@osdk/react 2.40.0 → 2.41.0-main-d24cc61b1e7fde7722d8229ed2b6821f5ce1bf8a

package/build/cjs/public/experimental/aip.cjs

@@ -0,0 +1,389 @@
+'use strict';
+
+var aipCore = require('@osdk/aip-core');
+var React = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+// src/aip/useChat.ts
+
+// src/aip/chatStore.ts
+function createChatStore(options) {
+  let state = {
+    messages: options.initialMessages ?? [],
+    status: "ready",
+    error: void 0
+  };
+  const subscribers = /* @__PURE__ */ new Set();
+  const throttleMs = options.throttleMs ?? 0;
+  let pendingNotify;
+  const notifyNow = () => {
+    if (pendingNotify != null) {
+      clearTimeout(pendingNotify);
+      pendingNotify = void 0;
+    }
+    for (const s of subscribers) {
+      s();
+    }
+  };
+  const notifyThrottled = () => {
+    if (throttleMs <= 0) {
+      notifyNow();
+      return;
+    }
+    if (pendingNotify != null) {
+      return;
+    }
+    pendingNotify = setTimeout(notifyNow, throttleMs);
+  };
+  return {
+    getSnapshot: () => state,
+    subscribe: (notify) => {
+      subscribers.add(notify);
+      return () => {
+        subscribers.delete(notify);
+      };
+    },
+    setState: (next) => {
+      state = typeof next === "function" ? next(state) : next;
+      notifyNow();
+    },
+    setStateThrottled: (next) => {
+      state = typeof next === "function" ? next(state) : next;
+      notifyThrottled();
+    }
+  };
+}
+async function runChatStream(ctx, transport, chatId, seed, trigger) {
+  ctx.abortRef.current?.abort();
+  const ctrl = new AbortController();
+  ctx.abortRef.current = ctrl;
+  ctx.stoppedRef.current = false;
+  const assistantId = aipCore.generateMessageId();
+  try {
+    const stream = await transport.sendMessages({
+      trigger,
+      chatId,
+      messageId: assistantId,
+      messages: seed.slice(),
+      abortSignal: ctrl.signal
+    });
+    await drainStream(ctx, stream, assistantId, ctrl);
+  } catch (err) {
+    handleStreamError(ctx, err, ctrl);
+  }
+}
+async function drainStream(ctx, stream, assistantMessageId, capturedCtrl) {
+  const {
+    store
+  } = ctx;
+  const reader = stream.getReader();
+  let textBuf = "";
+  const isStale = () => ctx.abortRef.current != null && ctx.abortRef.current !== capturedCtrl;
+  const isOrphaned = () => {
+    const messages = store.getSnapshot().messages;
+    return textBuf.length > 0 && !messages.some((m) => m.id === assistantMessageId);
+  };
+  try {
+    while (true) {
+      const {
+        done,
+        value
+      } = await reader.read();
+      if (done) {
+        break;
+      }
+      if (isStale()) {
+        await reader.cancel();
+        return;
+      }
+      if (isOrphaned()) {
+        await reader.cancel();
+        store.setState((prev) => ({
+          ...prev,
+          status: "ready"
+        }));
+        return;
+      }
+      if (value.type === "text-delta") {
+        textBuf += value.delta;
+        upsertAssistantText(store, assistantMessageId, textBuf);
+      } else if (value.type === "error") {
+        if (ctx.stoppedRef.current || capturedCtrl.signal.aborted) {
+          return;
+        }
+        await reader.cancel();
+        throw new Error(value.errorText);
+      }
+    }
+    if (isStale()) {
+      return;
+    }
+    store.setState((prev) => ({
+      ...prev,
+      status: "ready"
+    }));
+    const finalSnap = store.getSnapshot();
+    const finalMessage = finalSnap.messages.find((m) => m.id === assistantMessageId);
+    if (finalMessage != null && ctx.onFinish != null) {
+      ctx.onFinish({
+        message: finalMessage,
+        messages: finalSnap.messages
+      });
+    }
+  } catch (err) {
+    handleStreamError(ctx, err, capturedCtrl);
+  } finally {
+    reader.releaseLock();
+  }
+}
+function upsertAssistantText(store, assistantMessageId, text) {
+  store.setStateThrottled((prev) => {
+    const exists = prev.messages.some((m) => m.id === assistantMessageId);
+    const messages = exists ? prev.messages.map((m) => m.id === assistantMessageId ? {
+      ...m,
+      parts: [{
+        type: "text",
+        text
+      }]
+    } : m) : [...prev.messages, {
+      id: assistantMessageId,
+      role: "assistant",
+      parts: [{
+        type: "text",
+        text
+      }]
+    }];
+    return {
+      ...prev,
+      status: "streaming",
+      messages
+    };
+  });
+}
+function handleStreamError(ctx, err, capturedCtrl) {
+  if (ctx.abortRef.current != null && ctx.abortRef.current !== capturedCtrl) {
+    return;
+  }
+  const error = err instanceof Error ? err : new Error(String(err));
+  if (ctx.stoppedRef.current || error.name === "AbortError" || capturedCtrl.signal.aborted) {
+    ctx.store.setState((prev) => ({
+      ...prev,
+      status: "ready",
+      error: void 0
+    }));
+    return;
+  }
+  ctx.store.setState((prev) => ({
+    ...prev,
+    status: "error",
+    error
+  }));
+  ctx.onError?.(error);
+}
+
+// src/aip/useChat.ts
+function useChat(options) {
+  const {
+    onFinish,
+    onError
+  } = options;
+  const id = React__default.default.useMemo(() => options.id ?? aipCore.generateMessageId(), [options.id]);
+  const headersKey = JSON.stringify(options.headers ?? null);
+  const stopSequencesKey = JSON.stringify(options.stopSequences ?? null);
+  const transport = React__default.default.useMemo(
+    () => {
+      if (options.transport != null) {
+        return options.transport;
+      }
+      if (options.model == null) {
+        throw new Error("useChat: `model` is required when no `transport` is provided.");
+      }
+      const built = {
+        model: options.model,
+        system: options.system,
+        temperature: options.temperature,
+        maxOutputTokens: options.maxOutputTokens,
+        topP: options.topP,
+        presencePenalty: options.presencePenalty,
+        frequencyPenalty: options.frequencyPenalty,
+        stopSequences: options.stopSequences,
+        seed: options.seed,
+        headers: options.headers
+      };
+      return new aipCore.LmsChatTransport(built);
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [options.transport, options.model, options.system, options.temperature, options.maxOutputTokens, options.topP, options.presencePenalty, options.frequencyPenalty, options.seed, headersKey, stopSequencesKey]
+  );
+  const store = React__default.default.useMemo(
+    () => createChatStore({
+      initialMessages: options.messages,
+      throttleMs: options.experimentalThrottle ?? 50
+    }),
+    // Recreating the store mid-session would drop chat state, so it's keyed
+    // only by `id`. Use `setMessages` to mutate messages at runtime.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [id]
+  );
+  const state = React__default.default.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+  const abortRef = React__default.default.useRef(void 0);
+  const stoppedRef = React__default.default.useRef(false);
+  const ctxRef = React__default.default.useRef({
+    store,
+    abortRef,
+    stoppedRef,
+    onFinish,
+    onError
+  });
+  ctxRef.current = {
+    store,
+    abortRef,
+    stoppedRef,
+    onFinish,
+    onError
+  };
+  const runStream = React__default.default.useCallback((seed, trigger) => runChatStream(ctxRef.current, transport, id, seed, trigger), [transport, id]);
+  const sendMessage = React__default.default.useCallback(async (input) => {
+    const userMsg = normalizeUserMessage(input);
+    const seeded = [...store.getSnapshot().messages, userMsg];
+    store.setState({
+      messages: seeded,
+      status: "submitted",
+      error: void 0
+    });
+    await runStream(seeded, "submit-message");
+  }, [store, runStream]);
+  const regenerate = React__default.default.useCallback(async (regenerateOpts) => {
+    const messages = store.getSnapshot().messages;
+    const cutoff = resolveRegenerateCutoff(messages, regenerateOpts?.messageId);
+    if (cutoff.kind === "noop") {
+      return;
+    }
+    if (cutoff.kind === "error") {
+      store.setState((prev) => ({
+        ...prev,
+        status: "error",
+        error: cutoff.error
+      }));
+      return;
+    }
+    const truncated = messages.slice(0, cutoff.index);
+    store.setState({
+      messages: truncated,
+      status: "submitted",
+      error: void 0
+    });
+    await runStream(truncated, "regenerate-message");
+  }, [store, runStream]);
+  const stop = React__default.default.useCallback(() => {
+    stoppedRef.current = true;
+    abortRef.current?.abort();
+    abortRef.current = void 0;
+  }, []);
+  const resumeStream = React__default.default.useCallback(async () => {
+    const stream = await transport.reconnectToStream({
+      chatId: id
+    });
+    if (stream == null) {
+      return;
+    }
+    abortRef.current?.abort();
+    const ctrl = new AbortController();
+    abortRef.current = ctrl;
+    const assistantId = aipCore.generateMessageId();
+    await drainStream(ctxRef.current, stream, assistantId, ctrl);
+  }, [transport, id]);
+  const clearError = React__default.default.useCallback(() => {
+    store.setState((prev) => prev.status === "error" ? {
+      ...prev,
+      status: "ready",
+      error: void 0
+    } : prev);
+  }, [store]);
+  const setMessages = React__default.default.useCallback((next) => {
+    store.setState((prev) => {
+      if (prev.status === "streaming" || prev.status === "submitted") {
+        return prev;
+      }
+      return {
+        ...prev,
+        messages: typeof next === "function" ? next(prev.messages) : next
+      };
+    });
+  }, [store]);
+  return React__default.default.useMemo(() => ({
+    id,
+    messages: state.messages,
+    setMessages,
+    status: state.status,
+    error: state.error,
+    sendMessage,
+    regenerate,
+    stop,
+    resumeStream,
+    clearError
+  }), [id, state.messages, state.status, state.error, setMessages, sendMessage, regenerate, stop, resumeStream, clearError]);
+}
+function resolveRegenerateCutoff(messages, messageId) {
+  if (messageId != null) {
+    const index = messages.findIndex((m) => m.id === messageId);
+    if (index < 0) {
+      return {
+        kind: "noop"
+      };
+    }
+    const target = messages[index];
+    if (target == null || target.role !== "assistant") {
+      return {
+        kind: "error",
+        error: new Error(`useChat.regenerate: messageId "${messageId}" is not an assistant message; only assistant messages can be regenerated.`)
+      };
+    }
+    return {
+      kind: "ok",
+      index
+    };
+  }
+  const lastAssistant = findLastAssistantIndex(messages);
+  if (lastAssistant < 0) {
+    return {
+      kind: "noop"
+    };
+  }
+  return {
+    kind: "ok",
+    index: lastAssistant
+  };
+}
+function normalizeUserMessage(input) {
+  if ("text" in input) {
+    return {
+      id: aipCore.generateMessageId(),
+      role: "user",
+      parts: [{
+        type: "text",
+        text: input.text
+      }]
+    };
+  }
+  return {
+    id: aipCore.generateMessageId(),
+    role: input.role,
+    parts: input.parts
+  };
+}
+function findLastAssistantIndex(arr) {
+  for (let i = arr.length - 1; i >= 0; i--) {
+    if (arr[i]?.role === "assistant") {
+      return i;
+    }
+  }
+  return -1;
+}
+
+exports.useChat = useChat;
+//# sourceMappingURL=aip.cjs.map
+//# sourceMappingURL=aip.cjs.map

package/build/cjs/public/experimental/aip.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aip/chatStore.ts","../../../../src/aip/chatStream.ts","../../../../src/aip/useChat.ts"],"names":["generateMessageId","React","LmsChatTransport"],"mappings":"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","file":"aip.cjs","sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Tiny pub-sub store backing `useChat`. Throttles subscriber notifications so\n * fast token-delta streams don't trigger one render per token.\n */\nexport function createChatStore(options) {\n  let state = {\n    messages: options.initialMessages ?? [],\n    status: \"ready\",\n    error: undefined\n  };\n  const subscribers = new Set();\n  const throttleMs = options.throttleMs ?? 0;\n  let pendingNotify;\n  const notifyNow = () => {\n    if (pendingNotify != null) {\n      clearTimeout(pendingNotify);\n      pendingNotify = undefined;\n    }\n    for (const s of subscribers) {\n      s();\n    }\n  };\n  const notifyThrottled = () => {\n    if (throttleMs <= 0) {\n      notifyNow();\n      return;\n    }\n    if (pendingNotify != null) {\n      return;\n    }\n    pendingNotify = setTimeout(notifyNow, throttleMs);\n  };\n  return {\n    getSnapshot: () => state,\n    subscribe: notify => {\n      subscribers.add(notify);\n      return () => {\n        subscribers.delete(notify);\n      };\n    },\n    setState: next => {\n      state = typeof next === \"function\" ? next(state) : next;\n      notifyNow();\n    },\n    setStateThrottled: next => {\n      state = typeof next === \"function\" ? next(state) : next;\n      notifyThrottled();\n    }\n  };\n}","/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { generateMessageId } from \"@osdk/aip-core\";\n\n/**\n * Mutable orchestration handle threaded through the streaming functions.\n * Holds everything they need to read snapshots, mutate state, and check\n * whether their stream is still the active one.\n */\n\nexport async function runChatStream(ctx, transport, chatId, seed, trigger) {\n  ctx.abortRef.current?.abort();\n  const ctrl = new AbortController();\n  ctx.abortRef.current = ctrl;\n  ctx.stoppedRef.current = false;\n  const assistantId = generateMessageId();\n  try {\n    const stream = await transport.sendMessages({\n      trigger,\n      chatId,\n      messageId: assistantId,\n      messages: seed.slice(),\n      abortSignal: ctrl.signal\n    });\n    await drainStream(ctx, stream, assistantId, ctrl);\n  } catch (err) {\n    handleStreamError(ctx, err, ctrl);\n  }\n}\nexport async function drainStream(ctx, stream, assistantMessageId, capturedCtrl) {\n  const {\n    store\n  } = ctx;\n  const reader = stream.getReader();\n  let textBuf = \"\";\n  const isStale = () => ctx.abortRef.current != null && ctx.abortRef.current !== capturedCtrl;\n\n  // Caller dropped our assistant message via `setMessages` mid-stream.\n  // Treat as \"the consumer no longer wants this stream\" — quietly stop.\n  const isOrphaned = () => {\n    const messages = store.getSnapshot().messages;\n    return textBuf.length > 0 && !messages.some(m => m.id === assistantMessageId);\n  };\n  try {\n    while (true) {\n      const {\n        done,\n        value\n      } = await reader.read();\n      if (done) {\n        break;\n      }\n      if (isStale()) {\n        await reader.cancel();\n        return;\n      }\n      if (isOrphaned()) {\n        await reader.cancel();\n        store.setState(prev => ({\n          ...prev,\n          status: \"ready\"\n        }));\n        return;\n      }\n      if (value.type === \"text-delta\") {\n        textBuf += value.delta;\n        upsertAssistantText(store, assistantMessageId, textBuf);\n      } else if (value.type === \"error\") {\n        if (ctx.stoppedRef.current || capturedCtrl.signal.aborted) {\n          return;\n        }\n        await reader.cancel();\n        throw new Error(value.errorText);\n      }\n    }\n    if (isStale()) {\n      return;\n    }\n    store.setState(prev => ({\n      ...prev,\n      status: \"ready\"\n    }));\n    const finalSnap = store.getSnapshot();\n    const finalMessage = finalSnap.messages.find(m => m.id === assistantMessageId);\n    if (finalMessage != null && ctx.onFinish != null) {\n      ctx.onFinish({\n        message: finalMessage,\n        messages: finalSnap.messages\n      });\n    }\n  } catch (err) {\n    handleStreamError(ctx, err, capturedCtrl);\n  } finally {\n    reader.releaseLock();\n  }\n}\nfunction upsertAssistantText(store, assistantMessageId, text) {\n  store.setStateThrottled(prev => {\n    const exists = prev.messages.some(m => m.id === assistantMessageId);\n    const messages = exists ? prev.messages.map(m => m.id === assistantMessageId ? {\n      ...m,\n      parts: [{\n        type: \"text\",\n        text\n      }]\n    } : m) : [...prev.messages, {\n      id: assistantMessageId,\n      role: \"assistant\",\n      parts: [{\n        type: \"text\",\n        text\n      }]\n    }];\n    return {\n      ...prev,\n      status: \"streaming\",\n      messages\n    };\n  });\n}\nfunction handleStreamError(ctx, err, capturedCtrl) {\n  if (ctx.abortRef.current != null && ctx.abortRef.current !== capturedCtrl) {\n    return;\n  }\n  const error = err instanceof Error ? err : new Error(String(err));\n  if (ctx.stoppedRef.current || error.name === \"AbortError\" || capturedCtrl.signal.aborted) {\n    ctx.store.setState(prev => ({\n      ...prev,\n      status: \"ready\",\n      error: undefined\n    }));\n    return;\n  }\n  ctx.store.setState(prev => ({\n    ...prev,\n    status: \"error\",\n    error\n  }));\n  ctx.onError?.(error);\n}","/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { generateMessageId, LmsChatTransport } from \"@osdk/aip-core\";\nimport React from \"react\";\nimport { createChatStore } from \"./chatStore.js\";\nimport { drainStream, runChatStream } from \"./chatStream.js\";\n\n/**\n * Options for {@link useChat}.\n *\n * v0 covers text-only chat. Tools, multi-step agent loops, and stream\n * resume are not supported.\n */\n\n/** Return value of {@link useChat}. */\n\n/** Input shape accepted by `sendMessage`. */\n\n/**\n * React hook for streaming chat completions through `@osdk/aip-core`'s\n * `streamText`.\n *\n * @example\n * ```tsx\n * const { messages, status, sendMessage, stop, error } = useChat({\n *   model: foundryModel({ client, model: \"gpt-4o\" }),\n *   system: \"You are a concise assistant.\",\n * });\n * ```\n */\nexport function useChat(options) {\n  const {\n    onFinish,\n    onError\n  } = options;\n  const id = React.useMemo(() => options.id ?? generateMessageId(), [options.id]);\n\n  // JSON-stringify keys keep the memo stable when callers pass inline objects.\n  const headersKey = JSON.stringify(options.headers ?? null);\n  const stopSequencesKey = JSON.stringify(options.stopSequences ?? null);\n  const transport = React.useMemo(() => {\n    if (options.transport != null) {\n      return options.transport;\n    }\n    if (options.model == null) {\n      throw new Error(\"useChat: `model` is required when no `transport` is provided.\");\n    }\n    const built = {\n      model: options.model,\n      system: options.system,\n      temperature: options.temperature,\n      maxOutputTokens: options.maxOutputTokens,\n      topP: options.topP,\n      presencePenalty: options.presencePenalty,\n      frequencyPenalty: options.frequencyPenalty,\n      stopSequences: options.stopSequences,\n      seed: options.seed,\n      headers: options.headers\n    };\n    return new LmsChatTransport(built);\n  },\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  [options.transport, options.model, options.system, options.temperature, options.maxOutputTokens, options.topP, options.presencePenalty, options.frequencyPenalty, options.seed, headersKey, stopSequencesKey]);\n  const store = React.useMemo(() => createChatStore({\n    initialMessages: options.messages,\n    throttleMs: options.experimentalThrottle ?? 50\n  }),\n  // Recreating the store mid-session would drop chat state, so it's keyed\n  // only by `id`. Use `setMessages` to mutate messages at runtime.\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  [id]);\n  const state = React.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);\n  const abortRef = React.useRef(undefined);\n  const stoppedRef = React.useRef(false);\n  const ctxRef = React.useRef({\n    store,\n    abortRef,\n    stoppedRef,\n    onFinish,\n    onError\n  });\n  ctxRef.current = {\n    store,\n    abortRef,\n    stoppedRef,\n    onFinish,\n    onError\n  };\n  const runStream = React.useCallback((seed, trigger) => runChatStream(ctxRef.current, transport, id, seed, trigger), [transport, id]);\n  const sendMessage = React.useCallback(async input => {\n    const userMsg = normalizeUserMessage(input);\n    const seeded = [...store.getSnapshot().messages, userMsg];\n    store.setState({\n      messages: seeded,\n      status: \"submitted\",\n      error: undefined\n    });\n    await runStream(seeded, \"submit-message\");\n  }, [store, runStream]);\n  const regenerate = React.useCallback(async regenerateOpts => {\n    const messages = store.getSnapshot().messages;\n    const cutoff = resolveRegenerateCutoff(messages, regenerateOpts?.messageId);\n    if (cutoff.kind === \"noop\") {\n      return;\n    }\n    if (cutoff.kind === \"error\") {\n      store.setState(prev => ({\n        ...prev,\n        status: \"error\",\n        error: cutoff.error\n      }));\n      return;\n    }\n    const truncated = messages.slice(0, cutoff.index);\n    store.setState({\n      messages: truncated,\n      status: \"submitted\",\n      error: undefined\n    });\n    await runStream(truncated, \"regenerate-message\");\n  }, [store, runStream]);\n  const stop = React.useCallback(() => {\n    stoppedRef.current = true;\n    abortRef.current?.abort();\n    abortRef.current = undefined;\n  }, []);\n  const resumeStream = React.useCallback(async () => {\n    const stream = await transport.reconnectToStream({\n      chatId: id\n    });\n    if (stream == null) {\n      return;\n    }\n    abortRef.current?.abort();\n    const ctrl = new AbortController();\n    abortRef.current = ctrl;\n    const assistantId = generateMessageId();\n    await drainStream(ctxRef.current, stream, assistantId, ctrl);\n  }, [transport, id]);\n  const clearError = React.useCallback(() => {\n    // Resetting from streaming/submitted would race the in-flight stream, so\n    // only reset when status === \"error\".\n    store.setState(prev => prev.status === \"error\" ? {\n      ...prev,\n      status: \"ready\",\n      error: undefined\n    } : prev);\n  }, [store]);\n  const setMessages = React.useCallback(next => {\n    store.setState(prev => {\n      if (prev.status === \"streaming\" || prev.status === \"submitted\") {\n        return prev;\n      }\n      return {\n        ...prev,\n        messages: typeof next === \"function\" ? next(prev.messages) : next\n      };\n    });\n  }, [store]);\n  return React.useMemo(() => ({\n    id,\n    messages: state.messages,\n    setMessages,\n    status: state.status,\n    error: state.error,\n    sendMessage,\n    regenerate,\n    stop,\n    resumeStream,\n    clearError\n  }), [id, state.messages, state.status, state.error, setMessages, sendMessage, regenerate, stop, resumeStream, clearError]);\n}\nfunction resolveRegenerateCutoff(messages, messageId) {\n  if (messageId != null) {\n    const index = messages.findIndex(m => m.id === messageId);\n    if (index < 0) {\n      return {\n        kind: \"noop\"\n      };\n    }\n    const target = messages[index];\n    if (target == null || target.role !== \"assistant\") {\n      return {\n        kind: \"error\",\n        error: new Error(`useChat.regenerate: messageId \"${messageId}\" is ` + `not an assistant message; only assistant messages can be regenerated.`)\n      };\n    }\n    return {\n      kind: \"ok\",\n      index\n    };\n  }\n  const lastAssistant = findLastAssistantIndex(messages);\n  if (lastAssistant < 0) {\n    return {\n      kind: \"noop\"\n    };\n  }\n  return {\n    kind: \"ok\",\n    index: lastAssistant\n  };\n}\nfunction normalizeUserMessage(input) {\n  if (\"text\" in input) {\n    return {\n      id: generateMessageId(),\n      role: \"user\",\n      parts: [{\n        type: \"text\",\n        text: input.text\n      }]\n    };\n  }\n  return {\n    id: generateMessageId(),\n    role: input.role,\n    parts: input.parts\n  };\n}\nfunction findLastAssistantIndex(arr) {\n  for (let i = arr.length - 1; i >= 0; i--) {\n    if (arr[i]?.role === \"assistant\") {\n      return i;\n    }\n  }\n  return -1;\n}"]}

package/build/cjs/public/experimental/aip.d.cts

@@ -0,0 +1,83 @@
+import { UIMessage, LanguageModel, ChatTransport } from '@osdk/aip-core';
+export { UIMessage, UIMessageChunk } from '@osdk/aip-core';
+
+type ChatStatus = "ready" | "submitted" | "streaming" | "error";
+
+/**
+ * Options for {@link useChat}.
+ *
+ * v0 covers text-only chat. Tools, multi-step agent loops, and stream
+ * resume are not supported.
+ */
+interface UseChatOptions {
+    /** Required when no `transport` is provided: the LMS-backed model. */
+    model?: LanguageModel;
+    /** System prompt prepended to every request. Forwarded to the default transport. */
+    system?: string;
+    /** Sampling controls. Forwarded to the default transport. */
+    temperature?: number;
+    maxOutputTokens?: number;
+    topP?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    stopSequences?: Array<string>;
+    seed?: number;
+    headers?: Record<string, string | undefined>;
+    /** Stable chat id. A stable id is generated if not provided. */
+    id?: string;
+    /** Initial messages — used as the seed snapshot. */
+    messages?: ReadonlyArray<UIMessage>;
+    /** Override the transport. Defaults to a new `LmsChatTransport(options)`. */
+    transport?: ChatTransport<UIMessage>;
+    /**
+     * Throttle subscriber notifications during streaming (ms). Default 50ms,
+     * which keeps token-by-token rendering smooth without rerendering per token.
+     */
+    experimentalThrottle?: number;
+    /** Fires when an in-flight stream errors out. */
+    onError?: (error: Error) => void;
+    /** Fires once after a stream completes successfully. */
+    onFinish?: (event: {
+        message: UIMessage;
+        messages: ReadonlyArray<UIMessage>;
+    }) => void;
+}
+/** Return value of {@link useChat}. */
+interface UseChatReturn {
+    id: string;
+    messages: ReadonlyArray<UIMessage>;
+    /** No-op while a stream is in flight (`status === "streaming" | "submitted"`). Call `stop()` first to mutate during a stream. */
+    setMessages: (messages: ReadonlyArray<UIMessage> | ((prev: ReadonlyArray<UIMessage>) => ReadonlyArray<UIMessage>)) => void;
+    status: ChatStatus;
+    error: Error | undefined;
+    sendMessage: (message: SendMessageInput) => Promise<void>;
+    regenerate: (options?: {
+        messageId?: string;
+    }) => Promise<void>;
+    stop: () => void;
+    /** Calls `transport.reconnectToStream`. v0: LMS returns null, so this is a no-op. */
+    resumeStream: () => Promise<void>;
+    clearError: () => void;
+}
+/** Input shape accepted by `sendMessage`. */
+type SendMessageInput = {
+    text: string;
+} | {
+    role: "user";
+    parts: UIMessage["parts"];
+};
+/**
+ * React hook for streaming chat completions through `@osdk/aip-core`'s
+ * `streamText`.
+ *
+ * @example
+ * ```tsx
+ * const { messages, status, sendMessage, stop, error } = useChat({
+ *   model: foundryModel({ client, model: "gpt-4o" }),
+ *   system: "You are a concise assistant.",
+ * });
+ * ```
+ */
+declare function useChat(options: UseChatOptions): UseChatReturn;
+
+export { type ChatStatus, type SendMessageInput, type UseChatOptions, type UseChatReturn, useChat };

package/build/cjs/public/experimental.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkL33DWZUR_cjs = require('../chunk-L33DWZUR.cjs');
+var chunkQNNQV2NH_cjs = require('../chunk-QNNQV2NH.cjs');
 var chunkOGP2DK2V_cjs = require('../chunk-OGP2DK2V.cjs');
 require('../chunk-UKQGMTMG.cjs');
 require('../chunk-DO3NFBKN.cjs');
@@ -9,63 +9,63 @@ require('../chunk-DO3NFBKN.cjs');
 
 Object.defineProperty(exports, "OsdkProvider2", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.OsdkProvider; }
+  get: function () { return chunkQNNQV2NH_cjs.OsdkProvider; }
 });
 Object.defineProperty(exports, "useDebouncedCallback", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useDebouncedCallback; }
+  get: function () { return chunkQNNQV2NH_cjs.useDebouncedCallback; }
 });
 Object.defineProperty(exports, "useLinks", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useLinks; }
+  get: function () { return chunkQNNQV2NH_cjs.useLinks; }
 });
 Object.defineProperty(exports, "useObjectSet", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useObjectSet; }
+  get: function () { return chunkQNNQV2NH_cjs.useObjectSet; }
 });
 Object.defineProperty(exports, "useOsdkAction", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkAction; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkAction; }
 });
 Object.defineProperty(exports, "useOsdkAggregation", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkAggregation; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkAggregation; }
 });
 Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkClient; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkClient; }
 });
 Object.defineProperty(exports, "useOsdkClient2", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkClient; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkClient; }
 });
 Object.defineProperty(exports, "useOsdkFunction", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkFunction; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkFunction; }
 });
 Object.defineProperty(exports, "useOsdkFunctions", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkFunctions; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkFunctions; }
 });
 Object.defineProperty(exports, "useOsdkMetadata", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkMetadata; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkMetadata; }
 });
 Object.defineProperty(exports, "useOsdkObject", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkObject; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkObject; }
 });
 Object.defineProperty(exports, "useOsdkObjects", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useOsdkObjects; }
+  get: function () { return chunkQNNQV2NH_cjs.useOsdkObjects; }
 });
 Object.defineProperty(exports, "useRegisterUserAgent", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useRegisterUserAgent; }
+  get: function () { return chunkQNNQV2NH_cjs.useRegisterUserAgent; }
 });
 Object.defineProperty(exports, "useStableObjectSet", {
   enumerable: true,
-  get: function () { return chunkL33DWZUR_cjs.useStableObjectSet; }
+  get: function () { return chunkQNNQV2NH_cjs.useStableObjectSet; }
 });
 Object.defineProperty(exports, "getRegisteredDevTools", {
   enumerable: true,

package/build/esm/aip/chatStore.js

@@ -0,0 +1,67 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Tiny pub-sub store backing `useChat`. Throttles subscriber notifications so
+ * fast token-delta streams don't trigger one render per token.
+ */
+export function createChatStore(options) {
+  let state = {
+    messages: options.initialMessages ?? [],
+    status: "ready",
+    error: undefined
+  };
+  const subscribers = new Set();
+  const throttleMs = options.throttleMs ?? 0;
+  let pendingNotify;
+  const notifyNow = () => {
+    if (pendingNotify != null) {
+      clearTimeout(pendingNotify);
+      pendingNotify = undefined;
+    }
+    for (const s of subscribers) {
+      s();
+    }
+  };
+  const notifyThrottled = () => {
+    if (throttleMs <= 0) {
+      notifyNow();
+      return;
+    }
+    if (pendingNotify != null) {
+      return;
+    }
+    pendingNotify = setTimeout(notifyNow, throttleMs);
+  };
+  return {
+    getSnapshot: () => state,
+    subscribe: notify => {
+      subscribers.add(notify);
+      return () => {
+        subscribers.delete(notify);
+      };
+    },
+    setState: next => {
+      state = typeof next === "function" ? next(state) : next;
+      notifyNow();
+    },
+    setStateThrottled: next => {
+      state = typeof next === "function" ? next(state) : next;
+      notifyThrottled();
+    }
+  };
+}
+//# sourceMappingURL=chatStore.js.map