@xyne/workflow-sdk 3.2.37 → 3.2.38

package/dist/connectors/builtin/steps/http-request.step.d.ts

@@ -0,0 +1,1027 @@
+/**
+ * HTTP_REQUEST step — make HTTP requests to external APIs.
+ *
+ * Action step that uses the global `fetch` API (Node 20+). Always
+ * returns the response — never throws on HTTP error status codes.
+ * The consumer can branch on `ok` or `status` via a CONDITIONAL step.
+ *
+ * ## Body modes (Postman-aligned)
+ *
+ * `body` is a discriminated union by `mode`. Each mode has its own shape:
+ *
+ *  - `none`       — no body
+ *  - `raw`        — single text payload; pick the content-type via `contentType`
+ *  - `urlencoded` — `application/x-www-form-urlencoded` key/value pairs
+ *  - `formdata`   — `multipart/form-data` with text fields and optional files
+ *
+ * Binary request bodies are out of scope for the current iteration. Multipart
+ * file fields use the {@link Attachment} primitive and StorageAdapter.
+ *
+ * ## Auth
+ *
+ * The optional `credentialName` selects a stored credential from the vault.
+ * Before this step runs, the executor resolves that selection and injects the
+ * validated value through `ctx.credentials`. The step
+ * receives the resolved value and applies it after user-provided headers, so
+ * managed authentication cannot be accidentally overridden.
+ *
+ * ## Response shape
+ *
+ * The step's output IS the response:
+ *
+ *     { status, statusText, ok, headers, body, bodyText, size, duration }
+ *
+ * `body` is the parsed value per `responseType`. `bodyText` is the raw text
+ * (always present, empty for `discard`). `size` is bytes received.
+ *
+ * The author optionally declares `responseBodySchema` (a JSON Schema). When
+ * present the step's `resolveOutputJsonSchema(config)` types the `body`
+ * field for downstream variable pickers; the runtime behaviour is unchanged.
+ */
+import { z } from 'zod';
+import { BaseActionStep } from '../../../steps/base-step.js';
+import type { StepExecutionContext } from '../../../steps/base-step.js';
+import { BuiltinStepType } from '../../../types/known-types.js';
+import type { StepCategory } from '../../../types/categories.js';
+export declare const HttpRawContentTypeSchema: z.ZodEnum<["json", "xml", "html", "text", "javascript", "custom"]>;
+export type HttpRawContentType = z.infer<typeof HttpRawContentTypeSchema>;
+export declare const HttpBodySchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"none">;
+}, "strip", z.ZodTypeAny, {
+    mode: "none";
+}, {
+    mode: "none";
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"raw">;
+    raw: z.ZodString;
+    contentType: z.ZodDefault<z.ZodEnum<["json", "xml", "html", "text", "javascript", "custom"]>>;
+    customContentType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    raw: string;
+    mode: "raw";
+    contentType: "custom" | "text" | "json" | "xml" | "html" | "javascript";
+    customContentType?: string | undefined;
+}, {
+    raw: string;
+    mode: "raw";
+    contentType?: "custom" | "text" | "json" | "xml" | "html" | "javascript" | undefined;
+    customContentType?: string | undefined;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"urlencoded">;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        key: string;
+        enabled: boolean;
+    }, {
+        value: string;
+        key: string;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    mode: "urlencoded";
+    fields: {
+        value: string;
+        key: string;
+        enabled: boolean;
+    }[];
+}, {
+    mode: "urlencoded";
+    fields?: {
+        value: string;
+        key: string;
+        enabled?: boolean | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"formdata">;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        key: string;
+        enabled: boolean;
+    }, {
+        value: string;
+        key: string;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
+            name: z.ZodString;
+            mimeType: z.ZodString;
+            data: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }, {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }>, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            mimeType: z.ZodString;
+            data: z.ZodString;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }, {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }>, "many">]>, z.ZodString]>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        enabled: boolean;
+        value?: string | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        } | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }[] | undefined;
+    }, {
+        key: string;
+        value?: string | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        } | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }[] | undefined;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    mode: "formdata";
+    fields: {
+        value: string;
+        key: string;
+        enabled: boolean;
+    }[];
+    files?: {
+        key: string;
+        enabled: boolean;
+        value?: string | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        } | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }[] | undefined;
+    }[] | undefined;
+}, {
+    mode: "formdata";
+    files?: {
+        key: string;
+        value?: string | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        } | {
+            name: string;
+            mimeType: string;
+            data: string;
+            size?: number | undefined;
+        }[] | undefined;
+        enabled?: boolean | undefined;
+    }[] | undefined;
+    fields?: {
+        value: string;
+        key: string;
+        enabled?: boolean | undefined;
+    }[] | undefined;
+}>]>;
+export type HttpBody = z.infer<typeof HttpBodySchema>;
+export declare const HttpResponseSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"json">;
+    bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "json";
+    bodySchema?: Record<string, unknown> | undefined;
+}, {
+    type: "json";
+    bodySchema?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"auto">;
+    bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "auto";
+    bodySchema?: Record<string, unknown> | undefined;
+}, {
+    type: "auto";
+    bodySchema?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+}, {
+    type: "text";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"base64">;
+}, "strict", z.ZodTypeAny, {
+    type: "base64";
+}, {
+    type: "base64";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"discard">;
+}, "strict", z.ZodTypeAny, {
+    type: "discard";
+}, {
+    type: "discard";
+}>]>;
+export type HttpResponseConfig = z.infer<typeof HttpResponseSchema>;
+export type HttpResponseType = HttpResponseConfig['type'];
+export declare const HttpMethodSchema: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
+export type HttpMethod = z.infer<typeof HttpMethodSchema>;
+export declare const HttpRequestStepConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>>;
+    credentialName: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodDefault<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "none";
+    }, {
+        mode: "none";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"raw">;
+        raw: z.ZodString;
+        contentType: z.ZodDefault<z.ZodEnum<["json", "xml", "html", "text", "javascript", "custom"]>>;
+        customContentType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        raw: string;
+        mode: "raw";
+        contentType: "custom" | "text" | "json" | "xml" | "html" | "javascript";
+        customContentType?: string | undefined;
+    }, {
+        raw: string;
+        mode: "raw";
+        contentType?: "custom" | "text" | "json" | "xml" | "html" | "javascript" | undefined;
+        customContentType?: string | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"urlencoded">;
+        fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }, {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "urlencoded";
+        fields: {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }[];
+    }, {
+        mode: "urlencoded";
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"formdata">;
+        fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }, {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }>, "many">>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
+                name: z.ZodString;
+                mimeType: z.ZodString;
+                data: z.ZodString;
+                size: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }, {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }>, z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                mimeType: z.ZodString;
+                data: z.ZodString;
+                size: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }, {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }>, "many">]>, z.ZodString]>>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            enabled: boolean;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+        }, {
+            key: string;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+            enabled?: boolean | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "formdata";
+        fields: {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }[];
+        files?: {
+            key: string;
+            enabled: boolean;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+        }[] | undefined;
+    }, {
+        mode: "formdata";
+        files?: {
+            key: string;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    }>]>>;
+    response: z.ZodDefault<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"json">;
+        bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "json";
+        bodySchema?: Record<string, unknown> | undefined;
+    }, {
+        type: "json";
+        bodySchema?: Record<string, unknown> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"auto">;
+        bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "auto";
+        bodySchema?: Record<string, unknown> | undefined;
+    }, {
+        type: "auto";
+        bodySchema?: Record<string, unknown> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+    }, "strict", z.ZodTypeAny, {
+        type: "text";
+    }, {
+        type: "text";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"base64">;
+    }, "strict", z.ZodTypeAny, {
+        type: "base64";
+    }, {
+        type: "base64";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"discard">;
+    }, "strict", z.ZodTypeAny, {
+        type: "discard";
+    }, {
+        type: "discard";
+    }>]>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    followRedirects: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    timeoutMs: number;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+    body: {
+        mode: "none";
+    } | {
+        raw: string;
+        mode: "raw";
+        contentType: "custom" | "text" | "json" | "xml" | "html" | "javascript";
+        customContentType?: string | undefined;
+    } | {
+        mode: "urlencoded";
+        fields: {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }[];
+    } | {
+        mode: "formdata";
+        fields: {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }[];
+        files?: {
+            key: string;
+            enabled: boolean;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+        }[] | undefined;
+    };
+    response: {
+        type: "json";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "auto";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "text";
+    } | {
+        type: "base64";
+    } | {
+        type: "discard";
+    };
+    followRedirects: boolean;
+    credentialName?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    queryParams?: Record<string, string> | undefined;
+}, {
+    url: string;
+    timeoutMs?: number | undefined;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    credentialName?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    queryParams?: Record<string, string> | undefined;
+    body?: {
+        mode: "none";
+    } | {
+        raw: string;
+        mode: "raw";
+        contentType?: "custom" | "text" | "json" | "xml" | "html" | "javascript" | undefined;
+        customContentType?: string | undefined;
+    } | {
+        mode: "urlencoded";
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    } | {
+        mode: "formdata";
+        files?: {
+            key: string;
+            value?: string | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            } | {
+                name: string;
+                mimeType: string;
+                data: string;
+                size?: number | undefined;
+            }[] | undefined;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+    response?: {
+        type: "json";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "auto";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "text";
+    } | {
+        type: "base64";
+    } | {
+        type: "discard";
+    } | undefined;
+    followRedirects?: boolean | undefined;
+}>;
+export type HttpRequestStepConfig = z.infer<typeof HttpRequestStepConfigSchema>;
+export interface HttpRequestStepOutput extends Record<string, unknown> {
+    /** HTTP status code (e.g. 200, 404, 500). */
+    status: number;
+    /** Status text (e.g. "OK", "Not Found"). */
+    statusText: string;
+    /** Whether the status is 2xx. */
+    ok: boolean;
+    /** Response headers as a flat key-value map (lowercase keys). */
+    headers: Record<string, string>;
+    /**
+     * Parsed response body. Shape depends on `responseType`:
+     * - `json`    → object / array / primitive
+     * - `text`    → string
+     * - `base64`  → base64 string of the raw bytes
+     * - `auto`    → object | string | null (detected from content-type)
+     * - `discard` → null
+     */
+    body: unknown;
+    /** Raw response body text — always present, empty for `discard`. */
+    bodyText: string;
+    /** Response size in bytes. */
+    size: number;
+    /** Request duration in milliseconds. */
+    duration: number;
+}
+export declare class HttpRequestStep extends BaseActionStep<typeof HttpRequestStepConfigSchema, HttpRequestStepOutput> {
+    readonly type = BuiltinStepType.HTTP_REQUEST;
+    readonly name = "HTTP Request";
+    readonly description = "Make HTTP requests to external APIs";
+    readonly configSchema: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>>;
+        credentialName: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodDefault<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"none">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "none";
+        }, {
+            mode: "none";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"raw">;
+            raw: z.ZodString;
+            contentType: z.ZodDefault<z.ZodEnum<["json", "xml", "html", "text", "javascript", "custom"]>>;
+            customContentType: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            raw: string;
+            mode: "raw";
+            contentType: "custom" | "text" | "json" | "xml" | "html" | "javascript";
+            customContentType?: string | undefined;
+        }, {
+            raw: string;
+            mode: "raw";
+            contentType?: "custom" | "text" | "json" | "xml" | "html" | "javascript" | undefined;
+            customContentType?: string | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"urlencoded">;
+            fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodString;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }, {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "urlencoded";
+            fields: {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }[];
+        }, {
+            mode: "urlencoded";
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"formdata">;
+            fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodString;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }, {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }>, "many">>;
+            files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
+                    name: z.ZodString;
+                    mimeType: z.ZodString;
+                    data: z.ZodString;
+                    size: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }, {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }>, z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    mimeType: z.ZodString;
+                    data: z.ZodString;
+                    size: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }, {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }>, "many">]>, z.ZodString]>>;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                enabled: boolean;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+            }, {
+                key: string;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+                enabled?: boolean | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "formdata";
+            fields: {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }[];
+            files?: {
+                key: string;
+                enabled: boolean;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
+        }, {
+            mode: "formdata";
+            files?: {
+                key: string;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        }>]>>;
+        response: z.ZodDefault<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"json">;
+            bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "json";
+            bodySchema?: Record<string, unknown> | undefined;
+        }, {
+            type: "json";
+            bodySchema?: Record<string, unknown> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"auto">;
+            bodySchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "auto";
+            bodySchema?: Record<string, unknown> | undefined;
+        }, {
+            type: "auto";
+            bodySchema?: Record<string, unknown> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+        }, "strict", z.ZodTypeAny, {
+            type: "text";
+        }, {
+            type: "text";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"base64">;
+        }, "strict", z.ZodTypeAny, {
+            type: "base64";
+        }, {
+            type: "base64";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"discard">;
+        }, "strict", z.ZodTypeAny, {
+            type: "discard";
+        }, {
+            type: "discard";
+        }>]>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        followRedirects: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        timeoutMs: number;
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+        body: {
+            mode: "none";
+        } | {
+            raw: string;
+            mode: "raw";
+            contentType: "custom" | "text" | "json" | "xml" | "html" | "javascript";
+            customContentType?: string | undefined;
+        } | {
+            mode: "urlencoded";
+            fields: {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }[];
+        } | {
+            mode: "formdata";
+            fields: {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }[];
+            files?: {
+                key: string;
+                enabled: boolean;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+            }[] | undefined;
+        };
+        response: {
+            type: "json";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "auto";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "text";
+        } | {
+            type: "base64";
+        } | {
+            type: "discard";
+        };
+        followRedirects: boolean;
+        credentialName?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        queryParams?: Record<string, string> | undefined;
+    }, {
+        url: string;
+        timeoutMs?: number | undefined;
+        method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+        credentialName?: string | undefined;
+        headers?: Record<string, string> | undefined;
+        queryParams?: Record<string, string> | undefined;
+        body?: {
+            mode: "none";
+        } | {
+            raw: string;
+            mode: "raw";
+            contentType?: "custom" | "text" | "json" | "xml" | "html" | "javascript" | undefined;
+            customContentType?: string | undefined;
+        } | {
+            mode: "urlencoded";
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        } | {
+            mode: "formdata";
+            files?: {
+                key: string;
+                value?: string | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                } | {
+                    name: string;
+                    mimeType: string;
+                    data: string;
+                    size?: number | undefined;
+                }[] | undefined;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        } | undefined;
+        response?: {
+            type: "json";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "auto";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "text";
+        } | {
+            type: "base64";
+        } | {
+            type: "discard";
+        } | undefined;
+        followRedirects?: boolean | undefined;
+    }>;
+    readonly outputSchema: z.ZodObject<{
+        status: z.ZodNumber;
+        statusText: z.ZodString;
+        ok: z.ZodBoolean;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        body: z.ZodUnknown;
+        bodyText: z.ZodString;
+        size: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        status: number;
+        size: number;
+        duration: number;
+        headers: Record<string, string>;
+        statusText: string;
+        ok: boolean;
+        bodyText: string;
+        body?: unknown;
+    }, {
+        status: number;
+        size: number;
+        duration: number;
+        headers: Record<string, string>;
+        statusText: string;
+        ok: boolean;
+        bodyText: string;
+        body?: unknown;
+    }>;
+    readonly category: StepCategory;
+    readonly icon = "globe";
+    readonly credentialSlots: readonly [{
+        readonly name: "credentialName";
+        readonly required: false;
+    }];
+    /**
+     * Any shape its connector offers — an HTTP request calls arbitrary APIs, so
+     * every auth style is legitimate here. Accepting them is not the same as
+     * needing one: the slot above stays optional, because a public API takes no
+     * credential at all.
+     */
+    readonly credential: import("../../core/credentials.js").CredentialDefinition<"builtin">[];
+    decorateConfigSchema(jsonSchema: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Per-instance output schema. When the author's `response` config provides
+     * a `bodySchema` (json/auto), we plug it into `body`. For other response
+     * types (`text`, `base64`, `discard`) we set the body's static type since
+     * no user shape is involved.
+     */
+    resolveOutputJsonSchema(config: Record<string, unknown>): Record<string, unknown>;
+    private outputBodySchemaFor;
+    redactInput(input: Record<string, unknown>): Record<string, unknown>;
+    execute(config: HttpRequestStepConfig, ctx: StepExecutionContext): Promise<HttpRequestStepOutput>;
+    private buildUrl;
+    /**
+     * Encode the request body for the given mode. Mutates `headers` to set
+     * the appropriate Content-Type unless the user already supplied one.
+     *
+     * Returns the `BodyInit` to attach (or `undefined` for empty bodies).
+     */
+    private encodeBody;
+    private decodeText;
+    private parseResponseBody;
+    private autoParseBody;
+}
+//# sourceMappingURL=http-request.step.d.ts.map