framer-dalton 0.0.14 → 0.0.16

package/dist/cli.js

@@ -10,7 +10,7 @@ import { z } from 'zod';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.14 */
+/* @framer/ai CLI v0.0.16 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function openUrl(url) {
@@ -14982,7 +14982,7 @@ __name(renderDocs, "renderDocs");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.14" 
+  "0.0.16" 
 );
 
 // src/relay-client.ts
@@ -15344,7 +15344,31 @@ async function ensureRelayForCli() {
   }
 }
 __name(ensureRelayForCli, "ensureRelayForCli");
-program.option("-s, --session <id>", "Session ID (required for code execution)").option("-e, --eval <code>", "Code to execute (or pipe via stdin)").option("-f, --file <path>", "File containing code to execute").action(async (options) => {
+async function execAndPrint(sessionId, code) {
+  await ensureRelayForCli();
+  try {
+    const result = await client.exec.mutate({
+      sessionId: String(sessionId),
+      code,
+      cwd: process.cwd()
+    });
+    for (const line of result.output) {
+      print(line);
+    }
+    if (result.error) {
+      printError(`Error: ${result.error}`);
+      process.exit(1);
+    }
+  } catch (err) {
+    printError(`Execution failed: ${formatError(err)}`);
+    process.exit(1);
+  }
+}
+__name(execAndPrint, "execAndPrint");
+program.command("exec").description("Execute code in a session").requiredOption(
+  "-s, --session <id>",
+  "Session ID (create one with `session new <projectUrlOrId>`)"
+).option("-e, --eval <code>", "Code to execute (or pipe via stdin)").option("-f, --file <path>", "File containing code to execute").action(async (options, command) => {
   const { session: sessionId, eval: evalCode, file: filePath } = options;
   ensureTemporaryDir();
   let code = evalCode;
@@ -15363,34 +15387,43 @@ program.option("-s, --session <id>", "Session ID (required for code execution)")
     code = await readStdin();
   }
   if (!code) {
-    program.help();
+    command.help();
     return;
   }
-  if (!sessionId) {
-    printError("Error: -s/--session is required.");
-    printError(
-      "Run `framer session new <projectUrlOrId>` first to get a session ID."
-    );
-    process.exit(1);
-  }
-  await ensureRelayForCli();
+  await execAndPrint(sessionId, code);
+});
+program.command("apply-changes").description("Apply canvas DSL changes to a page").requiredOption(
+  "-s, --session <id>",
+  "Session ID (create one with `session new <projectUrlOrId>`)"
+).requiredOption("-e, --eval <dsl>", "DSL string to apply").option("-p, --page <path>", "Target page path", "/").action(async (options) => {
+  const { session: sessionId, eval: dsl, page: pagePath } = options;
+  const code = `
+      const result = await framer.applyAgentChanges(${JSON.stringify(dsl)}, { pagePath: ${JSON.stringify(pagePath)} });
+      if (result) console.log(JSON.stringify(result, null, 2));
+    `;
+  await execAndPrint(sessionId, code);
+});
+program.command("read-project").description("Read project state for a page").requiredOption(
+  "-s, --session <id>",
+  "Session ID (create one with `session new <projectUrlOrId>`)"
+).requiredOption("-q, --queries <json>", "JSON array of query objects").requiredOption("-p, --page <path>", "Target page path").action(async (options) => {
+  const {
+    session: sessionId,
+    queries: queriesJson,
+    page: pagePath
+  } = options;
+  let queries;
   try {
-    const result = await client.exec.mutate({
-      sessionId: String(sessionId),
-      code,
-      cwd: process.cwd()
-    });
-    for (const line of result.output) {
-      print(line);
-    }
-    if (result.error) {
-      printError(`Error: ${result.error}`);
-      process.exit(1);
-    }
-  } catch (err) {
-    printError(`Execution failed: ${formatError(err)}`);
+    queries = JSON.parse(queriesJson);
+  } catch {
+    printError("Invalid JSON for --queries");
     process.exit(1);
   }
+  const code = `
+      const result = await framer.readProjectForAgent(${JSON.stringify(queries)}, { pagePath: ${JSON.stringify(pagePath)} });
+      if (result) console.log(JSON.stringify(result, null, 2));
+    `;
+  await execAndPrint(sessionId, code);
 });
 var session = program.command("session").description("Manage sessions");
 session.command("new <projectUrlOrId>").description("Create a new session and print the session ID").action(async (projectUrlOrId) => {

package/dist/start-relay-server.js

@@ -13,7 +13,7 @@ import { createRequire } from 'module';
 import * as vm from 'vm';
 import { connect } from 'framer-api';
 
-/* @framer/ai relay server v0.0.14 */
+/* @framer/ai relay server v0.0.16 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
@@ -93,7 +93,7 @@ __name(log, "log");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.14" 
+  "0.0.16" 
 );
 
 // src/relay-client.ts

package/docs/skills/framer-canvas-editing-project.md

@@ -11,12 +11,10 @@ allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)",
 
 ## Rules
 
-- For design/layout work, do not use low-level node APIs (`createNode`, `setAttributes`, `setRect`, etc.). Use the canvas editing flow (`readProjectForAgent` + `applyAgentChanges`) with the embedded prompt and project context in this skill.
-- Canvas editing agent methods are employee-only.
-- Canvas editing methods are not globals. Call `framer.readProjectForAgent` and `framer.applyAgentChanges` as `framer.*`.
+- For design/layout work, do not use low-level node APIs (`createNode`, `setAttributes`, `setRect`, etc.). Use the canvas editing flow (`read-project` + `apply-changes`) with the embedded prompt and project context in this skill.
 - During normal task execution, do not call `framer.getAgentSystemPrompt()` or `framer.getAgentContext()`. This skill already includes `getAgentContext({ pagePath: "/" })`.
-- `framer.readProjectForAgent(queries, { pagePath })` reads project state. Start with page structure only, then request additional targeted queries only if needed. Query types are documented in the embedded prompt below. Never guess names for examples, icon sets, or fonts; look them up first.
-- `framer.applyAgentChanges(dsl, { pagePath })` applies canvas DSL changes. After applying changes, re-read project state to inspect results and iterate with `readProjectForAgent` + `applyAgentChanges` until accurate.
+- `npx framer-dalton read-project -s <sessionId> -q <queries> -p <pagePath>` reads project state. Start with page structure only, then request additional targeted queries only if needed. Query types are documented in the embedded prompt below. Never guess names for examples, icon sets, or fonts; look them up first.
+- `npx framer-dalton apply-changes -s <sessionId> -p <pagePath> -e <dsl>` applies canvas DSL changes. After applying changes, re-read project state to inspect results and iterate with `read-project` + `apply-changes` until accurate.
 - Request examples only when needed, and only after inspecting page structure first. Keep example queries targeted and minimal.
 - Use screenshots only when visual verification is necessary and cannot be confirmed from state reads. Do not use them for initial inspection or between every small change.
 - When setting text content, use raw Unicode characters directly (for example `->`, not `\u2192`).
@@ -27,31 +25,18 @@ allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)",
 ## Workflow Loop
 
 ```bash
-# 1) Read page structure first — write code to a unique file, then execute with -f
-# {{FRAMER_TEMPORARY_DIR}}/<sessionId>-read-page.js:
-#   const { results } = await framer.readProjectForAgent(
-#     [{ type: "page", path: "/" }],
-#     { pagePath: "/" }
-#   );
-#   console.log(results);
-
-framer -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-read-page.js
+# 1) Read page structure first
+npx framer-dalton read-project -s <sessionId> -q '[{"type":"page","path":"/"}]' -p "/"
 
 # 2) Request additional targeted queries only if needed
 
-# 3) Apply changes in a later call, once `dsl` has been prepared
-# {{FRAMER_TEMPORARY_DIR}}/<sessionId>-apply-changes.js:
-#   const dsl = `
-#   ...your canvas DSL...
-#   `;
-#   await framer.applyAgentChanges(dsl, { pagePath: "/" });
-
-framer -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-apply-changes.js
+# 3) Apply changes — pass DSL directly via apply-changes
+npx framer-dalton apply-changes -s <sessionId> -p "/" -e "$dsl"
 ```
 
 ## Critical for UX: Streaming
 
-When you generate a DSL file to apply, keep it short. Each file must only cover ONE logical section (header, footer, hero, card, etc.). Once you generate ONE section, apply it and continue with the next section.
+When you generate DSL to apply, keep it short. Each `apply-changes` call must only cover ONE logical section (header, footer, hero, card, etc.). Once you apply ONE section, continue with the next.
 
 This ensures progress is streamed to the user in small, visible increments.
 
@@ -59,8 +44,8 @@ This ensures progress is streamed to the user in small, visible increments.
 
 This is the static canvas-editing prompt returned by `framer.getAgentSystemPrompt()`. It is the sole documentation for:
 
-- command syntax for `applyAgentChanges`
-- query types and parameters for `readProjectForAgent`
+- command syntax for `apply-changes`
+- query types and parameters for `read-project`
 - design rules and examples used by the canvas editing flow
 
 {{CANVAS_PROMPT}}

package/docs/skills/framer.md

@@ -52,6 +52,8 @@ Create a session:
 npx framer-dalton session new "<url or 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.
+
 #### 2. Look up the API (before EVERY code execution)
 
 **You MUST run `npx framer-dalton docs` before writing any code.** Do not guess method names or signatures.
@@ -66,7 +68,7 @@ npx framer-dalton docs Collection.getItems  # What are the parameters and return
 Only after checking docs, write your code to a unique file under `{{FRAMER_TEMPORARY_DIR}}/` and execute with `-f`. Name each file `<sessionId>-<short-summary>.js` where `<short-summary>` is a brief kebab-case description (e.g., `1-read-collections.js`, `1-add-team-member.js`). Files are automatically deleted after execution.
 
 ```bash
-npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-read-collections.js
+npx framer-dalton exec -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-read-collections.js
 ```
 
 #### 4. Store results in `state`
@@ -100,7 +102,7 @@ state.collections = await framer.getCollections();
 ```
 
 ```bash
-npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-collections.js
+npx framer-dalton exec -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-collections.js
 ```
 
 ```js
@@ -110,7 +112,7 @@ console.log(state.teamItems.length);
 ```
 
 ```bash
-npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-team-items.js
+npx framer-dalton exec -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-team-items.js
 ```
 
 Store anything you'll reference again.
@@ -140,7 +142,7 @@ npx framer-dalton session list
 
 ## Canvas Editing
 
-For design tasks, do not try to build or restyle pages with low-level node APIs. Instead, load the dynamically created project-scoped canvas skill and follow its `readProjectForAgent` plus `applyAgentChanges` flow.
+For design tasks, do not try to build or restyle pages with low-level node APIs. Instead, load the dynamically created project-scoped canvas skill and use the `read-project` and `apply-changes` subcommands.
 
 After session creation, load the dynamically created project-scoped skill `framer-canvas-editing-project-<projectId>` for canvas editing on the connected project. It contains the canvas editing guidance, the live agent system prompt, and the live project context for `pagePath: "/"`.
 
@@ -149,7 +151,7 @@ After session creation, load the dynamically created project-scoped skill `frame
 Write your code to a unique file under `{{FRAMER_TEMPORARY_DIR}}/` and execute with `-f`:
 
 ```bash
-npx framer-dalton -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-<short-summary>.js
+npx framer-dalton exec -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-<short-summary>.js
 ```
 
 ## API Documentation
@@ -645,6 +647,7 @@ const contributors = await framer.getChangeContributors();
 
 ### Known Limitations
 
-- **Pages**: No list, delete, update, move, or settings APIs (create only)
+- **Pages**: Cannot change the path of a page
+- **Collection Index/Detail Pages**: Cannot be created as new pages; the user must create them through the UI. Once they exist, they can be modified normally through canvas editing.
 - **Code overrides**: Cannot assign overrides to nodes
 - **Analytics**: No APIs exist for accessing analytics data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "type": "module",
   "bin": {
     "framer-dalton": "./dist/cli.js"