@happyrobot-ai/sdk 0.1.18 → 0.1.20

package/README.md

@@ -168,8 +168,9 @@ await client.workflows.duplicate("my-workflow", { name: "Copy" });
 await client.workflows.publish("my-workflow");
 await client.workflows.unpublish("my-workflow");
 
-// Cancel all active runs
+// Cancel current and queued runs. By default, this also unpublishes the workflow.
 await client.workflows.cancelRuns("my-workflow");
+await client.workflows.cancelRuns("my-workflow", { unpublish_workflow: false });
 
 // List templates
 const { data } = await client.workflows.listTemplates();
@@ -195,7 +196,7 @@ const { run_id } = await client.workflows.triggerRun("my-workflow", { payload: {
 | `duplicate(workflowId, body?)`     | POST   | `/workflows/:id/duplicate`   | Duplicate a workflow           |
 | `publish(workflowId, body?)`       | POST   | `/workflows/:id/publish`     | Publish the latest version     |
 | `unpublish(workflowId)`            | POST   | `/workflows/:id/unpublish`   | Unpublish a workflow           |
-| `cancelRuns(workflowId)`           | POST   | `/workflows/:id/cancel-runs` | Cancel all active runs         |
+| `cancelRuns(workflowId, body?)`    | POST   | `/workflows/:id/cancel-runs` | Cancel current and queued runs |
 | `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       |

package/core/http.js

@@ -14,6 +14,19 @@ const DEFAULT_BASE_URL = exports.CLUSTER_URLS.us;
 const DEFAULT_TIMEOUT = 30_000;
 const DEFAULT_MAX_RETRIES = 2;
 const INITIAL_BACKOFF_MS = 500;
+function buildRequestBody(config) {
+    if (config.rawBody !== undefined) {
+        // Don't set Content-Type — let the runtime set it (with multipart boundary)
+        return { body: config.rawBody };
+    }
+    if (config.body !== undefined) {
+        return {
+            body: JSON.stringify(config.body),
+            contentType: "application/json",
+        };
+    }
+    return { body: undefined };
+}
 class HttpClient {
     apiKey;
     baseUrl;
@@ -67,8 +80,9 @@ class HttpClient {
             Accept: "application/json",
             ...config.headers,
         };
-        if (config.body !== undefined) {
-            headers["Content-Type"] = "application/json";
+        const { body: requestBody, contentType } = buildRequestBody(config);
+        if (contentType) {
+            headers["Content-Type"] = contentType;
         }
         let lastError;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {
@@ -76,9 +90,7 @@ class HttpClient {
                 const response = await this.fetchWithTimeout(url, {
                     method: config.method,
                     headers,
-                    body: config.body !== undefined
-                        ? JSON.stringify(config.body)
-                        : undefined,
+                    body: requestBody,
                 }, timeout);
                 if (response.ok) {
                     if (response.status === 204) {

package/core/types.d.ts

@@ -22,6 +22,8 @@ export interface RequestConfig {
     query?: Record<string, string | number | boolean | undefined>;
     /** JSON request body. */
     body?: unknown;
+    /** Raw body (e.g. FormData for multipart). Skips JSON serialization and Content-Type. */
+    rawBody?: FormData | Blob | ReadableStream;
     /** Additional headers. */
     headers?: Record<string, string>;
     /** Override timeout for this request. */

package/helpers/trigger-and-wait-for-node-output.d.ts

@@ -3,6 +3,8 @@ import type { RunNodeOutput } from "../types/runs.types";
 export interface TriggerAndWaitForNodeOutputOptions {
     workflowId: string;
     payload?: Record<string, unknown>;
+    /** File to upload (sends as multipart/form-data instead of JSON). */
+    file?: Blob | File;
     environment?: "production" | "staging" | "development";
     nodePersistentId: string;
     timeoutMs?: number;

package/helpers/trigger-and-wait-for-node-output.js

@@ -17,8 +17,9 @@ const NODE_READY_STATUSES = new Set([
     "skipped",
 ]);
 async function triggerAndWaitForNodeOutput(client, options) {
-    const { workflowId, payload, environment = "production", nodePersistentId, timeoutMs = 300_000, pollIntervalMs = 2_000, } = options;
+    const { workflowId, payload, file, environment = "production", nodePersistentId, timeoutMs = 300_000, pollIntervalMs = 2_000, } = options;
     const triggerResponse = await client.workflows.triggerRun(workflowId, {
+        file,
         payload,
         environment,
     });

package/helpers/trigger-and-wait.d.ts

@@ -9,6 +9,8 @@ export interface TriggerAndWaitOptions {
     workflowId: string;
     /** Trigger payload. */
     payload?: Record<string, unknown>;
+    /** File to upload (sends as multipart/form-data instead of JSON). */
+    file?: Blob | File;
     /** Target environment. */
     environment?: "production" | "staging" | "development";
     /** Maximum time to wait in milliseconds. Defaults to 300_000 (5 min). */

package/helpers/trigger-and-wait.js

@@ -25,9 +25,10 @@ const TERMINAL_STATUSES = new Set([
  * ```
  */
 async function triggerAndWait(client, options) {
-    const { workflowId, payload, environment = "production", timeoutMs = 300_000, pollIntervalMs = 2_000, fetchSessions = true, } = options;
+    const { workflowId, payload, file, environment = "production", timeoutMs = 300_000, pollIntervalMs = 2_000, fetchSessions = true, } = options;
     // 1. Trigger the run
     const { run_id } = await client.workflows.triggerRun(workflowId, {
+        file,
         payload,
         environment,
     });

package/package.json

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

package/resources/workflows.d.ts

@@ -17,8 +17,8 @@
  *   POST   /workflows/:workflow_id/runs
  */
 import type { HttpClient } from "../core/http";
-import type { WorkflowRunsQuery, PaginatedWorkflowRunsResponse, TriggerRunBody, TriggerRunResponse } from "../types/runs.types";
-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, 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";
 export declare class WorkflowsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -42,14 +42,15 @@ export declare class WorkflowsResource {
     }): Promise<WorkflowPublishResponse>;
     /** Unpublish a workflow. */
     unpublish(workflowId: string): Promise<WorkflowUnpublishResponse>;
-    /** Cancel all active runs for a workflow. */
-    cancelRuns(workflowId: string): Promise<CancelRunsResponse>;
+    /** Cancel current and queued runs for a workflow. By default, this also unpublishes it. */
+    cancelRuns(workflowId: string, body?: CancelRunsBody): 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>;
+    /** 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

@@ -90,11 +90,12 @@ class WorkflowsResource {
             path: `/workflows/${encodeURIComponent(workflowId)}/unpublish`,
         });
     }
-    /** Cancel all active runs for a workflow. */
-    async cancelRuns(workflowId) {
+    /** Cancel current and queued runs for a workflow. By default, this also unpublishes it. */
+    async cancelRuns(workflowId, body) {
         return this.http.request({
             method: "POST",
             path: `/workflows/${encodeURIComponent(workflowId)}/cancel-runs`,
+            ...(body ? { body } : {}),
         });
     }
     /** List templates for workflow creation. */
@@ -121,14 +122,35 @@ class WorkflowsResource {
             query: query,
         });
     }
-    /** Trigger a run for a workflow. */
+    /** Trigger a run for a workflow (JSON payload or file upload). */
     async triggerRun(workflowId, body) {
+        const path = `/workflows/${encodeURIComponent(workflowId)}/runs`;
+        if (body && "file" in body && body.file) {
+            return this.triggerRunWithFile(path, body);
+        }
         return this.http.request({
             method: "POST",
-            path: `/workflows/${encodeURIComponent(workflowId)}/runs`,
+            path,
             body: body ?? {},
         });
     }
+    async triggerRunWithFile(path, body) {
+        const formData = new FormData();
+        formData.append("file", body.file);
+        if (body.payload) {
+            for (const [key, value] of Object.entries(body.payload)) {
+                if (value !== undefined && value !== null) {
+                    formData.append(key, typeof value === "string" ? value : JSON.stringify(value));
+                }
+            }
+        }
+        return this.http.request({
+            method: "POST",
+            path,
+            rawBody: formData,
+            query: { environment: body.environment ?? "production" },
+        });
+    }
 }
 exports.WorkflowsResource = WorkflowsResource;
 //# sourceMappingURL=workflows.js.map

package/types/runs.types.d.ts

@@ -3,10 +3,11 @@
  */
 import type { z } from "zod";
 import type { RunDetailSchema, MarkRunBodySchema, MarkRunResponseSchema, ListFlagsQuerySchema, PaginatedFlagsResponseSchema, FlagItemSchema, GetRunOutputResponseSchema, ListRunNodesQuerySchema, ListRunNodesResponseSchema, RunNodeOutputSchema } from "../../routes/runs/schemas";
-import type { WorkflowRunsQuerySchema, PaginatedWorkflowRunsResponseSchema, TriggerRunBodySchema, TriggerRunResponseSchema } from "../../routes/workflows/:workflow_id/runs/schemas";
+import type { WorkflowRunsQuerySchema, PaginatedWorkflowRunsResponseSchema, TriggerRunBodySchema, TriggerRunWithFileBodySchema, TriggerRunResponseSchema } from "../../routes/workflows/:workflow_id/runs/schemas";
 export type WorkflowRunsQuery = z.input<typeof WorkflowRunsQuerySchema>;
 export type PaginatedWorkflowRunsResponse = z.infer<typeof PaginatedWorkflowRunsResponseSchema>;
 export type TriggerRunBody = z.input<typeof TriggerRunBodySchema>;
+export type TriggerRunWithFileBody = z.input<typeof TriggerRunWithFileBodySchema>;
 export type TriggerRunResponse = z.infer<typeof TriggerRunResponseSchema>;
 export type RunDetail = z.infer<typeof RunDetailSchema>;
 export type MarkRunBody = z.input<typeof MarkRunBodySchema>;

package/types/workflows.types.d.ts

@@ -3,7 +3,7 @@
  * 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";
+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>;
 export type PaginatedWorkflowsResponse = z.infer<typeof PaginatedWorkflowsResponseSchema>;
@@ -19,6 +19,7 @@ export type PaginatedTemplatesResponse = z.infer<typeof PaginatedTemplatesRespon
 export type WorkflowPublishResponse = z.infer<typeof WorkflowPublishResponseSchema>;
 export type WorkflowPublishErrorResponse = z.infer<typeof WorkflowPublishErrorResponseSchema>;
 export type WorkflowUnpublishResponse = z.infer<typeof WorkflowUnpublishResponseSchema>;
+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>;

package/types/common.types.d.ts

@@ -1,19 +0,0 @@
-/**
- * Common types shared across the SDK.
- * Extracted from Zod schemas using import type only — zero runtime cost.
- */
-import type { z } from "zod";
-import type { PaginationMetadataSchema } from "../../routes/shared/pagination";
-export type PaginationMetadata = z.infer<typeof PaginationMetadataSchema>;
-/** Standard paginated response shape. */
-export interface PaginatedResponse<T> {
-    data: T[];
-    pagination: PaginationMetadata;
-}
-/** Standard error response shape. */
-export interface ErrorResponse {
-    error: string;
-    message: string;
-    statusCode: number;
-    details?: unknown;
-}

package/types/common.types.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Common types shared across the SDK.
- * Extracted from Zod schemas using import type only — zero runtime cost.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=common.types.js.map

package/types/common.types.mjs

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