@alexkroman1/aai-cli 6.11.0 → 7.0.0

package/dist/{delete-vbpjGzqs.mjs → delete-Dl_LSfvI.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { a as ok } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
-import { l as writeProjectConfig } from "./_config-D_s09e7g.mjs";
-import { a as resolveDeployTarget, i as requireDeployedSlug } from "./_agent-DpH2pBJd.mjs";
-import { d as apiTestSeam, l as HINT_NOT_DEPLOYED, s as studioProjectApiUrl, u as apiRequest } from "./_studio-U3jhKlA3.mjs";
+import { l as writeProjectConfig } from "./_config-CmJOFsAP.mjs";
+import { a as resolveDeployTarget, i as requireDeployedSlug } from "./_agent-BTwZJu4P.mjs";
+import { d as apiTestSeam, l as HINT_NOT_DEPLOYED, s as studioProjectApiUrl, u as apiRequest } from "./_studio-DR5yzZ1T.mjs";
 //#region delete.ts
 async function runDelete(opts) {
 	await apiRequest(`${opts.url}/${opts.slug}`, {

package/dist/{deploy-B8lubiRT.mjs → deploy-DvYeD8ia.mjs}

@@ -2,12 +2,12 @@
 import { a as ok } from "./_output-CKkmWs7i.mjs";
 import { n as log, r as notify, t as fmtUrl } from "./_ui-u7T4YooX.mjs";
 import { o as errorMessage$1 } from "./_utils-B8QmtFhK.mjs";
-import { s as updateProjectConfig } from "./_config-D_s09e7g.mjs";
-import { i as evalWorkerConfig, t as buildAgentBundle } from "./_bundler-C2BDwU7r.mjs";
+import { s as updateProjectConfig } from "./_config-CmJOFsAP.mjs";
+import { i as evalWorkerConfig, t as buildAgentBundle } from "./_bundler-B4RqNF5Z.mjs";
 import { t as resolveServerEnv } from "./_server-common-6e0QI4mq.mjs";
-import { a as resolveDeployTarget } from "./_agent-DpH2pBJd.mjs";
+import { a as resolveDeployTarget } from "./_agent-BTwZJu4P.mjs";
 import { assertTypechecks } from "./_typecheck-gate-BXvUNnfs.mjs";
-import { d as apiTestSeam, f as checkedResponse, i as projectNameFromDir, u as apiRequest } from "./_studio-U3jhKlA3.mjs";
+import { d as apiTestSeam, f as checkedResponse, i as projectNameFromDir, u as apiRequest } from "./_studio-DR5yzZ1T.mjs";
 import { isRecord } from "@alexkroman1/aai/utils";
 import { gzipSync } from "node:zlib";
 //#region _deploy.ts
@@ -39,7 +39,7 @@ async function executeDeploy(opts) {
 	const { cwd } = opts;
 	const { config: projectConfig, serverUrl, apiKey } = await resolveDeployTarget(cwd, opts.server);
 	if (!opts.skipTypecheck) await assertTypechecks(cwd);
-	const preflightModule = import("./_preflight-BtfaYtbE.mjs");
+	const preflightModule = import("./_preflight-Co1G9Jww.mjs");
 	const bundle = await buildAgentBundle(cwd, { minify: true });
 	const slug = projectConfig?.slug ?? projectNameFromDir(cwd) ?? void 0;
 	const uploadEnv = {

package/dist/{dev-Uq5ujP8a.mjs → dev-B59JIfWO.mjs}

@@ -12,7 +12,7 @@ import { styleText } from "node:util";
 async function executeDev(opts) {
 	const port = parsePort(opts.port);
 	const agentName = path.basename(path.resolve(opts.cwd));
-	const { startDevServer } = await import("./_dev-server-LLLWnFBs.mjs");
+	const { startDevServer } = await import("./_dev-server-CiKFH9qw.mjs");
 	let cleanup;
 	let shuttingDown = false;
 	const onSignal = () => {

package/dist/{eject-31gjtaHF.mjs → eject-C9WJyyr2.mjs}

@@ -2,7 +2,7 @@
 import { a as ok, t as CliError } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
 import { l as readJson, o as errorMessage, p as writeJson, s as fileExists } from "./_utils-B8QmtFhK.mjs";
-import { scaffoldDir } from "./_templates-Dxb_P2Wz.mjs";
+import { scaffoldDir } from "./_templates-FI3xPEMj.mjs";
 import path from "node:path";
 import fs from "node:fs/promises";
 //#region eject.ts

package/dist/{init-l6xfU4xX.mjs → init-CpJVjEg0.mjs}

@@ -2,7 +2,7 @@
 import { a as ok } from "./_output-CKkmWs7i.mjs";
 import { n as log, s as unwrapCancel } from "./_ui-u7T4YooX.mjs";
 import { d as resolveCwd, l as readJson, o as errorMessage, s as fileExists, t as AGENT_ENTRY } from "./_utils-B8QmtFhK.mjs";
-import { r as isDevMode, t as getMonorepoRoot } from "./_agent-DpH2pBJd.mjs";
+import { r as isDevMode, t as getMonorepoRoot } from "./_agent-BTwZJu4P.mjs";
 import path from "node:path";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
@@ -105,7 +105,7 @@ function collectWarnings() {
 }
 /** Publish after init and return deploy metadata if successful. */
 async function tryPublish(cwd, server, warn) {
-	const { executePublish } = await import("./studio-BCNUpDgP.mjs");
+	const { executePublish } = await import("./studio--MUV0cid.mjs");
 	try {
 		const result = await executePublish({
 			cwd,
@@ -126,7 +126,7 @@ async function tryPublish(cwd, server, warn) {
 }
 /** Scaffold the project, optionally showing a spinner. */
 async function scaffoldProject(dir, cwd, template, silent) {
-	const { runInit } = await import("./_init-C57bWAQ8.mjs");
+	const { runInit } = await import("./_init-CE4HKdgV.mjs");
 	await withSpinner(silent, {
 		start: `Creating ${dir}`,
 		done: "Project created",

package/dist/{login-C71-qz8F.mjs → login-BBuM1sxH.mjs}

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
 import { a as ok, t as CliError } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
-import { o as updateGlobalConfig, r as readGlobalConfig, t as approveServer } from "./_config-D_s09e7g.mjs";
-import { o as resolveServerUrl } from "./_agent-DpH2pBJd.mjs";
-import { linkConfirmationCode } from "@alexkroman1/aai/utils";
+import { o as updateGlobalConfig, r as readGlobalConfig, t as approveServer } from "./_config-CmJOFsAP.mjs";
+import { o as resolveServerUrl } from "./_agent-BTwZJu4P.mjs";
+import { linkConfirmationCode, sleep } from "@alexkroman1/aai/internal";
 import { spawn } from "node:child_process";
-import { sleep } from "@alexkroman1/aai/internal";
 import { randomBytes } from "node:crypto";
 //#region login.ts
 /**

package/dist/{logs-BWVGSjLR.mjs → logs-9q-psa4q.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { a as ok } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
-import { f as checkedResponse } from "./_studio-U3jhKlA3.mjs";
-import { n as slugRequest } from "./_slug-api-BxrsJXVI.mjs";
+import { f as checkedResponse } from "./_studio-DR5yzZ1T.mjs";
+import { n as slugRequest } from "./_slug-api-nRFaBEPJ.mjs";
 import { isRecord, omitUndefined } from "@alexkroman1/aai/utils";
 import { sleep } from "@alexkroman1/aai/internal";
 function isLogsPage(value) {

package/dist/project-config.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { c as writeGlobalConfig, s as updateProjectConfig } from "./_config-D_s09e7g.mjs";
+import { c as writeGlobalConfig, s as updateProjectConfig } from "./_config-CmJOFsAP.mjs";
 export { updateProjectConfig, writeGlobalConfig as writeConfigHome };

package/dist/scaffold/CLAUDE.md

@@ -127,6 +127,8 @@ export default agent({
   llm?: LlmProvider | string;                // unset stages default to AssemblyAI
   tts?: TtsProvider;                         // (llm also takes a model-id string)
   s2s?: S2sProvider;                         // explicit opt-in to speech-to-speech mode
+                                             // all four types are on "@alexkroman1/aai",
+                                             // and on their own stage subpath
   sttPrompt?: string;                        // STT guidance for jargon/acronyms
   builtinTools?: BuiltinTool[];              // see built-in tools table
                                              // (there is no `tools` field — a tool is a FILE;
@@ -344,12 +346,15 @@ async function file(digest: { url: string }) {
 }
 ```
 
-Three rules, all of which fail silently if broken:
+Three rules. The second and third fail silently if broken; the first is
+warned about by `aai build` and `aai dev`, naming the file and the call:
 
 - **The body replays from the top on every resume**, so it holds no live handle
   and makes no undurable decision — no `Date.now()`, no `Math.random()`, no
-  `fetch`. Those belong in a step, whose result is journaled and returned
-  unchanged on replay.
+  `crypto.randomUUID()`, no `fetch`. Those belong in a step, whose result is
+  journaled and returned unchanged on replay. (The warning reads the built
+  workflow bundle, where step bodies have already been removed, so a step doing
+  any of this is not flagged — that is what a step is FOR.)
 - **A step's arguments and return value cross a queue**, so they must be
   JSON-shaped and small. Put bytes in storage and pass the key.
 - **A step gets no tool context.** It is bundled and dispatched separately from
@@ -359,12 +364,12 @@ Three rules, all of which fail silently if broken:
 ### A step's env, and calling a model from one
 
 A step has no `ctx`, so the two things tool code takes for granted come from
-`@alexkroman1/aai/utils` instead. Import them from THERE and not from
+`@alexkroman1/aai/step` instead. Import them from THERE and not from
 `@alexkroman1/aai` — a `workflows/*.ts` module is bundled separately, and the
 root barrel would drag the whole SDK into that bundle.
 
 ```ts no-check
-import { requireStepEnv, stepEnv, StepGenerateError, stepGenerate } from "@alexkroman1/aai/utils";
+import { requireStepEnv, stepEnv, StepGenerateError, stepGenerate } from "@alexkroman1/aai/step";
 import { FatalError } from "workflow";
 
 async function summarize(url: string, text: string) {
@@ -399,11 +404,11 @@ deploy. Ask it for JSON and parse the reply if you need a shape.
 ### A step's HTTP: use `stepFetch`, not `fetch`
 
 Any outbound request from a step goes through `stepFetch` (also
-`@alexkroman1/aai/utils`). It is not a style preference — `fetch` is the wrong
+`@alexkroman1/aai/step`). It is not a style preference — `fetch` is the wrong
 call to make from a step, for a reason nothing at the call site shows:
 
 ```ts no-check
-import { multipartBody, stepFetch, StepTransportError } from "@alexkroman1/aai/utils";
+import { multipartBody, stepFetch, StepTransportError } from "@alexkroman1/aai/step";
 
 async function transcribeChunk(key: string, bytes: Uint8Array, index: number) {
   "use step";
@@ -433,7 +438,7 @@ async function transcribeChunk(key: string, bytes: Uint8Array, index: number) {
 global `fetch` offers `h2` in ALPN and the far side decides; a server that takes
 it gets every concurrent request from your process multiplexed onto ONE TCP
 connection, sharing one flow-control window. That is fine for small JSON calls
-and pathological for `mapInBatches` over large bodies. Measured on 8 concurrent
+and pathological for `mapConcurrent` over large bodies. Measured on 8 concurrent
 17.66 MB uploads: `fetch` landed 14 of 16 at p50 8094ms, HTTP/1.1 landed 16 of
 16 at p50 3037ms.
 
@@ -470,11 +475,11 @@ it for free.
 
 A workflow whose answer is a FILE — a summary read aloud, a rendered image, a
 generated PDF — needs two things a first draft reaches for and does not find.
-Both are on `@alexkroman1/aai/utils`, and `spoken-summary` is the template that
+Both are on `@alexkroman1/aai/step`, and `spoken-summary` is the template that
 shows the whole round trip.
 
 ```ts no-check
-import { stepSpeak, writeUpload } from "@alexkroman1/aai/utils";
+import { stepSpeak, writeUpload } from "@alexkroman1/aai/step";
 
 export async function narrate(script: string) {
   "use step";
@@ -491,9 +496,11 @@ and the session TTS surface would not help anyway: it is an event stream wired
 into a live pipeline's playback, and a step has no turn to be part of and has to
 return a value. So this is the smaller thing: text in, the whole utterance out
 as a WAV, on the same `ASSEMBLYAI_API_KEY` everything else uses. Voices come
-from `ASSEMBLYAI_TTS_VOICES` (`@alexkroman1/aai/tts`) — read that list rather
-than typing an id, because a wrong one is refused *after* the socket opens and
-produces silence rather than an error.
+from `ASSEMBLYAI_TTS_VOICES` (`@alexkroman1/aai`, or `/tts`) — read that list
+rather than typing an id, because a wrong one is refused *after* the socket
+opens and produces silence rather than an error. The `AssemblyAITtsVoice` type
+gives you autocomplete over it and nothing more: it accepts any string, so that
+a voice the service adds after this release still compiles.
 
 **`writeUpload` is `readUpload`'s other direction, and you need it.** A run's
 output is read back as JSON, so audio cannot travel in one — the same rule that
@@ -560,7 +567,7 @@ request. Everything else is the same file, React and Tailwind included.
 ```tsx no-check
 import { createWorkflowApi, page, useWorkflowRun } from "@alexkroman1/aai-ui";
 import "@alexkroman1/aai-ui/styles.css";
-import type { WorkflowOutputOf } from "@alexkroman1/aai";
+import type { WorkflowOutputOf } from "@alexkroman1/aai/workflow-api";
 import { useState } from "react";
 import type { digest } from "./agent.ts";
 
@@ -747,11 +754,18 @@ for the providers you actually use.
 | --------------- | ---------------------- | -------------------- |
 | `assemblyAIStt` | `"universal-3-5-pro"`  | `ASSEMBLYAI_API_KEY` |
 | `deepgram`      | `"nova-3"`             | `DEEPGRAM_API_KEY`   |
-| `elevenlabs`    | `"scribe_v2_realtime"` | `ELEVENLABS_API_KEY` |
+| `elevenLabsStt` | `"scribe_v2_realtime"` | `ELEVENLABS_API_KEY` |
 | `soniox`        | `"stt-rt-v3"`          | `SONIOX_API_KEY`     |
 
 All STT factories accept `{ model?: string, ... }`. Bare calls
-(`deepgram()`, `soniox()`, etc.) use the default model.
+(`deepgram()`, `soniox()`, etc.) use the default model. Language is spelled
+`language` where the vendor takes one code (`deepgram`, `elevenLabsStt`) and
+`languages` where it takes a list (`assemblyAIStt`, `soniox`) — and only
+`deepgram`'s unset value means English; the other three auto-detect.
+
+`elevenLabsStt` carries the stage in its name because ElevenLabs is
+better known for TTS: when that stage arrives, `elevenLabs` is the name it
+should get.
 
 `assemblyAIStt` accepts an optional `region: "eu"` for EU data residency —
 it routes streaming transcription to AssemblyAI's EU endpoints. EU-region
@@ -772,8 +786,11 @@ API keys require it; the US endpoints reject them. Example:
 | `gateway`       | `ai` (built in)     | `AI_GATEWAY_API_KEY`           |
 | `assemblyAILlm` | `@ai-sdk/openai`    | `ASSEMBLYAI_API_KEY`           |
 
-LLM factories require `{ model: string }`. Example:
-`anthropic({ model: "claude-haiku-4-5" })`.
+LLM factories require `{ model: string }` — the `ModelOptions` interface,
+shared by all of them except `assemblyAILlm`. Example:
+`anthropic({ model: "claude-haiku-4-5" })`. The argument is required because a
+third-party vendor's catalog is not this SDK's to default from;
+`assemblyAILlm()` is the one bare call, since it has a default model.
 
 `openrouter` routes through [OpenRouter](https://openrouter.ai) — an
 OpenAI-compatible endpoint fronting hundreds of models addressed as
@@ -851,7 +868,11 @@ Set
 `language` only alongside a voice that speaks it, as an ISO 639-1 code —
 `"en"`, `"fr"`, `"de"`, `"it"`, `"pt"`, `"es"` are the six the catalog
 covers, and the SDK translates each to the full name the service wants.
-Anything else fails at session start.
+An unsupported code, and a code the declared voice does not speak, are both
+build errors naming the voices that do speak it — including the one you get by
+setting `language` alone, since the descriptor then fills in the default
+English voice. (A voice this release's catalog does not list is passed through:
+the catalog is the service's, so a voice it ships later still works.)
 
 **Rime quirk:** language uses ISO 639-3 three-letter codes (e.g. `"eng"`
 not `"en"`).

package/dist/scaffold/package.json

@@ -13,17 +13,19 @@
     "publish:agent": "aai publish"
   },
   "dependencies": {
-    "@alexkroman1/aai": "^6.11.0",
-    "@alexkroman1/aai-ui": "^6.11.0",
+    "@alexkroman1/aai": "^7.0.0",
+    "@alexkroman1/aai-runtime": "^7.0.0",
+    "@alexkroman1/aai-ui": "^7.0.0",
     "@workflow/world-postgres": "4.3.3",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tailwindcss": "^4.0.0",
     "workflow": "4.8.2",
+    "xstate": "^5.32.5",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@alexkroman1/aai-cli": "^6.11.0",
+    "@alexkroman1/aai-cli": "^7.0.0",
     "@tailwindcss/vite": "^4.3.3",
     "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",

package/dist/scaffold/server.mjs

@@ -17,7 +17,7 @@ import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { parseEnv } from "node:util";
-import { createAgentServer, withHostCredentialFallback } from "@alexkroman1/aai/runtime";
+import { createAgentServer, withHostCredentialFallback } from "@alexkroman1/aai-runtime";
 import { defaultClientDir } from "@alexkroman1/aai-ui/client-dir";
 
 const root = path.dirname(fileURLToPath(import.meta.url));

package/dist/{secret-BuMuFR4B.mjs → secret-CVvSLIDV.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { a as ok, n as fail } from "./_output-CKkmWs7i.mjs";
 import { n as log, s as unwrapCancel } from "./_ui-u7T4YooX.mjs";
-import { f as checkedResponse, p as isStringArray } from "./_studio-U3jhKlA3.mjs";
-import { t as secretRequest } from "./_slug-api-BxrsJXVI.mjs";
+import { f as checkedResponse, p as isStringArray } from "./_studio-DR5yzZ1T.mjs";
+import { t as secretRequest } from "./_slug-api-nRFaBEPJ.mjs";
 import { isRecord } from "@alexkroman1/aai/utils";
 import * as p from "@clack/prompts";
 import { text } from "node:stream/consumers";

package/dist/{storage-DzRZ-eCw.mjs → storage-BvUrnvM3.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { a as ok, n as fail } from "./_output-CKkmWs7i.mjs";
 import { n as log } from "./_ui-u7T4YooX.mjs";
-import { f as checkedResponse } from "./_studio-U3jhKlA3.mjs";
-import { n as slugRequest } from "./_slug-api-BxrsJXVI.mjs";
+import { f as checkedResponse } from "./_studio-DR5yzZ1T.mjs";
+import { n as slugRequest } from "./_slug-api-nRFaBEPJ.mjs";
 import { isRecord } from "@alexkroman1/aai/utils";
 import * as p from "@clack/prompts";
 //#region storage.ts

package/dist/{studio-BCNUpDgP.mjs → studio--MUV0cid.mjs}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { a as ok, t as CliError } from "./_output-CKkmWs7i.mjs";
 import { n as log, t as fmtUrl } from "./_ui-u7T4YooX.mjs";
-import { s as updateProjectConfig } from "./_config-D_s09e7g.mjs";
+import { s as updateProjectConfig } from "./_config-CmJOFsAP.mjs";
 import { t as resolveServerEnv } from "./_server-common-6e0QI4mq.mjs";
-import { a as resolveDeployTarget } from "./_agent-DpH2pBJd.mjs";
-import { layerScaffold } from "./_templates-Dxb_P2Wz.mjs";
-import { a as publishStudioProject, c as studioProjectUrl, f as checkedResponse, i as projectNameFromDir, n as fetchStudioProject, o as pushStudioSource, r as listStudioProjects, s as studioProjectApiUrl, t as collectSourceFiles, u as apiRequest } from "./_studio-U3jhKlA3.mjs";
+import { a as resolveDeployTarget } from "./_agent-BTwZJu4P.mjs";
+import { layerScaffold } from "./_templates-FI3xPEMj.mjs";
+import { a as publishStudioProject, c as studioProjectUrl, f as checkedResponse, i as projectNameFromDir, n as fetchStudioProject, o as pushStudioSource, r as listStudioProjects, s as studioProjectApiUrl, t as collectSourceFiles, u as apiRequest } from "./_studio-DR5yzZ1T.mjs";
 import path from "node:path";
 import { isRecord } from "@alexkroman1/aai/utils";
 import { mkdir, readdir, writeFile } from "node:fs/promises";