@fonoster/sdk 0.27.0 → 0.31.0

package/README.md

@@ -64,7 +64,7 @@ In Node.js:
 ```typescript
 const SDK = require("@fonoster/sdk");
 const ACCESS_KEY_ID = "WO00000000000000000000000000000000";
-const ENDPOINT = "api.fonoster.com";
+const ENDPOINT = "api.fonoster.ai";
 const client = new SDK.Client({ accessKeyId: ACCESS_KEY_ID, endpoint: ENDPOINT });
 ```
 
@@ -75,7 +75,7 @@ In the browser:
 ```typescript
 const SDK = require("@fonoster/sdk");
 const ACCESS_KEY_ID = "WO00000000000000000000000000000000";
-const URL = "https://api.fonoster.com/v1beta2";
+const URL = "https://api.fonoster.ai/v1beta2";
 const client = new SDK.WebClient({ accessKeyId: ACCESS_KEY_ID, url: URL });
 ```
 
@@ -92,7 +92,7 @@ async function main() {
   const applications = new SDK.Applications(client);
   await applications.createApplication({
     name: "MyApp",
-    type: "EXTERNAL",
+    type: "STREAM",
     endpoint: "localhost:50061" // Your app's endpoint
  });
 }
@@ -694,7 +694,8 @@ apiKeys
 
 ## Applications
 Fonoster Applications, part of the Fonoster Voice Subsystem,
-allow you to create, update, retrieve, and delete Voice Applications.
+allow you to create, update, retrieve, and delete Applications: streams (your own WebSocket
+server) and Autopilot agents.
 Note that an active Fonoster deployment is required.
 
 **Kind**: global class  
@@ -747,7 +748,7 @@ async function main(request) {
 
 const request = {
   name: "My application",
-  type: "EXTERNAL",
+  type: "STREAM",
   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
   speechToText: {
     productRef: "stt.deepgram",
@@ -778,7 +779,7 @@ Creates a new Application in Fonoster. The only required fields are the name and
 | --- | --- | --- |
 | request | <code>CreateApplicationRequest</code> | The request object that contains the necessary information to create a new application |
 | request.name | <code>string</code> | The name of the application |
-| request.type | <code>ApplicationType</code> | The type of application (e.g., EXTERNAL) |
+| request.type | <code>ApplicationType</code> | The type of application: STREAM or AUTOPILOT |
 | request.endpoint | <code>string</code> | The endpoint where the application is hosted |
 | request.speechToText | <code>SpeechToText</code> | The speech-to-text configuration |
 | request.speechToText.productRef | <code>string</code> | The product reference of the speech-to-text engine (e.g., stt.deepgram) |
@@ -796,7 +797,7 @@ const apps = new SDK.Applications(client); // Existing client object
 
 const request = {
   name: "My application",
-  type: "EXTERNAL",
+  type: "STREAM",
   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
   speechToText: {
     productRef: "stt.deepgram",
@@ -955,7 +956,7 @@ const request = {
     config: {
       conversationSettings: {
         firstMessage: "Hello, how can I help you today?",
-        systemPrompt: "You are a helpful assistant.",
+        systemPrompt: "You are a helpful agent.",
         systemErrorMessage: "I'm sorry, I didn't catch that. Can you say that again?",
         goodbyeMessage: "Thank you for calling. Have a great day!",
         languageModel: {
@@ -1139,6 +1140,7 @@ Retrieves a list of Calls from a Workspace.
 | request | <code>ListCallsRequest</code> | The request object that contains the necessary information to retrieve a list of Calls |
 | request.pageSize | <code>number</code> | The number of Calls to retrieve |
 | request.pageToken | <code>string</code> | The token to retrieve the next page of Calls |
+| request.appRef | <code>string</code> | Optional. Lists only the Calls the App with this reference handled |
 
 **Example**  
 ```js
@@ -1146,7 +1148,8 @@ const calls = new SDK.Calls(client); // Existing client object
 
 const request = {
   pageSize: 10,
-  pageToken: "00000000-0000-0000-0000-000000000000"
+  pageToken: "00000000-0000-0000-0000-000000000000",
+  appRef: "00000000-0000-0000-0000-000000000000" // Optional: only this App's Calls
 };
 
 calls

package/dist/node/Agents.js

@@ -114,15 +114,8 @@ class Agents {
             request: { ref },
             enumMapping: [["privacy", agents_pb_1.Privacy]]
         });
-        const credentials = response?.credentials?.toObject();
-        const domain = response?.domain?.toObject();
-        return response
-            ? {
-                ...response,
-                credentials,
-                domain
-            }
-            : null;
+        // The domain and credentials come back as plain objects (objectToJson).
+        return response ?? null;
     }
     /**
      * Updates an existing Agent in the Workspace.
@@ -192,19 +185,11 @@ class Agents {
             enumMapping: [["privacy", agents_pb_1.Privacy]],
             repeatableObjectMapping: [["itemsList", agents_pb_1.Agent]]
         });
-        // Manually extract nested objects for each agent
-        const processedItems = response.items?.map((agent) => {
-            const credentials = agent?.credentials?.toObject();
-            const domain = agent?.domain?.toObject();
-            return {
-                ...agent,
-                credentials,
-                domain
-            };
-        });
+        // Each agent's domain and credentials come back as plain objects
+        // (objectToJson); calling toObject() on them threw "toObject is not a function".
         return {
             ...response,
-            items: processedItems || []
+            items: response.items ?? []
         };
     }
     /**

package/dist/node/Applications.d.ts

@@ -16,57 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Application, BaseApiObject, CreateApplicationRequest, EvaluateIntelligenceEvent, EvaluateIntelligenceRequest, ListApplicationsRequest, ListApplicationsResponse, UpdateApplicationRequest } from "@fonoster/types";
+import { Application, BaseApiObject, CreateApplicationRequest, CreateApplicationResponse, EvaluateIntelligenceEvent, EvaluateIntelligenceRequest, ListApplicationsRequest, ListApplicationsResponse, RotateSigningSecretResponse, UpdateApplicationRequest, UpdateApplicationResponse } from "@fonoster/types";
 import { FonosterClient } from "./client/types";
 import { TestTokenResponse } from "./generated/node/applications_pb";
-/**
- * @classdesc Fonoster Applications, part of the Fonoster Voice Subsystem,
- * allow you to create, update, retrieve, and delete Voice Applications.
- * Note that an active Fonoster deployment is required.
- *
- * @example
- *
- * const SDK = require("@fonoster/sdk");
- *
- * async function main(request) {
- *   const apiKey = "your-api-key";
- *   const apiSecret = "your-api-secret"
- *   const accessKeyId = "WO00000000000000000000000000000000";
- *
- *   try {
- *     const client = SDK.Client({ accessKeyId });
- *     await client.loginWithApiKey(apiKey, apiSecret);
- *
- *     const apps = new SDK.Applications(client);
- *     const response = await apps.createApplication(request);
- *
- *     console.log(response); // successful response
- *   } catch (e) {
- *     console.error(e); // an error occurred
- *   }
- * }
- *
- * const request = {
- *   name: "My application",
- *   type: "EXTERNAL",
- *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
- *   speechToText: {
- *     productRef: "stt.deepgram",
- *     config: {
- *       model: "nova-2",
- *       languageCode: "en-US"
- *     }
- *   },
- *   textToSpeech: {
- *     productRef: "tts.elevenlabs",
- *     config: {
- *       voice: "lrTWbMInQjSJ9q5ywFKP"
- *     }
- *   }
- * };
- *
- * main(request);
- */
 declare class Applications {
     private readonly client;
     /**
@@ -82,37 +34,19 @@ declare class Applications {
      *
      * @param {CreateApplicationRequest} request - The request object that contains the necessary information to create a new application
      * @param {string} request.name - The name of the application
-     * @param {ApplicationType} request.type - The type of application (e.g., EXTERNAL)
+     * @param {ApplicationType} request.type - The type of application: STREAM or AUTOPILOT
      * @param {string} request.endpoint - The endpoint where the application is hosted
-     * @param {SpeechToText} request.speechToText - The speech-to-text configuration
-     * @param {string} request.speechToText.productRef - The product reference of the speech-to-text engine (e.g., stt.deepgram)
-     * @param {object} request.speechToText.config - The configuration object for the speech-to-text engine (e.g., { model: "nova-2", languageCode: "en-US" })
-     * @param {TextToSpeech} request.textToSpeech - The text-to-speech configuration
-     * @param {string} request.textToSpeech.productRef - The product reference of the text-to-speech engine (e.g., tts.elevenlabs)
-     * @param {object} request.textToSpeech.config - The configuration object for the text-to-speech engine (e.g., { voice: "lrTWbMInQjSJ9q5ywFKP" })
      * @param {Intelligence} request.intelligence - The intelligence configuration
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {Promise<CreateAppResponse>} - The response object that contains the reference to the newly created application
      * @example
      * const apps = new SDK.Applications(client); // Existing client object
      *
      * const request = {
      *   name: "My application",
-     *   type: "EXTERNAL",
-     *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
-     *   speechToText: {
-     *     productRef: "stt.deepgram",
-     *     config: {
-     *       languageCode: "en-US"
-     *     }
-     *   },
-     *   textToSpeech: {
-     *     productRef: "tts.elevenlabs",
-     *     config: {
-     *       voice: "lrTWbMInQjSJ9q5ywFKP"
-     *     }
-     *   }
+     *   type: "STREAM",
+     *   url: "wss://bot.example.com/session",
+     *   speech: { voice: "elevenlabs/21m00Tcm4TlvDq8ikWAM", language: "en-US" }
      * };
      *
      * apps
@@ -120,7 +54,7 @@ declare class Applications {
      *   .then(console.log) // successful response
      *   .catch(console.error); // an error occurred
      */
-    createApplication(request: CreateApplicationRequest): Promise<BaseApiObject>;
+    createApplication(request: CreateApplicationRequest): Promise<CreateApplicationResponse>;
     /**
      * Retrieves an existing Application in the Workspace.
      *
@@ -144,15 +78,8 @@ declare class Applications {
      * @param {string} request.ref - The reference of the application to update
      * @param {string} request.name - The name of the application
      * @param {string} request.endpoint - The endpoint where the application is hosted
-     * @param {SpeechToText} request.speechToText - The speech-to-text configuration
-     * @param {string} request.speechToText.productRef - The product reference of the speech-to-text engine (e.g., stt.deepgram)
-     * @param {object} request.speechToText.config - The configuration object for the speech-to-text engine (e.g., { model: "nova-2", languageCode: "en-US" })
-     * @param {TextToSpeech} request.textToSpeech - The text-to-speech configuration
-     * @param {string} request.textToSpeech.productRef - The product reference of the text-to-speech engine (e.g., tts.elevenlabs)
-     * @param {object} request.textToSpeech.config - The configuration object for the text-to-speech engine (e.g., { voice: "lrTWbMInQjSJ9q5ywFKP" })
      * @param {Intelligence} request.intelligence - The intelligence configuration
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {Promise<BaseApiObject>} - The response object that contains the reference to the updated application
      * @example
      * const apps = new SDK.Applications(client); // Existing client object
@@ -160,7 +87,7 @@ declare class Applications {
      * const request = {
      *   ref: "00000000-0000-0000-0000-000000000000",
      *   name: "My application",
-     *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
+     *   url: "wss://bot.example.com/session"
      * };
      *
      * apps
@@ -168,7 +95,7 @@ declare class Applications {
      *   .then(console.log) // successful response
      *   .catch(console.error); // an error occurred
      */
-    updateApplication(request: UpdateApplicationRequest): Promise<BaseApiObject>;
+    updateApplication(request: UpdateApplicationRequest): Promise<UpdateApplicationResponse>;
     /**
      * Retrieves a list of Applications from Fonoster.
      *
@@ -206,13 +133,22 @@ declare class Applications {
      *   .then(console.log) // successful response
      *   .catch(console.error); // an error occurred
      */
+    /**
+     * Replaces the app's signing secret. The old secret stops working at once (no overlap window),
+     * so redeploy the app with the new one. The secret is returned only here.
+     *
+     * @param {string} ref - The application's reference
+     * @return {Promise<RotateSigningSecretResponse>} - The new secret and its hint
+     * @example
+     * const { signingSecret } = await applications.rotateSigningSecret("00000000-...");
+     */
+    rotateSigningSecret(ref: string): Promise<RotateSigningSecretResponse>;
     deleteApplication(ref: string): Promise<BaseApiObject>;
     /**
      * Evaluates the intelligence of an application.
      *
      * @param {EvaluateIntelligenceRequest} request - The request object that contains the necessary information to evaluate the intelligence of an application
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {AsyncGenerator<EvaluateIntelligenceEvent>} - Stream of evaluation events (step results, scenario summaries, or errors)
      * @example
      * const apps = new SDK.Applications(client);

package/dist/node/Applications.js

@@ -27,7 +27,8 @@ const applications_pb_1 = require("./generated/node/applications_pb");
 const utils_1 = require("./utils");
 /**
  * @classdesc Fonoster Applications, part of the Fonoster Voice Subsystem,
- * allow you to create, update, retrieve, and delete Voice Applications.
+ * allow you to create, update, retrieve, and delete Applications: streams (your own WebSocket
+ * server) and Autopilot agents.
  * Note that an active Fonoster deployment is required.
  *
  * @example
@@ -54,25 +55,34 @@ const utils_1 = require("./utils");
  *
  * const request = {
  *   name: "My application",
- *   type: "EXTERNAL",
- *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
- *   speechToText: {
- *     productRef: "stt.deepgram",
- *     config: {
- *       model: "nova-2",
- *       languageCode: "en-US"
- *     }
- *   },
- *   textToSpeech: {
- *     productRef: "tts.elevenlabs",
- *     config: {
- *       voice: "lrTWbMInQjSJ9q5ywFKP"
- *     }
- *   }
+ *   type: "STREAM",
+ *   url: "wss://bot.example.com/session", // Serves the session protocol (@fonoster/voice)
+ *   protocol: "fonoster", // or "twilio" for a Twilio Media Streams server
+ *   speech: { voice: "elevenlabs/21m00Tcm4TlvDq8ikWAM", language: "en-US" }
  * };
  *
  * main(request);
  */
+/** Nested messages of create and update requests (the application model). */
+const REQUEST_OBJECTS = [
+    ["intelligence", applications_pb_1.ProductContainer],
+    ["speech", applications_pb_1.SpeechDefaults],
+    ["audio", applications_pb_1.AudioFormat],
+    ["listeners", applications_pb_1.Listener],
+    ["amd", applications_pb_1.AmdSettings],
+    ["filters", applications_pb_1.AudioFilter]
+];
+/** Repeated messages of an Application in responses (their options Structs are converted after). */
+const RESPONSE_REPEATED = [["filtersList", applications_pb_1.AudioFilter]];
+/** Repeated fields come back as `listenersList` when empty; always return `listeners`. */
+function withSessionFields(app) {
+    const { listenersList, filtersList, ...rest } = app;
+    return {
+        ...rest,
+        listeners: (rest.listeners ?? listenersList ?? []),
+        filters: (rest.filters ?? filtersList ?? [])
+    };
+}
 class Applications {
     client;
     /**
@@ -90,37 +100,19 @@ class Applications {
      *
      * @param {CreateApplicationRequest} request - The request object that contains the necessary information to create a new application
      * @param {string} request.name - The name of the application
-     * @param {ApplicationType} request.type - The type of application (e.g., EXTERNAL)
+     * @param {ApplicationType} request.type - The type of application: STREAM or AUTOPILOT
      * @param {string} request.endpoint - The endpoint where the application is hosted
-     * @param {SpeechToText} request.speechToText - The speech-to-text configuration
-     * @param {string} request.speechToText.productRef - The product reference of the speech-to-text engine (e.g., stt.deepgram)
-     * @param {object} request.speechToText.config - The configuration object for the speech-to-text engine (e.g., { model: "nova-2", languageCode: "en-US" })
-     * @param {TextToSpeech} request.textToSpeech - The text-to-speech configuration
-     * @param {string} request.textToSpeech.productRef - The product reference of the text-to-speech engine (e.g., tts.elevenlabs)
-     * @param {object} request.textToSpeech.config - The configuration object for the text-to-speech engine (e.g., { voice: "lrTWbMInQjSJ9q5ywFKP" })
      * @param {Intelligence} request.intelligence - The intelligence configuration
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {Promise<CreateAppResponse>} - The response object that contains the reference to the newly created application
      * @example
      * const apps = new SDK.Applications(client); // Existing client object
      *
      * const request = {
      *   name: "My application",
-     *   type: "EXTERNAL",
-     *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
-     *   speechToText: {
-     *     productRef: "stt.deepgram",
-     *     config: {
-     *       languageCode: "en-US"
-     *     }
-     *   },
-     *   textToSpeech: {
-     *     productRef: "tts.elevenlabs",
-     *     config: {
-     *       voice: "lrTWbMInQjSJ9q5ywFKP"
-     *     }
-     *   }
+     *   type: "STREAM",
+     *   url: "wss://bot.example.com/session",
+     *   speech: { voice: "elevenlabs/21m00Tcm4TlvDq8ikWAM", language: "en-US" }
      * };
      *
      * apps
@@ -137,11 +129,7 @@ class Applications {
             metadata: this.client.getMetadata(),
             request: reqWithStructOverride,
             enumMapping: [["type", applications_pb_1.ApplicationType]],
-            objectMapping: [
-                ["textToSpeech", applications_pb_1.ProductContainer],
-                ["speechToText", applications_pb_1.ProductContainer],
-                ["intelligence", applications_pb_1.ProductContainer]
-            ]
+            objectMapping: REQUEST_OBJECTS
         });
     }
     /**
@@ -167,13 +155,10 @@ class Applications {
             metadata: this.client.getMetadata(),
             request: { ref },
             enumMapping: [["type", applications_pb_1.ApplicationType]],
-            objectMapping: [
-                ["textToSpeech", applications_pb_1.ProductContainer],
-                ["speechToText", applications_pb_1.ProductContainer],
-                ["intelligence", applications_pb_1.ProductContainer]
-            ]
+            objectMapping: [["intelligence", applications_pb_1.ProductContainer]],
+            repeatableObjectMapping: RESPONSE_REPEATED
         });
-        return (0, utils_1.buildStructOverrideReverse)(response);
+        return withSessionFields((0, utils_1.buildStructOverrideReverse)(response));
     }
     /**
      * Updates an existing application in Fonoster.
@@ -182,15 +167,8 @@ class Applications {
      * @param {string} request.ref - The reference of the application to update
      * @param {string} request.name - The name of the application
      * @param {string} request.endpoint - The endpoint where the application is hosted
-     * @param {SpeechToText} request.speechToText - The speech-to-text configuration
-     * @param {string} request.speechToText.productRef - The product reference of the speech-to-text engine (e.g., stt.deepgram)
-     * @param {object} request.speechToText.config - The configuration object for the speech-to-text engine (e.g., { model: "nova-2", languageCode: "en-US" })
-     * @param {TextToSpeech} request.textToSpeech - The text-to-speech configuration
-     * @param {string} request.textToSpeech.productRef - The product reference of the text-to-speech engine (e.g., tts.elevenlabs)
-     * @param {object} request.textToSpeech.config - The configuration object for the text-to-speech engine (e.g., { voice: "lrTWbMInQjSJ9q5ywFKP" })
      * @param {Intelligence} request.intelligence - The intelligence configuration
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {Promise<BaseApiObject>} - The response object that contains the reference to the updated application
      * @example
      * const apps = new SDK.Applications(client); // Existing client object
@@ -198,7 +176,7 @@ class Applications {
      * const request = {
      *   ref: "00000000-0000-0000-0000-000000000000",
      *   name: "My application",
-     *   endpoint: "welcome.demo.fonoster.local", // Built-in demo application
+     *   url: "wss://bot.example.com/session"
      * };
      *
      * apps
@@ -215,11 +193,7 @@ class Applications {
             metadata: this.client.getMetadata(),
             request: reqWithStructOverride,
             enumMapping: [["type", applications_pb_1.ApplicationType]],
-            objectMapping: [
-                ["textToSpeech", applications_pb_1.ProductContainer],
-                ["speechToText", applications_pb_1.ProductContainer],
-                ["intelligence", applications_pb_1.ProductContainer]
-            ]
+            objectMapping: REQUEST_OBJECTS
         });
     }
     /**
@@ -250,15 +224,14 @@ class Applications {
             metadata: this.client.getMetadata(),
             request,
             enumMapping: [["type", applications_pb_1.ApplicationType]],
-            objectMapping: [
-                ["speechToText", applications_pb_1.ProductContainer],
-                ["textToSpeech", applications_pb_1.ProductContainer],
-                ["intelligence", applications_pb_1.ProductContainer]
-            ],
-            repeatableObjectMapping: [["itemsList", applications_pb_1.Application]]
+            objectMapping: [["intelligence", applications_pb_1.ProductContainer]],
+            repeatableObjectMapping: [
+                ["itemsList", applications_pb_1.Application],
+                ...RESPONSE_REPEATED
+            ]
         });
         return {
-            items: response.items.map(utils_1.buildStructOverrideReverse),
+            items: response.items.map((item) => withSessionFields((0, utils_1.buildStructOverrideReverse)(item))),
             nextPageToken: response.nextPageToken
         };
     }
@@ -278,6 +251,24 @@ class Applications {
      *   .then(console.log) // successful response
      *   .catch(console.error); // an error occurred
      */
+    /**
+     * Replaces the app's signing secret. The old secret stops working at once (no overlap window),
+     * so redeploy the app with the new one. The secret is returned only here.
+     *
+     * @param {string} ref - The application's reference
+     * @return {Promise<RotateSigningSecretResponse>} - The new secret and its hint
+     * @example
+     * const { signingSecret } = await applications.rotateSigningSecret("00000000-...");
+     */
+    async rotateSigningSecret(ref) {
+        const applicationsClient = this.client.getApplicationsClient();
+        return await (0, makeRpcRequest_1.makeRpcRequest)({
+            method: applicationsClient.rotateSigningSecret.bind(applicationsClient),
+            requestPBObjectConstructor: applications_pb_1.RotateSigningSecretRequest,
+            metadata: this.client.getMetadata(),
+            request: { ref }
+        });
+    }
     async deleteApplication(ref) {
         const applicationsClient = this.client.getApplicationsClient();
         return await (0, makeRpcRequest_1.makeRpcRequest)({
@@ -291,8 +282,7 @@ class Applications {
      * Evaluates the intelligence of an application.
      *
      * @param {EvaluateIntelligenceRequest} request - The request object that contains the necessary information to evaluate the intelligence of an application
-     * @param {string} request.intelligence.productRef - The product reference of the intelligence engine (e.g., llm.groq)
-     * @param {object} request.intelligence.config - The configuration object for the intelligence engine
+     * @param {object} request.intelligence.config - Autopilot agents: the agent (its model is a catalog id such as openai/gpt-4o-mini)
      * @return {AsyncGenerator<EvaluateIntelligenceEvent>} - Stream of evaluation events (step results, scenario summaries, or errors)
      * @example
      * const apps = new SDK.Applications(client);
@@ -329,7 +319,7 @@ class Applications {
             streamError = err instanceof Error ? err : new Error(String(err));
             done = true;
         });
-        while (!done || queue.length > 0) {
+        while (!done || queue.length > 0 || streamError) {
             if (streamError)
                 throw streamError;
             if (queue.length > 0) {

package/dist/node/Billing.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * 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 { BillingSummary, CreatePortalSessionRequest, CreatePortalSessionResponse, CreateTopUpRequest, UpdateAutoRechargeRequest } from "@fonoster/types";
+import { FonosterClient } from "./client/types";
+/**
+ * @classdesc Fonoster Cloud's billing for the owner signed in: the balance in credits
+ * (1 credit = $0.01) by source, the plan, top-ups, auto-recharge and the Stripe Customer Portal.
+ * Only workspace owners may call it, and only on Fonoster Cloud (the capabilities say
+ * `billing.enabled`). The account is always the caller's: it covers every workspace they own.
+ *
+ * @example
+ * const billing = new SDK.Billing(client);
+ * const { balance, sources } = await billing.getBilling();
+ * await billing.createTopUp({ credits: 1000 });
+ */
+declare class Billing {
+    private readonly client;
+    constructor(client: FonosterClient);
+    /** The balance by source, the plan and auto-recharge. */
+    getBilling(): Promise<BillingSummary>;
+    /** Turns auto-recharge on or off, with its threshold and amount in credits. */
+    updateAutoRecharge(request: UpdateAutoRechargeRequest): Promise<BillingSummary>;
+    /**
+     * Buys top-up credits, charged to the payment method added in the Customer Portal, with tax on
+     * top. The credits appear once the payment succeeds.
+     */
+    createTopUp(request: CreateTopUpRequest): Promise<BillingSummary>;
+    /** Moves the owner from the Trial to Pay-as-you-go. Needs a payment method first. */
+    subscribe(): Promise<BillingSummary>;
+    /** A Stripe Customer Portal link for payment methods and invoices. */
+    createPortalSession(request: CreatePortalSessionRequest): Promise<CreatePortalSessionResponse>;
+    private summary;
+}
+export { Billing };