@tanstack/ai-client 0.18.4 → 0.18.5

package/dist/esm/generation-client.d.ts

@@ -1,99 +0,0 @@
-import { ConnectConnectionAdapter } from './connection-adapters.js';
-import { GenerationClientOptions, GenerationClientState, GenerationFetcher } from './generation-types.js';
-/**
- * A lightweight, generic client for one-shot generation tasks
- * (image, speech, transcription, summarize).
- *
- * Supports two transport modes:
- * - **ConnectConnectionAdapter** — Streaming transport (SSE, HTTP stream, custom).
- *   Server wraps results in StreamChunk events with CUSTOM event names.
- * - **Fetcher** — Direct async function call. No streaming protocol needed.
- *
- * @template TInput - The input type for the generation request
- * @template TResult - The result type returned by the generation
- *
- * @example
- * ```typescript
- * // With streaming connection adapter
- * const client = new GenerationClient<ImageGenerateInput, ImageGenerationResult>({
- *   connection: fetchServerSentEvents('/api/generate/image'),
- *   onResultChange: setResult,
- *   onLoadingChange: setIsLoading,
- * })
- *
- * // With fetcher (direct)
- * const client = new GenerationClient<ImageGenerateInput, ImageGenerationResult>({
- *   fetcher: async (input) => {
- *     const res = await fetch('/api/generate/image', {
- *       method: 'POST',
- *       body: JSON.stringify(input),
- *     })
- *     return res.json()
- *   },
- * })
- *
- * await client.generate({ prompt: 'A sunset over mountains' })
- * ```
- */
-export declare class GenerationClient<TInput extends Record<string, any>, TResult, TOutput = TResult> {
-    private readonly connection;
-    private readonly fetcher;
-    private readonly uniqueId;
-    private readonly devtoolsMetadata;
-    private readonly devtoolsBridge;
-    private readonly threadId;
-    private body;
-    private result;
-    private input;
-    private progress;
-    private isLoading;
-    private error;
-    private status;
-    private abortController;
-    private readonly callbacksRef;
-    private devtoolsMounted;
-    constructor(options: GenerationClientOptions<TInput, TResult, TOutput> & ({
-        connection: ConnectConnectionAdapter;
-        fetcher?: never;
-    } | {
-        fetcher: GenerationFetcher<TInput, TResult>;
-        connection?: never;
-    }));
-    private buildDevtoolsBridgeOptions;
-    mountDevtools(): void;
-    /**
-     * Trigger a generation request.
-     * Only one generation can be in-flight at a time; calling generate()
-     * while already generating will be a no-op.
-     */
-    generate(input: TInput): Promise<void>;
-    /**
-     * Process a stream of AG-UI events from the streaming connection adapter.
-     */
-    private processStream;
-    /**
-     * Abort any in-flight generation request.
-     */
-    stop(): void;
-    /**
-     * Clear the result, error, and return to idle state.
-     */
-    reset(): void;
-    /**
-     * Update options without recreating the client.
-     */
-    updateOptions(options: Partial<Pick<GenerationClientOptions<TInput, TResult, TOutput>, 'body' | 'onResult' | 'onError' | 'onProgress' | 'onChunk'>>): void;
-    dispose(): void;
-    getResult(): TOutput | null;
-    getIsLoading(): boolean;
-    getError(): Error | undefined;
-    getStatus(): GenerationClientState;
-    private setResult;
-    private setIsLoading;
-    private setError;
-    private setStatus;
-    private setProgress;
-    private createDevtoolsMetadata;
-    private generateUniqueId;
-    private createRunContext;
-}

package/dist/esm/generation-client.js

@@ -1,325 +0,0 @@
-import { GENERATION_EVENTS } from "./generation-types.js";
-import { createNoOpGenerationDevtoolsBridge } from "./devtools-noop.js";
-import { parseSSEResponse } from "./sse-parser.js";
-class GenerationClient {
-  connection;
-  fetcher;
-  uniqueId;
-  devtoolsMetadata;
-  devtoolsBridge;
-  threadId;
-  body;
-  result = null;
-  input = null;
-  progress = null;
-  isLoading = false;
-  error = void 0;
-  status = "idle";
-  abortController = null;
-  callbacksRef;
-  devtoolsMounted = false;
-  constructor(options) {
-    this.uniqueId = options.id ?? this.generateUniqueId("generation");
-    this.threadId = this.uniqueId;
-    this.connection = options.connection;
-    this.fetcher = options.fetcher;
-    this.body = options.body ?? {};
-    this.callbacksRef = {
-      onResult: options.onResult,
-      onError: options.onError,
-      onProgress: options.onProgress,
-      onChunk: options.onChunk,
-      onResultChange: options.onResultChange,
-      onLoadingChange: options.onLoadingChange,
-      onErrorChange: options.onErrorChange,
-      onStatusChange: options.onStatusChange
-    };
-    this.devtoolsMetadata = this.createDevtoolsMetadata(options.devtools);
-    this.devtoolsBridge = (options.devtoolsBridgeFactory ?? createNoOpGenerationDevtoolsBridge)(this.buildDevtoolsBridgeOptions());
-  }
-  buildDevtoolsBridgeOptions() {
-    return {
-      hookId: this.uniqueId,
-      clientId: this.uniqueId,
-      threadId: this.threadId,
-      metadata: this.devtoolsMetadata,
-      getCoreState: () => ({
-        input: this.input,
-        result: this.result,
-        progress: this.progress,
-        status: this.status,
-        isLoading: this.isLoading,
-        ...this.error ? { error: this.error.message } : {}
-      })
-    };
-  }
-  mountDevtools() {
-    if (this.devtoolsMounted) {
-      return;
-    }
-    this.devtoolsMounted = true;
-    this.devtoolsBridge.emitRegistered();
-    this.devtoolsBridge.emitSnapshot();
-  }
-  /**
-   * Trigger a generation request.
-   * Only one generation can be in-flight at a time; calling generate()
-   * while already generating will be a no-op.
-   */
-  async generate(input) {
-    this.mountDevtools();
-    if (this.isLoading) return;
-    this.input = input;
-    this.progress = null;
-    const runId = this.devtoolsBridge.beginRun(input);
-    this.setIsLoading(true);
-    this.setStatus("generating");
-    this.setError(void 0);
-    const abortController = new AbortController();
-    this.abortController = abortController;
-    const { signal } = abortController;
-    try {
-      if (this.fetcher) {
-        const result = await this.fetcher(input, { signal });
-        if (signal.aborted) return;
-        if (result instanceof Response) {
-          await this.processStream(parseSSEResponse(result, signal), runId);
-        } else {
-          this.devtoolsBridge.ensureRunStarted(runId);
-          this.setResult(result);
-          this.setStatus("success");
-        }
-      } else if (this.connection) {
-        const mergedData = { ...this.body, ...input };
-        const stream = this.connection.connect(
-          [],
-          mergedData,
-          signal,
-          this.createRunContext(runId)
-        );
-        await this.processStream(stream, runId);
-      } else {
-        throw new Error(
-          "GenerationClient requires either a connection or fetcher option"
-        );
-      }
-      if (!signal.aborted && this.status === "success") {
-        this.progress = completeProgressValue(this.progress);
-        this.devtoolsBridge.finishRun(
-          this.devtoolsBridge.getActiveRunId() ?? runId,
-          "run:completed",
-          "completed"
-        );
-      }
-    } catch (err) {
-      if (signal.aborted) return;
-      const error = err instanceof Error ? err : new Error(String(err));
-      this.setError(error);
-      this.setStatus("error");
-      this.devtoolsBridge.finishRun(
-        this.devtoolsBridge.getActiveRunId() ?? runId,
-        "run:errored",
-        "errored",
-        error.message
-      );
-      this.callbacksRef.onError?.(error);
-    } finally {
-      this.abortController = null;
-      this.setIsLoading(false);
-    }
-  }
-  /**
-   * Process a stream of AG-UI events from the streaming connection adapter.
-   */
-  async processStream(source, fallbackRunId) {
-    let streamRunId;
-    for await (const chunk of source) {
-      if (this.abortController?.signal.aborted) break;
-      this.callbacksRef.onChunk?.(chunk);
-      const chunkRunId = "runId" in chunk && typeof chunk.runId === "string" ? chunk.runId : void 0;
-      switch (chunk.type) {
-        case "RUN_STARTED": {
-          streamRunId = chunk.runId;
-          this.devtoolsBridge.ensureRunStarted(chunk.runId);
-          break;
-        }
-        case "CUSTOM": {
-          this.devtoolsBridge.ensureRunStarted(streamRunId ?? fallbackRunId);
-          if (chunk.name === GENERATION_EVENTS.RESULT) {
-            this.setResult(chunk.value);
-          } else if (chunk.name === GENERATION_EVENTS.PROGRESS) {
-            const { progress, message } = chunk.value;
-            this.setProgress(progress, message);
-          }
-          break;
-        }
-        case "RUN_FINISHED": {
-          streamRunId = chunk.runId;
-          this.devtoolsBridge.ensureRunStarted(chunk.runId);
-          this.setStatus("success");
-          break;
-        }
-        case "RUN_ERROR": {
-          this.devtoolsBridge.ensureRunStarted(
-            chunkRunId ?? streamRunId ?? fallbackRunId
-          );
-          const msg = chunk.message || chunk.error?.message || "An error occurred";
-          throw new Error(msg);
-        }
-      }
-    }
-  }
-  /**
-   * Abort any in-flight generation request.
-   */
-  stop() {
-    const runId = this.devtoolsBridge.getActiveRunId();
-    if (this.abortController) {
-      this.abortController.abort();
-      this.abortController = null;
-    }
-    this.setIsLoading(false);
-    if (this.status === "generating") {
-      this.setStatus("idle");
-      if (runId) {
-        this.devtoolsBridge.finishRun(runId, "run:cancelled", "cancelled");
-      }
-    }
-  }
-  /**
-   * Clear the result, error, and return to idle state.
-   */
-  reset() {
-    this.stop();
-    this.setResult(null);
-    this.input = null;
-    this.progress = null;
-    this.devtoolsBridge.resetRuns();
-    this.setError(void 0);
-    this.setStatus("idle");
-    this.devtoolsBridge.emitState();
-  }
-  /**
-   * Update options without recreating the client.
-   */
-  updateOptions(options) {
-    if (options.body !== void 0) {
-      this.body = options.body ?? {};
-    }
-    if (options.onResult !== void 0) {
-      this.callbacksRef.onResult = options.onResult;
-    }
-    if (options.onError !== void 0) {
-      this.callbacksRef.onError = options.onError;
-    }
-    if (options.onProgress !== void 0) {
-      this.callbacksRef.onProgress = options.onProgress;
-    }
-    if (options.onChunk !== void 0) {
-      this.callbacksRef.onChunk = options.onChunk;
-    }
-  }
-  dispose() {
-    this.stop();
-    this.devtoolsBridge.dispose();
-    this.devtoolsMounted = false;
-  }
-  // ===========================
-  // Getters
-  // ===========================
-  getResult() {
-    return this.result;
-  }
-  getIsLoading() {
-    return this.isLoading;
-  }
-  getError() {
-    return this.error;
-  }
-  getStatus() {
-    return this.status;
-  }
-  // ===========================
-  // Private state setters
-  // ===========================
-  setResult(rawResult) {
-    if (rawResult === null) {
-      this.result = null;
-      this.callbacksRef.onResultChange?.(null);
-      this.devtoolsBridge.recordResultChange();
-      return;
-    }
-    if (this.callbacksRef.onResult) {
-      const transformed = this.callbacksRef.onResult(rawResult);
-      if (transformed === null) {
-        this.devtoolsBridge.emitState();
-        return;
-      }
-      if (transformed !== void 0) {
-        this.result = transformed;
-        this.callbacksRef.onResultChange?.(this.result);
-        this.devtoolsBridge.recordResultChange();
-        return;
-      }
-    }
-    this.result = rawResult;
-    this.callbacksRef.onResultChange?.(this.result);
-    this.devtoolsBridge.recordResultChange();
-  }
-  setIsLoading(isLoading) {
-    this.isLoading = isLoading;
-    this.callbacksRef.onLoadingChange?.(isLoading);
-    this.devtoolsBridge.recordLoadingChange();
-  }
-  setError(error) {
-    this.error = error;
-    this.callbacksRef.onErrorChange?.(error);
-    this.devtoolsBridge.recordErrorChange(error);
-  }
-  setStatus(status) {
-    this.status = status;
-    this.callbacksRef.onStatusChange?.(status);
-    this.devtoolsBridge.recordStatusChange(status);
-  }
-  setProgress(value, message) {
-    this.progress = {
-      value,
-      ...message ? { message } : {}
-    };
-    if (message === void 0) {
-      this.callbacksRef.onProgress?.(value);
-    } else {
-      this.callbacksRef.onProgress?.(value, message);
-    }
-    this.devtoolsBridge.recordProgressChange();
-  }
-  createDevtoolsMetadata(metadata) {
-    return {
-      hookName: metadata?.hookName ?? "useGeneration",
-      ...metadata?.framework ? { framework: metadata.framework } : {},
-      ...metadata?.outputKind ? { outputKind: metadata.outputKind } : {},
-      ...metadata?.name ? { name: metadata.name } : {}
-    };
-  }
-  generateUniqueId(prefix) {
-    return `${prefix}-${Date.now()}-${Math.random().toString(36).substring(7)}`;
-  }
-  createRunContext(runId) {
-    return {
-      threadId: this.threadId,
-      runId
-    };
-  }
-}
-function completeProgressValue(progress) {
-  if (!progress) return null;
-  const message = progress.message;
-  return {
-    value: 100,
-    ...message ? { message } : {}
-  };
-}
-export {
-  GenerationClient
-};
-//# sourceMappingURL=generation-client.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"generation-client.js","sources":["../../src/generation-client.ts"],"sourcesContent":["import { GENERATION_EVENTS } from './generation-types'\nimport { createNoOpGenerationDevtoolsBridge } 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  GenerationDevtoolsBridge,\n  GenerationDevtoolsBridgeOptions,\n} from './devtools'\nimport type {\n  GenerationClientOptions,\n  GenerationClientState,\n  GenerationFetcher,\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 GenerationCallbacks<TResult, TOutput> {\n  onResult?: ((result: TResult) => TOutput | null | void) | undefined\n  onError?: ((error: Error) => void) | undefined\n  onProgress?: ((progress: number, message?: string) => void) | undefined\n  onChunk?: ((chunk: StreamChunk) => 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}\n\n/**\n * A lightweight, generic client for one-shot generation tasks\n * (image, speech, transcription, summarize).\n *\n * Supports two transport modes:\n * - **ConnectConnectionAdapter** — Streaming transport (SSE, HTTP stream, custom).\n *   Server wraps results in StreamChunk events with CUSTOM event names.\n * - **Fetcher** — Direct async function call. No streaming protocol needed.\n *\n * @template TInput - The input type for the generation request\n * @template TResult - The result type returned by the generation\n *\n * @example\n * ```typescript\n * // With streaming connection adapter\n * const client = new GenerationClient<ImageGenerateInput, ImageGenerationResult>({\n *   connection: fetchServerSentEvents('/api/generate/image'),\n *   onResultChange: setResult,\n *   onLoadingChange: setIsLoading,\n * })\n *\n * // With fetcher (direct)\n * const client = new GenerationClient<ImageGenerateInput, ImageGenerationResult>({\n *   fetcher: async (input) => {\n *     const res = await fetch('/api/generate/image', {\n *       method: 'POST',\n *       body: JSON.stringify(input),\n *     })\n *     return res.json()\n *   },\n * })\n *\n * await client.generate({ prompt: 'A sunset over mountains' })\n * ```\n */\nexport class GenerationClient<\n  TInput extends Record<string, any>,\n  TResult,\n  TOutput = TResult,\n> {\n  private readonly connection: ConnectConnectionAdapter | undefined\n  private readonly fetcher: GenerationFetcher<TInput, TResult> | undefined\n  private readonly uniqueId: string\n  private readonly devtoolsMetadata: AIDevtoolsClientMetadata\n  private readonly devtoolsBridge: GenerationDevtoolsBridge<TOutput>\n  private readonly threadId: string\n  private body: Record<string, any>\n  private result: TOutput | null = null\n  private input: TInput | null = null\n  private progress: AIDevtoolsGenerationProgress | 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: GenerationCallbacks<TResult, TOutput>\n  private devtoolsMounted = false\n\n  constructor(\n    options: GenerationClientOptions<TInput, TResult, TOutput> &\n      (\n        | { connection: ConnectConnectionAdapter; fetcher?: never }\n        | {\n            fetcher: GenerationFetcher<TInput, TResult>\n            connection?: never\n          }\n      ),\n  ) {\n    this.uniqueId = options.id ?? this.generateUniqueId('generation')\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      onResultChange: options.onResultChange,\n      onLoadingChange: options.onLoadingChange,\n      onErrorChange: options.onErrorChange,\n      onStatusChange: options.onStatusChange,\n    }\n\n    this.devtoolsMetadata = this.createDevtoolsMetadata(options.devtools)\n    this.devtoolsBridge = (\n      options.devtoolsBridgeFactory ?? createNoOpGenerationDevtoolsBridge\n    )<TOutput>(this.buildDevtoolsBridgeOptions())\n  }\n\n  private buildDevtoolsBridgeOptions(): GenerationDevtoolsBridgeOptions<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        ...(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 a generation request.\n   * Only one generation can be in-flight at a time; calling generate()\n   * while already generating will be a no-op.\n   */\n  async generate(input: TInput): 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\n    const abortController = new AbortController()\n    this.abortController = abortController\n    const { signal } = abortController\n\n    try {\n      if (this.fetcher) {\n        // Direct fetch path\n        const result = await this.fetcher(input, { signal })\n        if (signal.aborted) return\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      } else if (this.connection) {\n        // Streaming adapter path\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          'GenerationClient requires either a connection or fetcher option',\n        )\n      }\n      if (!signal.aborted && this.status === 'success') {\n        // Bump progress to 100 on successful completion so devtools\n        // snapshots reflect the final state. The bridge mirrors this in\n        // the run's recorded progress, but the snapshot reads `progress`\n        // from the client's core state.\n        this.progress = completeProgressValue(this.progress)\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   * Process a stream of AG-UI events from the streaming connection adapter.\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 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.RESULT) {\n            this.setResult(chunk.value as TResult)\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 request.\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 the result, error, and return to idle state.\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.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        GenerationClientOptions<TInput, TResult, TOutput>,\n        'body' | 'onResult' | 'onError' | 'onProgress' | 'onChunk'\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  }\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  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: TResult | null): void {\n    if (rawResult === null) {\n      this.result = null\n      this.callbacksRef.onResultChange?.(null)\n      this.devtoolsBridge.recordResultChange()\n      return\n    }\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 `TResult`, so the runtime cast is sound.\n    // eslint-disable-next-line no-restricted-syntax -- TOutput defaults to TResult 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 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 createDevtoolsMetadata(\n    metadata?: Partial<AIDevtoolsClientMetadata>,\n  ): AIDevtoolsClientMetadata {\n    return {\n      hookName: metadata?.hookName ?? 'useGeneration',\n      ...(metadata?.framework ? { framework: metadata.framework } : {}),\n      ...(metadata?.outputKind ? { outputKind: metadata.outputKind } : {}),\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\nfunction completeProgressValue(\n  progress: AIDevtoolsGenerationProgress | null,\n): AIDevtoolsGenerationProgress | null {\n  if (!progress) return null\n  const message = progress.message\n  return {\n    value: 100,\n    ...(message ? { message } : {}),\n  }\n}\n"],"names":[],"mappings":"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"}