@laintern/chat-sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,538 @@
+'use strict';
+
+// src/errors.ts
+var LainternError = class extends Error {
+  code;
+  status;
+  /** Set on RATE_LIMIT_EXCEEDED. */
+  rateLimitScope;
+  rateLimitWindow;
+  /** Set on MCP_UNAVAILABLE: which dependency failed, and how. */
+  reason;
+  constructor(code, message, options = {}) {
+    super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "LainternError";
+    this.code = code;
+    this.status = options.status ?? null;
+    if (options.rateLimitScope) this.rateLimitScope = options.rateLimitScope;
+    if (options.rateLimitWindow) this.rateLimitWindow = options.rateLimitWindow;
+    if (options.reason) this.reason = options.reason;
+  }
+  /**
+   * True when retrying later could plausibly succeed: a rate limit, or a
+   * dependency the server could not reach. An expired session is NOT retryable
+   * — the host has to mint a new token first.
+   */
+  get isRetryable() {
+    return this.code === "RATE_LIMIT_EXCEEDED" || this.reason === "transport";
+  }
+};
+function pick(value, allowed) {
+  return typeof value === "string" && allowed.includes(value) ? value : void 0;
+}
+async function errorFromResponse(response) {
+  let code = `HTTP_${response.status}`;
+  let message = "An unexpected error occurred.";
+  let rateLimitScope;
+  let rateLimitWindow;
+  let reason;
+  try {
+    const body = await response.json();
+    if (body?.error?.code) {
+      code = body.error.code;
+      message = body.error.message ?? message;
+      rateLimitScope = pick(body.error.scope, ["user", "agent"]);
+      rateLimitWindow = pick(body.error.window, ["minute", "hour", "day"]);
+      if (typeof body.error.reason === "string") reason = body.error.reason;
+    } else if (typeof body?.message === "string") {
+      message = body.message;
+    }
+  } catch {
+  }
+  return new LainternError(code, message, {
+    status: response.status,
+    rateLimitScope,
+    rateLimitWindow,
+    reason
+  });
+}
+
+// src/sse.ts
+var DONE = "[DONE]";
+async function* parseSSE(response) {
+  const reader = response.body?.getReader();
+  if (!reader) throw new Error("Response body is not readable");
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let sepIndex;
+      while ((sepIndex = indexOfFrameBoundary(buffer)) !== -1) {
+        const frame = buffer.slice(0, sepIndex);
+        buffer = buffer.slice(boundaryEnd(buffer, sepIndex));
+        const parsed2 = parseFrame(frame);
+        if (parsed2 === DONE) return;
+        if (parsed2) yield parsed2;
+      }
+    }
+    const parsed = parseFrame(buffer);
+    if (parsed && parsed !== DONE) yield parsed;
+  } finally {
+    reader.releaseLock();
+  }
+}
+function indexOfFrameBoundary(buffer) {
+  const lf = buffer.indexOf("\n\n");
+  const crlf = buffer.indexOf("\r\n\r\n");
+  if (lf === -1) return crlf;
+  if (crlf === -1) return lf;
+  return Math.min(lf, crlf);
+}
+function boundaryEnd(buffer, index) {
+  return buffer.startsWith("\r\n\r\n", index) ? index + 4 : index + 2;
+}
+function parseFrame(frame) {
+  const trimmed = frame.trim();
+  if (!trimmed) return null;
+  const dataLines = [];
+  for (const rawLine of trimmed.split("\n")) {
+    const line = rawLine.replace(/\r$/, "");
+    if (line.startsWith(":")) continue;
+    if (!line.startsWith("data:")) continue;
+    dataLines.push(line.slice(5).replace(/^ /, ""));
+  }
+  if (dataLines.length === 0) return null;
+  const payload = dataLines.join("\n");
+  if (payload === DONE) return DONE;
+  try {
+    return JSON.parse(payload);
+  } catch {
+    return null;
+  }
+}
+
+// src/tokens.ts
+var DEFAULT_REFRESH_BUFFER_MS = 6e4;
+var FALLBACK_TTL_MS = 5 * 60 * 1e3;
+var DRIFT_WARN_THRESHOLD_MS = 5 * 60 * 1e3;
+function decodeJwtExpiryMs(token) {
+  try {
+    const parts = token.split(".");
+    if (parts.length < 2) return null;
+    const padded = parts[1].replace(/-/g, "+").replace(/_/g, "/");
+    if (typeof atob !== "function") return null;
+    const json = JSON.parse(atob(padded));
+    return typeof json.exp === "number" ? json.exp * 1e3 : null;
+  } catch {
+    return null;
+  }
+}
+function toEpochMs(value) {
+  if (value == null) return null;
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  const parsed = Date.parse(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+function resolveExpiry(token, reportedExpiresAt, onWarning) {
+  const jwtExpMs = decodeJwtExpiryMs(token);
+  const reported = toEpochMs(reportedExpiresAt);
+  if (jwtExpMs !== null) {
+    if (reported !== null && Math.abs(reported - jwtExpMs) > DRIFT_WARN_THRESHOLD_MS) {
+      onWarning?.(
+        "Token endpoint 'expires_at' drifts more than 5 minutes from the JWT 'exp'; using the JWT claim.",
+        { jwtExpMs, reportedExpiresAtMs: reported, driftMs: reported - jwtExpMs }
+      );
+    }
+    return jwtExpMs;
+  }
+  if (reported !== null) return reported;
+  onWarning?.(
+    "Token has no readable 'exp' claim and the endpoint reported no expiry; caching for 5 minutes."
+  );
+  return Date.now() + FALLBACK_TTL_MS;
+}
+function createTokenManager(options) {
+  const buffer = options.refreshBufferMs ?? DEFAULT_REFRESH_BUFFER_MS;
+  const storage = options.storage;
+  const storageKey = options.storageKey ?? "laintern.token";
+  let cached = readStored();
+  let inFlight = null;
+  function readStored() {
+    if (!storage) return null;
+    try {
+      const raw = storage.getItem(storageKey);
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.token !== "string" || typeof parsed.expiresAt !== "number") {
+        return null;
+      }
+      return { token: parsed.token, expiresAt: parsed.expiresAt };
+    } catch {
+      return null;
+    }
+  }
+  function writeStored(value) {
+    if (!storage) return;
+    try {
+      if (value === null) storage.removeItem(storageKey);
+      else storage.setItem(storageKey, JSON.stringify(value));
+    } catch {
+    }
+  }
+  function isUsable(value) {
+    return value !== null && Date.now() < value.expiresAt - buffer;
+  }
+  async function refresh() {
+    let result;
+    try {
+      result = await options.fetchToken();
+    } catch (err) {
+      throw new LainternError("TOKEN_FETCH_FAILED", "Could not obtain a chat token.", {
+        cause: err
+      });
+    }
+    const response = typeof result === "string" ? { token: result } : result;
+    if (!response || typeof response.token !== "string" || response.token.length === 0) {
+      throw new LainternError(
+        "TOKEN_INVALID",
+        "Token endpoint returned no 'token' string."
+      );
+    }
+    const next = {
+      token: response.token,
+      expiresAt: resolveExpiry(response.token, response.expiresAt, options.onWarning)
+    };
+    cached = next;
+    writeStored(next);
+    return next.token;
+  }
+  return {
+    async get() {
+      if (isUsable(cached)) return cached.token;
+      if (!inFlight) {
+        inFlight = refresh().finally(() => {
+          inFlight = null;
+        });
+      }
+      return inFlight;
+    },
+    clear() {
+      cached = null;
+      writeStored(null);
+    },
+    expiresAt() {
+      return cached?.expiresAt ?? null;
+    }
+  };
+}
+
+// src/client.ts
+function tokenFetcher(option, doFetch) {
+  if (typeof option === "function") return option;
+  return async () => {
+    const res = await doFetch(option.endpoint, {
+      method: "POST",
+      credentials: "same-origin",
+      headers: { "Content-Type": "application/json" },
+      ...option.init
+    });
+    if (!res.ok) throw await errorFromResponse(res);
+    const body = await res.json();
+    const payload = body.data ?? body ?? {};
+    return {
+      token: payload.token,
+      expiresAt: payload.expires_at ?? null
+    };
+  };
+}
+function createLainternClient(options) {
+  const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const apiBase = options.apiBase.replace(/\/+$/, "");
+  const tokens = createTokenManager({
+    fetchToken: tokenFetcher(options.token, doFetch),
+    storage: options.storage,
+    ...options.refreshBufferMs !== void 0 ? { refreshBufferMs: options.refreshBufferMs } : {},
+    ...options.onWarning ? { onWarning: options.onWarning } : {}
+  });
+  async function authorized(path, init = {}) {
+    const token = await tokens.get();
+    return doFetch(`${apiBase}${path}`, {
+      ...init,
+      headers: {
+        "Content-Type": "application/json",
+        ...init.headers,
+        Authorization: `Bearer ${token}`
+      }
+    });
+  }
+  return {
+    tokens,
+    async *sendMessage(message, sendOptions = {}) {
+      const body = { message };
+      if (sendOptions.sessionId) body.session_id = sendOptions.sessionId;
+      if (sendOptions.images?.length) body.images = sendOptions.images;
+      if (sendOptions.forceTool) body.force_tool = sendOptions.forceTool;
+      let response;
+      try {
+        response = await authorized("/v1/chat", {
+          method: "POST",
+          body: JSON.stringify(body),
+          ...sendOptions.signal ? { signal: sendOptions.signal } : {}
+        });
+      } catch (err) {
+        if (err instanceof LainternError) throw err;
+        if (err?.name === "AbortError") throw err;
+        throw new LainternError(
+          "NETWORK_ERROR",
+          err instanceof Error ? err.message : "Network request failed.",
+          { cause: err }
+        );
+      }
+      if (!response.ok) {
+        const error = await errorFromResponse(response);
+        if (response.status === 401) tokens.clear();
+        throw error;
+      }
+      yield* parseSSE(response);
+    },
+    async getConfig() {
+      const res = await authorized("/v1/config", { method: "GET" });
+      if (!res.ok) throw await errorFromResponse(res);
+      const body = await res.json();
+      const payload = body.data ?? body ?? {};
+      const raw = payload.disclaimer;
+      return {
+        disclaimer: {
+          enabled: raw?.enabled !== false,
+          text: typeof raw?.text === "string" && raw.text.trim().length > 0 ? raw.text : null
+        }
+      };
+    },
+    async submitFeedback(messageId, feedback) {
+      const res = await authorized(`/v1/chat/messages/${messageId}/feedback`, {
+        method: "PATCH",
+        body: JSON.stringify({ feedback })
+      });
+      if (!res.ok) throw await errorFromResponse(res);
+    }
+  };
+}
+
+// src/conversation.ts
+function newId() {
+  const c = globalThis.crypto;
+  if (c && typeof c.randomUUID === "function") return c.randomUUID();
+  return `turn-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function createTurn(message, images) {
+  return {
+    id: newId(),
+    userMessage: message,
+    ...images?.length ? { userImages: images } : {},
+    assistantContent: "",
+    citations: /* @__PURE__ */ new Map(),
+    sources: [],
+    externalSources: {},
+    mode: null,
+    steps: [],
+    isStreaming: true
+  };
+}
+function createConversation(client, options = {}) {
+  let state = {
+    turns: options.initialTurns ?? [],
+    sessionId: options.sessionId ?? null,
+    isStreaming: false
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  let controller = null;
+  function emit(next) {
+    state = next;
+    for (const listener of listeners) listener(state);
+  }
+  function patchLast(patch) {
+    const lastIndex = state.turns.length - 1;
+    if (lastIndex < 0) return;
+    const turns = [...state.turns];
+    turns[lastIndex] = patch(turns[lastIndex]);
+    emit({ ...state, turns });
+  }
+  return {
+    getState: () => state,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    abort() {
+      controller?.abort();
+    },
+    reset() {
+      controller?.abort();
+      emit({ turns: [], sessionId: null, isStreaming: false });
+    },
+    async send(message, sendOptions = {}) {
+      controller?.abort();
+      controller = new AbortController();
+      const signal = controller.signal;
+      emit({
+        ...state,
+        turns: [...state.turns, createTurn(message, sendOptions.images)],
+        isStreaming: true
+      });
+      try {
+        const stream = client.sendMessage(message, {
+          sessionId: state.sessionId,
+          ...sendOptions.images ? { images: sendOptions.images } : {},
+          ...sendOptions.forceTool ? { forceTool: sendOptions.forceTool } : {},
+          signal
+        });
+        for await (const event of stream) {
+          if (signal.aborted) break;
+          switch (event.type) {
+            case "session":
+              emit({ ...state, sessionId: event.session_id });
+              options.onSessionId?.(event.session_id);
+              break;
+            case "mode":
+              patchLast((turn) => ({ ...turn, mode: event.mode }));
+              break;
+            case "step":
+              patchLast((turn) => ({ ...turn, steps: mergeStep(turn.steps, event.step) }));
+              break;
+            case "delta":
+              patchLast((turn) => ({
+                ...turn,
+                assistantContent: turn.assistantContent + event.content
+              }));
+              break;
+            case "citation":
+              patchLast((turn) => {
+                const citations = new Map(turn.citations);
+                citations.set(event.index, event.source);
+                return { ...turn, citations };
+              });
+              break;
+            case "sources":
+              patchLast((turn) => ({ ...turn, sources: event.items }));
+              break;
+            case "external_sources":
+              patchLast((turn) => ({
+                ...turn,
+                externalSources: {
+                  ...turn.externalSources,
+                  [event.source_type]: event.items
+                }
+              }));
+              break;
+            case "advisory":
+              patchLast((turn) => ({
+                ...turn,
+                advisory: { redirect: event.redirect ?? null, message: event.message }
+              }));
+              break;
+            case "done":
+              patchLast((turn) => ({
+                ...turn,
+                isStreaming: false,
+                ...event.message_id ? { messageId: event.message_id } : {}
+              }));
+              emit({ ...state, isStreaming: false });
+              break;
+            case "error":
+              applyFailure(patchLast, {
+                code: event.code,
+                message: event.message,
+                guardrailSlug: event.guardrail_slug ?? null
+              });
+              break;
+          }
+        }
+      } catch (err) {
+        if (err?.name === "AbortError") {
+          patchLast((turn) => ({ ...turn, isStreaming: false }));
+        } else if (err instanceof LainternError) {
+          applyFailure(patchLast, {
+            code: err.code,
+            message: err.message,
+            guardrailSlug: null,
+            ...err.rateLimitScope ? { rateLimitScope: err.rateLimitScope } : {},
+            ...err.rateLimitWindow ? { rateLimitWindow: err.rateLimitWindow } : {}
+          });
+        } else {
+          applyFailure(patchLast, {
+            code: "NETWORK_ERROR",
+            message: err instanceof Error ? err.message : "An unknown error occurred.",
+            guardrailSlug: null
+          });
+        }
+      } finally {
+        const last = state.turns.at(-1);
+        if (last?.isStreaming) patchLast((turn) => ({ ...turn, isStreaming: false }));
+        if (state.isStreaming) emit({ ...state, isStreaming: false });
+        controller = null;
+      }
+    },
+    async setFeedback(turnId, feedback) {
+      const turn = state.turns.find((t) => t.id === turnId);
+      if (!turn?.messageId) {
+        throw new LainternError(
+          "FEEDBACK_UNAVAILABLE",
+          "This turn has no message id yet \u2014 feedback is only possible once a turn completes."
+        );
+      }
+      await client.submitFeedback(turn.messageId, feedback);
+      emit({
+        ...state,
+        turns: state.turns.map((t) => t.id === turnId ? { ...t, feedback } : t)
+      });
+    }
+  };
+}
+function mergeStep(steps, step) {
+  if (step.status !== "completed") return [...steps, step];
+  const startedIndex = steps.findIndex((s) => s.tool === step.tool && s.status === "started");
+  if (startedIndex === -1) return [...steps, step];
+  const next = [...steps];
+  next[startedIndex] = step;
+  return next;
+}
+function applyFailure(patchLast, failure) {
+  if (failure.code === "GUARDRAIL_TRIGGERED") {
+    patchLast((turn) => ({
+      ...turn,
+      isStreaming: false,
+      assistantContent: "",
+      citations: /* @__PURE__ */ new Map(),
+      sources: [],
+      externalSources: {},
+      steps: [],
+      mode: null,
+      advisory: void 0,
+      blocked: { slug: failure.guardrailSlug, message: failure.message }
+    }));
+    return;
+  }
+  patchLast((turn) => ({
+    ...turn,
+    isStreaming: false,
+    error: {
+      code: failure.code,
+      message: failure.message,
+      ...failure.rateLimitScope ? { rateLimitScope: failure.rateLimitScope } : {},
+      ...failure.rateLimitWindow ? { rateLimitWindow: failure.rateLimitWindow } : {}
+    }
+  }));
+}
+
+exports.DEFAULT_REFRESH_BUFFER_MS = DEFAULT_REFRESH_BUFFER_MS;
+exports.LainternError = LainternError;
+exports.createConversation = createConversation;
+exports.createLainternClient = createLainternClient;
+exports.createTokenManager = createTokenManager;
+exports.decodeJwtExpiryMs = decodeJwtExpiryMs;
+exports.parseSSE = parseSSE;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/sse.ts","../src/tokens.ts","../src/client.ts","../src/conversation.ts"],"names":["parsed"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Every failure the SDK surfaces, with the API's own error code attached.\n *\n * Callers switch on `code` rather than parsing messages: the server's copy is\n * user-facing prose that may change, while the code is part of the contract.\n */\nexport class LainternError extends Error {\n  readonly code: string\n  readonly status: number | null\n  /** Set on RATE_LIMIT_EXCEEDED. */\n  readonly rateLimitScope?: \"user\" | \"agent\"\n  readonly rateLimitWindow?: \"minute\" | \"hour\" | \"day\"\n  /** Set on MCP_UNAVAILABLE: which dependency failed, and how. */\n  readonly reason?: string\n\n  constructor(\n    code: string,\n    message: string,\n    options: {\n      status?: number | null\n      rateLimitScope?: \"user\" | \"agent\"\n      rateLimitWindow?: \"minute\" | \"hour\" | \"day\"\n      reason?: string\n      cause?: unknown\n    } = {},\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined)\n    this.name = \"LainternError\"\n    this.code = code\n    this.status = options.status ?? null\n    if (options.rateLimitScope) this.rateLimitScope = options.rateLimitScope\n    if (options.rateLimitWindow) this.rateLimitWindow = options.rateLimitWindow\n    if (options.reason) this.reason = options.reason\n  }\n\n  /**\n   * True when retrying later could plausibly succeed: a rate limit, or a\n   * dependency the server could not reach. An expired session is NOT retryable\n   * — the host has to mint a new token first.\n   */\n  get isRetryable(): boolean {\n    return this.code === \"RATE_LIMIT_EXCEEDED\" || this.reason === \"transport\"\n  }\n}\n\nfunction pick<T extends string>(value: unknown, allowed: readonly T[]): T | undefined {\n  return typeof value === \"string\" && (allowed as readonly string[]).includes(value)\n    ? (value as T)\n    : undefined\n}\n\n/** Turn a non-2xx API response into a `LainternError`. Never throws itself. */\nexport async function errorFromResponse(response: Response): Promise<LainternError> {\n  let code = `HTTP_${response.status}`\n  let message = \"An unexpected error occurred.\"\n  let rateLimitScope: \"user\" | \"agent\" | undefined\n  let rateLimitWindow: \"minute\" | \"hour\" | \"day\" | undefined\n  let reason: string | undefined\n\n  try {\n    const body = (await response.json()) as {\n      error?: {\n        code?: string\n        message?: string\n        scope?: unknown\n        window?: unknown\n        reason?: unknown\n      }\n      message?: string\n    }\n    if (body?.error?.code) {\n      code = body.error.code\n      message = body.error.message ?? message\n      rateLimitScope = pick(body.error.scope, [\"user\", \"agent\"] as const)\n      rateLimitWindow = pick(body.error.window, [\"minute\", \"hour\", \"day\"] as const)\n      if (typeof body.error.reason === \"string\") reason = body.error.reason\n    } else if (typeof body?.message === \"string\") {\n      message = body.message\n    }\n  } catch {\n    // Not JSON — keep the HTTP-derived defaults.\n  }\n\n  return new LainternError(code, message, {\n    status: response.status,\n    rateLimitScope,\n    rateLimitWindow,\n    reason,\n  })\n}\n","import type { ChatStreamEvent } from \"@laintern-headless/types\"\n\n/** Sentinel that terminates the stream (OpenAI-style `data: [DONE]`). */\nconst DONE = \"[DONE]\"\n\n/**\n * Parse a Server-Sent Events response into a stream of chat events.\n *\n * The server writes one event per SSE frame (`data: <json>\\n\\n`) and ends with\n * a `data: [DONE]` sentinel. We read the raw `ReadableStream` from fetch\n * rather than using `EventSource`, which cannot send a POST body or an\n * Authorization header.\n */\nexport async function* parseSSE(response: Response): AsyncGenerator<ChatStreamEvent> {\n  const reader = response.body?.getReader()\n  if (!reader) throw new Error(\"Response body is not readable\")\n\n  const decoder = new TextDecoder()\n  let buffer = \"\"\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n\n      buffer += decoder.decode(value, { stream: true })\n\n      // SSE frames are separated by a blank line. Tolerate CRLF endings.\n      let sepIndex: number\n      while ((sepIndex = indexOfFrameBoundary(buffer)) !== -1) {\n        const frame = buffer.slice(0, sepIndex)\n        buffer = buffer.slice(boundaryEnd(buffer, sepIndex))\n        const parsed = parseFrame(frame)\n        if (parsed === DONE) return\n        if (parsed) yield parsed\n      }\n    }\n\n    // Flush a trailing frame that wasn't terminated by a blank line.\n    const parsed = parseFrame(buffer)\n    if (parsed && parsed !== DONE) yield parsed\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/** Index of the start of the next `\\n\\n` or `\\r\\n\\r\\n` boundary, or -1. */\nfunction indexOfFrameBoundary(buffer: string): number {\n  const lf = buffer.indexOf(\"\\n\\n\")\n  const crlf = buffer.indexOf(\"\\r\\n\\r\\n\")\n  if (lf === -1) return crlf\n  if (crlf === -1) return lf\n  return Math.min(lf, crlf)\n}\n\n/** Length of the boundary at `index` so we can slice past it. */\nfunction boundaryEnd(buffer: string, index: number): number {\n  return buffer.startsWith(\"\\r\\n\\r\\n\", index) ? index + 4 : index + 2\n}\n\n/**\n * Extract the payload from a single SSE frame. Returns the parsed event, the\n * `DONE` sentinel, or `null` for empty/comment/unparseable frames.\n */\nfunction parseFrame(frame: string): ChatStreamEvent | typeof DONE | null {\n  const trimmed = frame.trim()\n  if (!trimmed) return null\n\n  const dataLines: string[] = []\n  for (const rawLine of trimmed.split(\"\\n\")) {\n    const line = rawLine.replace(/\\r$/, \"\")\n    if (line.startsWith(\":\")) continue // SSE comment\n    if (!line.startsWith(\"data:\")) continue // ignore event:/id:/retry:\n    dataLines.push(line.slice(5).replace(/^ /, \"\")) // strip \"data:\" + one optional space\n  }\n  if (dataLines.length === 0) return null\n\n  const payload = dataLines.join(\"\\n\")\n  if (payload === DONE) return DONE\n\n  try {\n    return JSON.parse(payload) as ChatStreamEvent\n  } catch {\n    return null\n  }\n}\n","import { LainternError } from \"./errors.js\"\n\n/**\n * Refresh this long before a token expires. It mirrors the margin the API\n * applies when it clamps a chat token to a credential inside it: the server\n * guarantees the token dies *after* the credential's own refresh point, and\n * this buffer is what makes the client come back in time to use that.\n */\nexport const DEFAULT_REFRESH_BUFFER_MS = 60_000\n\n/** Used only when neither the JWT nor the endpoint says when the token dies. */\nconst FALLBACK_TTL_MS = 5 * 60 * 1000\n\n/** A token proxy that drifts further than this from the JWT is misconfigured. */\nconst DRIFT_WARN_THRESHOLD_MS = 5 * 60 * 1000\n\nexport interface TokenResponse {\n  token: string\n  /** ISO-8601 or epoch ms, if the endpoint reports one. */\n  expiresAt?: string | number | null\n}\n\n/** Minimal storage surface — `sessionStorage`, `localStorage` or your own. */\nexport interface TokenStorage {\n  getItem(key: string): string | null\n  setItem(key: string, value: string): void\n  removeItem(key: string): void\n}\n\nexport interface TokenManagerOptions {\n  /**\n   * Fetches a fresh token from YOUR backend. This is the one integration\n   * point that cannot be generic: only your server may hold the API key that\n   * mints Laintern tokens, and only it knows who the current user is.\n   */\n  fetchToken: () => Promise<TokenResponse | string>\n  storage?: TokenStorage | null\n  storageKey?: string\n  refreshBufferMs?: number\n  onWarning?: (message: string, detail?: Record<string, unknown>) => void\n}\n\nexport interface TokenManager {\n  /** Cached token when still valid, otherwise a freshly fetched one. */\n  get(): Promise<string>\n  /** Drop the cached token — the next `get()` fetches. */\n  clear(): void\n  /** Expiry of the cached token, in epoch ms. Null when nothing is cached. */\n  expiresAt(): number | null\n}\n\n/** Read a JWT's `exp` claim (epoch ms) without verifying the signature. */\nexport function decodeJwtExpiryMs(token: string): number | null {\n  try {\n    const parts = token.split(\".\")\n    if (parts.length < 2) return null\n    const padded = parts[1].replace(/-/g, \"+\").replace(/_/g, \"/\")\n    // `atob` is global in browsers and in Node 18+, which is our floor. On an\n    // exotic runtime without it we return null, and the caller falls back to\n    // the endpoint's reported expiry.\n    if (typeof atob !== \"function\") return null\n    const json = JSON.parse(atob(padded)) as { exp?: unknown }\n    return typeof json.exp === \"number\" ? json.exp * 1000 : null\n  } catch {\n    return null\n  }\n}\n\nfunction toEpochMs(value: string | number | null | undefined): number | null {\n  if (value == null) return null\n  if (typeof value === \"number\") return Number.isFinite(value) ? value : null\n  const parsed = Date.parse(value)\n  return Number.isNaN(parsed) ? null : parsed\n}\n\n/**\n * Decide when a token really expires.\n *\n * The JWT's own `exp` wins: it is what the API enforces. A token endpoint that\n * reports something materially different is a misconfiguration worth\n * surfacing — it usually means the proxy invents its own TTL instead of\n * passing through what Laintern returned.\n */\nexport function resolveExpiry(\n  token: string,\n  reportedExpiresAt: string | number | null | undefined,\n  onWarning?: TokenManagerOptions[\"onWarning\"],\n): number {\n  const jwtExpMs = decodeJwtExpiryMs(token)\n  const reported = toEpochMs(reportedExpiresAt)\n\n  if (jwtExpMs !== null) {\n    if (reported !== null && Math.abs(reported - jwtExpMs) > DRIFT_WARN_THRESHOLD_MS) {\n      onWarning?.(\n        \"Token endpoint 'expires_at' drifts more than 5 minutes from the JWT 'exp'; using the JWT claim.\",\n        { jwtExpMs, reportedExpiresAtMs: reported, driftMs: reported - jwtExpMs },\n      )\n    }\n    return jwtExpMs\n  }\n  if (reported !== null) return reported\n\n  onWarning?.(\n    \"Token has no readable 'exp' claim and the endpoint reported no expiry; caching for 5 minutes.\",\n  )\n  return Date.now() + FALLBACK_TTL_MS\n}\n\ninterface CachedToken {\n  token: string\n  expiresAt: number\n}\n\n/**\n * Caches the chat token and refreshes it before it dies.\n *\n * Concurrent callers share one in-flight fetch: a page that opens a stream\n * while another request is already refreshing must not mint two sessions.\n */\nexport function createTokenManager(options: TokenManagerOptions): TokenManager {\n  const buffer = options.refreshBufferMs ?? DEFAULT_REFRESH_BUFFER_MS\n  const storage = options.storage\n  const storageKey = options.storageKey ?? \"laintern.token\"\n  let cached: CachedToken | null = readStored()\n  let inFlight: Promise<string> | null = null\n\n  function readStored(): CachedToken | null {\n    if (!storage) return null\n    try {\n      const raw = storage.getItem(storageKey)\n      if (!raw) return null\n      const parsed = JSON.parse(raw) as Partial<CachedToken>\n      if (typeof parsed.token !== \"string\" || typeof parsed.expiresAt !== \"number\") {\n        return null\n      }\n      return { token: parsed.token, expiresAt: parsed.expiresAt }\n    } catch {\n      return null\n    }\n  }\n\n  function writeStored(value: CachedToken | null): void {\n    if (!storage) return\n    try {\n      if (value === null) storage.removeItem(storageKey)\n      else storage.setItem(storageKey, JSON.stringify(value))\n    } catch {\n      // Storage can be unavailable (private mode, blocked cookies). Non-fatal:\n      // we simply refetch on the next page load.\n    }\n  }\n\n  function isUsable(value: CachedToken | null): value is CachedToken {\n    return value !== null && Date.now() < value.expiresAt - buffer\n  }\n\n  async function refresh(): Promise<string> {\n    let result: TokenResponse | string\n    try {\n      result = await options.fetchToken()\n    } catch (err) {\n      throw new LainternError(\"TOKEN_FETCH_FAILED\", \"Could not obtain a chat token.\", {\n        cause: err,\n      })\n    }\n    const response: TokenResponse = typeof result === \"string\" ? { token: result } : result\n    if (!response || typeof response.token !== \"string\" || response.token.length === 0) {\n      throw new LainternError(\n        \"TOKEN_INVALID\",\n        \"Token endpoint returned no 'token' string.\",\n      )\n    }\n    const next: CachedToken = {\n      token: response.token,\n      expiresAt: resolveExpiry(response.token, response.expiresAt, options.onWarning),\n    }\n    cached = next\n    writeStored(next)\n    return next.token\n  }\n\n  return {\n    async get(): Promise<string> {\n      if (isUsable(cached)) return cached.token\n      if (!inFlight) {\n        inFlight = refresh().finally(() => {\n          inFlight = null\n        })\n      }\n      return inFlight\n    },\n    clear(): void {\n      cached = null\n      writeStored(null)\n    },\n    expiresAt(): number | null {\n      return cached?.expiresAt ?? null\n    },\n  }\n}\n","import type { ChatStreamEvent } from \"@laintern-headless/types\"\nimport { LainternError, errorFromResponse } from \"./errors.js\"\nimport { parseSSE } from \"./sse.js\"\nimport { createTokenManager, type TokenManager, type TokenManagerOptions } from \"./tokens.js\"\n\nexport interface LainternClientOptions {\n  /** Base URL of the Laintern API, e.g. \"https://api.laintern.com\". */\n  apiBase: string\n  /**\n   * How to get a chat token. Either your own function, or the URL of an\n   * endpoint on your backend that returns `{ token, expires_at }`.\n   *\n   * Never put a Laintern API key in the browser: the key mints tokens for any\n   * user, so it belongs on your server, behind your own session check.\n   */\n  token: TokenManagerOptions[\"fetchToken\"] | { endpoint: string; init?: RequestInit }\n  storage?: TokenManagerOptions[\"storage\"]\n  refreshBufferMs?: number\n  onWarning?: TokenManagerOptions[\"onWarning\"]\n  /** Injectable for tests and non-browser runtimes. */\n  fetch?: typeof globalThis.fetch\n}\n\nexport interface SendMessageOptions {\n  /** Continues an existing conversation. Omit to start a new one. */\n  sessionId?: string | null\n  /** Base64 data URLs, for agents with image input enabled. */\n  images?: string[]\n  /** Force a specific tool on this turn, when the agent allows it. */\n  forceTool?: string\n  signal?: AbortSignal\n}\n\nexport interface AgentConfig {\n  /** Transparency notice to show before the conversation starts (EU AI Act). */\n  disclaimer: { enabled: boolean; text: string | null }\n}\n\nexport interface LainternClient {\n  /**\n   * Send one message and iterate the response as it streams.\n   *\n   * Yields typed events (`delta`, `citation`, `sources`, `step`, `done`, …).\n   * Prefer {@link createConversation} unless you want to assemble the turn\n   * yourself.\n   */\n  sendMessage(message: string, options?: SendMessageOptions): AsyncGenerator<ChatStreamEvent>\n  /** Per-agent presentation config. Best-effort: throws on transport errors. */\n  getConfig(): Promise<AgentConfig>\n  submitFeedback(messageId: string, feedback: \"positive\" | \"negative\"): Promise<void>\n  /** The token cache, exposed so a host can clear it on logout. */\n  tokens: TokenManager\n}\n\nfunction tokenFetcher(\n  option: LainternClientOptions[\"token\"],\n  doFetch: typeof globalThis.fetch,\n): TokenManagerOptions[\"fetchToken\"] {\n  if (typeof option === \"function\") return option\n  return async () => {\n    const res = await doFetch(option.endpoint, {\n      method: \"POST\",\n      credentials: \"same-origin\",\n      headers: { \"Content-Type\": \"application/json\" },\n      ...option.init,\n    })\n    if (!res.ok) throw await errorFromResponse(res)\n    const body = (await res.json()) as Record<string, unknown>\n    const payload = ((body.data as Record<string, unknown>) ?? body) ?? {}\n    return {\n      token: payload.token as string,\n      expiresAt: (payload.expires_at as string | undefined) ?? null,\n    }\n  }\n}\n\nexport function createLainternClient(options: LainternClientOptions): LainternClient {\n  const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis)\n  const apiBase = options.apiBase.replace(/\\/+$/, \"\")\n  const tokens = createTokenManager({\n    fetchToken: tokenFetcher(options.token, doFetch),\n    storage: options.storage,\n    ...(options.refreshBufferMs !== undefined\n      ? { refreshBufferMs: options.refreshBufferMs }\n      : {}),\n    ...(options.onWarning ? { onWarning: options.onWarning } : {}),\n  })\n\n  async function authorized(path: string, init: RequestInit = {}): Promise<Response> {\n    const token = await tokens.get()\n    return doFetch(`${apiBase}${path}`, {\n      ...init,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...init.headers,\n        Authorization: `Bearer ${token}`,\n      },\n    })\n  }\n\n  return {\n    tokens,\n\n    async *sendMessage(message, sendOptions = {}) {\n      const body: Record<string, unknown> = { message }\n      if (sendOptions.sessionId) body.session_id = sendOptions.sessionId\n      if (sendOptions.images?.length) body.images = sendOptions.images\n      if (sendOptions.forceTool) body.force_tool = sendOptions.forceTool\n\n      let response: Response\n      try {\n        response = await authorized(\"/v1/chat\", {\n          method: \"POST\",\n          body: JSON.stringify(body),\n          ...(sendOptions.signal ? { signal: sendOptions.signal } : {}),\n        })\n      } catch (err) {\n        if (err instanceof LainternError) throw err\n        if ((err as Error)?.name === \"AbortError\") throw err\n        throw new LainternError(\n          \"NETWORK_ERROR\",\n          err instanceof Error ? err.message : \"Network request failed.\",\n          { cause: err },\n        )\n      }\n\n      if (!response.ok) {\n        const error = await errorFromResponse(response)\n        // A token can expire between mint and use — drop it so the next send\n        // fetches a fresh one instead of replaying the dead credential.\n        if (response.status === 401) tokens.clear()\n        throw error\n      }\n\n      yield* parseSSE(response)\n    },\n\n    async getConfig(): Promise<AgentConfig> {\n      const res = await authorized(\"/v1/config\", { method: \"GET\" })\n      if (!res.ok) throw await errorFromResponse(res)\n      const body = (await res.json()) as Record<string, unknown>\n      const payload = ((body.data as Record<string, unknown>) ?? body) ?? {}\n      const raw = payload.disclaimer as Record<string, unknown> | undefined\n      return {\n        disclaimer: {\n          enabled: raw?.enabled !== false,\n          text:\n            typeof raw?.text === \"string\" && raw.text.trim().length > 0\n              ? (raw.text as string)\n              : null,\n        },\n      }\n    },\n\n    async submitFeedback(messageId, feedback): Promise<void> {\n      const res = await authorized(`/v1/chat/messages/${messageId}/feedback`, {\n        method: \"PATCH\",\n        body: JSON.stringify({ feedback }),\n      })\n      if (!res.ok) throw await errorFromResponse(res)\n    },\n  }\n}\n","import type {\n  CitationSource,\n  ExternalSourceType,\n  SearchResult,\n  StepEvent,\n} from \"@laintern-headless/types\"\nimport type { LainternClient } from \"./client.js\"\nimport { LainternError } from \"./errors.js\"\n\n/** Soft advisory alongside an answer — the agent flagged the topic, but answered. */\nexport interface TurnAdvisory {\n  redirect: string | null\n  message: string\n}\n\n/** A guardrail refused the turn. The agent produced no answer. */\nexport interface TurnBlock {\n  /** Which guardrail fired, when the server names one. */\n  slug: string | null\n  /** Copy meant for the end user, written by the guardrail's configuration. */\n  message: string\n}\n\nexport interface TurnError {\n  code: string\n  message: string\n  rateLimitScope?: \"user\" | \"agent\"\n  rateLimitWindow?: \"minute\" | \"hour\" | \"day\"\n}\n\nexport interface Turn {\n  id: string\n  userMessage: string\n  userImages?: string[]\n  assistantContent: string\n  /** Citation number (the `[1]` in the text) → the source it points at. */\n  citations: Map<number, CitationSource>\n  /** Everything the agent cited or consulted, in the order the server ranked it. */\n  sources: SearchResult[]\n  /** Sidebar suggestions per content type — not necessarily cited. */\n  externalSources: Partial<Record<ExternalSourceType, SearchResult[]>>\n  mode: string | null\n  steps: StepEvent[]\n  isStreaming: boolean\n  error?: TurnError\n  blocked?: TurnBlock\n  advisory?: TurnAdvisory\n  messageId?: string\n  feedback?: \"positive\" | \"negative\" | null\n}\n\nexport interface ConversationState {\n  turns: Turn[]\n  sessionId: string | null\n  isStreaming: boolean\n}\n\nexport interface SendOptions {\n  images?: string[]\n  forceTool?: string\n}\n\nexport interface Conversation {\n  getState(): ConversationState\n  /** Subscribe to state changes. Returns an unsubscribe function. */\n  subscribe(listener: (state: ConversationState) => void): () => void\n  /** Send a message and stream the answer into state. Never throws. */\n  send(message: string, options?: SendOptions): Promise<void>\n  /** Stop the current stream. The partial answer stays in state. */\n  abort(): void\n  /** Drop all turns and start a new server-side session on the next send. */\n  reset(): void\n  setFeedback(turnId: string, feedback: \"positive\" | \"negative\"): Promise<void>\n}\n\nexport interface ConversationOptions {\n  /** Resume an existing server-side session. */\n  sessionId?: string | null\n  /** Restore turns from your own storage. */\n  initialTurns?: Turn[]\n  /** Called whenever the session id changes, so you can persist it. */\n  onSessionId?: (sessionId: string) => void\n}\n\nfunction newId(): string {\n  const c = globalThis.crypto\n  if (c && typeof c.randomUUID === \"function\") return c.randomUUID()\n  return `turn-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`\n}\n\nfunction createTurn(message: string, images?: string[]): Turn {\n  return {\n    id: newId(),\n    userMessage: message,\n    ...(images?.length ? { userImages: images } : {}),\n    assistantContent: \"\",\n    citations: new Map(),\n    sources: [],\n    externalSources: {},\n    mode: null,\n    steps: [],\n    isStreaming: true,\n  }\n}\n\n/**\n * Stateful conversation on top of {@link LainternClient}.\n *\n * Holds the turn list, applies each stream event to the turn in flight, and\n * notifies subscribers. Framework-agnostic on purpose: the React binding in\n * `@laintern/chat-sdk/react` is a thin `useSyncExternalStore` wrapper, and any\n * other UI layer can subscribe the same way.\n *\n * `send()` never throws. A failed turn is part of the conversation — it lands\n * on `turn.error` (or `turn.blocked` for a guardrail) so the UI can render it\n * in place, which is what you want in a chat transcript.\n */\nexport function createConversation(\n  client: LainternClient,\n  options: ConversationOptions = {},\n): Conversation {\n  let state: ConversationState = {\n    turns: options.initialTurns ?? [],\n    sessionId: options.sessionId ?? null,\n    isStreaming: false,\n  }\n  const listeners = new Set<(state: ConversationState) => void>()\n  let controller: AbortController | null = null\n\n  function emit(next: ConversationState): void {\n    state = next\n    for (const listener of listeners) listener(state)\n  }\n\n  /** Apply a change to the turn currently streaming (always the last one). */\n  function patchLast(patch: (turn: Turn) => Turn): void {\n    const lastIndex = state.turns.length - 1\n    if (lastIndex < 0) return\n    const turns = [...state.turns]\n    turns[lastIndex] = patch(turns[lastIndex])\n    emit({ ...state, turns })\n  }\n\n  return {\n    getState: () => state,\n\n    subscribe(listener) {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n\n    abort() {\n      controller?.abort()\n    },\n\n    reset() {\n      controller?.abort()\n      emit({ turns: [], sessionId: null, isStreaming: false })\n    },\n\n    async send(message, sendOptions = {}) {\n      controller?.abort()\n      controller = new AbortController()\n      const signal = controller.signal\n\n      emit({\n        ...state,\n        turns: [...state.turns, createTurn(message, sendOptions.images)],\n        isStreaming: true,\n      })\n\n      try {\n        const stream = client.sendMessage(message, {\n          sessionId: state.sessionId,\n          ...(sendOptions.images ? { images: sendOptions.images } : {}),\n          ...(sendOptions.forceTool ? { forceTool: sendOptions.forceTool } : {}),\n          signal,\n        })\n\n        for await (const event of stream) {\n          if (signal.aborted) break\n\n          switch (event.type) {\n            case \"session\":\n              emit({ ...state, sessionId: event.session_id })\n              options.onSessionId?.(event.session_id)\n              break\n            case \"mode\":\n              patchLast((turn) => ({ ...turn, mode: event.mode }))\n              break\n            case \"step\":\n              patchLast((turn) => ({ ...turn, steps: mergeStep(turn.steps, event.step) }))\n              break\n            case \"delta\":\n              patchLast((turn) => ({\n                ...turn,\n                assistantContent: turn.assistantContent + event.content,\n              }))\n              break\n            case \"citation\":\n              patchLast((turn) => {\n                const citations = new Map(turn.citations)\n                citations.set(event.index, event.source)\n                return { ...turn, citations }\n              })\n              break\n            case \"sources\":\n              patchLast((turn) => ({ ...turn, sources: event.items }))\n              break\n            case \"external_sources\":\n              patchLast((turn) => ({\n                ...turn,\n                externalSources: {\n                  ...turn.externalSources,\n                  [event.source_type]: event.items,\n                },\n              }))\n              break\n            case \"advisory\":\n              patchLast((turn) => ({\n                ...turn,\n                advisory: { redirect: event.redirect ?? null, message: event.message },\n              }))\n              break\n            case \"done\":\n              patchLast((turn) => ({\n                ...turn,\n                isStreaming: false,\n                ...(event.message_id ? { messageId: event.message_id } : {}),\n              }))\n              emit({ ...state, isStreaming: false })\n              break\n            case \"error\":\n              applyFailure(patchLast, {\n                code: event.code,\n                message: event.message,\n                guardrailSlug: event.guardrail_slug ?? null,\n              })\n              break\n          }\n        }\n      } catch (err) {\n        if ((err as Error)?.name === \"AbortError\") {\n          patchLast((turn) => ({ ...turn, isStreaming: false }))\n        } else if (err instanceof LainternError) {\n          applyFailure(patchLast, {\n            code: err.code,\n            message: err.message,\n            guardrailSlug: null,\n            ...(err.rateLimitScope ? { rateLimitScope: err.rateLimitScope } : {}),\n            ...(err.rateLimitWindow ? { rateLimitWindow: err.rateLimitWindow } : {}),\n          })\n        } else {\n          applyFailure(patchLast, {\n            code: \"NETWORK_ERROR\",\n            message: err instanceof Error ? err.message : \"An unknown error occurred.\",\n            guardrailSlug: null,\n          })\n        }\n      } finally {\n        // A turn always stops streaming, however it ended — including an abort\n        // that broke the loop without throwing. Leaving the flag set strands a\n        // typing indicator on a turn that will never produce another token.\n        const last = state.turns.at(-1)\n        if (last?.isStreaming) patchLast((turn) => ({ ...turn, isStreaming: false }))\n        if (state.isStreaming) emit({ ...state, isStreaming: false })\n        controller = null\n      }\n    },\n\n    async setFeedback(turnId, feedback) {\n      const turn = state.turns.find((t) => t.id === turnId)\n      if (!turn?.messageId) {\n        throw new LainternError(\n          \"FEEDBACK_UNAVAILABLE\",\n          \"This turn has no message id yet — feedback is only possible once a turn completes.\",\n        )\n      }\n      await client.submitFeedback(turn.messageId, feedback)\n      emit({\n        ...state,\n        turns: state.turns.map((t) => (t.id === turnId ? { ...t, feedback } : t)),\n      })\n    },\n  }\n}\n\n/**\n * A completed step replaces its own \"started\" entry rather than appending, so\n * the UI shows one row per tool call that fills in, not two.\n */\nfunction mergeStep(steps: StepEvent[], step: StepEvent): StepEvent[] {\n  if (step.status !== \"completed\") return [...steps, step]\n  const startedIndex = steps.findIndex((s) => s.tool === step.tool && s.status === \"started\")\n  if (startedIndex === -1) return [...steps, step]\n  const next = [...steps]\n  next[startedIndex] = step\n  return next\n}\n\n/**\n * A failed or blocked turn.\n *\n * A guardrail block discards whatever streamed before it fired: the partial\n * answer is exactly the content the guardrail decided the user should not see,\n * and a hard block always wins over a soft advisory that arrived a moment\n * earlier.\n */\nfunction applyFailure(\n  patchLast: (patch: (turn: Turn) => Turn) => void,\n  failure: {\n    code: string\n    message: string\n    guardrailSlug: string | null\n    rateLimitScope?: \"user\" | \"agent\"\n    rateLimitWindow?: \"minute\" | \"hour\" | \"day\"\n  },\n): void {\n  if (failure.code === \"GUARDRAIL_TRIGGERED\") {\n    patchLast((turn) => ({\n      ...turn,\n      isStreaming: false,\n      assistantContent: \"\",\n      citations: new Map(),\n      sources: [],\n      externalSources: {},\n      steps: [],\n      mode: null,\n      advisory: undefined,\n      blocked: { slug: failure.guardrailSlug, message: failure.message },\n    }))\n    return\n  }\n\n  patchLast((turn) => ({\n    ...turn,\n    isStreaming: false,\n    error: {\n      code: failure.code,\n      message: failure.message,\n      ...(failure.rateLimitScope ? { rateLimitScope: failure.rateLimitScope } : {}),\n      ...(failure.rateLimitWindow ? { rateLimitWindow: failure.rateLimitWindow } : {}),\n    },\n  }))\n}\n"]}