framer-dalton 0.0.26 → 0.0.27

package/README.md

@@ -23,7 +23,7 @@ The CLI and the installed skills are meant to work together. There are three ski
 1. Running `npx framer-dalton@latest setup` will install the base `framer` and `framer-code-components` skills.
 2. The frontmatter of `framer-code-components` tells agents to always load `framer` and the generated project skill first.
 3. The frontmatter of `framer` tells agents to run `npx framer-dalton@latest setup` BEFORE loading the skill. This command will auto-update the cli and update the skill files.
-4. Creating a new session for a project will create a `framer-project-<project id>` file. This file contains the latest agent system prompt from `framer.getAgentSystemPrompt` and the latest project context from `framer.getAgentContext`. Agents must load this project-specific skill immediately after creating a session before doing any connected-project work.
+4. Creating a new session for a project will create a `framer-project-<project id>` file. This file contains the latest agent system prompt from `framer.agent.getSystemPrompt` and the latest project context from `framer.agent.getContext`. Agents must load this project-specific skill immediately after creating a session before doing any connected-project work.
 
 ## Local Development
 

package/dist/cli.js

@@ -12,7 +12,7 @@ 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.27 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -375,7 +375,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.26" 
+  "0.0.27" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -11036,6 +11036,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 +13264,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 +13352,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 +13365,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 +13463,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 +13575,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 +13624,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 +13652,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 +13680,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 +13708,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 +13715,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 +13729,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 +13757,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 +13764,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 +13834,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 +13870,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",
@@ -16829,7 +16634,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 +16650,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 +16804,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 +16827,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);

package/dist/start-relay-server.js

@@ -14,7 +14,7 @@ import { z } from 'zod';
 import { createRequire } from 'module';
 import * as vm from 'vm';
 
-/* @framer/ai relay server v0.0.26 */
+/* @framer/ai relay server v0.0.27 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name2, symbol) => (symbol = Symbol[name2]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name2);
 var __typeError = (msg) => {
@@ -160,7 +160,7 @@ __name(debug, "debug");
 // 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.27" 
 );
 
 // src/relay-client.ts

package/docs/skills/framer-project.md

@@ -36,16 +36,20 @@ Always save results you'll need again. Don't repeat API calls.
 
 ## Method Selection
 
-Use agent-specific methods whenever a plugin API method and an agent method overlap:
+Choose the highest-priority interface available for the task:
 
-- Use `readProjectForAgent`, `getNodeForAgent`, `getNodesForAgent`, `getNodesOfTypesForAgent`, `getScopeNodeForAgent`, `getGroundNodeForAgent`, `getParentNodeForAgent`, `getAncestorsForAgent`, `serializeForAgent`, `serializeNodesForAgent`, and `paginateForAgent` for project tree reads.
-- Use `readComponentControlsForAgent`, `readIconSetControlsForAgent`, `readIconsForAgent`, `readLayoutTemplateControlsForAgent`, and `readShaderControlsForAgent` for reading the controls of components, icon sets, icons, layout templates, and shaders.
-- Use `applyAgentChanges` for page and layout edits. Do not use low-level node APIs like `createNode`, `setAttributes`, or `setRect` for design/layout work.
-- Use `publishForAgent` for publishing. Do not use `publish`, `getDeployments`, or `deploy` for normal agent publishing flows.
+1. Subcommands, such as `framer-dalton read-project` and `framer-dalton apply-changes`
+2. Agent-specific methods, such as `framer.agent.readProject`, `framer.agent.applyChanges`, and `framer.agent.publish`
+3. Generic plugin API methods, such as top-level `framer.*` methods
 
-Use the plugin API for capabilities that do not have an agent-specific counterpart, such as code file management, localization, and redirects.
+- Use `framer.agent.readProject`, `framer.agent.getNode`, `framer.agent.getNodes`, `framer.agent.getNodesOfTypes`, `framer.agent.getScopeNode`, `framer.agent.getGroundNode`, `framer.agent.getParentNode`, `framer.agent.getAncestors`, `framer.agent.serialize`, `framer.agent.serializeNodes`, and `framer.agent.paginate` for project tree reads.
+- Use `framer.agent.readComponentControls`, `framer.agent.readIconSetControls`, `framer.agent.readIcons`, `framer.agent.readLayoutTemplateControls`, and `framer.agent.readShaderControls` for reading the controls of components, icon sets, icons, layout templates, and shaders.
+- Use `framer.agent.applyChanges` for page and layout edits. Do not use low-level node APIs like `createNode`, `setAttributes`, or `setRect` for design/layout work.
+- Use `framer.agent.publish` for publishing. Do not use `publish`, `getDeployments`, or `deploy` for normal agent publishing flows.
 
-During normal task execution, do not call `framer.getAgentSystemPrompt()` or `framer.getAgentContext()`. This skill already includes their output.
+Use generic plugin API methods only for capabilities that do not have a subcommand or agent-specific counterpart, such as code file management, localization, and redirects.
+
+During normal task execution, do not call `framer.agent.getSystemPrompt()` or `framer.agent.getContext()`. This skill already includes their output.
 
 ## Core Usage Principles
 
@@ -100,15 +104,15 @@ Store anything you'll reference again.
 
 Use this approach only if the user asks for it. Do not mention this approach to the user otherwise.
 
-This approach is called “Prompt the Framer agent”. With this approach, use `framer.startAgentConversation()` to start a stateful design subagent. Keep the `conversationId` it returns in `state`, and call `framer.continueAgentConversation()` with it to continue the same design task.
+This approach is called “Prompt the Framer agent”. With this approach, use `framer.agent.startConversation()` to start a stateful design subagent. Keep the `conversationId` it returns in `state`, and call `framer.agent.continueConversation()` with it to continue the same design task.
 
-Do not call `framer.getAgentSystemPrompt()` or `framer.getAgentContext()` or `framer.applyAgentChanges()` with this approach.
+Do not call `framer.agent.getSystemPrompt()` or `framer.agent.getContext()` or `framer.agent.applyChanges()` with this approach.
 
 Example:
 
 ```js
 state.agent ??= {};
-const first = await framer.startAgentConversation(
+const first = await framer.agent.startConversation(
   "Build me a landing page based on the attached screenshot",
   {
     pagePath: "/",
@@ -119,7 +123,7 @@ const first = await framer.startAgentConversation(
 state.agent.conversationId = first.conversationId;
 console.log(first.responseMessages);
 
-const second = await framer.continueAgentConversation("Now make it pink", {
+const second = await framer.agent.continueConversation("Now make it pink", {
   conversationId: state.agent.conversationId,
   selectionNodeIds: ["someNodeId"],
   // imageUrls: [...],
@@ -171,7 +175,7 @@ npx framer-dalton docs ScreenshotOptions          # Show type + recursively expa
 
 Collections are Framer's CMS. Each collection has fields (columns) and items (rows). Use the plugin Collection API (the methods below) for collection schema and item CRUD.
 
-**Exception — CMS Collection Lists.** The in-canvas construct that *renders* a collection as a repeating list of cards (the "Collection List" / repeater) is an agent/page concern. Build and edit those through `readProjectForAgent` and `applyAgentChanges`, not the plugin API. Use the plugin Collection API to read available collections and field schema first, then use `applyAgentChanges` to add the list.
+**Exception — CMS Collection Lists.** The in-canvas construct that *renders* a collection as a repeating list of cards (the "Collection List" / repeater) is an agent/page concern. Build and edit those through `framer.agent.readProject` and `framer.agent.applyChanges`, not the plugin API. Use the plugin Collection API to read available collections and field schema first, then use `framer.agent.applyChanges` to add the list.
 
 #### Reading Collections
 
@@ -275,14 +279,14 @@ await item.remove();
 
 ### Working with Images
 
-Canvas editing accepts image URLs directly when setting an image fill, so the typical task is to obtain a URL and use it directly with `applyAgentChanges`.
+Canvas editing accepts image URLs directly when setting an image fill, so the typical task is to obtain a URL and use it directly with `framer.agent.applyChanges`.
 
 There are three sources you'll typically pull URLs from:
 
-**Stock photography.** Use `framer.queryImagesForAgent` to source candidates and stash the URL you want:
+**Stock photography.** Use `framer.agent.queryImages` to source candidates and stash the URL you want:
 
 ```js
-const { results } = await framer.queryImagesForAgent({
+const { results } = await framer.agent.queryImages({
   source: "unsplash",
   query: "snow-capped mountains",
   count: 4,
@@ -303,7 +307,7 @@ state.heroUrl = (await framer.uploadImage({
 **An image already on the canvas.** Read the node and reuse its existing image URL:
 
 ```js
-const node = await framer.getNodeForAgent({ id: "<image-node-id>" });
+const node = await framer.agent.getNode({ id: "<image-node-id>" });
 state.heroUrl = node.attributes.fill;
 ```
 
@@ -343,7 +347,7 @@ console.log(state.diagnostics);
 state.component = state.codeFile.exports.find(
   (exportItem) => exportItem.type === "component" && exportItem.isDefaultExport,
 );
-await framer.applyAgentChanges(
+await framer.agent.applyChanges(
   `+ComponentInstanceNode badge parent="wrapper" component="${state.component.componentId}"; SET badge width=120 height=48;`,
   { pagePath: "/" },
 );

package/docs/skills/framer.md

@@ -1,7 +1,7 @@
 ---
 name: framer
 description: >
-  Use when the user wants to design, edit, or publish a website or web page — creating layouts, editing sections, updating text or images, managing CMS collections and content, syncing external data, creating or modifying code components, managing color and text styles, handling localization, or publishing deployments. Trigger when the user mentions Framer, references their website or web pages, asks to edit designs, update site content, or work with any Framer project — even if they don't explicitly say 'Framer'. 
+  Use when the user wants to design, edit, or publish a website or web page — creating layouts, editing sections, updating text or images, managing CMS collections and content, syncing external data, creating or modifying code components, managing color and text styles, handling localization, or publishing deployments. Trigger when the user mentions Framer, references their website or web pages, asks to edit designs, update site content, or work with any Framer project — even if they don't explicitly say 'Framer'.
   **Mandatory precondition**: run `npx framer-dalton@latest setup` and let it complete **BEFORE** loading this skill.
 allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Read({{FRAMER_TEMPORARY_DIR}}/*)", "Write({{FRAMER_TEMPORARY_DIR}}/*)"]
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "type": "module",
   "bin": "./dist/cli.js",
   "main": "./dist/cli.js",
@@ -24,7 +24,7 @@
     "@trpc/client": "^11.17.0",
     "@trpc/server": "^11.17.0",
     "commander": "^12.1.0",
-    "framer-api": "^0.1.14-beta",
+    "framer-api": "0.1.14",
     "zod": "^4.4.3"
   },
   "devDependencies": {