@osdk/react 0.17.0-main-5dc557e9e321d23e8e150e8015c41ebe3b6f387c → 0.17.0

package/AGENTS.md

@@ -2,12 +2,10 @@
 
 ## Installing
 
-**Default: `pnpm add @osdk/react@latest`** — use a prerelease only if you specifically need an unreleased feature. Everything below is for when you are NOT on the latest stable.
+`pnpm add @osdk/react@latest`. Must install `@osdk/react` AND `@osdk/client` AND `@osdk/api` together, and the versions must line up tighter than the declared peer ranges. `@osdk/react` imports its observable runtime from `@osdk/client/observable`, which is version-locked across the three packages.
 
-Must install `@osdk/react` AND `@osdk/client` AND `@osdk/api` together, and versions must line up tighter than the declared peer ranges. `@osdk/react` imports unstable APIs from `@osdk/client/unstable-do-not-use` that move between releases without deprecation.
-
-- **Stable `@osdk/react`** (e.g. `0.14.x`) → latest stable `@osdk/client` and `@osdk/api` (`2.x`).
-- **Prerelease `@osdk/react`** (e.g. `0.10.0-beta.15`) → MUST use prerelease `@osdk/client` and `@osdk/api` from the same line. Stable releases will break.
+- **Stable `@osdk/react`** (e.g. `1.x`) → latest stable `@osdk/client` and `@osdk/api` (`2.x`).
+- **Prerelease `@osdk/react`** → MUST use prerelease `@osdk/client` and `@osdk/api` from the same line. Stable releases will break.
 
 To find the exact compatible `@osdk/client` and `@osdk/api` for any installed `@osdk/react`:
 
@@ -16,52 +14,43 @@ To find the exact compatible `@osdk/client` and `@osdk/api` for any installed `@
 3. If that entry has an `Updated dependencies` section, install the exact `@osdk/client@X.Y.Z` AND `@osdk/api@X.Y.Z` it lists
 4. If it does NOT, walk backwards to the most recent prior entry that does, and use those versions
 
-**Worked example** — installed `@osdk/react@0.10.0-beta.15`:
-
-- `0.10.0-beta.15` has no `Updated dependencies` section → walk back
-- `0.10.0-beta.14` lists `@osdk/client@2.8.0-beta.29` and `@osdk/api@2.8.0-beta.29`
-- Run: `pnpm add @osdk/client@2.8.0-beta.29 @osdk/api@2.8.0-beta.29`
-
 **Optional peers** (install only if you import from the matching surface):
 
-- `@osdk/foundry.admin` + `@osdk/foundry.core`: required ONLY for any hook from `@osdk/react/experimental/admin`. Otherwise omit.
+- `@osdk/foundry.admin` + `@osdk/foundry.core`: required ONLY for any hook from `@osdk/react/platform-apis`. Otherwise omit.
 
 ## Install-time errors
 
-| Error                                                                                      | Cause                                                                                                                                                                             | Fix                                                                                                                                                                                                                                 |
-| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `"<name>" is not exported by @osdk/client/.../unstable-do-not-use.js` (or `@osdk/api/...`) | `@osdk/client` or `@osdk/api` is on a different release line than the one `@osdk/react` was built against — usually a beta `@osdk/react` paired with stable peers (or vice versa) | Do NOT delete the import or downgrade `@osdk/react` silently. Follow the CHANGELOG recipe in `## Installing` to find the exact `@osdk/client` and `@osdk/api` versions, then `pnpm add @osdk/client@<version> @osdk/api@<version>`. |
-| `Rollup failed to resolve import "@osdk/foundry.admin"` (or `@osdk/foundry.core`)          | Imported from `@osdk/react/experimental/admin` without installing the optional peers                                                                                              | Install `@osdk/foundry.admin` + `@osdk/foundry.core`, OR stop importing from `/experimental/admin`.                                                                                                                                 |
-| pnpm/npm peer warning about `@osdk/client` or `@osdk/api` range                            | Declared peer ranges are deliberately broad; prerelease coupling is tighter than the ranges express                                                                               | Follow the CHANGELOG recipe; pin to the exact `@osdk/client` and `@osdk/api` versions.                                                                                                                                              |
+| Error                                                                                                                           | Cause                                                                                                                                                                                   | Fix                                                                                                                                                                                                                                 |
+| ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `"<name>" is not exported by @osdk/client/.../observable.js` (or `@osdk/client/.../unstable-do-not-use.js`, or `@osdk/api/...`) | `@osdk/client` or `@osdk/api` is on a different release line than the one `@osdk/react` was built against — usually a prerelease `@osdk/react` paired with stable peers (or vice versa) | Do NOT delete the import or downgrade `@osdk/react` silently. Follow the CHANGELOG recipe in `## Installing` to find the exact `@osdk/client` and `@osdk/api` versions, then `pnpm add @osdk/client@<version> @osdk/api@<version>`. |
+| `Rollup failed to resolve import "@osdk/foundry.admin"` (or `@osdk/foundry.core`)                                               | Imported from `@osdk/react/platform-apis` without installing the optional peers                                                                                                         | Install `@osdk/foundry.admin` + `@osdk/foundry.core`, OR stop importing from `/platform-apis`.                                                                                                                                      |
+| pnpm/npm peer warning about `@osdk/client` or `@osdk/api` range                                                                 | Declared peer ranges are deliberately broad; prerelease coupling is tighter than the ranges express                                                                                     | Follow the CHANGELOG recipe; pin to the exact `@osdk/client` and `@osdk/api` versions.                                                                                                                                              |
 
 ## Rules
 
-1. **Use `OsdkProvider2`**, not `OsdkProvider`. All modern hooks require it.
-2. **Import from `@osdk/react/experimental`**, not `@osdk/react`. Main entry only has legacy hooks.
-3. **Never conditionally call hooks.** Use the `enabled` option instead.
-4. **Keep rendering during loading.** No early returns like `if (isLoading) return <Spinner />`. Show loading indicators alongside existing data to prevent UI flashing. Exception: `if (!data && isLoading)` is acceptable for initial load.
-5. **`useOsdkObject` `enabled` is positional**, not in an options object: `useOsdkObject(Type, id, false)`.
+1. **Wrap your app in `OsdkProvider`** at the root. All hooks require it.
+2. **Never conditionally call hooks.** Use the `enabled` option instead.
+3. **Keep rendering during loading.** No early returns like `if (isLoading) return <Spinner />`. Show loading indicators alongside existing data to prevent UI flashing. Exception: `if (!data && isLoading)` is acceptable for initial load.
+4. **`useOsdkObject` `enabled` is positional**, not in an options object: `useOsdkObject(Type, id, false)`.
 
 ## Exports
 
-**Stable** (`@osdk/react`): `OsdkProvider` (legacy), `useOsdkClient`, `useOsdkMetadata`
+**Main entry** (`@osdk/react`): `OsdkProvider`, `useOsdkObjects`, `useOsdkObject`, `useOsdkAction`, `useLinks`, `useObjectSet`, `useOsdkAggregation`, `useOsdkFunction`, `useOsdkFunctions`, `useStableObjectSet`, `useRegisterUserAgent`, `useDebouncedCallback`, `useOsdkClient`, `useOsdkMetadata`, plus the devtools registry re-exports (`registerDevTools`, `getRegisteredDevTools`).
+
+**Platform APIs** (`@osdk/react/platform-apis`): `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList`, `useMarkings`, `useMarkingCategories`, `useUserViewMarkings`, `useCbacBanner`, `useCbacMarkingRestrictions` — requires `@osdk/foundry.admin` + `@osdk/foundry.core` to be installed.
 
-**Experimental** (`@osdk/react/experimental`): `OsdkProvider2`, `useOsdkObjects`, `useOsdkObject`, `useOsdkAction`, `useLinks`, `useObjectSet`, `useOsdkAggregation`, `useOsdkFunction`, `useDebouncedCallback`, `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList`
+**DevTools** (`@osdk/react/devtools-registry`): `registerDevTools`, `getRegisteredDevTools`, `DevToolsRegistry` (also re-exported from main).
 
 ## Hook Options
 
-- `OsdkProvider2` - Modern provider (use this)
+- `OsdkProvider` - Wrap your app at the root
 - `useOsdkObjects` - Query lists of objects
 - `useOsdkObject` - Query single object by type+key or instance
 - `useOsdkAction` - Execute and validate actions
 - `useLinks` - Navigate object relationships
 - `useObjectSet` - Advanced set operations (union, intersect, subtract, pivot)
 - `useOsdkAggregation` - Server-side aggregations with groupBy/select
-- `useOsdkClient`, `useOsdkMetadata` - Also available from experimental
-
-**Experimental Admin** (`@osdk/react/experimental/admin`):
-
-- `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList` - Platform APIs (requires `@osdk/foundry.admin`)
+- `useOsdkFunction` / `useOsdkFunctions` - Call ontology functions
 
 ## Correct Patterns
 
@@ -100,11 +89,6 @@ if (isLoading) return <Spinner />;
 // CORRECT: render together
 <div>{isLoading && <Spinner />}{data?.map(...)}</div>
 
-// WRONG: import from main entry
-import { useOsdkObjects } from "@osdk/react";
-// CORRECT
-import { useOsdkObjects } from "@osdk/react/experimental";
-
 // WRONG: useOsdkObject enabled in options
 useOsdkObject(Employee, id, { enabled: false });
 // CORRECT: positional

package/CHANGELOG.md

@@ -1,20 +1,21 @@
 # @osdkkit/react
 
-## 0.17.0-main-5dc557e9e321d23e8e150e8015c41ebe3b6f387c
+## 0.17.0
 
 ### Minor Changes
 
+- f747fa3: Add `@osdk/aip-core` — the AIP SDK's chat completion primitives, backed by the Foundry Language Model Service's OpenAI-compatible proxy. Construct a model via `foundryModel({ client, model })` and call `generateText` for non-streaming completions or `streamText` for streaming. `LmsChatTransport` plugs into UI hooks; `useChat` is exposed from `@osdk/react/experimental/aip` and returns `messages`, `status`, `sendMessage`, `regenerate`, `stop`, `clearError`, and accepts a `transport` override. v0 is text-only and single-step — tool round-trips, multi-step loops, image/file content, Zod tool schemas, and stream resume are deferred.
+- d892397: expose `$includeAllBaseObjectProperties` on `useLinks` and on the underlying `ObservableClient.observeLinks`. When set against a link whose target is an interface, the server returns the underlying concrete object's full property set so `obj.$as(ConcreteType)` yields a fully-populated concrete object. The flag is dropped at fetch time when the link target is an object type and does not narrow the returned `Osdk.Instance` type.
 - c5a6047: expose `$includeAllBaseObjectProperties` on `useOsdkObject` and on the underlying `ObservableClient.observeObject`. When set against an interface query, the server returns the underlying concrete object's full property set so `obj.$as(ConcreteType)` yields a fully-populated concrete object. The flag is dropped for non-interface queries and does not narrow the returned `Osdk.Instance` type.
 - 45be476: expose `$includeAllBaseObjectProperties` on `useOsdkObjects` and on the underlying `ObservableClient.observeList`. When set against an interface query, the server returns the underlying concrete object's full property set so `obj.$as(ConcreteType)` yields a fully-populated concrete object. The flag is dropped for non-interface queries and does not narrow the returned `Osdk.Instance` type.
+- b355bc3: Add CONTRIBUTING.md for @osdk/react and @osdk/react-components
+- 20e9678: Wrap `@example` JSDoc blocks in fenced ts/tsx code blocks so VS Code's Markdown renderer preserves whitespace and applies syntax highlighting.
 
 ### Patch Changes
 
-- b355bc3: Add CONTRIBUTING.md for @osdk/react and @osdk/react-components
-- Updated dependencies [eb36e21]
-- Updated dependencies [c5a6047]
-- Updated dependencies [45be476]
-  - @osdk/client@2.14.0-main-5dc557e9e321d23e8e150e8015c41ebe3b6f387c
-  - @osdk/api@2.14.0-main-5dc557e9e321d23e8e150e8015c41ebe3b6f387c
+- Updated dependencies [86cc68c]
+- Updated dependencies [f747fa3]
+  - @osdk/aip-core@0.2.0
 
 ## 0.16.0
 

package/build/browser/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

package/build/browser/aip/chatStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatStore.js","names":["createChatStore","options","state","messages","initialMessages","status","error","undefined","subscribers","Set","throttleMs","pendingNotify","notifyNow","clearTimeout","s","notifyThrottled","setTimeout","getSnapshot","subscribe","notify","add","delete","setState","next","setStateThrottled"],"sources":["chatStore.ts"],"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\nimport type { UIMessage } from \"@osdk/aip-core\";\n\nexport type ChatStatus = \"ready\" | \"submitted\" | \"streaming\" | \"error\";\n\nexport interface ChatState {\n  messages: ReadonlyArray<UIMessage>;\n  status: ChatStatus;\n  error: Error | undefined;\n}\n\nexport interface ChatStore {\n  getSnapshot: () => ChatState;\n  /** Subscribe to state changes. Returns the unsubscribe function. */\n  subscribe: (notify: () => void) => () => void;\n  /** Replace state and notify subscribers synchronously. */\n  setState: (\n    next: ChatState | ((prev: ChatState) => ChatState),\n  ) => void;\n  /**\n   * Replace state and coalesce subscriber notifications across rapid calls.\n   * Notifications fire `throttleMs` after the first change in a quiet window.\n   * Use for high-frequency updates (e.g. token streaming) where one render per\n   * change is wasteful.\n   */\n  setStateThrottled: (\n    next: ChatState | ((prev: ChatState) => ChatState),\n  ) => void;\n}\n\nexport interface CreateChatStoreOptions {\n  initialMessages?: ReadonlyArray<UIMessage>;\n  /** Min ms between subscriber notifications. 0 = synchronous. Defaults to 0. */\n  throttleMs?: number;\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: CreateChatStoreOptions): ChatStore {\n  let state: ChatState = {\n    messages: options.initialMessages ?? [],\n    status: \"ready\",\n    error: undefined,\n  };\n\n  const subscribers = new Set<() => void>();\n  const throttleMs = options.throttleMs ?? 0;\n  let pendingNotify: ReturnType<typeof setTimeout> | undefined;\n\n  const notifyNow = (): void => {\n    if (pendingNotify != null) {\n      clearTimeout(pendingNotify);\n      pendingNotify = undefined;\n    }\n    for (const s of subscribers) {\n      s();\n    }\n  };\n\n  const notifyThrottled = (): void => {\n    if (throttleMs <= 0) {\n      notifyNow();\n      return;\n    }\n    if (pendingNotify != null) {\n      return;\n    }\n    pendingNotify = setTimeout(notifyNow, throttleMs);\n  };\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"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqCA;AACA;AACA;AACA;AACA,OAAO,SAASA,eAAeA,CAACC,OAA+B,EAAa;EAC1E,IAAIC,KAAgB,GAAG;IACrBC,QAAQ,EAAEF,OAAO,CAACG,eAAe,IAAI,EAAE;IACvCC,MAAM,EAAE,OAAO;IACfC,KAAK,EAAEC;EACT,CAAC;EAED,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAAa,CAAC;EACzC,MAAMC,UAAU,GAAGT,OAAO,CAACS,UAAU,IAAI,CAAC;EAC1C,IAAIC,aAAwD;EAE5D,MAAMC,SAAS,GAAGA,CAAA,KAAY;IAC5B,IAAID,aAAa,IAAI,IAAI,EAAE;MACzBE,YAAY,CAACF,aAAa,CAAC;MAC3BA,aAAa,GAAGJ,SAAS;IAC3B;IACA,KAAK,MAAMO,CAAC,IAAIN,WAAW,EAAE;MAC3BM,CAAC,CAAC,CAAC;IACL;EACF,CAAC;EAED,MAAMC,eAAe,GAAGA,CAAA,KAAY;IAClC,IAAIL,UAAU,IAAI,CAAC,EAAE;MACnBE,SAAS,CAAC,CAAC;MACX;IACF;IACA,IAAID,aAAa,IAAI,IAAI,EAAE;MACzB;IACF;IACAA,aAAa,GAAGK,UAAU,CAACJ,SAAS,EAAEF,UAAU,CAAC;EACnD,CAAC;EAED,OAAO;IACLO,WAAW,EAAEA,CAAA,KAAMf,KAAK;IACxBgB,SAAS,EAAGC,MAAM,IAAK;MACrBX,WAAW,CAACY,GAAG,CAACD,MAAM,CAAC;MACvB,OAAO,MAAM;QACXX,WAAW,CAACa,MAAM,CAACF,MAAM,CAAC;MAC5B,CAAC;IACH,CAAC;IACDG,QAAQ,EAAGC,IAAI,IAAK;MAClBrB,KAAK,GAAG,OAAOqB,IAAI,KAAK,UAAU,GAAGA,IAAI,CAACrB,KAAK,CAAC,GAAGqB,IAAI;MACvDX,SAAS,CAAC,CAAC;IACb,CAAC;IACDY,iBAAiB,EAAGD,IAAI,IAAK;MAC3BrB,KAAK,GAAG,OAAOqB,IAAI,KAAK,UAAU,GAAGA,IAAI,CAACrB,KAAK,CAAC,GAAGqB,IAAI;MACvDR,eAAe,CAAC,CAAC;IACnB;EACF,CAAC;AACH","ignoreList":[]}

package/build/browser/aip/chatStream.js

@@ -0,0 +1,155 @@
+/*
+ * 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.
+ */
+
+import { generateMessageId } from "@osdk/aip-core";
+
+/**
+ * Mutable orchestration handle threaded through the streaming functions.
+ * Holds everything they need to read snapshots, mutate state, and check
+ * whether their stream is still the active one.
+ */
+
+export 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 = 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);
+  }
+}
+export 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;
+
+  // Caller dropped our assistant message via `setMessages` mid-stream.
+  // Treat as "the consumer no longer wants this stream" — quietly stop.
+  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: undefined
+    }));
+    return;
+  }
+  ctx.store.setState(prev => ({
+    ...prev,
+    status: "error",
+    error
+  }));
+  ctx.onError?.(error);
+}
+//# sourceMappingURL=chatStream.js.map

package/build/browser/aip/chatStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatStream.js","names":["generateMessageId","runChatStream","ctx","transport","chatId","seed","trigger","abortRef","current","abort","ctrl","AbortController","stoppedRef","assistantId","stream","sendMessages","messageId","messages","slice","abortSignal","signal","drainStream","err","handleStreamError","assistantMessageId","capturedCtrl","store","reader","getReader","textBuf","isStale","isOrphaned","getSnapshot","length","some","m","id","done","value","read","cancel","setState","prev","status","type","delta","upsertAssistantText","aborted","Error","errorText","finalSnap","finalMessage","find","onFinish","message","releaseLock","text","setStateThrottled","exists","map","parts","role","error","String","name","undefined","onError"],"sources":["chatStream.ts"],"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\nimport {\n  type ChatTransport,\n  generateMessageId,\n  type UIMessage,\n  type UIMessageChunk,\n} from \"@osdk/aip-core\";\nimport type React from \"react\";\nimport type { ChatStore } from \"./chatStore.js\";\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 */\nexport interface StreamContext {\n  store: ChatStore;\n  abortRef: React.MutableRefObject<AbortController | undefined>;\n  stoppedRef: React.MutableRefObject<boolean>;\n  onFinish:\n    | ((event: {\n      message: UIMessage;\n      messages: ReadonlyArray<UIMessage>;\n    }) => void)\n    | undefined;\n  onError: ((error: Error) => void) | undefined;\n}\n\nexport async function runChatStream(\n  ctx: StreamContext,\n  transport: ChatTransport<UIMessage>,\n  chatId: string,\n  seed: ReadonlyArray<UIMessage>,\n  trigger: \"submit-message\" | \"regenerate-message\",\n): Promise<void> {\n  ctx.abortRef.current?.abort();\n  const ctrl = new AbortController();\n  ctx.abortRef.current = ctrl;\n  ctx.stoppedRef.current = false;\n\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}\n\nexport async function drainStream(\n  ctx: StreamContext,\n  stream: ReadableStream<UIMessageChunk>,\n  assistantMessageId: string,\n  capturedCtrl: AbortController,\n): Promise<void> {\n  const { store } = ctx;\n  const reader = stream.getReader();\n  let textBuf = \"\";\n\n  const isStale = (): boolean =>\n    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 = (): boolean => {\n    const messages = store.getSnapshot().messages;\n    return textBuf.length > 0\n      && !messages.some((m) => m.id === assistantMessageId);\n  };\n\n  try {\n    while (true) {\n      const { done, value } = 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) => ({ ...prev, status: \"ready\" }));\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) => ({ ...prev, status: \"ready\" }));\n    const finalSnap = store.getSnapshot();\n    const finalMessage = finalSnap.messages.find(\n      (m) => m.id === assistantMessageId,\n    );\n    if (finalMessage != null && ctx.onFinish != null) {\n      ctx.onFinish({ message: finalMessage, messages: finalSnap.messages });\n    }\n  } catch (err) {\n    handleStreamError(ctx, err, capturedCtrl);\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction upsertAssistantText(\n  store: ChatStore,\n  assistantMessageId: string,\n  text: string,\n): void {\n  store.setStateThrottled((prev) => {\n    const exists = prev.messages.some((m) => m.id === assistantMessageId);\n    const messages = exists\n      ? prev.messages.map((m) =>\n        m.id === assistantMessageId\n          ? { ...m, parts: [{ type: \"text\" as const, text }] }\n          : m\n      )\n      : [\n        ...prev.messages,\n        {\n          id: assistantMessageId,\n          role: \"assistant\" as const,\n          parts: [{ type: \"text\" as const, text }],\n        },\n      ];\n    return { ...prev, status: \"streaming\", messages };\n  });\n}\n\nfunction handleStreamError(\n  ctx: StreamContext,\n  err: unknown,\n  capturedCtrl: AbortController,\n): void {\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 (\n    ctx.stoppedRef.current\n    || error.name === \"AbortError\"\n    || capturedCtrl.signal.aborted\n  ) {\n    ctx.store.setState((prev) => ({\n      ...prev,\n      status: \"ready\",\n      error: undefined,\n    }));\n    return;\n  }\n  ctx.store.setState((prev) => ({ ...prev, status: \"error\", error }));\n  ctx.onError?.(error);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/aip/useChat.js

@@ -0,0 +1,243 @@
+/*
+ * 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.
+ */
+
+import { generateMessageId, LmsChatTransport } from "@osdk/aip-core";
+import React from "react";
+import { createChatStore } from "./chatStore.js";
+import { drainStream, runChatStream } from "./chatStream.js";
+
+/**
+ * Options for {@link useChat}.
+ *
+ * v0 covers text-only chat. Tools, multi-step agent loops, and stream
+ * resume are not supported.
+ */
+
+/** Return value of {@link useChat}. */
+
+/** Input shape accepted by `sendMessage`. */
+
+/**
+ * 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.",
+ * });
+ * ```
+ */
+export function useChat(options) {
+  const {
+    onFinish,
+    onError
+  } = options;
+  const id = React.useMemo(() => options.id ?? generateMessageId(), [options.id]);
+
+  // JSON-stringify keys keep the memo stable when callers pass inline objects.
+  const headersKey = JSON.stringify(options.headers ?? null);
+  const stopSequencesKey = JSON.stringify(options.stopSequences ?? null);
+  const transport = React.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 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.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.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+  const abortRef = React.useRef(undefined);
+  const stoppedRef = React.useRef(false);
+  const ctxRef = React.useRef({
+    store,
+    abortRef,
+    stoppedRef,
+    onFinish,
+    onError
+  });
+  ctxRef.current = {
+    store,
+    abortRef,
+    stoppedRef,
+    onFinish,
+    onError
+  };
+  const runStream = React.useCallback((seed, trigger) => runChatStream(ctxRef.current, transport, id, seed, trigger), [transport, id]);
+  const sendMessage = React.useCallback(async input => {
+    const userMsg = normalizeUserMessage(input);
+    const seeded = [...store.getSnapshot().messages, userMsg];
+    store.setState({
+      messages: seeded,
+      status: "submitted",
+      error: undefined
+    });
+    await runStream(seeded, "submit-message");
+  }, [store, runStream]);
+  const regenerate = React.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: undefined
+    });
+    await runStream(truncated, "regenerate-message");
+  }, [store, runStream]);
+  const stop = React.useCallback(() => {
+    stoppedRef.current = true;
+    abortRef.current?.abort();
+    abortRef.current = undefined;
+  }, []);
+  const resumeStream = React.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 = generateMessageId();
+    await drainStream(ctxRef.current, stream, assistantId, ctrl);
+  }, [transport, id]);
+  const clearError = React.useCallback(() => {
+    // Resetting from streaming/submitted would race the in-flight stream, so
+    // only reset when status === "error".
+    store.setState(prev => prev.status === "error" ? {
+      ...prev,
+      status: "ready",
+      error: undefined
+    } : prev);
+  }, [store]);
+  const setMessages = React.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.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: generateMessageId(),
+      role: "user",
+      parts: [{
+        type: "text",
+        text: input.text
+      }]
+    };
+  }
+  return {
+    id: 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;
+}
+//# sourceMappingURL=useChat.js.map