@contentful/experience-design-system-generation 2.36.2-dev-build-7907fec3.0 → 2.36.2-dev-build-a6f80ae6.0

package/dist/src/services/prompts/helpers/format-source-refs.js

@@ -1,31 +0,0 @@
-import { inferFenceLang } from './format-token-candidates.js';
-function formatSourceRefBlock(ref) {
-    const mainBlock = `#### ${ref.component} (\`${ref.sourcePath}\`)\n\`\`\`${inferFenceLang(ref.sourcePath)}\n${ref.content}\n\`\`\``;
-    const siblingBlocks = (ref.siblingFiles ?? []).map((sibling) => `##### ${ref.component} — imported file \`${sibling.path}\`\n\`\`\`${inferFenceLang(sibling.path)}\n${sibling.content}\n\`\`\``);
-    const truncationNote = ref.truncatedSiblingCount && ref.truncatedSiblingCount > 0
-        ? [
-            `##### ${ref.component} — +${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} — uses not shown: ${ref.usesNotShown.join(', ')}\n\nThe 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');
-}
-export 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\n\n${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 — 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 — emit nothing for their props';
-        sections.push(`Component source unavailable for (JSON) — ${guidance}:\n\`\`\`json\n${JSON.stringify(withoutContent.map((ref) => ({ component: ref.component, sourcePath: ref.sourcePath })))}\n\`\`\``);
-    }
-    return sections;
-}

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

@@ -1,8 +0,0 @@
-import type { GeneratedCdf } from '../../../types/prompt.js';
-export declare function inferFenceLang(filename: string | undefined): string;
-export declare function filterDesignTokenProps(cdf: GeneratedCdf): {
-    filtered: GeneratedCdf;
-    kinds: string[];
-    hasUnscoped: boolean;
-};
-export declare function buildTokenCandidateSections(tokenTree: Record<string, unknown>, filteredTokenProps?: ReturnType<typeof filterDesignTokenProps>): string[];

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

@@ -1,80 +0,0 @@
-import { flattenDTCG } from '@contentful/experience-design-system-types';
-export 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';
-}
-export function filterDesignTokenProps(cdf) {
-    const result = {};
-    const kinds = new Set();
-    let hasUnscoped = false;
-    for (const [componentName, component] of Object.entries(cdf)) {
-        const properties = component.$properties;
-        if (!properties)
-            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 };
-        }
-    }
-    return { filtered: result, kinds: [...kinds].sort(), hasUnscoped };
-}
-export 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 — ${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');
-        return `${label}, one leaf token per line as \`path · type\`, no \`$value\`:\n${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;
-}

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

@@ -1,4 +0,0 @@
-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 readSkillFile(skill: Skill, override?: string): Promise<string>;

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

@@ -1,49 +0,0 @@
-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',
-};
-export 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 = join(dir, 'skills');
-        if (existsSync(candidate))
-            return join(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;
-    }
-}
-export function formatCustomPromptBanner(skill, path) {
-    return (`WARNING: Custom prompt active for ${skill}: ${path}\n` +
-        `  Bundled invariants (utility-wrapper rejection, description content rules) do NOT apply.\n` +
-        `  You are responsible for the prompt's correctness.\n`);
-}
-export async function readSkillFile(skill, override) {
-    if (override) {
-        const skillPath = resolve(override);
-        try {
-            return await readFile(skillPath, 'utf8');
-        }
-        catch {
-            throw new Error(`custom prompt file not found (skill: ${skill}, path: ${skillPath})`);
-        }
-    }
-    const skillPath = resolveSkillPath(skill);
-    try {
-        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,10 +0,0 @@
-import type { AgentName } from '../agent-names.js';
-export type { AgentName };
-export interface AgentRunResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-}
-export type AgentAuthStatus = 'ok' | 'unauthenticated' | 'not-found';
-export type AgentDebugEvent = (name: string, payload?: Record<string, unknown>) => void;

package/dist/src/types/agent.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,24 +0,0 @@
-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;
-    readonly bedrock?: boolean;
-    readonly promptOptions: PromptOptions;
-    readonly timeoutMs: number;
-    readonly onOutput?: (chunk: string) => void;
-}
-export interface GenerationEndpointResponse {
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-    readonly timedOut: boolean;
-}
-export interface GenerationEndpointOptions {
-    onDebugEvent?: AgentDebugEvent;
-}
-export interface GenerationEndpoint {
-    run(request: GenerationEndpointRequest): Promise<GenerationEndpointResponse>;
-    checkAuth(agent: AgentName): Promise<AgentAuthStatus>;
-}

package/dist/src/types/contract.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,17 +0,0 @@
-import type { AgentName } from '../agent-names.js';
-import type { AgentAuthStatus, AgentDebugEvent, AgentRunResult } from './agent.js';
-export interface InvokeAgentOptions {
-    agent: AgentName;
-    model?: string;
-    bedrock?: boolean;
-    prompt: string;
-    timeoutMs: number;
-    onOutput?: (chunk: string) => void;
-}
-export interface AgentInvoker {
-    invoke(options: InvokeAgentOptions): Promise<AgentRunResult>;
-    checkAuth(agent: AgentName): Promise<AgentAuthStatus>;
-}
-export interface LocalCliAgentInvokerOptions {
-    onDebugEvent?: AgentDebugEvent;
-}

package/dist/src/types/invoker.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,53 +0,0 @@
-import type { CDFComponentEntry } from '@contentful/experience-design-system-types';
-export type Skill = 'components' | 'tokens' | 'select' | 'map-tokens';
-export type Mode = 'autonomous';
-export interface ComponentSourceRef {
-    component: string;
-    sourcePath: string;
-    content: string | null;
-    siblingFiles?: Array<{
-        path: string;
-        content: string;
-    }>;
-    truncatedSiblingCount?: number;
-    /**
-     * Properties with at least one use that fell outside the excerpt budget of
-     * the file it sits in. The reader cannot see that use, so its absence is a
-     * gap in the evidence, not evidence of absence.
-     */
-    usesNotShown?: string[];
-}
-/** Plain-data shape of the CDF generated so far — component name -> component entry. */
-export type GeneratedCdf = Record<string, CDFComponentEntry>;
-export interface PromptOptions {
-    skill: Skill;
-    mode: Mode;
-    rawComponentsInline?: string;
-    rawTokensInline?: string;
-    /** Original filename for raw tokens — used to set the correct code fence language. */
-    rawTokensFilename?: string;
-    tokensInline?: string;
-    tokenMapInline?: string;
-    outDir: string;
-    /** For components skill only: the single component's name (used in error messages). */
-    componentName?: string;
-    /** For map-tokens skill: the CDF generated so far. Filtered internally to design-category token-typed props only. */
-    generatedCdf?: GeneratedCdf;
-    /** For map-tokens skill: the full DTCG token tree. Flattened internally to a path+`$type` index, with `$value` stripped. */
-    tokenTree?: Record<string, unknown>;
-    /** Component source file references — consumption evidence for the components skill, explicit-restriction evidence for map-tokens. */
-    componentSourceRefs?: ComponentSourceRef[];
-    /**
-     * When set, this absolute or relative `.md` path is read in place of the
-     * bundled skill file. Bundled-prompt invariants do NOT apply.
-     */
-    skillPathOverride?: string;
-    /** Inline prompt instructions, taking precedence over the bundled skill or path override. */
-    skillContentOverride?: string;
-    /** JSON-serialized summary of existing space Components. */
-    existingComponentsInline?: string;
-    /** JSON-serialized summary of existing space DesignTokens. */
-    existingTokensInline?: string;
-    /** JSON-serialized hard allowlist for generated slot allowed-components references. */
-    componentAllowlistInline?: string;
-}

package/dist/src/types/prompt.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,91 +0,0 @@
-export interface ClassifyPropCall {
-    tool: 'classify_prop';
-    prop: string;
-    cdf_type: string;
-    cdf_category: 'content' | 'design' | 'state';
-    values?: string[];
-    token_kind?: string;
-    required?: boolean;
-    description?: string;
-    default?: string | boolean;
-    /** Internal LLM rationale; not customer-facing. Persisted to raw_props.rationale. */
-    reason?: string;
-}
-export interface ExcludePropCall {
-    tool: 'exclude_prop';
-    prop: string;
-    reason: string;
-}
-export interface ClassifyComponentCall {
-    tool: 'classify_component';
-    description?: string;
-    /**
-     * Component-level rationale strings. Surfaced by the `I` ComponentRationalePanel.
-     * Each field is optional; missing fields leave existing DB values untouched
-     * (sparse update semantics in applyToolCalls).
-     */
-    rationale?: {
-        description?: string;
-        props?: string;
-        slots?: string;
-    };
-}
-export interface ClassifySlotCall {
-    tool: 'classify_slot';
-    slot: string;
-    required?: boolean;
-    allowed_components?: string[];
-    description?: string;
-    /** Per-slot rationale; persisted to raw_slots.rationale. */
-    rationale?: string;
-}
-export type ToolCall = ClassifyPropCall | ExcludePropCall | ClassifyComponentCall | ClassifySlotCall;
-export interface ParsedToolCalls {
-    calls: ToolCall[];
-    warnings: string[];
-}
-export interface SelectComponentCall {
-    tool: 'select_component';
-    name: string;
-    reason?: string;
-    confidence?: number;
-}
-export interface RejectComponentCall {
-    tool: 'reject_component';
-    name: string;
-    reason?: string;
-    confidence?: number;
-}
-export type SelectToolCall = SelectComponentCall | RejectComponentCall;
-export interface ParsedSelectToolCalls {
-    calls: SelectToolCall[];
-    warnings: string[];
-}
-export interface SetTokenCall {
-    tool: 'set_token';
-    path: string;
-    type: string;
-    value: unknown;
-    description?: string;
-}
-export interface SetGroupCall {
-    tool: 'set_group';
-    path: string;
-    description?: string;
-}
-export type TokenToolCall = SetTokenCall | SetGroupCall;
-export interface ParsedTokenToolCalls {
-    calls: TokenToolCall[];
-    warnings: string[];
-}
-export interface MapTokenPropCall {
-    tool: 'map_token_prop';
-    component: string;
-    prop: string;
-    /** Narrowed subset of tokens the prop may draw from. Required and non-empty. */
-    token_allowed: string[];
-}
-export interface ParsedMapTokenPropToolCalls {
-    calls: MapTokenPropCall[];
-    warnings: string[];
-}

package/dist/src/types/tool-calls.js

@@ -1 +0,0 @@
-export {};