@impractical-ai/motion 0.1.3 → 0.1.5

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

@@ -1,260 +1,34 @@
 #!/usr/bin/env node
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// src/constants.ts
-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 = "0.1.2";
-var PACKAGE_COMMAND = `npx --yes ${PACKAGE_NAME}`;
-
-// 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}`);
-    }
-    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 --claude");
-  }
-  if (!config.apiKey) {
-    throw new Error("Not connected. Run: npx --yes @impractical-ai/motion setup --claude");
-  }
-  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}` : ""}`;
-}
+import {
+  ApiError,
+  delay,
+  invokeAt,
+  loadConfig,
+  recoverCorruptConfig,
+  saveConfig
+} from "./chunk-7724464Z.js";
+import {
+  PACKAGE_COMMAND,
+  PACKAGE_NAME,
+  PACKAGE_VERSION,
+  PRODUCTION_APP_URL,
+  PRODUCTION_SUPABASE_URL
+} from "./chunk-JDN3QHCX.js";
 
 // src/onboarding.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { dirname, join as join2 } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 var CLAUDE_MARKETPLACE = "Openpod/impractical-agent-plugins";
 var CLAUDE_PLUGIN = "impractical-motion@impractical";
 var CLAUDE_MARKETPLACE_NAME = "impractical";
 var AUTH_VERIFY_MIN_VERSION = "0.1.2";
+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"];
 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.-]+)?$/
@@ -294,20 +68,20 @@ function compareSemver(left, right) {
   return 0;
 }
 function readJson(path) {
-  if (!existsSync2(path)) return void 0;
+  if (!existsSync(path)) return void 0;
   try {
-    return JSON.parse(readFileSync2(path, "utf8"));
+    return JSON.parse(readFileSync(path, "utf8"));
   } catch {
     return void 0;
   }
 }
-var claudeConfigDir = () => process.env.CLAUDE_CONFIG_DIR?.trim() || join2(homedir2(), ".claude");
-function marketplaceRecord(configDir2) {
-  const value = readJson(join2(configDir2, "plugins", "known_marketplaces.json"));
+var claudeConfigDir = () => process.env.CLAUDE_CONFIG_DIR?.trim() || join(homedir(), ".claude");
+function marketplaceRecord(configDir) {
+  const value = readJson(join(configDir, "plugins", "known_marketplaces.json"));
   return value?.impractical;
 }
-function installedPluginVersion(configDir2) {
-  const value = readJson(join2(configDir2, "plugins", "installed_plugins.json"));
+function installedPluginVersion(configDir) {
+  const value = readJson(join(configDir, "plugins", "installed_plugins.json"));
   const entries = value?.plugins?.[CLAUDE_PLUGIN];
   if (!Array.isArray(entries)) return void 0;
   const versions = entries.filter((entry) => entry?.scope === "user" && typeof entry.version === "string").map((entry) => entry.version);
@@ -317,10 +91,10 @@ function installedPluginVersion(configDir2) {
     return comparison !== void 0 && comparison > 0 ? version : highest;
   }, void 0);
 }
-function marketplacePluginVersion(configDir2) {
-  const record = marketplaceRecord(configDir2);
-  const location = typeof record?.installLocation === "string" ? record.installLocation : join2(configDir2, "plugins", "marketplaces", CLAUDE_MARKETPLACE_NAME);
-  const value = readJson(join2(location, ".claude-plugin", "marketplace.json"));
+function marketplacePluginVersion(configDir) {
+  const record = marketplaceRecord(configDir);
+  const location = typeof record?.installLocation === "string" ? record.installLocation : join(configDir, "plugins", "marketplaces", CLAUDE_MARKETPLACE_NAME);
+  const value = readJson(join(location, ".claude-plugin", "marketplace.json"));
   return value?.plugins?.find((plugin) => plugin.name === "impractical-motion")?.version;
 }
 function expectedMarketplace(record) {
@@ -334,9 +108,133 @@ function marketplaceSourceLabel(record) {
 function commandResult(command, args) {
   return spawnSync(command, args, { encoding: "utf8", windowsHide: true });
 }
+function commandAvailable(command) {
+  const result = commandResult(command, ["--version"]);
+  return !result.error && result.status === 0;
+}
+function verifyAgentPrerequisites() {
+  const found = commandAvailable("claude") || commandAvailable("codex") || commandAvailable("cursor-agent") || commandAvailable("cursor") || commandAvailable("opencode");
+  if (!found) {
+    throw new Error(
+      "No supported coding agent was detected. Install Claude Code, Codex, Cursor, or OpenCode, then rerun setup."
+    );
+  }
+}
+function commandDetail(result) {
+  return `${result.stdout ?? ""}
+${result.stderr ?? ""}`.trim();
+}
+function runMcpCommand(command, args, harness) {
+  const result = commandResult(command, args);
+  if (!result.error && result.status === 0) return;
+  throw new Error(
+    `${harness} MCP setup failed: ${commandDetail(result) || result.error?.message || "unknown error"}`
+  );
+}
+function hasExpectedMcp(result) {
+  if (result.error || result.status !== 0) return false;
+  const detail = commandDetail(result);
+  return detail.includes("@impractical-ai/motion@latest") && /\bmcp\b/.test(detail);
+}
+function installNativeMcp(command, harness) {
+  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);
+    }
+    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 };
+}
+function readJsonObject(path) {
+  if (!existsSync(path)) return {};
+  let value;
+  try {
+    value = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    throw new Error(`Cannot configure MCP because ${path} is not valid JSON.`);
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Cannot configure MCP because ${path} must contain a JSON object.`);
+  }
+  return value;
+}
+function writeJsonObject(path, value) {
+  mkdirSync(dirname(path), { recursive: true, mode: 448 });
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, { mode: 384 });
+}
+function installCursorMcp(home) {
+  if (!commandAvailable("cursor-agent") && !commandAvailable("cursor")) return void 0;
+  const path = join(home, ".cursor", "mcp.json");
+  const config = readJsonObject(path);
+  const servers = config.mcpServers && typeof config.mcpServers === "object" && !Array.isArray(config.mcpServers) ? config.mcpServers : {};
+  const expected = {
+    command: MCP_COMMAND[0],
+    args: MCP_COMMAND.slice(1)
+  };
+  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+    return { harness: "Cursor", path };
+  }
+  config.mcpServers = {
+    ...servers,
+    [MCP_SERVER_NAME]: expected
+  };
+  writeJsonObject(path, config);
+  return { harness: "Cursor", path };
+}
+function openCodeConfigHome(home) {
+  if (process.env.XDG_CONFIG_HOME?.trim()) return process.env.XDG_CONFIG_HOME.trim();
+  if (process.platform === "win32" && process.env.APPDATA?.trim()) return process.env.APPDATA.trim();
+  return join(home, ".config");
+}
+function verifyAgentConfigs(home = homedir()) {
+  if (commandAvailable("cursor-agent") || commandAvailable("cursor")) {
+    readJsonObject(join(home, ".cursor", "mcp.json"));
+  }
+  if (commandAvailable("opencode")) {
+    readJsonObject(join(openCodeConfigHome(home), "opencode", "opencode.json"));
+  }
+}
+function installOpenCodeMcp(home) {
+  if (!commandAvailable("opencode")) return void 0;
+  const path = join(openCodeConfigHome(home), "opencode", "opencode.json");
+  const config = readJsonObject(path);
+  const servers = config.mcp && typeof config.mcp === "object" && !Array.isArray(config.mcp) ? config.mcp : {};
+  const expected = {
+    type: "local",
+    command: MCP_COMMAND
+  };
+  if (JSON.stringify(servers[MCP_SERVER_NAME]) === JSON.stringify(expected)) {
+    return { harness: "OpenCode", path };
+  }
+  config.mcp = {
+    ...servers,
+    [MCP_SERVER_NAME]: 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 requireCommand(command, label) {
   const result = commandResult(command, ["--version"]);
   if (result.error || result.status !== 0) {
+    if (command === "claude") {
+      throw new Error(
+        `${label} is not installed. Install it, then rerun setup:
+  ${CLAUDE_INSTALL_COMMAND}
+Official setup guide: ${CLAUDE_INSTALL_URL}`
+      );
+    }
     throw new Error(`${label} is required before setup can continue.`);
   }
 }
@@ -345,7 +243,7 @@ function hasChrome() {
     "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
     "/Applications/Chromium.app/Contents/MacOS/Chromium"
   ];
-  if (macPaths.some(existsSync2)) return true;
+  if (macPaths.some(existsSync)) return true;
   return ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser"].some((command) => {
     const result = spawnSync(command, ["--version"], { stdio: "ignore", windowsHide: true });
     return !result.error && result.status === 0;
@@ -381,9 +279,9 @@ ${result.stderr ?? ""}`.trim();
 }
 function installClaudePlugin(log = () => {
 }) {
-  const configDir2 = claudeConfigDir();
-  const beforeVersion = installedPluginVersion(configDir2);
-  let record = marketplaceRecord(configDir2);
+  const configDir = claudeConfigDir();
+  const beforeVersion = installedPluginVersion(configDir);
+  let record = marketplaceRecord(configDir);
   const preserveSource = Boolean(record && !expectedMarketplace(record));
   if (preserveSource) {
     log(
@@ -391,12 +289,12 @@ function installClaudePlugin(log = () => {
     );
   } else if (!record) {
     runClaude(["plugin", "marketplace", "add", CLAUDE_MARKETPLACE], log, true);
-    record = marketplaceRecord(configDir2);
+    record = marketplaceRecord(configDir);
   }
   if (!beforeVersion) {
     runClaude(["plugin", "install", CLAUDE_PLUGIN, "--scope", "user"], log, true);
   } else if (!preserveSource) {
-    const advertisedVersion = marketplacePluginVersion(configDir2);
+    const advertisedVersion = marketplacePluginVersion(configDir);
     const comparison = advertisedVersion ? compareSemver(beforeVersion, advertisedVersion) : void 0;
     if (comparison === void 0) {
       log(
@@ -408,8 +306,8 @@ function installClaudePlugin(log = () => {
       );
     } else {
       runClaude(["plugin", "marketplace", "update", CLAUDE_MARKETPLACE_NAME], log, true);
-      const refreshedVersion = marketplacePluginVersion(configDir2);
-      const currentVersion = installedPluginVersion(configDir2) ?? beforeVersion;
+      const refreshedVersion = marketplacePluginVersion(configDir);
+      const currentVersion = installedPluginVersion(configDir) ?? beforeVersion;
       const refreshedComparison = refreshedVersion ? compareSemver(currentVersion, refreshedVersion) : void 0;
       if (refreshedComparison !== void 0 && refreshedComparison < 0) {
         runClaude(["plugin", "update", CLAUDE_PLUGIN], log, true);
@@ -420,7 +318,7 @@ function installClaudePlugin(log = () => {
       }
     }
   }
-  const afterVersion = installedPluginVersion(configDir2);
+  const afterVersion = installedPluginVersion(configDir);
   const change = beforeVersion && afterVersion ? compareSemver(afterVersion, beforeVersion) : void 0;
   if (change !== void 0 && change < 0) {
     log(`WARNING: ${CLAUDE_PLUGIN} resolved to ${afterVersion}, below its prior ${beforeVersion}.`);
@@ -454,44 +352,44 @@ function pluginResultLine(result) {
   return `${CLAUDE_PLUGIN} already at ${result.afterVersion}; left unchanged.`;
 }
 var skillSourcePath = () => fileURLToPath(new URL("../assets/impractical/SKILL.md", import.meta.url));
-function installSkills(home = homedir2(), sourcePath = skillSourcePath()) {
-  const source = readFileSync2(sourcePath, "utf8");
+function installSkills(home = homedir(), sourcePath = skillSourcePath()) {
+  const source = readFileSync(sourcePath, "utf8");
   const targets = [
     {
       harness: "Claude Code",
-      path: join2(home, ".claude", "skills", "impractical", "SKILL.md")
+      path: join(home, ".claude", "skills", "impractical", "SKILL.md")
     },
     {
       harness: "Codex",
-      path: join2(home, ".codex", "skills", "impractical", "SKILL.md")
+      path: join(home, ".codex", "skills", "impractical", "SKILL.md")
     }
   ];
   for (const target of targets) {
-    mkdirSync2(dirname(target.path), { recursive: true, mode: 448 });
-    writeFileSync2(target.path, source, { mode: 420 });
+    mkdirSync(dirname(target.path), { recursive: true, mode: 448 });
+    writeFileSync(target.path, source, { mode: 420 });
   }
   return targets;
 }
-function reconcileLegacySkills(home = homedir2(), sourcePath = skillSourcePath()) {
-  const source = readFileSync2(sourcePath, "utf8");
+function reconcileLegacySkills(home = homedir(), sourcePath = skillSourcePath()) {
+  const source = readFileSync(sourcePath, "utf8");
   const targets = [
     {
       harness: "Claude Code",
-      path: join2(home, ".claude", "skills", "impractical", "SKILL.md")
+      path: join(home, ".claude", "skills", "impractical", "SKILL.md")
     },
     {
       harness: "Codex",
-      path: join2(home, ".codex", "skills", "impractical", "SKILL.md")
+      path: join(home, ".codex", "skills", "impractical", "SKILL.md")
     }
   ];
   const reconciled = [];
   for (const target of targets) {
-    if (!existsSync2(target.path)) continue;
-    const previous = readFileSync2(target.path, "utf8");
+    if (!existsSync(target.path)) continue;
+    const previous = readFileSync(target.path, "utf8");
     if (previous === source) continue;
     const backupPath = `${target.path}.pre-plugin`;
-    if (!existsSync2(backupPath)) writeFileSync2(backupPath, previous, { mode: 420 });
-    writeFileSync2(target.path, source, { mode: 420 });
+    if (!existsSync(backupPath)) writeFileSync(backupPath, previous, { mode: 420 });
+    writeFileSync(target.path, source, { mode: 420 });
     reconciled.push({ ...target, backupPath });
   }
   return reconciled;
@@ -509,7 +407,7 @@ function openBrowser(url) {
   });
   return !result.error && result.status === 0;
 }
-async function waitForApproval(supabaseUrl, authorization, log) {
+async function waitForApproval(supabaseUrl, authorization, log, setupFlag) {
   const deadline = Date.parse(authorization.expiresAt);
   const intervalMs = Math.max(1, authorization.intervalSeconds) * 1e3;
   let announced = false;
@@ -525,16 +423,21 @@ async function waitForApproval(supabaseUrl, authorization, log) {
     }
     await delay(intervalMs);
   }
-  throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup --claude\` again.`);
+  throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup ${setupFlag}\` again.`);
 }
 async function setup(options) {
   if (options.installClaudePlugin) verifyClaudePrerequisites();
+  if (options.installAgentMcp) {
+    verifyAgentPrerequisites();
+    verifyAgentConfigs();
+  }
   const corruptConfigBackup = recoverCorruptConfig();
   if (corruptConfigBackup) {
     options.log(`Backed up invalid configuration to ${corruptConfigBackup}; starting clean.`);
   }
   const supabaseUrl = process.env.IMPRACTICAL_SUPABASE_URL?.trim() || PRODUCTION_SUPABASE_URL;
   const appUrl = process.env.IMPRACTICAL_APP_URL?.trim() || PRODUCTION_APP_URL;
+  const setupFlag = options.installAgentMcp ? "--agent" : "--claude";
   const existing = loadConfig();
   let apiKey = existing.supabaseUrl === supabaseUrl ? existing.apiKey : void 0;
   let verified;
@@ -561,10 +464,10 @@ async function setup(options) {
       options.log(opened ? "Opened your browser." : "Could not open a browser automatically; use the link above.");
     }
     try {
-      apiKey = await waitForApproval(supabaseUrl, authorization, options.log);
+      apiKey = 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 --claude\` again.`);
+        throw new Error(`Authorization expired. Run \`${PACKAGE_COMMAND} setup ${setupFlag}\` again.`);
       }
       throw error;
     }
@@ -572,6 +475,7 @@ async function setup(options) {
     saveConfig({ apiKey, supabaseUrl, appUrl });
   }
   const claudePlugin = options.installClaudePlugin ? installClaudePlugin(options.log) : void 0;
+  const configuredMcps = options.installAgentMcp ? installAgentMcps() : [];
   const installed = options.installAgentSkills ? installSkills() : [];
   const reconciled = reconcileLegacySkills();
   options.log("");
@@ -579,39 +483,27 @@ async function setup(options) {
   for (const skill of installed) {
     options.log(`Installed /impractical for ${skill.harness}.`);
   }
+  for (const mcp of configuredMcps) {
+    options.log(`Configured Impractical MCP for ${mcp.harness}.`);
+  }
   for (const skill of reconciled) {
     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("");
-  options.log("Run /reload-plugins, then type continue.");
   if (options.installClaudePlugin) {
+    options.log("Run /reload-plugins, then type continue.");
+  } else if (options.installAgentMcp) {
+    options.log("Restart your coding agents, then ask them to use the Impractical MCP.");
+  }
+  if (options.installClaudePlugin || options.installAgentMcp) {
     for (const line of authenticatedWhoamiGuidance()) options.log(line);
   }
   return { installed, appUrl, supabaseUrl };
 }
 
 export {
-  __commonJS,
-  __export,
-  __toESM,
-  PRODUCTION_APP_URL,
-  PRODUCTION_SUPABASE_URL,
-  PACKAGE_VERSION,
-  loadConfig,
-  saveConfig,
-  requireConfig,
-  ApiError,
-  validateApiResponse,
-  invoke,
-  invokeAt,
-  admitMcpCall,
-  withAdmissionReceipt,
-  withMeteredCall,
-  jobStatus,
-  waitForJobs,
-  studioLink,
   openBrowser,
   setup
 };