@zapier/zapier-sdk 0.73.0 → 0.74.0

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

@@ -1,25 +1,136 @@
 import { z } from "zod";
-export declare const PublishWorkflowVersionOptionsSchema: z.ZodObject<{
+declare const TriggerConfigSchema: z.ZodObject<{
+    selectedApi: z.ZodOptional<z.ZodString>;
+    selected_api: z.ZodOptional<z.ZodString>;
+    action: z.ZodString;
+    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    authentication_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type TriggerConfig = z.infer<typeof TriggerConfigSchema>;
+export declare const PublishWorkflowVersionSchema: z.ZodObject<{
+    workflow: z.ZodString;
+    sourceFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    connections: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>>;
+    appVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    app_versions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        selectedApi: z.ZodOptional<z.ZodString>;
+        selected_api: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        authenticationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        authentication_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const PublishWorkflowVersionSchemaDeprecated: z.ZodObject<{
     workflow: z.ZodString;
     source_files: z.ZodRecord<z.ZodString, z.ZodString>;
     dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
     zapier_durable_version: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     connections: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
-        connection_id: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodString]>;
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>>;
+    appVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     app_versions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
-        implementation_name: z.ZodString;
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     trigger: z.ZodOptional<z.ZodObject<{
-        selected_api: z.ZodString;
+        selectedApi: z.ZodOptional<z.ZodString>;
+        selected_api: z.ZodOptional<z.ZodString>;
         action: z.ZodString;
+        authenticationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         authentication_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export type PublishWorkflowVersionOptions = z.infer<typeof PublishWorkflowVersionOptionsSchema>;
+export declare const PublishWorkflowVersionOptionsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    workflow: z.ZodString;
+    sourceFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    connections: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>>;
+    appVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    app_versions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        selectedApi: z.ZodOptional<z.ZodString>;
+        selected_api: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        authenticationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        authentication_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    workflow: z.ZodString;
+    source_files: z.ZodRecord<z.ZodString, z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    connections: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>>;
+    appVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    app_versions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        selectedApi: z.ZodOptional<z.ZodString>;
+        selected_api: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        authenticationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        authentication_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+export type PublishWorkflowVersionOptions = z.infer<typeof PublishWorkflowVersionSchema> | (Omit<z.infer<typeof PublishWorkflowVersionSchemaDeprecated>, "source_files"> & {
+    /** @deprecated Use `sourceFiles` instead. */
+    source_files: z.infer<typeof PublishWorkflowVersionSchemaDeprecated>["source_files"];
+});
 export declare const PublishWorkflowVersionResponseSchema: z.ZodObject<{
     id: z.ZodString;
     workflow_id: z.ZodString;
@@ -43,4 +154,5 @@ export declare const PublishWorkflowVersionResponseSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type PublishWorkflowVersionResponse = z.infer<typeof PublishWorkflowVersionResponseSchema>;
+export {};
 //# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/publishWorkflowVersion/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;iBA2C7C,CAAC;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,mCAAmC,CAC3C,CAAC;AAEF,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;iBA8B/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/publishWorkflowVersion/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,mBAAmB;;;;;;;iBA0BtB,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAyDhE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAarC,CAAC;AAGL,QAAA,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKF,CAAC;AAG3C,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEF,CAAC;AAE/C,MAAM,MAAM,6BAA6B,GACrC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,GAC5C,CAAC,IAAI,CACH,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,EACtD,cAAc,CACf,GAAG;IACF,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CACnB,OAAO,sCAAsC,CAC9C,CAAC,cAAc,CAAC,CAAC;CACnB,CAAC,CAAC;AAEP,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;iBA8B/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC"}

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

@@ -1,37 +1,100 @@
 import { z } from "zod";
+import { AppVersionBindingSchema as AppVersionBindingInputSchema, ConnectionBindingSchema as ConnectionBindingInputSchema, SourceFilesSchema, } from "../shared";
 import { AppVersionBindingSchema, ConnectionBindingSchema, WorkflowVersionTriggerConfigSchema, } from "../shared-schemas";
-export const PublishWorkflowVersionOptionsSchema = z
+// `selectedApi` is conceptually required when a trigger is configured, but it
+// coexists with its deprecated snake_case alias. AGENTS.md rule 9 prescribes a
+// union schema for a required renamed param; here we deliberately diverge —
+// a union nested inside `trigger` would drop `.shape`, which the docs
+// generator needs to render the trigger's fields. Instead both names are
+// optional (so `.shape` survives, snake_case stays hidden via `deprecated`)
+// and `toWireTrigger` enforces that one is present.
+const TriggerConfigSchema = z
     .object({
-    workflow: z.string().uuid().describe("Durable workflow ID"),
-    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"),
+    selectedApi: z
+        .string()
+        .optional()
+        .describe("Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured."),
+    /** @deprecated Use `selectedApi` instead. */
+    selected_api: z.string().optional().meta({ deprecated: true }),
+    action: z.string().describe("Trigger action key (e.g. 'new_row')"),
+    authenticationId: z
+        .string()
+        .nullish()
+        .describe("Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier)."),
+    /** @deprecated Use `authenticationId` instead. */
+    authentication_id: z.string().nullish().meta({ deprecated: true }),
+    params: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("Trigger parameters as a JSON object"),
+})
+    .describe("Zapier trigger configuration. When set, the workflow subscribes to trigger events.");
+const PublishWorkflowVersionDescription = "Publish a new version of a durable workflow. Enables the workflow by default.";
+// Shared, non-renamed properties for both the canonical and deprecated
+// `sourceFiles` variants. `workflow` and `sourceFiles` live on the variant
+// objects (not here) so they stay the leading keys — the CLI derives
+// positional args from key order, and the original order is
+// `<workflow> <source-files>`.
+const PublishWorkflowVersionBaseSchema = z.object({
     dependencies: z
         .record(z.string(), z.string())
         .optional()
         .describe("Optional npm package dependencies"),
-    zapier_durable_version: z
+    zapierDurableVersion: z
         .string()
         .optional()
         .describe('Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.'),
+    /** @deprecated Use `zapierDurableVersion` instead. */
+    zapier_durable_version: z.string().optional().meta({ deprecated: true }),
     enabled: z
         .boolean()
         .optional()
         .describe("Enable the workflow after publishing. Defaults to true; pass false to publish without enabling."),
     connections: z
-        .record(z.string(), ConnectionBindingSchema)
+        .record(z.string(), ConnectionBindingInputSchema)
         .nullish()
         .describe("Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding."),
-    app_versions: z
-        .record(z.string(), AppVersionBindingSchema)
+    appVersions: z
+        .record(z.string(), AppVersionBindingInputSchema)
         .nullish()
         .describe("Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding."),
-    trigger: WorkflowVersionTriggerConfigSchema.optional().describe("Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows."),
+    /** @deprecated Use `appVersions` instead. */
+    app_versions: z
+        .record(z.string(), AppVersionBindingInputSchema)
+        .nullish()
+        .meta({ deprecated: true }),
+    trigger: TriggerConfigSchema.optional().describe("Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows."),
+});
+const WorkflowPropertySchema = z
+    .string()
+    .uuid()
+    .describe("Durable workflow ID");
+// Canonical schema (new names only) — drives docs, CLI help, and the registry.
+export const PublishWorkflowVersionSchema = z
+    .object({
+    workflow: WorkflowPropertySchema,
+    sourceFiles: SourceFilesSchema,
 })
-    .describe("Publish a new version of a durable workflow. Enables the workflow by default.");
+    .merge(PublishWorkflowVersionBaseSchema)
+    .describe(PublishWorkflowVersionDescription)
+    .meta({
+    aliases: {
+        source_files: "sourceFiles",
+        zapier_durable_version: "zapierDurableVersion",
+        app_versions: "appVersions",
+    },
+});
+// Deprecated schema (backward compat) — keeps the old `source_files` name valid.
+const PublishWorkflowVersionSchemaDeprecated = z
+    .object({
+    workflow: WorkflowPropertySchema,
+    source_files: SourceFilesSchema,
+})
+    .merge(PublishWorkflowVersionBaseSchema);
+// Union for runtime validation: accepts either the canonical or the old name.
+export const PublishWorkflowVersionOptionsSchema = z
+    .union([PublishWorkflowVersionSchema, PublishWorkflowVersionSchemaDeprecated])
+    .describe(PublishWorkflowVersionDescription);
 export const PublishWorkflowVersionResponseSchema = z.object({
     id: z.string().describe("Workflow version ID (UUID)"),
     workflow_id: z.string().describe("Parent workflow ID (UUID)"),

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

@@ -22,15 +22,50 @@ export declare const runDurablePlugin: (sdk: {
     };
 }) => {
     runDurable: (options?: {
+        sourceFiles: Record<string, string>;
+        input?: unknown;
+        dependencies?: Record<string, string> | undefined;
+        zapierDurableVersion?: string | undefined;
+        zapier_durable_version?: string | undefined;
+        connections?: Record<string, {
+            connectionId?: string | number | undefined;
+            connection_id?: string | number | undefined;
+        }> | undefined;
+        appVersions?: Record<string, {
+            implementationName?: string | undefined;
+            implementation_name?: string | undefined;
+            version?: string | undefined;
+        }> | undefined;
+        app_versions?: Record<string, {
+            implementationName?: string | undefined;
+            implementation_name?: string | undefined;
+            version?: string | undefined;
+        }> | undefined;
+        private?: boolean | undefined;
+        notifications?: {
+            url: string;
+            events: ("error" | "started" | "cancelled" | "completed" | "progress")[];
+            type?: "webhook" | undefined;
+            max_retries?: number | undefined;
+        }[] | undefined;
+    } | {
         source_files: Record<string, string>;
         input?: unknown;
         dependencies?: Record<string, string> | undefined;
+        zapierDurableVersion?: string | undefined;
         zapier_durable_version?: string | undefined;
         connections?: Record<string, {
-            connection_id: string | number;
+            connectionId?: string | number | undefined;
+            connection_id?: string | number | undefined;
+        }> | undefined;
+        appVersions?: Record<string, {
+            implementationName?: string | undefined;
+            implementation_name?: string | undefined;
+            version?: string | undefined;
         }> | undefined;
         app_versions?: Record<string, {
-            implementation_name: string;
+            implementationName?: string | undefined;
+            implementation_name?: string | undefined;
             version?: string | undefined;
         }> | undefined;
         private?: boolean | undefined;

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

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

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

@@ -1,5 +1,5 @@
 import { definePlugin, createPluginMethod } from "kitcore";
-import { codeSubstrateDefaults } from "../shared";
+import { codeSubstrateDefaults, toWireConnections, toWireAppVersions, } from "../shared";
 import { RunDurableOptionsSchema, RunDurableResponseSchema } from "./schemas";
 export const runDurablePlugin = definePlugin((sdk) => createPluginMethod(sdk, {
     ...codeSubstrateDefaults,
@@ -9,23 +9,24 @@ export const runDurablePlugin = definePlugin((sdk) => createPluginMethod(sdk, {
     inputSchema: RunDurableOptionsSchema,
     outputSchema: RunDurableResponseSchema,
     handler: async ({ sdk, options }) => {
-        const body = {
-            source_files: options.source_files,
-        };
+        const sourceFiles = "sourceFiles" in options ? options.sourceFiles : options.source_files;
+        const zapierDurableVersion = options.zapierDurableVersion ?? options.zapier_durable_version;
+        const appVersions = options.appVersions ?? options.app_versions;
+        const body = { source_files: sourceFiles };
         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 (zapierDurableVersion !== undefined) {
+            body.zapier_durable_version = zapierDurableVersion;
         }
         if (options.connections !== undefined) {
-            body.connections = options.connections;
+            body.connections = toWireConnections(options.connections);
         }
-        if (options.app_versions !== undefined) {
-            body.app_versions = options.app_versions;
+        if (appVersions !== undefined) {
+            body.app_versions = toWireAppVersions(appVersions);
         }
         if (options.private !== undefined) {
             body.is_private = options.private;

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

@@ -1,14 +1,56 @@
 import { z } from "zod";
-export declare const RunDurableOptionsSchema: z.ZodObject<{
+export declare const RunDurableSchema: z.ZodObject<{
+    sourceFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    connections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    appVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    app_versions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    private: z.ZodOptional<z.ZodBoolean>;
+    notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"webhook">>;
+        url: z.ZodString;
+        max_retries: z.ZodOptional<z.ZodNumber>;
+        events: z.ZodArray<z.ZodEnum<{
+            error: "error";
+            started: "started";
+            cancelled: "cancelled";
+            completed: "completed";
+            progress: "progress";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const RunDurableSchemaDeprecated: z.ZodObject<{
     source_files: z.ZodRecord<z.ZodString, z.ZodString>;
     input: z.ZodOptional<z.ZodUnknown>;
     dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<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]>;
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    appVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     app_versions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        implementation_name: z.ZodString;
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     private: z.ZodOptional<z.ZodBoolean>;
@@ -25,7 +67,77 @@ export declare const RunDurableOptionsSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
-export type RunDurableOptions = z.infer<typeof RunDurableOptionsSchema>;
+export declare const RunDurableOptionsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    sourceFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    connections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    appVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    app_versions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    private: z.ZodOptional<z.ZodBoolean>;
+    notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"webhook">>;
+        url: z.ZodString;
+        max_retries: z.ZodOptional<z.ZodNumber>;
+        events: z.ZodArray<z.ZodEnum<{
+            error: "error";
+            started: "started";
+            cancelled: "cancelled";
+            completed: "completed";
+            progress: "progress";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    source_files: z.ZodRecord<z.ZodString, z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    zapierDurableVersion: z.ZodOptional<z.ZodString>;
+    zapier_durable_version: z.ZodOptional<z.ZodString>;
+    connections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        connectionId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+        connection_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    appVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    app_versions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        implementationName: z.ZodOptional<z.ZodString>;
+        implementation_name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    private: z.ZodOptional<z.ZodBoolean>;
+    notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodLiteral<"webhook">>;
+        url: z.ZodString;
+        max_retries: z.ZodOptional<z.ZodNumber>;
+        events: z.ZodArray<z.ZodEnum<{
+            error: "error";
+            started: "started";
+            cancelled: "cancelled";
+            completed: "completed";
+            progress: "progress";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>]>;
+export type RunDurableOptions = z.infer<typeof RunDurableSchema> | (Omit<z.infer<typeof RunDurableSchemaDeprecated>, "source_files"> & {
+    /** @deprecated Use `sourceFiles` instead. */
+    source_files: z.infer<typeof RunDurableSchemaDeprecated>["source_files"];
+});
 export declare const RunDurableResponseSchema: z.ZodObject<{
     id: z.ZodString;
     status: z.ZodLiteral<"initialized">;
@@ -33,4 +145,5 @@ export declare const RunDurableResponseSchema: z.ZodObject<{
     created_at: z.ZodString;
 }, z.core.$strip>;
 export type RunDurableResponse = z.infer<typeof RunDurableResponseSchema>;
+export {};
 //# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +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;AA8DxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;iBA4CjC,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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/codeSubstrate/runDurable/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0FxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUzB,CAAC;AAGL,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEF,CAAC;AAG/B,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEF,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GACzB,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GAChC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAAE,cAAc,CAAC,GAAG;IAClE,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC,cAAc,CAAC,CAAC;CAC1E,CAAC,CAAC;AAEP,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

@@ -1,26 +1,5 @@
 import { z } from "zod";
-// Local schemas (not imported from ../shared-schemas): runDurable enforces
-// `.min(1)` on implementation_name at the input boundary. The shared schema
-// is response-side and intentionally looser.
-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."),
-});
+import { AppVersionBindingSchema, ConnectionBindingSchema, SourceFilesSchema, } from "../shared";
 const RunNotificationEventSchema = z
     .enum(["started", "progress", "completed", "error", "cancelled"])
     .describe("Run lifecycle event this notification subscribes to");
@@ -47,31 +26,33 @@ const RunNotificationSchema = z
         .describe("One or more lifecycle events to subscribe this URL to."),
 })
     .describe("Webhook subscriber for run lifecycle events. Server POSTs `{run_id, event}` on each subscribed transition.");
-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"),
+// Shared, non-renamed properties. Lives in its own object so the canonical
+// and deprecated `sourceFiles` variants can merge it without repetition.
+const RunDurableBaseSchema = z.object({
     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
+    zapierDurableVersion: z
         .string()
         .optional()
         .describe('Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.'),
+    /** @deprecated Use `zapierDurableVersion` instead. */
+    zapier_durable_version: z.string().optional().meta({ deprecated: true }),
     connections: z
-        .record(z.string(), ConnectionMapEntrySchema)
+        .record(z.string(), ConnectionBindingSchema)
         .optional()
-        .describe('Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connection_id": "123" } }`.'),
-    app_versions: z
-        .record(z.string(), AppVersionMapEntrySchema)
+        .describe('Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connectionId": "123" } }`.'),
+    appVersions: z
+        .record(z.string(), AppVersionBindingSchema)
         .optional()
         .describe("Pinned app versions. Maps app keys (slugs) to implementation names and versions."),
+    /** @deprecated Use `appVersions` instead. */
+    app_versions: z
+        .record(z.string(), AppVersionBindingSchema)
+        .optional()
+        .meta({ deprecated: true }),
     private: z
         .boolean()
         .optional()
@@ -80,8 +61,28 @@ export const RunDurableOptionsSchema = z
         .array(RunNotificationSchema)
         .optional()
         .describe("Webhook subscribers for run lifecycle events. Each entry specifies a URL and the events it subscribes to."),
-})
-    .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.");
+});
+const RunDurableDescription = "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.";
+// Canonical schema (new names only) — drives docs, CLI help, and the registry.
+export const RunDurableSchema = z
+    .object({ sourceFiles: SourceFilesSchema })
+    .merge(RunDurableBaseSchema)
+    .describe(RunDurableDescription)
+    .meta({
+    aliases: {
+        source_files: "sourceFiles",
+        zapier_durable_version: "zapierDurableVersion",
+        app_versions: "appVersions",
+    },
+});
+// Deprecated schema (backward compat) — keeps the old `source_files` name valid.
+const RunDurableSchemaDeprecated = z
+    .object({ source_files: SourceFilesSchema })
+    .merge(RunDurableBaseSchema);
+// Union for runtime validation: accepts either the canonical or the old name.
+export const RunDurableOptionsSchema = z
+    .union([RunDurableSchema, RunDurableSchemaDeprecated])
+    .describe(RunDurableDescription);
 export const RunDurableResponseSchema = z.object({
     id: z.string().describe("Run ID (UUID) — server-generated, time-sortable"),
     status: z