@framer/agent 0.0.36 → 0.0.37

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import fs8 from 'fs';
-import path7 from 'path';
+import path6 from 'path';
 import { Command } from 'commander';
 import crypto, { randomUUID } from 'crypto';
 import http from 'http';
@@ -9,11 +9,11 @@ import { z } from 'zod';
 import os2 from 'os';
 import isWsl from 'is-wsl';
 import { ErrorCode, FramerAPIError } from 'framer-api';
-import net from 'net';
 import { fileURLToPath } from 'url';
+import net from 'net';
 import { createTRPCClient, httpLink } from '@trpc/client';
 
-/* @framer/ai CLI v0.0.36 */
+/* @framer/ai CLI v0.0.37 */
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
@@ -107,12 +107,12 @@ function openUrl(url) {
 __name(openUrl, "openUrl");
 function getConfigDir() {
   if (process.env.XDG_CONFIG_HOME) {
-    return path7.join(process.env.XDG_CONFIG_HOME, "framer");
+    return path6.join(process.env.XDG_CONFIG_HOME, "framer");
   }
   if (process.platform === "win32") {
-    return path7.join(process.env.APPDATA || os2.homedir(), "framer");
+    return path6.join(process.env.APPDATA || os2.homedir(), "framer");
   }
-  return path7.join(os2.homedir(), ".config", "framer");
+  return path6.join(os2.homedir(), ".config", "framer");
 }
 __name(getConfigDir, "getConfigDir");
 function ensureConfigDir() {
@@ -123,11 +123,11 @@ __name(ensureConfigDir, "ensureConfigDir");
 
 // src/config/projects.ts
 function getProjectsConfigPath() {
-  return path7.join(getConfigDir(), "projects.json");
+  return path6.join(getConfigDir(), "projects.json");
 }
 __name(getProjectsConfigPath, "getProjectsConfigPath");
 function getLegacyCredentialsPath() {
-  return path7.join(getConfigDir(), "credentials.json");
+  return path6.join(getConfigDir(), "credentials.json");
 }
 __name(getLegacyCredentialsPath, "getLegacyCredentialsPath");
 var ProjectsConfigSchema = z.object({
@@ -313,7 +313,7 @@ var SettingsFileSchema = z.object({
   telemetryNoticeShown: z.boolean().optional()
 });
 function getSettingsPath() {
-  return path7.join(getConfigDir(), "settings.json");
+  return path6.join(getConfigDir(), "settings.json");
 }
 __name(getSettingsPath, "getSettingsPath");
 var settings;
@@ -397,7 +397,7 @@ __name(markTelemetryNoticeShown, "markTelemetryNoticeShown");
 // src/version.ts
 var VERSION = (
   // typeof is used to ensure this can be used just via tsx or node etc. without build
-  "0.0.36" 
+  "0.0.37" 
 );
 var trackingEndpoint = "https://events.framer.com/track";
 var inProgressTrackings = /* @__PURE__ */ new Set();
@@ -1174,7 +1174,7 @@ var types = {
     members: [
       {
         name: "type",
-        type: '"page" | "collection" | "designPage" | "siteSettings" | "component" | "layoutTemplate" | "vectorSet" | "codeFile"',
+        type: '"page" | "collection" | "designPage" | "siteSettings" | "component" | "layoutTemplate" | "vectorSet" | "codeFile" | "colorStyle" | "textStyle" | "linkStyle" | "blockquoteStyle" | "inlineCodeStyle" | "localization" | "localizationGlossary"',
         description: "",
         optional: false
       },
@@ -7627,6 +7627,12 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "replaceTextForAgent",
+        type: "(input: {\n        id: string;\n        searchText: string;\n        replaceText: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<boolean>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "ping",
         type: "() => Promise<void>",
@@ -7681,6 +7687,24 @@ var types = {
         description: "@alpha",
         optional: false
       },
+      {
+        name: "getDescendantsOfTypesForAgent",
+        type: "(input: {\n        id: string;\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getRectForAgent",
+        type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<Rect$1 | null>",
+        description: "@alpha",
+        optional: false
+      },
+      {
+        name: "getDescendantReferencesOfTypesForAgent",
+        type: "(input: {\n        id: string;\n        types: readonly string[];\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
+        description: "@alpha",
+        optional: false
+      },
       {
         name: "getScopeNodeForAgent",
         type: "(input: {\n        id: string;\n    }, options?: {\n        pagePath?: string;\n    }) => Promise<unknown>",
@@ -14248,6 +14272,20 @@ var methodsByCategory = {
       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. Pair with the static prompt\nfrom {@link getSystemPrompt} for complete agent context.\n\n@returns A string containing the project context.",
       references: []
     },
+    {
+      name: "getDescendantReferencesOfTypes",
+      category: "FramerAgentAPI",
+      signature: "getDescendantReferencesOfTypes(input: { id: string; types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get style and token nodes referenced by a node\'s descendants.\n\n@param input - `{ id, types }`: the ancestor node id and referenced node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The referenced nodes without their children.',
+      references: []
+    },
+    {
+      name: "getDescendantsOfTypes",
+      category: "FramerAgentAPI",
+      signature: "getDescendantsOfTypes(input: { id: string; types: readonly string[]; }, options?: { pagePath?: string; }): Promise<unknown>",
+      description: 'Get descendants of a node with one or more kinds (e.g. `"FrameNode"`, `"RichTextNode"`, `"TextRun"`).\n\n@param input - `{ id, types }`: the ancestor node id and node kinds to match.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The matching descendants without their children.',
+      references: []
+    },
     {
       name: "getGroundNode",
       category: "FramerAgentAPI",
@@ -14283,6 +14321,13 @@ var methodsByCategory = {
       description: 'Get the direct parent of a node.\n\n@param input - `{ id }`: the id of the child node.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The parent node, or `null` if the node has no parent or doesn\'t exist.',
       references: []
     },
+    {
+      name: "getRect",
+      category: "FramerAgentAPI",
+      signature: "getRect(input: { id: string; }, options?: { pagePath?: string; }): Promise<Rect$1 | null>",
+      description: 'Get the measured rect for a node.\n\n@param input - `{ id }`: the id of the node to measure.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns The rounded measured rect, or `null` if no node with that id exists on the page.',
+      references: ["Rect$1"]
+    },
     {
       name: "getScopeNode",
       category: "FramerAgentAPI",
@@ -14395,6 +14440,13 @@ var methodsByCategory = {
       description: "Renames a branch.\n\n@param branchId - Branch id to rename.\n@param title - New branch title.",
       references: []
     },
+    {
+      name: "replaceText",
+      category: "FramerAgentAPI",
+      signature: "replaceText(input: { id: string; searchText: string; replaceText: string; }, options?: { pagePath?: string; }): Promise<boolean>",
+      description: 'Replaces text within a text-like node.\n\n@param input - `{ id, searchText, replaceText }`: the target node id, text to find, and replacement text.\n@param options.pagePath - Target page path (e.g. `"/about"`). Defaults to the active page.\n@returns `true` when text was replaced, or `false` when no matching text was found.',
+      references: []
+    },
     {
       name: "reviewChanges",
       category: "FramerAgentAPI",
@@ -16618,6 +16670,391 @@ ${typeDef}`);
 }
 __name(renderDocs, "renderDocs");
 
+// src/prompt-context.ts
+function toKebabId(title) {
+  const id = title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return id || "section";
+}
+__name(toKebabId, "toKebabId");
+function uniquifyId(id, seen) {
+  const count = seen.get(id) ?? 0;
+  seen.set(id, count + 1);
+  return count === 0 ? id : `${id}-${count + 1}`;
+}
+__name(uniquifyId, "uniquifyId");
+function splitPromptSections(markdown) {
+  const normalized = markdown.replaceAll("\r\n", "\n");
+  if (normalized.trim() === "") {
+    throw new Error("Cannot split an empty agent prompt.");
+  }
+  const sections = [];
+  let current;
+  for (const line of normalized.split("\n")) {
+    const heading = line.match(/^#\s+(.+?)\s*#*\s*$/u);
+    if (heading) {
+      current = { title: heading[1].trim(), lines: [] };
+      sections.push(current);
+      continue;
+    }
+    if (!current) {
+      current = { title: "Preamble", lines: [] };
+      sections.push(current);
+    }
+    current.lines.push(line);
+  }
+  const seen = /* @__PURE__ */ new Map();
+  return sections.map((section) => ({
+    id: uniquifyId(toKebabId(section.title), seen),
+    title: section.title,
+    content: section.lines.join("\n").trim()
+  })).filter(
+    (section) => section.title !== "Preamble" || section.content !== ""
+  );
+}
+__name(splitPromptSections, "splitPromptSections");
+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 writeRenderedFile(filePath, content) {
+  fs8.mkdirSync(path6.dirname(filePath), { recursive: true });
+  fs8.writeFileSync(filePath, `${content.trimEnd()}
+`, "utf-8");
+}
+__name(writeRenderedFile, "writeRenderedFile");
+function isTextFile(filePath) {
+  const extension = path6.extname(filePath).toLowerCase();
+  return [
+    ".css",
+    ".html",
+    ".js",
+    ".json",
+    ".md",
+    ".mjs",
+    ".ts",
+    ".tsx",
+    ".txt",
+    ".yaml",
+    ".yml"
+  ].includes(extension);
+}
+__name(isTextFile, "isTextFile");
+function renderFileTree(sourceDir, destinationDir, options) {
+  for (const entry of fs8.readdirSync(sourceDir, { withFileTypes: true })) {
+    const sourcePath = path6.join(sourceDir, entry.name);
+    const destinationPath = path6.join(destinationDir, entry.name);
+    if (entry.isDirectory()) {
+      fs8.mkdirSync(destinationPath, { recursive: true });
+      renderFileTree(sourcePath, destinationPath, options);
+      continue;
+    }
+    if (entry.isSymbolicLink()) {
+      throw new Error(options.getSymlinkErrorMessage(sourcePath));
+    }
+    const renderedDestinationPath = options.getRenderedDestinationPath({
+      sourcePath,
+      destinationPath
+    });
+    if (renderedDestinationPath) {
+      const renderedContent = renderTemplate(
+        fs8.readFileSync(sourcePath, "utf-8"),
+        options.templateValues
+      );
+      writeRenderedFile(
+        renderedDestinationPath,
+        options.transformRenderedContent?.(renderedContent) ?? renderedContent
+      );
+      continue;
+    }
+    fs8.copyFileSync(sourcePath, destinationPath);
+  }
+}
+__name(renderFileTree, "renderFileTree");
+var FRAMER_TEMPORARY_DIR = path6.join(os2.tmpdir(), "framer");
+function ensureTemporaryDir() {
+  fs8.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
+}
+__name(ensureTemporaryDir, "ensureTemporaryDir");
+function cleanupStaleSessionCodeFiles(activeSessionIds) {
+  if (!fs8.existsSync(FRAMER_TEMPORARY_DIR)) return;
+  const activeSessionIdsSet = new Set(activeSessionIds);
+  for (const entry of fs8.readdirSync(FRAMER_TEMPORARY_DIR)) {
+    const [sessionId] = entry.split("-");
+    if (activeSessionIdsSet.has(sessionId)) continue;
+    const filePath = path6.join(FRAMER_TEMPORARY_DIR, entry);
+    fs8.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
+  }
+}
+__name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
+
+// src/skills.ts
+var META_SKILL_NAME = "framer";
+var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
+var __dirname$1 = path6.dirname(fileURLToPath(import.meta.url));
+var sourceSkillsDir = path6.join(__dirname$1, "..", "skills");
+var GENERATED_PROJECTS_DIR_NAME = "projects";
+var GENERATED_PROJECT_TEMPLATE_ID = "__template__";
+var PROJECT_SKILL_PREFIX = "framer-project-";
+var LEGACY_CANVAS_EDITING_SKILL_PREFIX = "framer-canvas-editing-project-";
+var PACKAGE_NAME = "@framer/agent";
+var DEFAULT_FRAMER_AGENT_COMMAND = `npx ${PACKAGE_NAME}`;
+var RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND = `npx --min-release-age=0 ${PACKAGE_NAME}`;
+function getFramerAgentCommand() {
+  return isNpxMinReleaseAgeOverrideEnabled() ? RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND : DEFAULT_FRAMER_AGENT_COMMAND;
+}
+__name(getFramerAgentCommand, "getFramerAgentCommand");
+function replaceDefaultFramerAgentCommand(content) {
+  return content.replaceAll(
+    DEFAULT_FRAMER_AGENT_COMMAND,
+    getFramerAgentCommand()
+  );
+}
+__name(replaceDefaultFramerAgentCommand, "replaceDefaultFramerAgentCommand");
+function getSkillTemplateValues(skillDir) {
+  return {
+    FRAMER_TEMPORARY_DIR,
+    FRAMER_AGENT_COMMAND: getFramerAgentCommand(),
+    FRAMER_SKILL_DIR: skillDir
+  };
+}
+__name(getSkillTemplateValues, "getSkillTemplateValues");
+function toSafeProjectId(projectId) {
+  return projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
+}
+__name(toSafeProjectId, "toSafeProjectId");
+function removeSkillDirContents(skillDir, options) {
+  for (const entry of fs8.readdirSync(skillDir, { withFileTypes: true })) {
+    const entryPath = path6.join(skillDir, entry.name);
+    if (options.preserveGeneratedProjectBundles && entry.name === GENERATED_PROJECTS_DIR_NAME && entry.isDirectory()) {
+      fs8.rmSync(path6.join(entryPath, GENERATED_PROJECT_TEMPLATE_ID), {
+        recursive: true,
+        force: true,
+        maxRetries: 2
+      });
+      continue;
+    }
+    fs8.rmSync(entryPath, { recursive: true, force: true, maxRetries: 2 });
+  }
+}
+__name(removeSkillDirContents, "removeSkillDirContents");
+function prepareSkillDir(root, skillName) {
+  fs8.mkdirSync(root, { recursive: true });
+  const rootStat = fs8.statSync(root);
+  if (!rootStat.isDirectory()) {
+    throw new Error(`Skill root is not a directory: ${root}`);
+  }
+  const skillDir = path6.join(root, skillName);
+  const current = fs8.lstatSync(skillDir, { throwIfNoEntry: false });
+  if (current && (current.isSymbolicLink() || !current.isDirectory())) {
+    fs8.rmSync(skillDir, { recursive: true, force: true });
+  }
+  if (current?.isDirectory()) {
+    removeSkillDirContents(skillDir, {
+      preserveGeneratedProjectBundles: skillName === META_SKILL_NAME
+    });
+  }
+  fs8.mkdirSync(skillDir, { recursive: true });
+  return skillDir;
+}
+__name(prepareSkillDir, "prepareSkillDir");
+function installSourceSkill(root, skillName) {
+  const sourceDir = path6.join(sourceSkillsDir, skillName);
+  const skillDir = prepareSkillDir(root, skillName);
+  renderFileTree(sourceDir, skillDir, {
+    templateValues: getSkillTemplateValues(skillDir),
+    getRenderedDestinationPath: /* @__PURE__ */ __name(({ sourcePath, destinationPath }) => isTextFile(sourcePath) ? destinationPath : void 0, "getRenderedDestinationPath"),
+    getSymlinkErrorMessage: /* @__PURE__ */ __name((sourcePath) => `Source skill contains unsupported symlink: ${sourcePath}`, "getSymlinkErrorMessage")
+  });
+  return path6.join(skillDir, "SKILL.md");
+}
+__name(installSourceSkill, "installSourceSkill");
+function cleanupLegacyCanvasEditingSkills(skillRoots = getDefaultSkillRoots()) {
+  for (const root of skillRoots) {
+    if (!fs8.existsSync(root)) continue;
+    for (const entry of fs8.readdirSync(root)) {
+      if (!entry.startsWith(LEGACY_CANVAS_EDITING_SKILL_PREFIX)) continue;
+      const skillDir = path6.join(root, entry);
+      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+    }
+  }
+}
+__name(cleanupLegacyCanvasEditingSkills, "cleanupLegacyCanvasEditingSkills");
+function getDefaultSkillRoots() {
+  const home = os2.homedir();
+  return [
+    path6.join(home, ".agents", "skills"),
+    path6.join(home, ".claude", "skills")
+  ];
+}
+__name(getDefaultSkillRoots, "getDefaultSkillRoots");
+function cleanupProjectSkills(skillRoots = getDefaultSkillRoots()) {
+  for (const root of skillRoots) {
+    if (!fs8.existsSync(root)) continue;
+    for (const entry of fs8.readdirSync(root)) {
+      if (!entry.startsWith(PROJECT_SKILL_PREFIX)) continue;
+      const skillDir = path6.join(root, entry);
+      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
+    }
+  }
+}
+__name(cleanupProjectSkills, "cleanupProjectSkills");
+function installSkills(options = { type: "base" }) {
+  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
+  const skillNames = [META_SKILL_NAME, CODE_COMPONENTS_SKILL_NAME];
+  const results = skillNames.map((skillName) => ({
+    skillName,
+    paths: skillRoots.map((root) => installSourceSkill(root, skillName))
+  }));
+  trackSkillsInstall({
+    skillType: options.type,
+    skillCount: results.length
+  });
+  return results;
+}
+__name(installSkills, "installSkills");
+
+// src/generated-project-bundle.ts
+var PROJECT_BUNDLE_SCHEMA_VERSION = 1;
+var PROJECT_TEMPLATE_ID = "__template__";
+var TEMPLATE_FILE_MARKER = ".template";
+var __dirname2 = path6.dirname(fileURLToPath(import.meta.url));
+function sha256(content) {
+  return crypto.createHash("sha256").update(content).digest("hex");
+}
+__name(sha256, "sha256");
+function renderPromptFile(section) {
+  return [`# ${section.title}`, "", section.content].join("\n");
+}
+__name(renderPromptFile, "renderPromptFile");
+function getRenderedTemplatePath(filePath) {
+  const extension = path6.extname(filePath);
+  const suffix = `${TEMPLATE_FILE_MARKER}${extension}`;
+  if (!filePath.endsWith(suffix)) return void 0;
+  return filePath.slice(0, -suffix.length) + extension;
+}
+__name(getRenderedTemplatePath, "getRenderedTemplatePath");
+function makeMetadata(options, safeProjectId) {
+  return {
+    projectId: options.projectId,
+    safeProjectId,
+    sessionId: options.sessionId,
+    generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    cliVersion: VERSION,
+    promptHash: sha256(options.agentPrompt),
+    contextHash: sha256(options.agentContext),
+    contextSchemaVersion: PROJECT_BUNDLE_SCHEMA_VERSION
+  };
+}
+__name(makeMetadata, "makeMetadata");
+function getInstalledFramerSkillDirs(skillRoots) {
+  return skillRoots.map((root) => path6.join(root, "framer")).filter((skillDir) => fs8.existsSync(path6.join(skillDir, "SKILL.md")));
+}
+__name(getInstalledFramerSkillDirs, "getInstalledFramerSkillDirs");
+function getProjectTemplateDir(skillDir) {
+  const installedTemplateDir = path6.join(
+    skillDir,
+    "projects",
+    PROJECT_TEMPLATE_ID
+  );
+  if (fs8.existsSync(installedTemplateDir)) return installedTemplateDir;
+  return path6.join(
+    __dirname2,
+    "..",
+    "skills",
+    "framer",
+    "projects",
+    PROJECT_TEMPLATE_ID
+  );
+}
+__name(getProjectTemplateDir, "getProjectTemplateDir");
+function cleanupStaleGeneratedProjectBundles(activeProjectIds, skillRoots = getDefaultSkillRoots()) {
+  const activeSafeProjectIds = new Set(activeProjectIds.map(toSafeProjectId));
+  for (const skillDir of getInstalledFramerSkillDirs(skillRoots)) {
+    const projectsDir = path6.join(skillDir, "projects");
+    if (!fs8.existsSync(projectsDir)) continue;
+    for (const entry of fs8.readdirSync(projectsDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name === PROJECT_TEMPLATE_ID) continue;
+      if (activeSafeProjectIds.has(entry.name)) continue;
+      fs8.rmSync(path6.join(projectsDir, entry.name), {
+        recursive: true,
+        force: true,
+        maxRetries: 2
+      });
+    }
+  }
+}
+__name(cleanupStaleGeneratedProjectBundles, "cleanupStaleGeneratedProjectBundles");
+function makeTemplateValues(metadata, sections, agentContext) {
+  return {
+    PROJECT_ID: metadata.projectId,
+    SAFE_PROJECT_ID: metadata.safeProjectId,
+    SESSION_ID: metadata.sessionId,
+    GENERATED_AT: metadata.generatedAt,
+    PROMPT_SECTION_LIST: sections.map((section) => `- \`prompt/${section.id}.md\` - ${section.title}`).join("\n"),
+    PROJECT_CONTEXT: agentContext,
+    READ_PROJECT_DOCS_COMMAND: replaceDefaultFramerAgentCommand(
+      "npx @framer/agent@latest docs framer.agent.readProject"
+    ),
+    READ_PROJECT_COMMAND: replaceDefaultFramerAgentCommand(
+      `npx @framer/agent@latest read-project -s ${metadata.sessionId} -p "/" -q '<queries-json>'`
+    )
+  };
+}
+__name(makeTemplateValues, "makeTemplateValues");
+function writeGeneratedProjectBundle(options) {
+  const skillRoots = options.skillRoots ?? getDefaultSkillRoots();
+  const framerSkillDirs = getInstalledFramerSkillDirs(skillRoots);
+  if (framerSkillDirs.length === 0) {
+    throw new Error(
+      "Could not find an installed framer skill. Run `@framer/agent setup` before `session new`."
+    );
+  }
+  const safeProjectId = toSafeProjectId(options.projectId);
+  if (safeProjectId === PROJECT_TEMPLATE_ID) {
+    throw new Error(`Project ID resolves to reserved template directory.`);
+  }
+  const renderedPrompt = replaceDefaultFramerAgentCommand(options.agentPrompt);
+  const renderedContext = replaceDefaultFramerAgentCommand(
+    options.agentContext
+  );
+  const sections = splitPromptSections(renderedPrompt);
+  const metadata = makeMetadata(
+    { ...options, agentPrompt: renderedPrompt, agentContext: renderedContext },
+    safeProjectId
+  );
+  const paths = [];
+  for (const skillDir of framerSkillDirs) {
+    const projectDir = path6.join(skillDir, "projects", safeProjectId);
+    const templateDir = getProjectTemplateDir(skillDir);
+    fs8.rmSync(projectDir, { recursive: true, force: true, maxRetries: 2 });
+    fs8.mkdirSync(projectDir, { recursive: true });
+    renderFileTree(templateDir, projectDir, {
+      templateValues: makeTemplateValues(metadata, sections, renderedContext),
+      getRenderedDestinationPath: /* @__PURE__ */ __name(({ sourcePath, destinationPath }) => getRenderedTemplatePath(destinationPath) ?? (isTextFile(sourcePath) ? destinationPath : void 0), "getRenderedDestinationPath"),
+      getSymlinkErrorMessage: /* @__PURE__ */ __name((sourcePath) => `Project template contains unsupported symlink: ${sourcePath}`, "getSymlinkErrorMessage"),
+      transformRenderedContent: replaceDefaultFramerAgentCommand
+    });
+    for (const section of sections) {
+      writeRenderedFile(
+        path6.join(projectDir, "prompt", `${section.id}.md`),
+        renderPromptFile(section)
+      );
+    }
+    writeRenderedFile(
+      path6.join(projectDir, "metadata.json"),
+      JSON.stringify(metadata, null, "	")
+    );
+    paths.push(projectDir);
+  }
+  return { safeProjectId, paths };
+}
+__name(writeGeneratedProjectBundle, "writeGeneratedProjectBundle");
+
 // src/headless-server-url.ts
 var PROD_HEADLESS_SERVER_URL = "wss://api.framer.com/channel/headless-plugin";
 var DEV_HEADLESS_SERVER_URL = "wss://api.development.framer.com/channel/headless-plugin";
@@ -16669,7 +17106,7 @@ function inferHeadlessServerUrl(projectUrlOrId) {
 }
 __name(inferHeadlessServerUrl, "inferHeadlessServerUrl");
 function getRelayTokenPath() {
-  return path7.join(getConfigDir(), "relay-token");
+  return path6.join(getConfigDir(), "relay-token");
 }
 __name(getRelayTokenPath, "getRelayTokenPath");
 function readRelayToken() {
@@ -16684,7 +17121,7 @@ __name(readRelayToken, "readRelayToken");
 
 // src/relay-client.ts
 var __filename$1 = fileURLToPath(import.meta.url);
-var __dirname$1 = path7.dirname(__filename$1);
+var __dirname3 = path6.dirname(__filename$1);
 var RELAY_PORT = Number(process.env.FRAMER_CLI_PORT) || 19988;
 var WAIT_TIMEOUT_SECONDS = 5;
 var client = createTRPCClient({
@@ -16809,7 +17246,7 @@ async function ensureRelayServerRunning(options = {}) {
     logger?.log("Relay server not running, starting it...");
   }
   const isRunningFromSource = __filename$1.endsWith(".ts");
-  const scriptPath = isRunningFromSource ? path7.resolve(__dirname$1, "./start-relay-server.ts") : path7.resolve(__dirname$1, "./start-relay-server.js");
+  const scriptPath = isRunningFromSource ? path6.resolve(__dirname3, "./start-relay-server.ts") : path6.resolve(__dirname3, "./start-relay-server.js");
   debug("relay", `spawning server process: ${scriptPath}`);
   const serverProcess = spawn(
     isRunningFromSource ? "tsx" : process.execPath,
@@ -16846,171 +17283,6 @@ async function waitForClaudeCodeSkillDiscovery() {
   );
 }
 __name(waitForClaudeCodeSkillDiscovery, "waitForClaudeCodeSkillDiscovery");
-var FRAMER_TEMPORARY_DIR = path7.join(os2.tmpdir(), "framer");
-function ensureTemporaryDir() {
-  fs8.mkdirSync(FRAMER_TEMPORARY_DIR, { recursive: true });
-}
-__name(ensureTemporaryDir, "ensureTemporaryDir");
-function cleanupStaleSessionCodeFiles(activeSessionIds) {
-  if (!fs8.existsSync(FRAMER_TEMPORARY_DIR)) return;
-  const activeSessionIdsSet = new Set(activeSessionIds);
-  for (const entry of fs8.readdirSync(FRAMER_TEMPORARY_DIR)) {
-    const [sessionId] = entry.split("-");
-    if (activeSessionIdsSet.has(sessionId)) continue;
-    const filePath = path7.join(FRAMER_TEMPORARY_DIR, entry);
-    fs8.rmSync(filePath, { recursive: true, force: true, maxRetries: 2 });
-  }
-}
-__name(cleanupStaleSessionCodeFiles, "cleanupStaleSessionCodeFiles");
-
-// src/skills.ts
-var META_SKILL_NAME = "framer";
-var CODE_COMPONENTS_SKILL_NAME = "framer-code-components";
-var __dirname2 = path7.dirname(fileURLToPath(import.meta.url));
-var skillsDocsDir = path7.join(__dirname2, "..", "docs", "skills");
-function readSkillDoc(name2) {
-  return fs8.readFileSync(path7.join(skillsDocsDir, name2), "utf-8").trimEnd();
-}
-__name(readSkillDoc, "readSkillDoc");
-function buildMetaSkill() {
-  const command = getFramerAgentCommand();
-  const template = readSkillDoc("framer.md");
-  return `${renderTemplate(template, {
-    FRAMER_TEMPORARY_DIR,
-    FRAMER_AGENT_COMMAND: command
-  })}
-`;
-}
-__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");
-var PROJECT_SKILL_PREFIX = "framer-project-";
-var LEGACY_CANVAS_EDITING_SKILL_PREFIX = "framer-canvas-editing-project-";
-var PACKAGE_NAME = "@framer/agent";
-var DEFAULT_FRAMER_AGENT_COMMAND = `npx ${PACKAGE_NAME}`;
-var RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND = `npx --min-release-age=0 ${PACKAGE_NAME}`;
-function getFramerAgentCommand() {
-  return isNpxMinReleaseAgeOverrideEnabled() ? RELEASE_AGE_OVERRIDE_FRAMER_AGENT_COMMAND : DEFAULT_FRAMER_AGENT_COMMAND;
-}
-__name(getFramerAgentCommand, "getFramerAgentCommand");
-function toSafeProjectId(projectId) {
-  return projectId.replace(/[^a-zA-Z0-9_-]/g, "-");
-}
-__name(toSafeProjectId, "toSafeProjectId");
-function buildProjectSkill(projectId, agentContext, agentPrompt) {
-  const command = getFramerAgentCommand();
-  const skillName = `${PROJECT_SKILL_PREFIX}${toSafeProjectId(projectId)}`;
-  const template = readSkillDoc("framer-project.md");
-  const content = `${renderTemplate(template, {
-    SKILL_NAME: skillName,
-    PROJECT_ID: projectId,
-    GENERATED_AT: (/* @__PURE__ */ new Date()).toISOString(),
-    AGENT_PROMPT: agentPrompt.trimEnd().replaceAll(DEFAULT_FRAMER_AGENT_COMMAND, command),
-    AGENT_CONTEXT: agentContext.trimEnd().replaceAll(DEFAULT_FRAMER_AGENT_COMMAND, command),
-    FRAMER_TEMPORARY_DIR,
-    FRAMER_AGENT_COMMAND: command
-  })}
-`;
-  return { skillName, content };
-}
-__name(buildProjectSkill, "buildProjectSkill");
-function writeSkill(root, skillName, content) {
-  fs8.mkdirSync(root, { recursive: true });
-  const rootStat = fs8.statSync(root);
-  if (!rootStat.isDirectory()) {
-    throw new Error(`Skill root is not a directory: ${root}`);
-  }
-  const skillDir = path7.join(root, skillName);
-  const filePath = path7.join(skillDir, "SKILL.md");
-  const current = fs8.lstatSync(skillDir, { throwIfNoEntry: false });
-  if (current && (current.isSymbolicLink() || !current.isDirectory())) {
-    fs8.rmSync(skillDir, { recursive: true, force: true });
-  }
-  fs8.mkdirSync(skillDir, { recursive: true });
-  fs8.writeFileSync(filePath, content, "utf-8");
-  return filePath;
-}
-__name(writeSkill, "writeSkill");
-function cleanupLegacyCanvasEditingSkills(skillRoots = getDefaultSkillRoots()) {
-  for (const root of skillRoots) {
-    if (!fs8.existsSync(root)) continue;
-    for (const entry of fs8.readdirSync(root)) {
-      if (!entry.startsWith(LEGACY_CANVAS_EDITING_SKILL_PREFIX)) continue;
-      const skillDir = path7.join(root, entry);
-      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
-    }
-  }
-}
-__name(cleanupLegacyCanvasEditingSkills, "cleanupLegacyCanvasEditingSkills");
-function getDefaultSkillRoots() {
-  const home = os2.homedir();
-  return [
-    path7.join(home, ".agents", "skills"),
-    path7.join(home, ".claude", "skills")
-  ];
-}
-__name(getDefaultSkillRoots, "getDefaultSkillRoots");
-function cleanupStaleSkills(activeProjectIds, skillRoots = getDefaultSkillRoots()) {
-  const sanitizedActiveProjectIds = new Set(
-    [...activeProjectIds].map(toSafeProjectId)
-  );
-  for (const root of skillRoots) {
-    if (!fs8.existsSync(root)) continue;
-    for (const entry of fs8.readdirSync(root)) {
-      if (!entry.startsWith(PROJECT_SKILL_PREFIX)) continue;
-      const sanitizedProjectId = entry.slice(PROJECT_SKILL_PREFIX.length);
-      const isActive = sanitizedActiveProjectIds.has(sanitizedProjectId);
-      if (isActive) continue;
-      const skillDir = path7.join(root, entry);
-      fs8.rmSync(skillDir, { recursive: true, force: true, maxRetries: 2 });
-    }
-  }
-}
-__name(cleanupStaleSkills, "cleanupStaleSkills");
-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 = buildProjectSkill(
-      options.projectId,
-      options.agentContext,
-      options.agentPrompt
-    );
-    skills.push({
-      name: projectSkill.skillName,
-      content: projectSkill.content
-    });
-  }
-  const results = skills.map((skill) => ({
-    skillName: skill.name,
-    paths: skillRoots.map(
-      (root) => writeSkill(root, skill.name, skill.content)
-    )
-  }));
-  trackSkillsInstall({
-    skillType: options.type,
-    skillCount: results.length
-  });
-  return results;
-}
-__name(installSkills, "installSkills");
 
 // src/cli.ts
 var PROGRAM_NAME = "@framer/agent";
@@ -17038,8 +17310,8 @@ function printSetupSummary(results) {
   const installLocations = /* @__PURE__ */ new Set();
   for (const result of results) {
     for (const filePath of result.paths) {
-      const skillDir = path7.dirname(filePath);
-      const root = path7.dirname(skillDir);
+      const skillDir = path6.dirname(filePath);
+      const root = path6.dirname(skillDir);
       installLocations.add(root);
     }
   }
@@ -17067,6 +17339,13 @@ async function installBaseSkills() {
       `Failed to clean up legacy canvas editing skills: ${formatErrorForUser(error)}`
     );
   }
+  try {
+    cleanupProjectSkills();
+  } catch (error) {
+    printWarning(
+      `Failed to clean up generated project skills: ${formatErrorForUser(error)}`
+    );
+  }
   const results = installSkills();
   await waitForClaudeCodeSkillDiscovery();
   return results;
@@ -17104,29 +17383,30 @@ async function getAgentContext(sessionId) {
   return context;
 }
 __name(getAgentContext, "getAgentContext");
-async function refreshSkillsFromSession(sessionId, projectId) {
+async function refreshGeneratedProjectBundleFromSession(sessionId, projectId) {
   try {
     debug("skills", "fetching agent system prompt + context...");
     const [agentPrompt, agentContext] = await Promise.all([
       getAgentSystemPrompt(sessionId),
       getAgentContext(sessionId)
     ]);
-    debug("skills", "installing skills...");
-    installSkills({
-      type: "project",
+    debug("skills", "writing generated project bundle...");
+    writeGeneratedProjectBundle({
       agentPrompt,
       projectId,
+      sessionId,
       agentContext
     });
-    debug("skills", "skills installed");
+    debug("skills", "generated project bundle written");
+    await waitForClaudeCodeSkillDiscovery();
   } catch (err) {
     throw errorWithRef(
-      `Failed to refresh skills for session ${sessionId}: ${formatError(err)}`,
+      `Failed to refresh generated project bundle for session ${sessionId}: ${formatError(err)}`,
       getErrorRef(err)
     );
   }
 }
-__name(refreshSkillsFromSession, "refreshSkillsFromSession");
+__name(refreshGeneratedProjectBundleFromSession, "refreshGeneratedProjectBundleFromSession");
 async function resolveSessionCredentials(projectUrlOrId) {
   const projectId = extractProjectId(projectUrlOrId);
   try {
@@ -17315,13 +17595,18 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
       });
       sessionId = result.id;
       debug("session.new", `session created id=${sessionId}`);
-      debug("session.new", "fetching project name + refreshing skills...");
+      debug(
+        "session.new",
+        "fetching project name + refreshing generated bundle..."
+      );
       const [projectName] = await Promise.all([
         getProjectName(sessionId),
-        refreshSkillsFromSession(sessionId, projectId)
+        refreshGeneratedProjectBundleFromSession(sessionId, projectId)
       ]);
-      debug("session.new", `project name="${projectName}", skills refreshed`);
-      await waitForClaudeCodeSkillDiscovery();
+      debug(
+        "session.new",
+        `project name="${projectName}", generated files written`
+      );
       saveProject({
         projectId,
         apiKey: credentials.apiKey,
@@ -17335,10 +17620,10 @@ session.command("new <projectUrlOrId>").description("Create a new session and pr
         (activeSession) => activeSession.projectId
       );
       try {
-        cleanupStaleSkills(activeProjectIds);
+        cleanupStaleGeneratedProjectBundles(activeProjectIds);
       } catch (error) {
         printWarning(
-          `Failed to clean up stale skills: ${formatErrorForUser(error)}`
+          `Failed to clean up stale generated project bundles: ${formatErrorForUser(error)}`
         );
       }
       const activeSessionIds = activeSessions.map(