@alexkroman1/aai-cli 0.9.2 → 0.10.0

package/dist/{rag-D0xqGIrS.mjs → rag-BNfrEr4A.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { i as getServerInfo } from "./_discover-DsorPpR_.mjs";
-import { a as step, i as runCommand, n as info, s as warn, t as detail } from "./_ui-kJIua5L9.mjs";
+import { a as getServerInfo } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, c as warn, n as info, o as step, t as detail } from "./_ui-C9IvR7Fh.mjs";
 import { errorMessage } from "@alexkroman1/aai/utils";
 import pLimit from "p-limit";
 //#region rag.ts
@@ -64,11 +64,15 @@ async function upsertChunks(chunks, vectorUrl, apiKey, setStatus, fetchFn = glob
 	let upserted = 0;
 	let errors = 0;
 	let lastError = "";
-	const updateStatus = () => {
+	let lastStatusUpdate = 0;
+	const updateStatus = (force = false) => {
+		const now = Date.now();
+		if (!force && now - lastStatusUpdate < 100) return;
+		lastStatusUpdate = now;
 		const pct = Math.round(completed / total * 100);
 		setStatus(`   Upsert ${completed}/${total} (${pct}%)`);
 	};
-	updateStatus();
+	updateStatus(true);
 	const limit = pLimit(5);
 	await Promise.all(chunks.map((chunk) => limit(async () => {
 		try {
@@ -107,11 +111,12 @@ async function runRagCommand(opts) {
 	const { url, cwd } = opts;
 	try {
 		new URL(url);
-	} catch {
-		throw new Error(`Invalid URL: ${url}`);
+	} catch (err) {
+		throw new Error(`Invalid URL: ${url}\n  Provide a fully qualified URL including the protocol (e.g., https://example.com/docs).`, { cause: err });
 	}
-	const { apiKey, serverUrl, slug } = await getServerInfo(cwd, opts.server);
 	const chunkSize = Number.parseInt(opts.chunkSize ?? "512", 10);
+	if (Number.isNaN(chunkSize) || chunkSize <= 0) throw new Error(`Invalid chunk size: "${opts.chunkSize}". Must be a positive integer.`);
+	const { apiKey, serverUrl, slug } = await getServerInfo(cwd, opts.server);
 	await runCommand(async ({ log, setStatus }) => {
 		await runRag({
 			url,

package/dist/{secret-BQl3zBOS.mjs → secret-Zzv7fJ_3.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { d as askPassword, i as getServerInfo } from "./_discover-DsorPpR_.mjs";
-import { a as step, i as runCommand, o as stepInfo, t as detail } from "./_ui-kJIua5L9.mjs";
+import { a as getServerInfo, f as askPassword } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, o as step, s as stepInfo, t as detail } from "./_ui-C9IvR7Fh.mjs";
 //#region secret.ts
 async function apiFetch(cwd, pathSuffix, init) {
 	const { serverUrl, slug, apiKey } = await getServerInfo(cwd);

package/dist/{start-Df8c2ciS.mjs → start-DQypQkOq.mjs}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { t as fileExists } from "./_discover-DsorPpR_.mjs";
-import { a as step, i as runCommand } from "./_ui-kJIua5L9.mjs";
-import { n as loadAgentDef, r as resolveServerEnv, t as bootServer } from "./_server-common-CpK4rWGs.mjs";
+import { n as fileExists } from "./_discover-D7HCLa_N.mjs";
+import { a as runCommand, i as parsePort, o as step } from "./_ui-C9IvR7Fh.mjs";
+import { a as resolveServerEnv, i as loadAgentDef, n as bootServer } from "./_server-common-B6EXxxB2.mjs";
 import path from "node:path";
 //#region start.ts
 async function _startProductionServer(cwd, port, log) {
 	const clientDir = path.join(cwd, ".aai", "client");
 	log(step("Start", "loading agent"));
-	await bootServer(await loadAgentDef(cwd), clientDir, await resolveServerEnv(), port);
+	await bootServer(await loadAgentDef(cwd), clientDir, await resolveServerEnv(cwd), port);
 	log(step("Ready", `http://localhost:${port}`));
 }
 async function runStartCommand(opts) {
-	const port = Number.parseInt(opts.port, 10);
+	const port = parsePort(opts.port);
 	const buildDir = path.join(opts.cwd, ".aai", "build");
 	if (!await fileExists(path.join(buildDir, "worker.js"))) throw new Error("No build found — run `aai build` first");
 	await runCommand(async ({ log }) => {

package/dist/test-9fFn9DCf.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { a as runCommand, o as step } from "./_ui-C9IvR7Fh.mjs";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+//#region test.ts
+/**
+* `aai test` — run agent tests via vitest.
+*/
+/**
+* Run vitest in the given project directory.
+*
+* Returns `true` if tests passed, `false` if no test files exist.
+* Throws on test failure.
+*/
+function runVitest(cwd) {
+	if (!(existsSync(path.join(cwd, "agent.test.ts")) || existsSync(path.join(cwd, "agent.test.js")))) return false;
+	execSync("npx vitest run", {
+		cwd,
+		stdio: "inherit",
+		env: {
+			...process.env,
+			NODE_OPTIONS: "--experimental-strip-types"
+		}
+	});
+	return true;
+}
+/** Run agent tests. Used by `aai test`. */
+async function runTestCommand(cwd) {
+	await runCommand(async ({ log }) => {
+		log(step("Test", "running agent tests"));
+		if (!runVitest(cwd)) {
+			log("No test files found (agent.test.ts). Skipping.");
+			return;
+		}
+		log(step("Test", "ok"));
+	});
+}
+//#endregion
+export { runTestCommand, runVitest };

package/package.json

@@ -1,41 +1,48 @@
 {
   "name": "@alexkroman1/aai-cli",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "type": "module",
   "bin": {
     "aai": "dist/cli.mjs"
   },
   "files": [
-    "dist",
-    "templates"
+    "dist"
   ],
   "dependencies": {
-    "@hono/node-server": "^1.19.11",
-    "hono": "^4.12.9",
+    "@ai-sdk/openai-compatible": "^2.0.37",
     "@chonkiejs/core": "^0.0.8",
-    "@clack/prompts": "^1.1.0",
+    "consola": "^3.4.2",
+    "giget": "^2.0.0",
+    "@hono/node-server": "^1.19.11",
     "@preact/preset-vite": "^2.10.5",
     "@tailwindcss/vite": "^4.2.2",
+    "ai": "^6.0.140",
     "citty": "^0.2.1",
+    "hono": "^4.12.9",
     "human-id": "^4.1.3",
     "p-limit": "^7.3.0",
-    "picocolors": "^1.1.1",
-    "vite": "^8.0.2",
+    "vite": "^8.0.3",
     "zod": "^4.3.6",
-    "@alexkroman1/aai": "0.9.2"
+    "@alexkroman1/aai": "0.10.0"
   },
   "devDependencies": {
     "playwright": "^1.58.2",
-    "tsdown": "^0.21.4"
+    "tsdown": "^0.21.5"
   },
   "engines": {
     "node": ">=22.6"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alexkroman/agent.git",
+    "directory": "packages/aai-cli"
+  },
   "scripts": {
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "test:integration": "vitest run pack-build.test.ts -c vitest.slow.config.ts",
-    "test:e2e": "vitest run e2e.test.ts -c vitest.slow.config.ts"
+    "test:e2e": "vitest run e2e.test.ts -c vitest.slow.config.ts",
+    "check:e2e": "vitest run e2e.test.ts -c vitest.slow.config.ts"
   }
 }

package/dist/_init-l_uoyFCN.mjs

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-import path from "node:path";
-import fs from "node:fs/promises";
-//#region _init.ts
-async function listTemplates(dir) {
-	const templates = [];
-	const entries = await fs.readdir(dir, { withFileTypes: true });
-	for (const entry of entries) if (entry.isDirectory() && !entry.name.startsWith("_")) templates.push(entry.name);
-	return templates.sort();
-}
-/**
-* Copy all files from `src` into `dest`, skipping files that already exist
-* in `dest` so that template-specific files take precedence over shared ones.
-*/
-async function copyDirNoOverwrite(src, dest) {
-	const entries = await fs.readdir(src, {
-		recursive: true,
-		withFileTypes: true
-	});
-	for (const entry of entries) {
-		if (!entry.isFile()) continue;
-		const rel = path.relative(src, path.join(entry.parentPath, entry.name));
-		const destPath = path.join(dest, rel);
-		await fs.mkdir(path.dirname(destPath), { recursive: true });
-		try {
-			await fs.copyFile(path.join(src, rel), destPath, fs.constants.COPYFILE_EXCL);
-		} catch (err) {
-			if (!(err instanceof Error && "code" in err && err.code === "EEXIST")) throw err;
-		}
-	}
-}
-async function runInit(opts) {
-	const { targetDir, template, templatesDir } = opts;
-	const available = await listTemplates(templatesDir);
-	if (!available.includes(template)) throw new Error(`unknown template '${template}' -- available: ${available.join(", ")}`);
-	await fs.cp(path.join(templatesDir, template), targetDir, {
-		recursive: true,
-		force: true
-	});
-	await copyDirNoOverwrite(path.join(templatesDir, "_shared"), targetDir);
-	try {
-		await fs.copyFile(path.join(targetDir, ".env.example"), path.join(targetDir, ".env"));
-	} catch {}
-	const readmePath = path.join(targetDir, "README.md");
-	const readme = `# ${path.basename(path.resolve(targetDir))}
-
-A voice agent built with [aai](https://github.com/anthropics/aai).
-
-## Getting started
-
-\`\`\`sh
-npm install        # Install dependencies
-npm run dev        # Run locally (opens browser)
-npm run deploy     # Deploy to production
-\`\`\`
-
-## Environment variables
-
-Secrets are managed on the server, not in local files:
-
-\`\`\`sh
-aai env add MY_KEY # Set a secret (prompts for value)
-aai env ls         # List secret names
-aai env pull       # Pull names into .env for reference
-aai env rm MY_KEY  # Remove a secret
-\`\`\`
-
-Access secrets in your agent via \`ctx.env.MY_KEY\`.
-
-## Learn more
-
-See \`CLAUDE.md\` for the full agent API reference.
-`;
-	try {
-		await fs.writeFile(readmePath, readme, { flag: "wx" });
-	} catch (err) {
-		if (err.code !== "EEXIST") throw err;
-	}
-	return targetDir;
-}
-//#endregion
-export { runInit };

package/dist/_server-common-CpK4rWGs.mjs

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-import { r as getApiKey } from "./_discover-DsorPpR_.mjs";
-import path from "node:path";
-import fs from "node:fs/promises";
-//#region _server-common.ts
-/** Load an AgentDef by dynamically importing agent.ts via Node's native TS support. */
-async function loadAgentDef(cwd) {
-	const agentDef = (await import(path.resolve(cwd, "agent.ts"))).default;
-	if (!agentDef || typeof agentDef !== "object" || !agentDef.name) throw new Error("agent.ts must export a default agent definition (from defineAgent())");
-	return agentDef;
-}
-/**
-* Build an env record, ensuring ASSEMBLYAI_API_KEY is set.
-*
-* @param baseEnv - Override the base environment (defaults to process.env).
-*/
-async function resolveServerEnv(baseEnv) {
-	const env = Object.fromEntries(Object.entries(baseEnv ?? process.env).filter((e) => e[1] !== void 0));
-	if (!env.ASSEMBLYAI_API_KEY) env.ASSEMBLYAI_API_KEY = await getApiKey();
-	return env;
-}
-/** Create and start an agent server with static file serving. */
-async function bootServer(agentDef, clientDir, env, port) {
-	const clientHtml = await fs.readFile(path.join(clientDir, "index.html"), "utf-8");
-	const { createServer } = await import("@alexkroman1/aai/server");
-	const server = createServer({
-		agent: agentDef,
-		clientHtml,
-		clientDir,
-		env
-	});
-	await server.listen(port);
-	return server;
-}
-//#endregion
-export { loadAgentDef as n, resolveServerEnv as r, bootServer as t };

package/dist/_ui-kJIua5L9.mjs

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-import pc from "picocolors";
-//#region _ui.ts
-/** Interactive/info color wrapper. */
-function interactive(s) {
-	return pc.cyan(s);
-}
-/** Colored step message: bold action label + message. */
-function step(action, msg) {
-	return `${pc.bold(pc.yellow(action))} ${msg}`;
-}
-/** Informational step message: bold cyan action + message. */
-function stepInfo(action, msg) {
-	return `${pc.bold(pc.cyan(action))} ${msg}`;
-}
-/** Dimmed info sub-line (indented). */
-function info(msg) {
-	return pc.dim(`  ${msg}`);
-}
-/** Detail sub-line (indented). */
-function detail(msg) {
-	return `  ${msg}`;
-}
-/** Yellow warning message. */
-function warn(msg) {
-	return `${pc.yellow("!")} ${msg}`;
-}
-/**
-* Run an async command function, logging each step to stdout.
-* Replaces the Ink `runWithInk` pattern.
-*/
-async function runCommand(fn) {
-	const log = (msg) => console.log(msg);
-	const setStatus = (msg) => {
-		if (msg) process.stdout.write(`\r${pc.dim(msg)}`);
-		else process.stdout.write("\r\x1B[K");
-	};
-	await fn({
-		log,
-		setStatus
-	});
-}
-//#endregion
-export { step as a, runCommand as i, info as n, stepInfo as o, interactive as r, warn as s, detail as t };

package/dist/dev-DhHd1FRP.mjs

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-import "./_discover-DsorPpR_.mjs";
-import { a as step, i as runCommand, n as info } from "./_ui-kJIua5L9.mjs";
-import { buildAgentBundle } from "./_build-Dw66C1m4.mjs";
-import { n as loadAgentDef, r as resolveServerEnv, t as bootServer } from "./_server-common-CpK4rWGs.mjs";
-//#region dev.ts
-async function _startDevServer(cwd, port, log, opts) {
-	const bundle = await buildAgentBundle(cwd, log);
-	const agentDef = await loadAgentDef(cwd);
-	const env = await resolveServerEnv();
-	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}`);
-		const health = await healthRes.json();
-		if (health.status !== "ok") throw new Error(`GET /health returned ${JSON.stringify(health)}`);
-		log(step("Health", health.name ?? "ok"));
-		const pageRes = await fetch(`${base}/`);
-		if (!pageRes.ok) throw new Error(`GET / returned ${pageRes.status}`);
-		const html = await pageRes.text();
-		if (!(html.includes("<") && html.includes("html"))) throw new Error("GET / did not return valid HTML");
-		log(step("Client", "ok"));
-	} catch (err) {
-		await server.close();
-		throw err;
-	}
-	if (opts?.check) await server.close();
-	else log(info("Ctrl-C to quit"));
-}
-async function runDevCommand(opts) {
-	const port = Number.parseInt(opts.port, 10);
-	await runCommand(async ({ log }) => {
-		await _startDevServer(opts.cwd, port, log, opts.check ? { check: true } : void 0);
-	});
-}
-//#endregion
-export { runDevCommand };

package/templates/_shared/.env.example

@@ -1,5 +0,0 @@
-# Set secrets on the server with: aai env add <NAME>
-# Pull secret names here for local reference: aai env pull
-#
-# ASSEMBLYAI_API_KEY is managed globally by the CLI (~/.config/aai/).
-# Add any additional secrets your agent needs below: