@frontera-sdk/chat-ui 1.50.59 → 1.50.60

package/README.md

@@ -68,13 +68,39 @@ Pass exactly one. All four are mutually exclusive in the type.
 
 | Prop | Type | Notes |
 |---|---|---|
-| `tokenEndpoint` | `string` | **Recommended.** URL on your server. Renewal handled for you; the API origin arrives with the token. |
+| `tokenEndpoint` | `string` | **Recommended.** URL on your server. Renewal handled for you. Return `apiBaseUrl` alongside the token, or pass it as a prop — the exchange does not include it. |
 | `token` + `apiBaseUrl` | `string` + `string` | You own replacing it before it expires. The chat stops when it does. |
 | `getToken` | `() => Promise<{ token, expiresAt, apiBaseUrl? }>` | Called again on renewal. |
 | `client` | `FronteraClient \| (() => FronteraClient \| null)` | You built one yourself, e.g. from `useChatClient`. |
 
 ---
 
+## Upgrading
+
+### `modes`, `modelMode` and `defaultMode` are gone — use `modelSelector`
+
+The model is bound to the Agent on the deployment. A list supplied by the host
+could only ever disagree with what actually runs, and the disagreement was
+invisible: the picker showed one model and the reply came from another.
+
+What remains is `modelSelector?: boolean` — whether the picker appears at all.
+Which modes it offers, and which one starts selected, now come from the agent.
+
+| Before | After |
+|---|---|
+| `modes={[...]}` | delete it — the agent's own modes are used |
+| `modes={[]}` to hide the picker | `modelSelector={false}` |
+| `modelMode="fast"` to pin a model | configure that mode as the agent's default; the prop has no replacement |
+| `defaultMode="fast"` | same — it is the agent's default mode now |
+
+TypeScript reports these as unknown props. **JavaScript does not** — an ignored
+`modelMode` leaves the chat running the agent's default mode, and a `modes={[]}`
+that used to hide the picker now shows it, since `modelSelector` defaults to
+`true`. Search your integration for all three names.
+
+Ship this with a deployment whose `/v1/chat-agents` projects agent modes. An
+older deployment answers without them and the picker renders empty.
+
 ## Props
 
 Everything below is optional.
@@ -87,9 +113,7 @@ Everything below is optional.
 | `fileUpload` | `boolean` | `true` | Paperclip **and** drop-anywhere-on-the-conversation. `false` makes the whole surface inert. |
 | `appsButton` | `boolean` | `false` | Plugins button — connect accounts before asking. Requires `connectRedirectUri`. |
 | `shortcuts` | `Shortcut[]` | none | Starter cards on an empty conversation. Off by default: each default card needs a computer-equipped agent. |
-| `modes` | `Record<string, ModelConfig>` | none | Model picker. Omit to hide it. |
-| `modelMode` | `string` | — | Controlled mode key. |
-| `defaultMode` | `string` | — | Initial mode key. |
+| `modelSelector` | `boolean` | `true` | Model picker. What it offers comes from the **agent**; it hides itself when there is one mode and no effort levels. |
 | `placeholder` | `string` | `"Assign a task or ask anything..."` | Composer placeholder. |
 
 ```ts
@@ -172,13 +196,18 @@ export async function POST(req: Request) {
   const user = await currentUser(req)                // YOUR session
   if (!user) return new Response('unauthorized', { status: 401 })
 
-  return Response.json(
-    await exchangeChatToken(frontera, {
-      externalUserId: user.id,                       // never from the body
-      ttlSeconds: 1800,                              // 60–86400, default 3600
-      capabilities: ['plugin-connect'],
-    }),
-  )
+  const token = await exchangeChatToken(frontera, {
+    externalUserId: user.id,                         // never from the body
+    ttlSeconds: 1800,                                // 60–86400, default 3600
+    capabilities: ['plugin-connect'],
+  })
+
+  // `apiBaseUrl` is yours to add — the exchange returns only the token and its
+  // expiry, and the component has no other way to learn which deployment the
+  // token belongs to. Without it: "No apiBaseUrl: pass one, or return it from
+  // your token endpoint". It is the origin the browser is about to call, so
+  // there is nothing secret in it.
+  return Response.json({ ...token, apiBaseUrl: process.env.FRONTERA_API_URL })
 }
 ```
 
@@ -190,7 +219,7 @@ export async function POST(req: Request) {
 | Per-user choice | none — `agentId` naming a different agent is `403`, `agentIds` is `403` | `agentId` for one, `agentIds` for a subset (max 50) |
 | Agent picker | never shown, nothing to pick | shown, limited to what you minted |
 | If leaked | one agent | every chat agent |
-| Extra requirement | — | must be scoped **`chat`**; an `mcp`-scoped key is refused, naming its scope |
+| Extra requirement | — | create it with the **Embedded chat** purpose (Workspace settings → API Keys); a platform-access key is refused, naming its scope |
 
 One surface, one agent → agent key, and stop there. A picker, or different
 agents for different customers → workspace key.

package/dist/agent-picker.js

@@ -1,8 +1,8 @@
 'use client';
-export { AgentPicker, useChatAgents } from './chunk-VDZH5Z3K.js';
-import './chunk-ZS6PXIZP.js';
-import './chunk-FXKXDR5K.js';
-import './chunk-DGDHKMDB.js';
+export { AgentPicker, useChatAgents } from './chunk-PH7AYVSS.js';
+import './chunk-BDJFVRYR.js';
+import './chunk-TSKFBMGC.js';
+import './chunk-XLX3L3P4.js';
 import './chunk-AFVU5VT6.js';
 import './chunk-7ADM3CKD.js';
 import './chunk-PR4QN5HX.js';

package/dist/{esm-MHF25KDL.js → browser-B7HPFETX.js}

@@ -1,3 +1,3 @@
 'use client';
-export { AsyncGzip as AsyncCompress, AsyncDecompress, AsyncDeflate, AsyncGunzip, AsyncGzip, AsyncInflate, AsyncUnzipInflate, AsyncUnzlib, AsyncZipDeflate, AsyncZlib, Gzip as Compress, DecodeUTF8, Decompress, Deflate, EncodeUTF8, FlateErrorCode, Gunzip, Gzip, Inflate, Unzip, UnzipInflate, UnzipPassThrough, Unzlib, Zip, ZipDeflate, ZipPassThrough, Zlib, gzip as compress, gzipSync as compressSync, decompress, decompressSync, deflate, deflateSync, gunzip, gunzipSync, gzip, gzipSync, inflate, inflateSync, strFromU8, strToU8, unzip, unzipSync, unzlib, unzlibSync, zip, zipSync, zlib, zlibSync } from './chunk-PQZ2CS26.js';
+export { AsyncGzip as AsyncCompress, AsyncDecompress, AsyncDeflate, AsyncGunzip, AsyncGzip, AsyncInflate, AsyncUnzipInflate, AsyncUnzlib, AsyncZipDeflate, AsyncZlib, Gzip as Compress, DecodeUTF8, Decompress, Deflate, EncodeUTF8, FlateErrorCode, Gunzip, Gzip, Inflate, Unzip, UnzipInflate, UnzipPassThrough, Unzlib, Zip, ZipDeflate, ZipPassThrough, Zlib, gzip as compress, gzipSync as compressSync, decompress, decompressSync, deflate, deflateSync, gunzip, gunzipSync, gzip, gzipSync, inflate, inflateSync, strFromU8, strToU8, unzip, unzipSync, unzlib, unzlibSync, zip, zipSync, zlib, zlibSync } from './chunk-CDTES65T.js';
 import './chunk-PR4QN5HX.js';