@impractical-ai/motion 0.1.13 → 0.1.15

package/README.md

@@ -1,16 +1,16 @@
 # Impractical Motion CLI
 
-<!-- ARRIVAL-DRIFT-STANDARD START -->
-## Default motion: arrival and residual drift
+<!-- MOTION-STANDARD START -->
+## Default motion: arrival, hold and exit
 
-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.
+Each foreground element follows one continuous trajectory: it arrives with energy, decelerates strongly to near-zero speed for the reading hold, then accelerates into its exit or its next authored move. Shape this with the entrance and exit eases themselves; there is no separate drift layer, no constant velocity floor and no perpetual creep. Finish the visible travel quickly: during the hold the ease tail moves the subject less than about 0.5 output px in total, so “settled” and “hold” mean visually still and readable. Exits ease in (or in-out) from that near-zero state, so nothing starts from a dead stop. This applies to whole entities, not to every element inside them: a card, product window, headline block or logo lockup arrives, holds and exits as one unit, and its children (labels, icons, rows, words, buttons) ride with it. Don't recurse and give each child its own arrival, deceleration and exit; that reads as fidgeting and splits attention. Children may still have their own discrete actions inside the hold (text typing in, a toggle flipping, a row highlighting, a number counting), but not their own arrive/hold/exit motion.
 
-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.
+Why no creep: exports render in headless Linux Chromium, which snaps slowly moving text and elements to whole pixels, so a slow drift of about 1 px/s shows up as a visible 1 px tick every ~0.9 s. Move attached labels, controls, connectors and shadows together with their subject, preserve 3D hierarchy, and verify reverse/retimed seeks.
 
-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.
+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. Make things breathe: only one focus at a time, with generous negative space and comfortable margins around it. Keep supporting context subordinate; sequence competing text and actions. Let the focal idea land and be read before handing attention to the next event. If crowded, remove or sequence content before shrinking it. Check entry, hold and exit as well as playback. Purposeful object camera moves remain welcome; a generic card is not the default visual container.
 
 Full specification: [motion standard](../docs/motion-standard.md).
-<!-- ARRIVAL-DRIFT-STANDARD END -->
+<!-- MOTION-STANDARD END -->
 
 Connect Claude Code, Codex, Cursor, or OpenCode to Impractical Motion through
 its MCP server.
@@ -134,5 +134,11 @@ Opt-in flags on the MCP process, for testing quality interventions without touch
 - `IMPRACTICAL_MOTION_LIBRARY_FILE=<path>` — overlay locally generated motion-library
   guidance onto the live catalog.
 
+With quality-loop checks active, text-density findings (`OVERLOADED`) from `get_motion`
+are advisory and never refuse `export_video`: UI labels can exceed the density threshold
+without making a beat unreadable. Review the findings and simplify crowded beats when needed.
+Other shot-list and study-timing findings still refuse export once per draft revision in each
+MCP session; a second attempt on that revision can pass that gate. Other export gates still apply.
+
 If authorization is rejected, rerun the setup command. If the configuration file is malformed,
 the CLI reports its exact path instead of silently ignoring it.

package/assets/impractical/SKILL.md

@@ -5,17 +5,17 @@ description: Create and refine studio-quality motion-graphics launch videos with
 
 # Impractical Motion
 
-<!-- ARRIVAL-DRIFT-STANDARD START -->
-## Default motion: arrival and residual drift
+<!-- MOTION-STANDARD START -->
+## Default motion: arrival, hold and exit
 
-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.
+Each foreground element follows one continuous trajectory: it arrives with energy, decelerates strongly to near-zero speed for the reading hold, then accelerates into its exit or its next authored move. Shape this with the entrance and exit eases themselves; there is no separate drift layer, no constant velocity floor and no perpetual creep. Finish the visible travel quickly: during the hold the ease tail moves the subject less than about 0.5 output px in total, so “settled” and “hold” mean visually still and readable. Exits ease in (or in-out) from that near-zero state, so nothing starts from a dead stop. This applies to whole entities, not to every element inside them: a card, product window, headline block or logo lockup arrives, holds and exits as one unit, and its children (labels, icons, rows, words, buttons) ride with it. Don't recurse and give each child its own arrival, deceleration and exit; that reads as fidgeting and splits attention. Children may still have their own discrete actions inside the hold (text typing in, a toggle flipping, a row highlighting, a number counting), but not their own arrive/hold/exit motion.
 
-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.
+Why no creep: exports render in headless Linux Chromium, which snaps slowly moving text and elements to whole pixels, so a slow drift of about 1 px/s shows up as a visible 1 px tick every ~0.9 s. Move attached labels, controls, connectors and shadows together with their subject, preserve 3D hierarchy, and verify reverse/retimed seeks.
 
-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.
+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. Make things breathe: only one focus at a time, with generous negative space and comfortable margins around it. Keep supporting context subordinate; sequence competing text and actions. Let the focal idea land and be read before handing attention to the next event. If crowded, remove or sequence content before shrinking it. Check entry, hold and exit as well as playback. Purposeful object camera moves remain welcome; 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 -->
+For the complete standard and review checks, read `motion_context` → `guidance.director` before authoring.
+<!-- MOTION-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

package/dist/{api-4YQKINQI.js → api-UXWCLV7P.js}

@@ -3,29 +3,33 @@ import {
   ApiContractError,
   ApiError,
   ApiTransportError,
+  WORKSPACE_HEADER,
   admitMcpCall,
   delay,
   invoke,
   invokeAt,
   jobStatus,
   studioLink,
+  studioQuery,
   validateApiResponse,
   waitForJobs,
   withAdmissionReceipt,
   withMeteredCall
-} from "./chunk-GAHKKLF3.js";
-import "./chunk-PTYSKJ2Y.js";
+} from "./chunk-2VIBS7AS.js";
+import "./chunk-52D5QRLI.js";
 import "./chunk-77HVPD4G.js";
 export {
   ApiContractError,
   ApiError,
   ApiTransportError,
+  WORKSPACE_HEADER,
   admitMcpCall,
   delay,
   invoke,
   invokeAt,
   jobStatus,
   studioLink,
+  studioQuery,
   validateApiResponse,
   waitForJobs,
   withAdmissionReceipt,

package/dist/{chunk-GAHKKLF3.js → chunk-2VIBS7AS.js}

@@ -2,9 +2,9 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-PTYSKJ2Y.js";
+} from "./chunk-52D5QRLI.js";
 
-// src/config.ts
+// cli/src/config.ts
 import {
   chmodSync,
   existsSync,
@@ -63,7 +63,9 @@ Run: npx --yes @impractical-ai/motion setup --agent`
 }
 function loadConfig() {
   const stored = readStoredConfig();
+  const workspace = process.env.IMPRACTICAL_WORKSPACE?.trim() || void 0;
   return {
+    ...workspace ? { workspace } : {},
     apiKey: process.env.IMPRACTICAL_API_KEY ?? stored.apiKey,
     supabaseUrl: process.env.IMPRACTICAL_SUPABASE_URL ?? stored.supabaseUrl ?? PRODUCTION_SUPABASE_URL,
     appUrl: process.env.IMPRACTICAL_APP_URL ?? stored.appUrl ?? PRODUCTION_APP_URL
@@ -104,7 +106,7 @@ function requireConfig() {
   return config;
 }
 
-// src/api.ts
+// cli/src/api.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { randomUUID } from "node:crypto";
 var admissionContext = new AsyncLocalStorage();
@@ -144,7 +146,15 @@ function validateApiResponse(name, body, data) {
   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") {
+  if (name === "workspace-bootstrap" && input.action === "project_workspace") {
+    if (!("workspace" in data) || "orgId" in data) {
+      throw new ApiContractError(name, "a workspace field");
+    }
+  } else if (name === "workspace-bootstrap" && input.action === "list_workspaces") {
+    if (!Array.isArray(data.workspaces)) {
+      throw new ApiContractError(name, "an object with a workspaces array");
+    }
+  } else 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") {
       throw new ApiContractError(
@@ -188,12 +198,13 @@ function validateApiResponse(name, body, data) {
   }
   return data;
 }
+var WORKSPACE_HEADER = "x-impractical-workspace";
 async function invoke(name, body = {}) {
-  const { apiKey, supabaseUrl } = requireConfig();
-  const receipt = admissionContext.getStore();
-  return invokeAt(supabaseUrl, name, body, apiKey, receipt);
+  const { apiKey, supabaseUrl, workspace } = requireConfig();
+  const call = admissionContext.getStore();
+  return invokeAt(supabaseUrl, name, body, apiKey, call?.receipt, call ? call.workspace : workspace);
 }
-async function invokeAt(supabaseUrl, name, body = {}, apiKey, admissionReceipt) {
+async function invokeAt(supabaseUrl, name, body = {}, apiKey, admissionReceipt, workspace) {
   const requestUrl = `${supabaseUrl.replace(/\/$/, "")}/functions/v1/${name}`;
   let response;
   try {
@@ -202,6 +213,7 @@ async function invokeAt(supabaseUrl, name, body = {}, apiKey, admissionReceipt)
       headers: {
         ...apiKey ? { authorization: `Bearer ${apiKey}` } : {},
         ...admissionReceipt ? { "x-impractical-admission": admissionReceipt } : {},
+        ...apiKey && workspace ? { [WORKSPACE_HEADER]: workspace } : {},
         "content-type": "application/json"
       },
       body: JSON.stringify(body)
@@ -231,16 +243,33 @@ async function invokeAt(supabaseUrl, name, body = {}, apiKey, admissionReceipt)
   }
   return validateApiResponse(name, body, data);
 }
-async function admitMcpCall(toolName, callId = randomUUID()) {
+async function admitMcpCall(toolName, target, callId = randomUUID()) {
   const { apiKey, supabaseUrl } = requireConfig();
-  return invokeAt(supabaseUrl, "mcp-admission", { callId, toolName }, apiKey);
+  return invokeAt(
+    supabaseUrl,
+    "mcp-admission",
+    { callId, toolName, ...target && Object.keys(target).length ? { target } : {} },
+    apiKey
+  );
 }
-function withAdmissionReceipt(receipt, task) {
-  return admissionContext.run(receipt, task);
+function withAdmissionReceipt(receipt, task, workspace) {
+  return admissionContext.run({ receipt, workspace }, task);
 }
 async function withMeteredCall(toolName, task) {
-  const admission = await admitMcpCall(toolName);
-  return withAdmissionReceipt(admission.receipt, task);
+  const { workspace } = requireConfig();
+  const admission = await admitMcpCall(toolName, workspace ? { workspace } : void 0);
+  return withAdmissionReceipt(
+    admission.receipt,
+    task,
+    admission.keyScope === "user" ? admission.workspace?.id : void 0
+  );
+}
+function studioQuery(slug, workspace) {
+  const params = [
+    ...slug ? [`scene=${slug}`] : [],
+    ...workspace ? [`workspace=${encodeURIComponent(workspace)}`] : []
+  ];
+  return params.length ? `?${params.join("&")}` : "";
 }
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function jobStatus(jobIds) {
@@ -264,9 +293,9 @@ async function waitForJobs(jobIds, onTick, deadlineMs = 72e5) {
   }
   return latest;
 }
-function studioLink(appUrl, projectId, slug) {
+function studioLink(appUrl, projectId, slug, workspace) {
   const base = (appUrl ?? "http://localhost:5173").replace(/\/$/, "");
-  return `${base}/projects/${projectId}/studio${slug ? `?scene=${slug}` : ""}`;
+  return `${base}/projects/${projectId}/studio${studioQuery(slug, workspace)}`;
 }
 
 export {
@@ -278,11 +307,13 @@ export {
   ApiContractError,
   ApiTransportError,
   validateApiResponse,
+  WORKSPACE_HEADER,
   invoke,
   invokeAt,
   admitMcpCall,
   withAdmissionReceipt,
   withMeteredCall,
+  studioQuery,
   delay,
   jobStatus,
   waitForJobs,

package/dist/{chunk-PTYSKJ2Y.js → chunk-52D5QRLI.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-// package.json
+// cli/package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.13",
+  version: "0.1.15",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",
@@ -30,7 +30,7 @@ var package_default = {
   scripts: {
     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",
+    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-workspaces.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-workspaces.test.mjs dist/mcp-longpoll.test.mjs dist/mcp-agent-timeout.test.mjs dist/api-hardening.test.mjs",
     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"
   },
@@ -43,13 +43,13 @@ var package_default = {
     typescript: "^5.6.3"
   },
   dependencies: {
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "playwright-core": "^1.55.1",
     zod: "^4.4.3"
   }
 };
 
-// src/constants.ts
+// cli/src/constants.ts
 if (package_default.name !== "@impractical-ai/motion" || typeof package_default.version !== "string" || !package_default.version) {
   throw new Error("The packaged CLI manifest is missing valid release metadata");
 }
@@ -57,7 +57,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 = "ffb78fc" ? "ffb78fc" : "dev";
+var BUILD_COMMIT = "e3a238b6" ? "e3a238b6" : "dev";
 var BUILD_ID = `${PACKAGE_VERSION}+${BUILD_COMMIT}`;
 var PACKAGE_COMMAND = `npx --yes ${PACKAGE_NAME}`;
 

package/dist/{chunk-ZCTJTQB7.js → chunk-TPFRXA7C.js}

@@ -1,21 +1,22 @@
 #!/usr/bin/env node
 import {
+  ApiContractError,
   ApiError,
   delay,
   invokeAt,
   loadConfig,
   recoverCorruptConfig,
   saveConfig
-} from "./chunk-GAHKKLF3.js";
+} from "./chunk-2VIBS7AS.js";
 import {
   PACKAGE_COMMAND,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-PTYSKJ2Y.js";
+} from "./chunk-52D5QRLI.js";
 
-// src/onboarding.ts
+// cli/src/onboarding.ts
 import {
   chmodSync,
   existsSync,
@@ -31,6 +32,48 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
+
+// cli/src/workspaces.ts
+var UNSUPPORTED = {
+  supported: false,
+  keyScope: null,
+  lastOpenWorkspaceId: null,
+  workspaces: []
+};
+async function fetchWorkspaces(request) {
+  let result;
+  try {
+    result = await request("workspace-bootstrap", { action: "list_workspaces" });
+  } catch (error) {
+    if (error instanceof ApiContractError) return UNSUPPORTED;
+    throw error;
+  }
+  if (!Array.isArray(result?.workspaces)) return UNSUPPORTED;
+  const keyScope = result.keyScope === "user" ? "user" : result.keyScope === "org" ? "org" : null;
+  const workspaces = result.workspaces.filter((row) => typeof row?.id === "string").map((row) => ({
+    id: String(row.id),
+    name: typeof row.name === "string" ? row.name : null,
+    slug: typeof row.slug === "string" ? row.slug : null,
+    role: typeof row.role === "string" ? row.role : "",
+    plan: typeof row.plan === "string" ? row.plan : null,
+    usage: row.usage && typeof row.usage === "object" ? row.usage : null
+  }));
+  return {
+    supported: true,
+    keyScope,
+    lastOpenWorkspaceId: typeof result.lastOpenWorkspaceId === "string" ? result.lastOpenWorkspaceId : null,
+    workspaces
+  };
+}
+function workspaceLabel(workspace) {
+  return workspace.name ? `${workspace.name} (${workspace.id})` : workspace.id;
+}
+var DEVICE_START_BODY = { action: "start", scope: "user" };
+function grantScope(grant) {
+  return grant.scope === "user" ? "user" : "org";
+}
+
+// cli/src/onboarding.ts
 var CLAUDE_MARKETPLACE = "Openpod/impractical-agent-plugins";
 var CLAUDE_PLUGIN = "impractical-motion@impractical";
 var CLAUDE_MARKETPLACE_NAME = "impractical";
@@ -656,7 +699,7 @@ async function waitForApproval(supabaseUrl, authorization, log, setupFlag) {
       action: "poll",
       deviceCode: authorization.deviceCode
     });
-    if (result.status === "authorized") return result.apiKey;
+    if (result.status === "authorized") return result;
     if (!announced) {
       log("Waiting for browser approval\u2026");
       announced = true;
@@ -681,9 +724,25 @@ async function setup(options) {
   const existing = loadConfig();
   let apiKey = existing.supabaseUrl === supabaseUrl ? existing.apiKey : void 0;
   let verified;
+  let workspacesLine;
+  const listWorkspaces = async (key) => {
+    const listing = await fetchWorkspaces((name, body) => invokeAt(supabaseUrl, name, body, key));
+    workspacesLine = `Workspaces: ${listing.workspaces.map(workspaceLabel).join(", ") || "none yet"} (one key for all of them)`;
+  };
+  const verify = async (key, scope) => {
+    if (scope === "user") return listWorkspaces(key);
+    try {
+      verified = await invokeAt(supabaseUrl, "workspace-bootstrap", {}, key);
+    } catch (error) {
+      if (scope === "unknown" && error instanceof ApiError && error.status === 409 && error.details?.error === "workspace_selection_required") {
+        return listWorkspaces(key);
+      }
+      throw error;
+    }
+  };
   if (apiKey) {
     try {
-      verified = await invokeAt(supabaseUrl, "workspace-bootstrap", {}, apiKey);
+      await verify(apiKey, "unknown");
       options.log("Existing connection verified; browser authorization is not needed.");
     } catch (error) {
       if (!(error instanceof ApiError) || error.status !== 401) throw error;
@@ -692,9 +751,11 @@ async function setup(options) {
   }
   if (!apiKey) {
     if (options.installAgentMcp) verifyAgentConfigs();
-    const authorization = await invokeAt(supabaseUrl, "cli-device-auth", {
-      action: "start"
-    });
+    const authorization = await invokeAt(
+      supabaseUrl,
+      "cli-device-auth",
+      DEVICE_START_BODY
+    );
     options.log("");
     options.log("Connect Impractical Motion");
     options.log(`Code: ${authorization.userCode}`);
@@ -704,15 +765,17 @@ async function setup(options) {
       const opened = openBrowser(authorization.verificationUri);
       options.log(opened ? "Opened your browser." : "Could not open a browser automatically; use the link above.");
     }
+    let grant;
     try {
-      apiKey = await waitForApproval(supabaseUrl, authorization, options.log, setupFlag);
+      grant = await waitForApproval(supabaseUrl, authorization, options.log, setupFlag);
     } catch (error) {
       if (error instanceof ApiError && error.status === 410) {
         throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup ${setupFlag}\` again.`);
       }
       throw error;
     }
-    verified = await invokeAt(supabaseUrl, "workspace-bootstrap", {}, apiKey);
+    apiKey = grant.apiKey;
+    await verify(apiKey, grantScope(grant));
     saveConfig({ apiKey, supabaseUrl, appUrl });
   }
   const claudePlugin = options.installClaudePlugin ? installClaudePlugin(options.log) : void 0;
@@ -735,7 +798,9 @@ async function setup(options) {
     options.log(`Refreshed legacy /impractical for ${skill.harness}; previous copy preserved at ${skill.backupPath}.`);
   }
   if (claudePlugin) options.log(pluginResultLine(claudePlugin));
-  options.log(`Workspace: ${verified.orgId}${verified.plan ? ` \xB7 ${verified.plan}` : ""}`);
+  options.log(
+    workspacesLine ?? `Workspace: ${verified.orgId}${verified.plan ? ` \xB7 ${verified.plan}` : ""}`
+  );
   options.log("");
   if (options.installClaudePlugin) {
     options.log("Run /reload-plugins, then type continue.");
@@ -752,6 +817,10 @@ async function setup(options) {
 }
 
 export {
+  fetchWorkspaces,
+  workspaceLabel,
+  DEVICE_START_BODY,
+  grantScope,
   openBrowser,
   setup
 };

package/dist/{commands-NWJK7ANI.js → commands-MJSGITIZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-ZCTJTQB7.js";
+} from "./chunk-TPFRXA7C.js";
 import {
   invoke,
   invokeAt,
@@ -11,15 +11,15 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-GAHKKLF3.js";
-import "./chunk-PTYSKJ2Y.js";
+} from "./chunk-2VIBS7AS.js";
+import "./chunk-52D5QRLI.js";
 import "./chunk-77HVPD4G.js";
 
-// src/commands.ts
+// cli/src/commands.ts
 import { readFileSync as readFileSync2, writeFileSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 
-// src/media.ts
+// cli/src/media.ts
 import { readFileSync, statSync } from "node:fs";
 import { basename, extname } from "node:path";
 var MAX_UPLOAD_BYTES = 3e8;
@@ -79,7 +79,7 @@ async function uploadAsset(input) {
   return registered.assetId;
 }
 
-// ../src/studio/sampleLogos.ts
+// src/studio/sampleLogos.ts
 var SAMPLE_LOGOS = [
   {
     id: "bolt",
@@ -117,7 +117,7 @@ function sampleLogo(id) {
   return SAMPLE_LOGOS.find((s) => s.id === id);
 }
 
-// ../src/studio/templates.ts
+// src/studio/templates.ts
 var esc = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
 var escTemplate = (s) => s.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
 var num = (v, fallback) => {
@@ -1091,7 +1091,7 @@ var TEMPLATES = [
   blank
 ];
 
-// ../src/studio/parseFiles.ts
+// src/studio/parseFiles.ts
 var FENCE = /```([^\n`]*)\n([\s\S]*?)```/g;
 var DROP = /* @__PURE__ */ new Set([
   "index.tsx",
@@ -1143,7 +1143,7 @@ function parseSceneFiles(pasted) {
   return files;
 }
 
-// ../src/shared/local-project.ts
+// src/shared/local-project.ts
 var LOCAL_PROJECT_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var LOCAL_SCENE_NAME_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
 function isLocalProjectId(value) {
@@ -1163,7 +1163,7 @@ function localProjectMarker(input) {
 `;
 }
 
-// ../src/shared/initial-files.ts
+// src/shared/initial-files.ts
 var TITLE_TEMPLATE = TEMPLATES.find((t) => t.id === "title-card");
 var BLANK_DIRECTION = TEMPLATES.find((t) => t.id === "blank").generate({});
 var defaultParams = (t) => Object.fromEntries(t.params.map((p) => [p.key, p.default]));
@@ -1201,10 +1201,10 @@ function buildInitialFiles(input) {
   };
 }
 
-// ../src/shared/video-models.ts
+// src/shared/video-models.ts
 var DEFAULT_OPENROUTER_VIDEO_MODEL = "anthropic/claude-opus-5";
 
-// ../src/shared/video-clone-command.ts
+// 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) {
@@ -1218,7 +1218,7 @@ function videoShareToken(source) {
   throw new Error("Use an Impractical video share URL: https://impractical.ai/v/<token>");
 }
 
-// src/clone-video-project.ts
+// cli/src/clone-video-project.ts
 async function cloneVideoProject(source, json = false) {
   const token = videoShareToken(source);
   const result = await invoke("video-shares", { action: "clone", token });
@@ -1234,7 +1234,7 @@ async function cloneVideoProject(source, json = false) {
   console.log(`Use Impractical to open project ${result.projectId} and help me iterate on this video.`);
 }
 
-// src/video-sharing.ts
+// cli/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";
@@ -1247,7 +1247,11 @@ async function shareVideo(rest, flags) {
         method: body ? "POST" : "GET",
         redirect: "error",
         signal: AbortSignal.timeout(45e3),
-        headers: { authorization: `Bearer ${config.apiKey}`, "content-type": "application/json" },
+        headers: {
+          authorization: `Bearer ${config.apiKey}`,
+          ...config.workspace ? { "x-impractical-workspace": config.workspace } : {},
+          "content-type": "application/json"
+        },
         body: body ? JSON.stringify(body) : void 0
       }
     );
@@ -1331,7 +1335,7 @@ async function shareVideo(rest, flags) {
   }
 }
 
-// src/commands.ts
+// cli/src/commands.ts
 var flagString = (flags, name) => {
   const value = flags[name];
   if (Array.isArray(value)) return value[value.length - 1];
@@ -1380,7 +1384,10 @@ async function login(flags) {
     config.supabaseUrl,
     "workspace-bootstrap",
     {},
-    config.apiKey
+    config.apiKey,
+    void 0,
+    // IMPRACTICAL_WORKSPACE, for a multi-workspace key; unset sends nothing.
+    config.workspace
   );
   if (Object.keys(patch).length) saveConfig(patch);
   out(`org: ${snapshot.orgId}`);
@@ -1431,9 +1438,14 @@ async function generate(flags) {
   }
   const projectId = flagString(flags, "project");
   const feedback = flagString(flags, "feedback");
-  const append = Boolean(projectId && feedback);
+  if (projectId && feedback) {
+    throw new Error(
+      "Projects have one draft now. To revise this video, edit its draft with the MCP tools edit_draft_file / write_draft_files; every save is kept as a version."
+    );
+  }
+  const append = false;
   const slug = flagString(flags, "slug") ?? `${slugify(valueProp)}-${randomBytes(2).toString("hex")}`;
-  const directorIds = (flagString(flags, "directors") ?? "d1,d2").split(",").map((d) => d.trim());
+  const directorIds = (flagString(flags, "directors") ?? "d1").split(",").map((d) => d.trim()).slice(0, 1);
   const files = buildInitialFiles({ valueProp, appCode, brand: brand2 });
   const prepared = await invoke("prepare-generation", {
     ...projectId ? { projectId } : {},