assistant-ui 0.0.120 → 0.0.122

package/dist/lib/utils/download.js

@@ -0,0 +1,41 @@
+import { downloadTemplate } from "giget";
+//#region src/lib/utils/download.ts
+const DOWNLOAD_TIMEOUT_MS = 3e4;
+function resolveGitHubAuthToken() {
+	return (process.env.GIGET_AUTH ?? process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN)?.trim() || void 0;
+}
+async function withStagedDownload(source, options, timeoutMessage, cleanup, consumeDownload) {
+	const origDebug = process.env.DEBUG;
+	delete process.env.DEBUG;
+	let download;
+	let settled = false;
+	try {
+		const authToken = resolveGitHubAuthToken();
+		download = downloadTemplate(source, {
+			...options,
+			...authToken ? { auth: authToken } : {}
+		}).finally(() => {
+			settled = true;
+		});
+		let timer;
+		const timeout = new Promise((_, reject) => {
+			timer = setTimeout(() => reject(new Error(timeoutMessage)), DOWNLOAD_TIMEOUT_MS);
+		});
+		try {
+			return await consumeDownload(Promise.race([download, timeout]));
+		} finally {
+			clearTimeout(timer);
+		}
+	} finally {
+		try {
+			if (!download || settled) await cleanup();
+			else download.then(cleanup, cleanup);
+		} finally {
+			if (origDebug !== void 0) process.env.DEBUG = origDebug;
+		}
+	}
+}
+//#endregion
+export { DOWNLOAD_TIMEOUT_MS, resolveGitHubAuthToken, withStagedDownload };
+
+//# sourceMappingURL=download.js.map

package/dist/lib/utils/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","names":[],"sources":["../../../src/lib/utils/download.ts"],"sourcesContent":["import { downloadTemplate } from \"giget\";\n\nexport const DOWNLOAD_TIMEOUT_MS = 30_000;\n\nexport function resolveGitHubAuthToken(): string | undefined {\n  const token =\n    process.env.GIGET_AUTH ?? process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;\n  const trimmed = token?.trim();\n  return trimmed || undefined;\n}\n\nexport async function withStagedDownload<T>(\n  source: string,\n  options: NonNullable<Parameters<typeof downloadTemplate>[1]>,\n  timeoutMessage: string,\n  cleanup: () => void | Promise<void>,\n  consumeDownload: (download: Promise<unknown>) => Promise<T>,\n): Promise<T> {\n  // giget logs to console.debug whenever DEBUG is set, which the `debug`\n  // package does at module load for an unrelated namespace.\n  const origDebug = process.env.DEBUG;\n  delete process.env.DEBUG;\n  let download: Promise<unknown> | undefined;\n  let settled = false;\n  try {\n    const authToken = resolveGitHubAuthToken();\n    download = downloadTemplate(source, {\n      ...options,\n      ...(authToken ? { auth: authToken } : {}),\n    }).finally(() => {\n      settled = true;\n    });\n\n    let timer: ReturnType<typeof setTimeout>;\n    const timeout = new Promise<never>((_, reject) => {\n      timer = setTimeout(\n        () => reject(new Error(timeoutMessage)),\n        DOWNLOAD_TIMEOUT_MS,\n      );\n    });\n    try {\n      return await consumeDownload(Promise.race([download, timeout]));\n    } finally {\n      clearTimeout(timer!);\n    }\n  } finally {\n    try {\n      if (!download || settled) {\n        await cleanup();\n      } else {\n        void download.then(cleanup, cleanup);\n      }\n    } finally {\n      if (origDebug !== undefined) process.env.DEBUG = origDebug;\n    }\n  }\n}\n"],"mappings":";;AAEA,MAAa,sBAAsB;AAEnC,SAAgB,yBAA6C;CAI3D,QAFE,QAAQ,IAAI,cAAc,QAAQ,IAAI,gBAAgB,QAAQ,IAAI,SAAA,EAC7C,KAAK,KACV,KAAA;AACpB;AAEA,eAAsB,mBACpB,QACA,SACA,gBACA,SACA,iBACY;CAGZ,MAAM,YAAY,QAAQ,IAAI;CAC9B,OAAO,QAAQ,IAAI;CACnB,IAAI;CACJ,IAAI,UAAU;CACd,IAAI;EACF,MAAM,YAAY,uBAAuB;EACzC,WAAW,iBAAiB,QAAQ;GAClC,GAAG;GACH,GAAI,YAAY,EAAE,MAAM,UAAU,IAAI,CAAC;EACzC,CAAC,CAAC,CAAC,cAAc;GACf,UAAU;EACZ,CAAC;EAED,IAAI;EACJ,MAAM,UAAU,IAAI,SAAgB,GAAG,WAAW;GAChD,QAAQ,iBACA,OAAO,IAAI,MAAM,cAAc,CAAC,GACtC,mBACF;EACF,CAAC;EACD,IAAI;GACF,OAAO,MAAM,gBAAgB,QAAQ,KAAK,CAAC,UAAU,OAAO,CAAC,CAAC;EAChE,UAAU;GACR,aAAa,KAAM;EACrB;CACF,UAAU;EACR,IAAI;GACF,IAAI,CAAC,YAAY,SACf,MAAM,QAAQ;QAEd,SAAc,KAAK,SAAS,OAAO;EAEvC,UAAU;GACR,IAAI,cAAc,KAAA,GAAW,QAAQ,IAAI,QAAQ;EACnD;CACF;AACF"}

package/dist/lib/utils/file-scanner.d.ts

@@ -12,5 +12,4 @@ export declare function readProjectFiles(pattern: string, options: {
     content: string;
 }>;
 export declare function scanForImport(importPattern: string | string[], options?: ScanOptions): boolean;
-export declare function getFilesContaining(searchString: string, options?: ScanOptions): string[];
 //# sourceMappingURL=file-scanner.d.ts.map

package/dist/lib/utils/file-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/file-scanner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAiB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1C,SAAS,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhE;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,EAChC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAoBT;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,MAAM,EAAE,CAqBV"}
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/file-scanner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAiB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1C,SAAS,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhE;AAED,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,EAChC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAoBT"}

package/dist/lib/utils/file-scanner.js

@@ -32,22 +32,7 @@ function scanForImport(importPattern, options = {}) {
 	})) if (patterns.some((p) => content.includes(p))) return true;
 	return false;
 }
-function getFilesContaining(searchString, options = {}) {
-	const cwd = options.cwd || process.cwd();
-	const pattern = options.pattern || "**/*.{js,jsx,ts,tsx}";
-	const ignore = options.ignore || [
-		"**/node_modules/**",
-		"**/dist/**",
-		"**/build/**"
-	];
-	const result = [];
-	for (const { fullPath, content } of readProjectFiles(pattern, {
-		cwd,
-		ignore
-	})) if (content.includes(searchString)) result.push(fullPath);
-	return result;
-}
 //#endregion
-export { getFilesContaining, readProjectFiles, scanForImport };
+export { readProjectFiles, scanForImport };
 
 //# sourceMappingURL=file-scanner.js.map

package/dist/lib/utils/file-scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-scanner.js","names":["globSync","path","fs"],"sources":["../../../src/lib/utils/file-scanner.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { sync as globSync } from \"glob\";\n\nexport interface ScanOptions {\n  cwd?: string;\n  pattern?: string;\n  ignore?: string[];\n}\n\nexport function* readProjectFiles(\n  pattern: string,\n  options: { cwd: string; ignore?: string[] },\n): Generator<{ file: string; fullPath: string; content: string }> {\n  const files = globSync(pattern, options);\n\n  for (const file of files) {\n    const fullPath = path.join(options.cwd, file);\n    try {\n      const content = fs.readFileSync(fullPath, \"utf8\");\n      yield { file, fullPath, content };\n    } catch {\n      continue;\n    }\n  }\n}\n\nexport function scanForImport(\n  importPattern: string | string[],\n  options: ScanOptions = {},\n): boolean {\n  const cwd = options.cwd || process.cwd();\n  const pattern = options.pattern || \"**/*.{js,jsx,ts,tsx}\";\n  const ignore = options.ignore || [\n    \"**/node_modules/**\",\n    \"**/dist/**\",\n    \"**/build/**\",\n  ];\n\n  const patterns = Array.isArray(importPattern)\n    ? importPattern\n    : [importPattern];\n\n  for (const { content } of readProjectFiles(pattern, { cwd, ignore })) {\n    if (patterns.some((p) => content.includes(p))) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function getFilesContaining(\n  searchString: string,\n  options: ScanOptions = {},\n): string[] {\n  const cwd = options.cwd || process.cwd();\n  const pattern = options.pattern || \"**/*.{js,jsx,ts,tsx}\";\n  const ignore = options.ignore || [\n    \"**/node_modules/**\",\n    \"**/dist/**\",\n    \"**/build/**\",\n  ];\n\n  const result: string[] = [];\n\n  for (const { fullPath, content } of readProjectFiles(pattern, {\n    cwd,\n    ignore,\n  })) {\n    if (content.includes(searchString)) {\n      result.push(fullPath);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;AAUA,UAAiB,iBACf,SACA,SACgE;CAChE,MAAM,QAAQA,KAAS,SAAS,OAAO;CAEvC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,WAAWC,OAAK,KAAK,QAAQ,KAAK,IAAI;EAC5C,IAAI;GAEF,MAAM;IAAE;IAAM;IAAU,SADRC,KAAG,aAAa,UAAU,MACZ;GAAE;EAClC,QAAQ;GACN;EACF;CACF;AACF;AAEA,SAAgB,cACd,eACA,UAAuB,CAAC,GACf;CACT,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,QAAQ,UAAU;EAC/B;EACA;EACA;CACF;CAEA,MAAM,WAAW,MAAM,QAAQ,aAAa,IACxC,gBACA,CAAC,aAAa;CAElB,KAAK,MAAM,EAAE,aAAa,iBAAiB,SAAS;EAAE;EAAK;CAAO,CAAC,GACjE,IAAI,SAAS,MAAM,MAAM,QAAQ,SAAS,CAAC,CAAC,GAC1C,OAAO;CAIX,OAAO;AACT;AAEA,SAAgB,mBACd,cACA,UAAuB,CAAC,GACd;CACV,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,QAAQ,UAAU;EAC/B;EACA;EACA;CACF;CAEA,MAAM,SAAmB,CAAC;CAE1B,KAAK,MAAM,EAAE,UAAU,aAAa,iBAAiB,SAAS;EAC5D;EACA;CACF,CAAC,GACC,IAAI,QAAQ,SAAS,YAAY,GAC/B,OAAO,KAAK,QAAQ;CAIxB,OAAO;AACT"}
+{"version":3,"file":"file-scanner.js","names":["globSync","path","fs"],"sources":["../../../src/lib/utils/file-scanner.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { sync as globSync } from \"glob\";\n\nexport interface ScanOptions {\n  cwd?: string;\n  pattern?: string;\n  ignore?: string[];\n}\n\nexport function* readProjectFiles(\n  pattern: string,\n  options: { cwd: string; ignore?: string[] },\n): Generator<{ file: string; fullPath: string; content: string }> {\n  const files = globSync(pattern, options);\n\n  for (const file of files) {\n    const fullPath = path.join(options.cwd, file);\n    try {\n      const content = fs.readFileSync(fullPath, \"utf8\");\n      yield { file, fullPath, content };\n    } catch {\n      continue;\n    }\n  }\n}\n\nexport function scanForImport(\n  importPattern: string | string[],\n  options: ScanOptions = {},\n): boolean {\n  const cwd = options.cwd || process.cwd();\n  const pattern = options.pattern || \"**/*.{js,jsx,ts,tsx}\";\n  const ignore = options.ignore || [\n    \"**/node_modules/**\",\n    \"**/dist/**\",\n    \"**/build/**\",\n  ];\n\n  const patterns = Array.isArray(importPattern)\n    ? importPattern\n    : [importPattern];\n\n  for (const { content } of readProjectFiles(pattern, { cwd, ignore })) {\n    if (patterns.some((p) => content.includes(p))) {\n      return true;\n    }\n  }\n\n  return false;\n}\n"],"mappings":";;;;AAUA,UAAiB,iBACf,SACA,SACgE;CAChE,MAAM,QAAQA,KAAS,SAAS,OAAO;CAEvC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,WAAWC,OAAK,KAAK,QAAQ,KAAK,IAAI;EAC5C,IAAI;GAEF,MAAM;IAAE;IAAM;IAAU,SADRC,KAAG,aAAa,UAAU,MACZ;GAAE;EAClC,QAAQ;GACN;EACF;CACF;AACF;AAEA,SAAgB,cACd,eACA,UAAuB,CAAC,GACf;CACT,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,QAAQ,UAAU;EAC/B;EACA;EACA;CACF;CAEA,MAAM,WAAW,MAAM,QAAQ,aAAa,IACxC,gBACA,CAAC,aAAa;CAElB,KAAK,MAAM,EAAE,aAAa,iBAAiB,SAAS;EAAE;EAAK;CAAO,CAAC,GACjE,IAAI,SAAS,MAAM,MAAM,QAAQ,SAAS,CAAC,CAAC,GAC1C,OAAO;CAIX,OAAO;AACT"}

package/dist/lib/utils/package-manager.d.ts

@@ -1,4 +1,11 @@
 export type PackageManagerName = "npm" | "pnpm" | "yarn" | "bun";
+export declare function dlxCommand(pm: PackageManagerName): [string, string[]];
+export declare function resolvePackageManager(opts: {
+    useNpm?: boolean;
+    usePnpm?: boolean;
+    useYarn?: boolean;
+    useBun?: boolean;
+}): PackageManagerName | undefined;
 export declare function askQuestion(query: string): Promise<string>;
 export declare function isPackageInstalled(pkg: string, cwd?: string): boolean;
 export interface InstallCommand {

package/dist/lib/utils/package-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/package-manager.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC1D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAgBT;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAazB;AAYD,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,kBAAkB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAUlB"}
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/package-manager.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,wBAAgB,UAAU,CAAC,EAAE,EAAE,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWrE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,kBAAkB,GAAG,SAAS,CAMjC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC1D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAgBT;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAazB;AAYD,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,kBAAkB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/lib/utils/package-manager.js

@@ -5,6 +5,20 @@ import * as path$1 from "node:path";
 import { detect } from "detect-package-manager";
 import * as readline from "node:readline";
 //#region src/lib/utils/package-manager.ts
+function dlxCommand(pm) {
+	switch (pm) {
+		case "pnpm": return ["pnpm", ["dlx"]];
+		case "yarn": return ["yarn", ["dlx"]];
+		case "bun": return ["bunx", []];
+		case "npm": return ["npx", ["--yes"]];
+	}
+}
+function resolvePackageManager(opts) {
+	if (opts.useNpm) return "npm";
+	if (opts.usePnpm) return "pnpm";
+	if (opts.useYarn) return "yarn";
+	if (opts.useBun) return "bun";
+}
 function askQuestion(query) {
 	return new Promise((resolve) => {
 		if (process.stdin.readableEnded) {
@@ -93,6 +107,6 @@ async function installPackage(packageName, cwd) {
 	}
 }
 //#endregion
-export { askQuestion, getInstallCommand, installPackage, isPackageInstalled, resolvePackageManagerForCwd };
+export { askQuestion, dlxCommand, getInstallCommand, installPackage, isPackageInstalled, resolvePackageManager, resolvePackageManagerForCwd };
 
 //# sourceMappingURL=package-manager.js.map

package/dist/lib/utils/package-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager.js","names":["path","fs"],"sources":["../../../src/lib/utils/package-manager.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { detect } from \"detect-package-manager\";\nimport * as readline from \"node:readline\";\nimport { logger } from \"./logger\";\nimport { runSpawn, SpawnSignalError } from \"../run-spawn\";\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport function askQuestion(query: string): Promise<string> {\n  return new Promise((resolve) => {\n    // A stream only reaches EOF once, so a run that already consumed stdin gets\n    // no further `end` and an interface built over it would wait on a `close`\n    // that cannot arrive. An upgrade asks up to three questions.\n    if (process.stdin.readableEnded) {\n      resolve(\"\");\n      return;\n    }\n    const rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n    });\n    // stdin at EOF (a piped or CI run) emits `close` without a `line`, so the\n    // question callback alone would leave this pending forever and the process\n    // would exit 0 with the remaining work silently skipped. An empty answer is\n    // what pressing Enter sends, so EOF lands on the prompt's own default.\n    // A final answer with no trailing newline arrives as `line` instead of\n    // through the callback, and has to win over that default.\n    // Ctrl-C in raw mode is delivered as this event rather than as a signal,\n    // and without a listener readline answers it by closing — which the EOF\n    // default would then read as approval. A cancelled prompt declines.\n    let cancelled = false;\n    rl.on(\"SIGINT\", () => {\n      cancelled = true;\n      rl.close();\n    });\n    rl.on(\"line\", resolve);\n    rl.on(\"close\", () => resolve(cancelled ? \"n\" : \"\"));\n    rl.question(query, (answer) => {\n      resolve(answer);\n      rl.close();\n    });\n  });\n}\n\nexport function isPackageInstalled(\n  pkg: string,\n  cwd: string = process.cwd(),\n): boolean {\n  try {\n    const pkgJsonPath = path.join(cwd, \"package.json\");\n    if (fs.existsSync(pkgJsonPath)) {\n      const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf8\"));\n      const deps = pkgJson.dependencies || {};\n      const devDeps = pkgJson.devDependencies || {};\n      if (deps[pkg] || devDeps[pkg]) {\n        return true;\n      }\n    }\n  } catch {\n    // Fall back to node_modules check below.\n  }\n  const modulePath = path.join(cwd, \"node_modules\", ...pkg.split(\"/\"));\n  return fs.existsSync(modulePath);\n}\n\nexport interface InstallCommand {\n  command: string;\n  args: string[];\n}\n\nexport async function getInstallCommand(\n  packageName: string | string[],\n  cwd?: string,\n): Promise<InstallCommand> {\n  const pm = await detect({ cwd });\n  const packages = Array.isArray(packageName) ? packageName : [packageName];\n  switch (pm) {\n    case \"yarn\":\n      return { command: \"yarn\", args: [\"add\", ...packages] };\n    case \"pnpm\":\n      return { command: \"pnpm\", args: [\"add\", ...packages] };\n    case \"bun\":\n      return { command: \"bun\", args: [\"add\", ...packages] };\n    default:\n      return { command: \"npm\", args: [\"install\", ...packages] };\n  }\n}\n\nfunction detectFromUserAgent(): PackageManagerName | undefined {\n  const ua = process.env.npm_config_user_agent;\n  if (!ua) return undefined;\n  if (ua.startsWith(\"bun/\")) return \"bun\";\n  if (ua.startsWith(\"pnpm/\")) return \"pnpm\";\n  if (ua.startsWith(\"yarn/\")) return \"yarn\";\n  if (ua.startsWith(\"npm/\")) return \"npm\";\n  return undefined;\n}\n\nexport async function resolvePackageManagerForCwd(\n  cwd: string,\n  packageManager?: PackageManagerName,\n): Promise<PackageManagerName> {\n  if (packageManager) return packageManager;\n  const fromAgent = detectFromUserAgent();\n  if (fromAgent) return fromAgent;\n  try {\n    return await detect({ cwd });\n  } catch {\n    return \"npm\";\n  }\n}\n\nexport async function installPackage(\n  packageName: string,\n  cwd?: string,\n): Promise<boolean> {\n  try {\n    const { command, args } = await getInstallCommand(packageName, cwd);\n    await runSpawn(command, args, cwd);\n    return true;\n  } catch (e) {\n    if (e instanceof SpawnSignalError) throw e;\n    logger.error(`Installation failed: ${String(e)}`);\n    return false;\n  }\n}\n"],"mappings":";;;;;;;AASA,SAAgB,YAAY,OAAgC;CAC1D,OAAO,IAAI,SAAS,YAAY;EAI9B,IAAI,QAAQ,MAAM,eAAe;GAC/B,QAAQ,EAAE;GACV;EACF;EACA,MAAM,KAAK,SAAS,gBAAgB;GAClC,OAAO,QAAQ;GACf,QAAQ,QAAQ;EAClB,CAAC;EAUD,IAAI,YAAY;EAChB,GAAG,GAAG,gBAAgB;GACpB,YAAY;GACZ,GAAG,MAAM;EACX,CAAC;EACD,GAAG,GAAG,QAAQ,OAAO;EACrB,GAAG,GAAG,eAAe,QAAQ,YAAY,MAAM,EAAE,CAAC;EAClD,GAAG,SAAS,QAAQ,WAAW;GAC7B,QAAQ,MAAM;GACd,GAAG,MAAM;EACX,CAAC;CACH,CAAC;AACH;AAEA,SAAgB,mBACd,KACA,MAAc,QAAQ,IAAI,GACjB;CACT,IAAI;EACF,MAAM,cAAcA,OAAK,KAAK,KAAK,cAAc;EACjD,IAAIC,KAAG,WAAW,WAAW,GAAG;GAC9B,MAAM,UAAU,KAAK,MAAMA,KAAG,aAAa,aAAa,MAAM,CAAC;GAC/D,MAAM,OAAO,QAAQ,gBAAgB,CAAC;GACtC,MAAM,UAAU,QAAQ,mBAAmB,CAAC;GAC5C,IAAI,KAAK,QAAQ,QAAQ,MACvB,OAAO;EAEX;CACF,QAAQ,CAER;CACA,MAAM,aAAaD,OAAK,KAAK,KAAK,gBAAgB,GAAG,IAAI,MAAM,GAAG,CAAC;CACnE,OAAOC,KAAG,WAAW,UAAU;AACjC;AAOA,eAAsB,kBACpB,aACA,KACyB;CACzB,MAAM,KAAK,MAAM,OAAO,EAAE,IAAI,CAAC;CAC/B,MAAM,WAAW,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW;CACxE,QAAQ,IAAR;EACE,KAAK,QACH,OAAO;GAAE,SAAS;GAAQ,MAAM,CAAC,OAAO,GAAG,QAAQ;EAAE;EACvD,KAAK,QACH,OAAO;GAAE,SAAS;GAAQ,MAAM,CAAC,OAAO,GAAG,QAAQ;EAAE;EACvD,KAAK,OACH,OAAO;GAAE,SAAS;GAAO,MAAM,CAAC,OAAO,GAAG,QAAQ;EAAE;EACtD,SACE,OAAO;GAAE,SAAS;GAAO,MAAM,CAAC,WAAW,GAAG,QAAQ;EAAE;CAC5D;AACF;AAEA,SAAS,sBAAsD;CAC7D,MAAM,KAAK,QAAQ,IAAI;CACvB,IAAI,CAAC,IAAI,OAAO,KAAA;CAChB,IAAI,GAAG,WAAW,MAAM,GAAG,OAAO;CAClC,IAAI,GAAG,WAAW,OAAO,GAAG,OAAO;CACnC,IAAI,GAAG,WAAW,OAAO,GAAG,OAAO;CACnC,IAAI,GAAG,WAAW,MAAM,GAAG,OAAO;AAEpC;AAEA,eAAsB,4BACpB,KACA,gBAC6B;CAC7B,IAAI,gBAAgB,OAAO;CAC3B,MAAM,YAAY,oBAAoB;CACtC,IAAI,WAAW,OAAO;CACtB,IAAI;EACF,OAAO,MAAM,OAAO,EAAE,IAAI,CAAC;CAC7B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,eACpB,aACA,KACkB;CAClB,IAAI;EACF,MAAM,EAAE,SAAS,SAAS,MAAM,kBAAkB,aAAa,GAAG;EAClE,MAAM,SAAS,SAAS,MAAM,GAAG;EACjC,OAAO;CACT,SAAS,GAAG;EACV,IAAI,aAAa,kBAAkB,MAAM;EACzC,OAAO,MAAM,wBAAwB,OAAO,CAAC,GAAG;EAChD,OAAO;CACT;AACF"}
+{"version":3,"file":"package-manager.js","names":["path","fs"],"sources":["../../../src/lib/utils/package-manager.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { detect } from \"detect-package-manager\";\nimport * as readline from \"node:readline\";\nimport { logger } from \"./logger\";\nimport { runSpawn, SpawnSignalError } from \"../run-spawn\";\n\nexport type PackageManagerName = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nexport function dlxCommand(pm: PackageManagerName): [string, string[]] {\n  switch (pm) {\n    case \"pnpm\":\n      return [\"pnpm\", [\"dlx\"]];\n    case \"yarn\":\n      return [\"yarn\", [\"dlx\"]];\n    case \"bun\":\n      return [\"bunx\", []];\n    case \"npm\":\n      return [\"npx\", [\"--yes\"]];\n  }\n}\n\nexport function resolvePackageManager(opts: {\n  useNpm?: boolean;\n  usePnpm?: boolean;\n  useYarn?: boolean;\n  useBun?: boolean;\n}): PackageManagerName | undefined {\n  if (opts.useNpm) return \"npm\";\n  if (opts.usePnpm) return \"pnpm\";\n  if (opts.useYarn) return \"yarn\";\n  if (opts.useBun) return \"bun\";\n  return undefined;\n}\n\nexport function askQuestion(query: string): Promise<string> {\n  return new Promise((resolve) => {\n    // A stream only reaches EOF once, so a run that already consumed stdin gets\n    // no further `end` and an interface built over it would wait on a `close`\n    // that cannot arrive. An upgrade asks up to three questions.\n    if (process.stdin.readableEnded) {\n      resolve(\"\");\n      return;\n    }\n    const rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n    });\n    // stdin at EOF (a piped or CI run) emits `close` without a `line`, so the\n    // question callback alone would leave this pending forever and the process\n    // would exit 0 with the remaining work silently skipped. An empty answer is\n    // what pressing Enter sends, so EOF lands on the prompt's own default.\n    // A final answer with no trailing newline arrives as `line` instead of\n    // through the callback, and has to win over that default.\n    // Ctrl-C in raw mode is delivered as this event rather than as a signal,\n    // and without a listener readline answers it by closing — which the EOF\n    // default would then read as approval. A cancelled prompt declines.\n    let cancelled = false;\n    rl.on(\"SIGINT\", () => {\n      cancelled = true;\n      rl.close();\n    });\n    rl.on(\"line\", resolve);\n    rl.on(\"close\", () => resolve(cancelled ? \"n\" : \"\"));\n    rl.question(query, (answer) => {\n      resolve(answer);\n      rl.close();\n    });\n  });\n}\n\nexport function isPackageInstalled(\n  pkg: string,\n  cwd: string = process.cwd(),\n): boolean {\n  try {\n    const pkgJsonPath = path.join(cwd, \"package.json\");\n    if (fs.existsSync(pkgJsonPath)) {\n      const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf8\"));\n      const deps = pkgJson.dependencies || {};\n      const devDeps = pkgJson.devDependencies || {};\n      if (deps[pkg] || devDeps[pkg]) {\n        return true;\n      }\n    }\n  } catch {\n    // Fall back to node_modules check below.\n  }\n  const modulePath = path.join(cwd, \"node_modules\", ...pkg.split(\"/\"));\n  return fs.existsSync(modulePath);\n}\n\nexport interface InstallCommand {\n  command: string;\n  args: string[];\n}\n\nexport async function getInstallCommand(\n  packageName: string | string[],\n  cwd?: string,\n): Promise<InstallCommand> {\n  const pm = await detect({ cwd });\n  const packages = Array.isArray(packageName) ? packageName : [packageName];\n  switch (pm) {\n    case \"yarn\":\n      return { command: \"yarn\", args: [\"add\", ...packages] };\n    case \"pnpm\":\n      return { command: \"pnpm\", args: [\"add\", ...packages] };\n    case \"bun\":\n      return { command: \"bun\", args: [\"add\", ...packages] };\n    default:\n      return { command: \"npm\", args: [\"install\", ...packages] };\n  }\n}\n\nfunction detectFromUserAgent(): PackageManagerName | undefined {\n  const ua = process.env.npm_config_user_agent;\n  if (!ua) return undefined;\n  if (ua.startsWith(\"bun/\")) return \"bun\";\n  if (ua.startsWith(\"pnpm/\")) return \"pnpm\";\n  if (ua.startsWith(\"yarn/\")) return \"yarn\";\n  if (ua.startsWith(\"npm/\")) return \"npm\";\n  return undefined;\n}\n\nexport async function resolvePackageManagerForCwd(\n  cwd: string,\n  packageManager?: PackageManagerName,\n): Promise<PackageManagerName> {\n  if (packageManager) return packageManager;\n  const fromAgent = detectFromUserAgent();\n  if (fromAgent) return fromAgent;\n  try {\n    return await detect({ cwd });\n  } catch {\n    return \"npm\";\n  }\n}\n\nexport async function installPackage(\n  packageName: string,\n  cwd?: string,\n): Promise<boolean> {\n  try {\n    const { command, args } = await getInstallCommand(packageName, cwd);\n    await runSpawn(command, args, cwd);\n    return true;\n  } catch (e) {\n    if (e instanceof SpawnSignalError) throw e;\n    logger.error(`Installation failed: ${String(e)}`);\n    return false;\n  }\n}\n"],"mappings":"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"}

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,YAAY,YAc3B"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,YAAY,YAe3B"}

package/dist/program.js

@@ -1,6 +1,7 @@
 import { add } from "./commands/add.js";
 import { agent } from "./commands/agent.js";
 import { create } from "./commands/create.js";
+import { cloud } from "./commands/cloud.js";
 import { doctor } from "./commands/doctor.js";
 import { info } from "./commands/info.js";
 import { init } from "./commands/init.js";
@@ -10,7 +11,7 @@ import { codemodCommand, upgradeCommand } from "./commands/upgrade.js";
 import { Command } from "commander";
 //#region src/program.ts
 function buildProgram() {
-	return new Command().name("assistant-ui").description("add components and dependencies to your project").addCommand(add).addCommand(create).addCommand(init).addCommand(mcp).addCommand(codemodCommand).addCommand(upgradeCommand).addCommand(update).addCommand(agent).addCommand(info).addCommand(doctor);
+	return new Command().name("assistant-ui").description("add components and dependencies to your project").addCommand(add).addCommand(create).addCommand(init).addCommand(mcp).addCommand(codemodCommand).addCommand(upgradeCommand).addCommand(update).addCommand(agent).addCommand(cloud).addCommand(info).addCommand(doctor);
 }
 //#endregion
 export { buildProgram };

package/dist/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","names":[],"sources":["../src/program.ts"],"sourcesContent":["import { 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\nexport function buildProgram() {\n  return new Command()\n    .name(\"assistant-ui\")\n    .description(\"add components and dependencies to your project\")\n    .addCommand(add)\n    .addCommand(create)\n    .addCommand(init)\n    .addCommand(mcp)\n    .addCommand(codemodCommand)\n    .addCommand(upgradeCommand)\n    .addCommand(update)\n    .addCommand(agent)\n    .addCommand(info)\n    .addCommand(doctor);\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,eAAe;CAC7B,OAAO,IAAI,QAAQ,CAAC,CACjB,KAAK,cAAc,CAAC,CACpB,YAAY,iDAAiD,CAAC,CAC9D,WAAW,GAAG,CAAC,CACf,WAAW,MAAM,CAAC,CAClB,WAAW,IAAI,CAAC,CAChB,WAAW,GAAG,CAAC,CACf,WAAW,cAAc,CAAC,CAC1B,WAAW,cAAc,CAAC,CAC1B,WAAW,MAAM,CAAC,CAClB,WAAW,KAAK,CAAC,CACjB,WAAW,IAAI,CAAC,CAChB,WAAW,MAAM;AACtB"}
+{"version":3,"file":"program.js","names":[],"sources":["../src/program.ts"],"sourcesContent":["import { 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\";\nimport { cloud } from \"./commands/cloud\";\n\nexport function buildProgram() {\n  return new Command()\n    .name(\"assistant-ui\")\n    .description(\"add components and dependencies to your project\")\n    .addCommand(add)\n    .addCommand(create)\n    .addCommand(init)\n    .addCommand(mcp)\n    .addCommand(codemodCommand)\n    .addCommand(upgradeCommand)\n    .addCommand(update)\n    .addCommand(agent)\n    .addCommand(cloud)\n    .addCommand(info)\n    .addCommand(doctor);\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,eAAe;CAC7B,OAAO,IAAI,QAAQ,CAAC,CACjB,KAAK,cAAc,CAAC,CACpB,YAAY,iDAAiD,CAAC,CAC9D,WAAW,GAAG,CAAC,CACf,WAAW,MAAM,CAAC,CAClB,WAAW,IAAI,CAAC,CAChB,WAAW,GAAG,CAAC,CACf,WAAW,cAAc,CAAC,CAC1B,WAAW,cAAc,CAAC,CAC1B,WAAW,MAAM,CAAC,CAClB,WAAW,KAAK,CAAC,CACjB,WAAW,KAAK,CAAC,CACjB,WAAW,IAAI,CAAC,CAChB,WAAW,MAAM;AACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-ui",
-  "version": "0.0.120",
+  "version": "0.0.122",
   "description": "CLI for assistant-ui",
   "keywords": [
     "cli",
@@ -21,12 +21,14 @@
     "bin",
     "dist",
     "src",
-    "README.md"
+    "README.md",
+    "templates/cloud-harness"
   ],
   "sideEffects": false,
   "dependencies": {
     "@assistant-ui/agent-launcher": "^0.1.17",
     "@clack/prompts": "^1.8.1",
+    "aui-auth": "^0.0.11",
     "chalk": "^6.0.1",
     "cli-progress": "^3.12.0",
     "commander": "^15.0.0",
@@ -37,7 +39,9 @@
     "glob": "^13.0.6",
     "jscodeshift": "^17.4.0",
     "jsonc-parser": "^3.3.1",
-    "semver": "^7.8.5"
+    "react": "^19.3.0",
+    "semver": "^7.8.5",
+    "statewire": "^0.19.4"
   },
   "devDependencies": {
     "@assistant-ui/x-buildutils": "0.0.30",
@@ -45,7 +49,7 @@
     "@types/cross-spawn": "^6.0.6",
     "@types/debug": "^4.1.13",
     "@types/jscodeshift": "^17.3.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.4",
     "@types/semver": "^7.8.0",
     "@vitest/coverage-v8": "^5.0.3",
     "vitest": "^5.0.3"
@@ -64,10 +68,10 @@
     "url": "https://github.com/assistant-ui/assistant-ui/issues"
   },
   "scripts": {
-    "build": "aui-build",
-    "test": "vitest run",
+    "build": "aui-build && node scripts/copy-cloud-harness-template.mjs",
+    "test": "vitest run && node --test scripts/copy-cloud-harness-template.test.mjs",
+    "test:coverage": "vitest run --coverage --coverage.reporter=text --coverage.reporter=html --coverage.reporter=json-summary && node --test scripts/copy-cloud-harness-template.test.mjs",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:watch": "vitest"
   }
 }

package/src/commands/add.ts

@@ -6,9 +6,10 @@ import {
   getComponentsJsonStyle,
   resolveRegistryItemUrl,
 } from "../lib/utils/registry";
-import { dlxCommand, resolvePackageManager } from "../lib/create-project";
 import { runSpawn, SpawnExitError, SpawnSignalError } from "../lib/run-spawn";
 import {
+  dlxCommand,
+  resolvePackageManager,
   type PackageManagerName,
   resolvePackageManagerForCwd,
 } from "../lib/utils/package-manager";

package/src/commands/cloud.test.ts

@@ -0,0 +1,238 @@
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { setupCloud, cloud } from "./cloud";
+
+const {
+  fetchOrganizations,
+  fetchProjects,
+  createProject,
+  cloudAccessToken,
+  provisionCloudHarness,
+  scaffold,
+  select,
+  password,
+} = vi.hoisted(() => ({
+  fetchOrganizations: vi.fn(),
+  fetchProjects: vi.fn(),
+  createProject: vi.fn(),
+  cloudAccessToken: vi.fn(),
+  provisionCloudHarness: vi.fn(),
+  scaffold: vi.fn(),
+  select: vi.fn(),
+  password: vi.fn(),
+}));
+
+vi.mock("aui-auth/accounts", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("aui-auth/accounts")>()),
+  fetchOrganizations,
+  fetchProjects,
+  createProject,
+}));
+vi.mock("../lib/cloud-auth", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("../lib/cloud-auth")>()),
+  cloudAccessToken,
+}));
+vi.mock("../lib/cloud-provision", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("../lib/cloud-provision")>()),
+  provisionCloudHarness,
+}));
+vi.mock("./create", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("./create")>()),
+  create: { parseAsync: scaffold },
+}));
+vi.mock("@clack/prompts", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("@clack/prompts")>()),
+  select,
+  password,
+}));
+
+const directories: string[] = [];
+afterEach(async () => {
+  await Promise.all(
+    directories
+      .splice(0)
+      .map((directory) => rm(directory, { recursive: true, force: true })),
+  );
+});
+
+const fixture = async () => {
+  const directory = await mkdtemp(
+    path.join(os.tmpdir(), "assistant-ui-cloud-command-"),
+  );
+  directories.push(directory);
+  cloudAccessToken.mockResolvedValue("oauth-access");
+  fetchOrganizations.mockResolvedValue([
+    { id: "org-1", slug: "team", name: "Team" },
+  ]);
+  fetchProjects.mockResolvedValue([
+    { id: "project-1", slug: "chat", name: "Team chat" },
+  ]);
+  provisionCloudHarness.mockResolvedValue({
+    project_id: "project-1",
+    workspace_id: "shared-workspace",
+    harness_id: "harness-1",
+    harness_origin: "https://harness.example.com",
+    api_origin: "https://project.example.com",
+    api_key: "cloud-server-key",
+  });
+  scaffold.mockResolvedValue(undefined);
+  return directory;
+};
+
+const options = {
+  backendUrl: "http://localhost:3000/api/chat",
+  apiUrl: "https://cloud.example.com",
+  yes: true,
+  skipInstall: true,
+  accessCode: "hackathon-code",
+};
+
+describe("cloud setup", () => {
+  it("selects an existing project and scaffolds a shared harness with server-only credentials", async () => {
+    const directory = await fixture();
+    await setupCloud(directory, { ...options, org: "team", project: "chat" });
+    expect(createProject).not.toHaveBeenCalled();
+    expect(scaffold).toHaveBeenCalledWith(
+      expect.arrayContaining([
+        "cloud-harness",
+        "--skip-install",
+        "--no-skills",
+      ]),
+      { from: "user" },
+    );
+    expect(provisionCloudHarness).toHaveBeenCalledWith(
+      options.apiUrl,
+      "oauth-access",
+      expect.objectContaining({
+        org_id: "org-1",
+        project_id: "project-1",
+        access_code: "hackathon-code",
+        backend_urls: [],
+        allow_localhost: true,
+      }),
+    );
+    const env = await readFile(path.join(directory, ".env.local"), "utf8");
+    expect(env).toContain('ASSISTANT_API_KEY="cloud-server-key"');
+    expect(env).not.toContain("NEXT_PUBLIC_ASSISTANT_API_KEY");
+    expect(
+      await readFile(
+        path.join(directory, ".assistant-ui", "cloud.json"),
+        "utf8",
+      ),
+    ).not.toContain("cloud-server-key");
+  });
+
+  it("does not provision again or overwrite customizations when setup is repeated", async () => {
+    const directory = await fixture();
+    await setupCloud(directory, options);
+    const envFile = path.join(directory, ".env.local");
+    const custom = `${(await readFile(envFile, "utf8")).replace(/^ASSISTANT_API_KEY=/m, "export ASSISTANT_API_KEY=")}OPENAI_API_KEY=custom-key\nCUSTOM_SETTING=keep-me\n`;
+    await writeFile(envFile, custom);
+    const before = provisionCloudHarness.mock.calls.length;
+    await setupCloud(directory, options);
+    expect(provisionCloudHarness.mock.calls.length).toBe(before);
+    expect(await readFile(envFile, "utf8")).toBe(custom);
+  });
+
+  it("requires an explicit project when noninteractive users have several choices", async () => {
+    const directory = await fixture();
+    fetchProjects.mockResolvedValue([
+      { id: "one", slug: "one", name: "One" },
+      { id: "two", slug: "two", name: "Two" },
+    ]);
+    await expect(setupCloud(directory, options)).rejects.toThrow("--project");
+  });
+
+  it("reuses an organization created by an interrupted setup", async () => {
+    const directory = await fixture();
+    const before = fetchProjects.mock.calls.length;
+    await setupCloud(directory, {
+      ...options,
+      newOrg: "team",
+      project: "chat",
+    });
+    expect(fetchProjects.mock.calls.slice(before)).toEqual([
+      [expect.anything(), "oauth-access", { id: "org-1" }],
+    ]);
+    expect(fetchProjects).toHaveBeenCalledWith(
+      expect.anything(),
+      "oauth-access",
+      {
+        id: "org-1",
+      },
+    );
+    expect(provisionCloudHarness).toHaveBeenCalledWith(
+      options.apiUrl,
+      "oauth-access",
+      expect.objectContaining({ org_id: "org-1" }),
+    );
+  });
+
+  it("rejects a changed backend before silently reusing configured resources", async () => {
+    const directory = await fixture();
+    await setupCloud(directory, options);
+    const before = provisionCloudHarness.mock.calls.length;
+    await expect(
+      setupCloud(directory, {
+        ...options,
+        backendUrl: "https://app.example.com/api/chat",
+      }),
+    ).rejects.toThrow("backend allowlist in the Cloud dashboard");
+    expect(provisionCloudHarness.mock.calls.length).toBe(before);
+  });
+
+  it("rejects conflicting selection flags before logging in", async () => {
+    const directory = await fixture();
+    const before = cloudAccessToken.mock.calls.length;
+    await expect(
+      setupCloud(directory, { ...options, org: "team", newOrg: "other" }),
+    ).rejects.toThrow("Choose --org or --new-org");
+    expect(cloudAccessToken.mock.calls.length).toBe(before);
+  });
+
+  it("rejects URL credentials and invalid organization slugs before logging in", async () => {
+    const directory = await fixture();
+    const before = cloudAccessToken.mock.calls.length;
+    await expect(
+      setupCloud(directory, {
+        ...options,
+        backendUrl: "https://user:secret@app.example.com/api/chat",
+      }),
+    ).rejects.toThrow("credentials");
+    await expect(
+      setupCloud(directory, { ...options, newOrg: "Bad Org!" }),
+    ).rejects.toThrow("Organization slugs");
+    expect(cloudAccessToken.mock.calls.length).toBe(before);
+  });
+
+  it("stops before provisioning when organization selection is cancelled", async () => {
+    const directory = await fixture();
+    fetchOrganizations.mockResolvedValue([
+      { id: "one", slug: "one", name: "One" },
+      { id: "two", slug: "two", name: "Two" },
+    ]);
+    const prompts =
+      await vi.importActual<typeof import("@clack/prompts")>("@clack/prompts");
+    const cancelled = await prompts.select({
+      message: "Cancel test",
+      options: [{ value: "one", label: "One" }],
+      signal: AbortSignal.abort(),
+    });
+    select.mockResolvedValue(cancelled);
+    const before = provisionCloudHarness.mock.calls.length;
+    await expect(
+      setupCloud(directory, { ...options, yes: false }),
+    ).rejects.toThrow();
+    expect(provisionCloudHarness.mock.calls.length).toBe(before);
+  });
+
+  it("exposes login, logout, and setup as cloud commands", () => {
+    expect(cloud.commands.map((command) => command.name())).toEqual([
+      "login",
+      "logout",
+      "setup",
+    ]);
+  });
+});