@alexkroman1/aai-cli 0.9.0

package/templates/night-owl/agent.ts

@@ -0,0 +1,98 @@
+import { defineAgent, tool } from "@alexkroman1/aai";
+import { z } from "zod";
+
+const PICKS: Record<string, Record<string, 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 defineAgent({
+  name: "Night Owl",
+  instructions:
+    `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.
+
+Use run_code for sleep calculations:
+- Each sleep cycle is 90 minutes, plus 15 minutes to fall asleep
+- Bedtime = wake_time - (cycles * 90 + 15) minutes
+- If result is negative, add 1440 (24 hours in minutes)
+- 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(["movie", "music", "book"]),
+        mood: z.enum(["chill", "intense", "cozy", "spooky", "funny"]),
+      }),
+      execute: ({ category, mood }) => {
+        return {
+          category,
+          mood,
+          picks: PICKS[category]?.[mood] ?? [],
+        };
+      },
+    }),
+  },
+});

package/templates/night-owl/client.tsx

@@ -0,0 +1,12 @@
+import "@alexkroman1/aai-ui/styles.css";
+import { ChatView, StartScreen, mount } from "@alexkroman1/aai-ui";
+
+function NightOwl() {
+  return (
+    <StartScreen icon={<span class="text-5xl">&#x1F989;</span>} title="Night Owl" subtitle="your evening companion" buttonText="Start Conversation">
+      <ChatView />
+    </StartScreen>
+  );
+}
+
+mount(NightOwl);

package/templates/personal-finance/agent.ts

@@ -0,0 +1,26 @@
+import { defineAgent } from "@alexkroman1/aai";
+
+export default defineAgent({
+  name: "Penny",
+  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.",
+  instructions:
+    `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`,
+  builtinTools: ["run_code", "fetch_json"],
+});

package/templates/personal-finance/client.tsx

@@ -0,0 +1,3 @@
+import "@alexkroman1/aai-ui/styles.css";
+import { App, mount } from "@alexkroman1/aai-ui";
+mount(App);

package/templates/pizza-ordering/agent.ts

@@ -0,0 +1,218 @@
+import { defineAgent, type ToolDef } from "@alexkroman1/aai";
+import { z } from "zod";
+
+function orderTool<P extends z.ZodObject<z.ZodRawShape>>(def: ToolDef<P, OrderState>): ToolDef<P, OrderState> {
+  return def;
+}
+
+interface Pizza {
+  id: number;
+  size: "small" | "medium" | "large";
+  crust: "thin" | "regular" | "thick" | "stuffed";
+  toppings: string[];
+  quantity: number;
+}
+
+interface OrderState {
+  pizzas: Pizza[];
+  nextId: number;
+  customerName: string;
+  orderPlaced: boolean;
+}
+
+const MENU = {
+  sizes: { small: 8.99, medium: 11.99, large: 14.99 },
+  crusts: { thin: 0, regular: 0, thick: 1.0, stuffed: 2.0 },
+  toppings: {
+    pepperoni: 1.5,
+    sausage: 1.5,
+    mushrooms: 1.0,
+    onions: 1.0,
+    green_peppers: 1.0,
+    black_olives: 1.0,
+    bacon: 2.0,
+    ham: 1.5,
+    pineapple: 1.0,
+    jalapenos: 1.0,
+    extra_cheese: 1.5,
+    spinach: 1.0,
+    tomatoes: 1.0,
+    anchovies: 1.5,
+    chicken: 2.0,
+  },
+} as const;
+
+function calculateTotal(pizzas: Pizza[]): number {
+  return pizzas.reduce((total, pizza) => {
+    const base = MENU.sizes[pizza.size];
+    const crust = MENU.crusts[pizza.crust];
+    const toppingsPrice = pizza.toppings.reduce(
+      (sum, t) =>
+        sum + (MENU.toppings[t as keyof typeof MENU.toppings] ?? 1.0),
+      0,
+    );
+    return total + (base + crust + toppingsPrice) * pizza.quantity;
+  }, 0);
+}
+
+export default defineAgent({
+  name: "Pizza Palace",
+  greeting:
+    "Welcome to Pizza Palace. I can help you build your perfect pizza. What would you like to order?",
+  instructions: `You are a friendly pizza order-taker at Pizza Palace. Keep responses short and conversational, optimized for voice.
+
+Your job is to help customers build their pizza order step by step. Guide them through size, crust, and toppings.
+
+Menu info:
+- Sizes: small ($8.99), medium ($11.99), large ($14.99)
+- Crusts: thin (free), regular (free), thick (+$1), stuffed (+$2)
+- Toppings: pepperoni ($1.50), sausage ($1.50), mushrooms ($1), onions ($1), green peppers ($1), black olives ($1), bacon ($2), ham ($1.50), pineapple ($1), jalapenos ($1), extra cheese ($1.50), spinach ($1), tomatoes ($1), anchovies ($1.50), chicken ($2)
+
+Behavior:
+- When a customer wants a pizza, collect size, crust, and toppings, then use add_pizza to add it.
+- If they just say something like "pepperoni pizza", assume medium, regular crust, and confirm before adding.
+- Always confirm what you added after using add_pizza.
+- Use view_order when the customer asks to review their order.
+- Use update_pizza if they want to change an existing pizza.
+- Use remove_pizza if they want to remove one.
+- When they say they are done ordering, use place_order.
+- Suggest popular combos if they seem unsure. For example, "Our most popular is a large pepperoni with extra cheese."
+- Always mention the running total after changes.
+- Be warm but efficient. No long monologues.`,
+
+  state: (): OrderState => ({
+    pizzas: [],
+    nextId: 1,
+    customerName: "",
+    orderPlaced: false,
+  }),
+
+  tools: {
+    add_pizza: orderTool({
+      description:
+        "Add a pizza to the order. Use when the customer has decided on a pizza.",
+      parameters: z.object({
+        size: z.enum(["small", "medium", "large"]),
+        crust: z.enum(["thin", "regular", "thick", "stuffed"]),
+        toppings: z
+          .array(z.string())
+          .describe("List of topping names, e.g. ['pepperoni', 'mushrooms']"),
+        quantity: z.number().default(1),
+      }),
+      execute: (args, ctx) => {
+        const state = ctx.state;
+        const pizza: Pizza = {
+          id: state.nextId++,
+          size: args.size,
+          crust: args.crust,
+          toppings: args.toppings,
+          quantity: args.quantity,
+        };
+        state.pizzas.push(pizza);
+        const total = calculateTotal(state.pizzas);
+        return {
+          added: pizza,
+          orderTotal: `$${total.toFixed(2)}`,
+          itemCount: state.pizzas.length,
+        };
+      },
+    }),
+
+    remove_pizza: orderTool({
+      description: "Remove a pizza from the order by its ID.",
+      parameters: z.object({
+        pizza_id: z.number().describe("The pizza ID to remove"),
+      }),
+      execute: (args, ctx) => {
+        const state = ctx.state;
+        const idx = state.pizzas.findIndex((p) => p.id === args.pizza_id);
+        if (idx === -1) return { error: "Pizza not found in the order." };
+        const removed = state.pizzas.splice(idx, 1)[0];
+        const total = calculateTotal(state.pizzas);
+        return {
+          removed,
+          orderTotal: `$${total.toFixed(2)}`,
+          itemCount: state.pizzas.length,
+        };
+      },
+    }),
+
+    update_pizza: orderTool({
+      description:
+        "Update an existing pizza in the order. Only provided fields are changed.",
+      parameters: z.object({
+        pizza_id: z.number(),
+        size: z.enum(["small", "medium", "large"]).optional(),
+        crust: z.enum(["thin", "regular", "thick", "stuffed"]).optional(),
+        toppings: z.array(z.string()).optional(),
+        quantity: z.number().optional(),
+      }),
+      execute: (args, ctx) => {
+        const state = ctx.state;
+        const pizza = state.pizzas.find((p) => p.id === args.pizza_id);
+        if (!pizza) return { error: "Pizza not found in the order." };
+        if (args.size) pizza.size = args.size;
+        if (args.crust) pizza.crust = args.crust;
+        if (args.toppings) pizza.toppings = args.toppings;
+        if (args.quantity) pizza.quantity = args.quantity;
+        const total = calculateTotal(state.pizzas);
+        return {
+          updated: pizza,
+          orderTotal: `$${total.toFixed(2)}`,
+        };
+      },
+    }),
+
+    view_order: {
+      description:
+        "View the current order summary with all pizzas and total price.",
+      execute: (_args, ctx) => {
+        const state = ctx.state;
+        if (state.pizzas.length === 0)
+          return { message: "The order is empty." };
+        const total = calculateTotal(state.pizzas);
+        return {
+          pizzas: state.pizzas.map((p) => ({
+            id: p.id,
+            description: `${p.quantity}x ${p.size} ${p.crust} crust with ${p.toppings.length > 0 ? p.toppings.join(", ") : "cheese only"}`,
+            size: p.size,
+            crust: p.crust,
+            toppings: p.toppings,
+            quantity: p.quantity,
+          })),
+          orderTotal: `$${total.toFixed(2)}`,
+        };
+      },
+    },
+
+    set_customer_name: orderTool({
+      description: "Set the customer name for the order.",
+      parameters: z.object({ name: z.string() }),
+      execute: ({ name }, ctx) => {
+        const state = ctx.state;
+        state.customerName = name;
+        return { name };
+      },
+    }),
+
+    place_order: {
+      description:
+        "Place the final order. Use when the customer confirms they are done and ready to order.",
+      execute: (_args, ctx) => {
+        const state = ctx.state;
+        if (state.pizzas.length === 0)
+          return { error: "Cannot place an empty order." };
+        state.orderPlaced = true;
+        const total = calculateTotal(state.pizzas);
+        const orderNumber = Math.floor(1000 + Math.random() * 9000);
+        return {
+          orderNumber,
+          customerName: state.customerName || "Guest",
+          pizzas: state.pizzas.length,
+          total: `$${total.toFixed(2)}`,
+          estimatedMinutes: 15 + state.pizzas.length * 5,
+        };
+      },
+    },
+  },
+});

package/templates/pizza-ordering/client.tsx

@@ -0,0 +1,264 @@
+import "@alexkroman1/aai-ui/styles.css";
+import { useState } from "preact/hooks";
+import { ChatView, SidebarLayout, StartScreen, mount, useSession, useToolResult } from "@alexkroman1/aai-ui";
+
+interface Pizza {
+  id: number;
+  size: string;
+  crust: string;
+  toppings: string[];
+  quantity: number;
+}
+
+interface OrderInfo {
+  pizzas: Pizza[];
+  total: string;
+  orderPlaced: boolean;
+  orderNumber?: number;
+  estimatedMinutes?: number;
+}
+
+const SIZE_PRICES: Record<string, number> = {
+  small: 8.99,
+  medium: 11.99,
+  large: 14.99,
+};
+const CRUST_PRICES: Record<string, number> = {
+  thin: 0,
+  regular: 0,
+  thick: 1.0,
+  stuffed: 2.0,
+};
+const TOPPING_PRICES: Record<string, number> = {
+  pepperoni: 1.5,
+  sausage: 1.5,
+  mushrooms: 1.0,
+  onions: 1.0,
+  green_peppers: 1.0,
+  black_olives: 1.0,
+  bacon: 2.0,
+  ham: 1.5,
+  pineapple: 1.0,
+  jalapenos: 1.0,
+  extra_cheese: 1.5,
+  spinach: 1.0,
+  tomatoes: 1.0,
+  anchovies: 1.5,
+  chicken: 2.0,
+};
+
+function pizzaPrice(p: Pizza): number {
+  const base = SIZE_PRICES[p.size] ?? 11.99;
+  const crust = CRUST_PRICES[p.crust] ?? 0;
+  const toppings = p.toppings.reduce(
+    (s, t) => s + (TOPPING_PRICES[t] ?? 1.0),
+    0,
+  );
+  return (base + crust + toppings) * p.quantity;
+}
+
+function PizzaIcon({ size }: { size: string }) {
+  const dim = size === "small" ? 36 : size === "large" ? 52 : 44;
+  return (
+    <svg
+      width={dim}
+      height={dim}
+      viewBox="0 0 100 100"
+      class="shrink-0"
+    >
+      <circle cx="50" cy="50" r="48" fill="#F4C542" stroke="#D4A017" stroke-width="3" />
+      <circle cx="50" cy="50" r="42" fill="#E8A025" />
+      <circle cx="35" cy="35" r="7" fill="#C0392B" opacity="0.9" />
+      <circle cx="60" cy="30" r="6" fill="#C0392B" opacity="0.9" />
+      <circle cx="55" cy="55" r="7" fill="#C0392B" opacity="0.9" />
+      <circle cx="30" cy="58" r="6" fill="#C0392B" opacity="0.9" />
+      <circle cx="65" cy="65" r="5" fill="#C0392B" opacity="0.9" />
+      <circle cx="45" cy="68" r="4" fill="#27AE60" opacity="0.7" />
+      <circle cx="70" cy="42" r="4" fill="#27AE60" opacity="0.7" />
+    </svg>
+  );
+}
+
+function OrderPanel({ order }: { order: OrderInfo }) {
+  if (order.orderPlaced) {
+    return (
+      <div class="flex flex-col items-center gap-4 p-6 text-center">
+        <div class="text-5xl">&#10003;</div>
+        <h2 class="text-lg font-bold text-aai-text">Order Placed</h2>
+        {order.orderNumber && (
+          <p class="text-aai-text opacity-70">
+            Order #{order.orderNumber}
+          </p>
+        )}
+        <p class="text-aai-primary font-bold text-xl">{order.total}</p>
+        {order.estimatedMinutes && (
+          <p class="text-aai-text opacity-60 text-sm">
+            Ready in ~{order.estimatedMinutes} minutes
+          </p>
+        )}
+      </div>
+    );
+  }
+
+  if (order.pizzas.length === 0) {
+    return (
+      <div class="flex flex-col items-center gap-3 p-6 text-center opacity-50">
+        <PizzaIcon size="large" />
+        <p class="text-aai-text text-sm">
+          Your order is empty. Tell me what you'd like.
+        </p>
+      </div>
+    );
+  }
+
+  return (
+    <div class="flex flex-col gap-3 p-4">
+      <h3 class="text-sm font-bold text-aai-text opacity-60 uppercase tracking-wide">
+        Your Order
+      </h3>
+      {order.pizzas.map((p) => (
+        <div
+          key={p.id}
+          class="flex items-center gap-3 p-3 rounded-lg bg-aai-surface"
+        >
+          <PizzaIcon size={p.size} />
+          <div class="flex-1 min-w-0">
+            <p class="text-aai-text text-sm font-medium">
+              {p.quantity > 1 ? `${p.quantity}x ` : ""}
+              {p.size.charAt(0).toUpperCase() + p.size.slice(1)}{" "}
+              {p.crust} crust
+            </p>
+            <p class="text-aai-text opacity-60 text-xs truncate">
+              {p.toppings.length > 0
+                ? p.toppings.map((t) => t.replace("_", " ")).join(", ")
+                : "cheese only"}
+            </p>
+          </div>
+          <p class="text-aai-primary text-sm font-bold whitespace-nowrap">
+            ${pizzaPrice(p).toFixed(2)}
+          </p>
+        </div>
+      ))}
+      <div class="flex justify-between items-center pt-3 mt-1 border-t border-aai-border">
+        <span class="text-aai-text font-bold">Total</span>
+        <span class="text-aai-primary font-bold text-lg">{order.total}</span>
+      </div>
+    </div>
+  );
+}
+
+function PizzaAgent() {
+  const { running, toggle, reset } = useSession();
+  const [order, setOrder] = useState<OrderInfo>({
+    pizzas: [],
+    total: "$0.00",
+    orderPlaced: false,
+  });
+
+  useToolResult((toolName, result: any) => {
+    switch (toolName) {
+      case "add_pizza":
+        if (result.added) {
+          setOrder((prev) => ({
+            ...prev,
+            pizzas: [...prev.pizzas, result.added],
+            total: result.orderTotal,
+          }));
+        }
+        break;
+      case "remove_pizza":
+        if (result.removed) {
+          setOrder((prev) => ({
+            ...prev,
+            pizzas: prev.pizzas.filter(
+              (p: Pizza) => p.id !== result.removed.id,
+            ),
+            total: result.orderTotal,
+          }));
+        }
+        break;
+      case "update_pizza":
+        if (result.updated) {
+          setOrder((prev) => ({
+            ...prev,
+            pizzas: prev.pizzas.map((p: Pizza) =>
+              p.id === result.updated.id ? result.updated : p,
+            ),
+            total: result.orderTotal,
+          }));
+        }
+        break;
+      case "view_order":
+        if (result.pizzas) {
+          const total =
+            result.orderTotal ||
+            `$${result.pizzas.reduce((s: number, p: Pizza) => s + pizzaPrice(p), 0).toFixed(2)}`;
+          setOrder((prev) => ({ ...prev, total }));
+        }
+        break;
+      case "place_order":
+        if (result.orderNumber) {
+          setOrder((prev) => ({
+            ...prev,
+            orderPlaced: true,
+            orderNumber: result.orderNumber,
+            total: result.total,
+            estimatedMinutes: result.estimatedMinutes,
+          }));
+        }
+        break;
+    }
+  });
+
+  const sidebar = (
+    <>
+      <div class="p-4 flex items-center gap-3 border-b border-aai-border">
+        <PizzaIcon size="small" />
+        <h2 class="text-base font-bold text-aai-text">Pizza Palace</h2>
+      </div>
+      <div class="flex-1">
+        <OrderPanel order={order} />
+      </div>
+      <div class="p-3 flex gap-2 border-t border-aai-border">
+        <button
+          class={`flex-1 py-2 rounded-lg text-sm border-none cursor-pointer text-white ${running.value ? "bg-aai-error" : "bg-aai-primary"}`}
+          onClick={toggle}
+        >
+          {running.value ? "Pause" : "Resume"}
+        </button>
+        <button
+          class="py-2 px-4 rounded-lg text-sm cursor-pointer text-aai-text bg-aai-surface border border-aai-border"
+          onClick={() => {
+            reset();
+            setOrder({
+              pizzas: [],
+              total: "$0.00",
+              orderPlaced: false,
+            });
+          }}
+        >
+          New Order
+        </button>
+      </div>
+    </>
+  );
+
+  return (
+    <StartScreen icon={<PizzaIcon size="large" />} title="Pizza Palace" subtitle="Voice-powered pizza ordering" buttonText="Start Ordering">
+      <SidebarLayout sidebar={sidebar}>
+        <ChatView />
+      </SidebarLayout>
+    </StartScreen>
+  );
+}
+
+mount(PizzaAgent, {
+  title: "Pizza Palace",
+  theme: {
+    bg: "#1a1008",
+    primary: "#E8A025",
+    text: "#f5f0e8",
+    surface: "#2a1f10",
+    border: "#3d2e18",
+  },
+});

package/templates/simple/agent.ts

@@ -0,0 +1,6 @@
+import { defineAgent } from "@alexkroman1/aai";
+
+export default defineAgent({
+  name: "Simple Assistant",
+  // builtinTools: ["web_search", "visit_webpage", "fetch_json", "run_code"],
+});

package/templates/simple/client.tsx

@@ -0,0 +1,3 @@
+import "@alexkroman1/aai-ui/styles.css";
+import { App, mount } from "@alexkroman1/aai-ui";
+mount(App);