@lunnoa/client 2.1.0 → 2.2.0

package/dist/react.d.cts

@@ -107,7 +107,10 @@ declare class HttpClient {
 
 type ChatMode = 'builder' | 'preview';
 interface StreamMessageOptions {
-    /** Agent chat mode; defaults to the server default (`builder`). */
+    /**
+     * Agent chat mode. Defaults to `preview` (10 model rounds, a normal agent run).
+     * `builder` is the agent-editor interview and stops after 4 rounds.
+     */
     chatMode?: ChatMode;
     /** Optional image attachment forwarded with this turn. */
     data?: {
@@ -937,7 +940,7 @@ interface components {
             description?: string;
             /** @description System instructions / prompt for the agent. */
             instructions: string;
-            /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
+            /** @description Catalogue model id enabled on the AI connection. Example: `deepseek-ai/DeepSeek-V4-Pro`. Discover ids with GET /api/ai-connections. */
             model: string;
             /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
             aiConnectionId?: string;
@@ -2074,6 +2077,32 @@ interface components {
             /** Format: date-time */
             updatedAt: string;
         };
+        PublicAiModelResponseDto: {
+            /** @description Catalogue model id passed to agent deploy as `model`. Example: `deepseek-ai/DeepSeek-V4-Pro`. */
+            id: string;
+            /** @description Display name. */
+            name: string;
+            /** @description True when this is the model used if an agent deploy omits `model` on this connection. */
+            isDefault: boolean;
+            /** @description Whether the model can call tools. */
+            supportsTools: boolean;
+            /** @description Whether the model accepts image input. */
+            supportsVision: boolean;
+            /** @description Whether the model exposes a reasoning mode. */
+            supportsReasoning: boolean;
+        };
+        PublicAiConnectionResponseDto: {
+            /** @description AiProviderConnection UUID. Pass as `aiConnectionId` / `defineAiConnection({ id })` when this connection is not the default. */
+            id: string;
+            /** @description Connection display name. Example: `Lunnoa LLMs`. */
+            name: string;
+            /** @description Provider slug. Example: `featherless` or `openai`. */
+            provider: string;
+            /** @description True for the connection used when an agent deploy omits `aiConnectionId`. */
+            isDefault: boolean;
+            /** @description Models this connection accepts. Inactive models are omitted. */
+            models: components["schemas"]["PublicAiModelResponseDto"][];
+        };
         ConnectionWorkspaceDto: {
             /** @description Workspace ID. */
             id: string;
@@ -2682,7 +2711,10 @@ interface AgentDefinition {
     slug: string;
     name?: string;
     description?: string;
-    /** Selected model id on the AI provider connection. */
+    /**
+     * Catalogue model id from `ai-connections list` (`models[].id`).
+     * Example on Lunnoa LLMs: `deepseek-ai/DeepSeek-V4-Pro`.
+     */
     model: string;
     instructions: string;
     aiConnection?: AiConnectionDefinition;
@@ -2885,6 +2917,36 @@ declare class SsoAuthResource {
     getLoginUrl(providerId: string): string;
 }
 
+interface AiConnectionModel {
+    /** Catalogue id for `defineAgent({ model })`. */
+    id: string;
+    name: string;
+    isDefault: boolean;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsReasoning: boolean;
+}
+interface AiConnection {
+    /** AiProviderConnection UUID for `defineAiConnection({ id })`. */
+    id: string;
+    name: string;
+    /** Provider slug, for example `featherless` or `openai`. */
+    provider: string;
+    /** True when agent deploy uses this connection if `aiConnection` is omitted. */
+    isDefault: boolean;
+    models: AiConnectionModel[];
+}
+declare class AiConnectionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Lists AI connections the caller can assign to an agent, with the model
+     * ids each connection accepts. Credentials are never included.
+     * Requires `agents:create` (the same permission as agent deploy).
+     */
+    list(): Promise<AiConnection[]>;
+}
+
 declare class ConnectionsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3494,6 +3556,8 @@ declare class LunnoaClient {
     readonly variables: VariablesResource;
     readonly scorecards: ScorecardsResource;
     readonly connections: ConnectionsResource;
+    /** AI provider connections and the model ids each one accepts. */
+    readonly aiConnections: AiConnectionsResource;
     readonly workflowApps: WorkflowAppsResource;
     readonly discovery: DiscoveryResource;
     constructor(options: LunnoaClientOptions);
@@ -3645,7 +3709,10 @@ interface UseNeedsInputResult {
 declare function useNeedsInput(source: NeedsInputSource, options?: UseNeedsInputOptions): UseNeedsInputResult;
 
 interface UseAgentChatOptions {
-    /** Agent chat mode forwarded in the request body. */
+    /**
+     * Agent chat mode forwarded in the request body.
+     * Defaults to `preview` (10 model rounds). `builder` stops after 4 rounds.
+     */
     chatMode?: 'builder' | 'preview';
 }
 interface UseAgentChatResult {

package/dist/react.d.ts

@@ -107,7 +107,10 @@ declare class HttpClient {
 
 type ChatMode = 'builder' | 'preview';
 interface StreamMessageOptions {
-    /** Agent chat mode; defaults to the server default (`builder`). */
+    /**
+     * Agent chat mode. Defaults to `preview` (10 model rounds, a normal agent run).
+     * `builder` is the agent-editor interview and stops after 4 rounds.
+     */
     chatMode?: ChatMode;
     /** Optional image attachment forwarded with this turn. */
     data?: {
@@ -937,7 +940,7 @@ interface components {
             description?: string;
             /** @description System instructions / prompt for the agent. */
             instructions: string;
-            /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
+            /** @description Catalogue model id enabled on the AI connection. Example: `deepseek-ai/DeepSeek-V4-Pro`. Discover ids with GET /api/ai-connections. */
             model: string;
             /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
             aiConnectionId?: string;
@@ -2074,6 +2077,32 @@ interface components {
             /** Format: date-time */
             updatedAt: string;
         };
+        PublicAiModelResponseDto: {
+            /** @description Catalogue model id passed to agent deploy as `model`. Example: `deepseek-ai/DeepSeek-V4-Pro`. */
+            id: string;
+            /** @description Display name. */
+            name: string;
+            /** @description True when this is the model used if an agent deploy omits `model` on this connection. */
+            isDefault: boolean;
+            /** @description Whether the model can call tools. */
+            supportsTools: boolean;
+            /** @description Whether the model accepts image input. */
+            supportsVision: boolean;
+            /** @description Whether the model exposes a reasoning mode. */
+            supportsReasoning: boolean;
+        };
+        PublicAiConnectionResponseDto: {
+            /** @description AiProviderConnection UUID. Pass as `aiConnectionId` / `defineAiConnection({ id })` when this connection is not the default. */
+            id: string;
+            /** @description Connection display name. Example: `Lunnoa LLMs`. */
+            name: string;
+            /** @description Provider slug. Example: `featherless` or `openai`. */
+            provider: string;
+            /** @description True for the connection used when an agent deploy omits `aiConnectionId`. */
+            isDefault: boolean;
+            /** @description Models this connection accepts. Inactive models are omitted. */
+            models: components["schemas"]["PublicAiModelResponseDto"][];
+        };
         ConnectionWorkspaceDto: {
             /** @description Workspace ID. */
             id: string;
@@ -2682,7 +2711,10 @@ interface AgentDefinition {
     slug: string;
     name?: string;
     description?: string;
-    /** Selected model id on the AI provider connection. */
+    /**
+     * Catalogue model id from `ai-connections list` (`models[].id`).
+     * Example on Lunnoa LLMs: `deepseek-ai/DeepSeek-V4-Pro`.
+     */
     model: string;
     instructions: string;
     aiConnection?: AiConnectionDefinition;
@@ -2885,6 +2917,36 @@ declare class SsoAuthResource {
     getLoginUrl(providerId: string): string;
 }
 
+interface AiConnectionModel {
+    /** Catalogue id for `defineAgent({ model })`. */
+    id: string;
+    name: string;
+    isDefault: boolean;
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsReasoning: boolean;
+}
+interface AiConnection {
+    /** AiProviderConnection UUID for `defineAiConnection({ id })`. */
+    id: string;
+    name: string;
+    /** Provider slug, for example `featherless` or `openai`. */
+    provider: string;
+    /** True when agent deploy uses this connection if `aiConnection` is omitted. */
+    isDefault: boolean;
+    models: AiConnectionModel[];
+}
+declare class AiConnectionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Lists AI connections the caller can assign to an agent, with the model
+     * ids each connection accepts. Credentials are never included.
+     * Requires `agents:create` (the same permission as agent deploy).
+     */
+    list(): Promise<AiConnection[]>;
+}
+
 declare class ConnectionsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3494,6 +3556,8 @@ declare class LunnoaClient {
     readonly variables: VariablesResource;
     readonly scorecards: ScorecardsResource;
     readonly connections: ConnectionsResource;
+    /** AI provider connections and the model ids each one accepts. */
+    readonly aiConnections: AiConnectionsResource;
     readonly workflowApps: WorkflowAppsResource;
     readonly discovery: DiscoveryResource;
     constructor(options: LunnoaClientOptions);
@@ -3645,7 +3709,10 @@ interface UseNeedsInputResult {
 declare function useNeedsInput(source: NeedsInputSource, options?: UseNeedsInputOptions): UseNeedsInputResult;
 
 interface UseAgentChatOptions {
-    /** Agent chat mode forwarded in the request body. */
+    /**
+     * Agent chat mode forwarded in the request body.
+     * Defaults to `preview` (10 model rounds). `builder` stops after 4 rounds.
+     */
     chatMode?: 'builder' | 'preview';
 }
 interface UseAgentChatResult {

package/dist/react.js

@@ -516,7 +516,7 @@ var AgentChatClient = class {
 function messageTaskBody(message, options = {}) {
   return {
     messages: [message],
-    ...options.chatMode ? { chatMode: options.chatMode } : {},
+    chatMode: options.chatMode ?? "preview",
     ...options.data ? { data: options.data } : {},
     ...options.piiResolution ? { piiResolution: options.piiResolution } : {}
   };
@@ -891,6 +891,22 @@ var SsoAuthResource = class {
   }
 };
 
+// src/resources/ai-connections.ts
+var AiConnectionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Lists AI connections the caller can assign to an agent, with the model
+   * ids each connection accepts. Credentials are never included.
+   * Requires `agents:create` (the same permission as agent deploy).
+   */
+  list() {
+    return this.http.get("/api/ai-connections");
+  }
+};
+
 // src/resources/connections.ts
 var ConnectionsResource = class {
   constructor(http) {
@@ -2116,6 +2132,8 @@ var LunnoaClient = class {
   variables;
   scorecards;
   connections;
+  /** AI provider connections and the model ids each one accepts. */
+  aiConnections;
   workflowApps;
   discovery;
   constructor(options) {
@@ -2139,6 +2157,7 @@ var LunnoaClient = class {
     this.variables = new VariablesResource(this.http);
     this.scorecards = new ScorecardsResource(this.http);
     this.connections = new ConnectionsResource(this.http);
+    this.aiConnections = new AiConnectionsResource(this.http);
     this.discovery = new DiscoveryResource(this.http);
   }
 };
@@ -2540,7 +2559,7 @@ function useAgentChat(agentId, taskId, options = {}) {
         if (!token) return {};
         return { Authorization: `Bearer ${token}` };
       },
-      body: chatMode ? { chatMode } : void 0,
+      body: { chatMode: chatMode ?? "preview" },
       prepareReconnectToStreamRequest: ({ headers, credentials }) => ({
         api,
         headers,