@alexkroman1/aai 0.3.0

package/templates/health-assistant/agent.ts

@@ -0,0 +1,160 @@
+import { defineAgent } from "@alexkroman1/aai";
+import { z } from "zod";
+
+function first(field: unknown): string | undefined {
+  return Array.isArray(field) ? field[0] : undefined;
+}
+
+async function lookupDrug(
+  name: string,
+): Promise<Record<string, unknown>> {
+  const q = encodeURIComponent(name.toLowerCase());
+  let raw: Record<string, unknown>;
+  try {
+    const resp = await fetch(
+      `https://api.fda.gov/drug/label.json?search=openfda.generic_name:"${q}"+openfda.brand_name:"${q}"&limit=1`,
+    );
+    raw = resp.ok ? await resp.json() : { error: `Drug not found: ${name}` };
+  } catch {
+    raw = { error: `Drug not found: ${name}` };
+  }
+
+  if ("error" in raw) return raw;
+  const results = raw.results as Record<string, unknown>[] | undefined;
+  if (!results?.length) return { error: `No FDA data found for: ${name}` };
+
+  const drug = results[0]!;
+  const openfda = (drug.openfda ?? {}) as Record<string, string[]>;
+  return {
+    name: openfda.generic_name?.[0] ?? name,
+    brand_names: openfda.brand_name ?? [],
+    purpose: first(drug.purpose) ?? first(drug.indications_and_usage) ?? "N/A",
+    warnings: first(drug.warnings)?.slice(0, 500) ?? "N/A",
+    dosage: first(drug.dosage_and_administration)?.slice(0, 500) ?? "N/A",
+    side_effects: first(drug.adverse_reactions)?.slice(0, 500) ?? "N/A",
+    manufacturer: openfda.manufacturer_name?.[0] ?? "N/A",
+  };
+}
+
+type RxCui = {
+  name: string;
+  rxcui: string;
+};
+
+async function resolveRxCui(
+  name: string,
+): Promise<RxCui | null> {
+  let raw: { idGroup: { rxnormId?: string[] } } | null;
+  try {
+    const resp = await fetch(
+      `https://rxnav.nlm.nih.gov/REST/rxcui.json?name=${
+        encodeURIComponent(name)
+      }`,
+    );
+    raw = resp.ok ? await resp.json() : null;
+  } catch {
+    raw = null;
+  }
+  if (!raw) return null;
+  const id = raw.idGroup.rxnormId?.[0];
+  return id ? { name, rxcui: id } : null;
+}
+
+async function checkInteractions(
+  drugs: string,
+): Promise<Record<string, unknown>> {
+  const names = drugs.split(",").map((d) => d.trim().toLowerCase());
+
+  const resolved = (await Promise.all(names.map((n) => resolveRxCui(n))))
+    .filter((r): r is RxCui => r !== null);
+
+  if (resolved.length < 2) {
+    return {
+      error: `Could not resolve all drug names. Found: ${
+        resolved.map((r) => r.name).join(", ") || "none"
+      }`,
+    };
+  }
+
+  const rxcuiList = resolved.map((r) => r.rxcui).join("+");
+  let raw: Record<string, unknown>;
+  try {
+    const resp = await fetch(
+      `https://rxnav.nlm.nih.gov/REST/interaction/list.json?rxcuis=${rxcuiList}`,
+    );
+    raw = resp.ok ? await resp.json() : { error: "Interaction lookup failed" };
+  } catch {
+    raw = { error: "Interaction lookup failed" };
+  }
+
+  if ("error" in raw) return raw;
+
+  type InteractionGroup = {
+    fullInteractionType?: {
+      interactionPair?: { description: string; severity: string }[];
+    }[];
+  };
+
+  const groups = (raw.fullInteractionTypeGroup ?? []) as InteractionGroup[];
+  const interactions = groups
+    .flatMap((g) => g.fullInteractionType ?? [])
+    .flatMap((t) => t.interactionPair ?? [])
+    .map(({ description, severity }) => ({ description, severity }));
+
+  return {
+    drugs: resolved.map(({ name, rxcui }) => ({ name, rxcui })),
+    interactions_found: interactions.length,
+    interactions: interactions.slice(0, 5),
+  };
+}
+
+export default defineAgent({
+  name: "Dr. Sage",
+  instructions:
+    `You are Dr. Sage, a friendly health information assistant. You help people \
+understand symptoms, look up medication details, check drug interactions, and calculate \
+basic health metrics.
+
+Rules:
+- You are NOT a doctor and cannot diagnose or prescribe. Always remind users to consult \
+a healthcare provider for medical decisions.
+- Be clear and calm when discussing symptoms — avoid alarming language
+- When discussing medications, always mention common side effects
+- Use plain language first, then mention the medical term
+- Keep responses concise — this is a voice conversation
+- If symptoms sound urgent (chest pain, difficulty breathing, sudden numbness), \
+advise calling emergency services immediately
+- Use web_search to look up current symptom information when needed
+- Use medication_lookup to get details on a single medication
+- Use check_drug_interaction to check interactions between multiple drugs
+
+Use run_code for health calculations:
+- BMI: weight_kg / (height_m * height_m). Categories: <18.5 underweight, 18.5-25 normal, 25-30 overweight, >30 obese
+  Unit conversions: 1 lb = 0.453592 kg, 1 in = 0.0254 m, 1 ft = 0.3048 m, 1 cm = 0.01 m
+- Weight-based dosage: dose_mg = weight_kg * dose_per_kg. Always note this is an estimate.`,
+  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.",
+  builtinTools: ["web_search", "run_code"],
+  tools: {
+    medication_lookup: {
+      description:
+        "Look up detailed information about a single medication, including purpose, warnings, dosage, side effects, and manufacturer. Works with both generic and brand names.",
+      parameters: z.object({
+        name: z.string().describe(
+          "Medication name (generic or brand, e.g. 'ibuprofen' or 'Advil')",
+        ),
+      }),
+      execute: ({ name }) => lookupDrug(name),
+    },
+    check_drug_interaction: {
+      description:
+        "Check for known interactions between two or more medications. Resolves drug names via RxNorm and returns interaction details with severity levels.",
+      parameters: z.object({
+        drugs: z.string().describe(
+          "Comma-separated medication names (e.g. 'ibuprofen, warfarin')",
+        ),
+      }),
+      execute: ({ drugs }) => checkInteractions(drugs),
+    },
+  },
+});

package/templates/health-assistant/client.tsx

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

package/templates/infocom-adventure/agent.ts

@@ -0,0 +1,164 @@
+import { defineAgent } from "@alexkroman1/aai";
+import { z } from "zod";
+import type { ToolContext } from "@alexkroman1/aai";
+
+type GameState = {
+  inventory: string[];
+  currentRoom: string;
+  score: number;
+  moves: number;
+  flags: Record<string, boolean>;
+  history: string[];
+};
+
+function s(ctx: ToolContext<GameState>): GameState {
+  return ctx.state;
+}
+
+export default defineAgent({
+  name: "Infocom Adventure",
+  greeting:
+    "Welcome to the great underground empire. You are standing in an open field west of a white house, with a boarded front door. There is a small mailbox here. What would you like to do?",
+
+  state: (): GameState => ({
+    inventory: [],
+    currentRoom: "West of House",
+    score: 0,
+    moves: 0,
+    flags: {},
+    history: [],
+  }),
+
+  instructions:
+    `You are a classic Infocom-style text adventure game engine, simulating ZORK I: The Great Underground Empire.
+
+You ARE the game. You maintain the world state, describe rooms, handle puzzles, manage inventory, track score, and respond to player commands — all faithfully recreating the Zork experience.
+
+GAME WORLD RULES:
+- Follow the geography, puzzles, and items of Zork I as closely as you can recall
+- The map includes: West of House, North of House, Behind House, South of House, Kitchen, Living Room, Attic, Cellar, the Great Underground Empire (Troll Room, Flood Control Dam, Loud Room, etc.), the maze, Hades, and more
+- Key items: brass lantern, elvish sword, jeweled egg, gold coffin, platinum bar, jade figurine, sapphire bracelet, trunk of jewels, crystal trident, etc.
+- Key encounters: troll, thief, cyclops, spirits, vampire bat
+- Puzzles work as they do in Zork: the dam, the coal mine, the Egyptian room, the mirror rooms, Hades, the maze, etc.
+- Score increases when the player collects treasures and places them in the trophy case in the living room
+- The brass lantern has limited battery life underground
+
+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 the Infocom style ("There is a wall in the way." or "You can't eat that.")
+- Read inventory as a spoken list
+- Announce score changes
+- Keep the classic dry humor of Infocom games
+- 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 sword" / "grab the sword" / "take sword" = take sword
+- "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 sword
+- "what's my score" = score
+- 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. 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 when the lantern is present, and terrifying in pitch blackness
+- The thief should appear randomly and steal items
+- The troll blocks the passage until defeated
+- Convey a sense of mystery and danger
+- Keep the wry, understated humor that made Infocom games legendary`,
+
+  tools: {
+    game_state_get: {
+      description:
+        "Read the current game state including inventory, current room, score, moves, flags, and recent history.",
+      execute: (_args, ctx) => {
+        const g = s(ctx);
+        return {
+          currentRoom: g.currentRoom,
+          inventory: g.inventory,
+          score: g.score,
+          moves: g.moves,
+          flags: g.flags,
+          recentHistory: g.history.slice(-5),
+        };
+      },
+    },
+    game_state_move: {
+      description:
+        "Move the player to a new room and increment the move counter.",
+      parameters: z.object({
+        value: z.string().describe("Room name to move to"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        g.currentRoom = value;
+        g.moves++;
+        return { currentRoom: g.currentRoom, moves: g.moves };
+      },
+    },
+    game_state_take: {
+      description: "Add an item to the player's inventory.",
+      parameters: z.object({
+        value: z.string().describe("Item name to take"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        if (!g.inventory.includes(value)) g.inventory.push(value);
+        return { inventory: g.inventory };
+      },
+    },
+    game_state_drop: {
+      description: "Remove an item from the player's inventory.",
+      parameters: z.object({
+        value: z.string().describe("Item name to drop"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        g.inventory = g.inventory.filter((i) => i !== value);
+        return { inventory: g.inventory };
+      },
+    },
+    game_state_score: {
+      description: "Add points to the player's score.",
+      parameters: z.object({
+        value: z.number().describe("Points to add"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        g.score += value;
+        return { score: g.score };
+      },
+    },
+    game_state_flag: {
+      description:
+        "Set a game flag to true, used for tracking puzzle and event state.",
+      parameters: z.object({
+        value: z.string().describe("Flag name to set"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        g.flags[value] = true;
+        return { flags: g.flags };
+      },
+    },
+    game_state_history: {
+      description:
+        "Log a player command to the history and increment the move counter.",
+      parameters: z.object({
+        value: z.string().describe("Command text to log"),
+      }),
+      execute: ({ value }, ctx) => {
+        const g = s(ctx);
+        g.history.push(value);
+        g.moves++;
+        return { moves: g.moves, recentHistory: g.history.slice(-5) };
+      },
+    },
+  },
+});

package/templates/infocom-adventure/client.tsx

@@ -0,0 +1,299 @@
+import { mount, useSession } from "@alexkroman1/aai/ui";
+import type { Message } from "@alexkroman1/aai/ui";
+import { useEffect, useRef } from "preact/hooks";
+
+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-blink {
+  0%, 49% { opacity: 1; }
+  50%, 100% { opacity: 0; }
+}
+@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;
+  background: repeating-linear-gradient(
+    0deg,
+    rgba(0, 0, 0, 0.15) 0px,
+    rgba(0, 0, 0, 0.15) 1px,
+    transparent 1px,
+    transparent 3px
+  );
+  pointer-events: none;
+  z-index: 10;
+}
+.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 = `
+ ____  ___  ____  _  __
+/__  |/ _ \\|  _ \\| |/ /
+  / /| | | | |_) | ' /
+ / / | |_| |  _ <| . \\
+/_/   \\___/|_| \\_\\_|\\_\\
+`;
+
+function InfocomAdventure() {
+  const { session, started, running, start, toggle, reset } = useSession();
+  const bottom = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    bottom.current?.scrollIntoView({ behavior: "smooth" });
+  }, [session.messages.value.length, session.userUtterance.value]);
+
+  const stateVal = session.state.value;
+  const stateLabel = stateVal === "listening"
+    ? "Listening"
+    : stateVal === "speaking"
+    ? "Narrating"
+    : stateVal === "thinking"
+    ? "Thinking"
+    : stateVal === "connecting"
+    ? "Connecting"
+    : stateVal === "ready"
+    ? "Ready"
+    : "Idle";
+
+  const msgCount =
+    session.messages.value.filter((m: Message) => m.role === "user").length;
+
+  const dotColor = stateVal === "listening"
+    ? "#00ff41"
+    : stateVal === "speaking"
+    ? "#ffaa00"
+    : stateVal === "thinking"
+    ? "#00ccff"
+    : "#003300";
+
+  if (!started.value) {
+    return (
+      <>
+        <style>{CSS}</style>
+        <div
+          class="ic-crt fixed inset-0 overflow-hidden"
+          style={{
+            background: "#000800",
+            color: "#00ff41",
+            fontFamily: "monospace",
+            fontSize: "15px",
+            lineHeight: 1.6,
+            animation: "ic-flicker 4s infinite",
+          }}
+        >
+          <div
+            class="flex flex-col items-center justify-center h-full text-center p-10"
+            style={{ animation: "ic-boot 1.5s ease-out" }}
+          >
+            <div
+              class="text-[11px] whitespace-pre mb-8"
+              style={{ textShadow: "0 0 10px rgba(0, 255, 65, 0.5)" }}
+            >
+              {ASCII_LOGO}
+            </div>
+            <div class="text-[13px] mb-2" style={{ color: "#00aa2a" }}>
+              INFOCOM INTERACTIVE FICTION
+            </div>
+            <div class="text-[13px] mb-2" style={{ color: "#00aa2a" }}>
+              Copyright (c) 1980 Infocom, Inc.
+            </div>
+            <div class="text-[13px] mb-2" style={{ color: "#00aa2a" }}>
+              All rights reserved.
+            </div>
+            <div class="text-[13px] mt-4" style={{ color: "#00ff41" }}>
+              VOICE-ENABLED EDITION
+            </div>
+            <div class="text-[13px] mt-6" style={{ color: "#00aa2a" }}>
+              Release 88 / Serial No. 840726
+            </div>
+            <button
+              type="button"
+              class="mt-10 px-12 py-3.5 bg-transparent cursor-pointer uppercase tracking-[3px] font-mono text-base"
+              style={{
+                color: "#00ff41",
+                border: "1px solid #00ff41",
+                animation: "ic-pulse 2s ease-in-out infinite",
+              }}
+              onClick={start}
+            >
+              Begin Adventure
+            </button>
+          </div>
+          <div
+            class="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
+        class="ic-crt fixed inset-0 overflow-hidden"
+        style={{
+          background: "#000800",
+          color: "#00ff41",
+          fontFamily: "monospace",
+          fontSize: "15px",
+          lineHeight: 1.6,
+          animation: "ic-flicker 4s infinite",
+        }}
+      >
+        <div class="flex flex-col h-full">
+          {/* Status bar */}
+          <div
+            class="flex items-center justify-between px-5 py-2 text-[13px] font-bold tracking-wider shrink-0"
+            style={{ background: "#00ff41", color: "#000800" }}
+          >
+            <div class="flex gap-6">
+              <span>ZORK I</span>
+              <span>Moves: {msgCount}</span>
+            </div>
+            <span>Voice Adventure</span>
+          </div>
+
+          {session.error.value && (
+            <div
+              class="px-5 py-2 text-xs"
+              style={{ background: "#3a0000", color: "#ff4141" }}
+            >
+              ERROR: {session.error.value.message}
+            </div>
+          )}
+
+          {/* Messages */}
+          <div
+            class="ic-messages flex-1 overflow-y-auto p-5"
+            style={{
+              scrollbarWidth: "thin",
+              scrollbarColor: "#00ff41 #001a00",
+            }}
+          >
+            {session.messages.value.map((msg: Message, i: number) => (
+              <div
+                key={i}
+                class={`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" ? "#00ccff" : "#00ff41",
+                }}
+              >
+                {msg.text}
+              </div>
+            ))}
+            {session.userUtterance.value !== null && (
+              <div
+                class="ic-transcript italic"
+                style={{
+                  color: "#007a1e",
+                  textShadow: "0 0 5px rgba(0, 255, 65, 0.15)",
+                }}
+              >
+                {session.userUtterance.value || "..."}
+              </div>
+            )}
+            <div ref={bottom} />
+          </div>
+
+          {/* Footer controls */}
+          <div
+            class="flex items-center justify-between px-5 py-2 shrink-0 gap-3"
+            style={{
+              borderTop: "1px solid #003300",
+              background: "#001100",
+            }}
+          >
+            <div
+              class="flex items-center gap-2.5 text-xs uppercase tracking-wider"
+              style={{ color: "#00aa2a" }}
+            >
+              <div
+                class="w-2 h-2 rounded-full"
+                style={{
+                  background: dotColor,
+                  boxShadow: dotColor !== "#003300"
+                    ? `0 0 6px ${dotColor}`
+                    : "none",
+                }}
+              />
+              <span>{stateLabel}</span>
+            </div>
+            <div class="flex gap-2">
+              <button
+                type="button"
+                class="px-4 py-1 bg-transparent cursor-pointer uppercase tracking-wider font-mono text-[11px]"
+                style={{ color: "#00aa2a", border: "1px solid #003300" }}
+                onClick={toggle}
+              >
+                {running.value ? "[P]ause" : "[R]esume"}
+              </button>
+              <button
+                type="button"
+                class="px-4 py-1 bg-transparent cursor-pointer uppercase tracking-wider font-mono text-[11px]"
+                style={{ color: "#00aa2a", border: "1px solid #003300" }}
+                onClick={reset}
+              >
+                [Q]uit
+              </button>
+            </div>
+          </div>
+        </div>
+        <div
+          class="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>
+    </>
+  );
+}
+
+mount(InfocomAdventure);

package/templates/math-buddy/agent.ts

@@ -0,0 +1,21 @@
+import { defineAgent } from "@alexkroman1/aai";
+
+export default defineAgent({
+  name: "Math Buddy",
+  instructions:
+    `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)`,
+  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/templates/math-buddy/client.tsx

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