@warlock.js/ai-live 5.30.0 → 5.32.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@warlock.js/ai-live` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.32.0 - 2026-10-18
+
+### Changed
+
+- Pin the package development compiler to TypeScript 7.0.2 and use explicit Node types and source roots with supported module resolution.
+
+## 5.31.0 - 2026-10-18
+
+### Changed
+
+- Lockstep release; package APIs are unchanged.
+
 ## 5.30.0 - 2026-10-16
 
 ### Changed
@@ -81,6 +93,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### Changed
 
 - Lockstep release maintenance and dependency refresh.
+
 ## 5.20.0 - 2026-09-24
 
 ### Changed

package/README.md

@@ -15,6 +15,7 @@ import "@warlock.js/ai-live"; // side-effect: lights up ai.realtime + ai.video
 ## What it gives you
 
 ### `ai.realtime(options)` — duplex realtime voice sessions
+
 A **stateful, bidirectional voice session** (OpenAI Realtime-class): stream
 microphone audio in, stream synthesized audio + transcripts + tool-calls out,
 with barge-in. Unlike every other `ai.*` verb (one-shot request → result), this
@@ -25,7 +26,7 @@ endpoint), push audio, and consume an async event stream until you `close()` it
 
 ```ts
 const session = await ai.realtime({
-  transport: openAiRealtime({ apiKey }),   // provider transport (own adapter)
+  transport: openAiRealtime({ apiKey }), // provider transport (own adapter)
   model: "gpt-realtime",
   voice: "alloy",
   instructions: "You are a friendly phone receptionist.",
@@ -40,6 +41,7 @@ const report = await session.close();
 ```
 
 ### `ai.video(params)` — text-to-video generation
+
 Prompt → video (Sora / Veo / Kling-class). Generation is **async** (submit →
 poll), but the adapter hides the polling, so the verb returns the same uniform
 never-throws `{ data, error, usage, report }` envelope as `ai.image`, with
@@ -60,8 +62,8 @@ if (!error) download(data.video); // { type: "url" | "base64", ... }
 - **Heavy / optional deps.** Realtime needs a WebSocket transport (`ws` is an
   optional peer); video pulls long-poll + large-payload handling. Most apps
   using text/image/speech shouldn't carry that weight.
-- **Different shape.** `ai.realtime` is a *session*, not a request; `ai.video`
-  is a *long job*. Isolating them keeps the core verbs simple and synchronous.
+- **Different shape.** `ai.realtime` is a _session_, not a request; `ai.video`
+  is a _long job_. Isolating them keeps the core verbs simple and synchronous.
 - **Same contracts.** Both still produce a `BaseReport` (`type: "realtime"` /
   `"video"`) and route through the shared `observe` seam, so panoptic and the
   cost tree pick them up for free.

package/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["AIError","ProviderError","REPORT_SCHEMA_VERSION"],"sources":["../../../../../../../packages/ai-live/src/realtime/realtime.ts","../../../../../../../packages/ai-live/src/video/video.ts","../../../../../../../packages/ai-live/src/mock/index.ts","../../../../../../../packages/ai-live/src/index.ts"],"sourcesContent":["import { generateRunId } from \"@warlock.js/ai\";\nimport type {\n  RealtimeOptions,\n  RealtimeReport,\n  RealtimeSession,\n} from \"../contracts/realtime.contract\";\n\n/**\n * Open a live duplex voice session — the stateful primitive of\n * `@warlock.js/ai-live`. Connects through the provided\n * {@link RealtimeOptions.transport} (an OpenAI Realtime WebSocket\n * adapter, a mock in tests), then hands back a {@link RealtimeSession}\n * you drive: push audio/text in, consume the event stream out, and\n * `close()` to end it and receive a `type: \"realtime\"` report for the\n * cost/observability surfaces.\n *\n * Unlike the one-shot `ai.*` verbs, this returns a long-lived session —\n * its closest sibling is `ai.orchestrator`. Keeping the transport\n * pluggable is what lets the session surface ship without hard-wiring a\n * WebSocket dependency.\n *\n * @example\n * const session = await ai.realtime({ transport, model: \"gpt-realtime\", voice: \"alloy\" });\n * session.sendAudio(micChunk, \"audio/pcm\");\n * for await (const event of session.events()) {\n *   if (event.type === \"audio\") speaker.write(event.base64);\n * }\n * const report = await session.close();\n */\nexport async function realtime(options: RealtimeOptions): Promise<RealtimeSession> {\n  const runId = generateRunId(\"realtime\");\n  const startedAt = new Date().toISOString();\n  const startPerf = performance.now();\n\n  const connection = await options.transport.connect({\n    model: options.model,\n    voice: options.voice,\n    instructions: options.instructions,\n  });\n\n  let report: RealtimeReport | undefined;\n\n  return {\n    sendAudio: (base64, mediaType) => connection.sendAudio(base64, mediaType),\n    sendText: (text) => connection.sendText(text),\n    events: () => connection.events(),\n    async close(): Promise<RealtimeReport> {\n      // Idempotent — closing twice returns the first report, never\n      // re-tears-down the connection.\n      if (report) {\n        return report;\n      }\n\n      await connection.close();\n\n      report = {\n        runId,\n        rootRunId: runId,\n        type: \"realtime\",\n        name: options.name ?? \"realtime\",\n        status: \"completed\",\n        startedAt,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        ...(options.sessionId ? { sessionId: options.sessionId } : {}),\n      };\n\n      return report;\n    },\n  };\n}\n","import {\n  AIError,\n  computeCost,\n  generateRunId,\n  ProviderError,\n  REPORT_SCHEMA_VERSION,\n  resolveObservers,\n  stampReportLineage,\n  type BaseReport,\n  type ExecuteResult,\n  type FlowObserveOption,\n  type ModelPricing,\n  type Usage,\n} from \"@warlock.js/ai\";\nimport type {\n  GeneratedVideo,\n  VideoModelContract,\n  VideoModelPricing,\n} from \"../contracts/video.contract\";\n\n/** Parameters for {@link video}. `model` comes from an adapter's `video({ name })`. */\nexport type VideoParams = {\n  model: VideoModelContract;\n  prompt: string;\n  durationSeconds?: number;\n  aspectRatio?: string;\n  resolution?: string;\n  negativePrompt?: string;\n  signal?: AbortSignal;\n  observe?: FlowObserveOption;\n  sessionId?: string;\n  name?: string;\n  options?: Record<string, unknown>;\n};\n\n/** Success payload of a {@link video} run. */\nexport type VideoData = { video: GeneratedVideo };\n\n/** The report node a {@link video} run produces (`type: \"video\"`). */\nexport type VideoReport = BaseReport & {\n  type: \"video\";\n  model: { name: string; provider: string };\n  /** Final clip duration in seconds, when reported. */\n  durationSeconds?: number;\n};\n\n/** Result envelope of {@link video} — the uniform `{ data, error, usage, report }`. */\nexport type VideoResult = ExecuteResult<VideoData> & { type: \"video\"; report: VideoReport };\n\n/**\n * Generate a video from a text prompt — the moving-image verb of the\n * output-modality track. The adapter hides the provider's submit→poll\n * job, so this returns the framework's uniform never-throws envelope:\n *\n * - **Never throws.** Provider failures surface as a typed `AIError`.\n * - **Cost-truth.** `usage.cost` is filled per-second (Sora / Veo) or\n *   per-token, folding into the same `Usage.cost` rollup as everything else.\n * - **Observable.** The completed {@link VideoReport} routes to any\n *   registered `Observer` via the shared `observe` seam.\n *\n * @example\n * const { data, error } = await ai.video({\n *   model: sora.video({ name: \"sora-2\", pricing: { perSecond: 0.1 } }),\n *   prompt: \"a timelapse of a city skyline at dusk, cinematic\",\n *   durationSeconds: 8,\n * });\n * if (!error) download(data.video);\n */\nexport async function video(params: VideoParams): Promise<VideoResult> {\n  const { model, prompt } = params;\n\n  const runId = generateRunId(\"video\");\n  const startedAt = new Date().toISOString();\n  const startPerf = performance.now();\n\n  const usage: Usage = { input: 0, output: 0, total: 0 };\n  let data: VideoData | undefined;\n  let error: AIError | undefined;\n  let status: VideoReport[\"status\"] = \"completed\";\n  let durationSeconds: number | undefined;\n\n  try {\n    const response = await model.generate(prompt, {\n      durationSeconds: params.durationSeconds,\n      aspectRatio: params.aspectRatio,\n      resolution: params.resolution,\n      negativePrompt: params.negativePrompt,\n      signal: params.signal,\n      ...params.options,\n    });\n\n    Object.assign(usage, response.usage);\n    durationSeconds = response.durationSeconds;\n\n    if (usage.cost === undefined) {\n      const cost = computeVideoCost(usage, durationSeconds, model.pricing);\n      if (cost !== undefined) {\n        usage.cost = cost;\n      }\n    }\n\n    data = { video: response.video };\n  } catch (thrown) {\n    error =\n      thrown instanceof AIError ? thrown : new ProviderError(toMessage(thrown), { cause: thrown });\n    status = params.signal?.aborted ? \"cancelled\" : \"failed\";\n  }\n\n  const report: VideoReport = {\n    runId,\n    rootRunId: runId,\n    name: params.name ?? \"video\",\n    type: \"video\",\n    status,\n    error,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    usage,\n    children: [],\n    model: { name: model.name, provider: model.provider },\n    ...(durationSeconds !== undefined ? { durationSeconds } : {}),\n    reportSchemaVersion: REPORT_SCHEMA_VERSION,\n  };\n\n  stampReportLineage(report, { rootRunId: runId, sessionId: params.sessionId });\n\n  for (const observer of resolveObservers(params.observe)) {\n    try {\n      await observer.collect(report);\n    } catch {\n      // Isolate observer failures — never break the run.\n    }\n  }\n\n  return { type: \"video\", data, error, usage, report };\n}\n\n/**\n * Price a video run: `perSecond × durationSeconds` (per-second metering,\n * attributed to `cost.output`) wins when configured, otherwise the\n * standard token math. Returns `undefined` when no usable pricing is\n * present.\n */\nfunction computeVideoCost(\n  usage: Usage,\n  durationSeconds: number | undefined,\n  pricing: VideoModelPricing | undefined,\n): ModelPricing | undefined {\n  if (!pricing) {\n    return undefined;\n  }\n\n  if (pricing.perSecond !== undefined) {\n    if (durationSeconds === undefined) {\n      return undefined;\n    }\n    return { input: 0, output: durationSeconds * pricing.perSecond };\n  }\n\n  if (pricing.input !== undefined && pricing.output !== undefined) {\n    return computeCost(usage, { input: pricing.input, output: pricing.output });\n  }\n\n  return undefined;\n}\n\n/** Best-effort message for a non-`AIError` thrown value. */\nfunction toMessage(thrown: unknown): string {\n  return thrown instanceof Error ? thrown.message : String(thrown);\n}\n","import type { Usage } from \"@warlock.js/ai\";\nimport type {\n  RealtimeConnectConfig,\n  RealtimeConnection,\n  RealtimeEvent,\n  RealtimeTransport,\n} from \"../contracts/realtime.contract\";\nimport type {\n  GeneratedVideo,\n  VideoGenerationResponse,\n  VideoModelContract,\n  VideoModelPricing,\n  VideoOptions,\n} from \"../contracts/video.contract\";\n\n/** One scripted response for a {@link MockVideoModel}. */\nexport type MockVideoResponse = {\n  video?: GeneratedVideo;\n  usage?: Usage;\n  durationSeconds?: number;\n  error?: Error;\n};\n\n/** Deterministic {@link VideoModelContract} double for tests — no HTTP, no polling. */\nexport class MockVideoModel implements VideoModelContract {\n  public readonly provider = \"mock\";\n  public readonly calls: { prompt: string; options: VideoOptions | undefined }[] = [];\n\n  private callIndex = 0;\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockVideoResponse[],\n    public readonly pricing?: VideoModelPricing,\n  ) {}\n\n  public async generate(\n    prompt: string,\n    options?: VideoOptions,\n  ): Promise<VideoGenerationResponse> {\n    this.calls.push({ prompt, options });\n\n    const response = this.responses[Math.min(this.callIndex, this.responses.length - 1)] ?? {};\n    this.callIndex += 1;\n\n    if (response.error) {\n      throw response.error;\n    }\n\n    return {\n      video: response.video ?? { type: \"url\", url: \"https://mock/video.mp4\", mediaType: \"video/mp4\" },\n      usage: response.usage ?? { input: 0, output: 0, total: 0 },\n      durationSeconds: response.durationSeconds ?? options?.durationSeconds ?? 5,\n    };\n  }\n}\n\n/** A recording {@link RealtimeConnection} the mock transport hands back. */\nexport class MockRealtimeConnection implements RealtimeConnection {\n  public readonly sentAudio: { base64: string; mediaType: string }[] = [];\n  public readonly sentText: string[] = [];\n  public closed = false;\n\n  public constructor(private readonly scripted: RealtimeEvent[]) {}\n\n  public sendAudio(base64: string, mediaType: string): void {\n    this.sentAudio.push({ base64, mediaType });\n  }\n\n  public sendText(text: string): void {\n    this.sentText.push(text);\n  }\n\n  public async *events(): AsyncIterable<RealtimeEvent> {\n    for (const event of this.scripted) {\n      yield event;\n    }\n  }\n\n  public async close(): Promise<void> {\n    this.closed = true;\n  }\n}\n\n/** Deterministic {@link RealtimeTransport} double — scripts the event stream, records sends. */\nexport class MockRealtimeTransport implements RealtimeTransport {\n  public readonly connectConfigs: RealtimeConnectConfig[] = [];\n  public lastConnection?: MockRealtimeConnection;\n\n  public constructor(private readonly scriptedEvents: RealtimeEvent[] = []) {}\n\n  public async connect(config: RealtimeConnectConfig): Promise<RealtimeConnection> {\n    this.connectConfigs.push(config);\n    this.lastConnection = new MockRealtimeConnection(this.scriptedEvents);\n    return this.lastConnection;\n  }\n}\n","import { ai } from \"@warlock.js/ai\";\nimport { realtime } from \"./realtime/realtime\";\nimport { video } from \"./video/video\";\n\n/**\n * Augment the shared `Ai` facade with this package's two heavy\n * modalities. Importing `@warlock.js/ai-live` mounts `ai.video` +\n * `ai.realtime` as a side effect, mirroring how `@warlock.js/ai-tools`\n * mounts `ai.mcp` / `ai.tools` and `@warlock.js/ai-workspace` mounts\n * `ai.workspace`.\n */\ndeclare module \"@warlock.js/ai\" {\n  interface Ai {\n    /**\n     * Text-to-video generation (Sora / Veo / Kling-class). Async under\n     * the hood (submit→poll), surfaced as the uniform never-throws\n     * `{ data, error, usage, report }` envelope. Ships in `@warlock.js/ai-live`.\n     */\n    video: typeof video;\n    /**\n     * Live duplex voice sessions (OpenAI Realtime-class). A stateful\n     * session over a pluggable transport — push audio/text in, consume\n     * events out, `close()` for a report. Ships in `@warlock.js/ai-live`.\n     */\n    realtime: typeof realtime;\n  }\n}\n\nai.video = video;\nai.realtime = realtime;\n\nexport { realtime, video };\nexport type { VideoData, VideoParams, VideoReport, VideoResult } from \"./video/video\";\nexport * from \"./contracts/video.contract\";\nexport * from \"./contracts/realtime.contract\";\nexport * from \"./mock\";\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["generateRunId","generateRunId","AIError","ProviderError","REPORT_SCHEMA_VERSION","resolveObservers","computeCost"],"sources":["../../../../../../../packages/ai-live/src/realtime/realtime.ts","../../../../../../../packages/ai-live/src/video/video.ts","../../../../../../../packages/ai-live/src/mock/index.ts","../../../../../../../packages/ai-live/src/index.ts"],"sourcesContent":["import { generateRunId } from \"@warlock.js/ai\";\nimport type {\n  RealtimeOptions,\n  RealtimeReport,\n  RealtimeSession,\n} from \"../contracts/realtime.contract\";\n\n/**\n * Open a live duplex voice session — the stateful primitive of\n * `@warlock.js/ai-live`. Connects through the provided\n * {@link RealtimeOptions.transport} (an OpenAI Realtime WebSocket\n * adapter, a mock in tests), then hands back a {@link RealtimeSession}\n * you drive: push audio/text in, consume the event stream out, and\n * `close()` to end it and receive a `type: \"realtime\"` report for the\n * cost/observability surfaces.\n *\n * Unlike the one-shot `ai.*` verbs, this returns a long-lived session —\n * its closest sibling is `ai.orchestrator`. Keeping the transport\n * pluggable is what lets the session surface ship without hard-wiring a\n * WebSocket dependency.\n *\n * @example\n * const session = await ai.realtime({ transport, model: \"gpt-realtime\", voice: \"alloy\" });\n * session.sendAudio(micChunk, \"audio/pcm\");\n * for await (const event of session.events()) {\n *   if (event.type === \"audio\") speaker.write(event.base64);\n * }\n * const report = await session.close();\n */\nexport async function realtime(options: RealtimeOptions): Promise<RealtimeSession> {\n  const runId = generateRunId(\"realtime\");\n  const startedAt = new Date().toISOString();\n  const startPerf = performance.now();\n\n  const connection = await options.transport.connect({\n    model: options.model,\n    voice: options.voice,\n    instructions: options.instructions,\n  });\n\n  let report: RealtimeReport | undefined;\n\n  return {\n    sendAudio: (base64, mediaType) => connection.sendAudio(base64, mediaType),\n    sendText: (text) => connection.sendText(text),\n    events: () => connection.events(),\n    async close(): Promise<RealtimeReport> {\n      // Idempotent — closing twice returns the first report, never\n      // re-tears-down the connection.\n      if (report) {\n        return report;\n      }\n\n      await connection.close();\n\n      report = {\n        runId,\n        rootRunId: runId,\n        type: \"realtime\",\n        name: options.name ?? \"realtime\",\n        status: \"completed\",\n        startedAt,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - startPerf,\n        ...(options.sessionId ? { sessionId: options.sessionId } : {}),\n      };\n\n      return report;\n    },\n  };\n}\n","import {\n  AIError,\n  computeCost,\n  generateRunId,\n  ProviderError,\n  REPORT_SCHEMA_VERSION,\n  resolveObservers,\n  stampReportLineage,\n  type BaseReport,\n  type ExecuteResult,\n  type FlowObserveOption,\n  type ModelPricing,\n  type Usage,\n} from \"@warlock.js/ai\";\nimport type {\n  GeneratedVideo,\n  VideoModelContract,\n  VideoModelPricing,\n} from \"../contracts/video.contract\";\n\n/** Parameters for {@link video}. `model` comes from an adapter's `video({ name })`. */\nexport type VideoParams = {\n  model: VideoModelContract;\n  prompt: string;\n  durationSeconds?: number;\n  aspectRatio?: string;\n  resolution?: string;\n  negativePrompt?: string;\n  signal?: AbortSignal;\n  observe?: FlowObserveOption;\n  sessionId?: string;\n  name?: string;\n  options?: Record<string, unknown>;\n};\n\n/** Success payload of a {@link video} run. */\nexport type VideoData = { video: GeneratedVideo };\n\n/** The report node a {@link video} run produces (`type: \"video\"`). */\nexport type VideoReport = BaseReport & {\n  type: \"video\";\n  model: { name: string; provider: string };\n  /** Final clip duration in seconds, when reported. */\n  durationSeconds?: number;\n};\n\n/** Result envelope of {@link video} — the uniform `{ data, error, usage, report }`. */\nexport type VideoResult = ExecuteResult<VideoData> & { type: \"video\"; report: VideoReport };\n\n/**\n * Generate a video from a text prompt — the moving-image verb of the\n * output-modality track. The adapter hides the provider's submit→poll\n * job, so this returns the framework's uniform never-throws envelope:\n *\n * - **Never throws.** Provider failures surface as a typed `AIError`.\n * - **Cost-truth.** `usage.cost` is filled per-second (Sora / Veo) or\n *   per-token, folding into the same `Usage.cost` rollup as everything else.\n * - **Observable.** The completed {@link VideoReport} routes to any\n *   registered `Observer` via the shared `observe` seam.\n *\n * @example\n * const { data, error } = await ai.video({\n *   model: sora.video({ name: \"sora-2\", pricing: { perSecond: 0.1 } }),\n *   prompt: \"a timelapse of a city skyline at dusk, cinematic\",\n *   durationSeconds: 8,\n * });\n * if (!error) download(data.video);\n */\nexport async function video(params: VideoParams): Promise<VideoResult> {\n  const { model, prompt } = params;\n\n  const runId = generateRunId(\"video\");\n  const startedAt = new Date().toISOString();\n  const startPerf = performance.now();\n\n  const usage: Usage = { input: 0, output: 0, total: 0 };\n  let data: VideoData | undefined;\n  let error: AIError | undefined;\n  let status: VideoReport[\"status\"] = \"completed\";\n  let durationSeconds: number | undefined;\n\n  try {\n    const response = await model.generate(prompt, {\n      durationSeconds: params.durationSeconds,\n      aspectRatio: params.aspectRatio,\n      resolution: params.resolution,\n      negativePrompt: params.negativePrompt,\n      signal: params.signal,\n      ...params.options,\n    });\n\n    Object.assign(usage, response.usage);\n    durationSeconds = response.durationSeconds;\n\n    if (usage.cost === undefined) {\n      const cost = computeVideoCost(usage, durationSeconds, model.pricing);\n      if (cost !== undefined) {\n        usage.cost = cost;\n      }\n    }\n\n    data = { video: response.video };\n  } catch (thrown) {\n    error =\n      thrown instanceof AIError ? thrown : new ProviderError(toMessage(thrown), { cause: thrown });\n    status = params.signal?.aborted ? \"cancelled\" : \"failed\";\n  }\n\n  const report: VideoReport = {\n    runId,\n    rootRunId: runId,\n    name: params.name ?? \"video\",\n    type: \"video\",\n    status,\n    error,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    usage,\n    children: [],\n    model: { name: model.name, provider: model.provider },\n    ...(durationSeconds !== undefined ? { durationSeconds } : {}),\n    reportSchemaVersion: REPORT_SCHEMA_VERSION,\n  };\n\n  stampReportLineage(report, { rootRunId: runId, sessionId: params.sessionId });\n\n  for (const observer of resolveObservers(params.observe)) {\n    try {\n      await observer.collect(report);\n    } catch {\n      // Isolate observer failures — never break the run.\n    }\n  }\n\n  return { type: \"video\", data, error, usage, report };\n}\n\n/**\n * Price a video run: `perSecond × durationSeconds` (per-second metering,\n * attributed to `cost.output`) wins when configured, otherwise the\n * standard token math. Returns `undefined` when no usable pricing is\n * present.\n */\nfunction computeVideoCost(\n  usage: Usage,\n  durationSeconds: number | undefined,\n  pricing: VideoModelPricing | undefined,\n): ModelPricing | undefined {\n  if (!pricing) {\n    return undefined;\n  }\n\n  if (pricing.perSecond !== undefined) {\n    if (durationSeconds === undefined) {\n      return undefined;\n    }\n    return { input: 0, output: durationSeconds * pricing.perSecond };\n  }\n\n  if (pricing.input !== undefined && pricing.output !== undefined) {\n    return computeCost(usage, { input: pricing.input, output: pricing.output });\n  }\n\n  return undefined;\n}\n\n/** Best-effort message for a non-`AIError` thrown value. */\nfunction toMessage(thrown: unknown): string {\n  return thrown instanceof Error ? thrown.message : String(thrown);\n}\n","import type { Usage } from \"@warlock.js/ai\";\nimport type {\n  RealtimeConnectConfig,\n  RealtimeConnection,\n  RealtimeEvent,\n  RealtimeTransport,\n} from \"../contracts/realtime.contract\";\nimport type {\n  GeneratedVideo,\n  VideoGenerationResponse,\n  VideoModelContract,\n  VideoModelPricing,\n  VideoOptions,\n} from \"../contracts/video.contract\";\n\n/** One scripted response for a {@link MockVideoModel}. */\nexport type MockVideoResponse = {\n  video?: GeneratedVideo;\n  usage?: Usage;\n  durationSeconds?: number;\n  error?: Error;\n};\n\n/** Deterministic {@link VideoModelContract} double for tests — no HTTP, no polling. */\nexport class MockVideoModel implements VideoModelContract {\n  public readonly provider = \"mock\";\n  public readonly calls: { prompt: string; options: VideoOptions | undefined }[] = [];\n\n  private callIndex = 0;\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockVideoResponse[],\n    public readonly pricing?: VideoModelPricing,\n  ) {}\n\n  public async generate(prompt: string, options?: VideoOptions): Promise<VideoGenerationResponse> {\n    this.calls.push({ prompt, options });\n\n    const response = this.responses[Math.min(this.callIndex, this.responses.length - 1)] ?? {};\n    this.callIndex += 1;\n\n    if (response.error) {\n      throw response.error;\n    }\n\n    return {\n      video: response.video ?? {\n        type: \"url\",\n        url: \"https://mock/video.mp4\",\n        mediaType: \"video/mp4\",\n      },\n      usage: response.usage ?? { input: 0, output: 0, total: 0 },\n      durationSeconds: response.durationSeconds ?? options?.durationSeconds ?? 5,\n    };\n  }\n}\n\n/** A recording {@link RealtimeConnection} the mock transport hands back. */\nexport class MockRealtimeConnection implements RealtimeConnection {\n  public readonly sentAudio: { base64: string; mediaType: string }[] = [];\n  public readonly sentText: string[] = [];\n  public closed = false;\n\n  public constructor(private readonly scripted: RealtimeEvent[]) {}\n\n  public sendAudio(base64: string, mediaType: string): void {\n    this.sentAudio.push({ base64, mediaType });\n  }\n\n  public sendText(text: string): void {\n    this.sentText.push(text);\n  }\n\n  public async *events(): AsyncIterable<RealtimeEvent> {\n    for (const event of this.scripted) {\n      yield event;\n    }\n  }\n\n  public async close(): Promise<void> {\n    this.closed = true;\n  }\n}\n\n/** Deterministic {@link RealtimeTransport} double — scripts the event stream, records sends. */\nexport class MockRealtimeTransport implements RealtimeTransport {\n  public readonly connectConfigs: RealtimeConnectConfig[] = [];\n  public lastConnection?: MockRealtimeConnection;\n\n  public constructor(private readonly scriptedEvents: RealtimeEvent[] = []) {}\n\n  public async connect(config: RealtimeConnectConfig): Promise<RealtimeConnection> {\n    this.connectConfigs.push(config);\n    this.lastConnection = new MockRealtimeConnection(this.scriptedEvents);\n    return this.lastConnection;\n  }\n}\n","import { ai } from \"@warlock.js/ai\";\nimport { realtime } from \"./realtime/realtime\";\nimport { video } from \"./video/video\";\n\n/**\n * Augment the shared `Ai` facade with this package's two heavy\n * modalities. Importing `@warlock.js/ai-live` mounts `ai.video` +\n * `ai.realtime` as a side effect, mirroring how `@warlock.js/ai-tools`\n * mounts `ai.mcp` / `ai.tools` and `@warlock.js/ai-workspace` mounts\n * `ai.workspace`.\n */\ndeclare module \"@warlock.js/ai\" {\n  interface Ai {\n    /**\n     * Text-to-video generation (Sora / Veo / Kling-class). Async under\n     * the hood (submit→poll), surfaced as the uniform never-throws\n     * `{ data, error, usage, report }` envelope. Ships in `@warlock.js/ai-live`.\n     */\n    video: typeof video;\n    /**\n     * Live duplex voice sessions (OpenAI Realtime-class). A stateful\n     * session over a pluggable transport — push audio/text in, consume\n     * events out, `close()` for a report. Ships in `@warlock.js/ai-live`.\n     */\n    realtime: typeof realtime;\n  }\n}\n\nai.video = video;\nai.realtime = realtime;\n\nexport { realtime, video };\nexport type { VideoData, VideoParams, VideoReport, VideoResult } from \"./video/video\";\nexport * from \"./contracts/video.contract\";\nexport * from \"./contracts/realtime.contract\";\nexport * from \"./mock\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,eAAsB,SAAS,SAAoD;CACjF,MAAM,YAAQA,8BAAc,UAAU;CACtC,MAAM,6BAAY,IAAI,KAAK,EAAC,CAAC,YAAY;CACzC,MAAM,YAAY,YAAY,IAAI;CAElC,MAAM,aAAa,MAAM,QAAQ,UAAU,QAAQ;EACjD,OAAO,QAAQ;EACf,OAAO,QAAQ;EACf,cAAc,QAAQ;CACxB,CAAC;CAED,IAAI;CAEJ,OAAO;EACL,YAAY,QAAQ,cAAc,WAAW,UAAU,QAAQ,SAAS;EACxE,WAAW,SAAS,WAAW,SAAS,IAAI;EAC5C,cAAc,WAAW,OAAO;EAChC,MAAM,QAAiC;GAGrC,IAAI,QACF,OAAO;GAGT,MAAM,WAAW,MAAM;GAEvB,SAAS;IACP;IACA,WAAW;IACX,MAAM;IACN,MAAM,QAAQ,QAAQ;IACtB,QAAQ;IACR;IACA,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;IAChC,UAAU,YAAY,IAAI,IAAI;IAC9B,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;GAC9D;GAEA,OAAO;EACT;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;ACFA,eAAsB,MAAM,QAA2C;CACrE,MAAM,EAAE,OAAO,WAAW;CAE1B,MAAM,YAAQC,8BAAc,OAAO;CACnC,MAAM,6BAAY,IAAI,KAAK,EAAC,CAAC,YAAY;CACzC,MAAM,YAAY,YAAY,IAAI;CAElC,MAAM,QAAe;EAAE,OAAO;EAAG,QAAQ;EAAG,OAAO;CAAE;CACrD,IAAI;CACJ,IAAI;CACJ,IAAI,SAAgC;CACpC,IAAI;CAEJ,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,SAAS,QAAQ;GAC5C,iBAAiB,OAAO;GACxB,aAAa,OAAO;GACpB,YAAY,OAAO;GACnB,gBAAgB,OAAO;GACvB,QAAQ,OAAO;GACf,GAAG,OAAO;EACZ,CAAC;EAED,OAAO,OAAO,OAAO,SAAS,KAAK;EACnC,kBAAkB,SAAS;EAE3B,IAAI,MAAM,SAAS,QAAW;GAC5B,MAAM,OAAO,iBAAiB,OAAO,iBAAiB,MAAM,OAAO;GACnE,IAAI,SAAS,QACX,MAAM,OAAO;EAEjB;EAEA,OAAO,EAAE,OAAO,SAAS,MAAM;CACjC,SAAS,QAAQ;EACf,QACE,kBAAkBC,yBAAU,SAAS,IAAIC,6BAAc,UAAU,MAAM,GAAG,EAAE,OAAO,OAAO,CAAC;EAC7F,SAAS,OAAO,QAAQ,UAAU,cAAc;CAClD;CAEA,MAAM,SAAsB;EAC1B;EACA,WAAW;EACX,MAAM,OAAO,QAAQ;EACrB,MAAM;EACN;EACA;EACA;EACA,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;EAChC,UAAU,YAAY,IAAI,IAAI;EAC9B;EACA,UAAU,CAAC;EACX,OAAO;GAAE,MAAM,MAAM;GAAM,UAAU,MAAM;EAAS;EACpD,GAAI,oBAAoB,SAAY,EAAE,gBAAgB,IAAI,CAAC;EAC3D,qBAAqBC;CACvB;CAEA,uCAAmB,QAAQ;EAAE,WAAW;EAAO,WAAW,OAAO;CAAU,CAAC;CAE5E,KAAK,MAAM,gBAAYC,iCAAiB,OAAO,OAAO,GACpD,IAAI;EACF,MAAM,SAAS,QAAQ,MAAM;CAC/B,QAAQ,CAER;CAGF,OAAO;EAAE,MAAM;EAAS;EAAM;EAAO;EAAO;CAAO;AACrD;;;;;;;AAQA,SAAS,iBACP,OACA,iBACA,SAC0B;CAC1B,IAAI,CAAC,SACH;CAGF,IAAI,QAAQ,cAAc,QAAW;EACnC,IAAI,oBAAoB,QACtB;EAEF,OAAO;GAAE,OAAO;GAAG,QAAQ,kBAAkB,QAAQ;EAAU;CACjE;CAEA,IAAI,QAAQ,UAAU,UAAa,QAAQ,WAAW,QACpD,WAAOC,4BAAY,OAAO;EAAE,OAAO,QAAQ;EAAO,QAAQ,QAAQ;CAAO,CAAC;AAI9E;;AAGA,SAAS,UAAU,QAAyB;CAC1C,OAAO,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM;AACjE;;;;;AClJA,IAAa,iBAAb,MAA0D;CAMxD,AAAO,YACL,AAAgB,MAChB,AAAiB,WACjB,AAAgB,SAChB;EAHgB;EACC;EACD;kBARS;eACsD,CAAC;mBAE9D;CAMjB;CAEH,MAAa,SAAS,QAAgB,SAA0D;EAC9F,KAAK,MAAM,KAAK;GAAE;GAAQ;EAAQ,CAAC;EAEnC,MAAM,WAAW,KAAK,UAAU,KAAK,IAAI,KAAK,WAAW,KAAK,UAAU,SAAS,CAAC,MAAM,CAAC;EACzF,KAAK,aAAa;EAElB,IAAI,SAAS,OACX,MAAM,SAAS;EAGjB,OAAO;GACL,OAAO,SAAS,SAAS;IACvB,MAAM;IACN,KAAK;IACL,WAAW;GACb;GACA,OAAO,SAAS,SAAS;IAAE,OAAO;IAAG,QAAQ;IAAG,OAAO;GAAE;GACzD,iBAAiB,SAAS,mBAAmB,SAAS,mBAAmB;EAC3E;CACF;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAKhE,AAAO,YAAY,AAAiB,UAA2B;EAA3B;mBAJiC,CAAC;kBACjC,CAAC;gBACtB;CAEgD;CAEhE,AAAO,UAAU,QAAgB,WAAyB;EACxD,KAAK,UAAU,KAAK;GAAE;GAAQ;EAAU,CAAC;CAC3C;CAEA,AAAO,SAAS,MAAoB;EAClC,KAAK,SAAS,KAAK,IAAI;CACzB;CAEA,OAAc,SAAuC;EACnD,KAAK,MAAM,SAAS,KAAK,UACvB,MAAM;CAEV;CAEA,MAAa,QAAuB;EAClC,KAAK,SAAS;CAChB;AACF;;AAGA,IAAa,wBAAb,MAAgE;CAI9D,AAAO,YAAY,AAAiB,iBAAkC,CAAC,GAAG;EAAtC;wBAHsB,CAAC;CAGgB;CAE3E,MAAa,QAAQ,QAA4D;EAC/E,KAAK,eAAe,KAAK,MAAM;EAC/B,KAAK,iBAAiB,IAAI,uBAAuB,KAAK,cAAc;EACpE,OAAO,KAAK;CACd;AACF;;;;ACrEA,kBAAG,QAAQ;AACX,kBAAG,WAAW"}

package/esm/contracts/realtime.contract.d.mts

@@ -1,5 +1,4 @@
 import { AIError } from "@warlock.js/ai";
-
 //#region ../../packages/ai-live/src/contracts/realtime.contract.d.ts
 /**
  * One event streamed out of a realtime voice session. A closed union so
@@ -11,7 +10,7 @@ import { AIError } from "@warlock.js/ai";
  * - `error` — a typed, non-fatal provider/transport error.
  * - `done` — the session ended (server-side).
  */
-type RealtimeEvent = {
+export type RealtimeEvent = {
   type: "audio";
   base64: string;
   mediaType: string;
@@ -32,9 +31,12 @@ type RealtimeEvent = {
   type: "done";
 };
 /** Config a {@link RealtimeTransport} needs to open a connection. */
-type RealtimeConnectConfig = {
-  /** Realtime model id (e.g. `"gpt-realtime"`). */model: string; /** Default voice. */
-  voice?: string; /** System instructions for the session. */
+export type RealtimeConnectConfig = {
+  /** Realtime model id (e.g. `"gpt-realtime"`). */
+  model: string;
+  /** Default voice. */
+  voice?: string;
+  /** System instructions for the session. */
   instructions?: string;
 };
 /**
@@ -44,7 +46,7 @@ type RealtimeConnectConfig = {
  * mock transport drives the tests. Keeping this pluggable is what lets
  * `ai-live` ship the session surface without hard-wiring `ws`.
  */
-interface RealtimeConnection {
+export interface RealtimeConnection {
   /** Push a chunk of microphone audio (base64) upstream. */
   sendAudio(base64: string, mediaType: string): void;
   /** Push a text message upstream (the model can reply with audio). */
@@ -55,16 +57,22 @@ interface RealtimeConnection {
   close(): Promise<void>;
 }
 /** Opens a {@link RealtimeConnection}. Implemented per provider. */
-interface RealtimeTransport {
+export interface RealtimeTransport {
   connect(config: RealtimeConnectConfig): Promise<RealtimeConnection>;
 }
 /** Options for {@link ai.realtime}. */
-type RealtimeOptions = {
-  /** The provider transport (e.g. an OpenAI Realtime WebSocket adapter). */transport: RealtimeTransport; /** Realtime model id. */
-  model: string; /** Default voice. */
-  voice?: string; /** System instructions for the session. */
-  instructions?: string; /** Groups this session into a wider request for cost/trace queries. */
-  sessionId?: string; /** Report node name (defaults to `"realtime"`). */
+export type RealtimeOptions = {
+  /** The provider transport (e.g. an OpenAI Realtime WebSocket adapter). */
+  transport: RealtimeTransport;
+  /** Realtime model id. */
+  model: string;
+  /** Default voice. */
+  voice?: string;
+  /** System instructions for the session. */
+  instructions?: string;
+  /** Groups this session into a wider request for cost/trace queries. */
+  sessionId?: string;
+  /** Report node name (defaults to `"realtime"`). */
   name?: string;
 };
 /**
@@ -73,7 +81,7 @@ type RealtimeOptions = {
  * `close()` to end the session and get a report for cost + observability.
  * Its closest sibling is `ai.orchestrator` (a session, not a one-shot).
  */
-interface RealtimeSession {
+export interface RealtimeSession {
   /** Push microphone audio (base64) into the session. */
   sendAudio(base64: string, mediaType: string): void;
   /** Push a text turn into the session. */
@@ -88,7 +96,7 @@ interface RealtimeSession {
  * `type: "realtime"` node for the trace/cost surfaces. (Realtime usage
  * accounting is provider-dependent and refined as transports land.)
  */
-type RealtimeReport = {
+export type RealtimeReport = {
   runId: string;
   rootRunId: string;
   type: "realtime";
@@ -100,5 +108,4 @@ type RealtimeReport = {
   sessionId?: string;
 };
 //#endregion
-export { RealtimeConnectConfig, RealtimeConnection, RealtimeEvent, RealtimeOptions, RealtimeReport, RealtimeSession, RealtimeTransport };
 //# sourceMappingURL=realtime.contract.d.mts.map

package/esm/contracts/realtime.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/contracts/realtime.contract.ts"],"mappings":";;;;;AAYA;;;;;;;;KAAY,aAAA;EACN,IAAA;EAAe,MAAA;EAAgB,SAAA;AAAA;EAC/B,IAAA;EAAoB,IAAA;EAA4B,IAAA;EAAc,KAAA;AAAA;EAC9D,IAAA;EAAmB,EAAA;EAAY,IAAA;EAAc,KAAA;AAAA;EAC7C,IAAA;EAAe,KAAA,EAAO,OAAO;AAAA;EAC7B,IAAA;AAAA;;KAGM,qBAAA;EAgBK,iDAdf,KAAA;EAEA,KAAA,WAkBU;EAhBV,YAAA;AAAA;;;;;;;;UAUe,kBAAA;EAMS;EAJxB,SAAA,CAAU,MAAA,UAAgB,SAAA;EAMjB;EAJT,QAAA,CAAS,IAAA;EAIO;EAFhB,MAAA,IAAU,aAAA,CAAc,aAAA;EAMQ;EAJhC,KAAA,IAAS,OAAA;AAAA;;UAIM,iBAAA;EACf,OAAA,CAAQ,MAAA,EAAQ,qBAAA,GAAwB,OAAA,CAAQ,kBAAA;AAAA;;KAItC,eAAA;EAJF,0EAMR,SAAA,EAAW,iBAAiB,EANoB;EAQhD,KAAA,UARkE;EAUlE,KAAA,WANyB;EAQzB,YAAA,WAN4B;EAQ5B,SAAA,WARW;EAUX,IAAA;AAAA;;;;;AAAI;AASN;UAAiB,eAAA;;EAEf,SAAA,CAAU,MAAA,UAAgB,SAAA;EAIhB;EAFV,QAAA,CAAS,IAAA;EAIA;EAFT,MAAA,IAAU,aAAA,CAAc,aAAA;EAER;EAAhB,KAAA,IAAS,OAAA,CAAQ,cAAA;AAAA;;;;;;KAQP,cAAA;EACV,KAAA;EACA,SAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA;EACA,SAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;AAAA"}
+{"version":3,"file":"realtime.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/contracts/realtime.contract.ts"],"mappings":";;;;;;;;;;;;YAYY;EACN;EAAe;EAAgB;;EAC/B;EAAoB;EAA4B;EAAc;;EAC9D;EAAmB;EAAY;EAAc;;EAC7C;EAAe,OAAO;;EACtB;;;YAGM;;EAEV;;EAEA;;EAEA;;;;;;;;;iBAUe;;EAEf,UAAU,gBAAgB;;EAE1B,SAAS;;EAET,UAAU,cAAc;;EAExB,SAAS;;;iBAIM;EACf,QAAQ,QAAQ,wBAAwB,QAAQ;;;YAItC;;EAEV,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;iBASe;;EAEf,UAAU,gBAAgB;;EAE1B,SAAS;;EAET,UAAU,cAAc;;EAExB,SAAS,QAAQ;;;;;;;YAQP;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA"}

package/esm/contracts/video.contract.d.mts

@@ -1,5 +1,4 @@
 import { Usage } from "@warlock.js/ai";
-
 //#region ../../packages/ai-live/src/contracts/video.contract.d.ts
 /**
  * USD pricing for a text-to-video model. Video providers meter per
@@ -10,9 +9,12 @@ import { Usage } from "@warlock.js/ai";
  * @example
  * const pricing: VideoModelPricing = { perSecond: 0.1 };
  */
-type VideoModelPricing = {
-  /** USD per second of generated video — per-second-metered models. */perSecond?: number; /** USD per 1M input tokens — token-metered models. */
-  input?: number; /** USD per 1M output tokens — token-metered models. */
+export type VideoModelPricing = {
+  /** USD per second of generated video — per-second-metered models. */
+  perSecond?: number;
+  /** USD per 1M input tokens — token-metered models. */
+  input?: number;
+  /** USD per 1M output tokens — token-metered models. */
   output?: number;
 };
 /**
@@ -20,7 +22,7 @@ type VideoModelPricing = {
  * `GeneratedImage`). Providers return either a hosted URL (typically the
  * common case for video, which is large) or inlined base64 bytes.
  */
-type GeneratedVideo = {
+export type GeneratedVideo = {
   type: "url";
   url: string;
   mediaType?: string;
@@ -30,12 +32,18 @@ type GeneratedVideo = {
   mediaType: string;
 };
 /** Options for a single {@link VideoModelContract.generate} request. */
-type VideoOptions = {
-  /** Requested clip length in seconds. */durationSeconds?: number; /** Aspect ratio (e.g. `"16:9"`, `"9:16"`). */
-  aspectRatio?: string; /** Resolution hint (e.g. `"720p"`, `"1080p"`). */
-  resolution?: string; /** Concepts to steer away from. */
-  negativePrompt?: string; /** Cancellation handle. */
-  signal?: AbortSignal; /** Provider-specific escape hatch — forwarded verbatim. */
+export type VideoOptions = {
+  /** Requested clip length in seconds. */
+  durationSeconds?: number;
+  /** Aspect ratio (e.g. `"16:9"`, `"9:16"`). */
+  aspectRatio?: string;
+  /** Resolution hint (e.g. `"720p"`, `"1080p"`). */
+  resolution?: string;
+  /** Concepts to steer away from. */
+  negativePrompt?: string;
+  /** Cancellation handle. */
+  signal?: AbortSignal;
+  /** Provider-specific escape hatch — forwarded verbatim. */
   [key: string]: unknown;
 };
 /**
@@ -44,9 +52,11 @@ type VideoOptions = {
  * ready (or throws a typed `AIError`). The never-throws envelope is
  * added by `ai.video()`.
  */
-type VideoGenerationResponse = {
-  video: GeneratedVideo; /** Token usage when the provider reports it; otherwise all-zero. */
-  usage: Usage; /** Final clip duration in seconds — drives per-second cost. */
+export type VideoGenerationResponse = {
+  video: GeneratedVideo;
+  /** Token usage when the provider reports it; otherwise all-zero. */
+  usage: Usage;
+  /** Final clip duration in seconds — drives per-second cost. */
   durationSeconds?: number;
 };
 /**
@@ -55,18 +65,17 @@ type VideoGenerationResponse = {
  * factory and consumed by `ai.video()`. `generate()` encapsulates the
  * provider's async job (submit → poll → fetch result).
  */
-interface VideoModelContract {
+export interface VideoModelContract {
   readonly name: string;
   readonly provider: string;
   readonly pricing?: VideoModelPricing;
   generate(prompt: string, options?: VideoOptions): Promise<VideoGenerationResponse>;
 }
 /** Configuration passed to an adapter's `video()` factory. */
-type VideoModelConfig = {
+export type VideoModelConfig = {
   name: string;
   pricing?: VideoModelPricing;
   [key: string]: unknown;
 };
 //#endregion
-export { GeneratedVideo, VideoGenerationResponse, VideoModelConfig, VideoModelContract, VideoModelPricing, VideoOptions };
 //# sourceMappingURL=video.contract.d.mts.map

package/esm/contracts/video.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"video.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/contracts/video.contract.ts"],"mappings":";;;;;AAWA;;;;;;;KAAY,iBAAA;EAMJ,qEAJN,SAAA,WAYwB;EAVxB,KAAA,WAUwB;EARxB,MAAA;AAAA;;;;;;KAQU,cAAA;EACN,IAAA;EAAa,GAAA;EAAa,SAAA;AAAA;EAC1B,IAAA;EAAgB,MAAA;EAAgB,SAAA;AAAA;;KAG1B,YAAA;EAYT,wCAVD,eAAA,WAUY;EARZ,WAAA,WAiBiC;EAfjC,UAAA,WAkBY;EAhBZ,cAAA,WAcO;EAZP,MAAA,GAAS,WAAW,EAcb;EAAA,CAZN,GAAA;AAAA;AAcc;AASjB;;;;;AATiB,KALL,uBAAA;EACV,KAAA,EAAO,cAAA,EAiBkD;EAfzD,KAAA,EAAO,KAAK,EAYH;EAVT,eAAA;AAAA;;;;;;;UASe,kBAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA,GAAU,iBAAA;EACnB,QAAA,CAAS,MAAA,UAAgB,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,uBAAA;AAAA;;KAIhD,gBAAA;EACV,IAAA;EACA,OAAA,GAAU,iBAAiB;EAAA,CAC1B,GAAA;AAAA"}
+{"version":3,"file":"video.contract.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/contracts/video.contract.ts"],"mappings":";;;;;;;;;;;YAWY;;EAEV;;EAEA;;EAEA;;;;;;;YAQU;EACN;EAAa;EAAa;;EAC1B;EAAgB;EAAgB;;;YAG1B;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;GAER;;;;;;;;YASS;EACV,OAAO;;EAEP,OAAO;;EAEP;;;;;;;;iBASe;WACN;WACA;WACA,UAAU;EACnB,SAAS,gBAAgB,UAAU,eAAe,QAAQ;;;YAIhD;EACV;EACA,UAAU;GACT"}

package/esm/index.d.mts

@@ -3,7 +3,6 @@ import { realtime } from "./realtime/realtime.mjs";
 import { GeneratedVideo, VideoGenerationResponse, VideoModelConfig, VideoModelContract, VideoModelPricing, VideoOptions } from "./contracts/video.contract.mjs";
 import { VideoData, VideoParams, VideoReport, VideoResult, video } from "./video/video.mjs";
 import { MockRealtimeConnection, MockRealtimeTransport, MockVideoModel, MockVideoResponse } from "./mock/index.mjs";
-
 //#region ../../packages/ai-live/src/index.d.ts
 /**
  * Augment the shared `Ai` facade with this package's two heavy

package/esm/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../packages/ai-live/src/index.ts"],"mappings":";;;;;;;;;;;;AAEsC;;;YAU1B,EAAA;IAAA;;;;;IAMR,KAAA,SAAc,KAAA;IAMW;AAAA;;;;IAAzB,QAAA,SAAiB,QAAQ;EAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../packages/ai-live/src/index.ts"],"mappings":";;;;;;;;;;;;;;YAYY;;;;;;IAMR,cAAc;;;;;;IAMd,iBAAiB"}

package/esm/mock/index.d.mts

@@ -1,17 +1,16 @@
 import { RealtimeConnectConfig, RealtimeConnection, RealtimeEvent, RealtimeTransport } from "../contracts/realtime.contract.mjs";
 import { GeneratedVideo, VideoGenerationResponse, VideoModelContract, VideoModelPricing, VideoOptions } from "../contracts/video.contract.mjs";
 import { Usage } from "@warlock.js/ai";
-
 //#region ../../packages/ai-live/src/mock/index.d.ts
 /** One scripted response for a {@link MockVideoModel}. */
-type MockVideoResponse = {
+export type MockVideoResponse = {
   video?: GeneratedVideo;
   usage?: Usage;
   durationSeconds?: number;
   error?: Error;
 };
 /** Deterministic {@link VideoModelContract} double for tests — no HTTP, no polling. */
-declare class MockVideoModel implements VideoModelContract {
+export declare class MockVideoModel implements VideoModelContract {
   readonly name: string;
   private readonly responses;
   readonly pricing?: VideoModelPricing | undefined;
@@ -25,7 +24,7 @@ declare class MockVideoModel implements VideoModelContract {
   generate(prompt: string, options?: VideoOptions): Promise<VideoGenerationResponse>;
 }
 /** A recording {@link RealtimeConnection} the mock transport hands back. */
-declare class MockRealtimeConnection implements RealtimeConnection {
+export declare class MockRealtimeConnection implements RealtimeConnection {
   private readonly scripted;
   readonly sentAudio: {
     base64: string;
@@ -40,7 +39,7 @@ declare class MockRealtimeConnection implements RealtimeConnection {
   close(): Promise<void>;
 }
 /** Deterministic {@link RealtimeTransport} double — scripts the event stream, records sends. */
-declare class MockRealtimeTransport implements RealtimeTransport {
+export declare class MockRealtimeTransport implements RealtimeTransport {
   private readonly scriptedEvents;
   readonly connectConfigs: RealtimeConnectConfig[];
   lastConnection?: MockRealtimeConnection;
@@ -48,5 +47,4 @@ declare class MockRealtimeTransport implements RealtimeTransport {
   connect(config: RealtimeConnectConfig): Promise<RealtimeConnection>;
 }
 //#endregion
-export { MockRealtimeConnection, MockRealtimeTransport, MockVideoModel, MockVideoResponse };
 //# sourceMappingURL=index.d.mts.map

package/esm/mock/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/mock/index.ts"],"mappings":";;;;;;KAgBY,iBAAA;EACV,KAAA,GAAQ,cAAA;EACR,KAAA,GAAQ,KAAA;EACR,eAAA;EACA,KAAA,GAAQ,KAAA;AAAA;;cAIG,cAAA,YAA0B,kBAAA;EAAA,SAOnB,IAAA;EAAA,iBACC,SAAA;EAAA,SACD,OAAA,GAAU,iBAAA;EAAA,SARZ,QAAA;EAAA,SACA,KAAA;IAAS,MAAA;IAAgB,OAAA,EAAS,YAAA;EAAA;EAAA,QAE1C,SAAA;cAGU,IAAA,UACC,SAAA,EAAW,iBAAA,IACZ,OAAA,GAAU,iBAAA;EAGf,QAAA,CACX,MAAA,UACA,OAAA,GAAU,YAAA,GACT,OAAA,CAAQ,uBAAA;AAAA;;cAmBA,sBAAA,YAAkC,kBAAA;EAAA,iBAKT,QAAA;EAAA,SAJpB,SAAA;IAAa,MAAA;IAAgB,SAAA;EAAA;EAAA,SAC7B,QAAA;EACT,MAAA;cAE6B,QAAA,EAAU,aAAA;EAEvC,SAAA,CAAU,MAAA,UAAgB,SAAA;EAI1B,QAAA,CAAS,IAAA;EAIF,MAAA,IAAU,aAAA,CAAc,aAAA;EAMzB,KAAA,IAAS,OAAA;AAAA;;cAMX,qBAAA,YAAiC,iBAAA;EAAA,iBAIR,cAAA;EAAA,SAHpB,cAAA,EAAgB,qBAAA;EACzB,cAAA,GAAiB,sBAAA;cAEY,cAAA,GAAgB,aAAA;EAEvC,OAAA,CAAQ,MAAA,EAAQ,qBAAA,GAAwB,OAAA,CAAQ,kBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/mock/index.ts"],"mappings":";;;;;YAgBY;EACV,QAAQ;EACR,QAAQ;EACR;EACA,QAAQ;;;qBAIG,0BAA0B;WAOnB;mBACC;WACD,UAAU;WARZ;WACA;IAAS;IAAgB,SAAS;;UAE1C;EAER,YACkB,cACC,WAAW,qBACZ,UAAU;EAGf,SAAS,gBAAgB,UAAU,eAAe,QAAQ;;;qBAuB5D,kCAAkC;mBAKT;WAJpB;IAAa;IAAgB;;WAC7B;EACT;EAEP,YAAoC,UAAU;EAEvC,UAAU,gBAAgB;EAI1B,SAAS;EAIF,UAAU,cAAc;EAMzB,SAAS;;;qBAMX,iCAAiC;mBAIR;WAHpB,gBAAgB;EACzB,iBAAiB;EAExB,YAAoC,iBAAgB;EAEvC,QAAQ,QAAQ,wBAAwB,QAAQ"}

package/esm/mock/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/ai-live/src/mock/index.ts"],"sourcesContent":["import type { Usage } from \"@warlock.js/ai\";\nimport type {\n  RealtimeConnectConfig,\n  RealtimeConnection,\n  RealtimeEvent,\n  RealtimeTransport,\n} from \"../contracts/realtime.contract\";\nimport type {\n  GeneratedVideo,\n  VideoGenerationResponse,\n  VideoModelContract,\n  VideoModelPricing,\n  VideoOptions,\n} from \"../contracts/video.contract\";\n\n/** One scripted response for a {@link MockVideoModel}. */\nexport type MockVideoResponse = {\n  video?: GeneratedVideo;\n  usage?: Usage;\n  durationSeconds?: number;\n  error?: Error;\n};\n\n/** Deterministic {@link VideoModelContract} double for tests — no HTTP, no polling. */\nexport class MockVideoModel implements VideoModelContract {\n  public readonly provider = \"mock\";\n  public readonly calls: { prompt: string; options: VideoOptions | undefined }[] = [];\n\n  private callIndex = 0;\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockVideoResponse[],\n    public readonly pricing?: VideoModelPricing,\n  ) {}\n\n  public async generate(\n    prompt: string,\n    options?: VideoOptions,\n  ): Promise<VideoGenerationResponse> {\n    this.calls.push({ prompt, options });\n\n    const response = this.responses[Math.min(this.callIndex, this.responses.length - 1)] ?? {};\n    this.callIndex += 1;\n\n    if (response.error) {\n      throw response.error;\n    }\n\n    return {\n      video: response.video ?? { type: \"url\", url: \"https://mock/video.mp4\", mediaType: \"video/mp4\" },\n      usage: response.usage ?? { input: 0, output: 0, total: 0 },\n      durationSeconds: response.durationSeconds ?? options?.durationSeconds ?? 5,\n    };\n  }\n}\n\n/** A recording {@link RealtimeConnection} the mock transport hands back. */\nexport class MockRealtimeConnection implements RealtimeConnection {\n  public readonly sentAudio: { base64: string; mediaType: string }[] = [];\n  public readonly sentText: string[] = [];\n  public closed = false;\n\n  public constructor(private readonly scripted: RealtimeEvent[]) {}\n\n  public sendAudio(base64: string, mediaType: string): void {\n    this.sentAudio.push({ base64, mediaType });\n  }\n\n  public sendText(text: string): void {\n    this.sentText.push(text);\n  }\n\n  public async *events(): AsyncIterable<RealtimeEvent> {\n    for (const event of this.scripted) {\n      yield event;\n    }\n  }\n\n  public async close(): Promise<void> {\n    this.closed = true;\n  }\n}\n\n/** Deterministic {@link RealtimeTransport} double — scripts the event stream, records sends. */\nexport class MockRealtimeTransport implements RealtimeTransport {\n  public readonly connectConfigs: RealtimeConnectConfig[] = [];\n  public lastConnection?: MockRealtimeConnection;\n\n  public constructor(private readonly scriptedEvents: RealtimeEvent[] = []) {}\n\n  public async connect(config: RealtimeConnectConfig): Promise<RealtimeConnection> {\n    this.connectConfigs.push(config);\n    this.lastConnection = new MockRealtimeConnection(this.scriptedEvents);\n    return this.lastConnection;\n  }\n}\n"],"mappings":";;AAwBA,IAAa,iBAAb,MAA0D;CAMxD,AAAO,YACL,AAAgB,MAChB,AAAiB,WACjB,AAAgB,SAChB;EAHgB;EACC;EACD;kBARS;eACsD,CAAC;mBAE9D;CAMjB;CAEH,MAAa,SACX,QACA,SACkC;EAClC,KAAK,MAAM,KAAK;GAAE;GAAQ;EAAQ,CAAC;EAEnC,MAAM,WAAW,KAAK,UAAU,KAAK,IAAI,KAAK,WAAW,KAAK,UAAU,SAAS,CAAC,MAAM,CAAC;EACzF,KAAK,aAAa;EAElB,IAAI,SAAS,OACX,MAAM,SAAS;EAGjB,OAAO;GACL,OAAO,SAAS,SAAS;IAAE,MAAM;IAAO,KAAK;IAA0B,WAAW;GAAY;GAC9F,OAAO,SAAS,SAAS;IAAE,OAAO;IAAG,QAAQ;IAAG,OAAO;GAAE;GACzD,iBAAiB,SAAS,mBAAmB,SAAS,mBAAmB;EAC3E;CACF;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAKhE,AAAO,YAAY,AAAiB,UAA2B;EAA3B;mBAJiC,CAAC;kBACjC,CAAC;gBACtB;CAEgD;CAEhE,AAAO,UAAU,QAAgB,WAAyB;EACxD,KAAK,UAAU,KAAK;GAAE;GAAQ;EAAU,CAAC;CAC3C;CAEA,AAAO,SAAS,MAAoB;EAClC,KAAK,SAAS,KAAK,IAAI;CACzB;CAEA,OAAc,SAAuC;EACnD,KAAK,MAAM,SAAS,KAAK,UACvB,MAAM;CAEV;CAEA,MAAa,QAAuB;EAClC,KAAK,SAAS;CAChB;AACF;;AAGA,IAAa,wBAAb,MAAgE;CAI9D,AAAO,YAAY,AAAiB,iBAAkC,CAAC,GAAG;EAAtC;wBAHsB,CAAC;CAGgB;CAE3E,MAAa,QAAQ,QAA4D;EAC/E,KAAK,eAAe,KAAK,MAAM;EAC/B,KAAK,iBAAiB,IAAI,uBAAuB,KAAK,cAAc;EACpE,OAAO,KAAK;CACd;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/ai-live/src/mock/index.ts"],"sourcesContent":["import type { Usage } from \"@warlock.js/ai\";\nimport type {\n  RealtimeConnectConfig,\n  RealtimeConnection,\n  RealtimeEvent,\n  RealtimeTransport,\n} from \"../contracts/realtime.contract\";\nimport type {\n  GeneratedVideo,\n  VideoGenerationResponse,\n  VideoModelContract,\n  VideoModelPricing,\n  VideoOptions,\n} from \"../contracts/video.contract\";\n\n/** One scripted response for a {@link MockVideoModel}. */\nexport type MockVideoResponse = {\n  video?: GeneratedVideo;\n  usage?: Usage;\n  durationSeconds?: number;\n  error?: Error;\n};\n\n/** Deterministic {@link VideoModelContract} double for tests — no HTTP, no polling. */\nexport class MockVideoModel implements VideoModelContract {\n  public readonly provider = \"mock\";\n  public readonly calls: { prompt: string; options: VideoOptions | undefined }[] = [];\n\n  private callIndex = 0;\n\n  public constructor(\n    public readonly name: string,\n    private readonly responses: MockVideoResponse[],\n    public readonly pricing?: VideoModelPricing,\n  ) {}\n\n  public async generate(prompt: string, options?: VideoOptions): Promise<VideoGenerationResponse> {\n    this.calls.push({ prompt, options });\n\n    const response = this.responses[Math.min(this.callIndex, this.responses.length - 1)] ?? {};\n    this.callIndex += 1;\n\n    if (response.error) {\n      throw response.error;\n    }\n\n    return {\n      video: response.video ?? {\n        type: \"url\",\n        url: \"https://mock/video.mp4\",\n        mediaType: \"video/mp4\",\n      },\n      usage: response.usage ?? { input: 0, output: 0, total: 0 },\n      durationSeconds: response.durationSeconds ?? options?.durationSeconds ?? 5,\n    };\n  }\n}\n\n/** A recording {@link RealtimeConnection} the mock transport hands back. */\nexport class MockRealtimeConnection implements RealtimeConnection {\n  public readonly sentAudio: { base64: string; mediaType: string }[] = [];\n  public readonly sentText: string[] = [];\n  public closed = false;\n\n  public constructor(private readonly scripted: RealtimeEvent[]) {}\n\n  public sendAudio(base64: string, mediaType: string): void {\n    this.sentAudio.push({ base64, mediaType });\n  }\n\n  public sendText(text: string): void {\n    this.sentText.push(text);\n  }\n\n  public async *events(): AsyncIterable<RealtimeEvent> {\n    for (const event of this.scripted) {\n      yield event;\n    }\n  }\n\n  public async close(): Promise<void> {\n    this.closed = true;\n  }\n}\n\n/** Deterministic {@link RealtimeTransport} double — scripts the event stream, records sends. */\nexport class MockRealtimeTransport implements RealtimeTransport {\n  public readonly connectConfigs: RealtimeConnectConfig[] = [];\n  public lastConnection?: MockRealtimeConnection;\n\n  public constructor(private readonly scriptedEvents: RealtimeEvent[] = []) {}\n\n  public async connect(config: RealtimeConnectConfig): Promise<RealtimeConnection> {\n    this.connectConfigs.push(config);\n    this.lastConnection = new MockRealtimeConnection(this.scriptedEvents);\n    return this.lastConnection;\n  }\n}\n"],"mappings":";;AAwBA,IAAa,iBAAb,MAA0D;CAMxD,AAAO,YACL,AAAgB,MAChB,AAAiB,WACjB,AAAgB,SAChB;EAHgB;EACC;EACD;kBARS;eACsD,CAAC;mBAE9D;CAMjB;CAEH,MAAa,SAAS,QAAgB,SAA0D;EAC9F,KAAK,MAAM,KAAK;GAAE;GAAQ;EAAQ,CAAC;EAEnC,MAAM,WAAW,KAAK,UAAU,KAAK,IAAI,KAAK,WAAW,KAAK,UAAU,SAAS,CAAC,MAAM,CAAC;EACzF,KAAK,aAAa;EAElB,IAAI,SAAS,OACX,MAAM,SAAS;EAGjB,OAAO;GACL,OAAO,SAAS,SAAS;IACvB,MAAM;IACN,KAAK;IACL,WAAW;GACb;GACA,OAAO,SAAS,SAAS;IAAE,OAAO;IAAG,QAAQ;IAAG,OAAO;GAAE;GACzD,iBAAiB,SAAS,mBAAmB,SAAS,mBAAmB;EAC3E;CACF;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAKhE,AAAO,YAAY,AAAiB,UAA2B;EAA3B;mBAJiC,CAAC;kBACjC,CAAC;gBACtB;CAEgD;CAEhE,AAAO,UAAU,QAAgB,WAAyB;EACxD,KAAK,UAAU,KAAK;GAAE;GAAQ;EAAU,CAAC;CAC3C;CAEA,AAAO,SAAS,MAAoB;EAClC,KAAK,SAAS,KAAK,IAAI;CACzB;CAEA,OAAc,SAAuC;EACnD,KAAK,MAAM,SAAS,KAAK,UACvB,MAAM;CAEV;CAEA,MAAa,QAAuB;EAClC,KAAK,SAAS;CAChB;AACF;;AAGA,IAAa,wBAAb,MAAgE;CAI9D,AAAO,YAAY,AAAiB,iBAAkC,CAAC,GAAG;EAAtC;wBAHsB,CAAC;CAGgB;CAE3E,MAAa,QAAQ,QAA4D;EAC/E,KAAK,eAAe,KAAK,MAAM;EAC/B,KAAK,iBAAiB,IAAI,uBAAuB,KAAK,cAAc;EACpE,OAAO,KAAK;CACd;AACF"}

package/esm/realtime/realtime.d.mts

@@ -1,5 +1,4 @@
 import { RealtimeOptions, RealtimeSession } from "../contracts/realtime.contract.mjs";
-
 //#region ../../packages/ai-live/src/realtime/realtime.d.ts
 /**
  * Open a live duplex voice session — the stateful primitive of
@@ -23,7 +22,6 @@ import { RealtimeOptions, RealtimeSession } from "../contracts/realtime.contract
  * }
  * const report = await session.close();
  */
-declare function realtime(options: RealtimeOptions): Promise<RealtimeSession>;
+export declare function realtime(options: RealtimeOptions): Promise<RealtimeSession>;
 //#endregion
-export { realtime };
 //# sourceMappingURL=realtime.d.mts.map

package/esm/realtime/realtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/realtime/realtime.ts"],"mappings":";;;;;AA6BA;;;;;;;;;;;;;AAAiF;;;;;;;iBAA3D,QAAA,CAAS,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"realtime.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/realtime/realtime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;wBA6BsB,SAAS,SAAS,kBAAkB,QAAQ"}

package/esm/video/video.d.mts

@@ -1,9 +1,8 @@
 import { GeneratedVideo, VideoModelContract } from "../contracts/video.contract.mjs";
 import { BaseReport, ExecuteResult, FlowObserveOption } from "@warlock.js/ai";
-
 //#region ../../packages/ai-live/src/video/video.d.ts
 /** Parameters for {@link video}. `model` comes from an adapter's `video({ name })`. */
-type VideoParams = {
+export type VideoParams = {
   model: VideoModelContract;
   prompt: string;
   durationSeconds?: number;
@@ -17,20 +16,21 @@ type VideoParams = {
   options?: Record<string, unknown>;
 };
 /** Success payload of a {@link video} run. */
-type VideoData = {
+export type VideoData = {
   video: GeneratedVideo;
 };
 /** The report node a {@link video} run produces (`type: "video"`). */
-type VideoReport = BaseReport & {
+export type VideoReport = BaseReport & {
   type: "video";
   model: {
     name: string;
     provider: string;
-  }; /** Final clip duration in seconds, when reported. */
+  };
+  /** Final clip duration in seconds, when reported. */
   durationSeconds?: number;
 };
 /** Result envelope of {@link video} — the uniform `{ data, error, usage, report }`. */
-type VideoResult = ExecuteResult<VideoData> & {
+export type VideoResult = ExecuteResult<VideoData> & {
   type: "video";
   report: VideoReport;
 };
@@ -53,7 +53,6 @@ type VideoResult = ExecuteResult<VideoData> & {
  * });
  * if (!error) download(data.video);
  */
-declare function video(params: VideoParams): Promise<VideoResult>;
+export declare function video(params: VideoParams): Promise<VideoResult>;
 //#endregion
-export { VideoData, VideoParams, VideoReport, VideoResult, video };
 //# sourceMappingURL=video.d.mts.map

package/esm/video/video.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"video.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/video/video.ts"],"mappings":";;;;;KAqBY,WAAA;EACV,KAAA,EAAO,kBAAA;EACP,MAAA;EACA,eAAA;EACA,WAAA;EACA,UAAA;EACA,cAAA;EACA,MAAA,GAAS,WAAA;EACT,OAAA,GAAU,iBAAA;EACV,SAAA;EACA,IAAA;EACA,OAAA,GAAU,MAAA;AAAA;;KAIA,SAAA;EAAc,KAAA,EAAO,cAAc;AAAA;;KAGnC,WAAA,GAAc,UAAU;EAClC,IAAA;EACA,KAAA;IAAS,IAAA;IAAc,QAAA;EAAA,GATb;EAWV,eAAA;AAAA;AAPF;AAAA,KAWY,WAAA,GAAc,aAAA,CAAc,SAAA;EAAe,IAAA;EAAe,MAAA,EAAQ,WAAA;AAAA;AAR9E;;;;;;;;;;;AAIiB;AAIjB;;;;;;;AARA,iBA6BsB,KAAA,CAAM,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,WAAA"}
+{"version":3,"file":"video.d.mts","names":[],"sources":["../../../../../../../../packages/ai-live/src/video/video.ts"],"mappings":";;;;YAqBY;EACV,OAAO;EACP;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,UAAU;EACV;EACA;EACA,UAAU;;;YAIA;EAAc,OAAO;;;YAGrB,cAAc;EACxB;EACA;IAAS;IAAc;;;EAEvB;;;YAIU,cAAc,cAAc;EAAe;EAAe,QAAQ;;;;;;;;;;;;;;;;;;;;;wBAqBxD,MAAM,QAAQ,cAAc,QAAQ"}

package/llms-full.txt

@@ -39,9 +39,9 @@ const { data, error, usage, report } = await ai.video({
 });
 
 if (error) {
-  console.warn(error.code);   // typed AIError — NEVER thrown
+  console.warn(error.code); // typed AIError — NEVER thrown
 } else {
-  const clip = data.video;    // GeneratedVideo (discriminated)
+  const clip = data.video; // GeneratedVideo (discriminated)
   if (clip.type === "url") download(clip.url);
   else save(Buffer.from(clip.base64, "base64"), clip.mediaType);
 }
@@ -59,17 +59,17 @@ type GeneratedVideo =
 
 // VideoParams (provider-neutral) — the model is the only required field beyond prompt:
 await ai.video({
-  model,                 // VideoModelContract from an adapter's video({ name })
+  model, // VideoModelContract from an adapter's video({ name })
   prompt: "...",
-  durationSeconds: 8,    // requested clip length
+  durationSeconds: 8, // requested clip length
   aspectRatio: "9:16",
-  resolution: "1080p",   // hint
+  resolution: "1080p", // hint
   negativePrompt: "blurry, watermark",
-  signal,                // AbortSignal → status "cancelled"
-  observe: collector,    // route the report to an Observer (panoptic), like agents
+  signal, // AbortSignal → status "cancelled"
+  observe: collector, // route the report to an Observer (panoptic), like agents
   sessionId: "campaign-42",
-  name: "hero-clip",     // report node name (defaults to "video")
-  options: { seed: 7 },  // provider-specific escape hatch, forwarded verbatim
+  name: "hero-clip", // report node name (defaults to "video")
+  options: { seed: 7 }, // provider-specific escape hatch, forwarded verbatim
 });
 ```
 
@@ -97,13 +97,23 @@ const session = await ai.realtime({
 session.sendAudio(micChunkBase64, "audio/pcm"); // push mic audio upstream
 session.sendText("Please hold for one moment."); // or a text turn
 
-for await (const event of session.events()) {    // duplex output
+for await (const event of session.events()) {
+  // duplex output
   switch (event.type) {
-    case "audio":      speaker.write(event.base64); break;
-    case "transcript": if (event.final) log(event.role, event.text); break;
-    case "tool-call":  await handleTool(event.name, event.input); break;
-    case "error":      console.warn(event.error.code); break;
-    case "done":       break;
+    case "audio":
+      speaker.write(event.base64);
+      break;
+    case "transcript":
+      if (event.final) log(event.role, event.text);
+      break;
+    case "tool-call":
+      await handleTool(event.name, event.input);
+      break;
+    case "error":
+      console.warn(event.error.code);
+      break;
+    case "done":
+      break;
   }
 }
 
@@ -124,13 +134,19 @@ type RealtimeEvent =
   | { type: "audio"; base64: string; mediaType: string }
   | { type: "transcript"; role: "user" | "assistant"; text: string; final: boolean }
   | { type: "tool-call"; id: string; name: string; input: unknown }
-  | { type: "error"; error: AIError }   // typed, non-fatal
-  | { type: "done" };                   // server ended the session
+  | { type: "error"; error: AIError } // typed, non-fatal
+  | { type: "done" }; // server ended the session
 
 type RealtimeReport = {
-  runId: string; rootRunId: string; type: "realtime";
-  name: string; status: "completed" | "failed" | "cancelled";
-  startedAt: string; endedAt: string; duration: number; sessionId?: string;
+  runId: string;
+  rootRunId: string;
+  type: "realtime";
+  name: string;
+  status: "completed" | "failed" | "cancelled";
+  startedAt: string;
+  endedAt: string;
+  duration: number;
+  sessionId?: string;
 };
 ```
 
@@ -187,7 +203,9 @@ const transport = new MockRealtimeTransport([
 ]);
 const session = await ai.realtime({ transport, model: "mock-realtime" });
 session.sendText("hello");
-for await (const e of session.events()) { /* ... */ }
+for await (const e of session.events()) {
+  /* ... */
+}
 const report = await session.close();
 // transport.lastConnection.sentText → ["hello"]
 // transport.connectConfigs[0] → { model: "mock-realtime", ... }

package/package.json

@@ -15,17 +15,17 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@warlock.js/logger": "5.30.0"
+    "@warlock.js/logger": "5.32.0"
   },
   "peerDependencies": {
-    "@warlock.js/ai": "5.30.0"
+    "@warlock.js/ai": "5.32.0"
   },
   "peerDependenciesMeta": {
     "ws": {
       "optional": true
     }
   },
-  "version": "5.30.0",
+  "version": "5.32.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/use-ai-live/SKILL.md

@@ -31,9 +31,9 @@ const { data, error, usage, report } = await ai.video({
 });
 
 if (error) {
-  console.warn(error.code);   // typed AIError — NEVER thrown
+  console.warn(error.code); // typed AIError — NEVER thrown
 } else {
-  const clip = data.video;    // GeneratedVideo (discriminated)
+  const clip = data.video; // GeneratedVideo (discriminated)
   if (clip.type === "url") download(clip.url);
   else save(Buffer.from(clip.base64, "base64"), clip.mediaType);
 }
@@ -51,17 +51,17 @@ type GeneratedVideo =
 
 // VideoParams (provider-neutral) — the model is the only required field beyond prompt:
 await ai.video({
-  model,                 // VideoModelContract from an adapter's video({ name })
+  model, // VideoModelContract from an adapter's video({ name })
   prompt: "...",
-  durationSeconds: 8,    // requested clip length
+  durationSeconds: 8, // requested clip length
   aspectRatio: "9:16",
-  resolution: "1080p",   // hint
+  resolution: "1080p", // hint
   negativePrompt: "blurry, watermark",
-  signal,                // AbortSignal → status "cancelled"
-  observe: collector,    // route the report to an Observer (panoptic), like agents
+  signal, // AbortSignal → status "cancelled"
+  observe: collector, // route the report to an Observer (panoptic), like agents
   sessionId: "campaign-42",
-  name: "hero-clip",     // report node name (defaults to "video")
-  options: { seed: 7 },  // provider-specific escape hatch, forwarded verbatim
+  name: "hero-clip", // report node name (defaults to "video")
+  options: { seed: 7 }, // provider-specific escape hatch, forwarded verbatim
 });
 ```
 
@@ -89,13 +89,23 @@ const session = await ai.realtime({
 session.sendAudio(micChunkBase64, "audio/pcm"); // push mic audio upstream
 session.sendText("Please hold for one moment."); // or a text turn
 
-for await (const event of session.events()) {    // duplex output
+for await (const event of session.events()) {
+  // duplex output
   switch (event.type) {
-    case "audio":      speaker.write(event.base64); break;
-    case "transcript": if (event.final) log(event.role, event.text); break;
-    case "tool-call":  await handleTool(event.name, event.input); break;
-    case "error":      console.warn(event.error.code); break;
-    case "done":       break;
+    case "audio":
+      speaker.write(event.base64);
+      break;
+    case "transcript":
+      if (event.final) log(event.role, event.text);
+      break;
+    case "tool-call":
+      await handleTool(event.name, event.input);
+      break;
+    case "error":
+      console.warn(event.error.code);
+      break;
+    case "done":
+      break;
   }
 }
 
@@ -116,13 +126,19 @@ type RealtimeEvent =
   | { type: "audio"; base64: string; mediaType: string }
   | { type: "transcript"; role: "user" | "assistant"; text: string; final: boolean }
   | { type: "tool-call"; id: string; name: string; input: unknown }
-  | { type: "error"; error: AIError }   // typed, non-fatal
-  | { type: "done" };                   // server ended the session
+  | { type: "error"; error: AIError } // typed, non-fatal
+  | { type: "done" }; // server ended the session
 
 type RealtimeReport = {
-  runId: string; rootRunId: string; type: "realtime";
-  name: string; status: "completed" | "failed" | "cancelled";
-  startedAt: string; endedAt: string; duration: number; sessionId?: string;
+  runId: string;
+  rootRunId: string;
+  type: "realtime";
+  name: string;
+  status: "completed" | "failed" | "cancelled";
+  startedAt: string;
+  endedAt: string;
+  duration: number;
+  sessionId?: string;
 };
 ```
 
@@ -179,7 +195,9 @@ const transport = new MockRealtimeTransport([
 ]);
 const session = await ai.realtime({ transport, model: "mock-realtime" });
 session.sendText("hello");
-for await (const e of session.events()) { /* ... */ }
+for await (const e of session.events()) {
+  /* ... */
+}
 const report = await session.close();
 // transport.lastConnection.sentText → ["hello"]
 // transport.connectConfigs[0] → { model: "mock-realtime", ... }