@framer/agent 0.0.37 → 0.0.38

package/dist/cli.js

@@ -13,7 +13,7 @@ import { fileURLToPath } from 'url';
 import net from 'net';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.37 */
+/* @framer/ai CLI v0.0.38 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -397,7 +397,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.37" 
+  "0.0.38" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -1314,11 +1314,11 @@ var types = {
     name: "AgentConversationCompletedResult",
     description: "",
     kind: "interface",
-    references: [],
+    references: ["AgentResponseMessage"],
     members: [
       {
         name: "responseMessages",
-        type: "readonly unknown[]",
+        type: "readonly AgentResponseMessage[]",
         description: "",
         optional: false
       }
@@ -1338,6 +1338,33 @@ var types = {
       }
     ]
   },
+  agentresponsecontentpart: {
+    name: "AgentResponseContentPart",
+    description: "A content part of an assistant response message.\n\nReasoning and tool inputs are internal to the agent: reasoning content is omitted and tool\ncalls only expose the tool name and input. Text parts contain the user-facing response.",
+    kind: "alias",
+    alias: '{\n  type: "reasoning";\n} | {\n  type: "text";\n  text: string;\n} | {\n  type: "tool-call";\n  toolName: string;\n  input: unknown;\n}',
+    references: []
+  },
+  agentresponsemessage: {
+    name: "AgentResponseMessage",
+    description: "An assistant message from an agent turn.\n\nA turn typically produces multiple messages: text emitted between tool calls is progress\nnarration, and the last message containing text is the agent\u2019s final response.",
+    kind: "interface",
+    references: ["AgentResponseContentPart"],
+    members: [
+      {
+        name: "role",
+        type: '"assistant"',
+        description: "",
+        optional: false
+      },
+      {
+        name: "content",
+        type: "readonly AgentResponseContentPart[]",
+        description: "",
+        optional: false
+      }
+    ]
+  },
   agentturnoptions: {
     name: "AgentTurnOptions",
     description: "",
@@ -1355,6 +1382,12 @@ var types = {
         type: "readonly string[]",
         description: "Attach images to this agent turn by URL.\n\nURLs can be external or existing Framer asset URLs. They will be ingested into the\nproject's assets if needed, then made available to the agent as trusted attachment URLs.\n\nTip: if you have a local file (or bytes), upload it first (e.g. `framer.uploadImage(...)`) and\npass the returned asset URL here.",
         optional: true
+      },
+      {
+        name: "fileUrls",
+        type: "readonly string[]",
+        description: "Attach files to this agent turn by URL.\n\nURLs can be external or existing Framer asset URLs. They will be ingested into the\nproject's assets if needed, then made available to the agent as file attachments.",
+        optional: true
       }
     ]
   },
@@ -1395,7 +1428,7 @@ var types = {
     name: "AllMethods",
     description: "",
     kind: "alias",
-    alias: "keyof {\n    [K in Method as (typeof methodToMessageTypes)[K] extends [] ? never : K]: (typeof methodToMessageTypes)[K];\n}",
+    alias: "keyof { [K in Method as (typeof methodToMessageTypes)[K] extends [] ? never : K]: (typeof methodToMessageTypes)[K] }",
     references: []
   },
   anyeditableattributes: {
@@ -1647,7 +1680,7 @@ var types = {
     name: "AssetData",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName"],
+    references: ["WithOptionalName$1"],
     members: [
       {
         name: "url",
@@ -1656,7 +1689,7 @@ var types = {
         optional: false
       }
     ],
-    extends: ["WithOptionalName"]
+    extends: ["WithOptionalName$1"]
   },
   assetdatatransfer: {
     name: "AssetDataTransfer",
@@ -2021,7 +2054,7 @@ var types = {
     name: "BytesDataTransfer",
     description: "",
     kind: "alias",
-    alias: 'BytesData & {\n    type: "bytes";\n}',
+    alias: 'BytesData & {\n  type: "bytes";\n}',
     references: ["BytesData"]
   },
   canvasnode: {
@@ -2624,7 +2657,7 @@ var types = {
     members: [
       {
         name: "location",
-        type: "{\n        x: number;\n        y: number;\n    }",
+        type: "{\n    x: number;\n    y: number;\n  }",
         description: "Coordinates of the anchor point.",
         optional: false
       },
@@ -3267,7 +3300,7 @@ var types = {
     name: "CustomCode",
     description: "Custom HTML code settings for all injection locations, including disabled state.",
     kind: "alias",
-    alias: "Record<CustomCodeLocation, {\n    disabled: boolean;\n    html: string | null;\n}>",
+    alias: "Record<CustomCodeLocation, {\n  disabled: boolean;\n  html: string | null;\n}>",
     references: ["CustomCodeLocation"]
   },
   customcodelocation: {
@@ -4012,14 +4045,14 @@ var types = {
     name: "ExplicitPartial",
     description: "The opposite of Partial, can't omit it. Useful for making sure that you don't forget to handle a\nnew property in all cases where objects are built.",
     kind: "alias",
-    alias: "{\n    [P in keyof T]: T[P] | undefined;\n}",
+    alias: "{ [P in keyof T]: T[P] | undefined }",
     references: []
   },
   extractunmarshaledgradientattributes: {
     name: "ExtractUnmarshaledGradientAttributes",
     description: "",
     kind: "alias",
-    alias: "Omit<Extract<UnmarshaledGradient, {\n    [classKey]: T[ClassKey];\n}>, ClassKey>",
+    alias: "Omit<Extract<UnmarshaledGradient, {\n  [classKey]: T[ClassKey];\n}>, ClassKey>",
     references: ["Extract", "UnmarshaledGradient", "ClassKey"]
   },
   field: {
@@ -4299,7 +4332,7 @@ var types = {
     name: "FontAttributes",
     description: "",
     kind: "alias",
-    alias: "Prettify<Partial<{\n    weight: FontWeight;\n    style: FontStyle$1;\n}>>",
+    alias: "Prettify<Partial<{\n  weight: FontWeight;\n  style: FontStyle$1;\n}>>",
     references: ["Prettify"]
   },
   fontcontrol: {
@@ -4854,8 +4887,8 @@ var types = {
     name: "ImageData",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName", "ImageOptions"],
-    extends: ["WithOptionalName", "ImageOptions"]
+    references: ["WithOptionalName$1", "ImageOptions"],
+    extends: ["WithOptionalName$1", "ImageOptions"]
   },
   imagedatafields: {
     name: "ImageDataFields",
@@ -5012,7 +5045,7 @@ var types = {
     name: "InitialState",
     description: "",
     kind: "alias",
-    alias: '{\n    mode: Mode;\n    intent: "plugin/open";\n} | {\n    mode: PickModes<"collection" | "syncManagedCollection" | "configureManagedCollection">;\n    intent: "collection/add";\n}',
+    alias: '{\n  mode: Mode;\n  intent: "plugin/open";\n} | {\n  mode: PickModes<"collection" | "syncManagedCollection" | "configureManagedCollection">;\n  intent: "collection/add";\n}',
     references: []
   },
   inlinelocalizationvaluebylocale: {
@@ -5688,7 +5721,7 @@ var types = {
     name: "LocalizedValueUpdate",
     description: "",
     kind: "alias",
-    alias: '{\n    action: "set";\n    value: string;\n    needsReview?: boolean;\n} | {\n    action: "clear";\n} | {\n    action: "ignore";\n    needsReview?: boolean;\n}',
+    alias: '{\n  action: "set";\n  value: string;\n  needsReview?: boolean;\n} | {\n  action: "clear";\n} | {\n  action: "ignore";\n  needsReview?: boolean;\n}',
     references: []
   },
   location: {
@@ -6118,7 +6151,7 @@ var types = {
     name: "NamedFileAssetInput",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName", "AssetInput"],
+    references: ["WithOptionalName$1", "AssetInput"],
     members: [
       {
         name: "file",
@@ -6127,7 +6160,7 @@ var types = {
         optional: false
       }
     ],
-    extends: ["WithOptionalName"]
+    extends: ["WithOptionalName$1"]
   },
   namedimageassetinput: {
     name: "NamedImageAssetInput",
@@ -6201,7 +6234,7 @@ var types = {
     name: "NodeRuntimeErrorResult",
     description: "",
     kind: "alias",
-    alias: '{\n    type: "ModuleRuntimeError" | "ReactRenderingError";\n    message: string;\n}',
+    alias: '{\n  type: "ModuleRuntimeError" | "ReactRenderingError";\n  message: string;\n}',
     references: []
   },
   nodetype: {
@@ -6292,7 +6325,7 @@ var types = {
     name: "NullableRecord",
     description: "Type helper to transform a interface so that each value can be null.",
     kind: "alias",
-    alias: "{\n    [P in keyof T]-?: T[P] | null;\n}",
+    alias: "{ [P in keyof T]-?: T[P] | null }",
     references: []
   },
   numbercontrol: {
@@ -6446,7 +6479,7 @@ var types = {
     name: "Ownership",
     description: "",
     kind: "alias",
-    alias: '{\n    type: "project";\n} | {\n    type: "external";\n    name: string;\n}',
+    alias: '{\n  type: "project";\n} | {\n  type: "external";\n  name: string;\n}',
     references: []
   },
   paddingcontrol: {
@@ -6501,7 +6534,7 @@ var types = {
     name: "PerMethodPermissionMap",
     description: "",
     kind: "alias",
-    alias: "{\n    [K in ProtectedMethod]: boolean;\n}",
+    alias: "{ [K in ProtectedMethod]: boolean }",
     references: []
   },
   pixelnumber: {
@@ -6681,13 +6714,13 @@ var types = {
       },
       {
         name: "getLocaleLanguages",
-        type: "() => Promise<{\n        code: string;\n        name: string;\n    }[]>",
+        type: "() => Promise<{\n    code: string;\n    name: string;\n  }[]>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getLocaleRegions",
-        type: "(language: string) => Promise<{\n        code: string;\n        name: string;\n        isCommon: boolean;\n    }[]>",
+        type: "(language: string) => Promise<{\n    code: string;\n    name: string;\n    isCommon: boolean;\n  }[]>",
         description: "@alpha",
         optional: false
       },
@@ -6933,13 +6966,13 @@ var types = {
       },
       {
         name: "addComponentInstance",
-        type: "(options: {\n        url: string;\n        attributes?: Partial<Record<string, unknown>>;\n        parentId?: string;\n    }) => Promise<SomeNodeData>",
+        type: "(options: {\n    url: string;\n    attributes?: Partial<Record<string, unknown>>;\n    parentId?: string;\n  }) => Promise<SomeNodeData>",
         description: "",
         optional: false
       },
       {
         name: "addDetachedComponentLayers",
-        type: "(options: {\n        url: string;\n        layout?: boolean;\n        attributes?: Partial<Record<string, unknown>>;\n    }) => Promise<SomeNodeData>",
+        type: "(options: {\n    url: string;\n    layout?: boolean;\n    attributes?: Partial<Record<string, unknown>>;\n  }) => Promise<SomeNodeData>",
         description: "",
         optional: false
       },
@@ -7335,7 +7368,7 @@ var types = {
       },
       {
         name: "createCodeFile",
-        type: "(name: string, code: string, options?: {\n        editViaPlugin?: boolean;\n    }) => Promise<CodeFileData>",
+        type: "(name: string, code: string, options?: {\n    editViaPlugin?: boolean;\n  }) => Promise<CodeFileData>",
         description: "",
         optional: false
       },
@@ -7497,7 +7530,7 @@ var types = {
       },
       {
         name: "getChangedPaths",
-        type: "() => Promise<{\n        added: string[];\n        removed: string[];\n        modified: string[];\n    }>",
+        type: "() => Promise<{\n    added: string[];\n    removed: string[];\n    modified: string[];\n  }>",
         description: "@alpha",
         optional: false
       },
@@ -7521,7 +7554,7 @@ var types = {
       },
       {
         name: "getAgentContext",
-        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<string>",
+        type: "(options?: {\n    pagePath?: string;\n  }) => Promise<string>",
         description: "@alpha",
         optional: false
       },
@@ -7587,49 +7620,49 @@ var types = {
       },
       {
         name: "readProjectForAgent",
-        type: "(queries: Record<string, unknown>[], options?: {\n        pagePath?: string;\n    }) => Promise<{\n        results: unknown[];\n    }>",
+        type: "(queries: Record<string, unknown>[], options?: {\n    pagePath?: string;\n  }) => Promise<{\n    results: unknown[];\n  }>",
         description: "@alpha",
         optional: false
       },
       {
         name: "readComponentControlsForAgent",
-        type: "(input: {\n        componentIds: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        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>",
+        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[]>",
+        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>",
+        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>",
+        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<unknown>",
+        type: "(dsl: string, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "replaceTextForAgent",
-        type: "(input: {\n        id: string;\n        searchText: string;\n        replaceText: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<boolean>",
+        type: "(input: {\n    id: string;\n    searchText: string;\n    replaceText: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<boolean>",
         description: "@alpha",
         optional: false
       },
@@ -7651,99 +7684,105 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "queryAnalyticsForAgent",
+        type: "(input: {\n    query: string;\n    from: string;\n    to?: string;\n  }) => Promise<unknown[]>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "reviewChangesForAgent",
-        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "flattenComponentInstanceForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "makeExternalComponentLocalForAgent",
-        type: "(input: {\n        id: string;\n        replaceAll?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n    replaceAll?: boolean;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getNodeForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getNodesForAgent",
-        type: "(input: {\n        ids: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    ids: readonly string[];\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getNodesOfTypesForAgent",
-        type: "(input: {\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    types: readonly string[];\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getDescendantsOfTypesForAgent",
-        type: "(input: {\n        id: string;\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n    types: readonly string[];\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getRectForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<Rect$1 | null>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<Rect | null>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getDescendantReferencesOfTypesForAgent",
-        type: "(input: {\n        id: string;\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n    types: readonly string[];\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getScopeNodeForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getGroundNodeForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getParentNodeForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "getAncestorsForAgent",
-        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "serializeForAgent",
-        type: "(input: {\n        id: string;\n        depth?: number;\n        attributeFilter?: readonly string[];\n        ancestorPath?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    id: string;\n    depth?: number;\n    attributeFilter?: readonly string[];\n    ancestorPath?: boolean;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "serializeNodesForAgent",
-        type: "(input: {\n        ids: readonly string[];\n        depth?: number;\n        attributeFilter?: readonly string[];\n        ancestorPath?: boolean;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    ids: readonly string[];\n    depth?: number;\n    attributeFilter?: readonly string[];\n    ancestorPath?: boolean;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
       {
         name: "paginateForAgent",
-        type: "(input: {\n        items: readonly unknown[];\n        keyName?: never;\n        cursor?: never;\n    } | {\n        keyName: string;\n        cursor: number;\n        items?: never;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        type: "(input: {\n    items: readonly unknown[];\n    keyName?: never;\n    cursor?: never;\n  } | {\n    keyName: string;\n    cursor: number;\n    items?: never;\n  }, options?: {\n    pagePath?: string;\n  }) => Promise<unknown>",
         description: "@alpha",
         optional: false
       },
@@ -7930,7 +7969,7 @@ var types = {
     name: "Prettify",
     description: "This alias takes a type as its argument and returns a new type that has the same properties as\nthe original, but the properties are not intersected. This makes the new type easier to read and\nunderstand.\n\nExample:\n```ts\n// Original type:\n{ a: string; } & { b: number; } & { c: boolean; }\n\n// New type:\n{ a: string; b: number; c: boolean; }\n```",
     kind: "alias",
-    alias: "{\n    [K in keyof T]: T[K] extends object ? Prettify<T[K]> : T[K];\n} & {}",
+    alias: "{ [K in keyof T]: T[K] extends object ? Prettify<T[K]> : T[K] } & {}",
     references: []
   },
   projectinfo: {
@@ -8085,8 +8124,8 @@ var types = {
     alias: '"RadialGradient"',
     references: []
   },
-  rect$1: {
-    name: "Rect$1",
+  rect: {
+    name: "Rect",
     description: "",
     kind: "interface",
     references: [],
@@ -8319,7 +8358,7 @@ var types = {
       },
       {
         name: "clip",
-        type: "{\n        x: number;\n        y: number;\n        width: number;\n        height: number;\n    }",
+        type: "{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }",
         description: "Clip region in CSS pixels (before scale).\nCaptures only this portion of the node.",
         optional: true
       }
@@ -8423,13 +8462,13 @@ var types = {
     members: [
       {
         name: "valuesBySource",
-        type: "{\n        errors: readonly LocalizationValueError[];\n    }",
+        type: "{\n    errors: readonly LocalizationValueError[];\n  }",
         description: "Set one or more localized values",
         optional: false
       },
       {
         name: "statusByLocaleByGroup",
-        type: "{\n        errors: readonly LocalizationStatusByLocaleError[];\n    }",
+        type: "{\n    errors: readonly LocalizationStatusByLocaleError[];\n  }",
         description: "Set the hidden locale IDs of one or more localization groups",
         optional: false
       }
@@ -8530,8 +8569,8 @@ var types = {
     alias: 'Pick<ComponentInstancePlaceholderAttributes, "title" | "codePreview">',
     references: ["ComponentInstancePlaceholderAttributes"]
   },
-  size: {
-    name: "Size",
+  size$1: {
+    name: "Size$1",
     description: "",
     kind: "interface",
     references: [],
@@ -8663,7 +8702,7 @@ var types = {
     name: "StartAgentConversationResult",
     description: "",
     kind: "alias",
-    alias: "({\n    conversationId: string;\n} & AgentConversationCompletedResult) | ({\n    conversationId: string;\n} & AgentConversationNeedsClarificationResult)",
+    alias: "({\n  conversationId: string;\n} & AgentConversationCompletedResult) | ({\n  conversationId: string;\n} & AgentConversationNeedsClarificationResult)",
     references: [
       "AgentConversationCompletedResult",
       "AgentConversationNeedsClarificationResult"
@@ -8859,7 +8898,7 @@ var types = {
     name: "SVGData",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName"],
+    references: ["WithOptionalName$1"],
     members: [
       {
         name: "svg",
@@ -8868,7 +8907,7 @@ var types = {
         optional: false
       }
     ],
-    extends: ["WithOptionalName"]
+    extends: ["WithOptionalName$1"]
   },
   textalignment: {
     name: "TextAlignment",
@@ -8909,7 +8948,7 @@ var types = {
     name: "TextStyleAttributes",
     description: "",
     kind: "alias",
-    alias: 'Prettify<Partial<Omit<TextStyleData, "id" | "color" | "font" | "boldFont" | "italicFont" | "boldItalicFont" | "breakpoints"> & {\n    color: ColorStyle | string;\n    font: Font;\n    boldFont: Font | null;\n    italicFont: Font | null;\n    boldItalicFont: Font | null;\n    breakpoints: TextStyleBreakpointAttributes[];\n}> & AssetPath>',
+    alias: 'Prettify<Partial<Omit<TextStyleData, "id" | "color" | "font" | "boldFont" | "italicFont" | "boldItalicFont" | "breakpoints"> & {\n  color: ColorStyle | string;\n  font: Font;\n  boldFont: Font | null;\n  italicFont: Font | null;\n  boldItalicFont: Font | null;\n  breakpoints: TextStyleBreakpointAttributes[];\n}> & AssetPath>',
     references: ["Prettify", "TextStyleData", "AssetPath"]
   },
   textstylebreakpoint: {
@@ -9658,7 +9697,7 @@ var types = {
     name: "UpdateFieldAttributes",
     description: "The type of the `attributes` parameter of `Field.setAttributes`:\n\n```ts\nconst fileFieldAttributes: UpdateFieldAttributes<FileField> = {}\nfileFieldAttributes.allowedFileTypes = []\nfileField.setAttributes(fileFieldAttributes)\n```\n\nCan also use `typeof`:\n\n```ts\nconst fileFieldAttributes: UpdateFieldAttributes<typeof fileField> = {}\n```",
     kind: "alias",
-    alias: 'Omit<Extract<UpdateField, {\n    type: T["type"];\n}>,\n"id" | "type">',
+    alias: 'Omit<Extract<UpdateField, {\n  type: T["type"];\n}>,\n"id" | "type">',
     references: ["Extract", "UpdateField"]
   },
   updatefieldbase: {
@@ -9865,7 +9904,7 @@ var types = {
     name: "UpdateVariableAttributes",
     description: "",
     kind: "alias",
-    alias: 'Omit<Extract<UpdateVariable, {\n    type: T["type"];\n}>, "type">',
+    alias: 'Omit<Extract<UpdateVariable, {\n  type: T["type"];\n}>, "type">',
     references: ["Extract", "UpdateVariable"]
   },
   updatevariablebase: {
@@ -10892,8 +10931,8 @@ var types = {
     alias: "Partial<WithFieldRequired>",
     references: ["WithFieldRequired"]
   },
-  withoptionalname: {
-    name: "WithOptionalName",
+  withoptionalname$1: {
+    name: "WithOptionalName$1",
     description: "",
     kind: "interface",
     references: [],
@@ -12193,9 +12232,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "ComponentInstanceNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "getRuntimeError",
@@ -12465,9 +12504,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "ComponentNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "getVariables",
@@ -12690,9 +12729,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "DesignPageNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "navigateTo",
@@ -13211,9 +13250,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "FrameNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "gridAlignment",
@@ -13633,7 +13672,7 @@ var methodsByCategory = {
     {
       name: "addComponentInstance",
       category: "framer",
-      signature: "addComponentInstance({ url, attributes, parentId, }: AddComponentInstanceOptions): Promise<ComponentInstanceNode>",
+      signature: "addComponentInstance({\n    url,\n    attributes,\n    parentId\n  }: AddComponentInstanceOptions): Promise<ComponentInstanceNode>",
       description: "Add a component instance by module URL.\n\n@param url - The component module URL. Can be copied from the components panel.\n@param attributes - Optional component attributes.\n\n@returns The newly created component instance node.\n@category canvas",
       references: ["AddComponentInstanceOptions", "ComponentInstanceNode"]
     },
@@ -13650,7 +13689,7 @@ var methodsByCategory = {
     {
       name: "addDetachedComponentLayers",
       category: "framer",
-      signature: "addDetachedComponentLayers({ url, layout, attributes }: AddDetachedComponentLayersOptions): Promise<FrameNode>",
+      signature: "addDetachedComponentLayers({\n    url,\n    layout,\n    attributes\n  }: AddDetachedComponentLayersOptions): Promise<FrameNode>",
       description: "Adds the layers of a component by module URL.\n@category canvas",
       references: ["AddDetachedComponentLayersOptions", "FrameNode"]
     },
@@ -14007,9 +14046,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "framer",
-      signature: "getRect(nodeId: NodeId): Promise<Rect$1 | null>",
+      signature: "getRect(nodeId: NodeId): Promise<Rect | null>",
       description: "Get the rect of a node\n@category canvas",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "getRedirects",
@@ -14324,9 +14363,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "FramerAgentAPI",
-      signature: "getRect(input: { id: string; }, options?: { pagePath?: string; }): Promise<Rect$1 | null>",
+      signature: "getRect(input: { id: string; }, options?: { pagePath?: string; }): Promise<Rect | null>",
       description: 'Get the measured rect for a node.\n\n@param input - `{ id }`: the id of the node to measure.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The rounded measured rect, or `null` if no node with that id exists on the page.',
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "getScopeNode",
@@ -14384,6 +14423,13 @@ var methodsByCategory = {
       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: "queryAnalytics",
+      category: "FramerAgentAPI",
+      signature: "queryAnalytics(input: { query: string; from: string; to?: string | undefined; }): Promise<unknown[]>",
+      description: "Runs a read-only analytics query against the current site.\n\nThe input schema is documented in the string returned by {@link getSystemPrompt}.\n\n@param input - Query input object (query / from / to). Dates are ISO strings.\n@returns The analytics rows returned by the query.",
+      references: []
+    },
     {
       name: "queryImages",
       category: "FramerAgentAPI",
@@ -14503,7 +14549,7 @@ var methodsByCategory = {
     {
       name: "cloneWithAttributes",
       category: "ImageAsset",
-      signature: 'cloneWithAttributes({ altText, resolution, }: Prettify<Partial<Pick<ImageAssetData, "altText" | "resolution">>>): ImageAsset',
+      signature: 'cloneWithAttributes({\n    altText,\n    resolution\n  }: Prettify<Partial<Pick<ImageAssetData, "altText" | "resolution">>>): ImageAsset',
       description: "Clone this image asset, optionally overriding `altText` or `resolution`.\nThe clone shares the same underlying image data.",
       references: ["Prettify", "ImageAssetData", "ImageAsset"]
     },
@@ -14531,9 +14577,9 @@ var methodsByCategory = {
     {
       name: "measure",
       category: "ImageAsset",
-      signature: "measure(): Promise<Size>",
+      signature: "measure(): Promise<Size$1>",
       description: "Measure this image's natural dimensions.\n\n@returns The width and height in pixels. Warning: values may be zero.",
-      references: ["Size"]
+      references: ["Size$1"]
     },
     {
       name: "resolution",
@@ -15077,9 +15123,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "SVGNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "height",
@@ -15310,9 +15356,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "TextNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "getText",
@@ -15872,9 +15918,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "UnknownNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "navigateTo",
@@ -16071,9 +16117,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "VectorSetItemNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "height",
@@ -16241,9 +16287,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "VectorSetNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "navigateTo",
@@ -16383,9 +16429,9 @@ var methodsByCategory = {
     {
       name: "getRect",
       category: "WebPageNode",
-      signature: "getRect(): Promise<Rect$1 | null>",
+      signature: "getRect(): Promise<Rect | null>",
       description: "Get the bounding box of this node.\n\n@returns The bounding rectangle, or `null` if unavailable.",
-      references: ["Rect$1"]
+      references: ["Rect"]
     },
     {
       name: "navigateTo",

package/dist/start-relay-server.js

@@ -15,7 +15,7 @@ import { createRequire } from 'module';
 import * as vm from 'vm';
 import isWsl from 'is-wsl';
 
-/* @framer/ai relay server v0.0.37 */
+/* @framer/ai relay server v0.0.38 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name2, symbol) => (symbol = Symbol[name2]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name2);
 var __typeError = (msg) => {
@@ -200,7 +200,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.37" 
+  "0.0.38" 
 );
 
 // src/relay-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framer/agent",
-  "version": "0.0.37",
+  "version": "0.0.38",
   "description": "CLI and skills for connecting your AI agents to Framer.",
   "type": "module",
   "bin": "./dist/cli.js",
@@ -25,7 +25,7 @@
     "@trpc/client": "^11.17.0",
     "@trpc/server": "^11.17.0",
     "commander": "^12.1.0",
-    "framer-api": "^0.1.18",
+    "framer-api": "^0.1.22",
     "is-wsl": "^3.1.1",
     "zod": "^4.4.3"
   },

package/skills/framer/projects/__template__/recipes.md

@@ -116,4 +116,3 @@ await framer.setLocalizationData({
 
 - Pages: cannot change the path of a page.
 - Code overrides: cannot assign overrides to nodes.
-- Analytics: no APIs exist for accessing analytics data.