@graph-compose/client 1.0.0 → 1.0.3

package/dist/core/adk-workflow-builder.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdkWorkflowBuilder = void 0;
+/**
+ * Fluent builder for composing ADK workflow configurations.
+ *
+ * This builder provides a clean API for defining:
+ * - Agents (LLM, Sequential, Parallel, Loop)
+ * - Tools (HTTP, Agent)
+ * - Root agent and workflow settings
+ *
+ * Usage:
+ * ```typescript
+ * const workflow = builder
+ *   .rootAgent("main_agent")
+ *   .agent(createLlmAgent({ ... }))
+ *   .httpTool(createHttpTool({ ... }))
+ *   .build();
+ * ```
+ */
+class AdkWorkflowBuilder {
+    constructor() {
+        this.agents = [];
+        this.globalTools = [];
+    }
+    /**
+     * Set the root agent ID (entry point for the workflow).
+     *
+     * @param agentId - ID of the agent that will be the workflow entry point
+     */
+    rootAgent(agentId) {
+        this.rootAgentId = agentId;
+        return this;
+    }
+    /**
+     * Add an agent to the workflow.
+     *
+     * Use helper functions like createLlmAgent(), createSequentialAgent(), etc.
+     * to create agent configurations.
+     *
+     * @param agentConfig - Agent configuration to add
+     */
+    agent(agentConfig) {
+        this.agents.push(agentConfig);
+        return this;
+    }
+    /**
+     * Add an HTTP tool to the workflow.
+     *
+     * Use createHttpTool() helper to create the tool configuration.
+     *
+     * @param toolConfig - HTTP tool configuration to add
+     */
+    httpTool(toolConfig) {
+        if (toolConfig.type !== "HttpTool") {
+            throw new Error(`httpTool() expects a HttpTool configuration, got ${toolConfig.type}`);
+        }
+        this.globalTools.push(toolConfig);
+        return this;
+    }
+    /**
+     * Add an Agent tool to the workflow.
+     *
+     * Use createAgentTool() helper to create the tool configuration.
+     *
+     * @param toolConfig - Agent tool configuration to add
+     */
+    agentTool(toolConfig) {
+        if (toolConfig.type !== "AgentTool") {
+            throw new Error(`agentTool() expects an AgentTool configuration, got ${toolConfig.type}`);
+        }
+        this.globalTools.push(toolConfig);
+        return this;
+    }
+    /**
+     * Set the maximum orchestration cycles (workflow iterations).
+     *
+     * This provides a safety limit for autonomous workflows to prevent runaway execution.
+     *
+     * @param cycles - Maximum number of workflow iterations allowed
+     */
+    withMaxCycles(cycles) {
+        if (cycles <= 0 || !Number.isInteger(cycles)) {
+            throw new Error("maxOrchestrationCycles must be a positive integer");
+        }
+        this.maxOrchestrationCycles = cycles;
+        return this;
+    }
+    /**
+     * Build the ADK workflow definition.
+     *
+     * Validates that all required fields are set and returns the complete
+     * workflow configuration.
+     *
+     * @returns Complete ADK workflow definition
+     * @throws Error if required fields are missing or validation fails
+     */
+    build() {
+        // Validation
+        if (!this.rootAgentId) {
+            throw new Error("Root agent ID is required. Call rootAgent() before build().");
+        }
+        if (this.agents.length === 0) {
+            throw new Error("At least one agent is required. Call agent() before build().");
+        }
+        // Validate that root agent exists in agents list
+        const rootAgentExists = this.agents.some((agent) => agent.id === this.rootAgentId);
+        if (!rootAgentExists) {
+            throw new Error(`Root agent "${this.rootAgentId}" not found in agents list. Make sure to add it with agent() before build().`);
+        }
+        // Validate agent IDs are unique
+        const agentIds = new Set();
+        for (const agent of this.agents) {
+            if (agentIds.has(agent.id)) {
+                throw new Error(`Duplicate agent ID: "${agent.id}"`);
+            }
+            agentIds.add(agent.id);
+        }
+        // Validate tool IDs are unique
+        const toolIds = new Set();
+        for (const tool of this.globalTools) {
+            if (toolIds.has(tool.id)) {
+                throw new Error(`Duplicate tool ID: "${tool.id}"`);
+            }
+            toolIds.add(tool.id);
+        }
+        // Build the workflow definition
+        const workflow = {
+            agents: this.agents,
+            rootAgentId: this.rootAgentId,
+            globalTools: this.globalTools,
+            maxOrchestrationCycles: this.maxOrchestrationCycles,
+        };
+        return workflow;
+    }
+}
+exports.AdkWorkflowBuilder = AdkWorkflowBuilder;
+//# sourceMappingURL=adk-workflow-builder.js.map

package/dist/core/adk-workflow-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adk-workflow-builder.js","sourceRoot":"","sources":["../../src/core/adk-workflow-builder.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,kBAAkB;IAA/B;QACU,WAAM,GAAkB,EAAE,CAAC;QAC3B,gBAAW,GAA2B,EAAE,CAAC;IAyInD,CAAC;IArIC;;;;OAIG;IACH,SAAS,CAAC,OAAe;QACvB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAwB;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,UAAgC;QACvC,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,oDAAoD,UAAU,CAAC,IAAI,EAAE,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,UAAgC;QACxC,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,uDAAuD,UAAU,CAAC,IAAI,EAAE,CACzE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,MAAc;QAC1B,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,aAAa;QACb,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW,CACzC,CAAC;QACF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,WAAW,8EAA8E,CAC9G,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,+BAA+B;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QAED,gCAAgC;QAChC,MAAM,QAAQ,GAA0B;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;SACpD,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AA3ID,gDA2IC"}

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

@@ -0,0 +1,80 @@
+import type { Node } from "@graph-compose/core";
+import type { GraphCompose } from "./builder";
+/**
+ * Base interface for all node builders.
+ * Defines the contract that all node builders must implement.
+ */
+export interface BaseNodeBuilder<T extends Node> {
+    /**
+     * Get the node ID (used for error messages and tracking)
+     */
+    getId(): string;
+    /**
+     * Build the final node configuration.
+     * This is where the builder validates and constructs the node object.
+     */
+    build(): T;
+    /**
+     * Finalize the node definition and add it to the parent graph.
+     * This method should be called last in the builder chain.
+     * @returns The parent GraphCompose instance for further chaining
+     */
+    end(): GraphCompose;
+}
+/**
+ * Abstract base class for node builders with shared functionality.
+ *
+ * This class provides common implementation for:
+ * - ID management
+ * - Lifecycle management (end() method)
+ * - Integration with parent graph
+ *
+ * Subclasses must implement:
+ * - build(): Construct the specific node type
+ *
+ * @example
+ * ```typescript
+ * class MyNodeBuilder extends AbstractNodeBuilder<MyNode> {
+ *   build(): MyNode {
+ *     return {
+ *       id: this.id,
+ *       type: "my_type",
+ *       // ... other config
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class AbstractNodeBuilder<T extends Node> implements BaseNodeBuilder<T> {
+    protected readonly graph: GraphCompose;
+    protected readonly id: string;
+    /**
+     * Creates a new node builder instance.
+     *
+     * @param graph The parent GraphCompose instance
+     * @param id The unique identifier for the node being built
+     */
+    constructor(graph: GraphCompose, id: string);
+    /**
+     * Get the node ID.
+     * Used for error messages and builder state tracking.
+     */
+    getId(): string;
+    /**
+     * Build the final node configuration.
+     * Must be implemented by subclasses to construct their specific node type.
+     */
+    abstract build(): T;
+    /**
+     * Finalize the node definition and add it to the parent graph.
+     *
+     * This method:
+     * 1. Calls build() to construct the node
+     * 2. Adds the node to the parent graph
+     * 3. Returns the graph for further chaining
+     *
+     * @returns The parent GraphCompose instance
+     */
+    end(): GraphCompose;
+}
+//# sourceMappingURL=base-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-builder.d.ts","sourceRoot":"","sources":["../../src/core/base-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,IAAI;IAC7C;;OAEG;IACH,KAAK,IAAI,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,IAAI,CAAC,CAAC;IAEX;;;;OAIG;IACH,GAAG,IAAI,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,mBAAmB,CAAC,CAAC,SAAS,IAAI,CACtD,YAAW,eAAe,CAAC,CAAC,CAAC;IAS3B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY;IACtC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM;IAR/B;;;;;OAKG;gBAEkB,KAAK,EAAE,YAAY,EACnB,EAAE,EAAE,MAAM;IAG/B;;;OAGG;IACH,KAAK,IAAI,MAAM;IAIf;;;OAGG;IACH,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEnB;;;;;;;;;OASG;IACH,GAAG,IAAI,YAAY;CAKpB"}

package/dist/core/base-builder.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractNodeBuilder = void 0;
+/**
+ * Abstract base class for node builders with shared functionality.
+ *
+ * This class provides common implementation for:
+ * - ID management
+ * - Lifecycle management (end() method)
+ * - Integration with parent graph
+ *
+ * Subclasses must implement:
+ * - build(): Construct the specific node type
+ *
+ * @example
+ * ```typescript
+ * class MyNodeBuilder extends AbstractNodeBuilder<MyNode> {
+ *   build(): MyNode {
+ *     return {
+ *       id: this.id,
+ *       type: "my_type",
+ *       // ... other config
+ *     };
+ *   }
+ * }
+ * ```
+ */
+class AbstractNodeBuilder {
+    /**
+     * Creates a new node builder instance.
+     *
+     * @param graph The parent GraphCompose instance
+     * @param id The unique identifier for the node being built
+     */
+    constructor(graph, id) {
+        this.graph = graph;
+        this.id = id;
+    }
+    /**
+     * Get the node ID.
+     * Used for error messages and builder state tracking.
+     */
+    getId() {
+        return this.id;
+    }
+    /**
+     * Finalize the node definition and add it to the parent graph.
+     *
+     * This method:
+     * 1. Calls build() to construct the node
+     * 2. Adds the node to the parent graph
+     * 3. Returns the graph for further chaining
+     *
+     * @returns The parent GraphCompose instance
+     */
+    end() {
+        const node = this.build();
+        this.graph._addNodeDefinition(node);
+        return this.graph;
+    }
+}
+exports.AbstractNodeBuilder = AbstractNodeBuilder;
+//# sourceMappingURL=base-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-builder.js","sourceRoot":"","sources":["../../src/core/base-builder.ts"],"names":[],"mappings":";;;AA2BA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAsB,mBAAmB;IAGvC;;;;;OAKG;IACH,YACqB,KAAmB,EACnB,EAAU;QADV,UAAK,GAAL,KAAK,CAAc;QACnB,OAAE,GAAF,EAAE,CAAQ;IAC5B,CAAC;IAEJ;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAQD;;;;;;;;;OASG;IACH,GAAG;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AA3CD,kDA2CC"}

package/dist/core/builder.d.ts

@@ -1,7 +1,7 @@
-import { Node, ToolNode, WorkflowConfig, WorkflowGraph } from "@graph-compose/core";
-import { ApiResponse, ValidationResult as ClientValidationResult, ExecuteOptions, GetWorkflowResponse, TerminateWorkflowResponse, WorkflowResponse } from "../types";
+import { Node, WorkflowConfig, WorkflowGraph } from "@graph-compose/core";
+import { ApiResponse, ClientValidationResult, ExecuteOptions, GetWorkflowResponse, TerminateWorkflowResponse, WorkflowResponse } from "../types";
 import { NodeBuilder } from "./node-builder";
-import { ToolBuilder } from "./tool-builder";
+import { AdkNodeBuilder } from "./adk-node-builder";
 interface ApiValidationError {
     name: string;
     message: string;
@@ -17,7 +17,7 @@ export interface GraphComposeOptions {
 /**
  * GraphCompose is the main builder class for creating workflow graphs.
  * It provides a fluent API for building and executing workflows composed of HTTP nodes, agents, and error boundaries.
- * You configure each node or tool using chained methods and **must** call `.end()` to finalize its definition.
+ * You configure each node using chained methods and **must** call `.end()` to finalize its definition.
  *
  * @example
  * ```typescript
@@ -29,30 +29,26 @@ export interface GraphComposeOptions {
  *   .withHeaders({ "Authorization": "Bearer token" })
  *   .end(); // Required!
  *
- * // Define and end a tool (example)
- * graph.tool("analyze")
- *   .post("https://api.example.com/analyze")
- *   .end();
- *
- * // Create and finalize an agent node that uses the tool
- * graph.agent("process_data")
- *   .withMaxIterations(5)
- *   .withTools(["analyze"])
- *   .post("https://api.example.com/agent")
+ * // Create and finalize another node with dependencies
+ * graph.node("process_data")
+ *   .post("https://api.example.com/process")
  *   .withDependencies(["fetch_data"])
+ *   .withBody(({ results }) => ({
+ *     data: results.fetch_data
+ *   }))
  *   .end(); // Required!
  *
- * // Validate the complete workflow (requires all nodes/tools ended)
+ * // Validate the complete workflow (requires all nodes ended)
  * const validationResult = graph.validate();
  * if (!validationResult.isValid) { console.error("Validation failed:", validationResult.errors); }
  *
- * // Execute the workflow (requires all nodes/tools ended)
+ * // Execute the workflow (requires all nodes ended)
  * try {
  *   const result = await graph.execute({});
  *   console.log("Execution started:", result);
  * } catch (error) { console.error("Execution failed:", error); }
  *
- * // Get the raw workflow definition (requires all nodes/tools ended)
+ * // Get the raw workflow definition (requires all nodes ended)
  * const definition = graph.toJSON();
  * console.log("Workflow JSON:", JSON.stringify(definition, null, 2));
  *
@@ -63,9 +59,7 @@ export interface GraphComposeOptions {
  */
 export declare class GraphCompose {
     private nodes;
-    private _tools;
     private currentNodeBuilder?;
-    private currentToolBuilder?;
     private webhookUrl?;
     private context?;
     private workflowConfig?;
@@ -78,8 +72,6 @@ export declare class GraphCompose {
      * @throws {Error} If no API token is provided via options or environment variable
      */
     constructor(options?: GraphComposeOptions);
-    /** Internal method for ToolBuilder to add its definition */
-    _addToolDefinition(tool: ToolNode): void;
     /** Internal method for NodeBuilder to add its definition */
     _addNodeDefinition(node: Node): void;
     /**
@@ -126,40 +118,35 @@ export declare class GraphCompose {
      */
     errorBoundary(id: string, protectedNodes: string[]): NodeBuilder;
     /**
-     * Start building a new agent node.
-     * Agent nodes are special nodes that can execute multiple iterations and use tools.
-     * **Note:** You must call `.end()` on the returned `NodeBuilder` before starting another node or finishing the graph.
+     * Start building a new ADK (Agent Development Kit) node.
+     * ADK nodes enable agentic workflows with multi-agent orchestration.
+     * **Note:** You must call `.end()` on the returned `AdkNodeBuilder` before starting another node or finishing the graph.
      *
      * @param id Unique identifier for the node (must be alphanumeric with underscores)
-     * @returns NodeBuilder instance for method chaining
-     * @throws {Error} If another node or tool is currently being built.
-     * @example
-     * ```typescript
-     * graph.agent("research_agent")
-     *   .withMaxIterations(10)
-     *   .withTools(["search", "analyze"])
-     *   .post("https://api.example.com/agent")
-     *   .end(); // Required!
-     * ```
-     */
-    agent(id: string): NodeBuilder;
-    /**
-     * Start building a new tool definition.
-     * Tools are reusable components (HTTP calls or sub-graphs) usable by agent nodes.
-     * **Note:** You must call `.end()` on the returned `ToolBuilder` before starting another tool/node or finishing the graph.
-     *
-     * @param id Unique identifier for the tool (must be alphanumeric with underscores)
-     * @returns ToolBuilder instance for method chaining
+     * @returns AdkNodeBuilder instance for method chaining
      * @throws {Error} If another node or tool is currently being built.
      * @example
      * ```typescript
-     * graph.tool("search")
-     *   .get("https://api.search.com")
-     *   .withHeaders({ "Authorization": "Bearer token" })
+     * graph.adk("customer_support")
+     *   .withWorkflow(builder =>
+     *     builder
+     *       .rootAgent("support_agent")
+     *       .agent(createLlmAgent({
+     *         id: "support_agent",
+     *         httpConfig: { url: "https://llm.example.com", method: "POST" },
+     *         tools: ["search_kb"],
+     *         outputKey: "support_response"
+     *       }))
+     *       .httpTool(createHttpTool({
+     *         id: "search_kb",
+     *         httpConfig: { url: "https://kb.example.com/search", method: "POST" }
+     *       }))
+     *       .build()
+     *   )
      *   .end(); // Required!
      * ```
      */
-    tool(id: string): ToolBuilder;
+    adk(id: string): AdkNodeBuilder;
     /**
      * Add a pre-configured node to the workflow.
      * Ensures no other builder is active before adding.
@@ -169,15 +156,6 @@ export declare class GraphCompose {
      * @throws {Error} If another node or tool is currently being built.
      */
     addNode(node: Node): GraphCompose;
-    /**
-     * Add a pre-configured tool definition to the workflow.
-     * Ensures no other builder is active before adding.
-     *
-     * @param tool The tool configuration to add
-     * @returns this GraphCompose instance for method chaining
-     * @throws {Error} If another node or tool is currently being built.
-     */
-    addTool(tool: ToolNode): GraphCompose;
     /**
      * Get the complete workflow definition object.
      * This includes all nodes, tools, webhook URL, context, and workflow configuration.
@@ -203,9 +181,8 @@ export declare class GraphCompose {
      * - Valid node IDs
      * - Valid URLs
      * - Valid dependencies
-     * - Valid tool configurations
      * - No circular dependencies
-     * - Agent-specific requirements (e.g., `max_iterations` presence and value)
+     * - Valid error boundary configurations
      *
      * Note: This performs client-side validation only. Use `validateApi()` for server-side checks including tier limits.
      *
@@ -277,15 +254,6 @@ export declare class GraphCompose {
      * ```
      */
     execute(options?: Omit<ExecuteOptions, "token" | "baseUrl">): Promise<ApiResponse<WorkflowResponse | null>>;
-    /**
-     * Execute the workflow synchronously and wait for completion.
-     * **Note:** Requires all active builders to be finalized using `.end()`.
-     *
-     * @param options Execution options including webhook URL and context
-     * @returns Promise resolving to the full API response containing the final workflow details (status, results, error) upon completion or failure.
-     * @throws {Error} If a node or tool is currently being built (missing `.end()`).
-     */
-    executeSync(options?: Omit<ExecuteOptions, "token" | "baseUrl">): Promise<ApiResponse<WorkflowResponse | null>>;
     /**
      * Set the webhook URL for workflow notifications.
      * **Note:** Requires all active builders to be finalized using `.end()`.

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

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