@alexkroman1/aai 0.7.11 → 0.8.0

package/dist/cli.js

@@ -21,6 +21,16 @@ var COLORS;
 var init_colors = __esm({
   "cli/_colors.ts"() {
     "use strict";
+    if (chalk.level === 0 && !process.env.NO_COLOR) {
+      const ct = process.env.COLORTERM;
+      if (ct === "truecolor" || ct === "24bit") {
+        chalk.level = 3;
+      } else if (ct || /-256(color)?$/i.test(process.env.TERM ?? "")) {
+        chalk.level = 2;
+      } else if (process.env.TERM_PROGRAM) {
+        chalk.level = 1;
+      }
+    }
     COLORS = {
       primary: "#fab283",
       interactive: "#56b6c2",
@@ -52,10 +62,11 @@ function rootHelp(version) {
   const cmds = [
     ["init", "[dir]", "Scaffold a new agent project"],
     ["dev", "", "Start a local development server"],
+    ["build", "", "Bundle and validate (no server or deploy)"],
     ["deploy", "", "Bundle and deploy to production"],
     ["start", "", "Start production server from build"],
     ["secret", "<cmd>", "Manage secrets"],
-    ["rag", "<url>", "Ingest a site's llms-full.txt into the vector store"]
+    ["rag", "<url>", "Ingest a site into the vector store"]
   ];
   for (const [name, args, desc] of cmds) {
     const nameStr = interactive(name.padEnd(8));
@@ -78,15 +89,9 @@ function rootHelp(version) {
   lines.push("");
   lines.push(`  ${chalk2.bold(interactive("Getting started"))}`);
   lines.push("");
-  lines.push(
-    `    ${chalk2.dim("$")} ${primary("aai init")} ${interactive("my-agent")}    ${chalk2.dim(
-      "Create a new agent"
-    )}`
-  );
-  lines.push(`    ${chalk2.dim("$")} ${primary("cd my-agent")}`);
-  lines.push(
-    `    ${chalk2.dim("$")} ${primary("aai deploy")}          ${chalk2.dim("Deploy to production")}`
-  );
+  lines.push(`    ${chalk2.dim("$")} ${primary("aai init")} ${interactive("my-agent")}`);
+  lines.push(`    ${chalk2.dim("$")} ${primary("cd")} ${interactive("my-agent")}`);
+  lines.push(`    ${chalk2.dim("$")} ${primary("aai dev")}`);
   lines.push("");
   return lines.join("\n");
 }
@@ -273,6 +278,7 @@ async function askText(message, defaultValue) {
             onSubmit: (value) => {
               resolve(value || defaultValue);
               app.unmount();
+              app.clear();
             }
           }
         )
@@ -415,57 +421,6 @@ var init_discover = __esm({
   }
 });
 
-// cli/_deploy.ts
-async function attemptDeploy(url, slug, apiKey, env, worker, clientFiles) {
-  return await _internals.fetch(`${url}/${slug}/deploy`, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${apiKey}`
-    },
-    body: JSON.stringify({
-      env,
-      worker,
-      clientFiles
-    })
-  });
-}
-async function runDeploy(opts) {
-  const worker = opts.bundle.worker;
-  const clientFiles = opts.bundle.clientFiles;
-  let slug = opts.slug;
-  if (opts.dryRun) {
-    return { slug };
-  }
-  for (let i = 0; i < MAX_RETRIES; i++) {
-    const resp = await attemptDeploy(opts.url, slug, opts.apiKey, opts.env, worker, clientFiles);
-    if (resp.ok) {
-      return { slug };
-    }
-    if (resp.status === 403) {
-      const text2 = await resp.text();
-      if (text2.includes("Slug")) {
-        slug = generateSlug();
-        continue;
-      }
-    }
-    const text = await resp.text();
-    throw new Error(`deploy failed (${resp.status}): ${text}`);
-  }
-  throw new Error(`deploy failed: could not find available slug after ${MAX_RETRIES} attempts`);
-}
-var _internals, MAX_RETRIES;
-var init_deploy = __esm({
-  "cli/_deploy.ts"() {
-    "use strict";
-    init_discover();
-    _internals = {
-      fetch: globalThis.fetch.bind(globalThis)
-    };
-    MAX_RETRIES = 20;
-  }
-});
-
 // cli/_ink.tsx
 import { Spinner } from "@inkjs/ui";
 import { Box as Box2, render as render2, Static, Text as Text2, useApp } from "ink";
@@ -490,14 +445,20 @@ function StepInfo({ action, msg }) {
   ] });
 }
 function Info({ msg }) {
-  return /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: msg });
+  return /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+    "  ",
+    msg
+  ] });
 }
 function Detail({ msg }) {
-  return /* @__PURE__ */ jsx2(Text2, { children: msg });
+  return /* @__PURE__ */ jsxs2(Text2, { children: [
+    "  ",
+    msg
+  ] });
 }
 function Warn({ msg }) {
   return /* @__PURE__ */ jsxs2(Text2, { children: [
-    /* @__PURE__ */ jsx2(Text2, { bold: true, color: COLORS.warning, children: "warning" }),
+    /* @__PURE__ */ jsx2(Text2, { bold: true, color: COLORS.warning, children: "\u25B2" }),
     /* @__PURE__ */ jsxs2(Text2, { children: [
       " ",
       msg
@@ -506,9 +467,9 @@ function Warn({ msg }) {
 }
 function ErrorLine({ msg }) {
   return /* @__PURE__ */ jsxs2(Text2, { children: [
-    /* @__PURE__ */ jsx2(Text2, { bold: true, color: COLORS.error, children: "error" }),
+    /* @__PURE__ */ jsx2(Text2, { bold: true, color: COLORS.error, children: "\u2717" }),
     /* @__PURE__ */ jsxs2(Text2, { children: [
-      ": ",
+      " ",
       msg
     ] })
   ] });
@@ -587,7 +548,7 @@ async function runWithInk(fn) {
     )
   );
   await app.waitUntilExit();
-  if (thrownError) throw thrownError;
+  if (thrownError) process.exit(1);
 }
 var init_ink = __esm({
   "cli/_ink.tsx"() {
@@ -596,6 +557,244 @@ var init_ink = __esm({
   }
 });
 
+// ui/_dom_shim.ts
+import { DOMParser } from "linkedom";
+function installDomShim() {
+  if (installed) return;
+  installed = true;
+  const doc = new DOMParser().parseFromString(
+    "<!DOCTYPE html><html><head></head><body></body></html>",
+    "text/html"
+  );
+  const g2 = globalThis;
+  g2.document = doc;
+  g2.HTMLElement = doc.documentElement.constructor;
+  if (!Object.getOwnPropertyDescriptor(
+    g2.HTMLElement.prototype,
+    "scrollIntoView"
+  )) {
+    g2.HTMLElement.prototype.scrollIntoView = () => {
+    };
+  }
+}
+var installed;
+var init_dom_shim = __esm({
+  "ui/_dom_shim.ts"() {
+    "use strict";
+    installed = false;
+  }
+});
+
+// sdk/_mock_ws.ts
+function installMockWebSocket() {
+  const saved = globalThis.WebSocket;
+  const created = [];
+  g.WebSocket = class extends MockWebSocket {
+    constructor(url, protocols) {
+      super(url, protocols);
+      created.push(this);
+    }
+  };
+  return {
+    created,
+    get lastWs() {
+      return created.at(-1) ?? null;
+    },
+    restore() {
+      globalThis.WebSocket = saved;
+    },
+    [Symbol.dispose]() {
+      globalThis.WebSocket = saved;
+    }
+  };
+}
+var MockWebSocket, g;
+var init_mock_ws = __esm({
+  "sdk/_mock_ws.ts"() {
+    "use strict";
+    MockWebSocket = class _MockWebSocket extends EventTarget {
+      // mirrors the WebSocket API
+      static CONNECTING = 0;
+      // mirrors the WebSocket API
+      static OPEN = 1;
+      // mirrors the WebSocket API
+      static CLOSING = 2;
+      // mirrors the WebSocket API
+      static CLOSED = 3;
+      readyState = _MockWebSocket.CONNECTING;
+      binaryType = "arraybuffer";
+      /** All messages passed to {@linkcode send}, in order. */
+      sent = [];
+      url;
+      /**
+       * Create a new MockWebSocket.
+       *
+       * Automatically transitions to `OPEN` state on the next microtask,
+       * dispatching an `"open"` event.
+       *
+       * @param url - The WebSocket URL.
+       * @param _protocols - Ignored; accepted for API compatibility.
+       */
+      constructor(url, _protocols) {
+        super();
+        this.url = typeof url === "string" ? url : url.toString();
+        queueMicrotask(() => {
+          if (this.readyState === _MockWebSocket.CONNECTING) {
+            this.readyState = _MockWebSocket.OPEN;
+            this.dispatchEvent(new Event("open"));
+          }
+        });
+      }
+      /**
+       * Record a sent message without transmitting it.
+       *
+       * @param data - The message data to record.
+       */
+      send(data) {
+        this.sent.push(data);
+      }
+      /**
+       * Transition to `CLOSED` state and dispatch a `"close"` event.
+       *
+       * @param code - The close code (defaults to 1000).
+       * @param _reason - Ignored; accepted for API compatibility.
+       */
+      close(code, _reason) {
+        this.readyState = _MockWebSocket.CLOSED;
+        this.dispatchEvent(new CloseEvent("close", { code: code ?? 1e3 }));
+      }
+      /**
+       * Simulate receiving a message from the server.
+       *
+       * @param data - The message data (string or binary).
+       */
+      simulateMessage(data) {
+        this.dispatchEvent(new MessageEvent("message", { data }));
+      }
+      /** Transition to `OPEN` state and dispatch an `"open"` event. */
+      open() {
+        this.readyState = _MockWebSocket.OPEN;
+        this.dispatchEvent(new Event("open"));
+      }
+      /**
+       * Shorthand for {@linkcode simulateMessage}.
+       *
+       * @param data - The message data to dispatch.
+       */
+      msg(data) {
+        this.dispatchEvent(new MessageEvent("message", { data }));
+      }
+      /**
+       * Simulate a connection close from the server.
+       *
+       * @param code - The close code (defaults to 1000).
+       */
+      disconnect(code = 1e3) {
+        this.dispatchEvent(new CloseEvent("close", { code }));
+      }
+      /** Dispatch an `"error"` event on this socket. */
+      error() {
+        this.dispatchEvent(new Event("error"));
+      }
+      /**
+       * Return all sent string messages parsed as JSON objects.
+       *
+       * Binary messages are filtered out.
+       *
+       * @returns An array of parsed JSON objects from sent string messages.
+       */
+      sentJson() {
+        return this.sent.filter((d) => typeof d === "string").map((s) => JSON.parse(s));
+      }
+    };
+    g = globalThis;
+  }
+});
+
+// sdk/_render_check.ts
+var render_check_exports = {};
+__export(render_check_exports, {
+  renderCheck: () => renderCheck
+});
+import { createServer as createViteServer } from "vite";
+async function renderCheck(clientEntry, cwd) {
+  installDomShim();
+  const g2 = globalThis;
+  const doc = new DOMParser().parseFromString(
+    '<!DOCTYPE html><html><head></head><body><main id="app"></main></body></html>',
+    "text/html"
+  );
+  const prevDoc = g2.document;
+  const prevLocation = g2.location;
+  g2.document = doc;
+  g2.location = { origin: "http://localhost:3000", pathname: "/", href: "http://localhost:3000/" };
+  const mock = installMockWebSocket();
+  const vite = await createViteServer({
+    root: cwd,
+    logLevel: "silent",
+    server: { middlewareMode: true }
+  });
+  try {
+    await vite.ssrLoadModule(clientEntry);
+    const app = doc.querySelector("#app");
+    if (!app?.innerHTML) {
+      throw new Error("client.tsx render check failed: #app is empty after mount()");
+    }
+  } finally {
+    await vite.close();
+    mock.restore();
+    g2.document = prevDoc;
+    g2.location = prevLocation;
+  }
+}
+var init_render_check = __esm({
+  "sdk/_render_check.ts"() {
+    "use strict";
+    init_dom_shim();
+    init_mock_ws();
+  }
+});
+
+// cli/_build.ts
+import React2 from "react";
+async function buildAgentBundle(cwd, log) {
+  const agent = await loadAgent(cwd);
+  if (!agent) {
+    throw new Error("No agent found \u2014 run `aai init` first");
+  }
+  log(React2.createElement(Step, { action: "Bundle", msg: agent.slug }));
+  let bundle;
+  try {
+    bundle = await bundleAgent(agent);
+  } catch (err) {
+    if (err instanceof BundleError) {
+      throw new Error(`Bundle failed: ${err.message}`);
+    }
+    throw err;
+  }
+  const kb = (bundle.workerBytes / 1024).toFixed(1);
+  const clientCount = Object.keys(bundle.clientFiles).length;
+  log(React2.createElement(Info, { msg: `worker: ${kb} KB, client: ${clientCount} file(s)` }));
+  if (agent.clientEntry) {
+    log(React2.createElement(Step, { action: "Render", msg: "check" }));
+    try {
+      const { renderCheck: renderCheck2 } = await Promise.resolve().then(() => (init_render_check(), render_check_exports));
+      await renderCheck2(agent.clientEntry, cwd);
+    } catch (err) {
+      throw new Error(`Render check failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return bundle;
+}
+var init_build = __esm({
+  "cli/_build.ts"() {
+    "use strict";
+    init_bundler();
+    init_discover();
+    init_ink();
+  }
+});
+
 // cli/_init.ts
 var init_exports = {};
 __export(init_exports, {
@@ -684,19 +883,163 @@ var init_init = __esm({
   }
 });
 
+// cli/_deploy.ts
+async function attemptDeploy(url, slug, apiKey, env, worker, clientFiles) {
+  try {
+    return await _internals.fetch(`${url}/${slug}/deploy`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`
+      },
+      body: JSON.stringify({
+        env,
+        worker,
+        clientFiles
+      })
+    });
+  } catch {
+    throw new Error(`deployment failed: could not reach ${url}`);
+  }
+}
+async function runDeploy(opts) {
+  const worker = opts.bundle.worker;
+  const clientFiles = opts.bundle.clientFiles;
+  let slug = opts.slug;
+  if (opts.dryRun) {
+    return { slug };
+  }
+  for (let i = 0; i < MAX_RETRIES; i++) {
+    const resp = await attemptDeploy(opts.url, slug, opts.apiKey, opts.env, worker, clientFiles);
+    if (resp.ok) {
+      return { slug };
+    }
+    if (resp.status === 403) {
+      const text2 = await resp.text();
+      if (text2.includes("Slug")) {
+        slug = generateSlug();
+        continue;
+      }
+    }
+    const text = await resp.text();
+    throw new Error(`deploy failed (${resp.status}): ${text}`);
+  }
+  throw new Error(`deploy failed: could not find available slug after ${MAX_RETRIES} attempts`);
+}
+var _internals, MAX_RETRIES;
+var init_deploy = __esm({
+  "cli/_deploy.ts"() {
+    "use strict";
+    init_discover();
+    _internals = {
+      fetch: globalThis.fetch.bind(globalThis)
+    };
+    MAX_RETRIES = 20;
+  }
+});
+
+// cli/deploy.tsx
+var deploy_exports = {};
+__export(deploy_exports, {
+  runDeployCommand: () => runDeployCommand
+});
+import path4 from "node:path";
+import minimist from "minimist";
+import { jsx as jsx3 } from "react/jsx-runtime";
+function resolveServerUrl(parsed) {
+  return parsed.server || (isDevMode() ? "http://localhost:3100" : DEFAULT_SERVER);
+}
+async function deployBundle(opts) {
+  const { bundle, serverUrl, apiKey, cwd, log } = opts;
+  let { slug } = opts;
+  log(/* @__PURE__ */ jsx3(Step, { action: "Deploy", msg: slug }));
+  const deployed = await runDeploy({
+    url: serverUrl,
+    bundle,
+    env: { ASSEMBLYAI_API_KEY: apiKey },
+    slug,
+    dryRun: false,
+    apiKey
+  });
+  slug = deployed.slug;
+  await writeProjectConfig(cwd, { slug, serverUrl });
+  const agentUrl = `${serverUrl}/${slug}`;
+  log(/* @__PURE__ */ jsx3(Step, { action: "Ready", msg: agentUrl }));
+  return agentUrl;
+}
+async function runDeployCommand(args, version) {
+  const parsed = minimist(args, {
+    string: ["server"],
+    boolean: ["dry-run", "help", "yes"],
+    alias: { s: "server", h: "help", y: "yes" }
+  });
+  if (parsed.help) {
+    console.log(subcommandHelp(deployCommandDef, version));
+    return;
+  }
+  const cwd = process.env.INIT_CWD || process.cwd();
+  if (!await fileExists(path4.join(cwd, "agent.ts"))) {
+    await runInitCommand(parsed.yes ? ["-y"] : [], version, { quiet: true });
+  }
+  const serverUrl = resolveServerUrl(parsed);
+  const dryRun = parsed["dry-run"] ?? false;
+  const apiKey = dryRun ? "" : await getApiKey();
+  const projectConfig = await readProjectConfig(cwd);
+  const slug = projectConfig?.slug ?? generateSlug();
+  let agentUrl = "";
+  await runWithInk(async (log) => {
+    const bundle = await buildAgentBundle(cwd, log);
+    if (dryRun) {
+      log(/* @__PURE__ */ jsx3(StepInfo, { action: "Dry run", msg: `would deploy as ${slug}` }));
+      return;
+    }
+    agentUrl = await deployBundle({ bundle, serverUrl, apiKey, slug, cwd, log });
+  });
+  if (agentUrl && !dryRun) {
+    await askEnter("Press enter to open in browser");
+    const { exec } = await import("node:child_process");
+    exec(`open "${agentUrl}"`);
+  }
+}
+var deployCommandDef;
+var init_deploy2 = __esm({
+  "cli/deploy.tsx"() {
+    "use strict";
+    init_build();
+    init_deploy();
+    init_discover();
+    init_help();
+    init_ink();
+    init_prompts();
+    init_init2();
+    deployCommandDef = {
+      name: "deploy",
+      description: "Bundle and deploy to production",
+      options: [
+        { flags: "-s, --server <url>", description: "Server URL" },
+        {
+          flags: "--dry-run",
+          description: "Validate and bundle without deploying"
+        },
+        { flags: "-y, --yes", description: "Accept defaults (no prompts)" }
+      ]
+    };
+  }
+});
+
 // cli/init.tsx
 import { execFile } from "node:child_process";
 import fs4 from "node:fs/promises";
-import path4 from "node:path";
+import path5 from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
-import minimist from "minimist";
-import { jsx as jsx3 } from "react/jsx-runtime";
+import minimist2 from "minimist";
+import { jsx as jsx4 } from "react/jsx-runtime";
 async function rewriteDevDeps(cwd, cliDir2) {
-  const monorepoRoot = path4.join(cliDir2, "..");
-  const pkgJsonPath2 = path4.join(cwd, "package.json");
+  const monorepoRoot = path5.join(cliDir2, "..");
+  const pkgJsonPath2 = path5.join(cwd, "package.json");
   const pkgJson2 = JSON.parse(await fs4.readFile(pkgJsonPath2, "utf-8"));
-  const rootPkg = JSON.parse(await fs4.readFile(path4.join(monorepoRoot, "package.json"), "utf-8"));
+  const rootPkg = JSON.parse(await fs4.readFile(path5.join(monorepoRoot, "package.json"), "utf-8"));
   const rootPkgName = rootPkg.name;
   if (pkgJson2.dependencies[rootPkgName]) {
     pkgJson2.dependencies[rootPkgName] = `file:${monorepoRoot}`;
@@ -705,29 +1048,29 @@ async function rewriteDevDeps(cwd, cliDir2) {
 `);
 }
 async function installDeps(cwd, log) {
-  if (await fileExists(path4.join(cwd, "node_modules"))) return;
+  if (await fileExists(path5.join(cwd, "node_modules"))) return;
   let pkgJson2;
   try {
-    pkgJson2 = JSON.parse(await fs4.readFile(path4.join(cwd, "package.json"), "utf-8"));
+    pkgJson2 = JSON.parse(await fs4.readFile(path5.join(cwd, "package.json"), "utf-8"));
   } catch {
     pkgJson2 = {};
   }
   const deps = Object.keys(pkgJson2.dependencies ?? {});
   const devDeps = Object.keys(pkgJson2.devDependencies ?? {});
   if (deps.length > 0) {
-    log(/* @__PURE__ */ jsx3(Step, { action: "Install", msg: deps.join(", ") }));
+    log(/* @__PURE__ */ jsx4(Step, { action: "Install", msg: deps.join(", ") }));
   }
   if (devDeps.length > 0) {
-    log(/* @__PURE__ */ jsx3(Step, { action: "Install", msg: `dev: ${devDeps.join(", ")}` }));
+    log(/* @__PURE__ */ jsx4(Step, { action: "Install", msg: `dev: ${devDeps.join(", ")}` }));
   }
   try {
     await execFileAsync("npm", ["install"], { cwd });
   } catch {
-    log(/* @__PURE__ */ jsx3(Step, { action: "Skip", msg: "npm install failed" }));
+    log(/* @__PURE__ */ jsx4(Warn, { msg: "npm install failed" }));
   }
 }
 async function runInitCommand(args, version, opts) {
-  const parsed = minimist(args, {
+  const parsed = minimist2(args, {
     string: ["template"],
     boolean: ["force", "help"],
     alias: { t: "template", f: "force", h: "help" }
@@ -742,19 +1085,19 @@ async function runInitCommand(args, version, opts) {
   if (!dir) {
     dir = await askText("What is your project named?", "my-voice-agent");
   }
-  const cwd = path4.resolve(process.env.INIT_CWD || process.cwd(), dir);
-  if (!parsed.force && await fileExists(path4.join(cwd, "agent.ts"))) {
+  const cwd = path5.resolve(process.env.INIT_CWD || process.cwd(), dir);
+  if (!parsed.force && await fileExists(path5.join(cwd, "agent.ts"))) {
     console.log(
       `agent.ts already exists in this directory. Use ${interactive("--force")} to overwrite.`
     );
     process.exit(1);
   }
-  const cliDir2 = path4.dirname(fileURLToPath(import.meta.url));
-  const templatesDir = path4.join(cliDir2, "..", "templates");
+  const cliDir2 = path5.dirname(fileURLToPath(import.meta.url));
+  const templatesDir = path5.join(cliDir2, "..", "templates");
   const { runInit: runInit2 } = await Promise.resolve().then(() => (init_init(), init_exports));
   const template = parsed.template || "simple";
   await runWithInk(async (log) => {
-    log(/* @__PURE__ */ jsx3(Step, { action: "Create", msg: dir }));
+    log(/* @__PURE__ */ jsx4(Step, { action: "Create", msg: dir }));
     await runInit2({ targetDir: cwd, template, templatesDir });
     if (isDevMode()) {
       await rewriteDevDeps(cwd, cliDir2);
@@ -794,112 +1137,6 @@ var init_init2 = __esm({
   }
 });
 
-// cli/deploy.tsx
-var deploy_exports = {};
-__export(deploy_exports, {
-  runDeployCommand: () => runDeployCommand
-});
-import path5 from "node:path";
-import minimist2 from "minimist";
-import { jsx as jsx4 } from "react/jsx-runtime";
-function resolveServerUrl(parsed) {
-  return parsed.server || (isDevMode() ? "http://localhost:3100" : DEFAULT_SERVER);
-}
-async function buildAgent(cwd, log) {
-  log(/* @__PURE__ */ jsx4(Step, { action: "Build", msg: "bundling agent" }));
-  const agent = await loadAgent(cwd);
-  if (!agent) {
-    throw new Error("No agent found \u2014 run `aai init` first");
-  }
-  let bundle;
-  try {
-    bundle = await bundleAgent(agent);
-  } catch (err) {
-    if (err instanceof BundleError) {
-      throw new Error(`Bundle failed: ${err.message}`);
-    }
-    throw err;
-  }
-  return bundle;
-}
-async function deployBundle(opts) {
-  const { bundle, serverUrl, apiKey, cwd, log } = opts;
-  let { slug } = opts;
-  log(/* @__PURE__ */ jsx4(Step, { action: "Deploy", msg: slug }));
-  const deployed = await runDeploy({
-    url: serverUrl,
-    bundle,
-    env: { ASSEMBLYAI_API_KEY: apiKey },
-    slug,
-    dryRun: false,
-    apiKey
-  });
-  slug = deployed.slug;
-  await writeProjectConfig(cwd, { slug, serverUrl });
-  const agentUrl = `${serverUrl}/${slug}`;
-  log(/* @__PURE__ */ jsx4(Step, { action: "Ready", msg: agentUrl }));
-  return agentUrl;
-}
-async function runDeployCommand(args, version) {
-  const parsed = minimist2(args, {
-    string: ["server"],
-    boolean: ["dry-run", "help", "yes"],
-    alias: { s: "server", h: "help", y: "yes" }
-  });
-  if (parsed.help) {
-    console.log(subcommandHelp(deployCommandDef, version));
-    return;
-  }
-  const cwd = process.env.INIT_CWD || process.cwd();
-  if (!await fileExists(path5.join(cwd, "agent.ts"))) {
-    await runInitCommand(parsed.yes ? ["-y"] : [], version, { quiet: true });
-  }
-  const serverUrl = resolveServerUrl(parsed);
-  const dryRun = parsed["dry-run"] ?? false;
-  const apiKey = dryRun ? "" : await getApiKey();
-  const projectConfig = await readProjectConfig(cwd);
-  const slug = projectConfig?.slug ?? generateSlug();
-  let agentUrl = "";
-  await runWithInk(async (log) => {
-    const bundle = await buildAgent(cwd, log);
-    if (dryRun) {
-      log(/* @__PURE__ */ jsx4(StepInfo, { action: "Dry run", msg: `would deploy as ${slug}` }));
-      return;
-    }
-    agentUrl = await deployBundle({ bundle, serverUrl, apiKey, slug, cwd, log });
-  });
-  if (agentUrl && !dryRun) {
-    await askEnter("Press enter to open in browser");
-    const { exec } = await import("node:child_process");
-    exec(`open "${agentUrl}"`);
-  }
-}
-var deployCommandDef;
-var init_deploy2 = __esm({
-  "cli/deploy.tsx"() {
-    "use strict";
-    init_bundler();
-    init_deploy();
-    init_discover();
-    init_help();
-    init_ink();
-    init_prompts();
-    init_init2();
-    deployCommandDef = {
-      name: "deploy",
-      description: "Bundle and deploy to production",
-      options: [
-        { flags: "-s, --server <url>", description: "Server URL" },
-        {
-          flags: "--dry-run",
-          description: "Validate and bundle without deploying"
-        },
-        { flags: "-y, --yes", description: "Accept defaults (no prompts)" }
-      ]
-    };
-  }
-});
-
 // sdk/protocol.ts
 import { z } from "zod";
 var DEFAULT_TTS_SAMPLE_RATE, AUDIO_FORMAT, _bitsPerSample, _channels, AudioFrameSpec, KvRequestBaseSchema, HOOK_TIMEOUT_MS, SessionErrorCodeSchema, TranscriptEventSchema, ClientEventSchema, ClientMessageSchema;
@@ -965,6 +1202,7 @@ var init_protocol = __esm({
         turnOrder: z.number().int().nonnegative().optional()
       }),
       z.object({ type: z.literal("chat"), text: z.string() }),
+      z.object({ type: z.literal("chat_delta"), text: z.string() }),
       z.object({
         type: z.literal("tool_call_start"),
         toolCallId: z.string(),
@@ -1058,9 +1296,86 @@ var init_internal_types = __esm({
   }
 });
 
+// sdk/types.ts
+function tool(def) {
+  return def;
+}
+var DEFAULT_INSTRUCTIONS;
+var init_types = __esm({
+  "sdk/types.ts"() {
+    "use strict";
+    DEFAULT_INSTRUCTIONS = `You are AAI, a helpful AI assistant.
+
+Voice-First Rules:
+- Optimize for natural speech. Avoid jargon unless central to the answer. Use short, punchy sentences.
+- Never mention "search results," "sources," or "the provided text." Speak as if the knowledge is your own.
+- No visual formatting. Do not say "bullet point," "bold," or "bracketed one." If you need to list items, say "First," "Next," and "Finally."
+- Start with the most important information. No introductory filler.
+- Be concise. Keep answers to 1-3 sentences. For complex topics, provide a high-level summary.
+- Be confident. Avoid hedging phrases like "It seems that" or "I believe."
+- If you don't have enough information, say so directly rather than guessing.
+- Never use exclamation points. Keep your tone calm and conversational.`;
+  }
+});
+
+// sdk/memory_tools.ts
+import { z as z3 } from "zod";
+function memoryTools() {
+  return {
+    save_memory: tool({
+      description: "Save a piece of information to persistent memory. Use a descriptive key like 'user:name' or 'project:status'.",
+      parameters: z3.object({
+        key: z3.string().describe("A descriptive key for this memory (e.g. 'user:name', 'preference:color')"),
+        value: z3.string().describe("The information to remember")
+      }),
+      execute: async ({ key, value }, ctx) => {
+        await ctx.kv.set(key, value);
+        return { saved: key };
+      }
+    }),
+    recall_memory: tool({
+      description: "Retrieve a previously saved memory by its key.",
+      parameters: z3.object({
+        key: z3.string().describe("The key to look up")
+      }),
+      execute: async ({ key }, ctx) => {
+        const value = await ctx.kv.get(key);
+        if (value === null) return { found: false, key };
+        return { found: true, key, value };
+      }
+    }),
+    list_memories: tool({
+      description: "List all saved memory keys, optionally filtered by a prefix (e.g. 'user:').",
+      parameters: z3.object({
+        prefix: z3.string().describe("Prefix to filter keys (e.g. 'user:'). Use empty string for all.").optional()
+      }),
+      execute: async ({ prefix }, ctx) => {
+        const entries = await ctx.kv.list(prefix ?? "");
+        return { count: entries.length, keys: entries.map((e) => e.key) };
+      }
+    }),
+    forget_memory: tool({
+      description: "Delete a previously saved memory by its key.",
+      parameters: z3.object({
+        key: z3.string().describe("The key to delete")
+      }),
+      execute: async ({ key }, ctx) => {
+        await ctx.kv.delete(key);
+        return { deleted: key };
+      }
+    })
+  };
+}
+var init_memory_tools = __esm({
+  "sdk/memory_tools.ts"() {
+    "use strict";
+    init_types();
+  }
+});
+
 // sdk/builtin_tools.ts
 import { convert } from "html-to-text";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 function htmlToText(html) {
   return convert(html, { wordwrap: false });
 }
@@ -1213,12 +1528,27 @@ function getBuiltinToolDefs(names, opts) {
           defs[name] = createVectorSearch(opts.vectorSearch);
         }
         break;
+      case "memory": {
+        const mt = memoryTools();
+        for (const [toolName, toolDef] of Object.entries(mt)) {
+          defs[toolName] = toolDef;
+        }
+        break;
+      }
     }
   }
   return defs;
 }
 function getBuiltinToolSchemas(names) {
   return names.flatMap((name) => {
+    const multiCreator = MULTI_TOOL_BUILTINS[name];
+    if (multiCreator) {
+      return Object.entries(multiCreator()).map(([toolName, def2]) => ({
+        name: toolName,
+        description: def2.description,
+        parameters: z4.toJSONSchema(def2.parameters ?? EMPTY_PARAMS)
+      }));
+    }
     const creator = TOOL_CREATORS[name];
     if (!creator) return [];
     const def = creator();
@@ -1226,49 +1556,50 @@ function getBuiltinToolSchemas(names) {
       {
         name,
         description: def.description,
-        parameters: z3.toJSONSchema(def.parameters ?? EMPTY_PARAMS)
+        parameters: z4.toJSONSchema(def.parameters ?? EMPTY_PARAMS)
       }
     ];
   });
 }
-var webSearchParams, BRAVE_SEARCH_URL, BraveSearchResponseSchema, MAX_PAGE_CHARS, MAX_HTML_BYTES, visitWebpageParams, fetchJsonParams, runCodeParams, vectorSearchParams, TOOL_CREATORS;
+var webSearchParams, BRAVE_SEARCH_URL, BraveSearchResponseSchema, MAX_PAGE_CHARS, MAX_HTML_BYTES, visitWebpageParams, fetchJsonParams, runCodeParams, vectorSearchParams, TOOL_CREATORS, MULTI_TOOL_BUILTINS;
 var init_builtin_tools = __esm({
   "sdk/builtin_tools.ts"() {
     "use strict";
     init_internal_types();
-    webSearchParams = z3.object({
-      query: z3.string().describe("The search query"),
-      max_results: z3.number().describe("Maximum number of results to return (default 5)").optional()
+    init_memory_tools();
+    webSearchParams = z4.object({
+      query: z4.string().describe("The search query"),
+      max_results: z4.number().describe("Maximum number of results to return (default 5)").optional()
     });
     BRAVE_SEARCH_URL = "https://api.search.brave.com/res/v1/web/search";
-    BraveSearchResponseSchema = z3.object({
-      web: z3.object({
-        results: z3.array(
-          z3.object({
-            title: z3.string(),
-            url: z3.string(),
-            description: z3.string()
+    BraveSearchResponseSchema = z4.object({
+      web: z4.object({
+        results: z4.array(
+          z4.object({
+            title: z4.string(),
+            url: z4.string(),
+            description: z4.string()
           })
         )
       }).optional()
     });
     MAX_PAGE_CHARS = 1e4;
     MAX_HTML_BYTES = 2e5;
-    visitWebpageParams = z3.object({
-      url: z3.string().describe("The full URL to fetch (e.g., 'https://example.com/page')")
+    visitWebpageParams = z4.object({
+      url: z4.string().describe("The full URL to fetch (e.g., 'https://example.com/page')")
     });
-    fetchJsonParams = z3.object({
-      url: z3.string().describe("The URL to fetch JSON from"),
-      headers: z3.record(z3.string(), z3.string()).describe("Optional HTTP headers to include in the request").optional()
+    fetchJsonParams = z4.object({
+      url: z4.string().describe("The URL to fetch JSON from"),
+      headers: z4.record(z4.string(), z4.string()).describe("Optional HTTP headers to include in the request").optional()
     });
-    runCodeParams = z3.object({
-      code: z3.string().describe("JavaScript code to execute. Use console.log() for output.")
+    runCodeParams = z4.object({
+      code: z4.string().describe("JavaScript code to execute. Use console.log() for output.")
     });
-    vectorSearchParams = z3.object({
-      query: z3.string().describe(
+    vectorSearchParams = z4.object({
+      query: z4.string().describe(
         'Short keyword query to search the knowledge base. Use specific topic terms, not full sentences. Do NOT include the company or product name since all documents are from the same source. For example, if the user asks "how much does Acme cost", search for "pricing plans rates".'
       ),
-      topK: z3.number().describe("Maximum results to return (default: 5)").optional()
+      topK: z4.number().describe("Maximum results to return (default: 5)").optional()
     });
     TOOL_CREATORS = {
       web_search: createWebSearch,
@@ -1278,6 +1609,9 @@ var init_builtin_tools = __esm({
       // vector_search uses a stub for schema generation
       vector_search: () => createVectorSearch(async () => "")
     };
+    MULTI_TOOL_BUILTINS = {
+      memory: memoryTools
+    };
   }
 });
 
@@ -1348,7 +1682,7 @@ var init_kv = __esm({
 });
 
 // sdk/s2s.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 function uint8ToBase64(bytes) {
   return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64");
 }
@@ -1486,7 +1820,9 @@ function connectS2s(opts) {
         }
       },
       sendToolResult(callId, result) {
-        send({ type: "tool.result", call_id: callId, result });
+        const msg = { type: "tool.result", call_id: callId, result };
+        log.debug("S2S >> tool.result", { call_id: callId, resultLength: result.length });
+        send(msg);
       },
       updateSession(sessionConfig) {
         send({ type: "session.update", session: sessionConfig });
@@ -1516,6 +1852,9 @@ function connectS2s(opts) {
         return;
       }
       const obj = raw;
+      if (obj.type !== "reply.audio" && obj.type !== "input.audio" && obj.type !== "transcript.agent.delta") {
+        log.info(`S2S << ${obj.type}`);
+      }
       if (obj.type === "reply.audio" && typeof obj.data === "string") {
         const audioBytes = base64ToUint8(obj.data);
         target.dispatchEvent(new CustomEvent("audio", { detail: { audio: audioBytes } }));
@@ -1523,13 +1862,12 @@ function connectS2s(opts) {
       }
       const parsed = S2sServerMessageSchema.safeParse(raw);
       if (!parsed.success) {
-        log.debug(
-          `S2S << unrecognised message type: ${obj.type ?? JSON.stringify(raw).slice(0, 100)}`
+        log.warn(
+          `S2S << unrecognised message type: ${obj.type ?? JSON.stringify(raw).slice(0, 200)}`
         );
         return;
       }
       const msg = parsed.data;
-      log.debug(`S2S << ${msg.type}`);
       dispatchS2sMessage(target, msg);
     });
     ws.on("close", (code, reason) => {
@@ -1560,66 +1898,47 @@ var init_s2s = __esm({
     "use strict";
     init_runtime();
     WS_OPEN = 1;
-    S2sServerMessageSchema = z4.discriminatedUnion("type", [
-      z4.object({ type: z4.literal("session.ready"), session_id: z4.string() }),
-      z4.object({ type: z4.literal("session.updated") }).passthrough(),
-      z4.object({ type: z4.literal("input.speech.started") }),
-      z4.object({ type: z4.literal("input.speech.stopped") }),
-      z4.object({ type: z4.literal("transcript.user.delta"), text: z4.string() }),
-      z4.object({
-        type: z4.literal("transcript.user"),
-        item_id: z4.string(),
-        text: z4.string()
+    S2sServerMessageSchema = z5.discriminatedUnion("type", [
+      z5.object({ type: z5.literal("session.ready"), session_id: z5.string() }),
+      z5.object({ type: z5.literal("session.updated") }).passthrough(),
+      z5.object({ type: z5.literal("input.speech.started") }),
+      z5.object({ type: z5.literal("input.speech.stopped") }),
+      z5.object({ type: z5.literal("transcript.user.delta"), text: z5.string() }),
+      z5.object({
+        type: z5.literal("transcript.user"),
+        item_id: z5.string(),
+        text: z5.string()
       }),
-      z4.object({ type: z4.literal("reply.started"), reply_id: z4.string() }),
+      z5.object({ type: z5.literal("reply.started"), reply_id: z5.string() }),
       // reply.audio is handled on the fast path before Zod — see message handler.
-      z4.object({ type: z4.literal("transcript.agent.delta"), delta: z4.string() }).passthrough(),
-      z4.object({ type: z4.literal("transcript.agent"), text: z4.string() }),
-      z4.object({ type: z4.literal("reply.content_part.started") }).passthrough(),
-      z4.object({ type: z4.literal("reply.content_part.done") }).passthrough(),
-      z4.object({
-        type: z4.literal("tool.call"),
-        call_id: z4.string(),
-        name: z4.string(),
-        args: z4.record(z4.string(), z4.unknown()).optional().default({})
+      z5.object({ type: z5.literal("transcript.agent.delta"), delta: z5.string() }).passthrough(),
+      z5.object({ type: z5.literal("transcript.agent"), text: z5.string() }),
+      z5.object({ type: z5.literal("reply.content_part.started") }).passthrough(),
+      z5.object({ type: z5.literal("reply.content_part.done") }).passthrough(),
+      z5.object({
+        type: z5.literal("tool.call"),
+        call_id: z5.string(),
+        name: z5.string(),
+        args: z5.record(z5.string(), z5.unknown()).optional().default({})
       }),
-      z4.object({
-        type: z4.literal("reply.done"),
-        status: z4.string().optional()
+      z5.object({
+        type: z5.literal("reply.done"),
+        status: z5.string().optional()
       }),
-      z4.object({
-        type: z4.literal("session.error"),
-        code: z4.string(),
-        message: z4.string()
+      z5.object({
+        type: z5.literal("session.error"),
+        code: z5.string(),
+        message: z5.string()
       }),
       // Connection-level error (bare "error" without "session." prefix).
-      z4.object({
-        type: z4.literal("error"),
-        message: z4.string()
+      z5.object({
+        type: z5.literal("error"),
+        message: z5.string()
       })
     ]);
   }
 });
 
-// sdk/types.ts
-var DEFAULT_INSTRUCTIONS;
-var init_types = __esm({
-  "sdk/types.ts"() {
-    "use strict";
-    DEFAULT_INSTRUCTIONS = `You are AAI, a helpful AI assistant.
-
-Voice-First Rules:
-- Optimize for natural speech. Avoid jargon unless central to the answer. Use short, punchy sentences.
-- Never mention "search results," "sources," or "the provided text." Speak as if the knowledge is your own.
-- No visual formatting. Do not say "bullet point," "bold," or "bracketed one." If you need to list items, say "First," "Next," and "Finally."
-- Start with the most important information. No introductory filler.
-- Be concise. Keep answers to 1-3 sentences. For complex topics, provide a high-level summary.
-- Be confident. Avoid hedging phrases like "It seems that" or "I believe."
-- If you don't have enough information, say so directly rather than guessing.
-- Never use exclamation points. Keep your tone calm and conversational.`;
-  }
-});
-
 // sdk/system_prompt.ts
 function buildSystemPrompt(config, opts) {
   const { hasTools } = opts;
@@ -1822,6 +2141,9 @@ function createS2sSession(opts) {
       on(handle, "audio", (e) => {
         client.playAudioChunk(e.detail.audio);
       });
+      on(handle, "agent_transcript_delta", (e) => {
+        client.event({ type: "chat_delta", text: e.detail.text });
+      });
       on(handle, "agent_transcript", (e) => {
         const { text } = e.detail;
         client.event({ type: "chat", text });
@@ -1841,8 +2163,8 @@ function createS2sSession(opts) {
           pendingTools = [];
           client.event({ type: "cancelled" });
         } else if (pendingTools.length > 0) {
-          for (const tool of pendingTools) {
-            s2s?.sendToolResult(tool.call_id, tool.result);
+          for (const tool2 of pendingTools) {
+            s2s?.sendToolResult(tool2.call_id, tool2.result);
           }
           pendingTools = [];
         } else {
@@ -1860,6 +2182,7 @@ function createS2sSession(opts) {
           code: "internal",
           message: e.detail.message
         });
+        handle.close();
       });
       handle.addEventListener("close", () => {
         log.info("S2S closed");
@@ -2023,8 +2346,8 @@ function buildToolContext(opts) {
   };
 }
 async function executeToolCall(name, args, options) {
-  const { tool } = options;
-  const schema = tool.parameters ?? EMPTY_PARAMS;
+  const { tool: tool2 } = options;
+  const schema = tool2.parameters ?? EMPTY_PARAMS;
   const parsed = schema.safeParse(args);
   if (!parsed.success) {
     const issues = (parsed.error?.issues ?? []).map((i) => `${i.path.map(String).join(".")}: ${i.message}`).join(", ");
@@ -2033,7 +2356,7 @@ async function executeToolCall(name, args, options) {
   try {
     const ctx = buildToolContext(options);
     await yieldTick();
-    const result = await Promise.resolve(tool.execute(parsed.data, ctx));
+    const result = await Promise.resolve(tool2.execute(parsed.data, ctx));
     await yieldTick();
     if (result == null) return "null";
     return typeof result === "string" ? result : JSON.stringify(result);
@@ -2061,8 +2384,7 @@ function buildAgentConfig(agent) {
   const config = {
     name: agent.name,
     instructions: agent.instructions,
-    greeting: agent.greeting,
-    voice: agent.voice
+    greeting: agent.greeting
   };
   if (agent.sttPrompt !== void 0) config.sttPrompt = agent.sttPrompt;
   if (typeof agent.maxSteps !== "function") config.maxSteps = agent.maxSteps;
@@ -2117,10 +2439,10 @@ function createDirectExecutor(opts) {
     };
   }
   const executeTool = async (name, args, sessionId, messages) => {
-    const tool = allTools[name];
-    if (!tool) return JSON.stringify({ error: `Unknown tool: ${name}` });
+    const tool2 = allTools[name];
+    if (!tool2) return JSON.stringify({ error: `Unknown tool: ${name}` });
     return executeToolCall(name, args, {
-      tool,
+      tool: tool2,
       env: frozenEnv,
       sessionId,
       state: getState(sessionId ?? ""),
@@ -2590,30 +2912,64 @@ var init_server = __esm({
 
 // cli/cli.ts
 init_help();
-init_deploy2();
 import { readFileSync } from "node:fs";
-import path10 from "node:path";
+import path11 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-import minimist7 from "minimist";
+import minimist8 from "minimist";
 
-// cli/dev.tsx
-import path7 from "node:path";
+// cli/build.tsx
+init_build();
+init_discover();
+init_help();
+init_ink();
+init_init2();
+import path6 from "node:path";
 import minimist3 from "minimist";
+import { jsx as jsx5 } from "react/jsx-runtime";
+var buildCommandDef = {
+  name: "build",
+  description: "Bundle agent and client (validates code without deploying or starting a server)",
+  options: [{ flags: "-y, --yes", description: "Accept defaults (no prompts)" }]
+};
+async function runBuildCommand(args, version) {
+  const parsed = minimist3(args, {
+    boolean: ["help", "yes"],
+    alias: { h: "help", y: "yes" }
+  });
+  if (parsed.help) {
+    console.log(subcommandHelp(buildCommandDef, version));
+    return;
+  }
+  const cwd = process.env.INIT_CWD || process.cwd();
+  if (!await fileExists(path6.join(cwd, "agent.ts"))) {
+    await runInitCommand(parsed.yes ? ["-y"] : [], version, { quiet: true });
+  }
+  await runWithInk(async (log) => {
+    await buildAgentBundle(cwd, log);
+    log(/* @__PURE__ */ jsx5(Step, { action: "Build", msg: "ok" }));
+  });
+}
+
+// cli/cli.ts
+init_deploy2();
+
+// cli/dev.tsx
+import path8 from "node:path";
+import minimist4 from "minimist";
 
 // cli/_dev.ts
-init_bundler();
-init_discover();
+init_build();
 init_ink();
-import React2 from "react";
+import React3 from "react";
 
 // cli/_server_common.ts
 init_discover();
 import fs5 from "node:fs/promises";
-import path6 from "node:path";
-import { createServer as createViteServer } from "vite";
+import path7 from "node:path";
+import { createServer as createViteServer2 } from "vite";
 async function loadAgentDef(cwd) {
-  const agentPath = path6.resolve(cwd, "agent.ts");
-  const vite = await createViteServer({
+  const agentPath = path7.resolve(cwd, "agent.ts");
+  const vite = await createViteServer2({
     root: cwd,
     logLevel: "silent",
     server: { middlewareMode: true }
@@ -2642,7 +2998,7 @@ async function bootServer(agentDef, clientDir, env, port) {
   const wsMod = await import("ws");
   const WS = wsMod.default ?? wsMod;
   const createWebSocket = (url, opts) => new WS(url, { headers: opts.headers });
-  const clientHtml = await fs5.readFile(path6.join(clientDir, "index.html"), "utf-8");
+  const clientHtml = await fs5.readFile(path7.join(clientDir, "index.html"), "utf-8");
   const { createServer: createServer2 } = await Promise.resolve().then(() => (init_server(), server_exports));
   const server = createServer2({
     agent: agentDef,
@@ -2656,25 +3012,11 @@ async function bootServer(agentDef, clientDir, env, port) {
 
 // cli/_dev.ts
 async function _startDevServer(cwd, port, log) {
-  const agent = await loadAgent(cwd);
-  if (!agent) {
-    throw new Error("No agent found \u2014 run `aai init` first");
-  }
-  log(React2.createElement(Step, { action: "Build", msg: agent.slug }));
-  let clientDir;
-  try {
-    const bundle = await bundleAgent(agent);
-    clientDir = bundle.clientDir;
-  } catch (err) {
-    if (err instanceof BundleError) {
-      throw new Error(`Bundle failed: ${err.message}`);
-    }
-    throw err;
-  }
+  const bundle = await buildAgentBundle(cwd, log);
   const agentDef = await loadAgentDef(cwd);
   const env = await resolveServerEnv();
-  await bootServer(agentDef, clientDir, env, port);
-  log(React2.createElement(Step, { action: "Ready", msg: `http://localhost:${port}` }));
+  await bootServer(agentDef, bundle.clientDir, env, port);
+  log(React3.createElement(Step, { action: "Ready", msg: `http://localhost:${port}` }));
 }
 
 // cli/dev.tsx
@@ -2694,7 +3036,7 @@ var devCommandDef = {
   ]
 };
 async function runDevCommand(args, version) {
-  const parsed = minimist3(args, {
+  const parsed = minimist4(args, {
     string: ["port"],
     boolean: ["help", "yes"],
     alias: { p: "port", h: "help", y: "yes" }
@@ -2705,7 +3047,7 @@ async function runDevCommand(args, version) {
   }
   const cwd = process.env.INIT_CWD || process.cwd();
   const port = Number.parseInt(parsed.port ?? "3000", 10);
-  if (!await fileExists(path7.join(cwd, "agent.ts"))) {
+  if (!await fileExists(path8.join(cwd, "agent.ts"))) {
     await runInitCommand(parsed.yes ? ["-y"] : [], version, { quiet: true });
   }
   await getApiKey();
@@ -2722,10 +3064,10 @@ init_discover();
 init_help();
 init_ink();
 import { render as render3, Text as Text3, useApp as useApp2 } from "ink";
-import minimist4 from "minimist";
+import minimist5 from "minimist";
 import pLimit from "p-limit";
 import { useEffect, useState as useState2 } from "react";
-import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
 var ragCommandDef = {
   name: "rag",
   description: "Ingest a site's llms-full.txt into the vector store",
@@ -2740,7 +3082,7 @@ var ragCommandDef = {
   ]
 };
 var FETCH_TIMEOUT_MS = 6e4;
-var PAD = 9;
+var PAD = 2;
 function RagUI({ url, apiKey, serverUrl, slug, chunkSize, onError }) {
   const { exit } = useApp2();
   const { items, log } = useStepLog();
@@ -2768,8 +3110,8 @@ function RagUI({ url, apiKey, serverUrl, slug, chunkSize, onError }) {
     })();
   }, [apiKey, chunkSize, exit, log, onError, serverUrl, slug, url]);
   return /* @__PURE__ */ jsxs3(Fragment2, { children: [
-    /* @__PURE__ */ jsx5(StepLog, { items }),
-    err && /* @__PURE__ */ jsx5(ErrorLine, { msg: err }),
+    /* @__PURE__ */ jsx6(StepLog, { items }),
+    err && /* @__PURE__ */ jsx6(ErrorLine, { msg: err }),
     progress && /* @__PURE__ */ jsxs3(Text3, { children: [
       " ".repeat(PAD + 1),
       "Upsert ",
@@ -2784,7 +3126,7 @@ function RagUI({ url, apiKey, serverUrl, slug, chunkSize, onError }) {
 }
 async function runRag(opts) {
   const { url, apiKey, serverUrl, slug, chunkSize, log, setProgress } = opts;
-  log(/* @__PURE__ */ jsx5(Step, { action: "Fetch", msg: url }));
+  log(/* @__PURE__ */ jsx6(Step, { action: "Fetch", msg: url }));
   const resp = await fetch(url, {
     headers: { "User-Agent": "aai-cli/1.0" },
     redirect: "follow",
@@ -2795,27 +3137,27 @@ async function runRag(opts) {
   }
   const content = await resp.text();
   if (content.length === 0) {
-    log(/* @__PURE__ */ jsx5(Warn, { msg: "File is empty" }));
+    log(/* @__PURE__ */ jsx6(Warn, { msg: "File is empty" }));
     return;
   }
-  log(/* @__PURE__ */ jsx5(Info, { msg: `${(content.length / 1024).toFixed(0)} KB` }));
+  log(/* @__PURE__ */ jsx6(Info, { msg: `${(content.length / 1024).toFixed(0)} KB` }));
   const origin = new URL(url).origin;
   const pages = splitPages(content);
-  log(/* @__PURE__ */ jsx5(Step, { action: "Parsed", msg: `${pages.length} pages` }));
+  log(/* @__PURE__ */ jsx6(Step, { action: "Parse", msg: `${pages.length} pages` }));
   const { RecursiveChunker } = await import("@chonkiejs/core");
   const chunker = await RecursiveChunker.create({ chunkSize });
   const siteSlug = slugify(origin);
   const allChunks = await chunkPages(pages, chunker, origin, siteSlug);
-  log(/* @__PURE__ */ jsx5(Step, { action: "Chunked", msg: `${allChunks.length} chunks` }));
+  log(/* @__PURE__ */ jsx6(Step, { action: "Chunk", msg: `${allChunks.length} chunks` }));
   const vectorUrl = `${serverUrl}/${slug}/vector`;
-  log(/* @__PURE__ */ jsx5(Info, { msg: `target: ${vectorUrl}` }));
+  log(/* @__PURE__ */ jsx6(Info, { msg: `target: ${vectorUrl}` }));
   const result = await upsertChunks(allChunks, vectorUrl, apiKey, setProgress);
-  log(/* @__PURE__ */ jsx5(Step, { action: "Done", msg: `${result.upserted} chunks upserted` }));
+  log(/* @__PURE__ */ jsx6(Step, { action: "Done", msg: `${result.upserted} chunks upserted` }));
   if (result.errors > 0) {
-    log(/* @__PURE__ */ jsx5(Warn, { msg: `${result.errors} failed` }));
-    if (result.lastError) log(/* @__PURE__ */ jsx5(Info, { msg: `last error: ${result.lastError}` }));
+    log(/* @__PURE__ */ jsx6(Warn, { msg: `${result.errors} failed` }));
+    if (result.lastError) log(/* @__PURE__ */ jsx6(Info, { msg: `last error: ${result.lastError}` }));
   }
-  log(/* @__PURE__ */ jsx5(Detail, { msg: `Agent: ${slug}` }));
+  log(/* @__PURE__ */ jsx6(Detail, { msg: `Agent: ${slug}` }));
 }
 async function chunkPages(pages, chunker, origin, siteSlug) {
   const allChunks = [];
@@ -2884,7 +3226,7 @@ async function upsertChunks(chunks, vectorUrl, apiKey, setProgress) {
   return { upserted, errors, lastError };
 }
 async function runRagCommand(args, version) {
-  const parsed = minimist4(args, {
+  const parsed = minimist5(args, {
     string: ["server", "chunk-size"],
     boolean: ["help", "yes"],
     alias: { s: "server", h: "help", y: "yes" },
@@ -2916,7 +3258,7 @@ async function runRagCommand(args, version) {
   const chunkSize = Number.parseInt(parsed["chunk-size"] ?? "512", 10);
   let thrownError;
   const app = render3(
-    /* @__PURE__ */ jsx5(
+    /* @__PURE__ */ jsx6(
       RagUI,
       {
         url,
@@ -2984,8 +3326,8 @@ init_discover();
 init_help();
 init_ink();
 init_prompts();
-import minimist5 from "minimist";
-import { jsx as jsx6 } from "react/jsx-runtime";
+import minimist6 from "minimist";
+import { jsx as jsx7 } from "react/jsx-runtime";
 var secretCommandDef = {
   name: "secret",
   description: "Manage secrets",
@@ -3003,7 +3345,7 @@ async function requireProjectConfig(cwd) {
   return config;
 }
 async function runSecretCommand(args, version) {
-  const parsed = minimist5(args, {
+  const parsed = minimist6(args, {
     boolean: ["help", "yes"],
     alias: { h: "help", y: "yes" },
     stopEarly: true
@@ -3058,7 +3400,7 @@ async function secretPut(cwd, name, value) {
       const text = await resp.text();
       throw new Error(`Failed to set secret: ${text}`);
     }
-    log(/* @__PURE__ */ jsx6(Step, { action: "Set", msg: `${name} for ${slug}` }));
+    log(/* @__PURE__ */ jsx7(Step, { action: "Set", msg: `${name} for ${slug}` }));
   });
 }
 async function secretDelete(cwd, name) {
@@ -3073,7 +3415,7 @@ async function secretDelete(cwd, name) {
       const text = await resp.text();
       throw new Error(`Failed to delete secret: ${text}`);
     }
-    log(/* @__PURE__ */ jsx6(Step, { action: "Deleted", msg: `${name} from ${slug}` }));
+    log(/* @__PURE__ */ jsx7(Step, { action: "Deleted", msg: `${name} from ${slug}` }));
   });
 }
 async function secretList(cwd) {
@@ -3088,10 +3430,10 @@ async function secretList(cwd) {
     }
     const { vars } = await resp.json();
     if (vars.length === 0) {
-      log(/* @__PURE__ */ jsx6(StepInfo, { action: "Secrets", msg: "No secrets set" }));
+      log(/* @__PURE__ */ jsx7(StepInfo, { action: "Secrets", msg: "none set" }));
     } else {
       for (const name of vars) {
-        log(/* @__PURE__ */ jsx6(Detail, { msg: name }));
+        log(/* @__PURE__ */ jsx7(Detail, { msg: name }));
       }
     }
   });
@@ -3101,25 +3443,24 @@ async function secretList(cwd) {
 init_discover();
 init_help();
 init_ink();
-import path9 from "node:path";
-import minimist6 from "minimist";
+import path10 from "node:path";
+import minimist7 from "minimist";
 
 // cli/_start.ts
 init_ink();
-import path8 from "node:path";
-import React3 from "react";
+import path9 from "node:path";
+import React4 from "react";
 async function _startProductionServer(cwd, port, log) {
-  const clientDir = path8.join(cwd, ".aai", "client");
-  log(React3.createElement(Step, { action: "Load", msg: "agent" }));
+  const clientDir = path9.join(cwd, ".aai", "client");
+  log(React4.createElement(Step, { action: "Start", msg: "loading agent" }));
   const agentDef = await loadAgentDef(cwd);
   const env = await resolveServerEnv();
-  log(React3.createElement(Step, { action: "Start", msg: `http://localhost:${port}` }));
   await bootServer(agentDef, clientDir, env, port);
-  log(React3.createElement(Step, { action: "Ready", msg: `http://localhost:${port}` }));
+  log(React4.createElement(Step, { action: "Ready", msg: `http://localhost:${port}` }));
 }
 
 // cli/start.tsx
-import { jsx as jsx7 } from "react/jsx-runtime";
+import { jsx as jsx8 } from "react/jsx-runtime";
 var startCommandDef = {
   name: "start",
   description: "Start the production server from a build",
@@ -3132,7 +3473,7 @@ var startCommandDef = {
   ]
 };
 async function runStartCommand(args, version) {
-  const parsed = minimist6(args, {
+  const parsed = minimist7(args, {
     string: ["port"],
     boolean: ["help", "yes"],
     alias: { p: "port", h: "help", y: "yes" }
@@ -3143,24 +3484,24 @@ async function runStartCommand(args, version) {
   }
   const cwd = process.env.INIT_CWD || process.cwd();
   const port = Number.parseInt(parsed.port ?? "3000", 10);
-  const buildDir = path9.join(cwd, ".aai", "build");
-  if (!await fileExists(path9.join(buildDir, "worker.js"))) {
+  const buildDir = path10.join(cwd, ".aai", "build");
+  if (!await fileExists(path10.join(buildDir, "worker.js"))) {
     throw new Error("No build found \u2014 run `aai build` first");
   }
   await getApiKey();
   await runWithInk(async (log) => {
-    log(/* @__PURE__ */ jsx7(Step, { action: "Start", msg: `production server on port ${port}` }));
+    log(/* @__PURE__ */ jsx8(Step, { action: "Start", msg: `production server on port ${port}` }));
     await _startProductionServer(cwd, port, log);
   });
 }
 
 // cli/cli.ts
-var cliDir = path10.dirname(fileURLToPath2(import.meta.url));
-var pkgJsonPath = path10.join(cliDir, "..", "package.json");
+var cliDir = path11.dirname(fileURLToPath2(import.meta.url));
+var pkgJsonPath = path11.join(cliDir, "..", "package.json");
 var pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
 var VERSION = pkgJson.version;
 async function main(args) {
-  const parsed = minimist7(args, {
+  const parsed = minimist8(args, {
     boolean: ["help", "version"],
     alias: { h: "help", V: "version" },
     stopEarly: true
@@ -3179,6 +3520,9 @@ async function main(args) {
     case "init":
       await runInitCommand(subArgs, VERSION);
       return;
+    case "build":
+      await runBuildCommand(subArgs, VERSION);
+      return;
     case "deploy":
       await runDeployCommand(subArgs, VERSION);
       return;