assistant-ui 0.0.93 → 0.0.95

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/commands/create.ts"],"mappings":";;;;UAiBiB,eAAA;EACf,IAAA;EACA,KAAA;EACA,WAAA;EACA,QAAA;EACA,IAAA;EACA,kBAAA;AAAA;AAAA,cAGW,gBAAA,EAAkB,eAAe;AAAA,iBA8OxB,cAAA,CAAe,MAAA;EACnC,QAAA;EACA,OAAA;EACA,UAAA;EACA,MAAA,UAAgB,CAAA,CAAE,MAAA;EAClB,QAAA,UAAkB,CAAA,CAAE,QAAA;AAAA,IAClB,OAAA,CAAQ,eAAA;AAAA,iBA2EI,6BAAA,CAA8B,MAAA;EAC5C,gBAAA;EACA,UAAA;AAAA;AAAA,iBAYc,gBAAA,CAAiB,MAAc;AAAA,UAO9B,uBAAA;EACf,QAAA;EACA,OAAA;EACA,MAAA;EACA,MAAA;EACA,GAAA;AAAA;AAAA,UAGe,wBAAA;EACf,QAAA;EACA,OAAA;EACA,MAAA;AAAA;AAAA,iBAac,uBAAA,CACd,IAAA,EAAM,uBAAA,GACL,wBAAwB;AAAA,cAoCd,MAAA,EAAM,OAmPf"}
+{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/commands/create.ts"],"mappings":";;;;UAiBiB,eAAA;EACf,IAAA;EACA,KAAA;EACA,WAAA;EACA,QAAA;EACA,IAAA;EACA,kBAAA;AAAA;AAAA,cAGW,gBAAA,EAAkB,eAAe;AAAA,iBAsOxB,cAAA,CAAe,MAAA;EACnC,QAAA;EACA,OAAA;EACA,UAAA;EACA,MAAA,UAAgB,CAAA,CAAE,MAAA;EAClB,QAAA,UAAkB,CAAA,CAAE,QAAA;AAAA,IAClB,OAAA,CAAQ,eAAA;AAAA,iBA2EI,6BAAA,CAA8B,MAAA;EAC5C,gBAAA;EACA,UAAA;AAAA;AAAA,iBAYc,gBAAA,CAAiB,MAAc;AAAA,UAO9B,uBAAA;EACf,QAAA;EACA,OAAA;EACA,MAAA;EACA,MAAA;EACA,GAAA;AAAA;AAAA,UAGe,wBAAA;EACf,QAAA;EACA,OAAA;EACA,MAAA;AAAA;AAAA,iBAac,uBAAA,CACd,IAAA,EAAM,uBAAA,GACL,wBAAwB;AAAA,cAoCd,MAAA,EAAM,OAmPf"}

package/dist/commands/create.js

@@ -99,7 +99,7 @@ const PROJECT_METADATA = [
 	{
 		name: "with-chain-of-thought",
 		label: "Chain of Thought",
-		description: "Chain-of-thought rendering",
+		description: "Chain-of-thought, tool calls, and source citations",
 		category: "example",
 		path: "examples/with-chain-of-thought",
 		hasLocalComponents: false
@@ -184,14 +184,6 @@ const PROJECT_METADATA = [
 		path: "examples/with-langgraph",
 		hasLocalComponents: false
 	},
-	{
-		name: "with-parent-id-grouping",
-		label: "Parent ID Grouping",
-		description: "Message grouping strategy",
-		category: "example",
-		path: "examples/with-parent-id-grouping",
-		hasLocalComponents: false
-	},
 	{
 		name: "with-react-hook-form",
 		label: "React Hook Form",

package/dist/commands/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":[],"sources":["../../src/commands/create.ts"],"sourcesContent":["import { Command, Option } from \"commander\";\nimport chalk from \"chalk\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport * as p from \"@clack/prompts\";\nimport { logger } from \"../lib/utils/logger\";\nimport {\n  dlxCommand,\n  downloadProject,\n  resolveLatestReleaseRef,\n  resolvePackageManager,\n  resolvePackageManagerForCwd,\n  scaffoldProject,\n  transformProject,\n} from \"../lib/create-project\";\nimport { runSpawn, SpawnExitError } from \"../lib/run-spawn\";\n\nexport interface ProjectMetadata {\n  name: string;\n  label: string;\n  description?: string;\n  category: \"template\" | \"example\";\n  path: string;\n  hasLocalComponents: boolean;\n}\n\nexport const PROJECT_METADATA: ProjectMetadata[] = [\n  // Templates\n  {\n    name: \"default\",\n    label: \"Default\",\n    description: \"Default template with Vercel AI SDK\",\n    category: \"template\",\n    path: \"templates/default\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"minimal\",\n    label: \"Minimal\",\n    description: \"Bare-bones starting point\",\n    category: \"template\",\n    path: \"templates/minimal\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"cloud\",\n    label: \"Cloud\",\n    description: \"Cloud-backed persistence starter\",\n    category: \"template\",\n    path: \"templates/cloud\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"cloud-clerk\",\n    label: \"Cloud + Clerk\",\n    description: \"Cloud-backed starter with Clerk auth\",\n    category: \"template\",\n    path: \"templates/cloud-clerk\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"langgraph\",\n    label: \"LangGraph\",\n    description: \"LangGraph starter template\",\n    category: \"template\",\n    path: \"templates/langgraph\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"mcp\",\n    label: \"MCP\",\n    description: \"MCP tools + MCP Apps renderer starter\",\n    category: \"template\",\n    path: \"templates/mcp\",\n    hasLocalComponents: false,\n  },\n  // Examples\n  {\n    name: \"with-ag-ui\",\n    label: \"AG-UI\",\n    description: \"AG-UI protocol integration\",\n    category: \"example\",\n    path: \"examples/with-ag-ui\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-google-adk\",\n    label: \"Google ADK\",\n    description: \"Google ADK agent integration\",\n    category: \"example\",\n    path: \"examples/with-google-adk\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-ai-sdk-v6\",\n    label: \"AI SDK v6\",\n    description: \"Vercel AI SDK v6\",\n    category: \"example\",\n    path: \"examples/with-ai-sdk-v6\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-artifacts\",\n    label: \"Artifacts\",\n    description: \"Artifact rendering\",\n    category: \"example\",\n    path: \"examples/with-artifacts\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-assistant-transport\",\n    label: \"Assistant Transport\",\n    description: \"Assistant transport protocol\",\n    category: \"example\",\n    path: \"examples/with-assistant-transport\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-chain-of-thought\",\n    label: \"Chain of Thought\",\n    description: \"Chain-of-thought rendering\",\n    category: \"example\",\n    path: \"examples/with-chain-of-thought\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-cloud\",\n    label: \"Cloud Example\",\n    description: \"Cloud integration example\",\n    category: \"example\",\n    path: \"examples/with-cloud\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-custom-thread-list\",\n    label: \"Custom Thread List\",\n    description: \"Custom thread list UI\",\n    category: \"example\",\n    path: \"examples/with-custom-thread-list\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-elevenlabs-conversational\",\n    label: \"ElevenLabs Conversational\",\n    description: \"Realtime voice with ElevenLabs\",\n    category: \"example\",\n    path: \"examples/with-elevenlabs-conversational\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-elevenlabs-scribe\",\n    label: \"ElevenLabs Scribe\",\n    description: \"Audio/speech integration\",\n    category: \"example\",\n    path: \"examples/with-elevenlabs-scribe\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-livekit\",\n    label: \"LiveKit Voice\",\n    description: \"Realtime voice with LiveKit\",\n    category: \"example\",\n    path: \"examples/with-livekit\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-expo\",\n    label: \"Expo\",\n    description: \"Expo / React Native\",\n    category: \"example\",\n    path: \"examples/with-expo\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-interactables\",\n    label: \"Interactables\",\n    description: \"AI-driven interactive UI components\",\n    category: \"example\",\n    path: \"examples/with-interactables\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-external-store\",\n    label: \"External Store\",\n    description: \"Custom message store\",\n    category: \"example\",\n    path: \"examples/with-external-store\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-ffmpeg\",\n    label: \"FFmpeg\",\n    description: \"File processing\",\n    category: \"example\",\n    path: \"examples/with-ffmpeg\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-langgraph\",\n    label: \"LangGraph Example\",\n    description: \"LangGraph integration\",\n    category: \"example\",\n    path: \"examples/with-langgraph\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-parent-id-grouping\",\n    label: \"Parent ID Grouping\",\n    description: \"Message grouping strategy\",\n    category: \"example\",\n    path: \"examples/with-parent-id-grouping\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-react-hook-form\",\n    label: \"React Hook Form\",\n    description: \"Form integration\",\n    category: \"example\",\n    path: \"examples/with-react-hook-form\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-react-ink\",\n    label: \"React Ink\",\n    description: \"Terminal UI chat\",\n    category: \"example\",\n    path: \"examples/with-react-ink\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-react-router\",\n    label: \"React Router\",\n    description: \"React Router v7 + Vite\",\n    category: \"example\",\n    path: \"examples/with-react-router\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-tanstack\",\n    label: \"TanStack\",\n    description: \"TanStack/React Router + Vite\",\n    category: \"example\",\n    path: \"examples/with-tanstack\",\n    hasLocalComponents: false,\n  },\n];\n\n// Examples that exist in the monorepo but are intentionally excluded from the CLI:\n//\n// - waterfall: Still in development, not ready for production.\n// - with-cloud-standalone: For cloud without assistant-ui — not for the\n//     assistant-ui CLI.\n// - with-store: In development, not ready for public use of the tap store.\n// - with-tap-runtime: In development, not ready for public use of the tap\n//     store.\n\nconst templateNames = PROJECT_METADATA.filter(\n  (m) => m.category === \"template\",\n).map((m) => m.name);\n\nconst exampleNames = PROJECT_METADATA.filter(\n  (m) => m.category === \"example\",\n).map((m) => m.name);\n\nexport async function resolveProject(params: {\n  template?: string;\n  example?: string;\n  stdinIsTTY?: boolean;\n  select?: typeof p.select;\n  isCancel?: typeof p.isCancel;\n}): Promise<ProjectMetadata | null> {\n  const {\n    template,\n    example,\n    stdinIsTTY = process.stdin.isTTY,\n    select = p.select,\n    isCancel = p.isCancel,\n  } = params;\n\n  if (template !== undefined) {\n    const meta = PROJECT_METADATA.find(\n      (m) => m.name === template && m.category === \"template\",\n    );\n    if (!meta) {\n      logger.error(`Unknown template: ${template}`);\n      logger.info(`Available templates: ${templateNames.join(\", \")}`);\n      process.exit(1);\n    }\n    return meta;\n  }\n\n  if (example !== undefined) {\n    const meta = PROJECT_METADATA.find(\n      (m) => m.name === example && m.category === \"example\",\n    );\n    if (!meta) {\n      logger.error(`Unknown example: ${example}`);\n      logger.info(`Available examples: ${exampleNames.join(\", \")}`);\n      process.exit(1);\n    }\n    return meta;\n  }\n\n  if (!stdinIsTTY) {\n    return PROJECT_METADATA.find((m) => m.name === \"default\")!;\n  }\n\n  const selected = await select({\n    message: \"Select a project to scaffold:\",\n    options: [\n      {\n        value: \"_separator\",\n        label: \"────── Starter Templates ──────\",\n        disabled: true,\n      },\n      ...PROJECT_METADATA.filter((m) => m.category === \"template\").map((m) => ({\n        value: m.name,\n        label: m.label,\n        ...(m.description ? { hint: m.description } : {}),\n      })),\n      {\n        value: \"_separator\",\n        label: \"────── Feature Examples ──────\",\n        disabled: true,\n      },\n      ...PROJECT_METADATA.filter((m) => m.category === \"example\").map((m) => ({\n        value: m.name,\n        label: m.label,\n        ...(m.description ? { hint: m.description } : {}),\n      })),\n    ],\n  });\n\n  if (isCancel(selected)) {\n    return null;\n  }\n\n  const meta = PROJECT_METADATA.find((m) => m.name === selected);\n  if (!meta) {\n    logger.error(`Unknown selection: ${String(selected)}`);\n    process.exit(1);\n  }\n  return meta;\n}\n\nexport function resolveCreateProjectDirectory(params: {\n  projectDirectory?: string;\n  stdinIsTTY?: boolean;\n}): string | undefined {\n  const { projectDirectory, stdinIsTTY = process.stdin.isTTY } = params;\n\n  if (projectDirectory) return projectDirectory;\n  if (!stdinIsTTY) return \"my-aui-app\";\n  return undefined;\n}\n\nconst PLAYGROUND_PRESET_BASE_URL =\n  \"https://www.assistant-ui.com/playground/init\";\n\nexport function resolvePresetUrl(preset: string): string {\n  if (preset.startsWith(\"http://\") || preset.startsWith(\"https://\")) {\n    return preset;\n  }\n  return `${PLAYGROUND_PRESET_BASE_URL}?preset=${encodeURIComponent(preset)}`;\n}\n\nexport interface ScaffoldSelectorOptions {\n  template?: string;\n  example?: string;\n  preset?: string;\n  native?: boolean;\n  ink?: boolean;\n}\n\nexport interface ResolvedScaffoldSelector {\n  template?: string;\n  example?: string;\n  preset?: string;\n}\n\nconst scaffoldSelectorHelp =\n  \"Choose one scaffold selector: --template <name>, --example <name>, --native, or --ink. --preset <name-or-url> can be used with --template or by itself.\";\n\nfunction getPresetConflict(opts: ScaffoldSelectorOptions): string | undefined {\n  if (opts.example !== undefined) return \"--example\";\n  if (opts.native) return \"--native\";\n  if (opts.ink) return \"--ink\";\n  return undefined;\n}\n\nexport function resolveScaffoldSelector(\n  opts: ScaffoldSelectorOptions,\n): ResolvedScaffoldSelector {\n  const hasPreset = opts.preset !== undefined;\n  const presetConflict = getPresetConflict(opts);\n  const selectors = [\n    opts.template !== undefined ? \"--template\" : undefined,\n    opts.example !== undefined ? \"--example\" : undefined,\n    opts.native ? \"--native\" : undefined,\n    opts.ink ? \"--ink\" : undefined,\n  ].filter((selector): selector is string => selector !== undefined);\n\n  if (selectors.length > 1) {\n    throw new Error(\n      `Only one scaffold selector can be provided (${selectors.join(\", \")}). ${scaffoldSelectorHelp}`,\n    );\n  }\n\n  if (hasPreset && presetConflict) {\n    throw new Error(\n      `Cannot use --preset with ${presetConflict}. ${scaffoldSelectorHelp}`,\n    );\n  }\n\n  if (opts.native) return { example: \"with-expo\" };\n  if (opts.ink) return { example: \"with-react-ink\" };\n\n  if (opts.preset !== undefined && opts.template === undefined) {\n    return { template: \"default\", preset: opts.preset };\n  }\n\n  return {\n    ...(opts.template !== undefined && { template: opts.template }),\n    ...(opts.example !== undefined && { example: opts.example }),\n    ...(hasPreset && { preset: opts.preset }),\n  };\n}\n\nexport const create = new Command()\n  .name(\"create\")\n  .description(\"create a new project\")\n  .argument(\"[project-directory]\")\n  .usage(`${chalk.green(\"[project-directory]\")} [options]`)\n  .option(\n    \"-t, --template <template>\",\n    `template to use (${templateNames.join(\", \")})`,\n  )\n  .option(\n    \"-e, --example <example>\",\n    `create from an example (${exampleNames.join(\", \")})`,\n  )\n  .option(\n    \"-p, --preset <name-or-url>\",\n    \"preset name or URL (e.g., chatgpt or https://www.assistant-ui.com/playground/init?preset=chatgpt)\",\n  )\n  .option(\"--use-npm\", \"explicitly use npm\")\n  .option(\"--use-pnpm\", \"explicitly use pnpm\")\n  .option(\"--use-yarn\", \"explicitly use yarn\")\n  .option(\"--use-bun\", \"explicitly use bun\")\n  .option(\"--native\", \"create an Expo / React Native project\")\n  .option(\"--ink\", \"create a React Ink terminal project\")\n  .option(\"--skip-install\", \"skip installing packages\")\n  .addOption(\n    new Option(\n      \"--debug-source-root <path>\",\n      \"copy templates/examples from a local assistant-ui repo root\",\n    ).hideHelp(),\n  )\n  .action(async (projectDirectory, opts) => {\n    let scaffoldSelector: ResolvedScaffoldSelector;\n    try {\n      scaffoldSelector = resolveScaffoldSelector(opts);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error(message);\n      process.exit(1);\n    }\n\n    const localSourceRoot = opts.debugSourceRoot\n      ? path.resolve(opts.debugSourceRoot)\n      : undefined;\n\n    // Start release ref resolution early (runs during user prompts)\n    const refPromise = localSourceRoot\n      ? Promise.resolve(undefined)\n      : resolveLatestReleaseRef();\n\n    // 1. Resolve project directory\n    let resolvedProjectDirectory = resolveCreateProjectDirectory({\n      projectDirectory,\n    });\n\n    if (!resolvedProjectDirectory) {\n      const result = await p.text({\n        message: \"Project name:\",\n        placeholder: \"my-aui-app\",\n        defaultValue: \"my-aui-app\",\n        validate: (value?: string) => {\n          const name = (value ?? \"\").trim();\n          if (!name) return \"Project name cannot be empty\";\n          if (name === \".\" || name === \"..\")\n            return \"Project name cannot be . or ..\";\n          if (name.includes(\"/\") || name.includes(\"\\\\\"))\n            return \"Project name cannot contain path separators\";\n          return undefined;\n        },\n      });\n\n      if (p.isCancel(result)) {\n        p.cancel(\"Project creation cancelled.\");\n        process.exit(0);\n      }\n\n      resolvedProjectDirectory = result;\n    }\n\n    // Check directory\n    const absoluteProjectDir = path.resolve(resolvedProjectDirectory);\n    try {\n      const files = fs.readdirSync(absoluteProjectDir);\n      if (files.length > 0) {\n        logger.error(\n          `Directory ${resolvedProjectDirectory} already exists and is not empty`,\n        );\n        process.exit(1);\n      }\n    } catch (err: unknown) {\n      const code =\n        err instanceof Error ? (err as NodeJS.ErrnoException).code : undefined;\n      if (code === \"ENOENT\") {\n        // Directory doesn't exist — good, proceed\n      } else if (code === \"ENOTDIR\") {\n        logger.error(\n          `${resolvedProjectDirectory} already exists and is not a directory`,\n        );\n        process.exit(1);\n      } else {\n        const message = err instanceof Error ? err.message : String(err);\n        logger.error(`Cannot access ${resolvedProjectDirectory}: ${message}`);\n        process.exit(1);\n      }\n    }\n\n    // 2. Resolve scaffold target\n    const project = await resolveProject(scaffoldSelector);\n    if (!project) {\n      p.cancel(\"Project creation cancelled.\");\n      process.exit(0);\n    }\n\n    logger.info(`Creating project from ${project.category}: ${project.label}`);\n    logger.break();\n\n    const pm = await resolvePackageManagerForCwd(\n      path.dirname(absoluteProjectDir),\n      resolvePackageManager(opts),\n    );\n\n    // Clean up partial project directory on unexpected exit (e.g. Ctrl+C)\n    const cleanupOnExit = () => {\n      fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n    };\n    process.once(\"exit\", cleanupOnExit);\n\n    try {\n      // 3. Resolve latest release ref (started before prompts)\n      if (!localSourceRoot) {\n        logger.step(\"Resolving latest release...\");\n      }\n      const ref = await refPromise;\n      if (!localSourceRoot && !ref) {\n        logger.warn(\"Could not resolve latest release, downloading from HEAD\");\n      }\n\n      // 4. Scaffold project\n      logger.step(\n        localSourceRoot\n          ? `Copying project from local source: ${localSourceRoot}`\n          : \"Downloading project...\",\n      );\n      try {\n        const source = localSourceRoot\n          ? { kind: \"local\" as const, rootDir: localSourceRoot }\n          : {\n              kind: \"github\" as const,\n              ref,\n            };\n        await scaffoldProject(project.path, absoluteProjectDir, source);\n\n        // If the template didn't exist at the release tag, retry from HEAD\n        if (\n          !localSourceRoot &&\n          ref &&\n          !fs.existsSync(path.join(absoluteProjectDir, \"package.json\"))\n        ) {\n          fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n          logger.warn(\n            \"Template not found at release tag, downloading from HEAD\",\n          );\n          await downloadProject(project.path, absoluteProjectDir);\n        }\n\n        // 5. Run transform pipeline\n        await transformProject(absoluteProjectDir, {\n          hasLocalComponents: project.hasLocalComponents,\n          skipInstall: opts.skipInstall,\n          packageManager: pm,\n        });\n      } catch (err) {\n        // Clean up partially created project directory\n        fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n        throw err;\n      }\n\n      // 6. Apply preset if provided\n      if (scaffoldSelector.preset) {\n        const presetUrl = resolvePresetUrl(scaffoldSelector.preset);\n        logger.info(\"Applying preset configuration...\");\n        logger.break();\n        const [dlxCmd, dlxArgs] = dlxCommand(pm);\n        try {\n          await runSpawn(\n            dlxCmd,\n            [\n              ...dlxArgs,\n              \"shadcn@latest\",\n              \"add\",\n              \"--yes\",\n              \"--overwrite\",\n              presetUrl,\n            ],\n            absoluteProjectDir,\n          );\n        } catch {\n          logger.warn(\n            `Preset application failed. You can retry manually with:\\n  ${dlxCmd} ${[...dlxArgs, \"shadcn@latest\", \"add\", presetUrl].join(\" \")}`,\n          );\n        }\n      }\n\n      process.removeListener(\"exit\", cleanupOnExit);\n\n      logger.break();\n      logger.success(\"Project created successfully!\");\n      logger.break();\n      const runCmd = pm === \"npm\" ? \"npm run\" : pm;\n      let devScript = \"dev\";\n      let envFile = \".env.local\";\n      try {\n        const scaffoldedPkg = JSON.parse(\n          fs.readFileSync(\n            path.join(absoluteProjectDir, \"package.json\"),\n            \"utf-8\",\n          ),\n        );\n        devScript = scaffoldedPkg.scripts?.dev\n          ? \"dev\"\n          : scaffoldedPkg.scripts?.start\n            ? \"start\"\n            : \"dev\";\n        envFile = scaffoldedPkg.dependencies?.next ? \".env.local\" : \".env\";\n      } catch {\n        // Fall back to defaults if package.json cannot be read\n      }\n\n      logger.info(\"Next steps:\");\n      logger.info(`  cd ${resolvedProjectDirectory}`);\n      if (opts.skipInstall) {\n        logger.info(`  ${pm} install`);\n      }\n      logger.info(`  # Set up your environment variables in ${envFile}`);\n      logger.info(`  ${runCmd} ${devScript}`);\n    } catch (error) {\n      if (error instanceof SpawnExitError) {\n        logger.error(`Project creation failed with code ${error.code}`);\n        process.exit(error.code);\n      }\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error(`Failed to create project: ${message}`);\n      process.exit(1);\n    }\n  });\n"],"mappings":";;;;;;;;;AA0BA,MAAa,mBAAsC;CAEjD;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CAEA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA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"}
+{"version":3,"file":"create.js","names":[],"sources":["../../src/commands/create.ts"],"sourcesContent":["import { Command, Option } from \"commander\";\nimport chalk from \"chalk\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport * as p from \"@clack/prompts\";\nimport { logger } from \"../lib/utils/logger\";\nimport {\n  dlxCommand,\n  downloadProject,\n  resolveLatestReleaseRef,\n  resolvePackageManager,\n  resolvePackageManagerForCwd,\n  scaffoldProject,\n  transformProject,\n} from \"../lib/create-project\";\nimport { runSpawn, SpawnExitError } from \"../lib/run-spawn\";\n\nexport interface ProjectMetadata {\n  name: string;\n  label: string;\n  description?: string;\n  category: \"template\" | \"example\";\n  path: string;\n  hasLocalComponents: boolean;\n}\n\nexport const PROJECT_METADATA: ProjectMetadata[] = [\n  // Templates\n  {\n    name: \"default\",\n    label: \"Default\",\n    description: \"Default template with Vercel AI SDK\",\n    category: \"template\",\n    path: \"templates/default\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"minimal\",\n    label: \"Minimal\",\n    description: \"Bare-bones starting point\",\n    category: \"template\",\n    path: \"templates/minimal\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"cloud\",\n    label: \"Cloud\",\n    description: \"Cloud-backed persistence starter\",\n    category: \"template\",\n    path: \"templates/cloud\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"cloud-clerk\",\n    label: \"Cloud + Clerk\",\n    description: \"Cloud-backed starter with Clerk auth\",\n    category: \"template\",\n    path: \"templates/cloud-clerk\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"langgraph\",\n    label: \"LangGraph\",\n    description: \"LangGraph starter template\",\n    category: \"template\",\n    path: \"templates/langgraph\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"mcp\",\n    label: \"MCP\",\n    description: \"MCP tools + MCP Apps renderer starter\",\n    category: \"template\",\n    path: \"templates/mcp\",\n    hasLocalComponents: false,\n  },\n  // Examples\n  {\n    name: \"with-ag-ui\",\n    label: \"AG-UI\",\n    description: \"AG-UI protocol integration\",\n    category: \"example\",\n    path: \"examples/with-ag-ui\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-google-adk\",\n    label: \"Google ADK\",\n    description: \"Google ADK agent integration\",\n    category: \"example\",\n    path: \"examples/with-google-adk\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-ai-sdk-v6\",\n    label: \"AI SDK v6\",\n    description: \"Vercel AI SDK v6\",\n    category: \"example\",\n    path: \"examples/with-ai-sdk-v6\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-artifacts\",\n    label: \"Artifacts\",\n    description: \"Artifact rendering\",\n    category: \"example\",\n    path: \"examples/with-artifacts\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-assistant-transport\",\n    label: \"Assistant Transport\",\n    description: \"Assistant transport protocol\",\n    category: \"example\",\n    path: \"examples/with-assistant-transport\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-chain-of-thought\",\n    label: \"Chain of Thought\",\n    description: \"Chain-of-thought, tool calls, and source citations\",\n    category: \"example\",\n    path: \"examples/with-chain-of-thought\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-cloud\",\n    label: \"Cloud Example\",\n    description: \"Cloud integration example\",\n    category: \"example\",\n    path: \"examples/with-cloud\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-custom-thread-list\",\n    label: \"Custom Thread List\",\n    description: \"Custom thread list UI\",\n    category: \"example\",\n    path: \"examples/with-custom-thread-list\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-elevenlabs-conversational\",\n    label: \"ElevenLabs Conversational\",\n    description: \"Realtime voice with ElevenLabs\",\n    category: \"example\",\n    path: \"examples/with-elevenlabs-conversational\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-elevenlabs-scribe\",\n    label: \"ElevenLabs Scribe\",\n    description: \"Audio/speech integration\",\n    category: \"example\",\n    path: \"examples/with-elevenlabs-scribe\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-livekit\",\n    label: \"LiveKit Voice\",\n    description: \"Realtime voice with LiveKit\",\n    category: \"example\",\n    path: \"examples/with-livekit\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-expo\",\n    label: \"Expo\",\n    description: \"Expo / React Native\",\n    category: \"example\",\n    path: \"examples/with-expo\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-interactables\",\n    label: \"Interactables\",\n    description: \"AI-driven interactive UI components\",\n    category: \"example\",\n    path: \"examples/with-interactables\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-external-store\",\n    label: \"External Store\",\n    description: \"Custom message store\",\n    category: \"example\",\n    path: \"examples/with-external-store\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-ffmpeg\",\n    label: \"FFmpeg\",\n    description: \"File processing\",\n    category: \"example\",\n    path: \"examples/with-ffmpeg\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-langgraph\",\n    label: \"LangGraph Example\",\n    description: \"LangGraph integration\",\n    category: \"example\",\n    path: \"examples/with-langgraph\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-react-hook-form\",\n    label: \"React Hook Form\",\n    description: \"Form integration\",\n    category: \"example\",\n    path: \"examples/with-react-hook-form\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-react-ink\",\n    label: \"React Ink\",\n    description: \"Terminal UI chat\",\n    category: \"example\",\n    path: \"examples/with-react-ink\",\n    hasLocalComponents: true,\n  },\n  {\n    name: \"with-react-router\",\n    label: \"React Router\",\n    description: \"React Router v7 + Vite\",\n    category: \"example\",\n    path: \"examples/with-react-router\",\n    hasLocalComponents: false,\n  },\n  {\n    name: \"with-tanstack\",\n    label: \"TanStack\",\n    description: \"TanStack/React Router + Vite\",\n    category: \"example\",\n    path: \"examples/with-tanstack\",\n    hasLocalComponents: false,\n  },\n];\n\n// Examples that exist in the monorepo but are intentionally excluded from the CLI:\n//\n// - waterfall: Still in development, not ready for production.\n// - with-cloud-standalone: For cloud without assistant-ui — not for the\n//     assistant-ui CLI.\n// - with-store: In development, not ready for public use of the tap store.\n// - with-tap-runtime: In development, not ready for public use of the tap\n//     store.\n\nconst templateNames = PROJECT_METADATA.filter(\n  (m) => m.category === \"template\",\n).map((m) => m.name);\n\nconst exampleNames = PROJECT_METADATA.filter(\n  (m) => m.category === \"example\",\n).map((m) => m.name);\n\nexport async function resolveProject(params: {\n  template?: string;\n  example?: string;\n  stdinIsTTY?: boolean;\n  select?: typeof p.select;\n  isCancel?: typeof p.isCancel;\n}): Promise<ProjectMetadata | null> {\n  const {\n    template,\n    example,\n    stdinIsTTY = process.stdin.isTTY,\n    select = p.select,\n    isCancel = p.isCancel,\n  } = params;\n\n  if (template !== undefined) {\n    const meta = PROJECT_METADATA.find(\n      (m) => m.name === template && m.category === \"template\",\n    );\n    if (!meta) {\n      logger.error(`Unknown template: ${template}`);\n      logger.info(`Available templates: ${templateNames.join(\", \")}`);\n      process.exit(1);\n    }\n    return meta;\n  }\n\n  if (example !== undefined) {\n    const meta = PROJECT_METADATA.find(\n      (m) => m.name === example && m.category === \"example\",\n    );\n    if (!meta) {\n      logger.error(`Unknown example: ${example}`);\n      logger.info(`Available examples: ${exampleNames.join(\", \")}`);\n      process.exit(1);\n    }\n    return meta;\n  }\n\n  if (!stdinIsTTY) {\n    return PROJECT_METADATA.find((m) => m.name === \"default\")!;\n  }\n\n  const selected = await select({\n    message: \"Select a project to scaffold:\",\n    options: [\n      {\n        value: \"_separator\",\n        label: \"────── Starter Templates ──────\",\n        disabled: true,\n      },\n      ...PROJECT_METADATA.filter((m) => m.category === \"template\").map((m) => ({\n        value: m.name,\n        label: m.label,\n        ...(m.description ? { hint: m.description } : {}),\n      })),\n      {\n        value: \"_separator\",\n        label: \"────── Feature Examples ──────\",\n        disabled: true,\n      },\n      ...PROJECT_METADATA.filter((m) => m.category === \"example\").map((m) => ({\n        value: m.name,\n        label: m.label,\n        ...(m.description ? { hint: m.description } : {}),\n      })),\n    ],\n  });\n\n  if (isCancel(selected)) {\n    return null;\n  }\n\n  const meta = PROJECT_METADATA.find((m) => m.name === selected);\n  if (!meta) {\n    logger.error(`Unknown selection: ${String(selected)}`);\n    process.exit(1);\n  }\n  return meta;\n}\n\nexport function resolveCreateProjectDirectory(params: {\n  projectDirectory?: string;\n  stdinIsTTY?: boolean;\n}): string | undefined {\n  const { projectDirectory, stdinIsTTY = process.stdin.isTTY } = params;\n\n  if (projectDirectory) return projectDirectory;\n  if (!stdinIsTTY) return \"my-aui-app\";\n  return undefined;\n}\n\nconst PLAYGROUND_PRESET_BASE_URL =\n  \"https://www.assistant-ui.com/playground/init\";\n\nexport function resolvePresetUrl(preset: string): string {\n  if (preset.startsWith(\"http://\") || preset.startsWith(\"https://\")) {\n    return preset;\n  }\n  return `${PLAYGROUND_PRESET_BASE_URL}?preset=${encodeURIComponent(preset)}`;\n}\n\nexport interface ScaffoldSelectorOptions {\n  template?: string;\n  example?: string;\n  preset?: string;\n  native?: boolean;\n  ink?: boolean;\n}\n\nexport interface ResolvedScaffoldSelector {\n  template?: string;\n  example?: string;\n  preset?: string;\n}\n\nconst scaffoldSelectorHelp =\n  \"Choose one scaffold selector: --template <name>, --example <name>, --native, or --ink. --preset <name-or-url> can be used with --template or by itself.\";\n\nfunction getPresetConflict(opts: ScaffoldSelectorOptions): string | undefined {\n  if (opts.example !== undefined) return \"--example\";\n  if (opts.native) return \"--native\";\n  if (opts.ink) return \"--ink\";\n  return undefined;\n}\n\nexport function resolveScaffoldSelector(\n  opts: ScaffoldSelectorOptions,\n): ResolvedScaffoldSelector {\n  const hasPreset = opts.preset !== undefined;\n  const presetConflict = getPresetConflict(opts);\n  const selectors = [\n    opts.template !== undefined ? \"--template\" : undefined,\n    opts.example !== undefined ? \"--example\" : undefined,\n    opts.native ? \"--native\" : undefined,\n    opts.ink ? \"--ink\" : undefined,\n  ].filter((selector): selector is string => selector !== undefined);\n\n  if (selectors.length > 1) {\n    throw new Error(\n      `Only one scaffold selector can be provided (${selectors.join(\", \")}). ${scaffoldSelectorHelp}`,\n    );\n  }\n\n  if (hasPreset && presetConflict) {\n    throw new Error(\n      `Cannot use --preset with ${presetConflict}. ${scaffoldSelectorHelp}`,\n    );\n  }\n\n  if (opts.native) return { example: \"with-expo\" };\n  if (opts.ink) return { example: \"with-react-ink\" };\n\n  if (opts.preset !== undefined && opts.template === undefined) {\n    return { template: \"default\", preset: opts.preset };\n  }\n\n  return {\n    ...(opts.template !== undefined && { template: opts.template }),\n    ...(opts.example !== undefined && { example: opts.example }),\n    ...(hasPreset && { preset: opts.preset }),\n  };\n}\n\nexport const create = new Command()\n  .name(\"create\")\n  .description(\"create a new project\")\n  .argument(\"[project-directory]\")\n  .usage(`${chalk.green(\"[project-directory]\")} [options]`)\n  .option(\n    \"-t, --template <template>\",\n    `template to use (${templateNames.join(\", \")})`,\n  )\n  .option(\n    \"-e, --example <example>\",\n    `create from an example (${exampleNames.join(\", \")})`,\n  )\n  .option(\n    \"-p, --preset <name-or-url>\",\n    \"preset name or URL (e.g., chatgpt or https://www.assistant-ui.com/playground/init?preset=chatgpt)\",\n  )\n  .option(\"--use-npm\", \"explicitly use npm\")\n  .option(\"--use-pnpm\", \"explicitly use pnpm\")\n  .option(\"--use-yarn\", \"explicitly use yarn\")\n  .option(\"--use-bun\", \"explicitly use bun\")\n  .option(\"--native\", \"create an Expo / React Native project\")\n  .option(\"--ink\", \"create a React Ink terminal project\")\n  .option(\"--skip-install\", \"skip installing packages\")\n  .addOption(\n    new Option(\n      \"--debug-source-root <path>\",\n      \"copy templates/examples from a local assistant-ui repo root\",\n    ).hideHelp(),\n  )\n  .action(async (projectDirectory, opts) => {\n    let scaffoldSelector: ResolvedScaffoldSelector;\n    try {\n      scaffoldSelector = resolveScaffoldSelector(opts);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error(message);\n      process.exit(1);\n    }\n\n    const localSourceRoot = opts.debugSourceRoot\n      ? path.resolve(opts.debugSourceRoot)\n      : undefined;\n\n    // Start release ref resolution early (runs during user prompts)\n    const refPromise = localSourceRoot\n      ? Promise.resolve(undefined)\n      : resolveLatestReleaseRef();\n\n    // 1. Resolve project directory\n    let resolvedProjectDirectory = resolveCreateProjectDirectory({\n      projectDirectory,\n    });\n\n    if (!resolvedProjectDirectory) {\n      const result = await p.text({\n        message: \"Project name:\",\n        placeholder: \"my-aui-app\",\n        defaultValue: \"my-aui-app\",\n        validate: (value?: string) => {\n          const name = (value ?? \"\").trim();\n          if (!name) return \"Project name cannot be empty\";\n          if (name === \".\" || name === \"..\")\n            return \"Project name cannot be . or ..\";\n          if (name.includes(\"/\") || name.includes(\"\\\\\"))\n            return \"Project name cannot contain path separators\";\n          return undefined;\n        },\n      });\n\n      if (p.isCancel(result)) {\n        p.cancel(\"Project creation cancelled.\");\n        process.exit(0);\n      }\n\n      resolvedProjectDirectory = result;\n    }\n\n    // Check directory\n    const absoluteProjectDir = path.resolve(resolvedProjectDirectory);\n    try {\n      const files = fs.readdirSync(absoluteProjectDir);\n      if (files.length > 0) {\n        logger.error(\n          `Directory ${resolvedProjectDirectory} already exists and is not empty`,\n        );\n        process.exit(1);\n      }\n    } catch (err: unknown) {\n      const code =\n        err instanceof Error ? (err as NodeJS.ErrnoException).code : undefined;\n      if (code === \"ENOENT\") {\n        // Directory doesn't exist — good, proceed\n      } else if (code === \"ENOTDIR\") {\n        logger.error(\n          `${resolvedProjectDirectory} already exists and is not a directory`,\n        );\n        process.exit(1);\n      } else {\n        const message = err instanceof Error ? err.message : String(err);\n        logger.error(`Cannot access ${resolvedProjectDirectory}: ${message}`);\n        process.exit(1);\n      }\n    }\n\n    // 2. Resolve scaffold target\n    const project = await resolveProject(scaffoldSelector);\n    if (!project) {\n      p.cancel(\"Project creation cancelled.\");\n      process.exit(0);\n    }\n\n    logger.info(`Creating project from ${project.category}: ${project.label}`);\n    logger.break();\n\n    const pm = await resolvePackageManagerForCwd(\n      path.dirname(absoluteProjectDir),\n      resolvePackageManager(opts),\n    );\n\n    // Clean up partial project directory on unexpected exit (e.g. Ctrl+C)\n    const cleanupOnExit = () => {\n      fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n    };\n    process.once(\"exit\", cleanupOnExit);\n\n    try {\n      // 3. Resolve latest release ref (started before prompts)\n      if (!localSourceRoot) {\n        logger.step(\"Resolving latest release...\");\n      }\n      const ref = await refPromise;\n      if (!localSourceRoot && !ref) {\n        logger.warn(\"Could not resolve latest release, downloading from HEAD\");\n      }\n\n      // 4. Scaffold project\n      logger.step(\n        localSourceRoot\n          ? `Copying project from local source: ${localSourceRoot}`\n          : \"Downloading project...\",\n      );\n      try {\n        const source = localSourceRoot\n          ? { kind: \"local\" as const, rootDir: localSourceRoot }\n          : {\n              kind: \"github\" as const,\n              ref,\n            };\n        await scaffoldProject(project.path, absoluteProjectDir, source);\n\n        // If the template didn't exist at the release tag, retry from HEAD\n        if (\n          !localSourceRoot &&\n          ref &&\n          !fs.existsSync(path.join(absoluteProjectDir, \"package.json\"))\n        ) {\n          fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n          logger.warn(\n            \"Template not found at release tag, downloading from HEAD\",\n          );\n          await downloadProject(project.path, absoluteProjectDir);\n        }\n\n        // 5. Run transform pipeline\n        await transformProject(absoluteProjectDir, {\n          hasLocalComponents: project.hasLocalComponents,\n          skipInstall: opts.skipInstall,\n          packageManager: pm,\n        });\n      } catch (err) {\n        // Clean up partially created project directory\n        fs.rmSync(absoluteProjectDir, { recursive: true, force: true });\n        throw err;\n      }\n\n      // 6. Apply preset if provided\n      if (scaffoldSelector.preset) {\n        const presetUrl = resolvePresetUrl(scaffoldSelector.preset);\n        logger.info(\"Applying preset configuration...\");\n        logger.break();\n        const [dlxCmd, dlxArgs] = dlxCommand(pm);\n        try {\n          await runSpawn(\n            dlxCmd,\n            [\n              ...dlxArgs,\n              \"shadcn@latest\",\n              \"add\",\n              \"--yes\",\n              \"--overwrite\",\n              presetUrl,\n            ],\n            absoluteProjectDir,\n          );\n        } catch {\n          logger.warn(\n            `Preset application failed. You can retry manually with:\\n  ${dlxCmd} ${[...dlxArgs, \"shadcn@latest\", \"add\", presetUrl].join(\" \")}`,\n          );\n        }\n      }\n\n      process.removeListener(\"exit\", cleanupOnExit);\n\n      logger.break();\n      logger.success(\"Project created successfully!\");\n      logger.break();\n      const runCmd = pm === \"npm\" ? \"npm run\" : pm;\n      let devScript = \"dev\";\n      let envFile = \".env.local\";\n      try {\n        const scaffoldedPkg = JSON.parse(\n          fs.readFileSync(\n            path.join(absoluteProjectDir, \"package.json\"),\n            \"utf-8\",\n          ),\n        );\n        devScript = scaffoldedPkg.scripts?.dev\n          ? \"dev\"\n          : scaffoldedPkg.scripts?.start\n            ? \"start\"\n            : \"dev\";\n        envFile = scaffoldedPkg.dependencies?.next ? \".env.local\" : \".env\";\n      } catch {\n        // Fall back to defaults if package.json cannot be read\n      }\n\n      logger.info(\"Next steps:\");\n      logger.info(`  cd ${resolvedProjectDirectory}`);\n      if (opts.skipInstall) {\n        logger.info(`  ${pm} install`);\n      }\n      logger.info(`  # Set up your environment variables in ${envFile}`);\n      logger.info(`  ${runCmd} ${devScript}`);\n    } catch (error) {\n      if (error instanceof SpawnExitError) {\n        logger.error(`Project creation failed with code ${error.code}`);\n        process.exit(error.code);\n      }\n      const message = error instanceof Error ? error.message : String(error);\n      logger.error(`Failed to create project: ${message}`);\n      process.exit(1);\n    }\n  });\n"],"mappings":";;;;;;;;;AA0BA,MAAa,mBAAsC;CAEjD;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CAEA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA;EACE,MAAM;EACN,OAAO;EACP,aAAa;EACb,UAAU;EACV,MAAM;EACN,oBAAoB;CACtB;CACA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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,26 @@
+import { Command } from "commander";
+
+//#region src/commands/doctor.d.ts
+interface DiscoveredPackage {
+  name: string;
+  version: string;
+  installPath: string;
+}
+declare function discoverInstalledPackages(cwd: string): DiscoveredPackage[];
+interface DuplicateGroup {
+  name: string;
+  installations: DiscoveredPackage[];
+}
+declare function findDuplicates(packages: DiscoveredPackage[]): DuplicateGroup[];
+declare function uniquePackageNames(packages: DiscoveredPackage[]): string[];
+declare function compareSemver(a: string, b: string): number;
+interface OutdatedPackage {
+  name: string;
+  current: string;
+  latest: string;
+}
+declare function findOutdated(packages: DiscoveredPackage[], latest: Map<string, string | null>): OutdatedPackage[];
+declare const doctor: Command;
+//#endregion
+export { DiscoveredPackage, DuplicateGroup, OutdatedPackage, compareSemver, discoverInstalledPackages, doctor, findDuplicates, findOutdated, uniquePackageNames };
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","names":[],"sources":["../../src/commands/doctor.ts"],"mappings":";;;UAiBiB,iBAAA;EACf,IAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,iBA2Fc,yBAAA,CAA0B,GAAA,WAAc,iBAAiB;AAAA,UAOxD,cAAA;EACf,IAAA;EACA,aAAA,EAAe,iBAAiB;AAAA;AAAA,iBAGlB,cAAA,CACd,QAAA,EAAU,iBAAA,KACT,cAAc;AAAA,iBAmBD,kBAAA,CAAmB,QAA6B,EAAnB,iBAAiB;AAAA,iBAqD9C,aAAA,CAAc,CAAA,UAAW,CAAS;AAAA,UAkBjC,eAAA;EACf,IAAA;EACA,OAAA;EACA,MAAA;AAAA;AAAA,iBAGc,YAAA,CACd,QAAA,EAAU,iBAAA,IACV,MAAA,EAAQ,GAAA,0BACP,eAAA;AAAA,cAsFU,MAAA,EAAM,OA6Df"}

package/dist/commands/doctor.js

@@ -0,0 +1,219 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import * as fs$1 from "node:fs";
+import * as path$1 from "node:path";
+//#region src/commands/doctor.ts
+const ASSISTANT_UI_PACKAGE_NAMES = new Set([
+	"assistant-stream",
+	"assistant-cloud",
+	"assistant-ui"
+]);
+function isTrackedPackage(name) {
+	if (!name) return false;
+	if (name.startsWith("@assistant-ui/")) return true;
+	return ASSISTANT_UI_PACKAGE_NAMES.has(name);
+}
+function readJson(file) {
+	try {
+		return JSON.parse(fs$1.readFileSync(file, "utf8"));
+	} catch {
+		return null;
+	}
+}
+function processPackageDir(pkgDir, results, visited) {
+	const real = (() => {
+		try {
+			return fs$1.realpathSync(pkgDir);
+		} catch {
+			return pkgDir;
+		}
+	})();
+	if (visited.set.has(real)) return;
+	visited.set.add(real);
+	const pkgJson = readJson(path$1.join(pkgDir, "package.json"));
+	let isTracked = false;
+	if (pkgJson) {
+		const name = pkgJson.name;
+		const version = pkgJson.version;
+		if (name && version && isTrackedPackage(name)) {
+			results.push({
+				name,
+				version,
+				installPath: pkgDir
+			});
+			isTracked = true;
+		}
+	}
+	if (isTracked) walkNodeModulesAt(pkgDir, results, visited);
+}
+function walkNodeModulesAt(baseDir, results, visited) {
+	const nm = path$1.join(baseDir, "node_modules");
+	if (!fs$1.existsSync(nm)) return;
+	let entries;
+	try {
+		entries = fs$1.readdirSync(nm, { withFileTypes: true });
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		if (entry.name.startsWith(".")) continue;
+		if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
+		if (entry.name.startsWith("@")) {
+			const scopeDir = path$1.join(nm, entry.name);
+			let scoped;
+			try {
+				scoped = fs$1.readdirSync(scopeDir, { withFileTypes: true });
+			} catch {
+				continue;
+			}
+			for (const s of scoped) {
+				if (!s.isDirectory() && !s.isSymbolicLink()) continue;
+				processPackageDir(path$1.join(scopeDir, s.name), results, visited);
+			}
+		} else processPackageDir(path$1.join(nm, entry.name), results, visited);
+	}
+}
+function discoverInstalledPackages(cwd) {
+	const results = [];
+	walkNodeModulesAt(cwd, results, { set: /* @__PURE__ */ new Set() });
+	return results;
+}
+function findDuplicates(packages) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const pkg of packages) {
+		const list = byName.get(pkg.name) ?? [];
+		list.push(pkg);
+		byName.set(pkg.name, list);
+	}
+	const duplicates = [];
+	for (const [name, installations] of byName) if (new Set(installations.map((i) => i.version)).size > 1) duplicates.push({
+		name,
+		installations
+	});
+	duplicates.sort((a, b) => a.name.localeCompare(b.name));
+	return duplicates;
+}
+function uniquePackageNames(packages) {
+	return Array.from(new Set(packages.map((p) => p.name))).sort();
+}
+const VALID_NPM_NAME = /^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/;
+async function fetchLatestVersion(name) {
+	if (!VALID_NPM_NAME.test(name)) return null;
+	try {
+		const res = await fetch(`https://registry.npmjs.org/${name}/latest`, { headers: { Accept: "application/json" } });
+		if (!res.ok) return null;
+		return (await res.json()).version ?? null;
+	} catch {
+		return null;
+	}
+}
+async function fetchAllLatestVersions(names) {
+	const entries = await Promise.all(names.map(async (n) => [n, await fetchLatestVersion(n)]));
+	return new Map(entries);
+}
+function parseSemver(v) {
+	const m = /^(\d+)\.(\d+)\.(\d+)(?:-([^+\s]+))?/.exec(v);
+	if (!m) return null;
+	return {
+		major: parseInt(m[1], 10),
+		minor: parseInt(m[2], 10),
+		patch: parseInt(m[3], 10),
+		prerelease: m[4] ?? ""
+	};
+}
+function compareSemver(a, b) {
+	const pa = parseSemver(a);
+	const pb = parseSemver(b);
+	if (!pa || !pb) return a.localeCompare(b);
+	if (pa.major !== pb.major) return pa.major - pb.major;
+	if (pa.minor !== pb.minor) return pa.minor - pb.minor;
+	if (pa.patch !== pb.patch) return pa.patch - pb.patch;
+	if (pa.prerelease === pb.prerelease) return 0;
+	if (!pa.prerelease) return 1;
+	if (!pb.prerelease) return -1;
+	return pa.prerelease.localeCompare(pb.prerelease);
+}
+function findOutdated(packages, latest) {
+	const newestByName = /* @__PURE__ */ new Map();
+	for (const pkg of packages) {
+		const existing = newestByName.get(pkg.name);
+		if (!existing || compareSemver(pkg.version, existing) > 0) newestByName.set(pkg.name, pkg.version);
+	}
+	const result = [];
+	for (const [name, current] of newestByName) {
+		const latestVersion = latest.get(name);
+		if (!latestVersion) continue;
+		if (compareSemver(current, latestVersion) < 0) result.push({
+			name,
+			current,
+			latest: latestVersion
+		});
+	}
+	result.sort((a, b) => a.name.localeCompare(b.name));
+	return result;
+}
+function relativeInstallPath(installPath, cwd) {
+	const rel = path$1.relative(cwd, installPath);
+	return rel.startsWith("..") ? installPath : rel;
+}
+function reportDuplicates(duplicates, cwd, lines) {
+	if (duplicates.length === 0) {
+		lines.push(chalk.green("✓ No duplicate versions detected."));
+		return;
+	}
+	lines.push(chalk.red.bold("✗ Duplicate versions detected:"));
+	for (const dup of duplicates) {
+		const versions = Array.from(new Set(dup.installations.map((i) => i.version))).sort(compareSemver).join(", ");
+		lines.push(chalk.red(`  ${dup.name} → ${versions}`));
+		for (const inst of dup.installations) lines.push(chalk.dim(`    ${inst.version}  ${relativeInstallPath(inst.installPath, cwd)}`));
+	}
+	lines.push("");
+	lines.push(chalk.yellow("Duplicates almost always cause subtle runtime bugs (see https://github.com/assistant-ui/assistant-ui/issues/4101)."));
+	lines.push(chalk.yellow("Fix by aligning all @assistant-ui/* packages to compatible versions — run:"));
+	lines.push(chalk.cyan("    npx assistant-ui update"));
+}
+function reportOutdated(outdated, lines) {
+	if (outdated.length === 0) {
+		lines.push(chalk.green("✓ All assistant-ui packages are up to date."));
+		return;
+	}
+	lines.push(chalk.yellow.bold("! Outdated packages:"));
+	const maxLen = Math.max(...outdated.map((o) => o.name.length));
+	for (const o of outdated) lines.push(chalk.yellow(`  ${o.name.padEnd(maxLen)}  ${o.current} → ${o.latest} (latest)`));
+	lines.push("");
+	lines.push(chalk.yellow("Run the following to upgrade everything:"));
+	lines.push(chalk.cyan("    npx assistant-ui update"));
+}
+const doctor = new Command().name("doctor").description("Diagnose mismatched or outdated assistant-ui packages (including transitive ones).").option("-c, --cwd <cwd>", "the working directory. defaults to the current directory.", process.cwd()).option("--no-network", "Skip the npm registry check for latest versions.").action(async (opts) => {
+	const cwd = path$1.resolve(opts.cwd);
+	const packageJsonPath = path$1.join(cwd, "package.json");
+	if (!fs$1.existsSync(packageJsonPath)) {
+		console.error(chalk.red("No package.json found in the current directory."));
+		process.exit(1);
+	}
+	console.log("");
+	console.log(chalk.bold("Running assistant-ui doctor..."));
+	console.log("");
+	const installed = discoverInstalledPackages(cwd);
+	if (installed.length === 0) {
+		console.log(chalk.yellow("No assistant-ui packages found in node_modules. Did you run `npm install`?"));
+		console.log("");
+		return;
+	}
+	const duplicates = findDuplicates(installed);
+	let latest = /* @__PURE__ */ new Map();
+	if (opts.network) latest = await fetchAllLatestVersions(uniquePackageNames(installed));
+	const outdated = findOutdated(installed, latest);
+	const lines = [];
+	reportDuplicates(duplicates, cwd, lines);
+	lines.push("");
+	if (opts.network) reportOutdated(outdated, lines);
+	else lines.push(chalk.dim("Skipped npm registry check (--no-network)."));
+	for (const line of lines) console.log(line);
+	console.log("");
+	if (duplicates.length > 0) process.exitCode = 1;
+});
+//#endregion
+export { compareSemver, discoverInstalledPackages, doctor, findDuplicates, findOutdated, uniquePackageNames };
+
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","names":["fs","path"],"sources":["../../src/commands/doctor.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport chalk from \"chalk\";\n\nconst ASSISTANT_UI_PACKAGE_NAMES = new Set([\n  \"assistant-stream\",\n  \"assistant-cloud\",\n  \"assistant-ui\",\n]);\n\nfunction isTrackedPackage(name: string | undefined): boolean {\n  if (!name) return false;\n  if (name.startsWith(\"@assistant-ui/\")) return true;\n  return ASSISTANT_UI_PACKAGE_NAMES.has(name);\n}\n\nexport interface DiscoveredPackage {\n  name: string;\n  version: string;\n  installPath: string;\n}\n\ninterface ProcessedDir {\n  set: Set<string>;\n}\n\nfunction readJson(file: string): Record<string, unknown> | null {\n  try {\n    return JSON.parse(fs.readFileSync(file, \"utf8\"));\n  } catch {\n    return null;\n  }\n}\n\nfunction processPackageDir(\n  pkgDir: string,\n  results: DiscoveredPackage[],\n  visited: ProcessedDir,\n): void {\n  const real = (() => {\n    try {\n      return fs.realpathSync(pkgDir);\n    } catch {\n      return pkgDir;\n    }\n  })();\n  if (visited.set.has(real)) return;\n  visited.set.add(real);\n\n  const pkgJson = readJson(path.join(pkgDir, \"package.json\"));\n  let isTracked = false;\n  if (pkgJson) {\n    const name = pkgJson.name as string | undefined;\n    const version = pkgJson.version as string | undefined;\n    if (name && version && isTrackedPackage(name)) {\n      results.push({ name, version, installPath: pkgDir });\n      isTracked = true;\n    }\n  }\n\n  // Only descend into nested node_modules of tracked packages. Transitive\n  // copies of @assistant-ui/* live inside packages that depend on them,\n  // which are themselves tracked. Walking every unrelated package's\n  // subtree turns a doctor run on a large repo into thousands of stat\n  // calls for no gain.\n  if (isTracked) {\n    walkNodeModulesAt(pkgDir, results, visited);\n  }\n}\n\nfunction walkNodeModulesAt(\n  baseDir: string,\n  results: DiscoveredPackage[],\n  visited: ProcessedDir,\n): void {\n  const nm = path.join(baseDir, \"node_modules\");\n  if (!fs.existsSync(nm)) return;\n\n  let entries: fs.Dirent[];\n  try {\n    entries = fs.readdirSync(nm, { withFileTypes: true });\n  } catch {\n    return;\n  }\n\n  for (const entry of entries) {\n    if (entry.name.startsWith(\".\")) continue;\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n\n    if (entry.name.startsWith(\"@\")) {\n      const scopeDir = path.join(nm, entry.name);\n      let scoped: fs.Dirent[];\n      try {\n        scoped = fs.readdirSync(scopeDir, { withFileTypes: true });\n      } catch {\n        continue;\n      }\n      for (const s of scoped) {\n        if (!s.isDirectory() && !s.isSymbolicLink()) continue;\n        processPackageDir(path.join(scopeDir, s.name), results, visited);\n      }\n    } else {\n      processPackageDir(path.join(nm, entry.name), results, visited);\n    }\n  }\n}\n\n// Discover every installation of an assistant-ui-family package reachable\n// from `cwd`. Recurses into nested node_modules so transitive copies\n// (the real source of duplicate-version bugs) are not missed.\nexport function discoverInstalledPackages(cwd: string): DiscoveredPackage[] {\n  const results: DiscoveredPackage[] = [];\n  const visited: ProcessedDir = { set: new Set() };\n  walkNodeModulesAt(cwd, results, visited);\n  return results;\n}\n\nexport interface DuplicateGroup {\n  name: string;\n  installations: DiscoveredPackage[];\n}\n\nexport function findDuplicates(\n  packages: DiscoveredPackage[],\n): DuplicateGroup[] {\n  const byName = new Map<string, DiscoveredPackage[]>();\n  for (const pkg of packages) {\n    const list = byName.get(pkg.name) ?? [];\n    list.push(pkg);\n    byName.set(pkg.name, list);\n  }\n\n  const duplicates: DuplicateGroup[] = [];\n  for (const [name, installations] of byName) {\n    const versions = new Set(installations.map((i) => i.version));\n    if (versions.size > 1) {\n      duplicates.push({ name, installations });\n    }\n  }\n  duplicates.sort((a, b) => a.name.localeCompare(b.name));\n  return duplicates;\n}\n\nexport function uniquePackageNames(packages: DiscoveredPackage[]): string[] {\n  return Array.from(new Set(packages.map((p) => p.name))).sort();\n}\n\n// Package names use a restricted character set (`[a-z0-9._~-]` plus a\n// leading `@scope/` for scoped packages — see the npm package-name spec)\n// and the npm registry expects the scope's `@` and `/` un-encoded. So a\n// simple validation + concatenation is both correct and avoids the\n// CodeQL \"incomplete string escaping\" foot-gun of `encodeURIComponent`\n// + targeted un-escape.\nconst VALID_NPM_NAME = /^(@[a-z0-9._~-]+\\/)?[a-z0-9._~-]+$/;\n\nasync function fetchLatestVersion(name: string): Promise<string | null> {\n  if (!VALID_NPM_NAME.test(name)) return null;\n  try {\n    const res = await fetch(`https://registry.npmjs.org/${name}/latest`, {\n      headers: { Accept: \"application/json\" },\n    });\n    if (!res.ok) return null;\n    const data = (await res.json()) as { version?: string };\n    return data.version ?? null;\n  } catch {\n    return null;\n  }\n}\n\nasync function fetchAllLatestVersions(\n  names: string[],\n): Promise<Map<string, string | null>> {\n  const entries = await Promise.all(\n    names.map(async (n) => [n, await fetchLatestVersion(n)] as const),\n  );\n  return new Map(entries);\n}\n\ninterface SemverParts {\n  major: number;\n  minor: number;\n  patch: number;\n  prerelease: string;\n}\n\nfunction parseSemver(v: string): SemverParts | null {\n  const m = /^(\\d+)\\.(\\d+)\\.(\\d+)(?:-([^+\\s]+))?/.exec(v);\n  if (!m) return null;\n  return {\n    major: parseInt(m[1]!, 10),\n    minor: parseInt(m[2]!, 10),\n    patch: parseInt(m[3]!, 10),\n    prerelease: m[4] ?? \"\",\n  };\n}\n\nexport function compareSemver(a: string, b: string): number {\n  const pa = parseSemver(a);\n  const pb = parseSemver(b);\n  if (!pa || !pb) return a.localeCompare(b);\n  if (pa.major !== pb.major) return pa.major - pb.major;\n  if (pa.minor !== pb.minor) return pa.minor - pb.minor;\n  if (pa.patch !== pb.patch) return pa.patch - pb.patch;\n\n  // Per SemVer §11: a version with a prerelease tag is *less than* the\n  // same x.y.z without one. We compare tags lexically for a stable\n  // ordering across prereleases — good enough for doctor's \"is X older\n  // than the npm latest\" check.\n  if (pa.prerelease === pb.prerelease) return 0;\n  if (!pa.prerelease) return 1;\n  if (!pb.prerelease) return -1;\n  return pa.prerelease.localeCompare(pb.prerelease);\n}\n\nexport interface OutdatedPackage {\n  name: string;\n  current: string;\n  latest: string;\n}\n\nexport function findOutdated(\n  packages: DiscoveredPackage[],\n  latest: Map<string, string | null>,\n): OutdatedPackage[] {\n  const newestByName = new Map<string, string>();\n  for (const pkg of packages) {\n    const existing = newestByName.get(pkg.name);\n    if (!existing || compareSemver(pkg.version, existing) > 0) {\n      newestByName.set(pkg.name, pkg.version);\n    }\n  }\n\n  const result: OutdatedPackage[] = [];\n  for (const [name, current] of newestByName) {\n    const latestVersion = latest.get(name);\n    if (!latestVersion) continue;\n    if (compareSemver(current, latestVersion) < 0) {\n      result.push({ name, current, latest: latestVersion });\n    }\n  }\n  result.sort((a, b) => a.name.localeCompare(b.name));\n  return result;\n}\n\nfunction relativeInstallPath(installPath: string, cwd: string): string {\n  const rel = path.relative(cwd, installPath);\n  return rel.startsWith(\"..\") ? installPath : rel;\n}\n\nfunction reportDuplicates(\n  duplicates: DuplicateGroup[],\n  cwd: string,\n  lines: string[],\n): void {\n  if (duplicates.length === 0) {\n    lines.push(chalk.green(\"✓ No duplicate versions detected.\"));\n    return;\n  }\n\n  lines.push(chalk.red.bold(\"✗ Duplicate versions detected:\"));\n  for (const dup of duplicates) {\n    const versions = Array.from(\n      new Set(dup.installations.map((i) => i.version)),\n    )\n      .sort(compareSemver)\n      .join(\", \");\n    lines.push(chalk.red(`  ${dup.name} → ${versions}`));\n    for (const inst of dup.installations) {\n      lines.push(\n        chalk.dim(\n          `    ${inst.version}  ${relativeInstallPath(inst.installPath, cwd)}`,\n        ),\n      );\n    }\n  }\n  lines.push(\"\");\n  lines.push(\n    chalk.yellow(\n      \"Duplicates almost always cause subtle runtime bugs (see https://github.com/assistant-ui/assistant-ui/issues/4101).\",\n    ),\n  );\n  lines.push(\n    chalk.yellow(\n      \"Fix by aligning all @assistant-ui/* packages to compatible versions — run:\",\n    ),\n  );\n  lines.push(chalk.cyan(\"    npx assistant-ui update\"));\n}\n\nfunction reportOutdated(outdated: OutdatedPackage[], lines: string[]): void {\n  if (outdated.length === 0) {\n    lines.push(chalk.green(\"✓ All assistant-ui packages are up to date.\"));\n    return;\n  }\n\n  lines.push(chalk.yellow.bold(\"! Outdated packages:\"));\n  const maxLen = Math.max(...outdated.map((o) => o.name.length));\n  for (const o of outdated) {\n    lines.push(\n      chalk.yellow(\n        `  ${o.name.padEnd(maxLen)}  ${o.current} → ${o.latest} (latest)`,\n      ),\n    );\n  }\n  lines.push(\"\");\n  lines.push(chalk.yellow(\"Run the following to upgrade everything:\"));\n  lines.push(chalk.cyan(\"    npx assistant-ui update\"));\n}\n\nexport const doctor = new Command()\n  .name(\"doctor\")\n  .description(\n    \"Diagnose mismatched or outdated assistant-ui packages (including transitive ones).\",\n  )\n  .option(\n    \"-c, --cwd <cwd>\",\n    \"the working directory. defaults to the current directory.\",\n    process.cwd(),\n  )\n  .option(\"--no-network\", \"Skip the npm registry check for latest versions.\")\n  .action(async (opts: { cwd: string; network: boolean }) => {\n    const cwd = path.resolve(opts.cwd);\n    const packageJsonPath = path.join(cwd, \"package.json\");\n\n    if (!fs.existsSync(packageJsonPath)) {\n      console.error(\n        chalk.red(\"No package.json found in the current directory.\"),\n      );\n      process.exit(1);\n    }\n\n    console.log(\"\");\n    console.log(chalk.bold(\"Running assistant-ui doctor...\"));\n    console.log(\"\");\n\n    const installed = discoverInstalledPackages(cwd);\n\n    if (installed.length === 0) {\n      console.log(\n        chalk.yellow(\n          \"No assistant-ui packages found in node_modules. Did you run `npm install`?\",\n        ),\n      );\n      console.log(\"\");\n      return;\n    }\n\n    const duplicates = findDuplicates(installed);\n\n    let latest = new Map<string, string | null>();\n    if (opts.network) {\n      latest = await fetchAllLatestVersions(uniquePackageNames(installed));\n    }\n    const outdated = findOutdated(installed, latest);\n\n    const lines: string[] = [];\n    reportDuplicates(duplicates, cwd, lines);\n    lines.push(\"\");\n    if (opts.network) {\n      reportOutdated(outdated, lines);\n    } else {\n      lines.push(chalk.dim(\"Skipped npm registry check (--no-network).\"));\n    }\n\n    for (const line of lines) console.log(line);\n    console.log(\"\");\n\n    if (duplicates.length > 0) {\n      process.exitCode = 1;\n    }\n  });\n"],"mappings":"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"}

package/dist/index.js

@@ -7,6 +7,7 @@ import { update } from "./commands/update.js";
 import { mcp } from "./commands/mcp.js";
 import { agent } from "./commands/agent.js";
 import { info } from "./commands/info.js";
+import { doctor } from "./commands/doctor.js";
 import { Command } from "commander";
 //#region src/index.ts
 process.on("SIGINT", () => process.exit(0));
@@ -22,6 +23,7 @@ function main() {
 	program.addCommand(update);
 	program.addCommand(agent);
 	program.addCommand(info);
+	program.addCommand(doctor);
 	program.parse();
 }
 main();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from \"commander\";\nimport { create } from \"./commands/create\";\nimport { add } from \"./commands/add\";\nimport { codemodCommand, upgradeCommand } from \"./commands/upgrade\";\nimport { init } from \"./commands/init\";\nimport { update } from \"./commands/update\";\nimport { mcp } from \"./commands/mcp\";\nimport { agent } from \"./commands/agent\";\nimport { info } from \"./commands/info\";\n\nprocess.on(\"SIGINT\", () => process.exit(0));\nprocess.on(\"SIGTERM\", () => process.exit(0));\n\nfunction main() {\n  const program = new Command()\n    .name(\"assistant-ui\")\n    .description(\"add components and dependencies to your project\");\n\n  program.addCommand(add);\n  program.addCommand(create);\n  program.addCommand(init);\n  program.addCommand(mcp);\n  program.addCommand(codemodCommand);\n  program.addCommand(upgradeCommand);\n  program.addCommand(update);\n  program.addCommand(agent);\n  program.addCommand(info);\n\n  program.parse();\n}\n\nmain();\n"],"mappings":";;;;;;;;;;;AAYA,QAAQ,GAAG,gBAAgB,QAAQ,KAAK,CAAC,CAAC;AAC1C,QAAQ,GAAG,iBAAiB,QAAQ,KAAK,CAAC,CAAC;AAE3C,SAAS,OAAO;CACd,MAAM,UAAU,IAAI,QAAQ,EACzB,KAAK,cAAc,EACnB,YAAY,iDAAiD;CAEhE,QAAQ,WAAW,GAAG;CACtB,QAAQ,WAAW,MAAM;CACzB,QAAQ,WAAW,IAAI;CACvB,QAAQ,WAAW,GAAG;CACtB,QAAQ,WAAW,cAAc;CACjC,QAAQ,WAAW,cAAc;CACjC,QAAQ,WAAW,MAAM;CACzB,QAAQ,WAAW,KAAK;CACxB,QAAQ,WAAW,IAAI;CAEvB,QAAQ,MAAM;AAChB;AAEA,KAAK"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from \"commander\";\nimport { create } from \"./commands/create\";\nimport { add } from \"./commands/add\";\nimport { codemodCommand, upgradeCommand } from \"./commands/upgrade\";\nimport { init } from \"./commands/init\";\nimport { update } from \"./commands/update\";\nimport { mcp } from \"./commands/mcp\";\nimport { agent } from \"./commands/agent\";\nimport { info } from \"./commands/info\";\nimport { doctor } from \"./commands/doctor\";\n\nprocess.on(\"SIGINT\", () => process.exit(0));\nprocess.on(\"SIGTERM\", () => process.exit(0));\n\nfunction main() {\n  const program = new Command()\n    .name(\"assistant-ui\")\n    .description(\"add components and dependencies to your project\");\n\n  program.addCommand(add);\n  program.addCommand(create);\n  program.addCommand(init);\n  program.addCommand(mcp);\n  program.addCommand(codemodCommand);\n  program.addCommand(upgradeCommand);\n  program.addCommand(update);\n  program.addCommand(agent);\n  program.addCommand(info);\n  program.addCommand(doctor);\n\n  program.parse();\n}\n\nmain();\n"],"mappings":";;;;;;;;;;;;AAaA,QAAQ,GAAG,gBAAgB,QAAQ,KAAK,CAAC,CAAC;AAC1C,QAAQ,GAAG,iBAAiB,QAAQ,KAAK,CAAC,CAAC;AAE3C,SAAS,OAAO;CACd,MAAM,UAAU,IAAI,QAAQ,EACzB,KAAK,cAAc,EACnB,YAAY,iDAAiD;CAEhE,QAAQ,WAAW,GAAG;CACtB,QAAQ,WAAW,MAAM;CACzB,QAAQ,WAAW,IAAI;CACvB,QAAQ,WAAW,GAAG;CACtB,QAAQ,WAAW,cAAc;CACjC,QAAQ,WAAW,cAAc;CACjC,QAAQ,WAAW,MAAM;CACzB,QAAQ,WAAW,KAAK;CACxB,QAAQ,WAAW,IAAI;CACvB,QAAQ,WAAW,MAAM;CAEzB,QAAQ,MAAM;AAChB;AAEA,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-ui",
-  "version": "0.0.93",
+  "version": "0.0.95",
   "description": "CLI for assistant-ui",
   "keywords": [
     "cli",

package/src/commands/create.ts

@@ -118,7 +118,7 @@ export const PROJECT_METADATA: ProjectMetadata[] = [
   {
     name: "with-chain-of-thought",
     label: "Chain of Thought",
-    description: "Chain-of-thought rendering",
+    description: "Chain-of-thought, tool calls, and source citations",
     category: "example",
     path: "examples/with-chain-of-thought",
     hasLocalComponents: false,
@@ -203,14 +203,6 @@ export const PROJECT_METADATA: ProjectMetadata[] = [
     path: "examples/with-langgraph",
     hasLocalComponents: false,
   },
-  {
-    name: "with-parent-id-grouping",
-    label: "Parent ID Grouping",
-    description: "Message grouping strategy",
-    category: "example",
-    path: "examples/with-parent-id-grouping",
-    hasLocalComponents: false,
-  },
   {
     name: "with-react-hook-form",
     label: "React Hook Form",

package/src/commands/doctor.ts

@@ -0,0 +1,372 @@
+import { Command } from "commander";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import chalk from "chalk";
+
+const ASSISTANT_UI_PACKAGE_NAMES = new Set([
+  "assistant-stream",
+  "assistant-cloud",
+  "assistant-ui",
+]);
+
+function isTrackedPackage(name: string | undefined): boolean {
+  if (!name) return false;
+  if (name.startsWith("@assistant-ui/")) return true;
+  return ASSISTANT_UI_PACKAGE_NAMES.has(name);
+}
+
+export interface DiscoveredPackage {
+  name: string;
+  version: string;
+  installPath: string;
+}
+
+interface ProcessedDir {
+  set: Set<string>;
+}
+
+function readJson(file: string): Record<string, unknown> | null {
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function processPackageDir(
+  pkgDir: string,
+  results: DiscoveredPackage[],
+  visited: ProcessedDir,
+): void {
+  const real = (() => {
+    try {
+      return fs.realpathSync(pkgDir);
+    } catch {
+      return pkgDir;
+    }
+  })();
+  if (visited.set.has(real)) return;
+  visited.set.add(real);
+
+  const pkgJson = readJson(path.join(pkgDir, "package.json"));
+  let isTracked = false;
+  if (pkgJson) {
+    const name = pkgJson.name as string | undefined;
+    const version = pkgJson.version as string | undefined;
+    if (name && version && isTrackedPackage(name)) {
+      results.push({ name, version, installPath: pkgDir });
+      isTracked = true;
+    }
+  }
+
+  // Only descend into nested node_modules of tracked packages. Transitive
+  // copies of @assistant-ui/* live inside packages that depend on them,
+  // which are themselves tracked. Walking every unrelated package's
+  // subtree turns a doctor run on a large repo into thousands of stat
+  // calls for no gain.
+  if (isTracked) {
+    walkNodeModulesAt(pkgDir, results, visited);
+  }
+}
+
+function walkNodeModulesAt(
+  baseDir: string,
+  results: DiscoveredPackage[],
+  visited: ProcessedDir,
+): void {
+  const nm = path.join(baseDir, "node_modules");
+  if (!fs.existsSync(nm)) return;
+
+  let entries: fs.Dirent[];
+  try {
+    entries = fs.readdirSync(nm, { withFileTypes: true });
+  } catch {
+    return;
+  }
+
+  for (const entry of entries) {
+    if (entry.name.startsWith(".")) continue;
+    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
+
+    if (entry.name.startsWith("@")) {
+      const scopeDir = path.join(nm, entry.name);
+      let scoped: fs.Dirent[];
+      try {
+        scoped = fs.readdirSync(scopeDir, { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      for (const s of scoped) {
+        if (!s.isDirectory() && !s.isSymbolicLink()) continue;
+        processPackageDir(path.join(scopeDir, s.name), results, visited);
+      }
+    } else {
+      processPackageDir(path.join(nm, entry.name), results, visited);
+    }
+  }
+}
+
+// Discover every installation of an assistant-ui-family package reachable
+// from `cwd`. Recurses into nested node_modules so transitive copies
+// (the real source of duplicate-version bugs) are not missed.
+export function discoverInstalledPackages(cwd: string): DiscoveredPackage[] {
+  const results: DiscoveredPackage[] = [];
+  const visited: ProcessedDir = { set: new Set() };
+  walkNodeModulesAt(cwd, results, visited);
+  return results;
+}
+
+export interface DuplicateGroup {
+  name: string;
+  installations: DiscoveredPackage[];
+}
+
+export function findDuplicates(
+  packages: DiscoveredPackage[],
+): DuplicateGroup[] {
+  const byName = new Map<string, DiscoveredPackage[]>();
+  for (const pkg of packages) {
+    const list = byName.get(pkg.name) ?? [];
+    list.push(pkg);
+    byName.set(pkg.name, list);
+  }
+
+  const duplicates: DuplicateGroup[] = [];
+  for (const [name, installations] of byName) {
+    const versions = new Set(installations.map((i) => i.version));
+    if (versions.size > 1) {
+      duplicates.push({ name, installations });
+    }
+  }
+  duplicates.sort((a, b) => a.name.localeCompare(b.name));
+  return duplicates;
+}
+
+export function uniquePackageNames(packages: DiscoveredPackage[]): string[] {
+  return Array.from(new Set(packages.map((p) => p.name))).sort();
+}
+
+// Package names use a restricted character set (`[a-z0-9._~-]` plus a
+// leading `@scope/` for scoped packages — see the npm package-name spec)
+// and the npm registry expects the scope's `@` and `/` un-encoded. So a
+// simple validation + concatenation is both correct and avoids the
+// CodeQL "incomplete string escaping" foot-gun of `encodeURIComponent`
+// + targeted un-escape.
+const VALID_NPM_NAME = /^(@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/;
+
+async function fetchLatestVersion(name: string): Promise<string | null> {
+  if (!VALID_NPM_NAME.test(name)) return null;
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${name}/latest`, {
+      headers: { Accept: "application/json" },
+    });
+    if (!res.ok) return null;
+    const data = (await res.json()) as { version?: string };
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+async function fetchAllLatestVersions(
+  names: string[],
+): Promise<Map<string, string | null>> {
+  const entries = await Promise.all(
+    names.map(async (n) => [n, await fetchLatestVersion(n)] as const),
+  );
+  return new Map(entries);
+}
+
+interface SemverParts {
+  major: number;
+  minor: number;
+  patch: number;
+  prerelease: string;
+}
+
+function parseSemver(v: string): SemverParts | null {
+  const m = /^(\d+)\.(\d+)\.(\d+)(?:-([^+\s]+))?/.exec(v);
+  if (!m) return null;
+  return {
+    major: parseInt(m[1]!, 10),
+    minor: parseInt(m[2]!, 10),
+    patch: parseInt(m[3]!, 10),
+    prerelease: m[4] ?? "",
+  };
+}
+
+export function compareSemver(a: string, b: string): number {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  if (!pa || !pb) return a.localeCompare(b);
+  if (pa.major !== pb.major) return pa.major - pb.major;
+  if (pa.minor !== pb.minor) return pa.minor - pb.minor;
+  if (pa.patch !== pb.patch) return pa.patch - pb.patch;
+
+  // Per SemVer §11: a version with a prerelease tag is *less than* the
+  // same x.y.z without one. We compare tags lexically for a stable
+  // ordering across prereleases — good enough for doctor's "is X older
+  // than the npm latest" check.
+  if (pa.prerelease === pb.prerelease) return 0;
+  if (!pa.prerelease) return 1;
+  if (!pb.prerelease) return -1;
+  return pa.prerelease.localeCompare(pb.prerelease);
+}
+
+export interface OutdatedPackage {
+  name: string;
+  current: string;
+  latest: string;
+}
+
+export function findOutdated(
+  packages: DiscoveredPackage[],
+  latest: Map<string, string | null>,
+): OutdatedPackage[] {
+  const newestByName = new Map<string, string>();
+  for (const pkg of packages) {
+    const existing = newestByName.get(pkg.name);
+    if (!existing || compareSemver(pkg.version, existing) > 0) {
+      newestByName.set(pkg.name, pkg.version);
+    }
+  }
+
+  const result: OutdatedPackage[] = [];
+  for (const [name, current] of newestByName) {
+    const latestVersion = latest.get(name);
+    if (!latestVersion) continue;
+    if (compareSemver(current, latestVersion) < 0) {
+      result.push({ name, current, latest: latestVersion });
+    }
+  }
+  result.sort((a, b) => a.name.localeCompare(b.name));
+  return result;
+}
+
+function relativeInstallPath(installPath: string, cwd: string): string {
+  const rel = path.relative(cwd, installPath);
+  return rel.startsWith("..") ? installPath : rel;
+}
+
+function reportDuplicates(
+  duplicates: DuplicateGroup[],
+  cwd: string,
+  lines: string[],
+): void {
+  if (duplicates.length === 0) {
+    lines.push(chalk.green("✓ No duplicate versions detected."));
+    return;
+  }
+
+  lines.push(chalk.red.bold("✗ Duplicate versions detected:"));
+  for (const dup of duplicates) {
+    const versions = Array.from(
+      new Set(dup.installations.map((i) => i.version)),
+    )
+      .sort(compareSemver)
+      .join(", ");
+    lines.push(chalk.red(`  ${dup.name} → ${versions}`));
+    for (const inst of dup.installations) {
+      lines.push(
+        chalk.dim(
+          `    ${inst.version}  ${relativeInstallPath(inst.installPath, cwd)}`,
+        ),
+      );
+    }
+  }
+  lines.push("");
+  lines.push(
+    chalk.yellow(
+      "Duplicates almost always cause subtle runtime bugs (see https://github.com/assistant-ui/assistant-ui/issues/4101).",
+    ),
+  );
+  lines.push(
+    chalk.yellow(
+      "Fix by aligning all @assistant-ui/* packages to compatible versions — run:",
+    ),
+  );
+  lines.push(chalk.cyan("    npx assistant-ui update"));
+}
+
+function reportOutdated(outdated: OutdatedPackage[], lines: string[]): void {
+  if (outdated.length === 0) {
+    lines.push(chalk.green("✓ All assistant-ui packages are up to date."));
+    return;
+  }
+
+  lines.push(chalk.yellow.bold("! Outdated packages:"));
+  const maxLen = Math.max(...outdated.map((o) => o.name.length));
+  for (const o of outdated) {
+    lines.push(
+      chalk.yellow(
+        `  ${o.name.padEnd(maxLen)}  ${o.current} → ${o.latest} (latest)`,
+      ),
+    );
+  }
+  lines.push("");
+  lines.push(chalk.yellow("Run the following to upgrade everything:"));
+  lines.push(chalk.cyan("    npx assistant-ui update"));
+}
+
+export const doctor = new Command()
+  .name("doctor")
+  .description(
+    "Diagnose mismatched or outdated assistant-ui packages (including transitive ones).",
+  )
+  .option(
+    "-c, --cwd <cwd>",
+    "the working directory. defaults to the current directory.",
+    process.cwd(),
+  )
+  .option("--no-network", "Skip the npm registry check for latest versions.")
+  .action(async (opts: { cwd: string; network: boolean }) => {
+    const cwd = path.resolve(opts.cwd);
+    const packageJsonPath = path.join(cwd, "package.json");
+
+    if (!fs.existsSync(packageJsonPath)) {
+      console.error(
+        chalk.red("No package.json found in the current directory."),
+      );
+      process.exit(1);
+    }
+
+    console.log("");
+    console.log(chalk.bold("Running assistant-ui doctor..."));
+    console.log("");
+
+    const installed = discoverInstalledPackages(cwd);
+
+    if (installed.length === 0) {
+      console.log(
+        chalk.yellow(
+          "No assistant-ui packages found in node_modules. Did you run `npm install`?",
+        ),
+      );
+      console.log("");
+      return;
+    }
+
+    const duplicates = findDuplicates(installed);
+
+    let latest = new Map<string, string | null>();
+    if (opts.network) {
+      latest = await fetchAllLatestVersions(uniquePackageNames(installed));
+    }
+    const outdated = findOutdated(installed, latest);
+
+    const lines: string[] = [];
+    reportDuplicates(duplicates, cwd, lines);
+    lines.push("");
+    if (opts.network) {
+      reportOutdated(outdated, lines);
+    } else {
+      lines.push(chalk.dim("Skipped npm registry check (--no-network)."));
+    }
+
+    for (const line of lines) console.log(line);
+    console.log("");
+
+    if (duplicates.length > 0) {
+      process.exitCode = 1;
+    }
+  });

package/src/index.ts

@@ -9,6 +9,7 @@ import { update } from "./commands/update";
 import { mcp } from "./commands/mcp";
 import { agent } from "./commands/agent";
 import { info } from "./commands/info";
+import { doctor } from "./commands/doctor";
 
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
@@ -27,6 +28,7 @@ function main() {
   program.addCommand(update);
   program.addCommand(agent);
   program.addCommand(info);
+  program.addCommand(doctor);
 
   program.parse();
 }