@zapier/zapier-sdk 0.12.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.12.1
+
+### Patch Changes
+
+- c2f88bc: Fix usage examples, add rough apps proxy examples
+
 ## 0.12.0
 
 ### Minor Changes

package/README.md

@@ -14,6 +14,8 @@
   - [`listInputFields`](#listinputfields)
   - [`runAction`](#runaction)
 - [Apps](#apps)
+  - [`apps.{appKey}`](#appsappkey)
+  - [`apps.{appKey}.{actionType}.{actionKey}`](#appsappkeyactiontypeactionkey)
   - [`getApp`](#getapp)
   - [`listApps`](#listapps)
 - [Authentications](#authentications)
@@ -121,16 +123,16 @@ Get current user's profile information
 
 **Parameters:**
 
-| Name      | Type     | Required | Default | Possible Values | Description                            |
-| --------- | -------- | -------- | ------- | --------------- | -------------------------------------- |
-| `options` | `string` | ❌       | —       | —               | Get current user's profile information |
+| Name      | Type     | Required | Default | Possible Values | Description |
+| --------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options` | `object` | ❌       | —       | —               |             |
 
 **Returns:** `Promise<ProfileItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getProfile();
+const { data: profile } = await sdk.getProfile();
 ```
 
 ### Actions
@@ -143,7 +145,7 @@ Get detailed information about a specific action
 
 | Name           | Type     | Required | Default | Possible Values                                                                                | Description                                        |
 | -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| `options`      | `string` | ✅       | —       | —                                                                                              | Get detailed information about a specific action   |
+| `options`      | `object` | ✅       | —       | —                                                                                              |                                                    |
 | ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                      |
 | ↳ `actionType` | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type |
 | ↳ `actionKey`  | `string` | ✅       | —       | —                                                                                              | Action key to execute                              |
@@ -153,8 +155,7 @@ Get detailed information about a specific action
 **Example:**
 
 ```typescript
-const result = await sdk.getAction({
-  options: "example-value",
+const { data: action } = await sdk.getAction({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
@@ -169,7 +170,7 @@ List all actions for a specific app
 
 | Name           | Type     | Required | Default | Possible Values                                                                                | Description                                      |
 | -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------ |
-| `options`      | `string` | ✅       | —       | —                                                                                              | List all actions for a specific app              |
+| `options`      | `object` | ✅       | —       | —                                                                                              |                                                  |
 | ↳ `appKey`     | `string` | ✅       | —       | —                                                                                              | App key of actions to list (e.g., 'SlackCLIAPI') |
 | ↳ `actionType` | `string` | ❌       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Filter actions by type                           |
 | ↳ `pageSize`   | `number` | ❌       | —       | —                                                                                              | Number of actions per page                       |
@@ -180,10 +181,26 @@ List all actions for a specific app
 **Example:**
 
 ```typescript
-const result = await sdk.listActions({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: actions, nextCursor } = await sdk.listActions({
   appKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.listActions({
+  appKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const action of sdk
+  .listActions({
+    appKey: "example-key",
+  })
+  .items()) {
+  // Do something with each action
+}
 ```
 
 #### `listInputFieldChoices`
@@ -192,31 +209,55 @@ Get the available choices for a dynamic dropdown input field
 
 **Parameters:**
 
-| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                                  |
-| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Get the available choices for a dynamic dropdown input field |
-| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                                |
-| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type           |
-| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                        |
-| ↳ `inputFieldKey`    | `string` | ✅       | —       | —                                                                                              | Input field key to get choices for.                          |
-| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action                     |
-| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Current input values that may affect available choices       |
-| ↳ `page`             | `number` | ❌       | —       | —                                                                                              | Page number for paginated results                            |
-| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of choices per page                                   |
-| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages               |
+| Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                            |
+| -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                        |
+| ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                          |
+| ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type     |
+| ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                  |
+| ↳ `inputFieldKey`    | `string` | ✅       | —       | —                                                                                              | Input field key to get choices for.                    |
+| ↳ `authenticationId` | `string` | ❌       | —       | —                                                                                              | Authentication ID to use for this action               |
+| ↳ `inputs`           | `object` | ❌       | —       | —                                                                                              | Current input values that may affect available choices |
+| ↳ `page`             | `number` | ❌       | —       | —                                                                                              | Page number for paginated results                      |
+| ↳ `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of choices per page                             |
+| ↳ `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages         |
 
 **Returns:** `Promise<PaginatedResult<InputFieldChoiceItem>>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.listInputFieldChoices({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: inputFieldChoices, nextCursor } = await sdk.listInputFieldChoices(
+  {
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+    inputFieldKey: "example-key",
+  },
+);
+
+// Or iterate over all pages
+for await (const page of sdk.listInputFieldChoices({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
   inputFieldKey: "example-key",
-});
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const inputFieldChoice of sdk
+  .listInputFieldChoices({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+    inputFieldKey: "example-key",
+  })
+  .items()) {
+  // Do something with each inputFieldChoice
+}
 ```
 
 #### `listInputFields`
@@ -227,7 +268,7 @@ Get the input fields required for a specific action
 
 | Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                           |
 | -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Get the input fields required for a specific action   |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                       |
 | ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                         |
 | ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type    |
 | ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                                 |
@@ -241,12 +282,32 @@ Get the input fields required for a specific action
 **Example:**
 
 ```typescript
-const result = await sdk.listInputFields({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: rootFieldItems, nextCursor } = await sdk.listInputFields({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.listInputFields({
+  appKey: "example-key",
+  actionType: "read",
+  actionKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const rootFieldItem of sdk
+  .listInputFields({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+  })
+  .items()) {
+  // Do something with each rootFieldItem
+}
 ```
 
 #### `runAction`
@@ -257,7 +318,7 @@ Execute an action with the given inputs
 
 | Name                 | Type     | Required | Default | Possible Values                                                                                | Description                                        |
 | -------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------- |
-| `options`            | `string` | ✅       | —       | —                                                                                              | Execute an action with the given inputs            |
+| `options`            | `object` | ✅       | —       | —                                                                                              |                                                    |
 | ↳ `appKey`           | `string` | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI')                      |
 | ↳ `actionType`       | `string` | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type |
 | ↳ `actionKey`        | `string` | ✅       | —       | —                                                                                              | Action key to execute                              |
@@ -271,16 +332,91 @@ Execute an action with the given inputs
 **Example:**
 
 ```typescript
-const result = await sdk.runAction({
-  options: "example-value",
+// Get first page and a cursor for the second page
+const { data: actionResults, nextCursor } = await sdk.runAction({
   appKey: "example-key",
   actionType: "read",
   actionKey: "example-key",
 });
+
+// Or iterate over all pages
+for await (const page of sdk.runAction({
+  appKey: "example-key",
+  actionType: "read",
+  actionKey: "example-key",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const actionResult of sdk
+  .runAction({
+    appKey: "example-key",
+    actionType: "read",
+    actionKey: "example-key",
+  })
+  .items()) {
+  // Do something with each actionResult
+}
 ```
 
 ### Apps
 
+#### `apps.{appKey}`
+
+Bind an authentication ID to an app
+
+**Parameters:**
+
+| Name                 | Type     | Required | Default | Possible Values | Description |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options`            | `object` | ✅       | —       | —               |             |
+| ↳ `authenticationId` | `number` | ✅       | —       | —               |             |
+
+**Returns:** `Promise<AppProxy>`
+
+**Example:**
+
+```typescript
+const result = await sdk.apps.appKey({
+  authenticationId: 12345,
+});
+```
+
+#### `apps.{appKey}.{actionType}.{actionKey}`
+
+Execute an action with the given inputs for the bound app, as an alternative to runAction
+
+**Parameters:**
+
+| Name                 | Type     | Required | Default | Possible Values | Description |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------- |
+| `options`            | `object` | ✅       | —       | —               |             |
+| ↳ `inputs`           | `object` | ❌       | —       | —               |             |
+| ↳ `authenticationId` | `number` | ❌       | —       | —               |             |
+
+**Returns:** `Promise<PaginatedResult<ActionResultItem>>`
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: actionResults, nextCursor } =
+  await sdk.apps.appKey.actionType.actionKey();
+
+// Or iterate over all pages
+for await (const page of sdk.apps.appKey.actionType.actionKey()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const actionResult of sdk.apps.appKey.actionType
+  .actionKey()
+  .items()) {
+  // Do something with each actionResult
+}
+```
+
 #### `getApp`
 
 Get detailed information about a specific app
@@ -289,7 +425,7 @@ Get detailed information about a specific app
 
 | Name       | Type     | Required | Default | Possible Values | Description                                   |
 | ---------- | -------- | -------- | ------- | --------------- | --------------------------------------------- |
-| `options`  | `string` | ✅       | —       | —               | Get detailed information about a specific app |
+| `options`  | `object` | ✅       | —       | —               |                                               |
 | ↳ `appKey` | `string` | ✅       | —       | —               | App key of app to fetch (e.g., 'SlackCLIAPI') |
 
 **Returns:** `Promise<AppItem>`
@@ -297,8 +433,7 @@ Get detailed information about a specific app
 **Example:**
 
 ```typescript
-const result = await sdk.getApp({
-  options: "example-value",
+const { data: app } = await sdk.getApp({
   appKey: "example-key",
 });
 ```
@@ -311,7 +446,7 @@ List all available apps with optional filtering
 
 | Name         | Type     | Required | Default | Possible Values | Description                                                         |
 | ------------ | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------- |
-| `options`    | `string` | ✅       | —       | —               | List all available apps with optional filtering                     |
+| `options`    | `object` | ✅       | —       | —               |                                                                     |
 | ↳ `appKeys`  | `array`  | ❌       | —       | —               | Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github') |
 | ↳ `search`   | `string` | ❌       | —       | —               | Search for apps by name                                             |
 | ↳ `pageSize` | `number` | ❌       | —       | —               | Number of apps per page                                             |
@@ -322,9 +457,18 @@ List all available apps with optional filtering
 **Example:**
 
 ```typescript
-const result = await sdk.listApps({
-  options: "example-value",
-});
+// Get first page and a cursor for the second page
+const { data: apps, nextCursor } = await sdk.listApps();
+
+// Or iterate over all pages
+for await (const page of sdk.listApps()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const app of sdk.listApps().items()) {
+  // Do something with each app
+}
 ```
 
 ### Authentications
@@ -337,7 +481,7 @@ Find the first authentication matching the criteria
 
 | Name          | Type     | Required | Default | Possible Values | Description                                             |
 | ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------- |
-| `options`     | `string` | ✅       | —       | —               | Find the first authentication matching the criteria     |
+| `options`     | `object` | ✅       | —       | —               |                                                         |
 | ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI') |
 | ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title          |
 | ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match             |
@@ -349,9 +493,7 @@ Find the first authentication matching the criteria
 **Example:**
 
 ```typescript
-const result = await sdk.findFirstAuthentication({
-  options: "example-value",
-});
+const { data: authentication } = await sdk.findFirstAuthentication();
 ```
 
 #### `findUniqueAuthentication`
@@ -362,7 +504,7 @@ Find a unique authentication matching the criteria
 
 | Name          | Type     | Required | Default | Possible Values | Description                                             |
 | ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------- |
-| `options`     | `string` | ✅       | —       | —               | Find a unique authentication matching the criteria      |
+| `options`     | `object` | ✅       | —       | —               |                                                         |
 | ↳ `appKey`    | `string` | ❌       | —       | —               | App key of authentication to find (e.g., 'SlackCLIAPI') |
 | ↳ `search`    | `string` | ❌       | —       | —               | Search term to filter authentications by title          |
 | ↳ `title`     | `string` | ❌       | —       | —               | Filter authentications by exact title match             |
@@ -374,9 +516,7 @@ Find a unique authentication matching the criteria
 **Example:**
 
 ```typescript
-const result = await sdk.findUniqueAuthentication({
-  options: "example-value",
-});
+const { data: authentication } = await sdk.findUniqueAuthentication();
 ```
 
 #### `getAuthentication`
@@ -385,18 +525,17 @@ Get a specific authentication by ID
 
 **Parameters:**
 
-| Name                 | Type     | Required | Default | Possible Values | Description                         |
-| -------------------- | -------- | -------- | ------- | --------------- | ----------------------------------- |
-| `options`            | `string` | ✅       | —       | —               | Get a specific authentication by ID |
-| ↳ `authenticationId` | `number` | ✅       | —       | —               | Authentication ID to retrieve       |
+| Name                 | Type     | Required | Default | Possible Values | Description                   |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------------------------- |
+| `options`            | `object` | ✅       | —       | —               |                               |
+| ↳ `authenticationId` | `number` | ✅       | —       | —               | Authentication ID to retrieve |
 
 **Returns:** `Promise<AuthenticationItem>`
 
 **Example:**
 
 ```typescript
-const result = await sdk.getAuthentication({
-  options: "example-value",
+const { data: authentication } = await sdk.getAuthentication({
   authenticationId: 12345,
 });
 ```
@@ -409,7 +548,7 @@ List available authentications with optional filtering
 
 | Name                  | Type     | Required | Default | Possible Values | Description                                                              |
 | --------------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------------ |
-| `options`             | `string` | ✅       | —       | —               | List available authentications with optional filtering                   |
+| `options`             | `object` | ✅       | —       | —               |                                                                          |
 | ↳ `appKey`            | `string` | ❌       | —       | —               | App key of authentications to list (e.g., 'SlackCLIAPI')                 |
 | ↳ `authenticationIds` | `array`  | ❌       | —       | —               | List of authentication IDs to filter by                                  |
 | ↳ `search`            | `string` | ❌       | —       | —               | Search term to filter authentications by title                           |
@@ -424,9 +563,18 @@ List available authentications with optional filtering
 **Example:**
 
 ```typescript
-const result = await sdk.listAuthentications({
-  options: "example-value",
-});
+// Get first page and a cursor for the second page
+const { data: authentications, nextCursor } = await sdk.listAuthentications();
+
+// Or iterate over all pages
+for await (const page of sdk.listAuthentications()) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const authentication of sdk.listAuthentications().items()) {
+  // Do something with each authentication
+}
 ```
 
 ### HTTP Requests
@@ -440,7 +588,7 @@ Execute fetch
 | Name                       | Type     | Required | Default | Possible Values                                            | Description                                                          |
 | -------------------------- | -------- | -------- | ------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
 | `url`                      | `string` | ✅       | —       | —                                                          | The URL to fetch                                                     |
-| `init`                     | `string` | ❌       | —       | —                                                          | Fetch options including authentication                               |
+| `init`                     | `object` | ❌       | —       | —                                                          | Fetch options including authentication                               |
 | ↳ `method`                 | `string` | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` |                                                                      |
 | ↳ `headers`                | `object` | ❌       | —       | —                                                          |                                                                      |
 | ↳ `body`                   | `string` | ❌       | —       | —                                                          |                                                                      |
@@ -453,7 +601,7 @@ Execute fetch
 **Example:**
 
 ```typescript
-const result = await sdk.fetch("https://example.com");
+const result = await sdk.fetch("https://example.com", { key: "value" });
 ```
 
 #### `request`
@@ -464,7 +612,7 @@ Make authenticated HTTP requests through Zapier's Relay service
 
 | Name                       | Type     | Required | Default | Possible Values                                            | Description                                                          |
 | -------------------------- | -------- | -------- | ------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
-| `options`                  | `string` | ✅       | —       | —                                                          | Make authenticated HTTP requests through Zapier's Relay service      |
+| `options`                  | `object` | ✅       | —       | —                                                          |                                                                      |
 | ↳ `url`                    | `string` | ✅       | —       | —                                                          | The URL to request (will be proxied through Relay)                   |
 | ↳ `method`                 | `string` | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method                                                          |
 | ↳ `body`                   | `string` | ❌       | —       | —                                                          | Request body as a string                                             |
@@ -480,7 +628,6 @@ Make authenticated HTTP requests through Zapier's Relay service
 
 ```typescript
 const result = await sdk.request({
-  options: "example-value",
   url: "https://example.com",
 });
 ```

package/dist/index.cjs

@@ -192,6 +192,40 @@ HTTP Status: ${error.statusCode}`;
   }
   return message;
 }
+var ActionExecutionInputSchema = zod.z.object({
+  inputs: zod.z.record(zod.z.unknown()).optional(),
+  authenticationId: zod.z.number().optional()
+}).describe(
+  "Execute an action with the given inputs for the bound app, as an alternative to runAction"
+);
+var AppFactoryInputSchema = zod.z.object({
+  authenticationId: zod.z.number()
+}).describe("Bind an authentication ID to an app");
+function getStringProperty(obj, key) {
+  if (typeof obj === "object" && obj !== null && key in obj) {
+    const value = obj[key];
+    return typeof value === "string" ? value : void 0;
+  }
+  return void 0;
+}
+function formatActionResult(item) {
+  const obj = typeof item === "object" && item !== null ? item : {};
+  const title = getStringProperty(obj, "title") || getStringProperty(obj, "name") || getStringProperty(obj, "label") || getStringProperty(obj, "subject") || "Action Result";
+  return {
+    title,
+    id: getStringProperty(obj, "id"),
+    key: getStringProperty(obj, "key"),
+    description: getStringProperty(obj, "description"),
+    data: item,
+    // Let formatJsonOutput handle the JSON rendering
+    details: []
+    // Not used when data is provided
+  };
+}
+var ActionResultItemSchema = withFormatter(
+  zod.z.unknown().describe("Action execution result"),
+  { format: formatActionResult }
+);
 
 // src/plugins/apps/index.ts
 function createActionFunction(appKey, actionType, actionKey, options, pinnedAuthId) {
@@ -295,7 +329,26 @@ function createAppsProxy(options) {
 }
 var appsPlugin = ({ sdk }) => {
   return {
-    apps: createAppsProxy({ sdk })
+    apps: createAppsProxy({ sdk }),
+    context: {
+      meta: {
+        "apps.{appKey}": {
+          categories: ["app"],
+          packages: ["sdk"],
+          type: "function",
+          inputSchema: AppFactoryInputSchema,
+          returnType: "AppProxy"
+        },
+        "apps.{appKey}.{actionType}.{actionKey}": {
+          categories: ["app"],
+          packages: ["sdk"],
+          type: "list",
+          inputSchema: ActionExecutionInputSchema,
+          itemType: "ActionResult",
+          outputSchema: ActionResultItemSchema
+        }
+      }
+    }
   };
 };
 var FetchUrlSchema = zod.z.union([zod.z.string(), zod.z.instanceof(URL)]).describe("The URL to fetch");
@@ -2261,31 +2314,6 @@ var RunActionSchema = zod.z.object({
   pageSize: zod.z.number().min(1).optional().describe("Number of results per page"),
   maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages")
 }).describe("Execute an action with the given inputs");
-function getStringProperty(obj, key) {
-  if (typeof obj === "object" && obj !== null && key in obj) {
-    const value = obj[key];
-    return typeof value === "string" ? value : void 0;
-  }
-  return void 0;
-}
-function formatActionResult(item) {
-  const obj = typeof item === "object" && item !== null ? item : {};
-  const title = getStringProperty(obj, "title") || getStringProperty(obj, "name") || getStringProperty(obj, "label") || getStringProperty(obj, "subject") || "Action Result";
-  return {
-    title,
-    id: getStringProperty(obj, "id"),
-    key: getStringProperty(obj, "key"),
-    description: getStringProperty(obj, "description"),
-    data: item,
-    // Let formatJsonOutput handle the JSON rendering
-    details: []
-    // Not used when data is provided
-  };
-}
-var ActionResultItemSchema = withFormatter(
-  zod.z.unknown().describe("Action execution result"),
-  { format: formatActionResult }
-);
 
 // src/plugins/runAction/index.ts
 async function executeAction(actionOptions) {
@@ -3517,7 +3545,18 @@ var registryPlugin = ({ sdk, context }) => {
       title: "Other"
     }
   };
-  const functions = metaKeys.filter((key) => typeof sdk[key] === "function").map((key) => {
+  const functions = metaKeys.filter((key) => {
+    const property = sdk[key];
+    if (typeof property === "function") {
+      return true;
+    }
+    const [rootKey] = key.split(".");
+    const rootProperty = sdk[rootKey];
+    if (typeof rootProperty === "object" && rootProperty !== null) {
+      return true;
+    }
+    return false;
+  }).map((key) => {
     const meta = context.meta[key];
     return {
       name: key,

package/dist/index.d.mts

@@ -1613,13 +1613,25 @@ declare const getProfilePlugin: Plugin<{}, // no SDK dependencies
 }, // requires api in context
 GetProfilePluginProvides>;
 
-interface ActionExecutionOptions {
-    inputs?: Record<string, any>;
-    authenticationId?: number;
-}
-interface AppFactoryOptions {
+declare const ActionExecutionInputSchema: z.ZodObject<{
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    authenticationId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    authenticationId?: number | undefined;
+    inputs?: Record<string, unknown> | undefined;
+}, {
+    authenticationId?: number | undefined;
+    inputs?: Record<string, unknown> | undefined;
+}>;
+type ActionExecutionOptions = z.infer<typeof ActionExecutionInputSchema>;
+declare const AppFactoryInputSchema: z.ZodObject<{
+    authenticationId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
     authenticationId: number;
-}
+}, {
+    authenticationId: number;
+}>;
+type AppFactoryInput = z.infer<typeof AppFactoryInputSchema>;
 interface BaseActionTypeProxy {
     [action: string]: (options?: ActionExecutionOptions) => unknown;
 }
@@ -1635,7 +1647,7 @@ interface AppProxy {
     [type: string]: ActionTypeProxy;
 }
 interface AppFactory {
-    (options: AppFactoryOptions): AppProxy;
+    (options: AppFactoryInput): AppProxy;
 }
 type AppProxyWithFactory = AppFactory & AppProxy;
 interface ActionProxy {