@alexkroman1/aai 1.4.5 → 1.5.0

package/dist/host/session.d.ts

@@ -1,62 +0,0 @@
-/** S2S session — relays audio between client and AssemblyAI S2S API. */
-import type { AgentConfig, ExecuteTool, ToolSchema } from "../sdk/_internal-types.ts";
-import type { ClientSink } from "../sdk/protocol.ts";
-import type { Logger, S2SConfig } from "./runtime-config.ts";
-import { type CreateS2sWebSocket, connectS2s } from "./s2s.ts";
-/**
- * A voice session managing the Speech-to-Speech connection for one client.
- *
- * Created by {@link createS2sSession}. Each session owns a single S2S WebSocket
- * connection and relays audio between the browser client and AssemblyAI.
- *
- * @internal Exported for use by `ws-handler.ts`, `server.ts`, and `runtime.ts`.
- */
-export type Session = {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    onAudio(data: Uint8Array): void;
-    onAudioReady(): void;
-    onCancel(): void;
-    onReset(): void;
-    onHistory(incoming: readonly {
-        role: "user" | "assistant";
-        content: string;
-    }[]): void;
-    waitForTurn(): Promise<void>;
-};
-/** Configuration options for creating a new S2S voice session. */
-export type S2sSessionOptions = {
-    /** Unique session identifier (used for KV scoping and logging). */
-    id: string;
-    /** Agent slug — identifies which deployed agent this session belongs to. */
-    agent: string;
-    /** Sink for pushing events and audio to the connected browser client. */
-    client: ClientSink;
-    /** Serializable agent config (name, system prompt, greeting, maxSteps, etc.). */
-    agentConfig: AgentConfig;
-    /** JSON Schema definitions for the agent's custom tools. */
-    toolSchemas: readonly ToolSchema[];
-    /** Optional natural-language guidance appended to the system prompt for tool usage. */
-    toolGuidance?: readonly string[];
-    /** AssemblyAI API key — stays host-side, never forwarded to the guest sandbox. */
-    apiKey: string;
-    /** S2S connection config (sample rates, model selection). */
-    s2sConfig: S2SConfig;
-    /** Function to invoke tools by name (wired to direct-executor or sandbox RPC). */
-    executeTool: ExecuteTool;
-    /** Override WebSocket constructor for testing. */
-    createWebSocket?: CreateS2sWebSocket;
-    /** Agent environment variables (secrets). Forwarded to tool context. */
-    env?: Record<string, string | undefined>;
-    /** Skip the initial greeting audio on connect (used for session resume). */
-    skipGreeting?: boolean;
-    /** Logger instance. Defaults to `consoleLogger`. */
-    logger?: Logger;
-    /** Max conversation messages to retain. Defaults to DEFAULT_MAX_HISTORY (200). */
-    maxHistory?: number;
-};
-/** @internal Not part of the public API. Exposed for testing only. */
-export declare const _internals: {
-    connectS2s: typeof connectS2s;
-};
-export declare function createS2sSession(opts: S2sSessionOptions): Session;

package/host/pipeline-session-ctx.test.ts

@@ -1,31 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-import { describe, expect, test } from "vitest";
-import { buildPipelineCtx } from "./pipeline-session-ctx.ts";
-import { consoleLogger } from "./runtime-config.ts";
-
-const baseDeps = {
-  id: "sess-1",
-  agent: "demo",
-  client: { event: () => undefined, playAudioChunk: () => undefined } as never,
-  agentConfig: { name: "demo", systemPrompt: "", maxSteps: 3 } as never,
-  executeTool: (async () => "") as never,
-  log: consoleLogger,
-};
-
-describe("buildPipelineCtx", () => {
-  test("starts with null provider sessions", () => {
-    const ctx = buildPipelineCtx(baseDeps);
-    expect(ctx.stt).toBeNull();
-    expect(ctx.tts).toBeNull();
-  });
-
-  test("pushMessages + beginReply + cancelReply match S2S semantics", () => {
-    const ctx = buildPipelineCtx(baseDeps);
-    ctx.pushMessages({ role: "user", content: "hi" });
-    ctx.beginReply("r1");
-    expect(ctx.reply.currentReplyId).toBe("r1");
-    ctx.cancelReply();
-    expect(ctx.reply.currentReplyId).toBeNull();
-    expect(ctx.conversationMessages).toEqual([{ role: "user", content: "hi" }]);
-  });
-});

package/host/pipeline-session-ctx.ts

@@ -1,36 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/** Pipeline session context — base ctx + STT/TTS session slots. */
-
-import type { AgentConfig, ExecuteTool } from "../sdk/_internal-types.ts";
-import type { ClientSink } from "../sdk/protocol.ts";
-import type { SttSession, TtsSession } from "../sdk/providers.ts";
-import type { Logger } from "./runtime-config.ts";
-import { _buildBaseCtx, type BaseSessionCtx } from "./session-ctx.ts";
-
-/**
- * Pipeline session context — {@link BaseSessionCtx} plus STT/TTS provider
- * session handles. Replaces the S2S `s2s` field with decoupled `stt` + `tts`
- * slots so the pipeline orchestrator can drive independent providers.
- */
-export type PipelineSessionCtx = BaseSessionCtx & {
-  stt: SttSession | null;
-  tts: TtsSession | null;
-};
-
-export function buildPipelineCtx(opts: {
-  id: string;
-  agent: string;
-  client: ClientSink;
-  agentConfig: AgentConfig;
-  executeTool: ExecuteTool;
-  log: Logger;
-  maxHistory?: number | undefined;
-}): PipelineSessionCtx {
-  // Mutate the base ctx in place rather than spreading into a new object —
-  // the helper methods close over the base ctx reference, so spreading would
-  // leave them writing to an orphan object.
-  const base = _buildBaseCtx(opts) as PipelineSessionCtx;
-  base.stt = null;
-  base.tts = null;
-  return base;
-}