@open-mercato/ui 0.5.1-develop.3036.f02c281f23 → 0.5.1-develop.3045.b4b3320cc2

package/dist/ai/upload-adapter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ai/upload-adapter.ts"],
+  "sourcesContent": ["/**\n * Framework-agnostic upload adapter for the AI chat composer.\n *\n * Forwards files dropped into {@link AiChat} to the existing attachments API\n * (`POST /api/attachments`, multipart form-data \u2014 see\n * `packages/core/src/modules/attachments/api/route.ts`) and returns the\n * resulting `attachmentIds` so the chat request layer can thread them into the\n * dispatcher body (`POST /api/ai_assistant/ai/chat?agent=<id>` reads\n * `attachmentIds` from JSON).\n *\n * The adapter is intentionally framework-agnostic: no Next.js imports, no\n * React. A thin React hook ({@link useAiChatUpload}) wraps it for the composer.\n */\n\nconst DEFAULT_ATTACHMENTS_ENDPOINT = '/api/attachments'\nconst DEFAULT_AI_CHAT_ENTITY_ID = 'ai-chat-draft'\nconst DEFAULT_CONCURRENCY = 3\n// Hard cap on a single upload's wall-clock time. The previous implementation\n// had no timeout, so a stalled `/api/attachments` request would leave the\n// composer chip spinning forever (the server never returned, the client\n// never unblocked the Send button). 60s is generous for the documented\n// per-file size limits and matches the behaviour of the rest of the\n// backoffice's `apiCall` helpers.\nconst DEFAULT_PER_FILE_TIMEOUT_MS = 60_000\n\nexport type UploadFailureReason =\n  | 'mime_rejected'\n  | 'size_exceeded'\n  | 'network'\n  | 'server'\n  | 'aborted'\n\nexport interface UploadAttachmentsForChatOptions {\n  /** Optional override for the attachments endpoint (defaults to `/api/attachments`). */\n  endpoint?: string\n  /** Entity identifier recorded alongside the attachment. Defaults to `'ai-chat-draft'`. */\n  entityType?: string\n  /**\n   * Record identifier for the chat draft. When omitted, the adapter mints a\n   * per-invocation UUID so every batch groups cleanly in the attachments table.\n   */\n  recordId?: string\n  /** Optional partition code; forwarded verbatim to the attachments route. */\n  partitionCode?: string\n  /** Optional injectable fetch (tests, portal). Defaults to `globalThis.fetch`. */\n  fetchImpl?: typeof fetch\n  /** Optional progress callback fired once per file completion. */\n  onProgress?: (\n    fileIndex: number,\n    progress: { loaded: number; total: number },\n  ) => void\n  /** Abort the whole batch; queued files short-circuit as `'aborted'`. */\n  signal?: AbortSignal\n  /** Parallelism cap. Defaults to 3. */\n  concurrency?: number\n  /**\n   * Hard timeout per upload, in milliseconds. Defaults to 60_000 (60s).\n   * When the upload exceeds the timeout the request is aborted and the\n   * file lands in `failed` with `reason: 'aborted'` instead of the chip\n   * spinning forever. Pass `0` to disable.\n   */\n  perFileTimeoutMs?: number\n}\n\nexport interface UploadedAttachment {\n  attachmentId: string\n  /**\n   * Server-returned (possibly sanitized) filename. The original\n   * client-side `File.name` is preserved on `originalFileName` so the\n   * chat composer can pair the upload result back to its chip without a\n   * sanitization-induced map miss.\n   */\n  fileName: string\n  /** The exact `File.name` the caller passed in. Always set. */\n  originalFileName: string\n  /** Position of this file in the original input array. Always set. */\n  inputIndex: number\n  mediaType: string\n  size: number\n}\n\nexport interface UploadFailure {\n  fileName: string\n  /** The exact `File.name` the caller passed in. Always set. */\n  originalFileName: string\n  /** Position of this file in the original input array. Always set. */\n  inputIndex: number\n  reason: UploadFailureReason\n  message: string\n}\n\nexport interface UploadAttachmentsForChatResult {\n  items: UploadedAttachment[]\n  failed: UploadFailure[]\n}\n\nfunction mintRecordId(): string {\n  const cryptoApi = (globalThis as unknown as { crypto?: Crypto }).crypto\n  if (cryptoApi && typeof cryptoApi.randomUUID === 'function') {\n    return cryptoApi.randomUUID()\n  }\n  const random = Math.random().toString(36).slice(2, 10)\n  const time = Date.now().toString(36)\n  return `ai-chat-${time}-${random}`\n}\n\nfunction resolveFetchImpl(explicit?: typeof fetch): typeof fetch {\n  if (explicit) return explicit\n  const fallback = (globalThis as typeof globalThis & { fetch?: typeof fetch }).fetch\n  if (!fallback) {\n    throw new Error('No fetch implementation available for uploadAttachmentsForChat')\n  }\n  return fallback.bind(globalThis) as typeof fetch\n}\n\nfunction normalizeServerErrorMessage(raw: unknown): string {\n  if (raw && typeof raw === 'object') {\n    const err = (raw as { error?: unknown; message?: unknown }).error\n    if (typeof err === 'string' && err.trim()) return err\n    const msg = (raw as { message?: unknown }).message\n    if (typeof msg === 'string' && msg.trim()) return msg\n  }\n  return ''\n}\n\nfunction mapStatusToReason(status: number, message: string): UploadFailureReason {\n  if (status === 413) return 'size_exceeded'\n  if (status === 403 || status === 415) return 'mime_rejected'\n  if (status === 400) {\n    const lower = message.toLowerCase()\n    if (lower.includes('file type') || lower.includes('active content')) {\n      return 'mime_rejected'\n    }\n    if (lower.includes('size') || lower.includes('quota')) {\n      return 'size_exceeded'\n    }\n  }\n  return 'server'\n}\n\nfunction parseServerItem(\n  payload: unknown,\n  fallbackFile: File,\n  inputIndex: number,\n): UploadedAttachment | null {\n  if (!payload || typeof payload !== 'object') return null\n  const item = (payload as { item?: unknown }).item\n  if (!item || typeof item !== 'object') return null\n  const id = (item as { id?: unknown }).id\n  if (typeof id !== 'string' || !id.trim()) return null\n  const fileName =\n    typeof (item as { fileName?: unknown }).fileName === 'string'\n      ? (item as { fileName: string }).fileName\n      : fallbackFile.name\n  const fileSize = (item as { fileSize?: unknown }).fileSize\n  const size =\n    typeof fileSize === 'number' && Number.isFinite(fileSize) ? fileSize : fallbackFile.size\n  const mimeTypeCandidate = (item as { mimeType?: unknown; mediaType?: unknown })\n  const mediaType =\n    typeof mimeTypeCandidate.mimeType === 'string' && mimeTypeCandidate.mimeType.trim()\n      ? mimeTypeCandidate.mimeType\n      : typeof mimeTypeCandidate.mediaType === 'string' && mimeTypeCandidate.mediaType.trim()\n        ? mimeTypeCandidate.mediaType\n        : fallbackFile.type || 'application/octet-stream'\n  return {\n    attachmentId: id,\n    fileName,\n    originalFileName: fallbackFile.name,\n    inputIndex,\n    mediaType,\n    size,\n  }\n}\n\ninterface UploadSingleArgs {\n  file: File\n  fileIndex: number\n  endpoint: string\n  entityType: string\n  recordId: string\n  partitionCode?: string\n  fetchImpl: typeof fetch\n  signal: AbortSignal\n  perFileTimeoutMs: number\n  onProgress?: UploadAttachmentsForChatOptions['onProgress']\n}\n\ntype SingleOutcome =\n  | { ok: true; item: UploadedAttachment }\n  | { ok: false; failure: UploadFailure }\n\nasync function uploadSingleFile(args: UploadSingleArgs): Promise<SingleOutcome> {\n  const {\n    file,\n    fileIndex,\n    endpoint,\n    entityType,\n    recordId,\n    partitionCode,\n    fetchImpl,\n    signal,\n    perFileTimeoutMs,\n    onProgress,\n  } = args\n\n  const buildFailure = (\n    reason: UploadFailureReason,\n    message: string,\n  ): UploadFailure => ({\n    fileName: file.name,\n    originalFileName: file.name,\n    inputIndex: fileIndex,\n    reason,\n    message,\n  })\n\n  if (signal.aborted) {\n    return {\n      ok: false,\n      failure: buildFailure('aborted', 'Upload aborted before starting.'),\n    }\n  }\n\n  const form = new FormData()\n  form.append('entityId', entityType)\n  form.append('recordId', recordId)\n  form.append('file', file)\n  if (partitionCode && partitionCode.trim().length > 0) {\n    form.append('partitionCode', partitionCode.trim())\n  }\n\n  // Per-file timeout \u2014 wired through a child AbortController that is also\n  // cancelled when the parent batch aborts. Without this guard a stalled\n  // server (slow OCR, dead connection) would leave the chip spinning\n  // forever and block the composer's Send button indefinitely.\n  const localController = new AbortController()\n  const onParentAbort = () => localController.abort()\n  signal.addEventListener('abort', onParentAbort, { once: true })\n  let timeoutHandle: ReturnType<typeof setTimeout> | null = null\n  let timedOut = false\n  if (perFileTimeoutMs > 0) {\n    timeoutHandle = setTimeout(() => {\n      timedOut = true\n      localController.abort()\n    }, perFileTimeoutMs)\n  }\n  const clearTimers = () => {\n    if (timeoutHandle !== null) {\n      clearTimeout(timeoutHandle)\n      timeoutHandle = null\n    }\n    signal.removeEventListener('abort', onParentAbort)\n  }\n\n  let response: Response\n  try {\n    response = await fetchImpl(endpoint, {\n      method: 'POST',\n      body: form,\n      signal: localController.signal,\n    })\n  } catch (networkError) {\n    clearTimers()\n    if (timedOut) {\n      return {\n        ok: false,\n        failure: buildFailure(\n          'aborted',\n          `Upload timed out after ${Math.round(perFileTimeoutMs / 1000)}s. The server did not respond \u2014 try again, or attach the file to a record first and reference it in the chat.`,\n        ),\n      }\n    }\n    const aborted =\n      signal.aborted ||\n      localController.signal.aborted ||\n      (networkError as { name?: string } | undefined)?.name === 'AbortError'\n    if (aborted) {\n      return { ok: false, failure: buildFailure('aborted', 'Upload aborted.') }\n    }\n    const message =\n      networkError instanceof Error ? networkError.message : 'Network request failed.'\n    return { ok: false, failure: buildFailure('network', message) }\n  }\n  clearTimers()\n\n  let payload: unknown = null\n  try {\n    const text = await response.text()\n    if (text && text.trim()) {\n      payload = JSON.parse(text) as unknown\n    }\n  } catch {\n    // Response may not be JSON (HTML error page, empty body, etc.)\n    payload = null\n  }\n\n  if (!response.ok) {\n    const rawMessage = normalizeServerErrorMessage(payload)\n    const fallbackMessage = rawMessage || `Upload failed (${response.status}).`\n    const reason = mapStatusToReason(response.status, rawMessage)\n    return { ok: false, failure: buildFailure(reason, fallbackMessage) }\n  }\n\n  const item = parseServerItem(payload, file, fileIndex)\n  if (!item) {\n    return {\n      ok: false,\n      failure: buildFailure(\n        'server',\n        'Attachment API returned an unexpected response shape.',\n      ),\n    }\n  }\n\n  if (onProgress) {\n    try {\n      onProgress(fileIndex, { loaded: item.size, total: item.size })\n    } catch {\n      // A misbehaving progress callback must never abort the upload pipeline.\n    }\n  }\n\n  return { ok: true, item }\n}\n\n/**\n * Uploads files in parallel (bounded to `concurrency`, default 3) via the\n * attachments API and pairs the returned IDs back to the input order.\n *\n * The batch promise only rejects on programming errors \u2014 server rejections,\n * network errors, and aborts are surfaced via {@link UploadAttachmentsForChatResult.failed}\n * so the caller can render chips and retry UX without try/catch noise.\n */\nexport async function uploadAttachmentsForChat(\n  files: File[],\n  options: UploadAttachmentsForChatOptions = {},\n): Promise<UploadAttachmentsForChatResult> {\n  const items: UploadedAttachment[] = []\n  const failed: UploadFailure[] = []\n  if (!Array.isArray(files) || files.length === 0) {\n    return { items, failed }\n  }\n\n  const fetchImpl = resolveFetchImpl(options.fetchImpl)\n  const endpoint = options.endpoint?.trim() || DEFAULT_ATTACHMENTS_ENDPOINT\n  const entityType = options.entityType?.trim() || DEFAULT_AI_CHAT_ENTITY_ID\n  const recordId = options.recordId?.trim() || mintRecordId()\n  const rawConcurrency = options.concurrency ?? DEFAULT_CONCURRENCY\n  const concurrency = Math.max(\n    1,\n    Math.min(files.length, Math.floor(rawConcurrency) || DEFAULT_CONCURRENCY),\n  )\n  const signal = options.signal ?? new AbortController().signal\n  const perFileTimeoutMs = (() => {\n    const raw = options.perFileTimeoutMs\n    if (raw === 0) return 0\n    if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) return raw\n    return DEFAULT_PER_FILE_TIMEOUT_MS\n  })()\n\n  const outcomes: Array<SingleOutcome | null> = new Array(files.length).fill(null)\n  let nextIndex = 0\n\n  const worker = async (): Promise<void> => {\n    while (true) {\n      if (signal.aborted) return\n      const currentIndex = nextIndex\n      if (currentIndex >= files.length) return\n      nextIndex = currentIndex + 1\n      const file = files[currentIndex]\n      outcomes[currentIndex] = await uploadSingleFile({\n        file,\n        fileIndex: currentIndex,\n        endpoint,\n        entityType,\n        recordId,\n        partitionCode: options.partitionCode,\n        fetchImpl,\n        signal,\n        perFileTimeoutMs,\n        onProgress: options.onProgress,\n      })\n    }\n  }\n\n  const workerCount = Math.min(concurrency, files.length)\n  const workers = Array.from({ length: workerCount }, () => worker())\n  await Promise.all(workers)\n\n  for (let index = 0; index < files.length; index += 1) {\n    const outcome = outcomes[index]\n    if (outcome && outcome.ok) {\n      items.push(outcome.item)\n      continue\n    }\n    if (outcome && !outcome.ok) {\n      failed.push(outcome.failure)\n      continue\n    }\n    // Worker exited without processing this slot \u2192 it was skipped due to abort.\n    const file = files[index]\n    const fallbackName = file?.name ?? `file-${index}`\n    failed.push({\n      fileName: fallbackName,\n      originalFileName: fallbackName,\n      inputIndex: index,\n      reason: 'aborted',\n      message: 'Upload aborted before starting.',\n    })\n  }\n\n  return { items, failed }\n}\n\nexport const __testables = {\n  DEFAULT_ATTACHMENTS_ENDPOINT,\n  DEFAULT_AI_CHAT_ENTITY_ID,\n  DEFAULT_CONCURRENCY,\n  DEFAULT_PER_FILE_TIMEOUT_MS,\n  mapStatusToReason,\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/ai/useAiChat.js

@@ -0,0 +1,549 @@
+"use client";
+import * as React from "react";
+import { createAiAgentTransport } from "@open-mercato/ai-assistant/modules/ai_assistant/lib/agent-transport";
+import { apiFetch } from "../backend/utils/api.js";
+function makeMessageId() {
+  const random = Math.random().toString(36).slice(2, 10);
+  const time = Date.now().toString(36);
+  return `msg_${time}_${random}`;
+}
+function makeConversationId() {
+  const g = globalThis;
+  if (g.crypto && typeof g.crypto.randomUUID === "function") {
+    try {
+      return g.crypto.randomUUID();
+    } catch {
+    }
+  }
+  const rand = () => Math.random().toString(16).slice(2, 10);
+  return `conv_${Date.now().toString(16)}_${rand()}${rand()}`;
+}
+const SESSION_STORAGE_PREFIX = "om-ai-chat:";
+const SESSION_STORAGE_VERSION = 1;
+function getSessionStorageKey(agent, conversationId) {
+  if (typeof conversationId === "string" && conversationId.length > 0) {
+    return `${SESSION_STORAGE_PREFIX}${agent}:${conversationId}`;
+  }
+  return `${SESSION_STORAGE_PREFIX}${agent}`;
+}
+function readPersistedSession(agent, conversationId) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(getSessionStorageKey(agent, conversationId));
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed || parsed.v !== SESSION_STORAGE_VERSION) return null;
+    if (typeof parsed.conversationId !== "string") return null;
+    if (!Array.isArray(parsed.messages)) return null;
+    const messages = parsed.messages.filter((entry) => {
+      return !!entry && typeof entry === "object" && typeof entry.id === "string" && typeof entry.content === "string" && (entry.role === "user" || entry.role === "assistant");
+    });
+    return { v: SESSION_STORAGE_VERSION, conversationId: parsed.conversationId, messages };
+  } catch {
+    return null;
+  }
+}
+function writePersistedSession(agent, session, conversationId) {
+  if (typeof window === "undefined") return;
+  try {
+    const messages = session.messages.map((message) => {
+      if (!message.files || message.files.length === 0) return message;
+      const safeFiles = message.files.map(({ name, type, previewUrl }) => {
+        const durable = typeof previewUrl === "string" && previewUrl.startsWith("data:") ? previewUrl : void 0;
+        return durable ? { name, type, previewUrl: durable } : { name, type };
+      });
+      return { ...message, files: safeFiles };
+    });
+    window.localStorage.setItem(
+      getSessionStorageKey(agent, conversationId),
+      JSON.stringify({ ...session, messages })
+    );
+  } catch {
+  }
+}
+function clearPersistedSession(agent, conversationId) {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.removeItem(getSessionStorageKey(agent, conversationId));
+  } catch {
+  }
+}
+function getTransportEndpoint(agent, apiPath) {
+  const transport = createAiAgentTransport({ agentId: agent, endpoint: apiPath });
+  void transport;
+  const base = apiPath && apiPath.length > 0 ? apiPath : "/api/ai_assistant/ai/chat";
+  const separator = base.includes("?") ? "&" : "?";
+  return `${base}${separator}agent=${encodeURIComponent(agent)}`;
+}
+function createBuilder() {
+  return { text: "", reasoning: "", reasoningStreaming: false, toolCalls: [], uiParts: [] };
+}
+function extractUiPartsFromOutput(output, toolCallId) {
+  let parsed = output;
+  if (typeof output === "string") {
+    const trimmed = output.trim();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return [];
+    try {
+      parsed = JSON.parse(trimmed);
+    } catch {
+      return [];
+    }
+  }
+  if (!parsed || typeof parsed !== "object") return [];
+  const value = parsed;
+  const parts = [];
+  if (value.status === "pending-confirmation" || value.status === "awaiting-confirmation") {
+    const pendingActionId = typeof value.pendingActionId === "string" && value.pendingActionId.length > 0 ? value.pendingActionId : null;
+    if (pendingActionId) {
+      const agentId = typeof value.agentId === "string" ? value.agentId : typeof value.agent === "string" ? value.agent : void 0;
+      parts.push({
+        componentId: "mutation-preview-card",
+        pendingActionId,
+        payload: {
+          pendingActionId,
+          expiresAt: typeof value.expiresAt === "string" ? value.expiresAt : void 0,
+          agentId,
+          toolName: typeof value.toolName === "string" ? value.toolName : void 0
+        },
+        key: `${toolCallId}:mutation-preview-card`
+      });
+    }
+  }
+  if (value.uiPart && typeof value.uiPart === "object") {
+    const part = value.uiPart;
+    if (typeof part.componentId === "string" && part.componentId.length > 0) {
+      parts.push({
+        componentId: part.componentId,
+        payload: part.payload,
+        pendingActionId: typeof part.pendingActionId === "string" ? part.pendingActionId : void 0,
+        key: `${toolCallId}:${part.componentId}`
+      });
+    }
+  }
+  if (Array.isArray(value.uiParts)) {
+    value.uiParts.forEach((entry, index) => {
+      if (!entry || typeof entry !== "object") return;
+      const part = entry;
+      if (typeof part.componentId !== "string" || part.componentId.length === 0) return;
+      parts.push({
+        componentId: part.componentId,
+        payload: part.payload,
+        pendingActionId: typeof part.pendingActionId === "string" ? part.pendingActionId : void 0,
+        key: `${toolCallId}:${index}:${part.componentId}`
+      });
+    });
+  }
+  return parts;
+}
+function updateToolCall(state, id, patch) {
+  if (!id) return state;
+  const idx = state.toolCalls.findIndex((entry) => entry.id === id);
+  if (idx === -1) {
+    const next = {
+      id,
+      toolName: patch.toolName ?? "tool",
+      state: patch.state ?? "pending",
+      input: patch.input,
+      output: patch.output,
+      errorMessage: patch.errorMessage
+    };
+    return { ...state, toolCalls: [...state.toolCalls, next] };
+  }
+  const current = state.toolCalls[idx];
+  const merged = {
+    ...current,
+    toolName: patch.toolName ?? current.toolName,
+    state: patch.state ?? current.state,
+    input: patch.input !== void 0 ? patch.input : current.input,
+    output: patch.output !== void 0 ? patch.output : current.output,
+    errorMessage: patch.errorMessage ?? current.errorMessage
+  };
+  const nextCalls = state.toolCalls.slice();
+  nextCalls[idx] = merged;
+  return { ...state, toolCalls: nextCalls };
+}
+function applyChunk(state, chunk) {
+  switch (chunk.type) {
+    case "text-delta":
+      return {
+        ...state,
+        text: state.text + (typeof chunk.delta === "string" ? chunk.delta : "")
+      };
+    case "reasoning-start":
+      return { ...state, reasoningStreaming: true };
+    case "reasoning-delta":
+      return {
+        ...state,
+        reasoning: state.reasoning + (typeof chunk.delta === "string" ? chunk.delta : ""),
+        reasoningStreaming: true
+      };
+    case "reasoning-end":
+      return { ...state, reasoningStreaming: false };
+    case "tool-input-start":
+      return updateToolCall(state, String(chunk.toolCallId ?? ""), {
+        toolName: typeof chunk.toolName === "string" ? chunk.toolName : void 0,
+        state: "pending"
+      });
+    case "tool-input-available":
+      return updateToolCall(state, String(chunk.toolCallId ?? ""), {
+        toolName: typeof chunk.toolName === "string" ? chunk.toolName : void 0,
+        input: chunk.input,
+        state: "pending"
+      });
+    case "tool-output-available": {
+      const toolCallId = String(chunk.toolCallId ?? "");
+      const next = updateToolCall(state, toolCallId, {
+        output: chunk.output,
+        state: "complete"
+      });
+      const newParts = extractUiPartsFromOutput(chunk.output, toolCallId);
+      if (newParts.length === 0) return next;
+      const seen = new Set(next.uiParts.map((entry) => entry.key));
+      const merged = [...next.uiParts];
+      for (const part of newParts) {
+        if (seen.has(part.key)) continue;
+        seen.add(part.key);
+        merged.push(part);
+      }
+      if (merged.length === next.uiParts.length) return next;
+      return { ...next, uiParts: merged };
+    }
+    case "tool-output-error":
+      return updateToolCall(state, String(chunk.toolCallId ?? ""), {
+        state: "error",
+        errorMessage: typeof chunk.errorText === "string" ? chunk.errorText : "Tool error"
+      });
+    case "tool-input-error":
+      return updateToolCall(state, String(chunk.toolCallId ?? ""), {
+        toolName: typeof chunk.toolName === "string" ? chunk.toolName : void 0,
+        input: chunk.input,
+        state: "error",
+        errorMessage: typeof chunk.errorText === "string" ? chunk.errorText : "Tool error"
+      });
+    default:
+      return state;
+  }
+}
+function mergeAssistantMessage(current, state) {
+  return {
+    ...current,
+    content: state.text,
+    reasoning: state.reasoning ? state.reasoning : void 0,
+    reasoningStreaming: state.reasoning ? state.reasoningStreaming : void 0,
+    toolCalls: state.toolCalls.length > 0 ? state.toolCalls : void 0,
+    uiParts: state.uiParts.length > 0 ? state.uiParts : void 0
+  };
+}
+function parseSseLines(buffer) {
+  const events = [];
+  let rest = buffer;
+  for (; ; ) {
+    const idx = rest.indexOf("\n\n");
+    if (idx === -1) break;
+    events.push(rest.slice(0, idx));
+    rest = rest.slice(idx + 2);
+  }
+  return { events, rest };
+}
+function extractDataPayload(eventBlock) {
+  const lines = eventBlock.split("\n");
+  const dataLines = [];
+  for (const line of lines) {
+    if (line.startsWith("data: ")) {
+      dataLines.push(line.slice(6));
+    } else if (line.startsWith("data:")) {
+      dataLines.push(line.slice(5));
+    }
+  }
+  if (dataLines.length === 0) return null;
+  return dataLines.join("\n");
+}
+async function readErrorEnvelope(response) {
+  try {
+    const data = await response.clone().json();
+    if (data && typeof data === "object") {
+      const rawMessage = typeof data.error === "string" && data.error || typeof data.message === "string" && data.message || "";
+      const rawCode = typeof data.code === "string" ? data.code : void 0;
+      if (rawMessage || rawCode) {
+        return {
+          code: rawCode,
+          message: rawMessage || "Agent dispatch failed."
+        };
+      }
+    }
+  } catch {
+  }
+  const text = await response.text().catch(() => "");
+  return { message: text || `Agent dispatch failed (${response.status}).` };
+}
+function useAiChat(input) {
+  const { agent, apiPath, pageContext, attachmentIds, debug, initialMessages, onError, conversationId: conversationIdInput } = input;
+  const persistedRef = React.useRef("unread");
+  if (persistedRef.current === "unread") {
+    persistedRef.current = typeof conversationIdInput === "string" && conversationIdInput.length > 0 ? readPersistedSession(agent, conversationIdInput) : readPersistedSession(agent);
+  }
+  const persisted = persistedRef.current;
+  const mintedConversationIdRef = React.useRef(null);
+  if (mintedConversationIdRef.current === null) {
+    mintedConversationIdRef.current = persisted?.conversationId ?? makeConversationId();
+  }
+  const effectiveConversationId = typeof conversationIdInput === "string" && conversationIdInput.length > 0 ? conversationIdInput : mintedConversationIdRef.current;
+  const [messages, setMessages] = React.useState(() => {
+    if (persisted && persisted.messages.length > 0) {
+      return persisted.messages;
+    }
+    return (initialMessages ?? []).map((entry) => ({
+      id: makeMessageId(),
+      role: entry.role,
+      content: entry.content
+    }));
+  });
+  const [status, setStatusInternal] = React.useState("idle");
+  React.useEffect(() => {
+    if (status !== "idle") return;
+    const persistKey = typeof conversationIdInput === "string" && conversationIdInput.length > 0 ? conversationIdInput : null;
+    if (messages.length === 0) {
+      clearPersistedSession(agent, persistKey);
+      return;
+    }
+    writePersistedSession(
+      agent,
+      {
+        v: SESSION_STORAGE_VERSION,
+        conversationId: effectiveConversationId,
+        messages
+      },
+      persistKey
+    );
+  }, [agent, conversationIdInput, effectiveConversationId, messages, status]);
+  const setStatus = setStatusInternal;
+  const [error, setError] = React.useState(null);
+  const [lastRequestDebug, setLastRequestDebug] = React.useState(null);
+  const [lastResponseDebug, setLastResponseDebug] = React.useState(null);
+  const abortRef = React.useRef(null);
+  const onErrorRef = React.useRef(onError);
+  React.useEffect(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  const emitError = React.useCallback((envelope) => {
+    setError(envelope);
+    try {
+      onErrorRef.current?.(envelope);
+    } catch {
+    }
+  }, []);
+  const cancel = React.useCallback(() => {
+    if (abortRef.current) {
+      abortRef.current.abort();
+      abortRef.current = null;
+    }
+    setStatus("idle");
+  }, []);
+  const reset = React.useCallback(() => {
+    cancel();
+    setMessages([]);
+    setError(null);
+    setLastRequestDebug(null);
+    setLastResponseDebug(null);
+    clearPersistedSession(agent);
+    mintedConversationIdRef.current = makeConversationId();
+  }, [agent, cancel]);
+  const sendMessage = React.useCallback(
+    async (textInput, files) => {
+      const trimmed = textInput.trim();
+      if (!trimmed) return;
+      if (abortRef.current) {
+        abortRef.current.abort();
+      }
+      setError(null);
+      const userMessage = {
+        id: makeMessageId(),
+        role: "user",
+        content: trimmed,
+        files: files && files.length > 0 ? files : void 0
+      };
+      const assistantMessage = {
+        id: makeMessageId(),
+        role: "assistant",
+        content: ""
+      };
+      const assistantId = assistantMessage.id;
+      const outgoingHistory = [...messages, userMessage];
+      setMessages([...outgoingHistory, assistantMessage]);
+      setStatus("submitting");
+      const controller = new AbortController();
+      abortRef.current = controller;
+      const url = getTransportEndpoint(agent, apiPath);
+      const body = {
+        messages: outgoingHistory.map((message) => ({
+          role: message.role,
+          content: message.content
+        })),
+        pageContext,
+        attachmentIds,
+        debug,
+        conversationId: effectiveConversationId
+      };
+      setLastRequestDebug({ url, body });
+      let response;
+      try {
+        response = await apiFetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "text/event-stream, text/plain, application/json"
+          },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+      } catch (requestError) {
+        if (requestError?.name === "AbortError") {
+          setStatus("idle");
+          abortRef.current = null;
+          return;
+        }
+        const message = requestError instanceof Error ? requestError.message : "Network request failed.";
+        emitError({ message });
+        setStatus("idle");
+        abortRef.current = null;
+        return;
+      }
+      if (!response.ok) {
+        const envelope = await readErrorEnvelope(response);
+        setLastResponseDebug({ status: response.status, text: envelope.message });
+        emitError(envelope);
+        setStatus("idle");
+        setMessages((current) => current.filter((entry) => entry.id !== assistantId));
+        abortRef.current = null;
+        return;
+      }
+      const bodyStream = response.body;
+      if (!bodyStream) {
+        setLastResponseDebug({ status: response.status, text: "" });
+        setStatus("idle");
+        abortRef.current = null;
+        return;
+      }
+      const headerGet = (name) => {
+        const headers = response.headers;
+        if (!headers || typeof headers.get !== "function") return null;
+        try {
+          return headers.get(name);
+        } catch {
+          return null;
+        }
+      };
+      const isUiMessageStream = headerGet("x-vercel-ai-ui-message-stream") !== null || (headerGet("content-type") ?? "").includes("event-stream");
+      setStatus("streaming");
+      const reader = bodyStream.getReader();
+      const decoder = new TextDecoder();
+      let streamedRaw = "";
+      let builder = createBuilder();
+      let sseBuffer = "";
+      const flushUiMessageBuffer = (extra) => {
+        if (extra) sseBuffer += extra;
+        const { events, rest } = parseSseLines(sseBuffer);
+        sseBuffer = rest;
+        for (const block of events) {
+          const data = extractDataPayload(block);
+          if (!data) continue;
+          if (data === "[DONE]") continue;
+          try {
+            const parsed = JSON.parse(data);
+            if (parsed && typeof parsed.type === "string") {
+              builder = applyChunk(builder, parsed);
+            }
+          } catch {
+          }
+        }
+      };
+      try {
+        while (true) {
+          const { value, done } = await reader.read();
+          if (done) break;
+          if (!value) continue;
+          const piece = decoder.decode(value, { stream: true });
+          if (!piece) continue;
+          streamedRaw += piece;
+          if (isUiMessageStream) {
+            flushUiMessageBuffer(piece);
+          } else {
+            builder = { ...builder, text: streamedRaw };
+          }
+          const snapshotBuilder = builder;
+          setMessages(
+            (current) => current.map(
+              (entry) => entry.id === assistantId ? mergeAssistantMessage(entry, snapshotBuilder) : entry
+            )
+          );
+        }
+        const tail = decoder.decode();
+        if (tail) {
+          streamedRaw += tail;
+          if (isUiMessageStream) {
+            flushUiMessageBuffer(tail);
+          } else {
+            builder = { ...builder, text: streamedRaw };
+          }
+        }
+        if (isUiMessageStream && sseBuffer.length > 0) {
+          flushUiMessageBuffer("\n\n");
+        }
+        builder = { ...builder, reasoningStreaming: false };
+        const finalSnapshot = builder;
+        setMessages(
+          (current) => current.map(
+            (entry) => entry.id === assistantId ? mergeAssistantMessage(entry, finalSnapshot) : entry
+          )
+        );
+        setLastResponseDebug({ status: response.status, text: streamedRaw });
+        const isEmpty = !builder.text.trim() && builder.toolCalls.length === 0 && !builder.reasoning;
+        if (isEmpty) {
+          emitError({
+            code: "empty_response",
+            message: "The AI agent returned an empty response. This usually means the LLM provider rejected the request (invalid API key, rate limit, or model error). Check your server logs for details."
+          });
+          setMessages((current) => current.filter((entry) => entry.id !== assistantId));
+        }
+      } catch (streamError) {
+        if (streamError?.name === "AbortError") {
+        } else {
+          const rawMessage = streamError instanceof Error ? streamError.message : "Stream interrupted.";
+          const message = rawMessage.includes("API") ? rawMessage : `${rawMessage} \u2014 check server logs for LLM provider details.`;
+          emitError({ code: "stream_error", message });
+          setMessages((current) => current.filter((entry) => entry.id !== assistantId));
+        }
+      } finally {
+        reader.releaseLock();
+        if (abortRef.current === controller) {
+          abortRef.current = null;
+        }
+        setStatus("idle");
+      }
+    },
+    [agent, apiPath, attachmentIds, debug, effectiveConversationId, emitError, messages, pageContext]
+  );
+  React.useEffect(() => {
+    return () => {
+      if (abortRef.current) {
+        abortRef.current.abort();
+        abortRef.current = null;
+      }
+    };
+  }, []);
+  return {
+    messages,
+    status,
+    error,
+    lastRequestDebug,
+    lastResponseDebug,
+    conversationId: effectiveConversationId,
+    sendMessage,
+    cancel,
+    reset
+  };
+}
+export {
+  useAiChat
+};
+//# sourceMappingURL=useAiChat.js.map