@happyrobot-ai/sdk 0.1.25 → 0.1.27

package/README.md

@@ -181,6 +181,9 @@ const { data } = await client.workflows.listVersions("my-workflow");
 // List runs
 const { data } = await client.workflows.listRuns("my-workflow");
 
+// List sessions across all runs
+const { data: sessions } = await client.workflows.listSessions("my-workflow");
+
 // Trigger a run
 const { run_id } = await client.workflows.triggerRun("my-workflow", { payload: { phone: "+1..." } });
 ```
@@ -200,6 +203,7 @@ const { run_id } = await client.workflows.triggerRun("my-workflow", { payload: {
 | `listTemplates(query?)`            | GET    | `/workflows/templates`       | List workflow templates        |
 | `listVersions(workflowId, query?)` | GET    | `/workflows/:id/versions`    | List versions for a workflow   |
 | `listRuns(workflowId, query?)`     | GET    | `/workflows/:id/runs`        | List runs for a workflow       |
+| `listSessions(workflowId, query?)` | GET    | `/workflows/:id/sessions`    | List sessions for a workflow   |
 | `triggerRun(workflowId, body?)`    | POST   | `/workflows/:id/runs`        | Trigger a new run              |
 
 ---

package/package.json

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

package/resources/voice.d.ts

@@ -33,9 +33,9 @@ export declare class VoiceResource {
      * Call this from your server, then pass the returned `url` and `token`
      * to the browser where they can be used to initialize `HappyRobotVoiceClient`.
      *
-     * Provide `workflow_id` to start a new call, or `session_id` to join an
-     * in-progress call. Pair `session_id` with `should_takeover: true` to drop
-     * the AI agent and take over the call.
+     * Provide `workflow_id` to start a new call, or `session_id` (with the
+     * required `should_takeover: true`) to take over an in-progress call, which
+     * drops the AI agent.
      */
     createToken(body: CreateVoiceTokenBody): Promise<CreateVoiceTokenResponse>;
 }

package/resources/voice.js

@@ -36,9 +36,9 @@ class VoiceResource {
      * Call this from your server, then pass the returned `url` and `token`
      * to the browser where they can be used to initialize `HappyRobotVoiceClient`.
      *
-     * Provide `workflow_id` to start a new call, or `session_id` to join an
-     * in-progress call. Pair `session_id` with `should_takeover: true` to drop
-     * the AI agent and take over the call.
+     * Provide `workflow_id` to start a new call, or `session_id` (with the
+     * required `should_takeover: true`) to take over an in-progress call, which
+     * drops the AI agent.
      */
     async createToken(body) {
         return this.http.request({

package/resources/workflows.d.ts

@@ -15,10 +15,11 @@
  *   GET    /workflows/:workflow_id/versions
  *   GET    /workflows/:workflow_id/runs
  *   POST   /workflows/:workflow_id/runs
+ *   GET    /workflows/:workflow_id/sessions
  */
 import type { HttpClient } from "../core/http";
 import type { WorkflowRunsQuery, PaginatedWorkflowRunsResponse, TriggerRunBody, TriggerRunResponse, TriggerRunWithFileBody } from "../types/runs.types";
-import type { ListWorkflowsQuery, WorkflowListItem, PaginatedWorkflowsResponse, CreateWorkflowBody, CreateWorkflowResponse, WorkflowDetailResponse, UpdateWorkflowBody, UpdateWorkflowResponse, DuplicateWorkflowBody, DuplicateWorkflowResponse, ListTemplatesQuery, PaginatedTemplatesResponse, WorkflowPublishResponse, WorkflowUnpublishResponse, CancelRunsBody, CancelRunsResponse, ListWorkflowVersionsQuery, PaginatedWorkflowVersionsResponse } from "../types/workflows.types";
+import type { ListWorkflowsQuery, WorkflowListItem, PaginatedWorkflowsResponse, CreateWorkflowBody, CreateWorkflowResponse, WorkflowDetailResponse, UpdateWorkflowBody, UpdateWorkflowResponse, DuplicateWorkflowBody, DuplicateWorkflowResponse, ListTemplatesQuery, PaginatedTemplatesResponse, WorkflowPublishResponse, WorkflowUnpublishResponse, CancelRunsBody, CancelRunsResponse, ListWorkflowVersionsQuery, PaginatedWorkflowVersionsResponse, ListWorkflowSessionsQuery, PaginatedWorkflowSessionsResponse } from "../types/workflows.types";
 export declare class WorkflowsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -50,6 +51,8 @@ export declare class WorkflowsResource {
     listVersions(workflowId: string, query?: ListWorkflowVersionsQuery): Promise<PaginatedWorkflowVersionsResponse>;
     /** List runs for a workflow. */
     listRuns(workflowId: string, query?: WorkflowRunsQuery): Promise<PaginatedWorkflowRunsResponse>;
+    /** List sessions for a workflow across all runs. */
+    listSessions(workflowId: string, query?: ListWorkflowSessionsQuery): Promise<PaginatedWorkflowSessionsResponse>;
     /** Trigger a run for a workflow (JSON payload or file upload). */
     triggerRun(workflowId: string, body?: TriggerRunBody | TriggerRunWithFileBody): Promise<TriggerRunResponse>;
     private triggerRunWithFile;

package/resources/workflows.js

@@ -16,6 +16,7 @@
  *   GET    /workflows/:workflow_id/versions
  *   GET    /workflows/:workflow_id/runs
  *   POST   /workflows/:workflow_id/runs
+ *   GET    /workflows/:workflow_id/sessions
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowsResource = void 0;
@@ -122,6 +123,14 @@ class WorkflowsResource {
             query: query,
         });
     }
+    /** List sessions for a workflow across all runs. */
+    async listSessions(workflowId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/workflows/${encodeURIComponent(workflowId)}/sessions`,
+            query: query,
+        });
+    }
     /** Trigger a run for a workflow (JSON payload or file upload). */
     async triggerRun(workflowId, body) {
         const path = `/workflows/${encodeURIComponent(workflowId)}/runs`;

package/types/voice.types.d.ts

@@ -24,17 +24,17 @@ export type CreateVoiceTokenBody = (CreateVoiceTokenBase & {
     should_takeover?: never;
 }) | (CreateVoiceTokenBase & {
     /**
-     * ID of an in-progress session to join. Generates a token for the
+     * ID of an in-progress session to take over. Generates a token for the
      * session's existing LiveKit room.
      */
     session_id: string;
     workflow_id?: never;
     /**
-     * When `true`, the joining participant takes over the call and the AI
-     * agent drops. When `false` (default), the participant joins alongside
-     * the agent without dropping it.
+     * Must be `true`. Explicit opt-in confirming the joining participant
+     * takes over the call and the AI agent drops. Joining a live call
+     * without taking over is not supported.
      */
-    should_takeover?: boolean;
+    should_takeover: true;
 });
 /** POST /voice/tokens response. */
 export interface CreateVoiceTokenResponse {

package/types/workflows.types.d.ts

@@ -3,6 +3,8 @@
  * Uses import type — erased at compile time.
  */
 import type { z } from "zod";
+import type { ListSessionsQuerySchema } from "../../routes/sessions/schemas";
+import type { PaginatedWorkflowSessionsResponseSchema, WorkflowSessionItemSchema } from "../../routes/workflows/:workflow_id/sessions/schemas";
 import type { ListWorkflowsQuerySchema, WorkflowListItemSchema, PaginatedWorkflowsResponseSchema, CreateWorkflowBodySchema, CreateWorkflowResponseSchema, WorkflowDetailResponseSchema, UpdateWorkflowBodySchema, UpdateWorkflowResponseSchema, DuplicateWorkflowBodySchema, DuplicateWorkflowResponseSchema, PaginatedTemplatesResponseSchema, ListTemplatesQuerySchema, WorkflowPublishResponseSchema, WorkflowPublishErrorResponseSchema, WorkflowUnpublishResponseSchema, CancelRunsBodySchema, CancelRunsResponseSchema, ListWorkflowVersionsQuerySchema, PaginatedWorkflowVersionsResponseSchema } from "../../routes/workflows/schemas";
 export type ListWorkflowsQuery = z.output<typeof ListWorkflowsQuerySchema>;
 export type WorkflowListItem = z.infer<typeof WorkflowListItemSchema>;
@@ -23,3 +25,6 @@ export type CancelRunsBody = z.input<typeof CancelRunsBodySchema>;
 export type CancelRunsResponse = z.infer<typeof CancelRunsResponseSchema>;
 export type ListWorkflowVersionsQuery = z.input<typeof ListWorkflowVersionsQuerySchema>;
 export type PaginatedWorkflowVersionsResponse = z.infer<typeof PaginatedWorkflowVersionsResponseSchema>;
+export type ListWorkflowSessionsQuery = z.input<typeof ListSessionsQuerySchema>;
+export type WorkflowSessionItem = z.infer<typeof WorkflowSessionItemSchema>;
+export type PaginatedWorkflowSessionsResponse = z.infer<typeof PaginatedWorkflowSessionsResponseSchema>;