assistant-ui 0.0.117 → 0.0.118

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

@@ -1,5 +1,5 @@
-import { SpawnSignalError, runSpawn } from "../run-spawn.js";
 import { logger } from "./logger.js";
+import { SpawnSignalError, runSpawn } from "../run-spawn.js";
 import * as fs$1 from "node:fs";
 import * as path$1 from "node:path";
 import { detect } from "detect-package-manager";
@@ -7,13 +7,24 @@ import * as readline from "node:readline";
 //#region src/lib/utils/package-manager.ts
 function askQuestion(query) {
 	return new Promise((resolve) => {
+		if (process.stdin.readableEnded) {
+			resolve("");
+			return;
+		}
 		const rl = readline.createInterface({
 			input: process.stdin,
 			output: process.stdout
 		});
-		rl.question(query, (answer) => {
+		let cancelled = false;
+		rl.on("SIGINT", () => {
+			cancelled = true;
 			rl.close();
+		});
+		rl.on("line", resolve);
+		rl.on("close", () => resolve(cancelled ? "n" : ""));
+		rl.question(query, (answer) => {
 			resolve(answer);
+			rl.close();
 		});
 	});
 }

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    const rl = readline.createInterface({\n      input: process.stdin,\n      output: process.stdout,\n    });\n    rl.question(query, (answer) => {\n      rl.close();\n      resolve(answer);\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;EAC9B,MAAM,KAAK,SAAS,gBAAgB;GAClC,OAAO,QAAQ;GACf,QAAQ,QAAQ;EAClB,CAAC;EACD,GAAG,SAAS,QAAQ,WAAW;GAC7B,GAAG,MAAM;GACT,QAAQ,MAAM;EAChB,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 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"}

package/dist/lib/utils/registry.d.ts

@@ -1,8 +1,6 @@
-//#region src/lib/utils/registry.d.ts
 export declare const SHARED_REGISTRY_ITEMS: Set<string>;
 export declare function detectRegistryPlatform(cwd: string): "web" | "native";
 export declare function getComponentsJsonStyle(cwd: string): string | undefined;
 export declare function resolveQuickStartRegistryUrl(style?: string): string;
 export declare function resolveRegistryItemUrl(component: string, style?: string, platform?: "web" | "native"): string;
-//#endregion
 //# sourceMappingURL=registry.d.ts.map

package/dist/lib/utils/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../src/lib/utils/registry.ts"],"mappings":";qBAIa,uBAAqB;wBAElB,uBAAuB;wBA2BvB,uBAAuB;wBAavB,6BAA6B;wBAW7B,uBACd,mBACA,gBACA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/registry.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,aAAqB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAyBpE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,GAAE,KAAK,GAAG,QAAgB,GACjC,MAAM,CAgBR"}

package/dist/lib/utils/workspace.d.ts

@@ -1,5 +1,3 @@
-//#region src/lib/utils/workspace.d.ts
 export declare function resolveRealPath(inputPath: string): string;
 export declare function findWorkspaceRoot(cwd: string): string | null;
-//#endregion
 //# sourceMappingURL=workspace.d.ts.map

package/dist/lib/utils/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","names":[],"sources":["../../../src/lib/utils/workspace.ts"],"mappings":";wBAGgB,gBAAgB;wBAUhB,kBAAkB"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/workspace.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5D"}

package/dist/program.d.ts

@@ -1,5 +1,3 @@
 import { Command } from "commander";
-//#region src/program.d.ts
 export declare function buildProgram(): Command;
-//#endregion
 //# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","names":[],"sources":["../src/program.ts"],"mappings":";;wBAWgB,gBAAY"}
+{"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"}

package/dist/program.js

@@ -1,12 +1,12 @@
-import { create } from "./commands/create.js";
 import { add } from "./commands/add.js";
-import { codemodCommand, upgradeCommand } from "./commands/upgrade.js";
-import { init } from "./commands/init.js";
-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 { create } from "./commands/create.js";
 import { doctor } from "./commands/doctor.js";
+import { info } from "./commands/info.js";
+import { init } from "./commands/init.js";
+import { mcp } from "./commands/mcp.js";
+import { update } from "./commands/update.js";
+import { codemodCommand, upgradeCommand } from "./commands/upgrade.js";
 import { Command } from "commander";
 //#region src/program.ts
 function buildProgram() {

package/dist/run.d.ts

@@ -1,4 +1,2 @@
-//#region src/run.d.ts
 export declare function runCli(): Promise<void>;
-//#endregion
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","names":[],"sources":["../src/run.ts"],"mappings":";wBAEsB,UAAU"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-ui",
-  "version": "0.0.117",
+  "version": "0.0.118",
   "description": "CLI for assistant-ui",
   "keywords": [
     "cli",
@@ -20,7 +20,6 @@
   "files": [
     "bin",
     "dist",
-    "plugin",
     "src",
     "README.md"
   ],
@@ -41,7 +40,7 @@
     "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@assistant-ui/x-buildutils": "0.0.28",
+    "@assistant-ui/x-buildutils": "0.0.29",
     "@types/cli-progress": "^3.11.6",
     "@types/cross-spawn": "^6.0.6",
     "@types/debug": "^4.1.13",

package/src/codemods/utils/resolveBinding.test.ts

@@ -0,0 +1,107 @@
+import { describe, expect, it } from "vitest";
+import jscodeshift from "jscodeshift";
+import { resolveBinding } from "./resolveBinding";
+
+const j = jscodeshift.withParser("tsx");
+
+describe("resolveBinding", () => {
+  it.each([
+    ["const", "of"],
+    ["let", "of"],
+    ["const", "in"],
+    ["let", "in"],
+  ])(
+    "resolves the uninitialized %s binding in a for-%s right-hand side",
+    (kind, operator) => {
+      const root = j(
+        `const client = outer(); for (${kind} client ${operator} read(client)) {}`,
+      );
+      const reference = root
+        .find(j.CallExpression, { callee: { name: "read" } })
+        .paths()[0]!
+        .get("arguments", 0);
+      const loopBinding = root.find(j.VariableDeclarator).nodes()[1]!.id;
+      expect(resolveBinding(j, reference, "client")).toBe(loopBinding);
+    },
+  );
+
+  it.each([
+    ["namespace Local { const client = inner(); read(client); }", "inner"],
+    [
+      "namespace Local { if (ready) { var client = inner(); } read(client); }",
+      "inner",
+    ],
+    ["namespace Local { var client = inner(); } read(client);", "outer"],
+    [
+      "function worker() { if (ready) { var client = inner(); } read(client); }",
+      "inner",
+    ],
+    [
+      "function worker(value = read(client)) { var client = inner(); }",
+      "outer",
+    ],
+    ["{ const client = inner(); read(client); }", "inner"],
+    ["{ const { client } = inner(); read(client); }", "inner"],
+    ["{ const [client] = inner(); read(client); }", "inner"],
+    [
+      "function worker() { { const client = inner(); } read(client); }",
+      "outer",
+    ],
+    ["switch (read(client)) { case 1: const client = inner(); }", "outer"],
+    [
+      "switch (value) { case 1: const client = inner(); read(client); }",
+      "inner",
+    ],
+    ["for (const client = inner(); ready;) { read(client); }", "inner"],
+    [
+      "function worker() { function other() { var client = inner(); } read(client); }",
+      "outer",
+    ],
+    ["{ type client = Other; read(client); }", "outer"],
+  ])("resolves %s", (scope, expected) => {
+    const root = j(`const client = outer(); ${scope}`);
+    const reference = root
+      .find(j.CallExpression, { callee: { name: "read" } })
+      .paths()[0]!
+      .get("arguments", 0);
+    const binding = resolveBinding(j, reference, "client");
+    const declaration = root
+      .find(j.VariableDeclarator, { init: { callee: { name: expected } } })
+      .nodes()[0]!;
+    const identifiers = j(declaration.id)
+      .find(j.Identifier, { name: "client" })
+      .nodes();
+    expect(binding).toBe(
+      j.Identifier.check(declaration.id) ? declaration.id : identifiers.at(-1),
+    );
+  });
+
+  it.each([
+    "function worker(client) { read(client); }",
+    "function worker({ client }) { read(client); }",
+    "function worker(client = fallback) { read(client); }",
+    "try {} catch (client) { read(client); }",
+    "class Reader { constructor(private client: Client) { read(client); } }",
+  ])("resolves a parameter binding: %s", (source) => {
+    const root = j(source);
+    const reference = root
+      .find(j.CallExpression, { callee: { name: "read" } })
+      .paths()[0]!
+      .get("arguments", 0);
+    const binding = resolveBinding(j, reference, "client");
+    expect(binding?.name).toBe("client");
+    expect(binding).not.toBe(reference.value);
+  });
+
+  it("resolves imports and distinguishes an unbound identifier", () => {
+    const root = j('import { client } from "./client"; read(client);');
+    const reference = root
+      .find(j.CallExpression)
+      .paths()[0]!
+      .get("arguments", 0);
+    expect(resolveBinding(j, reference, "client")).toBe(
+      root.find(j.ImportSpecifier).nodes()[0]!.local,
+    );
+    expect(resolveBinding(j, reference, "missing")).toBeUndefined();
+  });
+});

package/src/codemods/utils/resolveBinding.ts

@@ -0,0 +1,130 @@
+import type { JSCodeshift } from "jscodeshift";
+
+const patternBinding = (node: any, name: string): any => {
+  switch (node?.type) {
+    case "Identifier":
+      return node.name === name ? node : undefined;
+    case "TSParameterProperty":
+      return patternBinding(node.parameter, name);
+    case "AssignmentPattern":
+      return patternBinding(node.left, name);
+    case "RestElement":
+      return patternBinding(node.argument, name);
+    case "ObjectPattern":
+      return node.properties
+        .map((p: any) => patternBinding(p.value ?? p.argument, name))
+        .find(Boolean);
+    case "ArrayPattern":
+      return node.elements
+        .map((p: any) => patternBinding(p, name))
+        .find(Boolean);
+  }
+};
+
+const declarationBinding = (node: any, name: string): any => {
+  switch (node?.type) {
+    case "ExportNamedDeclaration":
+    case "ExportDefaultDeclaration":
+      return declarationBinding(node.declaration, name);
+    case "VariableDeclaration":
+      return node.declarations
+        .map((d: any) => patternBinding(d.id, name))
+        .find(Boolean);
+    case "ImportDeclaration":
+      if (node.importKind === "type") return;
+      return node.specifiers
+        ?.filter((s: any) => s.importKind !== "type")
+        .map((s: any) => patternBinding(s.local, name))
+        .find(Boolean);
+    case "TSTypeAliasDeclaration":
+    case "TSInterfaceDeclaration":
+    case "TSDeclareFunction":
+      return;
+    default:
+      return patternBinding(node?.id, name);
+  }
+};
+
+const hoistedBinding = (j: JSCodeshift, body: any, name: string): any => {
+  let binding: any;
+  j.types.visit(body, {
+    visitFunction() {
+      return false;
+    },
+    visitClassDeclaration() {
+      return false;
+    },
+    visitClassExpression() {
+      return false;
+    },
+    visitTSModuleBlock(path) {
+      if (path.node !== body) return false;
+      this.traverse(path);
+      return undefined;
+    },
+    visitVariableDeclaration(path) {
+      if (path.node.kind === "var")
+        binding ??= declarationBinding(path.node, name);
+      this.traverse(path);
+    },
+  });
+  return binding;
+};
+
+// ast-types scopes do not distinguish block-scoped declarations.
+export const resolveBinding = (
+  j: JSCodeshift,
+  path: any,
+  name: string,
+): any => {
+  let child = path;
+  for (
+    let current = path.parent;
+    current;
+    child = current, current = current.parent
+  ) {
+    const node = current.value;
+    let binding: any;
+    if (Array.isArray(node.params)) {
+      binding =
+        node.params.map((p: any) => patternBinding(p, name)).find(Boolean) ??
+        patternBinding(node.id, name) ??
+        (child.value === node.body
+          ? hoistedBinding(j, node.body, name)
+          : undefined);
+    } else if (node.type === "CatchClause") {
+      binding = patternBinding(node.param, name);
+    } else if (node.type === "ClassExpression") {
+      binding = patternBinding(node.id, name);
+    } else if (node.type === "ForStatement") {
+      binding = declarationBinding(node.init, name);
+    } else if (
+      node.type === "ForInStatement" ||
+      node.type === "ForOfStatement"
+    ) {
+      binding = declarationBinding(node.left, name);
+    } else {
+      const statements =
+        node.type === "SwitchStatement" && child.value !== node.discriminant
+          ? node.cases.flatMap((c: any) => c.consequent)
+          : [
+                "BlockStatement",
+                "Program",
+                "StaticBlock",
+                "TSModuleBlock",
+              ].includes(node.type)
+            ? node.body
+            : [];
+      binding = statements
+        .map((s: any) => declarationBinding(s, name))
+        .find(Boolean);
+      if (
+        !binding &&
+        ["Program", "StaticBlock", "TSModuleBlock"].includes(node.type)
+      ) {
+        binding = hoistedBinding(j, node, name);
+      }
+    }
+    if (binding) return binding;
+  }
+};

package/src/codemods/v0-12/__tests__/assistant-api-to-aui.test.ts

@@ -21,6 +21,262 @@ function applyTransform(source: string): string | null {
 }
 
 describe("assistant-api-to-aui", () => {
+  it.each([
+    "const aui = props.aui; const api = useAui(); api.thread();",
+    "const api = useAui(); const aui = props.aui; api.thread();",
+    "const api = useAui(); function read(aui) { return api.thread(); }",
+    "const api = useAui(); { const aui = props.aui; api.thread(); }",
+    "function read(aui) { const api = useAui(); return api.thread(); }",
+  ])("preserves api when renaming would collide or capture: %s", (source) => {
+    const input = `import { useAui } from "@assistant-ui/react";\n${source}`;
+    expect(applyTransform(input)).toBeNull();
+  });
+
+  it("still migrates the hook when the api local name must be preserved", () => {
+    const output =
+      applyTransform(`import { useAssistantApi } from "@assistant-ui/react";
+const aui = props.aui;
+const api = useAssistantApi();
+api.thread();`);
+    expect(output).toContain('import { useAui } from "@assistant-ui/react";');
+    expect(output).toContain("const api = useAui();");
+    expect(output).toContain("api.thread();");
+    expect(applyTransform(output!)).toBeNull();
+  });
+
+  it("does not let one colliding api binding prevent independent renames", () => {
+    const blocked =
+      "function blocked(aui) { const api = useAui(); return api.thread(); }";
+    const output = applyTransform(`import { useAui } from "@assistant-ui/react";
+${blocked}
+function safe() { const api = useAui(); return api.thread(); }`);
+    expect(output).toContain(blocked);
+    expect(output).toContain(
+      "function safe() { const aui = useAui(); return aui.thread(); }",
+    );
+    expect(applyTransform(output!)).toBeNull();
+  });
+
+  it.each([
+    ["AssistantProvider", "AuiProvider"],
+    ["useAssistantState", "useAuiState"],
+  ])("preserves qualified type members named %s", (oldName, newName) => {
+    const output =
+      applyTransform(`import { ${oldName} } from "@assistant-ui/react";
+import type { Components } from "./types";
+type Foreign = Components.${oldName};
+type Nested = Components.Nested.${oldName};
+type ForeignValue = typeof Components.${oldName};
+type LocalValue = typeof ${oldName};
+type LocalMember = typeof ${oldName}.displayName;
+const value = ${oldName};`);
+    expect(output).toContain(`type Foreign = Components.${oldName};`);
+    expect(output).toContain(`type Nested = Components.Nested.${oldName};`);
+    expect(output).toContain(
+      `type ForeignValue = typeof Components.${oldName};`,
+    );
+    expect(output).toContain(`type LocalValue = typeof ${newName};`);
+    expect(output).toContain(
+      `type LocalMember = typeof ${newName}.displayName;`,
+    );
+    expect(output).toContain(`const value = ${newName};`);
+    expect(applyTransform(output!)).toBeNull();
+  });
+
+  it.each([
+    ["const", "of"],
+    ["let", "of"],
+    ["const", "in"],
+    ["let", "in"],
+  ])(
+    "preserves %s for-%s bindings in their right-hand side",
+    (kind, operator) => {
+      const loop = `for (${kind} api ${operator} api.thread()) { api.thread(); }`;
+      const output =
+        applyTransform(`import { useAssistantApi } from "@assistant-ui/react";
+const api = useAssistantApi();
+${loop}
+api.thread();`);
+      expect(output).toContain(loop);
+      expect(output).toContain("const aui = useAui();");
+      expect(output).toContain("\naui.thread();");
+    },
+  );
+
+  it.each(["useAssistantApi", "useAui"])(
+    "preserves api initialized from a foreign %s import",
+    (hook) => {
+      const input = `import { ${hook} } from "./local-hooks";
+const api = ${hook}();
+api.thread();`;
+      expect(applyTransform(input)).toBeNull();
+    },
+  );
+
+  it.each(["useAssistantApi", "useAui"])(
+    "preserves api initialized from a shadowed %s import",
+    (hook) => {
+      const shadowed = `function local(${hook}) { const api = ${hook}(); return api.thread(); }
+{ const ${hook} = other; const api = ${hook}(); api.thread(); }
+function hoisted() { const api = ${hook}(); if (ready) { var ${hook} = other; } return api.thread(); }`;
+      const output =
+        applyTransform(`import { ${hook} } from "@assistant-ui/react";
+${shadowed}
+const api = ${hook}();
+api.thread();`);
+      expect(output).toContain(shadowed);
+      expect(output).toContain("const aui = useAui();");
+      expect(output).toContain("\naui.thread();");
+      expect(applyTransform(output!)).toBeNull();
+    },
+  );
+
+  it.each(["useAssistantApi", "useAui"])(
+    "renames api initialized from an aliased %s import",
+    (hook) => {
+      const output =
+        applyTransform(`import { ${hook} as useClient } from "@assistant-ui/react";
+const api = useClient();
+api.thread();`);
+      expect(output).toContain("useAui as useClient");
+      expect(output).toContain("const aui = useClient();");
+      expect(output).toContain("aui.thread();");
+      expect(applyTransform(output!)).toBeNull();
+    },
+  );
+
+  it.each([
+    'import type { useAssistantApi } from "@assistant-ui/react";',
+    'import { type useAssistantApi } from "@assistant-ui/react";',
+  ])(
+    "does not infer an api value from type-only imports: %s",
+    (declaration) => {
+      const output = applyTransform(`${declaration}
+const api = useAssistantApi();
+api.thread();`);
+      expect(output).toContain("const api = useAssistantApi();");
+      expect(output).toContain("api.thread();");
+    },
+  );
+
+  it.each(["useAssistantApi", "useAui"])(
+    "leaves unresolved %s calls alone",
+    (hook) => {
+      expect(applyTransform(`const api = ${hook}(); api.thread();`)).toBeNull();
+    },
+  );
+
+  it("preserves hooks and components imported from another package", () => {
+    const input = `import { useAssistantState, AssistantIf } from "./local-hooks";
+import { useAui } from "@assistant-ui/react";
+const read = () => useAssistantState();
+const view = <AssistantIf />;`;
+    expect(applyTransform(input)).toBeNull();
+  });
+
+  it.each([
+    "function local(useAssistantState) { return useAssistantState(); }",
+    "{ const useAssistantState = other; useAssistantState(); }",
+    "{ const { useAssistantState } = other; useAssistantState(); }",
+    "function local() { if (ready) { var useAssistantState = other; } return useAssistantState(); }",
+  ])("preserves a shadowed hook: %s", (unrelated) => {
+    const output = applyTransform(
+      `import { useAssistantState } from "@assistant-ui/react";\n${unrelated}\nuseAssistantState();`,
+    );
+    expect(output).toContain(unrelated);
+    expect(output).toContain("\nuseAuiState();");
+  });
+
+  it("preserves hook import aliases", () => {
+    const output =
+      applyTransform(`import { useAssistantState as useLocalState } from "@assistant-ui/react";
+useLocalState();`);
+    expect(output).toContain("useAuiState as useLocalState");
+    expect(output).toContain("useLocalState();");
+    expect(applyTransform(output!)).toBeNull();
+  });
+
+  it("avoids duplicating an existing import of the new local name", () => {
+    const output =
+      applyTransform(`import { useAssistantState } from "@assistant-ui/react";
+import { useAuiState } from "./other";
+useAssistantState();
+useAuiState();`);
+    expect(output).toContain("useAuiState as useAssistantState");
+    expect(output).toContain('import { useAuiState } from "./other";');
+    expect(output).toContain("\nuseAssistantState();");
+  });
+
+  it("preserves public property and export names", () => {
+    const output =
+      applyTransform(`import { useAssistantState } from "@assistant-ui/react";
+const value = { useAssistantState };
+obj.useAssistantState();
+const config = { useAssistantState: "unchanged" };
+export { useAssistantState };
+export { useAssistantState as remote } from "./other";`);
+    expect(output).toMatch(/useAssistantState: useAuiState/);
+    expect(output).toContain("obj.useAssistantState();");
+    expect(output).toContain('useAssistantState: "unchanged"');
+    expect(output).toContain("useAuiState as useAssistantState");
+    expect(output).toContain(
+      'export { useAssistantState as remote } from "./other";',
+    );
+  });
+
+  it("does not capture references with an existing new-name binding", () => {
+    const output =
+      applyTransform(`import { useAssistantState } from "@assistant-ui/react";
+function local(useAuiState) { return useAssistantState(); }`);
+    expect(output).toContain("useAuiState as useAssistantState");
+    expect(output).toContain(
+      "function local(useAuiState) { return useAssistantState(); }",
+    );
+  });
+
+  it("preserves a shadowed JSX component and JSX property names", () => {
+    const output =
+      applyTransform(`import { AssistantIf } from "@assistant-ui/react";
+const view = <AssistantIf AssistantIf="attribute" />;
+function local(AssistantIf) { return <AssistantIf />; }
+const other = <components.AssistantIf />;`);
+    expect(output).toContain('<AuiIf AssistantIf="attribute" />');
+    expect(output).toContain(
+      "function local(AssistantIf) { return <AssistantIf />; }",
+    );
+    expect(output).toContain("<components.AssistantIf />");
+  });
+
+  it("preserves local names for type-only imports", () => {
+    const output =
+      applyTransform(`import type { AssistantProvider } from "@assistant-ui/react";
+type Provider = typeof AssistantProvider;`);
+    expect(output).toContain("AuiProvider as AssistantProvider");
+    expect(output).toContain("typeof AssistantProvider");
+  });
+  it("does not rename references to a hoisted body variable", () => {
+    const input = `import { useAssistantApi } from "@assistant-ui/react";
+const api = useAssistantApi();
+function worker() { if (ready) { var api = other(); } return api.value; }
+api.thread();`;
+    const output = applyTransform(input);
+    expect(output).toContain(
+      "if (ready) { var api = other(); } return api.value;",
+    );
+    expect(output).toContain("aui.thread();");
+  });
+
+  it("resolves switch discriminants and parameter defaults outside body bindings", () => {
+    const output =
+      applyTransform(`import { useAssistantApi } from "@assistant-ui/react";
+const api = useAssistantApi();
+function worker(value = api.thread()) { var api = other(); return api.value; }
+switch (api.kind) { case 1: const api = other(); api.thread(); }`);
+    expect(output).toContain("value = aui.thread()");
+    expect(output).toContain("switch (aui.kind)");
+    expect(output).toContain("var api = other(); return api.value;");
+    expect(output).toContain("const api = other(); api.thread();");
+  });
   it("should rename useAssistantApi to useAui", () => {
     const input = `
 import { useAssistantApi } from "@assistant-ui/react";