@happyrobot-ai/sdk 0.1.43 → 0.1.44

package/README.md

@@ -136,7 +136,7 @@ const { workflow } = await createFromTemplate(client, {
 | `client.issues`            | `IssuesResource`            | Quality issue (flag) status management               |
 | `client.auditRemarks`      | `AuditRemarksResource`      | Audit remark feedback management                     |
 | `client.chat`              | `ChatResource`              | Chat session management, messaging, and file uploads |
-| `client.voice`             | `VoiceResource`             | Voice call token creation                            |
+| `client.voice`             | `VoiceResource`             | Voice catalog lookup and call token creation         |
 
 ---
 
@@ -1046,9 +1046,23 @@ await connection.disconnect();
 
 ### `HappyRobotClient` (server-side)
 
-| Method                                                                 | Description                                                                                  |
-| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
-| `client.voice.createToken({ workflow_id, data?, env?, ttl_seconds? })` | Create a LiveKit token for voice calls. `ttl_seconds` defaults to 21600 (min 60, max 86400). |
+List the voices available to the current workspace in its cluster. Use a
+language prefix for all accents, or a locale for a location-specific result:
+
+```ts
+const voices = await client.voice.list({ language: "en-GB" });
+
+for (const voice of voices) {
+  console.log(voice.id, voice.name, voice.locales);
+}
+```
+
+`voice.id` is the value used in workflow `agent.voices` configuration.
+
+| Method                                                                 | Description                                                                                                    |
+| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `client.voice.list({ language? })`                                     | List voices available to the current workspace. `language` accepts prefixes like `en` or locales like `en-GB`. |
+| `client.voice.createToken({ workflow_id, data?, env?, ttl_seconds? })` | Create a LiveKit token for voice calls. `ttl_seconds` defaults to 21600 (min 60, max 86400).                   |
 
 ### `HappyRobotVoiceClient` (browser-side)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyrobot-ai/sdk",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "TypeScript SDK for the HappyRobot Public API",
   "main": "./index.js",
   "module": "./index.mjs",

package/resources/voice.d.ts

@@ -23,10 +23,12 @@
  * ```
  */
 import type { HttpClient } from "../core/http";
-import type { CreateVoiceTokenBody, CreateVoiceTokenResponse } from "../types/voice.types";
+import type { CreateVoiceTokenBody, CreateVoiceTokenResponse, ListVoicesQuery, ListVoicesResponse } from "../types/voice.types";
 export declare class VoiceResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** List visible voices available in the configured HappyRobot cluster. */
+    list(query?: ListVoicesQuery): Promise<ListVoicesResponse>;
     /**
      * Create a LiveKit token for browser-side voice calls.
      *

package/resources/voice.js

@@ -30,6 +30,18 @@ class VoiceResource {
     constructor(http) {
         this.http = http;
     }
+    /** List visible voices available in the configured HappyRobot cluster. */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/voices",
+            ...(query
+                ? {
+                    query: query,
+                }
+                : {}),
+        });
+    }
     /**
      * Create a LiveKit token for browser-side voice calls.
      *

package/types/voice.types.d.ts

@@ -1,3 +1,19 @@
+export interface ListVoicesQuery {
+    language?: string;
+}
+export interface Voice {
+    id: string;
+    name: string;
+    provider: "elevenlabs" | "happyrobot" | "elevenlabs-non-streaming" | "cartesia";
+    provider_voice_id: string | null;
+    model_id: string | null;
+    model_family: "turbo" | "flash" | "eleven_v3" | "happyrobot" | "sonic";
+    language: string;
+    languages: string[];
+    locales: string[];
+    gender: "male" | "female";
+}
+export type ListVoicesResponse = Voice[];
 type CreateVoiceTokenBase = {
     /** Payload data passed to the voice agent as participant attributes (`workflow_id` only). */
     data?: Record<string, unknown>;

package/voice/index.d.ts

@@ -19,4 +19,4 @@
  */
 export { HappyRobotVoiceClient } from "../voice-client";
 export type { VoiceConnectionHandlers, VoiceConnection } from "../voice-client";
-export type { CreateVoiceTokenBody, CreateVoiceTokenResponse, } from "../types/voice.types";
+export type { CreateVoiceTokenBody, CreateVoiceTokenResponse, ListVoicesQuery, ListVoicesResponse, Voice, } from "../types/voice.types";