@contentful/experience-design-system-generation 2.35.1-dev-build-f520d7cb.0 → 2.35.1-dev-build-459d7e23.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-generation",
-  "version": "2.35.1-dev-build-f520d7cb.0",
+  "version": "2.35.1-dev-build-459d7e23.0",
   "description": "Agent-invocation and skill-prompt engine for the Contentful Experience Design System SDK",
   "license": "MIT",
   "type": "module",

package/dist/src/index.d.ts

@@ -2,7 +2,7 @@ export { AGENT_NAMES, AGENT_BINARIES, DEFAULT_AGENT_NAME, isAgentName } from './
 export type { AgentName } from './agent-names.js';
 export type { AgentAuthStatus, AgentDebugEvent, AgentRunResult } from './types/agent.js';
 export type { ClassifyComponentCall, ClassifyPropCall, ClassifySlotCall, ExcludePropCall, MapTokenPropCall, ParsedMapTokenPropToolCalls, ParsedSelectToolCalls, ParsedTokenToolCalls, ParsedToolCalls, RejectComponentCall, SelectComponentCall, SelectToolCall, SelectionSlotEvidence, SelectionSlotEvidenceCitation, SetGroupCall, SetTokenCall, ToolCall, TokenToolCall, } from './types/tool-calls.js';
-export type { ComponentSourceRef, GeneratedCdf, Mode, PromptOptions, Skill } from './types/prompt.js';
+export type { ComponentSourceRef, DebateRole, GeneratedCdf, Mode, PromptOptions, Skill } from './types/prompt.js';
 export { createGenerationEndpoint } from './controller/create-generation-endpoint.js';
 export type { GenerationEndpoint, GenerationEndpointOptions, GenerationEndpointRequest, GenerationEndpointResponse, } from './controller/create-generation-endpoint.js';
 export { executeGenerationOrchestrator } from './orchestrator/execute-generation-orchestrator.js';

package/dist/src/progress.d.ts

@@ -1,8 +1,8 @@
 /**
  * Formats a structured generation-progress line for the wizard parser.
  *
- * Emitted at terminal completion of each component (success, cache hit,
- * pinned hit, or final failure). `done` represents the count of completed
+ * Emitted at terminal completion of each component (success or final
+ * failure). `done` represents the count of completed
  * components, which is monotonically non-decreasing — unlike the legacy
  * `[index+1/total]` line, which reports input position.
  */

package/dist/src/progress.js

@@ -1,8 +1,8 @@
 /**
  * Formats a structured generation-progress line for the wizard parser.
  *
- * Emitted at terminal completion of each component (success, cache hit,
- * pinned hit, or final failure). `done` represents the count of completed
+ * Emitted at terminal completion of each component (success or final
+ * failure). `done` represents the count of completed
  * components, which is monotonically non-decreasing — unlike the legacy
  * `[index+1/total]` line, which reports input position.
  */

package/dist/src/services/prompts/helpers/build-preamble.js

@@ -1,8 +1,8 @@
 import { inferFenceLang, filterDesignTokenProps, buildTokenCandidateSections } from './format-token-candidates.js';
 import { formatSourceRefsSection } from './format-source-refs.js';
-import { buildComponentsAutonomousPreamble, buildSelectAutonomousPreamble, buildMapTokensAutonomousPreamble, buildTokensAutonomousPreamble, } from './build-skill-preambles.js';
+import { buildComponentsAutonomousPreamble, buildDebateSelectAutonomousPreamble, buildSelectAutonomousPreamble, buildMapTokensAutonomousPreamble, buildTokensAutonomousPreamble, } from './build-skill-preambles.js';
 export function buildPreamble(options) {
-    const { skill, rawComponentsInline, propBucketsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline, } = options;
+    const { skill, rawComponentsInline, propBucketsInline, rawTokensInline, rawTokensFilename, tokensInline, tokenMapInline, generatedCdf, tokenTree, componentSourceRefs, existingComponentsInline, existingTokensInline, componentAllowlistInline, debateRole, disagreementInline, } = options;
     const sections = [];
     if (existingComponentsInline) {
         sections.push(`Existing components in the target Contentful space (JSON) — use for alignment, not as a hard filter:\n\`\`\`json\n${existingComponentsInline}\n\`\`\``);
@@ -45,6 +45,8 @@ export function buildPreamble(options) {
         return buildComponentsAutonomousPreamble(inputBlock);
     if (skill === 'select')
         return buildSelectAutonomousPreamble(inputBlock);
+    if (skill === 'debate-select')
+        return buildDebateSelectAutonomousPreamble(inputBlock, debateRole, disagreementInline);
     if (skill === 'map-tokens')
         return buildMapTokensAutonomousPreamble(inputBlock);
     return buildTokensAutonomousPreamble(inputBlock);

package/dist/src/services/prompts/helpers/build-skill-preambles.d.ts

@@ -1,4 +1,6 @@
+import type { DebateRole } from '../../../types/prompt.js';
 export declare function buildComponentsAutonomousPreamble(inputBlock: string): string;
 export declare function buildSelectAutonomousPreamble(inputBlock: string): string;
 export declare function buildMapTokensAutonomousPreamble(inputBlock: string): string;
 export declare function buildTokensAutonomousPreamble(inputBlock: string): string;
+export declare function buildDebateSelectAutonomousPreamble(inputBlock: string, debateRole: DebateRole | undefined, disagreementInline: string | undefined): string;

package/dist/src/services/prompts/helpers/build-skill-preambles.js

@@ -124,3 +124,34 @@ Rules:
 - Emit set_group calls before the set_token calls that fall under them.
 - You may emit prose lines (not starting with {) anywhere — they are ignored by the parser and serve as your reasoning log.`;
 }
+export function buildDebateSelectAutonomousPreamble(inputBlock, debateRole, disagreementInline) {
+    const role = debateRole ?? 'for';
+    return [
+        'You are the ' +
+            role.toUpperCase() +
+            ' participant in an adversarial review of one component-selection disagreement. This is an automatic escalation stage; do not ask the developer for confirmation.',
+        '',
+        'Your role is to argue the ' +
+            role.toUpperCase() +
+            ' position on the exact disagreement below. Address the claim literally, cite the supplied component evidence, and do not substitute a nearby component or field. The opposing participant is evaluating the same evidence independently.',
+        '',
+        'Component and source data:' + inputBlock,
+        '',
+        'Disagreement under review (JSON):',
+        '~~~json',
+        disagreementInline ?? '{}',
+        '~~~',
+        '',
+        '## Output protocol',
+        '',
+        'Emit exactly one JSON object on one line and do not write files:',
+        '',
+        '~~~json',
+        '{"role":"' +
+            role +
+            '","disagreement_id":"<id>","argument":"<position and reasoning>","evidence":[{"source":"<path>","line":"<line-or-range>","quote":"<verbatim evidence>"}]}',
+        '~~~',
+        '',
+        'The role and disagreement_id must match the values in this prompt. Use an empty evidence array only when the supplied context contains no citable source evidence.',
+    ].join('\n');
+}

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

@@ -6,6 +6,7 @@ const SKILL_FILES = {
     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) {

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

@@ -1,5 +1,6 @@
 import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-export type Skill = 'components' | 'tokens' | 'select' | 'map-tokens';
+export type Skill = 'components' | 'tokens' | 'select' | 'debate-select' | 'map-tokens';
+export type DebateRole = 'for' | 'against';
 export type Mode = 'autonomous';
 export interface ComponentSourceRef {
     component: 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-generation",
-  "version": "2.35.1-dev-build-f520d7cb.0",
+  "version": "2.35.1-dev-build-459d7e23.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-f520d7cb.0"
+    "@contentful/experience-design-system-types": "2.35.1-dev-build-459d7e23.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.