@graph-compose/client 1.0.0

package/dist/node-builder.d.ts

@@ -0,0 +1,64 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,261 @@
+"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

package/dist/node-builder.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export interface ExecuteOptions {
+    /**
+     * Context data to pass to the workflow
+     */
+    context?: Record<string, any>;
+    /**
+     * Webhook URL to receive notifications about workflow progress
+     */
+    webhookUrl?: string;
+}
+/**
+ * Represents the detailed response for getting workflow status or synchronous execution results.
+ */
+export interface WorkflowResponse<TState = any, TErr = any> {
+    /** Unique identifier for the workflow execution */
+    workflowId: string;
+    /** Unique identifier for the specific workflow run */
+    runId: string;
+    /** ISO string timestamp when the workflow started */
+    startedAt: string;
+    /** User ID associated with the workflow */
+    userId: string;
+    /** Organization ID associated with the workflow */
+    organizationId: string;
+    /** Current status of the workflow execution */
+    status: "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED" | "TERMINATED" | "CONTINUED_AS_NEW" | "TIMED_OUT";
+    /**
+     * The current state of the workflow (e.g., node results).
+     * Structure depends on the workflow implementation.
+     * Often null if status is RUNNING, FAILED, or TERMINATED.
+     */
+    executionState?: TState | null;
+    /**
+     * Error information if workflow status is FAILED or TERMINATED.
+     * Structure varies based on failure type.
+     */
+    error?: TErr | null;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    message: string;
+    data: T | null;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    errors: {
+        name: string;
+        message: string;
+    }[];
+}
+export interface GetWorkflowResponse {
+    workflow_id: string;
+    run_id: string;
+    started_at: string;
+    user_id: string;
+    organization_id: string;
+    status: string;
+    execution_state: any;
+    error?: any;
+}
+export interface TerminateWorkflowResponse {
+    workflowId: string;
+    status: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG;IACxD,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,MAAM,EACF,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,WAAW,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACrB;AAID,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAChB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C;AAID,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,GAAG,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAID,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// --- Added Types --- END
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AAkFA,0BAA0B"}

package/dist/validation/index.d.ts

@@ -0,0 +1,34 @@
+import { WorkflowGraph } from "@graph-compose/core";
+import { z } from "zod";
+export declare const ValidationResponseSchema: z.ZodObject<{
+    isValid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodType<Error, z.ZodTypeDef, Error>, "many">;
+}, "strip", z.ZodTypeAny, {
+    isValid: boolean;
+    errors: Error[];
+}, {
+    isValid: boolean;
+    errors: Error[];
+}>;
+export interface ValidationResult extends z.infer<typeof ValidationResponseSchema> {
+}
+/**
+ * Validates a workflow definition
+ */
+export declare function validateWorkflow(workflow: WorkflowGraph): ValidationResult;
+/**
+ * Validates a JSONata expression within a node's configuration
+ * @param expr - The JSONata expression to validate
+ * @param nodeId - The ID of the node containing the expression
+ * @returns A validation result indicating success or failure
+ */
+declare function validateExpression(expr: string, nodeId: string): ValidationResult;
+/**
+ * Validates a template string containing JSONata expressions
+ * @param template - The template string to validate
+ * @param nodeId - The ID of the node containing the template
+ * @returns A validation result indicating success or failure
+ */
+declare function validateTemplate(template: string, nodeId: string): ValidationResult;
+export { validateExpression, validateTemplate };
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,aAAa,EAAuB,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,WAAW,gBAAiB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC;CAAG;AA+FrF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,gBAAgB,CA4J1E;AAED;;;;;GAKG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAyB1E;AAED;;;;;GAKG;AACH,iBAAS,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA8C5E;AAGD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC"}