framer-dalton 0.0.10 → 0.0.12

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import fs2 from 'fs';
-import path3 from 'path';
+import fs3 from 'fs';
+import path4 from 'path';
 import { Command } from 'commander';
 import crypto from 'crypto';
 import http from 'http';
@@ -10,7 +10,7 @@ import { z } from 'zod';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.10 */
+/* @framer/ai CLI v0.0.12 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function openUrl(url) {
@@ -36,20 +36,20 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path3.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path4.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path3.join(process.env.APPDATA || os.homedir(), "framer");
+    return path4.join(process.env.APPDATA || os.homedir(), "framer");
   }
-  return path3.join(os.homedir(), ".config", "framer");
+  return path4.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function getProjectsConfigPath() {
-  return path3.join(getConfigDir(), "projects.json");
+  return path4.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path3.join(getConfigDir(), "credentials.json");
+  return path4.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -65,11 +65,11 @@ var ProjectsConfigSchema = z.object({
 });
 var LegacyCredentialsSchema = z.record(z.string(), z.string());
 function readJsonFile(filePath) {
-  if (!fs2.existsSync(filePath)) {
+  if (!fs3.existsSync(filePath)) {
     return null;
   }
   try {
-    return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+    return JSON.parse(fs3.readFileSync(filePath, "utf-8"));
   } catch (_error) {
     return null;
   }
@@ -77,14 +77,14 @@ function readJsonFile(filePath) {
 __name(readJsonFile, "readJsonFile");
 function ensureConfigDir() {
   const configDir = getConfigDir();
-  if (!fs2.existsSync(configDir)) {
-    fs2.mkdirSync(configDir, { recursive: true, mode: 448 });
+  if (!fs3.existsSync(configDir)) {
+    fs3.mkdirSync(configDir, { recursive: true, mode: 448 });
   }
 }
 __name(ensureConfigDir, "ensureConfigDir");
 function writeProjectsConfig(config) {
   ensureConfigDir();
-  fs2.writeFileSync(
+  fs3.writeFileSync(
     getProjectsConfigPath(),
     JSON.stringify(config, null, "	"),
     {
@@ -111,7 +111,7 @@ function migrateLegacyCredentials() {
   }
   const config = { version: 2, projects };
   writeProjectsConfig(config);
-  fs2.rmSync(getLegacyCredentialsPath(), { force: true });
+  fs3.rmSync(getLegacyCredentialsPath(), { force: true });
   return config;
 }
 __name(migrateLegacyCredentials, "migrateLegacyCredentials");
@@ -124,7 +124,7 @@ function readProjectsConfig() {
       return result.data;
     }
   }
-  if (fs2.existsSync(getLegacyCredentialsPath())) {
+  if (fs3.existsSync(getLegacyCredentialsPath())) {
     return migrateLegacyCredentials();
   }
   return { version: 2, projects: {} };
@@ -204,6 +204,16 @@ __name(printError, "printError");
 
 // src/auth-callback.ts
 var TIMEOUT_MS = 3e5;
+var codeMessages = {
+  "user.denied": "Authorization denied by user.",
+  "project.access_denied": "You don\u2019t have access to this project.",
+  "project.not_found": "Project not found. Check that the project ID is correct.",
+  "project.unauthorized": "Not logged in to Framer.",
+  "api_key.access_denied": "You don\u2019t have permission to create API keys for this project.",
+  "api_key.unauthorized": "Session expired.",
+  connection_error: "Could not connect to Framer.",
+  unknown: "Authorization failed."
+};
 var themes = {
   dark: {
     pageBackground: "rgb(17, 17, 17)",
@@ -271,15 +281,6 @@ function successHtml(theme) {
   });
 }
 __name(successHtml, "successHtml");
-function deniedHtml(theme) {
-  return htmlPage({
-    title: "Framer \u2014 Authorization Denied",
-    heading: "Authorization Denied",
-    message: "Agent access was denied. You can close this tab.",
-    theme
-  });
-}
-__name(deniedHtml, "deniedHtml");
 function errorHtml(theme) {
   return htmlPage({
     title: "Framer \u2014 Authorization Failed",
@@ -289,10 +290,26 @@ function errorHtml(theme) {
   });
 }
 __name(errorHtml, "errorHtml");
+function codeHtml(code, theme) {
+  const heading = code === "user.denied" ? "Authorization Denied" : "Authorization Failed";
+  return htmlPage({
+    title: `Framer \u2014 ${heading}`,
+    heading,
+    message: codeMessages[code],
+    theme
+  });
+}
+__name(codeHtml, "codeHtml");
 function parseTheme(value) {
   return value === "light" ? "light" : "dark";
 }
 __name(parseTheme, "parseTheme");
+var validCodes = new Set(Object.keys(codeMessages));
+function parseCode(value) {
+  if (value !== null && validCodes.has(value)) return value;
+  return null;
+}
+__name(parseCode, "parseCode");
 async function acquireKeyFromBrowser(projectId) {
   const state = crypto.randomBytes(16).toString("hex");
   return new Promise((resolve, reject) => {
@@ -324,12 +341,14 @@ async function acquireKeyFromBrowser(projectId) {
         return;
       }
       const theme = parseTheme(url.searchParams.get("theme"));
-      const error = url.searchParams.get("error");
-      if (error === "denied") {
+      const legacyError = url.searchParams.get("error");
+      const legacyCode = legacyError === "denied" ? "user.denied" : legacyError === "failed" ? "project.unauthorized" : null;
+      const code = parseCode(url.searchParams.get("code")) ?? legacyCode;
+      if (code !== null) {
         res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(deniedHtml(theme));
+        res.end(codeHtml(code, theme));
         cleanup();
-        reject(new Error("Authorization denied by user."));
+        reject(new Error(codeMessages[code]));
         return;
       }
       const apiKey = url.searchParams.get("apiKey");
@@ -14909,8 +14928,8 @@ ${typeDef}`);
 }
 __name(renderDocs, "renderDocs");
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path3.dirname(__filename$1);
-var VERSION = "0.0.10" ;
+var __dirname$1 = path4.dirname(__filename$1);
+var VERSION = "0.0.12" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -14972,7 +14991,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path3.resolve(__dirname$1, "./start-relay-server.ts") : path3.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path4.resolve(__dirname$1, "./start-relay-server.ts") : path4.resolve(__dirname$1, "./start-relay-server.js");
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
     [scriptPath],
@@ -14994,16 +15013,37 @@ async function ensureRelayServerRunning(options = {}) {
   throw new Error("Failed to start relay server after 5 seconds");
 }
 __name(ensureRelayServerRunning, "ensureRelayServerRunning");
+var FRAMER_TEMPORARY_DIR = path4.join(os.tmpdir(), "framer");
+function ensureTemporaryDir() {
+  fs3.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+}
+__name(ensureTemporaryDir, "ensureTemporaryDir");
+function isTemporaryFile(filePath) {
+  const absolutePath = path4.resolve(filePath);
+  const isInTemporaryDir = absolutePath.startsWith(
+    FRAMER_TEMPORARY_DIR + path4.sep
+  );
+  const isFile = fs3.statSync(absolutePath, { throwIfNoEntry: false })?.isFile() ?? false;
+  return isInTemporaryDir && isFile;
+}
+__name(isTemporaryFile, "isTemporaryFile");
+function removeTemporaryFile(filePath) {
+  fs3.unlinkSync(filePath);
+}
+__name(removeTemporaryFile, "removeTemporaryFile");
+
+// src/skills.ts
 var META_SKILL_NAME = "framer";
 var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path3.join(__dirname2, "..", "docs", "skills");
+var __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
+var skillsDocsDir = path4.join(__dirname2, "..", "docs", "skills");
 function readSkillDoc(name) {
-  return fs2.readFileSync(path3.join(skillsDocsDir, name), "utf-8").trimEnd();
+  return fs3.readFileSync(path4.join(skillsDocsDir, name), "utf-8").trimEnd();
 }
 __name(readSkillDoc, "readSkillDoc");
 function buildMetaSkill() {
-  return `${readSkillDoc("framer.md")}
+  const template = readSkillDoc("framer.md");
+  return `${renderTemplate(template, { FRAMER_TEMPORARY_DIR })}
 `;
 }
 __name(buildMetaSkill, "buildMetaSkill");
@@ -15033,36 +15073,37 @@ function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
     PROJECT_ID: projectId,
     GENERATED_AT: (/* @__PURE__ */ new Date()).toISOString(),
     CANVAS_PROMPT: canvasPrompt.trimEnd(),
-    AGENT_CONTEXT: agentContext.trimEnd()
+    AGENT_CONTEXT: agentContext.trimEnd(),
+    FRAMER_TEMPORARY_DIR
   })}
 `;
   return { skillName, content };
 }
 __name(buildProjectCanvasSkill, "buildProjectCanvasSkill");
 function writeSkill(root, skillName, content) {
-  fs2.mkdirSync(root, { recursive: true });
-  const rootStat = fs2.statSync(root);
+  fs3.mkdirSync(root, { recursive: true });
+  const rootStat = fs3.statSync(root);
   if (!rootStat.isDirectory()) {
     throw new Error(`Skill root is not a directory: ${root}`);
   }
-  const skillDir = path3.join(root, skillName);
-  const filePath = path3.join(skillDir, "SKILL.md");
-  if (fs2.existsSync(skillDir)) {
-    const current = fs2.lstatSync(skillDir);
+  const skillDir = path4.join(root, skillName);
+  const filePath = path4.join(skillDir, "SKILL.md");
+  if (fs3.existsSync(skillDir)) {
+    const current = fs3.lstatSync(skillDir);
     if (current.isSymbolicLink() || !current.isDirectory()) {
-      fs2.rmSync(skillDir, { recursive: true, force: true });
+      fs3.rmSync(skillDir, { recursive: true, force: true });
     }
   }
-  fs2.mkdirSync(skillDir, { recursive: true });
-  fs2.writeFileSync(filePath, content, "utf-8");
+  fs3.mkdirSync(skillDir, { recursive: true });
+  fs3.writeFileSync(filePath, content, "utf-8");
   return filePath;
 }
 __name(writeSkill, "writeSkill");
 function getDefaultSkillRoots() {
   const home = os.homedir();
   return [
-    path3.join(home, ".agents", "skills"),
-    path3.join(home, ".claude", "skills")
+    path4.join(home, ".agents", "skills"),
+    path4.join(home, ".claude", "skills")
   ];
 }
 __name(getDefaultSkillRoots, "getDefaultSkillRoots");
@@ -15111,8 +15152,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path3.dirname(filePath);
-      const root = path3.dirname(skillDir);
+      const skillDir = path4.dirname(filePath);
+      const root = path4.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -15216,14 +15257,18 @@ 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) => {
   const { session: sessionId, eval: evalCode, file: filePath } = options;
+  ensureTemporaryDir();
   let code = evalCode;
   if (!code && filePath) {
     try {
-      code = fs2.readFileSync(filePath, "utf-8");
+      code = fs3.readFileSync(filePath, "utf-8");
     } catch (err) {
       printError(`Failed to read file: ${formatError(err)}`);
       process.exit(1);
     }
+    if (isTemporaryFile(filePath)) {
+      removeTemporaryFile(filePath);
+    }
   }
   if (!code && !process.stdin.isTTY) {
     code = await readStdin();

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.10 */
+/* @framer/ai relay server v0.0.12 */
 var __defProp = Object.defineProperty;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
@@ -91,7 +91,7 @@ function log(message) {
 __name(log, "log");
 var __filename$1 = fileURLToPath(import.meta.url);
 path.dirname(__filename$1);
-var VERSION = "0.0.10" ;
+var VERSION = "0.0.12" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 createTRPCClient({
   links: [
@@ -456,25 +456,24 @@ async function execute(session, framer, code, options = {}) {
   }
 }
 __name(execute, "execute");
-async function executeWithReconnect(session, framer, code, options, reconnect) {
+async function executeWithReconnect(session, framer, code, options, reconnect, execId) {
   const result = await tryExecute(session, framer, code, options);
   if (!result.error || !isConnectionError(result.error)) {
     return result;
   }
-  log(
-    `reconnect session=${session.id} project=${session.projectId} reason="${result.error}"`
-  );
+  const reqId = framer.requestId;
+  const tag = `exec=${execId} session=${session.id}${reqId ? ` req=${reqId}` : ""}`;
+  log(`reconnect ${tag} project=${session.projectId} reason="${result.error}"`);
   const newFramer = await reconnect();
   if (!newFramer) {
-    log(
-      `reconnect.failed session=${session.id} error="no connection returned"`
-    );
+    log(`reconnect.failed ${tag} error="no connection returned"`);
     return {
       output: [],
       error: "Connection lost and failed to reconnect"
     };
   }
-  log(`reconnect.success session=${session.id}`);
+  const newReqId = newFramer.requestId;
+  log(`reconnect.success ${tag}${newReqId ? ` new_req=${newReqId}` : ""}`);
   return tryExecute(session, newFramer, code, options);
 }
 __name(executeWithReconnect, "executeWithReconnect");
@@ -522,6 +521,10 @@ var ConnectionPool = class {
     const entry = this.pool.get(projectId);
     if (entry) {
       entry.sessions.add(session);
+      if (!entry.connected) {
+        await entry.connection.reconnect();
+        entry.connected = true;
+      }
       return entry.connection;
     }
     const connection = await connect(projectId, apiKey);
@@ -645,6 +648,9 @@ var SessionManager = class {
   getFramer(session) {
     return connectionPool.getConnection(session.projectId);
   }
+  isConnected(session) {
+    return connectionPool.isConnected(session.projectId);
+  }
   async reconnect(session) {
     return connectionPool.reconnect(session.projectId);
   }
@@ -696,13 +702,23 @@ var SessionManager = class {
   }
   async reapIdleSessions() {
     const now = Date.now();
-    const disconnects = [];
+    const projectSessions = /* @__PURE__ */ new Map();
     for (const session of this.sessions.values()) {
-      if (session.inflight > 0) continue;
-      if (now - session.lastActivityAt < SESSION_IDLE_TIMEOUT_MS) continue;
-      if (!connectionPool.isConnected(session.projectId)) continue;
-      const { projectId } = session;
-      log(`idle disconnect project=${projectId}`);
+      const existing = projectSessions.get(session.projectId);
+      if (existing) existing.push(session);
+      else projectSessions.set(session.projectId, [session]);
+    }
+    const disconnects = [];
+    for (const [projectId, sessions] of projectSessions) {
+      if (!connectionPool.isConnected(projectId)) continue;
+      const allIdle = sessions.every(
+        (s) => s.inflight === 0 && now - s.lastActivityAt >= SESSION_IDLE_TIMEOUT_MS
+      );
+      if (!allIdle) continue;
+      const reqId = connectionPool.getConnection(projectId)?.requestId;
+      log(
+        `idle disconnect project=${projectId}${reqId ? ` req=${reqId}` : ""}`
+      );
       disconnects.push(connectionPool.disconnect(projectId));
     }
     const results = await Promise.allSettled(disconnects);
@@ -719,6 +735,7 @@ var sessionManager = new SessionManager();
 
 // src/router.ts
 var t = initTRPC.create();
+var nextExecId = 0;
 var appRouter = t.router({
   version: t.procedure.query(() => {
     return { version: VERSION };
@@ -761,11 +778,19 @@ var appRouter = t.router({
         });
       }
       const _guard = __using(_stack, sessionManager.exec(sessionId));
-      log(
-        `exec session=${sessionId} code=${JSON.stringify(code).slice(0, 100)}`
-      );
-      const framer = sessionManager.getFramer(session);
+      const execId = nextExecId++;
+      let framer = sessionManager.getFramer(session);
+      if (framer && !sessionManager.isConnected(session)) {
+        log(
+          `exec.reconnect exec=${execId} session=${sessionId} reason="idle disconnected"`
+        );
+        framer = await sessionManager.reconnect(session);
+      }
+      const reqId = framer?.requestId;
+      const tag = `exec=${execId} session=${sessionId}${reqId ? ` req=${reqId}` : ""}`;
+      log(`exec ${tag} code=${JSON.stringify(code).slice(0, 100)}`);
       if (!framer) {
+        log(`exec.error ${tag} error="no connection"`);
         return {
           output: [],
           error: "Failed to get connection for session"
@@ -776,10 +801,11 @@ var appRouter = t.router({
         framer,
         code,
         { cwd },
-        () => sessionManager.reconnect(session)
+        () => sessionManager.reconnect(session),
+        execId
       );
       if (result.error) {
-        log(`exec.error session=${sessionId} error="${result.error}"`);
+        log(`exec.error ${tag} error="${result.error}"`);
       }
       return result;
     } catch (_) {

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

@@ -1,7 +1,7 @@
 ---
 name: {{SKILL_NAME}}
 description: "Project-scoped Framer canvas editing skill for project {{PROJECT_ID}}. Very important: never load this skill without having already read the `framer` skill and without having already run `session new`, which will dynamically update this skill."
-allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write(/tmp/framer-*)"]
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write({{FRAMER_TEMPORARY_DIR}}/*)"]
 ---
 
 ## Project Scope
@@ -27,26 +27,26 @@ allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)",
 ## Workflow Loop
 
 ```bash
-# 1) Read page structure first — write code to /tmp/framer-<sessionId>.js, then execute with -f
-# /tmp/framer-<sessionId>.js:
+# 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 /tmp/framer-<sessionId>.js
+framer -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-read-page.js
 
 # 2) Request additional targeted queries only if needed
 
 # 3) Apply changes in a later call, once `dsl` has been prepared
-# /tmp/framer-<sessionId>.js:
+# {{FRAMER_TEMPORARY_DIR}}/<sessionId>-apply-changes.js:
 #   const dsl = `
 #   ...your canvas DSL...
 #   `;
 #   await framer.applyAgentChanges(dsl, { pagePath: "/" });
 
-framer -s <sessionId> -f /tmp/framer-<sessionId>.js
+framer -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-apply-changes.js
 ```
 
 ## Live Agent System Prompt

package/docs/skills/framer.md

@@ -3,7 +3,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'. 
   **Mandatory precondition**: run `npx framer-dalton@latest setup` and let it complete **BEFORE** loading this skill.
-allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write(/tmp/framer-*)"]
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write({{FRAMER_TEMPORARY_DIR}}/*)"]
 ---
 
 If you didn't run this command before loading the skill, run it now:
@@ -59,14 +59,12 @@ npx framer-dalton docs Collection.getItems  # What are the parameters and return
 
 #### 3. Execute code
 
-Only after checking docs, write your code to a `framer-<sessionId>.js` file in the OS temp directory and execute with `-f`. Use the session ID in the filename to avoid collisions between parallel sessions:
+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 /tmp/framer-1.js
+npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-read-collections.js
 ```
 
-On Windows, use the equivalent temp directory (e.g. `%TEMP%\framer-1.js`).
-
 #### 4. Store results in `state`
 
 Always save results you'll need again. Don't repeat API calls.
@@ -93,22 +91,22 @@ Always save results you'll need again. Don't repeat API calls.
 **Always store results in `state` when you'll need them again.** API calls are slow - don't repeat them.
 
 ```js
-// /tmp/framer-1.js
+// {{FRAMER_TEMPORARY_DIR}}/1-get-collections.js
 state.collections = await framer.getCollections();
 ```
 
 ```bash
-npx framer-dalton -s 1 -f /tmp/framer-1.js
+npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-collections.js
 ```
 
 ```js
-// /tmp/framer-1.js — reuse from state
+// {{FRAMER_TEMPORARY_DIR}}/1-get-team-items.js — reuse from state
 state.teamItems = await state.collections.find(c => c.name === 'Team').getItems();
 console.log(state.teamItems.length);
 ```
 
 ```bash
-npx framer-dalton -s 1 -f /tmp/framer-1.js
+npx framer-dalton -s 1 -f {{FRAMER_TEMPORARY_DIR}}/1-get-team-items.js
 ```
 
 Store anything you'll reference again.
@@ -144,10 +142,10 @@ After session creation, load the dynamically created project-scoped skill `frame
 
 ## Execute Code
 
-Write your code to `framer-<sessionId>.js` in the OS temp directory and execute with `-f`:
+Write your code to a unique file under `{{FRAMER_TEMPORARY_DIR}}/` and execute with `-f`:
 
 ```bash
-npx framer-dalton -s <sessionId> -f /tmp/framer-<sessionId>.js
+npx framer-dalton -s <sessionId> -f {{FRAMER_TEMPORARY_DIR}}/<sessionId>-<short-summary>.js
 ```
 
 ## API Documentation

package/package.json

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