@osmo.inc/cli 0.1.16 → 0.1.17

package/dist/osmo.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 
 // src/runtime.ts
 import fs from "node:fs";
-import path3 from "node:path";
+import path2 from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 function assertCompatibleProject(config) {
@@ -21,10 +21,10 @@ function assertCompatibleProject(config) {
     );
 }
 function nativeBinary() {
-  const bundled = path3.join(packageRoot, "vendor/osmo-lite");
+  const bundled = path2.join(packageRoot, "vendor/osmo-lite");
   if (fs.existsSync(bundled)) {
     const platform = JSON.parse(
-      fs.readFileSync(path3.join(packageRoot, "vendor/platform.json"), "utf8")
+      fs.readFileSync(path2.join(packageRoot, "vendor/platform.json"), "utf8")
     );
     if (platform.os !== process.platform || platform.arch !== process.arch)
       throw new Error(
@@ -33,7 +33,7 @@ function nativeBinary() {
     return bundled;
   }
   for (const profile of ["debug", "release"]) {
-    const candidate = path3.join(
+    const candidate = path2.join(
       runtimeRoot,
       `apps/native/target/${profile}/osmo-lite`
     );
@@ -57,22 +57,22 @@ function run(command, args, options = {}) {
     child.once(
       "exit",
       (code, signal) => code === 0 ? resolve() : reject(
-        new Error(`${path3.basename(command)} failed (${signal ?? code}).`)
+        new Error(`${path2.basename(command)} failed (${signal ?? code}).`)
       )
     );
   });
 }
 function projectRoot(start = process.cwd()) {
-  let dir = path3.resolve(start);
+  let dir = path2.resolve(start);
   while (true) {
-    if (fs.existsSync(path3.join(dir, ".osmo/project.json"))) {
+    if (fs.existsSync(path2.join(dir, ".osmo/project.json"))) {
       const config = JSON.parse(
-        fs.readFileSync(path3.join(dir, ".osmo/project.json"), "utf8")
+        fs.readFileSync(path2.join(dir, ".osmo/project.json"), "utf8")
       );
       assertCompatibleProject(config);
       return dir;
     }
-    const parent = path3.dirname(dir);
+    const parent = path2.dirname(dir);
     if (parent === dir)
       throw new Error(
         "No Osmo project found. Run osmo studio init in your project folder first."
@@ -81,11 +81,11 @@ function projectRoot(start = process.cwd()) {
   }
 }
 function sceneInProject(root, input = "scene.tsx") {
-  const source = fs.realpathSync(path3.resolve(root, input));
-  const relative = path3.relative(fs.realpathSync(root), source);
-  if (relative.startsWith(".." + path3.sep) || path3.isAbsolute(relative) || relative === "..")
+  const source = fs.realpathSync(path2.resolve(root, input));
+  const relative = path2.relative(fs.realpathSync(root), source);
+  if (relative.startsWith(".." + path2.sep) || path2.isAbsolute(relative) || relative === "..")
     throw new Error("Scene must be inside the current Osmo project.");
-  return { source, scene: relative.split(path3.sep).join("/") };
+  return { source, scene: relative.split(path2.sep).join("/") };
 }
 var packageRoot, manifest, version, sceneVersion, runtimeRoot, studioRoot;
 var init_runtime = __esm({
@@ -93,12 +93,78 @@ var init_runtime = __esm({
     "use strict";
     packageRoot = fileURLToPath(new URL("../", import.meta.url));
     manifest = JSON.parse(
-      fs.readFileSync(path3.join(packageRoot, "package.json"), "utf8")
+      fs.readFileSync(path2.join(packageRoot, "package.json"), "utf8")
     );
     version = manifest.version;
     sceneVersion = manifest.osmo.sceneVersion;
-    runtimeRoot = fs.existsSync(path3.join(packageRoot, "runtime")) ? path3.join(packageRoot, "runtime") : path3.resolve(packageRoot, "../..");
-    studioRoot = fs.existsSync(path3.join(packageRoot, "studio")) ? path3.join(packageRoot, "studio") : path3.join(runtimeRoot, "packages/studio/dist");
+    runtimeRoot = fs.existsSync(path2.join(packageRoot, "runtime")) ? path2.join(packageRoot, "runtime") : path2.resolve(packageRoot, "../..");
+    studioRoot = fs.existsSync(path2.join(packageRoot, "studio")) ? path2.join(packageRoot, "studio") : path2.join(runtimeRoot, "packages/studio/dist");
+  }
+});
+
+// src/check.ts
+import ts from "typescript";
+import path3 from "node:path";
+import { pathToFileURL } from "node:url";
+async function check(source, {
+  text: text2,
+  sources = {},
+  allowLegacyTracks = false
+} = {}) {
+  const { validate } = await import(pathToFileURL(
+    path3.join(runtimeRoot, "packages/scene/scripts/validate-strict.mjs")
+  ).href);
+  const strict = validate(source, "strict", {
+    text: text2,
+    sources,
+    requireTracks: !allowLegacyTracks
+  });
+  const scene = path3.join(runtimeRoot, "packages/scene/src");
+  const options = {
+    noEmit: true,
+    strict: true,
+    skipLibCheck: true,
+    target: ts.ScriptTarget.ES2022,
+    module: ts.ModuleKind.ESNext,
+    moduleResolution: ts.ModuleResolutionKind.Bundler,
+    jsx: ts.JsxEmit.ReactJSX,
+    jsxImportSource: "@osmo/scene",
+    baseUrl: runtimeRoot,
+    types: [],
+    allowImportingTsExtensions: true,
+    allowJs: true,
+    paths: {
+      "@osmo/scene": [path3.join(scene, "index.ts")],
+      "@osmo/scene/*": [path3.join(scene, "*")]
+    }
+  };
+  const host = ts.createCompilerHost(options), original = host.getSourceFile.bind(host);
+  const overrides = {
+    ...sources,
+    ...text2 === void 0 ? {} : { [path3.resolve(source)]: text2 }
+  };
+  host.getSourceFile = (file, language, ...rest) => Object.hasOwn(overrides, path3.resolve(file)) ? ts.createSourceFile(
+    file,
+    overrides[path3.resolve(file)],
+    language,
+    true,
+    ts.ScriptKind.TSX
+  ) : original(file, language, ...rest);
+  const program = ts.createProgram([source], options, host);
+  const diagnostics = ts.getPreEmitDiagnostics(program);
+  const errors = [
+    ...strict.errors,
+    ...diagnostics.map((d) => {
+      const pos = d.file && d.start !== void 0 ? d.file.getLineAndCharacterOfPosition(d.start) : void 0;
+      return `${d.file?.fileName ?? ""}${pos ? `:${pos.line + 1}:${pos.character + 1}` : ""} ${ts.flattenDiagnosticMessageText(d.messageText, "\n")}`;
+    })
+  ];
+  return { ok: !errors.length, errors };
+}
+var init_check = __esm({
+  "src/check.ts"() {
+    "use strict";
+    init_runtime();
   }
 });
 
@@ -149,76 +215,10 @@ var init_labels = __esm({
   }
 });
 
-// src/check.ts
-import ts3 from "typescript";
-import path10 from "node:path";
-import { pathToFileURL as pathToFileURL2 } from "node:url";
-async function check(source, {
-  text: text2,
-  sources = {},
-  allowLegacyTracks = false
-} = {}) {
-  const { validate } = await import(pathToFileURL2(
-    path10.join(runtimeRoot, "packages/scene/scripts/validate-strict.mjs")
-  ).href);
-  const strict = validate(source, "strict", {
-    text: text2,
-    sources,
-    requireTracks: !allowLegacyTracks
-  });
-  const scene = path10.join(runtimeRoot, "packages/scene/src");
-  const options = {
-    noEmit: true,
-    strict: true,
-    skipLibCheck: true,
-    target: ts3.ScriptTarget.ES2022,
-    module: ts3.ModuleKind.ESNext,
-    moduleResolution: ts3.ModuleResolutionKind.Bundler,
-    jsx: ts3.JsxEmit.ReactJSX,
-    jsxImportSource: "@osmo/scene",
-    baseUrl: runtimeRoot,
-    types: [],
-    allowImportingTsExtensions: true,
-    allowJs: true,
-    paths: {
-      "@osmo/scene": [path10.join(scene, "index.ts")],
-      "@osmo/scene/*": [path10.join(scene, "*")]
-    }
-  };
-  const host = ts3.createCompilerHost(options), original = host.getSourceFile.bind(host);
-  const overrides = {
-    ...sources,
-    ...text2 === void 0 ? {} : { [path10.resolve(source)]: text2 }
-  };
-  host.getSourceFile = (file, language, ...rest) => Object.hasOwn(overrides, path10.resolve(file)) ? ts3.createSourceFile(
-    file,
-    overrides[path10.resolve(file)],
-    language,
-    true,
-    ts3.ScriptKind.TSX
-  ) : original(file, language, ...rest);
-  const program = ts3.createProgram([source], options, host);
-  const diagnostics = ts3.getPreEmitDiagnostics(program);
-  const errors = [
-    ...strict.errors,
-    ...diagnostics.map((d) => {
-      const pos = d.file && d.start !== void 0 ? d.file.getLineAndCharacterOfPosition(d.start) : void 0;
-      return `${d.file?.fileName ?? ""}${pos ? `:${pos.line + 1}:${pos.character + 1}` : ""} ${ts3.flattenDiagnosticMessageText(d.messageText, "\n")}`;
-    })
-  ];
-  return { ok: !errors.length, errors };
-}
-var init_check = __esm({
-  "src/check.ts"() {
-    "use strict";
-    init_runtime();
-  }
-});
-
 // src/comments.ts
-import { mkdir as mkdir5, readFile as readFile6, writeFile as writeFile5, rename as rename2, rm as rm5 } from "node:fs/promises";
+import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile2, rename as rename2, rm as rm3 } from "node:fs/promises";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import path11 from "node:path";
+import path7 from "node:path";
 function validBounds(value) {
   return value && ["x", "y", "width", "height"].every(
     (key) => Number.isFinite(value[key]) && value[key] >= 0 && value[key] <= 1
@@ -244,7 +244,7 @@ function validAgentResponse(value) {
 }
 async function readComments(root) {
   try {
-    const data = JSON.parse(await readFile6(filename(root), "utf8"));
+    const data = JSON.parse(await readFile3(filename(root), "utf8"));
     if (data.version !== 1 || !Array.isArray(data.comments))
       throw new Error("Unsupported comments file");
     const ids = /* @__PURE__ */ new Set();
@@ -272,13 +272,13 @@ function commentText(value) {
   return value.trim();
 }
 async function mutateComments(root, change) {
-  const folder = path11.join(root, ".osmo");
-  await mkdir5(folder, { recursive: true });
-  const lock = path11.join(folder, "comments.lock");
+  const folder = path7.join(root, ".osmo");
+  await mkdir3(folder, { recursive: true });
+  const lock = path7.join(folder, "comments.lock");
   const start = Date.now();
   while (true) {
     try {
-      await mkdir5(lock);
+      await mkdir3(lock);
       break;
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
@@ -289,18 +289,18 @@ async function mutateComments(root, change) {
       await new Promise((resolve) => setTimeout(resolve, 25));
     }
   }
-  const temporary = path11.join(folder, `comments.${randomUUID2()}.tmp`);
+  const temporary = path7.join(folder, `comments.${randomUUID2()}.tmp`);
   try {
     const data = await readComments(root);
     const result = change(data.comments);
-    await writeFile5(temporary, JSON.stringify(data, null, 2) + "\n", {
+    await writeFile2(temporary, JSON.stringify(data, null, 2) + "\n", {
       flag: "wx"
     });
     await rename2(temporary, filename(root));
     return result;
   } finally {
-    await rm5(temporary, { force: true });
-    await rm5(lock, { recursive: true, force: true });
+    await rm3(temporary, { force: true });
+    await rm3(lock, { recursive: true, force: true });
   }
 }
 async function addComment(root, input) {
@@ -399,7 +399,7 @@ var filename, AGENT_REACTION_MIN_MS, graphemes, isoTime;
 var init_comments = __esm({
   "src/comments.ts"() {
     "use strict";
-    filename = (root) => path11.join(root, ".osmo/comments.json");
+    filename = (root) => path7.join(root, ".osmo/comments.json");
     AGENT_REACTION_MIN_MS = 3e4;
     graphemes = new Intl.Segmenter("en", { granularity: "grapheme" });
     isoTime = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
@@ -948,7 +948,7 @@ __export(scene_document_exports, {
   outlineDocument: () => outlineDocument
 });
 import fs2 from "node:fs/promises";
-import path12 from "node:path";
+import path11 from "node:path";
 import { createHash as createHash4 } from "node:crypto";
 import ts5 from "typescript";
 function createDocumentLoader(root) {
@@ -997,8 +997,8 @@ function createDocumentLoader(root) {
       }
       if (typeof value !== "string" || kind === "font" && value === "Inter")
         return;
-      const relative = path12.posix.normalize(
-        path12.posix.join(path12.posix.dirname(file), value)
+      const relative = path11.posix.normalize(
+        path11.posix.join(path11.posix.dirname(file), value)
       );
       if (document.assets[relative]) return;
       document.assets[relative] = await registerAsset(relative, kind);
@@ -1094,7 +1094,7 @@ function createDocumentLoader(root) {
       );
     return {
       bytes: await fs2.readFile(current.source),
-      extension: path12.extname(current.source).toLowerCase()
+      extension: path11.extname(current.source).toLowerCase()
     };
   }
   return { load, readAsset, resources };
@@ -1110,21 +1110,21 @@ var init_scene_document2 = __esm({
 
 // src/project-resources.ts
 import fs3 from "node:fs/promises";
-import path13 from "node:path";
-import { execFile as execFile2 } from "node:child_process";
-import { promisify as promisify2 } from "node:util";
+import path12 from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
 import { randomUUID as randomUUID3 } from "node:crypto";
 import ts6 from "typescript";
 async function resourceFile(root, relative) {
-  if (typeof relative !== "string" || path13.isAbsolute(relative))
+  if (typeof relative !== "string" || path12.isAbsolute(relative))
     throw new Error("Resource paths must be relative.");
-  const base = await fs3.realpath(root), file = await fs3.realpath(path13.resolve(base, relative));
-  if (!inside(path13.join(base, "resources"), file) || (await fs3.stat(file)).isDirectory())
+  const base = await fs3.realpath(root), file = await fs3.realpath(path12.resolve(base, relative));
+  if (!inside(path12.join(base, "resources"), file) || (await fs3.stat(file)).isDirectory())
     throw new Error("Resource files must stay inside resources/.");
   return file;
 }
 async function resourceFolder(root) {
-  const base = await fs3.realpath(root), folder = path13.join(base, "resources");
+  const base = await fs3.realpath(root), folder = path12.join(base, "resources");
   await fs3.mkdir(folder, { recursive: true });
   if ((await fs3.lstat(folder)).isSymbolicLink())
     throw new Error("resources/ must be a real directory.");
@@ -1133,7 +1133,7 @@ async function resourceFolder(root) {
 async function listProjectResources(root) {
   let entries;
   try {
-    entries = await fs3.readdir(path13.join(root, "resources"), {
+    entries = await fs3.readdir(path12.join(root, "resources"), {
       withFileTypes: true
     });
   } catch (e) {
@@ -1149,8 +1149,8 @@ async function listProjectResources(root) {
         throw new Error("Manifest exceeds 1 MB");
       const meta = JSON.parse(await fs3.readFile(manifestFile, "utf8"));
       const entry = `resources/${item.name}/${meta.entry}`, file = await resourceFile(root, entry);
-      const kind = meta.kind ?? meta.category ?? kinds[path13.extname(file).toLowerCase()];
-      if (!["shader", "image", "video", "model", "scene"].includes(kind) || kinds[path13.extname(file).toLowerCase()] !== kind)
+      const kind = meta.kind ?? meta.category ?? kinds[path12.extname(file).toLowerCase()];
+      if (!["shader", "image", "video", "model", "scene"].includes(kind) || kinds[path12.extname(file).toLowerCase()] !== kind)
         throw new Error("Unsupported resource type");
       let effect;
       if (kind === "shader" && meta.effect) {
@@ -1201,14 +1201,14 @@ async function listProjectResources(root) {
         "video-references"
       ].includes(item.name) || item.isSymbolicLink())
         continue;
-      const file = path13.join(folder, item.name);
+      const file = path12.join(folder, item.name);
       if (item.isDirectory()) {
         await scenes(file, depth + 1);
         continue;
       }
       if (!item.isFile() || !item.name.endsWith(".tsx") || (await fs3.stat(file)).size > 1024 * 1024)
         continue;
-      const entry = path13.relative(root, file).split(path13.sep).join("/");
+      const entry = path12.relative(root, file).split(path12.sep).join("/");
       try {
         const text2 = await fs3.readFile(file, "utf8"), ast = ts6.createSourceFile(
           entry,
@@ -1247,7 +1247,7 @@ async function listProjectResources(root) {
         else
           resources.push({
             id: `scene:${entry}`,
-            title: item.name === "scene.tsx" ? path13.basename(folder) : item.name.slice(0, -4),
+            title: item.name === "scene.tsx" ? path12.basename(folder) : item.name.slice(0, -4),
             kind: "scene",
             entry,
             ...info,
@@ -1271,7 +1271,7 @@ async function getProjectResource(root, id) {
 async function resourcePreview(root, id) {
   const resource = await getProjectResource(root, id);
   if (!resource.preview) throw new Error("No preview for this resource");
-  const file = await resourceFile(root, resource.preview), type = mime[path13.extname(file).toLowerCase()];
+  const file = await resourceFile(root, resource.preview), type = mime[path12.extname(file).toLowerCase()];
   if (!type) throw new Error("Unsupported preview type");
   if ((await fs3.stat(file)).size > 12 * 1024 * 1024)
     throw new Error("Preview is too large");
@@ -1279,14 +1279,14 @@ async function resourcePreview(root, id) {
 }
 async function dimensions(file, kind) {
   if (!["image", "video"].includes(kind)) return {};
-  if (path13.extname(file).toLowerCase() === ".svg") {
+  if (path12.extname(file).toLowerCase() === ".svg") {
     const text2 = await fs3.readFile(file, "utf8"), view = text2.match(
       /viewBox=["']\s*[-\d.]+\s+[-\d.]+\s+([\d.]+)\s+([\d.]+)/i
     );
     return view ? { width: Number(view[1]), height: Number(view[2]) } : {};
   }
   try {
-    const { stdout } = await exec2(
+    const { stdout } = await exec(
       "ffprobe",
       [
         "-v",
@@ -1311,42 +1311,42 @@ async function dimensions(file, kind) {
   }
 }
 async function importProjectResource(root, input) {
-  const source = await fs3.realpath(path13.resolve(input)), kind = kinds[path13.extname(source).toLowerCase()];
+  const source = await fs3.realpath(path12.resolve(input)), kind = kinds[path12.extname(source).toLowerCase()];
   if (!kind)
     throw new Error(
       "Supported files: scenes (.tsx), images, MP4/WebM/MOV, WGSL shaders and GLB models."
     );
   if (!(await fs3.stat(source)).isFile()) throw new Error("Import a file.");
-  const folder = await resourceFolder(root), title = path13.basename(source, path13.extname(source));
-  let id = slug(title), destination = path13.join(folder, id);
+  const folder = await resourceFolder(root), title = path12.basename(source, path12.extname(source));
+  let id = slug(title), destination = path12.join(folder, id);
   try {
     await fs3.mkdir(destination);
   } catch (e) {
     if (e.code !== "EEXIST") throw e;
     id += `-${randomUUID3().slice(0, 8)}`;
-    destination = path13.join(folder, id);
+    destination = path12.join(folder, id);
     await fs3.mkdir(destination);
   }
   try {
-    const entry = kind === "scene" ? path13.basename(source) : `asset${path13.extname(source).toLowerCase()}`;
+    const entry = kind === "scene" ? path12.basename(source) : `asset${path12.extname(source).toLowerCase()}`;
     if (kind === "scene") {
       const { createDocumentLoader: createDocumentLoader2 } = await Promise.resolve().then(() => (init_scene_document2(), scene_document_exports));
-      const base = path13.dirname(source), doc = await createDocumentLoader2(base).load(source);
+      const base = path12.dirname(source), doc = await createDocumentLoader2(base).load(source);
       if (doc.root.type !== "Scene")
         throw new Error("Scene resources must export a Scene.");
       if (doc.nativeReason) throw new Error(doc.nativeReason);
       const files = /* @__PURE__ */ new Set([...doc.files, ...Object.keys(doc.assets)]);
       for (const relative of files) {
-        const file = await fs3.realpath(path13.resolve(base, relative));
+        const file = await fs3.realpath(path12.resolve(base, relative));
         if (!inside(base, file))
           throw new Error(
             "Keep imported scene dependencies inside its folder."
           );
-        const dest = path13.join(destination, relative);
-        await fs3.mkdir(path13.dirname(dest), { recursive: true });
+        const dest = path12.join(destination, relative);
+        await fs3.mkdir(path12.dirname(dest), { recursive: true });
         await fs3.copyFile(file, dest);
       }
-    } else await fs3.copyFile(source, path13.join(destination, entry));
+    } else await fs3.copyFile(source, path12.join(destination, entry));
     const meta = {
       id,
       title,
@@ -1363,7 +1363,7 @@ async function importProjectResource(root, input) {
       );
     }
     await fs3.writeFile(
-      path13.join(destination, "resource.json"),
+      path12.join(destination, "resource.json"),
       JSON.stringify(meta, null, 2) + "\n",
       { flag: "wx" }
     );
@@ -1379,10 +1379,10 @@ async function importProjectResource(root, input) {
   }
 }
 async function installResourceExamples(root) {
-  const folder = await resourceFolder(root), source = path13.join(packageRoot, "src/resource-examples/");
+  const folder = await resourceFolder(root), source = path12.join(packageRoot, "src/resource-examples/");
   for (const item of await fs3.readdir(source, { withFileTypes: true })) {
     if (!item.isDirectory()) continue;
-    const destination = path13.join(folder, item.name);
+    const destination = path12.join(folder, item.name);
     try {
       await fs3.mkdir(destination);
     } catch (e) {
@@ -1390,12 +1390,12 @@ async function installResourceExamples(root) {
       throw e;
     }
     try {
-      for (const file of (await fs3.readdir(path13.join(source, item.name))).sort(
+      for (const file of (await fs3.readdir(path12.join(source, item.name))).sort(
         (a, b) => Number(a === "resource.json") - Number(b === "resource.json")
       ))
         await fs3.copyFile(
-          path13.join(source, item.name, file),
-          path13.join(destination, file)
+          path12.join(source, item.name, file),
+          path12.join(destination, file)
         );
     } catch (error) {
       await fs3.rm(destination, { recursive: true, force: true });
@@ -1404,12 +1404,12 @@ async function installResourceExamples(root) {
   }
   return { status: "installed", ...await listProjectResources(root) };
 }
-var exec2, kinds, mime, slug, inside;
+var exec, kinds, mime, slug, inside;
 var init_project_resources = __esm({
   "src/project-resources.ts"() {
     "use strict";
     init_runtime();
-    exec2 = promisify2(execFile2);
+    exec = promisify(execFile);
     kinds = {
       ".tsx": "scene",
       ".svg": "image",
@@ -1435,8 +1435,8 @@ var init_project_resources = __esm({
     };
     slug = (value) => value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60) || "resource";
     inside = (root, file) => {
-      const rel = path13.relative(root, file);
-      return rel !== ".." && !rel.startsWith(".." + path13.sep) && !path13.isAbsolute(rel);
+      const rel = path12.relative(root, file);
+      return rel !== ".." && !rel.startsWith(".." + path12.sep) && !path12.isAbsolute(rel);
     };
   }
 });
@@ -4768,86 +4768,11 @@ var init_server = __esm({
   }
 });
 
-// src/cli.ts
-import path20 from "node:path";
-
-// src/features.ts
-function studioEnabled(env = process.env) {
-  return env.OSMO_STUDIO_ENABLED === "1";
-}
-function requireStudio() {
-  if (!studioEnabled())
-    throw Object.assign(
-      new Error("Osmo Studio commands are not available in this release."),
-      { code: "feature_disabled" }
-    );
-}
-
-// src/help.ts
-function cliHelp(version2, studio) {
-  const common = `Osmo ${version2}
-
-osmo login [--name COMPUTER] [--json]
-osmo login status SESSION [--json]
-osmo whoami [--json]
-osmo logout [--json]
-osmo resources list [--category shader] [--json]
-osmo resources show ID [--version VERSION] [--preset PRESET] [--json]
-osmo resources add ID [--version VERSION] [--preset PRESET] [--json]
-osmo resources import FILE [--json]
-osmo resources local [--json]
-osmo resources examples [--json]
-osmo share --video FILE.mp4 [--project ID] [--name NAME] [--json]
-osmo unshare --project ID [--json]
-osmo comments list --project ID [--open] [--json]
-osmo comments reply ID "message" --project ID
-osmo comments resolve ID --project ID
-osmo comments reopen ID --project ID`;
-  const studioCommands = `osmo studio init [folder]
-osmo studio publish [--name NAME]
-osmo studio push
-osmo studio pull
-osmo studio sync
-osmo studio clone PROJECT_ID folder
-osmo studio history
-osmo studio open [scene.tsx] [--port NUMBER] [--no-open]
-osmo studio open animations/player.tsx [--width 800 --height 450 --duration 4]
-osmo studio check [scene.tsx] [--json]
-osmo studio render [scene.tsx] --out animation.mp4 [--supersample 1|2]
-osmo studio render [scene.tsx] --frame NUMBER --out frame.png [--supersample 1|2]
-osmo studio deploy [scene.tsx]
-osmo studio comments list [--open] [--scene scene.tsx] [--json]
-osmo studio comments start ID [EMOJI]
-osmo studio comments stop ID
-osmo studio comments react ID [EMOJI|none]
-osmo studio comments reply ID "message"
-osmo studio comments resolve ID
-osmo studio comments reopen ID`;
-  const video = "osmo share --video: share a rendered video from any tool, including drafts and work in progress. Video review and version history only; no editable source. Requires login and ffprobe, not init or Git. Without --project, creates a new review.";
-  return `${common}${studio ? "\n" + studioCommands : ""}
-
-${studio ? "Choose the sharing workflow:\n  " : ""}${video}${studio ? "\n  osmo studio deploy: publish a full-featured editable Osmo project with source files, assets, and tracked Git history, plus a review video. Requires osmo studio init, osmo login, and osmo studio publish. Prefer this command for Osmo Studio projects. Edit locally with Studio or code; the cloud review is read-only." : ""}
-${studio ? "\nNew animation: run osmo studio init, read AGENTS.md, then resources list --json before authoring.\n" : ""}
-osmo unshare: disable a project's public review and version links, preserving
-videos, comments, and history. Sharing a new video to the same project restores its review links.
-Previously obtained direct media URLs may still work.
-
-Run project commands from the initialized project folder. Native renderer included
-in release archives; Node 22 and FFmpeg/ffprobe are prerequisites.
-Cloud commands need osmo login; OSMO_BASE_URL picks the cloud (default studio.osmo.inc).
-`;
-}
-
 // src/cli.ts
 import { spawnSync as spawnSync4 } from "node:child_process";
+import path20 from "node:path";
 import { parseArgs } from "node:util";
 
-// src/video-deploy.ts
-import { execFile } from "node:child_process";
-import { stat } from "node:fs/promises";
-import path2 from "node:path";
-import { promisify } from "node:util";
-
 // src/auth.ts
 import {
   mkdir,
@@ -5356,6 +5281,16 @@ ${result.next}`;
 Next: ${result.next}`;
 }
 
+// src/cli.ts
+init_check();
+
+// src/cloud.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync as existsSync2 } from "node:fs";
+import { mkdir as mkdir2, readdir, readFile as readFile2, rm as rm2 } from "node:fs/promises";
+import path6 from "node:path";
+import ts3 from "typescript";
+
 // src/cloud-request.ts
 async function call(origin, route, { method = "GET", body: body2, timeoutMs = 6e4, allow = [] } = {}) {
   let response;
@@ -5380,345 +5315,9 @@ async function call(origin, route, { method = "GET", body: body2, timeoutMs = 6e
   return { status: response.status, ...data };
 }
 
-// src/upload-render.ts
-import { openAsBlob } from "node:fs";
-async function uploadRender(origin, project, file, metadata, log = () => {
-}) {
-  const video = await openAsBlob(file, { type: metadata.contentType });
-  if (!video.size || video.size > 2 * 1024 ** 3)
-    throw new Error("Video must be non-empty and no larger than 2 GB.");
-  let slot;
-  try {
-    log(`uploading video (${(video.size / 1048576).toFixed(1)} MB)\u2026`);
-    slot = await call(
-      origin,
-      `/api/projects/${encodeURIComponent(project)}/render`,
-      {
-        method: "POST",
-        body: { ...metadata, sizeInBytes: video.size }
-      }
-    );
-    if (slot.type !== "success")
-      throw new Error(slot.error ?? "The cloud did not accept the video.");
-    const put = await fetch(slot.uploadUrl, {
-      method: "PUT",
-      headers: { "Content-Type": metadata.contentType },
-      body: video,
-      redirect: "error",
-      signal: AbortSignal.timeout(9e5)
-    });
-    if (!put.ok) throw new Error(`Video upload failed (${put.status}).`);
-    const render = slot.renderRowId;
-    const done = await call(origin, `/api/renders/${render}/complete`, {
-      method: "POST",
-      body: { fileKey: slot.fileKey }
-    });
-    if (done.type !== "success")
-      throw new Error(done.error ?? "The cloud did not finalize the video.");
-    slot = null;
-    if (done.sharingEnabled === false)
-      throw new Error(
-        "Video saved, but review sharing was disabled after this upload started. Upload again to restore sharing."
-      );
-    return {
-      status: "deployed",
-      project,
-      render,
-      link: `${origin}/share/project/${project}`,
-      versionLink: `${origin}/share/${render}`
-    };
-  } finally {
-    if (slot?.renderRowId)
-      await call(origin, `/api/renders/${slot.renderRowId}/fail`, {
-        method: "POST",
-        body: { error: "deploy did not complete" }
-      }).catch(() => void 0);
-  }
-}
-
-// src/video-deploy.ts
-var exec = promisify(execFile);
-function projectId(value) {
-  if (typeof value !== "string" || !/^[a-z0-9]{10,40}$/.test(value))
-    throw new Error("Provide a valid cloud project ID with --project.");
-  return value;
-}
-async function unshare(project) {
-  projectId(project);
-  return call(
-    authOrigin(),
-    `/api/projects/${project}/share`,
-    { method: "DELETE" }
-  );
-}
-async function probeVideo(file) {
-  const info = await stat(file).catch(() => null);
-  if (!info?.isFile() || !info.size || info.size > 2 * 1024 ** 3)
-    throw new Error(
-      "Video must be an existing, non-empty file no larger than 2 GB."
-    );
-  let data;
-  try {
-    const { stdout } = await exec(
-      process.env.OSMO_FFPROBE ?? "ffprobe",
-      ["-v", "error", "-show_streams", "-show_format", "-of", "json", file],
-      { timeout: 3e4, maxBuffer: 2 * 1024 ** 2 }
-    );
-    data = JSON.parse(stdout);
-  } catch (error) {
-    if (error.code === "ENOENT")
-      throw new Error(
-        "ffprobe is required to inspect videos. Install FFmpeg (which includes ffprobe), then retry."
-      );
-    throw new Error(
-      "Cannot read this video. Provide a playable H.264 MP4 file."
-    );
-  }
-  const videos = (data.streams ?? []).filter(
-    (s) => s.codec_type === "video" && !s.disposition?.attached_pic
-  );
-  const video = videos[0], audio = (data.streams ?? []).filter((s) => s.codec_type === "audio");
-  if (!data.format?.format_name?.split(",").includes("mp4") || videos.length !== 1 || video?.codec_name !== "h264" || !["yuv420p", "yuvj420p"].includes(
-    video?.pix_fmt
-  ) || audio.some((s) => s.codec_name !== "aac"))
-    throw new Error(
-      "Use an H.264 MP4 with 8-bit 4:2:0 video and AAC audio (or no audio). Export a compatible MP4 from your video tool, then retry."
-    );
-  const [n, d = "1"] = String(video.avg_frame_rate).split("/");
-  const fps = Number(n) / Number(d), durationSeconds = Number(video.duration ?? data.format.duration);
-  const rotation = Number(
-    video.side_data_list?.find((s) => s.rotation !== void 0)?.rotation ?? video.tags?.rotate ?? 0
-  );
-  const portrait = Math.abs(rotation % 180) === 90;
-  const width = portrait ? video.height : video.width, height = portrait ? video.width : video.height;
-  if (![fps, durationSeconds, width, height].every(
-    (x) => Number.isFinite(x) && x > 0
-  ) || fps > 1e3 || durationSeconds * fps > 2147483647)
-    throw new Error("Video has invalid or unsupported timing or dimensions.");
-  return {
-    codec: "h264",
-    contentType: "video/mp4",
-    // The check above found both finite and positive.
-    compositionWidth: width,
-    compositionHeight: height,
-    fps,
-    durationSeconds,
-    durationInFrames: Math.max(1, Math.round(durationSeconds * fps))
-  };
-}
-async function shareVideo(file, {
-  project,
-  name,
-  log = () => {
-  }
-} = {}) {
-  if (project !== void 0) projectId(project);
-  if (name !== void 0 && (!name.trim() || name.trim().length > 200))
-    throw new Error("--name must contain 1\u2013200 characters.");
-  const source = path2.resolve(file), metadata = await probeVideo(source), origin = authOrigin();
-  await currentAccount(origin);
-  const title = name?.trim() ?? path2.basename(source).slice(0, 200);
-  const id = project ?? (await call(origin, "/api/review-projects", {
-    method: "POST",
-    body: { name: title }
-  })).id;
-  try {
-    return await uploadRender(
-      origin,
-      id,
-      source,
-      { ...metadata, source: "video", name: title },
-      log
-    );
-  } catch (error) {
-    throw new Error(
-      `${error.message}
-Retry with --project ${id} to use the same review project.`
-    );
-  }
-}
-async function videoComments(project, { open = false } = {}) {
-  projectId(project);
-  const origin = authOrigin(), comments = [];
-  let cursor;
-  do {
-    const page = await call(
-      origin,
-      `/api/projects/${project}/share/versions${cursor ? `?before=${encodeURIComponent(cursor)}` : ""}`
-    );
-    for (const version2 of page.versions) {
-      const data = await call(
-        origin,
-        `/api/renders/${version2.id}/review-comments`
-      );
-      comments.push(
-        ...data.comments.filter((c) => !open || c.status === "open").map((c) => ({
-          ...c,
-          render: version2.id,
-          link: `${origin}/share/${version2.id}`
-        }))
-      );
-    }
-    cursor = page.nextCursor;
-  } while (cursor);
-  return comments;
-}
-
-// src/init.ts
-import {
-  mkdir as mkdir4,
-  readFile as readFile5,
-  writeFile as writeFile4,
-  copyFile,
-  cp,
-  access as access2,
-  mkdtemp,
-  rm as rm4
-} from "node:fs/promises";
-import path9 from "node:path";
-
-// src/authoring.ts
-init_runtime();
-import { readFile as readFile2, writeFile as writeFile2, rm as rm2 } from "node:fs/promises";
-import { createHash as createHash2 } from "node:crypto";
-import path4 from "node:path";
-var begin = "<!-- osmo:begin -->";
-var end = "<!-- osmo:end -->";
-var legacyPointer = "For Osmo animation tasks, read osmo.md before editing. Use osmo studio check, and read open Studio comments.";
-var legacyGuideHash = "815dae34cd7e5e6f44a575a88d80516d3736f9b74c76b9379fc09144c6aa06fb";
-var authoringGuide = `${begin}
-## Osmo Studio (${version})
-
-Project setup: osmo studio init [folder]. During internal preview, Studio commands require OSMO_STUDIO_ENABLED=1.
-
-TSX is the source of truth. Use the installed @osmo/scene Strict API; do not edit node_modules or the renderer.
-
-### Check resources first
-At the start of every animation task, run osmo resources list --json. Inspect
-plausible matches with osmo resources show ID --json, including their previews.
-Prefer a suitable resource over recreating it; install only resources you use with
-osmo resources add ID --preset PRESET --json. If login is required, run osmo login
---json and share the approval link. If the catalog is unavailable, say so and
-continue locally. Use the CLI compatibility result; older manifests may describe
-an earlier CLI. After install, use its local files, types, preset values and usage.
-
-### Choose the primitive first
-| Visual pattern | Start with |
-| --- | --- |
-| Typography following a circle, curve or figure-eight | One Text with path; animate path.progress |
-| Elements moving/rotating together | Group transforms and shared motion tracks |
-| Panels, circles, borders or thin lines | Group fill/stroke/shape/rounding |
-| Vector curves, icons, cutouts or illustrations | Path with SVG d, fill and stroke; evenodd for holes |
-| Images, footage, soundtrack | Image, Video, Audio with local asset paths |
-| Parallax and solid cards | Camera, z and Group.depth |
-| Content on a 3D model | Model with Surface children; inspect GLB selectors first |
-| Procedural backgrounds or liquid glass | Check resources; Shader with local src and explicit uniforms; glass samples backdrop |
-| Softness or texture | effects={[blur({ radius: 5 }), grain({ amount: 0.04 })]} |
-
-Prototype the native primitive before detailed tracking; explain a tested limitation before custom reconstruction. No approval step needed.
-### Layout before coordinates
-- Use Group row/column, align, justify, gap and padding for labels/cards/icon rows; position places the whole group.
-- Center labels with Text width/height, align="center", verticalAlign="center". Default bounds are the line box; opt into alignBounds="glyphs" for visible-letter centering. Changing text can shift glyph bounds.
-- Fit icons into equal Path width/height with fit="contain". Supply viewBox for the asset viewport, or omit it for tight geometry bounds, including negative origins. Fitting scales strokes; fill stretches; unsized paths retain coordinates.
-- Text and fitted paths can overflow; use a clipping Group to crop. See the sizing JSDoc before applying manual offsets.
-
-### API reference: types with short explanations
-Read relevant declarations in node_modules/@osmo/scene/dist/ (JSDoc explains usage):
-- index.d.ts: public exports; elements.d.ts: all primitives, props and examples.
-- motion.d.ts: defineMotion, keyframes and interpolation.
-- knobs.d.ts + knob-schema.d.ts: Group controls, typed values and UI metadata.
-- effects.d.ts: built-in effects and the broader library effect API.
-
-### Strict rules
-- Named imports from @osmo/scene; export default <Scene ...> in the scene entry.
-- Reuse a local default-exported Group: import Card from './animations/card'; <Card track={0} values={{ title: 'Hello' }} />. No children/knobs replacement; imports stay Strict.
-- Root Group/Text/Image/Video/Audio/Shader/Path/Rect/Model clips require literal track (0\u201399). start/duration are optional seconds; same-track clips cannot overlap. Tracks do not change paint order. Nested layers omit track. Motions use local clip time; trimming never stretches motion or changes media trimIn/playbackRate.
-- Optional names: Group label="Orbiting circles" (max two words); Scene tracks={{0:{label:"Shapes"}}} (one word per lane). Labels are static; track names stay with lanes. Keep stable IDs separate. Group hidden hides visuals; solo isolates siblings. Scene.tracks also accepts hidden (visuals), muted (audio), solo (isolate lanes); these affect preview and export.
-- Camera/Surface are not clips. Group sizing: "fill" follows parent, "auto" fits flow content.
-- Groups clip children to their shape by default. Set clip={false} to allow overflow.
-- Preview Group files with studio open --width 640 --height 360; storyboard.canvas.json stores per-card placement, size and literal knob values, referencing the original TSX.
-- Use explicit JSX, literal values/arrays/objects, and const defineMotion or defineKnobs declarations. Bind tracks/knobs directly to compatible props.
-- No arbitrary expressions, loops, callbacks, spreads, import aliases, custom components, helper calls or computed variables. Only blur({...}) and grain({...}) effect calls are allowed in JSX; pass an explicit object, even for defaults.
-- Shader.src must be a static relative local .wgsl path. Put complete uniform values inline; numeric uniforms can use motion/knob tracks. defineEffect remains unsupported.
-- Keyframe at values are increasing local seconds (scene unless inside a timed clip); easing belongs to the arriving key. Add a key at 0 to define a continuous track's starting value. Tracks do not loop automatically.
-- Group knobs can drive many descendant props; Group.values accepts motion tracks.
-- Units: pixels, degrees, seconds; +z toward viewer. Asset/font paths are relative to their declaring file.
-- Text.path handles the complete string; no width/align/lineHeight or line breaks. SVG geometry is static; progress and ellipse radii can animate.
-- Path draws SVG d in local pixels; use scale to resize. Geometry stays static; transforms, stroke width and effects can animate. Use fill="transparent" for lines.
-
-### Workflow
-1. Read relevant types, edit the scene, then run osmo studio check scene.tsx.
-2. Preview: osmo studio open scene.tsx. Keep the server running; saves reload it.  Reopening reuses the project URL, saved in gitignored .osmo/studio.json.
-3. Export: osmo studio render scene.tsx --out exports/animation.mp4 (single PNG:  --frame 90 --out exports/frame.png, zero-based; use a new filename if one exists).  Share for review: osmo studio deploy (after osmo login and osmo studio publish) renders, pushes editable source/assets and Git history, and prints a review link. Prefer this command for Osmo Studio projects. osmo share --video FILE.mp4 is only for sharing a rendered video from any tool, including drafts and work in progress: video versions and comments, no editable source; it needs login and ffprobe but no init, Git, or project.
-4. When asked to apply feedback: osmo studio comments list --open --json.  Check the scene/timestamp and any older revision; edit and validate the fix.  If complete and verified, reply only "Done." with osmo studio comments reply ID "Done."  then run osmo studio comments resolve ID. Do not leave routine fixes open for review.  Keep open only for ambiguity, an incomplete fix, or a specific uncertainty needing  user verification. Reply with one short sentence stating the blocker or what to check.
-${end}
-`;
-async function optional(file) {
-  try {
-    return await readFile2(file, "utf8");
-  } catch (error) {
-    if (error.code === "ENOENT") return "";
-    throw error;
-  }
-}
-async function writeAuthoringGuide(root) {
-  const file = path4.join(root, "AGENTS.md");
-  const original = await optional(file);
-  const hasBegin = original.includes(begin), hasEnd = original.includes(end);
-  if (hasBegin !== hasEnd || hasBegin && original.indexOf(end) < original.indexOf(begin))
-    throw new Error(
-      "AGENTS.md has an incomplete Osmo section; repair its osmo:begin/osmo:end markers before running init."
-    );
-  let text2;
-  if (hasBegin)
-    text2 = original.slice(0, original.indexOf(begin)) + authoringGuide.trimEnd() + original.slice(original.indexOf(end) + end.length);
-  else {
-    const rest = original.split("\n").filter((line) => line !== legacyPointer).join("\n");
-    text2 = rest + (rest && !rest.endsWith("\n\n") ? rest.endsWith("\n") ? "\n" : "\n\n" : "") + authoringGuide;
-  }
-  if (text2 !== original) await writeFile2(file, text2);
-  const legacy = await optional(path4.join(root, "osmo.md"));
-  if (legacy && createHash2("sha256").update(legacy).digest("hex") === legacyGuideHash)
-    await rm2(path4.join(root, "osmo.md"));
-  else if (legacy)
-    console.log(
-      "Existing osmo.md was preserved because it differs from the original generated guide. Osmo instructions now live in AGENTS.md."
-    );
-}
-
-// src/init.ts
-import os2 from "node:os";
-
-// src/starter.ts
-init_runtime();
-import { access, mkdir as mkdir2, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
-import path5 from "node:path";
-var template = path5.join(packageRoot, "src/starter/");
-async function writeStarter(root) {
-  const scene = path5.join(root, "scene.tsx");
-  try {
-    await access(scene);
-    return;
-  } catch (error) {
-    if (error.code !== "ENOENT") throw error;
-  }
-  await mkdir2(path5.join(root, "animations"), { recursive: true });
-  try {
-    await writeFile3(scene, await readFile3(path5.join(template, "scene.tsx")), {
-      flag: "wx"
-    });
-  } catch (error) {
-    if (error.code !== "EEXIST") throw error;
-  }
-}
-
-// src/init.ts
-init_runtime();
-import { spawnSync as spawnSync3 } from "node:child_process";
-
 // src/git.ts
 import { execFileSync, spawnSync } from "node:child_process";
-import { createHash as createHash3 } from "node:crypto";
+import { createHash as createHash2 } from "node:crypto";
 import {
   existsSync,
   mkdirSync,
@@ -5727,13 +5326,13 @@ import {
   rmSync,
   writeFileSync
 } from "node:fs";
-import path6 from "node:path";
+import path4 from "node:path";
 import zlib from "node:zlib";
 var git = (root, ...args) => execFileSync("git", ["-C", root, ...args], {
   encoding: "utf8",
   maxBuffer: 1 << 28
 }).replace(/\n$/, "");
-var hasRepo = (root) => existsSync(path6.join(root, ".git"));
+var hasRepo = (root) => existsSync(path4.join(root, ".git"));
 var initRepo = (root) => git(root, "init", "-q", "--object-format=sha256", "-b", "main");
 var headOf = (root) => {
   const r = spawnSync(
@@ -5754,7 +5353,7 @@ var objectFormat = (root) => {
   );
   return r.status === 0 ? r.stdout.trim() : null;
 };
-var objectId = (kind, content) => createHash3("sha256").update(Buffer.from(`${kind} ${content.length}\0`)).update(content).digest("hex");
+var objectId = (kind, content) => createHash2("sha256").update(Buffer.from(`${kind} ${content.length}\0`)).update(content).digest("hex");
 var identity = (author2) => author2 && typeof author2 === "object" ? [`user.name=${author2.name || author2.email}`, `user.email=${author2.email}`] : [
   `user.name=${author2 ?? process.env.USER ?? "osmo"}`,
   `user.email=${author2 ?? process.env.USER ?? "osmo"}@local`
@@ -5844,13 +5443,13 @@ function objectInfo(root, hashes) {
   }
   return out;
 }
-var looseFile = (root, hash3) => path6.join(root, ".git/objects", hash3.slice(0, 2), hash3.slice(2));
+var looseFile = (root, hash3) => path4.join(root, ".git/objects", hash3.slice(0, 2), hash3.slice(2));
 function looseObjectValid(root, hash3) {
   const file = looseFile(root, hash3);
   if (!existsSync(file)) return null;
   try {
     const inflated = zlib.inflateSync(readFileSync(file));
-    if (createHash3("sha256").update(inflated).digest("hex") === hash3)
+    if (createHash2("sha256").update(inflated).digest("hex") === hash3)
       return true;
   } catch {
   }
@@ -5873,7 +5472,7 @@ function writeLooseObjects(root, objects) {
       );
     if (looseObjectValid(root, hash3)) continue;
     const file = looseFile(root, hash3);
-    mkdirSync(path6.dirname(file), { recursive: true });
+    mkdirSync(path4.dirname(file), { recursive: true });
     const temporary = `${file}.${process.pid}.tmp`;
     writeFileSync(
       temporary,
@@ -5887,21 +5486,13 @@ function writeLooseObjects(root, objects) {
   return written;
 }
 
-// src/cloud.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { mkdir as mkdir3, readdir, readFile as readFile4, rm as rm3 } from "node:fs/promises";
-import path8 from "node:path";
-import { spawnSync as spawnSync2 } from "node:child_process";
-import ts2 from "typescript";
-init_runtime();
-
 // src/outline.ts
 init_runtime();
 init_labels();
-import ts from "typescript";
-import path7 from "node:path";
-import { pathToFileURL } from "node:url";
-var { isClipPrimitive } = await import(pathToFileURL(path7.join(runtimeRoot, "packages/scene/src/clip.mjs")).href);
+import ts2 from "typescript";
+import path5 from "node:path";
+import { pathToFileURL as pathToFileURL2 } from "node:url";
+var { isClipPrimitive } = await import(pathToFileURL2(path5.join(runtimeRoot, "packages/scene/src/clip.mjs")).href);
 var Reference = class {
   constructor(set, name = "") {
     this.set = set;
@@ -5923,35 +5514,35 @@ function merge(ranges) {
   return result;
 }
 function inspectScene(text2, filename2, meta, definitions = {}) {
-  const ast = ts.createSourceFile(
+  const ast = ts2.createSourceFile(
     filename2,
     text2,
-    ts.ScriptTarget.Latest,
+    ts2.ScriptTarget.Latest,
     true,
-    ts.ScriptKind.TSX
+    ts2.ScriptKind.TSX
   );
   const motions = /* @__PURE__ */ new Map(), knobs = /* @__PURE__ */ new Map(), rows = [], byId = /* @__PURE__ */ new Map(), used = /* @__PURE__ */ new Set();
   const line = (n) => ast.getLineAndCharacterOfPosition(n.getStart(ast)).line + 1;
   function read(n) {
     if (!n) return true;
-    if (ts.isJsxExpression(n) || ts.isParenthesizedExpression(n))
+    if (ts2.isJsxExpression(n) || ts2.isParenthesizedExpression(n))
       return read(n.expression);
-    if (ts.isStringLiteral(n) || ts.isNumericLiteral(n))
-      return ts.isNumericLiteral(n) ? Number(n.text) : n.text;
-    if (n.kind === ts.SyntaxKind.TrueKeyword) return true;
-    if (n.kind === ts.SyntaxKind.FalseKeyword) return false;
-    if (n.kind === ts.SyntaxKind.NullKeyword) return null;
-    if (ts.isPrefixUnaryExpression(n))
-      return n.operator === ts.SyntaxKind.MinusToken ? -read(n.operand) : read(n.operand);
-    if (ts.isArrayLiteralExpression(n)) return n.elements.map(read);
-    if (ts.isObjectLiteralExpression(n))
+    if (ts2.isStringLiteral(n) || ts2.isNumericLiteral(n))
+      return ts2.isNumericLiteral(n) ? Number(n.text) : n.text;
+    if (n.kind === ts2.SyntaxKind.TrueKeyword) return true;
+    if (n.kind === ts2.SyntaxKind.FalseKeyword) return false;
+    if (n.kind === ts2.SyntaxKind.NullKeyword) return null;
+    if (ts2.isPrefixUnaryExpression(n))
+      return n.operator === ts2.SyntaxKind.MinusToken ? -read(n.operand) : read(n.operand);
+    if (ts2.isArrayLiteralExpression(n)) return n.elements.map(read);
+    if (ts2.isObjectLiteralExpression(n))
       return Object.fromEntries(
-        n.properties.filter(ts.isPropertyAssignment).map((p) => [p.name.text, read(p.initializer)])
+        n.properties.filter(ts2.isPropertyAssignment).map((p) => [p.name.text, read(p.initializer)])
       );
-    if (ts.isPropertyAccessExpression(n) && ts.isIdentifier(n.expression))
+    if (ts2.isPropertyAccessExpression(n) && ts2.isIdentifier(n.expression))
       return new Reference(n.expression.text, n.name.text);
-    if (ts.isIdentifier(n)) return new Reference(n.text);
-    if (ts.isCallExpression(n))
+    if (ts2.isIdentifier(n)) return new Reference(n.text);
+    if (ts2.isCallExpression(n))
       return {
         effect: n.expression.getText(ast),
         inputs: read(n.arguments[0])
@@ -5959,10 +5550,10 @@ function inspectScene(text2, filename2, meta, definitions = {}) {
     return void 0;
   }
   for (const st of ast.statements)
-    if (ts.isVariableStatement(st))
+    if (ts2.isVariableStatement(st))
       for (const d of st.declarationList.declarations) {
         const call2 = d.initializer;
-        if (!call2 || !ts.isCallExpression(call2)) continue;
+        if (!call2 || !ts2.isCallExpression(call2)) continue;
         const definition = read(call2.arguments[0]);
         if (call2.expression.getText(ast) === "defineKnobs")
           knobs.set(d.name.text, definition);
@@ -6015,18 +5606,18 @@ function inspectScene(text2, filename2, meta, definitions = {}) {
     }
   }
   function visit(n, parent, depth, scope, clock = { offset: 0, start: 0, end: meta.duration }) {
-    if (ts.isParenthesizedExpression(n) || ts.isJsxExpression(n))
+    if (ts2.isParenthesizedExpression(n) || ts2.isJsxExpression(n))
       return n.expression ? visit(n.expression, parent, depth, scope, clock) : [];
-    if (ts.isJsxFragment(n))
+    if (ts2.isJsxFragment(n))
       return n.children.flatMap((c) => visit(c, parent, depth, scope, clock));
-    if (!ts.isJsxElement(n) && !ts.isJsxSelfClosingElement(n)) return [];
-    const opening3 = ts.isJsxElement(n) ? n.openingElement : n;
+    if (!ts2.isJsxElement(n) && !ts2.isJsxSelfClosingElement(n)) return [];
+    const opening3 = ts2.isJsxElement(n) ? n.openingElement : n;
     const tag = opening3.tagName.getText(ast), definition = definitions[tag];
     const type = definition ? "Group" : tag;
     if (type === "Fragment")
-      return ts.isJsxElement(n) ? n.children.flatMap((c) => visit(c, parent, depth, scope, clock)) : [];
+      return ts2.isJsxElement(n) ? n.children.flatMap((c) => visit(c, parent, depth, scope, clock)) : [];
     const props = Object.fromEntries(
-      opening3.attributes.properties.filter(ts.isJsxAttribute).map((a) => [a.name.text, read(a.initializer)])
+      opening3.attributes.properties.filter(ts2.isJsxAttribute).map((a) => [a.name.text, read(a.initializer)])
     );
     if (parent === null && type === "Group") props.start = 0;
     const id = typeof props.id === "string" ? `source:${props.id}` : `node-${rows.length}`, local = new Map(scope);
@@ -6046,14 +5637,14 @@ function inspectScene(text2, filename2, meta, definitions = {}) {
       if (!["knobs", "values"].includes(name))
         bindings(value, name, local, propertyTracks);
     if (ownKnobs) bindings(props.values, "knobs", scope, propertyTracks);
-    const rawChildren = ts.isJsxElement(n) ? n.children : [];
+    const rawChildren = ts2.isJsxElement(n) ? n.children : [];
     if (type === "Text") {
       for (const child of rawChildren)
-        if (ts.isJsxExpression(child) && child.expression)
+        if (ts2.isJsxExpression(child) && child.expression)
           bindings(read(child), "text", local, propertyTracks);
     }
     const words = type === "Text" ? rawChildren.map(
-      (c) => ts.isJsxText(c) ? c.text : ts.isJsxExpression(c) ? resolve(read(c), local).value ?? "" : ""
+      (c) => ts2.isJsxText(c) ? c.text : ts2.isJsxExpression(c) ? resolve(read(c), local).value ?? "" : ""
     ).join(" ").replace(/\s+/g, " ").trim() : "";
     const media = ["Video", "Audio"].includes(type);
     const timedGroup = isClipPrimitive(type) && (props.start !== void 0 || props.duration !== void 0 || props.track !== void 0 || definition?.duration !== void 0 || definition?.start !== void 0);
@@ -6090,7 +5681,7 @@ function inspectScene(text2, filename2, meta, definitions = {}) {
       parent,
       depth,
       type,
-      label: words ? `\u201C${words.slice(0, 64)}${words.length > 64 ? "\u2026" : ""}\u201D` : typeof props.src === "string" ? path7.basename(props.src) : type,
+      label: words ? `\u201C${words.slice(0, 64)}${words.length > 64 ? "\u2026" : ""}\u201D` : typeof props.src === "string" ? path5.basename(props.src) : type,
       line: line(opening3),
       sourceStart: opening3.getStart(ast),
       start,
@@ -6145,7 +5736,7 @@ function inspectScene(text2, filename2, meta, definitions = {}) {
     return [id];
   }
   for (const st of ast.statements)
-    if (ts.isExportAssignment(st)) visit(st.expression, null, 0, /* @__PURE__ */ new Map());
+    if (ts2.isExportAssignment(st)) visit(st.expression, null, 0, /* @__PURE__ */ new Map());
   function mapPaths(row, runtimePath) {
     row.runtimePath = runtimePath;
     let index = 0;
@@ -6198,8 +5789,123 @@ function reviewManifest(text2, scene, meta, revision2) {
     )
   };
 }
-
-// src/cloud.ts
+
+// src/cloud.ts
+init_runtime();
+
+// src/upload-render.ts
+import { openAsBlob } from "node:fs";
+async function uploadRender(origin, project, file, metadata, log = () => {
+}) {
+  const video = await openAsBlob(file, { type: metadata.contentType });
+  if (!video.size || video.size > 2 * 1024 ** 3)
+    throw new Error("Video must be non-empty and no larger than 2 GB.");
+  let slot;
+  try {
+    log(`uploading video (${(video.size / 1048576).toFixed(1)} MB)\u2026`);
+    slot = await call(
+      origin,
+      `/api/projects/${encodeURIComponent(project)}/render`,
+      {
+        method: "POST",
+        body: { ...metadata, sizeInBytes: video.size }
+      }
+    );
+    if (slot.type !== "success")
+      throw new Error(slot.error ?? "The cloud did not accept the video.");
+    const put = await fetch(slot.uploadUrl, {
+      method: "PUT",
+      headers: { "Content-Type": metadata.contentType },
+      body: video,
+      redirect: "error",
+      signal: AbortSignal.timeout(9e5)
+    });
+    if (!put.ok) throw new Error(`Video upload failed (${put.status}).`);
+    const render = slot.renderRowId;
+    const done = await call(origin, `/api/renders/${render}/complete`, {
+      method: "POST",
+      body: { fileKey: slot.fileKey }
+    });
+    if (done.type !== "success")
+      throw new Error(done.error ?? "The cloud did not finalize the video.");
+    slot = null;
+    if (done.sharingEnabled === false)
+      throw new Error(
+        "Video saved, but review sharing was disabled after this upload started. Upload again to restore sharing."
+      );
+    return {
+      status: "deployed",
+      project,
+      render,
+      link: `${origin}/share/project/${project}`,
+      versionLink: `${origin}/share/${render}`
+    };
+  } finally {
+    if (slot?.renderRowId)
+      await call(origin, `/api/renders/${slot.renderRowId}/fail`, {
+        method: "POST",
+        body: { error: "deploy did not complete" }
+      }).catch(() => void 0);
+  }
+}
+
+// src/cloud.ts
+var sourceAccessLevels = [
+  "private",
+  "signed-in-view",
+  "signed-in-edit"
+];
+function parseSourceAccess(value) {
+  if (!sourceAccessLevels.includes(value))
+    throw new Error(
+      "Invalid --access. Use private, signed-in-view, or signed-in-edit."
+    );
+  return value;
+}
+async function permissions(root, action = "get", options = {}) {
+  if (action === "set") parseSourceAccess(options.access ?? "");
+  if (["invite", "revoke"].includes(action) && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(options.email ?? ""))
+    throw new Error("Provide a valid collaborator email.");
+  if (action === "invite" && !["viewer", "editor"].includes(options.role ?? ""))
+    throw new Error("Use --role viewer or --role editor.");
+  if (!["get", "set", "invite", "revoke"].includes(action))
+    throw new Error("Unknown permissions action.");
+  const { origin, id } = await cloudOf(root);
+  const base = `/api/store/projects/${encodeURIComponent(id)}/permissions`;
+  if (action === "set")
+    await call(origin, `${base}/access`, {
+      method: "PUT",
+      body: { access: options.access }
+    });
+  if (action === "invite")
+    await call(origin, `${base}/grants`, {
+      method: "PUT",
+      body: { email: options.email, role: options.role }
+    });
+  if (action === "revoke")
+    await call(
+      origin,
+      `${base}/grants/${encodeURIComponent(options.email.trim().toLowerCase())}`,
+      { method: "DELETE" }
+    );
+  const result = await call(origin, base);
+  parseSourceAccess(result.access);
+  return {
+    ...result,
+    link: `${origin}/share/project/${id}`,
+    ...action === "revoke" ? {
+      note: "Removed the direct Studio grant. Workspace, project membership, and signed-in access still apply."
+    } : {}
+  };
+}
+function formatPermissions(result) {
+  return `Source access: ${result.access}
+Your role: ${result.role}
+Review: ${result.link}` + (result.grants?.length ? `
+Collaborators:
+${result.grants.map((g) => `  ${g.email}: ${g.role}`).join("\n")}` : "") + (result.note ? `
+${result.note}` : "");
+}
 var PROJECT_ID = /^[a-z0-9]{10,40}$/;
 function validOrigin(value) {
   try {
@@ -6420,7 +6126,8 @@ function uncommittedCount(root) {
     (l) => l && !l.slice(3).startsWith(".osmo/") && !excluded(l.slice(3))
   ).length;
 }
-async function publish(root, { name } = {}) {
+async function publish(root, { name, access: access3 = "private" } = {}) {
+  parseSourceAccess(access3);
   if (!hasRepo(root))
     throw new Error(
       "No repository in this project. Run osmo studio init first."
@@ -6438,15 +6145,21 @@ async function publish(root, { name } = {}) {
   await record(root, "record before publish", origin);
   const project = await call(origin, "/api/store/projects", {
     method: "POST",
-    body: { name: name ?? path8.basename(root) }
+    body: { name: name ?? path6.basename(root), access: access3 }
   });
   rememberPointer(root, { origin, id: project.id });
+  if ((project.access ?? "private") !== access3)
+    throw new Error(
+      "The server did not confirm the requested source access. Update the backend before deploying; the project connection has been saved."
+    );
   return {
     ...await sync(root, { record: false }),
     id: project.id,
     name: project.name,
     origin,
-    page: `${origin}/app/projects/${project.id}`
+    page: `${origin}/app/projects/${project.id}`,
+    access: project.access ?? "private",
+    link: `${origin}/share/project/${project.id}`
   };
 }
 async function push(root, { log = () => {
@@ -6645,7 +6358,7 @@ async function clone(id, dir, origin = authOrigin()) {
     throw new Error(
       info.kind === "review" ? "This is a video-only review with no editable source to clone. Use osmo studio deploy to publish full projects with source and Git history." : "This project was made in the web editor. The CLI can only clone projects published from the CLI."
     );
-  await mkdir3(dir, { recursive: true });
+  await mkdir2(dir, { recursive: true });
   try {
     initRepo(dir);
     const pack = await call(
@@ -6668,7 +6381,7 @@ async function clone(id, dir, origin = authOrigin()) {
       dir
     };
   } catch (error) {
-    await rm3(dir, { recursive: true, force: true });
+    await rm2(dir, { recursive: true, force: true });
     throw error;
   }
 }
@@ -6791,28 +6504,28 @@ async function sync(root, {
   return { ...result, steps };
 }
 function sceneMeta(source, text2) {
-  const sf = ts2.createSourceFile(
+  const sf = ts3.createSourceFile(
     source,
     text2,
-    ts2.ScriptTarget.ES2022,
+    ts3.ScriptTarget.ES2022,
     true,
-    ts2.ScriptKind.TSX
+    ts3.ScriptKind.TSX
   );
   let meta = null;
   const visit = (node) => {
     if (meta) return;
-    if ((ts2.isJsxOpeningElement(node) || ts2.isJsxSelfClosingElement(node)) && node.tagName.getText() === "Scene") {
+    if ((ts3.isJsxOpeningElement(node) || ts3.isJsxSelfClosingElement(node)) && node.tagName.getText() === "Scene") {
       const props = {};
       for (const attr of node.attributes.properties) {
-        if (!ts2.isJsxAttribute(attr) || !attr.initializer || !ts2.isJsxExpression(attr.initializer) || !attr.initializer.expression)
+        if (!ts3.isJsxAttribute(attr) || !attr.initializer || !ts3.isJsxExpression(attr.initializer) || !attr.initializer.expression)
           continue;
         const e = attr.initializer.expression;
-        if (ts2.isNumericLiteral(e)) props[attr.name.getText()] = Number(e.text);
+        if (ts3.isNumericLiteral(e)) props[attr.name.getText()] = Number(e.text);
       }
       meta = props;
       return;
     }
-    ts2.forEachChild(node, visit);
+    ts3.forEachChild(node, visit);
   };
   visit(sf);
   if (!meta || !(meta.width > 0) || !(meta.height > 0) || !(meta.duration > 0))
@@ -6832,26 +6545,50 @@ async function deploy(root, {
   check: check2,
   log = () => {
   },
-  quiet = false
+  quiet = false,
+  access: access3
 }) {
+  if (access3 !== void 0) parseSourceAccess(access3);
+  const existing = pointerFromGit(root);
+  if (existing && access3 !== void 0)
+    throw new Error(
+      `This project is already published. Change access with osmo studio permissions set --access ${access3}.`
+    );
   const result = await check2(source);
   if (!result.ok) throw new Error(result.errors.join("\n"));
-  const { origin, id } = await cloudOf(root);
-  const cacheDir = path8.join(root, ".osmo/cache");
-  await mkdir3(cacheDir, { recursive: true });
-  const out = path8.join(cacheDir, `deploy-${Date.now()}.mp4`);
+  const currentPermissions = existing ? await call(
+    existing.origin,
+    `/api/store/projects/${encodeURIComponent(existing.id)}`
+  ) : void 0;
+  if (currentPermissions?.role === "viewer")
+    throw new Error(
+      "This project is read-only. Ask its owner for editor access before deploying."
+    );
+  let effectiveAccess = currentPermissions?.access ?? access3 ?? "private";
+  const cacheDir = path6.join(root, ".osmo/cache");
+  await mkdir2(cacheDir, { recursive: true });
+  const out = path6.join(cacheDir, `deploy-${Date.now()}.mp4`);
   log("rendering\u2026");
   try {
     await run(nativeBinary(), [source, "--export", out, "--supersample", "2"], {
       env: environment(),
       stdio: quiet ? ["ignore", "ignore", "inherit"] : "inherit"
     });
+    if (!existing) {
+      const published = await publish(root, { access: effectiveAccess });
+      effectiveAccess = published.access;
+      if (!["pushed", "up-to-date"].includes(published.status))
+        throw new Error(
+          `Project created but initial synchronization failed (${published.status}); run osmo studio sync before deploying again.`
+        );
+    }
+    const { origin, id } = await cloudOf(root);
     if (!isClean(root)) await record(root, `deploy: ${scene}`, origin);
     const pushed = await push(root, { log });
     if (pushed.status !== "pushed" && pushed.status !== "up-to-date")
       return { ...pushed, hint: "osmo studio sync, then deploy again" };
     const head = headOf(root);
-    const sceneText = await readFile4(source, "utf8");
+    const sceneText = await readFile2(source, "utf8");
     const meta = sceneMeta(source, sceneText);
     const review = reviewManifest(sceneText, scene, meta, head);
     const uploaded = await uploadRender(
@@ -6867,7 +6604,7 @@ async function deploy(root, {
         reviewManifest: review,
         contentType: "video/mp4",
         source: "cli",
-        name: `${path8.basename(root)}.mp4`,
+        name: `${path6.basename(root)}.mp4`,
         gitCommit: head
       },
       log
@@ -6875,6 +6612,7 @@ async function deploy(root, {
     const renderId = uploaded.render;
     return {
       status: "deployed",
+      access: effectiveAccess,
       head,
       link: `${origin}/share/project/${id}`,
       versionLink: `${origin}/share/${renderId}`,
@@ -6884,7 +6622,7 @@ async function deploy(root, {
       uploaded: pushed.uploaded ?? 0
     };
   } finally {
-    await rm3(out, { force: true });
+    await rm2(out, { force: true });
   }
 }
 async function publicJson(url) {
@@ -6960,85 +6698,310 @@ async function cloudCommentAction(root, id, action, text2) {
   const { origin } = await cloudOf(root);
   return reviewCommentAction(origin, comment, action, text2);
 }
-async function reviewCommentAction(origin, comment, action, text2) {
-  const post = async (route, body2, allowMissing = false) => {
-    const response = await fetch(`${origin}${route}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body2),
-      signal: AbortSignal.timeout(3e4)
-    });
-    if (allowMissing && response.status === 404) return null;
-    if (!response.ok)
-      throw new Error(
-        `Cloud ${response.status}: ${(await response.json().catch(() => ({}))).error ?? "request failed"}`
-      );
-    return response.json().catch(() => ({}));
-  };
-  if (action === "reply") {
-    const me = await currentAccount(origin);
-    const name = me.user.name || me.user.email;
-    const reply = await post(
-      `/api/renders/${comment.render}/review-comments`,
-      {
-        scene: comment.scene,
-        revision: comment.revision,
-        time: comment.time,
-        text: text2,
-        author: { name: name.slice(0, 80) },
-        parentId: comment.id
-      },
-      true
+async function reviewCommentAction(origin, comment, action, text2) {
+  const post = async (route, body2, allowMissing = false) => {
+    const response = await fetch(`${origin}${route}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body2),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (allowMissing && response.status === 404) return null;
+    if (!response.ok)
+      throw new Error(
+        `Cloud ${response.status}: ${(await response.json().catch(() => ({}))).error ?? "request failed"}`
+      );
+    return response.json().catch(() => ({}));
+  };
+  if (action === "reply") {
+    const me = await currentAccount(origin);
+    const name = me.user.name || me.user.email;
+    const reply = await post(
+      `/api/renders/${comment.render}/review-comments`,
+      {
+        scene: comment.scene,
+        revision: comment.revision,
+        time: comment.time,
+        text: text2,
+        author: { name: name.slice(0, 80) },
+        parentId: comment.id
+      },
+      true
+    );
+    if (reply === null)
+      await post(`/api/renders/${comment.render}/comments`, {
+        body: text2,
+        frame: comment.frame,
+        authorName: name,
+        parentId: comment.id
+      });
+    return { id: comment.id, status: comment.status };
+  }
+  await post(`/api/renders/${comment.render}/comments/${comment.id}/resolve`, {
+    resolved: action === "resolve"
+  });
+  return { id: comment.id, status: action === "resolve" ? "resolved" : "open" };
+}
+function format(result) {
+  const steps = result.steps?.length ? `
+  ${result.steps.join(" \u2192 ")}` : "";
+  const pending = result.uncommitted ? `
+${result.uncommitted} uncommitted file${result.uncommitted === 1 ? "" : "s"} not included; run osmo studio sync to record and push them.` : "";
+  return formatStatus(result) + steps + pending;
+}
+function formatStatus(result) {
+  switch (result.status) {
+    case "pushed":
+      return `Pushed ${result.commits} revision${result.commits === 1 ? "" : "s"} (${result.objects} objects${result.uploaded ? `, ${result.uploaded} media file${result.uploaded === 1 ? "" : "s"}` : ""}). Head ${result.head.slice(0, 12)}.`;
+    case "fast-forward":
+      return `Pulled ${result.revisions} revision${result.revisions === 1 ? "" : "s"}. Head ${result.head.slice(0, 12)}.`;
+    case "up-to-date":
+      return `Up to date${result.head ? ` at ${result.head.slice(0, 12)}` : ""}.`;
+    case "refused":
+      return `Refused: ${result.reason}. Cloud is at ${result.cloud?.slice(0, 12)}, you are at ${result.head.slice(0, 12)}. Run ${result.hint}.`;
+    case "invalid":
+      return `The cloud refused the revision: ${result.reason}.
+${result.hint === "osmo studio sync" ? "Run osmo studio sync: it folds your unpushed revisions into one and tries again." : `Then ${result.hint}.`}`;
+    case "diverged":
+      return `Diverged: you are at ${result.head.slice(0, 12)}, the cloud at ${result.cloud.slice(0, 12)}. Run ${result.hint}.`;
+    case "conflict":
+      return `Conflict: the cloud's changes overlap yours. ${result.hint}.`;
+    case "history":
+      return result.log;
+    case "deployed":
+      return `Source access: ${result.access}
+Deployed ${result.head.slice(0, 12)} (${result.pushed}${result.commits ? `, ${result.commits} revision${result.commits === 1 ? "" : "s"}` : ""}).
+Review: ${result.link}`;
+    default:
+      return JSON.stringify(result);
+  }
+}
+
+// src/cli.ts
+init_comments();
+
+// src/features.ts
+function studioEnabled(env = process.env) {
+  return env.OSMO_STUDIO_ENABLED === "1";
+}
+function requireStudio() {
+  if (!studioEnabled())
+    throw Object.assign(
+      new Error("Osmo Studio commands are not available in this release."),
+      { code: "feature_disabled" }
+    );
+}
+
+// src/help.ts
+function cliHelp(version2, studio) {
+  const common = `Osmo ${version2}
+
+osmo login [--name COMPUTER] [--json]
+osmo login status SESSION [--json]
+osmo whoami [--json]
+osmo logout [--json]
+osmo resources list [--category shader] [--json]
+osmo resources show ID [--version VERSION] [--preset PRESET] [--json]
+osmo resources add ID [--version VERSION] [--preset PRESET] [--json]
+osmo resources import FILE [--json]
+osmo resources local [--json]
+osmo resources examples [--json]
+osmo share --video FILE.mp4 [--project ID] [--name NAME] [--json]
+osmo unshare --project ID [--json]
+osmo comments list --project ID [--open] [--json]
+osmo comments reply ID "message" --project ID
+osmo comments resolve ID --project ID
+osmo comments reopen ID --project ID`;
+  const studioCommands = `osmo studio init [folder]
+osmo studio publish [--name NAME] [--access private|signed-in-view|signed-in-edit]
+osmo studio push
+osmo studio pull
+osmo studio sync
+osmo studio clone PROJECT_ID folder
+osmo studio history
+osmo studio open [scene.tsx] [--port NUMBER] [--no-open]
+osmo studio open animations/player.tsx [--width 800 --height 450 --duration 4]
+osmo studio check [scene.tsx] [--json]
+osmo studio render [scene.tsx] --out animation.mp4 [--supersample 1|2]
+osmo studio render [scene.tsx] --frame NUMBER --out frame.png [--supersample 1|2]
+osmo studio deploy [scene.tsx] [--access private|signed-in-view|signed-in-edit]
+osmo studio permissions [--json]
+osmo studio permissions set --access private|signed-in-view|signed-in-edit [--json]
+osmo studio permissions invite EMAIL --role viewer|editor [--json]
+osmo studio permissions revoke EMAIL [--json]
+osmo studio comments list [--open] [--scene scene.tsx] [--json]
+osmo studio comments start ID [EMOJI]
+osmo studio comments stop ID
+osmo studio comments react ID [EMOJI|none]
+osmo studio comments reply ID "message"
+osmo studio comments resolve ID
+osmo studio comments reopen ID`;
+  const video = "osmo share --video: share a rendered video from any tool, including drafts and work in progress. Video review and version history only; no editable source. Requires login and ffprobe, not init or Git. Without --project, creates a new review.";
+  return `${common}${studio ? "\n" + studioCommands : ""}
+
+${studio ? "Choose the sharing workflow:\n  " : ""}${video}${studio ? "\n  osmo studio deploy: publish a full-featured editable Osmo project with source files, assets, and tracked Git history, plus a review video. Requires osmo studio init and osmo login. First deploy creates the cloud project; source access defaults to private. Later deploys preserve permissions; use permissions set to change them. Prefer this command for Osmo Studio projects. Edit locally with Studio or code; the cloud review is read-only." : ""}
+${studio ? "\nNew animation: run osmo studio init, read AGENTS.md, then resources list --json before authoring.\n" : ""}
+osmo unshare: disable a project's public review and version links, preserving
+videos, comments, and history. Sharing a new video to the same project restores its review links.
+Previously obtained direct media URLs may still work.
+
+Run project commands from the initialized project folder. Native renderer included
+in release archives; Node 22 and FFmpeg/ffprobe are prerequisites.
+Cloud commands need osmo login; OSMO_BASE_URL picks the cloud (default studio.osmo.inc).
+`;
+}
+
+// src/init.ts
+import {
+  mkdir as mkdir5,
+  readFile as readFile6,
+  writeFile as writeFile5,
+  copyFile,
+  cp,
+  access as access2,
+  mkdtemp,
+  rm as rm5
+} from "node:fs/promises";
+import path10 from "node:path";
+
+// src/authoring.ts
+init_runtime();
+import { readFile as readFile4, writeFile as writeFile3, rm as rm4 } from "node:fs/promises";
+import { createHash as createHash3 } from "node:crypto";
+import path8 from "node:path";
+var begin = "<!-- osmo:begin -->";
+var end = "<!-- osmo:end -->";
+var legacyPointer = "For Osmo animation tasks, read osmo.md before editing. Use osmo studio check, and read open Studio comments.";
+var legacyGuideHash = "815dae34cd7e5e6f44a575a88d80516d3736f9b74c76b9379fc09144c6aa06fb";
+var authoringGuide = `${begin}
+## Osmo Studio (${version})
+
+Project setup: osmo studio init [folder]. During internal preview, Studio commands require OSMO_STUDIO_ENABLED=1.
+
+TSX is the source of truth. Use the installed @osmo/scene Strict API; do not edit node_modules or the renderer.
+
+### Check resources first
+At the start of every animation task, run osmo resources list --json. Inspect
+plausible matches with osmo resources show ID --json, including their previews.
+Prefer a suitable resource over recreating it; install only resources you use with
+osmo resources add ID --preset PRESET --json. If login is required, run osmo login
+--json and share the approval link. If the catalog is unavailable, say so and
+continue locally. Use the CLI compatibility result; older manifests may describe
+an earlier CLI. After install, use its local files, types, preset values and usage.
+
+### Choose the primitive first
+| Visual pattern | Start with |
+| --- | --- |
+| Typography following a circle, curve or figure-eight | One Text with path; animate path.progress |
+| Elements moving/rotating together | Group transforms and shared motion tracks |
+| Panels, circles, borders or thin lines | Group fill/stroke/shape/rounding |
+| Vector curves, icons, cutouts or illustrations | Path with SVG d, fill and stroke; evenodd for holes |
+| Images, footage, soundtrack | Image, Video, Audio with local asset paths |
+| Parallax and solid cards | Camera, z and Group.depth |
+| Content on a 3D model | Model with Surface children; inspect GLB selectors first |
+| Procedural backgrounds or liquid glass | Check resources; Shader with local src and explicit uniforms; glass samples backdrop |
+| Softness or texture | effects={[blur({ radius: 5 }), grain({ amount: 0.04 })]} |
+
+Prototype the native primitive before detailed tracking; explain a tested limitation before custom reconstruction. No approval step needed.
+### Layout before coordinates
+- Use Group row/column, align, justify, gap and padding for labels/cards/icon rows; position places the whole group.
+- Center labels with Text width/height, align="center", verticalAlign="center". Default bounds are the line box; opt into alignBounds="glyphs" for visible-letter centering. Changing text can shift glyph bounds.
+- Fit icons into equal Path width/height with fit="contain". Supply viewBox for the asset viewport, or omit it for tight geometry bounds, including negative origins. Fitting scales strokes; fill stretches; unsized paths retain coordinates.
+- Text and fitted paths can overflow; use a clipping Group to crop. See the sizing JSDoc before applying manual offsets.
+
+### API reference: types with short explanations
+Read relevant declarations in node_modules/@osmo/scene/dist/ (JSDoc explains usage):
+- index.d.ts: public exports; elements.d.ts: all primitives, props and examples.
+- motion.d.ts: defineMotion, keyframes and interpolation.
+- knobs.d.ts + knob-schema.d.ts: Group controls, typed values and UI metadata.
+- effects.d.ts: built-in effects and the broader library effect API.
+
+### Strict rules
+- Named imports from @osmo/scene; export default <Scene ...> in the scene entry.
+- Reuse a local default-exported Group: import Card from './animations/card'; <Card track={0} values={{ title: 'Hello' }} />. No children/knobs replacement; imports stay Strict.
+- Root Group/Text/Image/Video/Audio/Shader/Path/Rect/Model clips require literal track (0\u201399). start/duration are optional seconds; same-track clips cannot overlap. Tracks do not change paint order. Nested layers omit track. Motions use local clip time; trimming never stretches motion or changes media trimIn/playbackRate.
+- Optional names: Group label="Orbiting circles" (max two words); Scene tracks={{0:{label:"Shapes"}}} (one word per lane). Labels are static; track names stay with lanes. Keep stable IDs separate. Group hidden hides visuals; solo isolates siblings. Scene.tracks also accepts hidden (visuals), muted (audio), solo (isolate lanes); these affect preview and export.
+- Camera/Surface are not clips. Group sizing: "fill" follows parent, "auto" fits flow content.
+- Groups clip children to their shape by default. Set clip={false} to allow overflow.
+- Preview Group files with studio open --width 640 --height 360; storyboard.canvas.json stores per-card placement, size and literal knob values, referencing the original TSX.
+- Use explicit JSX, literal values/arrays/objects, and const defineMotion or defineKnobs declarations. Bind tracks/knobs directly to compatible props.
+- No arbitrary expressions, loops, callbacks, spreads, import aliases, custom components, helper calls or computed variables. Only blur({...}) and grain({...}) effect calls are allowed in JSX; pass an explicit object, even for defaults.
+- Shader.src must be a static relative local .wgsl path. Put complete uniform values inline; numeric uniforms can use motion/knob tracks. defineEffect remains unsupported.
+- Keyframe at values are increasing local seconds (scene unless inside a timed clip); easing belongs to the arriving key. Add a key at 0 to define a continuous track's starting value. Tracks do not loop automatically.
+- Group knobs can drive many descendant props; Group.values accepts motion tracks.
+- Units: pixels, degrees, seconds; +z toward viewer. Asset/font paths are relative to their declaring file.
+- Text.path handles the complete string; no width/align/lineHeight or line breaks. SVG geometry is static; progress and ellipse radii can animate.
+- Path draws SVG d in local pixels; use scale to resize. Geometry stays static; transforms, stroke width and effects can animate. Use fill="transparent" for lines.
+
+### Workflow
+1. Read relevant types, edit the scene, then run osmo studio check scene.tsx.
+2. Preview: osmo studio open scene.tsx. Keep the server running; saves reload it.  Reopening reuses the project URL, saved in gitignored .osmo/studio.json.
+3. Export: osmo studio render scene.tsx --out exports/animation.mp4 (single PNG:  --frame 90 --out exports/frame.png, zero-based; use a new filename if one exists).  Share for review: osmo studio deploy (after osmo login and osmo studio publish) renders, pushes editable source/assets and Git history, and prints a review link. Prefer this command for Osmo Studio projects. osmo share --video FILE.mp4 is only for sharing a rendered video from any tool, including drafts and work in progress: video versions and comments, no editable source; it needs login and ffprobe but no init, Git, or project.
+4. When asked to apply feedback: osmo studio comments list --open --json.  Check the scene/timestamp and any older revision; edit and validate the fix.  If complete and verified, reply only "Done." with osmo studio comments reply ID "Done."  then run osmo studio comments resolve ID. Do not leave routine fixes open for review.  Keep open only for ambiguity, an incomplete fix, or a specific uncertainty needing  user verification. Reply with one short sentence stating the blocker or what to check.
+${end}
+`;
+async function optional(file) {
+  try {
+    return await readFile4(file, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return "";
+    throw error;
+  }
+}
+async function writeAuthoringGuide(root) {
+  const file = path8.join(root, "AGENTS.md");
+  const original = await optional(file);
+  const hasBegin = original.includes(begin), hasEnd = original.includes(end);
+  if (hasBegin !== hasEnd || hasBegin && original.indexOf(end) < original.indexOf(begin))
+    throw new Error(
+      "AGENTS.md has an incomplete Osmo section; repair its osmo:begin/osmo:end markers before running init."
     );
-    if (reply === null)
-      await post(`/api/renders/${comment.render}/comments`, {
-        body: text2,
-        frame: comment.frame,
-        authorName: name,
-        parentId: comment.id
-      });
-    return { id: comment.id, status: comment.status };
+  let text2;
+  if (hasBegin)
+    text2 = original.slice(0, original.indexOf(begin)) + authoringGuide.trimEnd() + original.slice(original.indexOf(end) + end.length);
+  else {
+    const rest = original.split("\n").filter((line) => line !== legacyPointer).join("\n");
+    text2 = rest + (rest && !rest.endsWith("\n\n") ? rest.endsWith("\n") ? "\n" : "\n\n" : "") + authoringGuide;
   }
-  await post(`/api/renders/${comment.render}/comments/${comment.id}/resolve`, {
-    resolved: action === "resolve"
-  });
-  return { id: comment.id, status: action === "resolve" ? "resolved" : "open" };
-}
-function format(result) {
-  const steps = result.steps?.length ? `
-  ${result.steps.join(" \u2192 ")}` : "";
-  const pending = result.uncommitted ? `
-${result.uncommitted} uncommitted file${result.uncommitted === 1 ? "" : "s"} not included; run osmo studio sync to record and push them.` : "";
-  return formatStatus(result) + steps + pending;
+  if (text2 !== original) await writeFile3(file, text2);
+  const legacy = await optional(path8.join(root, "osmo.md"));
+  if (legacy && createHash3("sha256").update(legacy).digest("hex") === legacyGuideHash)
+    await rm4(path8.join(root, "osmo.md"));
+  else if (legacy)
+    console.log(
+      "Existing osmo.md was preserved because it differs from the original generated guide. Osmo instructions now live in AGENTS.md."
+    );
 }
-function formatStatus(result) {
-  switch (result.status) {
-    case "pushed":
-      return `Pushed ${result.commits} revision${result.commits === 1 ? "" : "s"} (${result.objects} objects${result.uploaded ? `, ${result.uploaded} media file${result.uploaded === 1 ? "" : "s"}` : ""}). Head ${result.head.slice(0, 12)}.`;
-    case "fast-forward":
-      return `Pulled ${result.revisions} revision${result.revisions === 1 ? "" : "s"}. Head ${result.head.slice(0, 12)}.`;
-    case "up-to-date":
-      return `Up to date${result.head ? ` at ${result.head.slice(0, 12)}` : ""}.`;
-    case "refused":
-      return `Refused: ${result.reason}. Cloud is at ${result.cloud?.slice(0, 12)}, you are at ${result.head.slice(0, 12)}. Run ${result.hint}.`;
-    case "invalid":
-      return `The cloud refused the revision: ${result.reason}.
-${result.hint === "osmo studio sync" ? "Run osmo studio sync: it folds your unpushed revisions into one and tries again." : `Then ${result.hint}.`}`;
-    case "diverged":
-      return `Diverged: you are at ${result.head.slice(0, 12)}, the cloud at ${result.cloud.slice(0, 12)}. Run ${result.hint}.`;
-    case "conflict":
-      return `Conflict: the cloud's changes overlap yours. ${result.hint}.`;
-    case "history":
-      return result.log;
-    case "deployed":
-      return `Deployed ${result.head.slice(0, 12)} (${result.pushed}${result.commits ? `, ${result.commits} revision${result.commits === 1 ? "" : "s"}` : ""}).
-Review: ${result.link}`;
-    default:
-      return JSON.stringify(result);
+
+// src/init.ts
+import os2 from "node:os";
+
+// src/starter.ts
+init_runtime();
+import { access, mkdir as mkdir4, readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
+import path9 from "node:path";
+var template = path9.join(packageRoot, "src/starter/");
+async function writeStarter(root) {
+  const scene = path9.join(root, "scene.tsx");
+  try {
+    await access(scene);
+    return;
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  await mkdir4(path9.join(root, "animations"), { recursive: true });
+  try {
+    await writeFile4(scene, await readFile5(path9.join(template, "scene.tsx")), {
+      flag: "wx"
+    });
+  } catch (error) {
+    if (error.code !== "EEXIST") throw error;
   }
 }
 
 // src/init.ts
+init_runtime();
+import { spawnSync as spawnSync3 } from "node:child_process";
 async function exists(p) {
   try {
     await access2(p);
@@ -7049,7 +7012,7 @@ async function exists(p) {
 }
 async function create(p, value) {
   try {
-    await writeFile4(p, value, { flag: "wx" });
+    await writeFile5(p, value, { flag: "wx" });
     return true;
   } catch (e) {
     if (e.code !== "EEXIST") throw e;
@@ -7058,7 +7021,7 @@ async function create(p, value) {
 }
 async function init(root = process.cwd()) {
   nativeBinary();
-  const gitProbe = await mkdtemp(path9.join(os2.tmpdir(), "osmo-git-check-"));
+  const gitProbe = await mkdtemp(path10.join(os2.tmpdir(), "osmo-git-check-"));
   try {
     const result = spawnSync3(
       "git",
@@ -7070,7 +7033,7 @@ async function init(root = process.cwd()) {
         "Osmo projects require Git with SHA-256 support (Git 2.29+). Install or update Git, then retry osmo studio init. Sharing an existing MP4 with osmo share --video does not require Git."
       );
   } finally {
-    await rm4(gitProbe, { recursive: true, force: true });
+    await rm5(gitProbe, { recursive: true, force: true });
   }
   for (const [name, variable] of [
     ["ffmpeg", "OSMO_FFMPEG"],
@@ -7095,15 +7058,15 @@ async function init(root = process.cwd()) {
         );
     }
   }
-  root = path9.resolve(root);
-  await mkdir4(root, { recursive: true });
+  root = path10.resolve(root);
+  await mkdir5(root, { recursive: true });
   if (hasRepo(root) && objectFormat(root) !== "sha256")
     throw new Error(
       `${root} is already a git repository with ${objectFormat(root) ?? "unknown"} objects. Osmo projects are SHA-256 repositories: run osmo studio init in a new folder.`
     );
-  const manifestPath = path9.join(root, "package.json");
-  const manifest2 = await exists(manifestPath) ? JSON.parse(await readFile5(manifestPath, "utf8")) : {
-    name: path9.basename(root).toLowerCase().replace(/[^a-z0-9-]/g, "-") || "osmo-project",
+  const manifestPath = path10.join(root, "package.json");
+  const manifest2 = await exists(manifestPath) ? JSON.parse(await readFile6(manifestPath, "utf8")) : {
+    name: path10.basename(root).toLowerCase().replace(/[^a-z0-9-]/g, "-") || "osmo-project",
     private: true,
     type: "module"
   };
@@ -7113,58 +7076,58 @@ async function init(root = process.cwd()) {
     throw new Error(
       `Existing @osmo/scene dependency (${previous}) was preserved. Initialize a new folder for this release.`
     );
-  const configFile = path9.join(root, ".osmo/project.json");
+  const configFile = path10.join(root, ".osmo/project.json");
   if (await exists(configFile)) {
-    const config = JSON.parse(await readFile5(configFile, "utf8"));
+    const config = JSON.parse(await readFile6(configFile, "utf8"));
     assertCompatibleProject(config);
   }
-  const vendor = path9.join(root, ".osmo/vendor");
-  await mkdir4(vendor, { recursive: true });
-  await mkdir4(path9.join(root, "assets"), { recursive: true });
-  const target = path9.join(vendor, `osmo-scene-${sceneVersion}.tgz`);
+  const vendor = path10.join(root, ".osmo/vendor");
+  await mkdir5(vendor, { recursive: true });
+  await mkdir5(path10.join(root, "assets"), { recursive: true });
+  const target = path10.join(vendor, `osmo-scene-${sceneVersion}.tgz`);
   let refreshScene = false;
-  const bundled = path9.join(
+  const bundled = path10.join(
     packageRoot,
     "vendor",
     `osmo-scene-${sceneVersion}.tgz`
   );
   if (await exists(bundled)) {
-    if (!await exists(target) || !(await readFile5(target)).equals(await readFile5(bundled))) {
+    if (!await exists(target) || !(await readFile6(target)).equals(await readFile6(bundled))) {
       await copyFile(bundled, target);
       refreshScene = true;
     }
   } else {
-    const scratch = await mkdtemp(path9.join(os2.tmpdir(), "osmo-scene-pack-"));
+    const scratch = await mkdtemp(path10.join(os2.tmpdir(), "osmo-scene-pack-"));
     try {
       await run("npm", ["run", "build"], {
-        cwd: path9.join(runtimeRoot, "packages/scene")
+        cwd: path10.join(runtimeRoot, "packages/scene")
       });
-      const sceneRoot = path9.join(runtimeRoot, "packages/scene");
+      const sceneRoot = path10.join(runtimeRoot, "packages/scene");
       const { scripts, devDependencies, ...scenePackage } = JSON.parse(
-        await readFile5(path9.join(sceneRoot, "package.json"), "utf8")
+        await readFile6(path10.join(sceneRoot, "package.json"), "utf8")
       );
-      await writeFile4(
-        path9.join(scratch, "package.json"),
+      await writeFile5(
+        path10.join(scratch, "package.json"),
         JSON.stringify({ ...scenePackage, files: ["dist"] }, null, 2)
       );
-      await cp(path9.join(sceneRoot, "dist"), path9.join(scratch, "dist"), {
+      await cp(path10.join(sceneRoot, "dist"), path10.join(scratch, "dist"), {
         recursive: true
       });
       await run("npm", ["pack", "--pack-destination", scratch], {
         cwd: scratch
       });
-      const packed = path9.join(scratch, `osmo-scene-${sceneVersion}.tgz`);
-      if (!await exists(target) || !(await readFile5(target)).equals(await readFile5(packed))) {
+      const packed = path10.join(scratch, `osmo-scene-${sceneVersion}.tgz`);
+      if (!await exists(target) || !(await readFile6(target)).equals(await readFile6(packed))) {
         await copyFile(packed, target);
         refreshScene = true;
       }
     } finally {
-      await rm4(scratch, { recursive: true, force: true });
+      await rm5(scratch, { recursive: true, force: true });
     }
   }
   if (!previous) {
     manifest2.dependencies = { ...manifest2.dependencies, "@osmo/scene": spec };
-    await writeFile4(manifestPath, JSON.stringify(manifest2, null, 2) + "\n");
+    await writeFile5(manifestPath, JSON.stringify(manifest2, null, 2) + "\n");
   }
   const tsconfig = JSON.stringify(
     {
@@ -7183,7 +7146,7 @@ async function init(root = process.cwd()) {
     null,
     2
   ) + "\n";
-  await create(path9.join(root, "tsconfig.json"), tsconfig);
+  await create(path10.join(root, "tsconfig.json"), tsconfig);
   await writeStarter(root);
   await create(
     configFile,
@@ -7194,8 +7157,8 @@ async function init(root = process.cwd()) {
     ) + "\n"
   );
   await writeAuthoringGuide(root);
-  const ignorePath = path9.join(root, ".gitignore");
-  const ignore = await exists(ignorePath) ? await readFile5(ignorePath, "utf8") : "";
+  const ignorePath = path10.join(root, ".gitignore");
+  const ignore = await exists(ignorePath) ? await readFile6(ignorePath, "utf8") : "";
   const rules = [
     "node_modules/",
     "exports/",
@@ -7212,7 +7175,7 @@ async function init(root = process.cwd()) {
   ];
   const missing = rules.filter((rule) => !ignore.split("\n").includes(rule));
   if (missing.length)
-    await writeFile4(
+    await writeFile5(
       ignorePath,
       ignore + (ignore && !ignore.endsWith("\n") ? "\n" : "") + missing.join("\n") + "\n"
     );
@@ -7237,11 +7200,6 @@ Node 22 is required. Video/audio and MP4 export require FFmpeg and ffprobe on PA
   );
 }
 
-// src/cli.ts
-init_check();
-init_runtime();
-init_comments();
-
 // src/resources.ts
 import { createHash as createHash5 } from "node:crypto";
 import {
@@ -7253,7 +7211,7 @@ import {
   rename as rename3,
   rm as rm6
 } from "node:fs/promises";
-import path14 from "node:path";
+import path13 from "node:path";
 import { unzipSync } from "fflate";
 init_runtime();
 init_project_resources();
@@ -7411,7 +7369,7 @@ function unpack(zip, meta) {
     invalid();
   return { files, manifest: manifest2 };
 }
-async function stat2(file) {
+async function stat(file) {
   try {
     return await lstat2(file);
   } catch (error) {
@@ -7420,14 +7378,14 @@ async function stat2(file) {
   }
 }
 async function install(root, id, files) {
-  const folder = path14.join(root, "resources");
+  const folder = path13.join(root, "resources");
   await mkdir6(folder, { recursive: true });
   if (!(await lstat2(folder)).isDirectory())
     fail(
       "resource_conflict",
       "resources must be a real directory, not a symlink."
     );
-  const lock = path14.join(folder, `.${id}.install.lock`);
+  const lock = path13.join(folder, `.${id}.install.lock`);
   try {
     await mkdir6(lock);
   } catch (error) {
@@ -7440,12 +7398,12 @@ async function install(root, id, files) {
   }
   let stage2;
   try {
-    const destination = path14.join(folder, id), existing = await stat2(destination);
+    const destination = path13.join(folder, id), existing = await stat(destination);
     if (existing) {
       if (!existing.isDirectory())
         fail("resource_conflict", `resources/${id} must be a real directory.`);
       for (const name of names) {
-        const file = path14.join(destination, name), info = await stat2(file);
+        const file = path13.join(destination, name), info = await stat(file);
         if (!info?.isFile() || !(await readFile7(file)).equals(Buffer.from(files[name])))
           fail(
             "resource_conflict",
@@ -7454,10 +7412,10 @@ async function install(root, id, files) {
       }
       return "already_installed";
     }
-    stage2 = await mkdtemp2(path14.join(folder, `.${id}-`));
+    stage2 = await mkdtemp2(path13.join(folder, `.${id}-`));
     for (const name of names)
-      await writeFile6(path14.join(stage2, name), files[name], { flag: "wx" });
-    if (await stat2(destination))
+      await writeFile6(path13.join(stage2, name), files[name], { flag: "wx" });
+    if (await stat(destination))
       fail(
         "resource_conflict",
         `resources/${id} appeared during installation. Existing files were preserved.`
@@ -7557,6 +7515,141 @@ ${result.compatibility.note}
 ${result.next}`;
 }
 
+// src/cli.ts
+init_runtime();
+
+// src/video-deploy.ts
+import { execFile as execFile2 } from "node:child_process";
+import { stat as stat2 } from "node:fs/promises";
+import path14 from "node:path";
+import { promisify as promisify2 } from "node:util";
+var exec2 = promisify2(execFile2);
+function projectId(value) {
+  if (typeof value !== "string" || !/^[a-z0-9]{10,40}$/.test(value))
+    throw new Error("Provide a valid cloud project ID with --project.");
+  return value;
+}
+async function unshare(project) {
+  projectId(project);
+  return call(
+    authOrigin(),
+    `/api/projects/${project}/share`,
+    { method: "DELETE" }
+  );
+}
+async function probeVideo(file) {
+  const info = await stat2(file).catch(() => null);
+  if (!info?.isFile() || !info.size || info.size > 2 * 1024 ** 3)
+    throw new Error(
+      "Video must be an existing, non-empty file no larger than 2 GB."
+    );
+  let data;
+  try {
+    const { stdout } = await exec2(
+      process.env.OSMO_FFPROBE ?? "ffprobe",
+      ["-v", "error", "-show_streams", "-show_format", "-of", "json", file],
+      { timeout: 3e4, maxBuffer: 2 * 1024 ** 2 }
+    );
+    data = JSON.parse(stdout);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      throw new Error(
+        "ffprobe is required to inspect videos. Install FFmpeg (which includes ffprobe), then retry."
+      );
+    throw new Error(
+      "Cannot read this video. Provide a playable H.264 MP4 file."
+    );
+  }
+  const videos = (data.streams ?? []).filter(
+    (s) => s.codec_type === "video" && !s.disposition?.attached_pic
+  );
+  const video = videos[0], audio = (data.streams ?? []).filter((s) => s.codec_type === "audio");
+  if (!data.format?.format_name?.split(",").includes("mp4") || videos.length !== 1 || video?.codec_name !== "h264" || !["yuv420p", "yuvj420p"].includes(
+    video?.pix_fmt
+  ) || audio.some((s) => s.codec_name !== "aac"))
+    throw new Error(
+      "Use an H.264 MP4 with 8-bit 4:2:0 video and AAC audio (or no audio). Export a compatible MP4 from your video tool, then retry."
+    );
+  const [n, d = "1"] = String(video.avg_frame_rate).split("/");
+  const fps = Number(n) / Number(d), durationSeconds = Number(video.duration ?? data.format.duration);
+  const rotation = Number(
+    video.side_data_list?.find((s) => s.rotation !== void 0)?.rotation ?? video.tags?.rotate ?? 0
+  );
+  const portrait = Math.abs(rotation % 180) === 90;
+  const width = portrait ? video.height : video.width, height = portrait ? video.width : video.height;
+  if (![fps, durationSeconds, width, height].every(
+    (x) => Number.isFinite(x) && x > 0
+  ) || fps > 1e3 || durationSeconds * fps > 2147483647)
+    throw new Error("Video has invalid or unsupported timing or dimensions.");
+  return {
+    codec: "h264",
+    contentType: "video/mp4",
+    // The check above found both finite and positive.
+    compositionWidth: width,
+    compositionHeight: height,
+    fps,
+    durationSeconds,
+    durationInFrames: Math.max(1, Math.round(durationSeconds * fps))
+  };
+}
+async function shareVideo(file, {
+  project,
+  name,
+  log = () => {
+  }
+} = {}) {
+  if (project !== void 0) projectId(project);
+  if (name !== void 0 && (!name.trim() || name.trim().length > 200))
+    throw new Error("--name must contain 1\u2013200 characters.");
+  const source = path14.resolve(file), metadata = await probeVideo(source), origin = authOrigin();
+  await currentAccount(origin);
+  const title = name?.trim() ?? path14.basename(source).slice(0, 200);
+  const id = project ?? (await call(origin, "/api/review-projects", {
+    method: "POST",
+    body: { name: title }
+  })).id;
+  try {
+    return await uploadRender(
+      origin,
+      id,
+      source,
+      { ...metadata, source: "video", name: title },
+      log
+    );
+  } catch (error) {
+    throw new Error(
+      `${error.message}
+Retry with --project ${id} to use the same review project.`
+    );
+  }
+}
+async function videoComments(project, { open = false } = {}) {
+  projectId(project);
+  const origin = authOrigin(), comments = [];
+  let cursor;
+  do {
+    const page = await call(
+      origin,
+      `/api/projects/${project}/share/versions${cursor ? `?before=${encodeURIComponent(cursor)}` : ""}`
+    );
+    for (const version2 of page.versions) {
+      const data = await call(
+        origin,
+        `/api/renders/${version2.id}/review-comments`
+      );
+      comments.push(
+        ...data.comments.filter((c) => !open || c.status === "open").map((c) => ({
+          ...c,
+          render: version2.id,
+          link: `${origin}/share/${version2.id}`
+        }))
+      );
+    }
+    cursor = page.nextCursor;
+  } while (cursor);
+  return comments;
+}
+
 // src/cli.ts
 var help = cliHelp(version, studioEnabled());
 try {
@@ -7576,6 +7669,8 @@ try {
       category: { type: "string" },
       preset: { type: "string" },
       name: { type: "string" },
+      access: { type: "string" },
+      role: { type: "string" },
       port: { type: "string" },
       "no-open": { type: "boolean" },
       out: { type: "string" },
@@ -7593,6 +7688,15 @@ try {
     throw new Error(
       "Use --video with osmo share, and --project with osmo share, osmo unshare, or osmo comments." + (studioEnabled() ? " For full editable projects, use osmo studio deploy." : "")
     );
+  if (!flags.help && flags.access !== void 0) {
+    if (args[0] !== "studio" || !(["deploy", "publish"].includes(args[1]) || args[1] === "permissions" && args[2] === "set"))
+      throw new Error(
+        "--access is supported only by studio publish, first deploy, and permissions set."
+      );
+    parseSourceAccess(flags.access);
+  }
+  if (!flags.help && flags.role !== void 0 && !(args[0] === "studio" && args[1] === "permissions" && args[2] === "invite"))
+    throw new Error("--role is supported only by studio permissions invite.");
   if (flags.version && !resourceMode) console.log(version);
   else if (flags.help || !args.length) console.log(help);
   else if (["login", "whoami", "logout"].includes(args[0])) {
@@ -7660,6 +7764,21 @@ ${c.text}${c.replies.map((r) => "\n  \u21B3 " + r.text).join("")}`
       flags.json ? JSON.stringify(result) : `Cloned ${result.name} (${result.revisions} revision${result.revisions === 1 ? "" : "s"}) into ${args[3]}.
 Next: cd ${args[3]} && osmo studio open scene.tsx`
     );
+  } else if (args[0] === "studio" && args[1] === "permissions") {
+    const action = args[2] ?? "get";
+    const valid = action === "get" && args.length <= 3 || action === "set" && args.length === 3 && flags.access || ["invite", "revoke"].includes(action) && args.length === 4;
+    if (!valid)
+      throw new Error(
+        "Usage: osmo studio permissions [--json] | set --access LEVEL | invite EMAIL --role viewer|editor | revoke EMAIL"
+      );
+    const result = await permissions(projectRoot(), action, {
+      access: flags.access,
+      email: args[3],
+      role: flags.role
+    });
+    console.log(
+      flags.json ? JSON.stringify(result) : formatPermissions(result)
+    );
   } else if (args[0] === "studio" && ["publish", "push", "pull", "sync", "history"].includes(args[1])) {
     if (args.length !== 2)
       throw new Error(
@@ -7668,7 +7787,10 @@ Next: cd ${args[3]} && osmo studio open scene.tsx`
     const root = projectRoot();
     let result;
     if (args[1] === "publish")
-      result = await publish(root, { name: flags.name });
+      result = await publish(root, {
+        name: flags.name,
+        access: flags.access === void 0 ? void 0 : parseSourceAccess(flags.access)
+      });
     else if (args[1] === "push")
       result = await push(root, { log: flags.json ? () => {
       } : console.log });
@@ -7680,6 +7802,8 @@ Next: cd ${args[3]} && osmo studio open scene.tsx`
     if (result)
       console.log(
         flags.json ? JSON.stringify(result) : args[1] === "publish" ? `Published as ${result.id}. Page: ${result.page}
+Source access: ${result.access}
+Review: ${result.link}
 ${format(result)}` : format(result)
       );
     if (result && ["refused", "diverged", "conflict", "invalid"].includes(result.status))
@@ -7782,7 +7906,8 @@ ${c.text}${c.replies.map((r) => "\n  \u21B3 " + r.text).join("")}`
           check,
           log: flags.json ? () => {
           } : console.error,
-          quiet: !!flags.json
+          quiet: !!flags.json,
+          access: flags.access === void 0 ? void 0 : parseSourceAccess(flags.access)
         });
         console.log(flags.json ? JSON.stringify(result) : format(result));
         if (result.status !== "deployed") process.exitCode = 1;