framer-dalton 0.0.7 → 0.0.9

package/dist/cli.js

@@ -1,15 +1,39 @@
 #!/usr/bin/env node
 import path3 from 'path';
 import { Command } from 'commander';
+import crypto from 'crypto';
+import http from 'http';
+import { spawn, execFile } from 'child_process';
 import fs2 from 'fs';
 import os from 'os';
-import { spawn } from 'child_process';
+import { z } from 'zod';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.7 */
+/* @framer/ai CLI v0.0.9 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function openUrl(url) {
+  const platform = process.platform;
+  let cmd;
+  let args;
+  if (platform === "darwin") {
+    cmd = "open";
+    args = [url];
+  } else if (platform === "win32") {
+    cmd = "cmd";
+    args = ["/c", "start", "", url];
+  } else {
+    cmd = "xdg-open";
+    args = [url];
+  }
+  return new Promise((resolve) => {
+    const child = execFile(cmd, args);
+    child.on("error", () => resolve(false));
+    child.on("exit", (code) => resolve(code === 0));
+  });
+}
+__name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
     return path3.join(process.env.XDG_CONFIG_HOME, "framer");
@@ -20,32 +44,92 @@ function getConfigDir() {
   return path3.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
-function getCredentialsPath() {
+function getProjectsConfigPath() {
+  return path3.join(getConfigDir(), "projects.json");
+}
+__name(getProjectsConfigPath, "getProjectsConfigPath");
+function getLegacyCredentialsPath() {
   return path3.join(getConfigDir(), "credentials.json");
 }
-__name(getCredentialsPath, "getCredentialsPath");
-function readCredentials() {
-  const credPath = getCredentialsPath();
+__name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
+var ProjectsConfigSchema = z.object({
+  version: z.literal(2),
+  projects: z.record(
+    z.string(),
+    z.object({
+      apiKey: z.string(),
+      name: z.string().optional(),
+      lastUsedAt: z.string().optional()
+    })
+  )
+});
+var LegacyCredentialsSchema = z.record(z.string(), z.string());
+function readJsonFile(filePath) {
+  if (!fs2.existsSync(filePath)) {
+    return null;
+  }
   try {
-    if (fs2.existsSync(credPath)) {
-      return JSON.parse(fs2.readFileSync(credPath, "utf-8"));
-    }
-  } catch {
+    return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+  } catch (_error) {
+    return null;
   }
-  return {};
 }
-__name(readCredentials, "readCredentials");
-function writeCredentials(creds) {
-  const credPath = getCredentialsPath();
+__name(readJsonFile, "readJsonFile");
+function ensureConfigDir() {
   const configDir = getConfigDir();
   if (!fs2.existsSync(configDir)) {
     fs2.mkdirSync(configDir, { recursive: true, mode: 448 });
   }
-  fs2.writeFileSync(credPath, JSON.stringify(creds, null, "	"), {
-    mode: 384
-  });
 }
-__name(writeCredentials, "writeCredentials");
+__name(ensureConfigDir, "ensureConfigDir");
+function writeProjectsConfig(config) {
+  ensureConfigDir();
+  fs2.writeFileSync(
+    getProjectsConfigPath(),
+    JSON.stringify(config, null, "	"),
+    {
+      mode: 384
+    }
+  );
+}
+__name(writeProjectsConfig, "writeProjectsConfig");
+function readLegacyCredentials() {
+  const legacyPath = getLegacyCredentialsPath();
+  const parsed = readJsonFile(legacyPath);
+  const result = LegacyCredentialsSchema.safeParse(parsed);
+  if (!result.success) {
+    return {};
+  }
+  return result.data;
+}
+__name(readLegacyCredentials, "readLegacyCredentials");
+function migrateLegacyCredentials() {
+  const legacyCreds = readLegacyCredentials();
+  const projects = {};
+  for (const [projectId, apiKey] of Object.entries(legacyCreds)) {
+    projects[projectId] = { apiKey };
+  }
+  const config = { version: 2, projects };
+  writeProjectsConfig(config);
+  fs2.rmSync(getLegacyCredentialsPath(), { force: true });
+  return config;
+}
+__name(migrateLegacyCredentials, "migrateLegacyCredentials");
+function readProjectsConfig() {
+  const projectsPath = getProjectsConfigPath();
+  const parsed = readJsonFile(projectsPath);
+  if (parsed !== null) {
+    const result = ProjectsConfigSchema.safeParse(parsed);
+    if (result.success) {
+      return result.data;
+    }
+  }
+  if (fs2.existsSync(getLegacyCredentialsPath())) {
+    return migrateLegacyCredentials();
+  }
+  return { version: 2, projects: {} };
+}
+__name(readProjectsConfig, "readProjectsConfig");
 function extractProjectId(input) {
   if (/^[a-zA-Z0-9]+$/.test(input)) {
     return input;
@@ -54,20 +138,279 @@ function extractProjectId(input) {
   if (match) {
     return match[1];
   }
+  const slugMatch = input.match(/^(?:.+--)?([a-zA-Z0-9]+)(?:-[a-zA-Z0-9]+)?$/);
+  if (slugMatch) {
+    return slugMatch[1];
+  }
   return input;
 }
 __name(extractProjectId, "extractProjectId");
+function listProjects() {
+  const config = readProjectsConfig();
+  return Object.entries(config.projects).map(([projectId, project2]) => ({
+    projectId,
+    ...project2
+  })).sort((a, b) => {
+    const left = a.lastUsedAt ?? "";
+    const right = b.lastUsedAt ?? "";
+    return right.localeCompare(left);
+  });
+}
+__name(listProjects, "listProjects");
 function getApiKey(projectId) {
-  const creds = readCredentials();
-  return creds[projectId] || null;
+  const config = readProjectsConfig();
+  return config.projects[projectId]?.apiKey ?? null;
 }
 __name(getApiKey, "getApiKey");
-function saveApiKey(projectId, apiKey) {
-  const creds = readCredentials();
-  creds[projectId] = apiKey;
-  writeCredentials(creds);
+function saveProject(project2) {
+  const config = readProjectsConfig();
+  config.projects[project2.projectId] = {
+    apiKey: project2.apiKey,
+    name: project2.name,
+    lastUsedAt: project2.lastUsedAt
+  };
+  writeProjectsConfig(config);
+}
+__name(saveProject, "saveProject");
+function clearApiKey(projectId) {
+  const config = readProjectsConfig();
+  if (!(projectId in config.projects)) return false;
+  delete config.projects[projectId];
+  writeProjectsConfig(config);
+  return true;
 }
-__name(saveApiKey, "saveApiKey");
+__name(clearApiKey, "clearApiKey");
+
+// src/utils.ts
+function formatError(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+__name(formatError, "formatError");
+function printJson(value) {
+  console.log(JSON.stringify(value, null, 2));
+}
+__name(printJson, "printJson");
+function print(message) {
+  console.log(message);
+}
+__name(print, "print");
+function printError(message) {
+  console.error(message);
+}
+__name(printError, "printError");
+
+// src/auth-callback.ts
+var TIMEOUT_MS = 3e5;
+var themes = {
+  dark: {
+    pageBackground: "rgb(17, 17, 17)",
+    modalBackground: "rgb(17, 17, 17)",
+    modalBorder: "rgba(255, 255, 255, 0.07)",
+    titleColor: "#fff",
+    textColor: "rgb(102, 102, 102)",
+    separatorColor: "rgba(255, 255, 255, 0.07)",
+    buttonBackground: "#333",
+    buttonBackgroundHover: "#3a3a3a",
+    buttonText: "#fff",
+    shadow: "0px 10px 30px 0px rgba(0, 0, 0, 0.15)"
+  },
+  light: {
+    pageBackground: "#eee",
+    modalBackground: "#fff",
+    modalBorder: "rgba(0, 0, 0, 0.07)",
+    titleColor: "#333",
+    textColor: "rgb(102, 102, 102)",
+    separatorColor: "rgba(0, 0, 0, 0.07)",
+    buttonBackground: "rgba(0, 0, 0, 0.05)",
+    buttonBackgroundHover: "rgba(0, 0, 0, 0.08)",
+    buttonText: "#333",
+    shadow: "0px 10px 30px 0px rgba(0, 0, 0, 0.15)"
+  }
+};
+function htmlPage(opts) {
+  const t = themes[opts.theme];
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${opts.title}</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@500;600&display=swap">
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:"Inter",system-ui,-apple-system,sans-serif;font-feature-settings:"cv01" 1,"cv05" 1,"cv09" 1,"cv11" 1;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;display:flex;justify-content:center;align-items:center;min-height:100vh;background:${t.pageBackground}}
+.modal{width:260px;padding:0 10px;border-radius:18px;background:${t.modalBackground};border:1px solid ${t.modalBorder};box-shadow:${t.shadow}}
+.header{display:flex;align-items:center;height:50px;border-bottom:1px solid ${t.separatorColor};color:${t.titleColor};font-size:12px;font-weight:600;line-height:1}
+.content{padding:10px 0}
+.text{color:${t.textColor};font-size:12px;font-weight:500;line-height:1.5;text-wrap:balance}
+.footer{padding:10px 0;border-top:1px solid ${t.separatorColor}}
+.footer button{display:block;width:100%;height:30px;border:none;border-radius:8px;background:${t.buttonBackground};color:${t.buttonText};font-size:12px;font-weight:600;cursor:pointer;font-family:inherit}
+.footer button:hover{background:${t.buttonBackgroundHover}}
+</style>
+</head>
+<body>
+<div class="modal">
+<div class="header">${opts.heading}</div>
+<div class="content"><span class="text">${opts.message}</span></div>
+</div>
+</body>
+</html>`;
+}
+__name(htmlPage, "htmlPage");
+function successHtml(theme) {
+  return htmlPage({
+    title: "Framer \u2014 Agent Approved",
+    heading: "Agent Approved",
+    message: "Your local agent now has edit access to the project. You can close this tab and continue with the local agent.",
+    theme
+  });
+}
+__name(successHtml, "successHtml");
+function deniedHtml(theme) {
+  return htmlPage({
+    title: "Framer \u2014 Authorization Denied",
+    heading: "Authorization Denied",
+    message: "Agent access was denied. You can close this tab.",
+    theme
+  });
+}
+__name(deniedHtml, "deniedHtml");
+function errorHtml(theme) {
+  return htmlPage({
+    title: "Framer \u2014 Authorization Failed",
+    heading: "Authorization Failed",
+    message: "Missing or invalid parameters. Please try again.",
+    theme
+  });
+}
+__name(errorHtml, "errorHtml");
+function parseTheme(value) {
+  return value === "light" ? "light" : "dark";
+}
+__name(parseTheme, "parseTheme");
+async function acquireKeyFromBrowser(projectId) {
+  const state = crypto.randomBytes(16).toString("hex");
+  return new Promise((resolve, reject) => {
+    let pendingResult = null;
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url ?? "/", `http://127.0.0.1`);
+      if (url.pathname === "/done") {
+        const theme2 = parseTheme(url.searchParams.get("theme"));
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(successHtml(theme2));
+        if (pendingResult) {
+          const { apiKey: apiKey2 } = pendingResult;
+          pendingResult = null;
+          cleanup();
+          print("\u2713 Agent authorized");
+          resolve(apiKey2);
+        }
+        return;
+      }
+      if (url.pathname === "/error") {
+        const theme2 = parseTheme(url.searchParams.get("theme"));
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(errorHtml(theme2));
+        return;
+      }
+      if (url.pathname !== "/callback") {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      const theme = parseTheme(url.searchParams.get("theme"));
+      const error = url.searchParams.get("error");
+      if (error === "denied") {
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(deniedHtml(theme));
+        cleanup();
+        reject(new Error("Authorization denied by user."));
+        return;
+      }
+      const apiKey = url.searchParams.get("apiKey");
+      const returnedState = url.searchParams.get("state");
+      if (!apiKey || returnedState !== state) {
+        res.writeHead(302, { Location: `/error?theme=${theme}` });
+        res.end();
+        return;
+      }
+      pendingResult = { apiKey, theme };
+      res.writeHead(302, { Location: `/done?theme=${theme}` });
+      res.end();
+    });
+    const POLL_INTERVAL_MS = 1e3;
+    const pollTimer = setInterval(() => {
+      const apiKey = getApiKey(projectId);
+      if (apiKey) {
+        cleanup();
+        print("\u2713 API key detected from config");
+        resolve(apiKey);
+      }
+    }, POLL_INTERVAL_MS);
+    const HINT_MS = 55e3;
+    const hintTimer = setTimeout(() => {
+      const settingsUrl = `https://framer.com/projects/${projectId}?view=settings%3Aproject`;
+      print("");
+      printError("Taking a while? You can generate an API key manually:");
+      printError(`  1. Open Site Settings \u2192 General: ${settingsUrl}`);
+      printError("  2. Scroll to API Keys and create a new key");
+      printError(
+        `  3. In another terminal, run: framer project auth ${projectId} <your-api-key>`
+      );
+      print("");
+      print("Waiting for authorization in browser...");
+    }, HINT_MS);
+    const timer = setTimeout(() => {
+      cleanup();
+      reject(
+        new Error(
+          "Browser authorization timed out. Use `framer project auth <projectUrlOrId> <apiKey>` instead."
+        )
+      );
+    }, TIMEOUT_MS);
+    function cleanup() {
+      clearTimeout(timer);
+      clearTimeout(hintTimer);
+      clearInterval(pollTimer);
+      server.close();
+    }
+    __name(cleanup, "cleanup");
+    server.listen(0, "127.0.0.1", async () => {
+      const addr = server.address();
+      if (!addr || typeof addr === "string") {
+        cleanup();
+        reject(new Error("Failed to start callback server."));
+        return;
+      }
+      const callbackUrl = `http://127.0.0.1:${addr.port}/callback`;
+      const deeplink = new URL("https://framer.com/projects/server-api/auth");
+      deeplink.searchParams.set("callback", callbackUrl);
+      deeplink.searchParams.set("state", state);
+      deeplink.searchParams.set("projectId", projectId);
+      const deeplinkStr = deeplink.toString();
+      const opened = await openUrl(deeplinkStr);
+      if (opened) {
+        print("Waiting for authorization in browser...");
+      } else {
+        printError("Could not open browser. Open this URL manually:");
+        printError(deeplinkStr);
+      }
+    });
+  });
+}
+__name(acquireKeyFromBrowser, "acquireKeyFromBrowser");
+
+// src/connection-errors.ts
+var AUTH_ERROR_PATTERNS = ["does not have access", "UNAUTHORIZED"];
+function isAuthError(errorMessage) {
+  return AUTH_ERROR_PATTERNS.some((p) => errorMessage.includes(p));
+}
+__name(isAuthError, "isAuthError");
 
 // src/types-data.ts
 var types = {
@@ -2239,6 +2582,20 @@ var types = {
       }
     ]
   },
+  designpagecloneoptions: {
+    name: "DesignPageCloneOptions",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "name",
+        type: "string",
+        description: "",
+        optional: true
+      }
+    ]
+  },
   diagnosticbase: {
     name: "DiagnosticBase",
     description: "",
@@ -4414,7 +4771,7 @@ var types = {
     name: "LocationControl",
     description: "",
     kind: "interface",
-    references: ["ControlBase", "Location"],
+    references: ["ControlBase", "Location", "UnsupportedVariable"],
     members: [
       {
         name: "type",
@@ -4424,7 +4781,7 @@ var types = {
       },
       {
         name: "value",
-        type: "Location | undefined",
+        type: "Location | UnsupportedVariable | undefined",
         description: "",
         optional: true
       }
@@ -5468,6 +5825,18 @@ var types = {
         description: "",
         optional: false
       },
+      {
+        name: "cloneWebPage",
+        type: "(nodeId: NodeId, options?: WebPageCloneOptions) => Promise<SomeNodeData | null>",
+        description: "",
+        optional: false
+      },
+      {
+        name: "cloneDesignPage",
+        type: "(nodeId: NodeId, options?: DesignPageCloneOptions) => Promise<SomeNodeData | null>",
+        description: "",
+        optional: false
+      },
       {
         name: "getNode",
         type: "(nodeId: NodeId) => Promise<SomeNodeData | null>",
@@ -8219,6 +8588,20 @@ var types = {
       }
     ]
   },
+  webpagecloneoptions: {
+    name: "WebPageCloneOptions",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "path",
+        type: "string",
+        description: "",
+        optional: true
+      }
+    ]
+  },
   widthconstraint: {
     name: "WidthConstraint",
     description: "",
@@ -10344,7 +10727,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "ComponentInstanceNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -10623,7 +11006,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "ComponentNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -10862,9 +11245,9 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "DesignPageNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
-      references: []
+      signature: "clone(options?: DesignPageCloneOptions): Promise<this>",
+      description: "Clone the DesignPageNode into a new one with the same content\nIf the given name already exists, the cloned page will be created with a unique name.",
+      references: ["DesignPageCloneOptions"]
     },
     {
       name: "getChildren",
@@ -11376,7 +11759,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "FrameNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -12965,7 +13348,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "SVGNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -13184,7 +13567,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "TextNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -13732,7 +14115,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "UnknownNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -13931,7 +14314,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "VectorSetItemNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -14101,7 +14484,7 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "VectorSetNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
+      signature: "clone(): Promise<typeof this | null>",
       description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
       references: []
     },
@@ -14222,9 +14605,9 @@ var methodsByCategory = {
     {
       name: "clone",
       category: "WebPageNode",
-      signature: 'clone(): Promise<(typeof this)[ClassKey] extends "UnknownNode" ? never : typeof this | null>',
-      description: 'Clone this node, creating a duplicate in the canvas tree.\n\n@returns The cloned node, or `null` if the clone failed.\n@throws If the node is an `UnknownNode`.\n\nUse `"Node.clone"` to check if this method is allowed.',
-      references: []
+      signature: "clone(options?: WebPageCloneOptions): Promise<this>",
+      description: "Clone the WebPageNode into a new one with the same content and settings, as a draft\nIf the given path already exists, the cloned page will be created with a unique path.",
+      references: ["WebPageCloneOptions"]
     },
     {
       name: "collectionId",
@@ -14527,7 +14910,7 @@ ${typeDef}`);
 __name(renderDocs, "renderDocs");
 var __filename$1 = fileURLToPath(import.meta.url);
 var __dirname$1 = path3.dirname(__filename$1);
-var VERSION = "0.0.7" ;
+var VERSION = "0.0.9" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -14712,27 +15095,6 @@ function installSkills(options = { type: "base" }) {
 }
 __name(installSkills, "installSkills");
 
-// src/utils.ts
-function formatError(error) {
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return String(error);
-}
-__name(formatError, "formatError");
-function printJson(value) {
-  console.log(JSON.stringify(value, null, 2));
-}
-__name(printJson, "printJson");
-function print(message) {
-  console.log(message);
-}
-__name(print, "print");
-function printError(message) {
-  console.error(message);
-}
-__name(printError, "printError");
-
 // src/cli.ts
 var program = new Command();
 program.name("framer").version(VERSION).description("Framer Server API CLI");
@@ -14811,40 +15173,38 @@ async function refreshSkillsFromSession(sessionId, projectId) {
   }
 }
 __name(refreshSkillsFromSession, "refreshSkillsFromSession");
-function resolveSessionCredentials(projectUrl, apiKeyArg) {
+async function resolveSessionCredentials(projectUrlOrId) {
   try {
-    const projectId = extractProjectId(projectUrl);
-    if (!apiKeyArg) {
-      const cachedApiKey = getApiKey(projectId);
-      if (cachedApiKey) {
-        return { projectId, apiKey: cachedApiKey };
-      }
-      printError("No API key provided and none cached for this project.");
-      printError("");
-      printError("Usage: framer session new <projectUrl> <apiKey>");
-      process.exit(1);
+    const projectId = extractProjectId(projectUrlOrId);
+    const cachedApiKey = getApiKey(projectId);
+    if (cachedApiKey) {
+      return { projectId, apiKey: cachedApiKey };
     }
-    saveApiKey(projectId, apiKeyArg);
-    return { projectId, apiKey: apiKeyArg };
+    const newApiKey = await acquireKeyFromBrowser(projectId);
+    saveProject({ projectId, apiKey: newApiKey });
+    return { projectId, apiKey: newApiKey };
   } catch (err) {
-    printError(`Failed to create session: ${formatError(err)}`);
+    printError(`Failed to resolve credentials: ${formatError(err)}`);
     process.exit(1);
   }
 }
 __name(resolveSessionCredentials, "resolveSessionCredentials");
-async function createSession(projectId, apiKey) {
-  try {
-    const result = await client.createSession.mutate({
-      projectId,
-      apiKey
-    });
-    return result.id;
-  } catch (err) {
-    printError(`Failed to create session: ${formatError(err)}`);
-    process.exit(1);
+async function getProjectName(sessionId) {
+  const result = await client.exec.mutate({
+    sessionId,
+    code: "return (await framer.getProjectInfo()).name;",
+    cwd: process.cwd()
+  });
+  if (result.error) {
+    throw new Error(result.error);
+  }
+  const projectName = result.output.at(-1);
+  if (typeof projectName !== "string") {
+    throw new Error("Did not receive project name output.");
   }
+  return projectName;
 }
-__name(createSession, "createSession");
+__name(getProjectName, "getProjectName");
 async function ensureRelayForCli() {
   try {
     await ensureRelayServerRunning({ logger: { log: print } });
@@ -14867,7 +15227,7 @@ program.option("-s, --session <id>", "Session ID (required for code execution)")
   if (!sessionId) {
     printError("Error: -s/--session is required.");
     printError(
-      "Run `framer session new <projectUrl> <apiKey>` first to get a session ID."
+      "Run `framer session new <projectUrlOrId>` first to get a session ID."
     );
     process.exit(1);
   }
@@ -14891,15 +15251,40 @@ program.option("-s, --session <id>", "Session ID (required for code execution)")
   }
 });
 var session = program.command("session").description("Manage sessions");
-session.command("new <projectUrl> [apiKey]").description("Create a new session and print the session ID").action(async (projectUrlArg, apiKeyArg) => {
-  const { projectId, apiKey } = resolveSessionCredentials(
-    projectUrlArg,
-    apiKeyArg
-  );
-  await ensureRelayForCli();
-  const sessionId = await createSession(projectId, apiKey);
-  await refreshSkillsFromSession(sessionId, projectId);
-  print(sessionId);
+session.command("new <projectUrlOrId>").description("Create a new session and print the session ID").action(async (projectUrlOrId) => {
+  const [credentials] = await Promise.all([
+    resolveSessionCredentials(projectUrlOrId),
+    ensureRelayForCli()
+  ]);
+  try {
+    const result = await client.createSession.mutate({
+      projectId: credentials.projectId,
+      apiKey: credentials.apiKey
+    });
+    const sessionId = result.id;
+    const [projectName] = await Promise.all([
+      getProjectName(sessionId),
+      refreshSkillsFromSession(sessionId, credentials.projectId)
+    ]);
+    saveProject({
+      projectId: credentials.projectId,
+      apiKey: credentials.apiKey,
+      name: projectName,
+      lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    print(sessionId);
+  } catch (err) {
+    const message = formatError(err);
+    printError(`Failed to create session: ${message}`);
+    if (isAuthError(message)) {
+      clearApiKey(credentials.projectId);
+      printError("The stored API key was invalid and has been removed.");
+      printError(
+        `Please try creating a session again. This will start a browser authentication flow`
+      );
+    }
+    process.exit(1);
+  }
 });
 session.command("list").description("List all active sessions").action(async () => {
   await ensureRelayForCli();
@@ -14915,6 +15300,26 @@ session.command("list").description("List all active sessions").action(async ()
     process.exit(1);
   }
 });
+var project = program.command("project").description("Manage projects");
+project.command("list").description("List recently used projects").action(() => {
+  printJson(
+    listProjects().map(({ projectId, name, lastUsedAt }) => ({
+      projectId,
+      name,
+      lastUsedAt
+    }))
+  );
+});
+project.command("auth <projectUrlOrId> [apiKey]").description("Authorize and save a project").action(async (projectUrlOrId, apiKey) => {
+  const projectId = extractProjectId(projectUrlOrId);
+  if (apiKey) {
+    saveProject({ projectId, apiKey });
+  } else {
+    const credentials = await resolveSessionCredentials(projectUrlOrId);
+    saveProject(credentials);
+  }
+  print(`Project ${projectId} saved`);
+});
 session.command("destroy <sessionId>").description("Destroy a session").action(async (sessionId) => {
   await ensureRelayForCli();
   try {

package/dist/start-relay-server.js

@@ -13,7 +13,7 @@ import { createRequire } from 'module';
 import * as vm from 'vm';
 import { connect } from 'framer-api';
 
-/* @framer/ai relay server v0.0.7 */
+/* @framer/ai relay server v0.0.9 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function getLogPath() {
@@ -50,7 +50,7 @@ function log(message) {
 __name(log, "log");
 var __filename$1 = fileURLToPath(import.meta.url);
 path.dirname(__filename$1);
-var VERSION = "0.0.7" ;
+var VERSION = "0.0.9" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 createTRPCClient({
   links: [
@@ -85,6 +85,11 @@ function isConnectionError(errorMessage) {
   );
 }
 __name(isConnectionError, "isConnectionError");
+var AUTH_ERROR_PATTERNS = ["does not have access", "UNAUTHORIZED"];
+function isAuthError(errorMessage) {
+  return AUTH_ERROR_PATTERNS.some((p) => errorMessage.includes(p));
+}
+__name(isAuthError, "isAuthError");
 var ScopedFS = class {
   static {
     __name(this, "ScopedFS");
@@ -605,9 +610,17 @@ var appRouter = t.router({
     return sessionManager.list();
   }),
   createSession: t.procedure.input(z.object({ projectId: z.string(), apiKey: z.string() })).mutation(async ({ input }) => {
-    const id = await sessionManager.create(input.projectId, input.apiKey);
-    log(`session.new id=${id} project=${input.projectId}`);
-    return { id };
+    try {
+      const id = await sessionManager.create(input.projectId, input.apiKey);
+      log(`session.new id=${id} project=${input.projectId}`);
+      return { id };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new TRPCError({
+        code: isAuthError(message) ? "UNAUTHORIZED" : "INTERNAL_SERVER_ERROR",
+        message
+      });
+    }
   }),
   destroySession: t.procedure.input(z.object({ sessionId: z.string() })).mutation(async ({ input }) => {
     await sessionManager.destroy(input.sessionId);

package/docs/skills/framer-canvas-editing-project.md

@@ -1,6 +1,7 @@
 ---
 name: {{SKILL_NAME}}
 description: "Project-scoped Framer canvas editing skill for project {{PROJECT_ID}}. Very important: never load this skill without having already read the `framer` skill and without having already run `session new`, which will dynamically update this skill."
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)"]
 ---
 
 ## Project Scope

package/docs/skills/framer.md

@@ -1,10 +1,12 @@
 ---
 name: framer
-description: "Single entry point for Framer tasks. Mandatory precondition: run `npx framer-dalton@latest setup` and let it complete BEFORE loading this skill."
+description: >
+  Use when the user wants to design, edit, or publish a website or web page — creating layouts, editing sections, updating text or images, managing CMS collections and content, syncing external data, creating or modifying code components, managing color and text styles, handling localization, or publishing deployments. Trigger when the user mentions Framer, references their website or web pages, asks to edit designs, update site content, or work with any Framer project — even if they don't explicitly say 'Framer'. 
+  **Mandatory precondition**: run `npx framer-dalton@latest setup` and let it complete **BEFORE** loading this skill.
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)"]
 ---
 
 If you didn't run this command before loading the skill, run it now:
-
 ```bash
 npx framer-dalton@latest setup
 ```
@@ -32,11 +34,18 @@ Every task follows these steps:
 
 #### 1. Connect (once per session)
 
-Ask for the Project URL, then create a session:
+If the user refers to a project by name or description rather than giving a URL, first inspect the recent projects:
+
+```bash
+npx framer-dalton project list
+```
+
+Use that list to infer the likely project from the names and recency. If the right project is already known, use its project ID with `session new`. If there are multiple possible matches, clarify with the user. Only ask the user for a Project URL if there is no clear match. Avoid talking about the technical contents of returned data like IDs.
+
+Create a session:
 
 ```bash
-npx framer-dalton session new "<projectUrl>"           # Uses cached API key
-npx framer-dalton session new "<projectUrl>" "<apiKey>" # First time: needs API key (Project Settings > General > API Keys)
+npx framer-dalton session new "<url or id>"
 ```
 
 #### 2. Look up the API (before EVERY code execution)
@@ -103,7 +112,7 @@ Each session maintains a persistent connection to a Framer project. Use sessions
 Get a new session ID:
 
 ```bash
-npx framer-dalton session new "https://framer.com/projects/Website--abc123" "framer_api_xxx"
+npx framer-dalton session new "https://framer.com/projects/Website--abc123"
 # outputs: 1
 ```
 
@@ -192,7 +201,10 @@ npx framer-dalton docs ScreenshotOptions          # Show type + recursively expa
 
 ### Working with Collections (CMS)
 
-Collections are Framer's CMS. Each collection has fields (columns) and items (rows).
+Collections are Framer's CMS. Each collection has fields (columns) and items (rows). There are two types:
+
+- **Unmanaged** (`framer.createCollection()`): Users can freely edit these in the Framer UI. Always use this by default.
+- **Managed** (`framer.createManagedCollection()`): Can ONLY be edited via the API. They appear read-only in the Framer UI. Only use managed collections when explicitly asked or when creating a script for data synchronisation.
 
 #### Reading Collections
 
@@ -257,8 +269,6 @@ await item.remove();
 
 #### Managed Collections
 
-Managed collections are fully controlled by code - users can't edit them directly. Use for syncing external data sources.
-
 ```js
 // Create a managed collection
 const managed = await framer.createManagedCollection({ name: "My Sync" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "bin": {
     "framer-dalton": "./dist/cli.js"
@@ -25,7 +25,7 @@
     "@trpc/client": "^11.9.0",
     "@trpc/server": "^11.9.0",
     "commander": "^12.1.0",
-    "framer-api": "https://pkg.pr.new/framer/FramerStudio/framer-api@5804b52.tgz",
+    "framer-api": "https://pkg.pr.new/framer/FramerStudio/framer-api@0711174.tgz",
     "zod": "^4.3.6"
   },
   "devDependencies": {