@zapier/zapier-sdk 0.109.1 → 0.110.1

package/dist/experimental.mjs

@@ -1,5 +1,5 @@
-import { DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, extractErrorDetail, ZapierApiError, durableRunIdResolver, ZapierConflictError, workflowVersionIdResolver, workflowDraftIdResolver, workflowRunIdResolver, zapierSdkPlugin, ZapierValidationError, ZapierConfigurationError, zapierCoreOptions, SDK_OPTIONS_ID } from './chunk-6TOSNLPZ.mjs';
-export { ACTION_RUNS_PATH, API_ID, ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMillisecondsPropertySchema, ActionTimeoutSecondsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthMechanism, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONNECTIONS_ID, CONTEXT, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MILLISECONDS, CORE_ERROR_SYMBOL, CORE_OPTIONS_ID, CORE_SIGNAL_SYMBOL, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CoreCancelledSignal, CoreDisposeError, CoreErrorCode, CoreSignal, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MILLISECONDS, DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DEPRECATION_NOTICE_EVENT, DebugPropertySchema, DrainTriggerInboxSchema, EVENT_EMISSION_ID, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MANIFEST_ID, MAX_CONCURRENCY_LIMIT, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RESOLVE_CREDENTIALS_ID, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, SDK_OPTIONS_ID, TablePropertySchema, TablesPropertySchema, TriggerInboxKeyPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, WatchTriggerInboxSchema, ZAPIER_BASE_URL, ZAPIER_MAX_CONCURRENT_REQUESTS, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, addPlugin, apiPlugin, apiPluginRef, appKeyResolver, appsPlugin, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, cleanupEventListeners, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, composePlugins, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, connectionsPluginRef, createActionRunPlugin, createBaseEvent, createClientCredentialsPlugin, createController, createCorePlugin, createFunction, createMemoryCache, createPaginatedFunction, createPaginatedPluginMethod, createPluginMethod, createPluginStack, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdkWithoutRegistry, declareMethod, declareOptionalProperty, declarePlugin, declareProperty, defineFormatter, defineLegacyMerge, defineMethod, defineMethodOverride, defineOverride, definePlugin, defineProperty, defineResolver, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, disposeSdk, durableRunIdResolver, eventEmissionHookPlugin, eventEmissionPlugin, eventEmissionPluginRef, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, fromFunctionPlugin, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getActionRunPlugin, getAgent, getAppPlugin, getBaseUrlFromCredentials, getCallerContext, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getContext, getCoreErrorCause, getCoreErrorCode, getCpuTime, getCurrentTimestamp, getMemoryUsage, getNegatable, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getRegistryPlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getTtyContext, getZapierApprovalMode, getZapierCausationId, getZapierCorrelationId, getZapierDefaultApprovalMode, getZapierOpenAutoModeApprovalsInBrowser, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCoreCancelledSignal, isCoreError, isCoreSignal, isCredentialsFunction, isCredentialsObject, isPermanentHttpError, isPkceCredentials, isPositional, isZapierAbortDrainSignal, isZapierActionError, isZapierAppNotFoundError, isZapierApprovalError, isZapierAuthenticationError, isZapierBundleError, isZapierConflictError, isZapierError, isZapierNotFoundError, isZapierRateLimitError, isZapierReleaseTriggerMessageSignal, isZapierResourceNotFoundError, isZapierSignal, isZapierTimeoutError, isZapierValidationError, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, manifestPluginRef, omitExports, operationAnnotatorPlugin, parseConcurrencyEnvVar, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuth, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, resolveCredentialsPlugin, resolveCredentialsPluginRef, resolvePlugin, runActionPlugin, runInMethodScope, runWithCallerContext, runWithTelemetryContext, sdkOptionsPluginRef, selectExports, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, triggerInboxResolver, triggerMessagesResolver, updateTableRecordsPlugin, workflowDraftIdResolver, workflowIdResolver, workflowRunIdResolver, workflowVersionIdResolver, zapierAdaptError, zapierCoreOptions, zapierSdkPlugin } from './chunk-6TOSNLPZ.mjs';
+import { DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, extractErrorDetail, ZapierApiError, durableRunIdResolver, ZapierConflictError, workflowVersionIdResolver, workflowDraftIdResolver, workflowDraftRevisionResolver, workflowRunIdResolver, zapierSdkPlugin, ZapierValidationError, ZapierConfigurationError, zapierCoreOptions, SDK_OPTIONS_ID } from './chunk-IRHF55YK.mjs';
+export { ACTION_RUNS_PATH, API_ID, ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMillisecondsPropertySchema, ActionTimeoutSecondsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthMechanism, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONNECTIONS_ID, CONTEXT, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MILLISECONDS, CORE_ERROR_SYMBOL, CORE_OPTIONS_ID, CORE_SIGNAL_SYMBOL, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CoreCancelledSignal, CoreDisposeError, CoreErrorCode, CoreSignal, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MILLISECONDS, DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DEPRECATION_NOTICE_EVENT, DebugPropertySchema, DrainTriggerInboxSchema, EVENT_EMISSION_ID, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MANIFEST_ID, MAX_CONCURRENCY_LIMIT, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RESOLVE_CREDENTIALS_ID, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, SDK_OPTIONS_ID, TablePropertySchema, TablesPropertySchema, TriggerInboxKeyPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, WatchTriggerInboxSchema, ZAPIER_BASE_URL, ZAPIER_MAX_CONCURRENT_REQUESTS, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, addPlugin, apiPlugin, apiPluginRef, appKeyResolver, appsPlugin, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, cleanupEventListeners, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, composePlugins, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, connectionsPluginRef, createActionRunPlugin, createBaseEvent, createClientCredentialsPlugin, createController, createCorePlugin, createFunction, createMemoryCache, createPaginatedFunction, createPaginatedPluginMethod, createPluginMethod, createPluginStack, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdkWithoutRegistry, declareMethod, declareOptionalProperty, declarePlugin, declareProperty, defineFormatter, defineLegacyMerge, defineMethod, defineMethodOverride, defineOverride, definePlugin, defineProperty, defineResolver, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, disposeSdk, durableRunIdResolver, eventEmissionHookPlugin, eventEmissionPlugin, eventEmissionPluginRef, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, fromFunctionPlugin, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getActionRunPlugin, getAgent, getAppPlugin, getBaseUrlFromCredentials, getCallerContext, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getContext, getCoreErrorCause, getCoreErrorCode, getCpuTime, getCurrentTimestamp, getMemoryUsage, getNegatable, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getRegistryPlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getTtyContext, getZapierApprovalMode, getZapierCausationId, getZapierCorrelationId, getZapierDefaultApprovalMode, getZapierOpenAutoModeApprovalsInBrowser, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCoreCancelledSignal, isCoreError, isCoreSignal, isCredentialsFunction, isCredentialsObject, isPermanentHttpError, isPkceCredentials, isPositional, isZapierAbortDrainSignal, isZapierActionError, isZapierAppNotFoundError, isZapierApprovalError, isZapierAuthenticationError, isZapierBundleError, isZapierConflictError, isZapierError, isZapierNotFoundError, isZapierRateLimitError, isZapierReleaseTriggerMessageSignal, isZapierResourceNotFoundError, isZapierSignal, isZapierTimeoutError, isZapierValidationError, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, manifestPluginRef, omitExports, operationAnnotatorPlugin, parseConcurrencyEnvVar, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuth, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, resolveCredentialsPlugin, resolveCredentialsPluginRef, resolvePlugin, runActionPlugin, runInMethodScope, runWithCallerContext, runWithTelemetryContext, sdkOptionsPluginRef, selectExports, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, triggerInboxResolver, triggerMessagesResolver, updateTableRecordsPlugin, workflowDraftIdResolver, workflowDraftRevisionResolver, workflowIdResolver, workflowRunIdResolver, workflowVersionIdResolver, zapierAdaptError, zapierCoreOptions, zapierSdkPlugin } from './chunk-IRHF55YK.mjs';
 import './chunk-Y6FXYEAI.mjs';
 import { defineMethod, openEnum, defineResolver, defineFormatter, definePlugin, createSdk, CORE_OPTIONS_ID } from '@zapier/kitcore';
 import { z } from 'zod';
@@ -1730,32 +1730,45 @@ var WorkflowRunStatusSchema = z.union([
 ]).describe(
   "Workflow run lifecycle status. `finished` / `failed` / `cancelled` are terminal."
 );
-var WorkflowRunListItemSchema = z.object({
-  id: z.string().describe("Workflow run ID (UUID)"),
-  trigger_id: z.string().nullable().describe(
-    "ID of the trigger that fired this run, if any. Null for runs created without a trigger."
-  ),
+var workflowRunListItemBase = z.object({
+  id: z.string().describe("Workflow run ID (UUIDv7). Unique across live and draft runs."),
   durable_run_id: z.string().nullable().describe(
     "Linked code-substrate-runner run ID. Null until the durable run is created."
   ),
-  workflow_version_id: z.string().nullable().describe("Workflow version the run is bound to. Null in rare edge cases."),
   status: WorkflowRunStatusSchema,
   input: z.unknown().describe("Input passed to the run"),
-  // `output` is intentionally omitted from list items: workflow-run lists no
-  // longer carry the (potentially large/externalized) output payload. Fetch a
-  // single run's output via `getWorkflowRun`. Use `status` to know when it's
-  // available (`finished`/`failed`).
   error: z.unknown().nullable().describe("Error payload when status is `failed` (null otherwise)"),
   created_at: z.string().describe("When the run was created (ISO-8601)"),
   updated_at: z.string().describe("When the run was last updated (ISO-8601)")
 });
+var LiveWorkflowRunListItemSchema = workflowRunListItemBase.extend({
+  kind: z.literal("live").describe("A run of a published workflow version."),
+  trigger_id: z.string().nullable().describe(
+    "ID of the trigger that fired this run. Null for runs created without a trigger."
+  ),
+  workflow_version_id: z.string().nullable().describe("Workflow version the run is bound to. Null in rare edge cases.")
+});
+var DraftWorkflowRunListItemSchema = workflowRunListItemBase.extend({
+  kind: z.literal("draft").describe("A run launched from a workflow draft via `runWorkflowDraft`."),
+  workflow_draft_id: z.string().nullable().describe(
+    "The draft this run was launched from. Null once that draft has been deleted (the run outlives its draft)."
+  ),
+  draft_revision: z.number().int().describe("The draft's revision at the moment this run was created.")
+});
+var WorkflowRunListItemSchema = z.discriminatedUnion("kind", [
+  LiveWorkflowRunListItemSchema,
+  DraftWorkflowRunListItemSchema
+]);
 var ListWorkflowRunsOptionsSchema = z.object({
   workflow: z.string().uuid().describe("Durable workflow ID"),
   pageSize: z.number().int().min(1).max(100).optional().describe("Number of runs per page (max 100)"),
+  kind: z.enum(["live", "draft"]).optional().describe(
+    "Return only runs of this kind. Omit for both, interleaved by recency."
+  ),
   cursor: z.string().optional().describe("Pagination cursor"),
   maxItems: z.number().int().min(1).optional().describe("Maximum total runs to return across all pages")
 }).describe(
-  "List workflow runs (triggered executions) for a specific deployed workflow, newest first"
+  "List workflow runs for a specific workflow, newest first. Live runs (of published versions) and draft runs share the one list; pass `kind` to narrow it to one."
 );
 var ListWorkflowRunsApiResponseSchema = z.object({
   results: z.array(WorkflowRunListItemSchema),
@@ -1769,7 +1782,91 @@ var ListWorkflowRunsApiResponseSchema = z.object({
   }).optional()
 });
 
-// src/plugins/codeSubstrate/listWorkflowRuns/index.ts
+// src/plugins/codeSubstrate/runWorkflowDraft/schemas.ts
+var RunWorkflowDraftOptionsSchema = z.object({
+  workflow: z.string().uuid().describe("Durable workflow ID"),
+  draft: z.string().uuid().describe("Workflow draft ID"),
+  draftRevision: z.number().int().min(0).describe(
+    "The draft revision you intend to run, from the last read of the draft. The server rejects the run with a conflict if the draft has changed since. The upstream API treats this check as optional; the SDK requires it so a test run can never silently execute source the caller has already replaced."
+  ),
+  input: JsonPayloadSchema.optional().describe(
+    "Input data passed to the workflow. Accepts any JSON value, or its JSON-string encoding. Omit for a workflow that takes no input."
+  )
+}).describe(
+  "Launch a draft test run: execute the draft's current source without publishing it. The draft's payload is snapshotted onto the run at creation, so later edits (or discarding the draft) never change what the run executed. Draft runs are free (not task-charged) and rate limited per user. The run is accepted asynchronously \u2014 it comes back `initialized`; follow it with `getWorkflowRun`, or list it via `listWorkflowRuns` with `kind: \"draft\"`."
+);
+var RunWorkflowDraftResponseSchema = z.object({
+  id: z.string().describe("Workflow run ID (UUIDv7). Unique across live and draft runs."),
+  kind: z.literal("draft").describe("A run launched from a workflow draft."),
+  workflow_id: z.string().describe("The workflow this run belongs to"),
+  durable_run_id: z.string().nullable().describe(
+    "Linked code-substrate-runner run ID. Usually still null in this response \u2014 the run is accepted and launched in the background."
+  ),
+  workflow_draft_id: z.string().nullable().describe(
+    "The draft this run was launched from. Becomes null once that draft is deleted \u2014 the run outlives its draft."
+  ),
+  draft_revision: z.number().int().describe("The draft's revision at the moment this run was created."),
+  status: WorkflowRunStatusSchema,
+  input: z.unknown().describe("Input passed to the run"),
+  output: z.unknown().nullable().describe("Return value, present when status is `finished`"),
+  error: z.unknown().nullable().describe("Error payload when status is `failed` (null otherwise)"),
+  created_at: z.string().describe("When the run was created (ISO-8601)"),
+  updated_at: z.string().describe("When the run was last updated (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/runWorkflowDraft/index.ts
+var runWorkflowDraftPlugin = defineMethod({
+  ...codeSubstrateDefaults,
+  name: "runWorkflowDraft",
+  imports: [apiPluginRef],
+  type: "create",
+  itemType: "WorkflowRun",
+  // The response is the draft variant of the run resource (`kind: "draft"`,
+  // required `workflow_draft_id` / `draft_revision`), not the mixed-kind
+  // `WorkflowRun` item the docs generator derives from itemType.
+  returnType: "RunWorkflowDraftResponse",
+  inputSchema: RunWorkflowDraftOptionsSchema,
+  outputSchema: RunWorkflowDraftResponseSchema,
+  skipOutputValidation: true,
+  output: "item",
+  resolvers: {
+    workflow: workflowIdResolver,
+    draft: workflowDraftIdResolver,
+    draftRevision: workflowDraftRevisionResolver
+  },
+  run: async ({ imports, input }) => {
+    const api = imports.api;
+    const body = {
+      draft_revision: input.draftRevision
+    };
+    if (input.input !== void 0) {
+      body.input = input.input;
+    }
+    const raw = await api.post(
+      `${CODE_SUBSTRATE_WORKFLOWS_API}/workflows/${encodeURIComponent(input.workflow)}/drafts/${encodeURIComponent(input.draft)}/runs`,
+      body,
+      {
+        authRequired: true,
+        resource: { type: "workflow-draft", id: input.draft },
+        // 409 — the draft was edited concurrently (its draft_revision moved
+        // past the caller's). Retryable after re-reading the draft. 429 (the
+        // per-user draft-run rate limit) needs no handling here: the client
+        // retries with backoff and then throws ZapierRateLimitError.
+        customErrorHandler: ({ status, data }) => {
+          if (status === 409) {
+            const detail = extractErrorDetail(data);
+            return new ZapierConflictError(
+              `${detail ?? "Draft run conflict"} \u2014 the draft changed since it was last read. Re-read the draft to get the current draft_revision, then retry the run.`,
+              { statusCode: status, resourceType: "workflow-draft" }
+            );
+          }
+          return void 0;
+        }
+      }
+    );
+    return { data: RunWorkflowDraftResponseSchema.parse(raw) };
+  }
+});
 var listWorkflowRunsPlugin = defineMethod({
   ...codeSubstrateDefaults,
   name: "listWorkflowRuns",
@@ -1789,6 +1886,9 @@ var listWorkflowRunsPlugin = defineMethod({
     if (input.pageSize !== void 0) {
       searchParams.limit = input.pageSize.toString();
     }
+    if (input.kind !== void 0) {
+      searchParams.kind = input.kind;
+    }
     if (input.cursor) {
       searchParams.cursor = input.cursor;
     }
@@ -1817,15 +1917,14 @@ var GetWorkflowRunOptionsSchema = z.object({
   ),
   run: z.string().uuid().describe("Workflow run ID")
 }).describe(
-  "Get the current state of a workflow run (a triggered execution of a deployed workflow)"
+  "Get the current state of a workflow run \u2014 a live run of a published workflow version, or a draft run launched via `runWorkflowDraft` (the `kind` field says which)"
 );
-var GetWorkflowRunResponseSchema = z.object({
-  id: z.string().describe("Workflow run ID (UUID)"),
-  trigger_id: z.string().nullable().describe("ID of the trigger that fired this run, if any"),
+var workflowRunBase = z.object({
+  id: z.string().describe("Workflow run ID (UUIDv7). Unique across live and draft runs."),
+  workflow_id: z.string().describe("The workflow this run belongs to"),
   durable_run_id: z.string().nullable().describe(
     "Linked code-substrate-runner run ID. Null until the durable run is created."
   ),
-  workflow_version_id: z.string().nullable().describe("Workflow version the run is bound to"),
   status: WorkflowRunStatusSchema,
   input: z.unknown().describe("Input passed to the run"),
   output: z.unknown().nullable().describe("Return value, present when status is `finished`"),
@@ -1833,6 +1932,26 @@ var GetWorkflowRunResponseSchema = z.object({
   created_at: z.string().describe("When the run was created (ISO-8601)"),
   updated_at: z.string().describe("When the run was last updated (ISO-8601)")
 });
+var LiveWorkflowRunSchema = workflowRunBase.extend({
+  kind: z.literal("live").describe("A run of a published workflow version."),
+  trigger_id: z.string().nullable().describe(
+    "ID of the trigger that fired this run. Null for runs created without a trigger."
+  ),
+  workflow_version_id: z.string().nullable().describe("Workflow version the run is bound to. Null in rare edge cases.")
+});
+var DraftWorkflowRunSchema = workflowRunBase.extend({
+  kind: z.literal("draft").describe("A run launched from a workflow draft via `runWorkflowDraft`."),
+  workflow_draft_id: z.string().nullable().describe(
+    "The draft this run was launched from. Null once that draft has been deleted (the run outlives its draft)."
+  ),
+  draft_revision: z.number().int().describe(
+    "The draft's revision at the moment this run was created. Compare against the draft's current `draft_revision` to tell whether the run still reflects the draft as it now stands."
+  )
+});
+var GetWorkflowRunResponseSchema = z.discriminatedUnion("kind", [
+  LiveWorkflowRunSchema,
+  DraftWorkflowRunSchema
+]);
 
 // src/plugins/codeSubstrate/getWorkflowRun/index.ts
 var getWorkflowRunPlugin = defineMethod({
@@ -3186,6 +3305,7 @@ var zapierExperimentalSdkPlugin = definePlugin({
     updateWorkflowDraftPlugin,
     discardWorkflowDraftPlugin,
     publishWorkflowDraftPlugin,
+    runWorkflowDraftPlugin,
     listWorkflowRunsPlugin,
     getWorkflowRunPlugin,
     listDurableRunsPlugin,