@alexkroman1/aai-cli 8.2.1 → 9.0.0

package/dist/_init-BNotRgV1.mjs

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+import { c as isEexist, l as readJson, p as writeJson } from "./_utils-B8QmtFhK.mjs";
+import { r as isDevMode, t as getMonorepoRoot } from "./_agent-BTwZJu4P.mjs";
+import { REPO_URL, downloadAndMergeTemplate } from "./_templates-4WcKOjS5.mjs";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region _init.ts
+function readmeContent(slug) {
+	return `# ${slug}
+
+A voice agent built with [aai](${REPO_URL}).
+
+## Getting started
+
+\`\`\`sh
+npm install        # Install dependencies
+aai dev            # Run locally (opens browser)
+aai publish        # Publish to production (and sync to the studio)
+\`\`\`
+
+## 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
+\`\`\`
+
+`;
+}
+/**
+* Map from npm package name to directory name under packages/.
+* Used to rewrite published version ranges to link: paths in dev mode.
+*/
+const WORKSPACE_PKG_DIRS = {
+	"@alexkroman1/aai": "aai",
+	"@alexkroman1/aai-cli": "aai-cli",
+	"@alexkroman1/aai-runtime": "aai-runtime",
+	"@alexkroman1/aai-ui": "aai-ui"
+};
+/** Rewrite workspace deps to link: paths so pnpm links to local source. */
+async function patchPackageJsonForWorkspace(targetDir) {
+	const pkgPath = path.join(targetDir, "package.json");
+	const pkgJson = await readJson(pkgPath);
+	if (!pkgJson) return;
+	pkgJson.name = path.basename(targetDir);
+	delete pkgJson.packageManager;
+	const root = getMonorepoRoot();
+	if (!root) return;
+	const packagesDir = path.join(root, "packages");
+	for (const field of ["dependencies", "devDependencies"]) {
+		const deps = pkgJson[field];
+		if (!deps) continue;
+		for (const key of Object.keys(deps)) {
+			const dir = WORKSPACE_PKG_DIRS[key];
+			if (dir) deps[key] = `link:${path.relative(targetDir, path.join(packagesDir, dir))}`;
+		}
+	}
+	await writeJson(pkgPath, pkgJson);
+	await pinSharedDeps(targetDir, packagesDir, pkgJson);
+}
+/**
+* Code-unit ordering, never `localeCompare`.
+*
+* With no explicit locale that answers to the runtime's ICU default, so the same
+* project would scaffold a differently-ordered file on a different machine —
+* which is the reason the repo's own generated artifacts sort this way too.
+*/
+function compareNames(a, b) {
+	if (a === b) return 0;
+	return a < b ? -1 : 1;
+}
+/**
+* Pin every THIRD-PARTY dependency this project shares with a linked workspace
+* package to the copy that workspace package resolved.
+*
+* Linking is what makes this necessary, and it only bites in dev mode. The
+* project's `@alexkroman1/*` deps become `link:` paths, so the SDK's types come
+* out of the WORKSPACE's `node_modules` — while the project installs its own
+* copy of anything it also declares. Two copies of a structurally identical
+* library are two NOMINALLY different types to TypeScript, and the error runs to
+* a hundred lines of `Type 'AnyActorLogic' is not assignable to type
+* 'AnyActorLogic'` with two absolute paths in it.
+*
+* Measured: `aai init --template support-line` produced exactly that. The
+* workspace lockfile pinned `xstate@5.32.5`, the fresh project resolved
+* `^5.32.5` to `5.32.6`, the CLI's typecheck gate failed, and the deploy was
+* REFUSED — `"deployed": false` with the whole error as a warning. One
+* `overrides` entry fixes it; verified end to end.
+*
+* A published install has no such problem, which is why this is dev-mode only:
+* a user's project and the published SDK both ask for `^5.32.5` and pnpm
+* resolves ONE copy. Nothing here changes what a user gets.
+*
+* Written to `pnpm-workspace.yaml` rather than `pnpm.overrides` in the manifest:
+* the scaffold ships that file, which makes the project its own workspace root,
+* and pnpm 10+ reads overrides from there. Verified both ways — the manifest
+* spelling installed `5.32.6` anyway.
+*/
+async function pinSharedDeps(targetDir, packagesDir, pkgJson) {
+	const declared = {
+		...pkgJson.dependencies,
+		...pkgJson.devDependencies
+	};
+	const linked = Object.entries(WORKSPACE_PKG_DIRS).filter(([name]) => name in declared).map(([, dir]) => dir);
+	const pins = /* @__PURE__ */ new Map();
+	for (const name of Object.keys(declared)) {
+		if (name in WORKSPACE_PKG_DIRS) continue;
+		for (const dir of linked) {
+			const manifest = await readJson(path.join(packagesDir, dir, "node_modules", name, "package.json"));
+			if (typeof manifest?.version === "string") {
+				pins.set(name, manifest.version);
+				break;
+			}
+		}
+	}
+	if (pins.size === 0) return;
+	const file = path.join(targetDir, "pnpm-workspace.yaml");
+	let existing;
+	try {
+		existing = await fs.readFile(file, "utf-8");
+	} catch {
+		return;
+	}
+	const block = [...pins].sort(([a], [b]) => compareNames(a, b)).map(([name, version]) => `  "${name}": "${version}"`).join("\n");
+	await fs.writeFile(file, `${existing.trimEnd()}\n\n# Added by \`aai init\` in DEV MODE only — see pinSharedDeps in\n# packages/aai-cli/_init.ts. The @alexkroman1/* packages above are LINKED to
+# this checkout, so anything they and this project both depend on has to be
+# ONE copy: two copies of xstate are two incompatible sets of types, and the
+# typecheck gate refuses the deploy.\noverrides:\n${block}\n`);
+}
+async function runInit(opts) {
+	const { targetDir, template } = opts;
+	await downloadAndMergeTemplate(template, targetDir);
+	if (isDevMode()) {
+		await patchPackageJsonForWorkspace(targetDir);
+		try {
+			await fs.unlink(path.join(targetDir, ".npmrc"));
+		} catch {}
+	}
+	try {
+		await fs.copyFile(path.join(targetDir, ".env.example"), path.join(targetDir, ".env"), fs.constants.COPYFILE_EXCL);
+	} catch {}
+	const readmePath = path.join(targetDir, "README.md");
+	const slug = path.basename(path.resolve(targetDir));
+	try {
+		await fs.writeFile(readmePath, readmeContent(slug), { flag: "wx" });
+	} catch (err) {
+		if (!isEexist(err)) throw err;
+	}
+}
+//#endregion
+export { runInit };

package/dist/_resource-commands.d.ts

@@ -20,4 +20,3 @@ export declare const logs: import("citty").CommandDef<{
         readonly description: "Output JSON (auto-detected in non-TTY)";
     };
 }>;
-export declare const storage: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/{build-BBxf8vom.mjs → build-DvDdSwAS.mjs}

@@ -3,7 +3,7 @@ import { a as ok, t as CliError } from "./_output-CKkmWs7i.mjs";
 import { n as log, r as notify } from "./_ui-u7T4YooX.mjs";
 import { r as evalWorkerBundle, t as buildAgentBundle } from "./_bundler-CDuYl5Gb.mjs";
 import { assertTypechecks } from "./_typecheck-gate-BXvUNnfs.mjs";
-import { classifyVitestError, runVitest } from "./test-BvyT6sAc.mjs";
+import { classifyVitestError, runVitest } from "./test-CvwgeVSQ.mjs";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { agentConfigWarnings } from "@alexkroman1/aai/manifest";

package/dist/cli.mjs

@@ -306,81 +306,17 @@ const secret = defineCommand({
 function resolveDirArg(cwd, dir) {
 	return dir ? path.resolve(cwd, dir) : cwd;
 }
-/**
-* The optional `[dir]` positional the project-scoped subcommands share.
-*
-* Named for what it is rather than for `storage`, which was the only group
-* that had one when it was written — `logs` takes the same positional and
-* read as borrowing another command's arg.
-*/
-const dirArg = {
-	type: "positional",
-	description: "Project directory",
-	required: false
-};
-const storageStatus = defineExec({
-	meta: {
-		name: "status",
-		description: "Show whether storage is enabled"
-	},
-	args: {
-		dir: dirArg,
-		server: sharedArgs.server,
-		json: sharedArgs.json
-	},
-	cwd: "any",
-	async run({ args, cwd }) {
-		const { executeStorageStatus } = await import("./storage-Bfs7QQWq.mjs");
-		return executeStorageStatus(resolveDirArg(cwd, args.dir), args.server);
-	}
-});
-const storageEnable = defineExec({
-	meta: {
-		name: "enable",
-		description: "Enable the agent's app database"
-	},
-	args: {
-		dir: dirArg,
-		server: sharedArgs.server,
-		json: sharedArgs.json
-	},
-	cwd: "any",
-	async run({ args, cwd }) {
-		const { executeStorageEnable } = await import("./storage-Bfs7QQWq.mjs");
-		return executeStorageEnable(resolveDirArg(cwd, args.dir), args.server);
-	}
-});
-const storageDisable = defineExec({
-	meta: {
-		name: "disable",
-		description: "Disable storage and DROP the database schema with all its data"
-	},
-	args: {
-		dir: dirArg,
-		force: {
-			type: "boolean",
-			alias: "f",
-			description: "Skip confirmation prompt"
-		},
-		server: sharedArgs.server,
-		json: sharedArgs.json
-	},
-	cwd: "any",
-	async run({ args, cwd }) {
-		const { executeStorageDisable } = await import("./storage-Bfs7QQWq.mjs");
-		return executeStorageDisable(resolveDirArg(cwd, args.dir), {
-			server: args.server,
-			force: args.force
-		});
-	}
-});
 const logs = defineExec({
 	meta: {
 		name: "logs",
 		description: "Show what the deployed agent has printed"
 	},
 	args: {
-		dir: dirArg,
+		dir: {
+			type: "positional",
+			description: "Project directory",
+			required: false
+		},
 		follow: {
 			type: "boolean",
 			alias: "f",
@@ -398,17 +334,6 @@ const logs = defineExec({
 		});
 	}
 });
-const storage = defineCommand({
-	meta: {
-		name: "storage",
-		description: "Manage the agent's app database"
-	},
-	subCommands: {
-		status: storageStatus,
-		enable: storageEnable,
-		disable: storageDisable
-	}
-});
 //#endregion
 //#region _studio-commands.ts
 /**
@@ -433,7 +358,7 @@ const list = defineExec({
 	},
 	cwd: "any",
 	async run({ args, cwd }) {
-		const { executeList } = await import("./studio-DUfCH9I8.mjs");
+		const { executeList } = await import("./studio-D3-HWIfk.mjs");
 		return executeList({
 			cwd,
 			server: args.server
@@ -466,7 +391,7 @@ const pull = defineExec({
 	},
 	cwd: "any",
 	async run({ args, cwd }) {
-		const { executePull } = await import("./studio-DUfCH9I8.mjs");
+		const { executePull } = await import("./studio-D3-HWIfk.mjs");
 		return executePull({
 			cwd,
 			project: args.project,
@@ -488,7 +413,7 @@ const push = defineExec({
 	},
 	cwd: "agent",
 	async run({ args, cwd }) {
-		const { executePush } = await import("./studio-DUfCH9I8.mjs");
+		const { executePush } = await import("./studio-D3-HWIfk.mjs");
 		return executePush({
 			cwd,
 			server: args.server,
@@ -512,7 +437,7 @@ const publish = defineExec({
 	},
 	cwd: "agent",
 	async run({ args, cwd }) {
-		const { executePublish } = await import("./studio-DUfCH9I8.mjs");
+		const { executePublish } = await import("./studio-D3-HWIfk.mjs");
 		return executePublish({
 			cwd,
 			server: args.server,
@@ -722,7 +647,7 @@ const mainCommand = defineCommand({
 			},
 			cwd: "none",
 			async run({ args, mode }) {
-				const { executeInit } = await import("./init-Cp5GZg0B.mjs");
+				const { executeInit } = await import("./init-DK7GpIF9.mjs");
 				return executeInit({
 					dir: args.dir,
 					force: args.force,
@@ -745,14 +670,19 @@ const mainCommand = defineCommand({
 					description: "Port to listen on",
 					default: "3000"
 				},
+				watch: {
+					type: "boolean",
+					description: "Restart on file changes (also AAI_DEV_WATCH=1)"
+				},
 				json: sharedArgs.json
 			},
 			cwd: "agent",
 			async run({ args, cwd }) {
-				const { executeDev } = await import("./dev-QuuOOUtv.mjs");
+				const { executeDev } = await import("./dev-dFzdvwa7.mjs");
 				return executeDev({
 					cwd,
-					port: args.port
+					port: args.port,
+					watch: args.watch
 				});
 			}
 		}),
@@ -764,7 +694,7 @@ const mainCommand = defineCommand({
 			args: { json: sharedArgs.json },
 			cwd: "agent",
 			async run({ cwd }) {
-				const { executeTest } = await import("./test-BvyT6sAc.mjs");
+				const { executeTest } = await import("./test-CvwgeVSQ.mjs");
 				return executeTest(cwd);
 			}
 		}),
@@ -776,7 +706,7 @@ const mainCommand = defineCommand({
 			args: { json: sharedArgs.json },
 			cwd: "agent",
 			async run({ cwd }) {
-				const { executeEval } = await import("./eval-DfQ8cm5p.mjs");
+				const { executeEval } = await import("./eval-DwNwdqmS.mjs");
 				return executeEval(cwd);
 			}
 		}),
@@ -798,7 +728,7 @@ const mainCommand = defineCommand({
 			},
 			cwd: "agent",
 			async run({ args, cwd }) {
-				const { executeBuild } = await import("./build-BBxf8vom.mjs");
+				const { executeBuild } = await import("./build-DvDdSwAS.mjs");
 				return executeBuild({
 					cwd,
 					skipTests: args.skipTests,
@@ -830,7 +760,7 @@ const mainCommand = defineCommand({
 			},
 			cwd: "agent",
 			async run({ args, cwd }) {
-				const { executeDeploy } = await import("./deploy-BqV6ShIe.mjs");
+				const { executeDeploy } = await import("./deploy-CjU3e-3P.mjs");
 				return executeDeploy({
 					cwd,
 					server: args.server,
@@ -850,7 +780,7 @@ const mainCommand = defineCommand({
 			},
 			cwd: "any",
 			async run({ args, cwd }) {
-				const { executeDelete } = await import("./delete-CPf347lo.mjs");
+				const { executeDelete } = await import("./delete-8pjH8n8n.mjs");
 				return executeDelete({
 					cwd,
 					server: args.server
@@ -874,7 +804,6 @@ const mainCommand = defineCommand({
 		}),
 		secret,
 		logs,
-		storage,
 		workflow,
 		templates: defineExec({
 			meta: {

package/dist/{delete-CPf347lo.mjs → delete-8pjH8n8n.mjs}

@@ -4,6 +4,7 @@ import { n as log } from "./_ui-u7T4YooX.mjs";
 import { l as writeProjectConfig } from "./_config-CmJOFsAP.mjs";
 import { a as resolveDeployTarget, i as requireDeployedSlug } from "./_agent-BTwZJu4P.mjs";
 import { d as apiTestSeam, l as HINT_NOT_DEPLOYED, s as studioProjectApiUrl, u as apiRequest } from "./_studio-CKrsixd0.mjs";
+import { omitUndefined } from "@alexkroman1/aai/utils";
 //#region delete.ts
 async function runDelete(opts) {
 	await apiRequest(`${opts.url}/${opts.slug}`, {
@@ -37,7 +38,7 @@ async function executeDelete(opts) {
 		await writeProjectConfig(cwd, { serverUrl });
 		return ok({
 			project,
-			...config.slug ? { slug: config.slug } : {}
+			...omitUndefined({ slug: config.slug })
 		});
 	}
 	const slug = requireDeployedSlug(config);

package/dist/{deploy-BqV6ShIe.mjs → deploy-CjU3e-3P.mjs}

@@ -8,12 +8,12 @@ import { t as resolveServerEnv } from "./_server-common-6e0QI4mq.mjs";
 import { a as resolveDeployTarget } from "./_agent-BTwZJu4P.mjs";
 import { assertTypechecks } from "./_typecheck-gate-BXvUNnfs.mjs";
 import { d as apiTestSeam, f as checkedResponse, i as projectNameFromDir, u as apiRequest } from "./_studio-CKrsixd0.mjs";
-import { isRecord } from "@alexkroman1/aai/utils";
+import { isRecord, omitUndefined } from "@alexkroman1/aai/utils";
 import { gzipSync } from "node:zlib";
 //#region _deploy.ts
 async function runDeploy(opts) {
 	const body = gzipSync(JSON.stringify({
-		...opts.slug ? { slug: opts.slug } : {},
+		...omitUndefined({ slug: opts.slug }),
 		...opts.allowPreviewSlug ? { allowPreviewSlug: true } : {},
 		env: opts.env,
 		worker: opts.bundle.worker,
@@ -56,7 +56,7 @@ async function executeDeploy(opts) {
 		url: serverUrl,
 		bundle,
 		env: uploadEnv,
-		...slug ? { slug } : {},
+		...omitUndefined({ slug }),
 		...opts.allowPreviewSlug ? { allowPreviewSlug: true } : {},
 		apiKey
 	});

package/dist/{dev-QuuOOUtv.mjs → dev-dFzdvwa7.mjs}

@@ -12,7 +12,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-Dt3TCjhj.mjs");
+	const { startDevServer } = await import("./_dev-server-BAR8Ya43.mjs");
 	let cleanup;
 	let shuttingDown = false;
 	const onSignal = () => {
@@ -28,7 +28,8 @@ async function executeDev(opts) {
 	process.on("SIGTERM", onSignal);
 	cleanup = await startDevServer({
 		cwd: opts.cwd,
-		port
+		port,
+		watch: opts.watch
 	});
 	const url = `http://localhost:${port}`;
 	log.success(`${styleText("bold", agentName)} running at ${fmtUrl(url)}`);

package/dist/dev.d.ts

@@ -9,5 +9,7 @@ type DevData = {
 export declare function executeDev(opts: {
     cwd: string;
     port: string;
+    /** `--watch`. Undefined leaves the decision to `AAI_DEV_WATCH`. */
+    watch?: boolean | undefined;
 }): Promise<CommandResult<DevData>>;
 export {};

package/dist/{eval-DfQ8cm5p.mjs → eval-DwNwdqmS.mjs}

@@ -2,7 +2,7 @@
 import { a as ok, n as fail } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
 import { t as resolveServerEnv } from "./_server-common-6e0QI4mq.mjs";
-import { classifyVitestError, runVitest } from "./test-BvyT6sAc.mjs";
+import { classifyVitestError, runVitest } from "./test-CvwgeVSQ.mjs";
 //#region eval.ts
 /**
 * `aai eval` — run the agent's behaviour evals via vitest.

package/dist/{init-Cp5GZg0B.mjs → init-DK7GpIF9.mjs}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { a as ok } from "./_output-CKkmWs7i.mjs";
 import { n as log, s as unwrapCancel } from "./_ui-u7T4YooX.mjs";
-import { d as resolveCwd, l as readJson, o as errorMessage, s as fileExists, t as AGENT_ENTRY } from "./_utils-B8QmtFhK.mjs";
+import { d as resolveCwd, l as readJson, o as errorMessage$1, s as fileExists, t as AGENT_ENTRY } from "./_utils-B8QmtFhK.mjs";
 import { r as isDevMode, t as getMonorepoRoot } from "./_agent-BTwZJu4P.mjs";
 import path from "node:path";
+import { omitUndefined } from "@alexkroman1/aai/utils";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
 import { execa } from "execa";
@@ -84,7 +85,7 @@ async function installDeps(cwd, warn, silent) {
 		}, () => runPnpmInstall(cwd));
 		return true;
 	} catch (err) {
-		warn(`pnpm install failed: ${errorMessage(err)}`);
+		warn(`pnpm install failed: ${errorMessage$1(err)}`);
 		warn("Install pnpm (`npm install -g pnpm`), then run `pnpm install` in the project.");
 		return false;
 	}
@@ -105,11 +106,11 @@ function collectWarnings() {
 }
 /** Publish after init and return deploy metadata if successful. */
 async function tryPublish(cwd, server, warn) {
-	const { executePublish } = await import("./studio-DUfCH9I8.mjs");
+	const { executePublish } = await import("./studio-D3-HWIfk.mjs");
 	try {
 		const result = await executePublish({
 			cwd,
-			...server ? { server } : {}
+			...omitUndefined({ server })
 		});
 		if (result.ok) return {
 			slug: result.data.slug,
@@ -119,14 +120,14 @@ async function tryPublish(cwd, server, warn) {
 		warn(`Publish failed: ${result.error}`);
 		return null;
 	} catch (err) {
-		warn(`Publish failed: ${errorMessage(err)}`);
+		warn(`Publish failed: ${errorMessage$1(err)}`);
 		warn("Your project was still created — run `aai publish` in it to retry.");
 		return null;
 	}
 }
 /** Scaffold the project, optionally showing a spinner. */
 async function scaffoldProject(dir, cwd, template, silent) {
-	const { runInit } = await import("./_init-BhEfQ6Yi.mjs");
+	const { runInit } = await import("./_init-BNotRgV1.mjs");
 	await withSpinner(silent, {
 		start: `Creating ${dir}`,
 		done: "Project created",

package/dist/scaffold/.env.example

@@ -12,10 +12,13 @@
 
 # --- Durable workflows and uploads -----------------------------------------
 #
-# A durable run needs a database; `api.upload(file)` needs a database AND
-# somewhere to put the bytes. A DEPLOYED agent gets both from the platform
-# (`aai storage enable`), so these four are the LOCAL equivalents and none of
-# them is needed by an agent that has no workflow.
+# A DEPLOYED agent's runs are durable with no setup — the platform keeps them
+# on its own database. `api.upload(file)` is the exception: an upload's record
+# needs a database YOU supply, so without a DATABASE_URL the bytes live only as
+# long as the sandbox even though the runs reading them do not.
+#
+# These four are the LOCAL equivalents, and none is needed by an agent that has
+# no workflow.
 #
 # All three storage keys or none: two of three resolves to nothing and refuses
 # by name rather than half-working. Nothing creates the bucket for you — a