framer-dalton 0.0.6 → 0.0.8

package/dist/cli.js

@@ -3,11 +3,12 @@ import path3 from 'path';
 import { Command } from 'commander';
 import fs2 from 'fs';
 import os from 'os';
+import { z } from 'zod';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.6 */
+/* @framer/ai CLI v0.0.8 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function getConfigDir() {
@@ -20,32 +21,92 @@ function getConfigDir() {
   return path3.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
-function getCredentialsPath() {
+function getProjectsConfigPath() {
+  return path3.join(getConfigDir(), "projects.json");
+}
+__name(getProjectsConfigPath, "getProjectsConfigPath");
+function getLegacyCredentialsPath() {
   return path3.join(getConfigDir(), "credentials.json");
 }
-__name(getCredentialsPath, "getCredentialsPath");
-function readCredentials() {
-  const credPath = getCredentialsPath();
+__name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
+var ProjectsConfigSchema = z.object({
+  version: z.literal(2),
+  projects: z.record(
+    z.string(),
+    z.object({
+      apiKey: z.string(),
+      name: z.string().optional(),
+      lastUsedAt: z.string().optional()
+    })
+  )
+});
+var LegacyCredentialsSchema = z.record(z.string(), z.string());
+function readJsonFile(filePath) {
+  if (!fs2.existsSync(filePath)) {
+    return null;
+  }
   try {
-    if (fs2.existsSync(credPath)) {
-      return JSON.parse(fs2.readFileSync(credPath, "utf-8"));
-    }
-  } catch {
+    return JSON.parse(fs2.readFileSync(filePath, "utf-8"));
+  } catch (_error) {
+    return null;
   }
-  return {};
 }
-__name(readCredentials, "readCredentials");
-function writeCredentials(creds) {
-  const credPath = getCredentialsPath();
+__name(readJsonFile, "readJsonFile");
+function ensureConfigDir() {
   const configDir = getConfigDir();
   if (!fs2.existsSync(configDir)) {
     fs2.mkdirSync(configDir, { recursive: true, mode: 448 });
   }
-  fs2.writeFileSync(credPath, JSON.stringify(creds, null, "	"), {
-    mode: 384
-  });
 }
-__name(writeCredentials, "writeCredentials");
+__name(ensureConfigDir, "ensureConfigDir");
+function writeProjectsConfig(config) {
+  ensureConfigDir();
+  fs2.writeFileSync(
+    getProjectsConfigPath(),
+    JSON.stringify(config, null, "	"),
+    {
+      mode: 384
+    }
+  );
+}
+__name(writeProjectsConfig, "writeProjectsConfig");
+function readLegacyCredentials() {
+  const legacyPath = getLegacyCredentialsPath();
+  const parsed = readJsonFile(legacyPath);
+  const result = LegacyCredentialsSchema.safeParse(parsed);
+  if (!result.success) {
+    return {};
+  }
+  return result.data;
+}
+__name(readLegacyCredentials, "readLegacyCredentials");
+function migrateLegacyCredentials() {
+  const legacyCreds = readLegacyCredentials();
+  const projects = {};
+  for (const [projectId, apiKey] of Object.entries(legacyCreds)) {
+    projects[projectId] = { apiKey };
+  }
+  const config = { version: 2, projects };
+  writeProjectsConfig(config);
+  fs2.rmSync(getLegacyCredentialsPath(), { force: true });
+  return config;
+}
+__name(migrateLegacyCredentials, "migrateLegacyCredentials");
+function readProjectsConfig() {
+  const projectsPath = getProjectsConfigPath();
+  const parsed = readJsonFile(projectsPath);
+  if (parsed !== null) {
+    const result = ProjectsConfigSchema.safeParse(parsed);
+    if (result.success) {
+      return result.data;
+    }
+  }
+  if (fs2.existsSync(getLegacyCredentialsPath())) {
+    return migrateLegacyCredentials();
+  }
+  return { version: 2, projects: {} };
+}
+__name(readProjectsConfig, "readProjectsConfig");
 function extractProjectId(input) {
   if (/^[a-zA-Z0-9]+$/.test(input)) {
     return input;
@@ -54,20 +115,40 @@ function extractProjectId(input) {
   if (match) {
     return match[1];
   }
+  const slugMatch = input.match(/^(?:.+--)?([a-zA-Z0-9]+)(?:-[a-zA-Z0-9]+)?$/);
+  if (slugMatch) {
+    return slugMatch[1];
+  }
   return input;
 }
 __name(extractProjectId, "extractProjectId");
+function listProjects() {
+  const config = readProjectsConfig();
+  return Object.entries(config.projects).map(([projectId, project2]) => ({
+    projectId,
+    ...project2
+  })).sort((a, b) => {
+    const left = a.lastUsedAt ?? "";
+    const right = b.lastUsedAt ?? "";
+    return right.localeCompare(left);
+  });
+}
+__name(listProjects, "listProjects");
 function getApiKey(projectId) {
-  const creds = readCredentials();
-  return creds[projectId] || null;
+  const config = readProjectsConfig();
+  return config.projects[projectId]?.apiKey ?? null;
 }
 __name(getApiKey, "getApiKey");
-function saveApiKey(projectId, apiKey) {
-  const creds = readCredentials();
-  creds[projectId] = apiKey;
-  writeCredentials(creds);
+function saveProject(project2) {
+  const config = readProjectsConfig();
+  config.projects[project2.projectId] = {
+    apiKey: project2.apiKey,
+    name: project2.name,
+    lastUsedAt: project2.lastUsedAt
+  };
+  writeProjectsConfig(config);
 }
-__name(saveApiKey, "saveApiKey");
+__name(saveProject, "saveProject");
 
 // src/types-data.ts
 var types = {
@@ -14527,7 +14608,7 @@ ${typeDef}`);
 __name(renderDocs, "renderDocs");
 var __filename$1 = fileURLToPath(import.meta.url);
 var __dirname$1 = path3.dirname(__filename$1);
-var VERSION = "0.0.6" ;
+var VERSION = "0.0.8" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -14811,40 +14892,42 @@ async function refreshSkillsFromSession(sessionId, projectId) {
   }
 }
 __name(refreshSkillsFromSession, "refreshSkillsFromSession");
-function resolveSessionCredentials(projectUrl, apiKeyArg) {
+function resolveSessionCredentials(projectUrlOrId, apiKey) {
   try {
-    const projectId = extractProjectId(projectUrl);
-    if (!apiKeyArg) {
-      const cachedApiKey = getApiKey(projectId);
-      if (cachedApiKey) {
-        return { projectId, apiKey: cachedApiKey };
-      }
-      printError("No API key provided and none cached for this project.");
-      printError("");
-      printError("Usage: framer session new <projectUrl> <apiKey>");
-      process.exit(1);
+    const projectId = extractProjectId(projectUrlOrId);
+    if (apiKey) {
+      return { projectId, apiKey };
     }
-    saveApiKey(projectId, apiKeyArg);
-    return { projectId, apiKey: apiKeyArg };
+    const cachedApiKey = getApiKey(projectId);
+    if (cachedApiKey) {
+      return { projectId, apiKey: cachedApiKey };
+    }
+    printError("No API key provided and none cached for this project.");
+    printError("");
+    printError("Usage: framer session new <projectUrl> <apiKey>");
+    process.exit(1);
   } catch (err) {
     printError(`Failed to create session: ${formatError(err)}`);
     process.exit(1);
   }
 }
 __name(resolveSessionCredentials, "resolveSessionCredentials");
-async function createSession(projectId, apiKey) {
-  try {
-    const result = await client.createSession.mutate({
-      projectId,
-      apiKey
-    });
-    return result.id;
-  } catch (err) {
-    printError(`Failed to create session: ${formatError(err)}`);
-    process.exit(1);
+async function getProjectName(sessionId) {
+  const result = await client.exec.mutate({
+    sessionId,
+    code: "return (await framer.getProjectInfo()).name;",
+    cwd: process.cwd()
+  });
+  if (result.error) {
+    throw new Error(result.error);
+  }
+  const projectName = result.output.at(-1);
+  if (typeof projectName !== "string") {
+    throw new Error("Did not receive project name output.");
   }
+  return projectName;
 }
-__name(createSession, "createSession");
+__name(getProjectName, "getProjectName");
 async function ensureRelayForCli() {
   try {
     await ensureRelayServerRunning({ logger: { log: print } });
@@ -14891,15 +14974,30 @@ program.option("-s, --session <id>", "Session ID (required for code execution)")
   }
 });
 var session = program.command("session").description("Manage sessions");
-session.command("new <projectUrl> [apiKey]").description("Create a new session and print the session ID").action(async (projectUrlArg, apiKeyArg) => {
-  const { projectId, apiKey } = resolveSessionCredentials(
-    projectUrlArg,
-    apiKeyArg
-  );
+session.command("new <projectUrlOrId> [apiKey]").description("Create a new session and print the session ID").action(async (projectUrlOrId, apiKey) => {
+  const credentials = resolveSessionCredentials(projectUrlOrId, apiKey);
   await ensureRelayForCli();
-  const sessionId = await createSession(projectId, apiKey);
-  await refreshSkillsFromSession(sessionId, projectId);
-  print(sessionId);
+  try {
+    const result = await client.createSession.mutate({
+      projectId: credentials.projectId,
+      apiKey: credentials.apiKey
+    });
+    const sessionId = result.id;
+    const [projectName] = await Promise.all([
+      getProjectName(sessionId),
+      refreshSkillsFromSession(sessionId, credentials.projectId)
+    ]);
+    saveProject({
+      projectId: credentials.projectId,
+      apiKey: credentials.apiKey,
+      name: projectName,
+      lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    print(sessionId);
+  } catch (err) {
+    printError(`Failed to create session: ${formatError(err)}`);
+    process.exit(1);
+  }
 });
 session.command("list").description("List all active sessions").action(async () => {
   await ensureRelayForCli();
@@ -14915,6 +15013,16 @@ session.command("list").description("List all active sessions").action(async ()
     process.exit(1);
   }
 });
+var project = program.command("project").description("Manage projects");
+project.command("list").description("List recently used projects").action(() => {
+  printJson(
+    listProjects().map(({ projectId, name, lastUsedAt }) => ({
+      projectId,
+      name,
+      lastUsedAt
+    }))
+  );
+});
 session.command("destroy <sessionId>").description("Destroy a session").action(async (sessionId) => {
   await ensureRelayForCli();
   try {

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.6 */
+/* @framer/ai relay server v0.0.8 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function getLogPath() {
@@ -50,7 +50,7 @@ function log(message) {
 __name(log, "log");
 var __filename$1 = fileURLToPath(import.meta.url);
 path.dirname(__filename$1);
-var VERSION = "0.0.6" ;
+var VERSION = "0.0.8" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 createTRPCClient({
   links: [

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

@@ -1,6 +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:*)"]
 ---
 
 ## Project Scope
@@ -20,12 +21,8 @@ description: "Project-scoped Framer canvas editing skill for project {{PROJECT_I
 - 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`).
 - Regenerate the embedded prompt and context by running `session new` again for the same project.
-- Node IDs assigned during commands are temporary and can only be referenced within the same `framer.applyAgentChanges` call. For later calls, re-read the project to get real IDs.
-- For rich text updates, default to `SET <RichTextNode-id> text="..."` for normal text replacement. Use `SET <TextRun-id> text="..."` only for intentional targeted run-level edits in multi-run content.
-- Child `TextRun` IDs are stable within one `applyAgentChanges` batch, but may change across batches or turns after re-hydration. Re-read before dependent follow-up commands in a new batch.
 - In rich text, block-level properties (for example line height or alignment) belong on block or parent targets, not `TextRun` targets.
 - `IconNode` `$control__icon` is immutable after creation. To change it, delete and recreate the node with the desired icon value.
-- `var(--token-<id>)` requires stable token IDs. Temporary IDs are only reliable within the same `applyAgentChanges` batch. If a token was created in a previous batch, re-read state to get its current real ID before referencing it, or create the token and dependents in one batch.
 
 ## Workflow Loop
 

package/docs/skills/framer.md

@@ -1,10 +1,12 @@
 ---
 name: framer
-description: "Single entry point for Framer tasks. Mandatory precondition: run `npx framer-dalton@latest setup` and let it complete BEFORE loading this skill."
+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:*)"]
 ---
 
 If you didn't run this command before loading the skill, run it now:
-
 ```bash
 npx framer-dalton@latest setup
 ```
@@ -32,11 +34,19 @@ Every task follows these steps:
 
 #### 1. Connect (once per session)
 
-Ask for the Project URL, then create a session:
+If the user refers to a project by name or description rather than giving a URL, first inspect the recent projects:
+
+```bash
+npx framer-dalton project list
+```
+
+Use that list to infer the likely project from the names and recency. If the right project is already known, use its project ID with `session new`. If there are multiple possible matches, clarify with the user. Only ask the user for a Project URL if there is no clear match. Avoid talking about the technical contents of returned data like IDs.
+
+Create a session:
 
 ```bash
-npx framer-dalton session new "<projectUrl>"           # Uses cached API key
-npx framer-dalton session new "<projectUrl>" "<apiKey>" # First time: needs API key (Project Settings > General > API Keys)
+npx framer-dalton session new "<url or id>"           # Uses cached API key
+npx framer-dalton session new "<url or id>" "<apiKey>" # First time: needs API key (Project Settings > General > API Keys)
 ```
 
 #### 2. Look up the API (before EVERY code execution)
@@ -192,7 +202,10 @@ npx framer-dalton docs ScreenshotOptions          # Show type + recursively expa
 
 ### Working with Collections (CMS)
 
-Collections are Framer's CMS. Each collection has fields (columns) and items (rows).
+Collections are Framer's CMS. Each collection has fields (columns) and items (rows). There are two types:
+
+- **Unmanaged** (`framer.createCollection()`): Users can freely edit these in the Framer UI. Always use this by default.
+- **Managed** (`framer.createManagedCollection()`): Can ONLY be edited via the API. They appear read-only in the Framer UI. Only use managed collections when explicitly asked or when creating a script for data synchronisation.
 
 #### Reading Collections
 
@@ -257,8 +270,6 @@ await item.remove();
 
 #### Managed Collections
 
-Managed collections are fully controlled by code - users can't edit them directly. Use for syncing external data sources.
-
 ```js
 // Create a managed collection
 const managed = await framer.createManagedCollection({ name: "My Sync" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framer-dalton",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "bin": {
     "framer-dalton": "./dist/cli.js"
@@ -25,7 +25,7 @@
     "@trpc/client": "^11.9.0",
     "@trpc/server": "^11.9.0",
     "commander": "^12.1.0",
-    "framer-api": "https://pkg.pr.new/framer/FramerStudio/framer-api@5804b52.tgz",
+    "framer-api": "https://pkg.pr.new/framer/FramerStudio/framer-api@0711174.tgz",
     "zod": "^4.3.6"
   },
   "devDependencies": {