content-agent 1.0.3 → 1.2.0

package/dist/messages.d.ts

@@ -0,0 +1,106 @@
+import { b as OutputFormat } from "./_chunks-dts/types.js";
+import { UIMessage } from "ai";
+import { Application, Context } from "@sanity/agent-types";
+/**
+ * Wire shape the Content Agent chat route expects: `{role, content}` where
+ * content is a flattened string for text-only turns, or the raw typed parts
+ * (tool calls / results) otherwise.
+ *
+ * @category Messages
+ */
+interface WireMessage {
+  id: string;
+  role: UIMessage['role'];
+  content: string | Array<Record<string, unknown>>;
+}
+/**
+ * Convert an AI SDK `UIMessage` into the Content Agent wire shape. Text-only
+ * messages collapse to a single string; anything with tool parts passes the
+ * parts array through.
+ *
+ * @category Messages
+ */
+declare function toWireMessage(message: UIMessage): WireMessage;
+/**
+ * Join a message's `text` parts into a single string. Separate text parts are
+ * delimited with a blank line so an inline directive followed by prose stays
+ * parseable.
+ *
+ * @category Messages
+ */
+declare function uiMessageToText(message: UIMessage): string;
+/**
+ * Concatenate the agent's reasoning summary from `data-agent-status` stream
+ * parts. Returns `undefined` when the message carries no reasoning.
+ *
+ * @category Messages
+ */
+declare function getReasoningText(message: UIMessage): string | undefined;
+/**
+ * A persisted thread turn loaded from `GET /threads/:id`, ready to seed into
+ * `chat.messages`.
+ *
+ * @category Messages
+ */
+interface HistoryMessage {
+  id: string;
+  role: 'user' | 'assistant';
+  content: string;
+  metadata?: unknown;
+}
+/**
+ * Convert persisted thread history into `UIMessage`s for seeding. The directive
+ * text is kept as a single text part so {@link uiMessageToText} round-trips it.
+ *
+ * @category Messages
+ */
+declare function historyToUiMessages(messages: HistoryMessage[]): UIMessage[];
+/**
+ * Merge persisted history (`seed`, ordered) with the live SDK messages.
+ *
+ * History and a resumed stream are complementary: after a reload mid-stream the
+ * resumed stream carries the assistant turn while only history has the user
+ * message. Merging by id keeps both. History order is preserved; for ids in
+ * both, the live object is kept (so the SDK keeps writing to the same message
+ * reference); live-only messages are appended.
+ *
+ * @category Messages
+ */
+declare function mergeMessagesById<UI_MESSAGE extends UIMessage>(seed: UI_MESSAGE[], live: UI_MESSAGE[]): UI_MESSAGE[];
+/**
+ * Options for {@link buildSendBody}.
+ *
+ * @category Messages
+ */
+interface BuildSendBodyOptions {
+  /** The conversation messages from `useChat`; only the last is sent. */
+  messages: UIMessage[];
+  /** Base body the SDK already assembled (id, trigger, etc.) to spread. */
+  body?: Record<string, unknown>;
+  application?: Application;
+  context?: Context;
+  format?: OutputFormat;
+  clientId?: string;
+  /** Defaults to `true` — the route streams over SSE. */
+  stream?: boolean;
+}
+/**
+ * Build the Content Agent chat request body for `prepareSendMessagesRequest`.
+ *
+ * Sends only the last turn (the backend persists history and appends it),
+ * wire-shaped via {@link toWireMessage}, plus the routing fields the route
+ * understands. Empty `context` is omitted so it isn't sent as noise.
+ *
+ * @category Messages
+ */
+declare function buildSendBody({
+  messages,
+  body,
+  application,
+  context,
+  format,
+  clientId,
+  stream
+}: BuildSendBodyOptions): Record<string, unknown>;
+export { type BuildSendBodyOptions, type HistoryMessage, type WireMessage, buildSendBody, getReasoningText, historyToUiMessages, mergeMessagesById, toWireMessage, uiMessageToText };
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","names":[],"sources":["../src/_internal/messages.ts"],"mappings":";;;;AAWA;;;;;;UAAiB,WAAA;EACf,EAAA;EACA,IAAA,EAAM,SAAA;EACN,OAAA,WAAkB,KAAA,CAAM,MAAA;AAAA;;;;;;AAU1B;;iBAAgB,aAAA,CAAc,OAAA,EAAS,SAAA,GAAY,WAAA;;;;;;;AA0BnD;iBAAgB,eAAA,CAAgB,OAAA,EAAS,SAAA;;;;AAkBzC;;;iBAAgB,gBAAA,CAAiB,OAAA,EAAS,SAAA;;AAiB1C;;;;;UAAiB,cAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,QAAA;AAAA;;;;;;;iBASc,mBAAA,CAAoB,QAAA,EAAU,cAAA,KAAmB,SAAA;;AAoBjE;;;;;;;;;;iBAAgB,iBAAA,oBAAqC,SAAA,CAAA,CACnD,IAAA,EAAM,UAAA,IACN,IAAA,EAAM,UAAA,KACL,UAAA;;;;;;UAsBc,oBAAA;EAtBJ;EAwBX,QAAA,EAAU,SAAA;EAFyB;EAInC,IAAA,GAAO,MAAA;EACP,WAAA,GAAc,WAAA;EACd,OAAA,GAAU,OAAA;EACV,MAAA,GAAS,YAAA;EACT,QAAA;EADS;EAGT,MAAA;AAAA;;;;;;;;;;iBAYc,aAAA,CAAA;EACd,QAAA;EACA,IAAA;EACA,WAAA;EACA,OAAA;EACA,MAAA;EACA,QAAA;EACA;AAAA,GACC,oBAAA,GAAuB,MAAA"}

package/dist/messages.js

@@ -0,0 +1,79 @@
+function toWireMessage(message) {
+  const parts = message.parts ?? [];
+  if (!parts.some((p) => p.type !== "text")) {
+    const text = parts.filter((p) => p.type === "text").map((p) => p.text).join("");
+    return { id: message.id, role: message.role, content: text };
+  }
+  return {
+    id: message.id,
+    role: message.role,
+    content: parts
+  };
+}
+function uiMessageToText(message) {
+  const parts = message.parts ?? [];
+  let out = "";
+  for (const part of parts)
+    part.type === "text" && typeof part.text == "string" && (out.length > 0 && !/\s$/.test(out) && !/^\s/.test(part.text) && (out += `
+
+`), out += part.text);
+  return out;
+}
+function getReasoningText(message) {
+  const parts = message.parts ?? [];
+  let out = "";
+  for (const part of parts) {
+    if (part.type !== "data-agent-status") continue;
+    const text = part.data?.text;
+    typeof text == "string" && (out += text);
+  }
+  return out === "" ? void 0 : out;
+}
+function historyToUiMessages(messages) {
+  return messages.map((message) => ({
+    id: message.id,
+    role: message.role,
+    parts: message.content ? [{ type: "text", text: message.content }] : [],
+    ...message.metadata !== void 0 && { metadata: message.metadata }
+  }));
+}
+function mergeMessagesById(seed, live) {
+  if (live.length === 0) return seed;
+  const liveById = new Map(live.map((message) => [message.id, message])), seen = /* @__PURE__ */ new Set(), merged = [];
+  for (const message of seed)
+    merged.push(liveById.get(message.id) ?? message), seen.add(message.id);
+  for (const message of live)
+    seen.has(message.id) || merged.push(message);
+  return merged;
+}
+function buildSendBody({
+  messages,
+  body,
+  application,
+  context,
+  format,
+  clientId,
+  stream = !0
+}) {
+  return {
+    ...body,
+    messages: messages.slice(-1).map(toWireMessage),
+    ...application && { application },
+    ...context && hasContext(context) && { context },
+    ...format && { format },
+    ...clientId && { clientId },
+    stream
+  };
+}
+function hasContext(context) {
+  return Object.values(context).some((value) => value != null);
+}
+export {
+  buildSendBody,
+  getReasoningText,
+  historyToUiMessages,
+  mergeMessagesById,
+  toWireMessage,
+  uiMessageToText
+};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sources":["../src/_internal/messages.ts"],"sourcesContent":["import type { Application, Context } from '@sanity/agent-types'\nimport type { UIMessage } from 'ai'\nimport type { OutputFormat } from '../types'\n\n/**\n * Wire shape the Content Agent chat route expects: `{role, content}` where\n * content is a flattened string for text-only turns, or the raw typed parts\n * (tool calls / results) otherwise.\n *\n * @category Messages\n */\nexport interface WireMessage {\n  id: string\n  role: UIMessage['role']\n  content: string | Array<Record<string, unknown>>\n}\n\n/**\n * Convert an AI SDK `UIMessage` into the Content Agent wire shape. Text-only\n * messages collapse to a single string; anything with tool parts passes the\n * parts array through.\n *\n * @category Messages\n */\nexport function toWireMessage(message: UIMessage): WireMessage {\n  const parts = message.parts ?? []\n  const hasNonText = parts.some((p) => p.type !== 'text')\n\n  if (!hasNonText) {\n    const text = parts\n      .filter((p): p is Extract<UIMessage['parts'][number], { type: 'text' }> => p.type === 'text')\n      .map((p) => p.text)\n      .join('')\n    return { id: message.id, role: message.role, content: text }\n  }\n\n  return {\n    id: message.id,\n    role: message.role,\n    content: parts as Array<Record<string, unknown>>,\n  }\n}\n\n/**\n * Join a message's `text` parts into a single string. Separate text parts are\n * delimited with a blank line so an inline directive followed by prose stays\n * parseable.\n *\n * @category Messages\n */\nexport function uiMessageToText(message: UIMessage): string {\n  const parts = message.parts ?? []\n  let out = ''\n  for (const part of parts) {\n    if (part.type === 'text' && typeof part.text === 'string') {\n      if (out.length > 0 && !/\\s$/.test(out) && !/^\\s/.test(part.text)) out += '\\n\\n'\n      out += part.text\n    }\n  }\n  return out\n}\n\n/**\n * Concatenate the agent's reasoning summary from `data-agent-status` stream\n * parts. Returns `undefined` when the message carries no reasoning.\n *\n * @category Messages\n */\nexport function getReasoningText(message: UIMessage): string | undefined {\n  const parts = message.parts ?? []\n  let out = ''\n  for (const part of parts) {\n    if (part.type !== 'data-agent-status') continue\n    const text = (part as { data?: { text?: unknown } }).data?.text\n    if (typeof text === 'string') out += text\n  }\n  return out === '' ? undefined : out\n}\n\n/**\n * A persisted thread turn loaded from `GET /threads/:id`, ready to seed into\n * `chat.messages`.\n *\n * @category Messages\n */\nexport interface HistoryMessage {\n  id: string\n  role: 'user' | 'assistant'\n  content: string\n  metadata?: unknown\n}\n\n/**\n * Convert persisted thread history into `UIMessage`s for seeding. The directive\n * text is kept as a single text part so {@link uiMessageToText} round-trips it.\n *\n * @category Messages\n */\nexport function historyToUiMessages(messages: HistoryMessage[]): UIMessage[] {\n  return messages.map((message) => ({\n    id: message.id,\n    role: message.role,\n    parts: message.content ? [{ type: 'text', text: message.content }] : [],\n    ...(message.metadata !== undefined && { metadata: message.metadata }),\n  }))\n}\n\n/**\n * Merge persisted history (`seed`, ordered) with the live SDK messages.\n *\n * History and a resumed stream are complementary: after a reload mid-stream the\n * resumed stream carries the assistant turn while only history has the user\n * message. Merging by id keeps both. History order is preserved; for ids in\n * both, the live object is kept (so the SDK keeps writing to the same message\n * reference); live-only messages are appended.\n *\n * @category Messages\n */\nexport function mergeMessagesById<UI_MESSAGE extends UIMessage>(\n  seed: UI_MESSAGE[],\n  live: UI_MESSAGE[],\n): UI_MESSAGE[] {\n  if (live.length === 0) return seed\n\n  const liveById = new Map(live.map((message) => [message.id, message]))\n  const seen = new Set<string>()\n  const merged: UI_MESSAGE[] = []\n\n  for (const message of seed) {\n    merged.push(liveById.get(message.id) ?? message)\n    seen.add(message.id)\n  }\n  for (const message of live) {\n    if (!seen.has(message.id)) merged.push(message)\n  }\n  return merged\n}\n\n/**\n * Options for {@link buildSendBody}.\n *\n * @category Messages\n */\nexport interface BuildSendBodyOptions {\n  /** The conversation messages from `useChat`; only the last is sent. */\n  messages: UIMessage[]\n  /** Base body the SDK already assembled (id, trigger, etc.) to spread. */\n  body?: Record<string, unknown>\n  application?: Application\n  context?: Context\n  format?: OutputFormat\n  clientId?: string\n  /** Defaults to `true` — the route streams over SSE. */\n  stream?: boolean\n}\n\n/**\n * Build the Content Agent chat request body for `prepareSendMessagesRequest`.\n *\n * Sends only the last turn (the backend persists history and appends it),\n * wire-shaped via {@link toWireMessage}, plus the routing fields the route\n * understands. Empty `context` is omitted so it isn't sent as noise.\n *\n * @category Messages\n */\nexport function buildSendBody({\n  messages,\n  body,\n  application,\n  context,\n  format,\n  clientId,\n  stream = true,\n}: BuildSendBodyOptions): Record<string, unknown> {\n  return {\n    ...body,\n    messages: messages.slice(-1).map(toWireMessage),\n    ...(application && { application }),\n    ...(context && hasContext(context) && { context }),\n    ...(format && { format }),\n    ...(clientId && { clientId }),\n    stream,\n  }\n}\n\nfunction hasContext(context: Context): boolean {\n  return Object.values(context).some((value) => value !== undefined && value !== null)\n}\n"],"names":[],"mappings":"AAwBO,SAAS,cAAc,SAAiC;AAC7D,QAAM,QAAQ,QAAQ,SAAS,CAAA;AAG/B,MAAI,CAFe,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM,GAErC;AACf,UAAM,OAAO,MACV,OAAO,CAAC,MAAkE,EAAE,SAAS,MAAM,EAC3F,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK,EAAE;AACV,WAAO,EAAE,IAAI,QAAQ,IAAI,MAAM,QAAQ,MAAM,SAAS,KAAA;AAAA,EACxD;AAEA,SAAO;AAAA,IACL,IAAI,QAAQ;AAAA,IACZ,MAAM,QAAQ;AAAA,IACd,SAAS;AAAA,EAAA;AAEb;AASO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QAAQ,QAAQ,SAAS,CAAA;AAC/B,MAAI,MAAM;AACV,aAAW,QAAQ;AACb,SAAK,SAAS,UAAU,OAAO,KAAK,QAAS,aAC3C,IAAI,SAAS,KAAK,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,MAAG,OAAO;AAAA;AAAA,IACzE,OAAO,KAAK;AAGhB,SAAO;AACT;AAQO,SAAS,iBAAiB,SAAwC;AACvE,QAAM,QAAQ,QAAQ,SAAS,CAAA;AAC/B,MAAI,MAAM;AACV,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,SAAS,oBAAqB;AACvC,UAAM,OAAQ,KAAuC,MAAM;AACvD,WAAO,QAAS,aAAU,OAAO;AAAA,EACvC;AACA,SAAO,QAAQ,KAAK,SAAY;AAClC;AAqBO,SAAS,oBAAoB,UAAyC;AAC3E,SAAO,SAAS,IAAI,CAAC,aAAa;AAAA,IAChC,IAAI,QAAQ;AAAA,IACZ,MAAM,QAAQ;AAAA,IACd,OAAO,QAAQ,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,QAAA,CAAS,IAAI,CAAA;AAAA,IACrE,GAAI,QAAQ,aAAa,UAAa,EAAE,UAAU,QAAQ,SAAA;AAAA,EAAS,EACnE;AACJ;AAaO,SAAS,kBACd,MACA,MACc;AACd,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAM,WAAW,IAAI,IAAI,KAAK,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,GAC/D,2BAAW,IAAA,GACX,SAAuB,CAAA;AAE7B,aAAW,WAAW;AACpB,WAAO,KAAK,SAAS,IAAI,QAAQ,EAAE,KAAK,OAAO,GAC/C,KAAK,IAAI,QAAQ,EAAE;AAErB,aAAW,WAAW;AACf,SAAK,IAAI,QAAQ,EAAE,KAAG,OAAO,KAAK,OAAO;AAEhD,SAAO;AACT;AA6BO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AACX,GAAkD;AAChD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU,SAAS,MAAM,EAAE,EAAE,IAAI,aAAa;AAAA,IAC9C,GAAI,eAAe,EAAE,YAAA;AAAA,IACrB,GAAI,WAAW,WAAW,OAAO,KAAK,EAAE,QAAA;AAAA,IACxC,GAAI,UAAU,EAAE,OAAA;AAAA,IAChB,GAAI,YAAY,EAAE,SAAA;AAAA,IAClB;AAAA,EAAA;AAEJ;AAEA,SAAS,WAAW,SAA2B;AAC7C,SAAO,OAAO,OAAO,OAAO,EAAE,KAAK,CAAC,UAAiC,SAAU,IAAI;AACrF;"}

package/dist/react.d.ts

@@ -0,0 +1,110 @@
+import { b as OutputFormat } from "./_chunks-dts/types.js";
+import { UIMessage } from "ai";
+import { Application, Context } from "@sanity/agent-types";
+import { UseChatHelpers, UseChatOptions } from "@ai-sdk/react";
+/** `useChat` options that {@link useContentAgentChat} owns; the rest pass through. */
+type ManagedChatOptions = 'id' | 'transport' | 'resume' | 'messages' | 'onError' | 'onFinish' | 'onData';
+/** A value, or a getter resolved at send time (avoids stale closures). */
+type Resolvable<T> = T | (() => T | undefined);
+/**
+ * Options for {@link useContentAgentChat}.
+ *
+ * @category React
+ */
+interface UseContentAgentChatOptions<UI_MESSAGE extends UIMessage = UIMessage> {
+  /** Sanity organization ID. When undefined, no transport is built. */
+  organizationId: string | undefined;
+  /** Stable thread id. When undefined, no transport is built. */
+  threadId: string | undefined;
+  /**
+   * Base URL for the Sanity API.
+   * @default 'https://api.sanity.io'
+   */
+  baseURL?: string;
+  /** API version segment, e.g. `'v2026-01-12'`. */
+  apiVersion?: string;
+  /** Bearer token, or a getter read at request time. */
+  token?: string | (() => string | undefined);
+  /** Target application; pass a getter to read it fresh on each turn. */
+  application?: Resolvable<Application>;
+  /** Per-turn request context; pass a getter to read it fresh on each turn. */
+  context?: Resolvable<Context>;
+  /** Directive output format (`'directives'` for custom client rendering). */
+  format?: OutputFormat;
+  /** Identifies the creating client (e.g. `'dashboard'`). */
+  clientId?: string;
+  /**
+   * When true, reconnect to an in-flight stream once per thread (page reload
+   * or thread switch). The SDK's `resume: true` only fires on first mount, so
+   * this hook drives resume per (Chat x threadId) pair instead.
+   */
+  autoResume?: boolean;
+  /** Initial messages (e.g. server-rendered history). */
+  messages?: UI_MESSAGE[];
+  onError?: (error: Error) => void;
+  onFinish?: () => void;
+  onData?: (dataPart: {
+    type: string;
+    data: unknown;
+  }) => void;
+  /**
+   * Any other `useChat` options to forward (e.g. `onToolCall`, `generateId`,
+   * `experimental_throttle`). The options this hook manages (transport, id,
+   * resume, messages, the callbacks above) take precedence.
+   */
+  chatOptions?: Omit<UseChatOptions<UI_MESSAGE>, ManagedChatOptions>;
+}
+/**
+ * Options for {@link useSanityChatResume}.
+ *
+ * @category React
+ */
+interface UseSanityChatResumeOptions {
+  /**
+   * When true, reconnect to an in-flight stream once per thread (page reload
+   * or thread switch). The SDK's `resume: true` only fires on first mount, so
+   * this drives resume per (Chat x threadId) pair instead.
+   */
+  autoResume?: boolean;
+}
+/**
+ * Add Sanity resume semantics to a `useChat` instance you own: reconnect to an
+ * in-flight stream once per thread, and abort the previous Chat's stream when
+ * the thread changes. Use this when you need full control of the `useChat`
+ * call; {@link useContentAgentChat} composes it for the turnkey path.
+ *
+ * @category React
+ *
+ * @example
+ * ```tsx
+ * const transport = useMemo(() => createSanityChatTransport({ ... }), [...])
+ * const chat = useChat({ id: threadId, transport, onToolCall })
+ * useSanityChatResume(chat, { autoResume: threadExistsOnBackend })
+ * ```
+ */
+declare function useSanityChatResume<UI_MESSAGE extends UIMessage>(chat: Pick<UseChatHelpers<UI_MESSAGE>, 'id' | 'status' | 'stop' | 'resumeStream'>, options?: UseSanityChatResumeOptions): void;
+/**
+ * `useChat` wired to the Sanity Content Agent: transport with bearer auth and
+ * transparent resume, per-turn body shaping (last message wire-shaped, plus
+ * application/context/format/clientId), `x-request-id` idempotency, resume on
+ * thread change, and stream cleanup when the thread changes.
+ *
+ * Returns the standard `useChat` helpers, so messages, status, sendMessage,
+ * stop, resumeStream, and setMessages all behave exactly as upstream.
+ *
+ * @category React
+ *
+ * @example
+ * ```tsx
+ * const chat = useContentAgentChat({
+ *   organizationId,
+ *   threadId,
+ *   token: () => client.config().token,
+ *   application,
+ *   autoResume: threadExistsOnBackend,
+ * })
+ * ```
+ */
+declare function useContentAgentChat<UI_MESSAGE extends UIMessage = UIMessage>(options: UseContentAgentChatOptions<UI_MESSAGE>): UseChatHelpers<UI_MESSAGE>;
+export { UseContentAgentChatOptions, UseSanityChatResumeOptions, useContentAgentChat, useSanityChatResume };
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../src/react.ts"],"mappings":";;;;;KASK,kBAAA;;KAUA,UAAA,MAAgB,CAAA,UAAW,CAAA;;;AAVT;;;UAiBN,0BAAA,oBAA8C,SAAA,GAAY,SAAA;EAP3D;EASd,cAAA;EAT8B;EAW9B,QAAA;EAX+B;AAOjC;;;EASE,OAAA;EATyE;EAWzE,UAAA;EAIc;EAFd,KAAA;EAIU;EAFV,WAAA,GAAc,UAAA,CAAW,WAAA;EAcd;EAZX,OAAA,GAAU,UAAA,CAAW,OAAA;EAqBa;EAnBlC,MAAA,GAAS,YAAA;EAmBsC;EAjB/C,QAAA;EAiBkB;;;;;EAXlB,UAAA;EAvBA;EAyBA,QAAA,GAAW,UAAA;EACX,OAAA,IAAW,KAAA,EAAO,KAAA;EAClB,QAAA;EACA,MAAA,IAAU,QAAA;IAAY,IAAA;IAAc,IAAA;EAAA;EAf1B;;;;;EAqBV,WAAA,GAAc,IAAA,CAAK,cAAA,CAAe,UAAA,GAAa,kBAAA;AAAA;;;;;;UAQhC,0BAAA;EAdO;;;;;EAoBtB,UAAA;AAAA;;;;AANF;;;;;AAwBA;;;;;;;iBAAgB,mBAAA,oBAAuC,SAAA,CAAA,CACrD,IAAA,EAAM,IAAA,CAAK,cAAA,CAAe,UAAA,+CAC1B,OAAA,GAAU,0BAAA;;;;;;;;;;;;;AA8CZ;;;;;;;;;;iBAAgB,mBAAA,oBAAuC,SAAA,GAAY,SAAA,CAAA,CACjE,OAAA,EAAS,0BAAA,CAA2B,UAAA,IACnC,cAAA,CAAe,UAAA"}

package/dist/react.js

@@ -0,0 +1,84 @@
+import { useChat } from "@ai-sdk/react";
+import { useRef, useMemo, useEffect } from "react";
+import { createSanityChatTransport } from "./chat-transport.js";
+import { buildSendBody } from "./messages.js";
+function useSanityChatResume(chat, options) {
+  const { autoResume = !1 } = options ?? {}, { id: threadId, status, stop, resumeStream } = chat;
+  useEffect(() => () => {
+    stop().catch(() => {
+    });
+  }, [stop]);
+  const resumeEvaluatedForRef = useRef(void 0);
+  useEffect(() => {
+    !autoResume || !threadId || status === "ready" && resumeEvaluatedForRef.current !== threadId && (resumeEvaluatedForRef.current = threadId, resumeStream());
+  }, [autoResume, threadId, status, resumeStream]);
+}
+function useContentAgentChat(options) {
+  const {
+    organizationId,
+    threadId,
+    baseURL,
+    apiVersion,
+    token,
+    application,
+    context,
+    format,
+    clientId,
+    autoResume = !1,
+    messages,
+    onError,
+    onFinish,
+    onData
+  } = options, latest = useRef({ token, application, context, format, clientId });
+  latest.current = { token, application, context, format, clientId };
+  const transport = useMemo(() => {
+    if (!(!organizationId || !threadId))
+      return createSanityChatTransport({
+        organizationId,
+        threadId,
+        baseURL,
+        apiVersion,
+        token: () => resolve(latest.current.token),
+        prepareSendMessagesRequest: ({ messages: turnMessages, body, headers }) => {
+          const current = latest.current;
+          return {
+            headers: withRequestId(headers, turnMessages),
+            body: buildSendBody({
+              messages: turnMessages,
+              body,
+              application: resolve(current.application),
+              context: resolve(current.context),
+              format: current.format,
+              clientId: current.clientId
+            })
+          };
+        }
+      });
+  }, [organizationId, threadId, baseURL, apiVersion]), chat = useChat({
+    ...options.chatOptions,
+    id: threadId,
+    transport,
+    resume: !1,
+    messages,
+    onError,
+    onFinish,
+    onData
+  });
+  return useSanityChatResume(chat, { autoResume }), chat;
+}
+function resolve(value) {
+  return typeof value == "function" ? value() : value;
+}
+function withRequestId(headers, messages) {
+  const merged = {};
+  new Headers(headers).forEach((value, key) => {
+    merged[key] = value;
+  });
+  const lastUser = [...messages].reverse().find((m) => m.role === "user");
+  return lastUser && (merged["x-request-id"] = lastUser.id), merged;
+}
+export {
+  useContentAgentChat,
+  useSanityChatResume
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sources":["../src/react.ts"],"sourcesContent":["import { type UseChatHelpers, type UseChatOptions, useChat } from '@ai-sdk/react'\nimport type { Application, Context } from '@sanity/agent-types'\nimport type { UIMessage } from 'ai'\nimport { useEffect, useMemo, useRef } from 'react'\nimport { createSanityChatTransport } from './_internal/chat-transport'\nimport { buildSendBody } from './_internal/messages'\nimport type { OutputFormat } from './types'\n\n/** `useChat` options that {@link useContentAgentChat} owns; the rest pass through. */\ntype ManagedChatOptions =\n  | 'id'\n  | 'transport'\n  | 'resume'\n  | 'messages'\n  | 'onError'\n  | 'onFinish'\n  | 'onData'\n\n/** A value, or a getter resolved at send time (avoids stale closures). */\ntype Resolvable<T> = T | (() => T | undefined)\n\n/**\n * Options for {@link useContentAgentChat}.\n *\n * @category React\n */\nexport interface UseContentAgentChatOptions<UI_MESSAGE extends UIMessage = UIMessage> {\n  /** Sanity organization ID. When undefined, no transport is built. */\n  organizationId: string | undefined\n  /** Stable thread id. When undefined, no transport is built. */\n  threadId: string | undefined\n  /**\n   * Base URL for the Sanity API.\n   * @default 'https://api.sanity.io'\n   */\n  baseURL?: string\n  /** API version segment, e.g. `'v2026-01-12'`. */\n  apiVersion?: string\n  /** Bearer token, or a getter read at request time. */\n  token?: string | (() => string | undefined)\n  /** Target application; pass a getter to read it fresh on each turn. */\n  application?: Resolvable<Application>\n  /** Per-turn request context; pass a getter to read it fresh on each turn. */\n  context?: Resolvable<Context>\n  /** Directive output format (`'directives'` for custom client rendering). */\n  format?: OutputFormat\n  /** Identifies the creating client (e.g. `'dashboard'`). */\n  clientId?: string\n  /**\n   * When true, reconnect to an in-flight stream once per thread (page reload\n   * or thread switch). The SDK's `resume: true` only fires on first mount, so\n   * this hook drives resume per (Chat x threadId) pair instead.\n   */\n  autoResume?: boolean\n  /** Initial messages (e.g. server-rendered history). */\n  messages?: UI_MESSAGE[]\n  onError?: (error: Error) => void\n  onFinish?: () => void\n  onData?: (dataPart: { type: string; data: unknown }) => void\n  /**\n   * Any other `useChat` options to forward (e.g. `onToolCall`, `generateId`,\n   * `experimental_throttle`). The options this hook manages (transport, id,\n   * resume, messages, the callbacks above) take precedence.\n   */\n  chatOptions?: Omit<UseChatOptions<UI_MESSAGE>, ManagedChatOptions>\n}\n\n/**\n * Options for {@link useSanityChatResume}.\n *\n * @category React\n */\nexport interface UseSanityChatResumeOptions {\n  /**\n   * When true, reconnect to an in-flight stream once per thread (page reload\n   * or thread switch). The SDK's `resume: true` only fires on first mount, so\n   * this drives resume per (Chat x threadId) pair instead.\n   */\n  autoResume?: boolean\n}\n\n/**\n * Add Sanity resume semantics to a `useChat` instance you own: reconnect to an\n * in-flight stream once per thread, and abort the previous Chat's stream when\n * the thread changes. Use this when you need full control of the `useChat`\n * call; {@link useContentAgentChat} composes it for the turnkey path.\n *\n * @category React\n *\n * @example\n * ```tsx\n * const transport = useMemo(() => createSanityChatTransport({ ... }), [...])\n * const chat = useChat({ id: threadId, transport, onToolCall })\n * useSanityChatResume(chat, { autoResume: threadExistsOnBackend })\n * ```\n */\nexport function useSanityChatResume<UI_MESSAGE extends UIMessage>(\n  chat: Pick<UseChatHelpers<UI_MESSAGE>, 'id' | 'status' | 'stop' | 'resumeStream'>,\n  options?: UseSanityChatResumeOptions,\n): void {\n  const { autoResume = false } = options ?? {}\n  const { id: threadId, status, stop, resumeStream } = chat\n\n  // Stop the previous Chat when the thread changes. The SDK recreates the Chat\n  // on `id` change but leaves the old fetch running; the cleanup closure\n  // captures the prior `stop`, so it aborts the OLD Chat.\n  useEffect(() => {\n    return () => void stop().catch(() => {})\n  }, [stop])\n\n  // Resume any in-flight stream once per (Chat x threadId). Skipped unless idle\n  // so a concurrent send and resume don't collide.\n  const resumeEvaluatedForRef = useRef<string | undefined>(undefined)\n  useEffect(() => {\n    if (!autoResume || !threadId) return\n    if (status !== 'ready') return\n    if (resumeEvaluatedForRef.current === threadId) return\n    resumeEvaluatedForRef.current = threadId\n    void resumeStream()\n  }, [autoResume, threadId, status, resumeStream])\n}\n\n/**\n * `useChat` wired to the Sanity Content Agent: transport with bearer auth and\n * transparent resume, per-turn body shaping (last message wire-shaped, plus\n * application/context/format/clientId), `x-request-id` idempotency, resume on\n * thread change, and stream cleanup when the thread changes.\n *\n * Returns the standard `useChat` helpers, so messages, status, sendMessage,\n * stop, resumeStream, and setMessages all behave exactly as upstream.\n *\n * @category React\n *\n * @example\n * ```tsx\n * const chat = useContentAgentChat({\n *   organizationId,\n *   threadId,\n *   token: () => client.config().token,\n *   application,\n *   autoResume: threadExistsOnBackend,\n * })\n * ```\n */\nexport function useContentAgentChat<UI_MESSAGE extends UIMessage = UIMessage>(\n  options: UseContentAgentChatOptions<UI_MESSAGE>,\n): UseChatHelpers<UI_MESSAGE> {\n  const {\n    organizationId,\n    threadId,\n    baseURL,\n    apiVersion,\n    token,\n    application,\n    context,\n    format,\n    clientId,\n    autoResume = false,\n    messages,\n    onError,\n    onFinish,\n    onData,\n  } = options\n\n  // Per-turn fields are read fresh on each send via a latest-ref so the\n  // transport (and the Chat behind it) only rebuilds on URL identity, never\n  // when the token refreshes or the user switches application/context.\n  const latest = useRef({ token, application, context, format, clientId })\n  latest.current = { token, application, context, format, clientId }\n\n  const transport = useMemo(() => {\n    if (!organizationId || !threadId) return undefined\n\n    return createSanityChatTransport<UI_MESSAGE>({\n      organizationId,\n      threadId,\n      baseURL,\n      apiVersion,\n      token: () => resolve(latest.current.token),\n      prepareSendMessagesRequest: ({ messages: turnMessages, body, headers }) => {\n        const current = latest.current\n        return {\n          headers: withRequestId(headers, turnMessages),\n          body: buildSendBody({\n            messages: turnMessages,\n            body,\n            application: resolve(current.application),\n            context: resolve(current.context),\n            format: current.format,\n            clientId: current.clientId,\n          }),\n        }\n      },\n    })\n  }, [organizationId, threadId, baseURL, apiVersion])\n\n  const chat = useChat<UI_MESSAGE>({\n    ...options.chatOptions,\n    id: threadId,\n    transport,\n    resume: false,\n    messages,\n    onError,\n    onFinish,\n    onData,\n  })\n\n  useSanityChatResume(chat, { autoResume })\n\n  return chat\n}\n\nfunction resolve<T>(value: Resolvable<T> | undefined): T | undefined {\n  return typeof value === 'function' ? (value as () => T | undefined)() : value\n}\n\n/** Spread the SDK's base headers and stamp `x-request-id` from the last user\n *  turn so the optimistic SDK message and the server share one id. */\nfunction withRequestId(headers: HeadersInit | undefined, messages: UIMessage[]): HeadersInit {\n  const merged: Record<string, string> = {}\n  new Headers(headers).forEach((value, key) => {\n    merged[key] = value\n  })\n  const lastUser = [...messages].reverse().find((m) => m.role === 'user')\n  if (lastUser) merged['x-request-id'] = lastUser.id\n  return merged\n}\n"],"names":[],"mappings":";;;;AAgGO,SAAS,oBACd,MACA,SACM;AACN,QAAM,EAAE,aAAa,GAAA,IAAU,WAAW,CAAA,GACpC,EAAE,IAAI,UAAU,QAAQ,MAAM,iBAAiB;AAKrD,YAAU,MACD,MAAG;AAAQ,SAAA,EAAO,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EAAA,GACtC,CAAC,IAAI,CAAC;AAIT,QAAM,wBAAwB,OAA2B,MAAS;AAClE,YAAU,MAAM;AACV,KAAC,cAAc,CAAC,YAChB,WAAW,WACX,sBAAsB,YAAY,aACtC,sBAAsB,UAAU,UAC3B,aAAA;AAAA,EACP,GAAG,CAAC,YAAY,UAAU,QAAQ,YAAY,CAAC;AACjD;AAwBO,SAAS,oBACd,SAC4B;AAC5B,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE,SAKE,SAAS,OAAO,EAAE,OAAO,aAAa,SAAS,QAAQ,UAAU;AACvE,SAAO,UAAU,EAAE,OAAO,aAAa,SAAS,QAAQ,SAAA;AAExD,QAAM,YAAY,QAAQ,MAAM;AAC9B,QAAI,EAAA,CAAC,kBAAkB,CAAC;AAExB,aAAO,0BAAsC;AAAA,QAC3C;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAO,MAAM,QAAQ,OAAO,QAAQ,KAAK;AAAA,QACzC,4BAA4B,CAAC,EAAE,UAAU,cAAc,MAAM,cAAc;AACzE,gBAAM,UAAU,OAAO;AACvB,iBAAO;AAAA,YACL,SAAS,cAAc,SAAS,YAAY;AAAA,YAC5C,MAAM,cAAc;AAAA,cAClB,UAAU;AAAA,cACV;AAAA,cACA,aAAa,QAAQ,QAAQ,WAAW;AAAA,cACxC,SAAS,QAAQ,QAAQ,OAAO;AAAA,cAChC,QAAQ,QAAQ;AAAA,cAChB,UAAU,QAAQ;AAAA,YAAA,CACnB;AAAA,UAAA;AAAA,QAEL;AAAA,MAAA,CACD;AAAA,EACH,GAAG,CAAC,gBAAgB,UAAU,SAAS,UAAU,CAAC,GAE5C,OAAO,QAAoB;AAAA,IAC/B,GAAG,QAAQ;AAAA,IACX,IAAI;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AAED,SAAA,oBAAoB,MAAM,EAAE,WAAA,CAAY,GAEjC;AACT;AAEA,SAAS,QAAW,OAAiD;AACnE,SAAO,OAAO,SAAU,aAAc,MAAA,IAAkC;AAC1E;AAIA,SAAS,cAAc,SAAkC,UAAoC;AAC3F,QAAM,SAAiC,CAAA;AACvC,MAAI,QAAQ,OAAO,EAAE,QAAQ,CAAC,OAAO,QAAQ;AAC3C,WAAO,GAAG,IAAI;AAAA,EAChB,CAAC;AACD,QAAM,WAAW,CAAC,GAAG,QAAQ,EAAE,QAAA,EAAU,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM;AACtE,SAAI,aAAU,OAAO,cAAc,IAAI,SAAS,KACzC;AACT;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "content-agent",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "Vercel AI SDK provider for Sanity Content Agent API",
   "keywords": [
     "sanity",
@@ -23,6 +23,15 @@
     "./agent": {
       "default": "./dist/content-agent.js"
     },
+    "./transport": {
+      "default": "./dist/chat-transport.js"
+    },
+    "./messages": {
+      "default": "./dist/messages.js"
+    },
+    "./react": {
+      "default": "./dist/react.js"
+    },
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.ts",
@@ -37,10 +46,16 @@
     "@sanity/agent-types": "0.1.4"
   },
   "devDependencies": {
+    "@ai-sdk/react": "^3.0.0",
     "@sanity/pkg-utils": "^10.4.1",
+    "@testing-library/react": "^16.0.0",
     "@types/node": "^22.19.7",
+    "@types/react": "^19.0.0",
     "ai": "^6.0.168",
+    "jsdom": "^26.0.0",
     "openapi-typescript": "^7.10.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "typedoc": "^0.28.17",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
@@ -48,11 +63,19 @@
     "@repo/tsconfig": "0.0.0"
   },
   "peerDependencies": {
-    "ai": ">=6.0.0"
+    "@ai-sdk/react": ">=3.0.0",
+    "ai": ">=6.0.0",
+    "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
+    "@ai-sdk/react": {
+      "optional": true
+    },
     "ai": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "publishConfig": {