@renderinc/sdk 0.3.0 → 0.4.0

package/README.md

@@ -30,6 +30,12 @@ Or with pnpm:
 pnpm add @renderinc/sdk
 ```
 
+Or with Bun:
+
+```bash
+bun add @renderinc/sdk
+```
+
 ## Quick Start
 
 ### REST API Client
@@ -47,11 +53,13 @@ const result = await render.workflows.runTask('my-workflow/my-task', [42, 'hello
 console.log('Status:', result.status);
 console.log('Results:', result.results);
 
+// Or start a task and decide when to await the result
+const run = await render.workflows.startTask('my-workflow/my-task', [42, 'hello']);
+console.log('Task run ID:', run.taskRunId);
+const details = await run.get();
+
 // List recent task runs
 const taskRuns = await render.workflows.listTaskRuns({ limit: 10 });
-
-// Get specific task run
-const details = await render.workflows.getTaskRun(result.id);
 ```
 
 Alternatively, you can create a workflows client directly:
@@ -125,9 +133,12 @@ Creates a new Render SDK instance with access to all Render products.
 - `baseUrl?: string` - Base URL (defaults to `https://api.render.com`)
 - `useLocalDev?: boolean` - Use local development mode
 - `localDevUrl?: string` - Local development URL
+- `ownerId?: string` - Default owner ID for object storage (falls back to `RENDER_WORKSPACE_ID` env var)
+- `region?: string` - Default region for object storage (falls back to `RENDER_REGION` env var)
 
 **Properties:**
 - `workflows` - WorkflowsClient instance for managing workflow tasks
+- `experimental` - ExperimentalClient instance for object storage and other experimental APIs
 
 **Example:**
 ```typescript
@@ -175,6 +186,56 @@ const result = await render.workflows.runTask('my-workflow/square', [5]);
 console.log('Results:', result.results);
 ```
 
+#### `render.workflows.startTask(taskIdentifier, inputData, signal?)`
+
+Starts a task run and returns a `TaskRunResult`. Results are not streamed until you call `.get()` on the returned result. Use this when you need the task run ID, want to defer awaiting, or want fire-and-forget.
+
+**Parameters:**
+- `taskIdentifier: string` - Task identifier in format "workflow-slug/task-name"
+- `inputData: any[]` - Input data as array of parameters
+- `signal?: AbortSignal` - Optional abort signal for cancellation
+
+**Returns:** `Promise<TaskRunResult>`
+
+**Example:**
+```typescript
+const render = new Render();
+
+// Start a task and grab its ID
+const run = await render.workflows.startTask('my-workflow/square', [5]);
+console.log('Task run ID:', run.taskRunId);
+
+// Await the result when you're ready
+const result = await run.get();
+console.log('Results:', result.results);
+```
+
+#### `render.workflows.taskRunEvents(taskRunIds, signal?)`
+
+Streams task run events as an async iterable. Yields a `TaskRunDetails` for each terminal event (completed or failed) received on the stream.
+
+**Parameters:**
+- `taskRunIds: string[]` - One or more task run IDs to subscribe to
+- `signal?: AbortSignal` - Optional abort signal for cancellation
+
+**Returns:** `AsyncGenerator<TaskRunDetails>`
+
+**Example:**
+```typescript
+const render = new Render();
+
+const run1 = await render.workflows.startTask('my-workflow/square', [3]);
+const run2 = await render.workflows.startTask('my-workflow/square', [6]);
+
+// The stream stays open until you break or abort.
+const pending = new Set([run1.taskRunId, run2.taskRunId]);
+for await (const event of render.workflows.taskRunEvents([...pending])) {
+  console.log('Event:', event.status, event.id, event.results);
+  pending.delete(event.id);
+  if (pending.size === 0) break;
+}
+```
+
 #### `render.workflows.getTaskRun(taskRunId)`
 
 Gets task run details by ID.
@@ -190,6 +251,22 @@ const render = new Render();
 const details = await render.workflows.getTaskRun('task-run-id');
 ```
 
+#### `render.workflows.cancelTaskRun(taskRunId)`
+
+Cancels a running task.
+
+**Parameters:**
+- `taskRunId: string` - Task run ID to cancel
+
+**Returns:** `Promise<void>`
+
+**Example:**
+```typescript
+const render = new Render();
+const run = await render.workflows.startTask('my-workflow/square', [5]);
+await render.workflows.cancelTaskRun(run.taskRunId);
+```
+
 #### `render.workflows.listTaskRuns(params)`
 
 Lists task runs with optional filters.
@@ -300,20 +377,36 @@ enum TaskRunStatus {
 ```typescript
 interface TaskRun {
   id: string;
+  taskId: string;
   status: TaskRunStatus;
-  created_at: string;
-  updated_at: string;
-  task_identifier: string;
+  startedAt?: string;
+  completedAt?: string;
+  parentTaskRunId: string;
+  rootTaskRunId: string;
+  retries: number;
 }
 ```
 
 #### `TaskRunDetails`
 
 ```typescript
-interface TaskRunDetails extends TaskRun {
-  completed_at?: string;
-  results?: any[];
+interface TaskRunDetails {
+  id: string;
+  taskId: string;
+  status: TaskRunStatus;
+  results?: any;
   error?: string;
+  startedAt?: string;
+  completedAt?: string;
+}
+```
+
+#### `TaskRunResult`
+
+```typescript
+class TaskRunResult {
+  readonly taskRunId: string;
+  get(): Promise<TaskRunDetails>;
 }
 ```
 
@@ -340,6 +433,7 @@ The SDK provides several error classes:
 import { Render } from '@renderinc/sdk';
 import {
   RenderError,
+  TaskRunError,
   ClientError,
   ServerError,
   AbortError,
@@ -350,7 +444,9 @@ const render = new Render();
 try {
   const result = await render.workflows.runTask('my-workflow/task', [42]);
 } catch (error) {
-  if (error instanceof ClientError) {
+  if (error instanceof TaskRunError) {
+    console.error('Task failed:', error.taskRunId, error.message);
+  } else if (error instanceof ClientError) {
     console.error('Client error:', error.statusCode, error.cause);
   } else if (error instanceof ServerError) {
     console.error('Server error:', error.statusCode, error.cause);
@@ -365,11 +461,36 @@ try {
 ## Environment Variables
 
 - `RENDER_API_KEY` - Your Render API key (required)
+- `RENDER_WORKSPACE_ID` - Default owner ID for object storage (workspace team ID, e.g. `tea-xxxxx`)
+- `RENDER_REGION` - Default region for object storage (e.g. `oregon`, `frankfurt`)
 - `RENDER_USE_LOCAL_DEV` - Enable local development mode (`true`/`false`)
 - `RENDER_LOCAL_DEV_URL` - Local development URL (default: `http://localhost:8120`)
 - `RENDER_SDK_MODE` - Task execution mode (`run` or `register`)
 - `RENDER_SDK_SOCKET_PATH` - Unix socket path for task communication
 
+### Object Storage
+
+When running on Render, `RENDER_WORKSPACE_ID` and `RENDER_REGION` are set automatically. You can also pass them as constructor options:
+
+```typescript
+import { Render } from '@renderinc/sdk';
+
+const render = new Render();  // Uses env vars for auth + object storage defaults
+
+// Upload (no need to pass ownerId/region when env vars are set)
+await render.experimental.storage.objects.put({
+  key: 'path/to/file.png',
+  data: Buffer.from('binary content'),
+  contentType: 'image/png',
+});
+
+// Download
+const obj = await render.experimental.storage.objects.get({ key: 'path/to/file.png' });
+
+// List
+const response = await render.experimental.storage.objects.list();
+```
+
 ## Examples
 
 ### Example 1: Running a Task
@@ -379,18 +500,14 @@ import { Render } from '@renderinc/sdk';
 
 const render = new Render();
 
-async function runSquareTask() {
-  const result = await render.workflows.runTask('my-workflow/square', [5]);
-  console.log('Square of 5 is:', result.results[0]); // 25
-}
-
-runSquareTask();
+const result = await render.workflows.runTask('my-workflow/square', [5]);
+console.log('Square of 5 is:', result.results[0]); // 25
 ```
 
 ### Example 2: Defining Tasks with Subtasks
 
 ```typescript
-import { task, startTaskServer } from '@renderinc/sdk/workflows';
+import { task } from '@renderinc/sdk/workflows';
 
 const square = task(
   { name: 'square' },
@@ -407,8 +524,6 @@ task(
     return Math.sqrt(aSquared + bSquared);
   }
 );
-
-await startTaskServer();
 ```
 
 ### Example 3: Error Handling in Tasks
@@ -502,8 +617,7 @@ async function workflowExample() {
     console.log(`\nRecent task runs: ${recentRuns.length}`);
 
     for (const run of recentRuns) {
-      const details = await render.workflows.getTaskRun(run.id);
-      console.log(`- ${run.taskId}: ${details.status}`);
+      console.log(`- ${run.id}: ${run.status} (${run.taskId})`);
     }
   } catch (error) {
     console.error('Error:', error);
@@ -544,30 +658,33 @@ npm run format
 ```
 typescript/
 ├── src/
-│   ├── render.ts            # Main Render SDK class
-│   ├── index.ts             # Main exports
-│   └── workflows/           # Workflows functionality
-│       ├── client/          # REST API client
-│       │   ├── client.ts    # WorkflowsClient class
-│       │   ├── workflows.ts # WorkflowsService
-│       │   ├── sse.ts       # SSE client
-│       │   ├── types.ts     # Type definitions
-│       │   ├── errors.ts    # Error classes
-│       │   └── index.ts     # Exports
-│       ├── task/            # Task execution SDK
-│       │   ├── task.ts      # task() function
-│       │   ├── runner.ts    # start() and run()
-│       │   ├── executor.ts  # TaskExecutor
-│       │   ├── registry.ts  # TaskRegistry
-│       │   ├── uds.ts       # Unix socket client
-│       │   ├── types.ts     # Type definitions
-│       │   └── index.ts     # Exports
-│       └── index.ts         # Workflows exports
+│   ├── render.ts              # Main Render SDK class
+│   ├── errors.ts              # Error classes
+│   ├── index.ts               # Main exports
+│   ├── version.ts             # SDK version and user-agent
+│   ├── workflows/             # Workflows functionality
+│   │   ├── task.ts            # task() function
+│   │   ├── runner.ts          # startTaskServer() and run()
+│   │   ├── executor.ts        # TaskExecutor
+│   │   ├── registry.ts        # TaskRegistry
+│   │   ├── uds.ts             # Unix socket client
+│   │   ├── types.ts           # Type definitions
+│   │   ├── client/            # REST API client
+│   │   │   ├── client.ts      # WorkflowsClient class
+│   │   │   ├── create-client.ts # createWorkflowsClient() factory
+│   │   │   ├── task-run-result.ts # TaskRunResult class
+│   │   │   ├── sse.ts         # SSE event types
+│   │   │   ├── types.ts       # Client type definitions
+│   │   │   └── index.ts       # Exports
+│   │   └── index.ts           # Workflows exports
+│   ├── experimental/          # Experimental features
+│   │   └── object/            # Object storage API
+│   └── utils/                 # Shared utilities
 ├── examples/
-│   ├── client/              # Client example
+│   ├── client/                # Client example
 │   │   ├── main.ts
 │   │   └── package.json
-│   └── task/                # Task example
+│   └── task/                  # Task example
 │       ├── main.ts
 │       └── package.json
 ├── package.json

package/dist/experimental/experimental.d.ts

@@ -3,10 +3,10 @@ import type { paths } from "../generated/schema.js";
 import { ObjectClient } from "./object/client.js";
 export declare class StorageClient {
     readonly objects: ObjectClient;
-    constructor(apiClient: Client<paths>);
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
 }
 export declare class ExperimentalClient {
     readonly storage: StorageClient;
-    constructor(apiClient: Client<paths>);
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
 }
 //# sourceMappingURL=experimental.d.ts.map

package/dist/experimental/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/experimental/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBlD,qBAAa,aAAa;IAExB,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;CAGrC;AAuBD,qBAAa,kBAAkB;IAE7B,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;CAGrC"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/experimental/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBlD,qBAAa,aAAa;IAExB,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAGtF;AAuBD,qBAAa,kBAAkB;IAE7B,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAGtF"}

package/dist/experimental/experimental.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExperimentalClient = exports.StorageClient = void 0;
 const client_js_1 = require("./object/client.js");
 class StorageClient {
-    constructor(apiClient) {
-        this.objects = new client_js_1.ObjectClient(apiClient);
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
+        this.objects = new client_js_1.ObjectClient(apiClient, defaultOwnerId, defaultRegion);
     }
 }
 exports.StorageClient = StorageClient;
 class ExperimentalClient {
-    constructor(apiClient) {
-        this.storage = new StorageClient(apiClient);
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
+        this.storage = new StorageClient(apiClient, defaultOwnerId, defaultRegion);
     }
 }
 exports.ExperimentalClient = ExperimentalClient;

package/dist/experimental/object/client.d.ts

@@ -1,13 +1,17 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../../generated/schema.js";
-import type { DeleteObjectInput, GetObjectInput, ListObjectsInput, ListObjectsResponse, ObjectData, ObjectScope, PutObjectInput, PutObjectResult, ScopedDeleteObjectInput, ScopedGetObjectInput, ScopedListObjectsInput, ScopedPutObjectInput } from "./types.js";
+import type { DeleteObjectInput, GetObjectInput, ListObjectsInput, ListObjectsResponse, ObjectData, ObjectScope, OptionalScope, PutObjectInput, PutObjectResult, ScopedDeleteObjectInput, ScopedGetObjectInput, ScopedListObjectsInput, ScopedPutObjectInput } from "./types.js";
 export declare class ObjectClient {
     private readonly apiClient;
-    constructor(apiClient: Client<paths>);
-    put(input: PutObjectInput): Promise<PutObjectResult>;
-    get(input: GetObjectInput): Promise<ObjectData>;
-    delete(input: DeleteObjectInput): Promise<void>;
-    list(input: ListObjectsInput): Promise<ListObjectsResponse>;
+    private readonly defaultOwnerId?;
+    private readonly defaultRegion?;
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
+    private resolveOwnerId;
+    private resolveRegion;
+    put(input: OptionalScope<PutObjectInput>): Promise<PutObjectResult>;
+    get(input: OptionalScope<GetObjectInput>): Promise<ObjectData>;
+    delete(input: OptionalScope<DeleteObjectInput>): Promise<void>;
+    list(input: OptionalScope<ListObjectsInput>): Promise<ListObjectsResponse>;
     scoped(scope: ObjectScope): ScopedObjectClient;
     private resolveSize;
 }

package/dist/experimental/object/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EAEV,WAAW,EACX,cAAc,EACd,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AASpB,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;IAoC/C,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAqFpD,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA+C/C,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C/C,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8CjE,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB;IAU9C,OAAO,CAAC,WAAW;CA0BpB;AAQD,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAG1C,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACP,KAAK,EAAE,WAAW;IAqB/B,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB1D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD,IAAI,CAAC,KAAK,GAAE,sBAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM7E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EAEV,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AASpB,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAkB;gBAG9B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACzC,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM;IAMxB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IA4Cf,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAwFnE,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAkD9D,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD9D,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiDhF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB;IAU9C,OAAO,CAAC,WAAW;CA0BpB;AAQD,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAG1C,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACP,KAAK,EAAE,WAAW;IAqB/B,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB1D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD,IAAI,CAAC,KAAK,GAAE,sBAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM7E"}

package/dist/experimental/object/client.js

@@ -4,16 +4,34 @@ exports.ScopedObjectClient = exports.ObjectClient = void 0;
 const node_stream_1 = require("node:stream");
 const errors_js_1 = require("../../errors.js");
 class ObjectClient {
-    constructor(apiClient) {
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
         this.apiClient = apiClient;
+        this.defaultOwnerId = defaultOwnerId;
+        this.defaultRegion = defaultRegion;
+    }
+    resolveOwnerId(ownerId) {
+        const resolved = ownerId || this.defaultOwnerId;
+        if (!resolved) {
+            throw new errors_js_1.RenderError("ownerId is required. Provide it as a parameter or set the RENDER_WORKSPACE_ID environment variable.");
+        }
+        return resolved;
+    }
+    resolveRegion(region) {
+        const resolved = region || this.defaultRegion;
+        if (!resolved) {
+            throw new errors_js_1.RenderError("region is required. Provide it as a parameter or set the RENDER_REGION environment variable.");
+        }
+        return resolved;
     }
     async put(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
         const size = this.resolveSize(input);
         const { data, error } = await this.apiClient.PUT("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -53,11 +71,13 @@ class ObjectClient {
         };
     }
     async get(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
         const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -78,11 +98,13 @@ class ObjectClient {
         };
     }
     async delete(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
         const { error } = await this.apiClient.DELETE("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -92,11 +114,13 @@ class ObjectClient {
         }
     }
     async list(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
         const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                 },
                 query: {
                     cursor: input.cursor,

package/dist/experimental/object/e2e-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { ObjectClient } from "./client.js";
+export declare function objectStorageCrudCheck(client: ObjectClient, ownerId: `tea-${string}`, region: string): Promise<string>;
+//# sourceMappingURL=e2e-helpers.d.ts.map

package/dist/experimental/object/e2e-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-helpers.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/e2e-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAchD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAsEjB"}

package/dist/experimental/object/e2e-helpers.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectStorageCrudCheck = objectStorageCrudCheck;
+const node_crypto_1 = require("node:crypto");
+const errors_js_1 = require("../../errors.js");
+const RETRY_ATTEMPTS = 5;
+const RETRY_INTERVAL_MS = 1000;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function objectStorageCrudCheck(client, ownerId, region) {
+    const key = `e2e-test/${(0, node_crypto_1.randomUUID)()}/crud-test.txt`;
+    const content = Buffer.from("hello from e2e");
+    try {
+        await client.put({
+            ownerId,
+            region,
+            key,
+            data: content,
+        });
+        let found = false;
+        for (let attempt = 1; attempt <= RETRY_ATTEMPTS; attempt++) {
+            const listResponse = await client.list({ ownerId, region });
+            const match = listResponse.objects.find((o) => o.key === key);
+            if (match) {
+                if (match.size !== content.byteLength) {
+                    throw new Error(`LIST size mismatch: expected ${content.byteLength}, got ${match.size}`);
+                }
+                const age = Date.now() - match.lastModified.getTime();
+                if (age > 5 * 60 * 1000) {
+                    throw new Error(`LIST lastModified too old: ${match.lastModified.toISOString()}`);
+                }
+                found = true;
+                break;
+            }
+            if (attempt < RETRY_ATTEMPTS) {
+                await sleep(RETRY_INTERVAL_MS);
+            }
+        }
+        if (!found) {
+            throw new Error(`Object ${key} not found in LIST after ${RETRY_ATTEMPTS} attempts`);
+        }
+        const obj = await client.get({ ownerId, region, key });
+        if (!obj.data.equals(content)) {
+            throw new Error("GET data does not match uploaded content");
+        }
+        if (obj.size !== content.byteLength) {
+            throw new Error(`GET size mismatch: expected ${content.byteLength}, got ${obj.size}`);
+        }
+        await client.delete({ ownerId, region, key });
+        try {
+            await client.get({ ownerId, region, key });
+            throw new Error("GET after DELETE should have thrown");
+        }
+        catch (err) {
+            if (!(err instanceof errors_js_1.RenderError)) {
+                throw err;
+            }
+        }
+        return key;
+    }
+    catch (err) {
+        try {
+            await client.delete({ ownerId, region, key });
+        }
+        catch {
+        }
+        throw err;
+    }
+}

package/dist/experimental/object/types.d.ts

@@ -38,6 +38,7 @@ export interface ObjectData {
 export interface PutObjectResult {
     etag?: string;
 }
+export type OptionalScope<T> = Omit<T, keyof ObjectScope> & Partial<ObjectScope>;
 export interface ObjectScope {
     ownerId: `tea-${string}`;
     region: Region | string;

package/dist/experimental/object/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAKhF,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,UAAU,kBAAmB,SAAQ,gBAAgB;IAEnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAEnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,QAAQ,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAKzE,MAAM,WAAW,cAAe,SAAQ,gBAAgB;CAAG;AAK3D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;CAAG;AAK9D,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;IAEhB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAKD,MAAM,WAAW,UAAU;IAEzB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,eAAe;IAE9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAKD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,WAAW,CAAC,CAAC;AAKjF,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,WAAW,CAAC,CAAC;AAK/E,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,EAAE,IAAI,CAAC;CACpB;AAKD,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAKhF,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,UAAU,kBAAmB,SAAQ,gBAAgB;IAEnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAEnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,QAAQ,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAKzE,MAAM,WAAW,cAAe,SAAQ,gBAAgB;CAAG;AAK3D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;CAAG;AAK9D,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;IAEhB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAKD,MAAM,WAAW,UAAU;IAEzB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,eAAe;IAE9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAKjF,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAKD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,WAAW,CAAC,CAAC;AAKjF,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,WAAW,CAAC,CAAC;AAK/E,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,EAAE,IAAI,CAAC;CACpB;AAKD,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,cAAc,EAAE,CAAC;IAE1B,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,qBAAa,MAAM;IACjB,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,YAAY,EAAE,kBAAkB,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAM9B,OAAO,CAAC,EAAE,aAAa;CAYpC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,qBAAa,MAAM;IACjB,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,YAAY,EAAE,kBAAkB,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAM9B,OAAO,CAAC,EAAE,aAAa;CAepC"}

package/dist/render.js

@@ -15,7 +15,9 @@ class Render {
         const baseUrl = (0, get_base_url_js_1.getBaseUrl)(options);
         this.apiClient = (0, create_api_client_js_1.createApiClient)(baseUrl, token);
         this.workflows = new index_js_1.WorkflowsClient(this.apiClient, baseUrl, token);
-        this.experimental = new experimental_js_1.ExperimentalClient(this.apiClient);
+        const defaultOwnerId = options?.ownerId || process.env.RENDER_WORKSPACE_ID || undefined;
+        const defaultRegion = options?.region || process.env.RENDER_REGION || undefined;
+        this.experimental = new experimental_js_1.ExperimentalClient(this.apiClient, defaultOwnerId, defaultRegion);
     }
 }
 exports.Render = Render;

package/dist/workflows/client/client.d.ts

@@ -1,14 +1,18 @@
 import type { Client as ApiClient } from "openapi-fetch";
 import type { paths } from "../../generated/schema.js";
+import { TaskRunResult } from "./task-run-result.js";
 import type { ListTaskRunsParams, TaskData, TaskIdentifier, TaskRun, TaskRunDetails } from "./types.js";
 export declare class WorkflowsClient {
-    private readonly sse;
     private readonly apiClient;
+    private readonly baseUrl;
+    private readonly token;
     constructor(apiClient: ApiClient<paths>, baseUrl: string, token: string);
+    taskRunEvents(taskRunIds: string[], signal?: AbortSignal): AsyncGenerator<TaskRunDetails>;
+    startTask(taskIdentifier: TaskIdentifier, inputData: TaskData, signal?: AbortSignal): Promise<TaskRunResult>;
     runTask(taskIdentifier: TaskIdentifier, inputData: TaskData, signal?: AbortSignal): Promise<TaskRunDetails>;
-    private waitForTask;
     getTaskRun(taskRunId: string): Promise<TaskRunDetails>;
-    private cancelTaskRun;
+    cancelTaskRun(taskRunId: string): Promise<void>;
     listTaskRuns(params: ListTaskRunsParams): Promise<TaskRun[]>;
+    private waitOnTaskRun;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/workflows/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,OAAO,EACP,cAAc,EACf,MAAM,YAAY,CAAC;AAoBpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAOjC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAKjE,OAAO,CACX,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,QAAQ,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;YA4CZ,WAAW;IAUnB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAe9C,aAAa;IAerB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CASnE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,OAAO,EACP,cAAc,EACf,MAAM,YAAY,CAAC;AAoBpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAOnB,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAchE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC;IA0G1F,SAAS,CACb,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,QAAQ,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC;IA+BnB,OAAO,CACX,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,QAAQ,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC;IAWpB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IActD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAcpD,aAAa;CAM5B"}

package/dist/workflows/client/client.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowsClient = void 0;
+const eventsource_1 = require("eventsource");
 const errors_js_1 = require("../../errors.js");
+const version_js_1 = require("../../version.js");
 const sse_js_1 = require("./sse.js");
+const task_run_result_js_1 = require("./task-run-result.js");
 function handleApiError(error, response, context) {
     const statusCode = response.status;
     const errorMessage = `${context}: ${error}`;
@@ -16,22 +19,97 @@ function handleApiError(error, response, context) {
 }
 class WorkflowsClient {
     constructor(apiClient, baseUrl, token) {
-        this.sse = new sse_js_1.SSEClient(baseUrl, token);
         this.apiClient = apiClient;
+        this.baseUrl = baseUrl;
+        this.token = token;
     }
-    async runTask(taskIdentifier, inputData, signal) {
+    async *taskRunEvents(taskRunIds, signal) {
         if (signal?.aborted) {
             throw new errors_js_1.AbortError();
         }
-        let taskRunId = null;
-        const abortHandler = async () => {
-            if (taskRunId) {
-                await this.cancelTaskRun(taskRunId);
-                throw new errors_js_1.AbortError();
+        const queue = [];
+        let resolve = null;
+        let finished = false;
+        let streamError = null;
+        const push = (item) => {
+            queue.push(item);
+            if (resolve) {
+                resolve();
+                resolve = null;
+            }
+        };
+        const fail = (err) => {
+            streamError = err;
+            finished = true;
+            if (resolve) {
+                resolve();
+                resolve = null;
             }
         };
+        const url = new URL("/v1/task-runs/events", this.baseUrl);
+        url.searchParams.append("taskRunIds", taskRunIds.join(","));
+        const eventSource = new eventsource_1.EventSource(url.toString(), {
+            fetch: (input, init) => fetch(input, {
+                ...init,
+                headers: {
+                    ...init?.headers,
+                    Authorization: `Bearer ${this.token}`,
+                    "User-Agent": (0, version_js_1.getUserAgent)(),
+                },
+            }),
+        });
+        const eventHandler = (event) => {
+            try {
+                const details = JSON.parse(event.data);
+                push(details);
+            }
+            catch (e) {
+                fail(new Error(`Failed to parse task run details: ${e}`));
+            }
+        };
+        const errorHandler = (error) => {
+            fail(new Error(`SSE connection error: ${error.message || "Unknown error"}`));
+        };
+        const abortHandler = () => {
+            cleanup();
+            fail(new errors_js_1.AbortError());
+        };
+        const cleanup = () => {
+            eventSource.removeEventListener(sse_js_1.TaskEventType.COMPLETED, eventHandler);
+            eventSource.removeEventListener(sse_js_1.TaskEventType.FAILED, eventHandler);
+            eventSource.removeEventListener("error", errorHandler);
+            eventSource.close();
+            signal?.removeEventListener("abort", abortHandler);
+        };
+        eventSource.addEventListener(sse_js_1.TaskEventType.COMPLETED, eventHandler);
+        eventSource.addEventListener(sse_js_1.TaskEventType.FAILED, eventHandler);
+        eventSource.addEventListener("error", errorHandler);
+        signal?.addEventListener("abort", abortHandler);
+        try {
+            while (true) {
+                while (queue.length > 0) {
+                    yield queue.shift();
+                }
+                if (finished) {
+                    break;
+                }
+                await new Promise((r) => {
+                    resolve = r;
+                });
+            }
+            if (streamError) {
+                throw streamError;
+            }
+        }
+        finally {
+            cleanup();
+        }
+    }
+    async startTask(taskIdentifier, inputData, signal) {
+        if (signal?.aborted) {
+            throw new errors_js_1.AbortError();
+        }
         try {
-            signal?.addEventListener("abort", abortHandler);
             const { data, error, response } = await this.apiClient.POST("/task-runs", {
                 body: {
                     task: taskIdentifier,
@@ -42,8 +120,7 @@ class WorkflowsClient {
             if (error) {
                 handleApiError(error, response, "Failed to run task");
             }
-            taskRunId = data.id;
-            return await this.waitForTask(data.id, signal);
+            return new task_run_result_js_1.TaskRunResult((id, sig) => this.waitOnTaskRun(id, sig), data.id, signal);
         }
         catch (err) {
             if (err instanceof DOMException && err.name === "AbortError") {
@@ -51,12 +128,10 @@ class WorkflowsClient {
             }
             throw err;
         }
-        finally {
-            signal?.removeEventListener("abort", abortHandler);
-        }
     }
-    async waitForTask(taskRunId, signal) {
-        return this.sse.waitOnTaskRun(taskRunId, signal);
+    async runTask(taskIdentifier, inputData, signal) {
+        const result = await this.startTask(taskIdentifier, inputData, signal);
+        return result.get();
     }
     async getTaskRun(taskRunId) {
         const { data, error, response } = await this.apiClient.GET("/task-runs/{taskRunId}", {
@@ -84,5 +159,11 @@ class WorkflowsClient {
         }
         return data;
     }
+    async waitOnTaskRun(taskRunId, signal) {
+        for await (const event of this.taskRunEvents([taskRunId], signal)) {
+            return event;
+        }
+        throw new Error(`SSE stream ended without receiving an event for task run ${taskRunId}`);
+    }
 }
 exports.WorkflowsClient = WorkflowsClient;

package/dist/workflows/client/index.d.ts

@@ -1,4 +1,6 @@
 export { WorkflowsClient } from "./client.js";
 export { createWorkflowsClient } from "./create-client.js";
+export { TaskEventType } from "./sse.js";
+export { TaskRunResult } from "./task-run-result.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/workflows/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,YAAY,CAAC"}

package/dist/workflows/client/index.js

@@ -14,9 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWorkflowsClient = exports.WorkflowsClient = void 0;
+exports.TaskRunResult = exports.TaskEventType = exports.createWorkflowsClient = exports.WorkflowsClient = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "WorkflowsClient", { enumerable: true, get: function () { return client_js_1.WorkflowsClient; } });
 var create_client_js_1 = require("./create-client.js");
 Object.defineProperty(exports, "createWorkflowsClient", { enumerable: true, get: function () { return create_client_js_1.createWorkflowsClient; } });
+var sse_js_1 = require("./sse.js");
+Object.defineProperty(exports, "TaskEventType", { enumerable: true, get: function () { return sse_js_1.TaskEventType; } });
+var task_run_result_js_1 = require("./task-run-result.js");
+Object.defineProperty(exports, "TaskRunResult", { enumerable: true, get: function () { return task_run_result_js_1.TaskRunResult; } });
 __exportStar(require("./types.js"), exports);

package/dist/workflows/client/sse.d.ts

@@ -1,14 +1,7 @@
-import type { TaskRunDetails } from "./types.js";
 export declare enum TaskEventType {
     COMPLETED = "task.completed",
     FAILED = "task.failed",
     RUNNING = "task.running",
     PENDING = "task.pending"
 }
-export declare class SSEClient {
-    private readonly baseUrl;
-    private readonly token;
-    constructor(baseUrl: string, token: string);
-    waitOnTaskRun(taskRunId: string, signal?: AbortSignal): Promise<TaskRunDetails>;
-}
 //# sourceMappingURL=sse.d.ts.map

package/dist/workflows/client/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/sse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,oBAAY,aAAa;IACvB,SAAS,mBAAmB;IAC5B,MAAM,gBAAgB;IACtB,OAAO,iBAAiB;IACxB,OAAO,iBAAiB;CACzB;AAKD,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM;IAG1B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAsEtF"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/sse.ts"],"names":[],"mappings":"AAGA,oBAAY,aAAa;IACvB,SAAS,mBAAmB;IAC5B,MAAM,gBAAgB;IACtB,OAAO,iBAAiB;IACxB,OAAO,iBAAiB;CACzB"}

package/dist/workflows/client/sse.js

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SSEClient = exports.TaskEventType = void 0;
-const eventsource_1 = require("eventsource");
-const errors_js_1 = require("../../errors.js");
-const version_js_1 = require("../../version.js");
+exports.TaskEventType = void 0;
 var TaskEventType;
 (function (TaskEventType) {
     TaskEventType["COMPLETED"] = "task.completed";
@@ -11,70 +8,3 @@ var TaskEventType;
     TaskEventType["RUNNING"] = "task.running";
     TaskEventType["PENDING"] = "task.pending";
 })(TaskEventType || (exports.TaskEventType = TaskEventType = {}));
-class SSEClient {
-    constructor(baseUrl, token) {
-        this.baseUrl = baseUrl;
-        this.token = token;
-    }
-    async waitOnTaskRun(taskRunId, signal) {
-        return new Promise((resolve, reject) => {
-            let eventSource = null;
-            const abortHandler = () => {
-                cleanup();
-                reject(new errors_js_1.AbortError());
-            };
-            const cleanup = () => {
-                if (eventSource) {
-                    eventSource.removeEventListener(TaskEventType.COMPLETED, eventHandler);
-                    eventSource.removeEventListener(TaskEventType.FAILED, eventHandler);
-                    eventSource.removeEventListener("error", errorHandler);
-                    eventSource.close();
-                    eventSource = null;
-                }
-                signal?.removeEventListener("abort", abortHandler);
-            };
-            const eventHandler = (event) => {
-                try {
-                    const details = JSON.parse(event.data);
-                    cleanup();
-                    resolve(details);
-                }
-                catch (e) {
-                    cleanup();
-                    reject(new Error(`Failed to parse task run details: ${e}`));
-                }
-            };
-            const errorHandler = (error) => {
-                cleanup();
-                reject(new Error(`SSE connection error: ${error.message || "Unknown error"}`));
-            };
-            if (signal?.aborted) {
-                reject(new errors_js_1.AbortError());
-                return;
-            }
-            signal?.addEventListener("abort", abortHandler);
-            try {
-                const url = new URL("/v1/task-runs/events", this.baseUrl);
-                url.searchParams.append("taskRunIds", taskRunId);
-                eventSource = new eventsource_1.EventSource(url.toString(), {
-                    fetch: (input, init) => fetch(input, {
-                        ...init,
-                        headers: {
-                            ...init?.headers,
-                            Authorization: `Bearer ${this.token}`,
-                            "User-Agent": (0, version_js_1.getUserAgent)(),
-                        },
-                    }),
-                });
-                eventSource.addEventListener(TaskEventType.COMPLETED, eventHandler);
-                eventSource.addEventListener(TaskEventType.FAILED, eventHandler);
-                eventSource.addEventListener("error", errorHandler);
-            }
-            catch (e) {
-                cleanup();
-                reject(e);
-            }
-        });
-    }
-}
-exports.SSEClient = SSEClient;

package/dist/workflows/client/task-run-promise.d.ts

@@ -0,0 +1,12 @@
+import type { SSEClient } from "./sse.js";
+import type { TaskRunDetails } from "./types.js";
+export declare class TaskRunPromise implements PromiseLike<TaskRunDetails> {
+    private readonly sseClient;
+    private readonly postPromise;
+    private readonly signal?;
+    private resultPromise;
+    constructor(sseClient: SSEClient, postPromise: Promise<string>, signal?: AbortSignal);
+    get taskRunId(): Promise<string>;
+    then<TResult1 = TaskRunDetails, TResult2 = never>(onfulfilled?: ((value: TaskRunDetails) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+//# sourceMappingURL=task-run-promise.d.ts.map

package/dist/workflows/client/task-run-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-run-promise.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/task-run-promise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD,qBAAa,cAAe,YAAW,WAAW,CAAC,cAAc,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAc;IACtC,OAAO,CAAC,aAAa,CAAwC;gBAEjD,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW;IAUpF,IAAI,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAE/B;IAED,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,QAAQ,GAAG,KAAK,EAC9C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAClF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACtE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAShC"}

package/dist/workflows/client/task-run-promise.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskRunPromise = void 0;
+class TaskRunPromise {
+    constructor(sseClient, postPromise, signal) {
+        this.resultPromise = null;
+        this.sseClient = sseClient;
+        this.postPromise = postPromise;
+        this.signal = signal;
+        this.postPromise.catch(() => { });
+    }
+    get taskRunId() {
+        return this.postPromise;
+    }
+    then(onfulfilled, onrejected) {
+        if (!this.resultPromise) {
+            this.resultPromise = this.postPromise.then((taskRunId) => this.sseClient.waitOnTaskRun(taskRunId, this.signal));
+        }
+        return this.resultPromise.then(onfulfilled, onrejected);
+    }
+}
+exports.TaskRunPromise = TaskRunPromise;

package/dist/workflows/client/task-run-result.d.ts

@@ -0,0 +1,10 @@
+import type { TaskRunDetails } from "./types.js";
+export declare class TaskRunResult {
+    readonly taskRunId: string;
+    private readonly waitOnTaskRun;
+    private readonly signal?;
+    private resultPromise;
+    constructor(waitOnTaskRun: (taskRunId: string, signal?: AbortSignal) => Promise<TaskRunDetails>, taskRunId: string, signal?: AbortSignal);
+    get(): Promise<TaskRunDetails>;
+}
+//# sourceMappingURL=task-run-result.d.ts.map

package/dist/workflows/client/task-run-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-run-result.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/task-run-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAGD;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAc;IACtC,OAAO,CAAC,aAAa,CAAwC;gBAG3D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,EACnF,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW;IAOtB,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC;CAM/B"}

package/dist/workflows/client/task-run-result.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskRunResult = void 0;
+class TaskRunResult {
+    constructor(waitOnTaskRun, taskRunId, signal) {
+        this.resultPromise = null;
+        this.waitOnTaskRun = waitOnTaskRun;
+        this.taskRunId = taskRunId;
+        this.signal = signal;
+    }
+    get() {
+        if (!this.resultPromise) {
+            this.resultPromise = this.waitOnTaskRun(this.taskRunId, this.signal);
+        }
+        return this.resultPromise;
+    }
+}
+exports.TaskRunResult = TaskRunResult;

package/dist/workflows/client/types.d.ts

@@ -19,5 +19,7 @@ export interface ClientOptions {
     baseUrl?: string;
     useLocalDev?: boolean;
     localDevUrl?: string;
+    ownerId?: string;
+    region?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/workflows/client/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAKhE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAKpC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAKlC,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAMD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;AAMvD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAKrE,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;AAKnF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflows/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAKhE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAKpC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAKlC,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAMD,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC;AAMvD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAKrE,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;AAKnF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAKD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/workflows/uds.d.ts

@@ -9,5 +9,6 @@ export declare class UDSClient {
     getSubtaskResult(subtaskId: string): Promise<GetSubtaskResultResponse>;
     registerTasks(tasks: TaskMetadata[]): Promise<void>;
     private request;
+    private requestOnce;
 }
 //# sourceMappingURL=uds.d.ts.map

package/dist/workflows/uds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uds.d.ts","sourceRoot":"","sources":["../../src/workflows/uds.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,wBAAwB,EAIxB,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAKzC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI3C,OAAO,CAAC,iBAAiB;IAyBnB,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAUtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,OAAO;CA4CtB"}
+{"version":3,"file":"uds.d.ts","sourceRoot":"","sources":["../../src/workflows/uds.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,wBAAwB,EAIxB,YAAY,EACb,MAAM,YAAY,CAAC;AAapB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAKzC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI3C,OAAO,CAAC,iBAAiB;IAyBnB,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAUtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,OAAO;YAmCP,WAAW;CA2C1B"}

package/dist/workflows/uds.js

@@ -6,6 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UDSClient = void 0;
 const node_http_1 = __importDefault(require("node:http"));
 const version_js_1 = require("../version.js");
+const UDS_MAX_RETRIES = 15;
+const UDS_INITIAL_DELAY_MS = 250;
+const UDS_BACKOFF_FACTOR = 2;
+const UDS_MAX_DELAY_MS = 16000;
+const CLIENT_ERROR_RE = /^HTTP 4\d{2}:/;
+const RETRY_ERROR_RE = /^HTTP 429:/;
 class UDSClient {
     constructor(socketPath) {
         this.socketPath = socketPath;
@@ -61,6 +67,27 @@ class UDSClient {
     }
     async request(path, method, body) {
         const bodyString = body ? JSON.stringify(body) : "";
+        let lastError = new Error("UDS request failed");
+        for (let attempt = 0; attempt < UDS_MAX_RETRIES; attempt++) {
+            try {
+                return await this.requestOnce(path, method, bodyString);
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                if (CLIENT_ERROR_RE.test(lastError.message) && !RETRY_ERROR_RE.test(lastError.message)) {
+                    throw lastError;
+                }
+                if (attempt < UDS_MAX_RETRIES - 1) {
+                    const delay = Math.min(UDS_INITIAL_DELAY_MS * UDS_BACKOFF_FACTOR ** attempt, UDS_MAX_DELAY_MS);
+                    console.warn(`Request to Render failed (attempt ${attempt + 1}/${UDS_MAX_RETRIES}), ` +
+                        `retrying in ${delay}ms: ${lastError.message}`);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError;
+    }
+    async requestOnce(path, method, bodyString) {
         return new Promise((resolve, reject) => {
             const req = node_http_1.default.request({
                 socketPath: this.socketPath,

package/dist/workflows/workflows.d.ts

@@ -0,0 +1,19 @@
+import { TaskRegistry } from "./registry.js";
+import type { RegisterTaskOptions, Retry, TaskFunction } from "./types.js";
+export interface WorkflowsOptions {
+    defaultRetry?: Retry;
+    defaultTimeout?: number;
+    defaultPlan?: string;
+}
+export declare class Workflows {
+    private readonly _registry;
+    private readonly _defaultRetry?;
+    private readonly _defaultTimeout?;
+    private readonly _defaultPlan?;
+    constructor(options?: WorkflowsOptions);
+    get registry(): TaskRegistry;
+    task<TArgs extends any[], TResult>(options: RegisterTaskOptions, func: TaskFunction<TArgs, TResult>): TaskFunction<TArgs, TResult>;
+    start(): Promise<void>;
+    static fromWorkflows(apps: Workflows[], options?: WorkflowsOptions): Workflows;
+}
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/workflows/workflows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,OAAO,CAAC,EAAE,gBAAgB;IAUtC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAQD,IAAI,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC/B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,GACjC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC;IAyBzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS;CAgB/E"}

package/dist/workflows/workflows.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workflows = void 0;
+const errors_js_1 = require("../errors.js");
+const registry_js_1 = require("./registry.js");
+const runner_js_1 = require("./runner.js");
+const task_js_1 = require("./task.js");
+class Workflows {
+    constructor(options) {
+        this._registry = new registry_js_1.TaskRegistry();
+        this._defaultRetry = options?.defaultRetry;
+        this._defaultTimeout = options?.defaultTimeout;
+        this._defaultPlan = options?.defaultPlan;
+    }
+    get registry() {
+        return this._registry;
+    }
+    task(options, func) {
+        const mergedOptions = {
+            ...options,
+            retry: options.retry ?? this._defaultRetry,
+            timeoutSeconds: options.timeoutSeconds ?? this._defaultTimeout,
+            plan: options.plan ?? this._defaultPlan,
+        };
+        this._registry.register(func, mergedOptions);
+        return ((...args) => {
+            const context = (0, task_js_1.getCurrentContext)();
+            if (!context) {
+                return func(...args);
+            }
+            const result = context.executeTask(func, options.name, ...args);
+            return result.get();
+        });
+    }
+    async start() {
+        await (0, runner_js_1.startTaskServer)(this._registry);
+    }
+    static fromWorkflows(apps, options) {
+        const combined = new Workflows(options);
+        for (const app of apps) {
+            for (const task of app._registry.getAllTasks()) {
+                if (combined._registry.has(task.name)) {
+                    throw new errors_js_1.RenderError(`Duplicate task name '${task.name}' when combining workflows`);
+                }
+                combined._registry.registerMetadata(task);
+            }
+        }
+        return combined;
+    }
+}
+exports.Workflows = Workflows;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renderinc/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Render SDK for TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,6 +10,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest",
+    "test:e2e": "vitest run --config vitest.config.e2e.ts",
     "typecheck": "tsc --noEmit",
     "lint": "biome lint",
     "lint:fix": "biome lint --write",