@alexkroman1/aai-cli 5.1.1 → 5.2.0

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

@@ -0,0 +1,279 @@
+import "@alexkroman1/aai-ui/styles.css";
+import type { ChatMessage } from "@alexkroman1/aai-ui";
+import { client, useSession } from "@alexkroman1/aai-ui";
+import { useEffect, useRef } from "react";
+
+const CSS = `
+@keyframes ic-flicker {
+  0% { opacity: 0.97; } 5% { opacity: 0.95; } 10% { opacity: 0.98; }
+  15% { opacity: 0.96; } 20% { opacity: 0.99; } 50% { opacity: 0.96; }
+  80% { opacity: 0.98; } 100% { opacity: 0.97; }
+}
+@keyframes ic-scanline {
+  0% { transform: translateY(-100%); }
+  100% { transform: translateY(100vh); }
+}
+@keyframes ic-boot {
+  0% { opacity: 0; transform: scaleY(0.01); }
+  30% { opacity: 1; transform: scaleY(0.01); }
+  60% { transform: scaleY(1); }
+  100% { transform: scaleY(1); opacity: 1; }
+}
+@keyframes ic-pulse {
+  0%, 100% { box-shadow: 0 0 8px rgba(0, 255, 65, 0.3); }
+  50% { box-shadow: 0 0 20px rgba(0, 255, 65, 0.6); }
+}
+.ic-crt::before {
+  content: ""; position: absolute; inset: 0; pointer-events: none; z-index: 10;
+  background: repeating-linear-gradient(0deg, rgba(0,0,0,0.15) 0px, rgba(0,0,0,0.15) 1px, transparent 1px, transparent 3px);
+}
+.ic-crt::after {
+  content: ""; position: absolute; top: 0; left: 0; right: 0; height: 4px;
+  background: rgba(0,255,65,0.08); animation: ic-scanline 8s linear infinite;
+  pointer-events: none; z-index: 11;
+}
+.ic-messages::-webkit-scrollbar { width: 6px; }
+.ic-messages::-webkit-scrollbar-track { background: #001a00; }
+.ic-messages::-webkit-scrollbar-thumb { background: #00ff41; }
+.ic-user-msg::before { content: "> "; color: #00ccff; }
+.ic-transcript::before { content: "> "; color: #007a1e; }
+`;
+
+const ASCII_LOGO = `
+  ____    _    __     __ _____  ____   _   _
+ / ___|  / \\   \\ \\   / /| ____||  _ \\ | \\ | |
+| |     / _ \\   \\ \\ / / |  _|  | |_) ||  \\| |
+| |___ / ___ \\   \\ V /  | |___ |  _ < | |\\  |
+ \\____/_/   \\_\\   \\_/   |_____||_| \\_\\|_| \\_|
+`;
+
+const CRT_BG = "#000800";
+const GREEN = "#00ff41";
+const GREEN_DIM = "#00aa2a";
+const GREEN_DARK = "#003300";
+const CYAN = "#00ccff";
+
+function InfocomAdventure() {
+  const session = useSession();
+  const bottom = useRef<HTMLDivElement>(null);
+
+  // Bumps whenever a message lands or the live transcript changes, so the
+  // view follows the conversation instead of scrolling once on mount.
+  const contentVersion = session.messages.length + (session.userTranscript?.length ?? 0);
+  useEffect(() => {
+    // Never true — contentVersion only drives the dependency array, and this
+    // reference keeps the exhaustive-deps lint satisfied.
+    if (contentVersion < 0) return;
+    bottom.current?.scrollIntoView({ behavior: "smooth" });
+  }, [contentVersion]);
+
+  const stateLabel =
+    session.state === "listening"
+      ? "Listening"
+      : session.state === "speaking"
+        ? "Narrating"
+        : session.state === "thinking"
+          ? "Thinking"
+          : session.state === "connecting"
+            ? "Connecting"
+            : session.state === "ready"
+              ? "Ready"
+              : "Idle";
+
+  const msgCount = session.messages.filter((m: ChatMessage) => m.role === "user").length;
+
+  const dotColor =
+    session.state === "listening"
+      ? GREEN
+      : session.state === "speaking"
+        ? "#ffaa00"
+        : session.state === "thinking"
+          ? CYAN
+          : GREEN_DARK;
+
+  if (!session.started) {
+    return (
+      <>
+        <style>{CSS}</style>
+        <div
+          className="ic-crt fixed inset-0 overflow-hidden"
+          style={{
+            background: CRT_BG,
+            color: GREEN,
+            fontFamily: "monospace",
+            fontSize: "15px",
+            lineHeight: 1.6,
+            animation: "ic-flicker 4s infinite",
+          }}
+        >
+          <div
+            className="flex flex-col items-center justify-center h-full text-center p-10"
+            style={{ animation: "ic-boot 1.5s ease-out" }}
+          >
+            <div
+              className="text-[11px] whitespace-pre mb-8"
+              style={{ textShadow: "0 0 10px rgba(0,255,65,0.5)" }}
+            >
+              {ASCII_LOGO}
+            </div>
+            <div className="text-[13px] mb-2" style={{ color: GREEN_DIM }}>
+              AN INTERACTIVE FICTION
+            </div>
+            <div className="text-[13px] mb-2" style={{ color: GREEN_DIM }}>
+              In the style of the classic text adventures.
+            </div>
+            <div className="text-[13px] mt-4" style={{ color: GREEN }}>
+              VOICE-ENABLED EDITION
+            </div>
+            <button
+              type="button"
+              className="mt-10 px-12 py-3.5 bg-transparent cursor-pointer uppercase tracking-[3px] font-mono text-base"
+              style={{
+                color: GREEN,
+                border: `1px solid ${GREEN}`,
+                animation: "ic-pulse 2s ease-in-out infinite",
+              }}
+              onClick={session.start}
+            >
+              Begin Adventure
+            </button>
+          </div>
+          <div
+            className="fixed inset-0 pointer-events-none z-12"
+            style={{
+              background:
+                "radial-gradient(ellipse at center, transparent 60%, rgba(0,0,0,0.4) 100%)",
+            }}
+          />
+        </div>
+      </>
+    );
+  }
+
+  return (
+    <>
+      <style>{CSS}</style>
+      <div
+        className="ic-crt fixed inset-0 overflow-hidden"
+        style={{
+          background: CRT_BG,
+          color: GREEN,
+          fontFamily: "monospace",
+          fontSize: "15px",
+          lineHeight: 1.6,
+          animation: "ic-flicker 4s infinite",
+        }}
+      >
+        <div className="flex flex-col h-full">
+          {/* Status bar */}
+          <div
+            className="flex items-center justify-between px-5 py-2 text-[13px] font-bold tracking-wider shrink-0"
+            style={{ background: GREEN, color: CRT_BG }}
+          >
+            <div className="flex gap-6">
+              <span>CAVERN ADVENTURE</span>
+              <span>Turns: {msgCount}</span>
+            </div>
+            <span>Voice Adventure</span>
+          </div>
+
+          {session.error && (
+            <div className="px-5 py-2 text-xs" style={{ background: "#3a0000", color: "#ff4141" }}>
+              ERROR: {session.error.message}
+            </div>
+          )}
+
+          {/* Messages */}
+          <div
+            className="ic-messages flex-1 overflow-y-auto p-5"
+            style={{ scrollbarWidth: "thin", scrollbarColor: `${GREEN} #001a00` }}
+          >
+            {session.messages.map((msg: ChatMessage, i: number) => (
+              <div
+                key={i}
+                className={`mb-4 ${msg.role === "user" ? "ic-user-msg" : ""}`}
+                style={{
+                  textShadow:
+                    msg.role === "user"
+                      ? "0 0 5px rgba(0,204,255,0.3)"
+                      : "0 0 5px rgba(0,255,65,0.3)",
+                  color: msg.role === "user" ? CYAN : GREEN,
+                }}
+              >
+                {msg.content}
+              </div>
+            ))}
+            {session.userTranscript !== null && (
+              <div
+                className="ic-transcript italic"
+                style={{ color: "#007a1e", textShadow: "0 0 5px rgba(0,255,65,0.15)" }}
+              >
+                {session.userTranscript === "" ? "..." : session.userTranscript}
+              </div>
+            )}
+            <div ref={bottom} />
+          </div>
+
+          {/* Footer controls */}
+          <div
+            className="flex items-center justify-between px-5 py-2 shrink-0 gap-3"
+            style={{ borderTop: `1px solid ${GREEN_DARK}`, background: "#001100" }}
+          >
+            <div
+              className="flex items-center gap-2.5 text-xs uppercase tracking-wider"
+              style={{ color: GREEN_DIM }}
+            >
+              <div
+                className="w-2 h-2 rounded-full"
+                style={{
+                  background: dotColor,
+                  boxShadow: dotColor !== GREEN_DARK ? `0 0 6px ${dotColor}` : "none",
+                }}
+              />
+              <span>{stateLabel}</span>
+            </div>
+            <div className="flex gap-2">
+              <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={session.toggle}
+              >
+                {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.) */}
+              <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()}
+              >
+                [N]ew Game
+              </button>
+            </div>
+          </div>
+        </div>
+        <div
+          className="fixed inset-0 pointer-events-none z-12"
+          style={{
+            background: "radial-gradient(ellipse at center, transparent 60%, rgba(0,0,0,0.4) 100%)",
+          }}
+        />
+      </div>
+    </>
+  );
+}
+
+client({
+  component: InfocomAdventure,
+  theme: {
+    bg: CRT_BG,
+    primary: GREEN,
+    text: GREEN,
+    surface: "#001a00",
+    border: GREEN_DARK,
+  },
+});

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

@@ -0,0 +1,38 @@
+import type { ToolContext } from "@alexkroman1/aai";
+
+export type GameState = {
+  inventory: string[];
+  currentRoom: string;
+  score: number;
+  moves: number;
+  flags: Record<string, boolean>;
+  history: string[];
+};
+
+export const DEFAULT_GAME_STATE: GameState = {
+  inventory: [],
+  currentRoom: "Cave Mouth",
+  score: 0,
+  moves: 0,
+  flags: {},
+  history: [],
+};
+
+// The game lives in `ctx.state`, the agent's per-session mutable state — each
+// session is its own playthrough, so concurrent players never see each
+// other's game and a fresh session starts a fresh adventure.
+type StateSlot = { game?: GameState };
+
+/** The session's live game. Mutations to the returned object stick — it is
+ *  the object stored in `ctx.state`. */
+export function getGameState(ctx: ToolContext): GameState {
+  const slot = ctx.state as StateSlot;
+  slot.game ??= structuredClone(DEFAULT_GAME_STATE);
+  return slot.game;
+}
+
+export function resetGameState(ctx: ToolContext): GameState {
+  const slot = ctx.state as StateSlot;
+  slot.game = structuredClone(DEFAULT_GAME_STATE);
+  return slot.game;
+}

package/dist/templates/infocom-adventure/system-prompt.md

@@ -0,0 +1,43 @@
+You are a classic text adventure game engine running an original game called CAVERN ADVENTURE, in the dry, witty style of early-1980s interactive fiction.
+
+You ARE the game. You maintain the world state, describe rooms, handle puzzles, manage inventory, track score, and respond to player commands.
+
+GAME WORLD RULES:
+- The game is an original underground adventure. Invent the world once, then keep it consistent for the whole session
+- The map includes: Cave Mouth, the Pine Forest around it, a Narrow Ledge, the Echoing Hall, an Underground River, the Flooded Gallery, the Crystal Grotto, the Old Miners' Camp, a maze of twisting tunnels, and a sealed Vault deep below
+- Key items: the rusted lantern (at the entrance), a coil of rope, a miner's pick, a silver key, a jeweled scarab, a golden chalice, an ancient crown, a carved jade idol
+- Key encounters: a hulking cave troll guarding a bridge, a hooded scavenger who prowls the tunnels and steals unattended treasure, a colony of bats, something large asleep in the Vault
+- Puzzles gate progress: crossing the underground river, draining the Flooded Gallery, unlocking the Vault with the silver key, finding your way through the tunnel maze
+- Score increases when the player finds treasures and carries them back to the stone pedestal at the Cave Mouth
+- The lantern has limited fuel. Underground rooms are pitch dark without it — wandering in darkness is dangerous
+
+VOICE-FIRST RESPONSE RULES:
+- Describe rooms vividly but concisely — two to four sentences max
+- For movement, describe the new room immediately
+- For failed actions, give brief, witty responses in classic adventure style ("There is a wall in the way." or "You can't eat that.")
+- Read inventory as a spoken list
+- Announce score changes
+- Keep a dry, understated sense of humor
+- Never use visual formatting — no bullets, no bold, no lists with dashes
+- Use "First... Then... Finally..." for sequences
+- Use directional words naturally: "To the north you see..." not "N: forest"
+
+COMMAND INTERPRETATION:
+- Players speak naturally. Translate their voice into classic adventure commands
+- "go north" / "head north" / "walk north" = north
+- "pick up the rope" / "grab the rope" / "take rope" = take rope
+- "what do I have" / "check my stuff" / "inventory" = inventory
+- "where am I" / "look around" / "describe the room" = look
+- "hit the troll" / "fight the troll" / "attack troll" = attack troll with pick
+- "what's my score" = score
+- "start over" / "new game" / "restart" = restart
+- Accept natural conversational commands and map them to game actions
+
+Use the game state tools to track inventory, location, score, and flags. Use game_state_get to read the current state, game_state_move to change rooms, game_state_take to pick up items, game_state_drop to drop items, game_state_score to add points, game_state_flag to set game flags, and game_state_history to log commands. When the player asks to restart, quit, or start a new game, call game_state_restart, then narrate the opening scene again. Always update state when the player takes an item, moves rooms, or triggers an event. Check state before responding to ensure consistency.
+
+ATMOSPHERE:
+- Underground areas should feel dark and foreboding with the lantern lit, and terrifying in pitch blackness
+- The hooded scavenger should appear unpredictably and make off with dropped treasure
+- The troll blocks the bridge until dealt with — by wits or by force
+- Convey a sense of mystery and danger
+- Keep the wry, understated humor of the classic text adventures

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

@@ -0,0 +1,16 @@
+import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
+import { assemblyAI as 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.
+  llm: assemblyAILlm({ model: "gemini-2.5-flash-lite" }),
+  systemPrompt,
+  greeting:
+    "Hey, I'm Math Buddy. Try asking me something like, what's 127 times 849, convert 5 miles to kilometers, or roll 3 twenty-sided dice.",
+  builtinTools: ["run_code"],
+});

package/dist/templates/math-buddy/system-prompt.md

@@ -0,0 +1,12 @@
+You are Math Buddy, a friendly math assistant. You help with calculations,
+unit conversions, dice rolls, and random number generation. Keep answers short and clear.
+When doing multi-step math, show your work briefly.
+
+Use run_code for ALL calculations. Write JavaScript using console.log() for output.
+
+Examples:
+- Math expressions: console.log((12 + 8) * 3) or console.log(Math.sqrt(144))
+- Unit conversions: convert using known factors (1 km = 0.621371 mi, 1 lb = 0.453592 kg, etc.)
+- Temperature: C to F = (c * 9/5) + 32, F to C = (f - 32) * 5/9, C to K = c + 273.15
+- Dice rolls: console.log(Array.from({length: N}, () => Math.floor(Math.random() * sides) + 1))
+- Random numbers: console.log(Math.floor(Math.random() * (max - min + 1)) + min)

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

@@ -0,0 +1,76 @@
+import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
+import { z } from "zod";
+import { CATEGORIES, type Category, MOODS, type Mood } from "./shared.ts";
+
+const PICKS: Record<Category, Record<Mood, string[]>> = {
+  movie: {
+    chill: ["Lost in Translation", "The Grand Budapest Hotel", "Amelie"],
+    intense: ["Inception", "Interstellar", "The Dark Knight"],
+    cozy: ["When Harry Met Sally", "The Holiday", "Paddington 2"],
+    spooky: ["The Shining", "Get Out", "Hereditary"],
+    funny: ["The Big Lebowski", "Airplane!", "Superbad"],
+  },
+  music: {
+    chill: ["Khruangbin — Con Todo El Mundo", "Tycho — Dive", "Bonobo — Migration"],
+    intense: ["Radiohead — OK Computer", "Tool — Lateralus", "Deftones — White Pony"],
+    cozy: [
+      "Norah Jones — Come Away with Me",
+      "Iron & Wine — Our Endless Numbered Days",
+      "Bon Iver — For Emma, Forever Ago",
+    ],
+    spooky: [
+      "Portishead — Dummy",
+      "Massive Attack — Mezzanine",
+      "Boards of Canada — Music Has the Right to Children",
+    ],
+    funny: [
+      "Weird Al — Running with Scissors",
+      "Flight of the Conchords — S/T",
+      "Tenacious D — S/T",
+    ],
+  },
+  book: {
+    chill: ["Norwegian Wood — Murakami", "The Alchemist — Coelho", "Siddhartha — Hesse"],
+    intense: ["Blood Meridian — McCarthy", "House of Leaves — Danielewski", "Neuromancer — Gibson"],
+    cozy: [
+      "The House in the Cerulean Sea — Klune",
+      "A Man Called Ove — Backman",
+      "Anxious People — Backman",
+    ],
+    spooky: [
+      "The Haunting of Hill House — Jackson",
+      "Mexican Gothic — Moreno-Garcia",
+      "The Turn of the Screw — James",
+    ],
+    funny: ["Good Omens — Pratchett & Gaiman", "Hitchhiker's Guide — Adams", "Catch-22 — Heller"],
+  },
+};
+
+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:
+    "Hey there, night owl. Try asking me for a cozy movie recommendation, or tell me what time you need to wake up and I'll calculate the best time to fall asleep.",
+  builtinTools: ["run_code"],
+
+  tools: {
+    recommend: tool({
+      description: "Get recommendations for movies, music, or books based on mood.",
+      parameters: z.object({
+        category: z.enum(CATEGORIES),
+        mood: z.enum(MOODS),
+      }),
+      async execute(args, ctx) {
+        const result = {
+          category: args.category,
+          mood: args.mood,
+          picks: PICKS[args.category][args.mood],
+        };
+        ctx.send("recommendations", result);
+        return result;
+      },
+    }),
+  },
+});

package/dist/templates/night-owl/client.tsx

@@ -0,0 +1,130 @@
+import "@alexkroman1/aai-ui/styles.css";
+import { Button, client, useEvent, useTheme, useToolCallStart } from "@alexkroman1/aai-ui";
+import { useState } from "react";
+import { MOODS } from "./shared.ts";
+
+type Rec = { category: string; mood: string; picks: string[] };
+
+const MOOD_EMOJI: Record<string, string> = {
+  chill: "\u{1F60C}",
+  intense: "\u{1F525}",
+  cozy: "\u{1F9E3}",
+  spooky: "\u{1F47B}",
+  funny: "\u{1F602}",
+};
+const CAT_EMOJI: Record<string, string> = {
+  movie: "\u{1F3AC}",
+  music: "\u{1F3B5}",
+  book: "\u{1F4DA}",
+};
+
+function RecSidebar() {
+  const theme = useTheme();
+  const [recs, setRecs] = useState<Rec[]>([]);
+  const [activeMood, setActiveMood] = useState<string | null>(null);
+
+  useToolCallStart("recommend", (tc) => {
+    setActiveMood(tc.args.mood as string);
+  });
+
+  useEvent("recommendations", (result) => {
+    setRecs((prev) => [result as Rec, ...prev]);
+  });
+
+  const filtered = activeMood ? recs.filter((r) => r.mood === activeMood) : recs;
+
+  return (
+    <div
+      className="flex flex-col h-full text-sm"
+      style={{ background: theme.bg, color: theme.text }}
+    >
+      <div className="px-4 py-3 border-b shrink-0" style={{ borderColor: theme.border }}>
+        <h2
+          className="text-xs font-bold uppercase tracking-wide opacity-60"
+          style={{ color: theme.text }}
+        >
+          Recommendations
+        </h2>
+      </div>
+
+      <div
+        className="flex flex-wrap gap-1.5 px-3 py-2.5 border-b shrink-0"
+        style={{ borderColor: theme.border }}
+      >
+        {MOODS.map((mood) => (
+          <Button
+            key={mood}
+            variant={activeMood === mood ? "default" : "ghost"}
+            onClick={() => setActiveMood(activeMood === mood ? null : mood)}
+          >
+            {MOOD_EMOJI[mood]} {mood}
+          </Button>
+        ))}
+      </div>
+
+      <div className="flex-1 overflow-y-auto px-3 py-2">
+        {filtered.length === 0 && (
+          <p className="text-xs text-center py-8 opacity-40" style={{ color: theme.text }}>
+            Ask me to recommend a movie, album, or book
+          </p>
+        )}
+        {filtered.map((rec, i) => (
+          <div
+            key={`${rec.category}-${rec.mood}-${i}`}
+            className="mb-3 p-2.5 rounded-lg border"
+            style={{ background: theme.surface, borderColor: theme.border }}
+          >
+            <div className="flex items-center gap-2 mb-1.5">
+              <span className="text-xs">{CAT_EMOJI[rec.category]}</span>
+              <span className="text-xs font-semibold capitalize" style={{ color: theme.primary }}>
+                {rec.category}s
+              </span>
+              <span className="text-xs capitalize opacity-50" style={{ color: theme.text }}>
+                {rec.mood}
+              </span>
+            </div>
+            {rec.picks.map((pick) => (
+              <p
+                key={pick}
+                className="text-xs pl-5 py-0.5 opacity-80"
+                style={{ color: theme.text }}
+              >
+                {pick}
+              </p>
+            ))}
+          </div>
+        ))}
+      </div>
+
+      {recs.length > 0 && (
+        <div className="px-3 py-2 border-t shrink-0" style={{ borderColor: theme.border }}>
+          <Button
+            variant="ghost"
+            className="w-full"
+            onClick={() => {
+              setRecs([]);
+              setActiveMood(null);
+            }}
+          >
+            Clear
+          </Button>
+        </div>
+      )}
+    </div>
+  );
+}
+
+client({
+  name: "Night Owl",
+  sidebar: RecSidebar,
+  theme: {
+    bg: "#0c0e1a",
+    primary: "#a78bfa",
+    text: "#e2e0f0",
+    surface: "#131627",
+    border: "#1e2340",
+  },
+  tools: {
+    recommend: { icon: "\u{1F989}", label: "Recommending" },
+  },
+});

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

@@ -0,0 +1,5 @@
+export const CATEGORIES = ["movie", "music", "book"] as const;
+export const MOODS = ["chill", "intense", "cozy", "spooky", "funny"] as const;
+
+export type Category = (typeof CATEGORIES)[number];
+export type Mood = (typeof MOODS)[number];

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

@@ -0,0 +1,11 @@
+import { agent, assemblyAIPipeline } 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.",
+  builtinTools: ["run_code", "fetch_json"],
+});

package/dist/templates/personal-finance/system-prompt.md

@@ -0,0 +1,17 @@
+You are Penny, a friendly personal finance assistant. You help people with currency conversions, cryptocurrency prices, loan calculations, savings projections, and splitting bills.
+
+Rules:
+- Always show your math clearly when explaining calculations
+- When discussing investments or crypto, remind users that prices fluctuate and this is not financial advice
+- Be encouraging about savings goals
+- Keep responses concise — this is a voice conversation
+- Round dollar amounts to two decimal places for clarity
+
+API endpoints (use fetch_json):
+- Currency rates: https://open.er-api.com/v6/latest/{CODE} — returns { rates: { USD: 1.0, EUR: 0.85, ... } }
+- Crypto prices: https://api.coingecko.com/api/v3/simple/price?ids={coin}&vs_currencies={cur}&include_24hr_change=true&include_market_cap=true
+
+Math calculations (use run_code):
+- Compound interest: FV = principal * (1 + rate/n)^(n*years) + monthly * ((1 + rate/n)^(n*years) - 1) / (rate/n)
+- Loan payment: M = P * (r(1+r)^n) / ((1+r)^n - 1) where r = annual_rate/12, n = years*12
+- Tip calculator: tip = bill * percent/100, per_person = (bill + tip) / people

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

@@ -0,0 +1,32 @@
+import { toAgentConfig } from "@alexkroman1/aai/manifest";
+import { describe, expect, test } from "vitest";
+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.
+    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.
+    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");
+  });
+
+  test("LLM descriptor is Anthropic", () => {
+    expect(agentDef.llm?.kind).toBe("anthropic");
+  });
+
+  test("TTS descriptor is AssemblyAI", () => {
+    expect(agentDef.tts?.kind).toBe("assemblyai");
+  });
+});