framer-dalton 0.0.4 → 0.0.6

package/dist/cli.js

@@ -1,34 +1,34 @@
 #!/usr/bin/env node
+import path3 from 'path';
 import { Command } from 'commander';
-import fs, { readFileSync } from 'fs';
+import fs2 from 'fs';
 import os from 'os';
-import path, { dirname, join } from 'path';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.4 */
+/* @framer/ai CLI v0.0.6 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path3.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path.join(process.env.APPDATA || os.homedir(), "framer");
+    return path3.join(process.env.APPDATA || os.homedir(), "framer");
   }
-  return path.join(os.homedir(), ".config", "framer");
+  return path3.join(os.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function getCredentialsPath() {
-  return path.join(getConfigDir(), "credentials.json");
+  return path3.join(getConfigDir(), "credentials.json");
 }
 __name(getCredentialsPath, "getCredentialsPath");
 function readCredentials() {
   const credPath = getCredentialsPath();
   try {
-    if (fs.existsSync(credPath)) {
-      return JSON.parse(fs.readFileSync(credPath, "utf-8"));
+    if (fs2.existsSync(credPath)) {
+      return JSON.parse(fs2.readFileSync(credPath, "utf-8"));
     }
   } catch {
   }
@@ -38,10 +38,10 @@ __name(readCredentials, "readCredentials");
 function writeCredentials(creds) {
   const credPath = getCredentialsPath();
   const configDir = getConfigDir();
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true, mode: 448 });
+  if (!fs2.existsSync(configDir)) {
+    fs2.mkdirSync(configDir, { recursive: true, mode: 448 });
   }
-  fs.writeFileSync(credPath, JSON.stringify(creds, null, "	"), {
+  fs2.writeFileSync(credPath, JSON.stringify(creds, null, "	"), {
     mode: 384
   });
 }
@@ -1412,7 +1412,7 @@ var types = {
     name: "Control",
     description: "",
     kind: "alias",
-    alias: "EnumControl | BooleanControl | BorderControl | ShadowControl | DateControl | NumberControl | TransitionControl | StringControl | ColorControl | FormattedTextControl | LinkControl | LinkRelControl | FontControl | PageScopeControl | ScrollSectionControl | CustomCursorControl | CursorControl | FileControl | GapControl | PaddingControl | BorderRadiusControl | CollectionReferenceControl | MultiCollectionReferenceControl | VectorSetItemControl | TrackingIdControl | ImageControl | FusedNumberControl | ObjectControl | ArrayControl | EventHandlerControl | SlotControl",
+    alias: "EnumControl | BooleanControl | BorderControl | ShadowControl | DateControl | NumberControl | TransitionControl | StringControl | ColorControl | FormattedTextControl | LinkControl | LinkRelControl | FontControl | PageScopeControl | ScrollSectionControl | CustomCursorControl | CursorControl | FileControl | GapControl | PaddingControl | BorderRadiusControl | CollectionReferenceControl | MultiCollectionReferenceControl | VectorSetItemControl | TrackingIdControl | ImageControl | FusedNumberControl | ObjectControl | ArrayControl | EventHandlerControl | SlotControl | LocationControl",
     references: [
       "EnumControl",
       "BooleanControl",
@@ -1444,7 +1444,8 @@ var types = {
       "ObjectControl",
       "ArrayControl",
       "EventHandlerControl",
-      "SlotControl"
+      "SlotControl",
+      "LocationControl"
     ]
   },
   controlattributes: {
@@ -1461,6 +1462,26 @@ var types = {
     references: ["WithKey"],
     extends: ["WithKey", "Partial", "Partial"]
   },
+  coordinate: {
+    name: "Coordinate",
+    description: "",
+    kind: "interface",
+    references: [],
+    members: [
+      {
+        name: "latitude",
+        type: "number",
+        description: "",
+        optional: false
+      },
+      {
+        name: "longitude",
+        type: "number",
+        description: "",
+        optional: false
+      }
+    ]
+  },
   createarrayfield: {
     name: "CreateArrayField",
     description: "",
@@ -1803,6 +1824,50 @@ var types = {
     references: ["WithLinkVariableType", "CreateVariableBase"],
     extends: ["WithLinkVariableType", "CreateVariableBase"]
   },
+  createlocaleinput: {
+    name: "CreateLocaleInput",
+    description: "Input for creating a new locale.\n@alpha",
+    kind: "interface",
+    references: ["LocaleId"],
+    members: [
+      {
+        name: "language",
+        type: "string",
+        description: 'The language code (e.g., "en", "fr", "zh-Hans"). Use `getLocaleLanguages()` to get the list of valid codes.',
+        optional: false
+      },
+      {
+        name: "region",
+        type: "string",
+        description: 'The optional region code (e.g., "US", "CA"). Use `getLocaleRegions(language)` to get the list of valid codes.',
+        optional: true
+      },
+      {
+        name: "fallbackLocaleId",
+        type: "LocaleId",
+        description: "ID of the fallback locale. Must reference an existing locale.",
+        optional: true
+      },
+      {
+        name: "slug",
+        type: "string",
+        description: 'URL slug for the locale (e.g., "en"). If not provided, one is derived from the code.',
+        optional: true
+      },
+      {
+        name: "name",
+        type: "string",
+        description: 'Display Name for the locale (e.g., "English (US)"). If not provided, one is derived from the code.',
+        optional: true
+      },
+      {
+        name: "draft",
+        type: "boolean",
+        description: "Flag to mark the locale as a draft. Defaults to `false`.",
+        optional: true
+      }
+    ]
+  },
   createmulticollectionreferencefield: {
     name: "CreateMultiCollectionReferenceField",
     description: "",
@@ -4319,6 +4384,53 @@ var types = {
     alias: '{\n    action: "set";\n    value: string;\n    needsReview?: boolean;\n} | {\n    action: "clear";\n} | {\n    action: "ignore";\n    needsReview?: boolean;\n}',
     references: []
   },
+  location: {
+    name: "Location",
+    description: "",
+    kind: "interface",
+    references: ["Coordinate"],
+    members: [
+      {
+        name: "coordinate",
+        type: "Coordinate",
+        description: "",
+        optional: false
+      },
+      {
+        name: "title",
+        type: "string",
+        description: 'Place name, e.g. "Eiffel Tower" or "Framer".',
+        optional: true
+      },
+      {
+        name: "address",
+        type: "string",
+        description: 'Formatted address string, e.g. "Rozengracht 207, 1016 LZ Amsterdam, Netherlands".',
+        optional: true
+      }
+    ]
+  },
+  locationcontrol: {
+    name: "LocationControl",
+    description: "",
+    kind: "interface",
+    references: ["ControlBase", "Location"],
+    members: [
+      {
+        name: "type",
+        type: '"location"',
+        description: "",
+        optional: false
+      },
+      {
+        name: "value",
+        type: "Location | undefined",
+        description: "",
+        optional: true
+      }
+    ],
+    extends: ["ControlBase"]
+  },
   managedarrayfieldinput: {
     name: "ManagedArrayFieldInput",
     description: "",
@@ -5254,6 +5366,24 @@ var types = {
         description: "",
         optional: false
       },
+      {
+        name: "createLocale",
+        type: "(input: CreateLocaleInput) => Promise<Locale>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getLocaleLanguages",
+        type: "() => Promise<{\n        code: string;\n        name: string;\n    }[]>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getLocaleRegions",
+        type: "(language: string) => Promise<{\n        code: string;\n        name: string;\n        isCommon: boolean;\n    }[]>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "unstable_ensureMinimumDependencyVersion",
         type: 'FramerPluginAPI["unstable_ensureMinimumDependencyVersion"]',
@@ -6058,6 +6188,30 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "getAgentSystemPrompt",
+        type: "() => Promise<string>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getAgentContext",
+        type: "(options?: {\n        pagePath?: string;\n    }) => Promise<string>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "readProjectForAgent",
+        type: "(queries: Record<string, unknown>[], options?: {\n        pagePath?: string;\n    }) => Promise<{\n        results: unknown[];\n    }>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "applyAgentChanges",
+        type: "(dsl: string, options?: {\n        pagePath?: string;\n    }) => Promise<void>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "[getAiServiceInfoMessageType]",
         type: "() => Promise<AiServiceInfo>",
@@ -11648,6 +11802,34 @@ var methodsByCategory = {
     }
   ],
   framer: [
+    {
+      name: "[$framerApiOnly.applyAgentChanges]",
+      category: "framer",
+      signature: "[$framerApiOnly.applyAgentChanges](dsl: string, options?: { pagePath?: string; }): Promise<void>",
+      description: 'Applies commands to the canvas to create, update, remove, move, or duplicate nodes.\n\nThe command syntax is documented in the string returned by {@link getAgentSystemPrompt}.\nEach call is scoped to a single page.\n\n@param dsl - A string of commands separated by `;`. See {@link getAgentSystemPrompt} for syntax.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getAgentContext]",
+      category: "framer",
+      signature: "[$framerApiOnly.getAgentContext](options?: { pagePath?: string; }): Promise<string>",
+      description: 'Returns the dynamic project context as a string.\n\nThe context includes project-specific data:\n- **Available fonts** \u2014 font families loaded in the project.\n- **Components** \u2014 component names and their controls.\n- **Design tokens** \u2014 color tokens defined in the project.\n- **Style presets** \u2014 text style presets defined in the project.\n- **Icon sets** \u2014 available icon sets and their definitions.\n\nThis data changes per project and page. Pair with the static prompt\nfrom {@link getAgentSystemPrompt} for complete agent context.\n\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns A string containing the project context.',
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.getAgentSystemPrompt]",
+      category: "framer",
+      signature: "[$framerApiOnly.getAgentSystemPrompt](): Promise<string>",
+      description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
+      references: []
+    },
+    {
+      name: "[$framerApiOnly.readProjectForAgent]",
+      category: "framer",
+      signature: "[$framerApiOnly.readProjectForAgent](queries: Record<string, unknown>[], options?: { pagePath?: string; }): Promise<{ results: unknown[]; }>",
+      description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
+      references: []
+    },
     {
       name: "[$framerInternal.initialState]",
       category: "framer",
@@ -11728,6 +11910,13 @@ var methodsByCategory = {
       description: "Add a new text node to the canvas.",
       references: ["AddTextOptions"]
     },
+    {
+      name: "applyAgentChanges",
+      category: "framer",
+      signature: "applyAgentChanges(dsl: string, options?: { pagePath?: string; }): Promise<void>",
+      description: 'Applies commands to the canvas to create, update, remove, move, or duplicate nodes.\n\nThe command syntax is documented in the string returned by {@link getAgentSystemPrompt}.\nEach call is scoped to a single page.\n\n@param dsl - A string of commands separated by `;`. See {@link getAgentSystemPrompt} for syntax.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.',
+      references: []
+    },
     {
       name: "cloneNode",
       category: "framer",
@@ -11777,6 +11966,13 @@ var methodsByCategory = {
       description: "Create a new node on the canvas.",
       references: ["EditableFrameNodeAttributes", "FrameNode"]
     },
+    {
+      name: "createLocale",
+      category: "framer",
+      signature: "createLocale(input: CreateLocaleInput): Promise<Locale>",
+      description: "Create a new locale in the project.\n\n@alpha\n@param input - The locale configuration, use `getLocaleLanguages` and `getLocaleRegions` to get valid language and region codes.\n@returns The created locale.",
+      references: ["CreateLocaleInput", "Locale"]
+    },
     {
       name: "createManagedCollection",
       category: "framer",
@@ -11826,6 +12022,20 @@ var methodsByCategory = {
       description: "",
       references: []
     },
+    {
+      name: "getAgentContext",
+      category: "framer",
+      signature: "getAgentContext(options?: { pagePath?: string; }): Promise<string>",
+      description: 'Returns the dynamic project context as a string.\n\nThe context includes project-specific data:\n- **Available fonts** \u2014 font families loaded in the project.\n- **Components** \u2014 component names and their controls.\n- **Design tokens** \u2014 color tokens defined in the project.\n- **Style presets** \u2014 text style presets defined in the project.\n- **Icon sets** \u2014 available icon sets and their definitions.\n\nThis data changes per project and page. Pair with the static prompt\nfrom {@link getAgentSystemPrompt} for complete agent context.\n\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns A string containing the project context.',
+      references: []
+    },
+    {
+      name: "getAgentSystemPrompt",
+      category: "framer",
+      signature: "getAgentSystemPrompt(): Promise<string>",
+      description: "Returns the static agent system prompt as a string.\n\nThe prompt includes:\n- **Command reference** \u2014 syntax for adding, updating, removing, moving, and duplicating nodes.\n- **Design rules** \u2014 spacing, layout, typography, and responsive design guidance.\n- **Examples** \u2014 common UI patterns expressed as commands.\n- **`readProjectForAgent` query reference** \u2014 available query types and their parameters.\n\nThis is the sole documentation for the command syntax used by {@link applyAgentChanges}\nand the query types used by {@link readProjectForAgent}.\n\nThe prompt is static and does not depend on any specific project.\nCall {@link getAgentContext} to get the project-specific context.\n\n@returns A string containing the agent system prompt.",
+      references: []
+    },
     {
       name: "getCanvasRoot",
       category: "framer",
@@ -11945,6 +12155,20 @@ var methodsByCategory = {
       description: "Get the image of the current selection or `null` if there is no image.\n\nIn `editImage` mode, this returns the image the user already has set,\nwhich your plugin can then modify.",
       references: ["ImageAsset"]
     },
+    {
+      name: "getLocaleLanguages",
+      category: "framer",
+      signature: "getLocaleLanguages(): Promise<{ code: string; name: string; }[]>",
+      description: "Get all available locale languages.\n\n@alpha\n@returns A list of language codes and their display names, sorted by name.",
+      references: []
+    },
+    {
+      name: "getLocaleRegions",
+      category: "framer",
+      signature: "getLocaleRegions(languageCode: string): Promise<{ code: string; name: string; isCommon: boolean; }[]>",
+      description: "Get all available locale regions for a given language.\n\n@alpha\n@param languageCode - The language code to get regions for. Use `getLocaleLanguages` to get valid language codes.\n@returns A list of region codes, their display names, and whether they are commonly paired with the given language.",
+      references: []
+    },
     {
       name: "getLocales",
       category: "framer",
@@ -12071,6 +12295,13 @@ var methodsByCategory = {
       description: "",
       references: ["PublishResult"]
     },
+    {
+      name: "readProjectForAgent",
+      category: "framer",
+      signature: "readProjectForAgent(queries: Record<string, unknown>[], options?: { pagePath?: string; }): Promise<{ results: unknown[]; }>",
+      description: 'Reads project state by executing an array of queries against the project.\n\nReturns one result per query. Available query types and their parameters\nare documented in the string returned by {@link getAgentSystemPrompt}.\n\n@param queries - Array of query objects. See {@link getAgentSystemPrompt} for available types.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns An object with a `results` array, one entry per query.',
+      references: []
+    },
     {
       name: "rejectAllPending",
       category: "framer",
@@ -14229,6 +14460,7 @@ __name(expandReferences, "expandReferences");
 function renderDocs(queries) {
   const lines = [];
   const errors = [];
+  const framerClass = getClass("framer");
   if (queries.length === 0) {
     queries = ["framer"];
   }
@@ -14251,6 +14483,20 @@ function renderDocs(queries) {
 ${typeDef}`);
       }
     } else {
+      if (framerClass) {
+        const method = framerClass.methods.find((m) => m.name === query);
+        if (method) {
+          if (method.description)
+            lines.push(formatDocComment(method.description));
+          lines.push(`${method.category}.${method.signature}`);
+          const seen = /* @__PURE__ */ new Set();
+          for (const typeDef of expandReferences(method.references, seen)) {
+            lines.push(`
+${typeDef}`);
+          }
+          continue;
+        }
+      }
       const classData = getClass(query);
       if (classData) {
         lines.push(
@@ -14280,8 +14526,8 @@ ${typeDef}`);
 }
 __name(renderDocs, "renderDocs");
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path.dirname(__filename$1);
-var VERSION = "0.0.4" ;
+var __dirname$1 = path3.dirname(__filename$1);
+var VERSION = "0.0.6" ;
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var client = createTRPCClient({
   links: [
@@ -14317,7 +14563,7 @@ function compareVersions(v1, v2) {
   return 0;
 }
 __name(compareVersions, "compareVersions");
-async function ensureRelayServer(options = {}) {
+async function ensureRelayServerRunning(options = {}) {
   const { logger, restartOnVersionMismatch = true } = options;
   const serverVersion = await getRelayServerVersion();
   if (serverVersion === VERSION) {
@@ -14343,7 +14589,7 @@ async function ensureRelayServer(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path.resolve(__dirname$1, "./start-relay-server.ts") : path.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path3.resolve(__dirname$1, "./start-relay-server.ts") : path3.resolve(__dirname$1, "./start-relay-server.js");
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
     [scriptPath],
@@ -14364,22 +14610,107 @@ async function ensureRelayServer(options = {}) {
   }
   throw new Error("Failed to start relay server after 5 seconds");
 }
-__name(ensureRelayServer, "ensureRelayServer");
-var __dirname2 = dirname(fileURLToPath(import.meta.url));
-var docsDir = join(__dirname2, "..", "docs");
-function readDoc(name) {
-  return readFileSync(join(docsDir, `${name}.md`), "utf-8").trimEnd();
+__name(ensureRelayServerRunning, "ensureRelayServerRunning");
+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");
+function readSkillDoc(name) {
+  return fs2.readFileSync(path3.join(skillsDocsDir, name), "utf-8").trimEnd();
+}
+__name(readSkillDoc, "readSkillDoc");
+function buildMetaSkill() {
+  return `${readSkillDoc("framer.md")}
+`;
+}
+__name(buildMetaSkill, "buildMetaSkill");
+function buildCodeComponentsSkill() {
+  return `${readSkillDoc("framer-code-components.md")}
+`;
+}
+__name(buildCodeComponentsSkill, "buildCodeComponentsSkill");
+function renderTemplate(template, values) {
+  let rendered = template;
+  for (const [key, value] of Object.entries(values)) {
+    rendered = rendered.split(`{{${key}}}`).join(value);
+  }
+  return rendered;
+}
+__name(renderTemplate, "renderTemplate");
+function toProjectSkillName(projectId) {
+  const safeProjectId = projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
+  return `framer-canvas-editing-project-${safeProjectId}`;
 }
-__name(readDoc, "readDoc");
-var skillTopics = [
-  "code-components",
-  "property-controls",
-  "component-examples"
-];
-function isSkillTopic(topic) {
-  return skillTopics.some((name) => name === topic);
+__name(toProjectSkillName, "toProjectSkillName");
+function buildProjectCanvasSkill(projectId, agentContext, canvasPrompt) {
+  const skillName = toProjectSkillName(projectId);
+  const template = readSkillDoc("framer-canvas-editing-project.md");
+  const content = `${renderTemplate(template, {
+    SKILL_NAME: skillName,
+    PROJECT_ID: projectId,
+    GENERATED_AT: (/* @__PURE__ */ new Date()).toISOString(),
+    CANVAS_PROMPT: canvasPrompt.trimEnd(),
+    AGENT_CONTEXT: agentContext.trimEnd()
+  })}
+`;
+  return { skillName, content };
 }
-__name(isSkillTopic, "isSkillTopic");
+__name(buildProjectCanvasSkill, "buildProjectCanvasSkill");
+function writeSkill(root, skillName, content) {
+  fs2.mkdirSync(root, { recursive: true });
+  const rootStat = fs2.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);
+    if (current.isSymbolicLink() || !current.isDirectory()) {
+      fs2.rmSync(skillDir, { recursive: true, force: true });
+    }
+  }
+  fs2.mkdirSync(skillDir, { recursive: true });
+  fs2.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")
+  ];
+}
+__name(getDefaultSkillRoots, "getDefaultSkillRoots");
+function installSkills(options = { type: "base" }) {
+  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
+  const skills = [
+    { name: META_SKILL_NAME, content: buildMetaSkill() },
+    {
+      name: CODE_COMPONENTS_SKILL_NAME,
+      content: buildCodeComponentsSkill()
+    }
+  ];
+  if (options.type === "project") {
+    const projectSkill = buildProjectCanvasSkill(
+      options.projectId,
+      options.agentContext,
+      options.canvasPrompt
+    );
+    skills.push({
+      name: projectSkill.skillName,
+      content: projectSkill.content
+    });
+  }
+  return skills.map((skill) => ({
+    skillName: skill.name,
+    paths: skillRoots.map(
+      (root) => writeSkill(root, skill.name, skill.content)
+    )
+  }));
+}
+__name(installSkills, "installSkills");
 
 // src/utils.ts
 function formatError(error) {
@@ -14413,8 +14744,118 @@ async function readStdin() {
   return Buffer.concat(chunks).toString("utf-8");
 }
 __name(readStdin, "readStdin");
-program.option("-s, --session <id>", "Session ID (required for code execution)").option("-e, --eval <code>", "Code to execute (or pipe via stdin)").option("--timeout <ms>", "Execution timeout in milliseconds", "30000").action(async (options) => {
-  const { session: sessionId, eval: evalCode, timeout } = options;
+function printSetupSummary(results) {
+  const skillCount = results.length;
+  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);
+      installLocations.add(root);
+    }
+  }
+  print(
+    `Installed ${skillCount} skills to ${Array.from(installLocations).sort().join(", ")}`
+  );
+}
+__name(printSetupSummary, "printSetupSummary");
+async function getAgentSystemPrompt(sessionId) {
+  const result = await client.exec.mutate({
+    sessionId,
+    code: "return await framer.getAgentSystemPrompt();",
+    cwd: process.cwd()
+  });
+  if (result.error) {
+    throw new Error(result.error);
+  }
+  const prompt = result.output.at(-1);
+  if (typeof prompt !== "string") {
+    throw new Error("Did not receive agent prompt output.");
+  }
+  return prompt;
+}
+__name(getAgentSystemPrompt, "getAgentSystemPrompt");
+async function getAgentContext(sessionId) {
+  const result = await client.exec.mutate({
+    sessionId,
+    code: "return await framer.getAgentContext({ pagePath: '/' });",
+    cwd: process.cwd()
+  });
+  if (result.error) {
+    throw new Error(result.error);
+  }
+  const context = result.output.at(-1);
+  if (typeof context !== "string") {
+    throw new Error("Did not receive agent context output.");
+  }
+  return context;
+}
+__name(getAgentContext, "getAgentContext");
+async function refreshSkillsFromSession(sessionId, projectId) {
+  try {
+    const [canvasPrompt, agentContext] = await Promise.all([
+      getAgentSystemPrompt(sessionId),
+      getAgentContext(sessionId)
+    ]);
+    installSkills({
+      type: "project",
+      canvasPrompt,
+      projectId,
+      agentContext
+    });
+  } catch (err) {
+    printError(
+      `Failed to refresh skills for session ${sessionId}: ${formatError(err)}`
+    );
+    process.exit(1);
+  }
+}
+__name(refreshSkillsFromSession, "refreshSkillsFromSession");
+function resolveSessionCredentials(projectUrl, apiKeyArg) {
+  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);
+    }
+    saveApiKey(projectId, apiKeyArg);
+    return { projectId, apiKey: apiKeyArg };
+  } 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);
+  }
+}
+__name(createSession, "createSession");
+async function ensureRelayForCli() {
+  try {
+    await ensureRelayServerRunning({ logger: { log: print } });
+  } catch (err) {
+    printError(`Failed to check relay status: ${formatError(err)}`);
+    process.exit(1);
+  }
+}
+__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;
   let code = evalCode;
   if (!code && !process.stdin.isTTY) {
     code = await readStdin();
@@ -14430,12 +14871,11 @@ program.option("-s, --session <id>", "Session ID (required for code execution)")
     );
     process.exit(1);
   }
+  await ensureRelayForCli();
   try {
-    await ensureRelayServer({ logger: { log: print } });
     const result = await client.exec.mutate({
       sessionId: String(sessionId),
       code,
-      timeout: parseInt(timeout, 10),
       cwd: process.cwd()
     });
     for (const line of result.output) {
@@ -14452,36 +14892,18 @@ 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) => {
-  try {
-    const projectId = extractProjectId(projectUrlArg);
-    let apiKey = apiKeyArg;
-    if (!apiKey) {
-      const cached = getApiKey(projectId);
-      if (cached) {
-        apiKey = cached;
-      } else {
-        printError("No API key provided and none cached for this project.");
-        printError("");
-        printError("Usage: framer session new <projectUrl> <apiKey>");
-        process.exit(1);
-      }
-    } else {
-      saveApiKey(projectId, apiKey);
-    }
-    await ensureRelayServer({ logger: { log: print } });
-    const result = await client.createSession.mutate({
-      projectId,
-      apiKey
-    });
-    print(result.id);
-  } catch (err) {
-    printError(`Failed to create session: ${formatError(err)}`);
-    process.exit(1);
-  }
+  const { projectId, apiKey } = resolveSessionCredentials(
+    projectUrlArg,
+    apiKeyArg
+  );
+  await ensureRelayForCli();
+  const sessionId = await createSession(projectId, apiKey);
+  await refreshSkillsFromSession(sessionId, projectId);
+  print(sessionId);
 });
 session.command("list").description("List all active sessions").action(async () => {
+  await ensureRelayForCli();
   try {
-    await ensureRelayServer({ logger: { log: print } });
     const sessions = await client.listSessions.query();
     if (sessions.length === 0) {
       print("No active sessions");
@@ -14494,8 +14916,8 @@ session.command("list").description("List all active sessions").action(async ()
   }
 });
 session.command("destroy <sessionId>").description("Destroy a session").action(async (sessionId) => {
+  await ensureRelayForCli();
   try {
-    await ensureRelayServer({ logger: { log: print } });
     await client.destroySession.mutate({ sessionId });
     print(`Session ${sessionId} destroyed`);
   } catch (err) {
@@ -14519,24 +14941,18 @@ relay.command("restart").description("Restart the relay server").action(async ()
   } catch {
   }
   await new Promise((resolve) => setTimeout(resolve, 500));
-  await ensureRelayServer({ logger: { log: print } });
+  await ensureRelayForCli();
 });
-program.command("skill [topic]").description("Output skill documentation").action((topic) => {
-  if (!topic) {
-    print(readDoc("server-api"));
-    print("");
-    print(readDoc("all-skills"));
-    return;
-  }
-  if (!isSkillTopic(topic)) {
-    const available = ["(no argument)", ...skillTopics];
-    printError(`Unknown skill topic: ${topic}`);
-    printError(`Available topics: ${available.join(", ")}`);
+program.command("setup").description(
+  "Install Framer skills into ~/.agents/skills and ~/.claude/skills"
+).action(() => {
+  try {
+    const results = installSkills();
+    printSetupSummary(results);
+  } catch (err) {
+    printError(`Setup failed: ${formatError(err)}`);
     process.exit(1);
   }
-  print(readDoc(topic));
-  print("");
-  print(readDoc("all-skills"));
 });
 program.command("docs [queries...]").description(
   "Look up API documentation. Use: docs, docs ClassName, docs Class.method, or docs TypeName"