@alexkroman1/aai-cli 5.0.1 → 5.1.1

package/dist/{_agent-D39qatZJ.mjs → _agent-D8zBb3M5.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as serverOrigin, i as readProjectConfig, n as ensureApiKey, r as readGlobalConfig, t as approveServer } from "./_config-Czjhvaax.mjs";
+import { a as serverOrigin, i as readProjectConfig, n as ensureApiKey, r as readGlobalConfig, t as approveServer } from "./_config-D3F9km8X.mjs";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -71,8 +71,7 @@ function resolveServerUrl(explicit, configUrl, approvedOrigins = []) {
 * the project has never been deployed), server URL, and API key.
 */
 async function resolveDeployTarget(cwd, explicitServer) {
-	const config = await readProjectConfig(cwd);
-	const globalConfig = await readGlobalConfig();
+	const [config, globalConfig] = await Promise.all([readProjectConfig(cwd), readGlobalConfig()]);
 	const serverUrl = resolveServerUrl(explicitServer, config?.serverUrl, globalConfig.approvedServers ?? []);
 	if (explicitServer) await approveServer(serverUrl);
 	return {

package/dist/{_api-client-a6cPMebU.mjs → _api-client-MenP4-O7.mjs}

@@ -9,6 +9,8 @@ import { FetchError, ofetch } from "ofetch";
 * 5xx/429) are retried before surfacing an error.
 */
 const HINT_INVALID_API_KEY = "Your API key may be invalid. Run `aai` to re-enter your AssemblyAI API key.";
+/** 404 hint for requests scoped to a deployed agent's slug. */
+const HINT_NOT_DEPLOYED = "The agent may not be deployed. Check `.aai/project.json` for the correct slug.";
 /**
 * Send an authenticated request to the platform API and return the parsed
 * JSON response. Throws a descriptive error with status-specific hints on
@@ -44,4 +46,4 @@ function toApiError(err, url, opts) {
 	return new Error(`${opts.action} failed: could not reach ${url}\n  ${hint}`, { cause });
 }
 //#endregion
-export { apiRequest as t };
+export { apiRequest as n, HINT_NOT_DEPLOYED as t };

package/dist/{_bundler-DdmuZzeR.mjs → _bundler-DFS4xxqE.mjs}

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-import { n as log, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { c as validateAgentExport } from "./_utils-C502jKo8.mjs";
-import { t as buildClient } from "./client-bundler-DO3GgO6p.mjs";
+import { u as validateAgentExport } from "./_utils-Ch0J4s6a.mjs";
+import { t as buildClient } from "./client-bundler-BWDkUeEP.mjs";
 import { buildWorker } from "./worker-bundler.mjs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -79,14 +78,5 @@ function createWorkerEvaluator() {
 		return agentDef;
 	};
 }
-async function executeBuild(cwd) {
-	const bundle = await buildAgentBundle(cwd, { minify: true });
-	const agentDef = await evalWorkerBundle(bundle.worker);
-	log.success("Build complete");
-	return ok({
-		name: agentDef.name,
-		workerBytes: bundle.worker.length
-	});
-}
 //#endregion
-export { buildAgentBundle, createWorkerEvaluator, executeBuild };
+export { createWorkerEvaluator as n, evalWorkerBundle as r, buildAgentBundle as t };

package/dist/{_config-Czjhvaax.mjs → _config-D3F9km8X.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as unwrapCancel, n as log, o as CliError } from "./_ui-DXZ9prrM.mjs";
-import { l as writeJson, o as readJson, r as errorMessage } from "./_utils-C502jKo8.mjs";
+import { a as unwrapCancel, n as log, o as CliError } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage, c as readJson, d as writeJson } from "./_utils-Ch0J4s6a.mjs";
 import path from "node:path";
 import * as p from "@clack/prompts";
 import envPaths from "env-paths";
@@ -116,7 +116,7 @@ async function ensureApiKey(configDir) {
 		return envKey;
 	}
 	if (!process.stdin.isTTY) throw new CliError("no_api_key", "No API key configured and no TTY to prompt for one.", "Set the ASSEMBLYAI_API_KEY environment variable, or run `aai` interactively once to save a key.");
-	const apiKey = unwrapCancel(await p.password({ message: "Enter your AssemblyAI API key" }));
+	const apiKey = unwrapCancel(await p.password({ message: "Enter your AssemblyAI API key" }), "Setup cancelled");
 	await trySaveApiKey(dir, config, apiKey);
 	return apiKey;
 }

package/dist/{_dev-server-BCbEUhmv.mjs → _dev-server-BBUWo0sb.mjs}

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import { n as log } from "./_ui-DXZ9prrM.mjs";
-import { r as errorMessage, t as errorCode } from "./_utils-C502jKo8.mjs";
-import { n as fallbackHtmlPlugin } from "./client-bundler-DO3GgO6p.mjs";
+import { n as log } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage, r as errorCode } from "./_utils-Ch0J4s6a.mjs";
+import { n as fallbackHtmlPlugin } from "./client-bundler-BWDkUeEP.mjs";
 import { buildWorker } from "./worker-bundler.mjs";
-import { createWorkerEvaluator } from "./_bundler-DdmuZzeR.mjs";
-import { n as ensureApiKey } from "./_config-Czjhvaax.mjs";
-import { t as resolveServerEnv } from "./_server-common-B75oco06.mjs";
+import { n as createWorkerEvaluator } from "./_bundler-DFS4xxqE.mjs";
+import { n as ensureApiKey } from "./_config-D3F9km8X.mjs";
+import { t as resolveServerEnv } from "./_server-common-CnaP_Urf.mjs";
 import { createRequire } from "node:module";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { setTimeout } from "node:timers/promises";
-import { requiredProviderEnvVars, withHostCredentialFallback } from "@alexkroman1/aai/runtime";
+import { createRuntime, createServer, requiredProviderEnvVars, withHostCredentialFallback } from "@alexkroman1/aai/runtime";
 import { watch } from "chokidar";
 import getPort, { portNumbers } from "get-port";
 import pDebounce from "p-debounce";
@@ -183,7 +183,6 @@ function viteDevConfig(cwd, vitePort, backendPort) {
 */
 async function startDevServer(opts) {
 	const { cwd, port } = opts;
-	const { createRuntime, createServer } = await import("@alexkroman1/aai/runtime");
 	const hasClient = existsSync(path.join(cwd, "client.tsx"));
 	const backendPort = hasClient ? await getPort({ port: portNumbers(port + 1, port + 100) }) : port;
 	const vitePort = port;
@@ -194,13 +193,12 @@ async function startDevServer(opts) {
 		const agentDef = await loadAgentDef(cwd, evaluateWorker);
 		const env = await resolveAgentEnv(cwd, agentDef);
 		const providerEnv = withHostCredentialFallback(env);
-		const runtime = createRuntime({
-			agent: agentDef,
-			env,
-			providerEnv
-		});
 		return createServer({
-			runtime,
+			runtime: createRuntime({
+				agent: agentDef,
+				env,
+				providerEnv
+			}),
 			name: agentDef.name,
 			env: hostModeEnv(providerEnv),
 			hostBaseAgent: agentDef,

package/dist/{_init-H-lw7czL.mjs → _init-B-LEVTHx.mjs}

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
-import { a as isEexist, l as writeJson, o as readJson, r as errorMessage } from "./_utils-C502jKo8.mjs";
-import { r as isDevMode, t as getMonorepoRoot } from "./_agent-D39qatZJ.mjs";
+import { a as errorMessage, c as readJson, d as writeJson, s as isEexist } from "./_utils-Ch0J4s6a.mjs";
+import { r as isDevMode, t as getMonorepoRoot } from "./_agent-D8zBb3M5.mjs";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import fs from "node:fs/promises";
 import os from "node:os";
 import { downloadTemplate } from "giget";
 //#region _templates.ts
-const GIGET_SOURCE = "github:alexkroman/agent/packages/aai-templates";
+/** The GitHub repo (owner/name) that hosts this project and its templates. */
+const REPO = "alexkroman/agent";
+const REPO_URL = `https://github.com/${REPO}`;
+const GIGET_SOURCE = `github:${REPO}/packages/aai-templates`;
 const GIGET_REF = process.env.AAI_TEMPLATES_REF ?? "main";
 const VALID_REF_RE = /^[\w./-]+$/;
 const noCleanup = async () => void 0;
@@ -79,7 +82,7 @@ async function downloadAndMergeTemplate(template, targetDir) {
 function readmeContent(slug) {
 	return `# ${slug}
 
-A voice agent built with [aai](https://github.com/anthropics/aai).
+A voice agent built with [aai](${REPO_URL}).
 
 ## Getting started
 

package/dist/{_server-common-B75oco06.mjs → _server-common-CnaP_Urf.mjs}

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { r as errorCode } from "./_utils-Ch0J4s6a.mjs";
 import path from "node:path";
 import { parseEnv } from "node:util";
 import fs from "node:fs/promises";
@@ -26,7 +27,7 @@ async function resolveServerEnv(cwd, baseEnv) {
 		try {
 			content = await fs.readFile(path.join(cwd, ".env"), "utf-8");
 		} catch (err) {
-			if (err.code !== "ENOENT") throw err;
+			if (errorCode(err) !== "ENOENT") throw err;
 		}
 		if (content !== null) fileEntries = parseEnv(content);
 	}

package/dist/_slug-api-19R5kZ0U.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { n as getServerInfo } from "./_agent-D8zBb3M5.mjs";
+import { n as apiRequest, t as HINT_NOT_DEPLOYED } from "./_api-client-MenP4-O7.mjs";
+//#region _slug-api.ts
+/**
+* Authenticated request against a deployed agent's slug-scoped resource
+* (`${serverUrl}/${slug}${resourcePath}`) — the one shape every per-agent
+* command (secret, storage) shares, including the standard "not deployed"
+* 404 hint.
+*
+* Its own module (rather than living beside `getServerInfo` in `_agent.ts`)
+* so tests can mock `_agent.ts`/`_api-client.ts` while this composition
+* stays real — an intra-module call would bypass those mocks.
+*/
+async function slugRequest(cwd, resourcePath, init, server) {
+	const { serverUrl, slug, apiKey } = await getServerInfo(cwd, server);
+	return {
+		data: await apiRequest(`${serverUrl}/${slug}${resourcePath}`, {
+			...init,
+			apiKey,
+			hints: { 404: HINT_NOT_DEPLOYED }
+		}),
+		slug
+	};
+}
+//#endregion
+export { slugRequest as t };

package/dist/{_typecheck-gate-B1GcKZX-.mjs → _typecheck-gate-9IHWDnl1.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as log, o as CliError } from "./_ui-DXZ9prrM.mjs";
+import { n as log, o as CliError } from "./_ui-8kOEB-JH.mjs";
 import { typecheckProject } from "./typecheck.mjs";
 //#region _typecheck-gate.ts
 /**
@@ -14,4 +14,4 @@ async function assertTypechecks(cwd) {
 	if (!result.ok) throw new CliError("typecheck_failed", result.output, "Fix the type errors, or pass --skipTypecheck to build anyway");
 }
 //#endregion
-export { assertTypechecks };
+export { assertTypechecks as t };

package/dist/{_ui-DXZ9prrM.mjs → _ui-8kOEB-JH.mjs}

@@ -83,10 +83,13 @@ const log = new Proxy(p.log, { get(target, prop, receiver) {
 function silenceOutput() {
 	silenced = true;
 }
-/** Unwrap a clack prompt result, exiting cleanly if the user cancelled. */
-function unwrapCancel(result) {
+/**
+* Unwrap a clack prompt result, exiting cleanly if the user cancelled.
+* `message` lets the caller name what was cancelled (e.g. "Setup cancelled").
+*/
+function unwrapCancel(result, message = "Cancelled") {
 	if (p.isCancel(result)) {
-		p.cancel("Setup cancelled");
+		p.cancel(message);
 		process.exit(0);
 	}
 	return result;

package/dist/{_utils-C502jKo8.mjs → _utils-Ch0J4s6a.mjs}

@@ -1,8 +1,14 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { errorDetail, errorMessage, errorMessage as errorMessage$1 } from "@alexkroman1/aai/utils";
 //#region _utils.ts
+/**
+* The file that marks a directory as an agent project — the single source
+* for the entry filename every command checks or scaffolds.
+*/
+const AGENT_ENTRY = "agent.ts";
 /** Resolve the working directory from INIT_CWD or process.cwd(). */
 function resolveCwd() {
 	return process.env.INIT_CWD || process.cwd();
@@ -19,6 +25,16 @@ function isEexist(err) {
 function validateAgentExport(mod) {
 	if (!mod?.name || typeof mod.name !== "string") throw new Error("agent.ts must export default agent({ name: ... })");
 }
+/**
+* Absolute path of `binName`'s script declared by the package.json at
+* `pkgJsonPath`, or undefined when the package declares no such bin.
+* Handles both `"bin": "script.js"` and `"bin": { name: "script.js" }`.
+*/
+function binFromPackageJson(pkgJsonPath, binName) {
+	const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+	const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.[binName];
+	return bin ? path.join(path.dirname(pkgJsonPath), bin) : void 0;
+}
 async function fileExists(p) {
 	try {
 		await fs.access(p);
@@ -79,4 +95,4 @@ async function writeJson(filePath, data, opts = {}) {
 	}
 }
 //#endregion
-export { isEexist as a, validateAgentExport as c, fileExists as i, writeJson as l, errorDetail as n, readJson as o, errorMessage$1 as r, resolveCwd as s, errorCode as t };
+export { errorMessage$1 as a, readJson as c, writeJson as d, errorDetail as i, resolveCwd as l, binFromPackageJson as n, fileExists as o, errorCode as r, isEexist as s, AGENT_ENTRY as t, validateAgentExport as u };

package/dist/build-Xq1xxoSg.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { n as log, o as CliError, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { r as evalWorkerBundle, t as buildAgentBundle } from "./_bundler-DFS4xxqE.mjs";
+import { t as assertTypechecks } from "./_typecheck-gate-9IHWDnl1.mjs";
+import { classifyVitestError, runVitest } from "./test-3Gq4pqH_.mjs";
+//#region build.ts
+/**
+* `aai build` — bundle the agent without deploying, behind the same gates
+* deploy runs (tests, then typecheck), so the command previews the deploy
+* artifact and its failures alike.
+*/
+/**
+* Map a {@link runVitest} failure to a CliError — distinguishing a real test
+* failure (test_failed) from the runner not spawning (spawn_failed) instead
+* of a generic command_failed.
+*/
+function testGateError(err) {
+	const { code, message } = classifyVitestError(err);
+	return new CliError(code, message, "Re-run with --skipTests to build without tests", { cause: err });
+}
+async function executeBuild(opts) {
+	const { cwd } = opts;
+	if (!opts.skipTests) try {
+		runVitest(cwd);
+	} catch (err) {
+		throw testGateError(err);
+	}
+	if (!opts.skipTypecheck) await assertTypechecks(cwd);
+	const bundle = await buildAgentBundle(cwd, { minify: true });
+	const agentDef = await evalWorkerBundle(bundle.worker);
+	log.success("Build complete");
+	return ok({
+		name: agentDef.name,
+		workerBytes: bundle.worker.length
+	});
+}
+//#endregion
+export { executeBuild };

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { c as getOutputMode, d as writeLine, i as silenceOutput, l as installStdoutGuard, n as log, o as CliError, s as fail } from "./_ui-DXZ9prrM.mjs";
-import { i as fileExists, r as errorMessage, s as resolveCwd } from "./_utils-C502jKo8.mjs";
+import { c as getOutputMode, d as writeLine, i as silenceOutput, l as installStdoutGuard, n as log, o as CliError, s as fail } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage, l as resolveCwd, o as fileExists, t as AGENT_ENTRY } from "./_utils-Ch0J4s6a.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -8,12 +8,6 @@ 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",
@@ -48,7 +42,7 @@ const VERSION = readCliVersion(cliDir);
 async function setup(opts) {
 	const cwd = resolveCwd();
 	if (opts?.agent) {
-		if (!await fileExists(path.join(cwd, "agent.ts"))) throw new Error("No agent.ts found in the current directory. Run `aai init` first.");
+		if (!await fileExists(path.join(cwd, "agent.ts"))) throw new Error(`No ${AGENT_ENTRY} found in the current directory. Run \`aai init\` first.`);
 	}
 	return cwd;
 }
@@ -56,7 +50,6 @@ async function setup(opts) {
 * Run a command body with standard output-mode resolution, error handling,
 * and result emission.
 *
-* - `setYes`: json mode sets `args.yes = true` (only meaningful for commands with a `yes` arg).
 * - API key acquisition is owned by `resolveDeployTarget`/`getServerInfo`
 *   inside the commands that talk to the platform — after the server-trust
 *   check, so an untrusted `serverUrl` is refused without prompting for a
@@ -66,12 +59,9 @@ async function setup(opts) {
 * human mode logs the message, JSON mode writes exactly one result line,
 * and both exit 1.
 */
-async function runCommand(args, fn, opts = {}) {
+async function runCommand(args, fn) {
 	const mode = getOutputMode(args);
-	if (mode === "json") {
-		silenceOutput();
-		if (opts.setYes) args.yes = true;
-	}
+	if (mode === "json") silenceOutput();
 	let result;
 	try {
 		result = await fn(mode);
@@ -115,16 +105,16 @@ const init = defineCommand({
 	},
 	async run({ args }) {
 		await runCommand(args, async (mode) => {
-			const { executeInit } = await import("./init-B53rR3yD.mjs");
+			const { executeInit } = await import("./init-tc3Rbgrf.mjs");
 			return executeInit({
 				dir: args.dir,
 				force: args.force,
 				template: args.template,
-				yes: args.yes,
+				yes: mode === "json" ? true : args.yes,
 				skipDeploy: args.skipDeploy,
 				server: args.server
 			}, mode === "json" ? { silent: true } : void 0);
-		}, { setYes: true });
+		});
 	}
 });
 const dev = defineCommand({
@@ -133,13 +123,18 @@ const dev = defineCommand({
 		description: "Start a local development server"
 	},
 	args: {
-		port: sharedArgs.port,
+		port: {
+			type: "string",
+			alias: "p",
+			description: "Port to listen on",
+			default: "3000"
+		},
 		json: sharedArgs.json
 	},
 	async run({ args }) {
 		await runCommand(args, async () => {
 			const cwd = await setup({ agent: true });
-			const { executeDev } = await import("./dev-C8o-p13B.mjs");
+			const { executeDev } = await import("./dev-g7sGt8qX.mjs");
 			return executeDev({
 				cwd,
 				port: args.port
@@ -156,7 +151,7 @@ const test = defineCommand({
 	async run({ args }) {
 		await runCommand(args, async () => {
 			const cwd = await setup();
-			const { executeTest } = await import("./test-CgWhus_Z.mjs");
+			const { executeTest } = await import("./test-3Gq4pqH_.mjs");
 			return executeTest(cwd);
 		});
 	}
@@ -180,24 +175,12 @@ const build = defineCommand({
 	async run({ args }) {
 		await runCommand(args, async () => {
 			const cwd = await setup({ agent: true });
-			if (!args.skipTests) {
-				const { classifyVitestError, runVitest } = await import("./test-CgWhus_Z.mjs");
-				const toCliError = (err) => {
-					const { code, message } = classifyVitestError(err);
-					return new CliError(code, message, "Re-run with --skipTests to build without tests", { cause: err });
-				};
-				try {
-					runVitest(cwd);
-				} catch (err) {
-					throw toCliError(err);
-				}
-			}
-			if (!args.skipTypecheck) {
-				const { assertTypechecks } = await import("./_typecheck-gate-B1GcKZX-.mjs");
-				await assertTypechecks(cwd);
-			}
-			const { executeBuild } = await import("./_bundler-DdmuZzeR.mjs");
-			return executeBuild(cwd);
+			const { executeBuild } = await import("./build-Xq1xxoSg.mjs");
+			return executeBuild({
+				cwd,
+				skipTests: args.skipTests,
+				skipTypecheck: args.skipTypecheck
+			});
 		});
 	}
 });
@@ -221,12 +204,12 @@ const deploy = defineCommand({
 	async run({ args }) {
 		await runCommand(args, async () => {
 			const cwd = await setup({ agent: true });
-			const { executeDeploy } = await import("./deploy-D-dnt9L8.mjs");
+			const { executeDeploy } = await import("./deploy-Ci0X1gp2.mjs");
 			return executeDeploy({
 				cwd,
-				...args.server ? { server: args.server } : {},
-				...args.allowMissingSecrets ? { allowMissingSecrets: true } : {},
-				...args.skipTypecheck ? { skipTypecheck: true } : {}
+				server: args.server,
+				allowMissingSecrets: args.allowMissingSecrets,
+				skipTypecheck: args.skipTypecheck
 			});
 		});
 	}
@@ -243,10 +226,10 @@ const del = defineCommand({
 	async run({ args }) {
 		await runCommand(args, async () => {
 			const cwd = await setup();
-			const { executeDelete } = await import("./delete-K24hW1ab.mjs");
+			const { executeDelete } = await import("./delete-kSXFLxek.mjs");
 			return executeDelete({
 				cwd,
-				...args.server ? { server: args.server } : {}
+				server: args.server
 			});
 		});
 	}
@@ -274,9 +257,9 @@ const secret = defineCommand({
 			async run({ args }) {
 				await runCommand(args, async (mode) => {
 					const cwd = await setup();
-					const { executeSecretPut, readStdin } = await import("./secret-C4unwCEw.mjs");
+					const { executeSecretPut, NO_INPUT, readStdin } = await import("./secret-DOva9OGk.mjs");
 					const value = mode === "json" ? await readStdin() : void 0;
-					if (mode === "json" && !value) throw new CliError("no_input", "No value provided", "Pipe secret value to stdin");
+					if (mode === "json" && !value) throw new CliError(...NO_INPUT);
 					return executeSecretPut(cwd, args.name, value, args.server);
 				});
 			}
@@ -298,7 +281,7 @@ const secret = defineCommand({
 			async run({ args }) {
 				await runCommand(args, async () => {
 					const cwd = await setup();
-					const { executeSecretDelete } = await import("./secret-C4unwCEw.mjs");
+					const { executeSecretDelete } = await import("./secret-DOva9OGk.mjs");
 					return executeSecretDelete(cwd, args.name, args.server);
 				});
 			}
@@ -315,7 +298,7 @@ const secret = defineCommand({
 			async run({ args }) {
 				await runCommand(args, async () => {
 					const cwd = await setup();
-					const { executeSecretList } = await import("./secret-C4unwCEw.mjs");
+					const { executeSecretList } = await import("./secret-DOva9OGk.mjs");
 					return executeSecretList(cwd, args.server);
 				});
 			}
@@ -350,7 +333,7 @@ const storage = defineCommand({
 			},
 			async run({ args }) {
 				await runCommand(args, async () => {
-					const { executeStorageStatus } = await import("./storage-tZM1J8qj.mjs");
+					const { executeStorageStatus } = await import("./storage-vM6HjDZZ.mjs");
 					return executeStorageStatus(resolveStorageCwd(args.dir), args.server);
 				});
 			}
@@ -367,7 +350,7 @@ const storage = defineCommand({
 			},
 			async run({ args }) {
 				await runCommand(args, async () => {
-					const { executeStorageEnable } = await import("./storage-tZM1J8qj.mjs");
+					const { executeStorageEnable } = await import("./storage-vM6HjDZZ.mjs");
 					return executeStorageEnable(resolveStorageCwd(args.dir), args.server);
 				});
 			}
@@ -389,7 +372,7 @@ const storage = defineCommand({
 			},
 			async run({ args }) {
 				await runCommand(args, async () => {
-					const { executeStorageDisable } = await import("./storage-tZM1J8qj.mjs");
+					const { executeStorageDisable } = await import("./storage-vM6HjDZZ.mjs");
 					return executeStorageDisable(resolveStorageCwd(args.dir), {
 						server: args.server,
 						force: args.force

package/dist/{client-bundler-DO3GgO6p.mjs → client-bundler-BWDkUeEP.mjs}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { i as fileExists, r as errorMessage } from "./_utils-C502jKo8.mjs";
+import { a as errorMessage$1, o as fileExists } from "./_utils-Ch0J4s6a.mjs";
 import { t as withPreservedNodeEnv } from "./_vite-env-Dg_QlVv0.mjs";
 import { existsSync, unlinkSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import fs from "node:fs/promises";
-import { isTextAssetPath } from "@alexkroman1/aai";
+import { isTextAssetPath } from "@alexkroman1/aai/utils";
 import { build } from "vite";
 //#region _default-html.ts
 /**
@@ -65,7 +65,7 @@ function writeTempHtml(root) {
 		writeFileSync(htmlPath, DEFAULT_HTML);
 	} catch (err) {
 		cleanup();
-		throw new Error(`Failed to write a temporary index.html at ${htmlPath} for the client build — is the project directory writable? (${errorMessage(err)})`, { cause: err });
+		throw new Error(`Failed to write a temporary index.html at ${htmlPath} for the client build — is the project directory writable? (${errorMessage$1(err)})`, { cause: err });
 	}
 	return cleanup;
 }
@@ -88,8 +88,7 @@ const DEFAULT_OUT_DIR = ".aai/client";
 *
 * Deduping states the peer contract in terms the bundler enforces, and it is
 * what a React app wants anyway: two copies of React in one bundle break
-* hooks. Guarded by `client-bundler.test.ts` and, for the half that has to
-* hold in the image, `aai-server/dockerfile-packaging.test.ts`.
+* hooks. Guarded by `client-bundler.test.ts`.
 */
 const DEDUPED_PEERS = ["react", "react-dom"];
 /**
@@ -131,7 +130,7 @@ async function readClientDir(clientDir) {
 			withFileTypes: true
 		});
 	} catch (err) {
-		throw new Error(`Client build produced no output at ${clientDir}: ${errorMessage(err)}`, { cause: err });
+		throw new Error(`Client build produced no output at ${clientDir}: ${errorMessage$1(err)}`, { cause: err });
 	}
 	await Promise.all(entries.filter((entry) => entry.isFile()).map(async (entry) => {
 		const abs = path.join(entry.parentPath, entry.name);

package/dist/client-bundler.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { t as buildClient } from "./client-bundler-DO3GgO6p.mjs";
+import { t as buildClient } from "./client-bundler-BWDkUeEP.mjs";
 export { buildClient };

package/dist/{delete-K24hW1ab.mjs → delete-kSXFLxek.mjs}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { n as log, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { n as getServerInfo } from "./_agent-D39qatZJ.mjs";
-import { t as apiRequest } from "./_api-client-a6cPMebU.mjs";
+import { n as log, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { n as getServerInfo } from "./_agent-D8zBb3M5.mjs";
+import { n as apiRequest, t as HINT_NOT_DEPLOYED } from "./_api-client-MenP4-O7.mjs";
 //#region delete.ts
 async function runDelete(opts) {
 	await apiRequest(`${opts.url}/${opts.slug}`, {
 		method: "DELETE",
 		apiKey: opts.apiKey,
 		action: "delete",
-		hints: { 404: "The agent may not be deployed. Check `.aai/project.json` for the correct slug." },
+		hints: { 404: HINT_NOT_DEPLOYED },
 		...opts.fetch ? { fetch: opts.fetch } : {}
 	});
 }

package/dist/{deploy-D-dnt9L8.mjs → deploy-Ci0X1gp2.mjs}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { n as log, t as fmtUrl, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { r as errorMessage } from "./_utils-C502jKo8.mjs";
-import { buildAgentBundle } from "./_bundler-DdmuZzeR.mjs";
-import { o as writeProjectConfig } from "./_config-Czjhvaax.mjs";
-import { t as resolveServerEnv } from "./_server-common-B75oco06.mjs";
-import { i as resolveDeployTarget } from "./_agent-D39qatZJ.mjs";
-import { assertTypechecks } from "./_typecheck-gate-B1GcKZX-.mjs";
-import { t as apiRequest } from "./_api-client-a6cPMebU.mjs";
+import { n as log, t as fmtUrl, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage } from "./_utils-Ch0J4s6a.mjs";
+import { t as buildAgentBundle } from "./_bundler-DFS4xxqE.mjs";
+import { o as writeProjectConfig } from "./_config-D3F9km8X.mjs";
+import { t as resolveServerEnv } from "./_server-common-CnaP_Urf.mjs";
+import { i as resolveDeployTarget } from "./_agent-D8zBb3M5.mjs";
+import { t as assertTypechecks } from "./_typecheck-gate-9IHWDnl1.mjs";
+import { n as apiRequest } from "./_api-client-MenP4-O7.mjs";
 import { gzipSync } from "node:zlib";
 //#region _deploy.ts
 async function runDeploy(opts) {

package/dist/{dev-C8o-p13B.mjs → dev-g7sGt8qX.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { n as log, r as parsePort, t as fmtUrl, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { n as errorDetail } from "./_utils-C502jKo8.mjs";
+import { n as log, r as parsePort, t as fmtUrl, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { i as errorDetail } from "./_utils-Ch0J4s6a.mjs";
 import path from "node:path";
 import { styleText } from "node:util";
 //#region dev.ts
@@ -11,7 +11,7 @@ import { styleText } from "node:util";
 async function executeDev(opts) {
 	const port = parsePort(opts.port);
 	const agentName = path.basename(path.resolve(opts.cwd));
-	const { startDevServer } = await import("./_dev-server-BCbEUhmv.mjs");
+	const { startDevServer } = await import("./_dev-server-BBUWo0sb.mjs");
 	let cleanup;
 	let shuttingDown = false;
 	const onSignal = () => {

package/dist/{init-B53rR3yD.mjs → init-tc3Rbgrf.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { a as unwrapCancel, n as log, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { i as fileExists, o as readJson, r as errorMessage, s as resolveCwd } from "./_utils-C502jKo8.mjs";
-import { r as isDevMode, t as getMonorepoRoot } from "./_agent-D39qatZJ.mjs";
+import { a as unwrapCancel, n as log, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage, c as readJson, l as resolveCwd, o as fileExists, t as AGENT_ENTRY } from "./_utils-Ch0J4s6a.mjs";
+import { r as isDevMode, t as getMonorepoRoot } from "./_agent-D8zBb3M5.mjs";
 import path from "node:path";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
@@ -15,7 +15,7 @@ async function promptProjectName(yes) {
 		message: "What is your project named?",
 		placeholder: DEFAULT_PROJECT_NAME,
 		defaultValue: DEFAULT_PROJECT_NAME
-	})) || DEFAULT_PROJECT_NAME;
+	}), "Setup cancelled") || DEFAULT_PROJECT_NAME;
 }
 /** Enable corepack so pnpm is available (scaffold declares packageManager: pnpm). */
 async function ensurePnpm() {
@@ -74,7 +74,7 @@ function resolveTargetDir(dir) {
 }
 /** Run deploy after init and return deploy metadata if successful. */
 async function tryDeploy(cwd, server) {
-	const { executeDeploy } = await import("./deploy-D-dnt9L8.mjs");
+	const { executeDeploy } = await import("./deploy-Ci0X1gp2.mjs");
 	try {
 		const result = await executeDeploy({
 			cwd,
@@ -92,21 +92,14 @@ async function tryDeploy(cwd, server) {
 }
 /** Scaffold the project, optionally showing a spinner. */
 async function scaffoldProject(dir, cwd, template, silent) {
-	const { runInit } = await import("./_init-H-lw7czL.mjs");
-	if (silent) {
-		await runInit({
-			targetDir: cwd,
-			template
-		});
-		return;
-	}
-	const s = p.spinner();
-	s.start(`Creating ${dir}`);
+	const { runInit } = await import("./_init-B-LEVTHx.mjs");
+	const s = silent ? void 0 : p.spinner();
+	s?.start(`Creating ${dir}`);
 	await runInit({
 		targetDir: cwd,
 		template
 	});
-	s.stop("Project created");
+	s?.stop("Project created");
 }
 /** Print post-init instructions. */
 function printPostInitInfo(cwd, monorepoRoot) {
@@ -120,7 +113,7 @@ async function executeInit(opts, extra) {
 	const dir = opts.dir ?? await promptProjectName(opts.yes);
 	const monorepoRoot = getMonorepoRoot();
 	const cwd = resolveTargetDir(dir);
-	if (!opts.force && await fileExists(path.join(cwd, "agent.ts"))) throw new Error(`agent.ts already exists in this directory. Use ${styleText("cyanBright", "--force")} to overwrite.`);
+	if (!opts.force && await fileExists(path.join(cwd, "agent.ts"))) throw new Error(`${AGENT_ENTRY} already exists in this directory. Use ${styleText("cyanBright", "--force")} to overwrite.`);
 	const template = opts.template ?? "simple";
 	await scaffoldProject(dir, cwd, template, suppressUi);
 	const installed = await installDeps(cwd, suppressUi);

package/dist/{secret-C4unwCEw.mjs → secret-DOva9OGk.mjs}

@@ -1,21 +1,18 @@
 #!/usr/bin/env node
-import { a as unwrapCancel, n as log, s as fail, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { n as getServerInfo } from "./_agent-D39qatZJ.mjs";
-import { t as apiRequest } from "./_api-client-a6cPMebU.mjs";
+import { a as unwrapCancel, n as log, s as fail, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { t as slugRequest } from "./_slug-api-19R5kZ0U.mjs";
 import * as p from "@clack/prompts";
 import { text } from "node:stream/consumers";
 //#region secret.ts
-async function secretRequest(cwd, pathSuffix, init, server) {
-	const { serverUrl, slug, apiKey } = await getServerInfo(cwd, server);
-	return {
-		data: await apiRequest(`${serverUrl}/${slug}/secret${pathSuffix}`, {
-			...init,
-			apiKey,
-			action: "secret"
-		}),
-		slug
-	};
-}
+/**
+* The one `no_input` failure for `secret put`, shared by the JSON-mode stdin
+* path (cli.ts) and the TTY prompt path below so the two can't drift.
+*/
+const NO_INPUT = [
+	"no_input",
+	"No value provided",
+	"Pipe secret value to stdin"
+];
 /** Read secret value from stdin (for non-TTY / piped input). */
 async function readStdin() {
 	return (await text(process.stdin)).trim();
@@ -28,23 +25,27 @@ async function executeSecretPut(cwd, name, value, server) {
 	let secretValue = value;
 	if (!secretValue) {
 		const result = unwrapCancel(await p.password({ message: `Enter value for ${name}` }));
-		if (!result) return fail("no_input", "No value provided", "Pipe secret value to stdin");
+		if (!result) return fail(...NO_INPUT);
 		secretValue = result;
 	}
-	const { slug } = await secretRequest(cwd, "", {
+	const { slug } = await slugRequest(cwd, "/secret", {
 		method: "PUT",
-		body: { [name]: secretValue }
+		body: { [name]: secretValue },
+		action: "secret"
 	}, server);
 	log.success(`Set ${name} for ${slug}`);
 	return ok({ name });
 }
 async function executeSecretDelete(cwd, name, server) {
-	const { slug } = await secretRequest(cwd, `/${encodeURIComponent(name)}`, { method: "DELETE" }, server);
+	const { slug } = await slugRequest(cwd, `/secret/${encodeURIComponent(name)}`, {
+		method: "DELETE",
+		action: "secret"
+	}, server);
 	log.success(`Deleted ${name} from ${slug}`);
 	return ok({ name });
 }
 async function executeSecretList(cwd, server) {
-	const { data: { vars } } = await secretRequest(cwd, "", void 0, server);
+	const { data: { vars } } = await slugRequest(cwd, "/secret", { action: "secret" }, server);
 	if (vars.length === 0) log.info("No secrets set. Use `aai secret put <name>` to add one.");
 	else {
 		log.message(`${vars.length} secret${vars.length === 1 ? "" : "s"}:`);
@@ -53,4 +54,4 @@ async function executeSecretList(cwd, server) {
 	return ok({ secrets: vars });
 }
 //#endregion
-export { executeSecretDelete, executeSecretList, executeSecretPut, readStdin };
+export { NO_INPUT, executeSecretDelete, executeSecretList, executeSecretPut, readStdin };

package/dist/{storage-tZM1J8qj.mjs → storage-vM6HjDZZ.mjs}

@@ -1,20 +1,13 @@
 #!/usr/bin/env node
-import { n as log, s as fail, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { n as getServerInfo } from "./_agent-D39qatZJ.mjs";
-import { t as apiRequest } from "./_api-client-a6cPMebU.mjs";
+import { n as log, s as fail, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { t as slugRequest } from "./_slug-api-19R5kZ0U.mjs";
 import * as p from "@clack/prompts";
 //#region storage.ts
 async function storageRequest(cwd, init, server) {
-	const { serverUrl, slug, apiKey } = await getServerInfo(cwd, server);
-	return {
-		data: await apiRequest(`${serverUrl}/${slug}/storage`, {
-			...init,
-			apiKey,
-			action: "storage",
-			hints: { 404: "The agent may not be deployed. Check `.aai/project.json` for the correct slug." }
-		}),
-		slug
-	};
+	return slugRequest(cwd, "/storage", {
+		...init,
+		action: "storage"
+	}, server);
 }
 async function executeStorageStatus(cwd, server) {
 	const { data: { enabled }, slug } = await storageRequest(cwd, void 0, server);

package/dist/{test-CgWhus_Z.mjs → test-3Gq4pqH_.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { n as log, s as fail, u as ok } from "./_ui-DXZ9prrM.mjs";
-import { r as errorMessage, t as errorCode } from "./_utils-C502jKo8.mjs";
+import { n as log, s as fail, u as ok } from "./_ui-8kOEB-JH.mjs";
+import { a as errorMessage, n as binFromPackageJson, r as errorCode } from "./_utils-Ch0J4s6a.mjs";
 import { createRequire } from "node:module";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import path from "node:path";
 import { execaSync } from "execa";
 //#region test.ts
@@ -19,12 +19,10 @@ import { execaSync } from "execa";
 */
 function resolveVitestCommand(cwd, resolve = createRequire(path.join(cwd, "package.json")).resolve) {
 	try {
-		const pkgPath = resolve("vitest/package.json");
-		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-		const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.vitest;
+		const bin = binFromPackageJson(resolve("vitest/package.json"), "vitest");
 		if (bin) return {
 			cmd: process.execPath,
-			args: [path.join(path.dirname(pkgPath), bin)]
+			args: [bin]
 		};
 	} catch {}
 	return {

package/dist/typecheck.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
+import { a as errorMessage, n as binFromPackageJson } from "./_utils-Ch0J4s6a.mjs";
+import { existsSync } from "node:fs";
 import path from "node:path";
-import { readFile } from "node:fs/promises";
 import { spawn } from "node:child_process";
 //#region typecheck.ts
 /**
@@ -55,17 +55,16 @@ function findTypescriptPackage(cwd) {
 function resolveTscEntry(cwd) {
 	const dir = findTypescriptPackage(cwd);
 	if (dir === void 0) throw new Error("no typescript package in the project's node_modules");
-	const pkg = JSON.parse(readFileSync(path.join(dir, "package.json"), "utf-8"));
-	const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.tsc;
+	const bin = binFromPackageJson(path.join(dir, "package.json"), "tsc");
 	if (!bin) throw new Error("installed typescript package declares no tsc bin");
-	return path.join(dir, bin);
+	return bin;
 }
 /**
 * Typecheck the project at `cwd` with its own tsconfig + compiler.
 * Skips (ok, skipped: true) when the project has no tsconfig.json.
 */
 async function typecheckProject(cwd) {
-	if (!await readFile(path.join(cwd, "tsconfig.json"), "utf-8").then(() => true, () => false)) return {
+	if (!existsSync(path.join(cwd, "tsconfig.json"))) return {
 		ok: true,
 		skipped: true
 	};
@@ -75,7 +74,7 @@ async function typecheckProject(cwd) {
 	} catch (err) {
 		return {
 			ok: false,
-			output: `tsconfig.json is present but TypeScript is not installed — add it (npm install -D typescript) or remove tsconfig.json: ${errMessage(err)}`
+			output: `tsconfig.json is present but TypeScript is not installed — add it (npm install -D typescript) or remove tsconfig.json: ${errorMessage(err)}`
 		};
 	}
 	const result = await new Promise((resolve, reject) => {
@@ -122,8 +121,5 @@ async function typecheckProject(cwd) {
 		output: `Type check failed:\n${result.output.trim()}`
 	};
 }
-function errMessage(err) {
-	return err instanceof Error ? err.message : String(err);
-}
 //#endregion
 export { typecheckProject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai-cli",
-  "version": "5.0.1",
+  "version": "5.1.1",
   "type": "module",
   "bin": {
     "aai": "dist/cli.mjs"
@@ -35,8 +35,8 @@
     "p-timeout": "^7.0.1",
     "vite": "^8.1.5",
     "zod": "^4.4.3",
-    "@alexkroman1/aai": "5.0.1",
-    "@alexkroman1/aai-ui": "5.0.1"
+    "@alexkroman1/aai": "5.1.1",
+    "@alexkroman1/aai-ui": "5.1.1"
   },
   "devDependencies": {
     "playwright": "^1.61.1",