@alexkroman1/aai-cli 8.2.0 → 9.0.0

package/dist/_init-BhEfQ6Yi.mjs

@@ -1,93 +0,0 @@
-#!/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);
-}
-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/storage-i_79ZwAR.mjs

@@ -1,66 +0,0 @@
-#!/usr/bin/env node
-import { a as ok, n as fail } from "./_output-CKkmWs7i.mjs";
-import { n as log } from "./_ui-u7T4YooX.mjs";
-import { f as checkedResponse } from "./_studio-DR5yzZ1T.mjs";
-import { n as slugRequest } from "./_slug-api-z-USxPtL.mjs";
-import { isRecord } from "@alexkroman1/aai/utils";
-import * as p from "@clack/prompts";
-//#region storage.ts
-/**
-* The storage route's answer, CHECKED — every caller here reads `enabled` and
-* a body without it reported "Storage is disabled for <slug>" (and returned
-* `enabled: undefined` to a script) for a server that never said so. See
-* `checkedResponse`.
-*/
-async function storageRequest(cwd, init, server) {
-	const { data, slug } = await slugRequest(cwd, "/storage", {
-		...init,
-		action: "storage"
-	}, server);
-	return {
-		enabled: checkedResponse(data, (value) => isRecord(value) && typeof value.enabled === "boolean", `the storage route for ${slug}`).enabled,
-		slug
-	};
-}
-async function executeStorageStatus(cwd, server) {
-	const { enabled, slug } = await storageRequest(cwd, void 0, server);
-	if (enabled) log.info(`Storage is enabled for ${slug}`);
-	else log.info(`Storage is disabled for ${slug}. Use \`aai storage enable\` to turn it on.`);
-	return ok({
-		slug,
-		enabled
-	});
-}
-async function executeStorageEnable(cwd, server) {
-	const { enabled, slug } = await storageRequest(cwd, { method: "POST" }, server);
-	log.success(`Storage enabled for ${slug}`);
-	log.info("Tool code can now use ctx.db.query(sql, params).");
-	return ok({
-		slug,
-		enabled
-	});
-}
-/**
-* Disable storage — destructive: the server DROPS the app's database schema
-* and all its data. On a TTY this requires interactive confirmation; without
-* a TTY it refuses unless `--force` is passed, so a script can never drop
-* data by accident.
-*/
-async function executeStorageDisable(cwd, opts = {}) {
-	if (!opts.force) {
-		if (!(opts.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) return fail("confirmation_required", "Disabling storage drops the app's database schema and ALL its data.", "Re-run with --force to disable storage without confirmation.");
-		const confirmed = await p.confirm({ message: "Disable storage? This DROPS the app's database schema and all its data." });
-		if (p.isCancel(confirmed) || confirmed !== true) {
-			log.info("Cancelled. Storage was left unchanged.");
-			return fail("cancelled", "Disable cancelled");
-		}
-	}
-	const { enabled, slug } = await storageRequest(cwd, { method: "DELETE" }, opts.server);
-	log.success(`Storage disabled for ${slug} — database schema and data dropped`);
-	return ok({
-		slug,
-		enabled
-	});
-}
-//#endregion
-export { executeStorageDisable, executeStorageEnable, executeStorageStatus };

package/dist/storage.d.ts

@@ -1,22 +0,0 @@
-import { type CommandResult } from "./_output.ts";
-type StorageStatusData = {
-    slug: string;
-    enabled: boolean;
-};
-export declare function executeStorageStatus(cwd: string, server: string | undefined): Promise<CommandResult<StorageStatusData>>;
-export declare function executeStorageEnable(cwd: string, server: string | undefined): Promise<CommandResult<StorageStatusData>>;
-export type StorageDisableOpts = {
-    server?: string | undefined;
-    /** Skip the confirmation prompt (required in non-interactive runs). */
-    force?: boolean | undefined;
-    /** TTY override for testing. Defaults to real stdin+stdout TTY state. */
-    isTTY?: boolean | undefined;
-};
-/**
- * Disable storage — destructive: the server DROPS the app's database schema
- * and all its data. On a TTY this requires interactive confirmation; without
- * a TTY it refuses unless `--force` is passed, so a script can never drop
- * data by accident.
- */
-export declare function executeStorageDisable(cwd: string, opts?: StorageDisableOpts): Promise<CommandResult<StorageStatusData>>;
-export {};

package/dist/templates/solo-rpg/tools/load_game.ts

@@ -1,37 +0,0 @@
-import { tool } from "@alexkroman1/aai";
-import { z } from "zod";
-import type { GameState } from "../shared.ts";
-import { gameSlot, loadState, saveSlotKey, saveSlotParam, storyFlow } from "../shared.ts";
-
-// Requires storage — `aai storage enable` (or DATABASE_URL in .env under
-// `aai dev`); the rest of the game works without it.
-export default tool({
-  description: "Load a previously saved game.",
-  inputSchema: z.object({ slot: saveSlotParam }),
-  async execute(args, ctx) {
-    const saved = await loadState<GameState>(ctx, saveSlotKey(args.slot));
-    if (!saved) return { error: "No save found." };
-    gameSlot.set(ctx, saved);
-
-    // The flow has to be restored alongside the campaign, or a loaded game
-    // would still be sitting in `awaitingSetup` with every roll tool refusing.
-    // A save is written from a settled scene, so it resumes at `awaitingRoll`
-    // rather than with a standing roll — `lastRoll` may be set, but a burn
-    // window that survived a save and a reload is not one a player is still in.
-    storyFlow.reset(ctx);
-    let at = storyFlow.send(ctx, { type: "SETUP" });
-    if (saved.gameOver) at = storyFlow.send(ctx, { type: "DOWNED" });
-
-    return {
-      loaded: true,
-      // The position spread verbatim — the same keys every gated tool reports.
-      ...at,
-      playerName: saved.playerName,
-      characterConcept: saved.characterConcept,
-      settingGenre: saved.settingGenre,
-      sceneCount: saved.sceneCount,
-      currentLocation: saved.currentLocation,
-      initialized: saved.initialized,
-    };
-  },
-});

package/dist/templates/solo-rpg/tools/save_game.ts

@@ -1,32 +0,0 @@
-import { z } from "zod";
-import { gameSlot, saveSlotKey, saveSlotParam, saveState, storyFlow } from "../shared.ts";
-
-// Requires storage — `aai storage enable` (or DATABASE_URL in .env under
-// `aai dev`); the rest of the game works without it.
-//
-/**
- * Gated on `playing` or `gameOver` — i.e. anything but `awaitingSetup`.
- *
- * Saving before a character exists writes an empty campaign under a slot name,
- * and `load_game` would then cheerfully restore it over a real game. That is a
- * position, so it is a `when`.
- *
- * The body AWAITS, which a flow tool allows: only `slot.updateTool` must be
- * synchronous, because its draft is stored when it returns. What a save needs is
- * the frozen value, and `gameSlot.get` is what hands it over.
- */
-export default storyFlow.tool({
-  description: "Save current game to persistent storage.",
-  inputSchema: z.object({ slot: saveSlotParam }),
-  when: ["playing", "gameOver"],
-  async execute(args, ctx) {
-    const game = gameSlot.get(ctx);
-    await saveState(ctx, saveSlotKey(args.slot), game);
-    return {
-      saved: true,
-      slot: args.slot ?? "autosave",
-      name: game.playerName,
-      scene: game.sceneCount,
-    };
-  },
-});

package/dist/test-BvyT6sAc.mjs

@@ -1,104 +0,0 @@
-#!/usr/bin/env node
-import { a as ok, n as fail } from "./_output-CKkmWs7i.mjs";
-import { n as log } from "./_ui-u7T4YooX.mjs";
-import { i as errorCode, o as errorMessage$1, r as binFromPackageJson } from "./_utils-B8QmtFhK.mjs";
-import { createRequire } from "node:module";
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { omitUndefined } from "@alexkroman1/aai/utils";
-import { execaSync } from "execa";
-//#region test.ts
-/**
-* `aai test` — run agent tests via vitest.
-*/
-/**
-* Resolve the agent project's own vitest binary so tests run without the
-* npx resolution overhead (and its potential network fetch of vitest).
-*
-* Resolves `vitest/package.json` from the agent directory, derives the bin
-* script, and runs it with the current Node executable. Falls back to
-* `npx vitest` only when no local install is resolvable.
-*/
-function resolveVitestCommand(cwd, resolve = createRequire(path.join(cwd, "package.json")).resolve) {
-	try {
-		const bin = binFromPackageJson(resolve("vitest/package.json"), "vitest");
-		if (bin) return {
-			cmd: process.execPath,
-			args: [bin]
-		};
-	} catch {}
-	return {
-		cmd: "npx",
-		args: ["vitest"]
-	};
-}
-/** The files `aai test` runs, in preference order. */
-const TEST_FILES = ["agent.test.ts", "agent.test.js"];
-/**
-* Run vitest over one of `candidates` in the given project directory.
-*
-* Returns `true` if it ran, `false` if none of the candidate files exists.
-* Throws on failure.
-*
-* A vitest FILTER, not an include glob: the argument is matched as a substring
-* against the paths vitest's own include globs already found, which is why the
-* candidates are named `*.test.ts` — `agent.test.ts` cannot match
-* `agent.eval.test.ts` and vice versa, so the two commands stay disjoint
-* without either one having to exclude the other's file.
-*/
-function runVitest(cwd, opts = { candidates: TEST_FILES }) {
-	const testFile = opts.candidates.find((name) => existsSync(path.join(cwd, name)));
-	if (!testFile) return false;
-	const { cmd, args } = resolveVitestCommand(cwd);
-	execaSync(cmd, [
-		...args,
-		"run",
-		"--root",
-		".",
-		...opts.extraArgs ?? [],
-		testFile
-	], {
-		cwd,
-		stdio: "inherit",
-		...omitUndefined({ env: opts.env ? {
-			...process.env,
-			...opts.env
-		} : void 0 })
-	});
-	return true;
-}
-/**
-* Classify a {@link runVitest} failure. execaSync throws an ENOENT-coded
-* error when the binary itself couldn't be spawned (infrastructure problem)
-* and an exit-code error when vitest ran and the tests failed.
-*/
-function classifyVitestError(err, label = "Tests") {
-	if (errorCode(err) === "ENOENT") return {
-		code: "spawn_failed",
-		message: `Could not launch the test runner: ${errorMessage$1(err)} — is the binary on your PATH?`
-	};
-	return {
-		code: "test_failed",
-		message: `${label} failed: ${errorMessage$1(err)}`
-	};
-}
-/** Execute agent tests and return structured result. */
-async function executeTest(cwd) {
-	log.step("Running agent tests");
-	try {
-		if (!runVitest(cwd)) {
-			log.info("No test file found. Create agent.test.ts to add tests.");
-			return ok({
-				passed: true,
-				skipped: true
-			});
-		}
-		log.success("Tests passed");
-		return ok({ passed: true });
-	} catch (err) {
-		const { code, message } = classifyVitestError(err);
-		return fail(code, message);
-	}
-}
-//#endregion
-export { classifyVitestError, executeTest, runVitest };