@astralform/js 3.0.1 → 3.2.0

package/dist/index.cjs

@@ -541,6 +541,29 @@ var AstralformClient = class {
       avatarUrl: a.avatar_url
     }));
   }
+  /**
+   * List the models the caller may pick this turn — expanded from the curated
+   * catalog of the providers the team has connected (client-side model
+   * selection). Backs the composer's model picker. Scoped to the active agent
+   * via X-Agent-ID, same as {@link getAgentStatus}.
+   */
+  async getModels() {
+    const raw = await this.get("/v1/models");
+    return raw.map((m) => ({
+      provider: m.provider,
+      providerDisplay: m.provider_display,
+      model: m.model,
+      thinking: m.thinking,
+      tools: m.tools,
+      vision: m.vision,
+      thinkingMode: m.thinking_mode,
+      // Coerce so the non-optional `supportsEffort: boolean` stays honest even
+      // against an older backend that omits `supports_effort` (→ false = safe:
+      // the effort control is hidden). Unlike the always-present siblings above,
+      // this field can be absent, so it's the one that needs coercion.
+      supportsEffort: Boolean(m.supports_effort)
+    }));
+  }
   async getSkills() {
     const raw = await this.get("/v1/skills");
     return raw.map((s) => ({
@@ -1292,6 +1315,11 @@ var ChatSession = class {
     this.emit({ type: "connected" });
   }
   async send(content, options) {
+    if (options?.provider == null !== (options?.model == null)) {
+      throw new Error(
+        "`provider` and `model` must be supplied together (client-side model selection)."
+      );
+    }
     if (this.isStreaming) return;
     const conversationId = options?.conversationId ?? this.conversationId ?? void 0;
     const userMessage = {
@@ -1316,7 +1344,12 @@ var ChatSession = class {
       upload_ids: options?.uploadIds,
       agent_name: options?.agentName,
       enable_search: options?.enableSearch,
-      plan_mode: options?.planMode
+      plan_mode: options?.planMode,
+      // Per-request model choice (client-side model selection).
+      provider: options?.provider,
+      model: options?.model,
+      reasoning_effort: options?.reasoningEffort,
+      temperature: options?.temperature
     };
     await this.processStream(request);
   }
@@ -1823,6 +1856,11 @@ var StreamManager = class {
   }
   // ── Send ──────────────────────────────────────────────────────
   async send(content, options) {
+    if (options?.provider == null !== (options?.model == null)) {
+      throw new Error(
+        "`provider` and `model` must be supplied together (client-side model selection)."
+      );
+    }
     if (this._state === "streaming") return;
     if (!this._activeConversationId) {
       const id = await this.session.createNewConversation();
@@ -1834,7 +1872,11 @@ var StreamManager = class {
         enableSearch: options?.enableSearch,
         agentName: options?.agentName,
         uploadIds: options?.uploadIds,
-        planMode: options?.planMode
+        planMode: options?.planMode,
+        provider: options?.provider,
+        model: options?.model,
+        reasoningEffort: options?.reasoningEffort,
+        temperature: options?.temperature
       });
     } catch {
     }