@alexkroman1/aai 0.12.3 → 1.0.2

package/dist/isolate/types.js

@@ -1,175 +0,0 @@
-import { z } from "zod";
-//#region isolate/types.ts
-/**
-* Core type definitions for the AAI agent SDK.
-*/
-/**
-* Identity helper that preserves the Zod schema generic for type inference.
-*
-* When tools are defined inline in `defineAgent({ tools: { ... } })`, the
-* generic `P` gets widened to the base `ZodObject` type, so `args` in
-* `execute` loses its specific shape. Wrapping a tool definition in
-* `defineTool()` lets TypeScript infer `P` from `parameters` and type
-* `args` correctly.
-*
-* @example
-* ```ts
-* import { defineAgent, defineTool } from "aai";
-* import { z } from "zod";
-*
-* export default defineAgent({
-*   name: "my-agent",
-*   tools: {
-*     greet: defineTool({
-*       description: "Greet the user",
-*       parameters: z.object({ name: z.string() }),
-*       execute: ({ name }) => `Hello, ${name}!`, // name is string
-*     }),
-*   },
-* });
-* ```
-*
-* @public
-*/
-function defineTool(def) {
-	return def;
-}
-/**
-* Create a typed `defineTool` helper with the session state type baked in.
-*
-* When tools need access to typed session state, you'd normally have to write
-* verbose generics on every `defineTool` call. `defineToolFactory` eliminates
-* that boilerplate by returning a `defineTool` variant that already knows `S`.
-*
-* @example
-* ```ts
-* import { defineToolFactory, defineAgent } from "aai";
-* import { z } from "zod";
-*
-* interface PortfolioState { holdings: Map<string, number> }
-*
-* const tool = defineToolFactory<PortfolioState>();
-*
-* export default defineAgent<PortfolioState>({
-*   name: "portfolio",
-*   state: () => ({ holdings: new Map() }),
-*   tools: {
-*     buy: tool({
-*       description: "Buy shares",
-*       parameters: z.object({ symbol: z.string(), qty: z.number() }),
-*       execute: (args, ctx) => {
-*         // args.symbol is string, ctx.state is PortfolioState
-*         ctx.state.holdings.set(args.symbol, args.qty);
-*       },
-*     }),
-*   },
-* });
-* ```
-*
-* @public
-*/
-function defineToolFactory() {
-	return (def) => def;
-}
-/**
-* Default system prompt used when `instructions` is not provided.
-*
-* Optimized for voice-first interactions: short sentences, no visual
-* formatting, confident tone, and concise answers.
-*/
-const DEFAULT_INSTRUCTIONS = `\
-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.union([z.enum([
-	"auto",
-	"required",
-	"none"
-]), z.object({
-	type: z.literal("tool"),
-	toolName: z.string().min(1)
-})]);
-const ToolDefSchema = z.object({
-	description: z.string().min(1, "Tool description must be non-empty"),
-	parameters: z.custom((val) => val === void 0 || val instanceof z.ZodType, "Expected a Zod schema").optional(),
-	execute: z.function()
-});
-const AgentOptionsSchema = z.object({
-	name: z.string().min(1, "Agent name must be non-empty"),
-	instructions: z.string().optional(),
-	greeting: z.string().optional(),
-	sttPrompt: z.string().optional(),
-	maxSteps: z.union([z.number().int().positive(), z.function()]).optional(),
-	toolChoice: ToolChoiceSchema.optional(),
-	builtinTools: z.array(BuiltinToolSchema).optional(),
-	tools: z.record(z.string(), ToolDefSchema).optional(),
-	state: z.function().optional(),
-	onConnect: z.function().optional(),
-	onDisconnect: z.function().optional(),
-	onError: z.function().optional(),
-	onTurn: z.function().optional(),
-	idleTimeoutMs: z.number().nonnegative().optional()
-});
-/**
-* Create an agent definition from the given options, applying sensible defaults.
-*
-* This is the main entry point for defining a voice agent. The returned
-* `AgentDef` is consumed by the AAI server at deploy time.
-*
-* @param options - Configuration for the agent including name, instructions,
-*   tools, hooks, and other settings.
-* @returns A fully resolved agent definition with all defaults applied.
-*
-* @public
-*
-* @example Basic agent with a custom tool
-* ```ts
-* import { defineAgent } from "aai";
-* import { z } from "zod";
-*
-* export default defineAgent({
-*   name: "greeter",
-*   instructions: "You greet people warmly.",
-*   tools: {
-*     greet: {
-*       description: "Greet a user by name",
-*       parameters: z.object({ name: z.string() }),
-*       execute: ({ name }) => `Hello, ${name}!`,
-*     },
-*   },
-* });
-* ```
-*/
-function defineAgent(options) {
-	AgentOptionsSchema.parse(options);
-	return {
-		...options,
-		instructions: options.instructions ?? DEFAULT_INSTRUCTIONS,
-		greeting: options.greeting ?? "Hey there. I'm a voice assistant. What can I help you with?",
-		maxSteps: options.maxSteps ?? 5,
-		tools: options.tools ?? {}
-	};
-}
-//#endregion
-export { BuiltinToolSchema, DEFAULT_GREETING, DEFAULT_INSTRUCTIONS, ToolChoiceSchema, defineAgent, defineTool, defineTool as tool, defineToolFactory };

package/dist/protocol-rcOrz7T3.js

@@ -1,183 +0,0 @@
-import { z } from "zod";
-//#region isolate/constants.ts
-/**
-* Centralised numeric constants — timeouts, size limits, sample rates.
-*
-* Every magic number that controls a timeout, buffer size, or threshold
-* lives here so the values are discoverable in one place.
-*/
-/** Default sample rate for speech-to-text audio in Hz (AssemblyAI). */
-const DEFAULT_STT_SAMPLE_RATE = 16e3;
-/** Default sample rate for text-to-speech audio in Hz. */
-const DEFAULT_TTS_SAMPLE_RATE = 24e3;
-/** Default timeout for agent lifecycle hooks (onConnect, onTurn, etc). */
-const HOOK_TIMEOUT_MS = 5e3;
-/** Default timeout for tool execution in the worker. */
-const TOOL_EXECUTION_TIMEOUT_MS = 3e4;
-/** Timeout for session.start() (S2S connection setup). */
-const DEFAULT_SESSION_START_TIMEOUT_MS = 1e4;
-/** S2S session idle timeout before auto-close. */
-const DEFAULT_IDLE_TIMEOUT_MS = 3e5;
-/** Per-fetch timeout for network tools (web_search, visit_webpage, fetch_json). */
-const FETCH_TIMEOUT_MS = 15e3;
-/** Timeout for sandboxed run_code execution. */
-const RUN_CODE_TIMEOUT_MS = 5e3;
-/** Maximum time to wait for sessions to stop during graceful shutdown. */
-const DEFAULT_SHUTDOWN_TIMEOUT_MS = 3e4;
-/** Maximum length for tool result strings sent to clients. */
-const MAX_TOOL_RESULT_CHARS = 4e3;
-/** Maximum chars for webpage text after HTML-to-text conversion. */
-const MAX_PAGE_CHARS = 1e4;
-/** Maximum bytes to fetch from an HTML page before conversion. */
-const MAX_HTML_BYTES = 2e5;
-/** Maximum value size for KV store entries (bytes). */
-const MAX_VALUE_SIZE = 65536;
-/** Maximum glob pattern length to prevent ReDoS. */
-const MAX_GLOB_PATTERN_LENGTH = 1024;
-/** Maximum conversation messages to retain (sliding window). */
-const DEFAULT_MAX_HISTORY = 200;
-/**
-* Content-Security-Policy applied to agent UI pages (both self-hosted and
-* platform). Single source of truth — used by `secureHeaders` middleware
-* and per-response CSP headers.
-*/
-const AGENT_CSP = "default-src 'self'; script-src 'self' 'unsafe-eval' blob:; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; connect-src 'self' wss: ws:; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com; object-src 'none'; base-uri 'self'";
-//#endregion
-//#region isolate/protocol.ts
-/**
-* WebSocket wire-format types shared by server and client.
-*
-* Note: this module is for internal use only and should not be used directly.
-*/
-/**
-* Audio codec identifier used in the wire protocol.
-*
-* All audio frames are 16-bit signed PCM, little-endian, mono.
-*/
-const AUDIO_FORMAT = "pcm16";
-/** Zod schema for KV operation requests from the worker to the host. */
-const KvRequestSchema = z.discriminatedUnion("op", [
-	z.object({
-		op: z.literal("get"),
-		key: z.string().min(1)
-	}),
-	z.object({
-		op: z.literal("set"),
-		key: z.string().min(1),
-		value: z.string(),
-		expireIn: z.number().int().positive().optional()
-	}),
-	z.object({
-		op: z.literal("del"),
-		key: z.string().min(1)
-	}),
-	z.object({
-		op: z.literal("list"),
-		prefix: z.string(),
-		limit: z.number().int().positive().optional(),
-		reverse: z.boolean().optional()
-	}),
-	z.object({
-		op: z.literal("keys"),
-		pattern: z.string().optional()
-	})
-]);
-/**
-* Zod schema for session error codes.
-* @public
-*/
-const SessionErrorCodeSchema = z.enum([
-	"stt",
-	"llm",
-	"tts",
-	"tool",
-	"protocol",
-	"connection",
-	"audio",
-	"internal"
-]);
-/** Helper: simple event with only a type field. */
-const ev = (t) => z.object({ type: z.literal(t) });
-/** Helper: event with type + text. */
-const textEv = (t) => z.object({
-	type: z.literal(t),
-	text: z.string()
-});
-const turnOrder = z.number().int().nonnegative().optional();
-/** Zod schema for {@link ClientEvent}. */
-const ClientEventSchema = z.discriminatedUnion("type", [
-	ev("speech_started"),
-	ev("speech_stopped"),
-	z.object({
-		type: z.literal("transcript"),
-		text: z.string(),
-		isFinal: z.boolean(),
-		turnOrder
-	}),
-	textEv("turn").extend({ turnOrder }),
-	textEv("chat"),
-	textEv("chat_delta"),
-	z.object({
-		type: z.literal("tool_call_start"),
-		toolCallId: z.string(),
-		toolName: z.string(),
-		args: z.record(z.string(), z.unknown())
-	}),
-	z.object({
-		type: z.literal("tool_call_done"),
-		toolCallId: z.string(),
-		result: z.string().max(MAX_TOOL_RESULT_CHARS)
-	}),
-	ev("tts_done"),
-	ev("cancelled"),
-	ev("reset"),
-	ev("idle_timeout"),
-	z.object({
-		type: z.literal("error"),
-		code: SessionErrorCodeSchema,
-		message: z.string()
-	})
-]);
-/** Zod schema for {@link ReadyConfig}. */
-const ReadyConfigSchema = z.object({
-	audioFormat: z.enum(["pcm16"]),
-	sampleRate: z.number().int().positive(),
-	ttsSampleRate: z.number().int().positive()
-});
-/** Zod schema for server→client text messages. */
-const ServerMessageSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("config"),
-		audioFormat: z.string(),
-		sampleRate: z.number(),
-		ttsSampleRate: z.number(),
-		sessionId: z.string().optional()
-	}),
-	ev("audio_done"),
-	...ClientEventSchema.options
-]);
-/** Zod schema for client→server text messages. */
-const ClientMessageSchema = z.discriminatedUnion("type", [
-	ev("audio_ready"),
-	ev("cancel"),
-	ev("reset"),
-	z.object({
-		type: z.literal("history"),
-		messages: z.array(z.object({
-			role: z.enum(["user", "assistant"]),
-			content: z.string().max(1e5)
-		})).max(200)
-	})
-]);
-/** Build the protocol-level session config from S2S sample rates. */
-function buildReadyConfig(s2sConfig) {
-	return {
-		audioFormat: AUDIO_FORMAT,
-		sampleRate: s2sConfig.inputSampleRate,
-		ttsSampleRate: s2sConfig.outputSampleRate
-	};
-}
-/** Zod schema for {@link TurnConfig}. */
-const TurnConfigSchema = z.object({ maxSteps: z.number().int().positive().optional() });
-//#endregion
-export { MAX_VALUE_SIZE as C, MAX_TOOL_RESULT_CHARS as S, TOOL_EXECUTION_TIMEOUT_MS as T, FETCH_TIMEOUT_MS as _, ReadyConfigSchema as a, MAX_HTML_BYTES as b, TurnConfigSchema as c, DEFAULT_IDLE_TIMEOUT_MS as d, DEFAULT_MAX_HISTORY as f, DEFAULT_TTS_SAMPLE_RATE as g, DEFAULT_STT_SAMPLE_RATE as h, KvRequestSchema as i, buildReadyConfig as l, DEFAULT_SHUTDOWN_TIMEOUT_MS as m, ClientEventSchema as n, ServerMessageSchema as o, DEFAULT_SESSION_START_TIMEOUT_MS as p, ClientMessageSchema as r, SessionErrorCodeSchema as s, AUDIO_FORMAT as t, AGENT_CSP as u, HOOK_TIMEOUT_MS as v, RUN_CODE_TIMEOUT_MS as w, MAX_PAGE_CHARS as x, MAX_GLOB_PATTERN_LENGTH as y };