@zapier/zapier-sdk 0.36.0 → 0.38.0

package/dist/index.mjs

@@ -76,6 +76,9 @@ var ActionTypePropertySchema = z.enum([
 var ActionKeyPropertySchema = z.string().min(1).describe("Action key to execute");
 var ConnectionIdPropertySchema = z.union([z.string(), z.number().int().positive()]).describe("Connection ID to use for this action");
 var AuthenticationIdPropertySchema = ConnectionIdPropertySchema;
+var ConnectionPropertySchema = z.union([z.string(), z.number().int().positive()]).describe(
+  "Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly."
+);
 var InputsPropertySchema = z.record(z.string(), z.unknown()).describe("Input parameters for the action");
 var LimitPropertySchema = z.number().int().min(1).max(MAX_PAGE_LIMIT).default(50).describe("Maximum number of items to return");
 var OffsetPropertySchema = z.number().int().min(0).default(0).describe("Number of items to skip for pagination");
@@ -250,6 +253,7 @@ HTTP Status: ${error.statusCode}`;
 var ActionExecutionInputSchema = z.object({
   inputs: z.record(z.string(), z.unknown()).optional(),
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional(),
   timeoutMs: ActionTimeoutMsPropertySchema
@@ -258,9 +262,10 @@ var ActionExecutionInputSchema = z.object({
 );
 var AppFactoryInputSchema = z.object({
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional()
-}).describe("Bind a connection ID to an app");
+}).describe("Bind a connection alias or numeric connectionId to an app");
 function getStringProperty(obj, key) {
   if (typeof obj === "object" && obj !== null && key in obj) {
     const value = obj[key];
@@ -288,44 +293,80 @@ var ActionResultItemSchema = withFormatter(
 );
 
 // src/plugins/apps/index.ts
-function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
+function resolveProxyConnection({
+  providedConnectionId,
+  providedConnection,
+  providedAuthenticationId,
+  pinnedAuthId,
+  pinnedConnection,
+  errorContext
+}) {
+  const hasDirectId = providedConnectionId != null || providedAuthenticationId != null;
+  if (hasDirectId && providedConnection != null) {
+    throw new ZapierValidationError(
+      "Cannot specify both connectionId/authenticationId and connection. Use connectionId for a direct ID, or connection for an alias or numeric ID."
+    );
+  }
+  const hasPerCall = providedConnectionId != null || providedConnection != null || providedAuthenticationId != null;
+  let finalConnectionId;
+  let finalConnection;
+  if (hasPerCall) {
+    finalConnectionId = providedConnectionId ?? providedAuthenticationId;
+    finalConnection = finalConnectionId != null ? void 0 : providedConnection;
+  } else {
+    finalConnectionId = pinnedAuthId;
+    finalConnection = pinnedAuthId != null ? void 0 : pinnedConnection;
+  }
+  if (finalConnectionId == null && finalConnection == null) {
+    throw new ZapierValidationError(errorContext);
+  }
+  return { connectionId: finalConnectionId, connection: finalConnection };
+}
+function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId, pinnedConnection) {
   return (actionOptions = {}) => {
     const { sdk } = options;
     const {
       inputs,
       connectionId: providedConnectionId,
+      connection: providedConnection,
       authenticationId: providedAuthenticationId,
       timeoutMs
     } = actionOptions;
-    const resolvedConnectionId = pinnedAuthId ?? providedConnectionId ?? providedAuthenticationId;
-    if (!resolvedConnectionId) {
-      throw new ZapierValidationError(
-        `Connection ID is required. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }) or provide connectionId in the action call.`
-      );
-    }
+    const { connectionId, connection } = resolveProxyConnection({
+      providedConnectionId,
+      providedConnection,
+      providedAuthenticationId,
+      pinnedAuthId,
+      pinnedConnection,
+      errorContext: `Connection is required. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }) or sdk.apps.${appKey}({ connection: "name" }), or provide connectionId/connection in the action call.`
+    });
     return sdk.runAction({
       appKey,
       actionType,
       actionKey,
       inputs,
-      connectionId: resolvedConnectionId,
+      connectionId,
+      connection,
       timeoutMs
     });
   };
 }
-function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
+function createActionTypeProxy(appKey, actionType, options, pinnedAuthId, pinnedConnection) {
   if (actionType === "fetch") {
     return async (url, init) => {
       const { sdk } = options;
-      const resolvedConnectionId = pinnedAuthId ?? init?.connectionId ?? init?.authenticationId;
-      if (!resolvedConnectionId) {
-        throw new ZapierValidationError(
-          `Connection ID is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId in the fetch call.`
-        );
-      }
+      const { connectionId, connection } = resolveProxyConnection({
+        providedConnectionId: init?.connectionId,
+        providedConnection: init?.connection,
+        providedAuthenticationId: init?.authenticationId,
+        pinnedAuthId,
+        pinnedConnection,
+        errorContext: `Connection is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ connectionId }).fetch(...) or provide connectionId/connection in the fetch call.`
+      });
       return sdk.fetch(url, {
         ...init,
-        connectionId: resolvedConnectionId
+        connectionId,
+        connection
       });
     };
   }
@@ -339,7 +380,8 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
             actionType,
             actionKey,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -347,7 +389,7 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
     }
   );
 }
-function createPinnedAppProxy(appKey, options, pinnedAuthId) {
+function createPinnedAppProxy(appKey, options, pinnedAuthId, pinnedConnection) {
   return new Proxy(
     {},
     {
@@ -357,7 +399,8 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
             appKey,
             actionType,
             options,
-            pinnedAuthId
+            pinnedAuthId,
+            pinnedConnection
           );
         }
         return void 0;
@@ -368,12 +411,23 @@ function createPinnedAppProxy(appKey, options, pinnedAuthId) {
 function createAppProxy(appKey, options) {
   const appFactory = (factoryOptions) => {
     const resolvedConnectionId = factoryOptions.connectionId ?? factoryOptions.authenticationId;
-    if (!resolvedConnectionId) {
+    const resolvedConnection = factoryOptions.connection;
+    if (resolvedConnectionId != null && resolvedConnection != null) {
       throw new ZapierValidationError(
-        `Connection ID is required. Use sdk.apps.${appKey}({ connectionId: "..." })`
+        "Cannot specify both connectionId/authenticationId and connection. Use connectionId for a direct ID, or connection for an alias or numeric ID."
       );
     }
-    return createPinnedAppProxy(appKey, options, resolvedConnectionId);
+    if (resolvedConnectionId == null && resolvedConnection == null) {
+      throw new ZapierValidationError(
+        `Connection is required. Use sdk.apps.${appKey}({ connectionId: "..." }) or sdk.apps.${appKey}({ connection: "name" })`
+      );
+    }
+    return createPinnedAppProxy(
+      appKey,
+      options,
+      resolvedConnectionId,
+      resolvedConnection
+    );
   };
   return new Proxy(appFactory, {
     get(_, actionType) {
@@ -436,6 +490,7 @@ var FetchInitSchema = z.object({
     "Request body \u2014 plain objects and JSON strings are auto-detected and Content-Type is set accordingly"
   ),
   connectionId: ConnectionIdPropertySchema.optional(),
+  connection: ConnectionPropertySchema.optional(),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: z.string().optional().describe("URL to send async response to (makes request async)")
@@ -443,6 +498,119 @@ var FetchInitSchema = z.object({
   "Request options including method, headers, body, and authentication"
 );
 
+// src/utils/domain-utils.ts
+async function resolveConnectionId({
+  connectionId,
+  connection,
+  authenticationId,
+  resolveConnection,
+  label
+}) {
+  const hasDirectId = connectionId != null || authenticationId != null;
+  if (hasDirectId && connection != null) {
+    const context = label ? ` for ${label}` : "";
+    throw new ZapierValidationError(
+      `Cannot specify both connectionId/authenticationId and connection${context}. Use connectionId for a direct ID, or connection for an alias or numeric ID.`
+    );
+  }
+  let resolvedConnectionId = connectionId ?? authenticationId ?? void 0;
+  if (connection != null && resolvedConnectionId == null) {
+    if (typeof connection === "number") {
+      resolvedConnectionId = connection;
+    } else {
+      const entry = await resolveConnection(connection);
+      if (!entry) {
+        throw new ZapierConfigurationError(
+          `Connection "${connection}" not found in connections map. Ensure the connection is defined in the manifest connections, or use a numeric connectionId.`,
+          { configType: "connections" }
+        );
+      }
+      resolvedConnectionId = entry.connectionId;
+    }
+  }
+  return resolvedConnectionId;
+}
+function splitVersionedKey(versionedKey) {
+  const parts = versionedKey.split("@");
+  if (parts.length >= 2) {
+    const baseKey = parts[0];
+    const version = parts.slice(1).join("@");
+    return [baseKey, version];
+  }
+  return [versionedKey, void 0];
+}
+function normalizeImplementationMetaToAppItem(implementationMeta) {
+  const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
+  const { id, name, ...restOfImplementationMeta } = implementationMeta;
+  return {
+    ...restOfImplementationMeta,
+    title: name,
+    key: selectedApi,
+    implementation_id: id,
+    version: appVersion
+  };
+}
+function normalizeActionItem(action) {
+  const { name, type, selected_api: selectedApi } = action;
+  const [appKey, appVersion] = selectedApi ? splitVersionedKey(selectedApi) : ["", void 0];
+  return {
+    // Only include the fields we want - explicitly list them
+    id: action.id,
+    key: action.key,
+    description: action.description,
+    is_important: action.is_important,
+    is_hidden: action.is_hidden,
+    // Transformed fields
+    app_key: appKey,
+    app_version: appVersion,
+    action_type: type,
+    title: name,
+    // Map name to title
+    type: "action"
+  };
+}
+function isSlug(slug) {
+  return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+}
+function isSnakeCasedSlug(slug) {
+  if (slug.match(/^_[0-9]/)) {
+    slug = slug.slice(1);
+  }
+  return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
+}
+function dashifySnakeCasedSlug(slug) {
+  if (!isSnakeCasedSlug(slug)) {
+    return slug;
+  }
+  if (slug.startsWith("_")) {
+    slug = slug.slice(1);
+  }
+  return slug.replace(/_/g, "-");
+}
+function isUuid(appKey) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    appKey
+  );
+}
+function toAppLocator(appKey) {
+  const [appKeyWithoutVersion, version] = splitVersionedKey(appKey);
+  if (isUuid(appKeyWithoutVersion)) {
+    throw new Error(
+      `UUID app keys are not supported. Use app slug or implementation ID instead of: ${appKey}`
+    );
+  }
+  const slug = isSlug(appKeyWithoutVersion) ? appKeyWithoutVersion : isSnakeCasedSlug(appKeyWithoutVersion) ? dashifySnakeCasedSlug(appKeyWithoutVersion) : void 0;
+  return {
+    lookupAppKey: appKeyWithoutVersion,
+    slug,
+    implementationName: slug ? void 0 : appKeyWithoutVersion,
+    version
+  };
+}
+function isResolvedAppLocator(appLocator) {
+  return !!appLocator.implementationName;
+}
+
 // src/utils/id-utils.ts
 function coerceToNumericId(fieldName, value) {
   if (value === "") {
@@ -537,8 +705,20 @@ var fetchPlugin = ({ context }) => {
         const startTime = Date.now();
         const isNested = isTelemetryNested();
         try {
-          const { connectionId, authenticationId, callbackUrl, ...fetchInit } = init || {};
-          const resolvedConnectionId = connectionId ?? authenticationId;
+          const {
+            connectionId,
+            connection,
+            authenticationId,
+            callbackUrl,
+            ...fetchInit
+          } = init || {};
+          const resolvedConnectionId = await resolveConnectionId({
+            connectionId,
+            connection,
+            authenticationId,
+            resolveConnection: context.resolveConnection,
+            label: "fetch"
+          });
           const relayPath = transformUrlToRelayPath(url);
           const headers = normalizeHeaders(
             fetchInit.headers
@@ -873,6 +1053,9 @@ function concatPaginated({
     }
   });
 }
+function toIterable(source) {
+  return { [Symbol.asyncIterator]: () => source[Symbol.asyncIterator]() };
+}
 
 // src/utils/validation.ts
 var validate = (schema, input) => {
@@ -1241,88 +1424,6 @@ var listAppsPlugin = ({ context }) => {
     }
   };
 };
-
-// src/utils/domain-utils.ts
-function splitVersionedKey(versionedKey) {
-  const parts = versionedKey.split("@");
-  if (parts.length >= 2) {
-    const baseKey = parts[0];
-    const version = parts.slice(1).join("@");
-    return [baseKey, version];
-  }
-  return [versionedKey, void 0];
-}
-function normalizeImplementationMetaToAppItem(implementationMeta) {
-  const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
-  const { id, name, ...restOfImplementationMeta } = implementationMeta;
-  return {
-    ...restOfImplementationMeta,
-    title: name,
-    key: selectedApi,
-    implementation_id: id,
-    version: appVersion
-  };
-}
-function normalizeActionItem(action) {
-  const { name, type, selected_api: selectedApi } = action;
-  const [appKey, appVersion] = selectedApi ? splitVersionedKey(selectedApi) : ["", void 0];
-  return {
-    // Only include the fields we want - explicitly list them
-    id: action.id,
-    key: action.key,
-    description: action.description,
-    is_important: action.is_important,
-    is_hidden: action.is_hidden,
-    // Transformed fields
-    app_key: appKey,
-    app_version: appVersion,
-    action_type: type,
-    title: name,
-    // Map name to title
-    type: "action"
-  };
-}
-function isSlug(slug) {
-  return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
-}
-function isSnakeCasedSlug(slug) {
-  if (slug.match(/^_[0-9]/)) {
-    slug = slug.slice(1);
-  }
-  return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
-}
-function dashifySnakeCasedSlug(slug) {
-  if (!isSnakeCasedSlug(slug)) {
-    return slug;
-  }
-  if (slug.startsWith("_")) {
-    slug = slug.slice(1);
-  }
-  return slug.replace(/_/g, "-");
-}
-function isUuid(appKey) {
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
-    appKey
-  );
-}
-function toAppLocator(appKey) {
-  const [appKeyWithoutVersion, version] = splitVersionedKey(appKey);
-  if (isUuid(appKeyWithoutVersion)) {
-    throw new Error(
-      `UUID app keys are not supported. Use app slug or implementation ID instead of: ${appKey}`
-    );
-  }
-  const slug = isSlug(appKeyWithoutVersion) ? appKeyWithoutVersion : isSnakeCasedSlug(appKeyWithoutVersion) ? dashifySnakeCasedSlug(appKeyWithoutVersion) : void 0;
-  return {
-    lookupAppKey: appKeyWithoutVersion,
-    slug,
-    implementationName: slug ? void 0 : appKeyWithoutVersion,
-    version
-  };
-}
-function isResolvedAppLocator(appLocator) {
-  return !!appLocator.implementationName;
-}
 var ListActionsSchema = z.object({
   appKey: AppKeyPropertySchema.describe(
     "App key of actions to list (e.g., 'SlackCLIAPI' or slug like 'github')"
@@ -1732,44 +1833,32 @@ var actionKeyResolver = {
 
 // src/resolvers/connectionId.ts
 async function fetchConnections(sdk, resolvedParams) {
-  const listOptions = {
-    maxItems: 1e3
-  };
-  if (resolvedParams.appKey) {
-    listOptions.appKey = resolvedParams.appKey;
-  }
-  const myConnections = await sdk.listConnections({
-    ...listOptions,
-    owner: "me"
-  });
-  const allConnections = await sdk.listConnections(listOptions);
-  const otherConnections = allConnections.data.filter(
-    (connection) => !myConnections.data.some(
-      (myConnection) => myConnection.id === connection.id
-    )
+  const context = sdk.getContext();
+  const includeShared = await context.hasCapability?.(
+    "canIncludeSharedConnections"
+  );
+  return toIterable(
+    sdk.listConnections({
+      appKey: resolvedParams.appKey,
+      includeShared: includeShared || void 0
+    })
   );
-  return [...myConnections.data, ...otherConnections];
 }
 function promptForConnection(connections, params) {
   return {
     type: "list",
     name: "connectionId",
     message: params.appKey ? `Select connection for ${params.appKey}:` : "Select connection:",
-    choices: [
-      ...connections.map((connection) => ({
-        name: `${connection.title || connection.label || "Connection"} (ID: ${connection.id})`,
-        value: connection.id
-      })),
-      {
-        name: "-> Skip connection (may fail)",
-        value: null
-      }
-    ]
+    choices: connections.map((connection) => ({
+      name: `${connection.title || connection.label || "Connection"} (ID: ${connection.id})`,
+      value: connection.id
+    }))
   };
 }
 var connectionIdResolver = {
   type: "dynamic",
   depends: ["appKey"],
+  requireCapabilities: ["canIncludeSharedConnections"],
   tryResolveWithoutPrompt: async (sdk, params) => {
     if (!params.appKey) return null;
     try {
@@ -1787,6 +1876,7 @@ var connectionIdResolver = {
 var connectionIdGenericResolver = {
   type: "dynamic",
   depends: [],
+  requireCapabilities: ["canIncludeSharedConnections"],
   fetch: fetchConnections,
   prompt: promptForConnection
 };
@@ -1910,11 +2000,24 @@ var clientIdResolver = {
 // src/resolvers/tableId.ts
 var tableIdResolver = {
   type: "dynamic",
-  fetch: (sdk) => {
-    return concatPaginated({
-      sources: [() => sdk.listTables({ owner: "me" }), () => sdk.listTables()],
-      dedupe: (table) => table.id
-    });
+  requireCapabilities: ["canIncludeSharedTables"],
+  fetch: async (sdk) => {
+    const context = sdk.getContext();
+    const includeShared = await context.hasCapability?.(
+      "canIncludeSharedTables"
+    );
+    if (includeShared) {
+      return toIterable(
+        concatPaginated({
+          sources: [
+            () => sdk.listTables(),
+            () => sdk.listTables({ includeShared: true })
+          ],
+          dedupe: (table) => table.id
+        })
+      );
+    }
+    return toIterable(sdk.listTables());
   },
   prompt: (tables) => ({
     type: "list",
@@ -3010,6 +3113,10 @@ var ListConnectionsQuerySchema = ListConnectionsQuerySchema$1.omit({
   ),
   // camelCase account ID
   accountId: z.string().optional().describe("Account ID to filter by"),
+  // Include shared connections (overrides default owner=me filter)
+  includeShared: z.boolean().optional().describe(
+    "Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections."
+  ),
   // camelCase isExpired
   isExpired: z.boolean().optional().describe("Filter by expired status"),
   // Override pageSize to make optional
@@ -3049,6 +3156,9 @@ var ConnectionItemSchema = withFormatter(ConnectionItemSchema$1, {
 // src/plugins/listConnections/index.ts
 var listConnectionsPlugin = ({ context }) => {
   async function listConnectionsPage(options) {
+    if (options.includeShared) {
+      await context.checkCapability("canIncludeSharedConnections");
+    }
     const { api, getVersionedImplementationId } = context;
     const searchParams = {};
     if (options.pageSize !== void 0) {
@@ -3079,8 +3189,14 @@ var listConnectionsPlugin = ({ context }) => {
     if (options.accountId) {
       searchParams.account_id = options.accountId;
     }
-    if (options.owner) {
-      searchParams.owner = options.owner;
+    if (options.owner && options.owner !== "me" && !options.includeShared) {
+      throw new ZapierValidationError(
+        'The "owner" option requires "includeShared" to be true. Without includeShared, only your own connections are returned.'
+      );
+    }
+    const owner = options.includeShared ? options.owner : "me";
+    if (owner) {
+      searchParams.owner = owner;
     }
     if (options.isExpired !== void 0) {
       searchParams.is_expired = options.isExpired.toString();
@@ -3633,6 +3749,9 @@ var RunActionSchema = z.object({
   connectionId: ConnectionIdPropertySchema.nullable().optional().describe(
     "Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service."
   ),
+  connection: ConnectionPropertySchema.optional().describe(
+    "Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. Mutually exclusive with connectionId."
+  ),
   /** @deprecated Use connectionId instead */
   authenticationId: ConnectionIdPropertySchema.nullable().optional(),
   inputs: InputsPropertySchema.optional().describe(
@@ -3761,12 +3880,18 @@ var runActionPlugin = ({ sdk, context }) => {
       actionKey,
       actionType,
       connectionId,
+      connection,
       authenticationId,
       inputs = {},
       cursor,
       timeoutMs
     } = options;
-    const resolvedConnectionId = connectionId ?? authenticationId;
+    const resolvedConnectionId = await resolveConnectionId({
+      connectionId,
+      connection,
+      authenticationId,
+      resolveConnection: context.resolveConnection
+    });
     const { selectedApi, actionId } = await getRunActionContext(options);
     setMethodMetadata({
       selectedApi,
@@ -3962,6 +4087,12 @@ async function readFile(filePath) {
   }
   throw new Error(`File not found: ${filePath}`);
 }
+var ConnectionEntrySchema = z.object({
+  connectionId: z.number().int().positive().describe("Zapier connection ID for the third-party service.")
+});
+var ConnectionsMapSchema = z.record(z.string(), ConnectionEntrySchema);
+
+// src/plugins/manifest/schemas.ts
 var DEFAULT_CONFIG_PATH = ".zapierrc";
 var ActionEntrySchema = z.object({
   appKey: z.string().describe("App key (slug or implementation name)"),
@@ -3985,18 +4116,20 @@ var ManifestSchema = z.object({
       ),
       version: z.string().describe("Version string (e.g., '1.21.1')")
     })
-  ),
-  actions: z.record(z.string(), ActionEntrySchema).optional().describe("Saved action configurations with their schemas")
-}).describe("Manifest for app version locking and action configurations");
+  ).optional(),
+  actions: z.record(z.string(), ActionEntrySchema).optional().describe("Saved action configurations with their schemas"),
+  canIncludeSharedConnections: z.boolean().optional().describe("Allow listing shared connections"),
+  canIncludeSharedTables: z.boolean().optional().describe("Allow listing shared tables"),
+  canDeleteTables: z.boolean().optional().describe("Allow deleting tables"),
+  connections: ConnectionsMapSchema.optional().describe(
+    "Named connections map. Keys are connection names, values contain a connectionId."
+  )
+}).describe(
+  "Manifest for app version locking, action configurations, and named connections"
+);
 z.object({
   manifestPath: z.string().optional().describe("Path to manifest file"),
-  manifest: z.record(
-    z.string(),
-    z.object({
-      implementationName: z.string(),
-      version: z.string().optional()
-    })
-  ).optional().describe("Direct manifest object")
+  manifest: ManifestSchema.optional().describe("Direct manifest object")
 });
 
 // src/utils/array-utils.ts
@@ -4012,13 +4145,14 @@ async function toArrayFromAsync(asyncIterable) {
 function parseManifestContent(content, source) {
   try {
     const parsed = JSON.parse(content);
-    if (parsed?.apps && typeof parsed?.apps === "object") {
-      const result = ManifestSchema.safeParse(parsed);
-      if (result.success) {
-        return result.data;
-      }
-      console.warn(`\u26A0\uFE0F Invalid manifest format in ${source}: ${result.error}`);
+    if (parsed == null || typeof parsed !== "object") {
+      return null;
     }
+    const result = ManifestSchema.safeParse(parsed);
+    if (result.success) {
+      return result.data;
+    }
+    console.warn(`\u26A0\uFE0F Invalid manifest format in ${source}: ${result.error}`);
     return null;
   } catch (error) {
     console.warn(`\u26A0\uFE0F Failed to parse manifest from ${source}:`, error);
@@ -4095,6 +4229,9 @@ function findManifestEntry({
   appKey,
   manifest
 }) {
+  if (!manifest.apps) {
+    return null;
+  }
   const [appKeyWithoutVersion] = splitVersionedKey(appKey);
   if (manifest.apps[appKeyWithoutVersion]) {
     return [appKeyWithoutVersion, manifest.apps[appKeyWithoutVersion]];
@@ -4339,6 +4476,7 @@ var manifestPlugin = (params) => {
   };
   return {
     context: {
+      getResolvedManifest,
       getVersionedImplementationId,
       resolveAppKeys: async ({ appKeys }) => resolveAppKeys({
         appKeys,
@@ -4352,7 +4490,11 @@ var manifestPlugin = (params) => {
       deleteActionEntry,
       hasActionEntry,
       findManifestEntry,
-      readManifestFromFile
+      readManifestFromFile,
+      getManifestConnections: async () => {
+        const manifest2 = await getResolvedManifest();
+        return manifest2?.connections ?? null;
+      }
     }
   };
 };
@@ -5715,6 +5857,92 @@ async function batch(tasks, options = {}) {
   await Promise.all(workers);
   return results;
 }
+
+// src/plugins/connections/index.ts
+var connectionsPlugin = (params) => {
+  const { context } = params;
+  let cachedMap;
+  async function loadConnectionsMap() {
+    if (cachedMap === void 0) {
+      cachedMap = await context.getManifestConnections() ?? null;
+    }
+    return cachedMap;
+  }
+  return {
+    context: {
+      resolveConnection: async (name) => {
+        const map = await loadConnectionsMap();
+        return map?.[name];
+      },
+      getConnectionsMap: async () => {
+        return loadConnectionsMap();
+      }
+    }
+  };
+};
+
+// src/plugins/capabilities/index.ts
+function toDescription(key) {
+  const words = key.replace(/^can/, "").replace(/([A-Z])/g, " $1").trim().toLowerCase();
+  return `To ${words}`;
+}
+function toEnvVar(key) {
+  return "ZAPIER_" + key.replace(/([A-Z])/g, "_$1").toUpperCase();
+}
+function toCliFlag(key) {
+  return "--" + key.replace(/([A-Z])/g, "-$1").toLowerCase();
+}
+function buildCapabilityMessage(key) {
+  return [
+    `${toDescription(key)}, use ${toCliFlag(key)} in the CLI,`,
+    `set ${key}: true in SDK options or .zapierrc,`,
+    `or set ${toEnvVar(key)}=true.`
+  ].join(" ");
+}
+var GATED_FLAGS = [
+  "canIncludeSharedConnections",
+  "canIncludeSharedTables",
+  "canDeleteTables"
+];
+function isEnabledByEnv(key) {
+  if (typeof process === "undefined") return void 0;
+  const value = process.env[toEnvVar(key)];
+  if (value === void 0) return void 0;
+  if (value === "true" || value === "1") return true;
+  if (value === "false" || value === "0") return false;
+  return void 0;
+}
+var capabilitiesPlugin = ({ context }) => {
+  const options = context.options ?? {};
+  let cached;
+  async function resolveFlags() {
+    if (cached) return cached;
+    const manifest = await context.getResolvedManifest();
+    cached = {};
+    for (const flag of GATED_FLAGS) {
+      cached[flag] = Boolean(
+        options[flag] ?? isEnabledByEnv(flag) ?? manifest?.[flag]
+      );
+    }
+    return cached;
+  }
+  return {
+    context: {
+      checkCapability: async (key) => {
+        const flags = await resolveFlags();
+        if (flags[key]) return;
+        throw new ZapierConfigurationError(
+          buildCapabilityMessage(key) + " (If you are an AI agent, you MUST NOT retry. Ask the user if they want to enable this.)",
+          { configType: key }
+        );
+      },
+      hasCapability: async (key) => {
+        const flags = await resolveFlags();
+        return flags[key];
+      }
+    }
+  };
+};
 var TableApiItemSchema = z.object({
   id: z.string(),
   name: z.string(),
@@ -5749,7 +5977,10 @@ var ListTablesOptionsSchema = z.object({
   kind: z.enum(["table", "virtual_table", "both"]).optional().describe("Filter by table type"),
   search: z.string().optional().describe("Search term to filter tables by name"),
   owner: z.string().optional().describe(
-    'Filter by table owner. Use "me" for the current user, or a numeric user ID.'
+    'Filter by table owner. Use "me" for the current user, or a numeric user ID. Requires includeShared to be true.'
+  ),
+  includeShared: z.boolean().optional().describe(
+    "Include tables shared with you. Without this, only your own tables are returned."
   ),
   pageSize: z.number().min(1).optional().describe("Number of tables per page"),
   maxItems: z.number().min(1).optional().describe("Maximum total items to return across all pages"),
@@ -5771,6 +6002,9 @@ function extractNextCursor(links) {
 }
 var listTablesPlugin = ({ context }) => {
   async function listTablesPage(options) {
+    if (options.includeShared) {
+      await context.checkCapability("canIncludeSharedTables");
+    }
     const { api } = context;
     const searchParams = {};
     if (options.pageSize !== void 0) {
@@ -5785,15 +6019,23 @@ var listTablesPlugin = ({ context }) => {
     if (options?.search) {
       searchParams.q = options.search;
     }
-    if (options?.owner) {
-      let ownerId = options.owner;
-      if (ownerId === "me") {
+    if (options?.owner && options.owner !== "me" && !options.includeShared) {
+      throw new ZapierValidationError(
+        'The "owner" option requires "includeShared" to be true. Without includeShared, only your own tables are returned.'
+      );
+    }
+    const owner = options.includeShared ? options.owner : "me";
+    if (owner) {
+      if (owner === "me") {
         const profile = await api.get("/zapier/api/v4/profile/", {
           authRequired: true
         });
-        ownerId = String(profile.id);
+        searchParams.owner_customuser_id = String(
+          profile.id
+        );
+      } else {
+        searchParams.owner_customuser_id = owner;
       }
-      searchParams.owner_customuser_id = ownerId;
     }
     if (options.cursor) {
       searchParams.offset = options.cursor;
@@ -5987,6 +6229,7 @@ var DeleteTableOptionsSchema = z.object({
 // src/plugins/tables/deleteTable/index.ts
 var deleteTablePlugin = ({ context }) => {
   async function deleteTable(options) {
+    await context.checkCapability("canDeleteTables");
     const { api } = context;
     await api.delete(`/tables/api/v1/tables/${options.tableId}`, void 0, {
       customErrorHandler: ({ status }) => {
@@ -7396,7 +7639,7 @@ function getCpuTime() {
 }
 
 // src/plugins/eventEmission/builders.ts
-var SDK_VERSION = "0.36.0";
+var SDK_VERSION = "0.38.0";
 function createBaseEvent(context = {}) {
   return {
     event_id: generateEventId(),
@@ -7889,7 +8132,7 @@ function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} })
   };
 }
 function createZapierSdkWithoutRegistry(options = {}) {
-  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
+  return createSdk(options).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listInputFieldsPlugin).addPlugin(getInputFieldsSchemaPlugin).addPlugin(listInputFieldChoicesPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
@@ -7918,9 +8161,12 @@ var BaseSdkOptionsSchema = z.object({
   onEvent: z.custom().optional().meta({ internal: true }),
   fetch: z.custom().optional().meta({ internal: true }),
   eventEmission: z.custom().optional().meta({ internal: true }),
+  canIncludeSharedConnections: z.boolean().optional().describe("Allow listing shared connections."),
+  canIncludeSharedTables: z.boolean().optional().describe("Allow listing shared tables."),
+  canDeleteTables: z.boolean().optional().describe("Allow deleting tables."),
   // Deprecated
   token: z.string().optional().meta({ deprecated: true })
   // Use credentials instead
 });
 
-export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionIdPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_PAGE_SIZE, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, updateTableRecordsPlugin };
+export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DEFAULT_PAGE_SIZE, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, toSnakeCase, toTitleCase, updateTableRecordsPlugin };