@contentful/experience-design-system-generation 2.35.1-dev-build-b8da2525.0 → 2.35.1-dev-build-e1cfef52.0

package/dist/src/services/prompts/helpers/format-token-candidates.js

@@ -1,27 +1,27 @@
-import { flattenDTCG } from "@contentful/experience-design-system-types";
+import { flattenDTCG } from '@contentful/experience-design-system-types';
 export function inferFenceLang(filename) {
     if (!filename)
-        return "json";
-    const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+        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",
+        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 map[ext] ?? 'text';
 }
 export function filterDesignTokenProps(cdf) {
     const result = {};
@@ -33,11 +33,11 @@ export function filterDesignTokenProps(cdf) {
             continue;
         const filteredProps = {};
         for (const [propName, prop] of Object.entries(properties)) {
-            if (prop.$type === "token" && prop.$category === "design") {
-                const { "$token.allowed": _tokenAllowed, ...rest } = prop;
+            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) {
+                const kind = prop['$token.kind'];
+                if (typeof kind === 'string' && kind.length > 0) {
                     kinds.add(kind);
                 }
                 else {
@@ -52,15 +52,15 @@ export function filterDesignTokenProps(cdf) {
     return { filtered: result, kinds: [...kinds].sort(), hasUnscoped };
 }
 export function buildTokenCandidateSections(tokenTree, filteredTokenProps) {
-    const index = flattenDTCG(tokenTree, "").sort((a, b) => a.path.localeCompare(b.path));
+    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 — ${kind} candidates only`
-            : "Token path index — full tree (no $token.kind to scope by)";
-        const lines = entries.map((e) => `${e.path} · ${e.$type}`).join("\n");
+            : 'Token path index — full tree (no $token.kind to scope by)';
+        const lines = entries.map((e) => `${e.path} · ${e.$type}`).join('\n');
         return `${label}, one leaf token per line as \`path · type\`, no \`$value\`:\n${lines}`;
     };
     if (filteredTokenProps) {

package/dist/src/services/prompts/helpers/resolve-skill-file.d.ts

@@ -1,4 +1,4 @@
-import type { Skill } from "../../../types/prompt.js";
+import type { Skill } from '../../../types/prompt.js';
 export declare function resolveSkillPath(skill: Skill): string;
-export declare function formatCustomPromptBanner(skill: "components" | "select", path: string): string;
+export declare function formatCustomPromptBanner(skill: 'components' | 'select', path: string): string;
 export declare function readSkillFile(skill: Skill, override?: string): Promise<string>;

package/dist/src/services/prompts/helpers/resolve-skill-file.js

@@ -1,12 +1,13 @@
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 const SKILL_FILES = {
-    components: "generate-components.md",
-    tokens: "generate-tokens.md",
-    select: "select-components.md",
-    "map-tokens": "map-tokens.md",
+    components: 'generate-components.md',
+    tokens: 'generate-tokens.md',
+    select: 'select-components.md',
+    'debate-select': 'debate-select.md',
+    'map-tokens': 'map-tokens.md',
 };
 export function resolveSkillPath(skill) {
     if (!(skill in SKILL_FILES))
@@ -14,10 +15,10 @@ export function resolveSkillPath(skill) {
     const thisDir = dirname(fileURLToPath(import.meta.url));
     let dir = thisDir;
     for (;;) {
-        const candidate = join(dir, "skills");
+        const candidate = join(dir, 'skills');
         if (existsSync(candidate))
             return join(candidate, SKILL_FILES[skill]);
-        const parent = resolve(dir, "..");
+        const parent = resolve(dir, '..');
         if (parent === dir) {
             throw new Error(`skill file missing from CLI installation (could not locate skills/ directory from: ${thisDir})`);
         }
@@ -33,7 +34,7 @@ export async function readSkillFile(skill, override) {
     if (override) {
         const skillPath = resolve(override);
         try {
-            return await readFile(skillPath, "utf8");
+            return await readFile(skillPath, 'utf8');
         }
         catch {
             throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath})`);
@@ -41,7 +42,7 @@ export async function readSkillFile(skill, override) {
     }
     const skillPath = resolveSkillPath(skill);
     try {
-        return await readFile(skillPath, "utf8");
+        return await readFile(skillPath, 'utf8');
     }
     catch {
         throw new Error(`skill file missing from CLI installation — try reinstalling the CLI (looked for: ${skillPath})`);

package/dist/src/types/agent.d.ts

@@ -1,4 +1,4 @@
-import type { AgentName } from "../agent-names.js";
+import type { AgentName } from '../agent-names.js';
 export type { AgentName };
 export interface AgentRunResult {
     exitCode: number;
@@ -6,5 +6,5 @@ export interface AgentRunResult {
     stderr: string;
     timedOut: boolean;
 }
-export type AgentAuthStatus = "ok" | "unauthenticated" | "not-found";
+export type AgentAuthStatus = 'ok' | 'unauthenticated' | 'not-found';
 export type AgentDebugEvent = (name: string, payload?: Record<string, unknown>) => void;

package/dist/src/types/contract.d.ts

@@ -1,6 +1,6 @@
-import type { AgentName } from "../agent-names.js";
-import type { AgentAuthStatus, AgentDebugEvent } from "./agent.js";
-import type { PromptOptions } from "./prompt.js";
+import type { AgentName } from '../agent-names.js';
+import type { AgentAuthStatus, AgentDebugEvent } from './agent.js';
+import type { PromptOptions } from './prompt.js';
 export interface GenerationEndpointRequest {
     readonly agent: AgentName;
     readonly model?: string;

package/dist/src/types/invoker.d.ts

@@ -1,5 +1,5 @@
-import type { AgentName } from "../agent-names.js";
-import type { AgentAuthStatus, AgentDebugEvent, AgentRunResult } from "./agent.js";
+import type { AgentName } from '../agent-names.js';
+import type { AgentAuthStatus, AgentDebugEvent, AgentRunResult } from './agent.js';
 export interface InvokeAgentOptions {
     agent: AgentName;
     model?: string;

package/dist/src/types/prompt.d.ts

@@ -1,6 +1,7 @@
-import type { CDFComponentEntry } from "@contentful/experience-design-system-types";
-export type Skill = "components" | "tokens" | "select" | "map-tokens";
-export type Mode = "autonomous";
+import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
+export type Skill = 'components' | 'tokens' | 'select' | 'debate-select' | 'map-tokens';
+export type DebateRole = 'for' | 'against';
+export type Mode = 'autonomous';
 export interface ComponentSourceRef {
     component: string;
     sourcePath: string;
@@ -23,6 +24,10 @@ export interface PromptOptions {
     skill: Skill;
     mode: Mode;
     rawComponentsInline?: string;
+    /** For the debate-select skill: which side of the disagreement this agent argues. */
+    debateRole?: DebateRole;
+    /** For the debate-select skill: JSON-serialized disagreement under review. */
+    disagreementInline?: string;
     propBucketsInline?: string;
     rawTokensInline?: string;
     /** Original filename for raw tokens — used to set the correct code fence language. */

package/dist/src/types/tool-calls.d.ts

@@ -1,8 +1,8 @@
 export interface ClassifyPropCall {
-    tool: "classify_prop";
+    tool: 'classify_prop';
     prop: string;
     cdf_type: string;
-    cdf_category: "content" | "design" | "state";
+    cdf_category: 'content' | 'design' | 'state';
     values?: string[];
     token_kind?: string;
     required?: boolean;
@@ -12,12 +12,12 @@ export interface ClassifyPropCall {
     reason?: string;
 }
 export interface ExcludePropCall {
-    tool: "exclude_prop";
+    tool: 'exclude_prop';
     prop: string;
     reason: string;
 }
 export interface ClassifyComponentCall {
-    tool: "classify_component";
+    tool: 'classify_component';
     description?: string;
     /**
      * Component-level rationale strings. Surfaced by the `I` ComponentRationalePanel.
@@ -31,7 +31,7 @@ export interface ClassifyComponentCall {
     };
 }
 export interface ClassifySlotCall {
-    tool: "classify_slot";
+    tool: 'classify_slot';
     slot: string;
     required?: boolean;
     allowed_components?: string[];
@@ -57,14 +57,14 @@ export interface SelectionSlotEvidence {
     reason: string;
 }
 export interface SelectComponentCall {
-    tool: "select_component";
+    tool: 'select_component';
     name: string;
     reason?: string;
     confidence?: number;
     slot_evidence?: SelectionSlotEvidence[];
 }
 export interface RejectComponentCall {
-    tool: "reject_component";
+    tool: 'reject_component';
     name: string;
     reason?: string;
     confidence?: number;
@@ -75,14 +75,14 @@ export interface ParsedSelectToolCalls {
     warnings: string[];
 }
 export interface SetTokenCall {
-    tool: "set_token";
+    tool: 'set_token';
     path: string;
     type: string;
     value: unknown;
     description?: string;
 }
 export interface SetGroupCall {
-    tool: "set_group";
+    tool: 'set_group';
     path: string;
     description?: string;
 }
@@ -92,7 +92,7 @@ export interface ParsedTokenToolCalls {
     warnings: string[];
 }
 export interface MapTokenPropCall {
-    tool: "map_token_prop";
+    tool: 'map_token_prop';
     component: string;
     prop: string;
     /** Narrowed subset of tokens the prop may draw from. Required and non-empty. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-generation",
-  "version": "2.35.1-dev-build-b8da2525.0",
+  "version": "2.35.1-dev-build-e1cfef52.0",
   "description": "Agent-invocation and skill-prompt engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",
@@ -22,7 +22,7 @@
     "skills/"
   ],
   "dependencies": {
-    "@contentful/experience-design-system-types": "2.35.1-dev-build-b8da2525.0"
+    "@contentful/experience-design-system-types": "2.35.1-dev-build-e1cfef52.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",

package/skills/debate-select.md

@@ -0,0 +1,23 @@
+# Debate component selection
+
+This skill is used after independent component-selection agents disagree about an interpretive question. The caller supplies one component, its source evidence, the disagreement record, and your role (for or against).
+
+The caller dispatches a blind FOR/AGAINST pair; argue only the side named in your prompt and do not assume or describe the other participant's response.
+
+## Scope
+
+- Argue only the exact disagreement in the prompt.
+- Use the supplied component data and citations as the evidence base.
+- For slot-realness or allowed-component questions, reason from concrete caller evidence rather than from a ReactNode-shaped prop alone.
+- Keep the argument specific enough for an orchestrator to make an independent determination.
+- Do not write files, call tools, or invent evidence that is not present in the prompt.
+
+## Output protocol
+
+Emit exactly one JSON object on one line:
+
+~~~json
+{"role":"for","disagreement_id":"d1","argument":"...","evidence":[{"source":"src/Panel.tsx","line":"42","quote":"<Card><Badge /></Card>"}]}
+~~~
+
+Use the role and disagreement ID supplied by the caller. evidence must be an array of objects with source, line, and quote strings; use an empty array when no citable source evidence is supplied.