framer-dalton 0.0.30 → 0.0.32

package/dist/cli.js

@@ -12,7 +12,7 @@ import net from 'net';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.30 */
+/* @framer/ai CLI v0.0.32 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -375,7 +375,7 @@ __name(markTelemetryNoticeShown, "markTelemetryNoticeShown");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.30" 
+  "0.0.32" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -16444,6 +16444,37 @@ function expandReferences(refs, seen) {
   return result;
 }
 __name(expandReferences, "expandReferences");
+function getMethodByPath(query) {
+  const pathParts = query.split(".");
+  if (pathParts.length < 2) return void 0;
+  if (pathParts.length === 2) {
+    const method = getMethod(query);
+    return method ? { method, displayCategory: method.category } : void 0;
+  }
+  let methods = methodsByCategory[pathParts[0].toLowerCase()];
+  const rootClass = classes[pathParts[0].toLowerCase()];
+  let displayCategory = rootClass?.name ?? pathParts[0];
+  for (let pathIndex = 1; pathIndex < pathParts.length; pathIndex++) {
+    const pathPart = pathParts[pathIndex];
+    const method = methods?.find(
+      (candidateMethod) => candidateMethod.name === pathPart
+    );
+    if (!method) return void 0;
+    if (pathIndex === pathParts.length - 1) {
+      return { method, displayCategory };
+    }
+    if (!method.signature.startsWith(`${method.name}:`) && !method.signature.startsWith(`${method.name}?:`)) {
+      return void 0;
+    }
+    const nestedCategory = method.references.find(
+      (referenceName) => methodsByCategory[referenceName.toLowerCase()]
+    );
+    if (!nestedCategory) return void 0;
+    displayCategory = `${displayCategory}.${method.name}`;
+    methods = methodsByCategory[nestedCategory.toLowerCase()];
+  }
+}
+__name(getMethodByPath, "getMethodByPath");
 function renderDocs(queries) {
   const lines = [];
   const errors = [];
@@ -16455,8 +16486,8 @@ function renderDocs(queries) {
     const query = queries[i];
     if (i > 0) lines.push("");
     if (query.includes(".")) {
-      const method = getMethod(query);
-      if (!method) {
+      const methodPath = getMethodByPath(query);
+      if (!methodPath) {
         const { methodNames } = getAllKnownNames();
         const suggestion = findClosestMatch(query, methodNames);
         const hint = suggestion ? ` Did you mean '${suggestion}'?` : "";
@@ -16465,8 +16496,9 @@ function renderDocs(queries) {
         );
         return { lines, errors };
       }
+      const { method, displayCategory } = methodPath;
       if (method.description) lines.push(formatDocComment(method.description));
-      lines.push(`${method.category}.${method.signature}`);
+      lines.push(`${displayCategory}.${method.signature}`);
       const seen = /* @__PURE__ */ new Set();
       for (const typeDef of expandReferences(method.references, seen)) {
         lines.push(`

package/dist/start-relay-server.js

@@ -14,7 +14,7 @@ import { z } from 'zod';
 import { createRequire } from 'module';
 import * as vm from 'vm';
 
-/* @framer/ai relay server v0.0.30 */
+/* @framer/ai relay server v0.0.32 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name2, symbol) => (symbol = Symbol[name2]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name2);
 var __typeError = (msg) => {
@@ -199,7 +199,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.30" 
+  "0.0.32" 
 );
 
 // src/relay-client.ts
@@ -687,15 +687,24 @@ async function execute(session, code, options = {}) {
 }
 __name(execute, "execute");
 async function readActiveBranch(session) {
+  if (session.branchMonitoringDisabled) return void 0;
   try {
     const branch = await session.connection.framer.agent.getActiveBranch();
     session.connection.setActiveBranchId(branch.id);
     return branch;
-  } catch {
+  } catch (err) {
+    if (isBranchingUnavailableError(err)) {
+      session.branchMonitoringDisabled = true;
+    }
     return void 0;
   }
 }
 __name(readActiveBranch, "readActiveBranch");
+function isBranchingUnavailableError(err) {
+  if (!(err instanceof Error)) return false;
+  return err.message.includes("Branching is not available");
+}
+__name(isBranchingUnavailableError, "isBranchingUnavailableError");
 async function getBranchChange(session, previousBranch) {
   if (!previousBranch) return void 0;
   const activeBranch = await readActiveBranch(session);

package/docs/skills/framer-project.md

@@ -262,7 +262,7 @@ const commands = rows.flatMap((row, i) => {
   return [`+CollectionItemNode ${itemId} parent="${collectionId}";`, `SET ${itemId} ${sets.join(" ")};`];
 });
 
-await framer.agent.applyChanges(commands.join(" "));
+console.log(await framer.agent.applyChanges(commands.join(" ")));
 ```
 
 #### Writing enum fields
@@ -275,10 +275,10 @@ const collection = (await framer.agent.getNodesOfTypes({ types: ["CollectionNode
 const statusField = collection.variables.find((v) => v.name === "Status");
 const status = statusField.cases.find((name) => name === "New");
 
-await framer.agent.applyChanges(
+console.log(await framer.agent.applyChanges(
   `+CollectionItemNode newPost parent="${collection.id}";
    SET newPost $control__slug="hello-world" ${statusField.key}="${status}";`,
-);
+));
 ```
 
 #### Sync external data
@@ -306,7 +306,7 @@ const commands = source.flatMap((row, i) => {
 });
 existing.filter((item) => !seen.has(item.id)).forEach((item) => commands.push(`DEL ${item.id};`));
 
-await framer.agent.applyChanges(commands.join(" "));
+console.log(await framer.agent.applyChanges(commands.join(" ")));
 ```
 
 #### Field Types
@@ -383,10 +383,10 @@ console.log(state.diagnostics);
 state.component = state.codeFile.exports.find(
   (exportItem) => exportItem.type === "component" && exportItem.isDefaultExport,
 );
-await framer.agent.applyChanges(
+console.log(await framer.agent.applyChanges(
   `+ComponentInstanceNode badge parent="wrapper" component="${state.component.componentId}"; SET badge width=120 height=48;`,
   { pagePath: "/" },
-);
+));
 ```
 
 #### Editing

package/docs/skills/framer.md

@@ -65,8 +65,6 @@ npx @framer/agent@latest project remix "<url, project id, or remix link>"
 npx @framer/agent@latest session new "<returned project id>"
 ```
 
-Note that during beta, you cannot connect to non-beta projects. If creating a session errors with a message about this, you need to move your project to beta.
-
 List active sessions:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "type": "module",
   "bin": "./dist/cli.js",
   "main": "./dist/cli.js",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.13",
     "@framerjs/framer-events": "0.0.185",
-    "@types/node": "24.12.4",
+    "@types/node": "24.13.0",
     "tsup": "^8.0.2",
     "tsx": "^4.22.3",
     "typescript": "^5.9.2",