framer-dalton 0.0.26 → 0.0.28

package/dist/cli.js

@@ -4,15 +4,15 @@ import path7 from 'path';
 import { Command } from 'commander';
 import crypto, { randomUUID } from 'crypto';
 import http from 'http';
-import { spawn, execFile } from 'child_process';
+import { spawn, execFile, execFileSync } from 'child_process';
 import { z } from 'zod';
-import os from 'os';
+import os2 from 'os';
 import { ErrorCode, FramerAPIError } from 'framer-api';
 import net from 'net';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.26 */
+/* @framer/ai CLI v0.0.28 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -100,9 +100,9 @@ function getConfigDir() {
     return path7.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path7.join(process.env.APPDATA || os.homedir(), "framer");
+    return path7.join(process.env.APPDATA || os2.homedir(), "framer");
   }
-  return path7.join(os.homedir(), ".config", "framer");
+  return path7.join(os2.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function ensureConfigDir() {
@@ -375,15 +375,59 @@ __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.26" 
+  "0.0.28" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
-function sharedFields() {
+var cachedSharedFields;
+function getOsName(platform) {
+  switch (platform) {
+    case "darwin":
+      return "macos";
+    case "win32":
+      return "windows";
+    case "linux":
+      return "linux";
+    default:
+      return "unknown";
+  }
+}
+__name(getOsName, "getOsName");
+function getMacOsVersion() {
+  try {
+    const version = execFileSync("/usr/bin/sw_vers", ["-productVersion"], {
+      encoding: "utf8",
+      timeout: 1e3
+    }).trim();
+    return version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+__name(getMacOsVersion, "getMacOsVersion");
+function getOsVersion(platform) {
+  if (platform === "darwin") return getMacOsVersion();
+  const version = os2.release().trim();
+  return version || "unknown";
+}
+__name(getOsVersion, "getOsVersion");
+function getOsMetadata() {
+  const platform = os2.platform();
+  const arch = os2.arch();
   return {
+    arch: arch || "unknown",
+    osName: getOsName(platform),
+    osVersion: getOsVersion(platform)
+  };
+}
+__name(getOsMetadata, "getOsMetadata");
+function sharedFields() {
+  cachedSharedFields ??= {
     machineId: getMachineId(),
-    cliVersion: VERSION
+    cliVersion: VERSION,
+    ...getOsMetadata()
   };
+  return cachedSharedFields;
 }
 __name(sharedFields, "sharedFields");
 function wrapEvent(event) {
@@ -396,16 +440,19 @@ function wrapEvent(event) {
   };
 }
 __name(wrapEvent, "wrapEvent");
-function postEvent(event) {
+function postEvent(createEvent) {
   if (!isTelemetryEnabled()) return false;
   if (process.env.NODE_ENV === "test" && true) return false;
+  const event = createEvent();
+  const body = JSON.stringify([wrapEvent(event)]);
+  debug("tracking", `sending ${event.event} to ${trackingEndpoint}: ${body}`);
   const promise = fetch(trackingEndpoint, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "User-Agent": `framer-dalton/${VERSION}`
     },
-    body: JSON.stringify([wrapEvent(event)]),
+    body,
     signal: AbortSignal.timeout(
       5e3
       /* 5 seconds */
@@ -434,35 +481,43 @@ function waitForTrackingToFinish() {
 }
 __name(waitForTrackingToFinish, "waitForTrackingToFinish");
 function trackAuthStart(payload) {
-  postEvent({
-    event: "local_agents_auth_start",
-    ...sharedFields(),
-    ...payload
-  });
+  postEvent(
+    () => ({
+      event: "local_agents_auth_start",
+      ...sharedFields(),
+      ...payload
+    })
+  );
 }
 __name(trackAuthStart, "trackAuthStart");
 function trackAuthSuccess(payload) {
-  postEvent({
-    event: "local_agents_auth_success",
-    ...sharedFields(),
-    ...payload
-  });
+  postEvent(
+    () => ({
+      event: "local_agents_auth_success",
+      ...sharedFields(),
+      ...payload
+    })
+  );
 }
 __name(trackAuthSuccess, "trackAuthSuccess");
 function trackSkillsInstall(payload) {
-  postEvent({
-    event: "local_agents_skills_install",
-    ...sharedFields(),
-    ...payload
-  });
+  postEvent(
+    () => ({
+      event: "local_agents_skills_install",
+      ...sharedFields(),
+      ...payload
+    })
+  );
 }
 __name(trackSkillsInstall, "trackSkillsInstall");
 function trackError(payload) {
-  postEvent({
-    event: "local_agents_error",
-    ...sharedFields(),
-    ...payload
-  });
+  postEvent(
+    () => ({
+      event: "local_agents_error",
+      ...sharedFields(),
+      ...payload
+    })
+  );
 }
 __name(trackError, "trackError");
 
@@ -11036,6 +11091,10 @@ var classes = {
     name: "framer",
     description: ""
   },
+  frameragentapi: {
+    name: "FramerAgentAPI",
+    description: 'Agent-specific methods exposed by framer-api as its agent namespace.\n\nEach method delegates to the corresponding wire-protocol name on the engine\n(e.g. `agent.publish(...)` invokes `"publishForAgent"`).'
+  },
   framerapierror: {
     name: "FramerAPIError",
     description: ""
@@ -13260,179 +13319,11 @@ var methodsByCategory = {
     }
   ],
   framer: [
-    {
-      name: "[$framerApiOnly.applyAgentChanges]",
-      category: "framer",
-      signature: "[$framerApiOnly.applyAgentChanges](dsl: string, options?: { pagePath?: string; }): Promise<void>",
-      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",
-      signature: "[$framerApiOnly.getAgentContext](options?: { pagePath?: string; }): Promise<string>",
-      description: 'Returns the dynamic project context as a string.\n\nThe context includes project-specific data:\n- **Available fonts** \u2014 font families loaded in the project.\n- **Components** \u2014 component names and their controls.\n- **Design tokens** \u2014 color tokens defined in the project.\n- **Style presets** \u2014 text style presets defined in the project.\n- **Icon sets** \u2014 available icon sets and their definitions.\n\nThis data changes per project and page. Pair with the static prompt\nfrom {@link getAgentSystemPrompt} for complete agent context.\n\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns A string containing the project context.',
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.getAgentSystemPrompt]",
-      category: "framer",
-      signature: "[$framerApiOnly.getAgentSystemPrompt](): Promise<string>",
-      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.ping]",
       category: "framer",
       signature: "[$framerApiOnly.ping](): Promise<void>",
-      description: "Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless\n backend to verify the transport actually routes, not just that the page is alive.",
-      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.readComponentControlsForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readComponentControlsForAgent](input: { componentIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readIconSetControlsForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readIconSetControlsForAgent](input: { iconSetNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readIconsForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readIconsForAgent](input: { iconSetName: string; }, options?: { pagePath?: string; }): Promise<string[]>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readLayoutTemplateControlsForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readLayoutTemplateControlsForAgent](input: { layoutTemplateIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readProjectForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readProjectForAgent](queries: Record<string, unknown>[], options?: { pagePath?: string; }): Promise<{ results: unknown[]; }>",
-      description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readShaderControlsForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.readShaderControlsForAgent](input: { shaderNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.reviewChangesForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.reviewChangesForAgent](options?: { pagePath?: string; }): Promise<unknown>",
-      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.',
+      description: "Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless backend to verify the transport actually routes, not just that the page is alive.",
       references: []
     },
     {
@@ -13516,11 +13407,11 @@ var methodsByCategory = {
       references: ["AddTextOptions"]
     },
     {
-      name: "applyAgentChanges",
+      name: "agent",
       category: "framer",
-      signature: "applyAgentChanges(dsl: string, options?: { pagePath?: string; }): Promise<void>",
-      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: []
+      signature: "agent: FramerAgentAPI",
+      description: 'Agent-specific methods exposed by framer-api as its agent namespace.\n\nEach method delegates to the corresponding wire-protocol name on the engine\n(e.g. `agent.publish(...)` invokes `"publishForAgent"`).',
+      references: ["FramerAgentAPI"]
     },
     {
       name: "cloneNode",
@@ -13529,16 +13420,6 @@ var methodsByCategory = {
       description: "Clone a node.\n@category canvas",
       references: ["AnyNode"]
     },
-    {
-      name: "continueAgentConversation",
-      category: "framer",
-      signature: "continueAgentConversation(prompt: string, options: ContinueAgentConversationOptions): Promise<ContinueAgentConversationResult>",
-      description: "",
-      references: [
-        "ContinueAgentConversationOptions",
-        "ContinueAgentConversationResult"
-      ]
-    },
     {
       name: "createCodeFile",
       category: "framer",
@@ -13637,34 +13518,6 @@ 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",
-      signature: "getAgentContext(options?: { pagePath?: string; }): Promise<string>",
-      description: 'Returns the dynamic project context as a string.\n\nThe context includes project-specific data:\n- **Available fonts** \u2014 font families loaded in the project.\n- **Components** \u2014 component names and their controls.\n- **Design tokens** \u2014 color tokens defined in the project.\n- **Style presets** \u2014 text style presets defined in the project.\n- **Icon sets** \u2014 available icon sets and their definitions.\n\nThis data changes per project and page. Pair with the static prompt\nfrom {@link getAgentSystemPrompt} for complete agent context.\n\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns A string containing the project context.',
-      references: []
-    },
-    {
-      name: "getAgentSystemPrompt",
-      category: "framer",
-      signature: "getAgentSystemPrompt(): Promise<string>",
-      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",
@@ -13777,13 +13630,6 @@ 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",
@@ -13833,27 +13679,6 @@ 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",
@@ -13882,13 +13707,6 @@ 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",
@@ -13917,13 +13735,6 @@ 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",
@@ -13952,13 +13763,6 @@ 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",
@@ -13966,18 +13770,11 @@ 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: "ping",
       category: "framer",
       signature: "ping(): Promise<void>",
-      description: "Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless\n backend to verify the transport actually routes, not just that the page is alive.",
+      description: "Liveness round-trip: resolves once Vekter's plugin handler answers. Used by the headless backend to verify the transport actually routes, not just that the page is alive.",
       references: []
     },
     {
@@ -13987,62 +13784,6 @@ 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: "readComponentControlsForAgent",
-      category: "framer",
-      signature: "readComponentControlsForAgent(input: { componentIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "readIconSetControlsForAgent",
-      category: "framer",
-      signature: "readIconSetControlsForAgent(input: { iconSetNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "readIconsForAgent",
-      category: "framer",
-      signature: "readIconsForAgent(input: { iconSetName: string; }, options?: { pagePath?: string; }): Promise<string[]>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "readLayoutTemplateControlsForAgent",
-      category: "framer",
-      signature: "readLayoutTemplateControlsForAgent(input: { layoutTemplateIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
-    {
-      name: "readProjectForAgent",
-      category: "framer",
-      signature: "readProjectForAgent(queries: Record<string, unknown>[], options?: { pagePath?: string; }): Promise<{ results: unknown[]; }>",
-      description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
-      references: []
-    },
-    {
-      name: "readShaderControlsForAgent",
-      category: "framer",
-      signature: "readShaderControlsForAgent(input: { shaderNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
-      description: "@alpha",
-      references: []
-    },
     {
       name: "rejectAllPending",
       category: "framer",
@@ -14071,23 +13812,6 @@ var methodsByCategory = {
       description: "",
       references: []
     },
-    {
-      name: "reviewChangesForAgent",
-      category: "framer",
-      signature: "reviewChangesForAgent(options?: { pagePath?: string; }): Promise<unknown>",
-      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",
@@ -14095,20 +13819,6 @@ 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",
@@ -14179,26 +13889,6 @@ var methodsByCategory = {
       description: "Set the text of the current selection or insert it onto the canvas.\n@category canvas",
       references: []
     },
-    {
-      name: "startAgentConversation",
-      category: "framer",
-      signature: "startAgentConversation(prompt: string, options?: StartAgentConversationOptions): Promise<StartAgentConversationResult>",
-      description: "",
-      references: [
-        "StartAgentConversationOptions",
-        "StartAgentConversationResult"
-      ]
-    },
-    {
-      name: "submitAgentClarification",
-      category: "framer",
-      signature: "submitAgentClarification(options: SubmitAgentClarificationOptions): Promise<SubmitAgentClarificationResult>",
-      description: "",
-      references: [
-        "SubmitAgentClarificationOptions",
-        "SubmitAgentClarificationResult"
-      ]
-    },
     {
       name: "typecheckCode",
       category: "framer",
@@ -14235,6 +13925,176 @@ var methodsByCategory = {
       references: ["NamedImageAssetInput", "ImageAsset"]
     }
   ],
+  frameragentapi: [
+    {
+      name: "applyChanges",
+      category: "FramerAgentAPI",
+      signature: "applyChanges(dsl: string, options?: { pagePath?: string; }): Promise<void>",
+      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 getSystemPrompt}.\nEach call is scoped to a single page.\n\n@param dsl - A string of commands separated by `;`. See {@link getSystemPrompt} for syntax.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.',
+      references: []
+    },
+    {
+      name: "flattenComponentInstance",
+      category: "FramerAgentAPI",
+      signature: "flattenComponentInstance(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: "getAncestors",
+      category: "FramerAgentAPI",
+      signature: "getAncestors(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: "getContext",
+      category: "FramerAgentAPI",
+      signature: "getContext(options?: { pagePath?: string; }): Promise<string>",
+      description: 'Returns the dynamic project context as a string.\n\nThe context includes project-specific data:\n- **Available fonts** \u2014 font families loaded in the project.\n- **Components** \u2014 component names and their controls.\n- **Design tokens** \u2014 color tokens defined in the project.\n- **Style presets** \u2014 text style presets defined in the project.\n- **Icon sets** \u2014 available icon sets and their definitions.\n\nThis data changes per project and page. Pair with the static prompt\nfrom {@link getSystemPrompt} for complete agent context.\n\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns A string containing the project context.',
+      references: []
+    },
+    {
+      name: "getGroundNode",
+      category: "FramerAgentAPI",
+      signature: "getGroundNode(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: "getNode",
+      category: "FramerAgentAPI",
+      signature: "getNode(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: "getNodes",
+      category: "FramerAgentAPI",
+      signature: "getNodes(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: "getNodesOfTypes",
+      category: "FramerAgentAPI",
+      signature: "getNodesOfTypes(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: "getParentNode",
+      category: "FramerAgentAPI",
+      signature: "getParentNode(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: "getScopeNode",
+      category: "FramerAgentAPI",
+      signature: "getScopeNode(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: "getSystemPrompt",
+      category: "FramerAgentAPI",
+      signature: "getSystemPrompt(): Promise<string>",
+      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- **`readProject` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyChanges}\nand the query types used by {@link readProject}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
+      references: []
+    },
+    {
+      name: "makeExternalComponentLocal",
+      category: "FramerAgentAPI",
+      signature: "makeExternalComponentLocal(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: "paginate",
+      category: "FramerAgentAPI",
+      signature: "paginate(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: "FramerAgentAPI",
+      signature: "publish(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 getSystemPrompt}.\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: "queryImages",
+      category: "FramerAgentAPI",
+      signature: "queryImages(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 applyChanges} 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 getSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
+      references: []
+    },
+    {
+      name: "readComponentControls",
+      category: "FramerAgentAPI",
+      signature: "readComponentControls(input: { componentIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Reads control definitions for project components.\n\n@param input - `{ componentIds }`: component ids from project context or previous reads.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching component control definitions.',
+      references: []
+    },
+    {
+      name: "readIcons",
+      category: "FramerAgentAPI",
+      signature: "readIcons(input: { iconSetName: string; }, options?: { pagePath?: string; }): Promise<string[]>",
+      description: 'Reads exact icon names for an icon set.\n\n@param input - `{ iconSetName }`: icon set name from project context or previous reads.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The available icon names in that set.',
+      references: []
+    },
+    {
+      name: "readIconSetControls",
+      category: "FramerAgentAPI",
+      signature: "readIconSetControls(input: { iconSetNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Reads icon-set control definitions.\n\n@param input - `{ iconSetNames }`: icon set names from project context or previous reads.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching icon-set control definitions.',
+      references: []
+    },
+    {
+      name: "readLayoutTemplateControls",
+      category: "FramerAgentAPI",
+      signature: "readLayoutTemplateControls(input: { layoutTemplateIds: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Reads layout-template control definitions.\n\n@param input - `{ layoutTemplateIds }`: layout template ids from project context or previous reads.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching layout-template control definitions.',
+      references: []
+    },
+    {
+      name: "readProject",
+      category: "FramerAgentAPI",
+      signature: "readProject(queries: Record<string, unknown>[], options?: { pagePath?: string; }): Promise<{ results: unknown[]; }>",
+      description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
+      references: []
+    },
+    {
+      name: "readShaderControls",
+      category: "FramerAgentAPI",
+      signature: "readShaderControls(input: { shaderNames: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Reads shader control definitions.\n\n@param input - `{ shaderNames }`: shader names from project context or previous reads.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching shader control definitions.',
+      references: []
+    },
+    {
+      name: "reviewChanges",
+      category: "FramerAgentAPI",
+      signature: "reviewChanges(options?: { pagePath?: string; }): Promise<unknown>",
+      description: "Reviews changes made by prior {@link applyChanges} 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: "serialize",
+      category: "FramerAgentAPI",
+      signature: "serialize(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: "serializeNodes",
+      category: "FramerAgentAPI",
+      signature: "serializeNodes(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: []
+    }
+  ],
   framerapierror: [
     {
       name: "recentMethods",
@@ -16625,7 +16485,7 @@ async function waitForClaudeCodeSkillDiscovery() {
   );
 }
 __name(waitForClaudeCodeSkillDiscovery, "waitForClaudeCodeSkillDiscovery");
-var FRAMER_TEMPORARY_DIR = path7.join(os.tmpdir(), "framer");
+var FRAMER_TEMPORARY_DIR = path7.join(os2.tmpdir(), "framer");
 function ensureTemporaryDir() {
   fs7.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
 }
@@ -16720,7 +16580,7 @@ function cleanupLegacyCanvasEditingSkills(skillRoots = getDefaultSkillRoots()) {
 }
 __name(cleanupLegacyCanvasEditingSkills, "cleanupLegacyCanvasEditingSkills");
 function getDefaultSkillRoots() {
-  const home = os.homedir();
+  const home = os2.homedir();
   return [
     path7.join(home, ".agents", "skills"),
     path7.join(home, ".claude", "skills")
@@ -16829,7 +16689,7 @@ async function getAgentSystemPrompt(sessionId) {
   debug("exec", "getAgentSystemPrompt: calling relay...");
   const result = await client.exec.mutate({
     sessionId,
-    code: "return await framer.getAgentSystemPrompt();",
+    code: "return await framer.agent.getSystemPrompt();",
     cwd: process.cwd()
   });
   debug("exec", "getAgentSystemPrompt: relay responded");
@@ -16845,7 +16705,7 @@ async function getAgentContext(sessionId) {
   debug("exec", "getAgentContext: calling relay...");
   const result = await client.exec.mutate({
     sessionId,
-    code: "return await framer.getAgentContext({ pagePath: '/' });",
+    code: "return await framer.agent.getContext({ pagePath: '/' });",
     cwd: process.cwd()
   });
   debug("exec", "getAgentContext: relay responded");
@@ -16999,7 +16859,7 @@ program.command("apply-changes").description("Apply canvas DSL changes to a page
 ).requiredOption("-e, --eval <dsl>", "DSL string to apply").option("-p, --page <path>", "Target page path", "/").action(async (options) => {
   const { session: sessionId, eval: dsl, page: pagePath } = options;
   const code = `
-      const result = await framer.applyAgentChanges(${JSON.stringify(dsl)}, { pagePath: ${JSON.stringify(pagePath)} });
+      const result = await framer.agent.applyChanges(${JSON.stringify(dsl)}, { pagePath: ${JSON.stringify(pagePath)} });
       if (result) console.log(JSON.stringify(result, null, 2));
     `;
   await execAndPrint(sessionId, code);
@@ -17022,7 +16882,7 @@ program.command("read-project").description("Read project state for a page").req
     process.exit(1);
   }
   const code = `
-      const result = await framer.readProjectForAgent(${JSON.stringify(queries)}, { pagePath: ${JSON.stringify(pagePath)} });
+      const result = await framer.agent.readProject(${JSON.stringify(queries)}, { pagePath: ${JSON.stringify(pagePath)} });
       if (result) console.log(JSON.stringify(result, null, 2));
     `;
   await execAndPrint(sessionId, code);