framer-dalton 0.0.21 → 0.0.23

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import fs6 from 'fs';
-import path6 from 'path';
+import fs7 from 'fs';
+import path7 from 'path';
 import { Command } from 'commander';
 import crypto, { randomUUID } from 'crypto';
 import http from 'http';
@@ -10,7 +10,7 @@ import os from 'os';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.21 */
+/* @framer/ai CLI v0.0.23 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -50,27 +50,27 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path6.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path7.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path6.join(process.env.APPDATA || os.homedir(), "framer");
+    return path7.join(process.env.APPDATA || os.homedir(), "framer");
   }
-  return path6.join(os.homedir(), ".config", "framer");
+  return path7.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function ensureConfigDir() {
   const configDir = getConfigDir();
-  fs6.mkdirSync(configDir, { recursive: true, mode: 448 });
+  fs7.mkdirSync(configDir, { recursive: true, mode: 448 });
 }
 __name(ensureConfigDir, "ensureConfigDir");
 
 // src/config/projects.ts
 function getProjectsConfigPath() {
-  return path6.join(getConfigDir(), "projects.json");
+  return path7.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path6.join(getConfigDir(), "credentials.json");
+  return path7.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -88,7 +88,7 @@ var ProjectsConfigSchema = z.object({
 var LegacyCredentialsSchema = z.record(z.string(), z.string());
 function readJsonFile(filePath) {
   try {
-    return JSON.parse(fs6.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs7.readFileSync(filePath, "utf-8"));
   } catch (_error) {
     return null;
   }
@@ -96,7 +96,7 @@ function readJsonFile(filePath) {
 __name(readJsonFile, "readJsonFile");
 function writeProjectsConfig(config) {
   ensureConfigDir();
-  fs6.writeFileSync(
+  fs7.writeFileSync(
     getProjectsConfigPath(),
     JSON.stringify(config, null, "	"),
     {
@@ -123,7 +123,7 @@ function migrateLegacyCredentials() {
   }
   const config = { version: 2, projects };
   writeProjectsConfig(config);
-  fs6.rmSync(getLegacyCredentialsPath(), { force: true });
+  fs7.rmSync(getLegacyCredentialsPath(), { force: true });
   return config;
 }
 __name(migrateLegacyCredentials, "migrateLegacyCredentials");
@@ -136,7 +136,7 @@ function readProjectsConfig() {
       return result.data;
     }
   }
-  if (fs6.existsSync(getLegacyCredentialsPath())) {
+  if (fs7.existsSync(getLegacyCredentialsPath())) {
     return migrateLegacyCredentials();
   }
   return { version: 2, projects: {} };
@@ -219,7 +219,7 @@ var SettingsWatcher = class {
     __name(this, "SettingsWatcher");
   }
   start(callback) {
-    fs6.watchFile(
+    fs7.watchFile(
       this.settingsPath,
       { persistent: false, interval: fsPollIntervalMs },
       (curr, prev) => {
@@ -236,7 +236,7 @@ var SettingsWatcher = class {
     return this;
   }
   stop() {
-    fs6.unwatchFile(this.settingsPath);
+    fs7.unwatchFile(this.settingsPath);
     return this;
   }
 };
@@ -254,7 +254,7 @@ var SettingsFileSchema = z.object({
   telemetryNoticeShown: z.boolean().optional()
 });
 function getSettingsPath() {
-  return path6.join(getConfigDir(), "settings.json");
+  return path7.join(getConfigDir(), "settings.json");
 }
 __name(getSettingsPath, "getSettingsPath");
 var settings;
@@ -273,7 +273,7 @@ __name(getSettings, "getSettings");
 function readSettingsFile() {
   const settingsPath = getSettingsPath();
   try {
-    const raw = JSON.parse(fs6.readFileSync(settingsPath, "utf-8"));
+    const raw = JSON.parse(fs7.readFileSync(settingsPath, "utf-8"));
     const result = SettingsFileSchema.parse(raw);
     return {
       machineId: result.machineId ?? DEFAULT_SETTINGS.machineId,
@@ -292,7 +292,7 @@ function setSettings(newSettings) {
 __name(setSettings, "setSettings");
 function writeSettingsFile(settings2) {
   ensureConfigDir();
-  fs6.writeFileSync(getSettingsPath(), JSON.stringify(settings2, null, "	"), {
+  fs7.writeFileSync(getSettingsPath(), JSON.stringify(settings2, null, "	"), {
     mode: 384
   });
 }
@@ -328,7 +328,7 @@ __name(markTelemetryNoticeShown, "markTelemetryNoticeShown");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.21" 
+  "0.0.23" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -6293,6 +6293,12 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "unstable_getDependencyVersion",
+        type: 'FramerPluginAPIAlpha["unstable_getDependencyVersion"]',
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "unstable_ensureMinimumDependencyVersion",
         type: 'FramerPluginAPI["unstable_ensureMinimumDependencyVersion"]',
@@ -7133,12 +7139,96 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "publishForAgent",
+        type: "(input?: Record<string, unknown>) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "queryImagesForAgent",
+        type: "(input: Record<string, unknown>) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "reviewChangesForAgent",
         type: "(options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
+      {
+        name: "flattenComponentInstanceForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "makeExternalComponentLocalForAgent",
+        type: "(input: {\n        id: string;\n        replaceAll?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodesForAgent",
+        type: "(input: {\n        ids: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getNodesOfTypesForAgent",
+        type: "(input: {\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getScopeNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getGroundNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getParentNodeForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getAncestorsForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "serializeForAgent",
+        type: "(input: {\n        id: string;\n        depth?: number;\n        attributeFilter?: readonly string[];\n        ancestorPath?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "serializeNodesForAgent",
+        type: "(input: {\n        ids: readonly string[];\n        depth?: number;\n        attributeFilter?: readonly string[];\n        ancestorPath?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "paginateForAgent",
+        type: "(input: {\n        items: readonly unknown[];\n        keyName?: never;\n        cursor?: never;\n    } | {\n        keyName: string;\n        cursor: number;\n        items?: never;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "startAgentConversation",
         type: "(prompt: string, options?: StartAgentConversationOptions) => Promise<StartAgentConversationResult>",
@@ -7157,6 +7247,12 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "runSupervisorAgentCommand",
+        type: "(options: RunSupervisorAgentCommandOptions) => Promise<RunSupervisorAgentCommandResult>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "[getAiServiceInfoMessageType]",
         type: "(version?: AiServiceVersion) => Promise<AiServiceInfo>",
@@ -7579,6 +7675,58 @@ var types = {
     alias: '"auto" | "lossless" | "small" | "medium" | "large" | "full"',
     references: []
   },
+  runsupervisoragentcommandoptions: {
+    name: "RunSupervisorAgentCommandOptions",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "goal",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "model",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "pagePath",
+        type: "string",
+        description: "",
+        optional: true
+      },
+      {
+        name: "maxSteps",
+        type: "number",
+        description: "",
+        optional: true
+      }
+    ]
+  },
+  runsupervisoragentcommandresult: {
+    name: "RunSupervisorAgentCommandResult",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "filename",
+        type: "string",
+        description: "",
+        optional: false
+      },
+      {
+        name: "archiveBase64",
+        type: "string",
+        description: "",
+        optional: false
+      }
+    ]
+  },
   screenshotoptions: {
     name: "ScreenshotOptions",
     description: "",
@@ -12891,6 +13039,13 @@ var methodsByCategory = {
       description: 'Applies commands to the canvas to create, update, remove, move, or duplicate nodes.\n\nThe command syntax is documented in the string returned by {@link getAgentSystemPrompt}.\nEach call is scoped to a single page.\n\n@param dsl - A string of commands separated by `;`. See {@link getAgentSystemPrompt} for syntax.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.',
       references: []
     },
+    {
+      name: "[$framerApiOnly.flattenComponentInstanceForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.flattenComponentInstanceForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Flattens a local component instance into raw editable layers.\n\n@param input - `{ id }`: the id of the component instance to flatten.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The flatten result \u2014 `success` with a `replacementId`, or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "[$framerApiOnly.getAgentContext]",
       category: "framer",
@@ -12905,6 +13060,83 @@ var methodsByCategory = {
       description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
       references: []
     },
+    {
+      name: "[$framerApiOnly.getAncestorsForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getAncestorsForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every ancestor of a node, from the direct parent up to the page root.\n\n@param input - `{ id }`: the id of the node to start from.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The ancestors ordered from closest parent to the page root.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getGroundNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getGroundNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the top-level node on the canvas that contains the given node.\n\n@param input - `{ id }`: the id of a descendant node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The top-level node, or `null` if none applies.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get a single node on the page, including its children.\n\n@param input - `{ id }`: the id of the node to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodesForAgent](input: { ids: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get multiple nodes on the page, including their children.\nIds that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }`: the ids of the nodes to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The nodes that were found, in input order.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getNodesOfTypesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getNodesOfTypesForAgent](input: { types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every node on the page of one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"ComponentInstanceNode"`).\n\n@param input - `{ types }`: the node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching nodes without their children.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getParentNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getParentNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the direct parent of a node.\n\n@param input - `{ id }`: the id of the child node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The parent node, or `null` if the node has no parent or doesn\'t exist.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getScopeNodeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.getScopeNodeForAgent](input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the scope node (page or component) that contains the given node.\n\n@param input - `{ id }`: the id of a node inside the scope.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The enclosing scope node, or `null` if the node isn\'t in any scope.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.makeExternalComponentLocalForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.makeExternalComponentLocalForAgent](input: { id: string; replaceAll?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Converts an external component into a local project component.\n\n@param input - `{ id, replaceAll? }`: the id of the external instance, and whether to replace all instances.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `success` (with the local component name), `needs_confirmation` (retry with `replaceAll`), or `blocked` with a reason.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.paginateForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.paginateForAgent](input: { items: readonly unknown[]; keyName?: never; cursor?: never; } | { keyName: string; cursor: number; items?: never; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Paginate a large array of values across multiple calls. The cursor is\nopaque and only valid within the same headless session and page.\n\n- First page: pass `{ items }`.\n- Continuation: pass `{ keyName, cursor }` using values returned by a previous call.\n\n@param input - `{ items }` for a fresh array, or `{ keyName, cursor }` for continuation.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The current page, including `keyName`, `cursor`, `results`, `totalResults`, and (if more pages remain) `nextCursor`.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.publishForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.publishForAgent](input?: Record<string, unknown>): Promise<unknown>",
+      description: "Executes the publish flow on behalf of an agent.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).\n@returns The action's result \u2014 status, publish URLs, and any errors, warnings, or changes.",
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.queryImagesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.queryImagesForAgent](input: Record<string, unknown>): Promise<unknown>",
+      description: 'Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns\ncandidate images with preview thumbnails and a `url` field for each. The returned URLs are\nregistered as trusted for this session so they can be applied directly via `fill="<url>"`\nin a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,\nexternal image URLs are rejected at apply time.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
+      references: []
+    },
     {
       name: "[$framerApiOnly.readProjectForAgent]",
       category: "framer",
@@ -12919,6 +13151,20 @@ var methodsByCategory = {
       description: "Reviews changes made by prior {@link applyAgentChanges} calls in this session.\n\nConsumes accumulated diagnostics from the session's agent context.\n\n@param options.pagePath - Target page path (e.g. `\"/about\"`). Defaults to the active page.\n@returns The session's accumulated changes, errors, warnings, and deferred trait reports.",
       references: []
     },
+    {
+      name: "[$framerApiOnly.serializeForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.serializeForAgent](input: { id: string; depth?: number; attributeFilter?: readonly string[]; ancestorPath?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Serialize a single node on the page.\n\n@param input - `{ id }` plus optional serialization options:\n  - `depth` \u2014 limit how many descendant levels to include.\n  - `attributeFilter` \u2014 only return the listed attributes per node.\n  - `ancestorPath` \u2014 also return the path of ancestors up to the page root.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The serialized node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.serializeNodesForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.serializeNodesForAgent](input: { ids: readonly string[]; depth?: number; attributeFilter?: readonly string[]; ancestorPath?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Serialize multiple nodes on the page. Ids that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }` plus optional serialization options:\n  - `depth` \u2014 limit how many descendant levels to include.\n  - `attributeFilter` \u2014 only return the listed attributes per node.\n  - `ancestorPath` \u2014 also return the path of ancestors up to the page root.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The serialized nodes that were found, in input order.',
+      references: []
+    },
     {
       name: "[$framerInternal.initialState]",
       category: "framer",
@@ -13121,6 +13367,13 @@ var methodsByCategory = {
       description: "",
       references: []
     },
+    {
+      name: "flattenComponentInstanceForAgent",
+      category: "framer",
+      signature: "flattenComponentInstanceForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Flattens a local component instance into raw editable layers.\n\n@param input - `{ id }`: the id of the component instance to flatten.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The flatten result \u2014 `success` with a `replacementId`, or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "getAgentContext",
       category: "framer",
@@ -13135,6 +13388,13 @@ var methodsByCategory = {
       description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
       references: []
     },
+    {
+      name: "getAncestorsForAgent",
+      category: "framer",
+      signature: "getAncestorsForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every ancestor of a node, from the direct parent up to the page root.\n\n@param input - `{ id }`: the id of the node to start from.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The ancestors ordered from closest parent to the page root.',
+      references: []
+    },
     {
       name: "getCanvasRoot",
       category: "framer",
@@ -13247,6 +13507,13 @@ var methodsByCategory = {
       description: "Get all available fonts.\n\nUnlike the Font Picker which groups fonts by typeface, this lists\nindividual fonts for each weight and style (each representing a separate\nfont file).\n\nNote: Custom fonts are not available to plugins.\n\n@returns An array of all available fonts.\n\n@example\n```ts\nconst fonts = await framer.getFonts()\n```\n@category canvas",
       references: ["Font"]
     },
+    {
+      name: "getGroundNodeForAgent",
+      category: "framer",
+      signature: "getGroundNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the top-level node on the canvas that contains the given node.\n\n@param input - `{ id }`: the id of a descendant node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The top-level node, or `null` if none applies.',
+      references: []
+    },
     {
       name: "getImage",
       category: "framer",
@@ -13296,6 +13563,27 @@ var methodsByCategory = {
       description: "Get a node by its id.\n@category canvas",
       references: ["AnyNode"]
     },
+    {
+      name: "getNodeForAgent",
+      category: "framer",
+      signature: "getNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get a single node on the page, including its children.\n\n@param input - `{ id }`: the id of the node to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "getNodesForAgent",
+      category: "framer",
+      signature: "getNodesForAgent(input: { ids: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get multiple nodes on the page, including their children.\nIds that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }`: the ids of the nodes to read.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The nodes that were found, in input order.',
+      references: []
+    },
+    {
+      name: "getNodesOfTypesForAgent",
+      category: "framer",
+      signature: "getNodesOfTypesForAgent(input: { types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get every node on the page of one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"ComponentInstanceNode"`).\n\n@param input - `{ types }`: the node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching nodes without their children.',
+      references: []
+    },
     {
       name: "getNodesWithAttribute",
       category: "framer",
@@ -13324,6 +13612,13 @@ var methodsByCategory = {
       description: "Get the parent of a node.\n@category canvas",
       references: ["AnyNode"]
     },
+    {
+      name: "getParentNodeForAgent",
+      category: "framer",
+      signature: "getParentNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the direct parent of a node.\n\n@param input - `{ id }`: the id of the child node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The parent node, or `null` if the node has no parent or doesn\'t exist.',
+      references: []
+    },
     {
       name: "getProjectInfo",
       category: "framer",
@@ -13352,6 +13647,13 @@ var methodsByCategory = {
       description: "Get all Redirects in the project.\n\n@returns All of the Redirects in the project.\n\n@example\n```ts\nconst redirects = await framer.getRedirects()\n```\n@category settings",
       references: ["Redirect"]
     },
+    {
+      name: "getScopeNodeForAgent",
+      category: "framer",
+      signature: "getScopeNodeForAgent(input: { id: string; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get the scope node (page or component) that contains the given node.\n\n@param input - `{ id }`: the id of a node inside the scope.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The enclosing scope node, or `null` if the node isn\'t in any scope.',
+      references: []
+    },
     {
       name: "getText",
       category: "framer",
@@ -13380,6 +13682,13 @@ var methodsByCategory = {
       description: "Get all available vector sets.\n\n@alpha",
       references: ["VectorSet"]
     },
+    {
+      name: "makeExternalComponentLocalForAgent",
+      category: "framer",
+      signature: "makeExternalComponentLocalForAgent(input: { id: string; replaceAll?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Converts an external component into a local project component.\n\n@param input - `{ id, replaceAll? }`: the id of the external instance, and whether to replace all instances.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `success` (with the local component name), `needs_confirmation` (retry with `replaceAll`), or `blocked` with a reason.',
+      references: []
+    },
     {
       name: "mode",
       category: "framer",
@@ -13387,6 +13696,13 @@ var methodsByCategory = {
       description: 'Get the current mode.\n\nA plugin can launch in a special mode where only a subset of the API is\nallowed. The mode is set when the plugin launches and never changes while\nthe plugin is active.\n\n@example\n```ts\nif (framer.mode === "image" || framer.mode === "editImage") {\n  // Do image mode specific logic\n  return\n}\n```\n@category settings',
       references: ["Mode"]
     },
+    {
+      name: "paginateForAgent",
+      category: "framer",
+      signature: "paginateForAgent(input: { items: readonly unknown[]; keyName?: never; cursor?: never; } | { keyName: string; cursor: number; items?: never; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Paginate a large array of values across multiple calls. The cursor is\nopaque and only valid within the same headless session and page.\n\n- First page: pass `{ items }`.\n- Continuation: pass `{ keyName, cursor }` using values returned by a previous call.\n\n@param input - `{ items }` for a fresh array, or `{ keyName, cursor }` for continuation.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The current page, including `keyName`, `cursor`, `results`, `totalResults`, and (if more pages remain) `nextCursor`.',
+      references: []
+    },
     {
       name: "publish",
       category: "framer",
@@ -13394,6 +13710,20 @@ var methodsByCategory = {
       description: "",
       references: ["PublishResult"]
     },
+    {
+      name: "publishForAgent",
+      category: "framer",
+      signature: "publishForAgent(input?: Record<string, unknown>): Promise<unknown>",
+      description: "Executes the publish flow on behalf of an agent.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).\n@returns The action's result \u2014 status, publish URLs, and any errors, warnings, or changes.",
+      references: []
+    },
+    {
+      name: "queryImagesForAgent",
+      category: "framer",
+      signature: "queryImagesForAgent(input: Record<string, unknown>): Promise<unknown>",
+      description: 'Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns\ncandidate images with preview thumbnails and a `url` field for each. The returned URLs are\nregistered as trusted for this session so they can be applied directly via `fill="<url>"`\nin a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,\nexternal image URLs are rejected at apply time.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
+      references: []
+    },
     {
       name: "readProjectForAgent",
       category: "framer",
@@ -13436,6 +13766,16 @@ var methodsByCategory = {
       description: "Reviews changes made by prior {@link applyAgentChanges} calls in this session.\n\nConsumes accumulated diagnostics from the session's agent context.\n\n@param options.pagePath - Target page path (e.g. `\"/about\"`). Defaults to the active page.\n@returns The session's accumulated changes, errors, warnings, and deferred trait reports.",
       references: []
     },
+    {
+      name: "runSupervisorAgentCommand",
+      category: "framer",
+      signature: "runSupervisorAgentCommand(options: RunSupervisorAgentCommandOptions): Promise<RunSupervisorAgentCommandResult>",
+      description: "",
+      references: [
+        "RunSupervisorAgentCommandOptions",
+        "RunSupervisorAgentCommandResult"
+      ]
+    },
     {
       name: "screenshot",
       category: "framer",
@@ -13443,6 +13783,20 @@ var methodsByCategory = {
       description: "",
       references: ["ScreenshotOptions", "ScreenshotResult"]
     },
+    {
+      name: "serializeForAgent",
+      category: "framer",
+      signature: "serializeForAgent(input: { id: string; depth?: number; attributeFilter?: readonly string[]; ancestorPath?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Serialize a single node on the page.\n\n@param input - `{ id }` plus optional serialization options:\n  - `depth` \u2014 limit how many descendant levels to include.\n  - `attributeFilter` \u2014 only return the listed attributes per node.\n  - `ancestorPath` \u2014 also return the path of ancestors up to the page root.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The serialized node, or `null` if no node with that id exists on the page.',
+      references: []
+    },
+    {
+      name: "serializeNodesForAgent",
+      category: "framer",
+      signature: "serializeNodesForAgent(input: { ids: readonly string[]; depth?: number; attributeFilter?: readonly string[]; ancestorPath?: boolean; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Serialize multiple nodes on the page. Ids that don\'t resolve to a node are skipped.\n\n@param input - `{ ids }` plus optional serialization options:\n  - `depth` \u2014 limit how many descendant levels to include.\n  - `attributeFilter` \u2014 only return the listed attributes per node.\n  - `ancestorPath` \u2014 also return the path of ancestors up to the page root.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The serialized nodes that were found, in input order.',
+      references: []
+    },
     {
       name: "sessionId",
       category: "framer",
@@ -15737,13 +16091,35 @@ function inferHeadlessServerUrl(projectUrlOrId) {
   }
 }
 __name(inferHeadlessServerUrl, "inferHeadlessServerUrl");
+function getRelayTokenPath() {
+  return path7.join(getConfigDir(), "relay-token");
+}
+__name(getRelayTokenPath, "getRelayTokenPath");
+function readRelayToken() {
+  try {
+    const token = fs7.readFileSync(getRelayTokenPath(), "utf-8").trim();
+    return token.length > 0 ? token : null;
+  } catch {
+    return null;
+  }
+}
+__name(readRelayToken, "readRelayToken");
+
+// src/relay-client.ts
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path6.dirname(__filename$1);
+var __dirname$1 = path7.dirname(__filename$1);
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
     httpLink({
-      url: `http://127.0.0.1:${RELAY_PORT}`
+      url: `http://127.0.0.1:${RELAY_PORT}`,
+      headers() {
+        const token = readRelayToken();
+        if (!token) {
+          return {};
+        }
+        return { Authorization: `Bearer ${token}` };
+      }
     })
   ]
 });
@@ -15806,7 +16182,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path6.resolve(__dirname$1, "./start-relay-server.ts") : path6.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path7.resolve(__dirname$1, "./start-relay-server.ts") : path7.resolve(__dirname$1, "./start-relay-server.js");
   debug("relay", `spawning server process: ${scriptPath}`);
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
@@ -15833,19 +16209,19 @@ async function ensureRelayServerRunning(options = {}) {
   throw new Error("Failed to start relay server after 5 seconds");
 }
 __name(ensureRelayServerRunning, "ensureRelayServerRunning");
-var FRAMER_TEMPORARY_DIR = path6.join(os.tmpdir(), "framer");
+var FRAMER_TEMPORARY_DIR = path7.join(os.tmpdir(), "framer");
 function ensureTemporaryDir() {
-  fs6.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+  fs7.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
 }
 __name(ensureTemporaryDir, "ensureTemporaryDir");
 function cleanupStaleSessionCodeFiles(activeSessionIds) {
-  if (!fs6.existsSync(FRAMER_TEMPORARY_DIR)) return;
+  if (!fs7.existsSync(FRAMER_TEMPORARY_DIR)) return;
   const activeSessionIdsSet = new Set(activeSessionIds);
-  for (const entry of fs6.readdirSync(FRAMER_TEMPORARY_DIR)) {
+  for (const entry of fs7.readdirSync(FRAMER_TEMPORARY_DIR)) {
     const [sessionId] = entry.split("-");
     if (activeSessionIdsSet.has(sessionId)) continue;
-    const filePath = path6.join(FRAMER_TEMPORARY_DIR, entry);
-    fs6.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
+    const filePath = path7.join(FRAMER_TEMPORARY_DIR, entry);
+    fs7.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
   }
 }
 __name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
@@ -15853,10 +16229,10 @@ __name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
 // src/skills.ts
 var META_SKILL_NAME = "framer";
 var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path6.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path6.join(__dirname2, "..", "docs", "skills");
+var __dirname2 = path7.dirname(fileURLToPath(import.meta.url));
+var skillsDocsDir = path7.join(__dirname2, "..", "docs", "skills");
 function readSkillDoc(name2) {
-  return fs6.readFileSync(path6.join(skillsDocsDir, name2), "utf-8").trimEnd();
+  return fs7.readFileSync(path7.join(skillsDocsDir, name2), "utf-8").trimEnd();
 }
 __name(readSkillDoc, "readSkillDoc");
 function buildMetaSkill() {
@@ -15899,27 +16275,27 @@ function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
 }
 __name(buildProjectCanvasSkill, "buildProjectCanvasSkill");
 function writeSkill(root, skillName, content) {
-  fs6.mkdirSync(root, { recursive: true });
-  const rootStat = fs6.statSync(root);
+  fs7.mkdirSync(root, { recursive: true });
+  const rootStat = fs7.statSync(root);
   if (!rootStat.isDirectory()) {
     throw new Error(`Skill root is not a directory: ${root}`);
   }
-  const skillDir = path6.join(root, skillName);
-  const filePath = path6.join(skillDir, "SKILL.md");
-  const current = fs6.lstatSync(skillDir, { throwIfNoEntry: false });
+  const skillDir = path7.join(root, skillName);
+  const filePath = path7.join(skillDir, "SKILL.md");
+  const current = fs7.lstatSync(skillDir, { throwIfNoEntry: false });
   if (current && (current.isSymbolicLink() || !current.isDirectory())) {
-    fs6.rmSync(skillDir, { recursive: true, force: true });
+    fs7.rmSync(skillDir, { recursive: true, force: true });
   }
-  fs6.mkdirSync(skillDir, { recursive: true });
-  fs6.writeFileSync(filePath, content, "utf-8");
+  fs7.mkdirSync(skillDir, { recursive: true });
+  fs7.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 __name(writeSkill, "writeSkill");
 function getDefaultSkillRoots() {
   const home = os.homedir();
   return [
-    path6.join(home, ".agents", "skills"),
-    path6.join(home, ".claude", "skills")
+    path7.join(home, ".agents", "skills"),
+    path7.join(home, ".claude", "skills")
   ];
 }
 __name(getDefaultSkillRoots, "getDefaultSkillRoots");
@@ -15929,14 +16305,14 @@ function cleanupStaleSkills(activeProjectIds, skillRoots) {
     [...activeProjectIds].map(toSafeProjectId)
   );
   for (const root of roots) {
-    if (!fs6.existsSync(root)) continue;
-    for (const entry of fs6.readdirSync(root)) {
+    if (!fs7.existsSync(root)) continue;
+    for (const entry of fs7.readdirSync(root)) {
       if (!entry.startsWith(CANVAS_SKILL_PREFIX)) continue;
       const sanitizedProjectId = entry.slice(CANVAS_SKILL_PREFIX.length);
       const isActive = sanitizedActiveProjectIds.has(sanitizedProjectId);
       if (isActive) continue;
-      const skillDir = path6.join(root, entry);
-      fs6.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+      const skillDir = path7.join(root, entry);
+      fs7.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
     }
   }
 }
@@ -15997,8 +16373,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path6.dirname(filePath);
-      const root = path6.dirname(skillDir);
+      const skillDir = path7.dirname(filePath);
+      const root = path7.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -16173,7 +16549,7 @@ program.command("exec").description("Execute code in a session").requiredOption(
   let code = evalCode;
   if (!code && filePath) {
     try {
-      code = fs6.readFileSync(filePath, "utf-8");
+      code = fs7.readFileSync(filePath, "utf-8");
     } catch (err) {
       printError(`Failed to read file: ${formatError(err)}`);
       await waitForTrackingToFinish();