@zapier/zapier-sdk 0.61.0 → 0.63.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.63.0
+
+### Minor Changes
+
+- dfa3cea: Add the durable-run-write experimental code-substrate plugins: `runDurable` and `cancelDurableRun`. Both are registered only in `@zapier/zapier-sdk/experimental`; the stable subpath does not expose them. `runDurable` POSTs to sdkdurableapi `/api/v0/runs` with `source_files` (filename → contents), optional `input`/`dependencies`/`zapier_durable_version`/`connections`/`app_versions`, and a `private` input that maps to `is_private` on the wire. Returns the run ID immediately in `initialized` status — callers that need terminal status poll via `getDurableRun`; no built-in polling. `cancelDurableRun` POSTs to `/api/v0/runs/:id/cancel`, returns `{ id, status: "cancelled" }` on success, and propagates `ZapierNotFoundError` (404) and `ZapierConflictError` (409 — run already terminal) so callers can distinguish those outcomes. `runDurable` passes the API response through verbatim (no client-side `.parse()` re-emission) so callers see any richer fields the server adds later without an SDK release. Input field naming follows the in-tree convention (`run` rather than `runId`); UUID-validated at the input boundary. `cancelDurableRun` reuses `durableRunIdResolver` from the reads MR for ID pickers.
+
+## 0.62.0
+
+### Minor Changes
+
+- eb9b408: Add the durable-run-read experimental code-substrate plugins: `listDurableRuns` and `getDurableRun`. Both are registered only in `@zapier/zapier-sdk/experimental`; the stable subpath does not expose them. `listDurableRuns` is paginated (cursor + pageSize) per the sdkdurableapi `/api/v0/runs` contract; `getDurableRun` returns the full run state with nested execution and operations journal. Handlers pass API responses through verbatim (no client-side `.parse()` re-emission) so callers see any richer fields the server adds later without an SDK release. Also adds `durableRunIdResolver` in `src/resolvers/durableRunId.ts` so commands that take a run id present an interactive picker via `sdk.listDurableRuns()` in the CLI (uses `toIterable` to pull across pages). Input field naming follows the in-tree convention (`run` rather than the fork's `runId`); input is validated as a UUID at the boundary so non-UUID strings fail with a clear schema error instead of an opaque 500 from the backend's `::uuid` cast.
+
 ## 0.61.0
 
 ### Minor Changes

package/README.md

@@ -27,12 +27,16 @@
   - [`deleteClientCredentials`](#deleteclientcredentials)
   - [`listClientCredentials`](#listclientcredentials)
 - [Code Workflows (Experimental)](#code-workflows-experimental)
+  - [`cancelDurableRun`](#canceldurablerun--experimental)
   - [`createWorkflow`](#createworkflow--experimental)
   - [`deleteWorkflow`](#deleteworkflow--experimental)
   - [`disableWorkflow`](#disableworkflow--experimental)
   - [`enableWorkflow`](#enableworkflow--experimental)
+  - [`getDurableRun`](#getdurablerun--experimental)
   - [`getWorkflow`](#getworkflow--experimental)
+  - [`listDurableRuns`](#listdurableruns--experimental)
   - [`listWorkflows`](#listworkflows--experimental)
+  - [`runDurable`](#rundurable--experimental)
   - [`updateWorkflow`](#updateworkflow--experimental)
 - [Connections](#connections)
   - [`findFirstConnection`](#findfirstconnection)
@@ -1092,6 +1096,27 @@ for await (const clientCredentials of zapier.listClientCredentials().items()) {
 
 > ℹ️ **Experimental.** Import from `"@zapier/zapier-sdk/experimental"` to use these methods. Methods and behavior may change.
 
+#### `cancelDurableRun` 🧪 _experimental_
+
+Cancel a run-once durable run in initialized or started status. Returns 409 if the run is already terminal.
+
+**Parameters:**
+
+| Name      | Type     | Required | Default | Possible Values | Description    |
+| --------- | -------- | -------- | ------- | --------------- | -------------- |
+| `options` | `object` | ✅       | —       | —               |                |
+| ​ ↳ `run` | `string` | ✅       | —       | —               | Durable run ID |
+
+**Returns:** `Promise<DurableRunItem>`
+
+**Example:**
+
+```typescript
+const result = await zapier.cancelDurableRun({
+  run: "example-run",
+});
+```
+
 #### `createWorkflow` 🧪 _experimental_
 
 Create a durable workflow container. Starts disabled with no version; publish a version to add code.
@@ -1199,6 +1224,40 @@ const result = await zapier.enableWorkflow({
 });
 ```
 
+#### `getDurableRun` 🧪 _experimental_
+
+Get the full state of a run-once durable run, including its operations journal
+
+**Parameters:**
+
+| Name      | Type     | Required | Default | Possible Values | Description    |
+| --------- | -------- | -------- | ------- | --------------- | -------------- |
+| `options` | `object` | ✅       | —       | —               |                |
+| ​ ↳ `run` | `string` | ✅       | —       | —               | Durable run ID |
+
+**Returns:** `Promise<DurableRunItem>`
+
+| Name             | Type      | Required | Possible Values                                             | Description                                                                                             |
+| ---------------- | --------- | -------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `data`           | `object`  | ✅       | —                                                           |                                                                                                         |
+| ​ ↳ `id`         | `string`  | ✅       | —                                                           | Run ID (UUID)                                                                                           |
+| ​ ↳ `status`     | `string`  | ✅       | `initialized`, `started`, `finished`, `failed`, `cancelled` | Run lifecycle status. `finished` / `failed` / `cancelled` are terminal.                                 |
+| ​ ↳ `input`      | `string`  | ✅       | —                                                           | Input data passed to the run                                                                            |
+| ​ ↳ `output`     | `string`  | ✅       | —                                                           | Return value, present when status is `finished`                                                         |
+| ​ ↳ `error`      | `object`  | ✅       | —                                                           | Structured error details when the run failed (null otherwise)                                           |
+| ​ ↳ `execution`  | `object`  | ✅       | —                                                           | Linked execution, including the operations journal. Null while the run is still in `initialized` state. |
+| ​ ↳ `is_private` | `boolean` | ✅       | —                                                           | When true, the run is visible only to the creating user; otherwise visible across the account.          |
+| ​ ↳ `created_at` | `string`  | ✅       | —                                                           | When the run was created (ISO-8601)                                                                     |
+| ​ ↳ `updated_at` | `string`  | ✅       | —                                                           | When the run was last updated (ISO-8601)                                                                |
+
+**Example:**
+
+```typescript
+const { data: durableRun } = await zapier.getDurableRun({
+  run: "example-run",
+});
+```
+
 #### `getWorkflow` 🧪 _experimental_
 
 Get a durable workflow with its current version details and trigger claim status
@@ -1239,6 +1298,52 @@ const { data: workflow } = await zapier.getWorkflow({
 });
 ```
 
+#### `listDurableRuns` 🧪 _experimental_
+
+List run-once durable runs for the authenticated account, newest first
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description                                    |
+| -------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                |
+| ​ ↳ `pageSize` | `number` | ❌       | —       | —               | Number of runs per page (max 100)              |
+| ​ ↳ `cursor`   | `string` | ❌       | —       | —               | Pagination cursor                              |
+| ​ ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total items to return across all pages |
+
+**Returns:** `Promise<PaginatedResult<DurableRunItem>>`
+
+| Name               | Type       | Required | Possible Values                                             | Description                                                                                    |
+| ------------------ | ---------- | -------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `data[]`           | `object[]` | ✅       | —                                                           |                                                                                                |
+| ​ ↳ `id`           | `string`   | ✅       | —                                                           | Run ID (UUID)                                                                                  |
+| ​ ↳ `status`       | `string`   | ✅       | `initialized`, `started`, `finished`, `failed`, `cancelled` | Run lifecycle status. `finished` / `failed` / `cancelled` are terminal.                        |
+| ​ ↳ `input`        | `string`   | ✅       | —                                                           | Input data passed to the run                                                                   |
+| ​ ↳ `output`       | `string`   | ✅       | —                                                           | Return value, present when status is `finished`                                                |
+| ​ ↳ `error`        | `object`   | ✅       | —                                                           | Structured error details when the run failed (null otherwise)                                  |
+| ​ ↳ `execution_id` | `string`   | ✅       | —                                                           | Linked execution ID. Null until the run leaves the `initialized` state.                        |
+| ​ ↳ `is_private`   | `boolean`  | ✅       | —                                                           | When true, the run is visible only to the creating user; otherwise visible across the account. |
+| ​ ↳ `created_at`   | `string`   | ✅       | —                                                           | When the run was created (ISO-8601)                                                            |
+| ​ ↳ `updated_at`   | `string`   | ✅       | —                                                           | When the run was last updated (ISO-8601)                                                       |
+| `nextCursor`       | `string`   | ❌       | —                                                           | Cursor for the next page; omitted when there are no more pages                                 |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: durableRuns, nextCursor } = await zapier.listDurableRuns();
+
+// Or iterate over all pages
+for await (const page of zapier.listDurableRuns()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const durableRun of zapier.listDurableRuns().items()) {
+  // Do something with each durableRun
+}
+```
+
 #### `listWorkflows` 🧪 _experimental_
 
 List all active durable workflows for the authenticated account
@@ -1284,6 +1389,41 @@ for await (const workflow of zapier.listWorkflows().items()) {
 }
 ```
 
+#### `runDurable` 🧪 _experimental_
+
+Run a workflow source file as a run-once durable run on sdkdurableapi (no deployed workflow required). Returns the run ID immediately; poll via getDurableRun for terminal status.
+
+**Parameters:**
+
+| Name                         | Type      | Required | Default | Possible Values | Description                                                                                                     |
+| ---------------------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
+| `options`                    | `object`  | ✅       | —       | —               |                                                                                                                 |
+| ​ ↳ `source_files`           | `object`  | ✅       | —       | —               | Source files keyed by filename → contents                                                                       |
+| ​ ↳ `input`                  | `string`  | ❌       | —       | —               | Input data passed to the run                                                                                    |
+| ​ ↳ `dependencies`           | `object`  | ❌       | —       | —               | Optional npm package dependencies                                                                               |
+| ​ ↳ `zapier_durable_version` | `string`  | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted. |
+| ​ ↳ `connections`            | `object`  | ❌       | —       | —               | Named connection aliases. Maps alias names to Zapier connection IDs.                                            |
+| ​ ↳ `app_versions`           | `object`  | ❌       | —       | —               | Pinned app versions. Maps app keys (slugs) to implementation names and versions.                                |
+| ​ ↳ `private`                | `boolean` | ❌       | —       | —               | Only the creating user can see the run (default false)                                                          |
+
+**Returns:** `Promise<DurableRunItem>`
+
+| Name             | Type      | Required | Possible Values | Description                                                                                                                               |
+| ---------------- | --------- | -------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `data`           | `object`  | ✅       | —               |                                                                                                                                           |
+| ​ ↳ `id`         | `string`  | ✅       | —               | Run ID (UUID) — server-generated, time-sortable                                                                                           |
+| ​ ↳ `status`     | `string`  | ✅       | `initialized`   | Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`. |
+| ​ ↳ `is_private` | `boolean` | ✅       | —               | When true, the run is visible only to the creating user; otherwise visible across the account.                                            |
+| ​ ↳ `created_at` | `string`  | ✅       | —               | When the run was created (ISO-8601)                                                                                                       |
+
+**Example:**
+
+```typescript
+const result = await zapier.runDurable({
+  source_files: {},
+});
+```
+
 #### `updateWorkflow` 🧪 _experimental_
 
 Update a durable workflow's name and/or description

package/dist/experimental.cjs

@@ -2889,7 +2889,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.61.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.63.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -4286,6 +4286,21 @@ var workflowIdResolver = {
   })
 };
 
+// src/resolvers/durableRunId.ts
+var durableRunIdResolver = {
+  type: "dynamic",
+  fetch: async (sdk) => toIterable(sdk.listDurableRuns()),
+  prompt: (runs) => ({
+    type: "list",
+    name: "run",
+    message: "Select a run:",
+    choices: runs.map((run) => ({
+      name: `${run.id} \u2014 ${run.status}`,
+      value: run.id
+    }))
+  })
+};
+
 // src/resolvers/triggerMessages.ts
 var triggerMessagesResolver = {
   type: "dynamic",
@@ -10824,6 +10839,305 @@ var deleteWorkflowPlugin = definePlugin(
     }
   })
 );
+var RunStatusSchema = zod.z.enum(["initialized", "started", "finished", "failed", "cancelled"]).describe(
+  "Run lifecycle status. `finished` / `failed` / `cancelled` are terminal."
+);
+var RunErrorSchema = zod.z.object({
+  code: zod.z.string().describe("Machine-readable error category"),
+  message: zod.z.string().describe("Human-readable error summary")
+}).passthrough().describe(
+  "Structured run error. Always carries `code` and `message`; additional keys may appear depending on the error type."
+);
+var RunItemSchema = zod.z.object({
+  id: zod.z.string().describe("Run ID (UUID)"),
+  status: RunStatusSchema,
+  input: zod.z.unknown().describe("Input data passed to the run"),
+  output: zod.z.unknown().nullable().describe("Return value, present when status is `finished`"),
+  error: RunErrorSchema.nullable().describe(
+    "Structured error details when the run failed (null otherwise)"
+  ),
+  execution_id: zod.z.string().nullable().describe(
+    "Linked execution ID. Null until the run leaves the `initialized` state."
+  ),
+  is_private: zod.z.boolean().describe(
+    "When true, the run is visible only to the creating user; otherwise visible across the account."
+  ),
+  created_at: zod.z.string().describe("When the run was created (ISO-8601)"),
+  updated_at: zod.z.string().describe("When the run was last updated (ISO-8601)")
+});
+var ListDurableRunsOptionsSchema = zod.z.object({
+  pageSize: zod.z.number().min(1).max(100).optional().describe("Number of runs per page (max 100)"),
+  cursor: zod.z.string().optional().describe("Pagination cursor"),
+  maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages")
+}).describe(
+  "List run-once durable runs for the authenticated account, newest first"
+);
+zod.z.object({
+  results: zod.z.array(RunItemSchema),
+  meta: zod.z.object({
+    limit: zod.z.number(),
+    cursor: zod.z.string().nullable().optional(),
+    next_cursor: zod.z.string().nullable().optional()
+  }),
+  links: zod.z.object({
+    next: zod.z.string().nullable().optional()
+  }).optional()
+});
+
+// src/plugins/codeSubstrate/listDurableRuns/index.ts
+var listDurableRunsPlugin = definePlugin(
+  (sdk) => createPaginatedPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "listDurableRuns",
+    type: "list",
+    itemType: "DurableRun",
+    inputSchema: ListDurableRunsOptionsSchema,
+    outputSchema: RunItemSchema,
+    defaultPageSize: DEFAULT_PAGE_SIZE,
+    handler: async ({ sdk: sdk2, options }) => {
+      const searchParams = {};
+      if (options.pageSize !== void 0) {
+        searchParams.limit = options.pageSize.toString();
+      }
+      if (options.cursor) {
+        searchParams.cursor = options.cursor;
+      }
+      const response = await sdk2.context.api.get(
+        "/sdkdurableapi/api/v0/runs",
+        { searchParams, authRequired: true }
+      );
+      return {
+        data: response.results,
+        nextCursor: response.meta.next_cursor ?? void 0
+      };
+    }
+  })
+);
+var OperationTypeSchema = zod.z.enum(["step", "wait", "callback"]).describe(
+  "Operation kind: `step` is a journaled function call; `wait` is a time-based suspension; `callback` is a wait on an external callback."
+);
+var OperationStatusSchema = zod.z.enum(["pending", "completed", "failed", "exhausted"]).describe(
+  "Operation lifecycle status. `exhausted` means retries were exceeded."
+);
+var OperationSchema = zod.z.object({
+  id: zod.z.string().describe("Operation ID (UUID)"),
+  execution_id: zod.z.string().describe("Parent execution ID"),
+  name: zod.z.string().describe("Operation name as declared by the workflow author"),
+  type: OperationTypeSchema,
+  status: OperationStatusSchema,
+  result: zod.z.unknown().optional().describe("Result value when the operation completed"),
+  error: zod.z.unknown().optional().describe("Error payload when the operation failed"),
+  retry_count: zod.z.number().describe("Number of retry attempts so far"),
+  max_attempts: zod.z.number().optional().describe(
+    "Cap on total attempts for this operation. Absent if no cap applies."
+  ),
+  next_retry_at: zod.z.string().optional().describe("When the next retry will be attempted (ISO-8601)"),
+  resume_at: zod.z.string().optional().describe(
+    "When a `wait` operation resumes (ISO-8601). Set only for type=wait."
+  ),
+  callback_token: zod.z.string().nullable().optional().describe(
+    "Token for delivering a callback. Set only for type=callback; null until the callback URL is materialized."
+  ),
+  payload_schema: zod.z.unknown().optional().describe("JSON Schema describing the expected callback payload"),
+  payload: zod.z.unknown().optional().describe("Payload delivered to a callback operation, when received"),
+  expires_at: zod.z.string().optional().describe("When a callback or wait operation expires (ISO-8601)"),
+  completed_at: zod.z.string().optional().describe("When the operation reached a terminal state (ISO-8601)"),
+  created_at: zod.z.string().describe("When the operation was created (ISO-8601)")
+});
+var ExecutionStatusSchema = zod.z.enum(["running", "waiting", "completed", "failed"]).describe(
+  "Execution lifecycle status. `waiting` means blocked on a wait or callback operation."
+);
+var ExecutionSummarySchema = zod.z.object({
+  id: zod.z.string().describe("Execution ID (UUID)"),
+  name: zod.z.string().describe("Durable function name"),
+  status: ExecutionStatusSchema,
+  input: zod.z.unknown().describe("Input passed when the execution was created"),
+  output: zod.z.unknown().optional().describe("Return value when status is `completed`"),
+  error: zod.z.unknown().optional().describe("Error details when status is `failed`"),
+  metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe(
+    "Caller-supplied tags (Zap ID, Step ID, Agent ID, etc.) carried alongside the execution"
+  ),
+  created_at: zod.z.string().describe("When the execution was created (ISO-8601)"),
+  summary: zod.z.object({
+    total_attempts: zod.z.number().describe(
+      "Total ticks attempted against this execution across all retries"
+    ),
+    last_error: zod.z.object({
+      code: zod.z.string().describe("Machine-readable error category"),
+      title: zod.z.string().describe("Short error label"),
+      detail: zod.z.string().nullable().optional().describe("Longer-form error detail, when provided")
+    }).passthrough().optional().describe("The most recent error, if the execution has failed once")
+  }).passthrough().nullable().optional().describe(
+    "Aggregate health summary. Null when no attempts have been recorded yet."
+  ),
+  operations: zod.z.array(OperationSchema).optional().describe(
+    "Operations journal \u2014 append-only record of every step/wait/callback the execution made"
+  )
+});
+var GetDurableRunOptionsSchema = zod.z.object({
+  run: zod.z.string().uuid().describe("Durable run ID")
+}).describe(
+  "Get the full state of a run-once durable run, including its operations journal"
+);
+var GetDurableRunResponseSchema = zod.z.object({
+  id: zod.z.string().describe("Run ID (UUID)"),
+  status: RunStatusSchema,
+  input: zod.z.unknown().describe("Input data passed to the run"),
+  output: zod.z.unknown().nullable().describe("Return value, present when status is `finished`"),
+  error: RunErrorSchema.nullable().describe(
+    "Structured error details when the run failed (null otherwise)"
+  ),
+  execution: ExecutionSummarySchema.nullable().describe(
+    "Linked execution, including the operations journal. Null while the run is still in `initialized` state."
+  ),
+  is_private: zod.z.boolean().describe(
+    "When true, the run is visible only to the creating user; otherwise visible across the account."
+  ),
+  created_at: zod.z.string().describe("When the run was created (ISO-8601)"),
+  updated_at: zod.z.string().describe("When the run was last updated (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/getDurableRun/index.ts
+var getDurableRunPlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "getDurableRun",
+    type: "item",
+    itemType: "DurableRun",
+    inputSchema: GetDurableRunOptionsSchema,
+    outputSchema: GetDurableRunResponseSchema,
+    resolvers: { run: durableRunIdResolver },
+    handler: async ({ sdk: sdk2, options }) => {
+      const data = await sdk2.context.api.get(
+        `/sdkdurableapi/api/v0/runs/${encodeURIComponent(options.run)}`,
+        {
+          authRequired: true,
+          resource: { type: "run", id: options.run }
+        }
+      );
+      return { data };
+    }
+  })
+);
+var ConnectionMapEntrySchema = zod.z.object({
+  connection_id: zod.z.union([
+    zod.z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
+    zod.z.string().uuid("must be a UUID"),
+    zod.z.number().int().positive()
+  ]).describe(
+    "Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections)."
+  )
+});
+var AppVersionMapEntrySchema = zod.z.object({
+  implementation_name: zod.z.string().min(1).describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
+  version: zod.z.string().optional().describe("Pinned app version (e.g. `1.27.1`). Latest if omitted.")
+});
+var RunDurableOptionsSchema = zod.z.object({
+  source_files: zod.z.record(zod.z.string(), zod.z.string()).refine((files) => Object.keys(files).length > 0, {
+    message: "source_files must contain at least one file"
+  }).describe("Source files keyed by filename \u2192 contents"),
+  input: zod.z.unknown().optional().describe("Input data passed to the run"),
+  dependencies: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Optional npm package dependencies"),
+  zapier_durable_version: zod.z.string().optional().describe(
+    'Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.'
+  ),
+  connections: zod.z.record(zod.z.string(), ConnectionMapEntrySchema).optional().describe(
+    "Named connection aliases. Maps alias names to Zapier connection IDs."
+  ),
+  app_versions: zod.z.record(zod.z.string(), AppVersionMapEntrySchema).optional().describe(
+    "Pinned app versions. Maps app keys (slugs) to implementation names and versions."
+  ),
+  private: zod.z.boolean().optional().describe("Only the creating user can see the run (default false)")
+}).describe(
+  "Run a workflow source file as a run-once durable run on sdkdurableapi (no deployed workflow required). Returns the run ID immediately; poll via getDurableRun for terminal status."
+);
+var RunDurableResponseSchema = zod.z.object({
+  id: zod.z.string().describe("Run ID (UUID) \u2014 server-generated, time-sortable"),
+  status: zod.z.literal("initialized").describe(
+    "Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`."
+  ),
+  is_private: zod.z.boolean().describe(
+    "When true, the run is visible only to the creating user; otherwise visible across the account."
+  ),
+  created_at: zod.z.string().describe("When the run was created (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/runDurable/index.ts
+var runDurablePlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "runDurable",
+    type: "create",
+    itemType: "DurableRun",
+    inputSchema: RunDurableOptionsSchema,
+    outputSchema: RunDurableResponseSchema,
+    handler: async ({ sdk: sdk2, options }) => {
+      const body = {
+        source_files: options.source_files
+      };
+      if (options.input !== void 0) {
+        body.input = options.input;
+      }
+      if (options.dependencies !== void 0) {
+        body.dependencies = options.dependencies;
+      }
+      if (options.zapier_durable_version !== void 0) {
+        body.zapier_durable_version = options.zapier_durable_version;
+      }
+      if (options.connections !== void 0) {
+        body.connections = options.connections;
+      }
+      if (options.app_versions !== void 0) {
+        body.app_versions = options.app_versions;
+      }
+      if (options.private !== void 0) {
+        body.is_private = options.private;
+      }
+      const data = await sdk2.context.api.post(
+        "/sdkdurableapi/api/v0/runs",
+        body,
+        { authRequired: true }
+      );
+      return { data };
+    }
+  })
+);
+var CancelDurableRunOptionsSchema = zod.z.object({
+  run: zod.z.string().uuid().describe("Durable run ID")
+}).describe(
+  "Cancel a run-once durable run in initialized or started status. Returns 409 if the run is already terminal."
+);
+zod.z.object({
+  id: zod.z.string().describe("Run ID that was targeted"),
+  status: zod.z.literal("cancelled").describe(
+    "Always `cancelled` on a successful call. Synthesized client-side \u2014 the backend returns 204; callers needing the run's full state should follow up with getDurableRun."
+  )
+});
+
+// src/plugins/codeSubstrate/cancelDurableRun/index.ts
+var cancelDurableRunPlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "cancelDurableRun",
+    type: "update",
+    itemType: "DurableRun",
+    inputSchema: CancelDurableRunOptionsSchema,
+    resolvers: { run: durableRunIdResolver },
+    handler: async ({ sdk: sdk2, options }) => {
+      await sdk2.context.api.post(
+        `/sdkdurableapi/api/v0/runs/${encodeURIComponent(options.run)}/cancel`,
+        void 0,
+        {
+          authRequired: true,
+          resource: { type: "run", id: options.run }
+        }
+      );
+      return {
+        data: { id: options.run, status: "cancelled" }
+      };
+    }
+  })
+);
 
 // src/utils/batch-utils.ts
 var DEFAULT_CONCURRENCY = 10;
@@ -10983,7 +11297,7 @@ var registryPlugin = definePlugin((_sdk) => {
 
 // src/experimental.ts
 function createZapierSdk2(options = {}) {
-  return createSdk().addPlugin(createOptionsPlugin(options)).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listActionInputFieldsPlugin).addPlugin(getActionInputFieldsSchemaPlugin).addPlugin(listActionInputFieldChoicesPlugin).addPlugin(listInputFieldsDeprecatedPlugin).addPlugin(getInputFieldsSchemaDeprecatedPlugin).addPlugin(listInputFieldChoicesDeprecatedPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(createTriggerInboxPlugin).addPlugin(ensureTriggerInboxPlugin).addPlugin(listTriggerInboxesPlugin).addPlugin(getTriggerInboxPlugin).addPlugin(updateTriggerInboxPlugin).addPlugin(deleteTriggerInboxPlugin).addPlugin(pauseTriggerInboxPlugin).addPlugin(resumeTriggerInboxPlugin).addPlugin(listTriggerInboxMessagesPlugin).addPlugin(leaseTriggerInboxMessagesPlugin).addPlugin(ackTriggerInboxMessagesPlugin).addPlugin(releaseTriggerInboxMessagesPlugin).addPlugin(drainTriggerInboxPlugin).addPlugin(watchTriggerInboxPlugin).addPlugin(listTriggersPlugin).addPlugin(listTriggerInputFieldsPlugin).addPlugin(listTriggerInputFieldChoicesPlugin).addPlugin(getTriggerInputFieldsSchemaPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(listWorkflowsPlugin).addPlugin(getWorkflowPlugin).addPlugin(createWorkflowPlugin).addPlugin(updateWorkflowPlugin).addPlugin(enableWorkflowPlugin).addPlugin(disableWorkflowPlugin).addPlugin(deleteWorkflowPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
+  return createSdk().addPlugin(createOptionsPlugin(options)).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listActionInputFieldsPlugin).addPlugin(getActionInputFieldsSchemaPlugin).addPlugin(listActionInputFieldChoicesPlugin).addPlugin(listInputFieldsDeprecatedPlugin).addPlugin(getInputFieldsSchemaDeprecatedPlugin).addPlugin(listInputFieldChoicesDeprecatedPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(createTriggerInboxPlugin).addPlugin(ensureTriggerInboxPlugin).addPlugin(listTriggerInboxesPlugin).addPlugin(getTriggerInboxPlugin).addPlugin(updateTriggerInboxPlugin).addPlugin(deleteTriggerInboxPlugin).addPlugin(pauseTriggerInboxPlugin).addPlugin(resumeTriggerInboxPlugin).addPlugin(listTriggerInboxMessagesPlugin).addPlugin(leaseTriggerInboxMessagesPlugin).addPlugin(ackTriggerInboxMessagesPlugin).addPlugin(releaseTriggerInboxMessagesPlugin).addPlugin(drainTriggerInboxPlugin).addPlugin(watchTriggerInboxPlugin).addPlugin(listTriggersPlugin).addPlugin(listTriggerInputFieldsPlugin).addPlugin(listTriggerInputFieldChoicesPlugin).addPlugin(getTriggerInputFieldsSchemaPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(listWorkflowsPlugin).addPlugin(getWorkflowPlugin).addPlugin(createWorkflowPlugin).addPlugin(updateWorkflowPlugin).addPlugin(enableWorkflowPlugin).addPlugin(disableWorkflowPlugin).addPlugin(deleteWorkflowPlugin).addPlugin(listDurableRunsPlugin).addPlugin(getDurableRunPlugin).addPlugin(runDurablePlugin).addPlugin(cancelDurableRunPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 
 exports.ActionKeyPropertySchema = ActionKeyPropertySchema;
@@ -11097,6 +11411,7 @@ exports.deleteClientCredentialsPlugin = deleteClientCredentialsPlugin;
 exports.deleteTableFieldsPlugin = deleteTableFieldsPlugin;
 exports.deleteTablePlugin = deleteTablePlugin;
 exports.deleteTableRecordsPlugin = deleteTableRecordsPlugin;
+exports.durableRunIdResolver = durableRunIdResolver;
 exports.eventEmissionPlugin = eventEmissionPlugin;
 exports.fetchPlugin = fetchPlugin;
 exports.findFirstConnectionPlugin = findFirstConnectionPlugin;