@framer/agent 0.0.36 → 0.0.38

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import fs8 from 'fs';
-import path7 from 'path';
+import path6 from 'path';
 import { Command } from 'commander';
 import crypto, { randomUUID } from 'crypto';
 import http from 'http';
@@ -9,11 +9,11 @@ import { z } from 'zod';
 import os2 from 'os';
 import isWsl from 'is-wsl';
 import { ErrorCode, FramerAPIError } from 'framer-api';
-import net from 'net';
 import { fileURLToPath } from 'url';
+import net from 'net';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.36 */
+/* @framer/ai CLI v0.0.38 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -107,12 +107,12 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path7.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path6.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path7.join(process.env.APPDATA || os2.homedir(), "framer");
+    return path6.join(process.env.APPDATA || os2.homedir(), "framer");
   }
-  return path7.join(os2.homedir(), ".config", "framer");
+  return path6.join(os2.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function ensureConfigDir() {
@@ -123,11 +123,11 @@ __name(ensureConfigDir, "ensureConfigDir");
 
 // src/config/projects.ts
 function getProjectsConfigPath() {
-  return path7.join(getConfigDir(), "projects.json");
+  return path6.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path7.join(getConfigDir(), "credentials.json");
+  return path6.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -313,7 +313,7 @@ var SettingsFileSchema = z.object({
   telemetryNoticeShown: z.boolean().optional()
 });
 function getSettingsPath() {
-  return path7.join(getConfigDir(), "settings.json");
+  return path6.join(getConfigDir(), "settings.json");
 }
 __name(getSettingsPath, "getSettingsPath");
 var settings;
@@ -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.36" 
+  "0.0.38" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -1174,7 +1174,7 @@ var types = {
     members: [
       {
         name: "type",
-        type: '"page" | "collection" | "designPage" | "siteSettings" | "component" | "layoutTemplate" | "vectorSet" | "codeFile"',
+        type: '"page" | "collection" | "designPage" | "siteSettings" | "component" | "layoutTemplate" | "vectorSet" | "codeFile" | "colorStyle" | "textStyle" | "linkStyle" | "blockquoteStyle" | "inlineCodeStyle" | "localization" | "localizationGlossary"',
         description: "",
         optional: false
       },
@@ -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,43 +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>",
         description: "@alpha",
         optional: false
       },
@@ -7645,81 +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>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getRectForAgent",
+        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>",
         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
       },
@@ -7906,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: {
@@ -8061,8 +8124,8 @@ var types = {
     alias: '"RadialGradient"',
     references: []
   },
-  rect$1: {
-    name: "Rect$1",
+  rect: {
+    name: "Rect",
     description: "",
     kind: "interface",
     references: [],
@@ -8295,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
       }
@@ -8399,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
       }
@@ -8506,8 +8569,8 @@ var types = {
     alias: 'Pick<ComponentInstancePlaceholderAttributes, "title" | "codePreview">',
     references: ["ComponentInstancePlaceholderAttributes"]
   },
-  size: {
-    name: "Size",
+  size$1: {
+    name: "Size$1",
     description: "",
     kind: "interface",
     references: [],
@@ -8639,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"
@@ -8835,7 +8898,7 @@ var types = {
     name: "SVGData",
     description: "",
     kind: "interface",
-    references: ["WithOptionalName"],
+    references: ["WithOptionalName$1"],
     members: [
       {
         name: "svg",
@@ -8844,7 +8907,7 @@ var types = {
         optional: false
       }
     ],
-    extends: ["WithOptionalName"]
+    extends: ["WithOptionalName$1"]
   },
   textalignment: {
     name: "TextAlignment",
@@ -8885,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: {
@@ -9634,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: {
@@ -9841,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: {
@@ -10868,8 +10931,8 @@ var types = {
     alias: "Partial<WithFieldRequired>",
     references: ["WithFieldRequired"]
   },
-  withoptionalname: {
-    name: "WithOptionalName",
+  withoptionalname$1: {
+    name: "WithOptionalName$1",
     description: "",
     kind: "interface",
     references: [],
@@ -12169,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",
@@ -12441,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",
@@ -12666,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",
@@ -13187,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",
@@ -13609,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"]
     },
@@ -13626,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"]
     },
@@ -13983,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",
@@ -14248,6 +14311,20 @@ var methodsByCategory = {
       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. Pair with the static prompt\nfrom {@link getSystemPrompt} for complete agent context.\n\n@returns A string containing the project context.",
       references: []
     },
+    {
+      name: "getDescendantReferencesOfTypes",
+      category: "FramerAgentAPI",
+      signature: "getDescendantReferencesOfTypes(input: { id: string; types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get style and token nodes referenced by a node\'s descendants.\n\n@param input - `{ id, types }`: the ancestor node id and referenced node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The referenced nodes without their children.',
+      references: []
+    },
+    {
+      name: "getDescendantsOfTypes",
+      category: "FramerAgentAPI",
+      signature: "getDescendantsOfTypes(input: { id: string; types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get descendants of a node with one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"TextRun"`).\n\n@param input - `{ id, types }`: the ancestor node id and node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching descendants without their children.',
+      references: []
+    },
     {
       name: "getGroundNode",
       category: "FramerAgentAPI",
@@ -14283,6 +14360,13 @@ var methodsByCategory = {
       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: "getRect",
+      category: "FramerAgentAPI",
+      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"]
+    },
     {
       name: "getScopeNode",
       category: "FramerAgentAPI",
@@ -14339,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",
@@ -14395,6 +14486,13 @@ var methodsByCategory = {
       description: "Renames a branch.\n\n@param branchId - Branch id to rename.\n@param title - New branch title.",
       references: []
     },
+    {
+      name: "replaceText",
+      category: "FramerAgentAPI",
+      signature: "replaceText(input: { id: string; searchText: string; replaceText: string; }, options?: { pagePath?: string; }): Promise<boolean>",
+      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",
@@ -14451,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"]
     },
@@ -14479,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",
@@ -15025,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",
@@ -15258,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",
@@ -15820,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",
@@ -16019,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",
@@ -16189,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",
@@ -16331,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",
@@ -16618,6 +16716,391 @@ ${typeDef}`);
 }
 __name(renderDocs, "renderDocs");
 
+// src/prompt-context.ts
+function toKebabId(title) {
+  const id = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return id || "section";
+}
+__name(toKebabId, "toKebabId");
+function uniquifyId(id, seen) {
+  const count = seen.get(id) ?? 0;
+  seen.set(id, count + 1);
+  return count === 0 ? id : `${id}-${count + 1}`;
+}
+__name(uniquifyId, "uniquifyId");
+function splitPromptSections(markdown) {
+  const normalized = markdown.replaceAll("\r\n", "\n");
+  if (normalized.trim() === "") {
+    throw new Error("Cannot split an empty agent prompt.");
+  }
+  const sections = [];
+  let current;
+  for (const line of normalized.split("\n")) {
+    const heading = line.match(/^#\s+(.+?)\s*#*\s*$/u);
+    if (heading) {
+      current = { title: heading[1].trim(), lines: [] };
+      sections.push(current);
+      continue;
+    }
+    if (!current) {
+      current = { title: "Preamble", lines: [] };
+      sections.push(current);
+    }
+    current.lines.push(line);
+  }
+  const seen = /* @__PURE__ */ new Map();
+  return sections.map((section) => ({
+    id: uniquifyId(toKebabId(section.title), seen),
+    title: section.title,
+    content: section.lines.join("\n").trim()
+  })).filter(
+    (section) => section.title !== "Preamble" || section.content !== ""
+  );
+}
+__name(splitPromptSections, "splitPromptSections");
+function renderTemplate(template, values) {
+  let rendered = template;
+  for (const [key, value] of Object.entries(values)) {
+    rendered = rendered.split(`{{${key}}}`).join(value);
+  }
+  return rendered;
+}
+__name(renderTemplate, "renderTemplate");
+function writeRenderedFile(filePath, content) {
+  fs8.mkdirSync(path6.dirname(filePath), { recursive: true });
+  fs8.writeFileSync(filePath, `${content.trimEnd()}
+`, "utf-8");
+}
+__name(writeRenderedFile, "writeRenderedFile");
+function isTextFile(filePath) {
+  const extension = path6.extname(filePath).toLowerCase();
+  return [
+    ".css",
+    ".html",
+    ".js",
+    ".json",
+    ".md",
+    ".mjs",
+    ".ts",
+    ".tsx",
+    ".txt",
+    ".yaml",
+    ".yml"
+  ].includes(extension);
+}
+__name(isTextFile, "isTextFile");
+function renderFileTree(sourceDir, destinationDir, options) {
+  for (const entry of fs8.readdirSync(sourceDir, { withFileTypes: true })) {
+    const sourcePath = path6.join(sourceDir, entry.name);
+    const destinationPath = path6.join(destinationDir, entry.name);
+    if (entry.isDirectory()) {
+      fs8.mkdirSync(destinationPath, { recursive: true });
+      renderFileTree(sourcePath, destinationPath, options);
+      continue;
+    }
+    if (entry.isSymbolicLink()) {
+      throw new Error(options.getSymlinkErrorMessage(sourcePath));
+    }
+    const renderedDestinationPath = options.getRenderedDestinationPath({
+      sourcePath,
+      destinationPath
+    });
+    if (renderedDestinationPath) {
+      const renderedContent = renderTemplate(
+        fs8.readFileSync(sourcePath, "utf-8"),
+        options.templateValues
+      );
+      writeRenderedFile(
+        renderedDestinationPath,
+        options.transformRenderedContent?.(renderedContent) ?? renderedContent
+      );
+      continue;
+    }
+    fs8.copyFileSync(sourcePath, destinationPath);
+  }
+}
+__name(renderFileTree, "renderFileTree");
+var FRAMER_TEMPORARY_DIR = path6.join(os2.tmpdir(), "framer");
+function ensureTemporaryDir() {
+  fs8.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+}
+__name(ensureTemporaryDir, "ensureTemporaryDir");
+function cleanupStaleSessionCodeFiles(activeSessionIds) {
+  if (!fs8.existsSync(FRAMER_TEMPORARY_DIR)) return;
+  const activeSessionIdsSet = new Set(activeSessionIds);
+  for (const entry of fs8.readdirSync(FRAMER_TEMPORARY_DIR)) {
+    const [sessionId] = entry.split("-");
+    if (activeSessionIdsSet.has(sessionId)) continue;
+    const filePath = path6.join(FRAMER_TEMPORARY_DIR, entry);
+    fs8.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
+  }
+}
+__name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
+
+// src/skills.ts
+var META_SKILL_NAME = "framer";
+var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
+var __dirname$1 = path6.dirname(fileURLToPath(import.meta.url));
+var sourceSkillsDir = path6.join(__dirname$1, "..", "skills");
+var GENERATED_PROJECTS_DIR_NAME = "projects";
+var GENERATED_PROJECT_TEMPLATE_ID = "__template__";
+var PROJECT_SKILL_PREFIX = "framer-project-";
+var LEGACY_CANVAS_EDITING_SKILL_PREFIX = "framer-canvas-editing-project-";
+var PACKAGE_NAME = "@framer/agent";
+var DEFAULT_FRAMER_AGENT_COMMAND = `npx ${PACKAGE_NAME}`;
+var RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND = `npx --min-release-age=0 ${PACKAGE_NAME}`;
+function getFramerAgentCommand() {
+  return isNpxMinReleaseAgeOverrideEnabled() ? RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND : DEFAULT_FRAMER_AGENT_COMMAND;
+}
+__name(getFramerAgentCommand, "getFramerAgentCommand");
+function replaceDefaultFramerAgentCommand(content) {
+  return content.replaceAll(
+    DEFAULT_FRAMER_AGENT_COMMAND,
+    getFramerAgentCommand()
+  );
+}
+__name(replaceDefaultFramerAgentCommand, "replaceDefaultFramerAgentCommand");
+function getSkillTemplateValues(skillDir) {
+  return {
+    FRAMER_TEMPORARY_DIR,
+    FRAMER_AGENT_COMMAND: getFramerAgentCommand(),
+    FRAMER_SKILL_DIR: skillDir
+  };
+}
+__name(getSkillTemplateValues, "getSkillTemplateValues");
+function toSafeProjectId(projectId) {
+  return projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
+}
+__name(toSafeProjectId, "toSafeProjectId");
+function removeSkillDirContents(skillDir, options) {
+  for (const entry of fs8.readdirSync(skillDir, { withFileTypes: true })) {
+    const entryPath = path6.join(skillDir, entry.name);
+    if (options.preserveGeneratedProjectBundles && entry.name === GENERATED_PROJECTS_DIR_NAME && entry.isDirectory()) {
+      fs8.rmSync(path6.join(entryPath, GENERATED_PROJECT_TEMPLATE_ID), {
+        recursive: true,
+        force: true,
+        maxRetries: 2
+      });
+      continue;
+    }
+    fs8.rmSync(entryPath, { recursive: true, force: true, maxRetries: 2 });
+  }
+}
+__name(removeSkillDirContents, "removeSkillDirContents");
+function prepareSkillDir(root, skillName) {
+  fs8.mkdirSync(root, { recursive: true });
+  const rootStat = fs8.statSync(root);
+  if (!rootStat.isDirectory()) {
+    throw new Error(`Skill root is not a directory: ${root}`);
+  }
+  const skillDir = path6.join(root, skillName);
+  const current = fs8.lstatSync(skillDir, { throwIfNoEntry: false });
+  if (current && (current.isSymbolicLink() || !current.isDirectory())) {
+    fs8.rmSync(skillDir, { recursive: true, force: true });
+  }
+  if (current?.isDirectory()) {
+    removeSkillDirContents(skillDir, {
+      preserveGeneratedProjectBundles: skillName === META_SKILL_NAME
+    });
+  }
+  fs8.mkdirSync(skillDir, { recursive: true });
+  return skillDir;
+}
+__name(prepareSkillDir, "prepareSkillDir");
+function installSourceSkill(root, skillName) {
+  const sourceDir = path6.join(sourceSkillsDir, skillName);
+  const skillDir = prepareSkillDir(root, skillName);
+  renderFileTree(sourceDir, skillDir, {
+    templateValues: getSkillTemplateValues(skillDir),
+    getRenderedDestinationPath: /* @__PURE__ */ __name(({ sourcePath, destinationPath }) => isTextFile(sourcePath) ? destinationPath : void 0, "getRenderedDestinationPath"),
+    getSymlinkErrorMessage: /* @__PURE__ */ __name((sourcePath) => `Source skill contains unsupported symlink: ${sourcePath}`, "getSymlinkErrorMessage")
+  });
+  return path6.join(skillDir, "SKILL.md");
+}
+__name(installSourceSkill, "installSourceSkill");
+function cleanupLegacyCanvasEditingSkills(skillRoots = getDefaultSkillRoots()) {
+  for (const root of skillRoots) {
+    if (!fs8.existsSync(root)) continue;
+    for (const entry of fs8.readdirSync(root)) {
+      if (!entry.startsWith(LEGACY_CANVAS_EDITING_SKILL_PREFIX)) continue;
+      const skillDir = path6.join(root, entry);
+      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+    }
+  }
+}
+__name(cleanupLegacyCanvasEditingSkills, "cleanupLegacyCanvasEditingSkills");
+function getDefaultSkillRoots() {
+  const home = os2.homedir();
+  return [
+    path6.join(home, ".agents", "skills"),
+    path6.join(home, ".claude", "skills")
+  ];
+}
+__name(getDefaultSkillRoots, "getDefaultSkillRoots");
+function cleanupProjectSkills(skillRoots = getDefaultSkillRoots()) {
+  for (const root of skillRoots) {
+    if (!fs8.existsSync(root)) continue;
+    for (const entry of fs8.readdirSync(root)) {
+      if (!entry.startsWith(PROJECT_SKILL_PREFIX)) continue;
+      const skillDir = path6.join(root, entry);
+      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+    }
+  }
+}
+__name(cleanupProjectSkills, "cleanupProjectSkills");
+function installSkills(options = { type: "base" }) {
+  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
+  const skillNames = [META_SKILL_NAME, CODE_COMPONENTS_SKILL_NAME];
+  const results = skillNames.map((skillName) => ({
+    skillName,
+    paths: skillRoots.map((root) => installSourceSkill(root, skillName))
+  }));
+  trackSkillsInstall({
+    skillType: options.type,
+    skillCount: results.length
+  });
+  return results;
+}
+__name(installSkills, "installSkills");
+
+// src/generated-project-bundle.ts
+var PROJECT_BUNDLE_SCHEMA_VERSION = 1;
+var PROJECT_TEMPLATE_ID = "__template__";
+var TEMPLATE_FILE_MARKER = ".template";
+var __dirname2 = path6.dirname(fileURLToPath(import.meta.url));
+function sha256(content) {
+  return crypto.createHash("sha256").update(content).digest("hex");
+}
+__name(sha256, "sha256");
+function renderPromptFile(section) {
+  return [`# ${section.title}`, "", section.content].join("\n");
+}
+__name(renderPromptFile, "renderPromptFile");
+function getRenderedTemplatePath(filePath) {
+  const extension = path6.extname(filePath);
+  const suffix = `${TEMPLATE_FILE_MARKER}${extension}`;
+  if (!filePath.endsWith(suffix)) return void 0;
+  return filePath.slice(0, -suffix.length) + extension;
+}
+__name(getRenderedTemplatePath, "getRenderedTemplatePath");
+function makeMetadata(options, safeProjectId) {
+  return {
+    projectId: options.projectId,
+    safeProjectId,
+    sessionId: options.sessionId,
+    generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    cliVersion: VERSION,
+    promptHash: sha256(options.agentPrompt),
+    contextHash: sha256(options.agentContext),
+    contextSchemaVersion: PROJECT_BUNDLE_SCHEMA_VERSION
+  };
+}
+__name(makeMetadata, "makeMetadata");
+function getInstalledFramerSkillDirs(skillRoots) {
+  return skillRoots.map((root) => path6.join(root, "framer")).filter((skillDir) => fs8.existsSync(path6.join(skillDir, "SKILL.md")));
+}
+__name(getInstalledFramerSkillDirs, "getInstalledFramerSkillDirs");
+function getProjectTemplateDir(skillDir) {
+  const installedTemplateDir = path6.join(
+    skillDir,
+    "projects",
+    PROJECT_TEMPLATE_ID
+  );
+  if (fs8.existsSync(installedTemplateDir)) return installedTemplateDir;
+  return path6.join(
+    __dirname2,
+    "..",
+    "skills",
+    "framer",
+    "projects",
+    PROJECT_TEMPLATE_ID
+  );
+}
+__name(getProjectTemplateDir, "getProjectTemplateDir");
+function cleanupStaleGeneratedProjectBundles(activeProjectIds, skillRoots = getDefaultSkillRoots()) {
+  const activeSafeProjectIds = new Set(activeProjectIds.map(toSafeProjectId));
+  for (const skillDir of getInstalledFramerSkillDirs(skillRoots)) {
+    const projectsDir = path6.join(skillDir, "projects");
+    if (!fs8.existsSync(projectsDir)) continue;
+    for (const entry of fs8.readdirSync(projectsDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name === PROJECT_TEMPLATE_ID) continue;
+      if (activeSafeProjectIds.has(entry.name)) continue;
+      fs8.rmSync(path6.join(projectsDir, entry.name), {
+        recursive: true,
+        force: true,
+        maxRetries: 2
+      });
+    }
+  }
+}
+__name(cleanupStaleGeneratedProjectBundles, "cleanupStaleGeneratedProjectBundles");
+function makeTemplateValues(metadata, sections, agentContext) {
+  return {
+    PROJECT_ID: metadata.projectId,
+    SAFE_PROJECT_ID: metadata.safeProjectId,
+    SESSION_ID: metadata.sessionId,
+    GENERATED_AT: metadata.generatedAt,
+    PROMPT_SECTION_LIST: sections.map((section) => `- \`prompt/${section.id}.md\` - ${section.title}`).join("\n"),
+    PROJECT_CONTEXT: agentContext,
+    READ_PROJECT_DOCS_COMMAND: replaceDefaultFramerAgentCommand(
+      "npx @framer/agent@latest docs framer.agent.readProject"
+    ),
+    READ_PROJECT_COMMAND: replaceDefaultFramerAgentCommand(
+      `npx @framer/agent@latest read-project -s ${metadata.sessionId} -p "/" -q '<queries-json>'`
+    )
+  };
+}
+__name(makeTemplateValues, "makeTemplateValues");
+function writeGeneratedProjectBundle(options) {
+  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
+  const framerSkillDirs = getInstalledFramerSkillDirs(skillRoots);
+  if (framerSkillDirs.length === 0) {
+    throw new Error(
+      "Could not find an installed framer skill. Run `@framer/agent setup` before `session new`."
+    );
+  }
+  const safeProjectId = toSafeProjectId(options.projectId);
+  if (safeProjectId === PROJECT_TEMPLATE_ID) {
+    throw new Error(`Project ID resolves to reserved template directory.`);
+  }
+  const renderedPrompt = replaceDefaultFramerAgentCommand(options.agentPrompt);
+  const renderedContext = replaceDefaultFramerAgentCommand(
+    options.agentContext
+  );
+  const sections = splitPromptSections(renderedPrompt);
+  const metadata = makeMetadata(
+    { ...options, agentPrompt: renderedPrompt, agentContext: renderedContext },
+    safeProjectId
+  );
+  const paths = [];
+  for (const skillDir of framerSkillDirs) {
+    const projectDir = path6.join(skillDir, "projects", safeProjectId);
+    const templateDir = getProjectTemplateDir(skillDir);
+    fs8.rmSync(projectDir, { recursive: true, force: true, maxRetries: 2 });
+    fs8.mkdirSync(projectDir, { recursive: true });
+    renderFileTree(templateDir, projectDir, {
+      templateValues: makeTemplateValues(metadata, sections, renderedContext),
+      getRenderedDestinationPath: /* @__PURE__ */ __name(({ sourcePath, destinationPath }) => getRenderedTemplatePath(destinationPath) ?? (isTextFile(sourcePath) ? destinationPath : void 0), "getRenderedDestinationPath"),
+      getSymlinkErrorMessage: /* @__PURE__ */ __name((sourcePath) => `Project template contains unsupported symlink: ${sourcePath}`, "getSymlinkErrorMessage"),
+      transformRenderedContent: replaceDefaultFramerAgentCommand
+    });
+    for (const section of sections) {
+      writeRenderedFile(
+        path6.join(projectDir, "prompt", `${section.id}.md`),
+        renderPromptFile(section)
+      );
+    }
+    writeRenderedFile(
+      path6.join(projectDir, "metadata.json"),
+      JSON.stringify(metadata, null, "	")
+    );
+    paths.push(projectDir);
+  }
+  return { safeProjectId, paths };
+}
+__name(writeGeneratedProjectBundle, "writeGeneratedProjectBundle");
+
 // src/headless-server-url.ts
 var PROD_HEADLESS_SERVER_URL = "wss://api.framer.com/channel/headless-plugin";
 var DEV_HEADLESS_SERVER_URL = "wss://api.development.framer.com/channel/headless-plugin";
@@ -16669,7 +17152,7 @@ function inferHeadlessServerUrl(projectUrlOrId) {
 }
 __name(inferHeadlessServerUrl, "inferHeadlessServerUrl");
 function getRelayTokenPath() {
-  return path7.join(getConfigDir(), "relay-token");
+  return path6.join(getConfigDir(), "relay-token");
 }
 __name(getRelayTokenPath, "getRelayTokenPath");
 function readRelayToken() {
@@ -16684,7 +17167,7 @@ __name(readRelayToken, "readRelayToken");
 
 // src/relay-client.ts
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path7.dirname(__filename$1);
+var __dirname3 = path6.dirname(__filename$1);
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var WAIT_TIMEOUT_SECONDS = 5;
 var client = createTRPCClient({
@@ -16809,7 +17292,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path7.resolve(__dirname$1, "./start-relay-server.ts") : path7.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path6.resolve(__dirname3, "./start-relay-server.ts") : path6.resolve(__dirname3, "./start-relay-server.js");
   debug("relay", `spawning server process: ${scriptPath}`);
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
@@ -16846,171 +17329,6 @@ async function waitForClaudeCodeSkillDiscovery() {
   );
 }
 __name(waitForClaudeCodeSkillDiscovery, "waitForClaudeCodeSkillDiscovery");
-var FRAMER_TEMPORARY_DIR = path7.join(os2.tmpdir(), "framer");
-function ensureTemporaryDir() {
-  fs8.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
-}
-__name(ensureTemporaryDir, "ensureTemporaryDir");
-function cleanupStaleSessionCodeFiles(activeSessionIds) {
-  if (!fs8.existsSync(FRAMER_TEMPORARY_DIR)) return;
-  const activeSessionIdsSet = new Set(activeSessionIds);
-  for (const entry of fs8.readdirSync(FRAMER_TEMPORARY_DIR)) {
-    const [sessionId] = entry.split("-");
-    if (activeSessionIdsSet.has(sessionId)) continue;
-    const filePath = path7.join(FRAMER_TEMPORARY_DIR, entry);
-    fs8.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
-  }
-}
-__name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
-
-// src/skills.ts
-var META_SKILL_NAME = "framer";
-var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path7.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path7.join(__dirname2, "..", "docs", "skills");
-function readSkillDoc(name2) {
-  return fs8.readFileSync(path7.join(skillsDocsDir, name2), "utf-8").trimEnd();
-}
-__name(readSkillDoc, "readSkillDoc");
-function buildMetaSkill() {
-  const command = getFramerAgentCommand();
-  const template = readSkillDoc("framer.md");
-  return `${renderTemplate(template, {
-    FRAMER_TEMPORARY_DIR,
-    FRAMER_AGENT_COMMAND: command
-  })}
-`;
-}
-__name(buildMetaSkill, "buildMetaSkill");
-function buildCodeComponentsSkill() {
-  return `${readSkillDoc("framer-code-components.md")}
-`;
-}
-__name(buildCodeComponentsSkill, "buildCodeComponentsSkill");
-function renderTemplate(template, values) {
-  let rendered = template;
-  for (const [key, value] of Object.entries(values)) {
-    rendered = rendered.split(`{{${key}}}`).join(value);
-  }
-  return rendered;
-}
-__name(renderTemplate, "renderTemplate");
-var PROJECT_SKILL_PREFIX = "framer-project-";
-var LEGACY_CANVAS_EDITING_SKILL_PREFIX = "framer-canvas-editing-project-";
-var PACKAGE_NAME = "@framer/agent";
-var DEFAULT_FRAMER_AGENT_COMMAND = `npx ${PACKAGE_NAME}`;
-var RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND = `npx --min-release-age=0 ${PACKAGE_NAME}`;
-function getFramerAgentCommand() {
-  return isNpxMinReleaseAgeOverrideEnabled() ? RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND : DEFAULT_FRAMER_AGENT_COMMAND;
-}
-__name(getFramerAgentCommand, "getFramerAgentCommand");
-function toSafeProjectId(projectId) {
-  return projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
-}
-__name(toSafeProjectId, "toSafeProjectId");
-function buildProjectSkill(projectId, agentContext, agentPrompt) {
-  const command = getFramerAgentCommand();
-  const skillName = `${PROJECT_SKILL_PREFIX}${toSafeProjectId(projectId)}`;
-  const template = readSkillDoc("framer-project.md");
-  const content = `${renderTemplate(template, {
-    SKILL_NAME: skillName,
-    PROJECT_ID: projectId,
-    GENERATED_AT: (/* @__PURE__ */ new Date()).toISOString(),
-    AGENT_PROMPT: agentPrompt.trimEnd().replaceAll(DEFAULT_FRAMER_AGENT_COMMAND, command),
-    AGENT_CONTEXT: agentContext.trimEnd().replaceAll(DEFAULT_FRAMER_AGENT_COMMAND, command),
-    FRAMER_TEMPORARY_DIR,
-    FRAMER_AGENT_COMMAND: command
-  })}
-`;
-  return { skillName, content };
-}
-__name(buildProjectSkill, "buildProjectSkill");
-function writeSkill(root, skillName, content) {
-  fs8.mkdirSync(root, { recursive: true });
-  const rootStat = fs8.statSync(root);
-  if (!rootStat.isDirectory()) {
-    throw new Error(`Skill root is not a directory: ${root}`);
-  }
-  const skillDir = path7.join(root, skillName);
-  const filePath = path7.join(skillDir, "SKILL.md");
-  const current = fs8.lstatSync(skillDir, { throwIfNoEntry: false });
-  if (current && (current.isSymbolicLink() || !current.isDirectory())) {
-    fs8.rmSync(skillDir, { recursive: true, force: true });
-  }
-  fs8.mkdirSync(skillDir, { recursive: true });
-  fs8.writeFileSync(filePath, content, "utf-8");
-  return filePath;
-}
-__name(writeSkill, "writeSkill");
-function cleanupLegacyCanvasEditingSkills(skillRoots = getDefaultSkillRoots()) {
-  for (const root of skillRoots) {
-    if (!fs8.existsSync(root)) continue;
-    for (const entry of fs8.readdirSync(root)) {
-      if (!entry.startsWith(LEGACY_CANVAS_EDITING_SKILL_PREFIX)) continue;
-      const skillDir = path7.join(root, entry);
-      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
-    }
-  }
-}
-__name(cleanupLegacyCanvasEditingSkills, "cleanupLegacyCanvasEditingSkills");
-function getDefaultSkillRoots() {
-  const home = os2.homedir();
-  return [
-    path7.join(home, ".agents", "skills"),
-    path7.join(home, ".claude", "skills")
-  ];
-}
-__name(getDefaultSkillRoots, "getDefaultSkillRoots");
-function cleanupStaleSkills(activeProjectIds, skillRoots = getDefaultSkillRoots()) {
-  const sanitizedActiveProjectIds = new Set(
-    [...activeProjectIds].map(toSafeProjectId)
-  );
-  for (const root of skillRoots) {
-    if (!fs8.existsSync(root)) continue;
-    for (const entry of fs8.readdirSync(root)) {
-      if (!entry.startsWith(PROJECT_SKILL_PREFIX)) continue;
-      const sanitizedProjectId = entry.slice(PROJECT_SKILL_PREFIX.length);
-      const isActive = sanitizedActiveProjectIds.has(sanitizedProjectId);
-      if (isActive) continue;
-      const skillDir = path7.join(root, entry);
-      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
-    }
-  }
-}
-__name(cleanupStaleSkills, "cleanupStaleSkills");
-function installSkills(options = { type: "base" }) {
-  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
-  const skills = [
-    { name: META_SKILL_NAME, content: buildMetaSkill() },
-    {
-      name: CODE_COMPONENTS_SKILL_NAME,
-      content: buildCodeComponentsSkill()
-    }
-  ];
-  if (options.type === "project") {
-    const projectSkill = buildProjectSkill(
-      options.projectId,
-      options.agentContext,
-      options.agentPrompt
-    );
-    skills.push({
-      name: projectSkill.skillName,
-      content: projectSkill.content
-    });
-  }
-  const results = skills.map((skill) => ({
-    skillName: skill.name,
-    paths: skillRoots.map(
-      (root) => writeSkill(root, skill.name, skill.content)
-    )
-  }));
-  trackSkillsInstall({
-    skillType: options.type,
-    skillCount: results.length
-  });
-  return results;
-}
-__name(installSkills, "installSkills");
 
 // src/cli.ts
 var PROGRAM_NAME = "@framer/agent";
@@ -17038,8 +17356,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path7.dirname(filePath);
-      const root = path7.dirname(skillDir);
+      const skillDir = path6.dirname(filePath);
+      const root = path6.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -17067,6 +17385,13 @@ async function installBaseSkills() {
       `Failed to clean up legacy canvas editing skills: ${formatErrorForUser(error)}`
     );
   }
+  try {
+    cleanupProjectSkills();
+  } catch (error) {
+    printWarning(
+      `Failed to clean up generated project skills: ${formatErrorForUser(error)}`
+    );
+  }
   const results = installSkills();
   await waitForClaudeCodeSkillDiscovery();
   return results;
@@ -17104,29 +17429,30 @@ async function getAgentContext(sessionId) {
   return context;
 }
 __name(getAgentContext, "getAgentContext");
-async function refreshSkillsFromSession(sessionId, projectId) {
+async function refreshGeneratedProjectBundleFromSession(sessionId, projectId) {
   try {
     debug("skills", "fetching agent system prompt + context...");
     const [agentPrompt, agentContext] = await Promise.all([
       getAgentSystemPrompt(sessionId),
       getAgentContext(sessionId)
     ]);
-    debug("skills", "installing skills...");
-    installSkills({
-      type: "project",
+    debug("skills", "writing generated project bundle...");
+    writeGeneratedProjectBundle({
       agentPrompt,
       projectId,
+      sessionId,
       agentContext
     });
-    debug("skills", "skills installed");
+    debug("skills", "generated project bundle written");
+    await waitForClaudeCodeSkillDiscovery();
   } catch (err) {
     throw errorWithRef(
-      `Failed to refresh skills for session ${sessionId}: ${formatError(err)}`,
+      `Failed to refresh generated project bundle for session ${sessionId}: ${formatError(err)}`,
       getErrorRef(err)
     );
   }
 }
-__name(refreshSkillsFromSession, "refreshSkillsFromSession");
+__name(refreshGeneratedProjectBundleFromSession, "refreshGeneratedProjectBundleFromSession");
 async function resolveSessionCredentials(projectUrlOrId) {
   const projectId = extractProjectId(projectUrlOrId);
   try {
@@ -17315,13 +17641,18 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
       });
       sessionId = result.id;
       debug("session.new", `session created id=${sessionId}`);
-      debug("session.new", "fetching project name + refreshing skills...");
+      debug(
+        "session.new",
+        "fetching project name + refreshing generated bundle..."
+      );
       const [projectName] = await Promise.all([
         getProjectName(sessionId),
-        refreshSkillsFromSession(sessionId, projectId)
+        refreshGeneratedProjectBundleFromSession(sessionId, projectId)
       ]);
-      debug("session.new", `project name="${projectName}", skills refreshed`);
-      await waitForClaudeCodeSkillDiscovery();
+      debug(
+        "session.new",
+        `project name="${projectName}", generated files written`
+      );
       saveProject({
         projectId,
         apiKey: credentials.apiKey,
@@ -17335,10 +17666,10 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
         (activeSession) => activeSession.projectId
       );
       try {
-        cleanupStaleSkills(activeProjectIds);
+        cleanupStaleGeneratedProjectBundles(activeProjectIds);
       } catch (error) {
         printWarning(
-          `Failed to clean up stale skills: ${formatErrorForUser(error)}`
+          `Failed to clean up stale generated project bundles: ${formatErrorForUser(error)}`
         );
       }
       const activeSessionIds = activeSessions.map(