@impractical-ai/motion 0.1.10 → 0.1.12

package/assets/impractical/SKILL.md

@@ -5,6 +5,18 @@ description: Create and refine studio-quality motion-graphics launch videos with
 
 # Impractical Motion
 
+<!-- ARRIVAL-DRIFT-STANDARD START -->
+## Default motion: arrival and residual drift
+
+Foreground motion defaults to an energetic arrival, strong deceleration, and small continuing travel through the reading hold. Compose a deterministic residual trajectory with the native entrance; do not stop and restart with a disconnected tween. “Settled” and “hold” mean readable and visually stable, with subtle nonzero travel unless an explicit freeze, exact alignment or reduced-motion mode requires stillness.
+
+Use the Rox `ambientOffset(seconds, amount, phase)` pattern: native 960×540 product groups start around amount 3.2–4, text around 0.8–1. Keep a signed velocity floor with gentle curvature, not a pure sine bob. Move attached labels, controls, connectors and shadows together, avoid double drift, preserve 3D hierarchy, and verify reverse/retimed seeks and late-hold displacement.
+
+The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Keep one primary focus and room around it; purposeful object camera moves remain welcome, and a generic card is not the default visual container.
+
+For the complete trajectory and review checks, read `motion_context` → `guidance.director` before authoring.
+<!-- ARRIVAL-DRIFT-STANDARD END -->
+
 You direct the video yourself. Impractical provides the engine, the preview
 build, the render, and the studio the user tweaks in — you provide the
 direction. Everything runs through the **Impractical MCP server**; the video's

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

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

package/dist/{chunk-WB7FRXAG.js → chunk-4JSZNV7I.js}

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

package/dist/{chunk-CZANULCU.js → chunk-6GR7BQDV.js}

@@ -2,7 +2,7 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-6FVZ6IWR.js";
+} from "./chunk-ACBYTWXK.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/{chunk-6FVZ6IWR.js → chunk-ACBYTWXK.js}

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.10",
+  version: "0.1.12",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",
@@ -18,7 +18,8 @@ var package_default = {
   type: "module",
   files: [
     "dist",
-    "assets",
+    "assets/impractical",
+    "assets/engine.d.ts",
     "README.md"
   ],
   bin: {
@@ -31,7 +32,8 @@ var package_default = {
     build: 'node ../scripts/verify-locked-cli-install.mjs && node ../scripts/build-engine-dts.mjs --cli-only && rm -rf dist && ./node_modules/esbuild/bin/esbuild src/index.ts --define:__BUILD_COMMIT__=\\"$(git rev-parse --short HEAD 2>/dev/null || echo dev)\\" --bundle --platform=node --format=esm --target=node22 --splitting --outdir=dist --external:playwright-core --banner:js="#!/usr/bin/env node" && chmod +x dist/index.js',
     typecheck: "tsc --noEmit",
     test: "npm run typecheck && npm run build && esbuild tests/onboarding.test.ts tests/mcp-tools.test.ts tests/mcp-frames.test.ts tests/mcp-browser-pool.test.ts tests/mcp-motion.test.ts tests/mcp-craft.test.ts tests/mcp-depthkit.test.ts tests/mcp-motion-score.test.ts tests/mcp-install-font.test.ts tests/mcp-metric-catalog.test.ts tests/mcp-text-census.test.ts tests/mcp-phased-flow.test.ts tests/mcp-preflight.test.ts tests/engine-dts.test.ts tests/mcp-connect.test.ts tests/mcp-longpoll.test.ts tests/mcp-agent-timeout.test.ts tests/api-hardening.test.ts --bundle --platform=node --format=esm --packages=external --outdir=dist --out-extension:.js=.mjs && node --test dist/onboarding.test.mjs dist/mcp-tools.test.mjs dist/mcp-frames.test.mjs dist/mcp-browser-pool.test.mjs dist/mcp-motion.test.mjs dist/mcp-craft.test.mjs dist/mcp-depthkit.test.mjs dist/mcp-motion-score.test.mjs dist/mcp-install-font.test.mjs dist/mcp-metric-catalog.test.mjs dist/mcp-text-census.test.mjs dist/mcp-phased-flow.test.mjs dist/mcp-preflight.test.mjs dist/engine-dts.test.mjs dist/mcp-connect.test.mjs dist/mcp-longpoll.test.mjs dist/mcp-agent-timeout.test.mjs dist/api-hardening.test.mjs",
-    prepack: "npm run build"
+    prepack: "npm run build",
+    "test:rig": "npm run typecheck && esbuild tests/engine-dts.test.ts tests/mcp-agent-timeout.test.ts tests/mcp-browser-pool.test.ts tests/mcp-component-assertions.test.ts tests/mcp-components.test.ts tests/mcp-connect.test.ts tests/mcp-craft.test.ts tests/mcp-depthkit.test.ts tests/mcp-exposed-ground.test.ts tests/mcp-frames.test.ts tests/mcp-install-font.test.ts tests/mcp-legibility.test.ts tests/mcp-longpoll.test.ts tests/mcp-metric-catalog.test.ts tests/mcp-motion-score.test.ts tests/mcp-motion-slop.test.ts tests/mcp-motion.test.ts tests/mcp-phased-flow.test.ts tests/mcp-preflight.test.ts tests/mcp-ref-inject.test.ts tests/mcp-shot-list.test.ts tests/mcp-text-census.test.ts tests/mcp-tools.test.ts tests/review-modules.test.ts tests/rig-transplant.test.ts --bundle --platform=node --format=esm --packages=external --outdir=.rig-tests --out-extension:.js=.mjs && node --test .rig-tests/engine-dts.test.mjs .rig-tests/mcp-agent-timeout.test.mjs .rig-tests/mcp-browser-pool.test.mjs .rig-tests/mcp-component-assertions.test.mjs .rig-tests/mcp-components.test.mjs .rig-tests/mcp-connect.test.mjs .rig-tests/mcp-craft.test.mjs .rig-tests/mcp-depthkit.test.mjs .rig-tests/mcp-exposed-ground.test.mjs .rig-tests/mcp-frames.test.mjs .rig-tests/mcp-install-font.test.mjs .rig-tests/mcp-legibility.test.mjs .rig-tests/mcp-longpoll.test.mjs .rig-tests/mcp-metric-catalog.test.mjs .rig-tests/mcp-motion-score.test.mjs .rig-tests/mcp-motion-slop.test.mjs .rig-tests/mcp-motion.test.mjs .rig-tests/mcp-phased-flow.test.mjs .rig-tests/mcp-preflight.test.mjs .rig-tests/mcp-ref-inject.test.mjs .rig-tests/mcp-shot-list.test.mjs .rig-tests/mcp-text-census.test.mjs .rig-tests/mcp-tools.test.mjs .rig-tests/review-modules.test.mjs .rig-tests/rig-transplant.test.mjs"
   },
   publishConfig: {
     access: "public"
@@ -56,7 +58,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 = "3fd1ba6" ? "3fd1ba6" : "dev";
 var BUILD_ID = `${PACKAGE_VERSION}+${BUILD_COMMIT}`;
 var PACKAGE_COMMAND = `npx --yes ${PACKAGE_NAME}`;
 

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-WB7FRXAG.js";
+} from "./chunk-4JSZNV7I.js";
 import {
   invoke,
   invokeAt,
@@ -11,8 +11,8 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-CZANULCU.js";
-import "./chunk-6FVZ6IWR.js";
+} from "./chunk-6GR7BQDV.js";
+import "./chunk-ACBYTWXK.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-ACBYTWXK.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,15 @@ 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 "..."] [--message "..."] [--expires-in 7] [--json]
+        [--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 +113,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 +160,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-K6AOA7CK.js"),
+  loadApi: () => import("./api-3IX5MBOY.js"),
+  loadMcp: () => import("./stdio-HFGQR34V.js")
 }).catch(async (error) => {
-  const { ApiError } = await import("./api-4WE4LYPB.js");
+  const { ApiError } = await import("./api-3IX5MBOY.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/{main-BEONOBG5.js → main-72BNF5J2.js}

@@ -4,9 +4,9 @@ import {
   __require
 } from "./chunk-77HVPD4G.js";
 
-// node_modules/esbuild/lib/main.js
+// ../../../../Desktop/impractical-motion/impractical-motion/cli/node_modules/esbuild/lib/main.js
 var require_main = __commonJS({
-  "node_modules/esbuild/lib/main.js"(exports, module) {
+  "../../../../Desktop/impractical-motion/impractical-motion/cli/node_modules/esbuild/lib/main.js"(exports, module) {
     var __defProp = Object.defineProperty;
     var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
     var __getOwnPropNames = Object.getOwnPropertyNames;