@tanstack/ai-client 0.12.0 → 0.14.0

package/dist/esm/devtools-noop.js

@@ -0,0 +1,135 @@
+import { ChatClientEventEmitter } from "./events.js";
+class NoOpChatClientEventEmitter extends ChatClientEventEmitter {
+  emitEvent() {
+  }
+}
+class NoOpChatDevtoolsBridge {
+  events;
+  constructor(options) {
+    this.events = new NoOpChatClientEventEmitter(options.clientId);
+  }
+  // base bridge surface
+  emitRegistered() {
+  }
+  emitUpdated() {
+  }
+  emitSnapshot() {
+  }
+  emitToolsRegistered() {
+  }
+  emitRunLifecycle(_eventType, _runId, _status, _options) {
+  }
+  deactivate() {
+  }
+  supersede() {
+  }
+  dispose() {
+  }
+  // chat-specific surface
+  setCurrentStreamId(_streamId) {
+  }
+  getCurrentStreamId() {
+    return null;
+  }
+  getLastStreamId() {
+    return null;
+  }
+  resolveStreamId() {
+    return "";
+  }
+  observeChunk(_chunk) {
+  }
+  beginRun(_runId, _threadId) {
+  }
+  getCurrentRunEventContext() {
+    return void 0;
+  }
+  getCurrentOrLastRunEventContext() {
+    return void 0;
+  }
+  findToolCallContext(toolCallId) {
+    return { toolCallId };
+  }
+  async applyFixture(_fixture) {
+  }
+}
+class NoOpGenerationDevtoolsBridge {
+  constructor(_options) {
+  }
+  // base bridge surface
+  emitRegistered() {
+  }
+  emitUpdated() {
+  }
+  emitSnapshot() {
+  }
+  emitToolsRegistered() {
+  }
+  emitRunLifecycle() {
+  }
+  deactivate() {
+  }
+  supersede() {
+  }
+  dispose() {
+  }
+  // generation-specific surface
+  beginRun(_input) {
+    return `noop-run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  }
+  ensureRunStarted(_runId) {
+  }
+  finishRun(_runId, _eventType, _status, _error) {
+  }
+  getActiveRunId() {
+    return null;
+  }
+  resetRuns() {
+  }
+  recordResultChange() {
+  }
+  recordLoadingChange() {
+  }
+  recordErrorChange(_error) {
+  }
+  recordStatusChange() {
+  }
+  recordProgressChange() {
+  }
+  emitState() {
+  }
+}
+class NoOpVideoDevtoolsBridge extends NoOpGenerationDevtoolsBridge {
+  constructor(options) {
+    super(options);
+  }
+  recordJobIdChange() {
+  }
+  recordVideoStatusChange() {
+  }
+}
+const createNoOpChatDevtoolsBridge = (options) => (
+  // eslint-disable-next-line no-restricted-syntax -- see comment above
+  new NoOpChatDevtoolsBridge(options)
+);
+const createNoOpGenerationDevtoolsBridge = (options) => (
+  // eslint-disable-next-line no-restricted-syntax -- see comment above
+  new NoOpGenerationDevtoolsBridge(
+    options
+  )
+);
+const createNoOpVideoDevtoolsBridge = (options) => (
+  // eslint-disable-next-line no-restricted-syntax -- see comment above
+  new NoOpVideoDevtoolsBridge(
+    options
+  )
+);
+export {
+  NoOpChatDevtoolsBridge,
+  NoOpGenerationDevtoolsBridge,
+  NoOpVideoDevtoolsBridge,
+  createNoOpChatDevtoolsBridge,
+  createNoOpGenerationDevtoolsBridge,
+  createNoOpVideoDevtoolsBridge
+};
+//# sourceMappingURL=devtools-noop.js.map

package/dist/esm/devtools-noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-noop.js","sources":["../../src/devtools-noop.ts"],"sourcesContent":["// No-op devtools bridge implementations + factories. The chat / generation /\n// video clients import the real bridge classes as types only and accept a\n// factory in options; when no factory is supplied they fall back to the\n// no-op factories here, which never touch `aiEventClient` or any of the\n// heavy preview/fixture machinery in `./devtools`. This keeps `./devtools`\n// outside the main-entry import graph — consumers opt into functional\n// devtools via `@tanstack/ai-client/devtools` (see `package.json#exports`).\nimport { ChatClientEventEmitter } from './events'\nimport type {\n  AIDevtoolsToolFixture,\n  ChatDevtoolsBridge,\n  ChatDevtoolsBridgeOptions,\n  GenerationDevtoolsBridge,\n  GenerationDevtoolsBridgeOptions,\n  VideoDevtoolsBridge,\n  VideoDevtoolsBridgeOptions,\n} from './devtools'\nimport type { StreamChunk } from '@tanstack/ai/client'\nimport type {\n  ChatClientEventContext,\n  ChatClientRunEventContext,\n} from './events'\n\nexport type ChatDevtoolsBridgeFactory = (\n  options: ChatDevtoolsBridgeOptions,\n) => ChatDevtoolsBridge\n\nexport type GenerationDevtoolsBridgeFactory = <TOutput>(\n  options: GenerationDevtoolsBridgeOptions<TOutput>,\n) => GenerationDevtoolsBridge<TOutput>\n\nexport type VideoDevtoolsBridgeFactory = <TOutput>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) => VideoDevtoolsBridge<TOutput>\n\n// ===========================================================================\n// No-op event emitter — extends the abstract base so it satisfies the type\n// without dragging in any of the event-bus runtime cost.\n// ===========================================================================\n\nclass NoOpChatClientEventEmitter extends ChatClientEventEmitter {\n  protected emitEvent(): void {\n    // intentionally empty\n  }\n}\n\n// ===========================================================================\n// No-op bridges. Methods exist to satisfy the structural shape of the real\n// classes; every emit/record call short-circuits.\n// ===========================================================================\n\nexport class NoOpChatDevtoolsBridge {\n  readonly events: ChatClientEventEmitter\n\n  constructor(options: ChatDevtoolsBridgeOptions) {\n    this.events = new NoOpChatClientEventEmitter(options.clientId)\n  }\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(\n    _eventType: unknown,\n    _runId: string,\n    _status: unknown,\n    _options?: { error?: string },\n  ): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // chat-specific surface\n  setCurrentStreamId(_streamId: string | null): void {}\n  getCurrentStreamId(): string | null {\n    return null\n  }\n  getLastStreamId(): string | null {\n    return null\n  }\n  resolveStreamId(): string {\n    return ''\n  }\n  observeChunk(_chunk: StreamChunk): void {}\n  beginRun(_runId: string, _threadId: string): void {}\n  getCurrentRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  getCurrentOrLastRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  findToolCallContext(toolCallId: string): ChatClientEventContext {\n    return { toolCallId }\n  }\n  async applyFixture(_fixture: AIDevtoolsToolFixture): Promise<void> {\n    // intentionally empty\n  }\n}\n\nexport class NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(_options: GenerationDevtoolsBridgeOptions<TOutput>) {}\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // generation-specific surface\n  beginRun(_input: unknown): string {\n    // Real factories supply a stable id; the no-op still returns a\n    // unique value because the generation client passes this run id to\n    // the adapter's RunAgentInputContext.\n    return `noop-run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n  }\n  ensureRunStarted(_runId: string): void {}\n  finishRun(\n    _runId: string,\n    _eventType: 'run:completed' | 'run:errored' | 'run:cancelled',\n    _status: 'completed' | 'errored' | 'cancelled',\n    _error?: string,\n  ): void {}\n  getActiveRunId(): string | null {\n    return null\n  }\n  resetRuns(): void {}\n  recordResultChange(): void {}\n  recordLoadingChange(): void {}\n  recordErrorChange(_error: Error | undefined): void {}\n  recordStatusChange(): void {}\n  recordProgressChange(): void {}\n  emitState(): void {}\n}\n\nexport class NoOpVideoDevtoolsBridge<\n  TOutput,\n> extends NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(options: VideoDevtoolsBridgeOptions<TOutput>) {\n    super(options)\n  }\n\n  recordJobIdChange(): void {}\n  recordVideoStatusChange(): void {}\n}\n\n// Compile-time parity checks. If a public method is added to the real\n// bridge class without a matching stub on the no-op, the corresponding\n// `Exclude<...>` will resolve to a non-`never` union and the `as never`\n// assignment below will fail to typecheck — surfacing the drift at build\n// time instead of as a runtime TypeError later.\ntype _ChatBridgeMissing = Exclude<\n  keyof ChatDevtoolsBridge,\n  keyof NoOpChatDevtoolsBridge\n>\ntype _GenerationBridgeMissing = Exclude<\n  keyof GenerationDevtoolsBridge<unknown>,\n  keyof NoOpGenerationDevtoolsBridge<unknown>\n>\ntype _VideoBridgeMissing = Exclude<\n  keyof VideoDevtoolsBridge<unknown>,\n  keyof NoOpVideoDevtoolsBridge<unknown>\n>\nconst _chatBridgeParity: _ChatBridgeMissing = undefined as never\nconst _generationBridgeParity: _GenerationBridgeMissing = undefined as never\nconst _videoBridgeParity: _VideoBridgeMissing = undefined as never\nvoid _chatBridgeParity\nvoid _generationBridgeParity\nvoid _videoBridgeParity\n\n// ===========================================================================\n// Factories — these are what the clients call when no real factory was\n// supplied in options.\n// ===========================================================================\n\n// Casts use `unknown` because the no-op classes don't `extend` the real bridge\n// (that would pull the real implementation into the main-entry import graph).\n// Structural parity is enforced by the `_*BridgeMissing` checks above.\n\nexport const createNoOpChatDevtoolsBridge: ChatDevtoolsBridgeFactory = (\n  options,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpChatDevtoolsBridge(options) as unknown as ChatDevtoolsBridge\n\nexport const createNoOpGenerationDevtoolsBridge: GenerationDevtoolsBridgeFactory =\n  <TOutput>(options: GenerationDevtoolsBridgeOptions<TOutput>) =>\n    // eslint-disable-next-line no-restricted-syntax -- see comment above\n    new NoOpGenerationDevtoolsBridge<TOutput>(\n      options,\n    ) as unknown as GenerationDevtoolsBridge<TOutput>\n\nexport const createNoOpVideoDevtoolsBridge: VideoDevtoolsBridgeFactory = <\n  TOutput,\n>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpVideoDevtoolsBridge<TOutput>(\n    options,\n  ) as unknown as VideoDevtoolsBridge<TOutput>\n"],"names":[],"mappings":";AAwCA,MAAM,mCAAmC,uBAAuB;AAAA,EACpD,YAAkB;AAAA,EAE5B;AACF;AAOO,MAAM,uBAAuB;AAAA,EACzB;AAAA,EAET,YAAY,SAAoC;AAC9C,SAAK,SAAS,IAAI,2BAA2B,QAAQ,QAAQ;AAAA,EAC/D;AAAA;AAAA,EAGA,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,iBACE,YACA,QACA,SACA,UACM;AAAA,EAAC;AAAA,EACT,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,mBAAmB,WAAgC;AAAA,EAAC;AAAA,EACpD,qBAAoC;AAClC,WAAO;AAAA,EACT;AAAA,EACA,kBAAiC;AAC/B,WAAO;AAAA,EACT;AAAA,EACA,kBAA0B;AACxB,WAAO;AAAA,EACT;AAAA,EACA,aAAa,QAA2B;AAAA,EAAC;AAAA,EACzC,SAAS,QAAgB,WAAyB;AAAA,EAAC;AAAA,EACnD,4BAAmE;AACjE,WAAO;AAAA,EACT;AAAA,EACA,kCAAyE;AACvE,WAAO;AAAA,EACT;AAAA,EACA,oBAAoB,YAA4C;AAC9D,WAAO,EAAE,WAAA;AAAA,EACX;AAAA,EACA,MAAM,aAAa,UAAgD;AAAA,EAEnE;AACF;AAEO,MAAM,6BAAsC;AAAA,EACjD,YAAY,UAAoD;AAAA,EAAC;AAAA;AAAA,EAGjE,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,mBAAyB;AAAA,EAAC;AAAA,EAC1B,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,SAAS,QAAyB;AAIhC,WAAO,YAAY,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAAA,EACzE;AAAA,EACA,iBAAiB,QAAsB;AAAA,EAAC;AAAA,EACxC,UACE,QACA,YACA,SACA,QACM;AAAA,EAAC;AAAA,EACT,iBAAgC;AAC9B,WAAO;AAAA,EACT;AAAA,EACA,YAAkB;AAAA,EAAC;AAAA,EACnB,qBAA2B;AAAA,EAAC;AAAA,EAC5B,sBAA4B;AAAA,EAAC;AAAA,EAC7B,kBAAkB,QAAiC;AAAA,EAAC;AAAA,EACpD,qBAA2B;AAAA,EAAC;AAAA,EAC5B,uBAA6B;AAAA,EAAC;AAAA,EAC9B,YAAkB;AAAA,EAAC;AACrB;AAEO,MAAM,gCAEH,6BAAsC;AAAA,EAC9C,YAAY,SAA8C;AACxD,UAAM,OAAO;AAAA,EACf;AAAA,EAEA,oBAA0B;AAAA,EAAC;AAAA,EAC3B,0BAAgC;AAAA,EAAC;AACnC;AAmCO,MAAM,+BAA0D,CACrE;AAAA;AAAA,EAGA,IAAI,uBAAuB,OAAO;AAAA;AAE7B,MAAM,qCACX,CAAU;AAAA;AAAA,EAER,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;AAGC,MAAM,gCAA4D,CAGvE;AAAA;AAAA,EAGA,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;"}

package/dist/esm/devtools.d.ts

@@ -0,0 +1,276 @@
+import { AnyClientTool, StreamChunk } from '@tanstack/ai/client';
+import { ChatClientEventContext, ChatClientEventEmitter, ChatClientRunEventContext } from './events.js';
+import { ChatClientState, ConnectionStatus, UIMessage } from './types.js';
+export interface AIDevtoolsDisplayOptions {
+    name?: string;
+}
+export interface AIDevtoolsClientMetadata extends AIDevtoolsDisplayOptions {
+    framework?: string;
+    hookName: string;
+    outputKind?: 'chat' | 'text' | 'structured' | 'image' | 'video' | 'audio';
+}
+export interface AIDevtoolsGenerationProgress {
+    value: number;
+    message?: string;
+}
+export interface AIDevtoolsGenerationMediaItem {
+    src: string;
+    sourceType: 'url' | 'base64';
+    mimeType?: string;
+    format?: string;
+    duration?: number;
+}
+export interface AIDevtoolsGenerationVideoJob {
+    jobId: string;
+    status?: string;
+    progress?: number;
+    error?: string;
+}
+export type AIDevtoolsGenerationPreview = {
+    kind: 'image';
+    items: Array<AIDevtoolsGenerationMediaItem>;
+} | {
+    kind: 'audio';
+    items: Array<AIDevtoolsGenerationMediaItem>;
+} | {
+    kind: 'video';
+    items: Array<AIDevtoolsGenerationMediaItem>;
+    job?: AIDevtoolsGenerationVideoJob;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'structured';
+    value: unknown;
+} | {
+    kind: 'empty';
+};
+export type AIDevtoolsGenerationRunStatus = 'idle' | 'generating' | 'success' | 'error' | 'cancelled';
+export interface AIDevtoolsGenerationRunSnapshot<TOutput = unknown> {
+    id: string;
+    input: unknown;
+    result: TOutput | null;
+    preview: AIDevtoolsGenerationPreview;
+    progress: AIDevtoolsGenerationProgress | null;
+    status: AIDevtoolsGenerationRunStatus;
+    isLoading: boolean;
+    startedAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    error?: string;
+    jobId?: string | null;
+    videoStatus?: unknown;
+}
+export interface AIDevtoolsGenerationPreviewInput {
+    outputKind?: AIDevtoolsClientMetadata['outputKind'];
+    result: unknown;
+    videoStatus?: unknown;
+}
+export interface AIDevtoolsChatSnapshot {
+    [key: string]: unknown;
+    messages: Array<UIMessage>;
+    status: ChatClientState;
+    isLoading: boolean;
+    isSubscribed: boolean;
+    connectionStatus: ConnectionStatus;
+    sessionGenerating: boolean;
+    activeRunIds: Array<string>;
+    error?: string;
+}
+export declare function createAIDevtoolsGenerationPreview(input: AIDevtoolsGenerationPreviewInput): AIDevtoolsGenerationPreview;
+export interface AIDevtoolsToolFixture {
+    fixtureId?: string;
+    hookId?: string;
+    threadId?: string;
+    runId?: string;
+    toolName: string;
+    input: unknown;
+    output: unknown;
+    execute?: boolean;
+    message?: {
+        id: string;
+        role: UIMessage['role'];
+        parts: Array<unknown>;
+        createdAt?: number | string;
+    };
+    toolCallId?: string;
+    messageId?: string;
+    errorText?: string;
+}
+type AIDevtoolsRunEventType = 'run:created' | 'run:started' | 'run:updated' | 'run:completed' | 'run:errored' | 'run:cancelled';
+type AIDevtoolsRunStatus = 'created' | 'started' | 'updated' | 'completed' | 'errored' | 'cancelled';
+export interface AIDevtoolsBridgeOptions<TSnapshot extends object> {
+    hookId: string;
+    threadId?: string;
+    clientId: string;
+    metadata: AIDevtoolsClientMetadata;
+    getSnapshot: () => TSnapshot;
+    getTools?: () => Iterable<AnyClientTool>;
+    applyToolFixture?: (fixture: AIDevtoolsToolFixture) => void | Promise<void>;
+}
+export declare class ClientDevtoolsBridge<TSnapshot extends object> {
+    protected readonly options: AIDevtoolsBridgeOptions<TSnapshot>;
+    private readonly bridgeId;
+    private readonly unsubscribers;
+    private disposed;
+    private superseded;
+    private registered;
+    constructor(options: AIDevtoolsBridgeOptions<TSnapshot>);
+    emitRegistered(): void;
+    emitUpdated(): void;
+    emitSnapshot(): void;
+    emitToolsRegistered(): void;
+    emitRunLifecycle(eventType: AIDevtoolsRunEventType, runId: string, status: AIDevtoolsRunStatus, options?: {
+        error?: string;
+    }): void;
+    deactivate(): void;
+    supersede(): void;
+    dispose(): void;
+    private prepareForEmit;
+    private prepareForMountEmit;
+    private activate;
+    private handleRequestState;
+    private handleToolFixtureApply;
+    private matchesFixtureTarget;
+    private createEnvelope;
+    private createMetadataPayload;
+}
+export interface ChatDevtoolsBridgeOptions extends AIDevtoolsBridgeOptions<AIDevtoolsChatSnapshot> {
+    getMessages: () => Array<UIMessage>;
+    setMessages: (messages: Array<UIMessage>) => void;
+    addToolResult: (toolCallId: string, output: unknown, errorText?: string) => void;
+    generateId: (prefix: string) => string;
+}
+export declare class ChatDevtoolsBridge extends ClientDevtoolsBridge<AIDevtoolsChatSnapshot> {
+    readonly events: ChatClientEventEmitter;
+    private readonly chatOptions;
+    private currentRunId;
+    private currentRunThreadId;
+    private currentStreamId;
+    private lastStreamId;
+    private lastRunEventContext;
+    constructor(options: ChatDevtoolsBridgeOptions);
+    setCurrentStreamId(streamId: string | null): void;
+    /**
+     * Called by the auto-attaching emitter every time it sees a non-empty
+     * streamId pass through. Lets devtools track the latest stream id
+     * without the chat client wiring it up explicitly.
+     */
+    recordStreamId(streamId: string): void;
+    mountWithTools(initialMessageCount: number): void;
+    notifyToolsChanged(): void;
+    getCurrentStreamId(): string | null;
+    getLastStreamId(): string | null;
+    resolveStreamId(): string;
+    beginRun(runId: string, threadId: string): void;
+    observeChunk(chunk: StreamChunk): void;
+    getCurrentRunEventContext(): ChatClientRunEventContext | undefined;
+    getCurrentOrLastRunEventContext(): ChatClientRunEventContext | undefined;
+    findToolCallContext(toolCallId: string): ChatClientEventContext;
+    /**
+     * Entry point invoked when the devtools panel emits
+     * `devtools:tool-fixture:apply`. The chat client never calls this
+     * directly; it is wired through the base bridge's fixture subscription.
+     */
+    applyFixture(fixture: AIDevtoolsToolFixture): Promise<void>;
+    private executeFixture;
+    private addToolResultForFixture;
+    private createReplayMessageFromFixture;
+    private cloneFixtureSourceMessage;
+    private createFixtureToolCallIdMap;
+    private resolveFixtureMessageId;
+    private resolveFixtureToolCallId;
+    private findClientTool;
+}
+export interface AIDevtoolsGenerationSnapshotBase<TOutput> {
+    input: unknown;
+    result: TOutput | null;
+    preview: AIDevtoolsGenerationPreview;
+    progress: AIDevtoolsGenerationProgress | null;
+    status: AIDevtoolsGenerationRunStatus;
+    isLoading: boolean;
+    activeRunId: string | null;
+    runs: Array<AIDevtoolsGenerationRunSnapshot<TOutput>>;
+    error?: string;
+}
+export interface GenerationDevtoolsBridgeOptions<TOutput> extends Omit<AIDevtoolsBridgeOptions<AIDevtoolsGenerationSnapshotBase<TOutput>>, 'getSnapshot'> {
+    getCoreState: () => GenerationDevtoolsCoreState<TOutput>;
+    maxRuns?: number;
+}
+export interface GenerationDevtoolsCoreState<TOutput> {
+    input: unknown;
+    result: TOutput | null;
+    progress: AIDevtoolsGenerationProgress | null;
+    status: AIDevtoolsGenerationRunStatus;
+    isLoading: boolean;
+    error?: string;
+}
+export interface GenerationRunPatch<TOutput> {
+    input?: unknown;
+    result?: TOutput | null;
+    preview?: AIDevtoolsGenerationPreview;
+    progress?: AIDevtoolsGenerationProgress | null;
+    status?: AIDevtoolsGenerationRunStatus;
+    isLoading?: boolean;
+    completedAt?: number;
+    error?: string;
+    clearError?: boolean;
+}
+export declare class GenerationDevtoolsBridge<TOutput> extends ClientDevtoolsBridge<AIDevtoolsGenerationSnapshotBase<TOutput>> {
+    protected activeRunId: string | null;
+    protected activeRunStarted: boolean;
+    protected devtoolsRuns: Array<AIDevtoolsGenerationRunSnapshot<TOutput>>;
+    protected readonly maxRuns: number;
+    protected readonly getCoreState: () => GenerationDevtoolsCoreState<TOutput>;
+    constructor(options: GenerationDevtoolsBridgeOptions<TOutput>);
+    beginRun(input: unknown): string;
+    ensureRunStarted(runId: string): void;
+    finishRun(runId: string, eventType: 'run:completed' | 'run:errored' | 'run:cancelled', status: 'completed' | 'errored' | 'cancelled', error?: string): void;
+    getActiveRunId(): string | null;
+    /** Clear all per-run history. Called when the client `reset()`s. */
+    resetRuns(): void;
+    /** Record state changes from the client and emit the matching snapshot. */
+    recordResultChange(): void;
+    recordLoadingChange(): void;
+    recordErrorChange(error: Error | undefined): void;
+    recordStatusChange(status: AIDevtoolsGenerationRunStatus): void;
+    recordProgressChange(): void;
+    /** Emit the latest snapshot without touching run state. */
+    emitState(): void;
+    protected buildSnapshot(): AIDevtoolsGenerationSnapshotBase<TOutput>;
+    protected updateActiveRun(patch: GenerationRunPatch<TOutput>): void;
+    protected upsertRun(runId: string, patch: GenerationRunPatch<TOutput>): void;
+    protected renameRun(previousRunId: string, nextRunId: string): void;
+    protected getProgress(): AIDevtoolsGenerationProgress | null;
+    protected completeProgress(): AIDevtoolsGenerationProgress | null;
+    protected createPreview(result: TOutput | null): AIDevtoolsGenerationPreview;
+    protected generateRunId(): string;
+}
+export interface AIDevtoolsVideoSnapshotBase<TOutput> extends AIDevtoolsGenerationSnapshotBase<TOutput> {
+    jobId: string | null;
+    videoStatus: unknown;
+}
+export interface VideoDevtoolsCoreState<TOutput> extends GenerationDevtoolsCoreState<TOutput> {
+    jobId: string | null;
+    videoStatus: unknown;
+}
+export interface VideoDevtoolsBridgeOptions<TOutput> extends Omit<GenerationDevtoolsBridgeOptions<TOutput>, 'getCoreState'> {
+    getCoreState: () => VideoDevtoolsCoreState<TOutput>;
+}
+export interface VideoRunPatch<TOutput> extends GenerationRunPatch<TOutput> {
+    jobId?: string | null;
+    videoStatus?: unknown;
+}
+export declare class VideoDevtoolsBridge<TOutput> extends GenerationDevtoolsBridge<TOutput> {
+    constructor(options: VideoDevtoolsBridgeOptions<TOutput>);
+    recordJobIdChange(): void;
+    recordVideoStatusChange(): void;
+    protected buildSnapshot(): AIDevtoolsVideoSnapshotBase<TOutput>;
+    protected upsertRun(runId: string, patch: VideoRunPatch<TOutput>): void;
+    protected createPreview(result: TOutput | null): AIDevtoolsGenerationPreview;
+    private createVideoPreview;
+}
+export declare function createChatDevtoolsBridge(options: ChatDevtoolsBridgeOptions): ChatDevtoolsBridge;
+export declare function createGenerationDevtoolsBridge<TOutput>(options: GenerationDevtoolsBridgeOptions<TOutput>): GenerationDevtoolsBridge<TOutput>;
+export declare function createVideoDevtoolsBridge<TOutput>(options: VideoDevtoolsBridgeOptions<TOutput>): VideoDevtoolsBridge<TOutput>;
+export {};