@agent-native/core 0.80.8 → 0.80.9

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
+    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/dist/server/agents-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-bundle.d.ts","sourceRoot":"","sources":["../../src/server/agents-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,eAAO,MAAM,mBAAmB,EAAE,UAAmB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAaD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAavE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAiDzE;AAUD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAiED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,qBAAqB,GAAG,IAAW,GACnD,YAAY,CA4Cd;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2C9D;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAI9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAIlE;AAyBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEtE;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,MAAM,CAER;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"agents-bundle.d.ts","sourceRoot":"","sources":["../../src/server/agents-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,eAAO,MAAM,mBAAmB,EAAE,UAAmB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC/B;AAaD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAavE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAiDzE;AAUD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAiED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,qBAAqB,GAAG,IAAW,GACnD,YAAY,CA4Cd;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2C9D;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAI9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,CAIlE;AA+CD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKtE;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,MAAM,CAKR;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/server/agents-bundle.js

@@ -300,31 +300,46 @@ export function getRuntimeSkills(bundle) {
 export function getDevelopmentSkills(bundle) {
     return Object.values(bundle.skills).filter((skill) => skill.meta.scope !== "runtime");
 }
-function generateSkillsPromptBlockForEntries(entries) {
+function skillDocsSlug(name) {
+    return `skill-${name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")}`;
+}
+function generateSkillsPromptBlockForEntries(entries, mode) {
     if (entries.length === 0)
         return "";
     const lines = entries.map((s) => {
         const extras = s.extraFiles.length > 0
             ? ` (also contains: ${s.extraFiles.join(", ")})`
             : "";
-        return `- \`${s.meta.name}\` at \`${s.dir}/\` — ${s.meta.description || "(no description)"}${extras}`;
+        const runtimeHint = mode === "runtime"
+            ? ` Read with \`docs-search --slug "${skillDocsSlug(s.meta.name)}"\` before starting a task it applies to.`
+            : "";
+        return `- \`${s.meta.name}\` at \`${s.dir}/\` — ${s.meta.description || "(no description)"}${extras}${runtimeHint}`;
     });
+    const readHint = mode === "runtime"
+        ? `To read a skill in the in-app runtime agent:
+  \`docs-search --slug "skill-<skill-name>"\`
+  \`docs-search --query "<topic>"\` to discover matching docs/skills`
+        : `To read a skill in dev mode (when you have bash access):
+  \`bash(command="cat <skill-dir>/SKILL.md")\`
+  \`bash(command="ls <skill-dir>/")\` to see all files in the folder`;
     return `<skills>
 The following skills live in the repo, usually at \`.agents/skills/<name>/\` (legacy \`.agent/skills/<name>/\` is also supported). Each skill is a folder containing a \`SKILL.md\` entry file and sometimes supporting files. Read a skill BEFORE starting a task it applies to.
 
-To read a skill in dev mode (when you have bash access):
-  \`bash(command="cat <skill-dir>/SKILL.md")\`
-  \`bash(command="ls <skill-dir>/")\` to see all files in the folder
+${readHint}
 
 Available skills:
 ${lines.join("\n")}
 </skills>`;
 }
 export function generateSkillsPromptBlock(bundle) {
-    return generateSkillsPromptBlockForEntries(getRuntimeSkills(bundle));
+    return generateSkillsPromptBlockForEntries(getRuntimeSkills(bundle), "runtime");
 }
 export function generateDevelopmentSkillsPromptBlock(bundle) {
-    return generateSkillsPromptBlockForEntries(getDevelopmentSkills(bundle));
+    return generateSkillsPromptBlockForEntries(getDevelopmentSkills(bundle), "development");
 }
 /** For tests — reset the module cache. */
 export function __resetAgentsBundleCache() {

package/dist/server/agents-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-bundle.js","sourceRoot":"","sources":["../../src/server/agents-bundle.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agents bundle — loads AGENTS.md and .agents/skills/ from the template.\n * The legacy singular .agent/skills/ directory is also accepted as an alias.\n *\n * This is the single source of truth the framework's agent uses to mirror what\n * Claude Code / Codex / any other agent would see when running locally in the\n * repo. The filesystem is the canonical source; this module is just a loader\n * that works both in dev (direct fs read) and production (content bundled at\n * build time via the `virtual:agents-bundle` Vite plugin).\n *\n * Resolution order inside `loadAgentsBundle()`:\n *   1. Virtual module (`virtual:agents-bundle`) — inlined at build time by the\n *      framework's Vite plugin. This is the ONLY path that works on edge\n *      runtimes (Cloudflare Workers) where `readFileSync` doesn't exist.\n *   2. Filesystem fallback — `process.cwd()/AGENTS.md` +\n *      `process.cwd()/.agents/skills/` (or legacy `.agent/skills/`). Only reliable in local dev and Node\n *      production (`agent-native start`); not on Netlify/Vercel/CF at runtime.\n *   3. Empty bundle — everything silently returns empty strings.\n *\n * Result is cached in module scope so it's only computed once per cold start.\n */\n\n/**\n * Where a skill is meant to be used:\n *   - `runtime` — only the in-app agent at runtime (not the human's coding agent).\n *   - `dev`     — only the human's development/coding agent (e.g. Claude Code).\n *                 EXCLUDED from the runtime agent's prompt block and docs-search.\n *   - `both`    — loaded everywhere. This is the default when `scope` is absent\n *                 or set to an unrecognized value (fully backward compatible).\n */\nexport type SkillScope = \"runtime\" | \"dev\" | \"both\";\n\nexport const DEFAULT_SKILL_SCOPE: SkillScope = \"both\";\n\nexport interface SkillMeta {\n  name: string;\n  description: string;\n  /**\n   * Audience for the skill. Defaults to `both` when the SKILL.md frontmatter\n   * omits `scope` or specifies an unknown value. `dev`-scoped skills are hidden\n   * from the runtime agent everywhere (prompt block + docs-search).\n   */\n  scope: SkillScope;\n}\n\nexport interface Skill {\n  meta: SkillMeta;\n  /** Contents of SKILL.md (the entry file of the skill). */\n  content: string;\n  /**\n   * Filesystem path to the skill directory, relative to the template root\n   * (e.g. `.agents/skills/create-deck`). The agent can read any file here via\n   * bash in dev — skills are folders, not single files, and may contain\n   * supporting assets, scripts, or additional markdown.\n   */\n  dir: string;\n  /**\n   * Files inside the skill directory (relative to the skill dir), excluding\n   * `SKILL.md`. Lets the agent know what else is available without a separate\n   * `ls` call. Empty array if the skill is single-file.\n   */\n  extraFiles: string[];\n}\n\nexport interface AgentsBundle {\n  /** Contents of the template's AGENTS.md (empty string if missing). */\n  agentsMd: string;\n  /**\n   * Contents of the workspace core's AGENTS.md, if the app is inside an\n   * enterprise monorepo with a `workspaceCore` configured. Empty string\n   * otherwise. Sits between the framework system prompt and the template's\n   * AGENTS.md in the instruction stack.\n   */\n  workspaceAgentsMd?: string;\n  /**\n   * Map from skill name → skill content. Contains skills merged from the\n   * workspace core layer (if present) and the template layer. On name\n   * collision, the template's version wins so apps can override a shared\n   * enterprise skill by dropping a same-named file under\n   * `.agents/skills/<name>/`.\n   */\n  skills: Record<string, Skill>;\n}\n\nconst EMPTY: AgentsBundle = { agentsMd: \"\", workspaceAgentsMd: \"\", skills: {} };\n\nlet cached: AgentsBundle | null = null;\n\n/**\n * Coerce a raw frontmatter `scope` value into a known `SkillScope`. Unknown,\n * empty, or malformed values fall back to the default (`both`) so a typo never\n * silently hides a skill from the runtime agent. Optionally warns once per\n * distinct bad value to aid debugging without spamming logs.\n */\nconst warnedBadScopes = new Set<string>();\nexport function normalizeSkillScope(raw: string | undefined): SkillScope {\n  if (!raw) return DEFAULT_SKILL_SCOPE;\n  const value = raw.trim().toLowerCase();\n  if (value === \"runtime\" || value === \"dev\" || value === \"both\") {\n    return value;\n  }\n  if (value && !warnedBadScopes.has(value)) {\n    warnedBadScopes.add(value);\n    console.warn(\n      `[agents-bundle] Unknown skill scope \"${raw}\" — treating as \"${DEFAULT_SKILL_SCOPE}\". Valid values: runtime, dev, both.`,\n    );\n  }\n  return DEFAULT_SKILL_SCOPE;\n}\n\n/**\n * Parse the YAML frontmatter at the top of a skill file.\n * Only pulls out `name`, `description`, and `scope` — deliberately simple, no\n * YAML lib.\n * Handles:\n *   - Inline: `description: Some text`\n *   - Folded scalar: `description: >-\\n  multi\\n  line` → \"multi line\"\n *   - Literal scalar: `description: |\\n  multi\\n  line` → \"multi\\nline\"\n */\nexport function parseSkillFrontmatter(content: string): Partial<SkillMeta> {\n  const match = content.match(/^---\\r?\\n([\\s\\S]+?)\\r?\\n---/);\n  if (!match) return {};\n  const lines = match[1].split(/\\r?\\n/);\n  const result: Partial<SkillMeta> = {};\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const keyMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\\s*(.*)$/);\n    if (!keyMatch) continue;\n    const [, key, valueRaw] = keyMatch;\n    const trimmed = valueRaw.trim();\n\n    const isFolded = trimmed === \">\" || trimmed === \">-\";\n    const isLiteral = trimmed === \"|\" || trimmed === \"|-\";\n\n    let value: string;\n    if (isFolded || isLiteral) {\n      // Collect subsequent indented lines (at least one leading space).\n      const block: string[] = [];\n      let j = i + 1;\n      while (j < lines.length) {\n        const next = lines[j];\n        if (next.length === 0) {\n          block.push(\"\");\n          j++;\n          continue;\n        }\n        if (!/^\\s/.test(next)) break;\n        block.push(next.replace(/^\\s+/, \"\"));\n        j++;\n      }\n      // Trim trailing blank lines\n      while (block.length > 0 && block[block.length - 1] === \"\") block.pop();\n      value = isFolded\n        ? block.filter((l) => l !== \"\").join(\" \")\n        : block.join(\"\\n\");\n      i = j - 1;\n    } else {\n      value = trimmed;\n    }\n\n    if (key === \"name\" && value) result.name = value;\n    else if (key === \"description\" && value) result.description = value;\n    else if (key === \"scope\" && value)\n      result.scope = normalizeSkillScope(value);\n  }\n\n  return result;\n}\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nconst TEMPLATE_SKILLS_DIRS = [\n  path.join(\".agents\", \"skills\"),\n  path.join(\".agent\", \"skills\"),\n] as const;\n\n/**\n * Paths to a workspace-core's agent resources, for merging into a template's\n * bundle. All fields optional — pass null for any missing piece.\n */\nexport interface WorkspaceAgentsSource {\n  /** Absolute path to the workspace core's skills/ directory. */\n  skillsDir: string | null;\n  /** Absolute path to the workspace core's AGENTS.md. */\n  agentsMdPath: string | null;\n  /** Root dir (used to compute `dir` paths for workspace-core skills). */\n  rootDir: string;\n}\n\n/**\n * Read one skills directory into a `Record<string, Skill>`. Extracted so\n * both the template and workspace-core paths can reuse it. `dirPrefix` is\n * the display path that will be reported to the agent (e.g.\n * `.agents/skills/<name>` for templates, or\n * `<workspace-shared-package>/.agents/skills/<name>` for the workspace layer).\n */\nfunction readSkillsDir(\n  skillsDir: string,\n  rootForRelative: string,\n  out: Record<string, Skill>,\n  skipExistingNames: boolean,\n): void {\n  if (!fs.existsSync(skillsDir)) return;\n  const entries = fs.readdirSync(skillsDir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const skillDirAbs = path.join(skillsDir, entry.name);\n    const skillFile = path.join(skillDirAbs, \"SKILL.md\");\n    try {\n      const realSkillFile = fs.realpathSync(skillFile);\n      if (!fs.existsSync(realSkillFile)) continue;\n      const content = fs.readFileSync(realSkillFile, \"utf-8\");\n      const meta = parseSkillFrontmatter(content);\n      const name = meta.name ?? entry.name;\n      if (skipExistingNames && out[name]) continue; // Template wins\n\n      const extraFiles: string[] = [];\n      try {\n        const walk = (subdir: string, prefix: string) => {\n          for (const e of fs.readdirSync(subdir, { withFileTypes: true })) {\n            const abs = path.join(subdir, e.name);\n            const rel = prefix ? `${prefix}/${e.name}` : e.name;\n            if (e.isDirectory() || e.isSymbolicLink()) {\n              try {\n                const stat = fs.statSync(abs);\n                if (stat.isDirectory()) walk(abs, rel);\n              } catch {}\n            } else if (e.isFile() && e.name !== \"SKILL.md\") {\n              extraFiles.push(rel);\n            }\n          }\n        };\n        walk(skillDirAbs, \"\");\n      } catch {}\n      extraFiles.sort();\n\n      out[name] = {\n        meta: {\n          name,\n          description: meta.description ?? \"\",\n          scope: meta.scope ?? DEFAULT_SKILL_SCOPE,\n        },\n        content,\n        dir: path.relative(rootForRelative, skillDirAbs).replace(/\\\\/g, \"/\"),\n        extraFiles,\n      };\n    } catch {\n      // Skip unreadable skills\n    }\n  }\n}\n\n/**\n * Read AGENTS.md + all skills directly from the filesystem rooted at `cwd`.\n * Optionally also reads a workspace-core's AGENTS.md and skills directory\n * and merges them in (template wins on name collisions). Used by both the\n * Vite plugin (at build time) and the runtime fallback (in dev / Node prod).\n *\n * Synchronous — the Vite plugin's load hook calls it inline during the build.\n */\nexport function readAgentsBundleFromFs(\n  cwd: string,\n  workspaceSource: WorkspaceAgentsSource | null = null,\n): AgentsBundle {\n  let agentsMd = \"\";\n  try {\n    const agentsMdPath = path.join(cwd, \"AGENTS.md\");\n    if (fs.existsSync(agentsMdPath)) {\n      agentsMd = fs.readFileSync(agentsMdPath, \"utf-8\");\n    }\n  } catch {}\n\n  let workspaceAgentsMd = \"\";\n  if (workspaceSource?.agentsMdPath) {\n    try {\n      if (fs.existsSync(workspaceSource.agentsMdPath)) {\n        workspaceAgentsMd = fs.readFileSync(\n          workspaceSource.agentsMdPath,\n          \"utf-8\",\n        );\n      }\n    } catch {}\n  }\n\n  // Merge skills: template first (so its entries are authoritative), then\n  // workspace-core with skipExistingNames=true so same-named skills don't\n  // overwrite the template's. `.agents/skills` is canonical; `.agent/skills`\n  // is accepted as a legacy alias and does not override canonical skills.\n  const skills: Record<string, Skill> = {};\n  for (const [index, relSkillsDir] of TEMPLATE_SKILLS_DIRS.entries()) {\n    try {\n      readSkillsDir(path.join(cwd, relSkillsDir), cwd, skills, index > 0);\n    } catch {}\n  }\n\n  if (workspaceSource?.skillsDir) {\n    try {\n      readSkillsDir(\n        workspaceSource.skillsDir,\n        workspaceSource.rootDir,\n        skills,\n        true,\n      );\n    } catch {}\n  }\n\n  return { agentsMd, workspaceAgentsMd, skills };\n}\n\n/**\n * Load the agents bundle. Returns a cached result on subsequent calls.\n * Tries the virtual module first (works everywhere, including edge), then\n * falls back to filesystem reads from `process.cwd()` — which, when a\n * workspace core is present, also merges in the workspace core's skills\n * and AGENTS.md.\n */\nexport async function loadAgentsBundle(): Promise<AgentsBundle> {\n  if (cached) return cached;\n\n  // 1. Try the Vite-emitted virtual module. This is the path that works on\n  //    every deployment target because the content is inlined at build time.\n  //    The Vite plugin itself is responsible for merging workspace-core\n  //    content into the bundle it emits.\n  try {\n    // @ts-expect-error — virtual module is resolved at build time by our\n    // Vite plugin; nothing exists at this path on disk.\n    const mod = await import(\"virtual:agents-bundle\");\n    if (mod && mod.default) {\n      cached = mod.default as AgentsBundle;\n      return cached;\n    }\n  } catch {\n    // Virtual module not available — fall through to filesystem.\n  }\n\n  // 2. Filesystem fallback — works in dev / Node prod. If a workspace core\n  //    is present in the ancestor chain, merge its skills + AGENTS.md in.\n  try {\n    let workspaceSource: WorkspaceAgentsSource | null = null;\n    try {\n      const { getWorkspaceCoreExports } =\n        await import(\"../deploy/workspace-core.js\");\n      const ws = await getWorkspaceCoreExports(process.cwd());\n      if (ws) {\n        workspaceSource = {\n          skillsDir: ws.skillsDir,\n          agentsMdPath: ws.agentsMdPath,\n          rootDir: ws.packageDir,\n        };\n      }\n    } catch {\n      // workspace-core discovery isn't available (e.g. edge runtime).\n    }\n    cached = readAgentsBundleFromFs(process.cwd(), workspaceSource);\n    return cached;\n  } catch {\n    cached = EMPTY;\n    return cached;\n  }\n}\n\n/**\n * Generate the `<skills>` block to inject into the system prompt.\n *\n * Skills are folders at `.agents/skills/<name>/` (or legacy\n * `.agent/skills/<name>/`) containing a `SKILL.md` entry file plus any number\n * of supporting files (additional markdown, examples, images, scripts). This\n * block lists what's available and how to read them.\n *\n * In dev mode the agent has bash access and reads skills via `cat` — exactly\n * like running `claude` locally in the repo. In production mode the agent has\n * no bash; templates that need skill content at runtime should inline the\n * critical parts directly in `AGENTS.md`.\n */\n/**\n * Skills visible to the agent-native RUNTIME agent. Excludes `scope: dev`\n * skills (those are for the human's coding agent only). Skills with no scope,\n * `scope: runtime`, or `scope: both` are all included. Use this anywhere the\n * runtime agent's view of skills is built (prompt block + docs-search) so a\n * dev-scoped skill is invisible to the runtime agent everywhere.\n */\nexport function getRuntimeSkills(bundle: AgentsBundle): Skill[] {\n  return Object.values(bundle.skills).filter(\n    (skill) => skill.meta.scope !== \"dev\",\n  );\n}\n\n/**\n * Skills visible to development/coding agents. Excludes `scope: runtime`\n * skills that are intended only for the deployed in-app agent.\n */\nexport function getDevelopmentSkills(bundle: AgentsBundle): Skill[] {\n  return Object.values(bundle.skills).filter(\n    (skill) => skill.meta.scope !== \"runtime\",\n  );\n}\n\nfunction generateSkillsPromptBlockForEntries(entries: Skill[]): string {\n  if (entries.length === 0) return \"\";\n\n  const lines = entries.map((s) => {\n    const extras =\n      s.extraFiles.length > 0\n        ? ` (also contains: ${s.extraFiles.join(\", \")})`\n        : \"\";\n    return `- \\`${s.meta.name}\\` at \\`${s.dir}/\\` — ${s.meta.description || \"(no description)\"}${extras}`;\n  });\n\n  return `<skills>\nThe following skills live in the repo, usually at \\`.agents/skills/<name>/\\` (legacy \\`.agent/skills/<name>/\\` is also supported). Each skill is a folder containing a \\`SKILL.md\\` entry file and sometimes supporting files. Read a skill BEFORE starting a task it applies to.\n\nTo read a skill in dev mode (when you have bash access):\n  \\`bash(command=\"cat <skill-dir>/SKILL.md\")\\`\n  \\`bash(command=\"ls <skill-dir>/\")\\` to see all files in the folder\n\nAvailable skills:\n${lines.join(\"\\n\")}\n</skills>`;\n}\n\nexport function generateSkillsPromptBlock(bundle: AgentsBundle): string {\n  return generateSkillsPromptBlockForEntries(getRuntimeSkills(bundle));\n}\n\nexport function generateDevelopmentSkillsPromptBlock(\n  bundle: AgentsBundle,\n): string {\n  return generateSkillsPromptBlockForEntries(getDevelopmentSkills(bundle));\n}\n\n/** For tests — reset the module cache. */\nexport function __resetAgentsBundleCache(): void {\n  cached = null;\n}\n"]}
+{"version":3,"file":"agents-bundle.js","sourceRoot":"","sources":["../../src/server/agents-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAYH,MAAM,CAAC,MAAM,mBAAmB,GAAe,MAAM,CAAC;AAoDtD,MAAM,KAAK,GAAiB,EAAE,QAAQ,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEhF,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAC1C,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACzD,IAAI,CAAC,GAAG;QAAE,OAAO,mBAAmB,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CACV,wCAAwC,GAAG,oBAAoB,mBAAmB,sCAAsC,CACzH,CAAC;IACJ,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC;QACrD,MAAM,SAAS,GAAG,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC;QAEtD,IAAI,KAAa,CAAC;QAClB,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC1B,kEAAkE;YAClE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACf,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,MAAM;gBAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;gBACrC,CAAC,EAAE,CAAC;YACN,CAAC;YACD,4BAA4B;YAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;gBAAE,KAAK,CAAC,GAAG,EAAE,CAAC;YACvE,KAAK,GAAG,QAAQ;gBACd,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,OAAO,CAAC;QAClB,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;aAC5C,IAAI,GAAG,KAAK,aAAa,IAAI,KAAK;YAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;aAC/D,IAAI,GAAG,KAAK,OAAO,IAAI,KAAK;YAC/B,MAAM,CAAC,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,oBAAoB,GAAG;IAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACrB,CAAC;AAeX;;;;;;GAMG;AACH,SAAS,aAAa,CACpB,SAAiB,EACjB,eAAuB,EACvB,GAA0B,EAC1B,iBAA0B;IAE1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IACtC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YAAE,SAAS;QAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,SAAS;YAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YACrC,IAAI,iBAAiB,IAAI,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS,CAAC,gBAAgB;YAE9D,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;oBAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;wBAChE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;wBACtC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;wBACpD,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;4BAC1C,IAAI,CAAC;gCACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gCAC9B,IAAI,IAAI,CAAC,WAAW,EAAE;oCAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;4BACzC,CAAC;4BAAC,MAAM,CAAC,CAAA,CAAC;wBACZ,CAAC;6BAAM,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;4BAC/C,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACvB,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC;gBACF,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,UAAU,CAAC,IAAI,EAAE,CAAC;YAElB,GAAG,CAAC,IAAI,CAAC,GAAG;gBACV,IAAI,EAAE;oBACJ,IAAI;oBACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,mBAAmB;iBACzC;gBACD,OAAO;gBACP,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;gBACpE,UAAU;aACX,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,eAAe,GAAiC,IAAI;IAEpD,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,IAAI,iBAAiB,GAAG,EAAE,CAAC;IAC3B,IAAI,eAAe,EAAE,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChD,iBAAiB,GAAG,EAAE,CAAC,YAAY,CACjC,eAAe,CAAC,YAAY,EAC5B,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC;QACnE,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,IAAI,eAAe,EAAE,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,aAAa,CACX,eAAe,CAAC,SAAS,EACzB,eAAe,CAAC,OAAO,EACvB,MAAM,EACN,IAAI,CACL,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,yEAAyE;IACzE,2EAA2E;IAC3E,sEAAsE;IACtE,uCAAuC;IACvC,IAAI,CAAC;QACH,qEAAqE;QACrE,oDAAoD;QACpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAClD,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,OAAuB,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;IAED,yEAAyE;IACzE,wEAAwE;IACxE,IAAI,CAAC;QACH,IAAI,eAAe,GAAiC,IAAI,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,EAAE,uBAAuB,EAAE,GAC/B,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;YAC9C,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACxD,IAAI,EAAE,EAAE,CAAC;gBACP,eAAe,GAAG;oBAChB,SAAS,EAAE,EAAE,CAAC,SAAS;oBACvB,YAAY,EAAE,EAAE,CAAC,YAAY;oBAC7B,OAAO,EAAE,EAAE,CAAC,UAAU;iBACvB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;QACD,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,KAAK,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CACtC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAC1C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,SAAS,IAAI;SACjB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,mCAAmC,CAC1C,OAAgB,EAChB,IAA+B;IAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,oBAAoB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAChD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,WAAW,GACf,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,oCAAoC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,2CAA2C;YAC3G,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,kBAAkB,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC;IACtH,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GACZ,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC;;qEAE6D;QAC/D,CAAC,CAAC;;qEAE6D,CAAC;IAEpE,OAAO;;;EAGP,QAAQ;;;EAGR,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;UACR,CAAC;AACX,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAoB;IAC5D,OAAO,mCAAmC,CACxC,gBAAgB,CAAC,MAAM,CAAC,EACxB,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAoB;IAEpB,OAAO,mCAAmC,CACxC,oBAAoB,CAAC,MAAM,CAAC,EAC5B,aAAa,CACd,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,wBAAwB;IACtC,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Agents bundle — loads AGENTS.md and .agents/skills/ from the template.\n * The legacy singular .agent/skills/ directory is also accepted as an alias.\n *\n * This is the single source of truth the framework's agent uses to mirror what\n * Claude Code / Codex / any other agent would see when running locally in the\n * repo. The filesystem is the canonical source; this module is just a loader\n * that works both in dev (direct fs read) and production (content bundled at\n * build time via the `virtual:agents-bundle` Vite plugin).\n *\n * Resolution order inside `loadAgentsBundle()`:\n *   1. Virtual module (`virtual:agents-bundle`) — inlined at build time by the\n *      framework's Vite plugin. This is the ONLY path that works on edge\n *      runtimes (Cloudflare Workers) where `readFileSync` doesn't exist.\n *   2. Filesystem fallback — `process.cwd()/AGENTS.md` +\n *      `process.cwd()/.agents/skills/` (or legacy `.agent/skills/`). Only reliable in local dev and Node\n *      production (`agent-native start`); not on Netlify/Vercel/CF at runtime.\n *   3. Empty bundle — everything silently returns empty strings.\n *\n * Result is cached in module scope so it's only computed once per cold start.\n */\n\n/**\n * Where a skill is meant to be used:\n *   - `runtime` — only the in-app agent at runtime (not the human's coding agent).\n *   - `dev`     — only the human's development/coding agent (e.g. Claude Code).\n *                 EXCLUDED from the runtime agent's prompt block and docs-search.\n *   - `both`    — loaded everywhere. This is the default when `scope` is absent\n *                 or set to an unrecognized value (fully backward compatible).\n */\nexport type SkillScope = \"runtime\" | \"dev\" | \"both\";\n\nexport const DEFAULT_SKILL_SCOPE: SkillScope = \"both\";\n\nexport interface SkillMeta {\n  name: string;\n  description: string;\n  /**\n   * Audience for the skill. Defaults to `both` when the SKILL.md frontmatter\n   * omits `scope` or specifies an unknown value. `dev`-scoped skills are hidden\n   * from the runtime agent everywhere (prompt block + docs-search).\n   */\n  scope: SkillScope;\n}\n\nexport interface Skill {\n  meta: SkillMeta;\n  /** Contents of SKILL.md (the entry file of the skill). */\n  content: string;\n  /**\n   * Filesystem path to the skill directory, relative to the template root\n   * (e.g. `.agents/skills/create-deck`). The agent can read any file here via\n   * bash in dev — skills are folders, not single files, and may contain\n   * supporting assets, scripts, or additional markdown.\n   */\n  dir: string;\n  /**\n   * Files inside the skill directory (relative to the skill dir), excluding\n   * `SKILL.md`. Lets the agent know what else is available without a separate\n   * `ls` call. Empty array if the skill is single-file.\n   */\n  extraFiles: string[];\n}\n\nexport interface AgentsBundle {\n  /** Contents of the template's AGENTS.md (empty string if missing). */\n  agentsMd: string;\n  /**\n   * Contents of the workspace core's AGENTS.md, if the app is inside an\n   * enterprise monorepo with a `workspaceCore` configured. Empty string\n   * otherwise. Sits between the framework system prompt and the template's\n   * AGENTS.md in the instruction stack.\n   */\n  workspaceAgentsMd?: string;\n  /**\n   * Map from skill name → skill content. Contains skills merged from the\n   * workspace core layer (if present) and the template layer. On name\n   * collision, the template's version wins so apps can override a shared\n   * enterprise skill by dropping a same-named file under\n   * `.agents/skills/<name>/`.\n   */\n  skills: Record<string, Skill>;\n}\n\nconst EMPTY: AgentsBundle = { agentsMd: \"\", workspaceAgentsMd: \"\", skills: {} };\n\nlet cached: AgentsBundle | null = null;\n\n/**\n * Coerce a raw frontmatter `scope` value into a known `SkillScope`. Unknown,\n * empty, or malformed values fall back to the default (`both`) so a typo never\n * silently hides a skill from the runtime agent. Optionally warns once per\n * distinct bad value to aid debugging without spamming logs.\n */\nconst warnedBadScopes = new Set<string>();\nexport function normalizeSkillScope(raw: string | undefined): SkillScope {\n  if (!raw) return DEFAULT_SKILL_SCOPE;\n  const value = raw.trim().toLowerCase();\n  if (value === \"runtime\" || value === \"dev\" || value === \"both\") {\n    return value;\n  }\n  if (value && !warnedBadScopes.has(value)) {\n    warnedBadScopes.add(value);\n    console.warn(\n      `[agents-bundle] Unknown skill scope \"${raw}\" — treating as \"${DEFAULT_SKILL_SCOPE}\". Valid values: runtime, dev, both.`,\n    );\n  }\n  return DEFAULT_SKILL_SCOPE;\n}\n\n/**\n * Parse the YAML frontmatter at the top of a skill file.\n * Only pulls out `name`, `description`, and `scope` — deliberately simple, no\n * YAML lib.\n * Handles:\n *   - Inline: `description: Some text`\n *   - Folded scalar: `description: >-\\n  multi\\n  line` → \"multi line\"\n *   - Literal scalar: `description: |\\n  multi\\n  line` → \"multi\\nline\"\n */\nexport function parseSkillFrontmatter(content: string): Partial<SkillMeta> {\n  const match = content.match(/^---\\r?\\n([\\s\\S]+?)\\r?\\n---/);\n  if (!match) return {};\n  const lines = match[1].split(/\\r?\\n/);\n  const result: Partial<SkillMeta> = {};\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const keyMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\\s*(.*)$/);\n    if (!keyMatch) continue;\n    const [, key, valueRaw] = keyMatch;\n    const trimmed = valueRaw.trim();\n\n    const isFolded = trimmed === \">\" || trimmed === \">-\";\n    const isLiteral = trimmed === \"|\" || trimmed === \"|-\";\n\n    let value: string;\n    if (isFolded || isLiteral) {\n      // Collect subsequent indented lines (at least one leading space).\n      const block: string[] = [];\n      let j = i + 1;\n      while (j < lines.length) {\n        const next = lines[j];\n        if (next.length === 0) {\n          block.push(\"\");\n          j++;\n          continue;\n        }\n        if (!/^\\s/.test(next)) break;\n        block.push(next.replace(/^\\s+/, \"\"));\n        j++;\n      }\n      // Trim trailing blank lines\n      while (block.length > 0 && block[block.length - 1] === \"\") block.pop();\n      value = isFolded\n        ? block.filter((l) => l !== \"\").join(\" \")\n        : block.join(\"\\n\");\n      i = j - 1;\n    } else {\n      value = trimmed;\n    }\n\n    if (key === \"name\" && value) result.name = value;\n    else if (key === \"description\" && value) result.description = value;\n    else if (key === \"scope\" && value)\n      result.scope = normalizeSkillScope(value);\n  }\n\n  return result;\n}\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nconst TEMPLATE_SKILLS_DIRS = [\n  path.join(\".agents\", \"skills\"),\n  path.join(\".agent\", \"skills\"),\n] as const;\n\n/**\n * Paths to a workspace-core's agent resources, for merging into a template's\n * bundle. All fields optional — pass null for any missing piece.\n */\nexport interface WorkspaceAgentsSource {\n  /** Absolute path to the workspace core's skills/ directory. */\n  skillsDir: string | null;\n  /** Absolute path to the workspace core's AGENTS.md. */\n  agentsMdPath: string | null;\n  /** Root dir (used to compute `dir` paths for workspace-core skills). */\n  rootDir: string;\n}\n\n/**\n * Read one skills directory into a `Record<string, Skill>`. Extracted so\n * both the template and workspace-core paths can reuse it. `dirPrefix` is\n * the display path that will be reported to the agent (e.g.\n * `.agents/skills/<name>` for templates, or\n * `<workspace-shared-package>/.agents/skills/<name>` for the workspace layer).\n */\nfunction readSkillsDir(\n  skillsDir: string,\n  rootForRelative: string,\n  out: Record<string, Skill>,\n  skipExistingNames: boolean,\n): void {\n  if (!fs.existsSync(skillsDir)) return;\n  const entries = fs.readdirSync(skillsDir, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const skillDirAbs = path.join(skillsDir, entry.name);\n    const skillFile = path.join(skillDirAbs, \"SKILL.md\");\n    try {\n      const realSkillFile = fs.realpathSync(skillFile);\n      if (!fs.existsSync(realSkillFile)) continue;\n      const content = fs.readFileSync(realSkillFile, \"utf-8\");\n      const meta = parseSkillFrontmatter(content);\n      const name = meta.name ?? entry.name;\n      if (skipExistingNames && out[name]) continue; // Template wins\n\n      const extraFiles: string[] = [];\n      try {\n        const walk = (subdir: string, prefix: string) => {\n          for (const e of fs.readdirSync(subdir, { withFileTypes: true })) {\n            const abs = path.join(subdir, e.name);\n            const rel = prefix ? `${prefix}/${e.name}` : e.name;\n            if (e.isDirectory() || e.isSymbolicLink()) {\n              try {\n                const stat = fs.statSync(abs);\n                if (stat.isDirectory()) walk(abs, rel);\n              } catch {}\n            } else if (e.isFile() && e.name !== \"SKILL.md\") {\n              extraFiles.push(rel);\n            }\n          }\n        };\n        walk(skillDirAbs, \"\");\n      } catch {}\n      extraFiles.sort();\n\n      out[name] = {\n        meta: {\n          name,\n          description: meta.description ?? \"\",\n          scope: meta.scope ?? DEFAULT_SKILL_SCOPE,\n        },\n        content,\n        dir: path.relative(rootForRelative, skillDirAbs).replace(/\\\\/g, \"/\"),\n        extraFiles,\n      };\n    } catch {\n      // Skip unreadable skills\n    }\n  }\n}\n\n/**\n * Read AGENTS.md + all skills directly from the filesystem rooted at `cwd`.\n * Optionally also reads a workspace-core's AGENTS.md and skills directory\n * and merges them in (template wins on name collisions). Used by both the\n * Vite plugin (at build time) and the runtime fallback (in dev / Node prod).\n *\n * Synchronous — the Vite plugin's load hook calls it inline during the build.\n */\nexport function readAgentsBundleFromFs(\n  cwd: string,\n  workspaceSource: WorkspaceAgentsSource | null = null,\n): AgentsBundle {\n  let agentsMd = \"\";\n  try {\n    const agentsMdPath = path.join(cwd, \"AGENTS.md\");\n    if (fs.existsSync(agentsMdPath)) {\n      agentsMd = fs.readFileSync(agentsMdPath, \"utf-8\");\n    }\n  } catch {}\n\n  let workspaceAgentsMd = \"\";\n  if (workspaceSource?.agentsMdPath) {\n    try {\n      if (fs.existsSync(workspaceSource.agentsMdPath)) {\n        workspaceAgentsMd = fs.readFileSync(\n          workspaceSource.agentsMdPath,\n          \"utf-8\",\n        );\n      }\n    } catch {}\n  }\n\n  // Merge skills: template first (so its entries are authoritative), then\n  // workspace-core with skipExistingNames=true so same-named skills don't\n  // overwrite the template's. `.agents/skills` is canonical; `.agent/skills`\n  // is accepted as a legacy alias and does not override canonical skills.\n  const skills: Record<string, Skill> = {};\n  for (const [index, relSkillsDir] of TEMPLATE_SKILLS_DIRS.entries()) {\n    try {\n      readSkillsDir(path.join(cwd, relSkillsDir), cwd, skills, index > 0);\n    } catch {}\n  }\n\n  if (workspaceSource?.skillsDir) {\n    try {\n      readSkillsDir(\n        workspaceSource.skillsDir,\n        workspaceSource.rootDir,\n        skills,\n        true,\n      );\n    } catch {}\n  }\n\n  return { agentsMd, workspaceAgentsMd, skills };\n}\n\n/**\n * Load the agents bundle. Returns a cached result on subsequent calls.\n * Tries the virtual module first (works everywhere, including edge), then\n * falls back to filesystem reads from `process.cwd()` — which, when a\n * workspace core is present, also merges in the workspace core's skills\n * and AGENTS.md.\n */\nexport async function loadAgentsBundle(): Promise<AgentsBundle> {\n  if (cached) return cached;\n\n  // 1. Try the Vite-emitted virtual module. This is the path that works on\n  //    every deployment target because the content is inlined at build time.\n  //    The Vite plugin itself is responsible for merging workspace-core\n  //    content into the bundle it emits.\n  try {\n    // @ts-expect-error — virtual module is resolved at build time by our\n    // Vite plugin; nothing exists at this path on disk.\n    const mod = await import(\"virtual:agents-bundle\");\n    if (mod && mod.default) {\n      cached = mod.default as AgentsBundle;\n      return cached;\n    }\n  } catch {\n    // Virtual module not available — fall through to filesystem.\n  }\n\n  // 2. Filesystem fallback — works in dev / Node prod. If a workspace core\n  //    is present in the ancestor chain, merge its skills + AGENTS.md in.\n  try {\n    let workspaceSource: WorkspaceAgentsSource | null = null;\n    try {\n      const { getWorkspaceCoreExports } =\n        await import(\"../deploy/workspace-core.js\");\n      const ws = await getWorkspaceCoreExports(process.cwd());\n      if (ws) {\n        workspaceSource = {\n          skillsDir: ws.skillsDir,\n          agentsMdPath: ws.agentsMdPath,\n          rootDir: ws.packageDir,\n        };\n      }\n    } catch {\n      // workspace-core discovery isn't available (e.g. edge runtime).\n    }\n    cached = readAgentsBundleFromFs(process.cwd(), workspaceSource);\n    return cached;\n  } catch {\n    cached = EMPTY;\n    return cached;\n  }\n}\n\n/**\n * Generate the `<skills>` block to inject into the system prompt.\n *\n * Skills are folders at `.agents/skills/<name>/` (or legacy\n * `.agent/skills/<name>/`) containing a `SKILL.md` entry file plus any number\n * of supporting files (additional markdown, examples, images, scripts). This\n * block lists what's available and how to read them.\n *\n * In dev mode the agent has bash access and reads skills via `cat` — exactly\n * like running `claude` locally in the repo. In production mode the agent has\n * no bash; templates that need skill content at runtime should inline the\n * critical parts directly in `AGENTS.md`.\n */\n/**\n * Skills visible to the agent-native RUNTIME agent. Excludes `scope: dev`\n * skills (those are for the human's coding agent only). Skills with no scope,\n * `scope: runtime`, or `scope: both` are all included. Use this anywhere the\n * runtime agent's view of skills is built (prompt block + docs-search) so a\n * dev-scoped skill is invisible to the runtime agent everywhere.\n */\nexport function getRuntimeSkills(bundle: AgentsBundle): Skill[] {\n  return Object.values(bundle.skills).filter(\n    (skill) => skill.meta.scope !== \"dev\",\n  );\n}\n\n/**\n * Skills visible to development/coding agents. Excludes `scope: runtime`\n * skills that are intended only for the deployed in-app agent.\n */\nexport function getDevelopmentSkills(bundle: AgentsBundle): Skill[] {\n  return Object.values(bundle.skills).filter(\n    (skill) => skill.meta.scope !== \"runtime\",\n  );\n}\n\nfunction skillDocsSlug(name: string): string {\n  return `skill-${name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")}`;\n}\n\nfunction generateSkillsPromptBlockForEntries(\n  entries: Skill[],\n  mode: \"runtime\" | \"development\",\n): string {\n  if (entries.length === 0) return \"\";\n\n  const lines = entries.map((s) => {\n    const extras =\n      s.extraFiles.length > 0\n        ? ` (also contains: ${s.extraFiles.join(\", \")})`\n        : \"\";\n    const runtimeHint =\n      mode === \"runtime\"\n        ? ` Read with \\`docs-search --slug \"${skillDocsSlug(s.meta.name)}\"\\` before starting a task it applies to.`\n        : \"\";\n    return `- \\`${s.meta.name}\\` at \\`${s.dir}/\\` — ${s.meta.description || \"(no description)\"}${extras}${runtimeHint}`;\n  });\n\n  const readHint =\n    mode === \"runtime\"\n      ? `To read a skill in the in-app runtime agent:\n  \\`docs-search --slug \"skill-<skill-name>\"\\`\n  \\`docs-search --query \"<topic>\"\\` to discover matching docs/skills`\n      : `To read a skill in dev mode (when you have bash access):\n  \\`bash(command=\"cat <skill-dir>/SKILL.md\")\\`\n  \\`bash(command=\"ls <skill-dir>/\")\\` to see all files in the folder`;\n\n  return `<skills>\nThe following skills live in the repo, usually at \\`.agents/skills/<name>/\\` (legacy \\`.agent/skills/<name>/\\` is also supported). Each skill is a folder containing a \\`SKILL.md\\` entry file and sometimes supporting files. Read a skill BEFORE starting a task it applies to.\n\n${readHint}\n\nAvailable skills:\n${lines.join(\"\\n\")}\n</skills>`;\n}\n\nexport function generateSkillsPromptBlock(bundle: AgentsBundle): string {\n  return generateSkillsPromptBlockForEntries(\n    getRuntimeSkills(bundle),\n    \"runtime\",\n  );\n}\n\nexport function generateDevelopmentSkillsPromptBlock(\n  bundle: AgentsBundle,\n): string {\n  return generateSkillsPromptBlockForEntries(\n    getDevelopmentSkills(bundle),\n    \"development\",\n  );\n}\n\n/** For tests — reset the module cache. */\nexport function __resetAgentsBundleCache(): void {\n  cached = null;\n}\n"]}

package/dist/server/transcribe-voice.d.ts

@@ -20,7 +20,7 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;
 //# sourceMappingURL=transcribe-voice.d.ts.map

package/dist/styles/agent-native.css

@@ -155,6 +155,7 @@
 .agent-sidebar-main-surface {
   position: relative;
   z-index: 1;
+  container: agent-native-main / inline-size;
   background: var(--agent-native-raised-surface);
   transition:
     border-radius 260ms cubic-bezier(0.32, 0.72, 0, 1),
@@ -162,6 +163,10 @@
     box-shadow 260ms cubic-bezier(0.32, 0.72, 0, 1);
 }
 
+.agent-native-app-main {
+  container: agent-native-main / inline-size;
+}
+
 .agent-layout-main-surface::before,
 .agent-sidebar-main-surface::before {
   content: "";

package/dist/templates/default/app/global.css

@@ -8,63 +8,63 @@
 
 :root {
   --background: 0 0% 100%;
-  --foreground: 220 10% 10%;
+  --foreground: 0 0% 10%;
   --card: 0 0% 100%;
-  --card-foreground: 220 10% 10%;
+  --card-foreground: 0 0% 10%;
   --popover: 0 0% 100%;
-  --popover-foreground: 220 10% 10%;
-  --primary: 220 10% 15%;
+  --popover-foreground: 0 0% 10%;
+  --primary: 0 0% 15%;
   --primary-foreground: 0 0% 100%;
-  --secondary: 220 10% 95%;
-  --secondary-foreground: 220 10% 15%;
-  --muted: 220 10% 95%;
-  --muted-foreground: 220 5% 45%;
-  --accent: 220 10% 95%;
-  --accent-foreground: 220 10% 15%;
+  --secondary: 0 0% 95%;
+  --secondary-foreground: 0 0% 15%;
+  --muted: 0 0% 95%;
+  --muted-foreground: 0 0% 45%;
+  --accent: 0 0% 95%;
+  --accent-foreground: 0 0% 15%;
   --destructive: 0 84% 60%;
   --destructive-foreground: 0 0% 98%;
-  --border: 220 10% 90%;
-  --input: 220 10% 90%;
-  --ring: 220 10% 40%;
+  --border: 0 0% 90%;
+  --input: 0 0% 90%;
+  --ring: 0 0% 40%;
   --radius: 0.5rem;
-  --sidebar-background: 220 10% 97%;
-  --sidebar-foreground: 220 5% 45%;
-  --sidebar-primary: 220 10% 15%;
+  --sidebar-background: 0 0% 97%;
+  --sidebar-foreground: 0 0% 45%;
+  --sidebar-primary: 0 0% 15%;
   --sidebar-primary-foreground: 0 0% 100%;
-  --sidebar-accent: 220 10% 95%;
-  --sidebar-accent-foreground: 220 10% 15%;
-  --sidebar-border: 220 10% 90%;
-  --sidebar-ring: 220 10% 40%;
+  --sidebar-accent: 0 0% 95%;
+  --sidebar-accent-foreground: 0 0% 15%;
+  --sidebar-border: 0 0% 90%;
+  --sidebar-ring: 0 0% 40%;
 }
 
 .dark {
-  --background: 220 6% 6%;
+  --background: 0 0% 13%;
   --foreground: 0 0% 90%;
-  --card: 220 5% 6%;
+  --card: 0 0% 15%;
   --card-foreground: 0 0% 90%;
-  --popover: 220 5% 6%;
+  --popover: 0 0% 15%;
   --popover-foreground: 0 0% 90%;
   --primary: 0 0% 75%;
-  --primary-foreground: 220 6% 6%;
-  --secondary: 220 4% 12%;
+  --primary-foreground: 0 0% 10%;
+  --secondary: 0 0% 18%;
   --secondary-foreground: 0 0% 90%;
-  --muted: 220 4% 10%;
-  --muted-foreground: 220 4% 60%;
-  --accent: 220 4% 13%;
+  --muted: 0 0% 16%;
+  --muted-foreground: 0 0% 60%;
+  --accent: 0 0% 18%;
   --accent-foreground: 0 0% 90%;
   --destructive: 0 63% 51%;
   --destructive-foreground: 0 0% 98%;
-  --border: 220 4% 14%;
-  --input: 220 4% 14%;
+  --border: 0 0% 24%;
+  --input: 0 0% 24%;
   --ring: 0 0% 60%;
   --radius: 0.5rem;
-  --sidebar-background: 220 6% 4%;
-  --sidebar-foreground: 220 4% 60%;
+  --sidebar-background: 0 0% 10%;
+  --sidebar-foreground: 0 0% 60%;
   --sidebar-primary: 0 0% 75%;
-  --sidebar-primary-foreground: 220 6% 6%;
-  --sidebar-accent: 220 4% 10%;
+  --sidebar-primary-foreground: 0 0% 10%;
+  --sidebar-accent: 0 0% 16%;
   --sidebar-accent-foreground: 0 0% 90%;
-  --sidebar-border: 220 4% 10%;
+  --sidebar-border: 0 0% 20%;
   --sidebar-ring: 0 0% 60%;
 }
 

package/docs/content/locales/ar-SA/template-design.mdx

@@ -374,6 +374,12 @@ npx @agent-native/core@latest skills add visual-edit
 المرقمة مثل `localhost:1234/onboarding/1` و`/onboarding/2` و`/onboarding/3`
 كشاشات منفصلة ومرتبة في وضع النظرة العامة.
 
+يمكن تحميل مسار الإدخال `/visual-edit` قبل تسجيل دخول المشاهد، كما يمكن لروابط
+`/design/:id` العامة عرض تصاميم عامة للقراءة فقط بدون جلسة. ما يزال حفظ تخطيط
+الشاشة أو إنشاء شاشات جديدة أو المشاركة ينشئ بيانات Design مرتبطة بحساب: يُرسَل
+المستخدمون غير المسجلين إلى `/_agent-native/sign-in?return=...`، ثم يحفظ Design
+المشروع أو ينسخه إلى ذلك الحساب قبل فتح مربع حوار المشاركة.
+
 لأسماء طبقات مستقرة، أضف `data-agent-native-layer-name` إلى العناصر المهمة.
 يستخدمه Design قبل البدائل الدلالية/النصية، ويمكنه حفظ إعادة تسمية الطبقات عبر
 تحرير هذا السمة. يدعم HTML المضمن تحرير طبقات الكود محليًا للنصوص والأصناف

package/docs/content/locales/de-DE/template-design.mdx

@@ -376,6 +376,14 @@ zu platzieren. Nummerierte Flows wie `localhost:1234/onboarding/1`,
 `/onboarding/2` und `/onboarding/3` bleiben als getrennte, geordnete Screens im
 Overview-Modus erhalten.
 
+Die Einstiegsroute `/visual-edit` kann laden, bevor der Betrachter angemeldet
+ist, und öffentliche `/design/:id`-Links können öffentliche Designs ohne Sitzung
+schreibgeschützt rendern. Das Speichern des Screen-Layouts, Generieren neuer
+Screens oder Teilen erstellt weiterhin accountgebundene Design-Daten:
+abgemeldete Benutzer gehen durch `/_agent-native/sign-in?return=...`;
+anschließend speichert oder kopiert Design das Projekt in dieses Konto, bevor
+der Teilen-Dialog geöffnet wird.
+
 Für stabile Ebenennamen fügen Sie wichtigen Elementen
 `data-agent-native-layer-name` hinzu. Design verwendet dies vor
 semantischen/textbasierten Fallbacks und kann Umbenennungen durch Bearbeiten

package/docs/content/locales/es-ES/template-design.mdx

@@ -340,11 +340,11 @@ Cada operación invocable por el agente es un archivo TypeScript en `templates/d
 - **Sistemas de diseño**: `create-design-system`, `update-design-system`, `get-design-system`, `list-design-systems`, `delete-design-system`, `set-default-design-system` y `analyze-brand-assets` para recopilar datos de marca antes del análisis.
 - **Importar** — `index-design-system-with-builder` for Builder-backed code/GitHub/Figma file design-system indexing, plus `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **Exportación y transferencia**: `export-html`, `export-pdf`, `export-svg`, `export-zip` y `export-coding-handoff` para convertir un diseño en una transferencia de herramienta de codificación.
-- **Contexto y navegación**: `view-screen` (diseño actual, archivo abierto, vista, pregunta pendiente o cuadrícula de variantes), `get-design-snapshot` (estado actual desde el cual un agente externo puede continuar) y `navigate`.
+- **Contexto y navegación**: `view-screen` (diseño actual, archivo abierto, vista, pregunta pendiente o elección de variante), `get-design-snapshot` (estado actual desde el cual un agente externo puede continuar) y `navigate`.
 
 ### Trabajar con el agente
 
-El agente siempre sabe lo que tienes abierto. `view-screen` devuelve el diseño actual, el archivo abierto, la vista activa y cualquier pregunta pendiente o cuadrícula variante y los inyecta en cada mensaje, por lo que puede decir "hacer esto más denso" o "exportar esta variante" sin nombrar el diseño.
+El agente siempre sabe lo que tienes abierto. `view-screen` devuelve el diseño actual, el archivo abierto, la vista activa y cualquier pregunta pendiente o elección de variante y los inyecta en cada mensaje, por lo que puede decir "hacer esto más denso" o "exportar esta variante" sin nombrar el diseño.
 
 Debido a que un diseño son solo archivos HTML/JSX independientes, el agente edita la misma fuente que representa el iframe y de donde proviene cada exportación; no hay un formato de "maqueta de IA" independiente para traducir. Un sistema de diseño vinculado proporciona tokens y `custom_instructions` el agente honra en cada paso de generación. Seleccione texto o una región en la vista previa y presione Cmd+I para enfocar al agente exactamente en esa parte.
 
@@ -375,6 +375,14 @@ por URL. Los flujos numerados como `localhost:1234/onboarding/1`,
 `/onboarding/2` y `/onboarding/3` se mantienen como pantallas separadas y
 ordenadas en modo de vista general.
 
+La ruta de entrada `/visual-edit` puede cargar antes de que el visitante inicie
+sesión, y los enlaces públicos `/design/:id` pueden renderizar diseños públicos
+de solo lectura sin sesión. Persistir el diseño de pantallas, generar pantallas
+nuevas o compartir sigue creando datos de Design vinculados a una cuenta: los
+usuarios sin sesión pasan por `/_agent-native/sign-in?return=...`; después,
+Design guarda o copia el proyecto en esa cuenta antes de abrir el diálogo de
+compartir.
+
 Para nombres de capa estables, agrega `data-agent-native-layer-name` a los
 elementos importantes. Design lo usa antes de los respaldos semánticos/de texto
 y puede persistir cambios de nombre editando ese atributo. HTML inline admite

package/docs/content/locales/fr-FR/template-design.mdx

@@ -340,11 +340,11 @@ Chaque opération appelable par un agent est un fichier TypeScript dans `templat
 - **Systèmes de conception** : `create-design-system`, `update-design-system`, `get-design-system`, `list-design-systems`, `delete-design-system`, `set-default-design-system` et `analyze-brand-assets` pour collecter des données de marque avant l'analyse.
 - **Importer** — `index-design-system-with-builder` for Builder-backed code/GitHub/Figma file design-system indexing, plus `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **Exportation et transfert** : `export-html`, `export-pdf`, `export-svg`, `export-zip` et `export-coding-handoff` pour transformer une conception en transfert d'outil de codage.
-- **Contexte et navigation** – `view-screen` (conception actuelle, fichier ouvert, vue, question en attente ou grille de variantes), `get-design-snapshot` (état actuel à partir duquel un agent externe peut continuer) et `navigate`.
+- **Contexte et navigation** – `view-screen` (conception actuelle, fichier ouvert, vue, question en attente ou choix de variante), `get-design-snapshot` (état actuel à partir duquel un agent externe peut continuer) et `navigate`.
 
 ### Travailler avec l'agent
 
-L'agent sait toujours ce que vous avez ouvert. La conception actuelle, le fichier ouvert, la vue active et toute question en attente ou grille de variantes sont renvoyés par `view-screen` et injectés dans chaque message, vous pouvez donc dire « rendre cela plus dense » ou « exporter cette variante » sans nommer la conception.
+L'agent sait toujours ce que vous avez ouvert. La conception actuelle, le fichier ouvert, la vue active et toute question en attente ou choix de variante sont renvoyés par `view-screen` et injectés dans chaque message, vous pouvez donc dire « rendre cela plus dense » ou « exporter cette variante » sans nommer la conception.
 
 Étant donné qu'une conception n'est constituée que de fichiers HTML/JSX autonomes, l'agent édite la même source que celle du rendu iframe et celle d'où provient chaque exportation : il n'existe pas de format de « maquette IA » distinct à traduire. Un système de conception lié fournit des jetons et `custom_instructions` que l'agent honore à chaque passage de génération. Sélectionnez du texte ou une région dans l'aperçu et appuyez sur Cmd+I pour concentrer l'agent exactement sur cette partie.
 
@@ -375,6 +375,14 @@ URL. Les flows numérotés comme `localhost:1234/onboarding/1`,
 `/onboarding/2` et `/onboarding/3` restent des écrans séparés et ordonnés en
 mode overview.
 
+La route d'entrée `/visual-edit` peut se charger avant la connexion du visiteur,
+et les liens publics `/design/:id` peuvent afficher des designs publics en
+lecture seule sans session. Persister la disposition des écrans, générer de
+nouveaux écrans ou partager crée toujours des données Design liées à un compte :
+les utilisateurs non connectés passent par `/_agent-native/sign-in?return=...`,
+puis Design enregistre ou copie le projet dans ce compte avant d'ouvrir la
+boîte de dialogue de partage.
+
 Pour des noms de couche stables, ajoutez `data-agent-native-layer-name` aux
 éléments importants. Design l'utilise avant les replis sémantiques/textuels et
 peut persister les renommages en modifiant cet attribut. Le HTML inline prend en

package/docs/content/locales/hi-IN/template-design.mdx

@@ -374,6 +374,13 @@ place करता है। `localhost:1234/onboarding/1`, `/onboarding/2`, औ
 `/onboarding/3` जैसे numbered flows overview mode में separate ordered screens
 रहते हैं।
 
+`/visual-edit` entry route viewer के sign in करने से पहले load हो सकता है, और
+public `/design/:id` links बिना session के read-only public designs render कर
+सकते हैं। Screen layout persist करना, नए screens generate करना, या sharing अभी
+भी account-backed Design data बनाता है: signed-out users
+`/_agent-native/sign-in?return=...` से गुजरते हैं, फिर Design share dialog खोलने
+से पहले project को उस account में save या copy करता है।
+
 Stable layer names के लिए meaningful elements पर
 `data-agent-native-layer-name` जोड़ें। Design semantic/text fallbacks से पहले
 इसे उपयोग करता है और इसी attribute को edit करके layer renames persist कर सकता

package/docs/content/locales/ja-JP/template-design.mdx

@@ -376,6 +376,13 @@ npx @agent-native/core@latest skills add visual-edit
 のような番号付きフローは、overview mode で個別の順序付き画面として保持
 されます。
 
+`/visual-edit` の入口ルートは閲覧者がサインインする前でも読み込めます。
+公開 `/design/:id` リンクも、セッションなしで読み取り専用の公開 Design を
+表示できます。画面レイアウトの保存、新しい画面の生成、共有は引き続きア
+カウントに紐づく Design データを作成します。サインアウト中のユーザーは
+`/_agent-native/sign-in?return=...` を経由し、その後 Design が共有ダイアロ
+グを開く前にプロジェクトをそのアカウントへ保存またはコピーします。
+
 安定したレイヤー名には、意味のある要素に
 `data-agent-native-layer-name` を追加します。Design はセマンティック/テ
 キストのフォールバックより先にこれを使い、この属性を編集してレイヤー名

package/docs/content/locales/ko-KR/template-design.mdx

@@ -373,6 +373,13 @@ npx @agent-native/core@latest skills add visual-edit
 `localhost:1234/onboarding/1`, `/onboarding/2`, `/onboarding/3` 같은 번호가
 붙은 흐름은 overview mode에서 분리된 순서 있는 화면으로 유지됩니다.
 
+`/visual-edit` 진입 route는 보는 사람이 sign in하기 전에도 load될 수 있고,
+public `/design/:id` 링크는 session 없이 read-only public design을 render할 수
+있습니다. Screen layout을 persist하거나 새 screen을 generate하거나 share하는
+일은 여전히 account-backed Design data를 만듭니다. signed-out 사용자는
+`/_agent-native/sign-in?return=...`를 거친 뒤, Design이 share dialog를 열기
+전에 project를 해당 account에 save하거나 copy합니다.
+
 안정적인 layer name을 위해 의미 있는 요소에 `data-agent-native-layer-name`을
 추가하세요. Design은 semantic/text fallback보다 이것을 먼저 사용하며, 해당
 attribute를 편집해 layer rename을 persist할 수 있습니다. Inline HTML은 text,

package/docs/content/locales/pt-BR/template-design.mdx

@@ -340,11 +340,11 @@ Cada operação que pode ser chamada pelo agente é um arquivo TypeScript em `te
 - **Sistemas de design** — `create-design-system`, `update-design-system`, `get-design-system`, `list-design-systems`, `delete-design-system`, `set-default-design-system` e `analyze-brand-assets` para coletar dados da marca antes da análise.
 - **Importar** — `index-design-system-with-builder` for Builder-backed code/GitHub/Figma file design-system indexing, plus `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **Exportação e transferência** — `export-html`, `export-pdf`, `export-svg`, `export-zip` e `export-coding-handoff` para transformar um design em uma transferência de ferramenta de codificação.
-- **Contexto e navegação** — `view-screen` (design atual, arquivo aberto, visualização, pergunta pendente ou grade de variantes), `get-design-snapshot` (estado atual para um agente externo continuar) e `navigate`.
+- **Contexto e navegação** — `view-screen` (design atual, arquivo aberto, visualização, pergunta pendente ou escolha de variante), `get-design-snapshot` (estado atual para um agente externo continuar) e `navigate`.
 
 ### Trabalhando com o agente
 
-O agente sempre sabe o que você tem em aberto. O design atual, o arquivo aberto, a visualização ativa e qualquer questão pendente ou grade de variantes são retornados por `view-screen` e injetados em cada mensagem, para que você possa dizer "tornar isso mais denso" ou "exportar esta variante" sem nomear o design.
+O agente sempre sabe o que você tem em aberto. O design atual, o arquivo aberto, a visualização ativa e qualquer questão pendente ou escolha de variante são retornados por `view-screen` e injetados em cada mensagem, para que você possa dizer "tornar isso mais denso" ou "exportar esta variante" sem nomear o design.
 
 Como um design consiste apenas em arquivos HTML/JSX independentes, o agente edita a mesma fonte que o iframe renderiza e de onde vem cada exportação — não há um formato de "maquete de IA" separado para traduzir. Um sistema de design vinculado fornece tokens e `custom_instructions` que o agente homenageia em cada passagem de geração. Selecione o texto ou uma região na visualização e pressione Cmd+I para focar o agente exatamente nessa parte.
 
@@ -374,6 +374,13 @@ para posicionar cada path ou URL solicitado como sua própria tela iframe basead
 em URL. Fluxos numerados como `localhost:1234/onboarding/1`, `/onboarding/2` e
 `/onboarding/3` permanecem como telas separadas e ordenadas no modo overview.
 
+A rota de entrada `/visual-edit` pode carregar antes de o visitante entrar, e
+links públicos `/design/:id` podem renderizar designs públicos somente leitura
+sem sessão. Persistir o layout das telas, gerar novas telas ou compartilhar
+ainda cria dados do Design vinculados a uma conta: usuários desconectados passam
+por `/_agent-native/sign-in?return=...`; depois, o Design salva ou copia o
+projeto para essa conta antes de abrir o diálogo de compartilhamento.
+
 Para nomes de camada estáveis, adicione `data-agent-native-layer-name` a
 elementos importantes. O Design usa isso antes de fallbacks semânticos/de texto
 e pode persistir renomeações editando esse atributo. HTML inline aceita edições

package/docs/content/locales/zh-CN/template-design.mdx

@@ -370,6 +370,12 @@ npx @agent-native/core@latest skills add visual-edit
 `localhost:1234/onboarding/1`、`/onboarding/2`、`/onboarding/3` 这样的编号流程
 会在 overview 模式中保持为分开的有序屏幕。
 
+`/visual-edit` 入口路由可以在查看者登录前加载，公开的 `/design/:id` 链接也
+可以在没有会话时以只读方式渲染公开 design。持久保存屏幕布局、生成新屏幕或
+共享仍会创建账号绑定的 Design 数据：未登录用户会经过
+`/_agent-native/sign-in?return=...`，然后 Design 会在打开共享对话框前，把项
+目保存或复制到该账号。
+
 为了获得稳定的图层名称，请在有意义的元素上添加
 `data-agent-native-layer-name`。Design 会优先使用它，然后才使用语义/文本回
 退，并且可以通过编辑该属性来持久保存图层重命名。Inline HTML 支持本地代

package/docs/content/locales/zh-TW/template-design.mdx

@@ -371,6 +371,12 @@ npx @agent-native/core@latest skills add visual-edit
 `localhost:1234/onboarding/1`、`/onboarding/2`、`/onboarding/3` 這樣的編號流程
 會在 overview 模式中保持為分開的有序畫面。
 
+`/visual-edit` 入口路由可以在檢視者登入前載入，公開的 `/design/:id` 連結也
+可以在沒有 session 時以唯讀方式渲染公開 design。持久保存畫面版面、產生新畫
+面或分享仍會建立帳號綁定的 Design 資料：未登入使用者會經過
+`/_agent-native/sign-in?return=...`，然後 Design 會在開啟分享對話框前，把專
+案保存或複製到該帳號。
+
 若要取得穩定的圖層名稱，請在有意義的元素上加入
 `data-agent-native-layer-name`。Design 會優先使用它，然後才使用語意/文字
 後備，並且可以透過編輯該屬性來持久保存圖層重新命名。Inline HTML 支援本

package/docs/content/template-design.mdx

@@ -340,11 +340,11 @@ Every agent-callable operation is a TypeScript file in `templates/design/actions
 - **Design systems** — `create-design-system`, `update-design-system`, `get-design-system`, `list-design-systems`, `delete-design-system`, `set-default-design-system`, and `analyze-brand-assets` for gathering brand data ahead of analysis.
 - **Import** — `index-design-system-with-builder` for Builder-backed code/GitHub/Figma file design-system indexing, plus `import-from-url`, `import-document` (DOCX/PPTX/PDF/XLSX), and `import-design-project` for other sources.
 - **Export & handoff** — `export-html`, `export-pdf`, `export-svg`, `export-zip`, and `export-coding-handoff` to turn a design into a coding-tool handoff.
-- **Context & navigation** — `view-screen` (current design, open file, view, pending question or variant grid), `get-design-snapshot` (current state for an external agent to continue from), and `navigate`.
+- **Context & navigation** — `view-screen` (current design, open file, view, pending question or variant choice), `get-design-snapshot` (current state for an external agent to continue from), and `navigate`.
 
 ### Working with the agent
 
-The agent always knows what you have open. The current design, the open file, the active view, and any pending question or variant grid are returned by `view-screen` and injected into every message, so you can say "make this denser" or "export this variant" without naming the design.
+The agent always knows what you have open. The current design, the open file, the active view, and any pending question or variant choice are returned by `view-screen` and injected into every message, so you can say "make this denser" or "export this variant" without naming the design.
 
 Because a design is just standalone HTML/JSX files, the agent edits the same source the iframe renders and every export comes from — there is no separate "AI mockup" format to translate. A linked design system supplies tokens and `custom_instructions` the agent honors on every generation pass. Select text or a region in the preview and hit Cmd+I to focus the agent on exactly that part.
 
@@ -374,6 +374,13 @@ place each requested path or URL as its own URL-backed iframe screen. Numbered
 flows such as `localhost:1234/onboarding/1`, `/onboarding/2`, and
 `/onboarding/3` stay as separate ordered screens in overview mode.
 
+The `/visual-edit` entry route can load before the viewer signs in, and public
+`/design/:id` links can render read-only public designs without a session.
+Persisting the screen layout, generating new screens, or sharing still creates
+account-backed Design data: signed-out users go through
+`/_agent-native/sign-in?return=...`, then Design saves or copies the project
+into that account before opening the share dialog.
+
 For stable layer names, add `data-agent-native-layer-name` to meaningful
 elements. Design uses it before semantic/text fallbacks and can persist layer
 renames by editing that attribute. Inline HTML supports local code-layer edits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.80.8",
+  "version": "0.80.9",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {