framer-dalton 0.0.9 → 0.0.10

package/dist/cli.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
+import fs2 from 'fs';
 import path3 from 'path';
 import { Command } from 'commander';
 import crypto from 'crypto';
 import http from 'http';
 import { spawn, execFile } from 'child_process';
-import fs2 from 'fs';
 import os from 'os';
 import { z } from 'zod';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.9 */
+/* @framer/ai CLI v0.0.10 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function openUrl(url) {
@@ -14910,7 +14910,7 @@ ${typeDef}`);
 __name(renderDocs, "renderDocs");
 var __filename$1 = fileURLToPath(import.meta.url);
 var __dirname$1 = path3.dirname(__filename$1);
-var VERSION = "0.0.9" ;
+var VERSION = "0.0.10" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -15214,9 +15214,17 @@ 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)").action(async (options) => {
-  const { session: sessionId, eval: evalCode } = options;
+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;
   let code = evalCode;
+  if (!code && filePath) {
+    try {
+      code = fs2.readFileSync(filePath, "utf-8");
+    } catch (err) {
+      printError(`Failed to read file: ${formatError(err)}`);
+      process.exit(1);
+    }
+  }
   if (!code && !process.stdin.isTTY) {
     code = await readStdin();
   }

package/dist/start-relay-server.js

@@ -13,9 +13,50 @@ import { createRequire } from 'module';
 import * as vm from 'vm';
 import { connect } from 'framer-api';
 
-/* @framer/ai relay server v0.0.9 */
+/* @framer/ai relay server v0.0.10 */
 var __defProp = Object.defineProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
 function getLogPath() {
   if (process.env.XDG_STATE_HOME) {
     return path.join(process.env.XDG_STATE_HOME, "framer", "relay.log");
@@ -50,7 +91,7 @@ function log(message) {
 __name(log, "log");
 var __filename$1 = fileURLToPath(import.meta.url);
 path.dirname(__filename$1);
-var VERSION = "0.0.9" ;
+var VERSION = "0.0.10" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 createTRPCClient({
   links: [
@@ -486,7 +527,8 @@ var ConnectionPool = class {
     const connection = await connect(projectId, apiKey);
     this.pool.set(projectId, {
       connection,
-      sessions: /* @__PURE__ */ new Set([session])
+      sessions: /* @__PURE__ */ new Set([session]),
+      connected: true
     });
     return connection;
   }
@@ -515,11 +557,26 @@ var ConnectionPool = class {
     if (!entry) return null;
     try {
       await entry.connection.reconnect();
+      entry.connected = true;
       return entry.connection;
     } catch {
       return null;
     }
   }
+  /**
+   * Disconnect a project's connection without removing sessions.
+   * The next exec will trigger a reconnect via executeWithReconnect.
+   */
+  async disconnect(projectId) {
+    const entry = this.pool.get(projectId);
+    if (!entry || !entry.connected) return;
+    entry.connected = false;
+    await entry.connection.disconnect();
+  }
+  isConnected(projectId) {
+    const entry = this.pool.get(projectId);
+    return entry?.connected ?? false;
+  }
   /**
    * Release a session from a connection.
    * If no sessions remain, the connection is disconnected and removed.
@@ -548,11 +605,14 @@ var ConnectionPool = class {
 var connectionPool = new ConnectionPool();
 
 // src/session-manager.ts
+var SESSION_IDLE_TIMEOUT_MS = 60 * 1e3;
+var SESSION_IDLE_CHECK_INTERVAL_MS = 30 * 1e3;
 var SessionManager = class {
   static {
     __name(this, "SessionManager");
   }
   sessions = /* @__PURE__ */ new Map();
+  idleCheck = null;
   async create(projectId, apiKey) {
     let id = 1;
     while (this.sessions.has(String(id))) {
@@ -562,9 +622,13 @@ var SessionManager = class {
       id: String(id),
       projectId,
       apiKey,
-      state: {}
+      state: {},
+      lastActivityAt: 0,
+      inflight: 0
     };
+    this.startIdleCheck();
     await connectionPool.acquire(projectId, apiKey, session);
+    session.lastActivityAt = Date.now();
     this.sessions.set(String(id), session);
     return String(id);
   }
@@ -584,6 +648,21 @@ var SessionManager = class {
   async reconnect(session) {
     return connectionPool.reconnect(session.projectId);
   }
+  /** Marks session as actively executing. Dispose to release. */
+  exec(id) {
+    const session = this.sessions.get(id);
+    if (session) {
+      session.inflight++;
+    }
+    return {
+      [Symbol.dispose]: () => {
+        if (session) {
+          session.inflight--;
+          session.lastActivityAt = Date.now();
+        }
+      }
+    };
+  }
   async destroy(id) {
     const session = this.sessions.get(id);
     if (!session) {
@@ -591,12 +670,50 @@ var SessionManager = class {
     }
     await connectionPool.release(session.projectId, session);
     this.sessions.delete(id);
+    if (this.sessions.size === 0) {
+      this.stopIdleCheck();
+    }
   }
   async destroyAll() {
     for (const id of this.sessions.keys()) {
       await this.destroy(id);
     }
   }
+  startIdleCheck() {
+    if (this.idleCheck) return;
+    this.idleCheck = setInterval(() => {
+      this.reapIdleSessions().catch((err) => {
+        log(`reap error: ${err instanceof Error ? err.message : err}`);
+      });
+    }, SESSION_IDLE_CHECK_INTERVAL_MS);
+    this.idleCheck.unref();
+  }
+  stopIdleCheck() {
+    if (this.idleCheck) {
+      clearInterval(this.idleCheck);
+      this.idleCheck = null;
+    }
+  }
+  async reapIdleSessions() {
+    const now = Date.now();
+    const disconnects = [];
+    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}`);
+      disconnects.push(connectionPool.disconnect(projectId));
+    }
+    const results = await Promise.allSettled(disconnects);
+    for (const result of results) {
+      if (result.status === "rejected") {
+        log(
+          `disconnect error: ${result.reason instanceof Error ? result.reason.message : result.reason}`
+        );
+      }
+    }
+  }
 };
 var sessionManager = new SessionManager();
 
@@ -633,35 +750,43 @@ var appRouter = t.router({
       cwd: z.string().optional()
     })
   ).mutation(async ({ input }) => {
-    const { sessionId, code, cwd } = input;
-    const session = sessionManager.get(sessionId);
-    if (!session) {
-      throw new TRPCError({
-        code: "NOT_FOUND",
-        message: `Session ${sessionId} not found`
-      });
-    }
-    log(
-      `exec session=${sessionId} code=${JSON.stringify(code).slice(0, 100)}`
-    );
-    const framer = sessionManager.getFramer(session);
-    if (!framer) {
-      return {
-        output: [],
-        error: "Failed to get connection for session"
-      };
-    }
-    const result = await executeWithReconnect(
-      session,
-      framer,
-      code,
-      { cwd },
-      () => sessionManager.reconnect(session)
-    );
-    if (result.error) {
-      log(`exec.error session=${sessionId} error="${result.error}"`);
+    var _stack = [];
+    try {
+      const { sessionId, code, cwd } = input;
+      const session = sessionManager.get(sessionId);
+      if (!session) {
+        throw new TRPCError({
+          code: "NOT_FOUND",
+          message: `Session ${sessionId} not found`
+        });
+      }
+      const _guard = __using(_stack, sessionManager.exec(sessionId));
+      log(
+        `exec session=${sessionId} code=${JSON.stringify(code).slice(0, 100)}`
+      );
+      const framer = sessionManager.getFramer(session);
+      if (!framer) {
+        return {
+          output: [],
+          error: "Failed to get connection for session"
+        };
+      }
+      const result = await executeWithReconnect(
+        session,
+        framer,
+        code,
+        { cwd },
+        () => sessionManager.reconnect(session)
+      );
+      if (result.error) {
+        log(`exec.error session=${sessionId} error="${result.error}"`);
+      }
+      return result;
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
     }
-    return result;
   }),
   shutdown: t.procedure.mutation(() => {
     log("shutdown requested");
@@ -672,11 +797,25 @@ var appRouter = t.router({
 });
 
 // src/relay-server.ts
+var IDLE_TIMEOUT_MS = 24 * 60 * 60 * 1e3;
+var IDLE_CHECK_INTERVAL_MS = 60 * 1e3;
 var trpcHandler = createHTTPHandler({ router: appRouter });
 async function startRelayServer(port = RELAY_PORT) {
+  let lastActivityAt = Date.now();
   const server = http.createServer((req, res) => {
+    lastActivityAt = Date.now();
     trpcHandler(req, res);
   });
+  const idleCheck = setInterval(() => {
+    const idleMs = Date.now() - lastActivityAt;
+    if (idleMs >= IDLE_TIMEOUT_MS) {
+      log(`idle for ${Math.round(idleMs / 1e3)}s, shutting down`);
+      clearInterval(idleCheck);
+      server.close();
+      process.exit(0);
+    }
+  }, IDLE_CHECK_INTERVAL_MS);
+  idleCheck.unref();
   return new Promise((resolve, reject) => {
     server.on("error", reject);
     server.listen(port, "127.0.0.1", () => {

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:*)"]
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write(/tmp/framer-*)"]
 ---
 
 ## 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
-framer -s <sessionId> <<'EOF'
-const { results } = await framer.readProjectForAgent(
-  [{ type: "page", path: "/" }],
-  { pagePath: "/" }
-);
+# 1) Read page structure first — write code to /tmp/framer-<sessionId>.js, then execute with -f
+# /tmp/framer-<sessionId>.js:
+#   const { results } = await framer.readProjectForAgent(
+#     [{ type: "page", path: "/" }],
+#     { pagePath: "/" }
+#   );
+#   console.log(results);
 
-console.log(results);
-EOF
+framer -s <sessionId> -f /tmp/framer-<sessionId>.js
 
 # 2) Request additional targeted queries only if needed
 
 # 3) Apply changes in a later call, once `dsl` has been prepared
-framer -s <sessionId> <<'EOF'
-const dsl = `
-...your canvas DSL...
-`;
+# /tmp/framer-<sessionId>.js:
+#   const dsl = `
+#   ...your canvas DSL...
+#   `;
+#   await framer.applyAgentChanges(dsl, { pagePath: "/" });
 
-await framer.applyAgentChanges(dsl, { pagePath: "/" });
-EOF
+framer -s <sessionId> -f /tmp/framer-<sessionId>.js
 ```
 
 ## Live Agent System Prompt
@@ -61,6 +61,6 @@ This is the static canvas-editing prompt returned by `framer.getAgentSystemPromp
 
 ## Live Agent Context (/)
 
-This is the dynamic project context returned by `framer.getAgentContext({ pagePath: "/" })`. It contains project-specific data for the current page, including available fonts, components and their controls, design tokens, style presets, and icon sets.
+This is the dynamic project context returned by `framer.getAgentContext({ pagePath: "/" })`. It contains project-specific data for the current page, including available fonts, available components, design tokens, style presets, and icon sets.
 
 {{AGENT_CONTEXT}}

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:*)"]
+allowed-tools: ["Bash(npx framer-dalton:*)", "Bash(npx framer-dalton@latest:*)", "Write(/tmp/framer-*)"]
 ---
 
 If you didn't run this command before loading the skill, run it now:
@@ -59,12 +59,14 @@ npx framer-dalton docs Collection.getItems  # What are the parameters and return
 
 #### 3. Execute code
 
-Only after checking docs:
+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:
 
 ```bash
-npx framer-dalton -s 1 -e "state.collections = await framer.getCollections(); console.log(state.collections.length)"
+npx framer-dalton -s 1 -f /tmp/framer-1.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.
@@ -90,13 +92,23 @@ 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
+state.collections = await framer.getCollections();
+```
+
 ```bash
-# First call: fetch and store
-npx framer-dalton -s 1 -e "state.collections = await framer.getCollections()"
+npx framer-dalton -s 1 -f /tmp/framer-1.js
+```
 
-# Later calls: reuse from state
-npx framer-dalton -s 1 -e "const team = state.collections.find(c => c.name === 'Team')"
-npx framer-dalton -s 1 -e "state.teamItems = await state.collections.find(c => c.name === 'Team').getItems()"
+```js
+// /tmp/framer-1.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
 ```
 
 Store anything you'll reference again.
@@ -132,55 +144,10 @@ After session creation, load the dynamically created project-scoped skill `frame
 
 ## Execute Code
 
-```bash
-npx framer-dalton -s <sessionId> -e "<code>"
-```
-
-**Escaping:** For code containing `$` (e.g. `$control__` properties), HTML, or nested quotes, use a heredoc (see below). `-e "..."` works for everything else, including multiline.
-
-**Examples:**
-
-```bash
-# Fetch collections and store in state (always store results you'll reuse)
-npx framer-dalton -s 1 -e "state.collections = await framer.getCollections(); console.log(state.collections.map(c => c.name))"
-
-# Use stored data in subsequent calls
-npx framer-dalton -s 1 -e "state.team = state.collections.find(c => c.name === 'Team')"
-npx framer-dalton -s 1 -e "state.teamItems = await state.team.getItems(); console.log(state.teamItems.length)"
-```
-
-**Multiline code with heredoc (recommended for complex strings):**
-
-For code containing HTML, quotes, or special characters, use a heredoc to avoid escaping issues:
+Write your code to `framer-<sessionId>.js` in the OS temp directory and execute with `-f`:
 
 ```bash
-npx framer-dalton -s 1 <<'EOF'
-const translations = {
-  "node-id": "<h2>Ship's Treasures</h2>",
-  "other-id": "<p>Text with "quotes" and <tags></p>"
-};
-await framer.setLocalizationData({ valuesBySource: translations });
-EOF
-```
-
-The `<<'EOF'` syntax (with quotes around EOF) prevents shell interpolation.
-
-**Alternative: pipe from file:**
-
-```bash
-cat script.js | npx framer-dalton -s 1
-```
-
-**Multiline inline code:**
-
-```bash
-npx framer-dalton -s 1 -e "
-const collections = await framer.getCollections();
-for (const c of collections) {
-  const items = await c.getItems();
-  console.log(c.name, items.length);
-}
-"
+npx framer-dalton -s <sessionId> -f /tmp/framer-<sessionId>.js
 ```
 
 ## API Documentation

package/package.json

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