@framer/agent 0.0.37 → 0.0.39

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.39 */
 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.39" 
 );
 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: {
@@ -4358,6 +4391,12 @@ var types = {
         type: "FontStyle$1 | null",
         description: "",
         optional: false
+      },
+      {
+        name: "url",
+        type: "string | null",
+        description: "",
+        optional: false
       }
     ]
   },
@@ -4854,8 +4893,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 +5051,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 +5727,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 +6157,7 @@ var types = {
     name: "NamedFileAssetInput",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName", "AssetInput"],
+    references: ["WithOptionalName$1", "AssetInput"],
     members: [
       {
         name: "file",
@@ -6127,7 +6166,7 @@ var types = {
         optional: false
       }
     ],
-    extends: ["WithOptionalName"]
+    extends: ["WithOptionalName$1"]
   },
   namedimageassetinput: {
     name: "NamedImageAssetInput",
@@ -6201,7 +6240,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 +6331,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 +6485,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 +6540,7 @@ var types = {
     name: "PerMethodPermissionMap",
     description: "",
     kind: "alias",
-    alias: "{\n    [K in ProtectedMethod]: boolean;\n}",
+    alias: "{ [K in ProtectedMethod]: boolean }",
     references: []
   },
   pixelnumber: {
@@ -6681,13 +6720,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 +6972,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 +7374,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 +7536,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 +7560,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 +7626,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
       },
@@ -7652,98 +7691,98 @@ var types = {
         optional: false
       },
       {
-        name: "reviewChangesForAgent",
-        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        name: "queryAnalyticsForAgent",
+        type: "(input: {\n    query: string;\n    from: string;\n    to?: 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",
@@ -13020,6 +13059,13 @@ var methodsByCategory = {
       description: "Specifies if the font is normal or _italic_.\n\nNote: This will be `null` for custom fonts since their weight isn't\ncalculated.",
       references: ["FontStyle$1"]
     },
+    {
+      name: "url",
+      category: "Font",
+      signature: "url: string | null",
+      description: "URL of the font's primary file, which can be used to render the font\n(for example in an `@font-face` rule). Intended for previewing a font;\nit may not cover every unicode range on its own.\n\n`null` when the font has no downloadable source file.",
+      references: []
+    },
     {
       name: "weight",
       category: "Font",
@@ -13211,9 +13257,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 +13679,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 +13696,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 +14053,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",
@@ -14213,7 +14259,7 @@ var methodsByCategory = {
       name: "applyChanges",
       category: "FramerAgentAPI",
       signature: "applyChanges(dsl: string, options?: { pagePath?: string; }): Promise<unknown>",
-      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\nCommands that fail (including syntax errors) are reported in the result\'s `errors`\nwithout blocking the remaining commands. Errors returned here are not repeated by\n{@link reviewChanges}, which reports the remaining project diagnostics.\n\nThe result schema is documented in the string returned by {@link getSystemPrompt}.\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.\n@returns The per-command status and errors, and the canonical system ids of created nodes.',
+      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\nCommands that fail (including syntax errors) are reported in the result\'s `errors`\nwithout blocking the remaining commands.\n\nThe result schema is documented in the string returned by {@link getSystemPrompt}.\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.\n@returns The command status and errors, and the canonical system ids of created nodes.',
       references: []
     },
     {
@@ -14324,9 +14370,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 +14430,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",
@@ -14447,13 +14500,6 @@ var methodsByCategory = {
       description: 'Replaces text within a text-like node.\n\n@param input - `{ id, searchText, replaceText }`: the target node id, text to find, and replacement text.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `true` when text was replaced, or `false` when no matching text was found.',
       references: []
     },
-    {
-      name: "reviewChanges",
-      category: "FramerAgentAPI",
-      signature: "reviewChanges(): Promise<unknown>",
-      description: "Reviews changes made by prior {@link applyChanges} calls in this session.\n\nConsumes accumulated diagnostics from the session's agent context. Command errors\nalready returned by {@link applyChanges} are not repeated here.\n\n@returns The session's accumulated changes, errors, warnings, and deferred trait reports.",
-      references: []
-    },
     {
       name: "serialize",
       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.39 */
 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.39" 
 );
 
 // src/relay-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framer/agent",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "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.24",
     "is-wsl": "^3.1.1",
     "zod": "^4.4.3"
   },

package/skills/framer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: framer
 description: >
-  Use when the user wants to design, edit, or publish a website or web page — creating layouts, editing sections, updating text or images, managing CMS collections and content, syncing external data, creating or modifying code components, managing color and text styles, handling localization, or publishing deployments. Trigger when the user mentions Framer, references their website or web pages, asks to edit designs, update site content, or work with any Framer project — even if they don't explicitly say 'Framer'.
+  Use when the user wants to design, edit, analyze, or publish a website or web page — creating layouts, editing sections, updating text or images, querying site analytics, managing CMS collections and content, syncing external data, creating or modifying code components, managing color and text styles, handling localization, or publishing deployments. Trigger when the user mentions Framer, references their website or web pages, asks to edit designs, update site content, analyze site traffic or conversions, or work with any Framer project — even if they don't explicitly say 'Framer'.
   **Mandatory precondition**: run `{{FRAMER_AGENT_COMMAND}}@latest setup` and let it complete **BEFORE** loading this skill.
 allowed-tools:
   - 'Bash({{FRAMER_AGENT_COMMAND}}:*)'
@@ -22,6 +22,7 @@ If you didn't run this command before loading the skill, run it now:
 What you can do with the Framer CLI:
 
 - **Canvas Editing**: For design tasks — creating or editing pages, sections, layouts, recreating designs from screenshots, etc.
+- **Analytics**: Query traffic, visitors, page views, conversions, and events.
 - **CMS**: Create, read, update, delete collections and items. Sync external databases.
 - **Styles**: Manage color and text styles. Sync design systems.
 - **Code Components**: Create, edit, type-check, and add custom React components to the canvas.
@@ -93,7 +94,7 @@ projects/<safeProjectId>/
 The generated `project-inventory.md` includes a snapshot of project context from `framer.agent.getContext()`, including pages, components, CMS data, styles, fonts, icons, and IDs when available.
 The source template for generated project files lives at `projects/__template__/`. Files ending in `.template.md` are rendered into generated files without the `.template` marker.
 
-Before editing, read `projects/<safeProjectId>/index.md` first. It contains a **task map**: read every item marked required in its "Always" row, including `prompt/critical-reminders.md`, then the row that matches your work — and every additional row a multi-domain task touches. The map routes you to the exact `prompt/` sections, `recipes.md` entries, and implementation guides for that task; read only what the map points to.
+Before starting any task, read `projects/<safeProjectId>/index.md` first. It contains a **task map**: read every item marked required in its "Always" row, including `prompt/critical-reminders.md`, then the row that matches your work — and every additional row a multi-domain task touches. The map routes you to the exact `prompt/` sections, `recipes.md` entries, and implementation guides for that task; read only what the map points to.
 
 Read `projects/<safeProjectId>/project-inventory.md` before using project-specific IDs, page paths, component names, CMS collection names, style preset names, or icon names. Treat it as a generated snapshot; when the project may have changed, use `{{FRAMER_AGENT_COMMAND}}@latest read-project` for fresh live project state.
 
@@ -145,15 +146,30 @@ Prefer `framer.agent.*` methods over regular plugin API methods when an agent-sp
 
 ### Execute Code
 
-Prefer writing code to a unique file under `{{FRAMER_TEMPORARY_DIR}}/` and executing it with `-f`. Do not create code files with shell heredocs or `cat`.
-
-Name files `<sessionId>-<short-summary>.js`, for example `1-read-collections.js`.
+For multiline or non-trivial code, use one `exec` call and send the code on stdin. In POSIX shells, use a quoted heredoc so the shell cannot expand `$`, backticks, or command substitutions in the JavaScript:
 
 ```bash
-{{FRAMER_AGENT_COMMAND}}@latest exec -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-read-collections.js
+{{FRAMER_AGENT_COMMAND}}@latest exec -s 1 <<'FRAMER_EXEC'
+const collections = await framer.getCollections();
+state.collections = collections;
+console.log(collections);
+FRAMER_EXEC
+```
+
+In Windows PowerShell, use the equivalent single-quoted here-string to prevent interpolation and pipe it to `exec`:
+
+```powershell
+@'
+const projectInfo = await framer.getProjectInfo();
+console.log(projectInfo);
+'@ | {{FRAMER_AGENT_COMMAND}}@latest exec -s 1
 ```
 
-For short snippets, `exec` also accepts `-e <code>` or code piped on stdin.
+For genuinely short snippets, use `-e <code>`:
+
+```bash
+{{FRAMER_AGENT_COMMAND}}@latest exec -s 1 -e 'console.log(await framer.getProjectInfo())'
+```
 
 ### Use `state`
 

package/skills/framer/projects/__template__/index.template.md

@@ -16,9 +16,10 @@ This `index.md` is the map. Read the **Always** row first — it is the core fou
 
 | Doing… | Read before you start |
 |---|---|
-| **Always — every change** | All files are required: [[prompt/core-principles.md]] (layout, spacing, width, fills, overflow) · [[prompt/core-examples.md]] (worked DSL patterns) · [[prompt/implementation-strategy.md]] (pick creation/edit/recreation, write a design plan, settle reusable-systems + site-metadata) · [[prompt/updating-the-project.md]] (DSL grammar) · [[prompt/tools.md]] (reads, screenshots, `reviewChanges`). House rules: [[prompt/overview.md]], [[prompt/guardrails.md]], [[prompt/critical-reminders.md]]. |
+| **Always — every change** | All files are required: [[prompt/core-principles.md]] (layout, spacing, width, fills, overflow) · [[prompt/core-examples.md]] (worked DSL patterns) · [[prompt/implementation-strategy.md]] (pick creation/edit/recreation, write a design plan, settle reusable-systems + site-metadata) · [[prompt/updating-the-project.md]] (DSL grammar) · [[prompt/tools.md]] (available tools and when to use them). House rules: [[prompt/overview.md]], [[prompt/guardrails.md]], [[prompt/critical-reminders.md]]. |
 | **Pages / sections** — create, redesign, add sections, visual polish, review | + [[prompt/design-rules.md]] · [[prompt/how-projects-work.md]] §Layout Recipe + §Width Rules + §Links |
 | **Responsive breakpoints** | [[recipes.md]] § Responsive breakpoints · [[prompt/how-projects-work.md]] §Layout Recipe (rules 7–8) |
+| **Analytics** — traffic, visitors, page views, conversions, events | guide **Analytics** |
 | **CMS** — collections, items, fields, collection lists, CMS-backed content | [[prompt/how-projects-work.md]] §CMS · [[prompt/updating-the-project.md]] (variable/CMS DSL) · guide **CMS Collection Lists** |
 | **CMS detail pages** | [[prompt/how-projects-work.md]] §CMS detail pages · guide **CMS Detail Pages** |
 | **Components / variants / icons** | [[prompt/how-projects-work.md]] §Components + §Icons · guide **Buttons** or others as needed |

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.