@graph-compose/client 1.0.0

package/dist/core/tool-builder.d.ts

@@ -0,0 +1,130 @@
+import { ActivityConfig, JsonataParam, // Assuming Node is needed for GraphToolNode definition
+ToolNode } from "@graph-compose/core";
+import { GraphCompose } from "./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.
+ */
+export declare class ToolBuilder {
+    private readonly parentGraph;
+    protected tool: ToolNode;
+    private readonly id;
+    /**
+     * Creates an instance of ToolBuilder.
+     * @param parentGraph The parent GraphCompose instance.
+     * @param id The unique identifier for the tool.
+     */
+    constructor(parentGraph: GraphCompose, id: string);
+    /**
+     * 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.
+     */
+    private validateJsonataExpression;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * Sets the description for the tool.
+     * @param description A brief description of what the tool does.
+     * @returns The ToolBuilder instance for chaining.
+     */
+    description(description: string): ToolBuilder;
+    /**
+     * 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: Record<string, string | JsonataParam>): ToolBuilder;
+    /**
+     * 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: Record<string, any> | string): ToolBuilder;
+    /**
+     * 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: Partial<ActivityConfig["retryPolicy"]>): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: string): ToolBuilder;
+    /**
+     * 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: (subGraph: GraphCompose) => void): ToolBuilder;
+    /**
+     * 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(): GraphCompose;
+    /**
+     * Builds and returns the configured tool node definition.
+     * Primarily used internally by the end() method.
+     * @returns The configured ToolNode object.
+     */
+    build(): ToolNode;
+    /**
+     * @internal
+     * Retrieves the ID of the tool being built.
+     * Used for generating informative error messages.
+     * @returns The ID of the tool.
+     */
+    getId(): string;
+}
+//# sourceMappingURL=tool-builder.d.ts.map

package/dist/core/tool-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-builder.d.ts","sourceRoot":"","sources":["../../src/core/tool-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,YAAY,EAAE,uDAAuD;AACrE,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,qBAAa,WAAW;IAWpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAV9B,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAE5B;;;;OAIG;gBAEgB,WAAW,EAAE,YAAY,EAC1C,EAAE,EAAE,MAAM;IAaZ;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAkB7B;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAgB9B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAgB7B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAgBhC;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAkB/B;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW;IAK7C;;;;;;;OAOG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG,WAAW;IAexE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,WAAW;IASzD;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,GAAG,WAAW;IAkBxE;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAatD;;;;;OAKG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAezD;;;;OAIG;IACH,KAAK,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,WAAW;IAmCrE;;;;;;OAMG;IACH,GAAG,IAAI,YAAY;IAenB;;;;OAIG;IACH,KAAK,IAAI,QAAQ;IAYjB;;;;;OAKG;IACH,KAAK,IAAI,MAAM;CAGhB"}

package/dist/core/tool-builder.js

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

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class NodeMethodError extends Error {
+    constructor(methodName: string);
+}
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class CircularDependencyError extends ValidationError {
+    constructor(cycle: string[]);
+}
+export declare class InvalidNodeIdError extends ValidationError {
+    constructor(id: string);
+}
+export declare class MissingDependencyError extends ValidationError {
+    constructor(nodeId: string, missingDeps: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,KAAK,EAAE,MAAM,EAAE;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,EAAE,EAAE,MAAM;CAMvB;AAED,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CAIlD"}

package/dist/errors.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingDependencyError = exports.InvalidNodeIdError = exports.CircularDependencyError = exports.ValidationError = exports.NodeMethodError = void 0;
+class NodeMethodError extends Error {
+    constructor(methodName) {
+        super(`${methodName} is not a function - you need to create a node first with .node()`);
+        this.name = "NodeMethodError";
+    }
+}
+exports.NodeMethodError = NodeMethodError;
+class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+exports.ValidationError = ValidationError;
+class CircularDependencyError extends ValidationError {
+    constructor(cycle) {
+        super(`Circular dependencies detected: ${cycle.join(" -> ")}`);
+        this.name = "CircularDependencyError";
+    }
+}
+exports.CircularDependencyError = CircularDependencyError;
+class InvalidNodeIdError extends ValidationError {
+    constructor(id) {
+        super(`Invalid node ID: "${id}". Node IDs must be alphanumeric and use underscores, not dashes`);
+        this.name = "InvalidNodeIdError";
+    }
+}
+exports.InvalidNodeIdError = InvalidNodeIdError;
+class MissingDependencyError extends ValidationError {
+    constructor(nodeId, missingDeps) {
+        super(`Node "${nodeId}" depends on non-existent nodes: ${missingDeps.join(", ")}`);
+        this.name = "MissingDependencyError";
+    }
+}
+exports.MissingDependencyError = MissingDependencyError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,UAAkB;QAC5B,KAAK,CAAC,GAAG,UAAU,mEAAmE,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,KAAe;QACzB,KAAK,CAAC,mCAAmC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAED,MAAa,kBAAmB,SAAQ,eAAe;IACrD,YAAY,EAAU;QACpB,KAAK,CACH,qBAAqB,EAAE,kEAAkE,CAC1F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAPD,gDAOC;AAED,MAAa,sBAAuB,SAAQ,eAAe;IACzD,YAAY,MAAc,EAAE,WAAqB;QAC/C,KAAK,CAAC,SAAS,MAAM,oCAAoC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Graph Compose Client Package
+ *
+ * This package provides a type-safe builder pattern for creating and managing workflow graphs.
+ * It includes validation, error handling, and execution management capabilities.
+ *
+ * @packageDocumentation
+ */
+import "zod-openapi/extend";
+export declare const VERSION = "1.0.0";
+export * from "./core/builder";
+export * from "./core/node-builder";
+export * from "./types";
+export { validateWorkflow } from "./validation";
+export * from "./errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,oBAAoB,CAAC;AAE5B,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,SAAS,CAAC;AAIxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkflow = exports.VERSION = void 0;
+/**
+ * Graph Compose Client Package
+ *
+ * This package provides a type-safe builder pattern for creating and managing workflow graphs.
+ * It includes validation, error handling, and execution management capabilities.
+ *
+ * @packageDocumentation
+ */
+require("zod-openapi/extend");
+exports.VERSION = "1.0.0";
+// Core functionality
+__exportStar(require("./core/builder"), exports);
+__exportStar(require("./core/node-builder"), exports);
+// Type definitions
+__exportStar(require("./types"), exports);
+// Validation utilities
+// Explicitly export only needed members to avoid name clash with types.ts
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateWorkflow", { enumerable: true, get: function () { return validation_1.validateWorkflow; } });
+// Error handling
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,8BAA4B;AAEf,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,qBAAqB;AACrB,iDAA+B;AAC/B,sDAAoC;AAEpC,mBAAmB;AACnB,0CAAwB;AAExB,uBAAuB;AACvB,0EAA0E;AAC1E,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AAEzB,iBAAiB;AACjB,2CAAyB"}