@impractical-ai/motion 0.1.3 → 0.1.5

package/README.md

@@ -1,22 +1,34 @@
 # Impractical Motion CLI
 
-Connect Claude Code to Impractical Motion through its MCP server.
+Connect Claude Code, Codex, Cursor, or OpenCode to Impractical Motion through
+its MCP server.
 
 ## Requirements
 
 - Node.js 22 or newer
-- Claude Code installed and signed in
+- At least one supported coding agent: Claude Code, Codex, Cursor, or OpenCode
 - Google Chrome or Chromium for frame inspection
 
 ## Setup
 
+```sh
+npx --yes @impractical-ai/motion setup --agent
+```
+
+Approve the device code in the browser, then restart the detected coding agents.
+Setup installs the global `impractical` MCP configuration for every detected
+Claude Code, Codex, Cursor, and OpenCode client, plus the shared skill for Claude
+Code and Codex. Re-running setup verifies and reuses a working credential,
+preserves unrelated client configuration, and does not require another browser
+authorization.
+
+For the full Claude Code plugin workflow, run:
+
 ```sh
 npx --yes @impractical-ai/motion setup --claude
 ```
 
-Approve the device code in the browser, then run `/reload-plugins` in Claude Code and type
-`continue`. Re-running setup verifies and reuses a working credential, refreshes the user-scoped
-plugin, and does not require another browser authorization.
+Then run `/reload-plugins` in Claude Code and type `continue`.
 
 Setup writes the API credential to `~/.impractical/config.json` with mode `0600`. Environment
 variables `IMPRACTICAL_API_KEY`, `IMPRACTICAL_SUPABASE_URL`, and `IMPRACTICAL_APP_URL` take
@@ -24,7 +36,7 @@ precedence over that file.
 
 ## MCP server
 
-The installed Claude plugin launches the server automatically. Other MCP clients can run:
+The installer configures supported clients to run:
 
 ```sh
 npx --yes @impractical-ai/motion@latest mcp

package/assets/impractical/SKILL.md

@@ -13,13 +13,15 @@ source code lives in the cloud, never in the user's project directory.
 ## 0. Setup check (once per session)
 
 Call the `account_status` tool (`whoami` is its legacy alias). If the
-Impractical tools are not available, the Claude plugin is not connected. Tell
-the user to run:
+Impractical tools are not available, the current coding agent is not connected.
+Tell the user to run:
 
-    npx --yes @impractical-ai/motion setup --claude
+    npx --yes @impractical-ai/motion setup --agent
 
-Then ask them to run `/reload-plugins` and type `continue`. If the weekly quota
-is exhausted, call `upgrade` to give the user the authenticated billing page.
+Then ask them to restart or reload their coding agent and type `continue`.
+Claude Code users who specifically want the full plugin can run the same command
+with `--claude` instead. If the weekly quota is exhausted, call `upgrade` to give
+the user the authenticated billing page.
 
 ## 1. Read the engine before you write anything
 

package/dist/api-KD6BNKBQ.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  ApiContractError,
+  ApiError,
+  admitMcpCall,
+  delay,
+  invoke,
+  invokeAt,
+  jobStatus,
+  studioLink,
+  validateApiResponse,
+  waitForJobs,
+  withAdmissionReceipt,
+  withMeteredCall
+} from "./chunk-7724464Z.js";
+import "./chunk-JDN3QHCX.js";
+export {
+  ApiContractError,
+  ApiError,
+  admitMcpCall,
+  delay,
+  invoke,
+  invokeAt,
+  jobStatus,
+  studioLink,
+  validateApiResponse,
+  waitForJobs,
+  withAdmissionReceipt,
+  withMeteredCall
+};

package/dist/chunk-7724464Z.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import {
+  PRODUCTION_APP_URL,
+  PRODUCTION_SUPABASE_URL
+} from "./chunk-JDN3QHCX.js";
+
+// src/config.ts
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync, renameSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+var configDir = () => join(homedir(), ".impractical");
+var configPath = () => join(configDir(), "config.json");
+function recoverCorruptConfig() {
+  const path = configPath();
+  if (!existsSync(path)) return null;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new SyntaxError("the root value must be an object");
+    }
+    return null;
+  } catch (error) {
+    if (!(error instanceof SyntaxError)) {
+      throw new Error(
+        `Could not inspect ${path}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    let backupPath = `${path}.corrupt-${Date.now()}`;
+    let suffix = 1;
+    while (existsSync(backupPath)) backupPath = `${path}.corrupt-${Date.now()}-${suffix++}`;
+    renameSync(path, backupPath);
+    return backupPath;
+  }
+}
+function readStoredConfig() {
+  try {
+    const parsed = JSON.parse(readFileSync(configPath(), "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new SyntaxError("the root value must be an object");
+    }
+    return parsed;
+  } catch (error) {
+    if (error?.code === "ENOENT") return {};
+    if (error instanceof SyntaxError) {
+      throw new Error(
+        `Invalid JSON in ${configPath()}: ${error.message}
+Run: npx --yes @impractical-ai/motion setup --agent`
+      );
+    }
+    throw new Error(
+      `Could not read ${configPath()}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function loadConfig() {
+  const stored = readStoredConfig();
+  return {
+    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
+  };
+}
+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);
+  return next;
+}
+function requireConfig() {
+  const config = loadConfig();
+  if (!config.supabaseUrl) {
+    throw new Error("Not configured. Run: npx --yes @impractical-ai/motion setup --agent");
+  }
+  if (!config.apiKey) {
+    throw new Error("Not connected. Run: npx --yes @impractical-ai/motion setup --agent");
+  }
+  return config;
+}
+
+// src/api.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+var admissionContext = new AsyncLocalStorage();
+var ApiError = class extends Error {
+  constructor(status, message, fn, details) {
+    super(message);
+    this.status = status;
+    this.fn = fn;
+    this.details = details;
+  }
+};
+var ApiContractError = class extends Error {
+  constructor(fn, expected) {
+    super(`${fn} returned an invalid response: expected ${expected}. Please retry; if this persists, update Impractical Motion or contact support.`);
+    this.fn = fn;
+  }
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function bodyRecord(body) {
+  return isRecord(body) ? body : {};
+}
+function validateApiResponse(name, body, data) {
+  if (!isRecord(data)) throw new ApiContractError(name, "a JSON object");
+  const input = bodyRecord(body);
+  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(
+        name,
+        "an orgId, plan, hasAccess flag, and billing status"
+      );
+    }
+  }
+  if (name === "list-projects") {
+    const key = input.projectId ? "project" : "projects";
+    const value = data[key];
+    if (key === "projects" ? !Array.isArray(value) : !isRecord(value)) {
+      throw new ApiContractError(name, `an object with a ${key} ${key === "projects" ? "array" : "object"}`);
+    }
+  }
+  if (name === "prepare-generation") {
+    if (typeof data.projectId !== "string" || !Array.isArray(data.drafts) || data.drafts.length === 0 || !isRecord(data.drafts[0]) || typeof data.drafts[0].id !== "string") {
+      throw new ApiContractError(
+        name,
+        "a projectId and at least one draft with an id"
+      );
+    }
+  }
+  if (name === "get-draft" && (!isRecord(data.files) || typeof data.draftId !== "string")) {
+    throw new ApiContractError(name, "draft metadata and a files object");
+  }
+  if (name === "save-draft" && typeof data.revision !== "number") {
+    throw new ApiContractError(name, "a numeric revision");
+  }
+  if (name === "job-status" && !Array.isArray(data.jobs)) {
+    throw new ApiContractError(name, "an object with a jobs array");
+  }
+  if (name === "start-export" && typeof data.jobId !== "string") {
+    throw new ApiContractError(name, "an object with a jobId");
+  }
+  if (name === "brand-kits") {
+    const key = input.action === "list" ? "brands" : input.action === "get" ? "brand" : null;
+    if (key && (key === "brands" ? !Array.isArray(data[key]) : !isRecord(data[key]))) {
+      throw new ApiContractError(name, `an object with a ${key} ${key === "brands" ? "array" : "object"}`);
+    }
+  }
+  return data;
+}
+async function invoke(name, body = {}) {
+  const { apiKey, supabaseUrl } = requireConfig();
+  const receipt = admissionContext.getStore();
+  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 text = await response.text();
+  let data = null;
+  try {
+    data = text ? JSON.parse(text) : null;
+  } catch {
+  }
+  if (!response.ok) {
+    const details = isRecord(data) ? data : void 0;
+    const message = typeof details?.message === "string" && details.message || typeof details?.error === "string" && details.error || text || `${name} failed (${response.status})`;
+    throw new ApiError(response.status, message, name, details);
+  }
+  return validateApiResponse(name, body, data);
+}
+async function admitMcpCall(toolName, callId = randomUUID()) {
+  const { apiKey, supabaseUrl } = requireConfig();
+  return invokeAt(supabaseUrl, "mcp-admission", { callId, toolName }, apiKey);
+}
+function withAdmissionReceipt(receipt, task) {
+  return admissionContext.run(receipt, task);
+}
+async function withMeteredCall(toolName, task) {
+  const admission = await admitMcpCall(toolName);
+  return withAdmissionReceipt(admission.receipt, task);
+}
+var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function jobStatus(jobIds) {
+  const result = await invoke("job-status", { jobIds });
+  return result.jobs;
+}
+async function waitForJobs(jobIds, onTick, deadlineMs = 72e5) {
+  const deadline = Date.now() + deadlineMs;
+  const terminal = /* @__PURE__ */ new Set();
+  let latest = [];
+  while (terminal.size < jobIds.length) {
+    if (Date.now() >= deadline) throw new Error("Timed out waiting for jobs");
+    latest = await jobStatus(jobIds);
+    for (const row of latest) {
+      if (row.status === "completed" || row.status === "failed" || row.status === "canceled") {
+        terminal.add(row.id);
+      }
+    }
+    onTick(latest);
+    if (terminal.size < jobIds.length) await delay(2e3);
+  }
+  return latest;
+}
+function studioLink(appUrl, projectId, slug) {
+  const base = (appUrl ?? "http://localhost:5173").replace(/\/$/, "");
+  return `${base}/projects/${projectId}/studio${slug ? `?scene=${slug}` : ""}`;
+}
+
+export {
+  recoverCorruptConfig,
+  loadConfig,
+  saveConfig,
+  requireConfig,
+  ApiError,
+  ApiContractError,
+  validateApiResponse,
+  invoke,
+  invokeAt,
+  admitMcpCall,
+  withAdmissionReceipt,
+  withMeteredCall,
+  delay,
+  jobStatus,
+  waitForJobs,
+  studioLink
+};