@zapier/zapier-sdk 0.95.0 → 0.96.0

package/dist/experimental.mjs

@@ -1,5 +1,5 @@
-import { defineMethod, DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, openEnum, durableRunIdResolver, defineResolver, ZapierConflictError, extractErrorDetail, workflowVersionIdResolver, workflowDraftIdResolver, ZapierApiError, workflowRunIdResolver, definePlugin, zapierSdkPlugin, ZapierValidationError, createSdk, zapierCoreOptions, CORE_OPTIONS_ID, SDK_OPTIONS_ID } from './chunk-JZDH3POI.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, 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, 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-JZDH3POI.mjs';
+import { defineMethod, DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, openEnum, durableRunIdResolver, defineResolver, ZapierConflictError, extractErrorDetail, workflowVersionIdResolver, workflowDraftIdResolver, ZapierApiError, workflowRunIdResolver, definePlugin, zapierSdkPlugin, ZapierValidationError, ZapierConfigurationError, createSdk, zapierCoreOptions, CORE_OPTIONS_ID, SDK_OPTIONS_ID } from './chunk-MLSC6GO6.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, 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, 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-MLSC6GO6.mjs';
 import './chunk-Y6FXYEAI.mjs';
 import { z } from 'zod';
 
@@ -1830,6 +1830,341 @@ var triggerWorkflowPlugin = defineMethod({
   }
 });
 
+// src/plugins/humanInput/shared.ts
+var humanInputDefaults = {
+  categories: ["human-input"],
+  experimental: true
+};
+var FORMS_API = "/forms/v0";
+var FORMS_ACCESS_DENIED_DETAIL = "This user does not yet have access to Forms.";
+function firstErrorDetail(data) {
+  if (typeof data !== "object" || data === null || !("errors" in data) || !Array.isArray(data.errors)) {
+    return void 0;
+  }
+  const first = data.errors[0];
+  if (typeof first !== "object" || first === null || !("detail" in first)) {
+    return void 0;
+  }
+  return typeof first.detail === "string" ? first.detail : void 0;
+}
+function handleFormsAccessError({
+  status,
+  data
+}) {
+  if (status !== 403 || firstErrorDetail(data) !== FORMS_ACCESS_DENIED_DETAIL) {
+    return void 0;
+  }
+  return new ZapierConfigurationError(
+    `${FORMS_ACCESS_DENIED_DETAIL} Request access through Zapier support at https://zapier.com/app/get-help.`,
+    { statusCode: status }
+  );
+}
+
+// src/plugins/humanInput/utils.ts
+var FORM_DOCUMENT_SCHEMA_VERSION = 4;
+function omitUndefined(body) {
+  return Object.fromEntries(
+    Object.entries(body).filter(([, value]) => value !== void 0)
+  );
+}
+function labelToKey(label) {
+  return label.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+}
+function toWireDataSource(dataSource) {
+  return omitUndefined({
+    app: dataSource.app,
+    action_type: dataSource.actionType,
+    resource: dataSource.resource,
+    value_key: dataSource.valueKey,
+    label_key: dataSource.labelKey
+  });
+}
+function toFieldAttrs(field, key) {
+  const base = {
+    key,
+    label: field.label,
+    required: field.required ?? false,
+    field_type: field.type,
+    disabled: field.disabled
+  };
+  switch (field.type) {
+    case "yes_no":
+      return omitUndefined({ ...base, variant: field.variant ?? "checkbox" });
+    case "url":
+      return omitUndefined({ ...base, multi_url: field.multiUrl ?? false });
+    case "date":
+    case "date_range":
+      return omitUndefined({
+        ...base,
+        include_time: field.includeTime ?? false
+      });
+    case "currency":
+      return omitUndefined({
+        ...base,
+        decimals: field.decimals ?? 2,
+        currency_format: field.currencyFormat
+      });
+    case "phone_number":
+      return omitUndefined({
+        ...base,
+        default_country: field.defaultCountry ?? "US",
+        phone_number_format: field.phoneNumberFormat ?? "national",
+        accepted_countries: field.acceptedCountries
+      });
+    case "dropdown":
+      return omitUndefined({
+        ...base,
+        options: field.options,
+        multi_select: field.multiSelect ?? false
+      });
+    case "integration_backed":
+      return omitUndefined({
+        ...base,
+        data_source: field.dataSource === void 0 ? void 0 : toWireDataSource(field.dataSource)
+      });
+    default:
+      return omitUndefined(base);
+  }
+}
+function assertUniqueKeys(keys, fields) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const [index, key] of keys.entries()) {
+    const label = fields[index]?.label ?? "";
+    const previous = seen.get(key);
+    if (previous !== void 0) {
+      throw new ZapierValidationError(
+        `Fields "${previous}" and "${label}" both derive the submission key "${key}". Give them labels that differ by more than punctuation or casing.`,
+        { details: { key, labels: [previous, label] } }
+      );
+    }
+    seen.set(key, label);
+  }
+}
+function toEndingActionNode(id, title, message) {
+  const trimmedTitle = title?.trim();
+  const trimmedMessage = message?.trim();
+  if (!trimmedTitle && !trimmedMessage) return void 0;
+  return {
+    id,
+    type: "ending_action",
+    attrs: omitUndefined({
+      variant: "success",
+      title: trimmedTitle || void 0,
+      message: trimmedMessage || void 0
+    })
+  };
+}
+function buildFormDocument(input) {
+  const fields = input.fields ?? [];
+  const keys = fields.map(
+    (field, index) => labelToKey(field.label) || `field_${index + 1}`
+  );
+  assertUniqueKeys(keys, fields);
+  const children = fields.map((field, index) => ({
+    id: `@field_${index + 1}`,
+    type: "field",
+    attrs: toFieldAttrs(field, keys[index])
+  }));
+  const endingAction = toEndingActionNode(
+    "@ending_action",
+    input.confirmationTitle,
+    input.confirmationMessage
+  );
+  if (endingAction) children.push(endingAction);
+  return {
+    id: "@root",
+    type: "root",
+    attrs: omitUndefined({
+      schema_version: FORM_DOCUMENT_SCHEMA_VERSION,
+      title: input.title,
+      description: input.description
+    }),
+    children
+  };
+}
+function toWireFormAttributes(input) {
+  return omitUndefined({
+    document: input.document ?? buildFormDocument(input),
+    consumer_auth: input.consumerAuth,
+    callback_url: input.callbackUrl,
+    publish: input.draft === true ? false : void 0
+  });
+}
+var FormFieldTypeSchema = z.enum([
+  "short_text",
+  "long_text",
+  "email",
+  "number",
+  "yes_no",
+  "url",
+  "date",
+  "date_range",
+  "currency",
+  "phone_number",
+  "dropdown",
+  "integration_backed"
+]);
+var ConsumerAuthSchema = z.enum(["none", "zapier"]);
+var DropdownOptionSchema = z.object({
+  value: z.string().min(1).describe("The value submitted when this option is selected."),
+  label: z.string().min(1).describe("Human-readable label shown to the user.")
+});
+var FieldDataSourceSchema = z.object({
+  app: z.string().min(1).describe(
+    "Zapier app to pull options from. See `listApps` for the catalog."
+  ),
+  actionType: z.enum(["read", "read_bulk"]).describe(
+    "Whether the data source returns a single record (`read`) or a collection (`read_bulk`)."
+  ),
+  resource: z.string().min(1).describe(
+    "Resource name within the app \u2014 typically a trigger or search key from the app's definition."
+  ),
+  valueKey: z.string().min(1).optional().describe(
+    "Property on each returned record to use as the submitted option value. Defaults to `id`."
+  ),
+  labelKey: z.string().min(1).optional().describe(
+    "Property on each returned record to use as the displayed option label. Defaults to a sensible name field."
+  )
+});
+var FormFieldBaseSchema = z.object({
+  label: z.string().min(1).describe("Human-readable label shown above the input."),
+  type: FormFieldTypeSchema.describe("The type of field."),
+  required: z.boolean().optional().describe("Whether the field must be answered before the form can submit."),
+  disabled: z.boolean().optional().describe(
+    "When true, the field is rendered read-only \u2014 shown but not editable. A rendering hint only; it is not enforced during submission validation."
+  ),
+  variant: z.enum(["checkbox", "radio"]).optional().describe(
+    "For `yes_no` fields: `checkbox` renders a single toggle, `radio` renders explicit yes/no buttons. Defaults to `checkbox`."
+  ),
+  multiUrl: z.boolean().optional().describe(
+    "For `url` fields: when true the field accepts a list of URLs, otherwise a single URL. Defaults to false."
+  ),
+  includeTime: z.boolean().optional().describe(
+    "For `date` and `date_range` fields: when true the picker also captures a time. Defaults to false."
+  ),
+  currencyFormat: z.string().regex(/^[A-Za-z]{3}$/).optional().describe(
+    "For `currency` fields: ISO 4217 currency code (e.g. `usd`, `eur`). Controls the symbol shown in the form UI."
+  ),
+  decimals: z.union([z.literal(0), z.literal(2)]).optional().describe(
+    "For `currency` fields: allowed decimal places. `0` for whole numbers, `2` for up to two decimal places. Defaults to `2`."
+  ),
+  defaultCountry: z.string().regex(/^[A-Z]{2}$/).optional().describe(
+    "For `phone_number` fields: ISO 3166-1 alpha-2 code for the default selected country (e.g. `US`). Defaults to `US`."
+  ),
+  phoneNumberFormat: z.enum(["national", "international"]).optional().describe(
+    "For `phone_number` fields: `national` omits the country-code prefix, `international` includes it. Defaults to `national`."
+  ),
+  acceptedCountries: z.array(z.string().regex(/^[A-Z]{2}$/)).optional().describe(
+    "For `phone_number` fields: restrict input to specific ISO 3166-1 alpha-2 country codes. Omit to allow all countries."
+  ),
+  options: z.array(DropdownOptionSchema).min(1).optional().describe(
+    "For `dropdown` fields: the selectable options. At least one is required."
+  ),
+  multiSelect: z.boolean().optional().describe(
+    "For `dropdown` fields: when true the user may select multiple options. Defaults to false."
+  ),
+  dataSource: FieldDataSourceSchema.optional().describe(
+    "For `integration_backed` fields: where to fetch the field's options from at render time."
+  )
+});
+var FormFieldSchema = FormFieldBaseSchema.superRefine((field, ctx) => {
+  if (field.type === "dropdown" && field.options === void 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["options"],
+      message: "A dropdown field requires `options`."
+    });
+  }
+  if (field.type === "integration_backed" && field.dataSource === void 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["dataSource"],
+      message: "An integration_backed field requires `dataSource`."
+    });
+  }
+});
+var RawFormDocumentSchema = z.object({
+  id: z.string().min(1),
+  type: z.literal("root"),
+  attrs: z.object({
+    schema_version: z.number().int(),
+    title: z.string().min(1)
+  }).loose(),
+  children: z.array(z.unknown()).optional()
+}).loose();
+var FormSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  description: z.string().nullish(),
+  hosted_url: z.string(),
+  submission_count: z.number(),
+  account_id: z.number(),
+  owner_id: z.string(),
+  created_at: z.string(),
+  updated_at: z.string(),
+  document: z.unknown(),
+  last_published_at: z.string().nullable(),
+  consumer_auth: z.unknown(),
+  callback_url: z.unknown()
+}).loose();
+
+// src/plugins/humanInput/createForm/schemas.ts
+var CreateFormDescription = "Create a Zapier Form from a title and optional fields. Forms publish by default and return a shareable `hosted_url`; set `draft` to save without publishing.";
+var CreateFormSchema = z.object({
+  title: z.string().min(1).describe("The title shown in the Forms UI and on the form."),
+  description: z.string().optional().describe("An optional description of the form."),
+  fields: z.array(FormFieldSchema).optional().describe("Initial fields to add to the form."),
+  draft: z.boolean().optional().describe(
+    "When true, save without publishing. Omit to publish immediately, making `hosted_url` live."
+  ),
+  confirmationTitle: z.string().max(200).optional().describe(
+    "Heading shown to the respondent after they submit. Omit to use the form renderer's default."
+  ),
+  confirmationMessage: z.string().max(1e3).optional().describe(
+    "Message shown to the respondent after they submit, below the confirmation title. Omit to use the form renderer's default."
+  ),
+  callbackUrl: z.string().url().optional().describe(
+    "Absolute http/https URL notified with the submission JSON each time the form is answered."
+  ),
+  consumerAuth: ConsumerAuthSchema.optional().describe(
+    "Who may open the published form. `none` (the default) leaves it public to anyone with the link; `zapier` requires the visitor to be signed in to Zapier on the form's owning account."
+  ),
+  document: RawFormDocumentSchema.optional().describe(
+    "Escape hatch: a complete form document tree, sent as-is. When supplied it replaces the document built from `fields`, and `title`, `description`, `confirmationTitle`, and `confirmationMessage` are ignored. Use only for structures the flat field list cannot express, such as approval decisions or multi-column row layout."
+  )
+}).describe(CreateFormDescription);
+
+// src/plugins/humanInput/createForm/index.ts
+var createFormPlugin = defineMethod({
+  ...humanInputDefaults,
+  name: "createForm",
+  imports: [apiPluginRef],
+  type: "create",
+  itemType: "Form",
+  inputSchema: CreateFormSchema,
+  outputSchema: FormSchema,
+  output: "item",
+  run: async ({ imports, input }) => {
+    const api = imports.api;
+    const body = toWireFormAttributes({
+      title: input.title,
+      description: input.description,
+      confirmationTitle: input.confirmationTitle,
+      confirmationMessage: input.confirmationMessage,
+      consumerAuth: input.consumerAuth,
+      callbackUrl: input.callbackUrl,
+      draft: input.draft,
+      fields: input.fields,
+      document: input.document
+    });
+    const rawResponse = await api.post(`${FORMS_API}/forms`, body, {
+      authRequired: true,
+      customErrorHandler: handleFormsAccessError
+    });
+    return { data: FormSchema.parse(rawResponse) };
+  }
+});
+
 // src/experimental.ts
 var zapierExperimentalSdkPlugin = definePlugin({
   namespace: "zapier",
@@ -1862,7 +2197,10 @@ var zapierExperimentalSdkPlugin = definePlugin({
     runDurablePlugin,
     cancelDurableRunPlugin,
     triggerWorkflowPlugin,
-    getTriggerRunPlugin
+    getTriggerRunPlugin,
+    // Human input (experimental). Routed through the Public API Gateway
+    // rather than the sdkapi proxy — see the `/forms` entry in api/client.ts.
+    createFormPlugin
   ]
 });
 function createZapierSdk(options = {}) {