@zapier/zapier-sdk 0.107.2 → 0.108.0

package/dist/experimental.mjs

@@ -1,7 +1,7 @@
-import { DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, extractErrorDetail, ZapierApiError, durableRunIdResolver, ZapierConflictError, workflowVersionIdResolver, workflowDraftIdResolver, workflowRunIdResolver, zapierSdkPlugin, ZapierValidationError, ZapierConfigurationError, zapierCoreOptions, SDK_OPTIONS_ID } from './chunk-HYFM3H36.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-HYFM3H36.mjs';
+import { DEFAULT_PAGE_SIZE, apiPluginRef, workflowIdResolver, extractErrorDetail, ZapierApiError, durableRunIdResolver, ZapierConflictError, workflowVersionIdResolver, workflowDraftIdResolver, workflowRunIdResolver, zapierSdkPlugin, ZapierValidationError, ZapierConfigurationError, zapierCoreOptions, SDK_OPTIONS_ID } from './chunk-ULZVDPAK.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-ULZVDPAK.mjs';
 import './chunk-Y6FXYEAI.mjs';
-import { defineMethod, openEnum, defineResolver, definePlugin, createSdk, CORE_OPTIONS_ID } from '@zapier/kitcore';
+import { defineMethod, openEnum, defineResolver, defineFormatter, definePlugin, createSdk, CORE_OPTIONS_ID } from '@zapier/kitcore';
 import { z } from 'zod';
 
 var codeSubstrateDefaults = {
@@ -2690,6 +2690,473 @@ var updateAgenticManagementIntentPlugin = defineMethod({
     return { data };
   }
 });
+var fsDirectoryEntryFormatter = defineFormatter({
+  format: ({ item }) => ({
+    title: item.path,
+    details: [
+      { label: "type", text: item.type, style: "normal" },
+      ...item.size !== void 0 ? [
+        {
+          label: "size",
+          text: `${item.size} bytes`,
+          style: "normal"
+        }
+      ] : [],
+      ...item.version !== void 0 ? [
+        {
+          label: "version",
+          text: String(item.version),
+          style: "normal"
+        }
+      ] : [],
+      ...item.updated_at ? [{ label: "updated", text: item.updated_at, style: "dim" }] : []
+    ]
+  })
+});
+
+// src/plugins/vfs/shared.ts
+var vfsDefaults = {
+  // `titlePlural` is set explicitly so the generated docs heading reads
+  // "Virtual File System", not the auto-pluralized "Virtual File Systems".
+  categories: [
+    {
+      key: "vfs",
+      title: "Virtual File System",
+      titlePlural: "Virtual File System"
+    }
+  ],
+  stability: "experimental"
+};
+var VFS_PATH_PREFIX = "/vfs/v1";
+var VFS_NAME = "Zapier Virtual File System (VFS)";
+var VFS_MAX_CONTENT_BYTES = 10485760;
+function absolutePathSchema({
+  label,
+  example = "/Mine/notes.md"
+}) {
+  return z.string().startsWith("/", {
+    message: `${label} must start with '/' \u2014 paths are absolute.`
+  }).meta({ example });
+}
+var FsWriteResultSchema = z.object({
+  path: z.string().describe("Absolute path of the written file."),
+  version: z.number().int().min(1).describe("Monotonic version stamped by the server on this write."),
+  action: z.enum(["created", "updated"]).describe(
+    "Whether the write created a new file or updated an existing one."
+  ),
+  warnings: z.array(z.string()).optional().describe(
+    "Non-fatal issues the server surfaced alongside the successful write."
+  )
+});
+var FsMkdirResultSchema = z.object({
+  path: z.string().describe("Absolute path of the created directory."),
+  action: z.enum(["created", "updated"]).describe(
+    "Whether the directory was newly created or already existed (idempotent)."
+  )
+});
+var FsDeleteResultSchema = z.object({
+  path: z.string().describe("Absolute path that was removed from the live tree.")
+});
+var FsMoveResultSchema = z.object({
+  from: z.string().describe("Absolute source path (before the move)."),
+  to: z.string().describe("Absolute destination path (after the move).")
+});
+var FsDirectoryEntrySchema = z.object({
+  type: z.enum(["file", "directory", "shortcut", "stream"]).describe("Kind of entry. `shortcut` points at a `target_*` sibling."),
+  name: z.string().describe("Basename of the entry (the segment after the last `/`)."),
+  path: z.string().describe("Absolute path of the entry."),
+  size: z.number().int().min(0).optional().describe(
+    "Content size in bytes. Present for files; absent for directories."
+  ),
+  version: z.number().int().min(1).optional().describe("Monotonic version for the underlying file, when applicable."),
+  updated_at: z.string().optional().describe("ISO-8601 timestamp of the last modification."),
+  target_type: z.enum(["file", "directory", "stream"]).nullable().optional().describe(
+    "For `shortcut` entries: the kind of resource the shortcut points at."
+  ),
+  target_path: z.string().nullable().optional().describe(
+    "For `shortcut` entries: the absolute path the shortcut points at."
+  ),
+  accessible: z.boolean().optional().describe(
+    "Whether the caller can read the target. Only meaningful for shortcuts."
+  ),
+  content_type: z.string().optional().describe(
+    "MIME type of a file's content, when the server can determine one."
+  )
+});
+
+// src/plugins/vfs/readVfsFile/schemas.ts
+var ReadVfsFileSchema = z.object({
+  path: absolutePathSchema({ label: "Path" }).describe(
+    "Absolute path of the file to read (must start with `/`)."
+  ),
+  maxBytes: z.number().int().min(1).max(VFS_MAX_CONTENT_BYTES).optional().describe(
+    "Optional cap on returned content length, in bytes. Files are capped at 10 MB, so values above that have no effect."
+  )
+}).describe(
+  "Read a file from the " + VFS_NAME + ", the file store behind your context repository. Paths are absolute, e.g. `/Mine/notes.md`. Returns the content as a UTF-8 string with its size, version, and last-modified time."
+);
+var ReadVfsFileItemSchema = z.object({
+  type: z.literal("file").describe("Discriminator \u2014 always `file` for a file read."),
+  path: z.string().describe("Absolute path of the file that was read."),
+  name: z.string().describe("Basename of the file (the segment after the last `/`)."),
+  content: z.string().describe(
+    "File content as a UTF-8 string, truncated to `maxBytes` when requested."
+  ),
+  size: z.number().int().min(0).describe(
+    "Total content size in bytes (independent of any `maxBytes` truncation)."
+  ),
+  version: z.number().int().min(1).describe("Monotonic version for the file at read time."),
+  updated_at: z.string().describe("ISO-8601 timestamp of the last modification."),
+  canonical_path: z.string().optional().describe(
+    "Absolute path the server resolved after following any shortcut."
+  )
+});
+
+// src/plugins/vfs/readVfsFile/index.ts
+var readVfsFilePlugin = defineMethod({
+  ...vfsDefaults,
+  name: "readVfsFile",
+  imports: [apiPluginRef],
+  itemType: "VfsFile",
+  inputSchema: ReadVfsFileSchema,
+  outputSchema: ReadVfsFileItemSchema,
+  output: "item",
+  formatter: fsDirectoryEntryFormatter,
+  run: async ({ imports, input }) => {
+    const searchParams = { path: input.path };
+    if (input.maxBytes !== void 0) {
+      searchParams.max_bytes = String(input.maxBytes);
+    }
+    const data = await imports.api.get(
+      `${VFS_PATH_PREFIX}/files`,
+      {
+        authRequired: true,
+        searchParams,
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var fsWriteResultFormatter = defineFormatter({
+  format: ({ item }) => ({
+    title: item.path,
+    details: [
+      { label: "action", text: item.action, style: "normal" },
+      {
+        label: "version",
+        text: String(item.version),
+        style: "normal"
+      },
+      ...item.warnings?.length ? [
+        {
+          label: "warnings",
+          text: item.warnings.join("; "),
+          style: "dim"
+        }
+      ] : []
+    ]
+  })
+});
+var WriteVfsFileSchema = z.object({
+  path: absolutePathSchema({ label: "Path" }).describe(
+    "Absolute path of the file (must start with `/`)."
+  ),
+  content: z.string().max(VFS_MAX_CONTENT_BYTES).describe("New file contents. Capped at 10 MB per call."),
+  expectedVersion: z.number().int().min(0).optional().describe(
+    "Optional expected current version for optimistic concurrency. The write fails if the file's actual version differs. Pass `0` to assert the file does not exist yet (versions start at 1)."
+  )
+}).describe(
+  "Write (create or overwrite) a file in the " + VFS_NAME + ". Paths are absolute (e.g. `/Mine/notes.md`); missing parent directories are created automatically."
+);
+var WriteVfsFileItemSchema = FsWriteResultSchema;
+
+// src/plugins/vfs/writeVfsFile/index.ts
+var writeVfsFilePlugin = defineMethod({
+  ...vfsDefaults,
+  name: "writeVfsFile",
+  imports: [apiPluginRef],
+  itemType: "VfsWriteResult",
+  inputSchema: WriteVfsFileSchema,
+  outputSchema: WriteVfsFileItemSchema,
+  output: "item",
+  formatter: fsWriteResultFormatter,
+  run: async ({ imports, input }) => {
+    const body = {
+      path: input.path,
+      content: input.content
+    };
+    if (input.expectedVersion !== void 0) {
+      body.expected_version = input.expectedVersion;
+    }
+    const data = await imports.api.put(
+      `${VFS_PATH_PREFIX}/files`,
+      body,
+      {
+        authRequired: true,
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var AppendVfsFileSchema = z.object({
+  path: absolutePathSchema({ label: "Path" }).describe(
+    "Absolute path of the file (must start with `/`)."
+  ),
+  content: z.string().max(VFS_MAX_CONTENT_BYTES).describe(
+    "Content to append. Capped at 10 MB per call, and the resulting file must also fit under 10 MB."
+  )
+}).describe(
+  "Append content to a file in the " + VFS_NAME + ". Creates the file if it doesn't exist; missing parent directories are created automatically. Safer than reading the file and rewriting it \u2014 appends server-side without a read/write round-trip. Paths are absolute (e.g. `/Mine/log.md`)."
+);
+var AppendVfsFileItemSchema = FsWriteResultSchema;
+
+// src/plugins/vfs/appendVfsFile/index.ts
+var appendVfsFilePlugin = defineMethod({
+  ...vfsDefaults,
+  name: "appendVfsFile",
+  imports: [apiPluginRef],
+  itemType: "VfsWriteResult",
+  inputSchema: AppendVfsFileSchema,
+  outputSchema: AppendVfsFileItemSchema,
+  output: "item",
+  formatter: fsWriteResultFormatter,
+  run: async ({ imports, input }) => {
+    const data = await imports.api.post(
+      `${VFS_PATH_PREFIX}/files/append`,
+      { path: input.path, content: input.content },
+      {
+        authRequired: true,
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var CopyVfsFileSchema = z.object({
+  from: absolutePathSchema({ label: "from" }).describe(
+    "Absolute path of the source file."
+  ),
+  to: absolutePathSchema({
+    label: "to",
+    example: "/Mine/notes-copy.md"
+  }).describe("Absolute path of the destination file."),
+  overwrite: z.boolean().optional().describe(
+    "When `true`, replace any existing file at `to`. Default `false` fails if `to` already exists."
+  ),
+  expectedVersion: z.number().int().min(1).optional().describe(
+    "Optional version pin for the destination. Requires `overwrite: true` and an existing file at `to`; the replace only succeeds if the destination's current version matches, otherwise the call fails."
+  )
+}).describe(
+  "Copy a file to a new path in the " + VFS_NAME + ". Both `from` and `to` are absolute file paths (e.g. `/Mine/notes.md`), not directories."
+);
+var CopyVfsFileItemSchema = FsWriteResultSchema;
+
+// src/plugins/vfs/copyVfsFile/index.ts
+var copyVfsFilePlugin = defineMethod({
+  ...vfsDefaults,
+  name: "copyVfsFile",
+  imports: [apiPluginRef],
+  itemType: "VfsWriteResult",
+  inputSchema: CopyVfsFileSchema,
+  outputSchema: CopyVfsFileItemSchema,
+  output: "item",
+  formatter: fsWriteResultFormatter,
+  run: async ({ imports, input }) => {
+    const body = { from: input.from, to: input.to };
+    if (input.overwrite !== void 0) body.overwrite = input.overwrite;
+    if (input.expectedVersion !== void 0) {
+      body.expected_version = input.expectedVersion;
+    }
+    const data = await imports.api.post(
+      `${VFS_PATH_PREFIX}/files/copy`,
+      body,
+      {
+        authRequired: true,
+        resource: { type: "vfs_path", id: input.from }
+      }
+    );
+    return { data };
+  }
+});
+var ListVfsDirectorySchema = z.object({
+  path: absolutePathSchema({ label: "Path", example: "/Mine" }).describe(
+    "Absolute path of the directory (must start with `/`)."
+  ),
+  pageSize: z.number().int().min(1).max(500).optional().describe("Entries per page (default 50, max 500)."),
+  maxItems: z.number().int().min(1).optional().describe("Maximum total entries to return across all pages."),
+  cursor: z.string().optional().describe("Cursor to resume from, as returned in `nextCursor`.")
+}).describe(
+  "List one page of a directory's contents in the " + VFS_NAME + ". Paths are absolute (e.g. `/Mine`). Pass the previous page's `nextCursor` back in `cursor` to fetch the next page."
+);
+
+// src/plugins/vfs/listVfsDirectory/index.ts
+var listVfsDirectoryPlugin = defineMethod({
+  ...vfsDefaults,
+  name: "listVfsDirectory",
+  imports: [apiPluginRef],
+  type: "list",
+  itemType: "VfsDirectoryEntry",
+  inputSchema: ListVfsDirectorySchema,
+  outputSchema: FsDirectoryEntrySchema,
+  output: "list",
+  formatter: fsDirectoryEntryFormatter,
+  run: async ({ imports, input }) => {
+    const searchParams = { path: input.path };
+    if (input.pageSize !== void 0) {
+      searchParams.limit = String(input.pageSize);
+    }
+    if (input.cursor !== void 0) {
+      searchParams.cursor = input.cursor;
+    }
+    const page = await imports.api.get(
+      `${VFS_PATH_PREFIX}/directories`,
+      {
+        authRequired: true,
+        searchParams,
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return {
+      data: page.results,
+      nextCursor: page.meta.next_cursor ?? void 0
+    };
+  }
+});
+var CreateVfsDirectorySchema = z.object({
+  path: absolutePathSchema({
+    label: "Path",
+    example: "/Mine/notes"
+  }).describe("Absolute path of the directory (must start with `/`).")
+}).describe(
+  "Create a directory in the " + VFS_NAME + ". Paths are absolute (e.g. `/Mine/notes`). Idempotent \u2014 safe to call on an existing directory."
+);
+var CreateVfsDirectoryItemSchema = FsMkdirResultSchema;
+
+// src/plugins/vfs/createVfsDirectory/index.ts
+var createVfsDirectoryPlugin = defineMethod({
+  ...vfsDefaults,
+  name: "createVfsDirectory",
+  imports: [apiPluginRef],
+  itemType: "VfsMkdirResult",
+  inputSchema: CreateVfsDirectorySchema,
+  outputSchema: CreateVfsDirectoryItemSchema,
+  output: "item",
+  run: async ({ imports, input }) => {
+    const data = await imports.api.put(
+      `${VFS_PATH_PREFIX}/directories`,
+      { path: input.path },
+      {
+        authRequired: true,
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var StatVfsPathSchema = z.object({
+  path: absolutePathSchema({ label: "Path" }).describe(
+    "Absolute path to stat (must start with `/`)."
+  )
+}).describe(
+  "Inspect metadata for any path (file, directory, shortcut, or stream) in the " + VFS_NAME + ". Paths are absolute (e.g. `/Mine/notes.md`). Check the `type` field before reading fields that only exist for certain types."
+);
+var StatVfsPathItemSchema = FsDirectoryEntrySchema;
+
+// src/plugins/vfs/statVfsPath/index.ts
+var statVfsPathPlugin = defineMethod({
+  ...vfsDefaults,
+  name: "statVfsPath",
+  imports: [apiPluginRef],
+  itemType: "VfsStat",
+  inputSchema: StatVfsPathSchema,
+  outputSchema: StatVfsPathItemSchema,
+  output: "item",
+  formatter: fsDirectoryEntryFormatter,
+  run: async ({ imports, input }) => {
+    const data = await imports.api.get(
+      `${VFS_PATH_PREFIX}/paths`,
+      {
+        authRequired: true,
+        searchParams: { path: input.path },
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var DeleteVfsPathSchema = z.object({
+  path: absolutePathSchema({ label: "Path" }).describe(
+    "Absolute path to delete (must start with `/`)."
+  )
+}).describe(
+  "Delete a file or directory in the " + VFS_NAME + ". Works on either; paths are absolute (e.g. `/Mine/notes.md`). Deletes are recoverable \u2014 contact Zapier support to restore an entry."
+);
+var DeleteVfsPathItemSchema = FsDeleteResultSchema;
+
+// src/plugins/vfs/deleteVfsPath/index.ts
+var deleteVfsPathPlugin = defineMethod({
+  ...vfsDefaults,
+  name: "deleteVfsPath",
+  imports: [apiPluginRef],
+  type: "delete",
+  itemType: "VfsDeleteResult",
+  // `type: "delete"` defaults the documented return to `{ success: boolean }`,
+  // but this method returns `{ data: { path } }`; name the real item type.
+  returnType: "VfsDeleteResultItem",
+  // Match the other delete methods: prompt in the CLI before removing a path.
+  confirm: "delete",
+  inputSchema: DeleteVfsPathSchema,
+  outputSchema: DeleteVfsPathItemSchema,
+  output: "item",
+  run: async ({ imports, input }) => {
+    const data = await imports.api.delete(
+      `${VFS_PATH_PREFIX}/paths`,
+      void 0,
+      {
+        authRequired: true,
+        searchParams: { path: input.path },
+        resource: { type: "vfs_path", id: input.path }
+      }
+    );
+    return { data };
+  }
+});
+var MoveVfsPathSchema = z.object({
+  from: absolutePathSchema({ label: "from" }).describe(
+    "Absolute path of the source entry."
+  ),
+  to: absolutePathSchema({
+    label: "to",
+    example: "/Mine/archive/notes.md"
+  }).describe("New absolute path for the entry.")
+}).describe(
+  "Move (rename) a file or directory in the " + VFS_NAME + ". Both `from` and `to` are absolute paths (e.g. `/Mine/notes.md`). Fails if an entry already exists at `to` \u2014 delete or rename it first."
+);
+var MoveVfsPathItemSchema = FsMoveResultSchema;
+
+// src/plugins/vfs/moveVfsPath/index.ts
+var moveVfsPathPlugin = defineMethod({
+  ...vfsDefaults,
+  name: "moveVfsPath",
+  imports: [apiPluginRef],
+  itemType: "VfsMoveResult",
+  inputSchema: MoveVfsPathSchema,
+  outputSchema: MoveVfsPathItemSchema,
+  output: "item",
+  run: async ({ imports, input }) => {
+    const data = await imports.api.post(
+      `${VFS_PATH_PREFIX}/paths/move`,
+      { from: input.from, to: input.to },
+      {
+        authRequired: true,
+        resource: { type: "vfs_path", id: input.from }
+      }
+    );
+    return { data };
+  }
+});
 
 // src/experimental.ts
 var zapierExperimentalSdkPlugin = definePlugin({
@@ -2738,7 +3205,19 @@ var zapierExperimentalSdkPlugin = definePlugin({
     getAgenticManagementConfigPlugin,
     updateAgenticManagementConfigPlugin,
     getAgenticManagementIntentPlugin,
-    updateAgenticManagementIntentPlugin
+    updateAgenticManagementIntentPlugin,
+    // VFS (experimental). Also routed through the Public API Gateway — see the
+    // `/vfs` entry in api/routing/config.ts. `list*` is exported before the
+    // other methods per the same listing-first convention as code substrate.
+    listVfsDirectoryPlugin,
+    readVfsFilePlugin,
+    writeVfsFilePlugin,
+    appendVfsFilePlugin,
+    copyVfsFilePlugin,
+    createVfsDirectoryPlugin,
+    statVfsPathPlugin,
+    deleteVfsPathPlugin,
+    moveVfsPathPlugin
   ]
 });
 function createZapierSdk(options = {}) {