@alexkroman1/aai 1.3.2 → 1.4.0

package/dist/host/providers/stt.d.ts

@@ -1,2 +0,0 @@
-/** STT provider interface — re-exported from sdk/ for host-side consumption. */
-export type * from "../../sdk/providers.ts";

package/dist/host/providers/tts-barrel.d.ts

@@ -1,8 +0,0 @@
-/**
- * `@alexkroman1/aai/tts` subpath barrel. Re-exports the TTS provider
- * contract types (via `tts.ts` → `sdk/providers.ts`) alongside the
- * concrete Cartesia adapter factory. Task 9 owns wiring this file
- * into `package.json` exports.
- */
-export * from "./tts/cartesia.ts";
-export type * from "./tts.ts";

package/dist/host/providers/tts-barrel.js

@@ -1,182 +0,0 @@
-import { createNanoEvents } from "nanoevents";
-import { randomUUID } from "node:crypto";
-import { Cartesia } from "@cartesia/cartesia-js";
-//#region host/providers/tts/cartesia.ts
-/**
-* Cartesia TTS adapter — streaming WebSocket with per-turn `context_id`.
-*
-* Wraps `@cartesia/cartesia-js`'s `TTSWS` / `TTSWSContext` and normalizes it
-* onto the {@link TtsProvider} / {@link TtsEvents} contract consumed by the
-* pipeline orchestrator.
-*
-* **Per-turn context lifecycle.** Each `sendText(...)` within the same turn
-* appends to the same Cartesia context. On `flush()` or `cancel()`, a new
-* context is minted for the next turn — so concurrent `cancel({ contextId })`
-* only targets the in-flight turn, never the one that follows.
-*
-* **Audio format.** The adapter requests `raw` / `pcm_s16le` at the
-* negotiated `sampleRate` so it can forward chunks as `Int16Array` with no
-* conversion.
-*/
-function makeError(message) {
-	const err = new Error(message);
-	err.code = "tts_stream_error";
-	return err;
-}
-/** PCM16 sample rates supported by Cartesia's `raw` output format. */
-const CARTESIA_PCM16_RATES = [
-	8e3,
-	16e3,
-	22050,
-	24e3,
-	44100,
-	48e3
-];
-function assertSupportedSampleRate(rate) {
-	if (CARTESIA_PCM16_RATES.includes(rate)) return rate;
-	const err = /* @__PURE__ */ new Error(`Cartesia TTS adapter: unsupported sample rate ${rate}. Supported: ${CARTESIA_PCM16_RATES.join(", ")}.`);
-	err.code = "tts_connect_failed";
-	throw err;
-}
-function cartesia(opts) {
-	return {
-		name: "cartesia",
-		async open(openOpts) {
-			const apiKey = opts.apiKey ?? openOpts.apiKey ?? process.env.CARTESIA_API_KEY;
-			if (!apiKey) {
-				const err = /* @__PURE__ */ new Error("Cartesia TTS adapter: missing API key. Provide via the factory option, TtsOpenOptions, or the CARTESIA_API_KEY environment variable.");
-				err.code = "tts_auth_failed";
-				throw err;
-			}
-			const sampleRate = assertSupportedSampleRate(openOpts.sampleRate);
-			const model = opts.model ?? "sonic-2";
-			const language = opts.language ?? "en";
-			const client = new Cartesia({ apiKey });
-			let ws;
-			try {
-				ws = await client.tts.websocket();
-			} catch (cause) {
-				const err = /* @__PURE__ */ new Error(`Cartesia TTS: connect failed: ${cause instanceof Error ? cause.message : String(cause)}`);
-				err.code = "tts_connect_failed";
-				throw err;
-			}
-			const emitter = createNanoEvents();
-			let closed = false;
-			/** Mint a fresh context bound to the shared TTSWS connection. */
-			const mintContext = () => ws.context({
-				model_id: model,
-				voice: {
-					mode: "id",
-					id: opts.voice
-				},
-				output_format: {
-					container: "raw",
-					encoding: "pcm_s16le",
-					sample_rate: sampleRate
-				},
-				contextId: randomUUID()
-			});
-			let context = mintContext();
-			/**
-			* `doneEmitted` guards against emitting `done` more than once per turn.
-			* Reset whenever a fresh context is minted (i.e. at turn boundaries).
-			*/
-			let doneEmitted = false;
-			const rotateContext = () => {
-				context = mintContext();
-				doneEmitted = false;
-			};
-			const emitDoneOnce = () => {
-				if (doneEmitted || closed) return;
-				doneEmitted = true;
-				emitter.emit("done");
-			};
-			ws.on("chunk", (event) => {
-				if (closed) return;
-				if (event.context_id !== context.contextId) return;
-				const buf = event.audio;
-				if (!buf || buf.byteLength === 0) return;
-				const evenBytes = buf.byteLength - buf.byteLength % 2;
-				if (evenBytes === 0) return;
-				const pcm = new Int16Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + evenBytes));
-				emitter.emit("audio", pcm);
-			});
-			ws.on("done", (event) => {
-				if (closed) return;
-				if (event.context_id !== context.contextId) return;
-				emitDoneOnce();
-			});
-			ws.on("error", (err) => {
-				if (closed) return;
-				emitter.emit("error", makeError(err?.message ?? String(err)));
-			});
-			const close = async () => {
-				if (closed) return;
-				closed = true;
-				try {
-					ws.close({
-						code: 1e3,
-						reason: "client close"
-					});
-				} catch {}
-			};
-			if (openOpts.signal.aborted) close();
-			else openOpts.signal.addEventListener("abort", () => void close(), { once: true });
-			/** Static part of each generation request; only `transcript` and
-			* `continue` vary per send. Pinned here so `language` threads through. */
-			const baseRequest = {
-				model_id: model,
-				voice: {
-					mode: "id",
-					id: opts.voice
-				},
-				output_format: {
-					container: "raw",
-					encoding: "pcm_s16le",
-					sample_rate: sampleRate
-				},
-				language
-			};
-			/**
-			* Swallow rejections from async SDK calls — the global `error`
-			* listener on `ws` emits a normalized {@link TtsError}, so there's
-			* nothing useful for the caller to do with per-send failures.
-			*/
-			const ignoreRejection = (_err) => {};
-			return {
-				sendText(text) {
-					if (closed || text.length === 0) return;
-					context.send({
-						...baseRequest,
-						transcript: text,
-						continue: true
-					}).catch(ignoreRejection);
-				},
-				flush() {
-					if (closed) return;
-					context.send({
-						...baseRequest,
-						transcript: "",
-						continue: false
-					}).catch(ignoreRejection);
-					queueMicrotask(emitDoneOnce);
-					rotateContext();
-				},
-				cancel() {
-					if (closed) return;
-					context.cancel().catch(ignoreRejection);
-					emitDoneOnce();
-					rotateContext();
-				},
-				on(event, fn) {
-					return emitter.on(event, fn);
-				},
-				close,
-				_ws: ws,
-				_currentContextId: () => context.contextId
-			};
-		}
-	};
-}
-//#endregion
-export { cartesia };

package/dist/host/providers/tts.d.ts

@@ -1,2 +0,0 @@
-/** TTS provider interface — re-exported from sdk/ for host-side consumption. */
-export type * from "../../sdk/providers.ts";

package/dist/types-Cfx_4QDK.js

@@ -1,39 +0,0 @@
-import { z } from "zod";
-//#region sdk/types.ts
-/**
-* Core type definitions for the AAI agent SDK.
-*/
-/**
-* Default system prompt used when `systemPrompt` is not provided.
-*
-* Optimized for voice-first interactions: short sentences, no visual
-* formatting, confident tone, and concise answers.
-*/
-const DEFAULT_SYSTEM_PROMPT = `\
-You are AAI, a helpful AI assistant.
-
-Voice-First Rules:
-- Optimize for natural speech. Avoid jargon unless central to the answer. \
-Use short, punchy sentences.
-- Never mention "search results," "sources," or "the provided text." \
-Speak as if the knowledge is your own.
-- No visual formatting. Do not say "bullet point," "bold," or "bracketed one." \
-If you need to list items, say "First," "Next," and "Finally."
-- Start with the most important information. No introductory filler.
-- Be concise. Keep answers to 1-3 sentences. For complex topics, provide a high-level summary.
-- Be confident. Avoid hedging phrases like "It seems that" or "I believe."
-- If you don't have enough information, say so directly rather than guessing.
-- Never use exclamation points. Keep your tone calm and conversational.`;
-/** Default greeting spoken when a session starts. */
-const DEFAULT_GREETING = "Hey there. I'm a voice assistant. What can I help you with?";
-/** @internal Zod schema for {@link BuiltinTool}. Exported for reuse in internal schemas. */
-const BuiltinToolSchema = z.enum([
-	"web_search",
-	"visit_webpage",
-	"fetch_json",
-	"run_code"
-]);
-/** @internal Zod schema for {@link ToolChoice}. Exported for reuse in internal schemas. */
-const ToolChoiceSchema = z.enum(["auto", "required"]);
-//#endregion
-export { ToolChoiceSchema as i, DEFAULT_GREETING as n, DEFAULT_SYSTEM_PROMPT as r, BuiltinToolSchema as t };

package/host/providers/llm.ts

@@ -1,3 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/** LLM provider type — re-exported from sdk/ for host-side consumption. */
-export type * from "../../sdk/providers.ts";

package/host/providers/stt-barrel.ts

@@ -1,13 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * `@alexkroman1/aai/stt` subpath barrel. Re-exports the STT provider
- * contract types (via `stt.ts` → `sdk/providers.ts`) alongside the
- * concrete AssemblyAI adapter factory. Task 9 owns wiring this file
- * into `package.json` exports.
- */
-
-// biome-ignore lint/performance/noReExportAll: subpath barrel
-export * from "./stt/assemblyai.ts";
-// Type-only re-export — no biome suppression needed; `export type *` is
-// excluded from the `noReExportAll` rule.
-export type * from "./stt.ts";

package/host/providers/stt.ts

@@ -1,3 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/** STT provider interface — re-exported from sdk/ for host-side consumption. */
-export type * from "../../sdk/providers.ts";

package/host/providers/tts-barrel.ts

@@ -1,13 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * `@alexkroman1/aai/tts` subpath barrel. Re-exports the TTS provider
- * contract types (via `tts.ts` → `sdk/providers.ts`) alongside the
- * concrete Cartesia adapter factory. Task 9 owns wiring this file
- * into `package.json` exports.
- */
-
-// biome-ignore lint/performance/noReExportAll: subpath barrel
-export * from "./tts/cartesia.ts";
-// Type-only re-export — no biome suppression needed; `export type *` is
-// excluded from the `noReExportAll` rule.
-export type * from "./tts.ts";

package/host/providers/tts.ts

@@ -1,3 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/** TTS provider interface — re-exported from sdk/ for host-side consumption. */
-export type * from "../../sdk/providers.ts";