@superdesign/cli 0.2.1 → 0.2.2

package/dist/api/drafts.d.ts

@@ -10,6 +10,7 @@ export interface CreateDraftRequest {
     prompt: string;
     deviceMode?: 'mobile' | 'tablet' | 'desktop';
     contextFiles?: ContextFile[];
+    model?: string;
 }
 export interface IterateDraftRequest {
     prompts?: string[];
@@ -17,6 +18,7 @@ export interface IterateDraftRequest {
     count?: 1 | 2 | 3 | 4;
     mode: 'replace' | 'branch';
     contextFiles?: ContextFile[];
+    model?: string;
 }
 export interface PlanFlowRequest {
     flowContext?: string;
@@ -29,6 +31,7 @@ export interface ExecuteFlowRequest {
     flowContext?: string;
     pages: FlowPage[];
     contextFiles?: ContextFile[];
+    model?: string;
 }
 export interface JobCreatedResponse {
     jobId: string;

package/dist/config/constants.d.ts

@@ -12,7 +12,7 @@ export declare const POLL_TIMEOUT_MS: number;
 export declare const AUTH_POLL_INTERVAL_MS = 2000;
 export declare const AUTH_POLL_TIMEOUT_MS: number;
 /** CLI version - should match package.json */
-export declare const CLI_VERSION = "0.2.1";
+export declare const CLI_VERSION = "0.2.2";
 /** PostHog analytics configuration */
 export declare const POSTHOG_KEY: string;
 export declare const POSTHOG_HOST: string;
@@ -30,6 +30,8 @@ export declare const EXIT_CODES: {
     readonly VALIDATION_ERROR: 5;
     readonly TIMEOUT: 6;
 };
+/** Supported model IDs for --model option */
+export declare const SUPPORTED_MODELS: readonly ["gemini-3-flash", "gemini-3-pro", "gemini-3.1-pro", "claude-haiku-4-5", "claude-sonnet-4-5", "claude-opus-4-5", "claude-opus-4-6", "gpt-5.2", "gpt-5.2-thinking", "gpt-5-mini", "kimi-k2.5"];
 /** Skill files directory relative to project root */
 export declare const SKILLS_DIR = ".claude/skills/superdesign";
 /** SKILL.md file name */

package/dist/index.cjs

@@ -104,6 +104,19 @@ var __webpack_exports__ = {};
         VALIDATION_ERROR: 5,
         TIMEOUT: 6
     };
+    const SUPPORTED_MODELS = [
+        'gemini-3-flash',
+        'gemini-3-pro',
+        'gemini-3.1-pro',
+        'claude-haiku-4-5',
+        'claude-sonnet-4-5',
+        'claude-opus-4-5',
+        'claude-opus-4-6',
+        'gpt-5.2',
+        'gpt-5.2-thinking',
+        'gpt-5-mini',
+        'kimi-k2.5'
+    ];
     const SKILLS_DIR = '.claude/skills/superdesign';
     const SKILL_FILE_NAME = 'SKILL.md';
     const external_fs_namespaceObject = require("fs");
@@ -316,7 +329,7 @@ var __webpack_exports__ = {};
         try {
             startSpinner('Creating auth session...');
             const session = await createSession({
-                cliVersion: "0.2.1",
+                cliVersion: "0.2.2",
                 os: `${external_os_namespaceObject.platform()} ${external_os_namespaceObject.release()}`,
                 hostname: external_os_namespaceObject.hostname()
             });
@@ -724,6 +737,12 @@ superdesign --help
             process.exit(EXIT_CODES.VALIDATION_ERROR);
         }
     }
+    function validateModel(model) {
+        if (model && !SUPPORTED_MODELS.includes(model)) {
+            output_error(`Invalid model "${model}". Supported models: ${SUPPORTED_MODELS.join(', ')}`);
+            process.exit(EXIT_CODES.VALIDATION_ERROR);
+        }
+    }
     function readFileIfExists(filePath) {
         if ((0, external_fs_namespaceObject.existsSync)(filePath)) return (0, external_fs_namespaceObject.readFileSync)(filePath, 'utf-8');
     }
@@ -928,10 +947,11 @@ superdesign --help
         return results;
     }
     function createCreateDesignDraftCommand() {
-        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
+        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
             validateDeviceMode(options.device);
+            validateModel(options.model);
             const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
             await runJob({
                 startLabel: 'Creating design draft...',
@@ -943,7 +963,8 @@ superdesign --help
                         title: options.title,
                         prompt: options.prompt,
                         deviceMode: options.device,
-                        contextFiles
+                        contextFiles,
+                        model: options.model
                     }),
                 transformResult: (job)=>({
                         draftId: job.result.draftId,
@@ -1015,20 +1036,23 @@ Usage Examples:
   superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
 
   # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
-  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
+            validateModel(options.model);
             const { prompts, count, mode } = validateOptions(options);
             const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
             const requestData = prompts.length > 1 ? {
                 prompts,
                 mode,
-                contextFiles
+                contextFiles,
+                model: options.model
             } : {
                 prompt: prompts[0],
                 count: count,
                 mode,
-                contextFiles
+                contextFiles,
+                model: options.model
             };
             await runJob({
                 startLabel: 'Starting iteration...',
@@ -1099,9 +1123,10 @@ Usage Examples:
         return parsed;
     }
     function createExecuteFlowPagesCommand() {
-        const command = new external_commander_namespaceObject.Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
+        const command = new external_commander_namespaceObject.Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
+            validateModel(options.model);
             let pages;
             try {
                 pages = parsePages(options.pages);
@@ -1131,7 +1156,8 @@ Usage Examples:
                 startJob: ()=>executeFlowPages(options.draftId, {
                         flowContext: options.context,
                         pages,
-                        contextFiles
+                        contextFiles,
+                        model: options.model
                     }),
                 transformResult: (job)=>({
                         drafts: job.result.drafts,
@@ -1446,7 +1472,7 @@ Usage Examples:
             durationMs: opts.durationMs,
             errorCode: opts.errorCode,
             options: opts.options,
-            cliVersion: "0.2.1",
+            cliVersion: "0.2.2",
             os: `${external_os_default().platform()} ${external_os_default().release()}`
         };
         const posthog = getPostHog();
@@ -1514,7 +1540,7 @@ Usage Examples:
     }
     function createProgram() {
         const program = new external_commander_namespaceObject.Command();
-        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.1");
+        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.2");
         program.configureOutput({
             writeErr: (str)=>{
                 if (!process.argv.includes('--json')) process.stderr.write(str);

package/dist/index.js

@@ -21,6 +21,19 @@ const EXIT_CODES = {
     VALIDATION_ERROR: 5,
     TIMEOUT: 6
 };
+const SUPPORTED_MODELS = [
+    'gemini-3-flash',
+    'gemini-3-pro',
+    'gemini-3.1-pro',
+    'claude-haiku-4-5',
+    'claude-sonnet-4-5',
+    'claude-opus-4-5',
+    'claude-opus-4-6',
+    'gpt-5.2',
+    'gpt-5.2-thinking',
+    'gpt-5-mini',
+    'kimi-k2.5'
+];
 const SKILLS_DIR = '.claude/skills/superdesign';
 const SKILL_FILE_NAME = 'SKILL.md';
 function getConfigDir() {
@@ -226,7 +239,7 @@ async function runAuthFlow(options = {}) {
     try {
         startSpinner('Creating auth session...');
         const session = await createSession({
-            cliVersion: "0.2.1",
+            cliVersion: "0.2.2",
             os: `${platform()} ${release()}`,
             hostname: hostname()
         });
@@ -634,6 +647,12 @@ function validateDeviceMode(device) {
         process.exit(EXIT_CODES.VALIDATION_ERROR);
     }
 }
+function validateModel(model) {
+    if (model && !SUPPORTED_MODELS.includes(model)) {
+        output_error(`Invalid model "${model}". Supported models: ${SUPPORTED_MODELS.join(', ')}`);
+        process.exit(EXIT_CODES.VALIDATION_ERROR);
+    }
+}
 function readFileIfExists(filePath) {
     if (existsSync(filePath)) return readFileSync(filePath, 'utf-8');
 }
@@ -838,10 +857,11 @@ function readContextFiles(filePaths) {
     return results;
 }
 function createCreateDesignDraftCommand() {
-    const command = new Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
+    const command = new Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
         validateDeviceMode(options.device);
+        validateModel(options.model);
         const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
         await runJob({
             startLabel: 'Creating design draft...',
@@ -853,7 +873,8 @@ function createCreateDesignDraftCommand() {
                     title: options.title,
                     prompt: options.prompt,
                     deviceMode: options.device,
-                    contextFiles
+                    contextFiles,
+                    model: options.model
                 }),
             transformResult: (job)=>({
                     draftId: job.result.draftId,
@@ -925,20 +946,23 @@ Usage Examples:
   superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
 
   # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
-  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
+        validateModel(options.model);
         const { prompts, count, mode } = validateOptions(options);
         const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
         const requestData = prompts.length > 1 ? {
             prompts,
             mode,
-            contextFiles
+            contextFiles,
+            model: options.model
         } : {
             prompt: prompts[0],
             count: count,
             mode,
-            contextFiles
+            contextFiles,
+            model: options.model
         };
         await runJob({
             startLabel: 'Starting iteration...',
@@ -1009,9 +1033,10 @@ function parsePages(pagesJson) {
     return parsed;
 }
 function createExecuteFlowPagesCommand() {
-    const command = new Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
+    const command = new Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--model <modelId>', 'Model ID to use for generation (e.g. claude-sonnet-4-5)').option('--json', 'Output in JSON format').action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
+        validateModel(options.model);
         let pages;
         try {
             pages = parsePages(options.pages);
@@ -1041,7 +1066,8 @@ function createExecuteFlowPagesCommand() {
             startJob: ()=>executeFlowPages(options.draftId, {
                     flowContext: options.context,
                     pages,
-                    contextFiles
+                    contextFiles,
+                    model: options.model
                 }),
             transformResult: (job)=>({
                     drafts: job.result.drafts,
@@ -1354,7 +1380,7 @@ async function trackCommand(opts) {
         durationMs: opts.durationMs,
         errorCode: opts.errorCode,
         options: opts.options,
-        cliVersion: "0.2.1",
+        cliVersion: "0.2.2",
         os: `${os.platform()} ${os.release()}`
     };
     const posthog = getPostHog();
@@ -1422,7 +1448,7 @@ function findFailedCommand(program) {
 }
 function createProgram() {
     const program = new Command();
-    program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.1");
+    program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.2");
     program.configureOutput({
         writeErr: (str)=>{
             if (!process.argv.includes('--json')) process.stderr.write(str);

package/dist/utils/job-runner.d.ts

@@ -51,3 +51,7 @@ export type DeviceMode = (typeof VALID_DEVICES)[number];
  * Validate device mode option and exit with error if invalid
  */
 export declare function validateDeviceMode(device: string | undefined): void;
+/**
+ * Validate model option and exit with error if invalid
+ */
+export declare function validateModel(model: string | undefined): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdesign/cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "CLI for SuperDesign Platform - agent skills for Claude Code",
   "type": "module",
   "main": "./dist/index.cjs",