@contentful/experience-design-system-cli 2.35.1-dev-build-45d6c918.0 → 2.36.0

package/legacy/dist/src/index.js

@@ -164,506 +164,272 @@ var init_render_with_goodbye = __esm({
 function isAgentName(value) {
   return AGENT_NAMES.includes(value);
 }
-var AGENT_NAMES, DEFAULT_AGENT_NAME, AGENT_BINARIES;
+var AGENT_NAMES, DEFAULT_AGENT_NAME;
 var init_agent_names = __esm({
   "packages/experience-design-system-generation/dist/src/agent-names.js"() {
     "use strict";
     AGENT_NAMES = ["claude", "codex", "opencode", "cursor", "copilot"];
     DEFAULT_AGENT_NAME = "claude";
-    AGENT_BINARIES = {
-      claude: "claude",
-      codex: "codex",
-      opencode: "opencode",
-      cursor: "cursor-agent",
-      copilot: "copilot"
-    };
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/controller/helpers/validate-generation-request.js
-function validateGenerationRequest(request2) {
-  if (request2 === null || typeof request2 !== "object") {
-    throw new TypeError("createGenerationEndpoint requires a request object");
-  }
-  if (!isAgentName(request2.agent)) {
-    throw new TypeError(`createGenerationEndpoint requires agent to be a valid agent name, got: ${String(request2.agent)}`);
-  }
-  if (typeof request2.timeoutMs !== "number" || request2.timeoutMs <= 0) {
-    throw new TypeError("createGenerationEndpoint requires timeoutMs to be a positive number");
-  }
-  if (request2.promptOptions === null || typeof request2.promptOptions !== "object") {
-    throw new TypeError("createGenerationEndpoint requires promptOptions to be an object");
-  }
-  if (request2.onOutput !== void 0 && typeof request2.onOutput !== "function") {
-    throw new TypeError("createGenerationEndpoint requires onOutput to be a function when provided");
-  }
-}
-var init_validate_generation_request = __esm({
-  "packages/experience-design-system-generation/dist/src/controller/helpers/validate-generation-request.js"() {
-    "use strict";
-    init_agent_names();
   }
 });
 
-// packages/experience-design-system-generation/dist/src/services/prompts/helpers/resolve-skill-file.js
-import { existsSync } from "node:fs";
-import { readFile as readFile2 } from "node:fs/promises";
-import { dirname, join as join2, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-function resolveSkillPath(skill) {
-  if (!(skill in SKILL_FILES))
-    throw new Error(`Invalid skill: ${skill}`);
-  const thisDir = dirname(fileURLToPath(import.meta.url));
-  let dir = thisDir;
-  for (; ; ) {
-    const candidate = join2(dir, "skills");
-    if (existsSync(candidate))
-      return join2(candidate, SKILL_FILES[skill]);
-    const parent = resolve(dir, "..");
-    if (parent === dir) {
-      throw new Error(`skill file missing from CLI installation (could not locate skills/ directory from: ${thisDir})`);
+// packages/experience-design-system-generation/dist/src/agent-runner.js
+import { spawn } from "node:child_process";
+function findJsonObjectEnd(line) {
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+    if (escaped) {
+      escaped = false;
+    } else if (ch === "\\" && inString) {
+      escaped = true;
+    } else if (ch === '"') {
+      inString = !inString;
+    } else if (!inString && ch === "{") {
+      depth++;
+    } else if (!inString && ch === "}" && --depth === 0) {
+      return i;
     }
-    dir = parent;
   }
+  return -1;
 }
-function formatCustomPromptBanner(skill, path) {
-  return `WARNING: Custom prompt active for ${skill}: ${path}
-  Bundled invariants (utility-wrapper rejection, description content rules) do NOT apply.
-  You are responsible for the prompt's correctness.
-`;
-}
-async function readSkillFile(skill, override) {
-  if (override) {
-    const skillPath2 = resolve(override);
+function readToolCallObjects(stdout) {
+  const objects = [];
+  const warnings = [];
+  for (const raw of stdout.split("\n")) {
+    const line = raw.trim();
+    if (!line.startsWith("{"))
+      continue;
+    const end = findJsonObjectEnd(line);
+    if (end === -1) {
+      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
+      continue;
+    }
+    let parsed;
     try {
-      return await readFile2(skillPath2, "utf8");
+      parsed = JSON.parse(line.slice(0, end + 1));
     } catch {
-      throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath2})`);
+      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
+      continue;
+    }
+    const trailing = line.slice(end + 1);
+    if (trailing.trim()) {
+      warnings.push(`ignored trailing content after JSON: ${trailing.trim().slice(0, 120)}`);
+    }
+    if (typeof parsed === "object" && parsed !== null && "tool" in parsed) {
+      objects.push(parsed);
     }
   }
-  const skillPath = resolveSkillPath(skill);
-  try {
-    return await readFile2(skillPath, "utf8");
-  } catch {
-    throw new Error(`skill file missing from CLI installation \u2014 try reinstalling the CLI (looked for: ${skillPath})`);
-  }
+  return { objects, warnings };
 }
-var SKILL_FILES;
-var init_resolve_skill_file = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/helpers/resolve-skill-file.js"() {
-    "use strict";
-    SKILL_FILES = {
-      components: "generate-components.md",
-      tokens: "generate-tokens.md",
-      select: "select-components.md",
-      "map-tokens": "map-tokens.md"
+function parseSelectToolCallLines(stdout) {
+  const calls = [];
+  const { objects, warnings } = readToolCallObjects(stdout);
+  for (const rec of objects) {
+    if (!VALID_SELECT_TOOL_NAMES.has(rec.tool))
+      continue;
+    if (typeof rec.name !== "string" || !rec.name) {
+      warnings.push(`${String(rec.tool)} missing name \u2014 skipped`);
+      continue;
+    }
+    const call = {
+      tool: rec.tool,
+      name: rec.name
     };
+    if (typeof rec.reason === "string")
+      call.reason = rec.reason;
+    if (typeof rec.confidence === "number" && rec.confidence >= 1 && rec.confidence <= 5) {
+      if (call.tool === "select_component") {
+        call.confidence = rec.confidence;
+      } else {
+        call.confidence = rec.confidence;
+      }
+    }
+    calls.push(call);
   }
-});
-
-// packages/experience-design-system-generation/dist/src/services/prompts/helpers/format-token-candidates.js
-import { flattenDTCG } from "@contentful/experience-design-system-types";
-function inferFenceLang(filename) {
-  if (!filename)
-    return "json";
-  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
-  const map = {
-    js: "js",
-    mjs: "js",
-    cjs: "js",
-    ts: "ts",
-    mts: "ts",
-    cts: "ts",
-    tsx: "tsx",
-    jsx: "jsx",
-    vue: "vue",
-    svelte: "svelte",
-    astro: "astro",
-    scss: "scss",
-    sass: "scss",
-    css: "css",
-    json: "json",
-    json5: "json"
-  };
-  return map[ext] ?? "text";
+  return { calls, warnings };
 }
-function filterDesignTokenProps(cdf) {
-  const result = {};
-  const kinds = /* @__PURE__ */ new Set();
-  let hasUnscoped = false;
-  for (const [componentName, component] of Object.entries(cdf)) {
-    const properties = component.$properties;
-    if (!properties)
+function parseToolCallLines(stdout) {
+  const calls = [];
+  const { objects, warnings } = readToolCallObjects(stdout);
+  for (const rec of objects) {
+    if (!VALID_TOOL_NAMES.has(rec.tool)) {
+      warnings.push(`unknown tool: ${String(rec.tool)}`);
       continue;
-    const filteredProps = {};
-    for (const [propName, prop] of Object.entries(properties)) {
-      if (prop.$type === "token" && prop.$category === "design") {
-        const { "$token.allowed": _tokenAllowed, ...rest } = prop;
-        filteredProps[propName] = rest;
-        const kind = prop["$token.kind"];
-        if (typeof kind === "string" && kind.length > 0) {
-          kinds.add(kind);
-        } else {
-          hasUnscoped = true;
-        }
-      }
     }
-    if (Object.keys(filteredProps).length > 0) {
-      result[componentName] = { ...component, $properties: filteredProps };
+    const tool = rec.tool;
+    if (tool === "classify_prop") {
+      if (typeof rec.prop !== "string" || !rec.prop) {
+        warnings.push("classify_prop missing prop name \u2014 skipped");
+        continue;
+      }
+      if (typeof rec.cdf_type !== "string" || !VALID_CDF_TYPES.has(rec.cdf_type)) {
+        warnings.push(`classify_prop '${rec.prop}': invalid cdf_type '${String(rec.cdf_type)}' \u2014 skipped`);
+        continue;
+      }
+      if (typeof rec.cdf_category !== "string" || !VALID_CATEGORIES.has(rec.cdf_category)) {
+        warnings.push(`classify_prop '${rec.prop}': invalid cdf_category '${String(rec.cdf_category)}' \u2014 skipped`);
+        continue;
+      }
+      const call = {
+        tool: "classify_prop",
+        prop: rec.prop,
+        cdf_type: rec.cdf_type,
+        cdf_category: rec.cdf_category
+      };
+      if (Array.isArray(rec.values) && rec.values.every((v) => typeof v === "string")) {
+        call.values = rec.values;
+      }
+      if (typeof rec.token_kind === "string")
+        call.token_kind = rec.token_kind;
+      if (typeof rec.required === "boolean")
+        call.required = rec.required;
+      if (typeof rec.description === "string")
+        call.description = rec.description;
+      if (typeof rec.default === "string" || typeof rec.default === "boolean")
+        call.default = rec.default;
+      if (typeof rec.reason === "string")
+        call.reason = rec.reason;
+      calls.push(call);
+    } else if (tool === "exclude_prop") {
+      if (typeof rec.prop !== "string" || !rec.prop) {
+        warnings.push("exclude_prop missing prop name \u2014 skipped");
+        continue;
+      }
+      calls.push({
+        tool: "exclude_prop",
+        prop: rec.prop,
+        reason: typeof rec.reason === "string" ? rec.reason : ""
+      });
+    } else if (tool === "classify_component") {
+      const call = { tool: "classify_component" };
+      if (typeof rec.description === "string")
+        call.description = rec.description;
+      if (typeof rec.rationale === "object" && rec.rationale !== null) {
+        const r = rec.rationale;
+        const rationale = {};
+        if (typeof r.description === "string")
+          rationale.description = r.description;
+        if (typeof r.props === "string")
+          rationale.props = r.props;
+        if (typeof r.slots === "string")
+          rationale.slots = r.slots;
+        if (Object.keys(rationale).length > 0)
+          call.rationale = rationale;
+      }
+      calls.push(call);
+    } else if (tool === "classify_slot") {
+      if (typeof rec.slot !== "string" || !rec.slot) {
+        warnings.push("classify_slot missing slot name \u2014 skipped");
+        continue;
+      }
+      const call = { tool: "classify_slot", slot: rec.slot };
+      if (typeof rec.required === "boolean")
+        call.required = rec.required;
+      if (Array.isArray(rec.allowed_components) && rec.allowed_components.every((v) => typeof v === "string")) {
+        call.allowed_components = rec.allowed_components;
+      }
+      if (typeof rec.description === "string")
+        call.description = rec.description;
+      if (typeof rec.rationale === "string")
+        call.rationale = rec.rationale;
+      calls.push(call);
     }
   }
-  return { filtered: result, kinds: [...kinds].sort(), hasUnscoped };
-}
-function buildTokenCandidateSections(tokenTree, filteredTokenProps) {
-  const index = flattenDTCG(tokenTree, "").sort((a, b) => a.path.localeCompare(b.path));
-  if (index.length === 0)
-    return [];
-  const sections = [];
-  const renderSection = (kind, entries) => {
-    const label = kind ? `Token path index \u2014 ${kind} candidates only` : "Token path index \u2014 full tree (no $token.kind to scope by)";
-    const lines = entries.map((e) => `${e.path} \xB7 ${e.$type}`).join("\n");
-    return `${label}, one leaf token per line as \`path \xB7 type\`, no \`$value\`:
-${lines}`;
-  };
-  if (filteredTokenProps) {
-    const { kinds, hasUnscoped } = filteredTokenProps;
-    for (const kind of kinds) {
-      const scoped = index.filter((e) => e.$type === kind);
-      if (scoped.length > 0)
-        sections.push(renderSection(kind, scoped));
-    }
-    if (hasUnscoped)
-      sections.push(renderSection(null, index));
-  } else {
-    sections.push(renderSection(null, index));
-  }
-  return sections;
+  return { calls, warnings };
 }
-var init_format_token_candidates = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/helpers/format-token-candidates.js"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/prompts/helpers/format-source-refs.js
-function formatSourceRefBlock(ref) {
-  const mainBlock = `#### ${ref.component} (\`${ref.sourcePath}\`)
-\`\`\`${inferFenceLang(ref.sourcePath)}
-${ref.content}
-\`\`\``;
-  const siblingBlocks = (ref.siblingFiles ?? []).map((sibling) => `##### ${ref.component} \u2014 imported file \`${sibling.path}\`
-\`\`\`${inferFenceLang(sibling.path)}
-${sibling.content}
-\`\`\``);
-  const truncationNote = ref.truncatedSiblingCount && ref.truncatedSiblingCount > 0 ? [
-    `##### ${ref.component} \u2014 +${ref.truncatedSiblingCount} more imported file${ref.truncatedSiblingCount === 1 ? "" : "s"} not shown (evidence may be incomplete)`
-  ] : [];
-  const notShownNote = ref.usesNotShown && ref.usesNotShown.length > 0 ? [
-    `##### ${ref.component} \u2014 uses not shown: ${ref.usesNotShown.join(", ")}
-
-The files above are excerpts, and each of these properties has at least one use that fell outside the excerpt budget. Treat their consumption as unknown, not absent: do not classify them \`token\` on what is shown, and do not conclude they are unread.`
-  ] : [];
-  return [mainBlock, ...siblingBlocks, ...truncationNote, ...notShownNote].join("\n\n");
-}
-function formatSourceRefsSection(refs, skill) {
-  const sections = [];
-  const withContent = refs.filter((ref) => ref.content != null);
-  const withoutContent = refs.filter((ref) => ref.content == null);
-  if (withContent.length > 0) {
-    sections.push(`### Component source references
-
-${withContent.map(formatSourceRefBlock).join("\n\n")}`);
-  }
-  if (withoutContent.length > 0) {
-    const guidance = skill === "components" ? "there is no consumption evidence for these, so `token` cannot be earned for any of their props \u2014 classify from the prop signature alone, and any prop that would otherwise be enum-versus-token is `enum` (or `string`)" : "there is no source evidence to narrow from \u2014 emit nothing for their props";
-    sections.push(`Component source unavailable for (JSON) \u2014 ${guidance}:
-\`\`\`json
-${JSON.stringify(withoutContent.map((ref) => ({ component: ref.component, sourcePath: ref.sourcePath })))}
-\`\`\``);
-  }
-  return sections;
-}
-var init_format_source_refs = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/helpers/format-source-refs.js"() {
-    "use strict";
-    init_format_token_candidates();
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/prompts/helpers/build-skill-preambles.js
-function buildComponentsAutonomousPreamble(inputBlock) {
-  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
-
-Context: You are classifying a React component for **Contentful Experience Orchestration**. The result is a Component Type \u2014 a schema that tells Contentful what a marketer can configure. Properties fall into three categories:
-- **design**: controls how the component looks (variant, size, color, layout toggles)
-- **content**: the data a content editor fills in (text, images, URLs, rich text)
-- **state**: runtime behavioral flags (disabled, loading, expanded, identifiers)
-
-Your task: classify every prop and slot in the component below. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a "description" field on each tool call to document your reasoning so the developer can review it afterward.
-
-All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
-
-## Output protocol
-
-Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each classification decision. The CLI reads your stdout line by line and writes each decision directly to the pipeline database.
-
-The four tool calls you may emit are:
-
-\`\`\`
-{"tool":"classify_component","description":"<optional component-level description>","rationale":{"description":"<why this component is classified the way it is>","props":"<why these props were chosen>","slots":"<why these slots were chosen>"}}
-
-{"tool":"classify_prop","prop":"<propName>","cdf_type":"<type>","cdf_category":"<category>","required":<bool>,"description":"<short customer-facing description>","reason":"<full internal rationale; not customer-facing>","values":["a","b"],"token_kind":"color","default":"<value>"}
-
-{"tool":"exclude_prop","prop":"<propName>","reason":"<why excluded>"}
-
-{"tool":"classify_slot","slot":"<slotName>","required":<bool>,"allowed_components":["ComponentName"],"description":"<reason>","rationale":"<why this slot was kept in the catalog>"}
-\`\`\`
-
-Rules:
-- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences around the lines.
-- Every prop in the input must have exactly one call: either classify_prop or exclude_prop.
-- Every slot in the input must have exactly one classify_slot call.
-- Valid cdf_type values: string, richtext, media, enum, token, boolean
-- Valid cdf_category values: content, design, state
-- For enum type, always include \`values\` (non-empty string array of the variant names the prop accepts).
-- For token type, always include \`token_kind\` (DTCG $type, e.g. "color"). **Never emit \`values\` for \`cdf_type: "token"\` props** \u2014 an enum prop's list holds variant names; a token prop's list holds design token paths, produced separately and never by you. Emitting \`values\` on a token prop makes the definition invalid.
-- Never emit both "values" and "token_kind" on one prop.
-- \`enum\` vs \`token\` is decided by three questions answered in order from the source shown \u2014 never from the TypeScript type. Q1: does the component look the value up, switch on it, or have a vocabulary for it (\`tokens[x]\`, \`switch (variant)\`, \`allowedValues\`)? yes \u2192 \`enum\`, stop.
-- Q2: is the value written straight into a style or attribute (\`rx={radius}\`, \`padding: \${padding}\`)? no \u2192 not \`token\`, apply the type rules.
-- Q3: is there a design-token reference at that use \u2014 a \`tokens.*\` parameter default, a \`tokenReference\`, an inline \`tokens.*\` / \`var(--*)\`? yes \u2192 \`token\` (cite both lines in "reason"); no \u2192 \`string\`. "Ambiguity resolves to \`enum\`" applies only when Q1\u2013Q3 cannot be answered from the source shown.
-- CSS design props (className, style, styles, positional/geometric props: top, bottom, left, right, rotation, offset, etc.) \u2192 classify_prop, cdf_type: "string", cdf_category: "design".
-- For \`classify_slot.allowed_components\`, use only exact names from the hard allowlist provided below. Never invent a child from an import, JSX element, type name, icon name, or implementation helper; if a child is not listed, omit it.
-- On classify_component, "rationale" fields are operator-facing (read-only) but may surface in customer-facing exports. The "rationale.description" field is subject to the description content rules in the skill prompt (no internal initiative names). "rationale.props" and "rationale.slots" describe your reasoning about scope; "classify_slot.rationale" explains why each slot was kept.
-- On classify_prop, "reason" is REQUIRED and is the LLM's internal rationale \u2014 shown to the developer reviewing the import, never to end-users. "description" is the customer-facing copy and is subject to the description content rules in the skill prompt. Keep them distinct: "description" is short and customer-facing; "reason" explains your reasoning in detail.
-- You may emit prose lines (not starting with {) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
-}
-function buildSelectAutonomousPreamble(inputBlock) {
-  return `You are running as part of the experience-design-system-cli import pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
-
-Your task: review the components provided below and decide whether each belongs in Contentful Experience Orchestration as a Component Type. The input is a JSON array \u2014 you may receive 1\u2013N components in a single message. Emit one tool call per input component, named after the component. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a brief "reason" to document your reasoning for each decision.
-
-Key rule: accept any component that renders visible UI \u2014 atoms, molecules, and organisms are all valid Component Types in Contentful Experience Orchestration. Reject only components that produce zero visual output: React hooks, pure context providers, A/B testing or variant-routing wrappers, analytics trackers, and security utilities. Do NOT reject a component because it has few props, is low-level, or has some A/B testing or personalization-related props mixed in \u2014 those props are handled in the generate step.
-
-All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
-
-## Output protocol
-
-Do NOT write any files or emit any JSON blobs. Instead, emit JSON tool calls one per line to stdout. The CLI reads your stdout line by line.
-
-The two tool calls \u2014 emit exactly one per input component:
-
-\`\`\`
-{"tool":"select_component","name":"<ComponentName>","reason":"<brief reason>"}
-
-{"tool":"reject_component","name":"<ComponentName>","reason":"<brief reason>"}
-\`\`\`
-
-Rules:
-- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences.
-- Emit exactly one tool call per input component. The "name" field must match a component name from the input array exactly. Tool calls may appear in any order.
-- You may emit prose lines (not starting with {) to reason before each tool call \u2014 they are ignored by the parser.`;
-}
-function buildMapTokensAutonomousPreamble(inputBlock) {
-  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
-
-Context: The components below already have design-category, token-typed props (\`$token.kind\` set). Your task is to decide, from source evidence, whether to narrow each one to a restricted subset (\`token_allowed\`) of the tokens matching its \`$token.kind\`. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation.
-
-All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
-
-## Output protocol
-
-Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each prop you narrow. The CLI reads your stdout line by line and writes each decision directly to the pipeline database.
-
-The one tool call you may emit:
-
-\`\`\`
-{"tool":"map_token_prop","component":"<ComponentName>","prop":"<propName>","token_allowed":["colors.brand.primary","colors.brand.secondary"]}
-\`\`\`
-
-Rules:
-- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences around the lines.
-- Only emit a call for a prop that appears in the "Generated CDF so far" section.
-- Each "Token path index" section below is already scoped to one \`$token.kind\` \u2014 a prop only draws candidates from the section matching its own \`$token.kind\` (or the "full tree" section, for a prop with no \`$token.kind\`). Never cross sections, never emit a group/prefix path, and never invent a path \u2014 every entry in \`token_allowed\` must exist verbatim in the matching section.
-- \`token_allowed\` is required and must be non-empty when the call is emitted.
-- For the judgment call of whether a prop should be narrowed at all, follow the decision tree in the map-tokens skill file: it explains defaults vs. restrictions, misclassified variant-name props, and when to emit nothing.
-- You may emit prose lines (not starting with \`{\`) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
-}
-function buildTokensAutonomousPreamble(inputBlock) {
-  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
-
-Your task: classify every raw token from the input below into a DTCG token tree. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a "description" field on each set_token call to document your reasoning.
-
-All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
-
-## Output protocol
-
-Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each token or group. The CLI reads your stdout line by line and writes each entry directly to the pipeline database.
-
-The two tool calls you may emit are:
-
-\`\`\`
-{"tool":"set_group","path":"<dot.notation.path>","description":"<optional group description>"}
-
-{"tool":"set_token","path":"<dot.notation.path>","type":"<DTCG type>","value":<value>,"description":"<reason>"}
-\`\`\`
-
-Rules:
-- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences.
-- Emit a set_group call for every intermediate group node in the tree.
-- Emit a set_token call for every leaf token.
-- "path" is dot-notation, e.g. "colors.brand.primary" \u2014 no leading dots or slashes.
-- "type" must be one of the 13 valid DTCG types: color, dimension, fontFamily, fontWeight, duration, cubicBezier, number, strokeStyle, border, transition, shadow, gradient, typography.
-- "value" must be valid JSON (string, number, array, or object depending on the type). Do NOT wrap it in quotes if it is a complex type.
-- Emit set_group calls before the set_token calls that fall under them.
-- You may emit prose lines (not starting with {) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
-}
-var init_build_skill_preambles = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/helpers/build-skill-preambles.js"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/prompts/helpers/build-preamble.js
-function buildPreamble(options) {
-  const { skill, rawComponentsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline } = options;
-  const sections = [];
-  if (existingComponentsInline) {
-    sections.push(`Existing components in the target Contentful space (JSON) \u2014 use for alignment, not as a hard filter:
-\`\`\`json
-${existingComponentsInline}
-\`\`\``);
-  }
-  if (existingTokensInline) {
-    sections.push(`Existing design tokens in the target Contentful space (JSON) \u2014 prefer binding to these paths over inventing new ones:
-\`\`\`json
-${existingTokensInline}
-\`\`\``);
-  }
-  if (componentAllowlistInline) {
-    sections.push(`Known component names for slot allowed_components (hard allowlist; never use any other name):
-\`\`\`json
-${componentAllowlistInline}
-\`\`\``);
-  }
-  if (rawComponentsInline) {
-    sections.push(`Raw component data (JSON):
-\`\`\`json
-${rawComponentsInline}
-\`\`\``);
-  }
-  if (rawTokensInline) {
-    const lang = inferFenceLang(rawTokensFilename);
-    const label = rawTokensFilename ? `Raw token source (${rawTokensFilename})` : "Raw token source";
-    sections.push(`${label}:
-\`\`\`${lang}
-${rawTokensInline}
-\`\`\``);
-  }
-  if (tokensInline) {
-    sections.push(`DTCG token data (for token kind lookups):
-\`\`\`json
-${tokensInline}
-\`\`\``);
-  }
-  if (tokenMapInline) {
-    sections.push(`Token-name sidecar (raw name \u2192 DTCG path):
-\`\`\`json
-${tokenMapInline}
-\`\`\``);
-  }
-  const filteredTokenProps = generatedCdf ? filterDesignTokenProps(generatedCdf) : void 0;
-  if (filteredTokenProps && Object.keys(filteredTokenProps.filtered).length > 0) {
-    sections.push(`Generated CDF so far \u2014 design-category token props only (JSON):
-\`\`\`json
-${JSON.stringify(filteredTokenProps.filtered)}
-\`\`\``);
-  }
-  if (tokenTree) {
-    sections.push(...buildTokenCandidateSections(tokenTree, filteredTokenProps));
-  }
-  if (componentSourceRefs && componentSourceRefs.length > 0) {
-    sections.push(...formatSourceRefsSection(componentSourceRefs, skill));
+function parseTokenToolCallLines(stdout) {
+  const calls = [];
+  const { objects, warnings } = readToolCallObjects(stdout);
+  for (const rec of objects) {
+    if (!VALID_TOKEN_TOOL_NAMES.has(rec.tool))
+      continue;
+    if (rec.tool === "set_token") {
+      if (typeof rec.path !== "string" || !rec.path) {
+        warnings.push("set_token missing path \u2014 skipped");
+        continue;
+      }
+      if (typeof rec.type !== "string" || !rec.type) {
+        warnings.push(`set_token '${rec.path}': missing type \u2014 skipped`);
+        continue;
+      }
+      if (!("value" in rec)) {
+        warnings.push(`set_token '${rec.path}': missing value \u2014 skipped`);
+        continue;
+      }
+      const call = { tool: "set_token", path: rec.path, type: rec.type, value: rec.value };
+      if (typeof rec.description === "string")
+        call.description = rec.description;
+      calls.push(call);
+    } else if (rec.tool === "set_group") {
+      if (typeof rec.path !== "string" || !rec.path) {
+        warnings.push("set_group missing path \u2014 skipped");
+        continue;
+      }
+      const call = { tool: "set_group", path: rec.path };
+      if (typeof rec.description === "string")
+        call.description = rec.description;
+      calls.push(call);
+    }
   }
-  const inputBlock = sections.length > 0 ? `
-
-${sections.join("\n\n")}` : "";
-  if (skill === "components")
-    return buildComponentsAutonomousPreamble(inputBlock);
-  if (skill === "select")
-    return buildSelectAutonomousPreamble(inputBlock);
-  if (skill === "map-tokens")
-    return buildMapTokensAutonomousPreamble(inputBlock);
-  return buildTokensAutonomousPreamble(inputBlock);
+  return { calls, warnings };
 }
-var init_build_preamble = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/helpers/build-preamble.js"() {
-    "use strict";
-    init_format_token_candidates();
-    init_format_source_refs();
-    init_build_skill_preambles();
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/prompts/build-prompt.js
-async function buildPrompt(options) {
-  const skillContent = options.skillContentOverride ?? await readSkillFile(options.skill, options.skillPathOverride);
-  const preamble = buildPreamble(options);
-  return `${preamble}
-
-Skill instructions follow:
----
-${skillContent}`;
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((v) => typeof v === "string");
 }
-var init_build_prompt = __esm({
-  "packages/experience-design-system-generation/dist/src/services/prompts/build-prompt.js"() {
-    "use strict";
-    init_resolve_skill_file();
-    init_build_preamble();
-    init_resolve_skill_file();
+function parseMapTokenPropToolCallLines(stdout) {
+  const calls = [];
+  const warnings = [];
+  for (const raw of stdout.split("\n")) {
+    const line = raw.trim();
+    if (!line.startsWith("{"))
+      continue;
+    let obj;
+    try {
+      obj = JSON.parse(line);
+    } catch {
+      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
+      continue;
+    }
+    if (typeof obj !== "object" || obj === null || !("tool" in obj))
+      continue;
+    const rec = obj;
+    if (rec.tool !== "map_token_prop")
+      continue;
+    if (typeof rec.component !== "string" || !rec.component) {
+      warnings.push("map_token_prop missing component \u2014 skipped");
+      continue;
+    }
+    if (typeof rec.prop !== "string" || !rec.prop) {
+      warnings.push(`map_token_prop '${rec.component}': missing prop \u2014 skipped`);
+      continue;
+    }
+    if (!isStringArray(rec.token_allowed) || rec.token_allowed.length === 0) {
+      warnings.push(`map_token_prop '${rec.component}.${String(rec.prop)}': missing or empty token_allowed \u2014 skipped`);
+      continue;
+    }
+    const call = {
+      tool: "map_token_prop",
+      component: rec.component,
+      prop: rec.prop,
+      token_allowed: rec.token_allowed
+    };
+    calls.push(call);
   }
-});
-
-// packages/experience-design-system-generation/dist/src/orchestrator/execute-generation-orchestrator.js
-async function executeGenerationOrchestrator(request2) {
-  const prompt = await buildPrompt(request2.promptOptions);
-  return request2.invoker.invoke({
-    agent: request2.agent,
-    model: request2.model,
-    bedrock: request2.bedrock,
-    prompt,
-    timeoutMs: request2.timeoutMs,
-    onOutput: request2.onOutput
-  });
+  return { calls, warnings };
 }
-var init_execute_generation_orchestrator = __esm({
-  "packages/experience-design-system-generation/dist/src/orchestrator/execute-generation-orchestrator.js"() {
-    "use strict";
-    init_build_prompt();
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/resolve-agent-binary.js
-function resolveAgentBinary(agent) {
+function resolveBinary(agent) {
   const envKey = `EDS_AGENT_BINARY_${agent.toUpperCase()}`;
   const override = process.env[envKey];
   if (override && override.trim())
     return override.trim();
   return AGENT_BINARIES[agent];
 }
-var init_resolve_agent_binary = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/resolve-agent-binary.js"() {
-    "use strict";
-    init_agent_names();
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/build-agent-args.js
 function agentSupportsBedrock(agent) {
   return BEDROCK_CAPABLE_AGENTS.has(agent);
 }
-function withBedrockProviderPrefix(model) {
-  return model.includes("/") ? model : `amazon-bedrock/${model}`;
-}
 function resolveAgentModel(agent, explicit, bedrock = false) {
   if (explicit && explicit.trim())
     return explicit.trim();
@@ -676,11 +442,14 @@ function resolveAgentModel(agent, explicit, bedrock = false) {
     return withBedrockProviderPrefix(DEFAULT_OPENCODE_MODEL);
   return DEFAULT_MODELS[agent];
 }
+function withBedrockProviderPrefix(model) {
+  return model.includes("/") ? model : `amazon-bedrock/${model}`;
+}
 function codexBedrockConfigArgs() {
   const region = process.env.AWS_REGION?.trim() || process.env.AWS_DEFAULT_REGION?.trim() || DEFAULT_CODEX_BEDROCK_REGION;
   return ["-c", "model_provider=amazon-bedrock", "-c", `model_providers.amazon-bedrock.region=${region}`];
 }
-function buildAgentArgs(agent, prompt, model, promptViaStdin = false, bedrock = false) {
+function buildArgs(agent, prompt, model, promptViaStdin = false, bedrock = false) {
   const resolvedModel = resolveAgentModel(agent, model, bedrock);
   const modelArg = resolvedModel ? ["--model", resolvedModel] : [];
   const promptArg = promptViaStdin ? [] : [prompt];
@@ -702,69 +471,12 @@ function buildAgentArgs(agent, prompt, model, promptViaStdin = false, bedrock =
     }
   }
 }
-var BEDROCK_ENV_BY_AGENT, BEDROCK_CAPABLE_AGENTS, DEFAULT_CODEX_BEDROCK_REGION, DEFAULT_OPENCODE_MODEL, DEFAULT_CODEX_BEDROCK_MODEL, DEFAULT_MODELS;
-var init_build_agent_args = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/build-agent-args.js"() {
-    "use strict";
-    BEDROCK_ENV_BY_AGENT = {
-      claude: { CLAUDE_CODE_USE_BEDROCK: "1" }
-    };
-    BEDROCK_CAPABLE_AGENTS = /* @__PURE__ */ new Set(["claude", "codex", "opencode"]);
-    DEFAULT_CODEX_BEDROCK_REGION = "us-east-1";
-    DEFAULT_OPENCODE_MODEL = "claude-haiku-4-5";
-    DEFAULT_CODEX_BEDROCK_MODEL = "openai.gpt-5.6-luna";
-    DEFAULT_MODELS = {
-      claude: "haiku",
-      opencode: DEFAULT_OPENCODE_MODEL,
-      cursor: "gpt-mini",
-      copilot: "Auto"
-    };
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/describe-agent-failure.js
-function describeAgentFailure(result, maxDetail = 800) {
-  const base = result.exitCode !== 0 ? `agent exited with code ${result.exitCode}` : "agent produced no tool calls";
-  const detail = (result.stderr.trim() || result.stdout.trim()).slice(-maxDetail).trim();
-  return detail ? `${base} \u2014 ${detail}` : base;
-}
-var init_describe_agent_failure = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/describe-agent-failure.js"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/extract-sentinel-output.js
-function extractSentinelOutput(stdout) {
-  const START = "<<<EDS_OUTPUT_START>>>";
-  const END = "<<<EDS_OUTPUT_END>>>";
-  const startIdx = stdout.indexOf(START);
-  const endIdx = stdout.indexOf(END);
-  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx)
-    return null;
-  const secondStart = stdout.indexOf(START, startIdx + START.length);
-  if (secondStart !== -1 && secondStart < endIdx)
-    return "multiple";
-  const afterStart = stdout.indexOf(END, startIdx);
-  const secondEnd = stdout.indexOf(END, afterStart + END.length);
-  if (secondEnd !== -1)
-    return "multiple";
-  return stdout.slice(startIdx + START.length, endIdx).trim();
-}
-var init_extract_sentinel_output = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/extract-sentinel-output.js"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/run-agent.js
-import { spawn } from "node:child_process";
 async function runAgent(options) {
   const { agent, prompt, timeoutMs, model, onOutput, promptViaStdin, onDebugEvent } = options;
   const bedrock = options.bedrock ?? process.env.EDS_BEDROCK === "1";
-  const binary = resolveAgentBinary(agent);
+  const binary = resolveBinary(agent);
   const useStdin2 = !!promptViaStdin;
-  const args = buildAgentArgs(agent, prompt, model, useStdin2, bedrock);
+  const args = buildArgs(agent, prompt, model, useStdin2, bedrock);
   const startedAt = Date.now();
   onDebugEvent?.("run.start", {
     agent,
@@ -807,7 +519,12 @@ async function runAgent(options) {
     });
     child.on("close", (code, signal) => {
       clearTimeout(timer);
-      const result = { exitCode: signal ? 1 : code ?? 1, stdout, stderr, timedOut };
+      const result = {
+        exitCode: signal ? 1 : code ?? 1,
+        stdout,
+        stderr,
+        timedOut
+      };
       onDebugEvent?.("run.end", {
         agent,
         model,
@@ -823,21 +540,22 @@ async function runAgent(options) {
     });
   });
 }
-var init_run_agent = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/run-agent.js"() {
-    "use strict";
-    init_resolve_agent_binary();
-    init_build_agent_args();
-    init_describe_agent_failure();
-    init_extract_sentinel_output();
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/check-claude-auth.js
-import { spawn as spawn2 } from "node:child_process";
-function checkClaudeAuth(binary) {
+async function checkAgentAuth(agent) {
+  const binary = resolveBinary(agent);
+  const binaryExists2 = await new Promise((resolve21) => {
+    if (binary.startsWith("/")) {
+      import("node:fs/promises").then((fs2) => fs2.access(binary).then(() => resolve21(true), () => resolve21(false)));
+      return;
+    }
+    const child = spawn(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
+    child.on("close", (code) => resolve21(code === 0));
+  });
+  if (!binaryExists2)
+    return "not-found";
+  if (agent !== "claude")
+    return "ok";
   return new Promise((resolve21) => {
-    const child = spawn2(binary, ["auth", "status", "--json"], {
+    const child = spawn(binary, ["auth", "status", "--json"], {
       stdio: ["ignore", "pipe", "pipe"]
     });
     let stdout = "";
@@ -870,39 +588,63 @@ function checkClaudeAuth(binary) {
     });
   });
 }
-var init_check_claude_auth = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/check-claude-auth.js"() {
-    "use strict";
-  }
-});
-
-// packages/experience-design-system-generation/dist/src/services/agent/helpers/check-agent-auth.js
-import { spawn as spawn3 } from "node:child_process";
-async function checkAgentAuth(agent) {
-  const binary = resolveAgentBinary(agent);
-  const binaryExists2 = await new Promise((resolve21) => {
-    if (binary.startsWith("/")) {
-      import("node:fs/promises").then((fs2) => fs2.access(binary).then(() => resolve21(true), () => resolve21(false)));
-      return;
-    }
-    const child = spawn3(process.platform === "win32" ? "where" : "which", [binary], { stdio: "ignore" });
-    child.on("close", (code) => resolve21(code === 0));
-  });
-  if (!binaryExists2)
-    return "not-found";
-  if (agent !== "claude")
-    return "ok";
-  return checkClaudeAuth(binary);
+function describeAgentFailure(result, maxDetail = 800) {
+  const base = result.exitCode !== 0 ? `agent exited with code ${result.exitCode}` : "agent produced no tool calls";
+  const detail = (result.stderr.trim() || result.stdout.trim()).slice(-maxDetail).trim();
+  return detail ? `${base} \u2014 ${detail}` : base;
+}
+function extractSentinelOutput(stdout) {
+  const START = "<<<EDS_OUTPUT_START>>>";
+  const END = "<<<EDS_OUTPUT_END>>>";
+  const startIdx = stdout.indexOf(START);
+  const endIdx = stdout.indexOf(END);
+  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx)
+    return null;
+  const secondStart = stdout.indexOf(START, startIdx + START.length);
+  if (secondStart !== -1 && secondStart < endIdx)
+    return "multiple";
+  const afterStart = stdout.indexOf(END, startIdx);
+  const secondEnd = stdout.indexOf(END, afterStart + END.length);
+  if (secondEnd !== -1)
+    return "multiple";
+  return stdout.slice(startIdx + START.length, endIdx).trim();
 }
-var init_check_agent_auth = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/helpers/check-agent-auth.js"() {
+var VALID_SELECT_TOOL_NAMES, VALID_TOOL_NAMES, VALID_TOKEN_TOOL_NAMES, VALID_CDF_TYPES, VALID_CATEGORIES, AGENT_BINARIES, BEDROCK_ENV_BY_AGENT, BEDROCK_CAPABLE_AGENTS, DEFAULT_CODEX_BEDROCK_REGION, DEFAULT_OPENCODE_MODEL, DEFAULT_MODELS, DEFAULT_CODEX_BEDROCK_MODEL;
+var init_agent_runner = __esm({
+  "packages/experience-design-system-generation/dist/src/agent-runner.js"() {
     "use strict";
-    init_resolve_agent_binary();
-    init_check_claude_auth();
+    init_agent_names();
+    VALID_SELECT_TOOL_NAMES = /* @__PURE__ */ new Set(["select_component", "reject_component"]);
+    VALID_TOOL_NAMES = /* @__PURE__ */ new Set(["classify_prop", "exclude_prop", "classify_component", "classify_slot"]);
+    VALID_TOKEN_TOOL_NAMES = /* @__PURE__ */ new Set(["set_token", "set_group"]);
+    VALID_CDF_TYPES = /* @__PURE__ */ new Set(["string", "richtext", "media", "enum", "token", "boolean"]);
+    VALID_CATEGORIES = /* @__PURE__ */ new Set(["content", "design", "state"]);
+    AGENT_BINARIES = {
+      claude: "claude",
+      codex: "codex",
+      opencode: "opencode",
+      cursor: "cursor-agent",
+      copilot: "copilot"
+    };
+    BEDROCK_ENV_BY_AGENT = {
+      claude: { CLAUDE_CODE_USE_BEDROCK: "1" }
+    };
+    BEDROCK_CAPABLE_AGENTS = /* @__PURE__ */ new Set(["claude", "codex", "opencode"]);
+    DEFAULT_CODEX_BEDROCK_REGION = "us-east-1";
+    DEFAULT_OPENCODE_MODEL = "claude-haiku-4-5";
+    DEFAULT_MODELS = {
+      claude: "haiku",
+      opencode: DEFAULT_OPENCODE_MODEL,
+      cursor: "gpt-mini",
+      // cursor alias for gpt-5.4-mini-medium; haiku not in cursor's catalog
+      copilot: "Auto"
+      // the only model guaranteed on every Copilot plan (Free/Pro/Business/Enterprise); Pro+ users override via EDS_AGENT_MODEL_COPILOT
+    };
+    DEFAULT_CODEX_BEDROCK_MODEL = "openai.gpt-5.6-luna";
   }
 });
 
-// packages/experience-design-system-generation/dist/src/services/agent/local-cli-agent-invoker.js
+// packages/experience-design-system-generation/dist/src/agent-invoker.js
 function createLocalCliAgentInvoker(options = {}) {
   const { onDebugEvent } = options;
   return {
@@ -914,310 +656,381 @@ function createLocalCliAgentInvoker(options = {}) {
     }
   };
 }
-var init_local_cli_agent_invoker = __esm({
-  "packages/experience-design-system-generation/dist/src/services/agent/local-cli-agent-invoker.js"() {
+var init_agent_invoker = __esm({
+  "packages/experience-design-system-generation/dist/src/agent-invoker.js"() {
     "use strict";
-    init_run_agent();
-    init_check_agent_auth();
+    init_agent_runner();
   }
 });
 
-// packages/experience-design-system-generation/dist/src/controller/create-generation-endpoint.js
-function createGenerationEndpoint(options = {}) {
-  const invoker2 = createLocalCliAgentInvoker({ onDebugEvent: options.onDebugEvent });
-  return {
-    async run(request2) {
-      validateGenerationRequest(request2);
-      return executeGenerationOrchestrator({ ...request2, invoker: invoker2 });
-    },
-    checkAuth(agent) {
-      return invoker2.checkAuth(agent);
-    }
-  };
+// packages/experience-design-system-generation/dist/src/prompt-builder.js
+import { existsSync } from "node:fs";
+import { readFile as readFile2 } from "node:fs/promises";
+import { dirname, join as join2, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { flattenDTCG } from "@contentful/experience-design-system-types";
+function formatCustomPromptBanner(skill, path) {
+  return `WARNING: Custom prompt active for ${skill}: ${path}
+  Bundled invariants (utility-wrapper rejection, description content rules) do NOT apply.
+  You are responsible for the prompt's correctness.
+`;
 }
-var init_create_generation_endpoint = __esm({
-  "packages/experience-design-system-generation/dist/src/controller/create-generation-endpoint.js"() {
-    "use strict";
-    init_validate_generation_request();
-    init_execute_generation_orchestrator();
-    init_local_cli_agent_invoker();
-  }
-});
+async function buildPrompt(options) {
+  const skillContent = options.skillContentOverride ?? await readSkillFile(options.skill, options.skillPathOverride);
+  const preamble = buildPreamble(options);
+  return `${preamble}
 
-// packages/experience-design-system-generation/dist/src/services/parsing/helpers/read-tool-call-objects.js
-function findJsonObjectEnd(line) {
-  let depth = 0;
-  let inString = false;
-  let escaped = false;
-  for (let i = 0; i < line.length; i++) {
-    const ch = line[i];
-    if (escaped) {
-      escaped = false;
-    } else if (ch === "\\" && inString) {
-      escaped = true;
-    } else if (ch === '"') {
-      inString = !inString;
-    } else if (!inString && ch === "{") {
-      depth++;
-    } else if (!inString && ch === "}" && --depth === 0) {
-      return i;
+Skill instructions follow:
+---
+${skillContent}`;
+}
+function resolveSkillPath(skill) {
+  if (!(skill in SKILL_FILES))
+    throw new Error(`Invalid skill: ${skill}`);
+  const thisDir = dirname(fileURLToPath(import.meta.url));
+  let dir = thisDir;
+  for (; ; ) {
+    const candidate = join2(dir, "skills");
+    if (existsSync(candidate))
+      return join2(candidate, SKILL_FILES[skill]);
+    const parent = resolve(dir, "..");
+    if (parent === dir) {
+      throw new Error(`skill file missing from CLI installation (could not locate skills/ directory from: ${thisDir})`);
     }
+    dir = parent;
   }
-  return -1;
 }
-function readToolCallObjects(stdout) {
-  const objects = [];
-  const warnings = [];
-  for (const raw of stdout.split("\n")) {
-    const line = raw.trim();
-    if (!line.startsWith("{"))
-      continue;
-    const end = findJsonObjectEnd(line);
-    if (end === -1) {
-      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
-      continue;
-    }
-    let parsed;
+async function readSkillFile(skill, override) {
+  if (override) {
+    const skillPath2 = resolve(override);
     try {
-      parsed = JSON.parse(line.slice(0, end + 1));
+      return await readFile2(skillPath2, "utf8");
     } catch {
-      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
-      continue;
-    }
-    const trailing = line.slice(end + 1);
-    if (trailing.trim()) {
-      warnings.push(`ignored trailing content after JSON: ${trailing.trim().slice(0, 120)}`);
-    }
-    if (typeof parsed === "object" && parsed !== null && "tool" in parsed) {
-      objects.push(parsed);
+      throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath2})`);
     }
   }
-  return { objects, warnings };
-}
-var init_read_tool_call_objects = __esm({
-  "packages/experience-design-system-generation/dist/src/services/parsing/helpers/read-tool-call-objects.js"() {
-    "use strict";
+  const skillPath = resolveSkillPath(skill);
+  try {
+    return await readFile2(skillPath, "utf8");
+  } catch {
+    throw new Error(`skill file missing from CLI installation \u2014 try reinstalling the CLI (looked for: ${skillPath})`);
   }
-});
-
-// packages/experience-design-system-generation/dist/src/services/parsing/parse-prop-tool-calls.js
-function parsePropToolCallLines(stdout) {
-  const calls = [];
-  const { objects, warnings } = readToolCallObjects(stdout);
-  for (const rec of objects) {
-    if (!VALID_TOOL_NAMES.has(rec.tool)) {
-      warnings.push(`unknown tool: ${String(rec.tool)}`);
+}
+function inferFenceLang(filename) {
+  if (!filename)
+    return "json";
+  const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+  const map = {
+    js: "js",
+    mjs: "js",
+    cjs: "js",
+    ts: "ts",
+    mts: "ts",
+    cts: "ts",
+    tsx: "tsx",
+    jsx: "jsx",
+    vue: "vue",
+    svelte: "svelte",
+    astro: "astro",
+    scss: "scss",
+    sass: "scss",
+    css: "css",
+    json: "json",
+    json5: "json"
+  };
+  return map[ext] ?? "text";
+}
+function filterDesignTokenProps(cdf) {
+  const result = {};
+  const kinds = /* @__PURE__ */ new Set();
+  let hasUnscoped = false;
+  for (const [componentName, component] of Object.entries(cdf)) {
+    const properties = component.$properties;
+    if (!properties)
       continue;
-    }
-    const tool = rec.tool;
-    if (tool === "classify_prop") {
-      if (typeof rec.prop !== "string" || !rec.prop) {
-        warnings.push("classify_prop missing prop name \u2014 skipped");
-        continue;
-      }
-      if (typeof rec.cdf_type !== "string" || !VALID_CDF_TYPES.has(rec.cdf_type)) {
-        warnings.push(`classify_prop '${rec.prop}': invalid cdf_type '${String(rec.cdf_type)}' \u2014 skipped`);
-        continue;
-      }
-      if (typeof rec.cdf_category !== "string" || !VALID_CATEGORIES.has(rec.cdf_category)) {
-        warnings.push(`classify_prop '${rec.prop}': invalid cdf_category '${String(rec.cdf_category)}' \u2014 skipped`);
-        continue;
-      }
-      const call = {
-        tool: "classify_prop",
-        prop: rec.prop,
-        cdf_type: rec.cdf_type,
-        cdf_category: rec.cdf_category
-      };
-      if (Array.isArray(rec.values) && rec.values.every((v) => typeof v === "string"))
-        call.values = rec.values;
-      if (typeof rec.token_kind === "string")
-        call.token_kind = rec.token_kind;
-      if (typeof rec.required === "boolean")
-        call.required = rec.required;
-      if (typeof rec.description === "string")
-        call.description = rec.description;
-      if (typeof rec.default === "string" || typeof rec.default === "boolean")
-        call.default = rec.default;
-      if (typeof rec.reason === "string")
-        call.reason = rec.reason;
-      calls.push(call);
-    } else if (tool === "exclude_prop") {
-      if (typeof rec.prop !== "string" || !rec.prop) {
-        warnings.push("exclude_prop missing prop name \u2014 skipped");
-        continue;
-      }
-      calls.push({ tool: "exclude_prop", prop: rec.prop, reason: typeof rec.reason === "string" ? rec.reason : "" });
-    } else if (tool === "classify_component") {
-      const call = { tool: "classify_component" };
-      if (typeof rec.description === "string")
-        call.description = rec.description;
-      if (typeof rec.rationale === "object" && rec.rationale !== null) {
-        const r = rec.rationale;
-        const rationale = {};
-        if (typeof r.description === "string")
-          rationale.description = r.description;
-        if (typeof r.props === "string")
-          rationale.props = r.props;
-        if (typeof r.slots === "string")
-          rationale.slots = r.slots;
-        if (Object.keys(rationale).length > 0)
-          call.rationale = rationale;
-      }
-      calls.push(call);
-    } else if (tool === "classify_slot") {
-      if (typeof rec.slot !== "string" || !rec.slot) {
-        warnings.push("classify_slot missing slot name \u2014 skipped");
-        continue;
-      }
-      const call = { tool: "classify_slot", slot: rec.slot };
-      if (typeof rec.required === "boolean")
-        call.required = rec.required;
-      if (Array.isArray(rec.allowed_components) && rec.allowed_components.every((v) => typeof v === "string")) {
-        call.allowed_components = rec.allowed_components;
+    const filteredProps = {};
+    for (const [propName, prop] of Object.entries(properties)) {
+      if (prop.$type === "token" && prop.$category === "design") {
+        const { "$token.allowed": _tokenAllowed, ...rest } = prop;
+        filteredProps[propName] = rest;
+        const kind = prop["$token.kind"];
+        if (typeof kind === "string" && kind.length > 0) {
+          kinds.add(kind);
+        } else {
+          hasUnscoped = true;
+        }
       }
-      if (typeof rec.description === "string")
-        call.description = rec.description;
-      if (typeof rec.rationale === "string")
-        call.rationale = rec.rationale;
-      calls.push(call);
+    }
+    if (Object.keys(filteredProps).length > 0) {
+      result[componentName] = { ...component, $properties: filteredProps };
     }
   }
-  return { calls, warnings };
+  return { filtered: result, kinds: [...kinds].sort(), hasUnscoped };
 }
-var VALID_TOOL_NAMES, VALID_CDF_TYPES, VALID_CATEGORIES;
-var init_parse_prop_tool_calls = __esm({
-  "packages/experience-design-system-generation/dist/src/services/parsing/parse-prop-tool-calls.js"() {
-    "use strict";
-    init_read_tool_call_objects();
-    VALID_TOOL_NAMES = /* @__PURE__ */ new Set(["classify_prop", "exclude_prop", "classify_component", "classify_slot"]);
-    VALID_CDF_TYPES = /* @__PURE__ */ new Set(["string", "richtext", "media", "enum", "token", "boolean"]);
-    VALID_CATEGORIES = /* @__PURE__ */ new Set(["content", "design", "state"]);
+function formatTokenCandidateLines(entries) {
+  return entries.map((entry) => `${entry.path} \xB7 ${entry.$type}`).join("\n");
+}
+function renderTokenCandidateSection(kind, entries) {
+  const label = kind ? `Token path index \u2014 ${kind} candidates only` : "Token path index \u2014 full tree (no $token.kind to scope by)";
+  return `${label}, one leaf token per line as \`path \xB7 type\`, no \`$value\`:
+${formatTokenCandidateLines(entries)}`;
+}
+function buildPreamble(options) {
+  const { skill, rawComponentsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline } = options;
+  const sections = [];
+  if (existingComponentsInline) {
+    sections.push(`Existing components in the target Contentful space (JSON) \u2014 use for alignment, not as a hard filter:
+\`\`\`json
+${existingComponentsInline}
+\`\`\``);
+  }
+  if (existingTokensInline) {
+    sections.push(`Existing design tokens in the target Contentful space (JSON) \u2014 prefer binding to these paths over inventing new ones:
+\`\`\`json
+${existingTokensInline}
+\`\`\``);
+  }
+  if (componentAllowlistInline) {
+    sections.push(`Known component names for slot allowed_components (hard allowlist; never use any other name):
+\`\`\`json
+${componentAllowlistInline}
+\`\`\``);
+  }
+  if (rawComponentsInline) {
+    sections.push(`Raw component data (JSON):
+\`\`\`json
+${rawComponentsInline}
+\`\`\``);
+  }
+  if (rawTokensInline) {
+    const lang = inferFenceLang(rawTokensFilename);
+    const label = rawTokensFilename ? `Raw token source (${rawTokensFilename})` : "Raw token source";
+    sections.push(`${label}:
+\`\`\`${lang}
+${rawTokensInline}
+\`\`\``);
+  }
+  if (tokensInline) {
+    sections.push(`DTCG token data (for token kind lookups):
+\`\`\`json
+${tokensInline}
+\`\`\``);
+  }
+  if (tokenMapInline) {
+    sections.push(`Token-name sidecar (raw name \u2192 DTCG path):
+\`\`\`json
+${tokenMapInline}
+\`\`\``);
+  }
+  const filteredTokenProps = generatedCdf ? filterDesignTokenProps(generatedCdf) : void 0;
+  if (filteredTokenProps && Object.keys(filteredTokenProps.filtered).length > 0) {
+    sections.push(`Generated CDF so far \u2014 design-category token props only (JSON):
+\`\`\`json
+${JSON.stringify(filteredTokenProps.filtered)}
+\`\`\``);
   }
-});
-
-// packages/experience-design-system-generation/dist/src/services/parsing/parse-select-tool-calls.js
-function parseSelectToolCallLines(stdout) {
-  const calls = [];
-  const { objects, warnings } = readToolCallObjects(stdout);
-  for (const rec of objects) {
-    if (!VALID_SELECT_TOOL_NAMES.has(rec.tool))
-      continue;
-    if (typeof rec.name !== "string" || !rec.name) {
-      warnings.push(`${String(rec.tool)} missing name \u2014 skipped`);
-      continue;
-    }
-    const call = { tool: rec.tool, name: rec.name };
-    if (typeof rec.reason === "string")
-      call.reason = rec.reason;
-    if (typeof rec.confidence === "number" && rec.confidence >= 1 && rec.confidence <= 5) {
-      if (call.tool === "select_component") {
-        call.confidence = rec.confidence;
+  if (tokenTree) {
+    const index = flattenDTCG(tokenTree, "").sort((a, b) => a.path.localeCompare(b.path));
+    if (index.length > 0) {
+      if (filteredTokenProps) {
+        const { kinds, hasUnscoped } = filteredTokenProps;
+        for (const kind of kinds) {
+          const scoped = index.filter((entry) => entry.$type === kind);
+          if (scoped.length > 0)
+            sections.push(renderTokenCandidateSection(kind, scoped));
+        }
+        if (hasUnscoped)
+          sections.push(renderTokenCandidateSection(null, index));
       } else {
-        call.confidence = rec.confidence;
+        sections.push(renderTokenCandidateSection(null, index));
       }
     }
-    calls.push(call);
-  }
-  return { calls, warnings };
-}
-var VALID_SELECT_TOOL_NAMES;
-var init_parse_select_tool_calls = __esm({
-  "packages/experience-design-system-generation/dist/src/services/parsing/parse-select-tool-calls.js"() {
-    "use strict";
-    init_read_tool_call_objects();
-    VALID_SELECT_TOOL_NAMES = /* @__PURE__ */ new Set(["select_component", "reject_component"]);
   }
-});
+  if (componentSourceRefs && componentSourceRefs.length > 0) {
+    const withContent = componentSourceRefs.filter((ref) => ref.content != null);
+    const withoutContent = componentSourceRefs.filter((ref) => ref.content == null);
+    if (withContent.length > 0) {
+      const blocks = withContent.map((ref) => {
+        const mainBlock = `#### ${ref.component} (\`${ref.sourcePath}\`)
+\`\`\`${inferFenceLang(ref.sourcePath)}
+${ref.content}
+\`\`\``;
+        const siblingBlocks = (ref.siblingFiles ?? []).map((sibling) => `##### ${ref.component} \u2014 imported file \`${sibling.path}\`
+\`\`\`${inferFenceLang(sibling.path)}
+${sibling.content}
+\`\`\``);
+        const truncationNote = ref.truncatedSiblingCount && ref.truncatedSiblingCount > 0 ? [
+          `##### ${ref.component} \u2014 +${ref.truncatedSiblingCount} more imported file${ref.truncatedSiblingCount === 1 ? "" : "s"} not shown (evidence may be incomplete)`
+        ] : [];
+        const notShownNote = ref.usesNotShown && ref.usesNotShown.length > 0 ? [
+          `##### ${ref.component} \u2014 uses not shown: ${ref.usesNotShown.join(", ")}
 
-// packages/experience-design-system-generation/dist/src/services/parsing/parse-token-tool-calls.js
-function parseTokenToolCallLines(stdout) {
-  const calls = [];
-  const { objects, warnings } = readToolCallObjects(stdout);
-  for (const rec of objects) {
-    if (!VALID_TOKEN_TOOL_NAMES.has(rec.tool))
-      continue;
-    if (rec.tool === "set_token") {
-      if (typeof rec.path !== "string" || !rec.path) {
-        warnings.push("set_token missing path \u2014 skipped");
-        continue;
-      }
-      if (typeof rec.type !== "string" || !rec.type) {
-        warnings.push(`set_token '${rec.path}': missing type \u2014 skipped`);
-        continue;
-      }
-      if (!("value" in rec)) {
-        warnings.push(`set_token '${rec.path}': missing value \u2014 skipped`);
-        continue;
-      }
-      const call = { tool: "set_token", path: rec.path, type: rec.type, value: rec.value };
-      if (typeof rec.description === "string")
-        call.description = rec.description;
-      calls.push(call);
-    } else if (rec.tool === "set_group") {
-      if (typeof rec.path !== "string" || !rec.path) {
-        warnings.push("set_group missing path \u2014 skipped");
-        continue;
-      }
-      const call = { tool: "set_group", path: rec.path };
-      if (typeof rec.description === "string")
-        call.description = rec.description;
-      calls.push(call);
+The files above are excerpts, and each of these properties has at least one use that fell outside the excerpt budget. Treat their consumption as unknown, not absent: do not classify them \`token\` on what is shown, and do not conclude they are unread.`
+        ] : [];
+        return [mainBlock, ...siblingBlocks, ...truncationNote, ...notShownNote].join("\n\n");
+      });
+      sections.push(`### Component source references
+
+${blocks.join("\n\n")}`);
+    }
+    if (withoutContent.length > 0) {
+      const guidance = skill === "components" ? "there is no consumption evidence for these, so `token` cannot be earned for any of their props \u2014 classify from the prop signature alone, and any prop that would otherwise be enum-versus-token is `enum` (or `string`)" : "there is no source evidence to narrow from \u2014 emit nothing for their props";
+      sections.push(`Component source unavailable for (JSON) \u2014 ${guidance}:
+\`\`\`json
+${JSON.stringify(withoutContent.map((ref) => ({ component: ref.component, sourcePath: ref.sourcePath })))}
+\`\`\``);
     }
   }
-  return { calls, warnings };
-}
-var VALID_TOKEN_TOOL_NAMES;
-var init_parse_token_tool_calls = __esm({
-  "packages/experience-design-system-generation/dist/src/services/parsing/parse-token-tool-calls.js"() {
-    "use strict";
-    init_read_tool_call_objects();
-    VALID_TOKEN_TOOL_NAMES = /* @__PURE__ */ new Set(["set_token", "set_group"]);
+  const inputBlock = sections.length > 0 ? `
+
+${sections.join("\n\n")}` : "";
+  if (skill === "components") {
+    return buildComponentsAutonomousPreamble(inputBlock);
   }
-});
+  if (skill === "select") {
+    return buildSelectAutonomousPreamble(inputBlock);
+  }
+  if (skill === "map-tokens") {
+    return buildMapTokensAutonomousPreamble(inputBlock);
+  }
+  return buildTokensAutonomousPreamble(inputBlock);
+}
+function buildComponentsAutonomousPreamble(inputBlock) {
+  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
 
-// packages/experience-design-system-generation/dist/src/services/parsing/parse-map-token-tool-calls.js
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((v) => typeof v === "string");
+Context: You are classifying a React component for **Contentful Experience Orchestration**. The result is a Component Type \u2014 a schema that tells Contentful what a marketer can configure. Properties fall into three categories:
+- **design**: controls how the component looks (variant, size, color, layout toggles)
+- **content**: the data a content editor fills in (text, images, URLs, rich text)
+- **state**: runtime behavioral flags (disabled, loading, expanded, identifiers)
+
+Your task: classify every prop and slot in the component below. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a "description" field on each tool call to document your reasoning so the developer can review it afterward.
+
+All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
+
+## Output protocol
+
+Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each classification decision. The CLI reads your stdout line by line and writes each decision directly to the pipeline database.
+
+The four tool calls you may emit are:
+
+\`\`\`
+{"tool":"classify_component","description":"<optional component-level description>","rationale":{"description":"<why this component is classified the way it is>","props":"<why these props were chosen>","slots":"<why these slots were chosen>"}}
+
+{"tool":"classify_prop","prop":"<propName>","cdf_type":"<type>","cdf_category":"<category>","required":<bool>,"description":"<short customer-facing description>","reason":"<full internal rationale; not customer-facing>","values":["a","b"],"token_kind":"color","default":"<value>"}
+
+{"tool":"exclude_prop","prop":"<propName>","reason":"<why excluded>"}
+
+{"tool":"classify_slot","slot":"<slotName>","required":<bool>,"allowed_components":["ComponentName"],"description":"<reason>","rationale":"<why this slot was kept in the catalog>"}
+\`\`\`
+
+Rules:
+- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences around the lines.
+- Every prop in the input must have exactly one call: either classify_prop or exclude_prop.
+- Every slot in the input must have exactly one classify_slot call.
+- Valid cdf_type values: string, richtext, media, enum, token, boolean
+- Valid cdf_category values: content, design, state
+- For enum type, always include \`values\` (non-empty string array of the variant names the prop accepts).
+- For token type, always include \`token_kind\` (DTCG $type, e.g. "color"). **Never emit \`values\` for \`cdf_type: "token"\` props** \u2014 an enum prop's list holds variant names; a token prop's list holds design token paths, produced separately and never by you. Emitting \`values\` on a token prop makes the definition invalid.
+- Never emit both "values" and "token_kind" on one prop.
+- \`enum\` vs \`token\` is decided by three questions answered in order from the source shown \u2014 never from the TypeScript type. Q1: does the component look the value up, switch on it, or have a vocabulary for it (\`tokens[x]\`, \`switch (variant)\`, \`allowedValues\`)? yes \u2192 \`enum\`, stop.
+- Q2: is the value written straight into a style or attribute (\`rx={radius}\`, \`padding: \${padding}\`)? no \u2192 not \`token\`, apply the type rules.
+- Q3: is there a design-token reference at that use \u2014 a \`tokens.*\` parameter default, a \`tokenReference\`, an inline \`tokens.*\` / \`var(--*)\`? yes \u2192 \`token\` (cite both lines in "reason"); no \u2192 \`string\`. "Ambiguity resolves to \`enum\`" applies only when Q1\u2013Q3 cannot be answered from the source shown.
+- CSS design props (className, style, styles, positional/geometric props: top, bottom, left, right, rotation, offset, etc.) \u2192 classify_prop, cdf_type: "string", cdf_category: "design".
+- For \`classify_slot.allowed_components\`, use only exact names from the hard allowlist provided below. Never invent a child from an import, JSX element, type name, icon name, or implementation helper; if a child is not listed, omit it.
+- On classify_component, "rationale" fields are operator-facing (read-only) but may surface in customer-facing exports. The "rationale.description" field is subject to the description content rules in the skill prompt (no internal initiative names). "rationale.props" and "rationale.slots" describe your reasoning about scope; "classify_slot.rationale" explains why each slot was kept.
+- On classify_prop, "reason" is REQUIRED and is the LLM's internal rationale \u2014 shown to the developer reviewing the import, never to end-users. "description" is the customer-facing copy and is subject to the description content rules in the skill prompt. Keep them distinct: "description" is short and customer-facing; "reason" explains your reasoning in detail.
+- You may emit prose lines (not starting with {) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
 }
-function parseMapTokenPropToolCallLines(stdout) {
-  const calls = [];
-  const warnings = [];
-  for (const raw of stdout.split("\n")) {
-    const line = raw.trim();
-    if (!line.startsWith("{"))
-      continue;
-    let obj;
-    try {
-      obj = JSON.parse(line);
-    } catch {
-      warnings.push(`unparseable line: ${line.slice(0, 120)}`);
-      continue;
-    }
-    if (typeof obj !== "object" || obj === null || !("tool" in obj))
-      continue;
-    const rec = obj;
-    if (rec.tool !== "map_token_prop")
-      continue;
-    if (typeof rec.component !== "string" || !rec.component) {
-      warnings.push("map_token_prop missing component \u2014 skipped");
-      continue;
-    }
-    if (typeof rec.prop !== "string" || !rec.prop) {
-      warnings.push(`map_token_prop '${rec.component}': missing prop \u2014 skipped`);
-      continue;
-    }
-    if (!isStringArray(rec.token_allowed) || rec.token_allowed.length === 0) {
-      warnings.push(`map_token_prop '${rec.component}.${String(rec.prop)}': missing or empty token_allowed \u2014 skipped`);
-      continue;
-    }
-    calls.push({ tool: "map_token_prop", component: rec.component, prop: rec.prop, token_allowed: rec.token_allowed });
-  }
-  return { calls, warnings };
+function buildSelectAutonomousPreamble(inputBlock) {
+  return `You are running as part of the experience-design-system-cli import pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
+
+Your task: review the components provided below and decide whether each belongs in Contentful Experience Orchestration as a Component Type. The input is a JSON array \u2014 you may receive 1\u2013N components in a single message. Emit one tool call per input component, named after the component. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a brief "reason" to document your reasoning for each decision.
+
+Key rule: accept any component that renders visible UI \u2014 atoms, molecules, and organisms are all valid Component Types in Contentful Experience Orchestration. Reject only components that produce zero visual output: React hooks, pure context providers, A/B testing or variant-routing wrappers, analytics trackers, and security utilities. Do NOT reject a component because it has few props, is low-level, or has some A/B testing or personalization-related props mixed in \u2014 those props are handled in the generate step.
+
+All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
+
+## Output protocol
+
+Do NOT write any files or emit any JSON blobs. Instead, emit JSON tool calls one per line to stdout. The CLI reads your stdout line by line.
+
+The two tool calls \u2014 emit exactly one per input component:
+
+\`\`\`
+{"tool":"select_component","name":"<ComponentName>","reason":"<brief reason>"}
+
+{"tool":"reject_component","name":"<ComponentName>","reason":"<brief reason>"}
+\`\`\`
+
+Rules:
+- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences.
+- Emit exactly one tool call per input component. The "name" field must match a component name from the input array exactly. Tool calls may appear in any order.
+- You may emit prose lines (not starting with {) to reason before each tool call \u2014 they are ignored by the parser.`;
+}
+function buildMapTokensAutonomousPreamble(inputBlock) {
+  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
+
+Context: The components below already have design-category, token-typed props (\`$token.kind\` set). Your task is to decide, from source evidence, whether to narrow each one to a restricted subset (\`token_allowed\`) of the tokens matching its \`$token.kind\`. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation.
+
+All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
+
+## Output protocol
+
+Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each prop you narrow. The CLI reads your stdout line by line and writes each decision directly to the pipeline database.
+
+The one tool call you may emit:
+
+\`\`\`
+{"tool":"map_token_prop","component":"<ComponentName>","prop":"<propName>","token_allowed":["colors.brand.primary","colors.brand.secondary"]}
+\`\`\`
+
+Rules:
+- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences around the lines.
+- Only emit a call for a prop that appears in the "Generated CDF so far" section.
+- Each "Token path index" section below is already scoped to one \`$token.kind\` \u2014 a prop only draws candidates from the section matching its own \`$token.kind\` (or the "full tree" section, for a prop with no \`$token.kind\`). Never cross sections, never emit a group/prefix path, and never invent a path \u2014 every entry in \`token_allowed\` must exist verbatim in the matching section.
+- \`token_allowed\` is required and must be non-empty when the call is emitted.
+- For the judgment call of whether a prop should be narrowed at all, follow the decision tree in the map-tokens skill file: it explains defaults vs. restrictions, misclassified variant-name props, and when to emit nothing.
+- You may emit prose lines (not starting with \`{\`) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
+}
+function buildTokensAutonomousPreamble(inputBlock) {
+  return `You are running as part of the experience-design-system-cli generate pipeline in AUTONOMOUS mode. The developer is not present to answer questions.
+
+Your task: classify every raw token from the input below into a DTCG token tree. Apply all judgment calls yourself \u2014 do not pause to ask for confirmation. Include a "description" field on each set_token call to document your reasoning.
+
+All input data is provided inline below \u2014 do not read any additional files.${inputBlock}
+
+## Output protocol
+
+Do NOT write any files or emit any JSON blobs. Instead, emit one JSON object per line to stdout for each token or group. The CLI reads your stdout line by line and writes each entry directly to the pipeline database.
+
+The two tool calls you may emit are:
+
+\`\`\`
+{"tool":"set_group","path":"<dot.notation.path>","description":"<optional group description>"}
+
+{"tool":"set_token","path":"<dot.notation.path>","type":"<DTCG type>","value":<value>,"description":"<reason>"}
+\`\`\`
+
+Rules:
+- Emit exactly one JSON object per line. No multi-line JSON. No markdown fences.
+- Emit a set_group call for every intermediate group node in the tree.
+- Emit a set_token call for every leaf token.
+- "path" is dot-notation, e.g. "colors.brand.primary" \u2014 no leading dots or slashes.
+- "type" must be one of the 13 valid DTCG types: color, dimension, fontFamily, fontWeight, duration, cubicBezier, number, strokeStyle, border, transition, shadow, gradient, typography.
+- "value" must be valid JSON (string, number, array, or object depending on the type). Do NOT wrap it in quotes if it is a complex type.
+- Emit set_group calls before the set_token calls that fall under them.
+- You may emit prose lines (not starting with {) anywhere \u2014 they are ignored by the parser and serve as your reasoning log.`;
 }
-var init_parse_map_token_tool_calls = __esm({
-  "packages/experience-design-system-generation/dist/src/services/parsing/parse-map-token-tool-calls.js"() {
+var SKILL_FILES;
+var init_prompt_builder = __esm({
+  "packages/experience-design-system-generation/dist/src/prompt-builder.js"() {
     "use strict";
+    SKILL_FILES = {
+      components: "generate-components.md",
+      tokens: "generate-tokens.md",
+      select: "select-components.md",
+      "map-tokens": "map-tokens.md"
+    };
   }
 });
 
@@ -1234,17 +1047,14 @@ var init_progress = __esm({
 // packages/experience-design-system-generation/dist/src/index.js
 var src_exports = {};
 __export(src_exports, {
-  AGENT_BINARIES: () => AGENT_BINARIES,
   AGENT_NAMES: () => AGENT_NAMES,
   DEFAULT_AGENT_NAME: () => DEFAULT_AGENT_NAME,
   agentSupportsBedrock: () => agentSupportsBedrock,
-  buildArgs: () => buildAgentArgs,
+  buildArgs: () => buildArgs,
   buildPrompt: () => buildPrompt,
   checkAgentAuth: () => checkAgentAuth,
-  createGenerationEndpoint: () => createGenerationEndpoint,
   createLocalCliAgentInvoker: () => createLocalCliAgentInvoker,
   describeAgentFailure: () => describeAgentFailure,
-  executeGenerationOrchestrator: () => executeGenerationOrchestrator,
   extractSentinelOutput: () => extractSentinelOutput,
   formatCustomPromptBanner: () => formatCustomPromptBanner,
   formatGenerateProgressLine: () => formatGenerateProgressLine,
@@ -1252,9 +1062,9 @@ __export(src_exports, {
   parseMapTokenPropToolCallLines: () => parseMapTokenPropToolCallLines,
   parseSelectToolCallLines: () => parseSelectToolCallLines,
   parseTokenToolCallLines: () => parseTokenToolCallLines,
-  parseToolCallLines: () => parsePropToolCallLines,
+  parseToolCallLines: () => parseToolCallLines,
   resolveAgentModel: () => resolveAgentModel,
-  resolveBinary: () => resolveAgentBinary,
+  resolveBinary: () => resolveBinary,
   resolveSkillPath: () => resolveSkillPath,
   runAgent: () => runAgent
 });
@@ -1262,19 +1072,10 @@ var init_src = __esm({
   "packages/experience-design-system-generation/dist/src/index.js"() {
     "use strict";
     init_agent_names();
-    init_create_generation_endpoint();
-    init_execute_generation_orchestrator();
-    init_build_agent_args();
-    init_resolve_agent_binary();
-    init_check_agent_auth();
-    init_run_agent();
-    init_parse_prop_tool_calls();
-    init_parse_select_tool_calls();
-    init_parse_token_tool_calls();
-    init_parse_map_token_tool_calls();
-    init_build_prompt();
+    init_agent_runner();
+    init_agent_invoker();
+    init_prompt_builder();
     init_progress();
-    init_local_cli_agent_invoker();
   }
 });
 
@@ -5109,7 +4910,7 @@ async function readFileInline(path) {
   return parts.filter(Boolean).join("\n\n");
 }
 function printFallbackInstructions(options) {
-  const binary = resolveAgentBinary(options.agent);
+  const binary = resolveBinary(options.agent);
   const skillPath = resolveSkillPath(options.skill);
   const lines = [
     `Error: agent '${options.agent}' not found in $PATH (looked for binary: ${binary}).`,
@@ -5324,7 +5125,7 @@ ${outputBuf}`);
       lastError = describeAgentFailure(result);
       continue;
     }
-    const { calls, warnings } = parsePropToolCallLines(result.stdout);
+    const { calls, warnings } = parseToolCallLines(result.stdout);
     if (calls.length === 0) {
       lastError = describeAgentFailure(result);
       continue;
@@ -5570,7 +5371,7 @@ async function runGenerateSkill(skill, opts, verbose = false) {
     process.stdout.write(prompt + "\n");
     await exitWithAnalytics(0);
   }
-  const binary = resolveAgentBinary(agent);
+  const binary = resolveBinary(agent);
   if (!await assertBinaryInPath(binary)) {
     printFallbackInstructions({
       agent,
@@ -9231,7 +9032,7 @@ ${defaultDiagnostics.map((diagnostic) => `  ${diagnostic}`).join("\n")}
         return;
       }
     }
-    const binary = resolveAgentBinary(agent);
+    const binary = resolveBinary(agent);
     if (!await assertBinaryInPath(binary)) {
       die(
         `Error: agent '${agent}' not found in $PATH (looked for binary: ${binary}).
@@ -18943,9 +18744,9 @@ var init_wizard_generate_progress = __esm({
 });
 
 // packages/experience-design-system-cli-legacy/src/import/tui/spawn-generate.ts
-import { spawn as spawn4 } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 function spawnGenerateChild(opts) {
-  const child = spawn4(opts.command, opts.args);
+  const child = spawn2(opts.command, opts.args);
   let stdout = "";
   let stderr = "";
   child.stdout?.on("data", (d) => {
@@ -27258,7 +27059,7 @@ import { join as join20, resolve as resolve17 } from "node:path";
 import { appendFileSync as appendFileSync2, writeFileSync } from "node:fs";
 import { access as access7, stat as stat5, writeFile as writeFile6 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { execFile as execFile2, spawn as spawn5 } from "node:child_process";
+import { execFile as execFile2, spawn as spawn3 } from "node:child_process";
 import { mkdir as mkdir5 } from "node:fs/promises";
 import { buildCDF as buildCDF3, validateCDF as validateCDF3, validateSlotReferences as validateSlotReferences2 } from "@contentful/experience-design-system-types";
 import { jsx as jsx50, jsxs as jsxs43 } from "react/jsx-runtime";
@@ -27320,7 +27121,7 @@ function runCli(args) {
 }
 function runSpawnedCli(args, onStderr, onStdout) {
   return new Promise((res) => {
-    const child = spawn5("node", args);
+    const child = spawn3("node", args);
     let stdout = "";
     let stderr = "";
     child.stdout.on("data", (d) => {
@@ -29615,7 +29416,7 @@ var init_agent_definitions = __esm({
 });
 
 // packages/experience-design-system-cli-legacy/src/setup/lib/shell.ts
-import { execFile as execFile3, spawn as spawn6 } from "node:child_process";
+import { execFile as execFile3, spawn as spawn4 } from "node:child_process";
 import { access as access8 } from "node:fs/promises";
 import { promisify as promisify2 } from "node:util";
 async function binaryExists(name) {
@@ -29631,7 +29432,7 @@ async function pathExists3(path) {
 }
 function runSpawn(cmd, args, opts = {}) {
   return new Promise((resolve21) => {
-    const child = spawn6(cmd, args, {
+    const child = spawn4(cmd, args, {
       cwd: opts.cwd,
       env: opts.env ?? process.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -32061,7 +31862,7 @@ __export(program_exports, {
   resolveBedrockFromAncestors: () => resolveBedrockFromAncestors,
   runBuild: () => runBuild
 });
-import { spawn as spawn7 } from "node:child_process";
+import { spawn as spawn5 } from "node:child_process";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { dirname as dirname13, join as join26, resolve as resolve20 } from "node:path";
 import { readFileSync as readFileSync10 } from "node:fs";
@@ -32096,7 +31897,7 @@ function registerBuildCommand(program) {
     const pkgRoot = resolve20(dirname13(fileURLToPath4(import.meta.url)), "..", "..");
     process.stderr.write("\u2699  Building from source...\n");
     const { exitCode } = await runBuild({
-      spawnFn: () => spawn7("pnpm", ["build"], { cwd: pkgRoot, stdio: "inherit" }),
+      spawnFn: () => spawn5("pnpm", ["build"], { cwd: pkgRoot, stdio: "inherit" }),
       stderrWrite: (s) => process.stderr.write(s)
     });
     process.exit(exitCode);