@frontera-sdk/chat 1.50.58 → 1.50.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/chat",
-  "version": "1.50.58",
+  "version": "1.50.60",
   "description": "Typed client and React hooks for chatting with a Frontera agent from your own application.",
   "keywords": [
     "frontera",
@@ -77,7 +77,7 @@
     "smoke": "bun run scripts/smoke.ts"
   },
   "dependencies": {
-    "@frontera-sdk/core": "1.50.58"
+    "@frontera-sdk/core": "1.50.60"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^3.0.0",

package/src/types.ts

@@ -176,12 +176,42 @@ export interface ChatArtifact {
 }
 
 /** An agent the current credential may talk to — enough to draw a picker. */
+/**
+ * One model choice an agent offers.
+ *
+ * `/v1/chat-agents` omits `modelId`, `model` and `provider` on purpose: those
+ * are the exact checkpoint the deployment runs, and nothing a chat needs to
+ * draw a picker. `name` is a LABEL, not that identifier — the operator's own
+ * wording when they set one, and the catalog's when they did not, which does
+ * name a vendor ("Claude Sonnet 5") and is what a vendor glyph is chosen from.
+ * Nothing here can be sent back to pin a request to a model.
+ *
+ * `reasoning` is what decides whether an effort control appears beside the
+ * model: a mode without it offers a model and nothing else.
+ */
+export interface ChatAgentMode {
+  key: string
+  name: string
+  description?: string
+  style?: string
+  reasoning?: {
+    style?: string
+    supportedEfforts?: string[]
+    defaultEffort?: string
+    [key: string]: unknown
+  }
+}
+
 export interface ChatAgent {
   id: string
   agentId: string
   name: string
   description?: string | null
   avatarConfig?: unknown
+  /** The agent's own model choices. Empty or single → nothing to pick between. */
+  modes?: ChatAgentMode[]
+  /** The mode the agent starts in, as configured on the deployment. */
+  defaultMode?: string | null
 }
 
 // --- approvals ---