@happyrobot-ai/sdk 0.1.11 → 0.1.13

package/README.md

@@ -44,10 +44,11 @@ const { run_id } = await client.workflows.triggerRun("my-workflow", {
 
 ```ts
 const client = new HappyRobotClient({
-  apiKey: "sk_live_...",   // Required. API key (sk_live_... or sk_test_...)
-  timeout: 30_000,         // Optional. Request timeout in ms. Defaults to 30000
-  maxRetries: 2,           // Optional. Retries on 429/5xx with exponential backoff. Defaults to 2
-  fetch: customFetch,      // Optional. Custom fetch implementation
+  apiKey: "sk_live_...", // Required. API key (sk_live_... or sk_test_...)
+  cluster: "eu", // Optional. "us" (default) or "eu"
+  timeout: 30_000, // Optional. Request timeout in ms. Defaults to 30000
+  maxRetries: 2, // Optional. Retries on 429/5xx with exponential backoff. Defaults to 2
+  fetch: customFetch, // Optional. Custom fetch implementation
 });
 ```
 
@@ -65,9 +66,9 @@ import { triggerAndWait } from "@happyrobot-ai/sdk/helpers";
 const { run, sessions } = await triggerAndWait(client, {
   workflowId: "my-workflow",
   payload: { phone: "+1234567890" },
-  timeoutMs: 300_000,      // Optional. Defaults to 5 minutes
-  pollIntervalMs: 2_000,   // Optional. Defaults to 2 seconds
-  fetchSessions: true,     // Optional. Fetch sessions on completion. Defaults to true
+  timeoutMs: 300_000, // Optional. Defaults to 5 minutes
+  pollIntervalMs: 2_000, // Optional. Defaults to 2 seconds
+  fetchSessions: true, // Optional. Fetch sessions on completion. Defaults to true
   environment: "production", // Optional. Defaults to "production"
 });
 
@@ -83,12 +84,12 @@ import { createVoiceAgent } from "@happyrobot-ai/sdk/helpers";
 
 const { workflow, publishResult } = await createVoiceAgent(client, {
   name: "Sales Agent",
-  template: "voice-agent",   // "voice-agent" (outbound) or "inbound-voice-agent"
+  template: "voice-agent", // "voice-agent" (outbound) or "inbound-voice-agent"
   prompt: "You are a helpful sales assistant...",
   initialMessage: "Hi, how can I help you today?",
   publish: true,
   environment: "production",
-  folderId: "folder-id",     // Optional
+  folderId: "folder-id", // Optional
 });
 ```
 
@@ -109,33 +110,33 @@ const { workflow } = await createFromTemplate(client, {
 
 ## Resources
 
-| Property | Class | Description |
-|---|---|---|
-| `client.workflows` | `WorkflowsResource` | Workflow CRUD, publishing, runs, and templates |
-| `client.versions` | `VersionsResource` | Version management (fork, publish, lock, test) |
-| `client.nodes` | `NodesResource` | Node CRUD, config schema, and available variables |
-| `client.runs` | `RunsResource` | Run details, cancellation, and annotations |
-| `client.sessions` | `SessionsResource` | Session details, messages, and SSE streaming |
-| `client.messages` | `MessagesResource` | Message quality flags |
-| `client.variables` | `VariablesResource` | Workflow-scoped variables |
-| `client.phoneNumbers` | `PhoneNumbersResource` | Phone number management |
-| `client.sipTrunks` | `SipTrunksResource` | SIP trunk management |
-| `client.integrations` | `IntegrationsResource` | Integration and event discovery |
-| `client.contacts` | `ContactsResource` | Contact lookup and history |
-| `client.knowledgeBases` | `KnowledgeBasesResource` | Knowledge base document management |
-| `client.workflowFolders` | `WorkflowFoldersResource` | Workflow folder organization |
-| `client.mcp` | `MCPResource` | MCP server management |
-| `client.billing` | `BillingResource` | Billing usage details and totals |
-| `client.apiKey` | `ApiKeyResource` | API key introspection |
-| `client.artifacts` | `ArtifactsResource` | Resolve fresh artifact URLs |
-| `client.adversarialSuites` | `AdversarialSuitesResource` | Adversarial suite management and execution |
-| `client.adversarialTests` | `AdversarialTestsResource` | Adversarial test management and execution |
-| `client.northstars` | `NorthstarsResource` | Northstar quality criteria management |
-| `client.customEvals` | `CustomEvalsResource` | Custom eval management and execution |
-| `client.issues` | `IssuesResource` | Quality issue (flag) status management |
-| `client.auditRemarks` | `AuditRemarksResource` | Audit remark feedback management |
-| `client.chat` | `ChatResource` | Chat session management, messaging, and file uploads |
-| `client.voice` | `VoiceResource` | Voice call token creation |
+| Property                   | Class                       | Description                                          |
+| -------------------------- | --------------------------- | ---------------------------------------------------- |
+| `client.workflows`         | `WorkflowsResource`         | Workflow CRUD, publishing, runs, and templates       |
+| `client.versions`          | `VersionsResource`          | Version management (fork, publish, lock, test)       |
+| `client.nodes`             | `NodesResource`             | Node CRUD, config schema, and available variables    |
+| `client.runs`              | `RunsResource`              | Run details, cancellation, and annotations           |
+| `client.sessions`          | `SessionsResource`          | Session details, messages, and SSE streaming         |
+| `client.messages`          | `MessagesResource`          | Message quality flags                                |
+| `client.variables`         | `VariablesResource`         | Workflow-scoped variables                            |
+| `client.phoneNumbers`      | `PhoneNumbersResource`      | Phone number management                              |
+| `client.sipTrunks`         | `SipTrunksResource`         | SIP trunk management                                 |
+| `client.integrations`      | `IntegrationsResource`      | Integration and event discovery                      |
+| `client.contacts`          | `ContactsResource`          | Contact lookup and history                           |
+| `client.knowledgeBases`    | `KnowledgeBasesResource`    | Knowledge base document management                   |
+| `client.workflowFolders`   | `WorkflowFoldersResource`   | Workflow folder organization                         |
+| `client.mcp`               | `MCPResource`               | MCP server management                                |
+| `client.billing`           | `BillingResource`           | Billing usage details and totals                     |
+| `client.apiKey`            | `ApiKeyResource`            | API key introspection                                |
+| `client.artifacts`         | `ArtifactsResource`         | Resolve fresh artifact URLs                          |
+| `client.adversarialSuites` | `AdversarialSuitesResource` | Adversarial suite management and execution           |
+| `client.adversarialTests`  | `AdversarialTestsResource`  | Adversarial test management and execution            |
+| `client.northstars`        | `NorthstarsResource`        | Northstar quality criteria management                |
+| `client.customEvals`       | `CustomEvalsResource`       | Custom eval management and execution                 |
+| `client.issues`            | `IssuesResource`            | Quality issue (flag) status management               |
+| `client.auditRemarks`      | `AuditRemarksResource`      | Audit remark feedback management                     |
+| `client.chat`              | `ChatResource`              | Chat session management, messaging, and file uploads |
+| `client.voice`             | `VoiceResource`             | Voice call token creation                            |
 
 ---
 
@@ -183,22 +184,22 @@ const { data } = await client.workflows.listRuns("my-workflow");
 const { run_id } = await client.workflows.triggerRun("my-workflow", { payload: { phone: "+1..." } });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/workflows` | List workflows, paginated |
-| `listAll(query?)` | GET | `/workflows` | Async generator over all pages |
-| `create(body)` | POST | `/workflows` | Create a new workflow |
-| `get(workflowId)` | GET | `/workflows/:id` | Get workflow by ID or slug |
-| `update(workflowId, body)` | PATCH | `/workflows/:id` | Update name, description, etc. |
-| `delete(workflowId)` | DELETE | `/workflows/:id` | Delete a workflow |
-| `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 |
-| `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 |
-| `triggerRun(workflowId, body?)` | POST | `/workflows/:id/runs` | Trigger a new run |
+| Method                             | HTTP   | Path                         | Description                    |
+| ---------------------------------- | ------ | ---------------------------- | ------------------------------ |
+| `list(query?)`                     | GET    | `/workflows`                 | List workflows, paginated      |
+| `listAll(query?)`                  | GET    | `/workflows`                 | Async generator over all pages |
+| `create(body)`                     | POST   | `/workflows`                 | Create a new workflow          |
+| `get(workflowId)`                  | GET    | `/workflows/:id`             | Get workflow by ID or slug     |
+| `update(workflowId, body)`         | PATCH  | `/workflows/:id`             | Update name, description, etc. |
+| `delete(workflowId)`               | DELETE | `/workflows/:id`             | Delete a workflow              |
+| `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         |
+| `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       |
+| `triggerRun(workflowId, body?)`    | POST   | `/workflows/:id/runs`        | Trigger a new run              |
 
 ---
 
@@ -216,17 +217,17 @@ await client.versions.testAll("version-id");
 const issues = await client.versions.getPromptIssues("version-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(versionId)` | GET | `/versions/:id` | Get version with node summary and changelog |
-| `update(versionId, body)` | PATCH | `/versions/:id` | Update name or description |
-| `fork(versionId)` | POST | `/versions/:id/fork` | Clone a version |
-| `publish(versionId, body?)` | POST | `/versions/:id/publish` | Publish a version |
-| `unpublish(versionId)` | POST | `/versions/:id/unpublish` | Unpublish a version |
-| `lock(versionId)` | POST | `/versions/:id/lock` | Lock a version (prevent edits) |
-| `unlock(versionId)` | POST | `/versions/:id/unlock` | Unlock a version |
-| `testAll(versionId)` | POST | `/versions/:id/test-all` | Run test-all validation |
-| `getPromptIssues(versionId)` | GET | `/versions/:id/prompt-issues` | Get prompt quality issues for all prompt nodes |
+| Method                       | HTTP  | Path                          | Description                                    |
+| ---------------------------- | ----- | ----------------------------- | ---------------------------------------------- |
+| `get(versionId)`             | GET   | `/versions/:id`               | Get version with node summary and changelog    |
+| `update(versionId, body)`    | PATCH | `/versions/:id`               | Update name or description                     |
+| `fork(versionId)`            | POST  | `/versions/:id/fork`          | Clone a version                                |
+| `publish(versionId, body?)`  | POST  | `/versions/:id/publish`       | Publish a version                              |
+| `unpublish(versionId)`       | POST  | `/versions/:id/unpublish`     | Unpublish a version                            |
+| `lock(versionId)`            | POST  | `/versions/:id/lock`          | Lock a version (prevent edits)                 |
+| `unlock(versionId)`          | POST  | `/versions/:id/unlock`        | Unlock a version                               |
+| `testAll(versionId)`         | POST  | `/versions/:id/test-all`      | Run test-all validation                        |
+| `getPromptIssues(versionId)` | GET   | `/versions/:id/prompt-issues` | Get prompt quality issues for all prompt nodes |
 
 ---
 
@@ -245,16 +246,16 @@ const vars = await client.nodes.getAvailableVars("version-id", "node-id");
 const result = await client.nodes.test("version-id", "node-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(versionId)` | GET | `/versions/:vId/nodes` | List all nodes in a version |
-| `addBatch(versionId, body)` | POST | `/versions/:vId/nodes` | Add nodes in batch (1–50) |
-| `get(versionId, nodeId)` | GET | `/versions/:vId/nodes/:nId` | Get a single node |
-| `update(versionId, nodeId, body)` | PUT | `/versions/:vId/nodes/:nId` | Update a node |
-| `delete(versionId, nodeId)` | DELETE | `/versions/:vId/nodes/:nId` | Delete a node |
-| `getConfigSchema(versionId, nodeId)` | GET | `/versions/:vId/nodes/:nId/config-schema` | Get field types and requirements |
-| `getAvailableVars(versionId, nodeId)` | GET | `/versions/:vId/nodes/:nId/available-vars` | Get upstream variables available to this node |
-| `test(versionId, nodeId, body?)` | POST | `/versions/:vId/nodes/:nId/test` | Test a single node (version must not be published) |
+| Method                                | HTTP   | Path                                       | Description                                        |
+| ------------------------------------- | ------ | ------------------------------------------ | -------------------------------------------------- |
+| `list(versionId)`                     | GET    | `/versions/:vId/nodes`                     | List all nodes in a version                        |
+| `addBatch(versionId, body)`           | POST   | `/versions/:vId/nodes`                     | Add nodes in batch (1–50)                          |
+| `get(versionId, nodeId)`              | GET    | `/versions/:vId/nodes/:nId`                | Get a single node                                  |
+| `update(versionId, nodeId, body)`     | PUT    | `/versions/:vId/nodes/:nId`                | Update a node                                      |
+| `delete(versionId, nodeId)`           | DELETE | `/versions/:vId/nodes/:nId`                | Delete a node                                      |
+| `getConfigSchema(versionId, nodeId)`  | GET    | `/versions/:vId/nodes/:nId/config-schema`  | Get field types and requirements                   |
+| `getAvailableVars(versionId, nodeId)` | GET    | `/versions/:vId/nodes/:nId/available-vars` | Get upstream variables available to this node      |
+| `test(versionId, nodeId, body?)`      | POST   | `/versions/:vId/nodes/:nId/test`           | Test a single node (version must not be published) |
 
 ---
 
@@ -269,14 +270,14 @@ await client.runs.cancel("run-id");
 await client.runs.mark("run-id", { annotation: "correct" });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(runId)` | GET | `/runs/:id` | Get run details |
-| `getSessions(runId, query?)` | GET | `/runs/:id/sessions` | Get sessions for a run |
-| `getRecordings(runId)` | GET | `/runs/:id/recordings` | Get recordings for a run |
-| `getFlags(runId, query?)` | GET | `/runs/:id/flags` | Get quality flags for a run |
-| `cancel(runId)` | POST | `/runs/:id/cancel` | Cancel a run |
-| `mark(runId, body)` | POST | `/runs/:id/mark` | Annotate a run (correct / incorrect / critical) |
+| Method                       | HTTP | Path                   | Description                                     |
+| ---------------------------- | ---- | ---------------------- | ----------------------------------------------- |
+| `get(runId)`                 | GET  | `/runs/:id`            | Get run details                                 |
+| `getSessions(runId, query?)` | GET  | `/runs/:id/sessions`   | Get sessions for a run                          |
+| `getRecordings(runId)`       | GET  | `/runs/:id/recordings` | Get recordings for a run                        |
+| `getFlags(runId, query?)`    | GET  | `/runs/:id/flags`      | Get quality flags for a run                     |
+| `cancel(runId)`              | POST | `/runs/:id/cancel`     | Cancel a run                                    |
+| `mark(runId, body)`          | POST | `/runs/:id/mark`       | Annotate a run (correct / incorrect / critical) |
 
 ---
 
@@ -288,16 +289,17 @@ const { data } = await client.sessions.getMessages("session-id");
 
 // SSE streaming
 for await (const event of await client.sessions.stream("session-id")) {
-  if (event.event === "message") console.log(event.data.role, event.data.content);
+  if (event.event === "message")
+    console.log(event.data.role, event.data.content);
   if (event.event === "session_ended") break;
 }
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(sessionId)` | GET | `/sessions/:id` | Get session details |
-| `getMessages(sessionId, query?)` | GET | `/sessions/:id/messages` | Get paginated messages for a session |
-| `stream(sessionId, query?)` | GET | `/sessions/:id/stream` | Open SSE stream of session messages |
+| Method                           | HTTP | Path                     | Description                          |
+| -------------------------------- | ---- | ------------------------ | ------------------------------------ |
+| `get(sessionId)`                 | GET  | `/sessions/:id`          | Get session details                  |
+| `getMessages(sessionId, query?)` | GET  | `/sessions/:id/messages` | Get paginated messages for a session |
+| `stream(sessionId, query?)`      | GET  | `/sessions/:id/stream`   | Open SSE stream of session messages  |
 
 ---
 
@@ -305,13 +307,16 @@ for await (const event of await client.sessions.stream("session-id")) {
 
 ```ts
 const { data } = await client.messages.listFlags("message-id");
-await client.messages.createFlag("message-id", { type: "incorrect", note: "..." });
+await client.messages.createFlag("message-id", {
+  type: "incorrect",
+  note: "...",
+});
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `listFlags(messageId, query?)` | GET | `/messages/:id/flags` | List quality flags for a message |
-| `createFlag(messageId, body)` | POST | `/messages/:id/flags` | Create a quality flag on a message |
+| Method                         | HTTP | Path                  | Description                        |
+| ------------------------------ | ---- | --------------------- | ---------------------------------- |
+| `listFlags(messageId, query?)` | GET  | `/messages/:id/flags` | List quality flags for a message   |
+| `createFlag(messageId, body)`  | POST | `/messages/:id/flags` | Create a quality flag on a message |
 
 ---
 
@@ -323,8 +328,8 @@ const resolved = await client.artifacts.resolve({
 });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
+| Method          | HTTP | Path                 | Description                                |
+| --------------- | ---- | -------------------- | ------------------------------------------ |
 | `resolve(body)` | POST | `/artifacts/resolve` | Resolve fresh presigned URLs for artifacts |
 
 ---
@@ -335,17 +340,20 @@ Variables are scoped to a workflow.
 
 ```ts
 const { data } = await client.variables.list("workflow-id");
-await client.variables.create("workflow-id", { name: "MY_VAR", value: "hello" });
+await client.variables.create("workflow-id", {
+  name: "MY_VAR",
+  value: "hello",
+});
 await client.variables.update("workflow-id", "variable-id", { value: "world" });
 await client.variables.delete("workflow-id", "variable-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(workflowId, query?)` | GET | `/workflows/:wId/variables` | List variables for a workflow |
-| `create(workflowId, body)` | POST | `/workflows/:wId/variables` | Create a variable |
-| `update(workflowId, variableId, body)` | PATCH | `/workflows/:wId/variables/:vId` | Update a variable |
-| `delete(workflowId, variableId)` | DELETE | `/workflows/:wId/variables/:vId` | Delete a variable |
+| Method                                 | HTTP   | Path                             | Description                   |
+| -------------------------------------- | ------ | -------------------------------- | ----------------------------- |
+| `list(workflowId, query?)`             | GET    | `/workflows/:wId/variables`      | List variables for a workflow |
+| `create(workflowId, body)`             | POST   | `/workflows/:wId/variables`      | Create a variable             |
+| `update(workflowId, variableId, body)` | PATCH  | `/workflows/:wId/variables/:vId` | Update a variable             |
+| `delete(workflowId, variableId)`       | DELETE | `/workflows/:wId/variables/:vId` | Delete a variable             |
 
 ---
 
@@ -366,20 +374,20 @@ await client.phoneNumbers.createSipTrunk("id");
 await client.phoneNumbers.validateTollFreeNumbers({ phone_numbers: [...] });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/phone-numbers` | List all phone numbers |
-| `buy(body)` | POST | `/phone-numbers` | Purchase a new phone number |
-| `update(id, body)` | PUT | `/phone-numbers/:id` | Update name or caller ID |
-| `getUsage(id)` | GET | `/phone-numbers/:id/usage` | Get usage info |
-| `getTollFreeVerification(id)` | GET | `/phone-numbers/:id/tollfree-verification` | Get toll-free verification status |
-| `createTollFreeVerification(id, body)` | POST | `/phone-numbers/:id/tollfree-verification` | Start toll-free verification |
-| `deleteTollFreeVerification(verificationSid)` | DELETE | `/phone-numbers/tollfree-verification/:sid` | Delete a toll-free verification |
-| `createSipTrunk(id)` | POST | `/phone-numbers/:id/sip-trunk` | Create a SIP trunk for a number |
-| `freeUp(id)` | POST | `/phone-numbers/:id/free-up-number` | Release a number from workflows |
-| `delete(id)` | POST | `/phone-numbers/:id/delete-number` | Permanently delete a number |
-| `removeFromWorkflow(id, body)` | POST | `/phone-numbers/:id/remove-from-workflow` | Remove from a specific workflow |
-| `validateTollFreeNumbers(body)` | POST | `/phone-numbers/validate-toll-free-numbers` | Check for conflicts |
+| Method                                        | HTTP   | Path                                        | Description                       |
+| --------------------------------------------- | ------ | ------------------------------------------- | --------------------------------- |
+| `list(query?)`                                | GET    | `/phone-numbers`                            | List all phone numbers            |
+| `buy(body)`                                   | POST   | `/phone-numbers`                            | Purchase a new phone number       |
+| `update(id, body)`                            | PUT    | `/phone-numbers/:id`                        | Update name or caller ID          |
+| `getUsage(id)`                                | GET    | `/phone-numbers/:id/usage`                  | Get usage info                    |
+| `getTollFreeVerification(id)`                 | GET    | `/phone-numbers/:id/tollfree-verification`  | Get toll-free verification status |
+| `createTollFreeVerification(id, body)`        | POST   | `/phone-numbers/:id/tollfree-verification`  | Start toll-free verification      |
+| `deleteTollFreeVerification(verificationSid)` | DELETE | `/phone-numbers/tollfree-verification/:sid` | Delete a toll-free verification   |
+| `createSipTrunk(id)`                          | POST   | `/phone-numbers/:id/sip-trunk`              | Create a SIP trunk for a number   |
+| `freeUp(id)`                                  | POST   | `/phone-numbers/:id/free-up-number`         | Release a number from workflows   |
+| `delete(id)`                                  | POST   | `/phone-numbers/:id/delete-number`          | Permanently delete a number       |
+| `removeFromWorkflow(id, body)`                | POST   | `/phone-numbers/:id/remove-from-workflow`   | Remove from a specific workflow   |
+| `validateTollFreeNumbers(body)`               | POST   | `/phone-numbers/validate-toll-free-numbers` | Check for conflicts               |
 
 ---
 
@@ -395,15 +403,15 @@ await client.sipTrunks.update("trunk-id", { name: "Updated" });
 await client.sipTrunks.delete("trunk-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list()` | GET | `/sip-trunks` | List all SIP trunks |
-| `listOptions()` | GET | `/sip-trunks/options` | Lightweight list of trunk options |
-| `create(body)` | POST | `/sip-trunks` | Create a SIP trunk |
-| `createBulk(body)` | POST | `/sip-trunks/bulk` | Create multiple SIP trunks |
-| `get(trunkId)` | GET | `/sip-trunks/:id` | Get a SIP trunk |
-| `update(trunkId, body)` | PUT | `/sip-trunks/:id` | Update a SIP trunk |
-| `delete(trunkId)` | DELETE | `/sip-trunks/:id` | Delete a SIP trunk |
+| Method                  | HTTP   | Path                  | Description                       |
+| ----------------------- | ------ | --------------------- | --------------------------------- |
+| `list()`                | GET    | `/sip-trunks`         | List all SIP trunks               |
+| `listOptions()`         | GET    | `/sip-trunks/options` | Lightweight list of trunk options |
+| `create(body)`          | POST   | `/sip-trunks`         | Create a SIP trunk                |
+| `createBulk(body)`      | POST   | `/sip-trunks/bulk`    | Create multiple SIP trunks        |
+| `get(trunkId)`          | GET    | `/sip-trunks/:id`     | Get a SIP trunk                   |
+| `update(trunkId, body)` | PUT    | `/sip-trunks/:id`     | Update a SIP trunk                |
+| `delete(trunkId)`       | DELETE | `/sip-trunks/:id`     | Delete a SIP trunk                |
 
 ---
 
@@ -435,25 +443,25 @@ await client.integrations.whatsApp.phoneNumbers({ credential_id: "...", business
 await client.integrations.whatsApp.messageTemplates({ credential_id: "...", business_account_id: "..." });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/integrations` | List all integrations |
-| `get(id)` | GET | `/integrations/:id` | Get integration and its events |
-| `createCredential(id, body)` | POST | `/integrations/:id/create-credential` | Create a credential for a form-based integration |
-| `googleSheets.spreadsheets(query?)` | GET | `/integrations/google-sheets/spreadsheets` | List spreadsheets |
-| `googleSheets.worksheets(query)` | GET | `/integrations/google-sheets/worksheets` | List worksheets in a spreadsheet |
-| `googleSheets.columns(query)` | GET | `/integrations/google-sheets/columns` | List columns in a worksheet |
-| `googleSheets.rows(query)` | GET | `/integrations/google-sheets/rows` | List rows in a worksheet |
-| `slack.channels(query?)` | GET | `/integrations/slack/channels` | List Slack channels |
-| `slack.users(query?)` | GET | `/integrations/slack/users` | List Slack users |
-| `teams.teams(query?)` | GET | `/integrations/teams/teams` | List Microsoft Teams teams |
-| `teams.channels(query?)` | GET | `/integrations/teams/channels` | List Microsoft Teams channels |
-| `teams.users(query?)` | GET | `/integrations/teams/users` | List Microsoft Teams users |
-| `twilioSms.phoneNumbers(query?)` | GET | `/integrations/twilio-sms/phone-numbers` | List Twilio SMS numbers |
-| `whatsApp.businesses(query)` | GET | `/integrations/whatsapp/businesses` | List WhatsApp businesses |
-| `whatsApp.businessAccounts(query)` | GET | `/integrations/whatsapp/business-accounts` | List WhatsApp business accounts |
-| `whatsApp.phoneNumbers(query)` | GET | `/integrations/whatsapp/phone-numbers` | List WhatsApp phone numbers |
-| `whatsApp.messageTemplates(query)` | GET | `/integrations/whatsapp/message-templates` | List WhatsApp message templates |
+| Method                              | HTTP | Path                                       | Description                                      |
+| ----------------------------------- | ---- | ------------------------------------------ | ------------------------------------------------ |
+| `list(query?)`                      | GET  | `/integrations`                            | List all integrations                            |
+| `get(id)`                           | GET  | `/integrations/:id`                        | Get integration and its events                   |
+| `createCredential(id, body)`        | POST | `/integrations/:id/create-credential`      | Create a credential for a form-based integration |
+| `googleSheets.spreadsheets(query?)` | GET  | `/integrations/google-sheets/spreadsheets` | List spreadsheets                                |
+| `googleSheets.worksheets(query)`    | GET  | `/integrations/google-sheets/worksheets`   | List worksheets in a spreadsheet                 |
+| `googleSheets.columns(query)`       | GET  | `/integrations/google-sheets/columns`      | List columns in a worksheet                      |
+| `googleSheets.rows(query)`          | GET  | `/integrations/google-sheets/rows`         | List rows in a worksheet                         |
+| `slack.channels(query?)`            | GET  | `/integrations/slack/channels`             | List Slack channels                              |
+| `slack.users(query?)`               | GET  | `/integrations/slack/users`                | List Slack users                                 |
+| `teams.teams(query?)`               | GET  | `/integrations/teams/teams`                | List Microsoft Teams teams                       |
+| `teams.channels(query?)`            | GET  | `/integrations/teams/channels`             | List Microsoft Teams channels                    |
+| `teams.users(query?)`               | GET  | `/integrations/teams/users`                | List Microsoft Teams users                       |
+| `twilioSms.phoneNumbers(query?)`    | GET  | `/integrations/twilio-sms/phone-numbers`   | List Twilio SMS numbers                          |
+| `whatsApp.businesses(query)`        | GET  | `/integrations/whatsapp/businesses`        | List WhatsApp businesses                         |
+| `whatsApp.businessAccounts(query)`  | GET  | `/integrations/whatsapp/business-accounts` | List WhatsApp business accounts                  |
+| `whatsApp.phoneNumbers(query)`      | GET  | `/integrations/whatsapp/phone-numbers`     | List WhatsApp phone numbers                      |
+| `whatsApp.messageTemplates(query)`  | GET  | `/integrations/whatsapp/message-templates` | List WhatsApp message templates                  |
 
 ---
 
@@ -467,13 +475,13 @@ const interactions = await client.contacts.getInteractions("contact-id");
 const memories = await client.contacts.getMemories("contact-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/contacts` | List contacts (cursor-paginated) |
-| `resolve(query)` | GET | `/contacts/resolve` | Look up a contact by phone number or email |
-| `get(contactId)` | GET | `/contacts/:id` | Get contact by ID |
-| `getInteractions(contactId)` | GET | `/contacts/:id/interactions` | Get call/message history for a contact |
-| `getMemories(contactId)` | GET | `/contacts/:id/memories` | Get AI memories for a contact |
+| Method                       | HTTP | Path                         | Description                                |
+| ---------------------------- | ---- | ---------------------------- | ------------------------------------------ |
+| `list(query?)`               | GET  | `/contacts`                  | List contacts (cursor-paginated)           |
+| `resolve(query)`             | GET  | `/contacts/resolve`          | Look up a contact by phone number or email |
+| `get(contactId)`             | GET  | `/contacts/:id`              | Get contact by ID                          |
+| `getInteractions(contactId)` | GET  | `/contacts/:id/interactions` | Get call/message history for a contact     |
+| `getMemories(contactId)`     | GET  | `/contacts/:id/memories`     | Get AI memories for a contact              |
 
 ---
 
@@ -482,20 +490,22 @@ const memories = await client.contacts.getMemories("contact-id");
 ```ts
 const kbs = await client.knowledgeBases.list();
 const files = await client.knowledgeBases.listFiles("kb-id");
-const urls = await client.knowledgeBases.getUploadUrls("kb-id", { files: [{ name: "doc.pdf", content_type: "application/pdf" }] });
+const urls = await client.knowledgeBases.getUploadUrls("kb-id", {
+  files: [{ name: "doc.pdf", content_type: "application/pdf" }],
+});
 await client.knowledgeBases.triggerChunking("kb-id");
 await client.knowledgeBases.deleteFile("kb-id", "file-id");
 await client.knowledgeBases.delete("kb-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list()` | GET | `/knowledge-bases` | List all knowledge bases |
-| `listFiles(kbId)` | GET | `/knowledge-bases/:id/files` | List documents in a knowledge base |
-| `getUploadUrls(kbId, body)` | POST | `/knowledge-bases/:id/upload-urls` | Get pre-signed S3 upload URLs |
-| `triggerChunking(kbId)` | POST | `/knowledge-bases/:id/trigger-chunking` | Start document processing/chunking |
-| `deleteFile(kbId, fileId)` | DELETE | `/knowledge-bases/:id/files/:fileId` | Delete a file from a knowledge base |
-| `delete(kbId)` | DELETE | `/knowledge-bases/:id` | Delete a knowledge base |
+| Method                      | HTTP   | Path                                    | Description                         |
+| --------------------------- | ------ | --------------------------------------- | ----------------------------------- |
+| `list()`                    | GET    | `/knowledge-bases`                      | List all knowledge bases            |
+| `listFiles(kbId)`           | GET    | `/knowledge-bases/:id/files`            | List documents in a knowledge base  |
+| `getUploadUrls(kbId, body)` | POST   | `/knowledge-bases/:id/upload-urls`      | Get pre-signed S3 upload URLs       |
+| `triggerChunking(kbId)`     | POST   | `/knowledge-bases/:id/trigger-chunking` | Start document processing/chunking  |
+| `deleteFile(kbId, fileId)`  | DELETE | `/knowledge-bases/:id/files/:fileId`    | Delete a file from a knowledge base |
+| `delete(kbId)`              | DELETE | `/knowledge-bases/:id`                  | Delete a knowledge base             |
 
 ---
 
@@ -509,13 +519,13 @@ await client.workflowFolders.update("folder-id", { name: "Updated" });
 await client.workflowFolders.delete("folder-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/workflow-folders` | List folders (paginated) |
-| `create(body)` | POST | `/workflow-folders` | Create a folder |
-| `get(folderId)` | GET | `/workflow-folders/:id` | Get a folder |
-| `update(folderId, body)` | PUT | `/workflow-folders/:id` | Update a folder |
-| `delete(folderId)` | DELETE | `/workflow-folders/:id` | Delete a folder |
+| Method                   | HTTP   | Path                    | Description              |
+| ------------------------ | ------ | ----------------------- | ------------------------ |
+| `list(query?)`           | GET    | `/workflow-folders`     | List folders (paginated) |
+| `create(body)`           | POST   | `/workflow-folders`     | Create a folder          |
+| `get(folderId)`          | GET    | `/workflow-folders/:id` | Get a folder             |
+| `update(folderId, body)` | PUT    | `/workflow-folders/:id` | Update a folder          |
+| `delete(folderId)`       | DELETE | `/workflow-folders/:id` | Delete a folder          |
 
 ---
 
@@ -527,25 +537,33 @@ await client.mcp.create({ name: "My MCP", url: "https://..." });
 await client.mcp.refresh("mcp-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `list(query?)` | GET | `/mcp` | List MCP servers (paginated) |
-| `create(body)` | POST | `/mcp` | Register a new MCP server |
+| Method           | HTTP | Path               | Description                         |
+| ---------------- | ---- | ------------------ | ----------------------------------- |
+| `list(query?)`   | GET  | `/mcp`             | List MCP servers (paginated)        |
+| `create(body)`   | POST | `/mcp`             | Register a new MCP server           |
 | `refresh(mcpId)` | POST | `/mcp/:id/refresh` | Re-discover tools for an MCP server |
 
+**OAuth2 (`auth_type: "oauth2"`)**: set `oauth2_credential_id` to the UUID of an **OAuth 2.0** integration credential (same org) configured with your provider’s token URL. Do not send `auth_token`; the API fetches a short-lived access token when creating, listing refresh, or when workflows run.
+
 ---
 
 ## `client.billing`
 
 ```ts
-const details = await client.billing.getDetails({ start: "2024-01-01", end: "2024-01-31" });
-const totals = await client.billing.getTotals({ start: "2024-01-01", end: "2024-01-31" });
+const details = await client.billing.getDetails({
+  start: "2024-01-01",
+  end: "2024-01-31",
+});
+const totals = await client.billing.getTotals({
+  start: "2024-01-01",
+  end: "2024-01-31",
+});
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `getDetails(query)` | GET | `/billing/usage/details` | Detailed billing line items |
-| `getTotals(query)` | GET | `/billing/usage/totals` | Aggregated billing totals |
+| Method              | HTTP | Path                     | Description                 |
+| ------------------- | ---- | ------------------------ | --------------------------- |
+| `getDetails(query)` | GET  | `/billing/usage/details` | Detailed billing line items |
+| `getTotals(query)`  | GET  | `/billing/usage/totals`  | Aggregated billing totals   |
 
 ---
 
@@ -555,9 +573,9 @@ const totals = await client.billing.getTotals({ start: "2024-01-01", end: "2024-
 const info = await client.apiKey.describe();
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `describe()` | GET | `/api-key/describe` | Introspect the current API key (ID, name, org, etc.) |
+| Method       | HTTP | Path                | Description                                          |
+| ------------ | ---- | ------------------- | ---------------------------------------------------- |
+| `describe()` | GET  | `/api-key/describe` | Introspect the current API key (ID, name, org, etc.) |
 
 ---
 
@@ -567,35 +585,43 @@ Adversarial suites group multiple adversarial tests and can auto-generate them f
 
 ```ts
 const { suite } = await client.adversarialSuites.get("suite-id");
-await client.adversarialSuites.update("suite-id", { name: "New Name", generation_count: 10 });
+await client.adversarialSuites.update("suite-id", {
+  name: "New Name",
+  generation_count: 10,
+});
 await client.adversarialSuites.delete("suite-id");
 
 // Generate tests from the suite's generation_prompt using AI
 await client.adversarialSuites.generate("suite-id", { version_id: "v-id" });
 
 // Generate a mermaid workflow graph for visualization
-await client.adversarialSuites.generateGraph("suite-id", { version_id: "v-id" });
+await client.adversarialSuites.generateGraph("suite-id", {
+  version_id: "v-id",
+});
 
 // Run all tests in the suite
-const { suite_run_id } = await client.adversarialSuites.run("suite-id", { version_id: "v-id" });
+const { suite_run_id } = await client.adversarialSuites.run("suite-id", {
+  version_id: "v-id",
+});
 
 // Poll results
 const { runs } = await client.adversarialSuites.listRuns("suite-id");
 const { run } = await client.adversarialSuites.getRun("suite-run-id");
-const { test_runs } = await client.adversarialSuites.getRunTestRuns("suite-run-id");
+const { test_runs } =
+  await client.adversarialSuites.getRunTestRuns("suite-run-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(suiteId)` | GET | `/adversarial-suites/:id` | Get suite with optional mermaid graph |
-| `update(suiteId, body)` | PATCH | `/adversarial-suites/:id` | Update name, model, timeout, generation settings |
-| `delete(suiteId)` | DELETE | `/adversarial-suites/:id` | Delete a suite |
-| `generate(suiteId, body?)` | POST | `/adversarial-suites/:id/generate` | AI-generate tests from the suite's generation prompt |
-| `generateGraph(suiteId, body)` | POST | `/adversarial-suites/:id/generate-graph` | Generate a mermaid workflow visualization |
-| `run(suiteId, body)` | POST | `/adversarial-suites/:id/run` | Execute all tests asynchronously, returns `suite_run_id` |
-| `listRuns(suiteId, query?)` | GET | `/adversarial-suites/:id/runs` | List suite runs |
-| `getRun(suiteRunId)` | GET | `/adversarial-suites/runs/:runId` | Get a suite run with aggregate pass/fail counts |
-| `getRunTestRuns(suiteRunId)` | GET | `/adversarial-suites/runs/:runId/test-runs` | List individual test results within a suite run |
+| Method                         | HTTP   | Path                                        | Description                                              |
+| ------------------------------ | ------ | ------------------------------------------- | -------------------------------------------------------- |
+| `get(suiteId)`                 | GET    | `/adversarial-suites/:id`                   | Get suite with optional mermaid graph                    |
+| `update(suiteId, body)`        | PATCH  | `/adversarial-suites/:id`                   | Update name, model, timeout, generation settings         |
+| `delete(suiteId)`              | DELETE | `/adversarial-suites/:id`                   | Delete a suite                                           |
+| `generate(suiteId, body?)`     | POST   | `/adversarial-suites/:id/generate`          | AI-generate tests from the suite's generation prompt     |
+| `generateGraph(suiteId, body)` | POST   | `/adversarial-suites/:id/generate-graph`    | Generate a mermaid workflow visualization                |
+| `run(suiteId, body)`           | POST   | `/adversarial-suites/:id/run`               | Execute all tests asynchronously, returns `suite_run_id` |
+| `listRuns(suiteId, query?)`    | GET    | `/adversarial-suites/:id/runs`              | List suite runs                                          |
+| `getRun(suiteRunId)`           | GET    | `/adversarial-suites/runs/:runId`           | Get a suite run with aggregate pass/fail counts          |
+| `getRunTestRuns(suiteRunId)`   | GET    | `/adversarial-suites/runs/:runId/test-runs` | List individual test results within a suite run          |
 
 ---
 
@@ -605,11 +631,16 @@ Individual adversarial tests simulate a user trying to break the agent's behavio
 
 ```ts
 const { test } = await client.adversarialTests.get("test-id");
-await client.adversarialTests.update("test-id", { adversarial_prompt: "Try to get PII", timeout_seconds: 120 });
+await client.adversarialTests.update("test-id", {
+  adversarial_prompt: "Try to get PII",
+  timeout_seconds: 120,
+});
 await client.adversarialTests.delete("test-id");
 
 // Run a single test
-const { test_run_id } = await client.adversarialTests.run("test-id", { version_id: "v-id" });
+const { test_run_id } = await client.adversarialTests.run("test-id", {
+  version_id: "v-id",
+});
 
 // Poll results
 const { runs } = await client.adversarialTests.listRuns("test-id");
@@ -617,15 +648,15 @@ const { run } = await client.adversarialTests.getRun("run-id");
 const { messages } = await client.adversarialTests.getRunMessages("run-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(testId)` | GET | `/adversarial-tests/:id` | Get test details |
-| `update(testId, body)` | PATCH | `/adversarial-tests/:id` | Update prompt, model, variables, timeout |
-| `delete(testId)` | DELETE | `/adversarial-tests/:id` | Delete a test |
-| `run(testId, body)` | POST | `/adversarial-tests/:id/run` | Execute a test asynchronously, returns `test_run_id` |
-| `listRuns(testId, query?)` | GET | `/adversarial-tests/:id/runs` | List test runs with audit remarks |
-| `getRun(runId)` | GET | `/adversarial-tests/runs/:runId` | Get a single run with full audit remarks |
-| `getRunMessages(runId)` | GET | `/adversarial-tests/runs/:runId/messages` | Get the full conversation from a test run |
+| Method                     | HTTP   | Path                                      | Description                                          |
+| -------------------------- | ------ | ----------------------------------------- | ---------------------------------------------------- |
+| `get(testId)`              | GET    | `/adversarial-tests/:id`                  | Get test details                                     |
+| `update(testId, body)`     | PATCH  | `/adversarial-tests/:id`                  | Update prompt, model, variables, timeout             |
+| `delete(testId)`           | DELETE | `/adversarial-tests/:id`                  | Delete a test                                        |
+| `run(testId, body)`        | POST   | `/adversarial-tests/:id/run`              | Execute a test asynchronously, returns `test_run_id` |
+| `listRuns(testId, query?)` | GET    | `/adversarial-tests/:id/runs`             | List test runs with audit remarks                    |
+| `getRun(runId)`            | GET    | `/adversarial-tests/runs/:runId`          | Get a single run with full audit remarks             |
+| `getRunMessages(runId)`    | GET    | `/adversarial-tests/runs/:runId/messages` | Get the full conversation from a test run            |
 
 ---
 
@@ -635,7 +666,10 @@ Northstars are quality criteria that define how the agent should behave. They ar
 
 ```ts
 const { northstar } = await client.northstars.get("northstar-id");
-await client.northstars.update("northstar-id", { enabled: true, priority: "high" });
+await client.northstars.update("northstar-id", {
+  enabled: true,
+  priority: "high",
+});
 await client.northstars.delete("northstar-id");
 
 // Get full regeneration history
@@ -651,14 +685,14 @@ const { feedback } = await client.northstars.submitFeedback("northstar-id", {
 await client.northstars.deleteFeedback("northstar-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(northstarId)` | GET | `/northstars/:id` | Get a northstar |
-| `update(northstarId, body)` | PATCH | `/northstars/:id` | Update name, description, examples, category, priority, or enabled state |
-| `delete(northstarId)` | DELETE | `/northstars/:id` | Delete a northstar |
-| `getHistory(northstarId)` | GET | `/northstars/:id/history` | Get the full regeneration chain, oldest first |
-| `submitFeedback(northstarId, body)` | POST | `/northstars/:id/feedback` | Rate a northstar's correctness (−2 to +2), optionally trigger regeneration |
-| `deleteFeedback(northstarId)` | DELETE | `/northstars/:id/feedback` | Remove your feedback on a northstar |
+| Method                              | HTTP   | Path                       | Description                                                                |
+| ----------------------------------- | ------ | -------------------------- | -------------------------------------------------------------------------- |
+| `get(northstarId)`                  | GET    | `/northstars/:id`          | Get a northstar                                                            |
+| `update(northstarId, body)`         | PATCH  | `/northstars/:id`          | Update name, description, examples, category, priority, or enabled state   |
+| `delete(northstarId)`               | DELETE | `/northstars/:id`          | Delete a northstar                                                         |
+| `getHistory(northstarId)`           | GET    | `/northstars/:id/history`  | Get the full regeneration chain, oldest first                              |
+| `submitFeedback(northstarId, body)` | POST   | `/northstars/:id/feedback` | Rate a northstar's correctness (−2 to +2), optionally trigger regeneration |
+| `deleteFeedback(northstarId)`       | DELETE | `/northstars/:id/feedback` | Remove your feedback on a northstar                                        |
 
 ---
 
@@ -675,19 +709,21 @@ await client.customEvals.update("eval-id", {
 await client.customEvals.delete("eval-id");
 
 // Run an eval
-const { run_id } = await client.customEvals.run("eval-id", { version_id: "v-id" });
+const { run_id } = await client.customEvals.run("eval-id", {
+  version_id: "v-id",
+});
 
 // Poll results
 const { runs } = await client.customEvals.listRuns("eval-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `get(evalId)` | GET | `/custom-evals/:id` | Get a custom eval |
-| `update(evalId, body)` | PATCH | `/custom-evals/:id` | Update messages, expected outputs, variables, or northstar IDs |
-| `delete(evalId)` | DELETE | `/custom-evals/:id` | Delete a custom eval |
-| `run(evalId, body)` | POST | `/custom-evals/:id/run` | Execute the eval asynchronously, returns `run_id` |
-| `listRuns(evalId, query?)` | GET | `/custom-evals/:id/runs` | List runs with pass/fail and judge reasoning |
+| Method                     | HTTP   | Path                     | Description                                                    |
+| -------------------------- | ------ | ------------------------ | -------------------------------------------------------------- |
+| `get(evalId)`              | GET    | `/custom-evals/:id`      | Get a custom eval                                              |
+| `update(evalId, body)`     | PATCH  | `/custom-evals/:id`      | Update messages, expected outputs, variables, or northstar IDs |
+| `delete(evalId)`           | DELETE | `/custom-evals/:id`      | Delete a custom eval                                           |
+| `run(evalId, body)`        | POST   | `/custom-evals/:id/run`  | Execute the eval asynchronously, returns `run_id`              |
+| `listRuns(evalId, query?)` | GET    | `/custom-evals/:id/runs` | List runs with pass/fail and judge reasoning                   |
 
 ---
 
@@ -699,8 +735,8 @@ Issues (quality flags) are raised when a conversation fails a northstar or quali
 await client.issues.update("issue-id", { status: "approved" });
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
+| Method                  | HTTP  | Path          | Description                                                       |
+| ----------------------- | ----- | ------------- | ----------------------------------------------------------------- |
 | `update(issueId, body)` | PATCH | `/issues/:id` | Update issue status (`open` / `approved` / `rejected` / `closed`) |
 
 ---
@@ -727,11 +763,11 @@ await client.auditRemarks.submitFeedback("audit-remark-id", {
 await client.auditRemarks.deleteFeedback("audit-remark-id");
 ```
 
-| Method | HTTP | Path | Description |
-|---|---|---|---|
-| `getFeedback(auditRemarkId)` | GET | `/audit-remarks/:id/feedback` | Get your feedback for this remark, or `null` |
-| `submitFeedback(auditRemarkId, body)` | POST | `/audit-remarks/:id/feedback` | Submit thumbs up/down; a thumbs-up adds the remark as a northstar example |
-| `deleteFeedback(auditRemarkId)` | DELETE | `/audit-remarks/:id/feedback` | Delete your feedback |
+| Method                                | HTTP   | Path                          | Description                                                               |
+| ------------------------------------- | ------ | ----------------------------- | ------------------------------------------------------------------------- |
+| `getFeedback(auditRemarkId)`          | GET    | `/audit-remarks/:id/feedback` | Get your feedback for this remark, or `null`                              |
+| `submitFeedback(auditRemarkId, body)` | POST   | `/audit-remarks/:id/feedback` | Submit thumbs up/down; a thumbs-up adds the remark as a northstar example |
+| `deleteFeedback(auditRemarkId)`       | DELETE | `/audit-remarks/:id/feedback` | Delete your feedback                                                      |
 
 ---
 
@@ -765,7 +801,9 @@ app.post("/api/chat-token", async (req, res) => {
 import { HappyRobotChatClient } from "@happyrobot-ai/sdk";
 
 // 1. Get a client token from your server
-const { token } = await fetch("/api/chat-token", { method: "POST" }).then(r => r.json());
+const { token } = await fetch("/api/chat-token", { method: "POST" }).then((r) =>
+  r.json()
+);
 
 // 2. Initialize the browser-side client
 const chat = new HappyRobotChatClient({ token });
@@ -798,7 +836,10 @@ console.log(ack.message.id); // server-assigned message ID
 
 // 6. Send messages with file attachments
 const artifact = await chat.uploadFile(fileBlob, "photo.png", "image/png");
-await connection.sendMessage({ content: "Here's the photo", artifacts: [artifact] });
+await connection.sendMessage({
+  content: "Here's the photo",
+  artifacts: [artifact],
+});
 
 // 7. Get history (page reload, reconnect)
 const { messages } = await chat.getHistory(session_id);
@@ -818,8 +859,15 @@ await connection.sendMessage({
 });
 
 // Option B: Manual 3-step flow for more control
-const upload = await chat.getPresignedUpload({ filename: "photo.png", mime_type: "image/png" });
-await fetch(upload.upload_url, { method: "PUT", body: fileBlob, headers: { "Content-Type": "image/png" } });
+const upload = await chat.getPresignedUpload({
+  filename: "photo.png",
+  mime_type: "image/png",
+});
+await fetch(upload.upload_url, {
+  method: "PUT",
+  body: fileBlob,
+  headers: { "Content-Type": "image/png" },
+});
 await chat.completeUpload({
   artifact_id: upload.artifact_id,
   s3_uri: upload.s3_uri,
@@ -829,56 +877,63 @@ await chat.completeUpload({
 });
 await connection.sendMessage({
   content: "Here's the photo",
-  artifacts: [{ media_id: upload.artifact_id, mime_type: "image/png", filename: "photo.png", size_bytes: fileBlob.size }],
+  artifacts: [
+    {
+      media_id: upload.artifact_id,
+      mime_type: "image/png",
+      filename: "photo.png",
+      size_bytes: fileBlob.size,
+    },
+  ],
 });
 ```
 
 ### `HappyRobotClient` (server-side)
 
-| Method | Description |
-|---|---|
+| Method                                           | Description                                  |
+| ------------------------------------------------ | -------------------------------------------- |
 | `client.chat.createToken({ workflow_id, env? })` | Create a scoped client token (1 hour expiry) |
 
 ### `HappyRobotChatClient` (browser-side)
 
-| Method | Description |
-|---|---|
-| `chat.createSession()` | Create a new chat session |
-| `chat.connect(sessionId, handlers)` | Open bidirectional WebSocket — returns `ChatConnection` |
+| Method                                                 | Description                                               |
+| ------------------------------------------------------ | --------------------------------------------------------- |
+| `chat.createSession()`                                 | Create a new chat session                                 |
+| `chat.connect(sessionId, handlers)`                    | Open bidirectional WebSocket — returns `ChatConnection`   |
 | `chat.sendMessage(sessionId, { content, artifacts? })` | Send a user message via HTTP (fallback if WS unavailable) |
-| `chat.getHistory(sessionId)` | Get message history |
-| `chat.uploadFile(file, filename, mimeType)` | Upload a file (convenience method) |
-| `chat.getPresignedUpload({ filename, mime_type })` | Get presigned S3 upload URL |
-| `chat.completeUpload({ artifact_id, s3_uri, ... })` | Register uploaded artifact |
+| `chat.getHistory(sessionId)`                           | Get message history                                       |
+| `chat.uploadFile(file, filename, mimeType)`            | Upload a file (convenience method)                        |
+| `chat.getPresignedUpload({ filename, mime_type })`     | Get presigned S3 upload URL                               |
+| `chat.completeUpload({ artifact_id, s3_uri, ... })`    | Register uploaded artifact                                |
 
 ### `ChatConnection`
 
-| Method | Description |
-|---|---|
+| Method                                            | Description                                                                         |
+| ------------------------------------------------- | ----------------------------------------------------------------------------------- |
 | `connection.sendMessage({ content, artifacts? })` | Send a message via WebSocket. Returns a `Promise` that resolves with the server ack |
-| `connection.close()` | Close the WebSocket connection |
-| `connection.ws` | The underlying `WebSocket` instance |
+| `connection.close()`                              | Close the WebSocket connection                                                      |
+| `connection.ws`                                   | The underlying `WebSocket` instance                                                 |
 
 ### WebSocket Events
 
 **Server → Client:**
 
-| Event | Fields | Description |
-|---|---|---|
-| `connected` | `session_id` | Connection established |
-| `response-start` | `content` | AI started generating a response |
-| `response-chunk` | `content` | Partial response text |
-| `response-end` | `content` | Complete response text |
-| `session-closed` | `session_id`, `status`, `reason`, `duration`, `timestamp` | Session ended |
-| `token-expired` | — | JWT expired — reconnect with a fresh token |
-| `message-ack` | `id`, `message` | Server confirmed the message was sent |
-| `message-error` | `id`, `error` | Server failed to send the message |
-| `heartbeat` | — | Keep-alive (every 15s) |
+| Event            | Fields                                                    | Description                                |
+| ---------------- | --------------------------------------------------------- | ------------------------------------------ |
+| `connected`      | `session_id`                                              | Connection established                     |
+| `response-start` | `content`                                                 | AI started generating a response           |
+| `response-chunk` | `content`                                                 | Partial response text                      |
+| `response-end`   | `content`                                                 | Complete response text                     |
+| `session-closed` | `session_id`, `status`, `reason`, `duration`, `timestamp` | Session ended                              |
+| `token-expired`  | —                                                         | JWT expired — reconnect with a fresh token |
+| `message-ack`    | `id`, `message`                                           | Server confirmed the message was sent      |
+| `message-error`  | `id`, `error`                                             | Server failed to send the message          |
+| `heartbeat`      | —                                                         | Keep-alive (every 15s)                     |
 
 **Client → Server:**
 
-| Event | Fields | Description |
-|---|---|---|
+| Event     | Fields                         | Description                                           |
+| --------- | ------------------------------ | ----------------------------------------------------- |
 | `message` | `content`, `artifacts?`, `id?` | Send a user message. `id` is echoed back in ack/error |
 
 ---
@@ -914,7 +969,9 @@ app.post("/api/voice-token", async (req, res) => {
 import { HappyRobotVoiceClient } from "@happyrobot-ai/sdk/voice";
 
 // 1. Get a voice token from your server
-const { url, token } = await fetch("/api/voice-token", { method: "POST" }).then(r => r.json());
+const { url, token } = await fetch("/api/voice-token", { method: "POST" }).then(
+  (r) => r.json()
+);
 
 // 2. Create the voice client and connect
 const voice = new HappyRobotVoiceClient({ url, token });
@@ -951,39 +1008,39 @@ await connection.disconnect();
 
 ### `HappyRobotClient` (server-side)
 
-| Method | Description |
-|---|---|
+| Method                                                   | Description                            |
+| -------------------------------------------------------- | -------------------------------------- |
 | `client.voice.createToken({ workflow_id, data?, env? })` | Create a LiveKit token for voice calls |
 
 ### `HappyRobotVoiceClient` (browser-side)
 
-| Method | Description |
-|---|---|
-| `new HappyRobotVoiceClient({ url, token })` | Create client with LiveKit credentials |
-| `voice.connect(handlers?)` | Connect to room, enable microphone — returns `VoiceConnection` |
+| Method                                      | Description                                                    |
+| ------------------------------------------- | -------------------------------------------------------------- |
+| `new HappyRobotVoiceClient({ url, token })` | Create client with LiveKit credentials                         |
+| `voice.connect(handlers?)`                  | Connect to room, enable microphone — returns `VoiceConnection` |
 
 ### `VoiceConnection`
 
-| Method | Description |
-|---|---|
-| `connection.disconnect()` | End the call and disconnect from the room |
-| `connection.mute()` | Mute the local microphone |
-| `connection.unmute()` | Unmute the local microphone |
-| `connection.isMuted()` | Check mute state |
-| `connection.room` | Underlying LiveKit `Room` instance for advanced use cases |
+| Method                    | Description                                               |
+| ------------------------- | --------------------------------------------------------- |
+| `connection.disconnect()` | End the call and disconnect from the room                 |
+| `connection.mute()`       | Mute the local microphone                                 |
+| `connection.unmute()`     | Unmute the local microphone                               |
+| `connection.isMuted()`    | Check mute state                                          |
+| `connection.room`         | Underlying LiveKit `Room` instance for advanced use cases |
 
 ### Room Events
 
-| Handler | Description |
-|---|---|
-| `onConnected` | Connected to the LiveKit room |
-| `onDisconnected` | Disconnected from the room |
-| `onAgentConnected` | AI agent participant joined the room |
-| `onTrackSubscribed` | Remote audio track subscribed (auto-plays) |
-| `onTrackUnsubscribed` | Remote audio track unsubscribed |
-| `onReconnecting` | Connection temporarily lost — attempting to reconnect |
-| `onReconnected` | Successfully reconnected |
-| `onError` | An error occurred |
+| Handler               | Description                                           |
+| --------------------- | ----------------------------------------------------- |
+| `onConnected`         | Connected to the LiveKit room                         |
+| `onDisconnected`      | Disconnected from the room                            |
+| `onAgentConnected`    | AI agent participant joined the room                  |
+| `onTrackSubscribed`   | Remote audio track subscribed (auto-plays)            |
+| `onTrackUnsubscribed` | Remote audio track unsubscribed                       |
+| `onReconnecting`      | Connection temporarily lost — attempting to reconnect |
+| `onReconnected`       | Successfully reconnected                              |
+| `onError`             | An error occurred                                     |
 
 ---
 
@@ -1016,7 +1073,11 @@ for await (const workflow of client.workflows.listAll({ folder_id: "..." })) {
 ## Error Handling
 
 ```ts
-import { ApiError, AuthenticationError, NotFoundError } from "@happyrobot-ai/sdk";
+import {
+  ApiError,
+  AuthenticationError,
+  NotFoundError,
+} from "@happyrobot-ai/sdk";
 
 try {
   const wf = await client.workflows.get("nonexistent");