framer-dalton 0.0.25 → 0.0.27

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.25 */
+/* @framer/ai CLI v0.0.27 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -29,6 +29,51 @@ Please upgrade: https://nodejs.org/`
   );
   process.exit(1);
 }
+
+// src/agent-thread-context.ts
+var MAX_AGENT_THREAD_ID_LENGTH = 256;
+var MAX_AGENT_PROVIDER_LENGTH = 64;
+var SAFE_VALUE_PATTERN = /^[A-Za-z0-9._:-]+$/;
+var providerEnvVars = [
+  { provider: "codex", envVar: "CODEX_THREAD_ID" },
+  { provider: "claude", envVar: "CLAUDE_CODE_SESSION_ID" },
+  { provider: "claude", envVar: "CLAUDE_CODE_REMOTE_SESSION_ID" }
+];
+function normalizeValue(value, maxLength) {
+  const trimmed = value?.trim();
+  if (!trimmed) return void 0;
+  if (trimmed.length > maxLength) return void 0;
+  if (!SAFE_VALUE_PATTERN.test(trimmed)) return void 0;
+  return trimmed;
+}
+__name(normalizeValue, "normalizeValue");
+function normalizeAgentThreadContext(input) {
+  const agentThreadId = normalizeValue(
+    input.agentThreadId,
+    MAX_AGENT_THREAD_ID_LENGTH
+  );
+  if (!agentThreadId) return {};
+  const agentProvider = normalizeValue(
+    input.agentProvider,
+    MAX_AGENT_PROVIDER_LENGTH
+  );
+  return {
+    agentThreadId,
+    ...agentProvider ? { agentProvider } : {}
+  };
+}
+__name(normalizeAgentThreadContext, "normalizeAgentThreadContext");
+function resolveAgentThreadContext(env = process.env) {
+  for (const { provider, envVar } of providerEnvVars) {
+    const agentThreadContext = normalizeAgentThreadContext({
+      agentThreadId: env[envVar],
+      agentProvider: provider
+    });
+    if (agentThreadContext.agentThreadId) return agentThreadContext;
+  }
+  return {};
+}
+__name(resolveAgentThreadContext, "resolveAgentThreadContext");
 function openUrl(url) {
   const platform = process.platform;
   let cmd;
@@ -330,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.25" 
+  "0.0.27" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -420,6 +465,45 @@ function trackError(payload) {
   });
 }
 __name(trackError, "trackError");
+
+// src/connection-errors.ts
+var RELAY_CONNECTION_LOST_PATTERNS = [
+  "fetch failed",
+  // undici top-level: relay gone / socket closed mid-request
+  "other side closed",
+  // undici SocketError: relay exited mid-request
+  "UND_ERR_SOCKET",
+  // undici socket error code
+  "ECONNREFUSED",
+  // relay not listening
+  "ECONNRESET",
+  // connection reset mid-request
+  "socket hang up"
+];
+function isRelayConnectionLost(err) {
+  const seen = /* @__PURE__ */ new Set();
+  const stack = [err];
+  while (stack.length > 0) {
+    const node = stack.pop();
+    if (node == null || seen.has(node)) continue;
+    seen.add(node);
+    const e = node;
+    const text = `${typeof e.message === "string" ? e.message : ""} ${typeof e.code === "string" ? e.code : ""}`;
+    if (RELAY_CONNECTION_LOST_PATTERNS.some((pattern) => text.includes(pattern)))
+      return true;
+    if (e.cause != null) stack.push(e.cause);
+    if (Array.isArray(e.errors)) stack.push(...e.errors);
+  }
+  return false;
+}
+__name(isRelayConnectionLost, "isRelayConnectionLost");
+var AUTH_ERROR_PATTERNS = ["does not have access", "UNAUTHORIZED"];
+function isAuthError(errorMessage) {
+  return AUTH_ERROR_PATTERNS.some((p) => errorMessage.includes(p));
+}
+__name(isAuthError, "isAuthError");
+
+// src/utils.ts
 function rehydrateFramerAPIError(error) {
   if (!(error instanceof Error)) return null;
   const framerApi = error.data?.framerApi;
@@ -448,10 +532,12 @@ function formatError(error) {
   return String(error);
 }
 __name(formatError, "formatError");
-function formatErrorForUser(error) {
+function formatErrorForUser(error, opts) {
   if (!(error instanceof Error)) return String(error);
   const rehydrated = rehydrateFramerAPIError(error);
   if (rehydrated) return rehydrated.toString();
+  if (!opts?.fromExecResult && isRelayConnectionLost(error))
+    return "Connection to the Framer server was lost. Run `framer session new` to reconnect.";
   const ref = getErrorRef(error);
   return ref ? `${error.message} [ref: ${ref}]` : error.message;
 }
@@ -819,13 +905,6 @@ async function acquireAuthWithRemixProject(sourceProjectUrlOrId) {
 }
 __name(acquireAuthWithRemixProject, "acquireAuthWithRemixProject");
 
-// src/connection-errors.ts
-var AUTH_ERROR_PATTERNS = ["does not have access", "UNAUTHORIZED"];
-function isAuthError(errorMessage) {
-  return AUTH_ERROR_PATTERNS.some((p) => errorMessage.includes(p));
-}
-__name(isAuthError, "isAuthError");
-
 // src/closest-match.ts
 function levenshteinDistance(source, target) {
   const sourceLength = source.length;
@@ -7210,12 +7289,48 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "readComponentControlsForAgent",
+        type: "(input: {\n        componentIds: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "readIconSetControlsForAgent",
+        type: "(input: {\n        iconSetNames: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "readIconsForAgent",
+        type: "(input: {\n        iconSetName: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<string[]>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "readLayoutTemplateControlsForAgent",
+        type: "(input: {\n        layoutTemplateIds: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "readShaderControlsForAgent",
+        type: "(input: {\n        shaderNames: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "applyAgentChanges",
         type: "(dsl: string, options?: {\n        pagePath?: string;\n    }) => Promise<void>",
         description: "@alpha",
         optional: false
       },
+      {
+        name: "ping",
+        type: "() => Promise<void>",
+        description: "@alpha Liveness round-trip; resolves when Vekter's plugin handler answers.",
+        optional: false
+      },
       {
         name: "publishForAgent",
         type: "(input?: Record<string, unknown>) => Promise<unknown>",
@@ -7825,6 +7940,18 @@ var types = {
         type: "string",
         description: "JSONL string with one training row per inner-agent step, present when `captureTrainingData` was set.",
         optional: true
+      },
+      {
+        name: "fixtureFilename",
+        type: "string",
+        description: "Document fixture filename, always present after a completed run.",
+        optional: false
+      },
+      {
+        name: "fixtureContent",
+        type: "string",
+        description: "Document fixture JSON content (tree + code files).",
+        optional: false
       }
     ]
   },
@@ -10909,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: ""
@@ -13134,136 +13265,10 @@ var methodsByCategory = {
   ],
   framer: [
     {
-      name: "[$framerApiOnly.applyAgentChanges]",
+      name: "[$framerApiOnly.ping]",
       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.publishForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.publishForAgent](input?: Record<string, unknown>): Promise<unknown>",
-      description: "Executes the publish flow on behalf of an agent.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Action-discriminated input object (preview / confirm_publish / deploy_to_production).\n@returns The action's result \u2014 status, publish URLs, and any errors, warnings, or changes.",
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.queryImagesForAgent]",
-      category: "framer",
-      signature: "[$framerApiOnly.queryImagesForAgent](input: Record<string, unknown>): Promise<unknown>",
-      description: 'Searches for stock images to use on the canvas (e.g. `"FrameNode"` `fill` values). Returns\ncandidate images with preview thumbnails and a `url` field for each. The returned URLs are\nregistered as trusted for this session so they can be applied directly via `fill="<url>"`\nin a subsequent {@link applyAgentChanges} DSL command. Without calling this method first,\nexternal image URLs are rejected at apply time.\n\nThe input schema is documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param input - Search input object (source / query / count / orientation).\n@returns An object describing the candidates or an error.',
-      references: []
-    },
-    {
-      name: "[$framerApiOnly.readProjectForAgent]",
-      category: "framer",
-      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.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.',
+      signature: "[$framerApiOnly.ping](): Promise<void>",
+      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: []
     },
     {
@@ -13347,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",
@@ -13360,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",
@@ -13468,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",
@@ -13608,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",
@@ -13664,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",
@@ -13713,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",
@@ -13748,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",
@@ -13783,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",
@@ -13798,10 +13716,10 @@ var methodsByCategory = {
       references: ["Mode"]
     },
     {
-      name: "paginateForAgent",
+      name: "ping",
       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`.',
+      signature: "ping(): Promise<void>",
+      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: []
     },
     {
@@ -13811,27 +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: "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: "rejectAllPending",
       category: "framer",
@@ -13860,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",
@@ -13884,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",
@@ -13968,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",
@@ -14024,6 +13870,192 @@ 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",
+      category: "FramerAPIError",
+      signature: "recentMethods: string[]",
+      description: "@see FramerAPIErrorOptions.recentMethods",
+      references: []
+    },
+    {
+      name: "retryable",
+      category: "FramerAPIError",
+      signature: "retryable: boolean",
+      description: "@see FramerAPIErrorOptions.retryable",
+      references: []
+    }
+  ],
   imageasset: [
     {
       name: "altText",
@@ -16602,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");
@@ -16618,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");
@@ -16729,7 +16761,7 @@ async function execAndPrint(sessionId, code) {
     }
     if (result.error) {
       printError(
-        `Error: ${formatErrorForUser(errorWithRef(result.error, result.errorRef))}`
+        `Error: ${formatErrorForUser(errorWithRef(result.error, result.errorRef), { fromExecResult: true })}`
       );
       await waitForTrackingToFinish();
       process.exit(1);
@@ -16772,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);
@@ -16795,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);
@@ -16807,6 +16839,7 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
 ).action(
   async (projectUrlOrId, options) => {
     const projectId = extractProjectId(projectUrlOrId);
+    const agentThreadContext = resolveAgentThreadContext();
     let sessionId;
     let userId;
     try {
@@ -16831,7 +16864,8 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
         projectId,
         apiKey: credentials.apiKey,
         userId: credentials.userId,
-        headlessServerUrl
+        headlessServerUrl,
+        ...agentThreadContext
       });
       sessionId = result.id;
       debug("session.new", `session created id=${sessionId}`);
@@ -16885,6 +16919,7 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
         errorType: "session_new_error",
         projectId,
         userId,
+        ...agentThreadContext,
         errorMessage: message
       });
       printError(`Failed to create session: ${formatErrorForUser(err)}`);