@alexkroman1/aai-cli 5.14.0 → 6.1.0

package/dist/cli.mjs

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
-import { i as installStdoutGuard, n as fail, o as writeLine, r as getOutputMode, t as CliError } from "./_output-CC300DzW.mjs";
+import { i as installStdoutGuard, n as fail, o as writeLine, r as getOutputMode, t as CliError } from "./_output-CKkmWs7i.mjs";
 import { n as log, o as silenceOutput } from "./_ui-u7T4YooX.mjs";
-import { a as errorMessage, l as resolveCwd, o as fileExists, t as AGENT_ENTRY } from "./_utils-0DHbcqUb.mjs";
+import { d as resolveCwd, o as errorMessage$1, s as fileExists, t as AGENT_ENTRY } from "./_utils-B8QmtFhK.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { defineCommand, runMain, showUsage } from "citty";
+import { isRecord } from "@alexkroman1/aai/utils";
 //#region _cli-common.ts
 /** Shared arg definitions for citty commands. */
 const sharedArgs = {
@@ -87,6 +88,24 @@ async function resolve(value) {
 	return typeof value === "function" ? await value() : await value;
 }
 /**
+* `aai secret put` for a subcommand, `aai` for the root — the name to put in
+* front of `--help` when telling someone which usage to read.
+*
+* Beside {@link resolve} because it is the same job: `meta` is a `Resolvable`,
+* so only the plain-object form carries a name synchronously and anything else
+* degrades to the binary name rather than blocking an error path on a resolve.
+* This module owns citty's `Resolvable` handling; `cli.ts` had its own copy of
+* the narrowing.
+*/
+function commandPath(cmd, parent) {
+	const nameOf = (c) => {
+		const meta = c?.meta;
+		return isRecord(meta) && typeof meta.name === "string" ? meta.name : void 0;
+	};
+	const named = [nameOf(parent), nameOf(cmd)].filter((n) => n !== void 0).join(" ");
+	return named.startsWith("aai") ? named : `aai ${named}`.trim();
+}
+/**
 * Unknown flags in `argv` for whichever (possibly nested) subcommand it
 * selects — `[]` when everything is declared.
 *
@@ -131,8 +150,19 @@ async function setup(opts) {
 *   key, and commands with no platform traffic never prompt at all.
 *
 * A thrown error and a returned `fail(...)` converge here on one emitter:
-* human mode logs the message, JSON mode writes exactly one result line,
-* and both exit 1.
+* human mode logs the message and the hint, JSON mode writes exactly one
+* result line, and both exit 1.
+*
+* That convergence is the whole contract and it was HALF TRUE for a long
+* time: only the `catch` printed anything, so a body that RETURNED a failure
+* fell straight through to the JSON check and `process.exit(1)`. In human
+* mode that is a bare exit 1 with an empty terminal — `aai test` with no
+* runner binary on PATH (message and "is it on your PATH?" both discarded),
+* every `aai workflow` verb against a booting sandbox (the agent's own
+* sentence plus `HINT_BROKER` discarded), `aai secret put` with an empty
+* value, and `aai storage disable`'s "re-run with --force". Nine paths, all
+* silent. Emitting is therefore driven by the RESULT rather than by which
+* arm produced it.
 */
 async function runCommand(args, fn) {
 	const mode = getOutputMode(args);
@@ -143,18 +173,73 @@ async function runCommand(args, fn) {
 	} catch (err) {
 		const code = err instanceof CliError ? err.code : "command_failed";
 		const hint = err instanceof CliError ? err.hint : void 0;
-		if (mode === "human") {
-			log.error(errorMessage(err));
-			if (hint) log.info(hint);
-		}
-		result = fail(code, errorMessage(err), hint);
+		result = fail(code, errorMessage$1(err), hint);
+	}
+	if (mode === "human" && !result.ok) {
+		log.error(result.error);
+		if (result.hint) log.info(result.hint);
 	}
 	if (mode === "json") await writeLine(`${JSON.stringify(result)}\n`);
 	if (!result.ok) process.exit(1);
 }
+/**
+* `--json` as citty parsed it, or undefined when it was not passed.
+*
+* `Record<string, unknown>` because that is what a generic `ParsedArgs<T>`
+* satisfies: citty's parsed shape carries an index signature, and a parameter
+* typed `{ json?: boolean }` is a WEAK type, which TypeScript refuses an
+* argument whose known properties it cannot see through the generic.
+*/
+function jsonFlag(args) {
+	return typeof args.json === "boolean" ? args.json : void 0;
+}
+/**
+* The one place a {@link CwdPolicy} turns into a directory.
+*
+* The two casts are the conditional return type: TypeScript cannot verify a
+* `P extends "none" ? undefined : string` from inside a body generic in `P`,
+* and the runtime branch is the same test the type is. Callers get the exact
+* type, which is the point — a `"none"` body cannot read a `cwd`.
+*/
+async function resolvePolicyCwd(policy) {
+	if (policy === "none") return void 0;
+	return await setup(policy === "agent" ? { agent: true } : void 0);
+}
+/**
+* Define a citty command whose body is an EXECUTOR — the shape all
+* twenty-four of this CLI's leaf commands have.
+*
+* Written longhand, each one restates the same four lines (`async run({ args
+* })`, `await runCommand(args, async (mode) => …)`, a cwd resolution, a lazy
+* `await import`) and, in the middle of them, DECIDES the working-directory
+* policy — which is the part that is not boilerplate and the part that has
+* been wrong in production: `aai test` shipped calling `setup()` bare instead
+* of `setup({ agent: true })`, so in a directory with no `agent.ts` it found
+* no test file, reported `{ passed: true, skipped: true }` and exited 0. A
+* green result for a project that is not there reads, in CI, exactly like a
+* passing suite.
+*
+* `cwd` is a required field of the spec, so that decision is stated once per
+* command in the one place a reader looks for it, and "forgot to pass
+* `{ agent: true }`" stops being a representable mistake — the alternative
+* spelling is a policy name that does not exist.
+*/
+function defineExec(spec) {
+	return defineCommand({
+		meta: spec.meta,
+		args: spec.args,
+		async run({ args }) {
+			await runCommand({ json: jsonFlag(args) }, async (mode) => spec.run({
+				args,
+				mode,
+				cwd: await resolvePolicyCwd(spec.cwd)
+			}));
+		}
+	});
+}
 //#endregion
 //#region _studio-commands.ts
-const list = defineCommand({
+const list = defineExec({
 	meta: {
 		name: "list",
 		description: "List your studio projects"
@@ -163,18 +248,16 @@ const list = defineCommand({
 		server: sharedArgs.server,
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = resolveCwd();
-			const { executeList } = await import("./studio-GSFd4s5O.mjs");
-			return executeList({
-				cwd,
-				server: args.server
-			});
+	cwd: "any",
+	async run({ args, cwd }) {
+		const { executeList } = await import("./studio-BGVmCA2G.mjs");
+		return executeList({
+			cwd,
+			server: args.server
 		});
 	}
 });
-const pull = defineCommand({
+const pull = defineExec({
 	meta: {
 		name: "pull",
 		description: "Pull a studio project into a local directory"
@@ -198,21 +281,19 @@ const pull = defineCommand({
 		server: sharedArgs.server,
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = resolveCwd();
-			const { executePull } = await import("./studio-GSFd4s5O.mjs");
-			return executePull({
-				cwd,
-				project: args.project,
-				dir: args.dir,
-				force: args.force,
-				server: args.server
-			});
+	cwd: "any",
+	async run({ args, cwd }) {
+		const { executePull } = await import("./studio-BGVmCA2G.mjs");
+		return executePull({
+			cwd,
+			project: args.project,
+			dir: args.dir,
+			force: args.force,
+			server: args.server
 		});
 	}
 });
-const push = defineCommand({
+const push = defineExec({
 	meta: {
 		name: "push",
 		description: "Sync this project's source to its studio workspace"
@@ -226,19 +307,17 @@ const push = defineCommand({
 		server: sharedArgs.server,
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executePush } = await import("./studio-GSFd4s5O.mjs");
-			return executePush({
-				cwd,
-				server: args.server,
-				force: args.force
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executePush } = await import("./studio-BGVmCA2G.mjs");
+		return executePush({
+			cwd,
+			server: args.server,
+			force: args.force
 		});
 	}
 });
-const publish = defineCommand({
+const publish = defineExec({
 	meta: {
 		name: "publish",
 		description: "Push to the studio and deploy to production (the studio's Publish button)"
@@ -256,20 +335,150 @@ const publish = defineCommand({
 			description: "Skip type checking before publishing"
 		}
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executePublish } = await import("./studio-GSFd4s5O.mjs");
-			return executePublish({
-				cwd,
-				server: args.server,
-				force: args.force,
-				skipTypecheck: args.skipTypecheck
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executePublish } = await import("./studio-BGVmCA2G.mjs");
+		return executePublish({
+			cwd,
+			server: args.server,
+			force: args.force,
+			skipTypecheck: args.skipTypecheck
 		});
 	}
 });
 //#endregion
+//#region cli-workflow.ts
+/**
+* The `aai workflow` subcommand group.
+*
+* Its own module because `cli.ts` is near the 500-line cap and this is the
+* natural seam: four verbs over one surface, none of which shares anything with
+* the deploy/secret/storage commands beyond `sharedArgs`. The executors are in
+* `workflow.ts` and are imported lazily, exactly as every other command here
+* does it — the CLI's startup path must not pay for a group nobody invoked.
+*/
+/**
+* `--token` for an agent whose operator set `AAI_WORKFLOW_API_TOKEN`.
+*
+* Not the caller's API key: the workflow API is the agent's own surface and
+* takes its own bearer, so sending a platform credential there would be both
+* useless and a leak. See `workflow.ts`.
+*/
+const workflowToken = {
+	type: "string",
+	description: "Bearer for an agent that sets AAI_WORKFLOW_API_TOKEN"
+};
+/** The positional every run-scoped verb takes. */
+const runIdArg = {
+	type: "positional",
+	description: "Run id",
+	required: true
+};
+/**
+* Every verb here reads `.aai/project.json` for the origin and the published
+* slug, and none of them touches `agent.ts` — a directory `aai pull`ed but
+* never edited still names a deployed agent whose runs are worth asking about.
+*/
+const WORKFLOW_CWD = "any";
+const workflow = defineCommand({
+	meta: {
+		name: "workflow",
+		description: "Inspect and steer durable workflow runs"
+	},
+	subCommands: {
+		list: defineExec({
+			meta: {
+				name: "list",
+				description: "List the workflows this agent declares"
+			},
+			args: {
+				server: sharedArgs.server,
+				json: sharedArgs.json,
+				token: workflowToken
+			},
+			cwd: WORKFLOW_CWD,
+			async run({ args, cwd }) {
+				const { executeWorkflowList } = await import("./workflow-B-O97AqI.mjs");
+				return executeWorkflowList(cwd, {
+					server: args.server,
+					token: args.token
+				});
+			}
+		}),
+		runs: defineExec({
+			meta: {
+				name: "runs",
+				description: "List recent runs of one workflow, newest first"
+			},
+			args: {
+				workflow: {
+					type: "positional",
+					description: "Workflow name",
+					required: true
+				},
+				limit: {
+					type: "string",
+					description: "How many runs to list"
+				},
+				server: sharedArgs.server,
+				json: sharedArgs.json,
+				token: workflowToken
+			},
+			cwd: WORKFLOW_CWD,
+			async run({ args, cwd }) {
+				const { executeWorkflowRuns } = await import("./workflow-B-O97AqI.mjs");
+				const limit = args.limit === void 0 ? void 0 : Number(args.limit);
+				if (limit !== void 0 && !Number.isFinite(limit)) throw new CliError("bad_limit", "--limit must be a number");
+				return executeWorkflowRuns(cwd, args.workflow, {
+					server: args.server,
+					token: args.token,
+					limit
+				});
+			}
+		}),
+		show: defineExec({
+			meta: {
+				name: "show",
+				description: "Show one run, including its output"
+			},
+			args: {
+				runId: runIdArg,
+				server: sharedArgs.server,
+				json: sharedArgs.json,
+				token: workflowToken
+			},
+			cwd: WORKFLOW_CWD,
+			async run({ args, cwd }) {
+				const { executeWorkflowShow } = await import("./workflow-B-O97AqI.mjs");
+				return executeWorkflowShow(cwd, args.runId, {
+					server: args.server,
+					token: args.token
+				});
+			}
+		}),
+		cancel: defineExec({
+			meta: {
+				name: "cancel",
+				description: "Stop a running workflow run"
+			},
+			args: {
+				runId: runIdArg,
+				server: sharedArgs.server,
+				json: sharedArgs.json,
+				token: workflowToken
+			},
+			cwd: WORKFLOW_CWD,
+			async run({ args, cwd }) {
+				const { executeWorkflowCancel } = await import("./workflow-B-O97AqI.mjs");
+				return executeWorkflowCancel(cwd, args.runId, {
+					server: args.server,
+					token: args.token
+				});
+			}
+		})
+	}
+});
+//#endregion
 //#region cli.ts
 const cliDir = path.dirname(fileURLToPath(import.meta.url));
 /**
@@ -285,24 +494,27 @@ function readCliVersion(dir) {
 	process.stderr.write("warning: could not read aai's package.json — reporting version unknown\n");
 	return "unknown";
 }
-const VERSION = readCliVersion(cliDir);
 /**
-* `aai secret put` for a subcommand, `aai` for the root — the name to put in
-* front of `--help` when telling someone which usage to read.
+* The version, read on FIRST ACCESS rather than at module load.
 *
-* `meta` is a `Resolvable`, so it can be a function or a promise; only the
-* plain-object form carries a name synchronously and anything else degrades
-* to the binary name rather than blocking the error path on a resolve.
+* Two synchronous reads and a parse used to run for every invocation of every
+* subcommand, on the startup path this package deliberately budgets (the same
+* one that keeps zod out of `_utils.ts` and `_ui.ts`, and that `bin.mjs` exists
+* to put `module.enableCompileCache()` in front of). Only `--version` and the
+* usage renderer read `meta.version`, and citty reads it as a property — so a
+* getter is transparent to both while charging the file read to the two
+* commands that display it. Memoized because usage rendering reads it twice.
 */
-function commandPath(cmd, parent) {
-	const nameOf = (c) => {
-		const meta = c?.meta;
-		return meta && typeof meta === "object" && "name" in meta && typeof meta.name === "string" ? meta.name : void 0;
-	};
-	const path = [nameOf(parent), nameOf(cmd)].filter((n) => n !== void 0).join(" ");
-	return path.startsWith("aai") ? path : `aai ${path}`.trim();
-}
-const init = defineCommand({
+let _version;
+const mainMeta = {
+	name: "aai",
+	description: "Voice agent development kit",
+	get version() {
+		_version ??= readCliVersion(cliDir);
+		return _version;
+	}
+};
+const init = defineExec({
 	meta: {
 		name: "init",
 		description: "Scaffold a new agent project"
@@ -331,21 +543,20 @@ const init = defineCommand({
 			description: "Skip deploy after scaffolding"
 		}
 	},
-	async run({ args }) {
-		await runCommand(args, async (mode) => {
-			const { executeInit } = await import("./init-BppxMR8r.mjs");
-			return executeInit({
-				dir: args.dir,
-				force: args.force,
-				template: args.template,
-				yes: mode === "json" ? true : args.yes,
-				skipDeploy: args.skipDeploy,
-				server: args.server
-			}, mode === "json" ? { silent: true } : void 0);
-		});
+	cwd: "none",
+	async run({ args, mode }) {
+		const { executeInit } = await import("./init-BTRGiPQr.mjs");
+		return executeInit({
+			dir: args.dir,
+			force: args.force,
+			template: args.template,
+			yes: mode === "json" ? true : args.yes,
+			skipDeploy: args.skipDeploy,
+			server: args.server
+		}, mode === "json" ? { silent: true } : void 0);
 	}
 });
-const dev = defineCommand({
+const dev = defineExec({
 	meta: {
 		name: "dev",
 		description: "Start a local development server"
@@ -359,32 +570,28 @@ const dev = defineCommand({
 		},
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executeDev } = await import("./dev-CvPH5dbF.mjs");
-			return executeDev({
-				cwd,
-				port: args.port
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executeDev } = await import("./dev-C6SWaAZP.mjs");
+		return executeDev({
+			cwd,
+			port: args.port
 		});
 	}
 });
-const test = defineCommand({
+const test = defineExec({
 	meta: {
 		name: "test",
 		description: "Run agent tests"
 	},
 	args: { json: sharedArgs.json },
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executeTest } = await import("./test-2LWBcXvY.mjs");
-			return executeTest(cwd);
-		});
+	cwd: "agent",
+	async run({ cwd }) {
+		const { executeTest } = await import("./test-B6ZBxSpk.mjs");
+		return executeTest(cwd);
 	}
 });
-const build = defineCommand({
+const build = defineExec({
 	meta: {
 		name: "build",
 		description: "Bundle agent without deploying"
@@ -400,19 +607,17 @@ const build = defineCommand({
 			description: "Skip type checking before build"
 		}
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executeBuild } = await import("./build-DQJ1ZSm9.mjs");
-			return executeBuild({
-				cwd,
-				skipTests: args.skipTests,
-				skipTypecheck: args.skipTypecheck
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executeBuild } = await import("./build-BO1Ni6oJ.mjs");
+		return executeBuild({
+			cwd,
+			skipTests: args.skipTests,
+			skipTypecheck: args.skipTypecheck
 		});
 	}
 });
-const eject = defineCommand({
+const eject = defineExec({
 	meta: {
 		name: "eject",
 		description: "Add the self-hosted server.mjs entrypoint to an older project"
@@ -425,18 +630,16 @@ const eject = defineCommand({
 		},
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executeEject } = await import("./eject-LgBRfnbH.mjs");
-			return executeEject({
-				cwd,
-				force: args.force
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executeEject } = await import("./eject-Zrzk5KV3.mjs");
+		return executeEject({
+			cwd,
+			force: args.force
 		});
 	}
 });
-const deploy = defineCommand({
+const deploy = defineExec({
 	meta: {
 		name: "deploy",
 		description: "(internal) used by studio Publish",
@@ -454,20 +657,18 @@ const deploy = defineCommand({
 			description: "Skip type checking before deploy"
 		}
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup({ agent: true });
-			const { executeDeploy } = await import("./deploy-DjsEV-40.mjs");
-			return executeDeploy({
-				cwd,
-				server: args.server,
-				allowPreviewSlug: args.allowPreviewSlug,
-				skipTypecheck: args.skipTypecheck
-			});
+	cwd: "agent",
+	async run({ args, cwd }) {
+		const { executeDeploy } = await import("./deploy-DJ3HRcia.mjs");
+		return executeDeploy({
+			cwd,
+			server: args.server,
+			allowPreviewSlug: args.allowPreviewSlug,
+			skipTypecheck: args.skipTypecheck
 		});
 	}
 });
-const del = defineCommand({
+const del = defineExec({
 	meta: {
 		name: "delete",
 		description: "Delete the studio project and its deployed agents"
@@ -476,14 +677,12 @@ const del = defineCommand({
 		server: sharedArgs.server,
 		json: sharedArgs.json
 	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const cwd = await setup();
-			const { executeDelete } = await import("./delete-DCRX3d96.mjs");
-			return executeDelete({
-				cwd,
-				server: args.server
-			});
+	cwd: "any",
+	async run({ args, cwd }) {
+		const { executeDelete } = await import("./delete-4I0uNR4a.mjs");
+		return executeDelete({
+			cwd,
+			server: args.server
 		});
 	}
 });
@@ -493,7 +692,7 @@ const secret = defineCommand({
 		description: "Manage agent secrets"
 	},
 	subCommands: {
-		put: defineCommand({
+		put: defineExec({
 			meta: {
 				name: "put",
 				description: "Create or update a secret"
@@ -507,17 +706,15 @@ const secret = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async (mode) => {
-					const cwd = await setup();
-					const { executeSecretPut, NO_INPUT, readStdin } = await import("./secret-Ds9dvqAj.mjs");
-					const value = mode === "json" ? await readStdin() : void 0;
-					if (mode === "json" && !value) throw new CliError(...NO_INPUT);
-					return executeSecretPut(cwd, args.name, value, args.server);
-				});
+			cwd: "any",
+			async run({ args, mode, cwd }) {
+				const { executeSecretPut, NO_INPUT, readStdin } = await import("./secret-DzSQx1Ds.mjs");
+				const value = mode === "json" ? await readStdin() : void 0;
+				if (mode === "json" && !value) throw new CliError(...NO_INPUT);
+				return executeSecretPut(cwd, args.name, value, args.server);
 			}
 		}),
-		delete: defineCommand({
+		delete: defineExec({
 			meta: {
 				name: "delete",
 				description: "Delete a secret"
@@ -531,15 +728,13 @@ const secret = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async () => {
-					const cwd = await setup();
-					const { executeSecretDelete } = await import("./secret-Ds9dvqAj.mjs");
-					return executeSecretDelete(cwd, args.name, args.server);
-				});
+			cwd: "any",
+			async run({ args, cwd }) {
+				const { executeSecretDelete } = await import("./secret-DzSQx1Ds.mjs");
+				return executeSecretDelete(cwd, args.name, args.server);
 			}
 		}),
-		list: defineCommand({
+		list: defineExec({
 			meta: {
 				name: "list",
 				description: "List all secrets"
@@ -548,19 +743,16 @@ const secret = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async () => {
-					const cwd = await setup();
-					const { executeSecretList } = await import("./secret-Ds9dvqAj.mjs");
-					return executeSecretList(cwd, args.server);
-				});
+			cwd: "any",
+			async run({ args, cwd }) {
+				const { executeSecretList } = await import("./secret-DzSQx1Ds.mjs");
+				return executeSecretList(cwd, args.server);
 			}
 		})
 	}
 });
-/** Resolve the working directory for a storage subcommand's optional [dir]. */
-function resolveStorageCwd(dir) {
-	const cwd = resolveCwd();
+/** A storage subcommand's optional [dir], resolved against the working directory. */
+function resolveStorageCwd(cwd, dir) {
 	return dir ? path.resolve(cwd, dir) : cwd;
 }
 const storageDir = {
@@ -574,7 +766,7 @@ const storage = defineCommand({
 		description: "Manage the agent's app database"
 	},
 	subCommands: {
-		status: defineCommand({
+		status: defineExec({
 			meta: {
 				name: "status",
 				description: "Show whether storage is enabled"
@@ -584,14 +776,13 @@ const storage = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async () => {
-					const { executeStorageStatus } = await import("./storage-DbrQSHFk.mjs");
-					return executeStorageStatus(resolveStorageCwd(args.dir), args.server);
-				});
+			cwd: "any",
+			async run({ args, cwd }) {
+				const { executeStorageStatus } = await import("./storage-C-Do0mIA.mjs");
+				return executeStorageStatus(resolveStorageCwd(cwd, args.dir), args.server);
 			}
 		}),
-		enable: defineCommand({
+		enable: defineExec({
 			meta: {
 				name: "enable",
 				description: "Enable the agent's app database"
@@ -601,14 +792,13 @@ const storage = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async () => {
-					const { executeStorageEnable } = await import("./storage-DbrQSHFk.mjs");
-					return executeStorageEnable(resolveStorageCwd(args.dir), args.server);
-				});
+			cwd: "any",
+			async run({ args, cwd }) {
+				const { executeStorageEnable } = await import("./storage-C-Do0mIA.mjs");
+				return executeStorageEnable(resolveStorageCwd(cwd, args.dir), args.server);
 			}
 		}),
-		disable: defineCommand({
+		disable: defineExec({
 			meta: {
 				name: "disable",
 				description: "Disable storage and DROP the database schema with all its data"
@@ -623,61 +813,19 @@ const storage = defineCommand({
 				server: sharedArgs.server,
 				json: sharedArgs.json
 			},
-			async run({ args }) {
-				await runCommand(args, async () => {
-					const { executeStorageDisable } = await import("./storage-DbrQSHFk.mjs");
-					return executeStorageDisable(resolveStorageCwd(args.dir), {
-						server: args.server,
-						force: args.force
-					});
+			cwd: "any",
+			async run({ args, cwd }) {
+				const { executeStorageDisable } = await import("./storage-C-Do0mIA.mjs");
+				return executeStorageDisable(resolveStorageCwd(cwd, args.dir), {
+					server: args.server,
+					force: args.force
 				});
 			}
 		})
 	}
 });
-const login = defineCommand({
-	meta: {
-		name: "login",
-		description: "Link your signed-in browser account and save your API key"
-	},
-	args: {
-		server: sharedArgs.server,
-		json: sharedArgs.json
-	},
-	async run({ args }) {
-		await runCommand(args, async () => {
-			const { executeLogin } = await import("./login-BQQaxJhL.mjs");
-			return executeLogin({ server: args.server });
-		});
-	}
-});
-const templates = defineCommand({
-	meta: {
-		name: "templates",
-		description: "List available project templates"
-	},
-	args: { json: sharedArgs.json },
-	async run({ args }) {
-		await runCommand(args, async (mode) => {
-			const { listTemplates } = await import("./_templates-B1kt3BGt.mjs");
-			const names = await listTemplates();
-			if (mode === "human") {
-				for (const name of names) log.message(name);
-				log.info("Scaffold one with `aai init --template <name>`.");
-			}
-			return {
-				ok: true,
-				data: { templates: names }
-			};
-		});
-	}
-});
 const mainCommand = defineCommand({
-	meta: {
-		name: "aai",
-		version: VERSION,
-		description: "Voice agent development kit"
-	},
+	meta: mainMeta,
 	subCommands: {
 		init,
 		dev,
@@ -690,10 +838,44 @@ const mainCommand = defineCommand({
 		publish,
 		deploy,
 		delete: del,
-		login,
+		login: defineExec({
+			meta: {
+				name: "login",
+				description: "Link your signed-in browser account and save your API key"
+			},
+			args: {
+				server: sharedArgs.server,
+				json: sharedArgs.json
+			},
+			cwd: "none",
+			async run({ args }) {
+				const { executeLogin } = await import("./login-k0Z3VQu9.mjs");
+				return executeLogin({ server: args.server });
+			}
+		}),
 		secret,
 		storage,
-		templates
+		workflow,
+		templates: defineExec({
+			meta: {
+				name: "templates",
+				description: "List available project templates"
+			},
+			args: { json: sharedArgs.json },
+			cwd: "none",
+			async run({ mode }) {
+				const { listTemplates } = await import("./_templates-iDGjGiPf.mjs");
+				const names = await listTemplates();
+				if (mode === "human") {
+					for (const name of names) log.message(name);
+					log.info("Scaffold one with `aai init --template <name>`.");
+				}
+				return {
+					ok: true,
+					data: { templates: names }
+				};
+			}
+		})
 	}
 });
 if (process.env.VITEST !== "true") {
@@ -752,7 +934,7 @@ if (process.env.VITEST !== "true") {
 		process.exit(1);
 	};
 	runDefault().then(assertKnownFlags).then(() => runMain(mainCommand, { showUsage: usageForMode })).catch((err) => {
-		log.error(errorMessage(err));
+		log.error(errorMessage$1(err));
 		process.exitCode = 1;
 	});
 }