@zapier/zapier-sdk 0.10.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.11.1
+
+### Patch Changes
+
+- 0002fe9: Updated doc generation
+
+## 0.11.0
+
+### Minor Changes
+
+- 12c6d3d: Return nested fields with fieldsets instead of flat fields. Also have CLI properly create line items from fieldsets for run-action.
+
 ## 0.10.0
 
 ### Minor Changes

package/README.md

@@ -1,7 +1,5 @@
 # @zapier/zapier-sdk
 
-<!-- Generated API Reference -->
-
 ## Table of Contents
 
 - [Installation](#installation)
@@ -170,7 +168,7 @@ Get the input fields required for a specific action
 | `pageSize`         | `number` | ❌       | —       | —                                                                                              | Number of input fields per page                       |
 | `maxItems`         | `number` | ❌       | —       | —                                                                                              | Maximum total items to return across all pages        |
 
-**Returns:** `Promise<PaginatedResult<InputFieldItem>>`
+**Returns:** `Promise<PaginatedResult<RootFieldItemItem>>`
 
 **Example:**
 
@@ -372,5 +370,3 @@ const result = await sdk.request({
   url: "https://example.com",
 });
 ```
-
-<!-- End Generated API Reference -->

package/dist/index.cjs

@@ -1381,6 +1381,23 @@ var authenticationIdGenericResolver = {
 };
 
 // src/resolvers/inputs.ts
+function makeFieldsOptional(fields) {
+  return fields.map((field) => {
+    if (field.type === "input_field") {
+      return {
+        ...field,
+        is_required: false
+      };
+    } else if (field.type === "fieldset") {
+      return {
+        ...field,
+        fields: makeFieldsOptional(field.fields)
+      };
+    } else {
+      return field;
+    }
+  });
+}
 var inputsResolver = {
   type: "fields",
   depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -1408,14 +1425,27 @@ var inputsAllOptionalResolver = {
       inputs: resolvedParams.inputs
       // Pass along currently resolved inputs
     });
-    return fieldsResponse.data.map((field) => ({
-      ...field,
-      is_required: false
-    }));
+    return makeFieldsOptional(fieldsResponse.data);
   }
 };
 
 // src/resolvers/inputFieldKey.ts
+function flattenRootFieldset(rootFieldset) {
+  const result = [];
+  function processItem(item) {
+    if (item.type === "input_field") {
+      result.push(item);
+    } else if (item.type === "fieldset") {
+      for (const field of item.fields) {
+        processItem(field);
+      }
+    }
+  }
+  for (const item of rootFieldset) {
+    processItem(item);
+  }
+  return result;
+}
 var inputFieldKeyResolver = {
   type: "dynamic",
   depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -1428,7 +1458,7 @@ var inputFieldKeyResolver = {
       inputs: resolvedParams.inputs
       // Pass along currently resolved inputs
     });
-    return fieldsResponse.data;
+    return flattenRootFieldset(fieldsResponse.data);
   },
   prompt: (fields) => ({
     type: "list",
@@ -1530,10 +1560,15 @@ var ListInputFieldsSchema = zod.z.object({
   pageSize: zod.z.number().min(1).optional().describe("Number of input fields per page"),
   maxItems: zod.z.number().min(1).optional().describe("Maximum total items to return across all pages")
 }).describe("Get the input fields required for a specific action");
+var BaseFieldItemSchema = zod.z.object({
+  type: zod.z.string(),
+  // "input_field", "info_field", or "fieldset"
+  key: zod.z.string()
+  // From need.key
+});
 var InputFieldItemSchema = withFormatter(
-  zod.z.object({
-    key: zod.z.string(),
-    // From need.key
+  BaseFieldItemSchema.extend({
+    type: zod.z.literal("input_field"),
     default_value: zod.z.string(),
     // Mapped from 'default' with fallback to ""
     depends_on: zod.z.array(zod.z.string()),
@@ -1607,6 +1642,46 @@ var InputFieldItemSchema = withFormatter(
     }
   }
 );
+var InfoFieldItemSchema = withFormatter(
+  BaseFieldItemSchema.extend({
+    type: zod.z.literal("info_field"),
+    description: zod.z.string(),
+    // From need.help_text
+    title: zod.z.string().optional()
+    // Optional title
+  }),
+  {
+    format: (item) => ({
+      title: item.title || "Info",
+      key: item.key,
+      description: item.description,
+      details: [{ text: item.description, style: "normal" }]
+    })
+  }
+);
+var FieldsetItemSchema = BaseFieldItemSchema.extend({
+  type: zod.z.literal("fieldset"),
+  title: zod.z.string(),
+  fields: zod.z.lazy(
+    () => zod.z.array(
+      zod.z.union([
+        InputFieldItemSchema,
+        InfoFieldItemSchema,
+        FieldsetItemSchema
+      ])
+    )
+  )
+});
+var RootFieldItemSchema = zod.z.union([
+  InputFieldItemSchema,
+  InfoFieldItemSchema,
+  FieldsetItemSchema
+]);
+
+// src/utils/string-utils.ts
+function toTitleCase(input) {
+  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
 
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
@@ -1651,7 +1726,7 @@ function getItemsTypeFromNeed(need) {
 function transformNeedToInputFieldItem(need) {
   const itemsType = getItemsTypeFromNeed(need);
   return {
-    // Only the final computed/mapped fields that are in InputFieldItemSchema
+    type: "input_field",
     key: need.key,
     default_value: need.default || "",
     depends_on: need.depends_on || [],
@@ -1665,6 +1740,48 @@ function transformNeedToInputFieldItem(need) {
     items: itemsType ? { type: itemsType } : void 0
   };
 }
+function transformNeedToInfoFieldItem(need) {
+  return {
+    type: "info_field",
+    key: need.key,
+    description: need.help_text || "",
+    title: need.label
+  };
+}
+function transformNeedsToFields(needs) {
+  const rootFields = [];
+  const fieldsetMap = /* @__PURE__ */ new Map();
+  for (const need of needs) {
+    if (need.computed) {
+      continue;
+    }
+    if (need.parent_key) {
+      let fieldset = fieldsetMap.get(need.parent_key);
+      if (!fieldset) {
+        fieldset = {
+          type: "fieldset",
+          key: need.parent_key,
+          title: toTitleCase(need.parent_key),
+          fields: []
+        };
+        fieldsetMap.set(need.parent_key, fieldset);
+        rootFields.push(fieldset);
+      }
+      if (need.type === "copy" && need.help_text) {
+        fieldset.fields.push(transformNeedToInfoFieldItem(need));
+      } else {
+        fieldset.fields.push(transformNeedToInputFieldItem(need));
+      }
+    } else {
+      if (need.type === "copy" && need.help_text) {
+        rootFields.push(transformNeedToInfoFieldItem(need));
+      } else {
+        rootFields.push(transformNeedToInputFieldItem(need));
+      }
+    }
+  }
+  return rootFields;
+}
 var listInputFieldsPlugin = ({ context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
@@ -1695,11 +1812,9 @@ var listInputFieldsPlugin = ({ context }) => {
           `Failed to get action fields: ${needsData.errors?.join(", ") || "Unknown error"}`
         );
       }
-      const inputFields = (needsData.needs || []).map(
-        transformNeedToInputFieldItem
-      );
+      const rootFieldset = transformNeedsToFields(needsData.needs || []);
       return {
-        data: inputFields,
+        data: rootFieldset,
         nextCursor: void 0
         // No pagination needed since we return all input fields
       };
@@ -1713,9 +1828,9 @@ var listInputFieldsPlugin = ({ context }) => {
         listInputFields: {
           categories: ["action"],
           type: "list",
-          itemType: "InputField",
+          itemType: "RootFieldItem",
           inputSchema: ListInputFieldsSchema,
-          outputSchema: InputFieldItemSchema,
+          outputSchema: RootFieldItemSchema,
           resolvers: {
             appKey: appKeyResolver,
             actionType: actionTypeResolver,

package/dist/index.d.mts

@@ -2079,12 +2079,12 @@ FindUniqueAuthenticationPluginProvides>;
 
 interface ListInputFieldsPluginProvides {
     listInputFields: (options?: ListInputFieldsOptions) => Promise<{
-        data: InputFieldItem[];
+        data: RootFieldItem[];
     }> & AsyncIterable<{
-        data: InputFieldItem[];
+        data: RootFieldItem[];
         nextCursor?: string;
     }> & {
-        items(): AsyncIterable<InputFieldItem>;
+        items(): AsyncIterable<InputFieldItem | InfoFieldItem | FieldsetItem>;
     };
     context: {
         meta: {
@@ -2209,6 +2209,8 @@ interface ZapierSdk extends GetSdkType<RegistryPluginProvides & FetchPluginProvi
 
 declare const InputFieldItemSchema: z.ZodObject<{
     key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"input_field">;
     default_value: z.ZodString;
     depends_on: z.ZodArray<z.ZodString, "many">;
     description: z.ZodString;
@@ -2226,6 +2228,7 @@ declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    type: "input_field";
     key: string;
     depends_on: string[];
     placeholder: string;
@@ -2240,6 +2243,7 @@ declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     } | undefined;
 }, {
+    type: "input_field";
     key: string;
     depends_on: string[];
     placeholder: string;
@@ -2254,6 +2258,97 @@ declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     } | undefined;
 }>;
+declare const InfoFieldItemSchema: z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"info_field">;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}>;
+type FieldsetItemType = z.infer<typeof InputFieldItemSchema> | z.infer<typeof InfoFieldItemSchema> | FieldsetItem;
+interface FieldsetItem {
+    type: "fieldset";
+    key: string;
+    title: string;
+    fields: FieldsetItemType[];
+}
+declare const RootFieldItemSchema: z.ZodUnion<[z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"input_field">;
+    default_value: z.ZodString;
+    depends_on: z.ZodArray<z.ZodString, "many">;
+    description: z.ZodString;
+    invalidates_input_fields: z.ZodBoolean;
+    is_required: z.ZodBoolean;
+    placeholder: z.ZodString;
+    title: z.ZodString;
+    value_type: z.ZodString;
+    format: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+    }, {
+        type: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "input_field";
+    key: string;
+    depends_on: string[];
+    placeholder: string;
+    description: string;
+    title: string;
+    default_value: string;
+    invalidates_input_fields: boolean;
+    is_required: boolean;
+    value_type: string;
+    format?: string | undefined;
+    items?: {
+        type: string;
+    } | undefined;
+}, {
+    type: "input_field";
+    key: string;
+    depends_on: string[];
+    placeholder: string;
+    description: string;
+    title: string;
+    default_value: string;
+    invalidates_input_fields: boolean;
+    is_required: boolean;
+    value_type: string;
+    format?: string | undefined;
+    items?: {
+        type: string;
+    } | undefined;
+}>, z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"info_field">;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}>, z.ZodType<FieldsetItem, z.ZodTypeDef, FieldsetItem>]>;
 type InputFieldItem$1 = z.infer<typeof InputFieldItemSchema>;
 
 interface PromptConfig {
@@ -2279,10 +2374,6 @@ interface DynamicResolver<TItem = unknown, TParams = Record<string, unknown>> ex
     fetch: (sdk: ZapierSdk, resolvedParams: TParams) => Promise<TItem[]>;
     prompt: (items: TItem[], params: TParams) => PromptConfig;
 }
-interface FieldsResolver<TParams = Record<string, unknown>> extends Resolver {
-    type: "fields";
-    fetch: (sdk: ZapierSdk, resolvedParams: TParams) => Promise<InputFieldItem$1[]>;
-}
 interface PositionalMetadata {
     positionalMeta: {
         positional: true;
@@ -3066,6 +3157,17 @@ type ActionItem$1 = z.infer<typeof ActionItemSchema>;
  * Inferred from InputFieldItemSchema which extends the base Need API schema
  */
 type InputFieldItem = z.infer<typeof InputFieldItemSchema>;
+/**
+ * Represents an info field item (help text/copy) returned by listInputFields functions
+ * Inferred from InfoFieldItemSchema
+ */
+type InfoFieldItem = z.infer<typeof InfoFieldItemSchema>;
+
+/**
+ * Represents a root field item (any field/fieldset type) returned by listInputFields
+ * Inferred from RootFieldItemSchema - use as RootFieldItem[]
+ */
+type RootFieldItem = z.infer<typeof RootFieldItemSchema>;
 /**
  * Represents a user profile item returned by getProfile function
  * Inferred from UserProfileItemSchema which extends the base UserProfile API schema
@@ -3136,13 +3238,17 @@ type AuthenticationIdResolver = DynamicResolver<AuthItem, {
 declare const authenticationIdResolver: AuthenticationIdResolver;
 declare const authenticationIdGenericResolver: AuthenticationIdResolver;
 
-type InputsResolver = FieldsResolver<{
-    appKey: string;
-    actionKey: string;
-    actionType: ActionTypeProperty;
-    authenticationId: number;
-    inputs?: Record<string, unknown>;
-}>;
+type InputsResolver = {
+    type: "fields";
+    depends: readonly string[];
+    fetch: (sdk: any, resolvedParams: {
+        appKey: string;
+        actionKey: string;
+        actionType: ActionTypeProperty;
+        authenticationId: number;
+        inputs?: Record<string, unknown>;
+    }) => Promise<RootFieldItem[]>;
+};
 declare const inputsResolver: InputsResolver;
 declare const inputsAllOptionalResolver: InputsResolver;
 
@@ -3288,4 +3394,4 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
 }>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
-export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type ErrorOptions, type EventCallback, type FetchPluginProvides, type Field, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RunActionPluginProvides, type Sdk, type SdkEvent, type UserProfile, type UserProfileItem, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin };
+export { type Action, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type Choice, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type ErrorOptions, type EventCallback, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindUniqueAuthenticationPluginProvides, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, type ManifestPluginOptions, type ManifestPluginProvides, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type UserProfile, type UserProfileItem, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, authenticationIdGenericResolver, authenticationIdResolver, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, fetchPlugin, findFirstAuthenticationPlugin, findManifestEntry, findUniqueAuthenticationPlugin, formatErrorMessage, getActionPlugin, getAppPlugin, getAuthenticationPlugin, getPreferredManifestEntryKey, getProfilePlugin, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, isPositional, listActionsPlugin, listAppsPlugin, listAuthenticationsPlugin, listInputFieldsPlugin, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, runActionPlugin };

package/dist/index.mjs

@@ -1379,6 +1379,23 @@ var authenticationIdGenericResolver = {
 };
 
 // src/resolvers/inputs.ts
+function makeFieldsOptional(fields) {
+  return fields.map((field) => {
+    if (field.type === "input_field") {
+      return {
+        ...field,
+        is_required: false
+      };
+    } else if (field.type === "fieldset") {
+      return {
+        ...field,
+        fields: makeFieldsOptional(field.fields)
+      };
+    } else {
+      return field;
+    }
+  });
+}
 var inputsResolver = {
   type: "fields",
   depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -1406,14 +1423,27 @@ var inputsAllOptionalResolver = {
       inputs: resolvedParams.inputs
       // Pass along currently resolved inputs
     });
-    return fieldsResponse.data.map((field) => ({
-      ...field,
-      is_required: false
-    }));
+    return makeFieldsOptional(fieldsResponse.data);
   }
 };
 
 // src/resolvers/inputFieldKey.ts
+function flattenRootFieldset(rootFieldset) {
+  const result = [];
+  function processItem(item) {
+    if (item.type === "input_field") {
+      result.push(item);
+    } else if (item.type === "fieldset") {
+      for (const field of item.fields) {
+        processItem(field);
+      }
+    }
+  }
+  for (const item of rootFieldset) {
+    processItem(item);
+  }
+  return result;
+}
 var inputFieldKeyResolver = {
   type: "dynamic",
   depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -1426,7 +1456,7 @@ var inputFieldKeyResolver = {
       inputs: resolvedParams.inputs
       // Pass along currently resolved inputs
     });
-    return fieldsResponse.data;
+    return flattenRootFieldset(fieldsResponse.data);
   },
   prompt: (fields) => ({
     type: "list",
@@ -1528,10 +1558,15 @@ var ListInputFieldsSchema = z.object({
   pageSize: z.number().min(1).optional().describe("Number of input fields per page"),
   maxItems: z.number().min(1).optional().describe("Maximum total items to return across all pages")
 }).describe("Get the input fields required for a specific action");
+var BaseFieldItemSchema = z.object({
+  type: z.string(),
+  // "input_field", "info_field", or "fieldset"
+  key: z.string()
+  // From need.key
+});
 var InputFieldItemSchema = withFormatter(
-  z.object({
-    key: z.string(),
-    // From need.key
+  BaseFieldItemSchema.extend({
+    type: z.literal("input_field"),
     default_value: z.string(),
     // Mapped from 'default' with fallback to ""
     depends_on: z.array(z.string()),
@@ -1605,6 +1640,46 @@ var InputFieldItemSchema = withFormatter(
     }
   }
 );
+var InfoFieldItemSchema = withFormatter(
+  BaseFieldItemSchema.extend({
+    type: z.literal("info_field"),
+    description: z.string(),
+    // From need.help_text
+    title: z.string().optional()
+    // Optional title
+  }),
+  {
+    format: (item) => ({
+      title: item.title || "Info",
+      key: item.key,
+      description: item.description,
+      details: [{ text: item.description, style: "normal" }]
+    })
+  }
+);
+var FieldsetItemSchema = BaseFieldItemSchema.extend({
+  type: z.literal("fieldset"),
+  title: z.string(),
+  fields: z.lazy(
+    () => z.array(
+      z.union([
+        InputFieldItemSchema,
+        InfoFieldItemSchema,
+        FieldsetItemSchema
+      ])
+    )
+  )
+});
+var RootFieldItemSchema = z.union([
+  InputFieldItemSchema,
+  InfoFieldItemSchema,
+  FieldsetItemSchema
+]);
+
+// src/utils/string-utils.ts
+function toTitleCase(input) {
+  return input.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_\-]+/g, " ").replace(/\s+/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
 
 // src/plugins/listInputFields/index.ts
 function getInputFieldTypeFromNeed(need) {
@@ -1649,7 +1724,7 @@ function getItemsTypeFromNeed(need) {
 function transformNeedToInputFieldItem(need) {
   const itemsType = getItemsTypeFromNeed(need);
   return {
-    // Only the final computed/mapped fields that are in InputFieldItemSchema
+    type: "input_field",
     key: need.key,
     default_value: need.default || "",
     depends_on: need.depends_on || [],
@@ -1663,6 +1738,48 @@ function transformNeedToInputFieldItem(need) {
     items: itemsType ? { type: itemsType } : void 0
   };
 }
+function transformNeedToInfoFieldItem(need) {
+  return {
+    type: "info_field",
+    key: need.key,
+    description: need.help_text || "",
+    title: need.label
+  };
+}
+function transformNeedsToFields(needs) {
+  const rootFields = [];
+  const fieldsetMap = /* @__PURE__ */ new Map();
+  for (const need of needs) {
+    if (need.computed) {
+      continue;
+    }
+    if (need.parent_key) {
+      let fieldset = fieldsetMap.get(need.parent_key);
+      if (!fieldset) {
+        fieldset = {
+          type: "fieldset",
+          key: need.parent_key,
+          title: toTitleCase(need.parent_key),
+          fields: []
+        };
+        fieldsetMap.set(need.parent_key, fieldset);
+        rootFields.push(fieldset);
+      }
+      if (need.type === "copy" && need.help_text) {
+        fieldset.fields.push(transformNeedToInfoFieldItem(need));
+      } else {
+        fieldset.fields.push(transformNeedToInputFieldItem(need));
+      }
+    } else {
+      if (need.type === "copy" && need.help_text) {
+        rootFields.push(transformNeedToInfoFieldItem(need));
+      } else {
+        rootFields.push(transformNeedToInputFieldItem(need));
+      }
+    }
+  }
+  return rootFields;
+}
 var listInputFieldsPlugin = ({ context }) => {
   const listInputFields = createPaginatedFunction(
     async function listInputFieldsPage(options) {
@@ -1693,11 +1810,9 @@ var listInputFieldsPlugin = ({ context }) => {
           `Failed to get action fields: ${needsData.errors?.join(", ") || "Unknown error"}`
         );
       }
-      const inputFields = (needsData.needs || []).map(
-        transformNeedToInputFieldItem
-      );
+      const rootFieldset = transformNeedsToFields(needsData.needs || []);
       return {
-        data: inputFields,
+        data: rootFieldset,
         nextCursor: void 0
         // No pagination needed since we return all input fields
       };
@@ -1711,9 +1826,9 @@ var listInputFieldsPlugin = ({ context }) => {
         listInputFields: {
           categories: ["action"],
           type: "list",
-          itemType: "InputField",
+          itemType: "RootFieldItem",
           inputSchema: ListInputFieldsSchema,
-          outputSchema: InputFieldItemSchema,
+          outputSchema: RootFieldItemSchema,
           resolvers: {
             appKey: appKeyResolver,
             actionType: actionTypeResolver,

package/dist/plugins/listInputFields/index.d.ts

@@ -1,17 +1,17 @@
 import type { Plugin, GetSdkType } from "../../types/plugin";
 import type { ApiClient } from "../../api";
-import type { InputFieldItem } from "../../types/domain";
+import type { InputFieldItem, InfoFieldItem, FieldsetItem, RootFieldItem } from "../../types/domain";
 import { ListInputFieldsSchema, type ListInputFieldsOptions } from "./schemas";
 import type { GetAppPluginProvides } from "../getApp";
 import type { GetVersionedImplementationId } from "../manifest/schemas";
 export interface ListInputFieldsPluginProvides {
     listInputFields: (options?: ListInputFieldsOptions) => Promise<{
-        data: InputFieldItem[];
+        data: RootFieldItem[];
     }> & AsyncIterable<{
-        data: InputFieldItem[];
+        data: RootFieldItem[];
         nextCursor?: string;
     }> & {
-        items(): AsyncIterable<InputFieldItem>;
+        items(): AsyncIterable<InputFieldItem | InfoFieldItem | FieldsetItem>;
     };
     context: {
         meta: {