@zapier/zapier-sdk 0.5.2 → 0.6.0

package/dist/plugins/runAction/index.test.js

@@ -36,13 +36,14 @@ describe("runAction plugin", () => {
         mockGetAction = vi.fn().mockResolvedValue({
             data: mockAction,
         });
-        mockGetApp = vi.fn().mockResolvedValue({
-            data: { current_implementation_id: "SlackCLIAPI" },
-        });
     });
     function createTestSdk() {
-        return createSdk({ getAction: mockGetAction, getApp: mockGetApp }, // Provide getAction and getApp in SDK
-        { api: mockApiClient, meta: {} }).addPlugin(runActionPlugin);
+        return createSdk({}, { getAction: mockGetAction, getApp: mockGetApp }, // Provide getAction and getApp in SDK
+        {
+            api: mockApiClient,
+            meta: {},
+            getVersionedImplementationId: () => "SlackCLIAPI@1.21.1",
+        }).addPlugin(runActionPlugin);
     }
     describe("schema validation", () => {
         it("should throw validation error for missing appKey", () => {
@@ -126,7 +127,7 @@ describe("runAction plugin", () => {
             });
             expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", {
                 data: {
-                    selected_api: "SlackCLIAPI",
+                    selected_api: "SlackCLIAPI@1.21.1",
                     action_key: "send_message",
                     action_type: "write",
                     inputs: { message: "Hello", channel: "#general" },
@@ -149,7 +150,7 @@ describe("runAction plugin", () => {
             });
             expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", {
                 data: {
-                    selected_api: "SlackCLIAPI",
+                    selected_api: "SlackCLIAPI@1.21.1",
                     action_key: "send_message",
                     action_type: "write",
                     inputs: { message: "Hello" },
@@ -170,7 +171,7 @@ describe("runAction plugin", () => {
             expect(mockApiClient.post).toHaveBeenCalledWith("/api/actions/v1/runs", expect.objectContaining({
                 data: expect.objectContaining({
                     inputs: { message: "Hello" },
-                    selected_api: "SlackCLIAPI",
+                    selected_api: "SlackCLIAPI@1.21.1",
                     action_key: "send_message",
                     action_type: "write",
                 }),

package/dist/plugins/runAction/schemas.d.ts

@@ -13,17 +13,17 @@ export declare const RunActionSchema: z.ZodObject<{
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
 }, {
     appKey: string;
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
 }>;
 export type RunActionOptions = z.infer<typeof RunActionSchema>;
 export interface RunActionPage {

package/dist/sdk.d.ts

@@ -1,10 +1,10 @@
 import { BaseSdkOptions } from "./types/sdk";
 import type { ZapierSdk } from "./types/sdk";
-import type { Sdk } from "./types/plugin";
+import type { Sdk, PluginMeta } from "./types/plugin";
 export interface ZapierSdkOptions extends BaseSdkOptions {
 }
 export declare function createSdk<TCurrentSdk = {}, TCurrentContext = {
-    meta: Record<string, any>;
-}>(initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): Sdk<TCurrentSdk, TCurrentContext>;
+    meta: Record<string, PluginMeta>;
+}>(options?: ZapierSdkOptions, initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): Sdk<TCurrentSdk, TCurrentContext>;
 export declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 //# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,GAAG,EAIJ,MAAM,gBAAgB,CAAC;AAuBxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,wBAAgB,SAAS,CACvB,WAAW,GAAG,EAAE,EAChB,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,EAE/C,UAAU,GAAE,WAA+B,EAC3C,cAAc,GAAE,eAAiD,GAChE,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAgEnC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAmCzE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,GAAG,EAIH,UAAU,EACX,MAAM,gBAAgB,CAAC;AAyBxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,wBAAgB,SAAS,CACvB,WAAW,GAAG,EAAE,EAChB,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,EAEtD,OAAO,GAAE,gBAAqB,EAC9B,UAAU,GAAE,WAA+B,EAC3C,cAAc,GAAE,eAAiD,GAChE,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAqEnC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAyCzE"}

package/dist/sdk.js

@@ -15,12 +15,14 @@ import { findFirstAuthenticationPlugin } from "./plugins/findFirstAuthentication
 import { findUniqueAuthenticationPlugin } from "./plugins/findUniqueAuthentication";
 import { listInputFieldsPlugin } from "./plugins/listInputFields";
 import { requestPlugin } from "./plugins/request";
+import { manifestPlugin } from "./plugins/manifest";
+import { lockVersionPlugin } from "./plugins/lockVersion";
 // Create SDK that supports flat plugins - returns an SDK, not a builder
-export function createSdk(initialSdk = {}, initialContext = { meta: {} }) {
+export function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} }) {
     return {
         ...initialSdk,
         getContext: () => initialContext,
-        addPlugin(plugin, options = {}) {
+        addPlugin(plugin, addPluginOptions = {}) {
             // Create SDK with getContext method for plugins to use
             const currentSdkWithContext = {
                 ...initialSdk,
@@ -29,8 +31,12 @@ export function createSdk(initialSdk = {}, initialContext = { meta: {} }) {
             // Apply the plugin with options merged in
             const pluginResult = plugin({
                 sdk: currentSdkWithContext,
-                context: initialContext,
-                ...options,
+                context: {
+                    ...initialContext,
+                    // Add the options that createSdk was called with to context
+                    options,
+                },
+                ...addPluginOptions,
             });
             // Extract context from plugin result if present
             const { context: pluginContext, ...sdkProperties } = pluginResult;
@@ -40,6 +46,7 @@ export function createSdk(initialSdk = {}, initialContext = { meta: {} }) {
             // Ensure meta is always present, starting with existing or empty object
             let newContext = {
                 ...initialContext,
+                ...addPluginOptions,
                 meta: initialContext.meta || {},
             };
             if (pluginContext) {
@@ -61,22 +68,26 @@ export function createSdk(initialSdk = {}, initialContext = { meta: {} }) {
                 }
             }
             // Recursively create new SDK with updated properties
-            return createSdk(newSdk, newContext);
+            return createSdk(options, newSdk, newContext);
         },
     };
 }
 export function createZapierSdk(options = {}) {
-    return (createSdk()
+    return (createSdk(options)
         // Provides the API client in context
-        .addPlugin(apiPlugin, options)
+        .addPlugin(apiPlugin)
+        // Manifest plugin (provides version locking context)
         // Apps/actions/fields
         .addPlugin(listAppsPlugin)
+        .addPlugin(manifestPlugin)
         .addPlugin(getAppPlugin)
         .addPlugin(listActionsPlugin)
         .addPlugin(getActionPlugin)
         .addPlugin(listInputFieldsPlugin)
         // Run action
         .addPlugin(runActionPlugin)
+        // Version locking
+        .addPlugin(lockVersionPlugin)
         // Authentications
         .addPlugin(listAuthenticationsPlugin)
         .addPlugin(getAuthenticationPlugin)

package/dist/sdk.test.js

@@ -113,7 +113,7 @@ describe("Flat Plugin System", () => {
         });
         const baseSdk = { existingMethod: () => "base" };
         const baseContext = { customContext: "custom", meta: {} };
-        const sdk = createSdk(baseSdk, baseContext).addPlugin(pluginWithHelper);
+        const sdk = createSdk({}, baseSdk, baseContext).addPlugin(pluginWithHelper);
         expect(sdk.helperMethod()).toBe("Helper: base + custom");
         expect(sdk.existingMethod()).toBe("base"); // Original method still works
     });

package/dist/types/plugin.d.ts

@@ -6,6 +6,8 @@
  * This system makes context dependencies explicit to restore TypeScript's
  * ability to catch missing context at compile time.
  */
+import type { z } from "zod";
+import { BaseSdkOptions } from "./sdk";
 export interface PluginDependencies<TSdk = {}, TContext = {}> {
     sdk: TSdk;
     context: TContext;
@@ -13,6 +15,11 @@ export interface PluginDependencies<TSdk = {}, TContext = {}> {
 export interface PluginProvides extends Record<string, any> {
     context?: Record<string, any>;
 }
+export interface PluginMeta {
+    categories: string[];
+    inputSchema: z.ZodSchema;
+    [key: string]: any;
+}
 export type ExtractSdkProperties<T extends Record<string, any>> = Omit<T, "context">;
 export type ExtractContextProperties<T extends PluginProvides> = T["context"];
 export type GetSdkType<TPluginProvides extends PluginProvides> = ExtractSdkProperties<TPluginProvides> & {
@@ -35,7 +42,8 @@ export interface Plugin<TSdk = {}, TRequiresContext = {}, TProvides extends Plug
     (params: {
         sdk: TSdk;
         context: TRequiresContext & {
-            meta: Record<string, any>;
+            meta: Record<string, PluginMeta>;
+            options: BaseSdkOptions;
         };
     }): TProvides;
 }
@@ -50,7 +58,7 @@ type ContextError<TRequired, TCurrent> = MissingContextKeys<TRequired, TCurrent>
  * If not, TypeScript will emit a detailed error showing missing properties.
  */
 export type Sdk<TCurrentSdk = {}, TCurrentContext = {
-    meta: Record<string, any>;
+    meta: Record<string, PluginMeta>;
 }> = TCurrentSdk & {
     addPlugin<TRequiresContext, TProvides extends PluginProvides>(plugin: Plugin<TCurrentSdk & {
         getContext(): TCurrentContext;

package/dist/types/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}

package/dist/types/sdk.d.ts

@@ -9,12 +9,22 @@ export interface BaseSdkOptions {
     fetch?: typeof fetch;
     baseUrl?: string;
     debug?: boolean;
+    manifestPath?: string;
+    manifest?: {
+        apps: {
+            [appKey: string]: {
+                implementationName: string;
+                version?: string;
+            };
+        };
+    };
 }
 import type { ListInputFieldsSdkFunction } from "../plugins/listInputFields/schemas";
 import type { GetAuthenticationSdkFunction } from "../plugins/getAuthentication/schemas";
 import type { FindFirstAuthenticationSdkFunction } from "../plugins/findFirstAuthentication/schemas";
 import type { FindUniqueAuthenticationSdkFunction } from "../plugins/findUniqueAuthentication/schemas";
 import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
+import type { LockVersionPluginProvides } from "../plugins/lockVersion";
 import type { z } from "zod";
 import { RegistryPluginProvides } from "../plugins/registry";
 import { GetProfilePluginProvides } from "../plugins/getProfile";
@@ -32,12 +42,13 @@ import { FindUniqueAuthenticationPluginProvides } from "../plugins/findUniqueAut
 import { ListInputFieldsPluginProvides } from "../plugins/listInputFields";
 import { RequestPluginProvides } from "../plugins/request";
 import { GetSdkType } from "./plugin";
+import { ManifestPluginProvides } from "../plugins/manifest";
 export interface FunctionRegistryEntry {
     name: string;
     inputSchema: z.ZodSchema;
-    implementation: Function;
+    categories: string[];
 }
 export interface ZapierSdkFunctions extends ListInputFieldsSdkFunction, GetAuthenticationSdkFunction, FindFirstAuthenticationSdkFunction, FindUniqueAuthenticationSdkFunction, RelayRequestSdkFunction {
 }
-export type ZapierSdk = GetSdkType<RegistryPluginProvides & FetchPluginProvides & AppsPluginProvides & ListAppsPluginProvides & GetAppPluginProvides & ListActionsPluginProvides & GetActionPluginProvides & RunActionPluginProvides & ListAuthenticationsPluginProvides & GetAuthenticationPluginProvides & FindFirstAuthenticationPluginProvides & FindUniqueAuthenticationPluginProvides & ListInputFieldsPluginProvides & RequestPluginProvides & GetProfilePluginProvides>;
+export type ZapierSdk = GetSdkType<RegistryPluginProvides & FetchPluginProvides & AppsPluginProvides & ListAppsPluginProvides & ManifestPluginProvides & GetAppPluginProvides & ListActionsPluginProvides & GetActionPluginProvides & RunActionPluginProvides & LockVersionPluginProvides & ListAuthenticationsPluginProvides & GetAuthenticationPluginProvides & FindFirstAuthenticationPluginProvides & FindUniqueAuthenticationPluginProvides & ListInputFieldsPluginProvides & RequestPluginProvides & GetProfilePluginProvides>;
 //# sourceMappingURL=sdk.d.ts.map

package/dist/types/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAGD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AACrG,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;IACzB,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAGD,MAAM,WAAW,kBACf,SAAQ,0BAA0B,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,mCAAmC,EACnC,uBAAuB;CAE1B;AAUD,MAAM,MAAM,SAAS,GAAG,UAAU,CAChC,sBAAsB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,GACvB,uBAAuB,GACvB,iCAAiC,GACjC,+BAA+B,GAC/B,qCAAqC,GACrC,sCAAsC,GACtC,6BAA6B,GAC7B,qBAAqB,GACrB,wBAAwB,CAC3B,CAAC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -33,8 +33,6 @@ export * from "./auth";
 // Export resolvers for CLI use
 export * from "./resolvers";
 
-// Note: SdkSchemas is now available via SDK.__registry
-
 // All functions now available through the plugin system via createZapierSdk()
 // Export plugin schemas for external use
 export {

package/src/plugins/api/index.ts

@@ -26,7 +26,7 @@ export const apiPlugin: Plugin<
     getToken,
     onEvent,
     debug = false,
-  } = params as any;
+  } = params.context.options;
 
   // Create the API client - it will handle token resolution internally
   const api = createZapierApi({

package/src/plugins/findFirstAuthentication/index.ts

@@ -47,6 +47,7 @@ export const findFirstAuthenticationPlugin: Plugin<
     context: {
       meta: {
         findFirstAuthentication: {
+          categories: ["authentication"],
           inputSchema: FindFirstAuthenticationSchema,
         },
       },

package/src/plugins/findUniqueAuthentication/index.ts

@@ -64,6 +64,7 @@ export const findUniqueAuthenticationPlugin: Plugin<
     context: {
       meta: {
         findUniqueAuthentication: {
+          categories: ["authentication"],
           inputSchema: FindUniqueAuthenticationSchema,
         },
       },

package/src/plugins/getAction/index.test.ts

@@ -63,7 +63,7 @@ describe("getAction plugin", () => {
     });
 
     // Build SDK with proper plugin composition, providing API in initial context
-    return createSdk({}, { api: mockApiClient, meta: {} })
+    return createSdk({}, {}, { api: mockApiClient, meta: {} })
       .addPlugin(mockListActionsPlugin)
       .addPlugin(getActionPlugin);
   }

package/src/plugins/getAction/index.ts

@@ -49,6 +49,7 @@ export const getActionPlugin: Plugin<
     context: {
       meta: {
         getAction: {
+          categories: ["action"],
           inputSchema: GetActionSchema,
         },
       },

package/src/plugins/getApp/index.test.ts

@@ -7,11 +7,13 @@ import { getAppPlugin } from "./index";
 import { createSdk } from "../../sdk";
 import { apiPlugin } from "../api/index";
 import { listAppsPlugin } from "../listApps";
+import { manifestPlugin } from "../manifest";
 
 function createTestSdk() {
   return createSdk()
     .addPlugin(apiPlugin, { fetch: global.fetch })
     .addPlugin(listAppsPlugin)
+    .addPlugin(manifestPlugin)
     .addPlugin(getAppPlugin);
 }
 

package/src/plugins/getApp/index.ts

@@ -4,8 +4,9 @@ import { GetAppSchema } from "./schemas";
 import type { GetAppOptions } from "./schemas";
 import type { AppItem } from "../../types/domain";
 import { ZapierAppNotFoundError } from "../../types/errors";
-import type { ListAppsPluginProvides } from "../listApps";
 import type { GetSdkType } from "../../types/plugin";
+import { GetImplementation } from "../manifest/schemas";
+import { ManifestPluginProvides } from "../manifest";
 
 // GetApp plugin provides interface - getApp goes directly to SDK root
 export interface GetAppPluginProvides {
@@ -21,34 +22,20 @@ export interface GetAppPluginProvides {
 
 // GetApp plugin depends on listApps SDK function
 export const getAppPlugin: Plugin<
-  GetSdkType<ListAppsPluginProvides>, // depends on listApps
-  {}, // no additional context dependencies
+  GetSdkType<ManifestPluginProvides>, // depends on manifest plugin with getImplementation in context
+  { getImplementation: GetImplementation }, //
   GetAppPluginProvides
-> = ({ sdk }) => {
+> = ({ context }) => {
   const getApp = createFunction(async function getApp(options: GetAppOptions) {
-    const { appKey } = options;
-
-    // Use listApps to get the app by key
-    const appsIterator = sdk
-      .listApps({
-        ...options,
-        appKeys: [appKey],
-      })
-      .items();
-
-    // Get the first (and should be only) result
-    const apps = [];
-    for await (const app of appsIterator) {
-      apps.push(app);
-      break; // Only need the first result
-    }
-
-    if (apps.length === 0) {
-      throw new ZapierAppNotFoundError(appKey);
+    const app = await context.getImplementation(options.appKey);
+    if (!app) {
+      throw new ZapierAppNotFoundError("App not found", {
+        appKey: options.appKey,
+      });
     }
 
     return {
-      data: apps[0],
+      data: app,
     };
   }, GetAppSchema);
 
@@ -58,6 +45,7 @@ export const getAppPlugin: Plugin<
     context: {
       meta: {
         getApp: {
+          categories: ["app"],
           inputSchema: GetAppSchema,
         },
       },

package/src/plugins/getAuthentication/index.test.ts

@@ -9,6 +9,8 @@ import { createSdk } from "../../sdk";
 import type { ApiClient } from "../../api";
 import type { GetAuthenticationOptions } from "./schemas";
 import type { Authentication } from "../../api/types";
+import { manifestPlugin } from "../manifest";
+import { listAppsPlugin } from "../listApps";
 
 const mockAuthenticationResponse: Authentication = {
   id: 123,
@@ -34,10 +36,18 @@ describe("getAuthentication plugin", () => {
     } as Partial<ApiClient> as ApiClient;
   });
 
+  const apiPlugin = () => ({
+    context: {
+      api: mockApiClient,
+    },
+  });
+
   function createTestSdk() {
-    return createSdk({}, { api: mockApiClient, meta: {} }).addPlugin(
-      getAuthenticationPlugin,
-    );
+    return createSdk()
+      .addPlugin(apiPlugin)
+      .addPlugin(listAppsPlugin)
+      .addPlugin(manifestPlugin)
+      .addPlugin(getAuthenticationPlugin);
   }
 
   describe("schema validation", () => {

package/src/plugins/getAuthentication/index.ts

@@ -78,6 +78,7 @@ export const getAuthenticationPlugin: Plugin<
     context: {
       meta: {
         getAuthentication: {
+          categories: ["authentication"],
           inputSchema: GetAuthenticationSchema,
         },
       },

package/src/plugins/getProfile/index.ts

@@ -47,6 +47,7 @@ export const getProfilePlugin: Plugin<
     context: {
       meta: {
         getProfile: {
+          categories: ["user"],
           inputSchema: GetProfileSchema,
         },
       },

package/src/plugins/listActions/index.test.ts

@@ -8,19 +8,8 @@ import { listActionsPlugin } from "./index";
 import { createSdk } from "../../sdk";
 import type { ApiClient } from "../../api";
 import type { ListActionsOptions } from "./schemas";
-import { App } from "../../api/types";
-import { GetAppSchema } from "../getApp/schemas";
-
-const mockAppResponse = {
-  data: {
-    slug: "slack",
-    name: "Slack",
-    current_implementation_id: "SlackCLIAPI@1.20.0",
-    key: "slack",
-    title: "Slack",
-    hex_color: "#4A154B",
-  } as Partial<App> as App & { key: string; title: string; hex_color: string },
-};
+
+import { listAppsPlugin } from "../listApps";
 
 const mockImplementationsResponse = {
   results: [
@@ -66,7 +55,7 @@ const mockEmptyImplementationsResponse = {
 
 describe("listActions plugin", () => {
   let mockApiClient: ApiClient;
-  let mockGetApp: any;
+  let mockGetVersionedImplementationId: any;
 
   beforeEach(() => {
     vi.clearAllMocks();
@@ -74,25 +63,31 @@ describe("listActions plugin", () => {
       get: vi.fn().mockResolvedValue(mockImplementationsResponse),
     } as Partial<ApiClient> as ApiClient;
 
-    mockGetApp = vi.fn().mockResolvedValue(mockAppResponse);
+    mockGetVersionedImplementationId = vi
+      .fn()
+      .mockResolvedValue("SlackCLIAPI@1.21.1");
   });
 
   function createTestSdk() {
     // Create a proper plugin chain with context dependencies
-    const mockGetAppPlugin = () => ({
-      getApp: mockGetApp,
-      context: {
-        meta: {
-          getApp: {
-            inputSchema: GetAppSchema,
-          },
-        },
-      },
-    });
 
     // Build SDK with proper plugin composition, providing API in initial context
-    return createSdk({}, { api: mockApiClient, meta: {} })
-      .addPlugin(mockGetAppPlugin)
+    return createSdk()
+      .addPlugin(() => ({
+        context: {
+          api: mockApiClient,
+          getVersionedImplementationId: mockGetVersionedImplementationId,
+        },
+      }))
+      .addPlugin(listAppsPlugin)
+      .addPlugin(() => ({
+        context: {
+          manifest: null,
+          getManifestEntry: () => null,
+          getVersionedImplementationId: mockGetVersionedImplementationId,
+          getImplementation: () => Promise.resolve(null),
+        },
+      }))
       .addPlugin(listActionsPlugin);
   }
 
@@ -401,9 +396,7 @@ describe("listActions plugin", () => {
       const sdk = createTestSdk();
       await sdk.listActions({ appKey: "slack" });
 
-      expect(mockGetApp).toHaveBeenCalledWith({
-        appKey: "slack",
-      });
+      expect(mockGetVersionedImplementationId).toHaveBeenCalledWith("slack");
     });
 
     it("should pass correct search parameters to implementations API", async () => {
@@ -416,7 +409,7 @@ describe("listActions plugin", () => {
           searchParams: expect.objectContaining({
             global: "true",
             public_only: "true",
-            selected_apis: "SlackCLIAPI", // Extracted from current_implementation_id
+            selected_apis: "SlackCLIAPI@1.21.1",
           }),
         }),
       );
@@ -425,12 +418,7 @@ describe("listActions plugin", () => {
 
   describe("error handling", () => {
     it("should throw ZapierConfigurationError when app has no current_implementation_id", async () => {
-      mockGetApp.mockResolvedValue({
-        data: {
-          ...mockAppResponse.data,
-          current_implementation_id: undefined, // Missing implementation ID
-        },
-      });
+      mockGetVersionedImplementationId.mockResolvedValue(null);
 
       const sdk = createTestSdk();
       await expect(sdk.listActions({ appKey: "slack" })).rejects.toThrow(
@@ -439,12 +427,7 @@ describe("listActions plugin", () => {
     });
 
     it("should throw ZapierConfigurationError when current_implementation_id is empty", async () => {
-      mockGetApp.mockResolvedValue({
-        data: {
-          ...mockAppResponse.data,
-          current_implementation_id: "", // Empty implementation ID
-        },
-      });
+      mockGetVersionedImplementationId.mockResolvedValue("");
 
       const sdk = createTestSdk();
       await expect(sdk.listActions({ appKey: "slack" })).rejects.toThrow(
@@ -516,8 +499,10 @@ describe("listActions plugin", () => {
       expect(result.data).toHaveLength(0);
     });
 
-    it("should propagate getApp errors", async () => {
-      mockGetApp.mockRejectedValue(new Error("App not found"));
+    it("should propagate getVersionedImplementationId errors", async () => {
+      mockGetVersionedImplementationId.mockRejectedValue(
+        new Error("App not found"),
+      );
 
       const sdk = createTestSdk();
       await expect(sdk.listActions({ appKey: "nonexistent" })).rejects.toThrow(
@@ -526,50 +511,6 @@ describe("listActions plugin", () => {
     });
   });
 
-  describe("implementation ID extraction", () => {
-    it("should extract implementation name from versioned ID", async () => {
-      mockGetApp.mockResolvedValue({
-        data: {
-          ...mockAppResponse.data,
-          current_implementation_id: "CustomAPIName@2.5.0",
-        },
-      });
-
-      const sdk = createTestSdk();
-      await sdk.listActions({ appKey: "slack" });
-
-      expect(mockApiClient.get).toHaveBeenCalledWith(
-        "/api/v4/implementations/",
-        expect.objectContaining({
-          searchParams: expect.objectContaining({
-            selected_apis: "CustomAPIName", // Extracted name without version
-          }),
-        }),
-      );
-    });
-
-    it("should handle implementation ID without version", async () => {
-      mockGetApp.mockResolvedValue({
-        data: {
-          ...mockAppResponse.data,
-          current_implementation_id: "PlainAPIName",
-        },
-      });
-
-      const sdk = createTestSdk();
-      await sdk.listActions({ appKey: "slack" });
-
-      expect(mockApiClient.get).toHaveBeenCalledWith(
-        "/api/v4/implementations/",
-        expect.objectContaining({
-          searchParams: expect.objectContaining({
-            selected_apis: "PlainAPIName", // Used as-is
-          }),
-        }),
-      );
-    });
-  });
-
   describe("context and metadata", () => {
     it("should provide context with meta information", () => {
       const sdk = createTestSdk();