@happyrobot-ai/sdk 0.1.5 → 0.1.6

package/types/runs.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Run types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runs.types.js.map

package/types/runs.types.mjs

@@ -0,0 +1 @@
+export * from "./runs.types.js";

package/types/sessions.types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Session types extracted from Zod schemas.
+ */
+import type { z } from "zod";
+import type { ListSessionsQuerySchema, SessionItemSchema, PaginatedSessionsResponseSchema, ListMessagesQuerySchema, MessageItemSchema, PaginatedMessagesResponseSchema, StreamQuerySchema } from "../../routes/sessions/schemas";
+export type ListSessionsQuery = z.input<typeof ListSessionsQuerySchema>;
+export type SessionItem = z.infer<typeof SessionItemSchema>;
+export type PaginatedSessionsResponse = z.infer<typeof PaginatedSessionsResponseSchema>;
+export type ListMessagesQuery = z.input<typeof ListMessagesQuerySchema>;
+export type MessageItem = z.infer<typeof MessageItemSchema>;
+export type PaginatedMessagesResponse = z.infer<typeof PaginatedMessagesResponseSchema>;
+export type StreamQuery = z.input<typeof StreamQuerySchema>;
+/** Payload for SSE "message" events from the session stream. */
+export interface StreamMessagePayload {
+    id: string;
+    session_id: string;
+    role: string;
+    content: string;
+    timestamp: string;
+    is_filler?: boolean;
+    is_interrupted?: boolean;
+    tool_calls?: unknown;
+    artifacts?: unknown;
+}
+/** Union of all SSE event data types emitted by the session stream. */
+export type SessionStreamEvent = {
+    event: "connected";
+    data: {
+        session_id: string;
+        session_status: string;
+    };
+} | {
+    event: "message";
+    data: StreamMessagePayload;
+    id?: string;
+} | {
+    event: "backfill_complete";
+    data: {
+        count: number;
+    };
+} | {
+    event: "session_ended";
+    data: {
+        status: string;
+    };
+} | {
+    event: "error";
+    data: {
+        message: string;
+    };
+};

package/types/sessions.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Session types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sessions.types.js.map

package/types/sessions.types.mjs

@@ -0,0 +1 @@
+export * from "./sessions.types.js";

package/types/sip-trunks.types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SIP trunk types extracted from Zod schemas.
+ */
+import type { z } from "zod";
+import type { SipTrunkResponseSchema, ListSipTrunksResponseSchema, CreateSipTrunkBodySchema, CreateSipTrunkBulkBodySchema, UpdateSipTrunkBodySchema, SipTrunkOptionsResponseSchema } from "../../routes/sip-trunks/schemas";
+export type SipTrunkResponse = z.infer<typeof SipTrunkResponseSchema>;
+export type ListSipTrunksResponse = z.infer<typeof ListSipTrunksResponseSchema>;
+export type CreateSipTrunkBody = z.input<typeof CreateSipTrunkBodySchema>;
+export type CreateSipTrunkBulkBody = z.input<typeof CreateSipTrunkBulkBodySchema>;
+export type UpdateSipTrunkBody = z.input<typeof UpdateSipTrunkBodySchema>;
+export type SipTrunkOptionsResponse = z.infer<typeof SipTrunkOptionsResponseSchema>;

package/types/sip-trunks.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * SIP trunk types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sip-trunks.types.js.map

package/types/sip-trunks.types.mjs

@@ -0,0 +1 @@
+export * from "./sip-trunks.types.js";

package/types/variables.types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Variable types extracted from Zod schemas.
+ */
+import type { z } from "zod";
+import type { VariableResponseSchema, ListVariablesQuerySchema, PaginatedVariablesResponseSchema, CreateVariableBodySchema, UpdateVariableBodySchema } from "../../routes/workflows/:workflow_id/variables/schemas";
+export type VariableResponse = z.infer<typeof VariableResponseSchema>;
+export type ListVariablesQuery = z.input<typeof ListVariablesQuerySchema>;
+export type PaginatedVariablesResponse = z.infer<typeof PaginatedVariablesResponseSchema>;
+export type CreateVariableBody = z.input<typeof CreateVariableBodySchema>;
+export type UpdateVariableBody = z.input<typeof UpdateVariableBodySchema>;

package/types/variables.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Variable types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=variables.types.js.map

package/types/variables.types.mjs

@@ -0,0 +1 @@
+export * from "./variables.types.js";

package/types/versions.types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Version types extracted from Zod schemas.
+ */
+import type { z } from "zod";
+import type { VersionWithNodesSummarySchema, UpdateVersionBodySchema, UpdateVersionResponseSchema, ForkVersionResponseSchema, PublishBodySchema, PublishResponseSchema, PublishErrorResponseSchema, VersionStatusResponseSchema, ListNodesResponseSchema, AddNodesBodySchema, AddNodesResponseSchema, UpdateNodeBodySchema, GetSingleNodeResponseSchema } from "../../routes/versions/:version_id/schemas";
+import type { PromptIssuesResponseSchema, PromptNodeIssuesSchema, PromptIssueSchema } from "../../routes/versions/:version_id/prompt-issues/get";
+export type VersionWithNodesSummary = z.infer<typeof VersionWithNodesSummarySchema>;
+export type UpdateVersionBody = z.input<typeof UpdateVersionBodySchema>;
+export type UpdateVersionResponse = z.infer<typeof UpdateVersionResponseSchema>;
+export type ForkVersionResponse = z.infer<typeof ForkVersionResponseSchema>;
+export type PublishBody = z.input<typeof PublishBodySchema>;
+export type PublishResponse = z.infer<typeof PublishResponseSchema>;
+export type PublishErrorResponse = z.infer<typeof PublishErrorResponseSchema>;
+export type VersionStatusResponse = z.infer<typeof VersionStatusResponseSchema>;
+export type ListNodesResponse = z.infer<typeof ListNodesResponseSchema>;
+export type AddNodesBody = z.input<typeof AddNodesBodySchema>;
+export type AddNodesResponse = z.infer<typeof AddNodesResponseSchema>;
+export type UpdateNodeBody = z.input<typeof UpdateNodeBodySchema>;
+export type GetSingleNodeResponse = z.infer<typeof GetSingleNodeResponseSchema>;
+export type PromptIssue = z.infer<typeof PromptIssueSchema>;
+export type PromptNodeIssues = z.infer<typeof PromptNodeIssuesSchema>;
+export type PromptIssuesResponse = z.infer<typeof PromptIssuesResponseSchema>;

package/types/versions.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Version types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=versions.types.js.map

package/types/versions.types.mjs

@@ -0,0 +1 @@
+export * from "./versions.types.js";

package/types/voice.types.d.ts

@@ -0,0 +1,13 @@
+/** POST /voice/tokens request body. */
+export interface CreateVoiceTokenBody {
+    workflow_id: string;
+    data?: Record<string, unknown>;
+    env?: "production" | "staging" | "development";
+}
+/** POST /voice/tokens response. */
+export interface CreateVoiceTokenResponse {
+    url: string;
+    token: string;
+    room_name: string;
+    run_id: string;
+}

package/types/voice.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=voice.types.js.map

package/types/voice.types.mjs

@@ -0,0 +1 @@
+export * from "./voice.types.js";

package/types/workflow-folders.types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workflow folder types extracted from Zod schemas.
+ */
+import type { z } from "zod";
+import type { WorkflowFolderSchema, PaginatedFoldersResponseSchema, ListFoldersQuerySchema, CreateFolderBodySchema } from "../../routes/workflow-folders/schemas";
+export type WorkflowFolder = z.infer<typeof WorkflowFolderSchema>;
+export type PaginatedFoldersResponse = z.infer<typeof PaginatedFoldersResponseSchema>;
+export type ListFoldersQuery = z.input<typeof ListFoldersQuerySchema>;
+export type CreateFolderBody = z.input<typeof CreateFolderBodySchema>;

package/types/workflow-folders.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Workflow folder types extracted from Zod schemas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflow-folders.types.js.map

package/types/workflow-folders.types.mjs

@@ -0,0 +1 @@
+export * from "./workflow-folders.types.js";

package/types/workflows.types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Workflow types extracted from Zod schemas.
+ * Uses import type — erased at compile time.
+ */
+import type { z } from "zod";
+import type { ListWorkflowsQuerySchema, WorkflowListItemSchema, PaginatedWorkflowsResponseSchema, CreateWorkflowBodySchema, CreateWorkflowResponseSchema, WorkflowDetailResponseSchema, UpdateWorkflowBodySchema, UpdateWorkflowResponseSchema, DuplicateWorkflowBodySchema, DuplicateWorkflowResponseSchema, PaginatedTemplatesResponseSchema, ListTemplatesQuerySchema, WorkflowPublishResponseSchema, WorkflowPublishErrorResponseSchema, WorkflowUnpublishResponseSchema, CancelRunsResponseSchema, ListWorkflowVersionsQuerySchema, PaginatedWorkflowVersionsResponseSchema } from "../../routes/workflows/schemas";
+export type ListWorkflowsQuery = z.input<typeof ListWorkflowsQuerySchema>;
+export type WorkflowListItem = z.infer<typeof WorkflowListItemSchema>;
+export type PaginatedWorkflowsResponse = z.infer<typeof PaginatedWorkflowsResponseSchema>;
+export type CreateWorkflowBody = z.input<typeof CreateWorkflowBodySchema>;
+export type CreateWorkflowResponse = z.infer<typeof CreateWorkflowResponseSchema>;
+export type WorkflowDetailResponse = z.infer<typeof WorkflowDetailResponseSchema>;
+export type UpdateWorkflowBody = z.input<typeof UpdateWorkflowBodySchema>;
+export type UpdateWorkflowResponse = z.infer<typeof UpdateWorkflowResponseSchema>;
+export type DuplicateWorkflowBody = z.input<typeof DuplicateWorkflowBodySchema>;
+export type DuplicateWorkflowResponse = z.infer<typeof DuplicateWorkflowResponseSchema>;
+export type ListTemplatesQuery = z.input<typeof ListTemplatesQuerySchema>;
+export type PaginatedTemplatesResponse = z.infer<typeof PaginatedTemplatesResponseSchema>;
+export type WorkflowPublishResponse = z.infer<typeof WorkflowPublishResponseSchema>;
+export type WorkflowPublishErrorResponse = z.infer<typeof WorkflowPublishErrorResponseSchema>;
+export type WorkflowUnpublishResponse = z.infer<typeof WorkflowUnpublishResponseSchema>;
+export type CancelRunsResponse = z.infer<typeof CancelRunsResponseSchema>;
+export type ListWorkflowVersionsQuery = z.input<typeof ListWorkflowVersionsQuerySchema>;
+export type PaginatedWorkflowVersionsResponse = z.infer<typeof PaginatedWorkflowVersionsResponseSchema>;

package/types/workflows.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Workflow types extracted from Zod schemas.
+ * Uses import type — erased at compile time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflows.types.js.map

package/types/workflows.types.mjs

@@ -0,0 +1 @@
+export * from "./workflows.types.js";

package/voice/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @happyrobot-ai/sdk/voice — Browser-side voice client (WebRTC via LiveKit).
+ *
+ * Requires `livekit-client` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * import { HappyRobotVoiceClient } from "@happyrobot-ai/sdk/voice";
+ *
+ * const voice = new HappyRobotVoiceClient({ url, token });
+ * const connection = await voice.connect({
+ *   onConnected: () => console.log("Connected!"),
+ *   onAgentConnected: (p) => console.log("Agent joined:", p.identity),
+ * });
+ *
+ * // Later…
+ * await connection.disconnect();
+ * ```
+ */
+export { HappyRobotVoiceClient } from "../voice-client";
+export type { VoiceConnectionHandlers, VoiceConnection } from "../voice-client";
+export type { CreateVoiceTokenBody, CreateVoiceTokenResponse, } from "../types/voice.types";

package/voice/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @happyrobot-ai/sdk/voice — Browser-side voice client (WebRTC via LiveKit).
+ *
+ * Requires `livekit-client` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * import { HappyRobotVoiceClient } from "@happyrobot-ai/sdk/voice";
+ *
+ * const voice = new HappyRobotVoiceClient({ url, token });
+ * const connection = await voice.connect({
+ *   onConnected: () => console.log("Connected!"),
+ *   onAgentConnected: (p) => console.log("Agent joined:", p.identity),
+ * });
+ *
+ * // Later…
+ * await connection.disconnect();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HappyRobotVoiceClient = void 0;
+var voice_client_1 = require("../voice-client");
+Object.defineProperty(exports, "HappyRobotVoiceClient", { enumerable: true, get: function () { return voice_client_1.HappyRobotVoiceClient; } });
+//# sourceMappingURL=index.js.map

package/voice/index.mjs

@@ -0,0 +1,3 @@
+import * as _cjs from "./index.js";
+const { HappyRobotVoiceClient } = _cjs;
+export { HappyRobotVoiceClient };

package/voice-client.d.ts

@@ -0,0 +1,87 @@
+/**
+ * HappyRobotVoiceClient — browser-side client for voice calls with AI agents.
+ *
+ * Wraps `livekit-client` Room with HappyRobot defaults for audio-only calls.
+ * Requires `livekit-client` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * import { HappyRobotVoiceClient } from "@happyrobot-ai/sdk/voice";
+ *
+ * // Token comes from your server via client.voice.createToken()
+ * const voice = new HappyRobotVoiceClient({ url, token });
+ *
+ * const connection = await voice.connect({
+ *   onConnected: () => console.log("Connected!"),
+ *   onAgentConnected: (p) => console.log("Agent joined:", p.identity),
+ *   onDisconnected: (reason) => console.log("Disconnected:", reason),
+ * });
+ *
+ * // Mute/unmute
+ * await connection.mute();
+ * await connection.unmute();
+ *
+ * // End the call
+ * await connection.disconnect();
+ * ```
+ */
+import { Room } from "livekit-client";
+export interface VoiceConnectionHandlers {
+    /** Room connection established. */
+    onConnected?: () => void;
+    /** Room disconnected. */
+    onDisconnected?: (reason?: string) => void;
+    /** AI agent participant joined the room. */
+    onAgentConnected?: (participant: {
+        identity: string;
+        name: string;
+    }) => void;
+    /** Remote audio track subscribed — audio will play automatically. */
+    onTrackSubscribed?: (track: {
+        kind: string;
+        source: string;
+        /** Attach to a DOM element. Returns the HTMLMediaElement created. */
+        attach: () => HTMLMediaElement;
+    }) => void;
+    /** Remote audio track unsubscribed. */
+    onTrackUnsubscribed?: (track: {
+        kind: string;
+        source: string;
+    }) => void;
+    /** Connection temporarily lost — attempting to reconnect. */
+    onReconnecting?: () => void;
+    /** Successfully reconnected after a temporary disconnect. */
+    onReconnected?: () => void;
+    /** An error occurred. */
+    onError?: (error: Error) => void;
+}
+export interface VoiceConnection {
+    /** Disconnect from the room and end the call. */
+    disconnect(): Promise<void>;
+    /** Mute the local microphone. */
+    mute(): Promise<void>;
+    /** Unmute the local microphone. */
+    unmute(): Promise<void>;
+    /** Whether the local microphone is currently muted. */
+    isMuted(): boolean;
+    /** The underlying LiveKit Room instance for advanced use cases. */
+    readonly room: Room;
+}
+export interface VoiceClientConfig {
+    /** LiveKit WebSocket URL from `client.voice.createToken()`. */
+    url: string;
+    /** LiveKit access token from `client.voice.createToken()`. */
+    token: string;
+}
+export declare class HappyRobotVoiceClient {
+    private readonly url;
+    private readonly token;
+    constructor(config: VoiceClientConfig);
+    /**
+     * Connect to the voice call room and enable the microphone.
+     *
+     * Returns a `VoiceConnection` with `mute()`, `unmute()`, and `disconnect()` methods.
+     * Pass event handlers to react to room lifecycle events and remote tracks.
+     */
+    connect(handlers?: VoiceConnectionHandlers): Promise<VoiceConnection>;
+}

package/voice-client.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * HappyRobotVoiceClient — browser-side client for voice calls with AI agents.
+ *
+ * Wraps `livekit-client` Room with HappyRobot defaults for audio-only calls.
+ * Requires `livekit-client` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * import { HappyRobotVoiceClient } from "@happyrobot-ai/sdk/voice";
+ *
+ * // Token comes from your server via client.voice.createToken()
+ * const voice = new HappyRobotVoiceClient({ url, token });
+ *
+ * const connection = await voice.connect({
+ *   onConnected: () => console.log("Connected!"),
+ *   onAgentConnected: (p) => console.log("Agent joined:", p.identity),
+ *   onDisconnected: (reason) => console.log("Disconnected:", reason),
+ * });
+ *
+ * // Mute/unmute
+ * await connection.mute();
+ * await connection.unmute();
+ *
+ * // End the call
+ * await connection.disconnect();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HappyRobotVoiceClient = void 0;
+const livekit_client_1 = require("livekit-client");
+class HappyRobotVoiceClient {
+    url;
+    token;
+    constructor(config) {
+        if (!config.url)
+            throw new Error("url is required");
+        if (!config.token)
+            throw new Error("token is required");
+        this.url = config.url;
+        this.token = config.token;
+    }
+    /**
+     * Connect to the voice call room and enable the microphone.
+     *
+     * Returns a `VoiceConnection` with `mute()`, `unmute()`, and `disconnect()` methods.
+     * Pass event handlers to react to room lifecycle events and remote tracks.
+     */
+    async connect(handlers = {}) {
+        // Create Room with HappyRobot defaults (matching platform use-webcall.tsx)
+        const room = new livekit_client_1.Room({
+            adaptiveStream: true,
+            dynacast: true,
+            audioCaptureDefaults: {
+                echoCancellation: true,
+                noiseSuppression: false,
+            },
+            publishDefaults: {
+                dtx: false,
+            },
+        });
+        // Track mute state locally
+        let muted = false;
+        // ── Event listeners ──
+        room.on(livekit_client_1.RoomEvent.Connected, () => {
+            handlers.onConnected?.();
+        });
+        room.on(livekit_client_1.RoomEvent.Disconnected, (reason) => {
+            handlers.onDisconnected?.(reason !== undefined ? livekit_client_1.DisconnectReason[reason] : undefined);
+        });
+        room.on(livekit_client_1.RoomEvent.ParticipantConnected, (participant) => {
+            // Filter for agent participants (non-browser identities)
+            if (participant.identity !== "browser") {
+                handlers.onAgentConnected?.({
+                    identity: participant.identity,
+                    name: participant.name ?? participant.identity,
+                });
+            }
+        });
+        room.on(livekit_client_1.RoomEvent.TrackSubscribed, (track, _publication, _participant) => {
+            // Auto-attach audio tracks so the user hears the agent
+            if (track.kind === livekit_client_1.Track.Kind.Audio) {
+                track.attach();
+            }
+            handlers.onTrackSubscribed?.({
+                kind: track.kind === livekit_client_1.Track.Kind.Audio ? "audio" : "video",
+                source: track.source?.toString() ?? "unknown",
+                attach: () => track.attach(),
+            });
+        });
+        room.on(livekit_client_1.RoomEvent.TrackUnsubscribed, (track, _publication, _participant) => {
+            track.detach();
+            handlers.onTrackUnsubscribed?.({
+                kind: track.kind === livekit_client_1.Track.Kind.Audio ? "audio" : "video",
+                source: track.source?.toString() ?? "unknown",
+            });
+        });
+        room.on(livekit_client_1.RoomEvent.LocalTrackUnpublished, (publication) => {
+            publication.track?.detach();
+        });
+        room.on(livekit_client_1.RoomEvent.Reconnecting, () => {
+            handlers.onReconnecting?.();
+        });
+        room.on(livekit_client_1.RoomEvent.Reconnected, () => {
+            handlers.onReconnected?.();
+        });
+        // ── Connect ──
+        try {
+            await room.prepareConnection(this.url, this.token);
+            await room.connect(this.url, this.token);
+            await room.localParticipant.setMicrophoneEnabled(true);
+        }
+        catch (error) {
+            // Clean up on connection failure
+            try {
+                await room.disconnect();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            handlers.onError?.(error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+        // ── Return VoiceConnection ──
+        const connection = {
+            async disconnect() {
+                await room.disconnect();
+            },
+            async mute() {
+                await room.localParticipant.setMicrophoneEnabled(false);
+                muted = true;
+            },
+            async unmute() {
+                await room.localParticipant.setMicrophoneEnabled(true);
+                muted = false;
+            },
+            isMuted() {
+                return muted;
+            },
+            get room() {
+                return room;
+            },
+        };
+        return connection;
+    }
+}
+exports.HappyRobotVoiceClient = HappyRobotVoiceClient;
+//# sourceMappingURL=voice-client.js.map

package/voice-client.mjs

@@ -0,0 +1,3 @@
+import * as _cjs from "./voice-client.js";
+const { HappyRobotVoiceClient } = _cjs;
+export { HappyRobotVoiceClient };