blink 0.1.91 → 0.1.93

package/dist/node/react/index.node.d.cts

@@ -1,5 +1,5 @@
 import { Context, UIOptions, UIOptionsSchema } from "../index.browser-CS2PXHA_.cjs";
-import "../index.node-CFD7trD8.cjs";
+import "../index.node-ztcay7c1.cjs";
 import { BuildLog, BuildResult } from "../index-DZ_cKJPr.cjs";
 import { CapabilitiesResponse, Client } from "../index-BDhvk5TM.cjs";
 import { UIMessage } from "ai";
@@ -82,13 +82,35 @@ interface Store<T extends object> {
  * createFileStore creates a simple file-based store with atomic read/write.
  * All operations are protected by filesystem locks for multi-process safety.
  */
+
+interface DiskStoreWatcher<T = any> {
+  onChange: (callback: (event: {
+    key: string;
+    value: T | undefined;
+    locked: boolean;
+    pid?: number;
+  }) => void) => () => void;
+  dispose: () => void;
+}
+/**
+ * createDiskStoreWatcher creates a watcher for the disk store.
+ * It watches the disk store for changes and emits events when the
+ * store changes.
+ *
+ * It also polls the store for changes in case the watcher misses
+ * any changes.
+ *
+ * It also debounces the changes to prevent too many events from
+ * being emitted.
+ */
 //#endregion
 //#region src/local/types.d.ts
 interface StoredChat {
-  readonly id: string;
-  readonly created_at: string;
-  readonly updated_at: string;
-  readonly messages: StoredMessage[];
+  id: string;
+  created_at: string;
+  updated_at: string;
+  messages: StoredMessage[];
+  error?: string;
 }
 type StoredMessageMetadata = {
   __blink_internal: true;
@@ -107,23 +129,111 @@ interface StoredMessage<T extends UIMessage = UIMessage<StoredMessageMetadata>>
  * Helper to convert UIMessage to StoredMessage
  */
 //#endregion
-//#region src/react/use-chat.d.ts
+//#region src/local/chat-manager.d.ts
 type ChatStatus = "idle" | "streaming" | "error";
-interface Chat {
+interface ChatState {
   readonly id: string;
   readonly created_at?: string;
   readonly updated_at?: string;
   readonly messages: StoredMessage[];
   readonly status: ChatStatus;
   readonly streamingMessage?: UIMessage;
-  readonly error?: Error;
+  readonly error?: string;
+  readonly loading: boolean;
   readonly queuedMessages: StoredMessage[];
 }
+interface ChatManagerOptions {
+  readonly chatId: string;
+  readonly store: Store<StoredChat>;
+  readonly watcher: DiskStoreWatcher<StoredChat>;
+  /**
+   * Optional function to filter messages before persisting them.
+   * Return undefined to skip persisting the message.
+   */
+  readonly serializeMessage?: (message: UIMessage) => StoredMessage | undefined;
+  /**
+   * Optional function to filter messages before sending to the agent.
+   * Return true to include the message, false to exclude it.
+   */
+  readonly filterMessages?: (message: UIMessage) => boolean;
+}
+type StateListener = (state: ChatState) => void;
+/**
+ * ChatManager handles all chat state and operations outside of React.
+ * This makes it easier to test and reason about race conditions.
+ */
+declare class ChatManager {
+  private chatId;
+  private agent;
+  private chatStore;
+  private serializeMessage?;
+  private filterMessages?;
+  private chat;
+  private loading;
+  private streamingMessage;
+  private status;
+  private queue;
+  private abortController;
+  private isProcessingQueue;
+  private listeners;
+  private unwatchStore;
+  private disposed;
+  constructor(options: ChatManagerOptions);
+  /**
+   * Update the agent instance to be used for chats
+   */
+  setAgent(agent: Client | undefined): void;
+  /**
+   * Get the current state
+   */
+  getState(): ChatState;
+  /**
+   * Subscribe to state changes
+   */
+  subscribe(listener: StateListener): () => void;
+  /**
+   * Upsert a message to the chat
+   */
+  upsertMessage(message: UIMessage, lock?: LockedStoreEntry<StoredChat>): Promise<void>;
+  deleteMessage(id: string): Promise<void>;
+  /**
+   * Send a message to the agent
+   */
+  sendMessage(message: StoredMessage): Promise<void>;
+  private processQueue;
+  /**
+   * Stop the current streaming operation
+   */
+  stopStreaming(): void;
+  /**
+   * Clear all queued messages
+   */
+  clearQueue(): void;
+  /**
+   * Reset the chat (delete from disk)
+   */
+  resetChat(): Promise<void>;
+  /**
+   * Dispose of the manager (cleanup)
+   */
+  dispose(): void;
+  private resetChatState;
+  private notifyListeners;
+}
+//#endregion
+//#region src/react/use-chat.d.ts
 interface UseChatOptions {
   readonly chatId: string;
   readonly agent: Client | undefined;
-  readonly chatStore: Store<StoredChat>;
   readonly chatsDirectory: string;
+  /**
+   * Optional shared store to use. If not provided, a new one will be created.
+   */
+  readonly store?: Store<StoredChat>;
+  /**
+   * Optional shared watcher to use. If not provided, a new one will be created.
+   */
+  readonly watcher?: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -135,9 +245,10 @@ interface UseChatOptions {
    */
   readonly filterMessages?: (message: UIMessage) => boolean;
 }
-interface UseChat extends Chat {
+interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
   readonly clearQueue: () => void;
@@ -163,8 +274,12 @@ type LocalServer = ReturnType<typeof createLocalServer>;
 declare function createLocalServer(options: CreateLocalServerOptions): {
   url: string;
   runtime: Context;
-  chatStore: Store<StoredChat>;
   chatsDirectory: string;
+  chatStore: Store<StoredChat>;
+  chatWatcher: DiskStoreWatcher<StoredChat>;
+  getChatManager: (chatId: string) => ChatManager;
+  listChats: () => Promise<StoreEntry[]>;
+  lockChat: (chatId: string) => Promise<LockedStoreEntry<StoredChat>>;
   startChat: (chatId: string) => void;
   stopChat: (chatId: string) => void;
   dispose: () => void;
@@ -226,6 +341,7 @@ interface UseDevMode {
   readonly approval: ApprovalRequest | undefined;
   readonly tokenUsage: TokenUsage | undefined;
   readonly server: LocalServer;
+  readonly showWaitingPlaceholder: boolean;
 }
 /**
  * useDevMode abstracts all the business logic for running/editing an agent.

package/dist/node/react/index.node.d.ts

@@ -1,5 +1,5 @@
 import { Context, UIOptions, UIOptionsSchema } from "../index.browser-BsqAq16G.js";
-import "../index.node-B8u-uZx1.js";
+import "../index.node-GlFXJEaB.js";
 import { BuildLog, BuildResult } from "../index-BNMqN1Am.js";
 import { CapabilitiesResponse, Client } from "../index-DHCYXwb2.js";
 import { UIMessage } from "ai";
@@ -82,13 +82,35 @@ interface Store<T extends object> {
  * createFileStore creates a simple file-based store with atomic read/write.
  * All operations are protected by filesystem locks for multi-process safety.
  */
+
+interface DiskStoreWatcher<T = any> {
+  onChange: (callback: (event: {
+    key: string;
+    value: T | undefined;
+    locked: boolean;
+    pid?: number;
+  }) => void) => () => void;
+  dispose: () => void;
+}
+/**
+ * createDiskStoreWatcher creates a watcher for the disk store.
+ * It watches the disk store for changes and emits events when the
+ * store changes.
+ *
+ * It also polls the store for changes in case the watcher misses
+ * any changes.
+ *
+ * It also debounces the changes to prevent too many events from
+ * being emitted.
+ */
 //#endregion
 //#region src/local/types.d.ts
 interface StoredChat {
-  readonly id: string;
-  readonly created_at: string;
-  readonly updated_at: string;
-  readonly messages: StoredMessage[];
+  id: string;
+  created_at: string;
+  updated_at: string;
+  messages: StoredMessage[];
+  error?: string;
 }
 type StoredMessageMetadata = {
   __blink_internal: true;
@@ -107,23 +129,111 @@ interface StoredMessage<T extends UIMessage = UIMessage<StoredMessageMetadata>>
  * Helper to convert UIMessage to StoredMessage
  */
 //#endregion
-//#region src/react/use-chat.d.ts
+//#region src/local/chat-manager.d.ts
 type ChatStatus = "idle" | "streaming" | "error";
-interface Chat {
+interface ChatState {
   readonly id: string;
   readonly created_at?: string;
   readonly updated_at?: string;
   readonly messages: StoredMessage[];
   readonly status: ChatStatus;
   readonly streamingMessage?: UIMessage;
-  readonly error?: Error;
+  readonly error?: string;
+  readonly loading: boolean;
   readonly queuedMessages: StoredMessage[];
 }
+interface ChatManagerOptions {
+  readonly chatId: string;
+  readonly store: Store<StoredChat>;
+  readonly watcher: DiskStoreWatcher<StoredChat>;
+  /**
+   * Optional function to filter messages before persisting them.
+   * Return undefined to skip persisting the message.
+   */
+  readonly serializeMessage?: (message: UIMessage) => StoredMessage | undefined;
+  /**
+   * Optional function to filter messages before sending to the agent.
+   * Return true to include the message, false to exclude it.
+   */
+  readonly filterMessages?: (message: UIMessage) => boolean;
+}
+type StateListener = (state: ChatState) => void;
+/**
+ * ChatManager handles all chat state and operations outside of React.
+ * This makes it easier to test and reason about race conditions.
+ */
+declare class ChatManager {
+  private chatId;
+  private agent;
+  private chatStore;
+  private serializeMessage?;
+  private filterMessages?;
+  private chat;
+  private loading;
+  private streamingMessage;
+  private status;
+  private queue;
+  private abortController;
+  private isProcessingQueue;
+  private listeners;
+  private unwatchStore;
+  private disposed;
+  constructor(options: ChatManagerOptions);
+  /**
+   * Update the agent instance to be used for chats
+   */
+  setAgent(agent: Client | undefined): void;
+  /**
+   * Get the current state
+   */
+  getState(): ChatState;
+  /**
+   * Subscribe to state changes
+   */
+  subscribe(listener: StateListener): () => void;
+  /**
+   * Upsert a message to the chat
+   */
+  upsertMessage(message: UIMessage, lock?: LockedStoreEntry<StoredChat>): Promise<void>;
+  deleteMessage(id: string): Promise<void>;
+  /**
+   * Send a message to the agent
+   */
+  sendMessage(message: StoredMessage): Promise<void>;
+  private processQueue;
+  /**
+   * Stop the current streaming operation
+   */
+  stopStreaming(): void;
+  /**
+   * Clear all queued messages
+   */
+  clearQueue(): void;
+  /**
+   * Reset the chat (delete from disk)
+   */
+  resetChat(): Promise<void>;
+  /**
+   * Dispose of the manager (cleanup)
+   */
+  dispose(): void;
+  private resetChatState;
+  private notifyListeners;
+}
+//#endregion
+//#region src/react/use-chat.d.ts
 interface UseChatOptions {
   readonly chatId: string;
   readonly agent: Client | undefined;
-  readonly chatStore: Store<StoredChat>;
   readonly chatsDirectory: string;
+  /**
+   * Optional shared store to use. If not provided, a new one will be created.
+   */
+  readonly store?: Store<StoredChat>;
+  /**
+   * Optional shared watcher to use. If not provided, a new one will be created.
+   */
+  readonly watcher?: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -135,9 +245,10 @@ interface UseChatOptions {
    */
   readonly filterMessages?: (message: UIMessage) => boolean;
 }
-interface UseChat extends Chat {
+interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
   readonly clearQueue: () => void;
@@ -163,8 +274,12 @@ type LocalServer = ReturnType<typeof createLocalServer>;
 declare function createLocalServer(options: CreateLocalServerOptions): {
   url: string;
   runtime: Context;
-  chatStore: Store<StoredChat>;
   chatsDirectory: string;
+  chatStore: Store<StoredChat>;
+  chatWatcher: DiskStoreWatcher<StoredChat>;
+  getChatManager: (chatId: string) => ChatManager;
+  listChats: () => Promise<StoreEntry[]>;
+  lockChat: (chatId: string) => Promise<LockedStoreEntry<StoredChat>>;
   startChat: (chatId: string) => void;
   stopChat: (chatId: string) => void;
   dispose: () => void;
@@ -226,6 +341,7 @@ interface UseDevMode {
   readonly approval: ApprovalRequest | undefined;
   readonly tokenUsage: TokenUsage | undefined;
   readonly server: LocalServer;
+  readonly showWaitingPlaceholder: boolean;
 }
 /**
  * useDevMode abstracts all the business logic for running/editing an agent.