@happyrobot-ai/sdk 0.1.0

package/resources/sessions.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Session resource — client.sessions.*
+ *
+ * Maps to:
+ *   GET /sessions/:session_id
+ *   GET /sessions/:session_id/messages
+ *   GET /sessions/:session_id/stream
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionsResource = void 0;
+const sse_1 = require("../core/sse");
+class SessionsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get a session by ID. */
+    async get(sessionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/sessions/${enc(sessionId)}`,
+        });
+    }
+    /** Get messages for a session. */
+    async getMessages(sessionId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/sessions/${enc(sessionId)}/messages`,
+            query: query,
+        });
+    }
+    /**
+     * Open an SSE stream for a session's messages.
+     *
+     * Returns an async iterable of typed SSE events (`connected`, `message`,
+     * `backfill_complete`, `session_ended`, `error`).
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.sessions.stream(sessionId, { backfillLimit: 50 })) {
+     *   if (event.event === "message") {
+     *     console.log(event.data.role, event.data.content);
+     *   }
+     *   if (event.event === "session_ended") break;
+     * }
+     * ```
+     */
+    async stream(sessionId, query) {
+        const response = await this.http.requestRaw({
+            method: "GET",
+            path: `/sessions/${enc(sessionId)}/stream`,
+            query: query,
+        });
+        return (0, sse_1.iterateSSE)(response);
+    }
+}
+exports.SessionsResource = SessionsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=sessions.js.map

package/resources/sessions.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./sessions.js";
+export * from "./sessions.js";

package/resources/sip-trunks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SIP trunks resource — client.sipTrunks.*
+ *
+ * Maps to:
+ *   GET    /sip-trunks
+ *   GET    /sip-trunks/options
+ *   POST   /sip-trunks
+ *   POST   /sip-trunks/bulk
+ *   GET    /sip-trunks/:id
+ *   PUT    /sip-trunks/:id
+ *   DELETE /sip-trunks/:id
+ */
+import type { HttpClient } from "../core/http";
+import type { SipTrunkResponse, ListSipTrunksResponse, CreateSipTrunkBody, CreateSipTrunkBulkBody, UpdateSipTrunkBody, SipTrunkOptionsResponse } from "../types/sip-trunks.types";
+export declare class SipTrunksResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List all SIP trunks. */
+    list(): Promise<ListSipTrunksResponse>;
+    /** Get SIP trunk options (lightweight list). */
+    listOptions(): Promise<SipTrunkOptionsResponse>;
+    /** Create a SIP trunk. */
+    create(body: CreateSipTrunkBody): Promise<SipTrunkResponse>;
+    /** Create multiple SIP trunks in bulk. */
+    createBulk(body: CreateSipTrunkBulkBody): Promise<SipTrunkResponse[]>;
+    /** Get a SIP trunk by ID. */
+    get(trunkId: string): Promise<SipTrunkResponse>;
+    /** Update a SIP trunk. */
+    update(trunkId: string, body: UpdateSipTrunkBody): Promise<SipTrunkResponse>;
+    /** Delete a SIP trunk. */
+    delete(trunkId: string): Promise<void>;
+}

package/resources/sip-trunks.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * SIP trunks resource — client.sipTrunks.*
+ *
+ * Maps to:
+ *   GET    /sip-trunks
+ *   GET    /sip-trunks/options
+ *   POST   /sip-trunks
+ *   POST   /sip-trunks/bulk
+ *   GET    /sip-trunks/:id
+ *   PUT    /sip-trunks/:id
+ *   DELETE /sip-trunks/:id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SipTrunksResource = void 0;
+class SipTrunksResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all SIP trunks. */
+    async list() {
+        return this.http.request({
+            method: "GET",
+            path: "/sip-trunks",
+        });
+    }
+    /** Get SIP trunk options (lightweight list). */
+    async listOptions() {
+        return this.http.request({
+            method: "GET",
+            path: "/sip-trunks/options",
+        });
+    }
+    /** Create a SIP trunk. */
+    async create(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/sip-trunks",
+            body,
+        });
+    }
+    /** Create multiple SIP trunks in bulk. */
+    async createBulk(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/sip-trunks/bulk",
+            body,
+        });
+    }
+    /** Get a SIP trunk by ID. */
+    async get(trunkId) {
+        return this.http.request({
+            method: "GET",
+            path: `/sip-trunks/${enc(trunkId)}`,
+        });
+    }
+    /** Update a SIP trunk. */
+    async update(trunkId, body) {
+        return this.http.request({
+            method: "PUT",
+            path: `/sip-trunks/${enc(trunkId)}`,
+            body,
+        });
+    }
+    /** Delete a SIP trunk. */
+    async delete(trunkId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/sip-trunks/${enc(trunkId)}`,
+        });
+    }
+}
+exports.SipTrunksResource = SipTrunksResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=sip-trunks.js.map

package/resources/sip-trunks.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./sip-trunks.js";
+export * from "./sip-trunks.js";

package/resources/usage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Usage resource — client.usage.*
+ *
+ * Maps to:
+ *   GET /usage/call-minutes
+ *   GET /usage/llm-tokens
+ *   GET /usage/text-count
+ *   GET /usage/ocr-count
+ *   GET /usage/rpa-minutes
+ */
+import type { HttpClient } from "../core/http";
+import type { UsageQuery, DetailedUsageResponse } from "../types/usage.types";
+export declare class UsageResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get call minutes usage. */
+    callMinutes(query: UsageQuery): Promise<DetailedUsageResponse>;
+    /** Get LLM token usage. */
+    llmTokens(query: UsageQuery): Promise<DetailedUsageResponse>;
+    /** Get text message count usage. */
+    textCount(query: UsageQuery): Promise<DetailedUsageResponse>;
+    /** Get OCR count usage. */
+    ocrCount(query: UsageQuery): Promise<DetailedUsageResponse>;
+    /** Get RPA minutes usage. */
+    rpaMinutes(query: UsageQuery): Promise<DetailedUsageResponse>;
+    private toQuery;
+}

package/resources/usage.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Usage resource — client.usage.*
+ *
+ * Maps to:
+ *   GET /usage/call-minutes
+ *   GET /usage/llm-tokens
+ *   GET /usage/text-count
+ *   GET /usage/ocr-count
+ *   GET /usage/rpa-minutes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = void 0;
+class UsageResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get call minutes usage. */
+    async callMinutes(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/usage/call-minutes",
+            query: this.toQuery(query),
+        });
+    }
+    /** Get LLM token usage. */
+    async llmTokens(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/usage/llm-tokens",
+            query: this.toQuery(query),
+        });
+    }
+    /** Get text message count usage. */
+    async textCount(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/usage/text-count",
+            query: this.toQuery(query),
+        });
+    }
+    /** Get OCR count usage. */
+    async ocrCount(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/usage/ocr-count",
+            query: this.toQuery(query),
+        });
+    }
+    /** Get RPA minutes usage. */
+    async rpaMinutes(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/usage/rpa-minutes",
+            query: this.toQuery(query),
+        });
+    }
+    toQuery(query) {
+        const { workflow_id, start_date, end_date } = query;
+        const ids = Array.isArray(workflow_id) ? workflow_id : [workflow_id];
+        return {
+            workflow_id: ids.join(","),
+            start_date,
+            end_date,
+        };
+    }
+}
+exports.UsageResource = UsageResource;
+//# sourceMappingURL=usage.js.map

package/resources/usage.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./usage.js";
+export * from "./usage.js";

package/resources/variables.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Variables resource — client.variables.*
+ *
+ * Maps to:
+ *   GET    /workflows/:workflow_id/variables
+ *   POST   /workflows/:workflow_id/variables
+ *   PATCH  /workflows/:workflow_id/variables/:variable_id
+ *   DELETE /workflows/:workflow_id/variables/:variable_id
+ */
+import type { HttpClient } from "../core/http";
+import type { ListVariablesQuery, PaginatedVariablesResponse, CreateVariableBody, UpdateVariableBody, VariableResponse } from "../types/variables.types";
+export declare class VariablesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List variables for a workflow. */
+    list(workflowId: string, query?: ListVariablesQuery): Promise<PaginatedVariablesResponse>;
+    /** Create a variable for a workflow. */
+    create(workflowId: string, body: CreateVariableBody): Promise<VariableResponse>;
+    /** Update a variable. */
+    update(workflowId: string, variableId: string, body: UpdateVariableBody): Promise<VariableResponse>;
+    /** Delete a variable. */
+    delete(workflowId: string, variableId: string): Promise<void>;
+}

package/resources/variables.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Variables resource — client.variables.*
+ *
+ * Maps to:
+ *   GET    /workflows/:workflow_id/variables
+ *   POST   /workflows/:workflow_id/variables
+ *   PATCH  /workflows/:workflow_id/variables/:variable_id
+ *   DELETE /workflows/:workflow_id/variables/:variable_id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariablesResource = void 0;
+class VariablesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List variables for a workflow. */
+    async list(workflowId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/workflows/${enc(workflowId)}/variables`,
+            query: query,
+        });
+    }
+    /** Create a variable for a workflow. */
+    async create(workflowId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/workflows/${enc(workflowId)}/variables`,
+            body,
+        });
+    }
+    /** Update a variable. */
+    async update(workflowId, variableId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/workflows/${enc(workflowId)}/variables/${enc(variableId)}`,
+            body,
+        });
+    }
+    /** Delete a variable. */
+    async delete(workflowId, variableId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/workflows/${enc(workflowId)}/variables/${enc(variableId)}`,
+        });
+    }
+}
+exports.VariablesResource = VariablesResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=variables.js.map

package/resources/variables.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./variables.js";
+export * from "./variables.js";

package/resources/versions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Version resource — client.versions.*
+ *
+ * Maps to:
+ *   GET    /versions/:version_id
+ *   PATCH  /versions/:version_id
+ *   POST   /versions/:version_id/fork
+ *   POST   /versions/:version_id/publish
+ *   POST   /versions/:version_id/unpublish
+ *   POST   /versions/:version_id/lock
+ *   POST   /versions/:version_id/unlock
+ *   POST   /versions/:version_id/test-all
+ *   GET    /versions/:version_id/prompt-issues
+ */
+import type { HttpClient } from "../core/http";
+import type { VersionWithNodesSummary, UpdateVersionBody, UpdateVersionResponse, ForkVersionResponse, PublishBody, PublishResponse, VersionStatusResponse, PromptIssuesResponse } from "../types/versions.types";
+export declare class VersionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get a version by ID or slug (includes node summary and changelog). */
+    get(versionId: string): Promise<VersionWithNodesSummary>;
+    /** Update a version's name or description. */
+    update(versionId: string, body: UpdateVersionBody): Promise<UpdateVersionResponse>;
+    /** Fork (clone) a version. */
+    fork(versionId: string): Promise<ForkVersionResponse>;
+    /** Publish a version. */
+    publish(versionId: string, body?: PublishBody): Promise<PublishResponse>;
+    /** Unpublish a version. */
+    unpublish(versionId: string): Promise<VersionStatusResponse>;
+    /** Lock a version (prevent edits). */
+    lock(versionId: string): Promise<VersionStatusResponse>;
+    /** Unlock a version. */
+    unlock(versionId: string): Promise<VersionStatusResponse>;
+    /** Run test-all validation on a version. */
+    testAll(versionId: string): Promise<unknown>;
+    /** Get prompt quality issues for all prompt nodes in a version. */
+    getPromptIssues(versionId: string): Promise<PromptIssuesResponse>;
+}

package/resources/versions.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Version resource — client.versions.*
+ *
+ * Maps to:
+ *   GET    /versions/:version_id
+ *   PATCH  /versions/:version_id
+ *   POST   /versions/:version_id/fork
+ *   POST   /versions/:version_id/publish
+ *   POST   /versions/:version_id/unpublish
+ *   POST   /versions/:version_id/lock
+ *   POST   /versions/:version_id/unlock
+ *   POST   /versions/:version_id/test-all
+ *   GET    /versions/:version_id/prompt-issues
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionsResource = void 0;
+class VersionsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get a version by ID or slug (includes node summary and changelog). */
+    async get(versionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${encodeURIComponent(versionId)}`,
+        });
+    }
+    /** Update a version's name or description. */
+    async update(versionId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/versions/${encodeURIComponent(versionId)}`,
+            body,
+        });
+    }
+    /** Fork (clone) a version. */
+    async fork(versionId) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/fork`,
+        });
+    }
+    /** Publish a version. */
+    async publish(versionId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/publish`,
+            body: body ?? {},
+        });
+    }
+    /** Unpublish a version. */
+    async unpublish(versionId) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/unpublish`,
+        });
+    }
+    /** Lock a version (prevent edits). */
+    async lock(versionId) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/lock`,
+        });
+    }
+    /** Unlock a version. */
+    async unlock(versionId) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/unlock`,
+        });
+    }
+    /** Run test-all validation on a version. */
+    async testAll(versionId) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${encodeURIComponent(versionId)}/test-all`,
+        });
+    }
+    /** Get prompt quality issues for all prompt nodes in a version. */
+    async getPromptIssues(versionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${encodeURIComponent(versionId)}/prompt-issues`,
+        });
+    }
+}
+exports.VersionsResource = VersionsResource;
+//# sourceMappingURL=versions.js.map

package/resources/versions.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./versions.js";
+export * from "./versions.js";

package/resources/workflow-folders.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Workflow folders resource — client.workflowFolders.*
+ *
+ * Maps to:
+ *   GET    /workflow-folders
+ *   POST   /workflow-folders
+ *   GET    /workflow-folders/:folder_id
+ *   PUT    /workflow-folders/:folder_id
+ *   DELETE /workflow-folders/:folder_id
+ */
+import type { HttpClient } from "../core/http";
+import type { ListFoldersQuery, PaginatedFoldersResponse, CreateFolderBody, WorkflowFolder } from "../types/workflow-folders.types";
+export declare class WorkflowFoldersResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List workflow folders (paginated). */
+    list(query?: ListFoldersQuery): Promise<PaginatedFoldersResponse>;
+    /** Create a workflow folder. */
+    create(body: CreateFolderBody): Promise<WorkflowFolder>;
+    /** Get a folder by ID. */
+    get(folderId: string): Promise<WorkflowFolder>;
+    /** Update a folder. */
+    update(folderId: string, body: Partial<CreateFolderBody>): Promise<WorkflowFolder>;
+    /** Delete a folder. */
+    delete(folderId: string): Promise<void>;
+}

package/resources/workflow-folders.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Workflow folders resource — client.workflowFolders.*
+ *
+ * Maps to:
+ *   GET    /workflow-folders
+ *   POST   /workflow-folders
+ *   GET    /workflow-folders/:folder_id
+ *   PUT    /workflow-folders/:folder_id
+ *   DELETE /workflow-folders/:folder_id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowFoldersResource = void 0;
+class WorkflowFoldersResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List workflow folders (paginated). */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/workflow-folders",
+            query: query,
+        });
+    }
+    /** Create a workflow folder. */
+    async create(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/workflow-folders",
+            body,
+        });
+    }
+    /** Get a folder by ID. */
+    async get(folderId) {
+        return this.http.request({
+            method: "GET",
+            path: `/workflow-folders/${enc(folderId)}`,
+        });
+    }
+    /** Update a folder. */
+    async update(folderId, body) {
+        return this.http.request({
+            method: "PUT",
+            path: `/workflow-folders/${enc(folderId)}`,
+            body,
+        });
+    }
+    /** Delete a folder. */
+    async delete(folderId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/workflow-folders/${enc(folderId)}`,
+        });
+    }
+}
+exports.WorkflowFoldersResource = WorkflowFoldersResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=workflow-folders.js.map

package/resources/workflow-folders.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./workflow-folders.js";
+export * from "./workflow-folders.js";

package/resources/workflows.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Workflow resource — client.workflows.*
+ *
+ * Maps to:
+ *   GET    /workflows
+ *   POST   /workflows
+ *   GET    /workflows/templates
+ *   GET    /workflows/:workflow_id
+ *   PATCH  /workflows/:workflow_id
+ *   DELETE /workflows/:workflow_id
+ *   POST   /workflows/:workflow_id/duplicate
+ *   POST   /workflows/:workflow_id/publish
+ *   POST   /workflows/:workflow_id/unpublish
+ *   POST   /workflows/:workflow_id/cancel-runs
+ *   GET    /workflows/:workflow_id/versions
+ *   GET    /workflows/:workflow_id/runs
+ *   POST   /workflows/:workflow_id/runs
+ */
+import type { HttpClient } from "../core/http";
+import type { ListWorkflowsQuery, WorkflowListItem, PaginatedWorkflowsResponse, CreateWorkflowBody, CreateWorkflowResponse, WorkflowDetailResponse, UpdateWorkflowBody, UpdateWorkflowResponse, DuplicateWorkflowBody, DuplicateWorkflowResponse, ListTemplatesQuery, PaginatedTemplatesResponse, WorkflowPublishResponse, WorkflowUnpublishResponse, CancelRunsResponse, ListWorkflowVersionsQuery, PaginatedWorkflowVersionsResponse } from "../types/workflows.types";
+import type { WorkflowRunsQuery, PaginatedWorkflowRunsResponse, TriggerRunBody, TriggerRunResponse } from "../types/runs.types";
+export declare class WorkflowsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List workflows (paginated). */
+    list(query?: ListWorkflowsQuery): Promise<PaginatedWorkflowsResponse>;
+    /** Iterate over all workflows across pages. */
+    listAll(query?: Omit<ListWorkflowsQuery, "page">): AsyncGenerator<WorkflowListItem>;
+    /** Create a new workflow. */
+    create(body: CreateWorkflowBody): Promise<CreateWorkflowResponse>;
+    /** Get a workflow by ID or slug. */
+    get(workflowId: string): Promise<WorkflowDetailResponse>;
+    /** Update a workflow. */
+    update(workflowId: string, body: UpdateWorkflowBody): Promise<UpdateWorkflowResponse>;
+    /** Delete a workflow. */
+    delete(workflowId: string): Promise<void>;
+    /** Duplicate a workflow. */
+    duplicate(workflowId: string, body?: DuplicateWorkflowBody): Promise<DuplicateWorkflowResponse>;
+    /** Publish the latest version of a workflow. */
+    publish(workflowId: string, body?: {
+        environment?: "production" | "staging" | "development";
+    }): Promise<WorkflowPublishResponse>;
+    /** Unpublish a workflow. */
+    unpublish(workflowId: string): Promise<WorkflowUnpublishResponse>;
+    /** Cancel all active runs for a workflow. */
+    cancelRuns(workflowId: string): Promise<CancelRunsResponse>;
+    /** List templates for workflow creation. */
+    listTemplates(query?: ListTemplatesQuery): Promise<PaginatedTemplatesResponse>;
+    /** List versions for a workflow. */
+    listVersions(workflowId: string, query?: ListWorkflowVersionsQuery): Promise<PaginatedWorkflowVersionsResponse>;
+    /** List runs for a workflow. */
+    listRuns(workflowId: string, query?: WorkflowRunsQuery): Promise<PaginatedWorkflowRunsResponse>;
+    /** Trigger a run for a workflow. */
+    triggerRun(workflowId: string, body?: TriggerRunBody): Promise<TriggerRunResponse>;
+}