@alexkroman1/aai-cli 0.9.3 → 0.10.0

package/dist/cli.mjs

@@ -1,10 +1,29 @@
 #!/usr/bin/env node
-import { c as resolveCwd, r as getApiKey, t as fileExists } from "./_discover-DsorPpR_.mjs";
+import { l as resolveCwd, n as fileExists, t as ensureApiKeyInEnv } from "./_discover-D7HCLa_N.mjs";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { defineCommand, runMain } from "citty";
 //#region cli.ts
+/** Shared arg definitions for citty commands. */
+const sharedArgs = {
+	port: {
+		type: "string",
+		alias: "p",
+		description: "Port to listen on",
+		default: "3000"
+	},
+	server: {
+		type: "string",
+		alias: "s",
+		description: "Server URL"
+	},
+	yes: {
+		type: "boolean",
+		alias: "y",
+		description: "Accept defaults (no prompts)"
+	}
+};
 const cliDir = path.dirname(fileURLToPath(import.meta.url));
 function findPkgJson(dir) {
 	try {
@@ -16,7 +35,7 @@ function findPkgJson(dir) {
 const VERSION = JSON.parse(findPkgJson(cliDir)).version;
 async function ensureAgent(cwd, yes) {
 	if (!await fileExists(path.join(cwd, "agent.ts"))) {
-		const { runInitCommand } = await import("./init-nHgDq3Om.mjs");
+		const { runInitCommand } = await import("./init-COkINbH_.mjs");
 		await runInitCommand({ yes }, { quiet: true });
 	}
 }
@@ -41,11 +60,7 @@ const init = defineCommand({
 			alias: "f",
 			description: "Overwrite existing agent.ts"
 		},
-		yes: {
-			type: "boolean",
-			alias: "y",
-			description: "Accept defaults (no prompts)"
-		},
+		yes: sharedArgs.yes,
 		skipApi: {
 			type: "boolean",
 			description: "Skip API key check"
@@ -56,7 +71,7 @@ const init = defineCommand({
 		}
 	},
 	async run({ args }) {
-		const { runInitCommand } = await import("./init-nHgDq3Om.mjs");
+		const { runInitCommand } = await import("./init-COkINbH_.mjs");
 		await runInitCommand({
 			dir: args.dir,
 			template: args.template,
@@ -92,8 +107,8 @@ const dev = defineCommand({
 	async run({ args }) {
 		const cwd = resolveCwd();
 		await ensureAgent(cwd, args.yes);
-		await getApiKey();
-		const { runDevCommand } = await import("./dev-BIgNj8Dt.mjs");
+		await ensureApiKeyInEnv();
+		const { runDevCommand } = await import("./dev-DCtHG1pz.mjs");
 		await runDevCommand({
 			cwd,
 			port: args.port,
@@ -101,20 +116,41 @@ const dev = defineCommand({
 		});
 	}
 });
+const test = defineCommand({
+	meta: {
+		name: "test",
+		description: "Run agent tests"
+	},
+	async run() {
+		const cwd = resolveCwd();
+		const { runTestCommand } = await import("./test-9fFn9DCf.mjs");
+		await runTestCommand(cwd);
+	}
+});
 const build = defineCommand({
 	meta: {
 		name: "build",
 		description: "Bundle and validate (no server or deploy)"
 	},
-	args: { yes: {
-		type: "boolean",
-		alias: "y",
-		description: "Accept defaults (no prompts)"
-	} },
+	args: {
+		yes: {
+			type: "boolean",
+			alias: "y",
+			description: "Accept defaults (no prompts)"
+		},
+		skipTests: {
+			type: "boolean",
+			description: "Skip running tests before build"
+		}
+	},
 	async run({ args }) {
 		const cwd = resolveCwd();
 		await ensureAgent(cwd, args.yes);
-		const { runBuildCommand } = await import("./_build-Cf_bB5Vl.mjs");
+		if (!args.skipTests) {
+			const { runVitest } = await import("./test-9fFn9DCf.mjs");
+			runVitest(cwd);
+		}
+		const { runBuildCommand } = await import("./_build-aW_zyPpr.mjs");
 		await runBuildCommand(cwd);
 	}
 });
@@ -142,7 +178,7 @@ const deploy = defineCommand({
 	async run({ args }) {
 		const cwd = resolveCwd();
 		await ensureAgent(cwd, args.yes);
-		const { runDeployCommand } = await import("./deploy-2OxZpIfj.mjs");
+		const { runDeployCommand } = await import("./deploy-DB0PeNtc.mjs");
 		await runDeployCommand({
 			cwd,
 			...args.server ? { server: args.server } : {},
@@ -150,6 +186,25 @@ const deploy = defineCommand({
 		});
 	}
 });
+const del = defineCommand({
+	meta: {
+		name: "delete",
+		description: "Remove a deployed agent"
+	},
+	args: { server: {
+		type: "string",
+		alias: "s",
+		description: "Server URL"
+	} },
+	async run({ args }) {
+		const cwd = resolveCwd();
+		const { runDeleteCommand } = await import("./delete-DxECFYOp.mjs");
+		await runDeleteCommand({
+			cwd,
+			...args.server ? { server: args.server } : {}
+		});
+	}
+});
 const start = defineCommand({
 	meta: {
 		name: "start",
@@ -170,8 +225,8 @@ const start = defineCommand({
 	},
 	async run({ args }) {
 		const cwd = resolveCwd();
-		await getApiKey();
-		const { runStartCommand } = await import("./start-Df8c2ciS.mjs");
+		await ensureApiKeyInEnv();
+		const { runStartCommand } = await import("./start-DQypQkOq.mjs");
 		await runStartCommand({
 			cwd,
 			port: args.port
@@ -196,8 +251,8 @@ const secret = defineCommand({
 			} },
 			async run({ args }) {
 				const cwd = resolveCwd();
-				await getApiKey();
-				const { runSecretPut } = await import("./secret-BQl3zBOS.mjs");
+				await ensureApiKeyInEnv();
+				const { runSecretPut } = await import("./secret-Zzv7fJ_3.mjs");
 				await runSecretPut(cwd, args.name);
 			}
 		}),
@@ -213,8 +268,8 @@ const secret = defineCommand({
 			} },
 			async run({ args }) {
 				const cwd = resolveCwd();
-				await getApiKey();
-				const { runSecretDelete } = await import("./secret-BQl3zBOS.mjs");
+				await ensureApiKeyInEnv();
+				const { runSecretDelete } = await import("./secret-Zzv7fJ_3.mjs");
 				await runSecretDelete(cwd, args.name);
 			}
 		}),
@@ -225,8 +280,8 @@ const secret = defineCommand({
 			},
 			async run() {
 				const cwd = resolveCwd();
-				await getApiKey();
-				const { runSecretList } = await import("./secret-BQl3zBOS.mjs");
+				await ensureApiKeyInEnv();
+				const { runSecretList } = await import("./secret-Zzv7fJ_3.mjs");
 				await runSecretList(cwd);
 			}
 		})
@@ -261,8 +316,8 @@ const rag = defineCommand({
 	},
 	async run({ args }) {
 		const cwd = resolveCwd();
-		await getApiKey();
-		const { runRagCommand } = await import("./rag-D0xqGIrS.mjs");
+		await ensureApiKeyInEnv();
+		const { runRagCommand } = await import("./rag-BNfrEr4A.mjs");
 		await runRagCommand({
 			url: args.url,
 			cwd,
@@ -271,13 +326,86 @@ const rag = defineCommand({
 		});
 	}
 });
+const doctor = defineCommand({
+	meta: {
+		name: "doctor",
+		description: "Check environment health and diagnose issues"
+	},
+	args: { port: {
+		type: "string",
+		alias: "p",
+		description: "Port to check availability",
+		default: "3000"
+	} },
+	async run({ args }) {
+		const cwd = resolveCwd();
+		const { runDoctorCommand } = await import("./doctor-bWuArZi6.mjs");
+		await runDoctorCommand({
+			cwd,
+			port: args.port
+		});
+	}
+});
+const generate = defineCommand({
+	meta: {
+		name: "generate",
+		description: "Generate or modify agent code using AI"
+	},
+	args: { prompt: {
+		type: "positional",
+		description: "What to generate",
+		required: true
+	} },
+	async run({ args }) {
+		const cwd = resolveCwd();
+		await ensureApiKeyInEnv();
+		const { runGenerateCommand } = await import("./generate-D7zJtqoC.mjs");
+		await runGenerateCommand({
+			cwd,
+			prompt: args.prompt
+		});
+	}
+});
+const run = defineCommand({
+	meta: {
+		name: "run",
+		description: "Init, generate, and deploy in one step"
+	},
+	args: {
+		prompt: {
+			type: "positional",
+			description: "What to build",
+			required: true
+		},
+		server: {
+			type: "string",
+			alias: "s",
+			description: "Server URL"
+		}
+	},
+	async run({ args }) {
+		await ensureAgent(resolveCwd(), true);
+		await ensureApiKeyInEnv();
+		const cwd = resolveCwd();
+		const { runGenerateCommand } = await import("./generate-D7zJtqoC.mjs");
+		await runGenerateCommand({
+			cwd,
+			prompt: args.prompt
+		});
+		const { runDeployCommand } = await import("./deploy-DB0PeNtc.mjs");
+		await runDeployCommand({
+			cwd,
+			...args.server ? { server: args.server } : {}
+		});
+	}
+});
 const link = defineCommand({
 	meta: {
 		name: "link",
 		description: "Link local workspace packages into the current project (dev only)"
 	},
 	async run() {
-		const { runLinkCommand } = await import("./_link-BGXGFYWa.mjs");
+		const { runLinkCommand } = await import("./_link-D6mmDQ0B.mjs");
 		runLinkCommand(resolveCwd());
 	}
 });
@@ -287,7 +415,7 @@ const unlink = defineCommand({
 		description: "Restore published package versions (reverses aai link)"
 	},
 	async run() {
-		const { runUnlinkCommand } = await import("./_link-BGXGFYWa.mjs");
+		const { runUnlinkCommand } = await import("./_link-D6mmDQ0B.mjs");
 		runUnlinkCommand(resolveCwd());
 	}
 });
@@ -300,18 +428,45 @@ const mainCommand = defineCommand({
 	subCommands: {
 		init,
 		dev,
+		test,
 		build,
 		deploy,
+		delete: del,
 		start,
 		secret,
 		rag,
+		generate,
+		run,
 		link,
-		unlink
+		unlink,
+		doctor
 	}
 });
 if (process.env.VITEST !== "true") {
 	const sub = process.argv[2];
-	if (!sub || sub.startsWith("-")) process.argv.splice(2, 0, "init");
+	const knownCommands = new Set(Object.keys(mainCommand.subCommands ?? {}));
+	const helpFlags = new Set([
+		"--help",
+		"--version",
+		"-h",
+		"-V"
+	]);
+	if (!sub || sub.startsWith("-") && !helpFlags.has(sub)) process.argv.splice(2, 0, "init");
+	else if (!(sub.startsWith("-") || knownCommands.has(sub))) {
+		const promptParts = [];
+		const flagArgs = [];
+		for (let i = 2; i < process.argv.length; i++) if (process.argv[i]?.startsWith("-")) {
+			flagArgs.push(process.argv[i]);
+			if (i + 1 < process.argv.length && !process.argv[i + 1]?.startsWith("-")) flagArgs.push(process.argv[++i]);
+		} else promptParts.push(process.argv[i]);
+		process.argv = [
+			process.argv[0],
+			process.argv[1],
+			"run",
+			promptParts.join(" "),
+			...flagArgs
+		];
+	}
 	runMain(mainCommand);
 }
 //#endregion

package/dist/delete-DxECFYOp.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { a as getServerInfo } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, o as step } from "./_ui-C9IvR7Fh.mjs";
+//#region _delete.ts
+async function runDelete(opts) {
+	const fetchFn = opts.fetch ?? globalThis.fetch.bind(globalThis);
+	let resp;
+	try {
+		resp = await fetchFn(`${opts.url}/${opts.slug}`, {
+			method: "DELETE",
+			headers: { Authorization: `Bearer ${opts.apiKey}` }
+		});
+	} catch (err) {
+		const hint = opts.url.startsWith("http://localhost") ? "Is the local dev server running? Start it with `aai dev`." : "Check your network connection and verify the server URL is correct.";
+		throw new Error(`delete failed: could not reach ${opts.url}\n  ${hint}`, { cause: err });
+	}
+	if (resp.ok) return;
+	const text = await resp.text();
+	let hint = "";
+	if (resp.status === 401) hint = "Your API key may be invalid. Check ~/.config/aai/config.json or set ASSEMBLYAI_API_KEY.";
+	else if (resp.status === 404) hint = "The agent may not be deployed. Check `.aai/project.json` for the correct slug.";
+	throw new Error(`delete failed (HTTP ${resp.status}): ${text}${hint ? `\n  ${hint}` : ""}`);
+}
+//#endregion
+//#region delete.ts
+async function runDeleteCommand(opts) {
+	const { cwd } = opts;
+	const { serverUrl, slug, apiKey } = await getServerInfo(cwd, opts.server);
+	await runCommand(async ({ log }) => {
+		log(step("Delete", slug));
+		await runDelete({
+			url: serverUrl,
+			slug,
+			apiKey
+		});
+		log(step("Deleted", `${serverUrl}/${slug}`));
+	});
+}
+//#endregion
+export { runDeleteCommand };

package/dist/{deploy-2OxZpIfj.mjs → deploy-DB0PeNtc.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { l as resolveServerUrl, n as generateSlug, r as getApiKey, s as readProjectConfig, u as writeProjectConfig } from "./_discover-DsorPpR_.mjs";
-import { a as step, i as runCommand, o as stepInfo } from "./_ui-kJIua5L9.mjs";
-import { buildAgentBundle } from "./_build-Cf_bB5Vl.mjs";
+import { c as readProjectConfig, d as writeProjectConfig, i as getApiKey, r as generateSlug, u as resolveServerUrl } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, o as step, s as stepInfo } from "./_ui-C9IvR7Fh.mjs";
+import { buildAgentBundle } from "./_build-aW_zyPpr.mjs";
 //#region _deploy.ts
 async function attemptDeploy(fetchFn, url, slug, apiKey, env, worker, clientFiles) {
 	try {
@@ -17,8 +17,9 @@ async function attemptDeploy(fetchFn, url, slug, apiKey, env, worker, clientFile
 				clientFiles
 			})
 		});
-	} catch {
-		throw new Error(`deployment failed: could not reach ${url}`);
+	} catch (err) {
+		const hint = url.startsWith("http://localhost") ? "Is the local dev server running? Start it with `aai dev`." : "Check your network connection and verify the server URL is correct.";
+		throw new Error(`deployment failed: could not reach ${url}\n  ${hint}`, { cause: err });
 	}
 }
 const MAX_RETRIES = 20;
@@ -34,9 +35,12 @@ async function runDeploy(opts) {
 			slug = generateSlug();
 			continue;
 		}
-		throw new Error(`deploy failed (${resp.status}): ${text}`);
+		let hint = "";
+		if (resp.status === 401) hint = "Your API key may be invalid. Check ~/.config/aai/config.json or set ASSEMBLYAI_API_KEY.";
+		else if (resp.status === 413) hint = "Your bundle is too large. Try reducing dependencies or splitting your agent.";
+		throw new Error(`deploy failed (HTTP ${resp.status}): ${text}${hint ? `\n  ${hint}` : ""}`);
 	}
-	throw new Error(`deploy failed: could not find available slug after ${MAX_RETRIES} attempts`);
+	throw new Error(`deploy failed: could not find an available agent slug after ${MAX_RETRIES} attempts. Try setting a custom slug in .aai/project.json.`);
 }
 //#endregion
 //#region deploy.ts

package/dist/dev-DCtHG1pz.mjs

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { s as loadAgent } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, i as parsePort, n as info, o as step } from "./_ui-C9IvR7Fh.mjs";
+import { buildAgentBundle, t as createClientDevServer } from "./_build-aW_zyPpr.mjs";
+import { a as resolveServerEnv, i as loadAgentDef, n as bootServer, t as bootBackendServer } from "./_server-common-B6EXxxB2.mjs";
+//#region dev.ts
+/** Build, boot, and verify the server — used by `--check` mode. */
+async function runCheckMode(cwd, port, log) {
+	const bundle = await buildAgentBundle(cwd, log);
+	const agentDef = await loadAgentDef(cwd);
+	const env = await resolveServerEnv(cwd);
+	const server = await bootServer(agentDef, bundle.clientDir, env, port);
+	log(step("Ready", `http://localhost:${port}`));
+	const base = `http://localhost:${port}`;
+	try {
+		const healthRes = await fetch(`${base}/health`);
+		if (!healthRes.ok) throw new Error(`GET /health returned ${healthRes.status}. The server started but the health endpoint failed.`);
+		const health = await healthRes.json();
+		if (health.status !== "ok") throw new Error(`GET /health returned unhealthy status: ${JSON.stringify(health)}. Check your agent.ts for errors.`);
+		log(step("Health", health.name ?? "ok"));
+		const pageRes = await fetch(`${base}/`);
+		if (!pageRes.ok) throw new Error(`GET / returned ${pageRes.status}. The client page failed to load.`);
+		const html = await pageRes.text();
+		if (!(html.includes("<") && html.includes("html"))) throw new Error("GET / did not return valid HTML. Check that client.tsx exists and builds correctly.");
+		log(step("Client", "ok"));
+	} catch (err) {
+		await server.close();
+		throw err;
+	}
+	await server.close();
+}
+async function _startDevServer(cwd, port, log, opts) {
+	if (opts?.check) {
+		await runCheckMode(cwd, port, log);
+		return;
+	}
+	const agent = await loadAgent(cwd);
+	if (!agent) throw new Error("No agent found — run `aai init` first");
+	const agentDef = await loadAgentDef(cwd);
+	const env = await resolveServerEnv();
+	const backendPort = port + 1;
+	await bootBackendServer(agentDef, env, backendPort);
+	if (agent.clientEntry) {
+		await (await createClientDevServer(cwd, backendPort, port)).listen();
+		log(step("Ready", `http://localhost:${port}`));
+		log(info("Client HMR enabled — edits to client.tsx update instantly"));
+	} else {
+		log(step("Ready", `http://localhost:${backendPort}`));
+		log(info("No client.tsx found — serving agent API only"));
+	}
+	log(info("Ctrl-C to quit"));
+}
+async function runDevCommand(opts) {
+	const port = parsePort(opts.port);
+	await runCommand(async ({ log }) => {
+		await _startDevServer(opts.cwd, port, log, opts.check ? { check: true } : void 0);
+	});
+}
+//#endregion
+export { runDevCommand };