@framer/agent 0.0.38 → 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.38 */
+/* @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.38" 
+  "0.0.39" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -4391,6 +4391,12 @@ var types = {
         type: "FontStyle$1 | null",
         description: "",
         optional: false
+      },
+      {
+        name: "url",
+        type: "string | null",
+        description: "",
+        optional: false
       }
     ]
   },
@@ -7690,12 +7696,6 @@ var types = {
         description: "@alpha",
         optional: false
       },
-      {
-        name: "reviewChangesForAgent",
-        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>",
@@ -13059,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",
@@ -14252,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: []
     },
     {
@@ -14493,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",

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.38 */
+/* @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.38" 
+  "0.0.39" 
 );
 
 // src/relay-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framer/agent",
-  "version": "0.0.38",
+  "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.22",
+    "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 |