@alexkroman1/aai-cli 5.4.0 → 5.5.0

package/dist/scaffold/package.json

@@ -11,15 +11,15 @@
     "deploy": "aai deploy"
   },
   "dependencies": {
-    "@alexkroman1/aai": "^5.4.0",
-    "@alexkroman1/aai-ui": "^5.4.0",
+    "@alexkroman1/aai": "^5.5.0",
+    "@alexkroman1/aai-ui": "^5.5.0",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tailwindcss": "^4.0.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@alexkroman1/aai-cli": "^5.4.0",
+    "@alexkroman1/aai-cli": "^5.5.0",
     "@tailwindcss/vite": "^4.3.3",
     "@types/node": "^26.1.1",
     "@types/react": "^19.2.17",

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { a as unwrapCancel, n as log, s as fail, u as ok } from "./_ui-8kOEB-JH.mjs";
-import { t as slugRequest } from "./_slug-api-19R5kZ0U.mjs";
+import { t as slugRequest } from "./_slug-api-DaqQJHk8.mjs";
 import * as p from "@clack/prompts";
 import { text } from "node:stream/consumers";
 //#region secret.ts

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { n as log, s as fail, u as ok } from "./_ui-8kOEB-JH.mjs";
-import { t as slugRequest } from "./_slug-api-19R5kZ0U.mjs";
+import { t as slugRequest } from "./_slug-api-DaqQJHk8.mjs";
 import * as p from "@clack/prompts";
 //#region storage.ts
 async function storageRequest(cwd, init, server) {

package/dist/templates/code-interpreter/agent.ts

@@ -1,9 +1,8 @@
-import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { agent } from "@alexkroman1/aai";
 import systemPrompt from "./system-prompt.md?raw";
 
 export default agent({
   name: "Coda",
-  ...assemblyAIPipeline(),
   systemPrompt,
   greeting:
     "Hey, I'm Coda. I solve problems by writing and running code. Try asking me something like, what's the 50th fibonacci number, or what day of the week was January 1st 2000.",

package/dist/templates/dispatch-center/agent.ts

@@ -1,4 +1,4 @@
-import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { agent } from "@alexkroman1/aai";
 import { assemblyAIStt } from "@alexkroman1/aai/stt";
 import { dashboardView } from "./shared.ts";
 import systemPrompt from "./system-prompt.md?raw";
@@ -17,13 +17,13 @@ import { resourcesUpdateStatus } from "./tools/resources_update_status.ts";
 
 export default agent({
   name: "Dispatch Command Center",
-  ...assemblyAIPipeline(),
   // One projection replaces eleven `ctx.send("incidents", ...)` calls, and
   // is the single place that decides caller PII stays server-side.
   syncState: dashboardView,
-  // Overriding the STT stage: a dispatcher reads addresses and unit numbers
-  // in bursts with pauses inside one message, so end-of-turn silence has to
-  // be longer than the default or "unit twelve … respond to" splits in two.
+  // Only the STT stage is declared (LLM and TTS stay on the AssemblyAI
+  // defaults): a dispatcher reads addresses and unit numbers in bursts with
+  // pauses inside one message, so end-of-turn silence has to be longer than
+  // the default or "unit twelve … respond to" splits in two.
   stt: assemblyAIStt({ minTurnSilenceMs: 2200 }),
   systemPrompt,
   greeting:

package/dist/templates/dispatch-center/client.tsx

@@ -300,13 +300,18 @@ function App() {
                   >
                     {session.running ? "Pause" : "Resume"}
                   </button>
+                  {/* end() hangs up and flips `started` back, so the UI
+                      returns to "Start Dispatch" and the next start is a
+                      brand-new shift (fresh incident board, greeting
+                      included). reset() would keep the call live — the
+                      buttons never toggle back. */}
                   <button
                     type="button"
                     className="px-4 py-2 border-none rounded-md font-mono text-xs font-semibold uppercase tracking-wider cursor-pointer text-white"
                     style={{ background: "#dc2626" }}
-                    onClick={() => session.reset()}
+                    onClick={() => session.end()}
                   >
-                    Reset
+                    End Shift
                   </button>
                 </>
               )}

package/dist/templates/embedded-assets/agent.ts

@@ -1,4 +1,4 @@
-import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
+import { agent, tool } from "@alexkroman1/aai";
 import { z } from "zod";
 import knowledge from "./knowledge.json" with { type: "json" };
 
@@ -14,7 +14,6 @@ const searchable = faqs.map((entry) => ({
 
 export default agent({
   name: "FAQ Bot",
-  ...assemblyAIPipeline(),
   systemPrompt:
     "You are a friendly FAQ assistant. Answer questions using ONLY the information from your embedded knowledge base. If the user asks something not covered by your knowledge base, say you don't have that information and suggest they check the official documentation.\n\nRules:\n- Keep answers concise and conversational — this is a voice agent\n- Quote the knowledge base accurately, do not embellish\n- If a question is ambiguous, ask the user to clarify\n- Use 'search_knowledge' to find answers to specific questions\n- Use 'list_topics' to see all available FAQ topics\n- Always be helpful and polite",
   greeting:

package/dist/templates/health-assistant/agent.ts

@@ -1,4 +1,4 @@
-import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
+import { agent, tool } from "@alexkroman1/aai";
 import { z } from "zod";
 import systemPrompt from "./system-prompt.md?raw";
 
@@ -76,7 +76,6 @@ function excerptAround(text: string, alias: string): string {
 
 export default agent({
   name: "Dr. Sage",
-  ...assemblyAIPipeline(),
   systemPrompt,
   greeting:
     "Hey, I'm Dr. Sage. Try asking me something like, what are the side effects of ibuprofen, can I take aspirin and warfarin together, or calculate my BMI. Just remember, I'm not a real doctor, so always check with your healthcare provider.",

package/dist/templates/infocom-adventure/agent.ts

@@ -1,15 +1,13 @@
-import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
-import { assemblyAITts } from "@alexkroman1/aai/tts";
+import { agent, tool } from "@alexkroman1/aai";
 import { z } from "zod";
 import { getGameState, resetGameState } from "./shared.ts";
 import systemPrompt from "./system-prompt.md?raw";
 
 export default agent({
   name: "Cavern Adventure",
-  ...assemblyAIPipeline(),
-  // Overriding one stage of the preset: a narrator wants a narrative voice,
-  // and the other two stages stay as the preset set them.
-  tts: assemblyAITts({ voice: "paul" }),
+  // A narrator wants a narrative voice; everything else stays on the
+  // default all-AssemblyAI pipeline.
+  voice: "paul",
   systemPrompt,
   // The opening scene here must agree with DEFAULT_GAME_STATE.currentRoom
   // (shared.ts) and the world map in system-prompt.md.

package/dist/templates/infocom-adventure/client.tsx

@@ -241,15 +241,15 @@ function InfocomAdventure() {
               >
                 {session.running ? "[P]ause" : "[R]esume"}
               </button>
-              {/* Full reload = new WebSocket = fresh sessionId, so the
-                  session-scoped game state starts over too.
-                  (session.reset() keeps the same sessionId and would
-                  resume the old game.) */}
+              {/* end() hangs up and drops the sessionId, so the
+                  session-scoped game state starts over and the title
+                  screen returns. (session.reset() keeps the same
+                  sessionId and would resume the old game.) */}
               <button
                 type="button"
                 className="px-4 py-1 bg-transparent cursor-pointer uppercase tracking-wider font-mono text-[11px]"
                 style={{ color: GREEN_DIM, border: `1px solid ${GREEN_DARK}` }}
-                onClick={() => window.location.reload()}
+                onClick={() => session.end()}
               >
                 [N]ew Game
               </button>

package/dist/templates/math-buddy/agent.ts

@@ -1,13 +1,14 @@
-import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { agent } from "@alexkroman1/aai";
 import { assemblyAILlm } from "@alexkroman1/aai/llm";
 import systemPrompt from "./system-prompt.md?raw";
 
 export default agent({
   name: "Math Buddy",
-  ...assemblyAIPipeline(),
-  // Overriding the LLM stage: this tutor delegates every calculation to
-  // run_code, so it needs turn-taking speed more than reasoning depth —
-  // and Flash-Lite is both quicker and cheaper than the preset's default.
+  // Only the LLM stage is declared: this tutor delegates every calculation
+  // to run_code, so it needs turn-taking speed more than reasoning depth —
+  // and Flash-Lite is both quicker and cheaper than the default model. STT
+  // and TTS stay on the AssemblyAI defaults. (The string shorthand
+  // `llm: "gemini-2.5-flash-lite"` desugars to this same descriptor.)
   llm: assemblyAILlm({ model: "gemini-2.5-flash-lite" }),
   systemPrompt,
   greeting:

package/dist/templates/night-owl/agent.ts

@@ -1,4 +1,4 @@
-import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
+import { agent, tool } from "@alexkroman1/aai";
 import { z } from "zod";
 import { CATEGORIES, type Category, MOODS, type Mood } from "./shared.ts";
 
@@ -48,7 +48,6 @@ const PICKS: Record<Category, Record<Mood, string[]>> = {
 
 export default agent({
   name: "Night Owl",
-  ...assemblyAIPipeline(),
   systemPrompt:
     "You are Night Owl, a cozy evening companion. You help people wind down, recommend entertainment, and share interesting facts about the night sky. Keep your tone warm and relaxed. Use short, conversational responses.\n\nUse run_code for sleep calculations:\n- Each sleep cycle is 90 minutes, plus 15 minutes to fall asleep\n- Bedtime = wake_time - (cycles * 90 + 15) minutes\n- If result is negative, add 1440 (24 hours in minutes)\n- Format as HH:MM",
   greeting:

package/dist/templates/personal-finance/agent.ts

@@ -1,9 +1,8 @@
-import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { agent } from "@alexkroman1/aai";
 import systemPrompt from "./system-prompt.md?raw";
 
 export default agent({
   name: "Penny",
-  ...assemblyAIPipeline(),
   systemPrompt,
   greeting:
     "Hey, I'm Penny, your personal finance helper. Try asking me something like, what's 100 dollars in euros, what's the price of bitcoin, or help me split a 120 dollar bill four ways with 20 percent tip.",

package/dist/templates/pipeline-simple/agent.test.ts

@@ -4,29 +4,29 @@ import agentDef from "./agent.ts";
 
 describe("pipeline-simple template", () => {
   test("config passes manifest validation", () => {
-    // Same conversion `aai build`/`aai deploy` run — catches a partial
-    // provider triple or invalid tuning, not just descriptor presence.
+    // Same conversion `aai build`/`aai deploy` run — catches an invalid
+    // provider combination or tuning, not just descriptor presence.
     expect(() => toAgentConfig(agentDef)).not.toThrow();
   });
 
-  test("exports an agent with all three pipeline providers", () => {
-    // Presence of stt + llm + tts is what flips the runtime into
-    // pipeline mode (see parseManifest). Smoke-test each is wired up.
+  test("declares only the LLM stage on the def", () => {
+    // The template's point: swap one stage, leave the rest unset. The
+    // unset stages are filled with the AssemblyAI defaults at parse time.
     expect(agentDef.name).toBe("pipeline-simple");
-    expect(agentDef.stt).toBeDefined();
     expect(agentDef.llm).toBeDefined();
-    expect(agentDef.tts).toBeDefined();
-  });
-
-  test("STT descriptor is AssemblyAI", () => {
-    expect(agentDef.stt?.kind).toBe("assemblyai");
+    expect(agentDef.stt).toBeUndefined();
+    expect(agentDef.tts).toBeUndefined();
   });
 
   test("LLM descriptor is Anthropic", () => {
     expect(agentDef.llm?.kind).toBe("anthropic");
   });
 
-  test("TTS descriptor is AssemblyAI", () => {
-    expect(agentDef.tts?.kind).toBe("assemblyai");
+  test("unset stages fill to AssemblyAI in the deployable config", () => {
+    const config = toAgentConfig(agentDef);
+    expect(config.mode).toBe("pipeline");
+    expect(config.stt?.kind).toBe("assemblyai");
+    expect(config.tts?.kind).toBe("assemblyai");
+    expect(config.llm?.kind).toBe("anthropic");
   });
 });

package/dist/templates/pipeline-simple/agent.ts

@@ -1,13 +1,12 @@
-import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { agent } from "@alexkroman1/aai";
 import { anthropic } from "@alexkroman1/aai/llm";
 
 export default agent({
   name: "pipeline-simple",
   greeting: "Hi! I'm running in pipeline mode. What can I help with?",
-  // The preset fills all three stages with AssemblyAI, billed to the one key
-  // a published agent is guaranteed to have. Spread it, then override the one
-  // stage you want elsewhere — here the LLM. Anything not overridden stays
-  // AssemblyAI, so swapping a stage never means restating the other two.
-  ...assemblyAIPipeline(),
+  // Declare only the stage you want elsewhere — here the LLM. Every stage
+  // left unset (STT and TTS here) runs on the AssemblyAI default, billed to
+  // the one key a published agent is guaranteed to have, so swapping a stage
+  // never means restating the other two.
   llm: anthropic({ model: "claude-haiku-4-5" }),
 });

package/dist/templates/pizza-ordering/agent.ts

@@ -1,4 +1,4 @@
-import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
+import { agent, tool } from "@alexkroman1/aai";
 import { z } from "zod";
 import {
   CRUSTS,
@@ -21,7 +21,6 @@ const crusts = z.enum(CRUSTS);
 
 export default agent({
   name: "Pizza Palace",
-  ...assemblyAIPipeline(),
   // The cart, pushed to the client after every tool call. Replaces a
   // `ctx.send("order", ...)` in each of the five order tools, and the
   // event-diffing the client had to do to rebuild the cart from them.

package/dist/templates/retail/address.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { Address } from "./shared.ts";
+
+/** Spread into both address tools' schemas. Two hand-copied zod shapes is how
+ *  the order address and the profile address drift apart. */
+export const AddressFields = {
+  address1: z.string().max(200).describe("First line, e.g. '123 Main St'"),
+  address2: z.string().max(200).describe("Second line, e.g. 'Apt 1' — pass '' if there is none"),
+  city: z.string().max(100).describe("City, e.g. 'San Francisco'"),
+  state: z.string().max(60).describe("State, e.g. 'CA'"),
+  country: z.string().max(60).describe("Country, e.g. 'USA'"),
+  zip: z.string().max(20).describe("Zip code, e.g. '12345'"),
+};
+
+export function toAddress(args: Address): Address {
+  return {
+    address1: args.address1,
+    address2: args.address2,
+    city: args.city,
+    state: args.state,
+    country: args.country,
+    zip: args.zip,
+  };
+}
+
+export function formatAddress(address: Address): string {
+  const lines = [address.address1, address.address2].filter(Boolean).join(", ");
+  return `${lines}, ${address.city} ${address.state} ${address.zip}, ${address.country}`;
+}