@tanstack/ai-client 0.22.0 → 0.23.0

package/dist/esm/devtools.d.ts

@@ -1,4 +1,5 @@
 import { AnyClientTool, StreamChunk } from '@tanstack/ai/client';
+import { AIDevtoolsEventVisibility } from '@tanstack/ai-event-client';
 import { ChatClientEventContext, ChatClientEventEmitter, ChatClientRunEventContext } from './events.js';
 import { ChatClientState, ConnectionStatus, QueuedMessage, UIMessage } from './types.js';
 export interface AIDevtoolsDisplayOptions {
@@ -131,9 +132,17 @@ export declare class ClientDevtoolsBridge<TSnapshot extends object> {
     private prepareForMountEmit;
     private activate;
     private handleRequestState;
+    /**
+     * Extension hook for subclasses to replay any additional cached state on a
+     * `devtools:request-state` (i.e. when a panel opens). Called only after the
+     * base guards (disposed/superseded/targetHookId) pass. No-op by default.
+     */
+    protected onReplayState(): void;
     private handleToolFixtureApply;
     private matchesFixtureTarget;
-    private createEnvelope;
+    protected createEnvelope(eventType: 'hook:registered' | 'hook:updated' | 'hook:unregistered' | 'hook:state-snapshot' | 'tools:registered' | 'memory:retrieve:started' | 'memory:retrieve:completed' | 'memory:snapshot' | AIDevtoolsRunEventType, visibility?: AIDevtoolsEventVisibility, context?: {
+        runId?: string;
+    }): import('@tanstack/ai-event-client').AIDevtoolsEventEnvelope;
     private createMetadataPayload;
 }
 export interface ChatDevtoolsBridgeOptions extends AIDevtoolsBridgeOptions<AIDevtoolsChatSnapshot> {
@@ -150,6 +159,8 @@ export declare class ChatDevtoolsBridge extends ClientDevtoolsBridge<AIDevtoolsC
     private currentStreamId;
     private lastStreamId;
     private lastRunEventContext;
+    /** Last transported `memory:state` value, replayed when a panel opens. */
+    private lastMemoryStateValue;
     constructor(options: ChatDevtoolsBridgeOptions);
     setCurrentStreamId(streamId: string | null): void;
     /**
@@ -165,6 +176,25 @@ export declare class ChatDevtoolsBridge extends ClientDevtoolsBridge<AIDevtoolsC
     resolveStreamId(): string;
     beginRun(runId: string, threadId: string): void;
     observeChunk(chunk: StreamChunk): void;
+    /**
+     * Record a transported `memory:state` value (the server memory middleware's
+     * per-turn recall metrics + store snapshot). Called from the chat client's
+     * `onCustomEvent` handler — the designated path for CUSTOM stream events —
+     * NOT from `observeChunk`. Re-emits the browser `memory:*` events the devtools
+     * store consumes, and caches the value so a panel opened later can replay it
+     * (see {@link onReplayState}). Symmetric with the generation bridge's
+     * `recordResultChange` / `recordProgressChange`.
+     */
+    recordMemoryState(rawValue: unknown): void;
+    /**
+     * Re-emit the browser-side `memory:*` events from a transported
+     * `memory:state` value. The devtools store consumes these to render the
+     * Memory tab (operations timeline + live contents). The recall pair mirrors
+     * the server middleware's own emits; the snapshot is included only when the
+     * adapter supports introspection.
+     */
+    private emitMemoryState;
+    protected onReplayState(): void;
     getCurrentRunEventContext(): ChatClientRunEventContext | undefined;
     getCurrentOrLastRunEventContext(): ChatClientRunEventContext | undefined;
     findToolCallContext(toolCallId: string): ChatClientEventContext;