@impractical-ai/motion 0.1.5 → 0.1.6

package/assets/engine.d.ts

@@ -598,12 +598,20 @@ export type AudioKit = {
 }
 
 export type Output = {
+  /** Delivery raster dimensions. They do not change scene layout. */
   width: number
   height: number
   fps: number
   render?: RenderConfig
 }
 
+/** Resolved renderer contract. `width`/`height` are always logical scene
+ * coordinates; only the exporter consumes `delivery` as raster dimensions. */
+export type StageConfig = Output & {
+  composition: { width: number; height: number }
+  delivery: { width: number; height: number }
+}
+
 export type Rect = { left: number; top: number; width: number; height: number }
 
 export type FramingTarget = string | Element | Rect | FramingTarget[]
@@ -642,6 +650,9 @@ export type TextStyleOverride = {
   color?: string
   x?: number
   y?: number
+  /** Wrapping width in scene px — the side bars reflow text instead of
+   * scale-squeezing it. Applied as inline-block + width. */
+  width?: number
   hidden?: boolean
 }
 
@@ -652,6 +663,14 @@ export type ObjectPositionOverride = {
   scaleY?: number
   rotation?: number
   hidden?: boolean
+  /** Plain CSS declarations the studio applies to the object's element —
+   * border-radius, background-color, box-shadow and friends. Applied at
+   * stage prepare, so they ride the structural rebuild route. */
+  styles?: Record<string, string>
+  /** Replacement source for the image or video the object carries (the
+   * element itself or its first img/video descendant), usually a data URI so
+   * renders never depend on the network. */
+  src?: string
 }
 
 export type AddedTextLayer = {
@@ -668,6 +687,11 @@ export type SceneOverrides = {
   textStyles?: Record<string, TextStyleOverride>
   addedText?: Record<string, AddedTextLayer>
   objects?: Record<string, ObjectPositionOverride> // stable UI wrapper id -> scene-pixel offset
+  /** Explicit paint order for editable siblings. Keys include the editable
+   * kind (`object:…` / `text:…`) so independently generated ids cannot
+   * collide. Values are normalized by the studio whenever an item moves in
+   * the stack. */
+  layerOrder?: Record<string, number>
 }
 
 export type TweenKind =
@@ -698,12 +722,16 @@ export type TweenInfo = {
   stagger?: number
   vars: Record<string, number | string>
   overridden: boolean
+  /** The editable layer this tween animates, when its first Element target
+   * sits inside one — lets the studio show a layer's choreography. */
+  targetObjectId?: string
+  targetTextId?: string
 }
 
 export type CameraSetInfo = Framing & { id: number; overridden: boolean }
 
 export type SceneInspection = {
-  config: Output
+  config: StageConfig
   duration: number
   tweens: TweenInfo[]
   cameraSets: CameraSetInfo[]
@@ -720,7 +748,7 @@ export type DirectionContext = {
   gsap: typeof gsap
   tl: gsap.core.Timeline // the master timeline (created paused)
   stage: HTMLElement // scene wrapper the camera transforms
-  config: Output
+  config: StageConfig
   q: <T extends HTMLElement>(selector: string) => T
   qa: (selector: string) => HTMLElement[]
   camera: {
@@ -897,6 +925,14 @@ export type DirectionContext = {
 
 export type Direction = (ctx: DirectionContext) => void | Promise<void>
 
+export type BuiltScene = {
+  timeline: gsap.core.Timeline
+  runtime: DeterministicStageRuntime
+  scene: SceneInspection
+  config: StageConfig
+  previewOverrides: (overrides: SceneOverrides) => boolean
+}
+
 // ─── Named eases ──────────────────────────────────────────────────────
 
 // ─── The promo easing set ─────────────────────────────────────────────────

package/dist/{api-KD6BNKBQ.js → api-C7KJDYN4.js}

@@ -2,6 +2,7 @@
 import {
   ApiContractError,
   ApiError,
+  ApiTransportError,
   admitMcpCall,
   delay,
   invoke,
@@ -12,11 +13,12 @@ import {
   waitForJobs,
   withAdmissionReceipt,
   withMeteredCall
-} from "./chunk-7724464Z.js";
-import "./chunk-JDN3QHCX.js";
+} from "./chunk-KITRCE33.js";
+import "./chunk-LJ4YH3YJ.js";
 export {
   ApiContractError,
   ApiError,
+  ApiTransportError,
   admitMcpCall,
   delay,
   invoke,

package/dist/{chunk-DMAQPSA4.js → chunk-BUHNO2W2.js}

@@ -6,17 +6,26 @@ import {
   loadConfig,
   recoverCorruptConfig,
   saveConfig
-} from "./chunk-7724464Z.js";
+} from "./chunk-KITRCE33.js";
 import {
   PACKAGE_COMMAND,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-JDN3QHCX.js";
+} from "./chunk-LJ4YH3YJ.js";
 
 // src/onboarding.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  statSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -29,6 +38,8 @@ var CLAUDE_INSTALL_COMMAND = "npm install -g @anthropic-ai/claude-code";
 var CLAUDE_INSTALL_URL = "https://code.claude.com/docs/en/installation";
 var MCP_SERVER_NAME = "impractical";
 var MCP_COMMAND = ["npx", "--yes", `${PACKAGE_NAME}@latest`, "mcp"];
+var MCP_TOOL_TIMEOUT_MS = 6e5;
+var MCP_TOOL_TIMEOUT_SECONDS = MCP_TOOL_TIMEOUT_MS / 1e3;
 function parseSemver(value) {
   const match = value.trim().match(
     /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
@@ -136,17 +147,116 @@ function hasExpectedMcp(result) {
   const detail = commandDetail(result);
   return detail.includes("@impractical-ai/motion@latest") && /\bmcp\b/.test(detail);
 }
-function installNativeMcp(command, harness) {
+function hasExpectedClaudeMcp(result) {
+  if (!hasExpectedMcp(result)) return false;
+  return new RegExp(`\\b${MCP_TOOL_TIMEOUT_MS}(?:ms)?\\b`).test(commandDetail(result));
+}
+function hasExpectedCodexMcp(result) {
+  if (!hasExpectedMcp(result)) return false;
+  return new RegExp(`\\btool_timeout_sec\\s*:\\s*${MCP_TOOL_TIMEOUT_SECONDS}\\b`).test(
+    commandDetail(result)
+  );
+}
+function codexConfigPath(home) {
+  const codexHome = process.env.CODEX_HOME?.trim();
+  return join(codexHome || join(home, ".codex"), "config.toml");
+}
+function atomicWrite(path, contents, mode) {
+  mkdirSync(dirname(path), { recursive: true, mode: 448 });
+  const temporary = join(dirname(path), `.${MCP_SERVER_NAME}-${process.pid}-${Date.now()}.tmp`);
+  try {
+    writeFileSync(temporary, contents, { mode });
+    chmodSync(temporary, mode);
+    renameSync(temporary, path);
+  } finally {
+    if (existsSync(temporary)) unlinkSync(temporary);
+  }
+}
+function upsertCodexToolTimeout(path) {
+  if (!existsSync(path)) throw new Error(`Codex MCP registration did not create ${path}.`);
+  const previous = readFileSync(path, "utf8");
+  const newline = previous.includes("\r\n") ? "\r\n" : "\n";
+  const lines = previous.split(/\r?\n/);
+  const section = /^\s*\[mcp_servers\.(?:impractical|"impractical")\]\s*(?:#.*)?$/;
+  const sectionStart = lines.findIndex((line) => section.test(line));
+  if (sectionStart === -1) {
+    throw new Error(`Codex MCP registration did not create [mcp_servers.${MCP_SERVER_NAME}].`);
+  }
+  let sectionEnd = lines.length;
+  for (let index = sectionStart + 1; index < lines.length; index++) {
+    if (/^\s*\[/.test(lines[index])) {
+      sectionEnd = index;
+      break;
+    }
+  }
+  const timeoutLine = /^\s*tool_timeout_sec\s*=/;
+  const timeoutIndex = lines.slice(sectionStart + 1, sectionEnd).findIndex((line) => timeoutLine.test(line));
+  if (timeoutIndex !== -1 && new RegExp(`^\\s*tool_timeout_sec\\s*=\\s*${MCP_TOOL_TIMEOUT_SECONDS}\\s*(?:#.*)?$`).test(
+    lines[sectionStart + 1 + timeoutIndex]
+  )) {
+    return;
+  }
+  if (timeoutIndex === -1) {
+    lines.splice(sectionEnd, 0, `tool_timeout_sec = ${MCP_TOOL_TIMEOUT_SECONDS}`);
+  } else {
+    lines[sectionStart + 1 + timeoutIndex] = `tool_timeout_sec = ${MCP_TOOL_TIMEOUT_SECONDS}`;
+  }
+  atomicWrite(path, lines.join(newline), statSync(path).mode & 511);
+}
+function restoreFile(path, existed, contents, mode) {
+  if (existed) atomicWrite(path, contents, mode);
+  else if (existsSync(path)) unlinkSync(path);
+}
+function installNativeMcp(command, harness, home) {
   if (!commandAvailable(command)) return void 0;
   const existing = commandResult(command, ["mcp", "get", MCP_SERVER_NAME]);
-  if (!hasExpectedMcp(existing)) {
-    if (command === "claude" && !existing.error && existing.status === 0) {
-      runMcpCommand(command, ["mcp", "remove", MCP_SERVER_NAME, "-s", "user"], harness);
+  if (command === "claude") {
+    if (!hasExpectedClaudeMcp(existing)) {
+      const existingDetail = commandDetail(existing);
+      if (!existing.error && existing.status === 0 && !/No MCP server named\b/i.test(existingDetail)) {
+        runMcpCommand(command, ["mcp", "remove", MCP_SERVER_NAME, "-s", "user"], harness);
+      }
+      const definition = JSON.stringify({
+        type: "stdio",
+        command: MCP_COMMAND[0],
+        args: MCP_COMMAND.slice(1),
+        timeout: MCP_TOOL_TIMEOUT_MS
+      });
+      runMcpCommand(
+        command,
+        ["mcp", "add-json", "-s", "user", MCP_SERVER_NAME, definition],
+        harness
+      );
+      if (!hasExpectedClaudeMcp(commandResult(command, ["mcp", "get", MCP_SERVER_NAME]))) {
+        throw new Error(`${harness} MCP setup failed validation after registration.`);
+      }
     }
-    const addArgs = command === "claude" ? ["mcp", "add", "-s", "user", MCP_SERVER_NAME, "--", ...MCP_COMMAND] : ["mcp", "add", MCP_SERVER_NAME, "--", ...MCP_COMMAND];
-    runMcpCommand(command, addArgs, harness);
+    return { harness };
   }
-  return { harness };
+  const path = codexConfigPath(home);
+  mkdirSync(dirname(path), { recursive: true, mode: 448 });
+  const existed = existsSync(path);
+  const previous = existed ? readFileSync(path, "utf8") : "";
+  const mode = existed ? statSync(path).mode & 511 : 384;
+  try {
+    if (!hasExpectedMcp(existing)) {
+      runMcpCommand(command, ["mcp", "add", MCP_SERVER_NAME, "--", ...MCP_COMMAND], harness);
+    }
+    upsertCodexToolTimeout(path);
+    if (!hasExpectedCodexMcp(commandResult(command, ["mcp", "get", MCP_SERVER_NAME]))) {
+      throw new Error(`${harness} MCP setup failed validation after registration.`);
+    }
+  } catch (error) {
+    try {
+      restoreFile(path, existed, previous, mode);
+    } catch (rollbackError) {
+      throw new Error(
+        `${error instanceof Error ? error.message : String(error)} Rollback failed: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`
+      );
+    }
+    throw error;
+  }
+  return { harness, path };
 }
 function readJsonObject(path) {
   if (!existsSync(path)) return {};
@@ -166,6 +276,13 @@ function writeJsonObject(path, value) {
   writeFileSync(path, `${JSON.stringify(value, null, 2)}
 `, { mode: 384 });
 }
+function hasRequiredFields(value, required) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const record = value;
+  return Object.entries(required).every(
+    ([key, expected]) => JSON.stringify(record[key]) === JSON.stringify(expected)
+  );
+}
 function installCursorMcp(home) {
   if (!commandAvailable("cursor-agent") && !commandAvailable("cursor")) return void 0;
   const path = join(home, ".cursor", "mcp.json");
@@ -175,12 +292,13 @@ function installCursorMcp(home) {
     command: MCP_COMMAND[0],
     args: MCP_COMMAND.slice(1)
   };
-  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+  if (hasRequiredFields(servers[MCP_SERVER_NAME], expected)) {
     return { harness: "Cursor", path };
   }
+  const existing = servers[MCP_SERVER_NAME] && typeof servers[MCP_SERVER_NAME] === "object" && !Array.isArray(servers[MCP_SERVER_NAME]) ? servers[MCP_SERVER_NAME] : {};
   config.mcpServers = {
     ...servers,
-    [MCP_SERVER_NAME]: expected
+    [MCP_SERVER_NAME]: { ...existing, ...expected }
   };
   writeJsonObject(path, config);
   return { harness: "Cursor", path };
@@ -191,11 +309,38 @@ function openCodeConfigHome(home) {
   return join(home, ".config");
 }
 function verifyAgentConfigs(home = homedir()) {
+  const checks = [];
   if (commandAvailable("cursor-agent") || commandAvailable("cursor")) {
-    readJsonObject(join(home, ".cursor", "mcp.json"));
+    checks.push({ harness: "Cursor", path: join(home, ".cursor", "mcp.json") });
   }
   if (commandAvailable("opencode")) {
-    readJsonObject(join(openCodeConfigHome(home), "opencode", "opencode.json"));
+    checks.push({
+      harness: "OpenCode",
+      path: join(openCodeConfigHome(home), "opencode", "opencode.json")
+    });
+  }
+  const failures = [];
+  for (const check of checks) {
+    try {
+      readJsonObject(check.path);
+    } catch (error) {
+      failures.push({
+        harness: check.harness,
+        path: check.path,
+        message: error instanceof Error ? error.message : String(error),
+        remediation: agentMcpRemediation(check.harness, check.path)
+      });
+    }
+  }
+  if (failures.length > 0) {
+    const detail = failures.map(
+      (failure) => `${failure.harness}: ${failure.message}
+Remediation: ${failure.remediation}`
+    ).join("\n");
+    throw new Error(
+      `Device authorization was not started because ${failures.length} coding agent configuration${failures.length === 1 ? "" : "s"} must be repaired first.
+${detail}`
+    );
   }
 }
 function installOpenCodeMcp(home) {
@@ -205,25 +350,68 @@ function installOpenCodeMcp(home) {
   const servers = config.mcp && typeof config.mcp === "object" && !Array.isArray(config.mcp) ? config.mcp : {};
   const expected = {
     type: "local",
-    command: MCP_COMMAND
+    command: MCP_COMMAND,
+    timeout: MCP_TOOL_TIMEOUT_MS
   };
-  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+  if (hasRequiredFields(servers[MCP_SERVER_NAME], expected)) {
     return { harness: "OpenCode", path };
   }
+  const existing = servers[MCP_SERVER_NAME] && typeof servers[MCP_SERVER_NAME] === "object" && !Array.isArray(servers[MCP_SERVER_NAME]) ? servers[MCP_SERVER_NAME] : {};
   config.mcp = {
     ...servers,
-    [MCP_SERVER_NAME]: expected
+    [MCP_SERVER_NAME]: { ...existing, ...expected }
   };
   writeJsonObject(path, config);
   return { harness: "OpenCode", path };
 }
-function installAgentMcps(home = homedir()) {
-  return [
-    installNativeMcp("claude", "Claude Code"),
-    installNativeMcp("codex", "Codex"),
-    installCursorMcp(home),
-    installOpenCodeMcp(home)
-  ].filter((result) => Boolean(result));
+function agentMcpRemediation(harness, path) {
+  if (path) {
+    return `Repair ${path} so it contains a valid configuration object without deleting unrelated entries, then rerun \`${PACKAGE_COMMAND} setup --agent\`.`;
+  }
+  return `Inspect the ${harness} MCP configuration for \`${MCP_SERVER_NAME}\`, then rerun \`${PACKAGE_COMMAND} setup --agent\`.`;
+}
+function agentMcpFailureMessage(failures) {
+  const detail = failures.map((failure) => `${failure.harness}: ${failure.message}
+Remediation: ${failure.remediation}`).join("\n");
+  return `Could not configure ${failures.length} coding agent${failures.length === 1 ? "" : "s"}. Successful agent configurations were preserved.
+${detail}`;
+}
+function configureAgentMcps(home = homedir()) {
+  const configured = [];
+  const failures = [];
+  const installers = [
+    { harness: "Claude Code", install: () => installNativeMcp("claude", "Claude Code", home) },
+    {
+      harness: "Codex",
+      path: codexConfigPath(home),
+      install: () => installNativeMcp("codex", "Codex", home)
+    },
+    {
+      harness: "Cursor",
+      path: join(home, ".cursor", "mcp.json"),
+      install: () => installCursorMcp(home)
+    },
+    {
+      harness: "OpenCode",
+      path: join(openCodeConfigHome(home), "opencode", "opencode.json"),
+      install: () => installOpenCodeMcp(home)
+    }
+  ];
+  for (const installer of installers) {
+    try {
+      const result = installer.install();
+      if (result) configured.push(result);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      failures.push({
+        harness: installer.harness,
+        path: installer.path,
+        message,
+        remediation: agentMcpRemediation(installer.harness, installer.path)
+      });
+    }
+  }
+  return { configured, failures };
 }
 function requireCommand(command, label) {
   const result = commandResult(command, ["--version"]);
@@ -429,7 +617,6 @@ async function setup(options) {
   if (options.installClaudePlugin) verifyClaudePrerequisites();
   if (options.installAgentMcp) {
     verifyAgentPrerequisites();
-    verifyAgentConfigs();
   }
   const corruptConfigBackup = recoverCorruptConfig();
   if (corruptConfigBackup) {
@@ -451,6 +638,7 @@ async function setup(options) {
     }
   }
   if (!apiKey) {
+    if (options.installAgentMcp) verifyAgentConfigs();
     const authorization = await invokeAt(supabaseUrl, "cli-device-auth", {
       action: "start"
     });
@@ -475,7 +663,7 @@ async function setup(options) {
     saveConfig({ apiKey, supabaseUrl, appUrl });
   }
   const claudePlugin = options.installClaudePlugin ? installClaudePlugin(options.log) : void 0;
-  const configuredMcps = options.installAgentMcp ? installAgentMcps() : [];
+  const agentMcpSetup = options.installAgentMcp ? configureAgentMcps() : { configured: [], failures: [] };
   const installed = options.installAgentSkills ? installSkills() : [];
   const reconciled = reconcileLegacySkills();
   options.log("");
@@ -483,9 +671,13 @@ async function setup(options) {
   for (const skill of installed) {
     options.log(`Installed /impractical for ${skill.harness}.`);
   }
-  for (const mcp of configuredMcps) {
+  for (const mcp of agentMcpSetup.configured) {
     options.log(`Configured Impractical MCP for ${mcp.harness}.`);
   }
+  for (const failure of agentMcpSetup.failures) {
+    options.log(`Could not configure Impractical MCP for ${failure.harness}: ${failure.message}`);
+    options.log(`Remediation for ${failure.harness}: ${failure.remediation}`);
+  }
   for (const skill of reconciled) {
     options.log(`Refreshed legacy /impractical for ${skill.harness}; previous copy preserved at ${skill.backupPath}.`);
   }
@@ -500,6 +692,9 @@ async function setup(options) {
   if (options.installClaudePlugin || options.installAgentMcp) {
     for (const line of authenticatedWhoamiGuidance()) options.log(line);
   }
+  if (agentMcpSetup.failures.length > 0) {
+    throw new Error(agentMcpFailureMessage(agentMcpSetup.failures));
+  }
   return { installed, appUrl, supabaseUrl };
 }
 

package/dist/{chunk-7724464Z.js → chunk-KITRCE33.js}

@@ -2,10 +2,19 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-JDN3QHCX.js";
+} from "./chunk-LJ4YH3YJ.js";
 
 // src/config.ts
-import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync, renameSync } from "node:fs";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { randomBytes } from "node:crypto";
 import { homedir } from "node:os";
 import { join } from "node:path";
 var configDir = () => join(homedir(), ".impractical");
@@ -63,9 +72,25 @@ function loadConfig() {
 function saveConfig(patch) {
   const stored = readStoredConfig();
   const next = { ...stored, ...patch };
-  mkdirSync(configDir(), { recursive: true });
-  writeFileSync(configPath(), JSON.stringify(next, null, 2) + "\n");
-  chmodSync(configPath(), 384);
+  const directory = configDir();
+  const path = configPath();
+  mkdirSync(directory, { recursive: true, mode: 448 });
+  chmodSync(directory, 448);
+  const temporary = join(
+    directory,
+    `.config-${process.pid}-${randomBytes(8).toString("hex")}.tmp`
+  );
+  try {
+    writeFileSync(temporary, JSON.stringify(next, null, 2) + "\n", {
+      encoding: "utf8",
+      flag: "wx",
+      mode: 384
+    });
+    chmodSync(temporary, 384);
+    renameSync(temporary, path);
+  } finally {
+    if (existsSync(temporary)) unlinkSync(temporary);
+  }
   return next;
 }
 function requireConfig() {
@@ -97,6 +122,16 @@ var ApiContractError = class extends Error {
     this.fn = fn;
   }
 };
+var ApiTransportError = class extends Error {
+  constructor(fn, endpoint, reason) {
+    super(
+      `Could not reach ${endpoint} for ${fn}. Cause: ${reason}. Check your network and IMPRACTICAL_SUPABASE_URL, then retry. If this persists, run \`npx --yes @impractical-ai/motion setup --agent\`.`
+    );
+    this.fn = fn;
+    this.endpoint = endpoint;
+    this.reason = reason;
+  }
+};
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -156,15 +191,30 @@ async function invoke(name, body = {}) {
   return invokeAt(supabaseUrl, name, body, apiKey, receipt);
 }
 async function invokeAt(supabaseUrl, name, body = {}, apiKey, admissionReceipt) {
-  const response = await fetch(`${supabaseUrl.replace(/\/$/, "")}/functions/v1/${name}`, {
-    method: "POST",
-    headers: {
-      ...apiKey ? { authorization: `Bearer ${apiKey}` } : {},
-      ...admissionReceipt ? { "x-impractical-admission": admissionReceipt } : {},
-      "content-type": "application/json"
-    },
-    body: JSON.stringify(body)
-  });
+  const requestUrl = `${supabaseUrl.replace(/\/$/, "")}/functions/v1/${name}`;
+  let response;
+  try {
+    response = await fetch(requestUrl, {
+      method: "POST",
+      headers: {
+        ...apiKey ? { authorization: `Bearer ${apiKey}` } : {},
+        ...admissionReceipt ? { "x-impractical-admission": admissionReceipt } : {},
+        "content-type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+  } catch (error) {
+    let endpoint = `configured API/functions/v1/${encodeURIComponent(name)}`;
+    try {
+      const configured = new URL(supabaseUrl);
+      endpoint = `${configured.protocol}//${configured.host}/functions/v1/${encodeURIComponent(name)}`;
+    } catch {
+    }
+    const cause = error instanceof Error ? error.cause : void 0;
+    const code = isRecord(cause) && typeof cause.code === "string" ? cause.code : void 0;
+    const reason = code && /^[A-Z0-9_]+$/.test(code) ? code : "network transport error";
+    throw new ApiTransportError(name, endpoint, reason);
+  }
   const text = await response.text();
   let data = null;
   try {
@@ -223,6 +273,7 @@ export {
   requireConfig,
   ApiError,
   ApiContractError,
+  ApiTransportError,
   validateApiResponse,
   invoke,
   invokeAt,

package/dist/{chunk-JDN3QHCX.js → chunk-LJ4YH3YJ.js}

@@ -32,7 +32,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.5",
+  version: "0.1.6",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",
@@ -57,15 +57,16 @@ var package_default = {
     node: ">=22"
   },
   scripts: {
-    build: 'node ../scripts/build-engine-dts.mjs && rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --splitting --outdir=dist --external:playwright-core --banner:js="#!/usr/bin/env node" && chmod +x dist/index.js',
+    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 --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 build && esbuild tests/onboarding.test.ts tests/mcp-tools.test.ts tests/mcp-frames.test.ts tests/engine-dts.test.ts tests/mcp-connect.test.ts tests/mcp-longpoll.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/engine-dts.test.mjs dist/mcp-connect.test.mjs dist/mcp-longpoll.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/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/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"
   },
   publishConfig: {
     access: "public"
   },
   devDependencies: {
+    "@types/node": "^26.1.0",
     esbuild: "^0.25.0",
     typescript: "^5.6.3"
   },

package/dist/{commands-Y35XPDVH.js → commands-P5CDHPDP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-DMAQPSA4.js";
+} from "./chunk-BUHNO2W2.js";
 import {
   invoke,
   invokeAt,
@@ -11,8 +11,8 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-7724464Z.js";
-import "./chunk-JDN3QHCX.js";
+} from "./chunk-KITRCE33.js";
+import "./chunk-LJ4YH3YJ.js";
 
 // src/commands.ts
 import { readFileSync as readFileSync2, writeFileSync } from "node:fs";
@@ -1142,6 +1142,26 @@ function parseSceneFiles(pasted) {
   return files;
 }
 
+// ../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) {
+  return typeof value === "string" && LOCAL_PROJECT_ID_RE.test(value);
+}
+function localProjectMarker(input) {
+  if (!isLocalProjectId(input.projectId) || !LOCAL_SCENE_NAME_RE.test(input.sceneName)) {
+    throw new Error("A local project requires a valid project and scene identity");
+  }
+  return `${JSON.stringify({
+    projectId: input.projectId,
+    sceneName: input.sceneName,
+    createdAt: input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    valueProp: input.valueProp.trim(),
+    ...input.brand ? { brand: input.brand } : {}
+  })}
+`;
+}
+
 // ../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({});
@@ -1162,7 +1182,11 @@ function buildInitialFiles(input) {
       }
     })
   };
-  const projectMarker = JSON.stringify({
+  const projectMarker = input.localProject ? localProjectMarker({
+    ...input.localProject,
+    valueProp: input.valueProp,
+    brand: input.brand?.slug
+  }) : JSON.stringify({
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     valueProp: input.valueProp.trim(),
     ...input.brand ? { brand: input.brand.slug } : {}