@tanstack/ai-client 0.13.0 → 0.14.0

package/dist/esm/video-generation-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"video-generation-client.js","sources":["../../src/video-generation-client.ts"],"sourcesContent":["import { GENERATION_EVENTS } from './generation-types'\nimport { createNoOpVideoDevtoolsBridge } from './devtools-noop'\nimport { parseSSEResponse } from './sse-parser'\nimport type { StreamChunk } from '@tanstack/ai'\nimport type {\n  ConnectConnectionAdapter,\n  RunAgentInputContext,\n} from './connection-adapters'\nimport type {\n  AIDevtoolsClientMetadata,\n  AIDevtoolsGenerationProgress,\n  VideoDevtoolsBridge,\n  VideoDevtoolsBridgeOptions,\n} from './devtools'\nimport type {\n  GenerationClientState,\n  GenerationFetcher,\n  VideoGenerateInput,\n  VideoGenerateResult,\n  VideoGenerationClientOptions,\n  VideoStatusInfo,\n} from './generation-types'\n\n/**\n * Callbacks stored in a ref so hooks can update them without recreating the client.\n */\n// All optional fields explicitly allow `| undefined` so callers can spread\n// option bags (where each callback may be `undefined`) into the callbacks\n// ref under `exactOptionalPropertyTypes`.\ninterface VideoCallbacks<TOutput> {\n  onResult?:\n    | ((result: VideoGenerateResult) => TOutput | null | void)\n    | undefined\n  onError?: ((error: Error) => void) | undefined\n  onProgress?: ((progress: number, message?: string) => void) | undefined\n  onChunk?: ((chunk: StreamChunk) => void) | undefined\n  onJobCreated?: ((jobId: string) => void) | undefined\n  onStatusUpdate?: ((status: VideoStatusInfo) => void) | undefined\n  onResultChange?: ((result: TOutput | null) => void) | undefined\n  onLoadingChange?: ((isLoading: boolean) => void) | undefined\n  onErrorChange?: ((error: Error | undefined) => void) | undefined\n  onStatusChange?: ((status: GenerationClientState) => void) | undefined\n  onJobIdChange?: ((jobId: string | null) => void) | undefined\n  onVideoStatusChange?: ((status: VideoStatusInfo | null) => void) | undefined\n}\n\n/**\n * A specialized client for job-based video generation.\n *\n * Video generation is asynchronous: a job is created, then polled for status\n * until completion. This client handles the full lifecycle.\n *\n * Supports two transport modes:\n * - **ConnectConnectionAdapter** — Server handles the polling loop internally and\n *   streams status updates via CUSTOM events.\n * - **Fetcher** — Direct async function that returns a completed\n *   `VideoGenerateResult`.\n *\n * @example\n * ```typescript\n * // With streaming connection adapter (server-driven polling)\n * const client = new VideoGenerationClient({\n *   connection: fetchServerSentEvents('/api/generate/video'),\n *   onResultChange: setResult,\n *   onVideoStatusChange: setVideoStatus,\n * })\n *\n * // With fetcher (direct result)\n * const client = new VideoGenerationClient({\n *   fetcher: async (input) => {\n *     const res = await fetch('/api/video/generate', {\n *       method: 'POST',\n *       body: JSON.stringify(input),\n *     })\n *     return res.json() // { jobId, status: 'completed', url, expiresAt }\n *   },\n * })\n *\n * await client.generate({ prompt: 'A flying car over a city' })\n * ```\n */\nexport class VideoGenerationClient<TOutput = VideoGenerateResult> {\n  private readonly connection: ConnectConnectionAdapter | undefined\n  private readonly fetcher:\n    | GenerationFetcher<VideoGenerateInput, VideoGenerateResult>\n    | undefined\n  private readonly uniqueId: string\n  private readonly devtoolsMetadata: AIDevtoolsClientMetadata\n  private readonly devtoolsBridge: VideoDevtoolsBridge<TOutput>\n  private readonly threadId: string\n  private body: Record<string, any>\n\n  private result: TOutput | null = null\n  private input: VideoGenerateInput | null = null\n  private progress: AIDevtoolsGenerationProgress | null = null\n  private jobId: string | null = null\n  private videoStatus: VideoStatusInfo | null = null\n  private isLoading = false\n  private error: Error | undefined = undefined\n  private status: GenerationClientState = 'idle'\n  private abortController: AbortController | null = null\n  private readonly callbacksRef: VideoCallbacks<TOutput>\n  private devtoolsMounted = false\n\n  constructor(\n    options: VideoGenerationClientOptions<TOutput> &\n      (\n        | { connection: ConnectConnectionAdapter; fetcher?: never }\n        | {\n            fetcher: GenerationFetcher<VideoGenerateInput, VideoGenerateResult>\n            connection?: never\n          }\n      ),\n  ) {\n    this.uniqueId = options.id ?? this.generateUniqueId('video')\n    this.threadId = this.uniqueId\n    this.connection = options.connection\n    this.fetcher = options.fetcher\n    this.body = options.body ?? {}\n\n    this.callbacksRef = {\n      onResult: options.onResult,\n      onError: options.onError,\n      onProgress: options.onProgress,\n      onChunk: options.onChunk,\n      onJobCreated: options.onJobCreated,\n      onStatusUpdate: options.onStatusUpdate,\n      onResultChange: options.onResultChange,\n      onLoadingChange: options.onLoadingChange,\n      onErrorChange: options.onErrorChange,\n      onStatusChange: options.onStatusChange,\n      onJobIdChange: options.onJobIdChange,\n      onVideoStatusChange: options.onVideoStatusChange,\n    }\n\n    this.devtoolsMetadata = this.createDevtoolsMetadata(options.devtools)\n    this.devtoolsBridge = (\n      options.devtoolsBridgeFactory ?? createNoOpVideoDevtoolsBridge\n    )<TOutput>(this.buildDevtoolsBridgeOptions())\n  }\n\n  private buildDevtoolsBridgeOptions(): VideoDevtoolsBridgeOptions<TOutput> {\n    return {\n      hookId: this.uniqueId,\n      clientId: this.uniqueId,\n      threadId: this.threadId,\n      metadata: this.devtoolsMetadata,\n      getCoreState: () => ({\n        input: this.input,\n        result: this.result,\n        progress: this.progress,\n        status: this.status,\n        isLoading: this.isLoading,\n        jobId: this.jobId,\n        videoStatus: this.videoStatus,\n        ...(this.error ? { error: this.error.message } : {}),\n      }),\n    }\n  }\n\n  mountDevtools(): void {\n    if (this.devtoolsMounted) {\n      return\n    }\n\n    this.devtoolsMounted = true\n    this.devtoolsBridge.emitRegistered()\n    this.devtoolsBridge.emitSnapshot()\n  }\n\n  /**\n   * Trigger video generation.\n   * Only one generation can be in-flight at a time.\n   */\n  async generate(input: VideoGenerateInput): Promise<void> {\n    this.mountDevtools()\n    if (this.isLoading) return\n\n    this.input = input\n    this.progress = null\n    const runId = this.devtoolsBridge.beginRun(input)\n    this.setIsLoading(true)\n    this.setStatus('generating')\n    this.setError(undefined)\n    this.setJobId(null)\n    this.setVideoStatus(null)\n\n    const abortController = new AbortController()\n    this.abortController = abortController\n    const { signal } = abortController\n\n    try {\n      if (this.fetcher) {\n        await this.generateWithFetcher(input, signal, runId)\n      } else if (this.connection) {\n        const mergedData = { ...this.body, ...input }\n        const stream = this.connection.connect(\n          [],\n          mergedData,\n          signal,\n          this.createRunContext(runId),\n        )\n        await this.processStream(stream, runId)\n      } else {\n        throw new Error(\n          'VideoGenerationClient requires either a connection or fetcher option',\n        )\n      }\n      if (!signal.aborted && this.status === 'success') {\n        this.devtoolsBridge.finishRun(\n          this.devtoolsBridge.getActiveRunId() ?? runId,\n          'run:completed',\n          'completed',\n        )\n      }\n    } catch (err: unknown) {\n      if (signal.aborted) return\n      const error = err instanceof Error ? err : new Error(String(err))\n      this.setError(error)\n      this.setStatus('error')\n      this.devtoolsBridge.finishRun(\n        this.devtoolsBridge.getActiveRunId() ?? runId,\n        'run:errored',\n        'errored',\n        error.message,\n      )\n      this.callbacksRef.onError?.(error)\n    } finally {\n      this.abortController = null\n      this.setIsLoading(false)\n    }\n  }\n\n  /**\n   * Direct fetcher mode: call fetcher and set result.\n   */\n  private async generateWithFetcher(\n    input: VideoGenerateInput,\n    signal: AbortSignal,\n    runId: string,\n  ): Promise<void> {\n    if (!this.fetcher) return\n\n    // Fetcher returns a completed result directly, or a Response with SSE body\n    const result = await this.fetcher(input, { signal })\n    if (signal.aborted) return\n\n    if (result instanceof Response) {\n      // Server function returned SSE Response — parse stream\n      await this.processStream(parseSSEResponse(result, signal), runId)\n    } else {\n      this.devtoolsBridge.ensureRunStarted(runId)\n      this.setResult(result)\n      this.setStatus('success')\n    }\n  }\n\n  /**\n   * Process a stream of AG-UI events from the streaming connection adapter.\n   * The server handles the polling loop and streams status updates.\n   */\n  private async processStream(\n    source: AsyncIterable<StreamChunk>,\n    fallbackRunId: string,\n  ): Promise<void> {\n    let streamRunId: string | undefined\n\n    for await (const chunk of source) {\n      if (this.abortController?.signal.aborted) break\n\n      this.callbacksRef.onChunk?.(chunk)\n      const chunkRunId =\n        'runId' in chunk && typeof chunk.runId === 'string'\n          ? chunk.runId\n          : undefined\n\n      // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- AG-UI EventType has ~22 variants; this consumer only handles the subset relevant to video generation lifecycle.\n      switch (chunk.type) {\n        case 'RUN_STARTED': {\n          streamRunId = chunk.runId\n          this.devtoolsBridge.ensureRunStarted(chunk.runId)\n          break\n        }\n        case 'CUSTOM': {\n          this.devtoolsBridge.ensureRunStarted(streamRunId ?? fallbackRunId)\n          if (chunk.name === GENERATION_EVENTS.VIDEO_JOB_CREATED) {\n            const { jobId } = chunk.value as { jobId: string }\n            this.setJobId(jobId)\n            this.callbacksRef.onJobCreated?.(jobId)\n          } else if (chunk.name === GENERATION_EVENTS.VIDEO_STATUS) {\n            const statusInfo = chunk.value as VideoStatusInfo\n            this.setVideoStatus(statusInfo)\n            this.callbacksRef.onStatusUpdate?.(statusInfo)\n            if (statusInfo.progress !== undefined) {\n              this.setProgress(statusInfo.progress)\n            }\n          } else if (chunk.name === GENERATION_EVENTS.RESULT) {\n            this.setResult(chunk.value as VideoGenerateResult)\n          } else if (chunk.name === GENERATION_EVENTS.PROGRESS) {\n            const { progress, message } = chunk.value as {\n              progress: number\n              message?: string\n            }\n            this.setProgress(progress, message)\n          }\n          break\n        }\n        case 'RUN_FINISHED': {\n          streamRunId = chunk.runId\n          this.devtoolsBridge.ensureRunStarted(chunk.runId)\n          this.setStatus('success')\n          break\n        }\n        case 'RUN_ERROR': {\n          this.devtoolsBridge.ensureRunStarted(\n            chunkRunId ?? streamRunId ?? fallbackRunId,\n          )\n          // Prefer spec `message`; fall back to deprecated `error.message`\n          const msg =\n            (chunk.message as string | undefined) ||\n            chunk.error?.message ||\n            'An error occurred'\n          throw new Error(msg)\n        }\n        default:\n          break\n      }\n    }\n  }\n\n  /**\n   * Abort any in-flight generation or polling.\n   */\n  stop(): void {\n    const runId = this.devtoolsBridge.getActiveRunId()\n    if (this.abortController) {\n      this.abortController.abort()\n      this.abortController = null\n    }\n    this.setIsLoading(false)\n    if (this.status === 'generating') {\n      this.setStatus('idle')\n      if (runId) {\n        this.devtoolsBridge.finishRun(runId, 'run:cancelled', 'cancelled')\n      }\n    }\n  }\n\n  /**\n   * Clear all state and return to idle.\n   */\n  reset(): void {\n    this.stop()\n    this.setResult(null)\n    this.input = null\n    this.progress = null\n    this.devtoolsBridge.resetRuns()\n    this.setJobId(null)\n    this.setVideoStatus(null)\n    this.setError(undefined)\n    this.setStatus('idle')\n    this.devtoolsBridge.emitState()\n  }\n\n  /**\n   * Update options without recreating the client.\n   */\n  updateOptions(\n    options: Partial<\n      Pick<\n        VideoGenerationClientOptions<TOutput>,\n        | 'body'\n        | 'onResult'\n        | 'onError'\n        | 'onProgress'\n        | 'onChunk'\n        | 'onJobCreated'\n        | 'onStatusUpdate'\n      >\n    >,\n  ): void {\n    if (options.body !== undefined) {\n      this.body = options.body ?? {}\n    }\n    if (options.onResult !== undefined) {\n      this.callbacksRef.onResult = options.onResult\n    }\n    if (options.onError !== undefined) {\n      this.callbacksRef.onError = options.onError\n    }\n    if (options.onProgress !== undefined) {\n      this.callbacksRef.onProgress = options.onProgress\n    }\n    if (options.onChunk !== undefined) {\n      this.callbacksRef.onChunk = options.onChunk\n    }\n    if (options.onJobCreated !== undefined) {\n      this.callbacksRef.onJobCreated = options.onJobCreated\n    }\n    if (options.onStatusUpdate !== undefined) {\n      this.callbacksRef.onStatusUpdate = options.onStatusUpdate\n    }\n  }\n\n  dispose(): void {\n    this.stop()\n    this.devtoolsBridge.dispose()\n    this.devtoolsMounted = false\n  }\n\n  // ===========================\n  // Getters\n  // ===========================\n\n  getResult(): TOutput | null {\n    return this.result\n  }\n\n  getJobId(): string | null {\n    return this.jobId\n  }\n\n  getVideoStatus(): VideoStatusInfo | null {\n    return this.videoStatus\n  }\n\n  getIsLoading(): boolean {\n    return this.isLoading\n  }\n\n  getError(): Error | undefined {\n    return this.error\n  }\n\n  getStatus(): GenerationClientState {\n    return this.status\n  }\n\n  // ===========================\n  // Private state setters\n  // ===========================\n\n  private setResult(rawResult: VideoGenerateResult | null): void {\n    if (rawResult === null) {\n      this.result = null\n      this.callbacksRef.onResultChange?.(null)\n      this.devtoolsBridge.recordResultChange()\n      return\n    }\n\n    const completedStatus = this.createCompletedVideoStatus(rawResult)\n    if (this.progress?.value !== 100) {\n      this.setProgress(100, this.progress?.message)\n    }\n    this.setJobId(rawResult.jobId)\n    this.setVideoStatus(completedStatus)\n\n    if (this.callbacksRef.onResult) {\n      const transformed = this.callbacksRef.onResult(rawResult)\n      if (transformed === null) {\n        // null return → keep previous result unchanged, just re-emit\n        this.devtoolsBridge.emitState()\n        return\n      }\n      if (transformed !== undefined) {\n        // Non-null, non-undefined → use transformed value\n        this.result = transformed\n        this.callbacksRef.onResultChange?.(this.result)\n        this.devtoolsBridge.recordResultChange()\n        return\n      }\n    }\n\n    // No onResult callback, or callback returned void → use raw value as\n    // TOutput. When the caller did not supply an onResult transform,\n    // `TOutput` defaults to `VideoGenerateResult`, so the runtime cast is\n    // sound.\n    // eslint-disable-next-line no-restricted-syntax -- TOutput defaults to VideoGenerateResult when no onResult transform is supplied\n    this.result = rawResult as unknown as TOutput\n    this.callbacksRef.onResultChange?.(this.result)\n    this.devtoolsBridge.recordResultChange()\n  }\n\n  private setJobId(jobId: string | null): void {\n    this.jobId = jobId\n    this.callbacksRef.onJobIdChange?.(jobId)\n    this.devtoolsBridge.recordJobIdChange()\n  }\n\n  private setVideoStatus(status: VideoStatusInfo | null): void {\n    this.videoStatus = status\n    this.callbacksRef.onVideoStatusChange?.(status)\n    this.devtoolsBridge.recordVideoStatusChange()\n  }\n\n  private setIsLoading(isLoading: boolean): void {\n    this.isLoading = isLoading\n    this.callbacksRef.onLoadingChange?.(isLoading)\n    this.devtoolsBridge.recordLoadingChange()\n  }\n\n  private setError(error: Error | undefined): void {\n    this.error = error\n    this.callbacksRef.onErrorChange?.(error)\n    this.devtoolsBridge.recordErrorChange(error)\n  }\n\n  private setStatus(status: GenerationClientState): void {\n    this.status = status\n    this.callbacksRef.onStatusChange?.(status)\n    this.devtoolsBridge.recordStatusChange(status)\n  }\n\n  private setProgress(value: number, message?: string): void {\n    this.progress = {\n      value,\n      ...(message ? { message } : {}),\n    }\n    if (message === undefined) {\n      this.callbacksRef.onProgress?.(value)\n    } else {\n      this.callbacksRef.onProgress?.(value, message)\n    }\n    this.devtoolsBridge.recordProgressChange()\n  }\n\n  private createCompletedVideoStatus(\n    result: VideoGenerateResult,\n  ): VideoStatusInfo {\n    return {\n      jobId: result.jobId,\n      status: result.status,\n      progress: 100,\n      url: result.url,\n    }\n  }\n\n  private createDevtoolsMetadata(\n    metadata?: Partial<AIDevtoolsClientMetadata>,\n  ): AIDevtoolsClientMetadata {\n    return {\n      hookName: metadata?.hookName ?? 'useGenerateVideo',\n      outputKind: metadata?.outputKind ?? 'video',\n      ...(metadata?.framework ? { framework: metadata.framework } : {}),\n      ...(metadata?.name ? { name: metadata.name } : {}),\n    }\n  }\n\n  private generateUniqueId(prefix: string): string {\n    return `${prefix}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n\n  private createRunContext(runId: string): RunAgentInputContext {\n    return {\n      threadId: this.threadId,\n      runId,\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"video-generation-client.js","sources":["../../src/video-generation-client.ts"],"sourcesContent":["import { GENERATION_EVENTS } from './generation-types'\nimport { createNoOpVideoDevtoolsBridge } from './devtools-noop'\nimport { parseSSEResponse } from './sse-parser'\nimport type { StreamChunk } from '@tanstack/ai/client'\nimport type {\n  ConnectConnectionAdapter,\n  RunAgentInputContext,\n} from './connection-adapters'\nimport type {\n  AIDevtoolsClientMetadata,\n  AIDevtoolsGenerationProgress,\n  VideoDevtoolsBridge,\n  VideoDevtoolsBridgeOptions,\n} from './devtools'\nimport type {\n  GenerationClientState,\n  GenerationFetcher,\n  VideoGenerateInput,\n  VideoGenerateResult,\n  VideoGenerationClientOptions,\n  VideoStatusInfo,\n} from './generation-types'\n\n/**\n * Callbacks stored in a ref so hooks can update them without recreating the client.\n */\n// All optional fields explicitly allow `| undefined` so callers can spread\n// option bags (where each callback may be `undefined`) into the callbacks\n// ref under `exactOptionalPropertyTypes`.\ninterface VideoCallbacks<TOutput> {\n  onResult?:\n    | ((result: VideoGenerateResult) => TOutput | null | void)\n    | undefined\n  onError?: ((error: Error) => void) | undefined\n  onProgress?: ((progress: number, message?: string) => void) | undefined\n  onChunk?: ((chunk: StreamChunk) => void) | undefined\n  onJobCreated?: ((jobId: string) => void) | undefined\n  onStatusUpdate?: ((status: VideoStatusInfo) => void) | undefined\n  onResultChange?: ((result: TOutput | null) => void) | undefined\n  onLoadingChange?: ((isLoading: boolean) => void) | undefined\n  onErrorChange?: ((error: Error | undefined) => void) | undefined\n  onStatusChange?: ((status: GenerationClientState) => void) | undefined\n  onJobIdChange?: ((jobId: string | null) => void) | undefined\n  onVideoStatusChange?: ((status: VideoStatusInfo | null) => void) | undefined\n}\n\n/**\n * A specialized client for job-based video generation.\n *\n * Video generation is asynchronous: a job is created, then polled for status\n * until completion. This client handles the full lifecycle.\n *\n * Supports two transport modes:\n * - **ConnectConnectionAdapter** — Server handles the polling loop internally and\n *   streams status updates via CUSTOM events.\n * - **Fetcher** — Direct async function that returns a completed\n *   `VideoGenerateResult`.\n *\n * @example\n * ```typescript\n * // With streaming connection adapter (server-driven polling)\n * const client = new VideoGenerationClient({\n *   connection: fetchServerSentEvents('/api/generate/video'),\n *   onResultChange: setResult,\n *   onVideoStatusChange: setVideoStatus,\n * })\n *\n * // With fetcher (direct result)\n * const client = new VideoGenerationClient({\n *   fetcher: async (input) => {\n *     const res = await fetch('/api/video/generate', {\n *       method: 'POST',\n *       body: JSON.stringify(input),\n *     })\n *     return res.json() // { jobId, status: 'completed', url, expiresAt }\n *   },\n * })\n *\n * await client.generate({ prompt: 'A flying car over a city' })\n * ```\n */\nexport class VideoGenerationClient<TOutput = VideoGenerateResult> {\n  private readonly connection: ConnectConnectionAdapter | undefined\n  private readonly fetcher:\n    | GenerationFetcher<VideoGenerateInput, VideoGenerateResult>\n    | undefined\n  private readonly uniqueId: string\n  private readonly devtoolsMetadata: AIDevtoolsClientMetadata\n  private readonly devtoolsBridge: VideoDevtoolsBridge<TOutput>\n  private readonly threadId: string\n  private body: Record<string, any>\n\n  private result: TOutput | null = null\n  private input: VideoGenerateInput | null = null\n  private progress: AIDevtoolsGenerationProgress | null = null\n  private jobId: string | null = null\n  private videoStatus: VideoStatusInfo | null = null\n  private isLoading = false\n  private error: Error | undefined = undefined\n  private status: GenerationClientState = 'idle'\n  private abortController: AbortController | null = null\n  private readonly callbacksRef: VideoCallbacks<TOutput>\n  private devtoolsMounted = false\n\n  constructor(\n    options: VideoGenerationClientOptions<TOutput> &\n      (\n        | { connection: ConnectConnectionAdapter; fetcher?: never }\n        | {\n            fetcher: GenerationFetcher<VideoGenerateInput, VideoGenerateResult>\n            connection?: never\n          }\n      ),\n  ) {\n    this.uniqueId = options.id ?? this.generateUniqueId('video')\n    this.threadId = this.uniqueId\n    this.connection = options.connection\n    this.fetcher = options.fetcher\n    this.body = options.body ?? {}\n\n    this.callbacksRef = {\n      onResult: options.onResult,\n      onError: options.onError,\n      onProgress: options.onProgress,\n      onChunk: options.onChunk,\n      onJobCreated: options.onJobCreated,\n      onStatusUpdate: options.onStatusUpdate,\n      onResultChange: options.onResultChange,\n      onLoadingChange: options.onLoadingChange,\n      onErrorChange: options.onErrorChange,\n      onStatusChange: options.onStatusChange,\n      onJobIdChange: options.onJobIdChange,\n      onVideoStatusChange: options.onVideoStatusChange,\n    }\n\n    this.devtoolsMetadata = this.createDevtoolsMetadata(options.devtools)\n    this.devtoolsBridge = (\n      options.devtoolsBridgeFactory ?? createNoOpVideoDevtoolsBridge\n    )<TOutput>(this.buildDevtoolsBridgeOptions())\n  }\n\n  private buildDevtoolsBridgeOptions(): VideoDevtoolsBridgeOptions<TOutput> {\n    return {\n      hookId: this.uniqueId,\n      clientId: this.uniqueId,\n      threadId: this.threadId,\n      metadata: this.devtoolsMetadata,\n      getCoreState: () => ({\n        input: this.input,\n        result: this.result,\n        progress: this.progress,\n        status: this.status,\n        isLoading: this.isLoading,\n        jobId: this.jobId,\n        videoStatus: this.videoStatus,\n        ...(this.error ? { error: this.error.message } : {}),\n      }),\n    }\n  }\n\n  mountDevtools(): void {\n    if (this.devtoolsMounted) {\n      return\n    }\n\n    this.devtoolsMounted = true\n    this.devtoolsBridge.emitRegistered()\n    this.devtoolsBridge.emitSnapshot()\n  }\n\n  /**\n   * Trigger video generation.\n   * Only one generation can be in-flight at a time.\n   */\n  async generate(input: VideoGenerateInput): Promise<void> {\n    this.mountDevtools()\n    if (this.isLoading) return\n\n    this.input = input\n    this.progress = null\n    const runId = this.devtoolsBridge.beginRun(input)\n    this.setIsLoading(true)\n    this.setStatus('generating')\n    this.setError(undefined)\n    this.setJobId(null)\n    this.setVideoStatus(null)\n\n    const abortController = new AbortController()\n    this.abortController = abortController\n    const { signal } = abortController\n\n    try {\n      if (this.fetcher) {\n        await this.generateWithFetcher(input, signal, runId)\n      } else if (this.connection) {\n        const mergedData = { ...this.body, ...input }\n        const stream = this.connection.connect(\n          [],\n          mergedData,\n          signal,\n          this.createRunContext(runId),\n        )\n        await this.processStream(stream, runId)\n      } else {\n        throw new Error(\n          'VideoGenerationClient requires either a connection or fetcher option',\n        )\n      }\n      if (!signal.aborted && this.status === 'success') {\n        this.devtoolsBridge.finishRun(\n          this.devtoolsBridge.getActiveRunId() ?? runId,\n          'run:completed',\n          'completed',\n        )\n      }\n    } catch (err: unknown) {\n      if (signal.aborted) return\n      const error = err instanceof Error ? err : new Error(String(err))\n      this.setError(error)\n      this.setStatus('error')\n      this.devtoolsBridge.finishRun(\n        this.devtoolsBridge.getActiveRunId() ?? runId,\n        'run:errored',\n        'errored',\n        error.message,\n      )\n      this.callbacksRef.onError?.(error)\n    } finally {\n      this.abortController = null\n      this.setIsLoading(false)\n    }\n  }\n\n  /**\n   * Direct fetcher mode: call fetcher and set result.\n   */\n  private async generateWithFetcher(\n    input: VideoGenerateInput,\n    signal: AbortSignal,\n    runId: string,\n  ): Promise<void> {\n    if (!this.fetcher) return\n\n    // Fetcher returns a completed result directly, or a Response with SSE body\n    const result = await this.fetcher(input, { signal })\n    if (signal.aborted) return\n\n    if (result instanceof Response) {\n      // Server function returned SSE Response — parse stream\n      await this.processStream(parseSSEResponse(result, signal), runId)\n    } else {\n      this.devtoolsBridge.ensureRunStarted(runId)\n      this.setResult(result)\n      this.setStatus('success')\n    }\n  }\n\n  /**\n   * Process a stream of AG-UI events from the streaming connection adapter.\n   * The server handles the polling loop and streams status updates.\n   */\n  private async processStream(\n    source: AsyncIterable<StreamChunk>,\n    fallbackRunId: string,\n  ): Promise<void> {\n    let streamRunId: string | undefined\n\n    for await (const chunk of source) {\n      if (this.abortController?.signal.aborted) break\n\n      this.callbacksRef.onChunk?.(chunk)\n      const chunkRunId =\n        'runId' in chunk && typeof chunk.runId === 'string'\n          ? chunk.runId\n          : undefined\n\n      // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- AG-UI EventType has ~22 variants; this consumer only handles the subset relevant to video generation lifecycle.\n      switch (chunk.type) {\n        case 'RUN_STARTED': {\n          streamRunId = chunk.runId\n          this.devtoolsBridge.ensureRunStarted(chunk.runId)\n          break\n        }\n        case 'CUSTOM': {\n          this.devtoolsBridge.ensureRunStarted(streamRunId ?? fallbackRunId)\n          if (chunk.name === GENERATION_EVENTS.VIDEO_JOB_CREATED) {\n            const { jobId } = chunk.value as { jobId: string }\n            this.setJobId(jobId)\n            this.callbacksRef.onJobCreated?.(jobId)\n          } else if (chunk.name === GENERATION_EVENTS.VIDEO_STATUS) {\n            const statusInfo = chunk.value as VideoStatusInfo\n            this.setVideoStatus(statusInfo)\n            this.callbacksRef.onStatusUpdate?.(statusInfo)\n            if (statusInfo.progress !== undefined) {\n              this.setProgress(statusInfo.progress)\n            }\n          } else if (chunk.name === GENERATION_EVENTS.RESULT) {\n            this.setResult(chunk.value as VideoGenerateResult)\n          } else if (chunk.name === GENERATION_EVENTS.PROGRESS) {\n            const { progress, message } = chunk.value as {\n              progress: number\n              message?: string\n            }\n            this.setProgress(progress, message)\n          }\n          break\n        }\n        case 'RUN_FINISHED': {\n          streamRunId = chunk.runId\n          this.devtoolsBridge.ensureRunStarted(chunk.runId)\n          this.setStatus('success')\n          break\n        }\n        case 'RUN_ERROR': {\n          this.devtoolsBridge.ensureRunStarted(\n            chunkRunId ?? streamRunId ?? fallbackRunId,\n          )\n          // Prefer spec `message`; fall back to deprecated `error.message`\n          const msg =\n            (chunk.message as string | undefined) ||\n            chunk.error?.message ||\n            'An error occurred'\n          throw new Error(msg)\n        }\n        default:\n          break\n      }\n    }\n  }\n\n  /**\n   * Abort any in-flight generation or polling.\n   */\n  stop(): void {\n    const runId = this.devtoolsBridge.getActiveRunId()\n    if (this.abortController) {\n      this.abortController.abort()\n      this.abortController = null\n    }\n    this.setIsLoading(false)\n    if (this.status === 'generating') {\n      this.setStatus('idle')\n      if (runId) {\n        this.devtoolsBridge.finishRun(runId, 'run:cancelled', 'cancelled')\n      }\n    }\n  }\n\n  /**\n   * Clear all state and return to idle.\n   */\n  reset(): void {\n    this.stop()\n    this.setResult(null)\n    this.input = null\n    this.progress = null\n    this.devtoolsBridge.resetRuns()\n    this.setJobId(null)\n    this.setVideoStatus(null)\n    this.setError(undefined)\n    this.setStatus('idle')\n    this.devtoolsBridge.emitState()\n  }\n\n  /**\n   * Update options without recreating the client.\n   */\n  updateOptions(\n    options: Partial<\n      Pick<\n        VideoGenerationClientOptions<TOutput>,\n        | 'body'\n        | 'onResult'\n        | 'onError'\n        | 'onProgress'\n        | 'onChunk'\n        | 'onJobCreated'\n        | 'onStatusUpdate'\n      >\n    >,\n  ): void {\n    if (options.body !== undefined) {\n      this.body = options.body ?? {}\n    }\n    if (options.onResult !== undefined) {\n      this.callbacksRef.onResult = options.onResult\n    }\n    if (options.onError !== undefined) {\n      this.callbacksRef.onError = options.onError\n    }\n    if (options.onProgress !== undefined) {\n      this.callbacksRef.onProgress = options.onProgress\n    }\n    if (options.onChunk !== undefined) {\n      this.callbacksRef.onChunk = options.onChunk\n    }\n    if (options.onJobCreated !== undefined) {\n      this.callbacksRef.onJobCreated = options.onJobCreated\n    }\n    if (options.onStatusUpdate !== undefined) {\n      this.callbacksRef.onStatusUpdate = options.onStatusUpdate\n    }\n  }\n\n  dispose(): void {\n    this.stop()\n    this.devtoolsBridge.dispose()\n    this.devtoolsMounted = false\n  }\n\n  // ===========================\n  // Getters\n  // ===========================\n\n  getResult(): TOutput | null {\n    return this.result\n  }\n\n  getJobId(): string | null {\n    return this.jobId\n  }\n\n  getVideoStatus(): VideoStatusInfo | null {\n    return this.videoStatus\n  }\n\n  getIsLoading(): boolean {\n    return this.isLoading\n  }\n\n  getError(): Error | undefined {\n    return this.error\n  }\n\n  getStatus(): GenerationClientState {\n    return this.status\n  }\n\n  // ===========================\n  // Private state setters\n  // ===========================\n\n  private setResult(rawResult: VideoGenerateResult | null): void {\n    if (rawResult === null) {\n      this.result = null\n      this.callbacksRef.onResultChange?.(null)\n      this.devtoolsBridge.recordResultChange()\n      return\n    }\n\n    const completedStatus = this.createCompletedVideoStatus(rawResult)\n    if (this.progress?.value !== 100) {\n      this.setProgress(100, this.progress?.message)\n    }\n    this.setJobId(rawResult.jobId)\n    this.setVideoStatus(completedStatus)\n\n    if (this.callbacksRef.onResult) {\n      const transformed = this.callbacksRef.onResult(rawResult)\n      if (transformed === null) {\n        // null return → keep previous result unchanged, just re-emit\n        this.devtoolsBridge.emitState()\n        return\n      }\n      if (transformed !== undefined) {\n        // Non-null, non-undefined → use transformed value\n        this.result = transformed\n        this.callbacksRef.onResultChange?.(this.result)\n        this.devtoolsBridge.recordResultChange()\n        return\n      }\n    }\n\n    // No onResult callback, or callback returned void → use raw value as\n    // TOutput. When the caller did not supply an onResult transform,\n    // `TOutput` defaults to `VideoGenerateResult`, so the runtime cast is\n    // sound.\n    // eslint-disable-next-line no-restricted-syntax -- TOutput defaults to VideoGenerateResult when no onResult transform is supplied\n    this.result = rawResult as unknown as TOutput\n    this.callbacksRef.onResultChange?.(this.result)\n    this.devtoolsBridge.recordResultChange()\n  }\n\n  private setJobId(jobId: string | null): void {\n    this.jobId = jobId\n    this.callbacksRef.onJobIdChange?.(jobId)\n    this.devtoolsBridge.recordJobIdChange()\n  }\n\n  private setVideoStatus(status: VideoStatusInfo | null): void {\n    this.videoStatus = status\n    this.callbacksRef.onVideoStatusChange?.(status)\n    this.devtoolsBridge.recordVideoStatusChange()\n  }\n\n  private setIsLoading(isLoading: boolean): void {\n    this.isLoading = isLoading\n    this.callbacksRef.onLoadingChange?.(isLoading)\n    this.devtoolsBridge.recordLoadingChange()\n  }\n\n  private setError(error: Error | undefined): void {\n    this.error = error\n    this.callbacksRef.onErrorChange?.(error)\n    this.devtoolsBridge.recordErrorChange(error)\n  }\n\n  private setStatus(status: GenerationClientState): void {\n    this.status = status\n    this.callbacksRef.onStatusChange?.(status)\n    this.devtoolsBridge.recordStatusChange(status)\n  }\n\n  private setProgress(value: number, message?: string): void {\n    this.progress = {\n      value,\n      ...(message ? { message } : {}),\n    }\n    if (message === undefined) {\n      this.callbacksRef.onProgress?.(value)\n    } else {\n      this.callbacksRef.onProgress?.(value, message)\n    }\n    this.devtoolsBridge.recordProgressChange()\n  }\n\n  private createCompletedVideoStatus(\n    result: VideoGenerateResult,\n  ): VideoStatusInfo {\n    return {\n      jobId: result.jobId,\n      status: result.status,\n      progress: 100,\n      url: result.url,\n    }\n  }\n\n  private createDevtoolsMetadata(\n    metadata?: Partial<AIDevtoolsClientMetadata>,\n  ): AIDevtoolsClientMetadata {\n    return {\n      hookName: metadata?.hookName ?? 'useGenerateVideo',\n      outputKind: metadata?.outputKind ?? 'video',\n      ...(metadata?.framework ? { framework: metadata.framework } : {}),\n      ...(metadata?.name ? { name: metadata.name } : {}),\n    }\n  }\n\n  private generateUniqueId(prefix: string): string {\n    return `${prefix}-${Date.now()}-${Math.random().toString(36).substring(7)}`\n  }\n\n  private createRunContext(runId: string): RunAgentInputContext {\n    return {\n      threadId: this.threadId,\n      runId,\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAiFO,MAAM,sBAAqD;AAAA,EAC/C;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACT;AAAA,EAEA,SAAyB;AAAA,EACzB,QAAmC;AAAA,EACnC,WAAgD;AAAA,EAChD,QAAuB;AAAA,EACvB,cAAsC;AAAA,EACtC,YAAY;AAAA,EACZ,QAA2B;AAAA,EAC3B,SAAgC;AAAA,EAChC,kBAA0C;AAAA,EACjC;AAAA,EACT,kBAAkB;AAAA,EAE1B,YACE,SAQA;AACA,SAAK,WAAW,QAAQ,MAAM,KAAK,iBAAiB,OAAO;AAC3D,SAAK,WAAW,KAAK;AACrB,SAAK,aAAa,QAAQ;AAC1B,SAAK,UAAU,QAAQ;AACvB,SAAK,OAAO,QAAQ,QAAQ,CAAA;AAE5B,SAAK,eAAe;AAAA,MAClB,UAAU,QAAQ;AAAA,MAClB,SAAS,QAAQ;AAAA,MACjB,YAAY,QAAQ;AAAA,MACpB,SAAS,QAAQ;AAAA,MACjB,cAAc,QAAQ;AAAA,MACtB,gBAAgB,QAAQ;AAAA,MACxB,gBAAgB,QAAQ;AAAA,MACxB,iBAAiB,QAAQ;AAAA,MACzB,eAAe,QAAQ;AAAA,MACvB,gBAAgB,QAAQ;AAAA,MACxB,eAAe,QAAQ;AAAA,MACvB,qBAAqB,QAAQ;AAAA,IAAA;AAG/B,SAAK,mBAAmB,KAAK,uBAAuB,QAAQ,QAAQ;AACpE,SAAK,kBACH,QAAQ,yBAAyB,+BACxB,KAAK,4BAA4B;AAAA,EAC9C;AAAA,EAEQ,6BAAkE;AACxE,WAAO;AAAA,MACL,QAAQ,KAAK;AAAA,MACb,UAAU,KAAK;AAAA,MACf,UAAU,KAAK;AAAA,MACf,UAAU,KAAK;AAAA,MACf,cAAc,OAAO;AAAA,QACnB,OAAO,KAAK;AAAA,QACZ,QAAQ,KAAK;AAAA,QACb,UAAU,KAAK;AAAA,QACf,QAAQ,KAAK;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,OAAO,KAAK;AAAA,QACZ,aAAa,KAAK;AAAA,QAClB,GAAI,KAAK,QAAQ,EAAE,OAAO,KAAK,MAAM,YAAY,CAAA;AAAA,MAAC;AAAA,IACpD;AAAA,EAEJ;AAAA,EAEA,gBAAsB;AACpB,QAAI,KAAK,iBAAiB;AACxB;AAAA,IACF;AAEA,SAAK,kBAAkB;AACvB,SAAK,eAAe,eAAA;AACpB,SAAK,eAAe,aAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,SAAS,OAA0C;AACvD,SAAK,cAAA;AACL,QAAI,KAAK,UAAW;AAEpB,SAAK,QAAQ;AACb,SAAK,WAAW;AAChB,UAAM,QAAQ,KAAK,eAAe,SAAS,KAAK;AAChD,SAAK,aAAa,IAAI;AACtB,SAAK,UAAU,YAAY;AAC3B,SAAK,SAAS,MAAS;AACvB,SAAK,SAAS,IAAI;AAClB,SAAK,eAAe,IAAI;AAExB,UAAM,kBAAkB,IAAI,gBAAA;AAC5B,SAAK,kBAAkB;AACvB,UAAM,EAAE,WAAW;AAEnB,QAAI;AACF,UAAI,KAAK,SAAS;AAChB,cAAM,KAAK,oBAAoB,OAAO,QAAQ,KAAK;AAAA,MACrD,WAAW,KAAK,YAAY;AAC1B,cAAM,aAAa,EAAE,GAAG,KAAK,MAAM,GAAG,MAAA;AACtC,cAAM,SAAS,KAAK,WAAW;AAAA,UAC7B,CAAA;AAAA,UACA;AAAA,UACA;AAAA,UACA,KAAK,iBAAiB,KAAK;AAAA,QAAA;AAE7B,cAAM,KAAK,cAAc,QAAQ,KAAK;AAAA,MACxC,OAAO;AACL,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,UAAI,CAAC,OAAO,WAAW,KAAK,WAAW,WAAW;AAChD,aAAK,eAAe;AAAA,UAClB,KAAK,eAAe,eAAA,KAAoB;AAAA,UACxC;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ;AAAA,IACF,SAAS,KAAc;AACrB,UAAI,OAAO,QAAS;AACpB,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,WAAK,SAAS,KAAK;AACnB,WAAK,UAAU,OAAO;AACtB,WAAK,eAAe;AAAA,QAClB,KAAK,eAAe,eAAA,KAAoB;AAAA,QACxC;AAAA,QACA;AAAA,QACA,MAAM;AAAA,MAAA;AAER,WAAK,aAAa,UAAU,KAAK;AAAA,IACnC,UAAA;AACE,WAAK,kBAAkB;AACvB,WAAK,aAAa,KAAK;AAAA,IACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,oBACZ,OACA,QACA,OACe;AACf,QAAI,CAAC,KAAK,QAAS;AAGnB,UAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,EAAE,QAAQ;AACnD,QAAI,OAAO,QAAS;AAEpB,QAAI,kBAAkB,UAAU;AAE9B,YAAM,KAAK,cAAc,iBAAiB,QAAQ,MAAM,GAAG,KAAK;AAAA,IAClE,OAAO;AACL,WAAK,eAAe,iBAAiB,KAAK;AAC1C,WAAK,UAAU,MAAM;AACrB,WAAK,UAAU,SAAS;AAAA,IAC1B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,cACZ,QACA,eACe;AACf,QAAI;AAEJ,qBAAiB,SAAS,QAAQ;AAChC,UAAI,KAAK,iBAAiB,OAAO,QAAS;AAE1C,WAAK,aAAa,UAAU,KAAK;AACjC,YAAM,aACJ,WAAW,SAAS,OAAO,MAAM,UAAU,WACvC,MAAM,QACN;AAGN,cAAQ,MAAM,MAAA;AAAA,QACZ,KAAK,eAAe;AAClB,wBAAc,MAAM;AACpB,eAAK,eAAe,iBAAiB,MAAM,KAAK;AAChD;AAAA,QACF;AAAA,QACA,KAAK,UAAU;AACb,eAAK,eAAe,iBAAiB,eAAe,aAAa;AACjE,cAAI,MAAM,SAAS,kBAAkB,mBAAmB;AACtD,kBAAM,EAAE,UAAU,MAAM;AACxB,iBAAK,SAAS,KAAK;AACnB,iBAAK,aAAa,eAAe,KAAK;AAAA,UACxC,WAAW,MAAM,SAAS,kBAAkB,cAAc;AACxD,kBAAM,aAAa,MAAM;AACzB,iBAAK,eAAe,UAAU;AAC9B,iBAAK,aAAa,iBAAiB,UAAU;AAC7C,gBAAI,WAAW,aAAa,QAAW;AACrC,mBAAK,YAAY,WAAW,QAAQ;AAAA,YACtC;AAAA,UACF,WAAW,MAAM,SAAS,kBAAkB,QAAQ;AAClD,iBAAK,UAAU,MAAM,KAA4B;AAAA,UACnD,WAAW,MAAM,SAAS,kBAAkB,UAAU;AACpD,kBAAM,EAAE,UAAU,QAAA,IAAY,MAAM;AAIpC,iBAAK,YAAY,UAAU,OAAO;AAAA,UACpC;AACA;AAAA,QACF;AAAA,QACA,KAAK,gBAAgB;AACnB,wBAAc,MAAM;AACpB,eAAK,eAAe,iBAAiB,MAAM,KAAK;AAChD,eAAK,UAAU,SAAS;AACxB;AAAA,QACF;AAAA,QACA,KAAK,aAAa;AAChB,eAAK,eAAe;AAAA,YAClB,cAAc,eAAe;AAAA,UAAA;AAG/B,gBAAM,MACH,MAAM,WACP,MAAM,OAAO,WACb;AACF,gBAAM,IAAI,MAAM,GAAG;AAAA,QACrB;AAAA,MAEE;AAAA,IAEN;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACX,UAAM,QAAQ,KAAK,eAAe,eAAA;AAClC,QAAI,KAAK,iBAAiB;AACxB,WAAK,gBAAgB,MAAA;AACrB,WAAK,kBAAkB;AAAA,IACzB;AACA,SAAK,aAAa,KAAK;AACvB,QAAI,KAAK,WAAW,cAAc;AAChC,WAAK,UAAU,MAAM;AACrB,UAAI,OAAO;AACT,aAAK,eAAe,UAAU,OAAO,iBAAiB,WAAW;AAAA,MACnE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,SAAK,KAAA;AACL,SAAK,UAAU,IAAI;AACnB,SAAK,QAAQ;AACb,SAAK,WAAW;AAChB,SAAK,eAAe,UAAA;AACpB,SAAK,SAAS,IAAI;AAClB,SAAK,eAAe,IAAI;AACxB,SAAK,SAAS,MAAS;AACvB,SAAK,UAAU,MAAM;AACrB,SAAK,eAAe,UAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKA,cACE,SAYM;AACN,QAAI,QAAQ,SAAS,QAAW;AAC9B,WAAK,OAAO,QAAQ,QAAQ,CAAA;AAAA,IAC9B;AACA,QAAI,QAAQ,aAAa,QAAW;AAClC,WAAK,aAAa,WAAW,QAAQ;AAAA,IACvC;AACA,QAAI,QAAQ,YAAY,QAAW;AACjC,WAAK,aAAa,UAAU,QAAQ;AAAA,IACtC;AACA,QAAI,QAAQ,eAAe,QAAW;AACpC,WAAK,aAAa,aAAa,QAAQ;AAAA,IACzC;AACA,QAAI,QAAQ,YAAY,QAAW;AACjC,WAAK,aAAa,UAAU,QAAQ;AAAA,IACtC;AACA,QAAI,QAAQ,iBAAiB,QAAW;AACtC,WAAK,aAAa,eAAe,QAAQ;AAAA,IAC3C;AACA,QAAI,QAAQ,mBAAmB,QAAW;AACxC,WAAK,aAAa,iBAAiB,QAAQ;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,UAAgB;AACd,SAAK,KAAA;AACL,SAAK,eAAe,QAAA;AACpB,SAAK,kBAAkB;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAMA,YAA4B;AAC1B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,WAA0B;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,iBAAyC;AACvC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,eAAwB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,WAA8B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAmC;AACjC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAMQ,UAAU,WAA6C;AAC7D,QAAI,cAAc,MAAM;AACtB,WAAK,SAAS;AACd,WAAK,aAAa,iBAAiB,IAAI;AACvC,WAAK,eAAe,mBAAA;AACpB;AAAA,IACF;AAEA,UAAM,kBAAkB,KAAK,2BAA2B,SAAS;AACjE,QAAI,KAAK,UAAU,UAAU,KAAK;AAChC,WAAK,YAAY,KAAK,KAAK,UAAU,OAAO;AAAA,IAC9C;AACA,SAAK,SAAS,UAAU,KAAK;AAC7B,SAAK,eAAe,eAAe;AAEnC,QAAI,KAAK,aAAa,UAAU;AAC9B,YAAM,cAAc,KAAK,aAAa,SAAS,SAAS;AACxD,UAAI,gBAAgB,MAAM;AAExB,aAAK,eAAe,UAAA;AACpB;AAAA,MACF;AACA,UAAI,gBAAgB,QAAW;AAE7B,aAAK,SAAS;AACd,aAAK,aAAa,iBAAiB,KAAK,MAAM;AAC9C,aAAK,eAAe,mBAAA;AACpB;AAAA,MACF;AAAA,IACF;AAOA,SAAK,SAAS;AACd,SAAK,aAAa,iBAAiB,KAAK,MAAM;AAC9C,SAAK,eAAe,mBAAA;AAAA,EACtB;AAAA,EAEQ,SAAS,OAA4B;AAC3C,SAAK,QAAQ;AACb,SAAK,aAAa,gBAAgB,KAAK;AACvC,SAAK,eAAe,kBAAA;AAAA,EACtB;AAAA,EAEQ,eAAe,QAAsC;AAC3D,SAAK,cAAc;AACnB,SAAK,aAAa,sBAAsB,MAAM;AAC9C,SAAK,eAAe,wBAAA;AAAA,EACtB;AAAA,EAEQ,aAAa,WAA0B;AAC7C,SAAK,YAAY;AACjB,SAAK,aAAa,kBAAkB,SAAS;AAC7C,SAAK,eAAe,oBAAA;AAAA,EACtB;AAAA,EAEQ,SAAS,OAAgC;AAC/C,SAAK,QAAQ;AACb,SAAK,aAAa,gBAAgB,KAAK;AACvC,SAAK,eAAe,kBAAkB,KAAK;AAAA,EAC7C;AAAA,EAEQ,UAAU,QAAqC;AACrD,SAAK,SAAS;AACd,SAAK,aAAa,iBAAiB,MAAM;AACzC,SAAK,eAAe,mBAAmB,MAAM;AAAA,EAC/C;AAAA,EAEQ,YAAY,OAAe,SAAwB;AACzD,SAAK,WAAW;AAAA,MACd;AAAA,MACA,GAAI,UAAU,EAAE,YAAY,CAAA;AAAA,IAAC;AAE/B,QAAI,YAAY,QAAW;AACzB,WAAK,aAAa,aAAa,KAAK;AAAA,IACtC,OAAO;AACL,WAAK,aAAa,aAAa,OAAO,OAAO;AAAA,IAC/C;AACA,SAAK,eAAe,qBAAA;AAAA,EACtB;AAAA,EAEQ,2BACN,QACiB;AACjB,WAAO;AAAA,MACL,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf,UAAU;AAAA,MACV,KAAK,OAAO;AAAA,IAAA;AAAA,EAEhB;AAAA,EAEQ,uBACN,UAC0B;AAC1B,WAAO;AAAA,MACL,UAAU,UAAU,YAAY;AAAA,MAChC,YAAY,UAAU,cAAc;AAAA,MACpC,GAAI,UAAU,YAAY,EAAE,WAAW,SAAS,UAAA,IAAc,CAAA;AAAA,MAC9D,GAAI,UAAU,OAAO,EAAE,MAAM,SAAS,KAAA,IAAS,CAAA;AAAA,IAAC;AAAA,EAEpD;AAAA,EAEQ,iBAAiB,QAAwB;AAC/C,WAAO,GAAG,MAAM,IAAI,KAAK,KAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;AAAA,EAC3E;AAAA,EAEQ,iBAAiB,OAAqC;AAC5D,WAAO;AAAA,MACL,UAAU,KAAK;AAAA,MACf;AAAA,IAAA;AAAA,EAEJ;AACF;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "",
   "license": "MIT",
@@ -41,8 +41,8 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/ai": "0.22.1",
-    "@tanstack/ai-event-client": "0.4.0"
+    "@tanstack/ai": "0.23.0",
+    "@tanstack/ai-event-client": "0.4.1"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",

package/src/chat-client.ts

@@ -3,7 +3,7 @@ import {
   convertSchemaToJsonSchema,
   generateMessageId,
   normalizeToUIMessage,
-} from '@tanstack/ai'
+} from '@tanstack/ai/client'
 import { createNoOpChatDevtoolsBridge } from './devtools-noop'
 import {
   fetcherToConnectionAdapter,
@@ -14,7 +14,7 @@ import type {
   ContentPart,
   ModelMessage,
   StreamChunk,
-} from '@tanstack/ai'
+} from '@tanstack/ai/client'
 import type {
   ConnectionAdapter,
   SubscribeConnectionAdapter,

package/src/connection-adapters.ts

@@ -1,11 +1,16 @@
-import { EventType, uiMessagesToWire } from '@tanstack/ai'
+import { EventType, uiMessagesToWire } from '@tanstack/ai/client'
+import {
+  createResponseStreamTextDecoder,
+  getResponseStreamReader,
+} from './response-stream'
+import { parseSseDataLine } from './sse-utils'
 import type {
   ModelMessage,
   RunErrorEvent,
   RunFinishedEvent,
   StreamChunk,
   UIMessage,
-} from '@tanstack/ai'
+} from '@tanstack/ai/client'
 import type { ChatFetcher } from './types'
 
 /**
@@ -71,7 +76,7 @@ async function* readStreamLines(
   abortSignal?: AbortSignal,
 ): AsyncGenerator<string> {
   try {
-    const decoder = new TextDecoder()
+    const decoder = createResponseStreamTextDecoder()
     let buffer = ''
 
     while (!abortSignal?.aborted) {
@@ -125,10 +130,7 @@ async function* responseToSSEChunks(
       `HTTP error! status: ${response.status} ${response.statusText}`,
     )
   }
-  const reader = response.body?.getReader()
-  if (!reader) {
-    throw new Error('Response body is not readable')
-  }
+  const reader = getResponseStreamReader(response)
   let lastThreadId: string | undefined
   let lastRunId: string | undefined
   let lastModel: string | undefined
@@ -141,7 +143,7 @@ async function* responseToSSEChunks(
     ) {
       continue
     }
-    const data = line.startsWith('data: ') ? line.slice(6) : line
+    const data = parseSseDataLine(line)
     if (data === '[DONE]') {
       const synthetic: RunFinishedEvent = {
         type: EventType.RUN_FINISHED,
@@ -381,6 +383,53 @@ export interface FetchConnectionOptions {
   fetchClient?: typeof globalThis.fetch
 }
 
+/**
+ * Options for XHR-based connection adapters.
+ */
+export interface XhrConnectionOptions {
+  headers?: Record<string, string> | Headers
+  withCredentials?: boolean
+  signal?: AbortSignal
+  body?: Record<string, any>
+  xhrFactory?: () => XMLHttpRequest
+}
+
+type ResolvedConnectionOptions = Pick<
+  FetchConnectionOptions,
+  'body' | 'headers'
+>
+
+function buildRunAgentInputBody(
+  messages: Array<UIMessage> | Array<ModelMessage>,
+  data: Record<string, any> | undefined,
+  runContext: RunAgentInputContext | undefined,
+  options: ResolvedConnectionOptions,
+): Record<string, unknown> {
+  // Precedence (later spreads win): static adapter `body` is the base,
+  // overridden by `runContext.forwardedProps`, overridden by per-message `data`.
+  const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)
+  const forwardedProps = {
+    ...options.body,
+    ...(runContext?.forwardedProps ?? {}),
+    ...data,
+  }
+
+  return {
+    threadId: runContext?.threadId ?? generateRunId('thread'),
+    runId: runContext?.runId ?? generateRunId('run'),
+    ...(runContext?.parentRunId !== undefined && {
+      parentRunId: runContext.parentRunId,
+    }),
+    state: {},
+    messages: wireMessages,
+    tools: runContext?.clientTools ?? [],
+    context: [],
+    forwardedProps,
+    // Backward-compat mirror of `forwardedProps` under the legacy field name.
+    data: { ...forwardedProps },
+  }
+}
+
 /**
  * Create a Server-Sent Events connection adapter
  *
@@ -440,34 +489,12 @@ export function fetchServerSentEvents(
       // forwardedProps options), overridden by per-message `data` passed
       // to `connection.send`. Runtime values win over static config —
       // this matches the documented "forwardedProps wins" semantic.
-      const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)
-      const forwardedProps = {
-        ...resolvedOptions.body,
-        ...(runContext?.forwardedProps ?? {}),
-        ...data,
-      }
-      const requestBody = {
-        threadId: runContext?.threadId ?? generateRunId('thread'),
-        runId: runContext?.runId ?? generateRunId('run'),
-        ...(runContext?.parentRunId !== undefined && {
-          parentRunId: runContext.parentRunId,
-        }),
-        state: {},
-        messages: wireMessages,
-        tools: runContext?.clientTools ?? [],
-        context: [],
-        forwardedProps,
-        // Backward-compat mirror of `forwardedProps` under the legacy
-        // field name `data`. Server endpoints that have not migrated
-        // off the pre-AG-UI shape (`{ messages, data }`) keep working.
-        // AG-UI strict consumers strip this via `RunAgentInputSchema`
-        // (see `chatParamsFromRequestBody`). Will be removed when the
-        // legacy `body` client option is dropped.
-        // Shallow-cloned so that downstream mutation of `data` (e.g.
-        // by a logging interceptor or fetch wrapper) cannot corrupt
-        // `forwardedProps` and vice versa.
-        data: { ...forwardedProps },
-      }
+      const requestBody = buildRunAgentInputBody(
+        messages,
+        data,
+        runContext,
+        resolvedOptions,
+      )
 
       const fetchClient = resolvedOptions.fetchClient ?? fetch
       // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`
@@ -546,34 +573,12 @@ export function fetchHttpStream(
       // forwardedProps options), overridden by per-message `data` passed
       // to `connection.send`. Runtime values win over static config —
       // this matches the documented "forwardedProps wins" semantic.
-      const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)
-      const forwardedProps = {
-        ...resolvedOptions.body,
-        ...(runContext?.forwardedProps ?? {}),
-        ...data,
-      }
-      const requestBody = {
-        threadId: runContext?.threadId ?? generateRunId('thread'),
-        runId: runContext?.runId ?? generateRunId('run'),
-        ...(runContext?.parentRunId !== undefined && {
-          parentRunId: runContext.parentRunId,
-        }),
-        state: {},
-        messages: wireMessages,
-        tools: runContext?.clientTools ?? [],
-        context: [],
-        forwardedProps,
-        // Backward-compat mirror of `forwardedProps` under the legacy
-        // field name `data`. Server endpoints that have not migrated
-        // off the pre-AG-UI shape (`{ messages, data }`) keep working.
-        // AG-UI strict consumers strip this via `RunAgentInputSchema`
-        // (see `chatParamsFromRequestBody`). Will be removed when the
-        // legacy `body` client option is dropped.
-        // Shallow-cloned so that downstream mutation of `data` (e.g.
-        // by a logging interceptor or fetch wrapper) cannot corrupt
-        // `forwardedProps` and vice versa.
-        data: { ...forwardedProps },
-      }
+      const requestBody = buildRunAgentInputBody(
+        messages,
+        data,
+        runContext,
+        resolvedOptions,
+      )
 
       const fetchClient = resolvedOptions.fetchClient ?? fetch
       // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`
@@ -595,10 +600,7 @@ export function fetchHttpStream(
       }
 
       // Parse raw HTTP stream (newline-delimited JSON)
-      const reader = response.body?.getReader()
-      if (!reader) {
-        throw new Error('Response body is not readable')
-      }
+      const reader = getResponseStreamReader(response)
 
       for await (const line of readStreamLines(reader, abortSignal)) {
         yield JSON.parse(line) as StreamChunk
@@ -607,6 +609,296 @@ export function fetchHttpStream(
   }
 }
 
+type XhrConnectionOptionsResolver =
+  | XhrConnectionOptions
+  | (() => XhrConnectionOptions | Promise<XhrConnectionOptions>)
+
+function createDefaultXMLHttpRequest(): XMLHttpRequest {
+  if (typeof globalThis.XMLHttpRequest !== 'function') {
+    throw new Error('XMLHttpRequest is not available in this runtime')
+  }
+
+  return new globalThis.XMLHttpRequest()
+}
+
+function cleanupXhr(
+  xhr: XMLHttpRequest,
+  abortSignal: AbortSignal | undefined,
+  onAbort: (() => void) | undefined,
+): void {
+  xhr.onprogress = null
+  xhr.onload = null
+  xhr.onerror = null
+  xhr.onabort = null
+  xhr.onloadend = null
+
+  if (abortSignal && onAbort) {
+    abortSignal.removeEventListener('abort', onAbort)
+  }
+}
+
+function readXhrLines(
+  xhr: XMLHttpRequest,
+  abortSignal?: AbortSignal,
+): AsyncGenerator<string> {
+  let offset = 0
+  let buffer = ''
+  const lines: Array<string> = []
+  const waiters: Array<() => void> = []
+  let done = false
+  let aborted = false
+  let error: unknown
+  let onAbort: (() => void) | undefined
+
+  const wake = () => {
+    const waiter = waiters.shift()
+    waiter?.()
+  }
+
+  const enqueueDelta = () => {
+    if (xhr.status !== 0 && (xhr.status < 200 || xhr.status >= 300)) {
+      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`)
+      done = true
+      return
+    }
+
+    const responseText = xhr.responseText
+    if (responseText.length <= offset) {
+      return
+    }
+
+    buffer += responseText.slice(offset)
+    offset = responseText.length
+    const splitLines = buffer.split('\n')
+    buffer = splitLines.pop() ?? ''
+
+    for (const line of splitLines) {
+      const normalized = line.endsWith('\r') ? line.slice(0, -1) : line
+      if (normalized.trim()) {
+        lines.push(normalized)
+      }
+    }
+  }
+
+  const finish = () => {
+    enqueueDelta()
+    if (xhr.status < 200 || xhr.status >= 300) {
+      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`)
+    } else if (buffer.trim() && !aborted) {
+      error = new StreamTruncatedError()
+    }
+    done = true
+    wake()
+  }
+
+  xhr.onprogress = () => {
+    enqueueDelta()
+    wake()
+  }
+  xhr.onload = finish
+  xhr.onerror = () => {
+    error = new Error('XHR request failed')
+    done = true
+    wake()
+  }
+  xhr.onabort = () => {
+    aborted = true
+    done = true
+    wake()
+  }
+  xhr.onloadend = () => {
+    if (!done) {
+      finish()
+    }
+  }
+
+  if (abortSignal) {
+    onAbort = () => {
+      aborted = true
+      xhr.abort()
+    }
+    if (abortSignal.aborted) {
+      onAbort()
+    } else {
+      abortSignal.addEventListener('abort', onAbort, { once: true })
+    }
+  }
+
+  return (async function* () {
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      while (true) {
+        const line = lines.shift()
+        if (line !== undefined) {
+          yield line
+          continue
+        }
+
+        if (error) {
+          throw error
+        }
+
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (done || abortSignal?.aborted) {
+          return
+        }
+
+        await new Promise<void>((resolve) => {
+          waiters.push(resolve)
+        })
+      }
+    } finally {
+      cleanupXhr(xhr, abortSignal, onAbort)
+    }
+  })()
+}
+
+interface ConfiguredXhrRequest {
+  xhr: XMLHttpRequest
+  body: string
+}
+
+function createConfiguredXhrRequest(
+  url: string,
+  options: XhrConnectionOptions,
+  messages: Array<UIMessage> | Array<ModelMessage>,
+  data: Record<string, any> | undefined,
+  runContext: RunAgentInputContext | undefined,
+): ConfiguredXhrRequest {
+  const xhr = options.xhrFactory?.() ?? createDefaultXMLHttpRequest()
+  xhr.open('POST', url)
+  if (options.withCredentials !== undefined) {
+    xhr.withCredentials = options.withCredentials
+  }
+
+  const requestHeaders: Record<string, string> = {
+    'Content-Type': 'application/json',
+    ...mergeHeaders(options.headers),
+  }
+
+  for (const [name, value] of Object.entries(requestHeaders)) {
+    xhr.setRequestHeader(name, value)
+  }
+
+  const requestBody = buildRunAgentInputBody(
+    messages,
+    data,
+    runContext,
+    options,
+  )
+
+  return { xhr, body: JSON.stringify(requestBody) }
+}
+
+async function resolveXhrConnectionOptions(
+  options: XhrConnectionOptionsResolver,
+): Promise<XhrConnectionOptions> {
+  return typeof options === 'function' ? await options() : options
+}
+
+/**
+ * Create an XMLHttpRequest-backed Server-Sent Events connection adapter.
+ */
+export function xhrServerSentEvents(
+  url: string | (() => string),
+  options: XhrConnectionOptionsResolver = {},
+): ConnectConnectionAdapter {
+  return {
+    async *connect(messages, data, abortSignal, runContext) {
+      const resolvedUrl = typeof url === 'function' ? url() : url
+      const resolvedOptions = await resolveXhrConnectionOptions(options)
+      const signal = abortSignal || resolvedOptions.signal
+      const request = createConfiguredXhrRequest(
+        resolvedUrl,
+        resolvedOptions,
+        messages,
+        data,
+        runContext,
+      )
+      const lines = readXhrLines(request.xhr, signal)
+      if (signal?.aborted) {
+        await lines.next()
+        return
+      }
+      request.xhr.send(request.body)
+      let lastThreadId: string | undefined
+      let lastRunId: string | undefined
+      let lastModel: string | undefined
+
+      for await (const line of lines) {
+        if (
+          line.startsWith(':') ||
+          line.startsWith('event:') ||
+          line.startsWith('id:') ||
+          line.startsWith('retry:')
+        ) {
+          continue
+        }
+
+        const chunkData = parseSseDataLine(line)
+        if (chunkData === '[DONE]') {
+          const synthetic: RunFinishedEvent = {
+            type: EventType.RUN_FINISHED,
+            threadId: lastThreadId ?? runContext?.threadId ?? '',
+            runId: lastRunId ?? runContext?.runId ?? '',
+            model: lastModel ?? '',
+            timestamp: Date.now(),
+            finishReason: 'stop',
+          }
+          request.xhr.abort()
+          yield synthetic
+          return
+        }
+
+        const chunk = JSON.parse(chunkData) as StreamChunk
+        if ('threadId' in chunk && typeof chunk.threadId === 'string') {
+          lastThreadId = chunk.threadId
+        }
+        if ('runId' in chunk && typeof chunk.runId === 'string') {
+          lastRunId = chunk.runId
+        }
+        if ('model' in chunk && typeof chunk.model === 'string') {
+          lastModel = chunk.model
+        }
+        yield chunk
+      }
+    },
+  }
+}
+
+/**
+ * Create an XMLHttpRequest-backed newline-delimited JSON stream adapter.
+ */
+export function xhrHttpStream(
+  url: string | (() => string),
+  options: XhrConnectionOptionsResolver = {},
+): ConnectConnectionAdapter {
+  return {
+    async *connect(messages, data, abortSignal, runContext) {
+      const resolvedUrl = typeof url === 'function' ? url() : url
+      const resolvedOptions = await resolveXhrConnectionOptions(options)
+      const signal = abortSignal || resolvedOptions.signal
+      const request = createConfiguredXhrRequest(
+        resolvedUrl,
+        resolvedOptions,
+        messages,
+        data,
+        runContext,
+      )
+      const lines = readXhrLines(request.xhr, signal)
+      if (signal?.aborted) {
+        await lines.next()
+        return
+      }
+      request.xhr.send(request.body)
+
+      for await (const line of lines) {
+        yield JSON.parse(line) as StreamChunk
+      }
+    },
+  }
+}
+
 /**
  * Create a direct stream connection adapter (for server functions or direct streams)
  *

package/src/devtools-noop.ts

@@ -15,7 +15,7 @@ import type {
   VideoDevtoolsBridge,
   VideoDevtoolsBridgeOptions,
 } from './devtools'
-import type { StreamChunk } from '@tanstack/ai'
+import type { StreamChunk } from '@tanstack/ai/client'
 import type {
   ChatClientEventContext,
   ChatClientRunEventContext,

package/src/devtools.ts

@@ -3,9 +3,9 @@ import {
   createAIDevtoolsEventEnvelope,
   emitAIDevtoolsEvent,
 } from '@tanstack/ai-event-client'
-import { convertSchemaToJsonSchema } from '@tanstack/ai'
+import { convertSchemaToJsonSchema } from '@tanstack/ai/client'
 import { DefaultChatClientEventEmitter } from './events'
-import type { AnyClientTool, StreamChunk } from '@tanstack/ai'
+import type { AnyClientTool, StreamChunk } from '@tanstack/ai/client'
 import type { AIDevtoolsEventVisibility } from '@tanstack/ai-event-client'
 import type {
   ChatClientEventContext,