@alexkroman1/aai-cli 0.10.3 → 0.11.0

package/dist/_api-client-H4MFOr8j.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+//#region _api-client.ts
+/**
+* Shared HTTP helpers for platform API calls (deploy, delete, secrets).
+*/
+const HINT_INVALID_API_KEY = "Your API key may be invalid. Check ~/.config/aai/config.json or set ASSEMBLYAI_API_KEY.";
+/**
+* Send an authenticated request to the platform API.
+*
+* Adds the `Authorization` header and, on network failure, throws with a
+* contextual hint (localhost → "is the dev server running?", remote →
+* "check your network connection").
+*/
+async function apiRequest(url, init, fetchFn = globalThis.fetch.bind(globalThis)) {
+	const { apiKey, action, ...rest } = init;
+	const headers = {
+		Authorization: `Bearer ${apiKey}`,
+		...rest.body ? { "Content-Type": "application/json" } : {},
+		...rest.headers
+	};
+	try {
+		return await fetchFn(url, {
+			...rest,
+			headers
+		});
+	} catch (err) {
+		throw new Error(`${action} failed: could not reach ${url}\n  Check your network connection and verify the server URL is correct.`, { cause: err });
+	}
+}
+/** Format a non-ok API response into a descriptive error. */
+function apiError(action, status, body, hint) {
+	return /* @__PURE__ */ new Error(`${action} failed (HTTP ${status}): ${body}${hint ? `\n  ${hint}` : ""}`);
+}
+//#endregion
+export { apiError as n, apiRequest as r, HINT_INVALID_API_KEY as t };

package/dist/_bundler-BjgPrg7s.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+import path from "node:path";
+import fs from "node:fs/promises";
+import { errorMessage } from "@alexkroman1/aai/utils";
+import { build } from "vite";
+//#region _bundler.ts
+var BundleError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "BundleError";
+	}
+};
+const TEXT_EXTENSIONS = new Set([
+	".html",
+	".htm",
+	".css",
+	".js",
+	".mjs",
+	".cjs",
+	".ts",
+	".mts",
+	".json",
+	".map",
+	".svg",
+	".xml",
+	".txt",
+	".md"
+]);
+async function readDirFiles(dir) {
+	let entries;
+	try {
+		entries = await fs.readdir(dir, {
+			recursive: true,
+			withFileTypes: true
+		});
+	} catch (err) {
+		if (err instanceof Error && "code" in err && err.code === "ENOENT") return {};
+		throw err;
+	}
+	const files = {};
+	await Promise.all(entries.filter((e) => e.isFile()).map(async (e) => {
+		const full = path.join(e.parentPath, e.name);
+		const ext = path.extname(e.name).toLowerCase();
+		const rel = path.relative(dir, full);
+		if (TEXT_EXTENSIONS.has(ext)) files[rel] = await fs.readFile(full, "utf-8");
+		else files[rel] = `base64:${(await fs.readFile(full)).toString("base64")}`;
+	}));
+	return files;
+}
+/**
+* Bundle an agent project using Vite.
+*
+* - Worker: `vite build --ssr agent.ts` (uses project's vite.config.ts)
+* - Client: `vite build` (uses project's vite.config.ts)
+*/
+async function bundleAgent(agent, opts) {
+	const aaiDir = path.join(agent.dir, ".aai");
+	const buildDir = path.join(aaiDir, "build");
+	const clientDir = path.join(aaiDir, "client");
+	try {
+		await build({
+			root: agent.dir,
+			logLevel: "warn",
+			build: {
+				ssr: path.join(agent.dir, "agent.ts"),
+				outDir: buildDir,
+				emptyOutDir: true,
+				rollupOptions: { output: { entryFileNames: "worker.js" } }
+			}
+		});
+	} catch (err) {
+		throw new BundleError(errorMessage(err), { cause: err });
+	}
+	if (!(opts?.skipClient ?? !agent.clientEntry)) try {
+		await build({
+			root: agent.dir,
+			base: "./",
+			logLevel: "warn",
+			build: {
+				outDir: clientDir,
+				emptyOutDir: true
+			}
+		});
+	} catch (err) {
+		throw new BundleError(errorMessage(err), { cause: err });
+	}
+	const worker = await fs.readFile(path.join(buildDir, "worker.js"), "utf-8");
+	const clientFiles = await readDirFiles(clientDir);
+	return {
+		slug: agent.slug,
+		worker,
+		clientFiles,
+		clientDir,
+		workerBytes: Buffer.byteLength(worker)
+	};
+}
+async function buildAgentBundle(cwd) {
+	const { loadAgent } = await import("./_discover-a8yIuqEp.mjs").then((n) => n.t);
+	const { log } = await import("./_ui-DWGXImbO.mjs");
+	const agent = await loadAgent(cwd);
+	if (!agent) throw new Error("No agent found — run `aai init` first");
+	log.step(`Bundling ${agent.slug}`);
+	let bundle;
+	try {
+		bundle = await bundleAgent(agent);
+	} catch (err) {
+		if (err instanceof BundleError) throw new Error(`Build failed: ${err.message}`, { cause: err });
+		throw err;
+	}
+	return bundle;
+}
+async function runBuildCommand(cwd) {
+	const { log } = await import("./_ui-DWGXImbO.mjs");
+	await buildAgentBundle(cwd);
+	log.success("Build complete");
+}
+//#endregion
+export { buildAgentBundle, runBuildCommand };

package/dist/{_discover-CbHCotwB.mjs → _discover-a8yIuqEp.mjs}

@@ -2,13 +2,24 @@
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import fs$1 from "node:fs/promises";
+import fs from "node:fs/promises";
 import { consola } from "consola";
 import { humanId } from "human-id";
 import { z } from "zod";
 import { createInterface } from "node:readline";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
 //#region _prompts.ts
-const consola$1 = consola.create({ formatOptions: { date: false } });
 /**
 * Prompt the user for a password (masked input).
 * Returns the entered string.
@@ -47,20 +58,23 @@ function readMasked(stdin) {
 		stdin.on("data", onData);
 	});
 }
-/**
-* Prompt the user for text input with a default value.
-* Returns the entered string, or the default if empty.
-*/
-async function askText(message, defaultValue) {
-	return await consola$1.prompt(message, {
-		type: "text",
-		placeholder: defaultValue,
-		initial: defaultValue,
-		cancel: "reject"
-	}) || defaultValue;
-}
 //#endregion
 //#region _discover.ts
+var _discover_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_DEV_SERVER: () => DEFAULT_DEV_SERVER,
+	DEFAULT_SERVER: () => DEFAULT_SERVER,
+	ensureApiKeyInEnv: () => ensureApiKeyInEnv,
+	fileExists: () => fileExists,
+	generateSlug: () => generateSlug,
+	getApiKey: () => getApiKey,
+	getServerInfo: () => getServerInfo,
+	isDevMode: () => isDevMode,
+	loadAgent: () => loadAgent,
+	readProjectConfig: () => readProjectConfig,
+	resolveCwd: () => resolveCwd,
+	resolveServerUrl: () => resolveServerUrl,
+	writeProjectConfig: () => writeProjectConfig
+});
 const AuthConfigSchema = z.object({ assemblyai_api_key: z.string().optional() });
 const ProjectConfigSchema = z.object({
 	slug: z.string(),
@@ -84,15 +98,16 @@ const CONFIG_DIR = path.join(process.env.HOME ?? process.env.USERPROFILE ?? ".",
 const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 async function readAuthConfig() {
 	try {
-		return AuthConfigSchema.parse(JSON.parse(await fs$1.readFile(CONFIG_FILE, "utf-8")));
-	} catch {
+		return AuthConfigSchema.parse(JSON.parse(await fs.readFile(CONFIG_FILE, "utf-8")));
+	} catch (error) {
+		consola.debug(`Failed to read auth config from ${CONFIG_FILE}:`, error);
 		return {};
 	}
 }
 async function writeAuthConfig(config) {
-	await fs$1.mkdir(CONFIG_DIR, { recursive: true });
-	await fs$1.writeFile(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`);
-	if (process.platform !== "win32") await fs$1.chmod(CONFIG_FILE, 384);
+	await fs.mkdir(CONFIG_DIR, { recursive: true });
+	await fs.writeFile(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`);
+	if (process.platform !== "win32") await fs.chmod(CONFIG_FILE, 384);
 }
 /**
 * Retrieves the AssemblyAI API key from `process.env`, `~/.config/aai/config.json`,
@@ -105,8 +120,9 @@ async function getApiKey() {
 	if (process.env.ASSEMBLYAI_API_KEY) return process.env.ASSEMBLYAI_API_KEY;
 	const config = await readAuthConfig();
 	if (config.assemblyai_api_key) return config.assemblyai_api_key;
-	consola.info("Get your API key at https://www.assemblyai.com/dashboard/signup");
-	consola.info("Or set the ASSEMBLYAI_API_KEY environment variable to skip this prompt.\n");
+	const { log } = await import("./_ui-DWGXImbO.mjs");
+	log.info("Get your API key at https://www.assemblyai.com/dashboard/signup");
+	log.info("Or set the ASSEMBLYAI_API_KEY environment variable to skip this prompt.");
 	let key;
 	while (!key) key = await askPassword("ASSEMBLYAI_API_KEY");
 	config.assemblyai_api_key = key;
@@ -128,8 +144,9 @@ async function ensureApiKeyInEnv() {
 */
 async function readProjectConfig(agentDir) {
 	try {
-		return ProjectConfigSchema.parse(JSON.parse(await fs$1.readFile(path.join(agentDir, ".aai", "project.json"), "utf-8")));
-	} catch {
+		return ProjectConfigSchema.parse(JSON.parse(await fs.readFile(path.join(agentDir, ".aai", "project.json"), "utf-8")));
+	} catch (error) {
+		consola.debug(`Failed to read project config from ${path.join(agentDir, ".aai", "project.json")}:`, error);
 		return null;
 	}
 }
@@ -138,16 +155,16 @@ async function readProjectConfig(agentDir) {
 */
 async function writeProjectConfig(agentDir, data) {
 	const aaiDir = path.join(agentDir, ".aai");
-	await fs$1.mkdir(aaiDir, { recursive: true });
-	await fs$1.writeFile(path.join(aaiDir, "project.json"), `${JSON.stringify(data, null, 2)}\n`);
+	await fs.mkdir(aaiDir, { recursive: true });
+	await fs.writeFile(path.join(aaiDir, "project.json"), `${JSON.stringify(data, null, 2)}\n`);
 }
 /**
 * Read project config (throws if missing), resolve API key and server URL.
-* Shared by secret and rag commands.
+* Shared by secret commands.
 */
 async function getServerInfo(cwd, explicitServer, explicitApiKey) {
 	const config = await readProjectConfig(cwd);
-	if (!config) throw new Error("No .aai/project.json found — deploy first with `aai deploy`");
+	if (!config) throw new Error("No .aai/project.json found — run `aai deploy` first");
 	const apiKey = explicitApiKey ?? await getApiKey();
 	return {
 		serverUrl: resolveServerUrl(explicitServer, config.serverUrl),
@@ -155,6 +172,8 @@ async function getServerInfo(cwd, explicitServer, explicitApiKey) {
 		apiKey
 	};
 }
+/** Default production server URL for agent deployments. */
+const DEFAULT_SERVER = "https://aai-agent.fly.dev";
 /** Default local dev server URL. */
 const DEFAULT_DEV_SERVER = "http://localhost:8787";
 /** Check if the CLI is running from the monorepo (dev mode). */
@@ -172,9 +191,10 @@ function resolveServerUrl(explicit, configUrl) {
 }
 async function fileExists(p) {
 	try {
-		await fs$1.access(p);
+		await fs.access(p);
 		return true;
-	} catch {
+	} catch (error) {
+		consola.debug(`File access check failed for ${p}:`, error);
 		return false;
 	}
 }
@@ -197,4 +217,4 @@ async function loadAgent(dir) {
 	};
 }
 //#endregion
-export { getServerInfo as a, readProjectConfig as c, writeProjectConfig as d, askPassword as f, getApiKey as i, resolveCwd as l, fileExists as n, isDevMode as o, askText as p, generateSlug as r, loadAgent as s, ensureApiKeyInEnv as t, resolveServerUrl as u };
+export { getApiKey as a, readProjectConfig as c, writeProjectConfig as d, askPassword as f, generateSlug as i, resolveCwd as l, ensureApiKeyInEnv as n, getServerInfo as o, fileExists as r, isDevMode as s, _discover_exports as t, resolveServerUrl as u };

package/dist/_init-VzVTpJFZ.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { t as downloadAndMergeTemplate } from "./_templates-CtZBILce.mjs";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region _init.ts
+async function runInit(opts) {
+	const { targetDir, template } = opts;
+	await downloadAndMergeTemplate(template, 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
+aai dev            # Run locally (opens browser)
+aai deploy         # Deploy to production
+\`\`\`
+
+## Secrets
+
+Access secrets in your agent via \`ctx.env.MY_KEY\`.
+
+**Local development** — add secrets to \`.env\` (auto-loaded by \`aai dev\`):
+
+\`\`\`sh
+ALPHA_VANTAGE_KEY=sk-abc123
+MY_API_KEY=secret-value
+\`\`\`
+
+**Production** — set secrets on the server:
+
+\`\`\`sh
+aai secret put MY_KEY    # Set a secret (prompts for value)
+aai secret list          # List secret names
+aai secret delete MY_KEY # Remove a secret
+\`\`\`
+
+## Learn more
+
+See \`CLAUDE.md\` for the full agent API reference.
+`;
+	try {
+		await fs.writeFile(readmePath, readme, { flag: "wx" });
+	} catch (err) {
+		if (!(err instanceof Error && "code" in err && err.code === "EEXIST")) throw err;
+	}
+	return targetDir;
+}
+//#endregion
+export { runInit };

package/dist/_templates-CtZBILce.mjs

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { s as isDevMode } from "./_discover-a8yIuqEp.mjs";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs/promises";
+import { downloadTemplate } from "giget";
+//#region _templates.ts
+const GIGET_SOURCE = "github:alexkroman/agent/packages/aai-templates";
+const GIGET_REF = process.env.AAI_TEMPLATES_REF ?? "main";
+/** Resolve the local aai-templates package directory (dev mode only). */
+function resolveLocalTemplatesDir() {
+	const cliDir = path.dirname(fileURLToPath(import.meta.url));
+	const fromSrc = path.resolve(cliDir, "../aai-templates");
+	const fromDist = path.resolve(cliDir, "../../aai-templates");
+	if (existsSync(fromSrc)) return fromSrc;
+	if (existsSync(fromDist)) return fromDist;
+	throw new Error("Cannot find local aai-templates package");
+}
+/** Resolve the templates directory — local in dev, giget download in prod. */
+async function resolveTemplatesDir() {
+	if (isDevMode()) return resolveLocalTemplatesDir();
+	const { dir } = await downloadTemplate(`${GIGET_SOURCE}#${GIGET_REF}`, { force: true });
+	return dir;
+}
+/** List available templates with descriptions. */
+async function listTemplates() {
+	const root = await resolveTemplatesDir();
+	const dir = path.join(root, "templates");
+	const names = (await fs.readdir(dir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name).sort((a, b) => a.localeCompare(b));
+	let descriptions = {};
+	try {
+		descriptions = JSON.parse(await fs.readFile(path.join(root, "templates.json"), "utf-8"));
+	} catch {}
+	return names.map((name) => ({
+		name,
+		description: descriptions[name] ?? ""
+	}));
+}
+/**
+* Download a template into targetDir, merging scaffold files underneath.
+*/
+async function downloadAndMergeTemplate(template, targetDir) {
+	const root = await resolveTemplatesDir();
+	const templatesDir = path.join(root, "templates");
+	const names = (await fs.readdir(templatesDir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name);
+	if (!names.includes(template)) throw new Error(`Unknown template "${template}". Available templates: ${names.join(", ")}`);
+	await fs.cp(path.join(templatesDir, template), targetDir, {
+		recursive: true,
+		force: true
+	});
+	const scaffoldDir = path.join(root, "scaffold");
+	if (existsSync(scaffoldDir)) {
+		const entries = await fs.readdir(scaffoldDir, {
+			recursive: true,
+			withFileTypes: true
+		});
+		for (const entry of entries) {
+			if (!entry.isFile()) continue;
+			const rel = path.relative(scaffoldDir, path.join(entry.parentPath, entry.name));
+			const destPath = path.join(targetDir, rel);
+			await fs.mkdir(path.dirname(destPath), { recursive: true });
+			try {
+				await fs.copyFile(path.join(scaffoldDir, rel), destPath, fs.constants.COPYFILE_EXCL);
+			} catch (err) {
+				if (!(err instanceof Error && "code" in err && err.code === "EEXIST")) throw err;
+			}
+		}
+	}
+}
+//#endregion
+export { listTemplates as n, downloadAndMergeTemplate as t };

package/dist/_ui-DWGXImbO.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import * as p from "@clack/prompts";
+import { colorize } from "consola/utils";
+//#region _ui.ts
+/**
+* Unified CLI output using @clack/prompts style (◐ ◇ │).
+*
+* All commands should use these helpers instead of consola directly
+* so the output is visually consistent.
+*/
+const log = {
+	step: (msg) => p.log.step(msg),
+	success: (msg) => p.log.success(msg),
+	info: (msg) => p.log.info(msg),
+	warn: (msg) => p.log.warn(msg),
+	error: (msg) => p.log.error(msg),
+	message: (msg) => p.log.message(msg)
+};
+/** Format a URL for display. */
+function fmtUrl(url) {
+	return colorize("cyanBright", url);
+}
+/** Parse and validate a port string. Returns the numeric port or throws. */
+function parsePort(raw) {
+	const port = Number.parseInt(raw, 10);
+	if (Number.isNaN(port) || port < 0 || port > 65535) throw new Error(`Invalid port: ${raw}. Must be a number between 0 and 65535.`);
+	return port;
+}
+//#endregion
+export { fmtUrl, log, parsePort };