@xyne/workflow-sdk 1.0.0

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

@@ -0,0 +1,928 @@
+/**
+ * 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
+ *
+ * File uploads (multipart file fields, binary bodies) are out of scope for
+ * the current iteration. The {@link Attachment} primitive and StorageAdapter
+ * are still used by triggers and resume payloads.
+ *
+ * ## Auth
+ *
+ * Two auth mechanisms, used together or independently:
+ *
+ * 1. **Config-level `auth`** — for tokens from variable refs
+ *    `{{ steps.login.output.token }}`. Fully typed discriminated union.
+ *
+ * 2. **Credential slots** — for stored secrets from the credential vault.
+ *    Resolved by the executor at runtime, injected via `ctx.credentials`.
+ *    Config-level auth takes precedence when both are present.
+ *
+ * ## 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 '../base-step.js';
+import type { StepExecutionContext, CredentialSlot, CredentialTypeSchema } from '../base-step.js';
+import { BuiltinStepType } from '../../types/known-types.js';
+import type { StepCategory } from '../../types/categories.js';
+declare const HttpAuthSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+}, "strip", z.ZodTypeAny, {
+    type: "none";
+}, {
+    type: "none";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"bearer">;
+    token: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "bearer";
+    token: string;
+}, {
+    type: "bearer";
+    token: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"basic">;
+    username: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "basic";
+    password: string;
+    username: string;
+}, {
+    type: "basic";
+    password: string;
+    username: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"apiKey">;
+    key: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    in: z.ZodDefault<z.ZodEnum<["header", "query"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "apiKey";
+    name: string;
+    key: string;
+    in: "header" | "query";
+}, {
+    type: "apiKey";
+    key: string;
+    name?: string | undefined;
+    in?: "header" | "query" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"customHeader">;
+    name: z.ZodString;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    type: "customHeader";
+    name: string;
+}, {
+    value: string;
+    type: "customHeader";
+    name: string;
+}>]>;
+export type HttpAuth = z.infer<typeof HttpAuthSchema>;
+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: "text" | "custom" | "json" | "xml" | "html" | "javascript";
+    customContentType?: string | undefined;
+}, {
+    raw: string;
+    mode: "raw";
+    contentType?: "text" | "custom" | "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">>;
+}, "strip", z.ZodTypeAny, {
+    mode: "formdata";
+    fields: {
+        value: string;
+        key: string;
+        enabled: boolean;
+    }[];
+}, {
+    mode: "formdata";
+    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"]>>;
+    auth: z.ZodDefault<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        type: "none";
+    }, {
+        type: "none";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"bearer">;
+        token: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "bearer";
+        token: string;
+    }, {
+        type: "bearer";
+        token: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"basic">;
+        username: z.ZodString;
+        password: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "basic";
+        password: string;
+        username: string;
+    }, {
+        type: "basic";
+        password: string;
+        username: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"apiKey">;
+        key: z.ZodString;
+        name: z.ZodDefault<z.ZodString>;
+        in: z.ZodDefault<z.ZodEnum<["header", "query"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "apiKey";
+        name: string;
+        key: string;
+        in: "header" | "query";
+    }, {
+        type: "apiKey";
+        key: string;
+        name?: string | undefined;
+        in?: "header" | "query" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"customHeader">;
+        name: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        type: "customHeader";
+        name: string;
+    }, {
+        value: string;
+        type: "customHeader";
+        name: string;
+    }>]>>;
+    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: "text" | "custom" | "json" | "xml" | "html" | "javascript";
+        customContentType?: string | undefined;
+    }, {
+        raw: string;
+        mode: "raw";
+        contentType?: "text" | "custom" | "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">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "formdata";
+        fields: {
+            value: string;
+            key: string;
+            enabled: boolean;
+        }[];
+    }, {
+        mode: "formdata";
+        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, {
+    body: {
+        mode: "none";
+    } | {
+        raw: string;
+        mode: "raw";
+        contentType: "text" | "custom" | "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;
+        }[];
+    };
+    timeoutMs: number;
+    url: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+    auth: {
+        type: "none";
+    } | {
+        type: "bearer";
+        token: string;
+    } | {
+        type: "basic";
+        password: string;
+        username: string;
+    } | {
+        type: "apiKey";
+        name: string;
+        key: string;
+        in: "header" | "query";
+    } | {
+        value: string;
+        type: "customHeader";
+        name: string;
+    };
+    response: {
+        type: "json";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "auto";
+        bodySchema?: Record<string, unknown> | undefined;
+    } | {
+        type: "text";
+    } | {
+        type: "base64";
+    } | {
+        type: "discard";
+    };
+    followRedirects: boolean;
+    headers?: Record<string, string> | undefined;
+    queryParams?: Record<string, string> | undefined;
+}, {
+    url: string;
+    headers?: Record<string, string> | undefined;
+    body?: {
+        mode: "none";
+    } | {
+        raw: string;
+        mode: "raw";
+        contentType?: "text" | "custom" | "json" | "xml" | "html" | "javascript" | undefined;
+        customContentType?: string | undefined;
+    } | {
+        mode: "urlencoded";
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    } | {
+        mode: "formdata";
+        fields?: {
+            value: string;
+            key: string;
+            enabled?: boolean | undefined;
+        }[] | undefined;
+    } | undefined;
+    timeoutMs?: number | undefined;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | undefined;
+    auth?: {
+        type: "none";
+    } | {
+        type: "bearer";
+        token: string;
+    } | {
+        type: "basic";
+        password: string;
+        username: string;
+    } | {
+        type: "apiKey";
+        key: string;
+        name?: string | undefined;
+        in?: "header" | "query" | undefined;
+    } | {
+        value: string;
+        type: "customHeader";
+        name: string;
+    } | undefined;
+    queryParams?: Record<string, string> | 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"]>>;
+        auth: z.ZodDefault<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, "strip", z.ZodTypeAny, {
+            type: "none";
+        }, {
+            type: "none";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"bearer">;
+            token: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "bearer";
+            token: string;
+        }, {
+            type: "bearer";
+            token: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"basic">;
+            username: z.ZodString;
+            password: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "basic";
+            password: string;
+            username: string;
+        }, {
+            type: "basic";
+            password: string;
+            username: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"apiKey">;
+            key: z.ZodString;
+            name: z.ZodDefault<z.ZodString>;
+            in: z.ZodDefault<z.ZodEnum<["header", "query"]>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "apiKey";
+            name: string;
+            key: string;
+            in: "header" | "query";
+        }, {
+            type: "apiKey";
+            key: string;
+            name?: string | undefined;
+            in?: "header" | "query" | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"customHeader">;
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "customHeader";
+            name: string;
+        }, {
+            value: string;
+            type: "customHeader";
+            name: string;
+        }>]>>;
+        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: "text" | "custom" | "json" | "xml" | "html" | "javascript";
+            customContentType?: string | undefined;
+        }, {
+            raw: string;
+            mode: "raw";
+            contentType?: "text" | "custom" | "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">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "formdata";
+            fields: {
+                value: string;
+                key: string;
+                enabled: boolean;
+            }[];
+        }, {
+            mode: "formdata";
+            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, {
+        body: {
+            mode: "none";
+        } | {
+            raw: string;
+            mode: "raw";
+            contentType: "text" | "custom" | "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;
+            }[];
+        };
+        timeoutMs: number;
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+        auth: {
+            type: "none";
+        } | {
+            type: "bearer";
+            token: string;
+        } | {
+            type: "basic";
+            password: string;
+            username: string;
+        } | {
+            type: "apiKey";
+            name: string;
+            key: string;
+            in: "header" | "query";
+        } | {
+            value: string;
+            type: "customHeader";
+            name: string;
+        };
+        response: {
+            type: "json";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "auto";
+            bodySchema?: Record<string, unknown> | undefined;
+        } | {
+            type: "text";
+        } | {
+            type: "base64";
+        } | {
+            type: "discard";
+        };
+        followRedirects: boolean;
+        headers?: Record<string, string> | undefined;
+        queryParams?: Record<string, string> | undefined;
+    }, {
+        url: string;
+        headers?: Record<string, string> | undefined;
+        body?: {
+            mode: "none";
+        } | {
+            raw: string;
+            mode: "raw";
+            contentType?: "text" | "custom" | "json" | "xml" | "html" | "javascript" | undefined;
+            customContentType?: string | undefined;
+        } | {
+            mode: "urlencoded";
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        } | {
+            mode: "formdata";
+            fields?: {
+                value: string;
+                key: string;
+                enabled?: boolean | undefined;
+            }[] | undefined;
+        } | undefined;
+        timeoutMs?: number | undefined;
+        method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | undefined;
+        auth?: {
+            type: "none";
+        } | {
+            type: "bearer";
+            token: string;
+        } | {
+            type: "basic";
+            password: string;
+            username: string;
+        } | {
+            type: "apiKey";
+            key: string;
+            name?: string | undefined;
+            in?: "header" | "query" | undefined;
+        } | {
+            value: string;
+            type: "customHeader";
+            name: string;
+        } | undefined;
+        queryParams?: Record<string, string> | 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;
+        headers: Record<string, string>;
+        duration: number;
+        statusText: string;
+        ok: boolean;
+        bodyText: string;
+        size: number;
+        body?: unknown;
+    }, {
+        status: number;
+        headers: Record<string, string>;
+        duration: number;
+        statusText: string;
+        ok: boolean;
+        bodyText: string;
+        size: number;
+        body?: unknown;
+    }>;
+    readonly category: StepCategory;
+    readonly icon = "globe";
+    /**
+     * Credential slots — fallback auth when config.auth is 'none'.
+     * Resolved by the executor from the credential vault.
+     */
+    readonly credentialSlots: readonly CredentialSlot[];
+    /** Credential type schemas — defines what fields each credential type needs for UI forms. */
+    readonly credentialTypeSchemas: readonly CredentialTypeSchema[];
+    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;
+    private applyAuth;
+    private applyConfigAuth;
+    private applyCredentialAuth;
+    /**
+     * 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;
+}
+export {};
+//# sourceMappingURL=http-request.step.d.ts.map