@impractical-ai/motion 0.1.10 → 0.1.11

package/README.md

@@ -34,6 +34,58 @@ Setup writes the API credential to `~/.impractical/config.json` with mode `0600`
 variables `IMPRACTICAL_API_KEY`, `IMPRACTICAL_SUPABASE_URL`, and `IMPRACTICAL_APP_URL` take
 precedence over that file.
 
+## Start from a shared video
+
+When the sender includes an editable project, the public video page has an
+**Edit this video** action. Its single command both connects your agent and
+copies the project into your workspace:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 setup --agent --from https://impractical.ai/v/SHARE_TOKEN
+```
+
+Use the real URL copied from the page. Sign in when prompted, then restart your
+coding agent. The command prints your new project URL and a prompt containing
+its project ID. Drafts stay in your Impractical workspace and are edited through
+MCP; no source is executed or written into your current directory by this command.
+
+Already connected, or retrying an interrupted import:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 clone https://impractical.ai/v/SHARE_TOKEN
+```
+
+Repeating the command returns the same copy for that share and workspace. The
+copy is independent of the sender's project. An MP4-only share cannot be cloned.
+
+## Choose who can edit a shared video
+
+Each link is **view only by default**. Upload without `--project` to share just
+the video and its public brand information; the page will hide **Edit this video**
+and the API will reject project-copy requests for that link:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share ./video.mp4 --title "For Acme" --references ./public-brand.json
+```
+
+`--project` explicitly lets recipients copy **all editable drafts and assets**
+from that project, so use a project you intend to share:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share ./video.mp4 --title "For Acme" --references ./public-brand.json --project PROJECT_ID
+```
+
+Enable cloning on an existing video share, or disable future clones:
+
+```sh
+npx --yes @impractical-ai/motion@0.1.11 share allow-editing SHARE_ID --project PROJECT_ID
+npx --yes @impractical-ai/motion@0.1.11 share view-only SHARE_ID
+```
+
+Detaching the source or revoking the video does not remove copies already owned
+by recipients. The existing upload API accepts the same opt-in as `projectId`.
+The shorter `share attach` and `share detach` aliases also remain supported.
+
 ## MCP server
 
 The installer configures supported clients to run:

package/dist/{api-4WE4LYPB.js → api-FMMG3W6J.js}

@@ -13,8 +13,8 @@ import {
   waitForJobs,
   withAdmissionReceipt,
   withMeteredCall
-} from "./chunk-CZANULCU.js";
-import "./chunk-6FVZ6IWR.js";
+} from "./chunk-VTHAZQEV.js";
+import "./chunk-HGA2O3JM.js";
 import "./chunk-77HVPD4G.js";
 export {
   ApiContractError,

package/dist/{chunk-6FVZ6IWR.js → chunk-HGA2O3JM.js}

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.10",
+  version: "0.1.11",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",
@@ -56,7 +56,7 @@ var PRODUCTION_APP_URL = "https://motion.impractical.ai";
 var PRODUCTION_SUPABASE_URL = "https://uaxjweednprtbhbceify.supabase.co";
 var PACKAGE_NAME = "@impractical-ai/motion";
 var PACKAGE_VERSION = package_default.version;
-var BUILD_COMMIT = "779568a" ? "779568a" : "dev";
+var BUILD_COMMIT = "9f06a02" ? "9f06a02" : "dev";
 var BUILD_ID = `${PACKAGE_VERSION}+${BUILD_COMMIT}`;
 var PACKAGE_COMMAND = `npx --yes ${PACKAGE_NAME}`;
 

package/dist/{chunk-WB7FRXAG.js → chunk-SN6SLPIC.js}

@@ -6,14 +6,14 @@ import {
   loadConfig,
   recoverCorruptConfig,
   saveConfig
-} from "./chunk-CZANULCU.js";
+} from "./chunk-VTHAZQEV.js";
 import {
   PACKAGE_COMMAND,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-6FVZ6IWR.js";
+} from "./chunk-HGA2O3JM.js";
 
 // src/onboarding.ts
 import {

package/dist/{chunk-CZANULCU.js → chunk-VTHAZQEV.js}

@@ -2,7 +2,7 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-6FVZ6IWR.js";
+} from "./chunk-HGA2O3JM.js";
 
 // src/config.ts
 import {
@@ -141,6 +141,9 @@ function bodyRecord(body) {
 function validateApiResponse(name, body, data) {
   if (!isRecord(data)) throw new ApiContractError(name, "a JSON object");
   const input = bodyRecord(body);
+  if (name === "video-shares" && input.action === "clone" && (typeof data.projectId !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(data.projectId) || typeof data.alreadyForked !== "boolean")) {
+    throw new ApiContractError(name, "a projectId and alreadyForked flag");
+  }
   if (name === "workspace-bootstrap") {
     const billing = data.billing;
     if (typeof data.orgId !== "string" || typeof data.plan !== "string" || typeof data.hasAccess !== "boolean" || !isRecord(billing) || typeof billing.status !== "string") {

package/dist/{commands-YJFMKK2K.js → commands-EDRH2XMY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-WB7FRXAG.js";
+} from "./chunk-SN6SLPIC.js";
 import {
   invoke,
   invokeAt,
@@ -11,8 +11,8 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-CZANULCU.js";
-import "./chunk-6FVZ6IWR.js";
+} from "./chunk-VTHAZQEV.js";
+import "./chunk-HGA2O3JM.js";
 import "./chunk-77HVPD4G.js";
 
 // src/commands.ts
@@ -1204,6 +1204,133 @@ function buildInitialFiles(input) {
 // ../src/shared/video-models.ts
 var DEFAULT_OPENROUTER_VIDEO_MODEL = "anthropic/claude-opus-5";
 
+// ../src/shared/video-clone-command.ts
+var TOKEN = /^[A-Za-z0-9_-]{43}$/;
+var SHARE_HOSTS = /* @__PURE__ */ new Set(["impractical.ai", "www.impractical.ai", "impractical-video-shares.vercel.app"]);
+function videoShareToken(source) {
+  if (TOKEN.test(source)) return source;
+  try {
+    const url = new URL(source);
+    const token = url.pathname.match(/^\/v\/([A-Za-z0-9_-]{43})\/?$/)?.[1];
+    if (url.protocol === "https:" && SHARE_HOSTS.has(url.host) && !url.username && !url.password && !url.search && !url.hash && token) return token;
+  } catch {
+  }
+  throw new Error("Use an Impractical video share URL: https://impractical.ai/v/<token>");
+}
+
+// src/clone-video-project.ts
+async function cloneVideoProject(source, json = false) {
+  const token = videoShareToken(source);
+  const result = await invoke("video-shares", { action: "clone", token });
+  const url = studioLink(requireConfig().appUrl, result.projectId);
+  if (json) {
+    console.log(JSON.stringify({ ...result, url }, null, 2));
+    return;
+  }
+  console.log(result.alreadyForked ? "Your editable copy is ready." : "Copied the project into your workspace.");
+  console.log(`Open: ${url}`);
+  console.log(`Project: ${result.projectId}`);
+  console.log("After restarting your agent, paste:");
+  console.log(`Use Impractical to open project ${result.projectId} and help me iterate on this video.`);
+}
+
+// src/video-sharing.ts
+import { openAsBlob } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { basename as basename2, extname as extname2 } from "node:path";
+async function shareVideo(rest, flags) {
+  const config = requireConfig();
+  const request = async (body) => {
+    const response = await fetch(
+      `${config.supabaseUrl.replace(/\/$/, "")}/functions/v1/video-shares`,
+      {
+        method: body ? "POST" : "GET",
+        redirect: "error",
+        signal: AbortSignal.timeout(45e3),
+        headers: { authorization: `Bearer ${config.apiKey}`, "content-type": "application/json" },
+        body: body ? JSON.stringify(body) : void 0
+      }
+    );
+    const data = await response.json().catch(() => ({}));
+    if (!response.ok) throw new Error(data.error || `Video sharing failed (${response.status})`);
+    return data;
+  };
+  if (rest[0] === "list") {
+    console.log(JSON.stringify(await request(), null, 2));
+    return;
+  }
+  if (rest[0] === "revoke") {
+    if (!rest[1]) throw new Error("Usage: impractical share revoke <share-id>");
+    await request({ action: "revoke", id: rest[1] });
+    console.log("Share link revoked. Already-open videos may remain playable for up to 5 minutes.");
+    return;
+  }
+  const allowEditing = rest[0] === "allow-editing" || rest[0] === "attach";
+  const viewOnly = rest[0] === "view-only" || rest[0] === "detach";
+  if (allowEditing || viewOnly) {
+    if (!rest[1] || allowEditing && typeof flags.project !== "string") {
+      throw new Error("Usage: impractical share allow-editing <share-id> --project <id> | share view-only <share-id>");
+    }
+    await request({ action: "attach-project", id: rest[1], projectId: viewOnly ? null : flags.project });
+    console.log(allowEditing ? "Editing allowed for this link. Recipients can make their own editable copy." : "This link is now view only. Future project copies are disabled; existing recipient copies remain theirs.");
+    return;
+  }
+  const filePath = rest[0];
+  if (!filePath || extname2(filePath).toLowerCase() !== ".mp4") {
+    throw new Error(
+      'Usage: impractical share ./video.mp4 [--title "A video for Acme"] [--message "..."] [--references ./public-brand.json] [--project <id>] [--expires-in 7] [--json]'
+    );
+  }
+  const info = await stat(filePath);
+  if (!info.isFile() || info.size < 16 || info.size > 3e8) {
+    throw new Error("Choose an MP4 up to 300 MB");
+  }
+  const days = flags["expires-in"] === void 0 ? null : Number(flags["expires-in"]);
+  if (days !== null && (!Number.isFinite(days) || days <= 0 || days > 3650)) {
+    throw new Error("--expires-in must be a number of days between 0 and 3650");
+  }
+  const file = await openAsBlob(filePath, { type: "video/mp4" });
+  const header = new Uint8Array(await file.slice(0, 16).arrayBuffer());
+  if (String.fromCharCode(...header.slice(4, 8)) !== "ftyp") {
+    throw new Error("This file does not have an MP4 header");
+  }
+  let references;
+  if (typeof flags.references === "string") {
+    const metadataFile = await stat(flags.references);
+    if (!metadataFile.isFile() || metadataFile.size > 4e6) throw new Error("Public references must be a JSON file up to 4 MB");
+    references = JSON.parse(await readFile(flags.references, "utf8"));
+  }
+  const prepared = await request({
+    action: "prepare",
+    bytes: info.size,
+    title: typeof flags.title === "string" ? flags.title : basename2(filePath, extname2(filePath)).slice(0, 160),
+    message: typeof flags.message === "string" ? flags.message : "",
+    expiresAt: days === null ? null : new Date(Date.now() + days * 864e5).toISOString(),
+    ...references === void 0 ? {} : { references },
+    ...typeof flags.project === "string" ? { projectId: flags.project } : {}
+  });
+  try {
+    const form = new FormData();
+    form.append("cacheControl", "0");
+    form.append("", file, basename2(filePath));
+    const response = await fetch(prepared.upload.signedUrl, {
+      method: "PUT",
+      body: form,
+      headers: { "x-upsert": "false" },
+      redirect: "error",
+      signal: AbortSignal.timeout(15 * 6e4)
+    });
+    await response.body?.cancel();
+    if (!response.ok) throw new Error(`MP4 upload failed (${response.status}). Please try again`);
+    const share = await request({ action: "complete", id: prepared.id });
+    console.log(flags.json ? JSON.stringify(share, null, 2) : share.url);
+  } catch (error) {
+    await request({ action: "revoke", id: prepared.id }).catch(() => {
+    });
+    throw error;
+  }
+}
+
 // src/commands.ts
 var flagString = (flags, name) => {
   const value = flags[name];
@@ -1218,6 +1345,8 @@ var flagList = (flags, name) => {
 var flagBool = (flags, name) => flags[name] === true;
 var out = (line) => console.log(line);
 async function setup2(flags) {
+  const source = flagString(flags, "from");
+  if (source !== void 0) videoShareToken(source);
   const claude = flagBool(flags, "claude");
   const agent = flagBool(flags, "agent");
   await setup({
@@ -1227,6 +1356,11 @@ async function setup2(flags) {
     openBrowser: !flagBool(flags, "no-open"),
     log: out
   });
+  if (source !== void 0) await cloneVideoProject(source);
+}
+async function clone(positional, flags) {
+  if (positional.length !== 1) throw new Error("Usage: impractical clone <video-share-url> [--json]");
+  await cloneVideoProject(positional[0], flagBool(flags, "json"));
 }
 async function login(flags) {
   const patch = {};
@@ -1522,12 +1656,14 @@ function validateMeteredCommand(command, positional, flags) {
 }
 export {
   brand,
+  clone,
   exportDraft,
   generate,
   keys,
   link,
   login,
   setup2 as setup,
+  shareVideo,
   status,
   upload,
   validateMeteredCommand,

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PACKAGE_VERSION
-} from "./chunk-6FVZ6IWR.js";
+} from "./chunk-HGA2O3JM.js";
 import "./chunk-77HVPD4G.js";
 
 // src/cli-args.ts
@@ -17,6 +17,7 @@ var CLI_OPTIONS = {
   brand: { type: "string" },
   asset: { type: "string", multiple: true },
   project: { type: "string" },
+  from: { type: "string" },
   feedback: { type: "string" },
   model: { type: "string" },
   slug: { type: "string" },
@@ -26,6 +27,11 @@ var CLI_OPTIONS = {
   out: { type: "string" },
   draft: { type: "string" },
   id: { type: "string" },
+  title: { type: "string" },
+  message: { type: "string" },
+  references: { type: "string" },
+  "expires-in": { type: "string" },
+  json: { type: "boolean" },
   wait: { type: "boolean" },
   agent: { type: "boolean" },
   claude: { type: "boolean" },
@@ -48,6 +54,7 @@ var HELP = `impractical \u2014 Impractical Motion from your terminal (and your c
 Setup
   setup --claude                Sign in and install the Claude plugin + MCP
   setup --agent                 Sign in and install MCP for detected coding agents
+        --from <video-share-url> Also copy the shared project into your workspace
   login --key imk_...           Manual credential override for development
   whoami                       Show org and plan status
   keys [list|revoke <id>]      List or revoke agent API keys
@@ -66,6 +73,14 @@ Edit drafts
   Editing happens through the MCP server (see "Agents" above) \u2014 draft source
   lives in the cloud, so there is no working copy to pull or push.
   link <projectId> [slug]      Print the studio tweak-UI URL
+  clone <video-share-url>      Add an editable copy to your connected workspace
+
+Share videos
+  share <file.mp4> [--title "..."] [--references brand.json] [--project <id>]
+        Omit --project for a view-only link (the default)
+  share allow-editing <share-id> --project <id>  Let recipients copy and edit
+  share view-only <share-id>   Hide editing and block future project copies
+  share list | share revoke <share-id>
 
 Assets & brands
   upload <file> --project <id> --draft <id>
@@ -97,6 +112,10 @@ async function runCli(args, deps) {
   switch (command) {
     case "setup":
       return commands.setup(flags);
+    case "clone":
+      return commands.clone(rest, flags);
+    case "share":
+      return commands.shareVideo(rest, flags);
     case "motion":
       if (rest[0] === "wizard") return commands.setup(flags);
       break;
@@ -140,11 +159,11 @@ async function runCli(args, deps) {
 // src/index.ts
 runCli(process.argv.slice(2), {
   writeLine: (line) => console.log(line),
-  loadCommands: () => import("./commands-YJFMKK2K.js"),
-  loadApi: () => import("./api-4WE4LYPB.js"),
-  loadMcp: () => import("./stdio-S7VGBKNS.js")
+  loadCommands: () => import("./commands-EDRH2XMY.js"),
+  loadApi: () => import("./api-FMMG3W6J.js"),
+  loadMcp: () => import("./stdio-VBPVT2KS.js")
 }).catch(async (error) => {
-  const { ApiError } = await import("./api-4WE4LYPB.js");
+  const { ApiError } = await import("./api-FMMG3W6J.js");
   if (error instanceof ApiError) {
     console.error(`Error (${error.status} from ${error.fn}): ${error.message}`);
     if (error.status === 429) console.error("Weekly MCP allowance reached. Upgrade or wait for Monday UTC.");

package/dist/{stdio-S7VGBKNS.js → stdio-VBPVT2KS.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   openBrowser
-} from "./chunk-WB7FRXAG.js";
+} from "./chunk-SN6SLPIC.js";
 import {
   ApiError,
   admitMcpCall,
@@ -11,13 +11,13 @@ import {
   saveConfig,
   validateApiResponse,
   withAdmissionReceipt
-} from "./chunk-CZANULCU.js";
+} from "./chunk-VTHAZQEV.js";
 import {
   BUILD_COMMIT,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-6FVZ6IWR.js";
+} from "./chunk-HGA2O3JM.js";
 import {
   __commonJS,
   __export,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impractical-ai/motion",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": false,
   "description": "Create and refine Impractical Motion videos from coding agents and the terminal.",
   "homepage": "https://github.com/Openpod/impractical-motion#readme",