@zapier/zapier-sdk 0.62.0 → 0.63.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @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

package/README.md

@@ -27,6 +27,7 @@
   - [`deleteClientCredentials`](#deleteclientcredentials)
   - [`listClientCredentials`](#listclientcredentials)
 - [Code Workflows (Experimental)](#code-workflows-experimental)
+  - [`cancelDurableRun`](#canceldurablerun--experimental)
   - [`createWorkflow`](#createworkflow--experimental)
   - [`deleteWorkflow`](#deleteworkflow--experimental)
   - [`disableWorkflow`](#disableworkflow--experimental)
@@ -35,6 +36,7 @@
   - [`getWorkflow`](#getworkflow--experimental)
   - [`listDurableRuns`](#listdurableruns--experimental)
   - [`listWorkflows`](#listworkflows--experimental)
+  - [`runDurable`](#rundurable--experimental)
   - [`updateWorkflow`](#updateworkflow--experimental)
 - [Connections](#connections)
   - [`findFirstConnection`](#findfirstconnection)
@@ -1094,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.
@@ -1366,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.62.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:";
@@ -11019,6 +11019,125 @@ var getDurableRunPlugin = definePlugin(
     }
   })
 );
+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;
@@ -11178,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(listDurableRunsPlugin).addPlugin(getDurableRunPlugin).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;

package/dist/experimental.d.mts

@@ -2511,6 +2511,49 @@ declare function createZapierSdk(options?: ZapierSdkOptions): WithAddPlugin<{
             getDurableRun: PluginMeta;
         };
     };
+} & {
+    runDurable: (options?: {
+        source_files: Record<string, string>;
+        input?: unknown;
+        dependencies?: Record<string, string> | undefined;
+        zapier_durable_version?: string | undefined;
+        connections?: Record<string, {
+            connection_id: string | number;
+        }> | undefined;
+        app_versions?: Record<string, {
+            implementation_name: string;
+            version?: string | undefined;
+        }> | undefined;
+        private?: boolean | undefined;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "initialized";
+            is_private: boolean;
+            created_at: string;
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            runDurable: PluginMeta;
+        };
+    };
+} & {
+    cancelDurableRun: (options?: {
+        run: string;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "cancelled";
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            cancelDurableRun: PluginMeta;
+        };
+    };
 } & {
     apps: ActionProxy & ZapierSdkApps;
     context: {

package/dist/experimental.d.ts

@@ -2526,6 +2526,49 @@ export declare function createZapierSdk(options?: ZapierSdkOptions): import("./i
             getDurableRun: PluginMeta;
         };
     };
+} & {
+    runDurable: (options?: {
+        source_files: Record<string, string>;
+        input?: unknown;
+        dependencies?: Record<string, string> | undefined;
+        zapier_durable_version?: string | undefined;
+        connections?: Record<string, {
+            connection_id: string | number;
+        }> | undefined;
+        app_versions?: Record<string, {
+            implementation_name: string;
+            version?: string | undefined;
+        }> | undefined;
+        private?: boolean | undefined;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "initialized";
+            is_private: boolean;
+            created_at: string;
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            runDurable: PluginMeta;
+        };
+    };
+} & {
+    cancelDurableRun: (options?: {
+        run: string;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "cancelled";
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            cancelDurableRun: PluginMeta;
+        };
+    };
 } & {
     apps: import("./plugins/apps/schemas").ActionProxy & import("./index").ZapierSdkApps;
     context: {

package/dist/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiFjD,cAAc,SAAS,CAAC;AAExB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAE3D,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA0Gg5I,CAAC;;;;sBAAiX,CAAC;qBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAT11J;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAM3D,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"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"}

package/dist/experimental.js

@@ -85,6 +85,8 @@ import { disableWorkflowPlugin } from "./plugins/codeSubstrate/disableWorkflow";
 import { deleteWorkflowPlugin } from "./plugins/codeSubstrate/deleteWorkflow";
 import { listDurableRunsPlugin } from "./plugins/codeSubstrate/listDurableRuns";
 import { getDurableRunPlugin } from "./plugins/codeSubstrate/getDurableRun";
+import { runDurablePlugin } from "./plugins/codeSubstrate/runDurable";
+import { cancelDurableRunPlugin } from "./plugins/codeSubstrate/cancelDurableRun";
 // Re-export everything from the stable index so callers importing from
 // the experimental subpath get the full API surface (types, helpers,
 // errors) without having to import from two paths.
@@ -169,6 +171,8 @@ export function createZapierSdk(options = {}) {
         .addPlugin(deleteWorkflowPlugin)
         .addPlugin(listDurableRunsPlugin)
         .addPlugin(getDurableRunPlugin)
+        .addPlugin(runDurablePlugin)
+        .addPlugin(cancelDurableRunPlugin)
         // Magic apps plugin
         .addPlugin(appsPlugin)
         // Profile

package/dist/experimental.mjs

@@ -2887,7 +2887,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.62.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:";
@@ -11017,6 +11017,125 @@ var getDurableRunPlugin = definePlugin(
     }
   })
 );
+var ConnectionMapEntrySchema = z.object({
+  connection_id: z.union([
+    z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
+    z.string().uuid("must be a UUID"),
+    z.number().int().positive()
+  ]).describe(
+    "Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections)."
+  )
+});
+var AppVersionMapEntrySchema = z.object({
+  implementation_name: z.string().min(1).describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
+  version: z.string().optional().describe("Pinned app version (e.g. `1.27.1`). Latest if omitted.")
+});
+var RunDurableOptionsSchema = z.object({
+  source_files: z.record(z.string(), 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: z.unknown().optional().describe("Input data passed to the run"),
+  dependencies: z.record(z.string(), z.string()).optional().describe("Optional npm package dependencies"),
+  zapier_durable_version: 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: z.record(z.string(), ConnectionMapEntrySchema).optional().describe(
+    "Named connection aliases. Maps alias names to Zapier connection IDs."
+  ),
+  app_versions: z.record(z.string(), AppVersionMapEntrySchema).optional().describe(
+    "Pinned app versions. Maps app keys (slugs) to implementation names and versions."
+  ),
+  private: 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 = z.object({
+  id: z.string().describe("Run ID (UUID) \u2014 server-generated, time-sortable"),
+  status: z.literal("initialized").describe(
+    "Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`."
+  ),
+  is_private: z.boolean().describe(
+    "When true, the run is visible only to the creating user; otherwise visible across the account."
+  ),
+  created_at: 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 = z.object({
+  run: 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."
+);
+z.object({
+  id: z.string().describe("Run ID that was targeted"),
+  status: 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;
@@ -11176,7 +11295,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(listDurableRunsPlugin).addPlugin(getDurableRunPlugin).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);
 }
 
 export { ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_APPROVAL_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DebugPropertySchema, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MAX_CONCURRENCY_LIMIT, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, TablePropertySchema, TablesPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, ZAPIER_BASE_URL, ZAPIER_MAX_CONCURRENT_REQUESTS, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, cleanupEventListeners, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, composePlugins, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, createBaseEvent, createClientCredentialsPlugin, createFunction, createMemoryCache, createOptionsPlugin, createPaginatedPluginMethod, createPluginMethod, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdk2 as createZapierSdk, createZapierSdkWithoutRegistry, definePlugin, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, durableRunIdResolver, eventEmissionPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getZapierApprovalMode, getZapierDefaultApprovalMode, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, parseConcurrencyEnvVar, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, triggerInboxResolver, triggerMessagesResolver, updateTableRecordsPlugin, workflowIdResolver };

package/dist/index.cjs

@@ -6354,7 +6354,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.62.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:";

package/dist/index.mjs

@@ -6352,7 +6352,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.62.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:";

package/dist/plugins/codeSubstrate/cancelDurableRun/index.d.ts

@@ -0,0 +1,40 @@
+export declare const cancelDurableRunPlugin: (sdk: {
+    context: {
+        api: import("../../..").ApiClient;
+        resolveCredentials: () => Promise<string | {
+            clientId: string;
+            clientSecret: string;
+            type?: "client_credentials" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | {
+            clientId: string;
+            type?: "pkce" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | undefined>;
+    };
+} & {
+    context: import("../../eventEmission").EventEmissionContext;
+} & {
+    context: {
+        meta: Record<string, import("../../..").PluginMeta>;
+    };
+}) => {
+    cancelDurableRun: (options?: {
+        run: string;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "cancelled";
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            cancelDurableRun: import("../../..").PluginMeta;
+        };
+    };
+};
+export type CancelDurableRunPluginProvides = ReturnType<typeof cancelDurableRunPlugin>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/codeSubstrate/cancelDurableRun/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/cancelDurableRun/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,UAAU,CACrD,OAAO,sBAAsB,CAC9B,CAAC"}

package/dist/plugins/codeSubstrate/cancelDurableRun/index.js

@@ -0,0 +1,27 @@
+import { definePlugin, createPluginMethod } from "../../../utils/plugin-utils";
+import { durableRunIdResolver } from "../../../resolvers/durableRunId";
+import { codeSubstrateDefaults } from "../shared";
+import { CancelDurableRunOptionsSchema } from "./schemas";
+export const cancelDurableRunPlugin = definePlugin((sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "cancelDurableRun",
+    type: "update",
+    itemType: "DurableRun",
+    inputSchema: CancelDurableRunOptionsSchema,
+    resolvers: { run: durableRunIdResolver },
+    handler: async ({ sdk, options }) => {
+        // Backend returns 204 on success. 404 (run missing) and 409 (run
+        // already terminal) propagate as their respective ZapierErrors so
+        // callers can distinguish — we don't soft-fold them into a status
+        // enum the way deleteWorkflow does, because cancelling an
+        // already-terminal run is a meaningfully different outcome that
+        // callers may want to surface to users.
+        await sdk.context.api.post(`/sdkdurableapi/api/v0/runs/${encodeURIComponent(options.run)}/cancel`, undefined, {
+            authRequired: true,
+            resource: { type: "run", id: options.run },
+        });
+        return {
+            data: { id: options.run, status: "cancelled" },
+        };
+    },
+}));

package/dist/plugins/codeSubstrate/cancelDurableRun/schemas.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const CancelDurableRunOptionsSchema: z.ZodObject<{
+    run: z.ZodString;
+}, z.core.$strip>;
+export type CancelDurableRunOptions = z.infer<typeof CancelDurableRunOptionsSchema>;
+export declare const CancelDurableRunResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodLiteral<"cancelled">;
+}, z.core.$strip>;
+export type CancelDurableRunResponse = z.infer<typeof CancelDurableRunResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/plugins/codeSubstrate/cancelDurableRun/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/cancelDurableRun/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,6BAA6B;;iBAMvC,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;iBAOzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC"}

package/dist/plugins/codeSubstrate/cancelDurableRun/schemas.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export const CancelDurableRunOptionsSchema = z
+    .object({
+    run: 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.");
+export const CancelDurableRunResponseSchema = z.object({
+    id: z.string().describe("Run ID that was targeted"),
+    status: z
+        .literal("cancelled")
+        .describe("Always `cancelled` on a successful call. Synthesized client-side — the backend returns 204; callers needing the run's full state should follow up with getDurableRun."),
+});

package/dist/plugins/codeSubstrate/runDurable/index.d.ts

@@ -0,0 +1,53 @@
+export declare const runDurablePlugin: (sdk: {
+    context: {
+        api: import("../../..").ApiClient;
+        resolveCredentials: () => Promise<string | {
+            clientId: string;
+            clientSecret: string;
+            type?: "client_credentials" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | {
+            clientId: string;
+            type?: "pkce" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | undefined>;
+    };
+} & {
+    context: import("../../eventEmission").EventEmissionContext;
+} & {
+    context: {
+        meta: Record<string, import("../../..").PluginMeta>;
+    };
+}) => {
+    runDurable: (options?: {
+        source_files: Record<string, string>;
+        input?: unknown;
+        dependencies?: Record<string, string> | undefined;
+        zapier_durable_version?: string | undefined;
+        connections?: Record<string, {
+            connection_id: string | number;
+        }> | undefined;
+        app_versions?: Record<string, {
+            implementation_name: string;
+            version?: string | undefined;
+        }> | undefined;
+        private?: boolean | undefined;
+    } | undefined) => Promise<{
+        data: {
+            id: string;
+            status: "initialized";
+            is_private: boolean;
+            created_at: string;
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            runDurable: import("../../..").PluginMeta;
+        };
+    };
+};
+export type RunDurablePluginProvides = ReturnType<typeof runDurablePlugin>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/codeSubstrate/runDurable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/runDurable/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/plugins/codeSubstrate/runDurable/index.js

@@ -0,0 +1,36 @@
+import { definePlugin, createPluginMethod } from "../../../utils/plugin-utils";
+import { codeSubstrateDefaults } from "../shared";
+import { RunDurableOptionsSchema, RunDurableResponseSchema, } from "./schemas";
+export const runDurablePlugin = definePlugin((sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "runDurable",
+    type: "create",
+    itemType: "DurableRun",
+    inputSchema: RunDurableOptionsSchema,
+    outputSchema: RunDurableResponseSchema,
+    handler: async ({ sdk, options }) => {
+        const body = {
+            source_files: options.source_files,
+        };
+        if (options.input !== undefined) {
+            body.input = options.input;
+        }
+        if (options.dependencies !== undefined) {
+            body.dependencies = options.dependencies;
+        }
+        if (options.zapier_durable_version !== undefined) {
+            body.zapier_durable_version = options.zapier_durable_version;
+        }
+        if (options.connections !== undefined) {
+            body.connections = options.connections;
+        }
+        if (options.app_versions !== undefined) {
+            body.app_versions = options.app_versions;
+        }
+        if (options.private !== undefined) {
+            body.is_private = options.private;
+        }
+        const data = await sdk.context.api.post("/sdkdurableapi/api/v0/runs", body, { authRequired: true });
+        return { data };
+    },
+}));

package/dist/plugins/codeSubstrate/runDurable/schemas.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export declare const RunDurableOptionsSchema: z.ZodObject<{
+    source_files: z.ZodRecord<z.ZodString, z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    connections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connection_id: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>;
+    }, z.core.$strip>>>;
+    app_versions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementation_name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    private: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RunDurableOptions = z.infer<typeof RunDurableOptionsSchema>;
+export declare const RunDurableResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodLiteral<"initialized">;
+    is_private: z.ZodBoolean;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type RunDurableResponse = z.infer<typeof RunDurableResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/plugins/codeSubstrate/runDurable/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/runDurable/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAsCjC,CAAC;AAEJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;;;iBAanC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/plugins/codeSubstrate/runDurable/schemas.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+const ConnectionMapEntrySchema = z.object({
+    connection_id: z
+        .union([
+        z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
+        z.string().uuid("must be a UUID"),
+        z.number().int().positive(),
+    ])
+        .describe("Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections)."),
+});
+const AppVersionMapEntrySchema = z.object({
+    implementation_name: z
+        .string()
+        .min(1)
+        .describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
+    version: z
+        .string()
+        .optional()
+        .describe("Pinned app version (e.g. `1.27.1`). Latest if omitted."),
+});
+export const RunDurableOptionsSchema = z
+    .object({
+    source_files: z
+        .record(z.string(), z.string())
+        .refine((files) => Object.keys(files).length > 0, {
+        message: "source_files must contain at least one file",
+    })
+        .describe("Source files keyed by filename → contents"),
+    input: z.unknown().optional().describe("Input data passed to the run"),
+    dependencies: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Optional npm package dependencies"),
+    zapier_durable_version: 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: z
+        .record(z.string(), ConnectionMapEntrySchema)
+        .optional()
+        .describe("Named connection aliases. Maps alias names to Zapier connection IDs."),
+    app_versions: z
+        .record(z.string(), AppVersionMapEntrySchema)
+        .optional()
+        .describe("Pinned app versions. Maps app keys (slugs) to implementation names and versions."),
+    private: 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.");
+export const RunDurableResponseSchema = z.object({
+    id: z.string().describe("Run ID (UUID) — server-generated, time-sortable"),
+    status: z
+        .literal("initialized")
+        .describe("Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`."),
+    is_private: z
+        .boolean()
+        .describe("When true, the run is visible only to the creating user; otherwise visible across the account."),
+    created_at: z.string().describe("When the run was created (ISO-8601)"),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.62.0",
+  "version": "0.63.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",