@graph-compose/client 1.0.0 → 1.0.3

package/dist/core/tool-builder.js

@@ -1,343 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolBuilder = void 0;
-const validation_1 = require("../validation");
-const builder_1 = require("./builder");
-/**
- * Fluent API for configuring individual tools within a GraphCompose workflow.
- * Tools can be of type 'http' or 'graph'.
- * Chain configuration methods (e.g., `.get()`, `.description()`, `.graph()`).
- * Call `.end()` to finalize the tool definition and add it to the graph.
- */
-class ToolBuilder {
-    /**
-     * Creates an instance of ToolBuilder.
-     * @param parentGraph The parent GraphCompose instance.
-     * @param id The unique identifier for the tool.
-     */
-    constructor(parentGraph, id) {
-        this.parentGraph = parentGraph;
-        this.id = id; // Store the ID
-        this.tool = {
-            id,
-            type: "http",
-            http: {
-                method: "GET",
-                url: "",
-            },
-        };
-    }
-    /**
-     * Validates a JSONata expression within the context of the current tool.
-     * @param expression The JSONata expression string to validate.
-     * @param context A descriptive string indicating where the expression is used.
-     * @throws {Error} If the expression is invalid.
-     */
-    validateJsonataExpression(expression, context) {
-        try {
-            const result = (0, validation_1.validateExpression)(expression, this.tool.id);
-            if (!result.isValid) {
-                throw result.errors[0];
-            }
-        }
-        catch (e) {
-            console.error(`Error validating expression for tool ${this.tool.id}:`, e);
-            throw e;
-        }
-    }
-    /**
-     * Sets the tool type to 'http' (if not already set) and configures it for a GET request.
-     * @param url The URL endpoint for the GET request.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    get(url) {
-        if (this.tool.type !== "http") {
-            // Explicitly create a new HTTP tool structure
-            this.tool = {
-                id: this.tool.id,
-                description: this.tool.description,
-                type: "http",
-                http: { method: "GET", url },
-            };
-        }
-        else {
-            // Ensure http property exists before assigning
-            if (!this.tool.http)
-                this.tool.http = { method: "GET", url };
-            this.tool.http.method = "GET";
-            this.tool.http.url = url;
-        }
-        return this;
-    }
-    /**
-     * Sets the tool type to 'http' (if not already set) and configures it for a POST request.
-     * @param url The URL endpoint for the POST request.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    post(url) {
-        if (this.tool.type !== "http") {
-            this.tool = {
-                id: this.tool.id,
-                description: this.tool.description,
-                type: "http",
-                http: { method: "POST", url },
-            };
-        }
-        else {
-            if (!this.tool.http)
-                this.tool.http = { method: "POST", url };
-            this.tool.http.method = "POST";
-            this.tool.http.url = url;
-        }
-        return this;
-    }
-    /**
-     * Sets the tool type to 'http' (if not already set) and configures it for a PUT request.
-     * @param url The URL endpoint for the PUT request.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    put(url) {
-        if (this.tool.type !== "http") {
-            this.tool = {
-                id: this.tool.id,
-                description: this.tool.description,
-                type: "http",
-                http: { method: "PUT", url },
-            };
-        }
-        else {
-            if (!this.tool.http)
-                this.tool.http = { method: "PUT", url };
-            this.tool.http.method = "PUT";
-            this.tool.http.url = url;
-        }
-        return this;
-    }
-    /**
-     * Sets the tool type to 'http' (if not already set) and configures it for a DELETE request.
-     * @param url The URL endpoint for the DELETE request.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    delete(url) {
-        if (this.tool.type !== "http") {
-            this.tool = {
-                id: this.tool.id,
-                description: this.tool.description,
-                type: "http",
-                http: { method: "DELETE", url },
-            };
-        }
-        else {
-            if (!this.tool.http)
-                this.tool.http = { method: "DELETE", url };
-            this.tool.http.method = "DELETE";
-            this.tool.http.url = url;
-        }
-        return this;
-    }
-    /**
-     * Sets the tool type to 'http' (if not already set) and configures it for a PATCH request.
-     * @param url The URL endpoint for the PATCH request.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    patch(url) {
-        if (this.tool.type !== "http") {
-            this.tool = {
-                id: this.tool.id,
-                description: this.tool.description,
-                type: "http",
-                http: { method: "PATCH", url },
-            };
-        }
-        else {
-            if (!this.tool.http)
-                this.tool.http = { method: "PATCH", url };
-            this.tool.http.method = "PATCH";
-            this.tool.http.url = url;
-        }
-        return this;
-    }
-    // --- Configuration methods for HTTP Tools ---
-    /**
-     * Sets the description for the tool.
-     * @param description A brief description of what the tool does.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    description(description) {
-        this.tool.description = description;
-        return this;
-    }
-    /**
-     * Sets the HTTP headers for the HTTP tool's request.
-     * Only applicable if the tool type is 'http'.
-     * @param headers A record of header names to string values or JsonataParam objects.
-     * @returns The ToolBuilder instance for chaining.
-     * @throws {Error} If the tool type is not 'http'.
-     * @throws {Error} If any JSONata expression within headers is invalid.
-     */
-    withHeaders(headers) {
-        if (this.tool.type !== "http") {
-            throw new Error("Cannot set headers on a non-HTTP tool.");
-        }
-        // Ensure http property exists
-        if (!this.tool.http)
-            this.tool.http = { method: "GET", url: "" }; // Should have URL by now ideally
-        Object.entries(headers).forEach(([key, value]) => {
-            if (typeof value === "object" && "jsonataExpression" in value) {
-                this.validateJsonataExpression(value.jsonataExpression, `header '${key}'`);
-            }
-        });
-        this.tool.http.headers = headers;
-        return this;
-    }
-    /**
-     * Sets the body for the HTTP tool's request.
-     * Only applicable if the tool type is 'http'.
-     * @param body The request body as an object or string.
-     * @returns The ToolBuilder instance for chaining.
-     * @throws {Error} If the tool type is not 'http'.
-     */
-    withBody(body) {
-        if (this.tool.type !== "http") {
-            throw new Error("Cannot set body on a non-HTTP tool.");
-        }
-        if (!this.tool.http)
-            this.tool.http = { method: "GET", url: "" };
-        this.tool.http.body = body;
-        return this;
-    }
-    /**
-     * Configures the retry policy for the HTTP tool's request.
-     * Only applicable if the tool type is 'http'.
-     * @param config Partial configuration for the RetryPolicy.
-     * @returns The ToolBuilder instance for chaining.
-     * @throws {Error} If the tool type is not 'http'.
-     */
-    withRetries(config) {
-        if (this.tool.type !== "http") {
-            throw new Error("Cannot set retry policy on a non-HTTP tool.");
-        }
-        if (!this.tool.http)
-            this.tool.http = { method: "GET", url: "" };
-        // Ensure activityConfig exists
-        if (!this.tool.activityConfig) {
-            this.tool.activityConfig = {};
-        }
-        this.tool.activityConfig.retryPolicy = {
-            ...this.tool.activityConfig.retryPolicy,
-            ...config,
-        };
-        return this;
-    }
-    /**
-     * Sets the start-to-close timeout for the HTTP tool's activity execution.
-     * @param duration The timeout duration (e.g., '30s', 5000).
-     * @returns The ToolBuilder instance for chaining.
-     * @throws {Error} If the tool type is not 'http'.
-     */
-    withStartToCloseTimeout(duration) {
-        if (this.tool.type !== "http") {
-            throw new Error("Cannot set startToCloseTimeout on a non-HTTP tool.");
-        }
-        if (!this.tool.http)
-            this.tool.http = { method: "GET", url: "" };
-        if (!this.tool.activityConfig) {
-            this.tool.activityConfig = {};
-        }
-        this.tool.activityConfig.startToCloseTimeout = duration;
-        return this;
-    }
-    /**
-     * Sets the schedule-to-close timeout for the HTTP tool's activity execution.
-     * @param duration The timeout duration (e.g., '30s', 5000).
-     * @returns The ToolBuilder instance for chaining.
-     * @throws {Error} If the tool type is not 'http'.
-     */
-    withScheduleToCloseTimeout(duration) {
-        if (this.tool.type !== "http") {
-            throw new Error("Cannot set scheduleToCloseTimeout on a non-HTTP tool.");
-        }
-        if (!this.tool.http)
-            this.tool.http = { method: "GET", url: "" };
-        if (!this.tool.activityConfig) {
-            this.tool.activityConfig = {};
-        }
-        this.tool.activityConfig.scheduleToCloseTimeout = duration;
-        return this;
-    }
-    // --- Configuration method for Graph Tools ---
-    /**
-     * Configures the tool as a 'graph' type using a nested builder.
-     * @param builderCallback A function that receives a new GraphCompose instance to define the sub-graph.
-     * @returns The ToolBuilder instance for chaining.
-     */
-    graph(builderCallback) {
-        const subGraphBuilder = new builder_1.GraphCompose({ token: "subgraph-internal" });
-        builderCallback(subGraphBuilder);
-        const subGraphDefinition = subGraphBuilder.getWorkflow();
-        // --- START VALIDATION ---
-        const invalidNodes = subGraphDefinition.nodes.filter((node) => node.type !== "http");
-        if (invalidNodes.length > 0) {
-            const invalidIds = invalidNodes.map((n) => n.id);
-            throw new Error(`Graph tool '${this.tool.id}' can only contain HTTP nodes. Found invalid node types for IDs: ${invalidIds.join(", ")}`);
-        }
-        // --- END VALIDATION ---
-        if (subGraphDefinition.tools && subGraphDefinition.tools.length > 0) {
-            console.warn(`Tool '${this.tool.id}': Graph tools currently do not support nested tools. Inner tools will be ignored.`);
-        }
-        this.tool = {
-            id: this.tool.id,
-            type: "graph",
-            description: this.tool.description,
-            graph: {
-                nodes: subGraphDefinition.nodes,
-            },
-        }; // Assert final assignment conforms to ToolNode
-        delete this.tool.http;
-        return this;
-    }
-    // --- Finalization ---
-    /**
-     * Finalizes the configuration of this tool and returns control to the parent GraphCompose builder.
-     * Adds the configured tool to the main graph's tool list.
-     * This method MUST be called to complete the tool definition.
-     *
-     * @returns The parent GraphCompose instance, allowing for further chaining on the main graph.
-     */
-    end() {
-        // Basic validation before adding
-        if (this.tool.type === "http" && !this.tool.http?.url) {
-            throw new Error(`HTTP tool '${this.tool.id}' must have a URL defined.`);
-        }
-        if (this.tool.type === "graph" && (!this.tool.graph || this.tool.graph.nodes.length === 0)) {
-            throw new Error(`Graph tool '${this.tool.id}' must have at least one node defined in its graph.`);
-        }
-        this.parentGraph._addToolDefinition(this.build());
-        return this.parentGraph;
-    }
-    /**
-     * Builds and returns the configured tool node definition.
-     * Primarily used internally by the end() method.
-     * @returns The configured ToolNode object.
-     */
-    build() {
-        // Remove empty activityConfig if no activity settings were provided for HTTP tools
-        if (this.tool.type === "http" &&
-            this.tool.activityConfig &&
-            Object.keys(this.tool.activityConfig).length === 0) {
-            delete this.tool.activityConfig;
-        }
-        return this.tool;
-    }
-    /**
-     * @internal
-     * Retrieves the ID of the tool being built.
-     * Used for generating informative error messages.
-     * @returns The ID of the tool.
-     */
-    getId() {
-        return this.id;
-    }
-}
-exports.ToolBuilder = ToolBuilder;
-//# sourceMappingURL=tool-builder.js.map

package/dist/core/tool-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-builder.js","sourceRoot":"","sources":["../../src/core/tool-builder.ts"],"names":[],"mappings":"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"}

package/dist/node-builder.d.ts

@@ -1,64 +0,0 @@
-import { AgentNode, ErrorBoundaryNode, FlowControl, HttpNode, JsonataParam, Node, NodeConditions, RetryPolicy } from "@graph-compose/core";
-import { z } from "zod";
-import { GraphCompose } from "./core/builder";
-export declare class NodeBuilder {
-    private readonly graph;
-    protected node: HttpNode | ErrorBoundaryNode | AgentNode;
-    private isHttpNode;
-    private isAgentNode;
-    constructor(graph: GraphCompose, id: string, type?: "http" | "error_boundary" | "agent", protectedNodes?: string[]);
-    private validateJsonataExpression;
-    get(url: string): NodeBuilder;
-    post(url: string): NodeBuilder;
-    put(url: string): NodeBuilder;
-    delete(url: string): NodeBuilder;
-    patch(url: string): NodeBuilder;
-    withCondition(behavior: NodeConditions): NodeBuilder;
-    withFlowControl(flowControls: FlowControl[]): NodeBuilder;
-    addFlowControl(flowControl: FlowControl): NodeBuilder;
-    withHeaders(headers: Record<string, string | JsonataParam>): NodeBuilder;
-    withBody(body: Record<string, any> | string): NodeBuilder;
-    withRetries(config: Partial<RetryPolicy>): NodeBuilder;
-    withTimeout(duration: string | number): NodeBuilder;
-    withDependencies(nodeIds: string[]): NodeBuilder;
-    withValidation(config: {
-        input?: z.ZodType<any> | Record<string, any>;
-        output?: z.ZodType<any> | Record<string, any>;
-    }): NodeBuilder;
-    private isZodType;
-    /**
-     * Set the maximum number of iterations for an agent node.
-     * An agent runs until it returns a completion schema response.
-     * You are responsible for ensuring the agent returns a `complete` response before this limit.
-     * If the agent reaches the max iterations without completing, it will fail.
-     *
-     * @default 5
-     * @param maxIterations Must be greater than 0
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If maxIterations is less than 1
-     */
-    withMaxIterations(maxIterations: number): NodeBuilder;
-    /**
-     * Set the tools available to the agent.
-     * Tools must be defined in the global tools section of the workflow.
-     * Each tool name must be unique within the workflow and have no dashes or spaces.
-     *
-     * @param tools Array of tool names that the agent can use
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If any tool is not found in global tools
-     */
-    withTools(tools: string[]): NodeBuilder;
-    /**
-     * Add a single tool to the agent's available tools.
-     * The tool must be defined in the global tools section of the workflow.
-     * The tool name must be unique within the workflow and have no dashes or spaces.
-     *
-     * @param tool Name of the tool to add
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If the tool is not found in global tools
-     */
-    addTool(tool: string): NodeBuilder;
-    end(): GraphCompose;
-    build(): Node;
-}
-//# sourceMappingURL=node-builder.d.ts.map

package/dist/node-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-builder.d.ts","sourceRoot":"","sources":["../src/node-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,WAAW,CAAU;gBAGV,KAAK,EAAE,YAAY,EACpC,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAM,GAAG,gBAAgB,GAAG,OAAgB,EAClD,cAAc,CAAC,EAAE,MAAM,EAAE;IA0C3B,OAAO,CAAC,yBAAyB;IAcjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAM7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAMhC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAO/B,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW;IASpD,eAAe,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW;IAYzD,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW;IAgBrD,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,WAAW;IAWxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,WAAW;IAWzD,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW;IAQtD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW;IAKnD,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW;IAWhD,cAAc,CAAC,MAAM,EAAE;QACrB,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/C,GAAG,WAAW;IA2Bf,OAAO,CAAC,SAAS;IAIjB;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW;IASrD;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW;IASvC;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAYlC,GAAG,IAAI,YAAY;IAKnB,KAAK,IAAI,IAAI;CAGd"}

package/dist/node-builder.js

@@ -1,261 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeBuilder = void 0;
-const jsonata_1 = __importDefault(require("jsonata"));
-const zod_1 = require("zod");
-const zod_to_json_schema_1 = require("zod-to-json-schema");
-class NodeBuilder {
-    constructor(graph, id, type = "http", protectedNodes) {
-        this.graph = graph;
-        this.isHttpNode = type === "http";
-        this.isAgentNode = type === "agent";
-        if (type === "error_boundary") {
-            this.node = {
-                id,
-                type: "error_boundary",
-                protectedNodes: protectedNodes || [],
-                http: {
-                    method: "POST",
-                    url: "",
-                },
-            };
-        }
-        else if (type === "agent") {
-            this.node = {
-                id,
-                type: "agent",
-                dependencies: [],
-                tools: [],
-                http: {
-                    method: "POST",
-                    url: "",
-                    config: {
-                        max_iterations: undefined,
-                    },
-                },
-            };
-        }
-        else {
-            this.node = {
-                id,
-                type: "http",
-                dependencies: [],
-                http: {
-                    method: "GET",
-                    url: "",
-                },
-            };
-        }
-    }
-    validateJsonataExpression(expression, context) {
-        try {
-            console.log("validating", expression);
-            // Try to parse the JSONata expression
-            (0, jsonata_1.default)(expression);
-        }
-        catch (e) {
-            console.log("error", e);
-            throw new Error(`Invalid JSONata expression in ${context}: ${e instanceof Error ? e.message : "Unknown error"}`);
-        }
-    }
-    // Update HTTP methods to validate URLs
-    get(url) {
-        this.node.http.method = "GET";
-        this.node.http.url = url;
-        return this;
-    }
-    post(url) {
-        this.node.http.method = "POST";
-        this.node.http.url = url;
-        return this;
-    }
-    put(url) {
-        this.node.http.method = "PUT";
-        this.node.http.url = url;
-        return this;
-    }
-    delete(url) {
-        this.node.http.method = "DELETE";
-        this.node.http.url = url;
-        return this;
-    }
-    patch(url) {
-        this.node.http.method = "PATCH";
-        this.node.http.url = url;
-        return this;
-    }
-    // Conditional branching methods - only available for HTTP nodes
-    withCondition(behavior) {
-        if (!this.isHttpNode) {
-            throw new Error("Conditional branching is only available for HTTP nodes");
-        }
-        const httpNode = this.node;
-        httpNode.conditions = behavior;
-        return this;
-    }
-    withFlowControl(flowControls) {
-        if (!this.isHttpNode) {
-            throw new Error("Conditional branching is only available for HTTP nodes");
-        }
-        const httpNode = this.node;
-        if (!httpNode.conditions) {
-            httpNode.conditions = { flowControl: [] };
-        }
-        httpNode.conditions.flowControl = flowControls;
-        return this;
-    }
-    addFlowControl(flowControl) {
-        if (!this.isHttpNode) {
-            throw new Error("Conditional branching is only available for HTTP nodes");
-        }
-        const httpNode = this.node;
-        if (!httpNode.conditions) {
-            httpNode.conditions = { flowControl: [] };
-        }
-        if (!httpNode.conditions.flowControl) {
-            httpNode.conditions.flowControl = [];
-        }
-        httpNode.conditions.flowControl.push(flowControl);
-        return this;
-    }
-    // Configuration methods
-    withHeaders(headers) {
-        // Validate any JSONata expressions in headers
-        Object.entries(headers).forEach(([key, value]) => {
-            if (typeof value === "object" && "jsonataExpression" in value) {
-                this.validateJsonataExpression(value.jsonataExpression, `header '${key}'`);
-            }
-        });
-        this.node.http.headers = headers;
-        return this;
-    }
-    withBody(body) {
-        // Note: Template expression validation happens during final workflow validation
-        // This allows us to collect all validation errors at once and maintain a single source of truth
-        if (typeof body === "string") {
-            this.node.http.body = body;
-        }
-        else {
-            this.node.http.body = body;
-        }
-        return this;
-    }
-    withRetries(config) {
-        this.node.http.retryPolicy = {
-            ...this.node.http.retryPolicy,
-            ...config,
-        };
-        return this;
-    }
-    withTimeout(duration) {
-        this.node.http.startToCloseTimeout = duration;
-        return this;
-    }
-    withDependencies(nodeIds) {
-        if (this.isHttpNode) {
-            this.node.dependencies = nodeIds;
-        }
-        else if (this.isAgentNode) {
-            this.node.dependencies = nodeIds;
-        }
-        else {
-            throw new Error("Dependencies can only be set on HTTP or agent nodes");
-        }
-        return this;
-    }
-    withValidation(config) {
-        if (!this.isHttpNode) {
-            throw new Error("Validation can only be set on HTTP nodes");
-        }
-        if (config.input || config.output) {
-            this.node.validation = {};
-            if (config.input) {
-                const inputSchema = this.isZodType(config.input)
-                    ? (0, zod_to_json_schema_1.zodToJsonSchema)(config.input)
-                    : config.input;
-                this.node.validation.input =
-                    inputSchema.definitions?.[Object.keys(inputSchema.definitions || {})[0]] || inputSchema;
-            }
-            if (config.output) {
-                const outputSchema = this.isZodType(config.output)
-                    ? (0, zod_to_json_schema_1.zodToJsonSchema)(config.output)
-                    : config.output;
-                this.node.validation.output =
-                    outputSchema.definitions?.[Object.keys(outputSchema.definitions || {})[0]] ||
-                        outputSchema;
-            }
-        }
-        return this;
-    }
-    isZodType(value) {
-        return value instanceof zod_1.z.ZodType;
-    }
-    /**
-     * Set the maximum number of iterations for an agent node.
-     * An agent runs until it returns a completion schema response.
-     * You are responsible for ensuring the agent returns a `complete` response before this limit.
-     * If the agent reaches the max iterations without completing, it will fail.
-     *
-     * @default 5
-     * @param maxIterations Must be greater than 0
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If maxIterations is less than 1
-     */
-    withMaxIterations(maxIterations) {
-        if (!this.isAgentNode) {
-            throw new Error("Max iterations can only be set for agent nodes");
-        }
-        const agentNode = this.node;
-        agentNode.http.config.max_iterations = maxIterations;
-        return this;
-    }
-    /**
-     * Set the tools available to the agent.
-     * Tools must be defined in the global tools section of the workflow.
-     * Each tool name must be unique within the workflow and have no dashes or spaces.
-     *
-     * @param tools Array of tool names that the agent can use
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If any tool is not found in global tools
-     */
-    withTools(tools) {
-        if (!this.isAgentNode) {
-            throw new Error("Tools can only be set for agent nodes");
-        }
-        const agentNode = this.node;
-        agentNode.tools = tools;
-        return this;
-    }
-    /**
-     * Add a single tool to the agent's available tools.
-     * The tool must be defined in the global tools section of the workflow.
-     * The tool name must be unique within the workflow and have no dashes or spaces.
-     *
-     * @param tool Name of the tool to add
-     * @throws {Error} If called on a non-agent node
-     * @throws {ValidationError} If the tool is not found in global tools
-     */
-    addTool(tool) {
-        if (!this.isAgentNode) {
-            throw new Error("Tools can only be added to agent nodes");
-        }
-        const agentNode = this.node;
-        if (!agentNode.tools.includes(tool)) {
-            agentNode.tools.push(tool);
-        }
-        return this;
-    }
-    // Terminal operation
-    end() {
-        return this.graph;
-    }
-    // Internal method to get the built node
-    build() {
-        return this.node;
-    }
-}
-exports.NodeBuilder = NodeBuilder;
-//# sourceMappingURL=node-builder.js.map