@kubuild/ai 0.3.0

package/dist/react/index.js

@@ -0,0 +1,336 @@
+import {
+  createAiClient
+} from "../chunk-JY4NHD3Q.js";
+
+// src/react/use-ai-generator.ts
+import { useState, useCallback, useRef } from "react";
+function useAiGenerator(options) {
+  const [isGenerating, setIsGenerating] = useState(false);
+  const [isStreaming, setIsStreaming] = useState(false);
+  const [currentStep, setCurrentStep] = useState("");
+  const [error, setError] = useState(null);
+  const abortControllerRef = useRef(null);
+  const clientRef = useRef(createAiClient(options));
+  const cancel = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+      setIsGenerating(false);
+      setIsStreaming(false);
+      setCurrentStep("");
+    }
+  }, []);
+  const generatePage = useCallback(
+    async (params) => {
+      cancel();
+      const ac = new AbortController();
+      abortControllerRef.current = ac;
+      setIsGenerating(true);
+      setIsStreaming(false);
+      setError(null);
+      setCurrentStep("Generating full page...");
+      try {
+        const doc = await clientRef.current.generatePage(params, {
+          signal: ac.signal
+        });
+        options.onSuccess?.(doc);
+        return doc;
+      } catch (err) {
+        if (ac.signal.aborted) return null;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        options.onError?.(e);
+        return null;
+      } finally {
+        if (abortControllerRef.current === ac) {
+          setIsGenerating(false);
+          setCurrentStep("");
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [cancel, options]
+  );
+  const streamPage = useCallback(
+    async (params, streamCallbacks) => {
+      cancel();
+      const ac = new AbortController();
+      abortControllerRef.current = ac;
+      setIsGenerating(true);
+      setIsStreaming(true);
+      setError(null);
+      setCurrentStep("Connecting to AI stream...");
+      try {
+        const doc = await clientRef.current.streamPage(
+          params,
+          {
+            onStatus: (msg) => {
+              setCurrentStep(msg);
+              streamCallbacks?.onStatus?.(msg);
+            },
+            onMetadata: (metadata, rootPage) => {
+              streamCallbacks?.onMetadata?.(metadata, rootPage);
+            },
+            onSection: (section, index, total) => {
+              setCurrentStep(`Section ${index + 1}/${total} rendered`);
+              streamCallbacks?.onSection?.(section, index, total);
+            },
+            onComplete: (completedDoc) => {
+              setCurrentStep("Completed");
+              streamCallbacks?.onComplete?.(completedDoc);
+              options.onSuccess?.(completedDoc);
+            },
+            onError: (err) => {
+              setError(err);
+              streamCallbacks?.onError?.(err);
+              options.onError?.(err);
+            }
+          },
+          { signal: ac.signal }
+        );
+        return doc;
+      } catch (err) {
+        if (ac.signal.aborted) return null;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        options.onError?.(e);
+        return null;
+      } finally {
+        if (abortControllerRef.current === ac) {
+          setIsGenerating(false);
+          setIsStreaming(false);
+          setCurrentStep("");
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [cancel, options]
+  );
+  const generateSection = useCallback(
+    async (params) => {
+      cancel();
+      const ac = new AbortController();
+      abortControllerRef.current = ac;
+      setIsGenerating(true);
+      setIsStreaming(false);
+      setError(null);
+      setCurrentStep("Generating section...");
+      try {
+        const node = await clientRef.current.generateSection(params, {
+          signal: ac.signal
+        });
+        options.onSuccess?.(node);
+        return node;
+      } catch (err) {
+        if (ac.signal.aborted) return null;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        options.onError?.(e);
+        return null;
+      } finally {
+        if (abortControllerRef.current === ac) {
+          setIsGenerating(false);
+          setCurrentStep("");
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [cancel, options]
+  );
+  const refactorNode = useCallback(
+    async (params) => {
+      cancel();
+      const ac = new AbortController();
+      abortControllerRef.current = ac;
+      setIsGenerating(true);
+      setIsStreaming(false);
+      setError(null);
+      setCurrentStep("Refactoring node...");
+      try {
+        const node = await clientRef.current.refactorNode(params, {
+          signal: ac.signal
+        });
+        options.onSuccess?.(node);
+        return node;
+      } catch (err) {
+        if (ac.signal.aborted) return null;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        options.onError?.(e);
+        return null;
+      } finally {
+        if (abortControllerRef.current === ac) {
+          setIsGenerating(false);
+          setCurrentStep("");
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [cancel, options]
+  );
+  return {
+    generatePage,
+    streamPage,
+    generateSection,
+    refactorNode,
+    isGenerating,
+    isStreaming,
+    currentStep,
+    error,
+    cancel
+  };
+}
+
+// src/react/use-ai-chat.ts
+import { useState as useState2, useCallback as useCallback2, useRef as useRef2, useEffect } from "react";
+function useAiChat(options) {
+  const [messages, setMessages] = useState2(options.initialMessages || []);
+  const [isLoading, setIsLoading] = useState2(false);
+  const [isStreaming, setIsStreaming] = useState2(false);
+  const [error, setError] = useState2(null);
+  const abortControllerRef = useRef2(null);
+  const clientRef = useRef2(createAiClient(options));
+  const historyStorageRef = useRef2(options.historyStorage);
+  historyStorageRef.current = options.historyStorage;
+  const persistHistory = useCallback2((history) => {
+    const adapter = historyStorageRef.current;
+    if (!adapter) return;
+    try {
+      void Promise.resolve(adapter.saveHistory(history)).catch(() => void 0);
+    } catch {
+    }
+  }, []);
+  useEffect(() => {
+    const adapter = historyStorageRef.current;
+    if (!adapter) return;
+    let cancelled = false;
+    Promise.resolve(adapter.loadHistory()).then((loaded) => {
+      if (!cancelled && Array.isArray(loaded) && loaded.length > 0) {
+        setMessages(loaded);
+      }
+    }).catch((err) => {
+      if (cancelled) return;
+      const e = err instanceof Error ? err : new Error(String(err));
+      options.onError?.(e);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+  const cancel = useCallback2(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+      setIsLoading(false);
+      setIsStreaming(false);
+    }
+  }, []);
+  const clearMessages = useCallback2(() => {
+    setMessages([]);
+    setError(null);
+    persistHistory([]);
+  }, [persistHistory]);
+  const sendMessage = useCallback2(
+    async (content, sendOptions) => {
+      if (!content.trim()) return null;
+      cancel();
+      const ac = new AbortController();
+      abortControllerRef.current = ac;
+      const userMessage = {
+        role: "user",
+        content: content.trim(),
+        timestamp: Date.now()
+      };
+      const updatedHistory = [...messages, userMessage];
+      setMessages(updatedHistory);
+      setIsLoading(true);
+      setError(null);
+      persistHistory(updatedHistory);
+      const useStream = sendOptions?.stream !== false;
+      try {
+        if (useStream) {
+          setIsStreaming(true);
+          let assistantIndex = -1;
+          setMessages((prev) => {
+            assistantIndex = prev.length;
+            return [...prev, { role: "assistant", content: "", timestamp: Date.now() }];
+          });
+          const finalMessage = await clientRef.current.chatStream(
+            {
+              messages: updatedHistory,
+              currentDocument: sendOptions?.currentDocument,
+              selectedNodeId: sendOptions?.selectedNodeId,
+              systemPrompt: sendOptions?.systemPrompt
+            },
+            {
+              onChatChunk: (delta, contentSoFar) => {
+                options.onChunk?.(delta, contentSoFar);
+                setMessages((prev) => {
+                  if (assistantIndex < 0 || assistantIndex >= prev.length) return prev;
+                  const next = prev.slice();
+                  next[assistantIndex] = { ...next[assistantIndex], content: contentSoFar };
+                  return next;
+                });
+              },
+              onChatComplete: (message) => {
+                setMessages((prev) => {
+                  if (assistantIndex < 0 || assistantIndex >= prev.length) return prev;
+                  const next = prev.slice();
+                  next[assistantIndex] = message;
+                  return next;
+                });
+              }
+            },
+            { signal: ac.signal }
+          );
+          persistHistory([...updatedHistory, finalMessage]);
+          options.onMessage?.(finalMessage);
+          return finalMessage;
+        }
+        const response = await clientRef.current.chat(
+          {
+            messages: updatedHistory,
+            currentDocument: sendOptions?.currentDocument,
+            selectedNodeId: sendOptions?.selectedNodeId,
+            systemPrompt: sendOptions?.systemPrompt
+          },
+          { signal: ac.signal }
+        );
+        const assistantMsg = response.message;
+        setMessages((prev) => [...prev, assistantMsg]);
+        persistHistory([...updatedHistory, assistantMsg]);
+        options.onMessage?.(assistantMsg);
+        return assistantMsg;
+      } catch (err) {
+        if (ac.signal.aborted) return null;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        options.onError?.(e);
+        return null;
+      } finally {
+        if (abortControllerRef.current === ac) {
+          setIsLoading(false);
+          setIsStreaming(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [cancel, messages, options, persistHistory]
+  );
+  return {
+    messages,
+    sendMessage,
+    isLoading,
+    /** Whether the in-flight `sendMessage` call is a token-level stream (STORA-516). */
+    isStreaming,
+    error,
+    cancel,
+    clearMessages,
+    setMessages
+  };
+}
+export {
+  useAiChat,
+  useAiGenerator
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/use-ai-generator.ts","../../src/react/use-ai-chat.ts"],"sourcesContent":["import { useState, useCallback, useRef } from 'react';\nimport type { PageDocument, Node } from '@kubuild/schema';\nimport type {\n  AiGeneratePageRequest,\n  AiGenerateSectionRequest,\n  AiRefactorNodeRequest,\n  AiStreamCallbacks,\n} from '../types';\nimport { createAiClient, type AiClientOptions, KubuildAiClient } from '../client/ai-client';\n\nexport interface UseAiGeneratorOptions extends AiClientOptions {\n  onSuccess?: (data: PageDocument | Node) => void;\n  onError?: (error: Error) => void;\n}\n\nexport function useAiGenerator(options: UseAiGeneratorOptions) {\n  const [isGenerating, setIsGenerating] = useState(false);\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [currentStep, setCurrentStep] = useState<string>('');\n  const [error, setError] = useState<Error | null>(null);\n\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const clientRef = useRef<KubuildAiClient>(createAiClient(options));\n\n  // Cancel any in-flight request\n  const cancel = useCallback(() => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n      abortControllerRef.current = null;\n      setIsGenerating(false);\n      setIsStreaming(false);\n      setCurrentStep('');\n    }\n  }, []);\n\n  /**\n   * Standard full page generator (non-streaming).\n   */\n  const generatePage = useCallback(\n    async (params: AiGeneratePageRequest): Promise<PageDocument | null> => {\n      cancel();\n      const ac = new AbortController();\n      abortControllerRef.current = ac;\n\n      setIsGenerating(true);\n      setIsStreaming(false);\n      setError(null);\n      setCurrentStep('Generating full page...');\n\n      try {\n        const doc = await clientRef.current.generatePage(params, {\n          signal: ac.signal,\n        });\n        options.onSuccess?.(doc);\n        return doc;\n      } catch (err: unknown) {\n        if (ac.signal.aborted) return null;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        options.onError?.(e);\n        return null;\n      } finally {\n        if (abortControllerRef.current === ac) {\n          setIsGenerating(false);\n          setCurrentStep('');\n          abortControllerRef.current = null;\n        }\n      }\n    },\n    [cancel, options],\n  );\n\n  /**\n   * Progressive section streamer (SSE).\n   * Calls callbacks on each step (onStatus, onMetadata, onSection, onComplete).\n   */\n  const streamPage = useCallback(\n    async (\n      params: AiGeneratePageRequest,\n      streamCallbacks?: AiStreamCallbacks,\n    ): Promise<PageDocument | null> => {\n      cancel();\n      const ac = new AbortController();\n      abortControllerRef.current = ac;\n\n      setIsGenerating(true);\n      setIsStreaming(true);\n      setError(null);\n      setCurrentStep('Connecting to AI stream...');\n\n      try {\n        const doc = await clientRef.current.streamPage(\n          params,\n          {\n            onStatus: (msg) => {\n              setCurrentStep(msg);\n              streamCallbacks?.onStatus?.(msg);\n            },\n            onMetadata: (metadata, rootPage) => {\n              streamCallbacks?.onMetadata?.(metadata, rootPage);\n            },\n            onSection: (section, index, total) => {\n              setCurrentStep(`Section ${index + 1}/${total} rendered`);\n              streamCallbacks?.onSection?.(section, index, total);\n            },\n            onComplete: (completedDoc) => {\n              setCurrentStep('Completed');\n              streamCallbacks?.onComplete?.(completedDoc);\n              options.onSuccess?.(completedDoc);\n            },\n            onError: (err) => {\n              setError(err);\n              streamCallbacks?.onError?.(err);\n              options.onError?.(err);\n            },\n          },\n          { signal: ac.signal },\n        );\n\n        return doc;\n      } catch (err: unknown) {\n        if (ac.signal.aborted) return null;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        options.onError?.(e);\n        return null;\n      } finally {\n        if (abortControllerRef.current === ac) {\n          setIsGenerating(false);\n          setIsStreaming(false);\n          setCurrentStep('');\n          abortControllerRef.current = null;\n        }\n      }\n    },\n    [cancel, options],\n  );\n\n  const generateSection = useCallback(\n    async (params: AiGenerateSectionRequest): Promise<Node | null> => {\n      cancel();\n      const ac = new AbortController();\n      abortControllerRef.current = ac;\n\n      setIsGenerating(true);\n      setIsStreaming(false);\n      setError(null);\n      setCurrentStep('Generating section...');\n\n      try {\n        const node = await clientRef.current.generateSection(params, {\n          signal: ac.signal,\n        });\n        options.onSuccess?.(node);\n        return node;\n      } catch (err: unknown) {\n        if (ac.signal.aborted) return null;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        options.onError?.(e);\n        return null;\n      } finally {\n        if (abortControllerRef.current === ac) {\n          setIsGenerating(false);\n          setCurrentStep('');\n          abortControllerRef.current = null;\n        }\n      }\n    },\n    [cancel, options],\n  );\n\n  const refactorNode = useCallback(\n    async (params: AiRefactorNodeRequest): Promise<Node | null> => {\n      cancel();\n      const ac = new AbortController();\n      abortControllerRef.current = ac;\n\n      setIsGenerating(true);\n      setIsStreaming(false);\n      setError(null);\n      setCurrentStep('Refactoring node...');\n\n      try {\n        const node = await clientRef.current.refactorNode(params, {\n          signal: ac.signal,\n        });\n        options.onSuccess?.(node);\n        return node;\n      } catch (err: unknown) {\n        if (ac.signal.aborted) return null;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        options.onError?.(e);\n        return null;\n      } finally {\n        if (abortControllerRef.current === ac) {\n          setIsGenerating(false);\n          setCurrentStep('');\n          abortControllerRef.current = null;\n        }\n      }\n    },\n    [cancel, options],\n  );\n\n  return {\n    generatePage,\n    streamPage,\n    generateSection,\n    refactorNode,\n    isGenerating,\n    isStreaming,\n    currentStep,\n    error,\n    cancel,\n  };\n}\n","import { useState, useCallback, useRef, useEffect } from 'react';\nimport type { PageDocument } from '@kubuild/schema';\nimport type { AiChatMessage, AiChatResponse } from '../types';\nimport { createAiClient, type AiClientOptions, KubuildAiClient } from '../client/ai-client';\n\n/**\n * Optional, host-implemented chat history persistence (STORA-520). `@kubuild/ai` stays\n * storage-agnostic — it never imports `localStorage` or any concrete storage mechanism\n * itself; the host supplies an adapter backed by whatever it wants (browser\n * `localStorage`, IndexedDB, a Stora.page backend call, etc.).\n */\nexport interface AiChatHistoryStorageAdapter {\n  /** Called once on mount to seed `messages` before the user sends anything. */\n  loadHistory(): Promise<AiChatMessage[]> | AiChatMessage[];\n  /**\n   * Called at completed-message boundaries (a user message just sent, or an assistant\n   * reply that just finished/streamed to completion) — never on every mid-stream token,\n   * see `useAiChat`'s persistence notes.\n   */\n  saveHistory(messages: AiChatMessage[]): Promise<void> | void;\n}\n\nexport interface UseAiChatOptions extends AiClientOptions {\n  initialMessages?: AiChatMessage[];\n  onMessage?: (message: AiChatMessage) => void;\n  onError?: (error: Error) => void;\n  /**\n   * Fired for every partial token/chunk of a streaming chat response (STORA-516),\n   * mirroring `useAiGenerator`'s `AiStreamCallbacks` naming convention. Optional — the\n   * `messages` array already updates incrementally on its own, this is only for hosts\n   * that want a side-channel (e.g. custom rendering, telemetry) into the raw chunks.\n   */\n  onChunk?: (delta: string, content: string) => void;\n  /**\n   * Optional storage adapter (STORA-520) used to persist/restore chat history across\n   * reloads. Without it, behavior is exactly as before: pure in-memory React state, lost\n   * on reload/unmount. `loadHistory()` is called once on mount to hydrate `messages`\n   * (only overriding `initialMessages` when it resolves a non-empty array);\n   * `saveHistory()` is called at completed-message boundaries — after a user message is\n   * appended, and after an assistant reply finishes (streamed or not) — intentionally\n   * *not* on every streaming chunk, to avoid hammering the adapter mid-stream.\n   */\n  historyStorage?: AiChatHistoryStorageAdapter;\n}\n\nexport interface SendMessageOptions {\n  currentDocument?: PageDocument;\n  selectedNodeId?: string;\n  systemPrompt?: string;\n  /**\n   * Opt out of token-level streaming for this call (STORA-515/516 default to `true`).\n   * When `false`, behaves exactly like the pre-streaming single request/response call.\n   */\n  stream?: boolean;\n}\n\nexport function useAiChat(options: UseAiChatOptions) {\n  const [messages, setMessages] = useState<AiChatMessage[]>(options.initialMessages || []);\n  const [isLoading, setIsLoading] = useState(false);\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const clientRef = useRef<KubuildAiClient>(createAiClient(options));\n  const historyStorageRef = useRef(options.historyStorage);\n  historyStorageRef.current = options.historyStorage;\n\n  /**\n   * STORA-520 — best-effort persistence: a storage failure (quota exceeded, network\n   * error on a remote adapter, etc.) must never break the chat itself, so errors are\n   * swallowed here rather than surfaced through `setError`/`onError` (those are reserved\n   * for the actual chat request failing).\n   */\n  const persistHistory = useCallback((history: AiChatMessage[]) => {\n    const adapter = historyStorageRef.current;\n    if (!adapter) return;\n    try {\n      void Promise.resolve(adapter.saveHistory(history)).catch(() => undefined);\n    } catch {\n      // Synchronous throw from a non-Promise-returning adapter — ignore, same reasoning.\n    }\n  }, []);\n\n  // STORA-520 — hydrate from storage once on mount. Only overrides `initialMessages`\n  // when the adapter actually resolves a non-empty history, so a fresh/empty adapter\n  // (e.g. first-ever visit) doesn't clobber a host-provided `initialMessages` seed.\n  useEffect(() => {\n    const adapter = historyStorageRef.current;\n    if (!adapter) return;\n    let cancelled = false;\n    Promise.resolve(adapter.loadHistory())\n      .then((loaded) => {\n        if (!cancelled && Array.isArray(loaded) && loaded.length > 0) {\n          setMessages(loaded);\n        }\n      })\n      .catch((err: unknown) => {\n        if (cancelled) return;\n        const e = err instanceof Error ? err : new Error(String(err));\n        options.onError?.(e);\n      });\n    return () => {\n      cancelled = true;\n    };\n    // Deliberately empty deps: `historyStorage`/`onError` are read via refs/closures at\n    // call time and this must run exactly once per mount, not whenever the caller passes\n    // a fresh options object.\n  }, []);\n\n  const cancel = useCallback(() => {\n    if (abortControllerRef.current) {\n      // Aborts the underlying fetch (and, for a streaming request, the in-flight\n      // ReadableStream read) — not just local UI state (STORA-516 AC).\n      abortControllerRef.current.abort();\n      abortControllerRef.current = null;\n      setIsLoading(false);\n      setIsStreaming(false);\n    }\n  }, []);\n\n  const clearMessages = useCallback(() => {\n    setMessages([]);\n    setError(null);\n    persistHistory([]);\n  }, [persistHistory]);\n\n  const sendMessage = useCallback(\n    async (content: string, sendOptions?: SendMessageOptions): Promise<AiChatMessage | null> => {\n      if (!content.trim()) return null;\n\n      cancel();\n      const ac = new AbortController();\n      abortControllerRef.current = ac;\n\n      const userMessage: AiChatMessage = {\n        role: 'user',\n        content: content.trim(),\n        timestamp: Date.now(),\n      };\n\n      const updatedHistory = [...messages, userMessage];\n      setMessages(updatedHistory);\n      setIsLoading(true);\n      setError(null);\n      // Completed-message boundary #1 (STORA-520): the user's message is final the\n      // instant it's sent — persist it now rather than waiting for the assistant reply,\n      // so a reload mid-request doesn't lose it.\n      persistHistory(updatedHistory);\n\n      const useStream = sendOptions?.stream !== false;\n\n      try {\n        if (useStream) {\n          setIsStreaming(true);\n\n          // Placeholder assistant message, filled in incrementally as chunks arrive.\n          let assistantIndex = -1;\n          setMessages((prev) => {\n            assistantIndex = prev.length;\n            return [...prev, { role: 'assistant', content: '', timestamp: Date.now() }];\n          });\n\n          const finalMessage = await clientRef.current.chatStream(\n            {\n              messages: updatedHistory,\n              currentDocument: sendOptions?.currentDocument,\n              selectedNodeId: sendOptions?.selectedNodeId,\n              systemPrompt: sendOptions?.systemPrompt,\n            },\n            {\n              onChatChunk: (delta, contentSoFar) => {\n                options.onChunk?.(delta, contentSoFar);\n                setMessages((prev) => {\n                  if (assistantIndex < 0 || assistantIndex >= prev.length) return prev;\n                  const next = prev.slice();\n                  next[assistantIndex] = { ...next[assistantIndex], content: contentSoFar };\n                  return next;\n                });\n              },\n              onChatComplete: (message) => {\n                setMessages((prev) => {\n                  if (assistantIndex < 0 || assistantIndex >= prev.length) return prev;\n                  const next = prev.slice();\n                  next[assistantIndex] = message;\n                  return next;\n                });\n              },\n            },\n            { signal: ac.signal },\n          );\n\n          // Completed-message boundary #2 (STORA-520): the stream finished — persist the\n          // fully assembled assistant message, never the intermediate per-chunk content\n          // (`onChatChunk` above deliberately does not call `persistHistory`).\n          persistHistory([...updatedHistory, finalMessage]);\n          options.onMessage?.(finalMessage);\n          return finalMessage;\n        }\n\n        const response: AiChatResponse = await clientRef.current.chat(\n          {\n            messages: updatedHistory,\n            currentDocument: sendOptions?.currentDocument,\n            selectedNodeId: sendOptions?.selectedNodeId,\n            systemPrompt: sendOptions?.systemPrompt,\n          },\n          { signal: ac.signal },\n        );\n\n        const assistantMsg = response.message;\n        setMessages((prev) => [...prev, assistantMsg]);\n        // Completed-message boundary #2 (non-streaming variant): a single request/response\n        // call has no intermediate chunks at all, so this is simply \"after the reply\".\n        persistHistory([...updatedHistory, assistantMsg]);\n        options.onMessage?.(assistantMsg);\n        return assistantMsg;\n      } catch (err: unknown) {\n        if (ac.signal.aborted) return null;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        options.onError?.(e);\n        return null;\n      } finally {\n        if (abortControllerRef.current === ac) {\n          setIsLoading(false);\n          setIsStreaming(false);\n          abortControllerRef.current = null;\n        }\n      }\n    },\n    [cancel, messages, options, persistHistory],\n  );\n\n  return {\n    messages,\n    sendMessage,\n    isLoading,\n    /** Whether the in-flight `sendMessage` call is a token-level stream (STORA-516). */\n    isStreaming,\n    error,\n    cancel,\n    clearMessages,\n    setMessages,\n  };\n}\n"],"mappings":"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","names":["useState","useCallback","useRef","useState","useRef","useCallback"]}

package/dist/react/use-ai-chat.d.ts

@@ -0,0 +1,63 @@
+import type { PageDocument } from '@kubuild/schema';
+import type { AiChatMessage } from '../types';
+import { type AiClientOptions } from '../client/ai-client';
+/**
+ * Optional, host-implemented chat history persistence (STORA-520). `@kubuild/ai` stays
+ * storage-agnostic — it never imports `localStorage` or any concrete storage mechanism
+ * itself; the host supplies an adapter backed by whatever it wants (browser
+ * `localStorage`, IndexedDB, a Stora.page backend call, etc.).
+ */
+export interface AiChatHistoryStorageAdapter {
+    /** Called once on mount to seed `messages` before the user sends anything. */
+    loadHistory(): Promise<AiChatMessage[]> | AiChatMessage[];
+    /**
+     * Called at completed-message boundaries (a user message just sent, or an assistant
+     * reply that just finished/streamed to completion) — never on every mid-stream token,
+     * see `useAiChat`'s persistence notes.
+     */
+    saveHistory(messages: AiChatMessage[]): Promise<void> | void;
+}
+export interface UseAiChatOptions extends AiClientOptions {
+    initialMessages?: AiChatMessage[];
+    onMessage?: (message: AiChatMessage) => void;
+    onError?: (error: Error) => void;
+    /**
+     * Fired for every partial token/chunk of a streaming chat response (STORA-516),
+     * mirroring `useAiGenerator`'s `AiStreamCallbacks` naming convention. Optional — the
+     * `messages` array already updates incrementally on its own, this is only for hosts
+     * that want a side-channel (e.g. custom rendering, telemetry) into the raw chunks.
+     */
+    onChunk?: (delta: string, content: string) => void;
+    /**
+     * Optional storage adapter (STORA-520) used to persist/restore chat history across
+     * reloads. Without it, behavior is exactly as before: pure in-memory React state, lost
+     * on reload/unmount. `loadHistory()` is called once on mount to hydrate `messages`
+     * (only overriding `initialMessages` when it resolves a non-empty array);
+     * `saveHistory()` is called at completed-message boundaries — after a user message is
+     * appended, and after an assistant reply finishes (streamed or not) — intentionally
+     * *not* on every streaming chunk, to avoid hammering the adapter mid-stream.
+     */
+    historyStorage?: AiChatHistoryStorageAdapter;
+}
+export interface SendMessageOptions {
+    currentDocument?: PageDocument;
+    selectedNodeId?: string;
+    systemPrompt?: string;
+    /**
+     * Opt out of token-level streaming for this call (STORA-515/516 default to `true`).
+     * When `false`, behaves exactly like the pre-streaming single request/response call.
+     */
+    stream?: boolean;
+}
+export declare function useAiChat(options: UseAiChatOptions): {
+    messages: AiChatMessage[];
+    sendMessage: (content: string, sendOptions?: SendMessageOptions) => Promise<AiChatMessage | null>;
+    isLoading: boolean;
+    /** Whether the in-flight `sendMessage` call is a token-level stream (STORA-516). */
+    isStreaming: boolean;
+    error: Error | null;
+    cancel: () => void;
+    clearMessages: () => void;
+    setMessages: import("react").Dispatch<import("react").SetStateAction<AiChatMessage[]>>;
+};
+//# sourceMappingURL=use-ai-chat.d.ts.map

package/dist/react/use-ai-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ai-chat.d.ts","sourceRoot":"","sources":["../../src/react/use-ai-chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAkB,KAAK,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8EAA8E;IAC9E,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;IAC1D;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB;;2BAuE/B,MAAM,gBAAgB,kBAAkB,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;;IA8GxF,oFAAoF;;;;;;EAOvF"}

package/dist/react/use-ai-generator.d.ts

@@ -0,0 +1,19 @@
+import type { PageDocument, Node } from '@kubuild/schema';
+import type { AiGeneratePageRequest, AiGenerateSectionRequest, AiRefactorNodeRequest, AiStreamCallbacks } from '../types';
+import { type AiClientOptions } from '../client/ai-client';
+export interface UseAiGeneratorOptions extends AiClientOptions {
+    onSuccess?: (data: PageDocument | Node) => void;
+    onError?: (error: Error) => void;
+}
+export declare function useAiGenerator(options: UseAiGeneratorOptions): {
+    generatePage: (params: AiGeneratePageRequest) => Promise<PageDocument | null>;
+    streamPage: (params: AiGeneratePageRequest, streamCallbacks?: AiStreamCallbacks) => Promise<PageDocument | null>;
+    generateSection: (params: AiGenerateSectionRequest) => Promise<Node | null>;
+    refactorNode: (params: AiRefactorNodeRequest) => Promise<Node | null>;
+    isGenerating: boolean;
+    isStreaming: boolean;
+    currentStep: string;
+    error: Error | null;
+    cancel: () => void;
+};
+//# sourceMappingURL=use-ai-generator.d.ts.map

package/dist/react/use-ai-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ai-generator.d.ts","sourceRoot":"","sources":["../../src/react/use-ai-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAkB,KAAK,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAE5F,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB;2BAwB1C,qBAAqB,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;yBAuCzD,qBAAqB,oBACX,iBAAiB,KAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;8BA2DhB,wBAAwB,KAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;2BAkC/C,qBAAqB,KAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;;;;;;EA4C9D"}

package/dist/server/adapters/anthropic.d.ts

@@ -0,0 +1,30 @@
+import type { AiProviderAdapter, AiProviderGenerateParams, AiProviderGenerateResult } from '../../types';
+export interface AnthropicAdapterOptions {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    baseUrl?: string;
+    anthropicVersion?: string;
+    headers?: Record<string, string>;
+}
+export declare class AnthropicAdapter implements AiProviderAdapter {
+    readonly name = "anthropic";
+    private apiKey;
+    private model;
+    private maxTokens;
+    private temperature;
+    private baseUrl;
+    private anthropicVersion;
+    private customHeaders?;
+    constructor(options: AnthropicAdapterOptions);
+    private buildMessages;
+    generate(params: AiProviderGenerateParams): Promise<AiProviderGenerateResult>;
+    /**
+     * Token-level streaming via Anthropic's `stream: true` Messages API (STORA-515).
+     * Parses the `content_block_delta` (`text_delta`) events for incremental text and the
+     * `message_start`/`message_delta` events for usage accounting.
+     */
+    generateStream(params: AiProviderGenerateParams): AsyncGenerator<string, AiProviderGenerateResult, void>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/server/adapters/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAC,CAAyB;gBAEnC,OAAO,EAAE,uBAAuB;IAa5C,OAAO,CAAC,aAAa;IAgBf,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA4DnF;;;;OAIG;IACI,cAAc,CACnB,MAAM,EAAE,wBAAwB,GAC/B,cAAc,CAAC,MAAM,EAAE,wBAAwB,EAAE,IAAI,CAAC;CA6E1D"}

package/dist/server/adapters/base.d.ts

@@ -0,0 +1,2 @@
+export type { AiProviderAdapter, AiProviderGenerateParams, AiProviderGenerateResult, } from '../../types';
+//# sourceMappingURL=base.d.ts.map

package/dist/server/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/base.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/dist/server/adapters/custom.d.ts

@@ -0,0 +1,18 @@
+import type { AiProviderAdapter, AiProviderGenerateParams, AiProviderGenerateResult } from '../../types';
+export interface CustomHttpAdapterOptions {
+    url: string;
+    name?: string;
+    headers?: Record<string, string>;
+    formatRequestBody?: (params: AiProviderGenerateParams) => unknown;
+    parseResponse?: (json: unknown) => string;
+}
+export declare class CustomHttpAdapter implements AiProviderAdapter {
+    readonly name: string;
+    private url;
+    private headers?;
+    private formatRequestBody;
+    private parseResponse;
+    constructor(options: CustomHttpAdapterOptions);
+    generate(params: AiProviderGenerateParams): Promise<AiProviderGenerateResult>;
+}
+//# sourceMappingURL=custom.d.ts.map

package/dist/server/adapters/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/custom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,OAAO,CAAC;IAClE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;CAC3C;AAED,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,iBAAiB,CAAgD;IACzE,OAAO,CAAC,aAAa,CAA4B;gBAErC,OAAO,EAAE,wBAAwB;IA8CvC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAyBpF"}

package/dist/server/adapters/gemini.d.ts

@@ -0,0 +1,22 @@
+import type { AiProviderAdapter, AiProviderGenerateParams, AiProviderGenerateResult } from '../../types';
+export interface GeminiAdapterOptions {
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    baseUrl?: string;
+}
+export declare class GeminiAdapter implements AiProviderAdapter {
+    readonly name = "gemini";
+    private apiKey;
+    private model;
+    private temperature;
+    private baseUrl;
+    constructor(options: GeminiAdapterOptions);
+    private buildContents;
+    generate(params: AiProviderGenerateParams): Promise<AiProviderGenerateResult>;
+    /**
+     * Token-level streaming via Gemini's `streamGenerateContent` SSE endpoint (STORA-515).
+     */
+    generateStream(params: AiProviderGenerateParams): AsyncGenerator<string, AiProviderGenerateResult, void>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/server/adapters/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAc,YAAW,iBAAiB;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,oBAAoB;IAWzC,OAAO,CAAC,aAAa;IAiBf,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAkEnF;;OAEG;IACI,cAAc,CACnB,MAAM,EAAE,wBAAwB,GAC/B,cAAc,CAAC,MAAM,EAAE,wBAAwB,EAAE,IAAI,CAAC;CAmE1D"}