@alexkroman1/aai-cli 5.3.0 → 5.4.0

package/dist/templates/dispatch-center/tools/incident_create.ts

@@ -13,7 +13,7 @@ import {
 
 export const incidentCreate = tool({
   description: "Create a new incident from an incoming emergency call.",
-  parameters: z.object({
+  inputSchema: z.object({
     location: z.string().max(300).describe("Address or location description"),
     description: z.string().max(2000).describe("Nature of the emergency as described by caller"),
     callerName: z.string().max(120).describe("Caller's name").optional(),

package/dist/templates/dispatch-center/tools/incident_escalate.ts

@@ -11,7 +11,7 @@ import {
 
 export const incidentEscalate = tool({
   description: "Escalate an incident when it exceeds current capacity or severity increases.",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentId: z.string().max(20).describe("The incident ID"),
     reason: z.string().max(1000).describe("Reason for escalation"),
     requestMutualAid: z

package/dist/templates/dispatch-center/tools/incident_get.ts

@@ -4,7 +4,7 @@ import { findIncident, getApplicableProtocols, getState, incidentAgeMinutes } fr
 
 export const incidentGet = tool({
   description: "Get full details on a specific incident including timeline and assigned resources.",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentId: z.string().max(20).describe("The incident ID"),
   }),
   async execute(args, ctx) {

package/dist/templates/dispatch-center/tools/incident_triage.ts

@@ -15,7 +15,7 @@ import {
 export const incidentTriage = tool({
   description:
     "Triage an incident — confirm or override severity, type, hazards, and casualty count.",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentId: z.string().max(20).describe("The incident ID"),
     severity: z.enum(SEVERITIES).describe("Confirmed severity after triage").optional(),
     type: z.enum(INCIDENT_TYPES).describe("Confirmed incident type").optional(),

package/dist/templates/dispatch-center/tools/incident_update_status.ts

@@ -4,7 +4,7 @@ import { assertNotResolved, findIncident, logEvent, updateState } from "../share
 
 export const incidentUpdateStatus = tool({
   description: "Update an incident's status (en_route, on_scene, resolved, escalated).",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentId: z.string().max(20).describe("The incident ID"),
     status: z.enum(["en_route", "on_scene", "resolved", "escalated"]).describe("New status"),
     notes: z.string().max(1000).describe("Status update notes").optional(),

package/dist/templates/dispatch-center/tools/ops_protocols.ts

@@ -4,7 +4,7 @@ import { getApplicableProtocols, INCIDENT_TYPES, SEVERITIES } from "../shared.ts
 
 export const opsProtocols = tool({
   description: "Look up step-by-step response protocols for a given incident type and severity.",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentType: z.enum(INCIDENT_TYPES).describe("Type of incident"),
     severity: z.enum(SEVERITIES).describe("Severity level"),
   }),

package/dist/templates/dispatch-center/tools/ops_run_scenario.ts

@@ -119,7 +119,7 @@ const SCENARIO_NAMES = Object.keys(scenarios) as [ScenarioName, ...ScenarioName[
 
 export const opsRunScenario = tool({
   description: "Run a training scenario that creates simulated incidents for dispatch practice.",
-  parameters: z.object({
+  inputSchema: z.object({
     scenario: z.enum(SCENARIO_NAMES).describe("Scenario type to simulate"),
   }),
   async execute(args, ctx) {

package/dist/templates/dispatch-center/tools/resources_dispatch.ts

@@ -12,7 +12,7 @@ import {
 export const resourcesDispatch = tool({
   description:
     "Dispatch units to an incident. Can auto-dispatch recommended resources or manually specify callsigns.",
-  parameters: z.object({
+  inputSchema: z.object({
     incidentId: z.string().max(20).describe("The incident ID"),
     callsigns: z
       .array(z.string().max(50))

package/dist/templates/dispatch-center/tools/resources_get_available.ts

@@ -4,7 +4,7 @@ import { getState, RESOURCE_TYPES } from "../shared.ts";
 
 export const resourcesGetAvailable = tool({
   description: "List available resources, optionally filtered by type.",
-  parameters: z.object({
+  inputSchema: z.object({
     type: z
       .enum([...RESOURCE_TYPES, "all"])
       .describe("Filter by resource type, or 'all'")

package/dist/templates/dispatch-center/tools/resources_update_status.ts

@@ -4,7 +4,7 @@ import { logEvent, RESOURCE_STATUSES, updateState } from "../shared.ts";
 
 export const resourcesUpdateStatus = tool({
   description: "Update a resource unit's status when it radios in.",
-  parameters: z.object({
+  inputSchema: z.object({
     callsign: z.string().max(50).describe("The resource callsign"),
     status: z.enum(RESOURCE_STATUSES).describe("New status"),
     notes: z.string().max(1000).describe("Status notes").optional(),

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

@@ -31,7 +31,7 @@ export default agent({
     search_knowledge: tool({
       description:
         "Search the embedded FAQ knowledge base for an answer matching the user's question.",
-      parameters: z.object({
+      inputSchema: z.object({
         query: z.string().describe("The user's question to search for"),
       }),
       async execute(args) {

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

@@ -86,7 +86,7 @@ export default agent({
     check_drug_interaction: tool({
       description:
         "Check for interactions between two or more medications using FDA drug label data. Looks up each drug's official label and reports where one drug's Drug Interactions section mentions another. Absence of a mention does not guarantee safety.",
-      parameters: z.object({
+      inputSchema: z.object({
         drugs: z
           .array(z.string().min(1))
           .min(2)
@@ -142,7 +142,7 @@ export default agent({
     medication_lookup: tool({
       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({
+      inputSchema: z.object({
         name: z
           .string()
           .describe("Medication name (generic or brand, e.g. 'ibuprofen' or 'Advil')"),

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

@@ -1,5 +1,5 @@
 import { agent, assemblyAIPipeline, tool } from "@alexkroman1/aai";
-import { assemblyAI as assemblyAITts } from "@alexkroman1/aai/tts";
+import { assemblyAITts } from "@alexkroman1/aai/tts";
 import { z } from "zod";
 import { getGameState, resetGameState } from "./shared.ts";
 import systemPrompt from "./system-prompt.md?raw";
@@ -19,7 +19,7 @@ export default agent({
   tools: {
     game_state_drop: tool({
       description: "Remove an item from the player's inventory.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.string().describe("Item name to drop"),
       }),
       async execute(args, ctx) {
@@ -31,7 +31,7 @@ export default agent({
 
     game_state_flag: tool({
       description: "Set a game flag to true, used for tracking puzzle and event state.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.string().describe("Flag name to set"),
       }),
       async execute(args, ctx) {
@@ -59,7 +59,7 @@ export default agent({
 
     game_state_history: tool({
       description: "Log a player command to the history and increment the move counter.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.string().describe("Command text to log"),
       }),
       async execute(args, ctx) {
@@ -72,7 +72,7 @@ export default agent({
 
     game_state_move: tool({
       description: "Move the player to a new room and increment the move counter.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.string().describe("Room name to move to"),
       }),
       async execute(args, ctx) {
@@ -94,7 +94,7 @@ export default agent({
 
     game_state_score: tool({
       description: "Add points to the player's score.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.number().describe("Points to add"),
       }),
       async execute(args, ctx) {
@@ -106,7 +106,7 @@ export default agent({
 
     game_state_take: tool({
       description: "Add an item to the player's inventory.",
-      parameters: z.object({
+      inputSchema: z.object({
         value: z.string().describe("Item name to take"),
       }),
       async execute(args, ctx) {

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

@@ -1,5 +1,5 @@
 import { agent, assemblyAIPipeline } from "@alexkroman1/aai";
-import { assemblyAI as assemblyAILlm } from "@alexkroman1/aai/llm";
+import { assemblyAILlm } from "@alexkroman1/aai/llm";
 import systemPrompt from "./system-prompt.md?raw";
 
 export default agent({

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

@@ -58,7 +58,7 @@ export default agent({
   tools: {
     recommend: tool({
       description: "Get recommendations for movies, music, or books based on mood.",
-      parameters: z.object({
+      inputSchema: z.object({
         category: z.enum(CATEGORIES),
         mood: z.enum(MOODS),
       }),

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

@@ -76,17 +76,19 @@ describe("pricing (shared.ts)", () => {
     expect(calculateTotal([a, b])).toBeCloseTo(8.99 * 4, 5);
   });
 
-  test("add_pizza schema defaults quantity to 1 and rejects non-positive quantities", () => {
-    const schema = getTool("add_pizza").parameters;
-    if (!schema) throw new Error("add_pizza has no parameters schema");
-    const parsed = schema.parse({ size: "small", crust: "thin", toppings: [] });
-    expect(parsed.quantity).toBe(1);
-    expect(() =>
-      schema.parse({ size: "small", crust: "thin", toppings: [], quantity: 0 }),
-    ).toThrow();
-    expect(() =>
-      schema.parse({ size: "small", crust: "thin", toppings: [], quantity: 1.5 }),
-    ).toThrow();
+  test("add_pizza schema defaults quantity to 1 and rejects non-positive quantities", async () => {
+    const schema = getTool("add_pizza").inputSchema;
+    if (!schema) throw new Error("add_pizza has no input schema");
+    // Validate through the Standard Schema contract — the vendor-neutral
+    // interface every inputSchema carries.
+    const validate = (value: unknown) => schema["~standard"].validate(value);
+    const ok = await validate({ size: "small", crust: "thin", toppings: [] });
+    if (ok.issues) throw new Error("expected valid input");
+    expect((ok.value as { quantity: number }).quantity).toBe(1);
+    const zero = await validate({ size: "small", crust: "thin", toppings: [], quantity: 0 });
+    expect(zero.issues).toBeDefined();
+    const frac = await validate({ size: "small", crust: "thin", toppings: [], quantity: 1.5 });
+    expect(frac.issues).toBeDefined();
   });
 });
 

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

@@ -35,7 +35,7 @@ export default agent({
   tools: {
     add_pizza: tool({
       description: "Add a pizza to the order. Use when the customer has decided on a pizza.",
-      parameters: z.object({
+      inputSchema: z.object({
         size: sizes,
         crust: crusts,
         toppings: z
@@ -93,7 +93,7 @@ export default agent({
 
     remove_pizza: tool({
       description: "Remove a pizza from the order by its ID.",
-      parameters: z.object({
+      inputSchema: z.object({
         pizza_id: z.number().describe("The pizza ID to remove"),
       }),
       async execute(args, ctx) {
@@ -113,7 +113,7 @@ export default agent({
 
     set_customer_name: tool({
       description: "Set the customer name for the order.",
-      parameters: z.object({
+      inputSchema: z.object({
         name: z.string(),
       }),
       async execute(args, ctx) {
@@ -124,7 +124,7 @@ export default agent({
 
     update_pizza: tool({
       description: "Update an existing pizza in the order. Only provided fields are changed.",
-      parameters: z.object({
+      inputSchema: z.object({
         pizza_id: z.number(),
         size: sizes.optional(),
         crust: crusts.optional(),

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

@@ -0,0 +1,18 @@
+import { toAgentConfig } from "@alexkroman1/aai/manifest";
+import { describe, expect, test } from "vitest";
+import agentDef from "./agent.ts";
+
+describe("simple template", () => {
+  test("config passes manifest validation", () => {
+    // Same conversion `aai build`/`aai deploy` run.
+    expect(() => toAgentConfig(agentDef)).not.toThrow();
+  });
+
+  test("exports an agent with a name and no explicit providers", () => {
+    // No provider fields declared: the default all-AssemblyAI pipeline is
+    // injected at parse time (see `assemblyAIPipeline`).
+    expect(agentDef.name).toBe("Simple Assistant");
+    expect(agentDef.stt).toBeUndefined();
+    expect(agentDef.s2s).toBeUndefined();
+  });
+});

package/dist/templates/simple/agent.ts

@@ -1,5 +1,7 @@
 import { agent } from "@alexkroman1/aai";
 
+// No providers declared: the agent runs the default all-AssemblyAI cascaded
+// pipeline (`...assemblyAIPipeline()`), billed to ASSEMBLYAI_API_KEY.
 export default agent({
   name: "Simple Assistant",
 });

package/dist/templates/solo-rpg/agent.test.ts

@@ -408,7 +408,7 @@ describe("update_state", () => {
   });
 
   test("zod schemas reject out-of-range and malformed inputs", () => {
-    const params = updateState.parameters!;
+    const params = updateState.inputSchema!;
     expect(() => params.parse({ addClockSegments: 1 })).toThrow(); // below min
     expect(() => params.parse({ addClockSegments: 13 })).toThrow(); // above max
     expect(() => params.parse({ addClockSegments: 2.5 })).toThrow(); // non-integer
@@ -419,7 +419,7 @@ describe("update_state", () => {
       params.parse({ addClockSegments: 6, updateNpcBond: 4, timeOfDay: "night" }),
     ).toBeTruthy();
 
-    const slotParams = saveGame.parameters!;
+    const slotParams = saveGame.inputSchema!;
     expect(() => slotParams.parse({ slot: "../../etc" })).toThrow();
     expect(() => slotParams.parse({ slot: "a".repeat(40) })).toThrow();
     expect(slotParams.parse({ slot: "chapter-2" })).toBeTruthy();

package/dist/templates/solo-rpg/tools/action_roll.ts

@@ -15,7 +15,7 @@ import {
 export const actionRoll = tool({
   description:
     "Core mechanic. Roll 2d6 + stat (capped at 10) vs 2d10 challenge dice. Also applies consequences (health/spirit/supply/momentum changes, clock advancement) based on move type, position, and result. Call for ANY risky action. Pure conversation needs no roll.",
-  parameters: z.object({
+  inputSchema: z.object({
     move: z.enum(MOVES).describe("Which move the player is making"),
     stat: z.enum(["edge", "heart", "iron", "shadow", "wits"]).describe("Which stat to roll"),
     position: z

package/dist/templates/solo-rpg/tools/load_game.ts

@@ -7,7 +7,7 @@ import { loadState, saveGameState, saveSlotKey, saveSlotParam } from "../shared.
 // `aai dev`); the rest of the game works without it.
 export const loadGame = tool({
   description: "Load a previously saved game.",
-  parameters: z.object({ slot: saveSlotParam }),
+  inputSchema: z.object({ slot: saveSlotParam }),
   async execute(args, ctx) {
     const saved = await loadState<GameState>(ctx, saveSlotKey(args.slot));
     if (!saved) return { error: "No save found." };

package/dist/templates/solo-rpg/tools/oracle.ts

@@ -205,7 +205,7 @@ const THEMES = [
 export const oracle = tool({
   description:
     "Consult the oracle for narrative inspiration. Generates random prompts from thematic tables.",
-  parameters: z.object({
+  inputSchema: z.object({
     type: z
       .enum(["action_theme", "npc_reaction", "scene_twist", "yes_no", "chaos_check"])
       .describe("Type of oracle consultation"),

package/dist/templates/solo-rpg/tools/save_game.ts

@@ -6,7 +6,7 @@ import { getGameState, saveSlotKey, saveSlotParam, saveState } from "../shared.t
 // `aai dev`); the rest of the game works without it.
 export const saveGame = tool({
   description: "Save current game to persistent storage.",
-  parameters: z.object({ slot: saveSlotParam }),
+  inputSchema: z.object({ slot: saveSlotParam }),
   async execute(args, ctx) {
     const state = getGameState(ctx);
     await saveState(ctx, saveSlotKey(args.slot), state);

package/dist/templates/solo-rpg/tools/setup_character.ts

@@ -21,7 +21,7 @@ import {
 export const setupCharacter = tool({
   description:
     "Set up the entire game in one call. Starts a completely fresh game (any previous unsaved game is replaced), generates stats, initializes state, and marks the game as ready. After this returns, just narrate the opening scene. No need to call update_state — everything is already done.",
-  parameters: z.object({
+  inputSchema: z.object({
     genre: z.string().max(100).describe("Chosen genre code or custom description"),
     tone: z.string().max(100).describe("Chosen tone code or custom description"),
     archetype: z.string().max(100).describe("Chosen archetype code or custom description"),

package/dist/templates/solo-rpg/tools/update_state.ts

@@ -22,7 +22,7 @@ import {
 export const updateState = tool({
   description:
     "Lightweight state sync for during gameplay. Handles location changes, NPC additions, clock additions, time changes, and session log entries. Resource changes (health/spirit/supply/momentum) are auto-applied by action_roll — only use those fields here for manual adjustments like resting or trading. Pass only what changed.",
-  parameters: z.object({
+  inputSchema: z.object({
     location: z.string().max(200).describe("New location name").optional(),
     locationDesc: z.string().max(500).describe("Short location description").optional(),
     timeOfDay: z.enum(TIME_PHASES).describe("New time of day").optional(),

package/dist/typecheck.d.ts

@@ -11,6 +11,21 @@
  * checked with it; one that doesn't isn't (scaffolded projects and studio
  * workspaces always have one). TypeScript itself resolves from the
  * PROJECT'S node_modules — the user's pinned compiler, not ours.
+ *
+ * @internal — build hook for aai-server/the studio; not a supported public
+ * API and not covered by semver. The lack of a `_` prefix is packaging (the
+ * subpath must be importable cross-package), not an invitation: user code
+ * should never import from `@alexkroman1/aai-cli`.
+ */
+/**
+ * Outcome of one {@link typecheckProject} run — a discriminated union on
+ * `ok`: `{ ok: true, skipped }` when the check passed (`skipped: true`
+ * meaning the project has no `tsconfig.json` so nothing ran), or
+ * `{ ok: false, output }` with the formatted tsc diagnostics (tail-capped)
+ * ready to surface as build feedback.
+ *
+ * @internal — build hook for aai-server/the studio; not a supported public
+ * API and not covered by semver.
  */
 export type TypecheckResult = {
     ok: true;
@@ -22,5 +37,8 @@ export type TypecheckResult = {
 /**
  * Typecheck the project at `cwd` with its own tsconfig + compiler.
  * Skips (ok, skipped: true) when the project has no tsconfig.json.
+ *
+ * @internal — build hook for aai-server/the studio; not a supported public
+ * API and not covered by semver.
  */
 export declare function typecheckProject(cwd: string): Promise<TypecheckResult>;

package/dist/typecheck.mjs

@@ -17,6 +17,11 @@ import { spawn } from "node:child_process";
 * checked with it; one that doesn't isn't (scaffolded projects and studio
 * workspaces always have one). TypeScript itself resolves from the
 * PROJECT'S node_modules — the user's pinned compiler, not ours.
+*
+* @internal — build hook for aai-server/the studio; not a supported public
+* API and not covered by semver. The lack of a `_` prefix is packaging (the
+* subpath must be importable cross-package), not an invitation: user code
+* should never import from `@alexkroman1/aai-cli`.
 */
 /** Bound on one typecheck run — a hung compiler must not wedge a deploy. */
 const TYPECHECK_TIMEOUT_MS = 12e4;
@@ -62,6 +67,9 @@ function resolveTscEntry(cwd) {
 /**
 * Typecheck the project at `cwd` with its own tsconfig + compiler.
 * Skips (ok, skipped: true) when the project has no tsconfig.json.
+*
+* @internal — build hook for aai-server/the studio; not a supported public
+* API and not covered by semver.
 */
 async function typecheckProject(cwd) {
 	if (!existsSync(path.join(cwd, "tsconfig.json"))) return {

package/dist/worker-bundler.d.ts

@@ -1,5 +1,10 @@
 import { type PluginOption } from "vite";
-/** Options for worker bundling. */
+/**
+ * Options for worker bundling.
+ *
+ * @internal — build hook for aai-server/the studio; not a supported public
+ * API and not covered by semver.
+ */
 export type BuildWorkerOptions = {
     /**
      * Minify the worker with Oxc (Vite 8's native minifier). Deploy builds set
@@ -25,5 +30,8 @@ export type BuildWorkerOptions = {
  *
  * Zod is bundled in — zod 4's `Function()` usage is wrapped in try/catch
  * and gracefully degrades in restricted environments like Deno.
+ *
+ * @internal — build hook for aai-server/the studio; not a supported public
+ * API and not covered by semver.
  */
 export declare function buildWorker(cwd: string, opts?: BuildWorkerOptions): Promise<string>;

package/dist/worker-bundler.mjs

@@ -13,6 +13,11 @@ import { build } from "vite";
 * worker published from the browser comes out of the same Vite/Rollup pass as
 * one from `aai deploy`.
 *
+* @internal — build hook for aai-server/the studio; not a supported public
+* API and not covered by semver. The lack of a `_` prefix is packaging (the
+* subpath must be importable cross-package), not an invitation: user code
+* should never import from `@alexkroman1/aai-cli`.
+*
 * Every worker is built through a generated wrapper entry that re-exports the
 * agent *and* its extracted config as `__aaiConfig` (via the dependency-free
 * `@alexkroman1/aai/manifest` helpers, bundled in). The guest harness returns
@@ -60,6 +65,9 @@ ${runtime ? `export const __aaiCreateRuntime = (opts: Record<string, unknown>) =
 *
 * Zod is bundled in — zod 4's `Function()` usage is wrapped in try/catch
 * and gracefully degrades in restricted environments like Deno.
+*
+* @internal — build hook for aai-server/the studio; not a supported public
+* API and not covered by semver.
 */
 async function buildWorker(cwd, opts = {}) {
 	const wrapperPath = path.join(cwd, WRAPPER_ENTRY_REL);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai-cli",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "type": "module",
   "bin": {
     "aai": "dist/cli.mjs"
@@ -37,8 +37,8 @@
     "p-timeout": "^7.0.1",
     "vite": "^8.1.5",
     "zod": "^4.4.3",
-    "@alexkroman1/aai": "5.3.0",
-    "@alexkroman1/aai-ui": "5.3.0"
+    "@alexkroman1/aai-ui": "5.4.0",
+    "@alexkroman1/aai": "5.4.0"
   },
   "devDependencies": {
     "playwright": "^1.61.1",