@contentful/experience-design-system-cli 2.18.1-dev-build-180092e.0 → 2.18.1-dev-build-0f85b83.0

package/README.md

@@ -214,6 +214,7 @@ Pass `--select-prompt-path <path>` and/or `--generate-prompt-path <path>` to swa
 | `--host <url>`                    | `https://api.contentful.com`           | Override API base URL                                                                                        |
 | `--on-conflict <mode>`            | _(prompt via `<SaveConflictGate>`)_    | Headless conflict resolution when a file already exists at the save path: `overwrite`, `skip`, or `fail`. Bypasses the wizard's interactive save-conflict gate. Mutex with `--no-save`. |
 | `--print-prompt`                  | —                                      | Print the generate prompt to stdout and exit. Replaces the prompt-print semantics of `--dry-run`.            |
+| `--allow-deletions`               | off (non-destructive)                  | Allow the push to delete remote ComponentTypes/DesignTokens missing from the manifest. Default skips them instead of deleting. Without this flag, preview responses suppress the removed-entity list and return a count instead; interactive confirm screens show an opt-out toggle (never opt-in) only when the flag is passed. Forwarded to headless subprocess pushes and `--push-from-run`. |
 | `--dry-run`                       | _(deprecated)_                         | Deprecated alias for `--print-prompt`. Emits a stderr deprecation notice; prompt-print semantics will be removed in a future release. |
 
 ### Run-picker at wizard start
@@ -418,7 +419,7 @@ experiences apply select  --space-id <id> --environment-id <env> --session <id>
 experiences apply push    --space-id <id> --environment-id <env> --session <id> [--yes]
 ```
 
-Shared flags: `--components`, `--tokens`, `--session`, `--space-id`, `--environment-id`, `--cma-token`, `--host`, `--viewports`. `apply preview` adds `--include-unchanged`. `apply select` adds `--select-all`, `--select`, `--deselect`, `--force`. `apply push` adds `--yes`, `--verbose`, `--force`, `--dry-run`.
+Shared flags: `--components`, `--tokens`, `--session`, `--space-id`, `--environment-id`, `--cma-token`, `--host`, `--viewports`. `apply preview` adds `--include-unchanged`. `apply select` adds `--select-all`, `--select`, `--deselect`, `--force`, `--allow-deletions`. `apply push` adds `--yes`, `--verbose`, `--force`, `--dry-run`, `--allow-deletions`. By default, remote ComponentTypes and DesignTokens missing from the pushed manifest are skipped, not deleted; pass `--allow-deletions` to restore the prior delete behavior.
 
 Design tokens are written first (component types may reference token kinds). Each entity write is recorded in the session database atomically — interrupted pushes resume from where they left off.
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.18.1-dev-build-180092e.0",
+  "version": "2.18.1-dev-build-0f85b83.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,7 @@
   "files": [
     "bin/",
     "dist/",
+    "skills/",
     "prompts/"
   ],
   "scripts": {
@@ -39,7 +40,6 @@
   "dependencies": {
     "@contentful/experience-design-system-client": "workspace:*",
     "@contentful/experience-design-system-extraction": "workspace:*",
-    "@contentful/experience-design-system-generation": "workspace:*",
     "@contentful/experience-design-system-types": "workspace:*",
     "commander": "^13.1.0",
     "ink": "^4.4.1",

package/dist/src/analyze/command.js

@@ -19,11 +19,11 @@ import { buildCompositionInputHash } from './composition/composition-cache-key.j
 import { runParserInSandbox } from './composition/agent-parser/sandbox.js';
 import { resolveViaAgentParser } from './composition/agent-parser/resolve-via-parser.js';
 import { parsePromptOverrides, resolvePromptOverride } from '../lib/prompt-overrides.js';
-import { DEFAULT_AGENT_NAME, isAgentName, runAgent, } from '@contentful/experience-design-system-generation';
+import { DEFAULT_AGENT_NAME, isAgentName } from '../lib/agent-names.js';
+import { runAgent } from '../generate/agent-runner.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { buildAnalyzeViewRows, partitionGlobalWarnings } from './build-analyze-view-rows.js';
 import { getInteractiveTerminalSupport } from '../lib/terminal-capabilities.js';
-import { getDebugLogger } from '../lib/debug-logger.js';
 const SCANNED_FILE_EXTENSIONS = new Set(['.astro', '.js', '.jsx', '.svelte', '.ts', '.tsx', '.vue']);
 const IGNORED_DIRECTORY_NAMES = new Set([
     '.git',
@@ -351,9 +351,9 @@ export function registerAnalyzeCommand(program) {
                     const res = await runAgent({
                         agent: resolverAgent,
                         prompt,
+                        interactive: false,
                         timeoutMs: 120_000,
                         promptViaStdin: true,
-                        onDebugEvent: (name, payload) => getDebugLogger().event('agent', name, payload),
                     });
                     lastAgentExitCode = res.exitCode;
                     if (res.exitCode !== 0 && res.stderr.trim()) {

package/dist/src/analyze/composition/parse-map-edges.d.ts

@@ -2,7 +2,7 @@ import type { CompositionEdge } from './interchange-schema.js';
 /**
  * Lenient JSONL parser for the composition-mapping agent's tool-call output
  * (spec T4). Mirrors `parseSelectToolCallLines` / `parseToolCallLines` in
- * `@contentful/experience-design-system-generation`'s `agent-runner.ts`: one JSON object per line, each with a `tool`
+ * `src/generate/agent-runner.ts`: one JSON object per line, each with a `tool`
  * field from a fixed allowlist. A line that fails JSON.parse or validation is
  * DROPPED into `warnings[]` (with a reason) and parsing CONTINUES — no retry,
  * no throw. Non-`{` prose and blank lines are skipped silently.

package/dist/src/analyze/select/tui/App.js

@@ -80,7 +80,10 @@ export function App({ sessionId, artifactsRoot, reviewRoot }) {
             if (!manifest.componentsManifest)
                 manifest.componentsManifest = {};
             const client = new ImportApiClient({ cmaToken, spaceId, environmentId });
-            const preview = await client.previewImport(manifest);
+            // This preview is display-only (component-picker annotations); it never
+            // triggers an apply, so always request the full diff to keep the
+            // existing "removed" annotation working.
+            const preview = await client.previewImport(manifest, true);
             const annotations = {};
             for (const item of preview.components.new) {
                 const name = item.name ?? '';

package/dist/src/analyze/select-agent/command.js

@@ -3,21 +3,19 @@ import { openPipelineDb, loadRawComponents, loadScannedFiles, createStep, update
 import { hashPromptForSkill } from '../../session/cache-keys.js';
 import { appendReviewEvent, getRefineArtifactsRoot, ensureRefineSession, getRefineSessionPaths, saveReviewState, } from '../select/persistence.js';
 import { loadReviewInput } from '../select/parser.js';
-import { AGENT_NAMES, buildPrompt, createLocalCliAgentInvoker, formatCustomPromptBanner, isAgentName, parseSelectToolCallLines, } from '@contentful/experience-design-system-generation';
+import { buildPrompt } from '../../generate/prompt-builder.js';
+import { formatCustomPromptBanner } from '../../generate/command.js';
+import { AGENT_NAMES, isAgentName, parseSelectToolCallLines, runAgent } from '../../generate/agent-runner.js';
 import { access } from 'node:fs/promises';
 import { readExperiencesCredentials } from '../../credentials-store.js';
 import { OutputFormatter, c } from '../../output/format.js';
 import { buildRepoContextIndex, buildSelectionContext } from './context-builder.js';
 import { runShowRationale } from './show-rationale.js';
 import { isAbsolute, resolve } from 'node:path';
-import { getDebugLogger } from '../../lib/debug-logger.js';
 import { validateExtractedComponents, shouldExcludeDueToValidation, formatExclusionWarning, } from '@contentful/experience-design-system-extraction';
 const DEFAULT_TIMEOUT_MS = Number(process.env.EDS_AGENT_TIMEOUT_MS ?? 3 * 60 * 1000);
 export const DEFAULT_CONCURRENCY = 10;
 export const DEFAULT_BATCH_SIZE = 5;
-const invoker = createLocalCliAgentInvoker({
-    onDebugEvent: (name, payload) => getDebugLogger().event('agent', name, payload),
-});
 function resolveBatchSize() {
     const raw = process.env.EDS_SELECT_BATCH_SIZE;
     if (!raw)
@@ -111,10 +109,11 @@ async function selectBatch(agent, model, batch, total, verbose, skillPathOverrid
     const formatter = new OutputFormatter(verbose, (s) => {
         outputBuf += s;
     });
-    const result = await invoker.invoke({
+    const result = await runAgent({
         agent,
         model,
         prompt,
+        interactive: false,
         timeoutMs: DEFAULT_TIMEOUT_MS,
         onOutput: (chunk) => formatter.push(chunk),
     });

package/dist/src/apply/api-client.d.ts

@@ -50,8 +50,11 @@ export declare class ImportApiClient {
     private headers;
     private requestWithRetry;
     validateToken(): Promise<void>;
-    previewImport(manifest: ManifestPayload): Promise<ServerPreviewResponse>;
-    applyImport(manifest: ManifestPayload, acknowledgeBreakingChanges: boolean): Promise<ApplyOperationResponse>;
+    previewImport(manifest: ManifestPayload, allowDeletions?: boolean): Promise<ServerPreviewResponse>;
+    applyImport(manifest: ManifestPayload, options: {
+        acknowledgeBreakingChanges: boolean;
+        allowDeletions?: boolean;
+    }): Promise<ApplyOperationResponse>;
     pollOperation(operationId: string, opts?: {
         intervalMs?: number;
         maxIntervalMs?: number;

package/dist/src/apply/api-client.js

@@ -268,19 +268,20 @@ export class ImportApiClient {
             throw new ApiError(`unexpected error validating token: ${res.status}`, res.status, await res.text());
         }
     }
-    async previewImport(manifest) {
+    async previewImport(manifest, allowDeletions = false) {
         const debug = getDebugLogger();
         const startedAt = Date.now();
         debug.event('apply', 'preview.request', {
             url: `${this.base()}/design_systems/imports/preview`,
             componentCount: manifest.components?.length ?? 0,
             tokenCount: manifest.designTokens?.length ?? 0,
+            allowDeletions,
         });
         const result = await this.requestWithRetry('preview', PREVIEW_ERROR_PREFIX, () => designSystemImportSourcelessPreview({
             baseUrl: this.host,
             headers: this.headers(),
             path: { spaceId: this.spaceId, environmentId: this.environmentId },
-            body: manifest,
+            body: { ...manifest, allowDeletions },
             parseAs: 'json',
         }));
         if (!result.response.ok) {
@@ -296,12 +297,14 @@ export class ImportApiClient {
         debug.event('apply', 'preview.ok', { status: result.response.status, durationMs: Date.now() - startedAt });
         return sanitizePreviewResponse(parsed);
     }
-    async applyImport(manifest, acknowledgeBreakingChanges) {
+    async applyImport(manifest, options) {
+        const { acknowledgeBreakingChanges, allowDeletions = false } = options;
         const debug = getDebugLogger();
         const startedAt = Date.now();
         debug.event('apply', 'apply.request', {
             url: `${this.base()}/design_systems/imports/apply`,
             acknowledgeBreakingChanges,
+            allowDeletions,
         });
         let result;
         try {
@@ -309,7 +312,7 @@ export class ImportApiClient {
                 baseUrl: this.host,
                 headers: this.headers(),
                 path: { spaceId: this.spaceId, environmentId: this.environmentId },
-                body: { ...manifest, acknowledgeBreakingChanges },
+                body: { ...manifest, acknowledgeBreakingChanges, allowDeletions },
                 parseAs: 'json',
             });
         }

package/dist/src/apply/command.js

@@ -12,7 +12,7 @@ import { ServerPreviewApp, ServerPreviewConfirm, ServerApplyProgress, ServerAppl
 import { SelectView, makeSelectKey } from './tui/SelectView.js';
 import { buildPostPushUrl } from '../lib/contentful-urls.js';
 import { resolveCompositionMode } from '../lib/composition-mode.js';
-import { addArtifactInputOptions, addCompositionOptions, addContentfulTargetOptions, addSelectionOptions, } from '../lib/command-options.js';
+import { addAllowDeletionsOption, addArtifactInputOptions, addCompositionOptions, addContentfulTargetOptions, addSelectionOptions, } from '../lib/command-options.js';
 import { stripAllowedComponents } from '../import/strip-allowed-components.js';
 import { readExperiencesCredentials } from '../credentials-store.js';
 import { getInteractiveTerminalSupport, requireInteractiveTerminal } from '../lib/terminal-capabilities.js';
@@ -457,6 +457,7 @@ export function registerApplyCommand(program) {
                 preview,
                 spaceId,
                 environmentId,
+                allowDeletions: false,
             }));
             await waitUntilExit();
         }
@@ -469,6 +470,7 @@ export function registerApplyCommand(program) {
     addArtifactInputOptions(pushCmd);
     addContentfulTargetOptions(pushCmd);
     addCompositionOptions(pushCmd);
+    addAllowDeletionsOption(pushCmd);
     pushCmd
         .option('--yes', 'Skip interactive confirmation')
         .option('--verbose', 'Show all entity progress including skipped/unchanged')
@@ -502,7 +504,7 @@ export function registerApplyCommand(program) {
         const manifest = buildManifest(components, tokens);
         let preview;
         try {
-            preview = await client.previewImport(manifest);
+            preview = await client.previewImport(manifest, opts.allowDeletions === true);
         }
         catch (e) {
             if (e instanceof ApiError)
@@ -517,6 +519,7 @@ export function registerApplyCommand(program) {
                     preview,
                     spaceId,
                     environmentId,
+                    allowDeletions: opts.allowDeletions === true,
                 }));
                 await waitUntilExit();
             }
@@ -547,7 +550,10 @@ export function registerApplyCommand(program) {
             }
             let operation;
             try {
-                operation = await client.applyImport(manifest, breakingWithImpact || opts.force === true);
+                operation = await client.applyImport(manifest, {
+                    acknowledgeBreakingChanges: breakingWithImpact || opts.force === true,
+                    allowDeletions: opts.allowDeletions === true,
+                });
             }
             catch (e) {
                 if (e instanceof ApiError)
@@ -569,7 +575,7 @@ export function registerApplyCommand(program) {
             return;
         }
         await new Promise((resolvePromise) => {
-            const runApply = async (acknowledge) => {
+            const runApply = async (acknowledge, applyDeletions) => {
                 instance.rerender(createElement(ServerApplyProgress, {
                     spaceId,
                     environmentId,
@@ -577,7 +583,10 @@ export function registerApplyCommand(program) {
                 }));
                 let operation;
                 try {
-                    operation = await client.applyImport(manifest, acknowledge);
+                    operation = await client.applyImport(manifest, {
+                        acknowledgeBreakingChanges: acknowledge,
+                        allowDeletions: applyDeletions,
+                    });
                 }
                 catch (e) {
                     if (e instanceof ApiError) {
@@ -625,8 +634,9 @@ export function registerApplyCommand(program) {
                 spaceId,
                 environmentId,
                 breakingWithImpact,
-                onConfirm: (acknowledge) => {
-                    void runApply(acknowledge);
+                allowDeletions: opts.allowDeletions === true,
+                onConfirm: (acknowledge, applyDeletions) => {
+                    void runApply(acknowledge, applyDeletions);
                 },
                 onCancel: () => {
                     process.exit(0);
@@ -640,6 +650,7 @@ export function registerApplyCommand(program) {
     addContentfulTargetOptions(selectCmd);
     addCompositionOptions(selectCmd);
     addSelectionOptions(selectCmd);
+    addAllowDeletionsOption(selectCmd);
     selectCmd.option('--force', 'Skip confirmation for breaking changes').action(async (opts) => {
         const nonInteractive = opts.selectAll || (opts.select ?? []).length > 0 || (opts.deselect ?? []).length > 0;
         if (!nonInteractive) {
@@ -669,7 +680,7 @@ export function registerApplyCommand(program) {
         const fullManifest = buildManifest(components, tokens);
         let preview;
         try {
-            preview = await client.previewImport(fullManifest);
+            preview = await client.previewImport(fullManifest, opts.allowDeletions === true);
         }
         catch (e) {
             if (e instanceof ApiError)
@@ -707,7 +718,10 @@ export function registerApplyCommand(program) {
             }
             let operation;
             try {
-                operation = await client.applyImport(filteredManifest, hasBreaking || opts.force === true);
+                operation = await client.applyImport(filteredManifest, {
+                    acknowledgeBreakingChanges: hasBreaking || opts.force === true,
+                    allowDeletions: opts.allowDeletions === true,
+                });
             }
             catch (e) {
                 if (e instanceof ApiError)
@@ -749,7 +763,10 @@ export function registerApplyCommand(program) {
                 }));
                 let operation;
                 try {
-                    operation = await client.applyImport(filteredManifest, hasBreaking);
+                    operation = await client.applyImport(filteredManifest, {
+                        acknowledgeBreakingChanges: hasBreaking,
+                        allowDeletions: opts.allowDeletions === true,
+                    });
                 }
                 catch (e) {
                     if (e instanceof ApiError) {

package/dist/src/apply/preview-utils.d.ts

@@ -7,6 +7,10 @@ import type { ServerPreviewResponse } from '@contentful/experience-design-system
  *     would be a pure no-op (INTEG-4411 refined guard).
  *
  * A push that produces ANY entry in ANY bucket — including a rejection that
- * removes a server-side component — is NOT empty.
+ * removes a server-side component — is NOT empty. Note the server hides
+ * removals entirely (empty removed[]) unless the preview was fetched with
+ * allowDeletions: true, so "empty" here also correctly describes a preview
+ * with pending-but-hidden deletions: pushing without --allow-deletions is a
+ * genuine no-op in that case too, since the apply gate hides them the same way.
  */
 export declare function isEmptyPreview(preview: ServerPreviewResponse): boolean;

package/dist/src/apply/preview-utils.js

@@ -6,7 +6,11 @@
  *     would be a pure no-op (INTEG-4411 refined guard).
  *
  * A push that produces ANY entry in ANY bucket — including a rejection that
- * removes a server-side component — is NOT empty.
+ * removes a server-side component — is NOT empty. Note the server hides
+ * removals entirely (empty removed[]) unless the preview was fetched with
+ * allowDeletions: true, so "empty" here also correctly describes a preview
+ * with pending-but-hidden deletions: pushing without --allow-deletions is a
+ * genuine no-op in that case too, since the apply gate hides them the same way.
  */
 export function isEmptyPreview(preview) {
     const { components, tokens, taxonomies } = preview;

package/dist/src/apply/tui/ServerApplyView.d.ts

@@ -5,16 +5,19 @@ interface ServerPreviewConfirmProps {
     spaceId: string;
     environmentId: string;
     breakingWithImpact: boolean;
-    onConfirm: (acknowledge: boolean) => void;
+    /** The value the preview was actually fetched with. */
+    allowDeletions: boolean;
+    onConfirm: (acknowledge: boolean, allowDeletions: boolean) => void;
     onCancel: () => void;
 }
-export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
+export declare function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions: fetchedAllowDeletions, onConfirm, onCancel, }: ServerPreviewConfirmProps): React.ReactElement;
 interface ServerPreviewAppProps {
     preview: ServerPreviewResponse;
     spaceId: string;
     environmentId: string;
+    allowDeletions: boolean;
 }
-export declare function ServerPreviewApp({ preview, spaceId, environmentId }: ServerPreviewAppProps): React.ReactElement;
+export declare function ServerPreviewApp({ preview, spaceId, environmentId, allowDeletions, }: ServerPreviewAppProps): React.ReactElement;
 interface ServerApplyProgressProps {
     spaceId: string;
     environmentId: string;

package/dist/src/apply/tui/ServerApplyView.js

@@ -1,23 +1,32 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
 import { Box, Text, useInput } from 'ink';
 import { ServerPreviewView } from './ServerPreviewView.js';
 import { buildPostPushUrl } from '../../lib/contentful-urls.js';
 import { formatEdsiError } from '../../lib/error-parser.js';
-export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, onConfirm, onCancel, }) {
+export function ServerPreviewConfirm({ preview, spaceId, environmentId, breakingWithImpact, allowDeletions: fetchedAllowDeletions, onConfirm, onCancel, }) {
+    const [allowDeletions, setAllowDeletions] = useState(fetchedAllowDeletions);
+    const removedCount = preview.components.removed.length + preview.tokens.removed.length;
     useInput((input, key) => {
-        if (key.return)
-            onConfirm(breakingWithImpact);
+        if (key.return) {
+            onConfirm(breakingWithImpact, allowDeletions);
+            return;
+        }
+        if ((input === 'x' || input === 'X') && fetchedAllowDeletions && removedCount > 0) {
+            setAllowDeletions((prev) => !prev);
+            return;
+        }
         if (key.escape || input === 'q')
             onCancel();
     });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }), _jsxs(Box, { paddingX: 2, flexDirection: "column", children: [breakingWithImpact && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 Breaking changes will affect downstream entities. Press Enter to acknowledge and apply."] })), allowDeletions && removedCount > 0 && (_jsxs(Text, { color: "red", bold: true, children: [' ', "\u26A0 ", removedCount, " missing ", removedCount === 1 ? 'entity' : 'entities', " will be permanently deleted. Press Enter to confirm."] })), fetchedAllowDeletions && removedCount > 0 && (_jsxs(Text, { dimColor: true, children: [' ', "[x] ", allowDeletions ? '[✓]' : '[ ]', " Also delete ", removedCount, " ", removedCount === 1 ? 'entity' : 'entities'] })), _jsxs(Text, { children: [' ', "Press ", _jsx(Text, { bold: true, children: "Enter" }), " to apply, ", _jsx(Text, { bold: true, children: "Esc" }), " to cancel"] })] })] }));
 }
-export function ServerPreviewApp({ preview, spaceId, environmentId }) {
+export function ServerPreviewApp({ preview, spaceId, environmentId, allowDeletions, }) {
     useInput((input, key) => {
         if (key.escape || input === 'q')
             process.exit(0);
     });
-    return _jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId });
+    return (_jsx(ServerPreviewView, { preview: preview, spaceId: spaceId, environmentId: environmentId, allowDeletions: allowDeletions }));
 }
 export function ServerApplyProgress({ spaceId, environmentId, status, operationId, error, }) {
     useInput((_input, key) => {

package/dist/src/apply/tui/ServerPreviewView.d.ts

@@ -4,6 +4,7 @@ interface ServerPreviewViewProps {
     preview: ServerPreviewResponse;
     spaceId: string;
     environmentId: string;
+    allowDeletions: boolean;
 }
-export declare function ServerPreviewView({ preview, spaceId, environmentId }: ServerPreviewViewProps): React.ReactElement;
+export declare function ServerPreviewView({ preview, spaceId, environmentId, allowDeletions, }: ServerPreviewViewProps): React.ReactElement;
 export {};

package/dist/src/apply/tui/ServerPreviewView.js

@@ -13,11 +13,11 @@ function DraftWarning({ hasDraft }) {
         return null;
     return _jsx(Text, { color: "yellow", children: " \u26A1 has pending draft changes" });
 }
-export function ServerPreviewView({ preview, spaceId, environmentId }) {
+export function ServerPreviewView({ preview, spaceId, environmentId, allowDeletions, }) {
     const { components, tokens } = preview;
     const totalComponents = components.new.length + components.changed.length + components.unchanged.length + components.removed.length;
     const totalTokens = tokens.new.length + tokens.changed.length + tokens.unchanged.length + tokens.removed.length;
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Preview \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), totalComponents > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Component Types (", totalComponents, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", components.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", components.changed.length, " to update"] }), _jsxs(Text, { color: "red", children: [" \u2717 ", components.removed.length, " to remove"] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", components.unchanged.length, " unchanged"] }), components.changed.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: item.hasPendingDraftChanges })] }), _jsx(BreakingBadge, { item: item })] }, i))), _jsx(Text, { children: " " })] })), totalTokens > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Design Tokens (", totalTokens, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", tokens.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", tokens.changed.length, " to update"] }), _jsxs(Text, { color: "red", children: [" \u2717 ", tokens.removed.length, " to remove"] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", tokens.unchanged.length, " unchanged"] }), tokens.changed
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Preview \u2014 ", environmentId, " @ ", spaceId] }), _jsx(Text, { children: " " }), totalComponents > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Component Types (", totalComponents, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", components.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", components.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", components.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", components.unchanged.length, " unchanged"] }), components.changed.map((item, i) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: item.hasPendingDraftChanges })] }), _jsx(BreakingBadge, { item: item })] }, i))), _jsx(Text, { children: " " })] })), totalTokens > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [" Design Tokens (", totalTokens, " total)"] }), _jsxs(Text, { color: "green", children: [" \u2746 ", tokens.new.length, " to create"] }), _jsxs(Text, { color: "yellow", children: [" ~ ", tokens.changed.length, " to update"] }), _jsxs(Text, { color: allowDeletions ? 'red' : 'yellow', children: [' ', allowDeletions ? '✗' : '⊘', " ", tokens.removed.length, " to ", allowDeletions ? 'delete' : 'skip'] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", tokens.unchanged.length, " unchanged"] }), tokens.changed
                         .filter((t) => t.hasPendingDraftChanges)
-                        .map((item, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: true })] }, i))), _jsx(Text, { children: " " })] })), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
+                        .map((item, i) => (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: "yellow", children: [" ~ ", item.current.name] }), _jsx(DraftWarning, { hasDraft: true })] }, i))), _jsx(Text, { children: " " })] })), !allowDeletions && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: " \u2298 Deletions are hidden by default \u2014 rerun with --allow-deletions to see them." }) })), _jsx(Text, { dimColor: true, children: " Press Q to exit." })] }));
 }

package/dist/src/generate/agent-runner.d.ts

@@ -0,0 +1,125 @@
+import type { AgentName } from '../lib/agent-names.js';
+export { AGENT_NAMES, isAgentName, type AgentName } from '../lib/agent-names.js';
+export interface AgentRunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+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 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 declare function parseSelectToolCallLines(stdout: string): ParsedSelectToolCalls;
+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 ParsedToolCalls {
+    calls: ToolCall[];
+    warnings: string[];
+}
+export declare function parseToolCallLines(stdout: string): ParsedToolCalls;
+export declare function parseTokenToolCallLines(stdout: string): ParsedTokenToolCalls;
+export declare function resolveBinary(agent: AgentName): string;
+/**
+ * Resolve the model for an agent. Explicit flag/creds value wins, then a
+ * per-agent `EDS_AGENT_MODEL_<AGENT>` env override (mirrors the
+ * `EDS_AGENT_BINARY_<AGENT>` pattern), otherwise the lightweight default for
+ * that agent.
+ */
+export declare function resolveAgentModel(agent: AgentName, explicit?: string): string;
+export declare function buildArgs(agent: AgentName, prompt: string, model?: string, promptViaStdin?: boolean): string[];
+export declare function runAgent(options: {
+    agent: AgentName;
+    prompt: string;
+    interactive: boolean;
+    timeoutMs: number;
+    model?: string;
+    onOutput?: (chunk: string) => void;
+    /**
+     * Deliver the prompt on stdin instead of as an argv positional. Required for
+     * large prompts (e.g. the composition resolver inlining candidate files),
+     * which overflow ARG_MAX when passed as an argument. Non-interactive only.
+     */
+    promptViaStdin?: boolean;
+}): Promise<AgentRunResult>;
+export type AgentAuthStatus = 'ok' | 'unauthenticated' | 'not-found';
+export declare function checkAgentAuth(agent: AgentName): Promise<AgentAuthStatus>;
+/**
+ * Build a diagnostic string from a failed agent run, surfacing the agent's own
+ * stderr (or stdout, when stderr is empty) so callers never emit a context-free
+ * "agent failed". Callers only invoke this on a failed run: either a non-zero
+ * exit, or a zero exit that produced no tool calls. A non-zero exit is reported
+ * as such; a zero exit is therefore the "produced no tool calls" case.
+ */
+export declare function describeAgentFailure(result: AgentRunResult, maxDetail?: number): string;
+export declare function extractSentinelOutput(stdout: string): string | null | 'multiple';