@graph-compose/client 1.0.0 → 1.0.3

package/dist/core/adk-helpers.d.ts

@@ -0,0 +1,94 @@
+import type { ActivityConfig, AgentConfig, GlobalAgentToolDefinition, GlobalHttpToolDefinition, HTTPConfig, LlmAgentConfig, LoopAgentConfig, ParallelAgentConfig, SequentialAgentConfig, SubAgentReference } from "@graph-compose/core";
+/**
+ * Helper function to create an LLM agent configuration.
+ *
+ * LLM agents are the basic building blocks that make HTTP calls to your LLM service.
+ * They can use tools, maintain conversation history, and contribute to session state.
+ */
+export declare function createLlmAgent(config: {
+    id: string;
+    httpConfig: HTTPConfig;
+    instructions?: string;
+    tools?: string[];
+    outputKey?: string;
+    activityConfig?: ActivityConfig;
+    subAgents?: AgentConfig[];
+}): LlmAgentConfig;
+/**
+ * Helper function to create a Sequential agent configuration.
+ *
+ * Sequential agents execute their sub-agents one after another in order.
+ * Each sub-agent can access outputs from previous agents via session state.
+ * Note: SequentialAgent runs natively in the workflow (not as an HTTP activity).
+ */
+export declare function createSequentialAgent(config: {
+    id: string;
+    subAgents: Array<{
+        agentId: string;
+    }>;
+    outputKey?: string;
+    instructions?: string;
+}): SequentialAgentConfig;
+/**
+ * Helper function to create a Parallel agent configuration.
+ *
+ * Parallel agents execute their sub-agents concurrently.
+ * Note: ParallelAgent does NOT support outputKey - sub-agents should have their own outputKeys.
+ * Note: ParallelAgent runs natively in the workflow (not as an HTTP activity).
+ */
+export declare function createParallelAgent(config: {
+    id: string;
+    subAgents: Array<{
+        agentId: string;
+    }>;
+    instructions?: string;
+}): ParallelAgentConfig;
+/**
+ * Helper function to create a Loop agent configuration.
+ *
+ * Loop agents repeatedly execute their sub-agents until a condition is met
+ * or the maximum iterations is reached.
+ * Note: LoopAgent runs natively in the workflow (not as an HTTP activity).
+ */
+export declare function createLoopAgent(config: {
+    id: string;
+    subAgents: Array<{
+        agentId: string;
+    }>;
+    maxAgentLoopIterations: number;
+    loopExitCondition?: string;
+    outputKey?: string;
+    instructions?: string;
+}): LoopAgentConfig;
+/**
+ * Helper function to create an HTTP tool definition.
+ *
+ * HTTP tools make external HTTP calls when invoked by agents.
+ * Results are returned to the agent and optionally saved to session state.
+ */
+export declare function createHttpTool(config: {
+    id: string;
+    httpConfig: HTTPConfig;
+    outputKey?: string;
+    activityConfig?: ActivityConfig;
+}): GlobalHttpToolDefinition;
+/**
+ * Helper function to create an Agent tool definition.
+ *
+ * Agent tools allow one agent to delegate work to another agent.
+ * The target agent's response is returned to the calling agent.
+ */
+export declare function createAgentTool(config: {
+    id: string;
+    targetAgentId: string;
+    outputKey?: string;
+    skipSummarization?: boolean;
+}): GlobalAgentToolDefinition;
+/**
+ * Helper function to create a sub-agent reference.
+ *
+ * Used by orchestrator agents (Sequential, Parallel, Loop) to reference
+ * other agents defined at the workflow level.
+ */
+export declare function createSubAgentReference(agentId: string): SubAgentReference;
+//# sourceMappingURL=adk-helpers.d.ts.map

package/dist/core/adk-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adk-helpers.d.ts","sourceRoot":"","sources":["../../src/core/adk-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,UAAU,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B,GAAG,cAAc,CAcjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,qBAAqB,CAWxB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAUtB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,eAAe,CAalB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,wBAAwB,CAW3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,yBAAyB,CAW5B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAE1E"}

package/dist/core/adk-helpers.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLlmAgent = createLlmAgent;
+exports.createSequentialAgent = createSequentialAgent;
+exports.createParallelAgent = createParallelAgent;
+exports.createLoopAgent = createLoopAgent;
+exports.createHttpTool = createHttpTool;
+exports.createAgentTool = createAgentTool;
+exports.createSubAgentReference = createSubAgentReference;
+/**
+ * Helper function to create an LLM agent configuration.
+ *
+ * LLM agents are the basic building blocks that make HTTP calls to your LLM service.
+ * They can use tools, maintain conversation history, and contribute to session state.
+ */
+function createLlmAgent(config) {
+    const agent = {
+        type: "LlmAgent",
+        id: config.id,
+        httpConfig: config.httpConfig,
+        tools: config.tools || [],
+        subAgents: config.subAgents || [],
+    };
+    if (config.instructions)
+        agent.instructions = config.instructions;
+    if (config.outputKey)
+        agent.outputKey = config.outputKey;
+    if (config.activityConfig)
+        agent.activityConfig = config.activityConfig;
+    return agent;
+}
+/**
+ * Helper function to create a Sequential agent configuration.
+ *
+ * Sequential agents execute their sub-agents one after another in order.
+ * Each sub-agent can access outputs from previous agents via session state.
+ * Note: SequentialAgent runs natively in the workflow (not as an HTTP activity).
+ */
+function createSequentialAgent(config) {
+    const agent = {
+        type: "SequentialAgent",
+        id: config.id,
+        subAgents: config.subAgents,
+    };
+    if (config.outputKey)
+        agent.outputKey = config.outputKey;
+    if (config.instructions)
+        agent.instructions = config.instructions;
+    return agent;
+}
+/**
+ * Helper function to create a Parallel agent configuration.
+ *
+ * Parallel agents execute their sub-agents concurrently.
+ * Note: ParallelAgent does NOT support outputKey - sub-agents should have their own outputKeys.
+ * Note: ParallelAgent runs natively in the workflow (not as an HTTP activity).
+ */
+function createParallelAgent(config) {
+    const agent = {
+        type: "ParallelAgent",
+        id: config.id,
+        subAgents: config.subAgents,
+    };
+    if (config.instructions)
+        agent.instructions = config.instructions;
+    return agent;
+}
+/**
+ * Helper function to create a Loop agent configuration.
+ *
+ * Loop agents repeatedly execute their sub-agents until a condition is met
+ * or the maximum iterations is reached.
+ * Note: LoopAgent runs natively in the workflow (not as an HTTP activity).
+ */
+function createLoopAgent(config) {
+    const agent = {
+        type: "LoopAgent",
+        id: config.id,
+        subAgents: config.subAgents,
+        maxAgentLoopIterations: config.maxAgentLoopIterations,
+    };
+    if (config.loopExitCondition)
+        agent.loopExitCondition = config.loopExitCondition;
+    if (config.outputKey)
+        agent.outputKey = config.outputKey;
+    if (config.instructions)
+        agent.instructions = config.instructions;
+    return agent;
+}
+/**
+ * Helper function to create an HTTP tool definition.
+ *
+ * HTTP tools make external HTTP calls when invoked by agents.
+ * Results are returned to the agent and optionally saved to session state.
+ */
+function createHttpTool(config) {
+    const tool = {
+        type: "HttpTool",
+        id: config.id,
+        httpConfig: config.httpConfig,
+    };
+    if (config.outputKey)
+        tool.outputKey = config.outputKey;
+    if (config.activityConfig)
+        tool.activityConfig = config.activityConfig;
+    return tool;
+}
+/**
+ * Helper function to create an Agent tool definition.
+ *
+ * Agent tools allow one agent to delegate work to another agent.
+ * The target agent's response is returned to the calling agent.
+ */
+function createAgentTool(config) {
+    const tool = {
+        type: "AgentTool",
+        id: config.id,
+        targetAgentId: config.targetAgentId,
+        skipSummarization: config.skipSummarization ?? false,
+    };
+    if (config.outputKey)
+        tool.outputKey = config.outputKey;
+    return tool;
+}
+/**
+ * Helper function to create a sub-agent reference.
+ *
+ * Used by orchestrator agents (Sequential, Parallel, Loop) to reference
+ * other agents defined at the workflow level.
+ */
+function createSubAgentReference(agentId) {
+    return { agentId };
+}
+//# sourceMappingURL=adk-helpers.js.map

package/dist/core/adk-helpers.js.map

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

package/dist/core/adk-node-builder.d.ts

@@ -0,0 +1,128 @@
+import type { ActivityConfig, AdkNode, ADKWorkflowDefinition } from "@graph-compose/core";
+import { AdkWorkflowBuilder } from "./adk-workflow-builder";
+import { AbstractNodeBuilder } from "./base-builder";
+/**
+ * Builder for ADK (Agent Development Kit) nodes in the workflow graph.
+ *
+ * ADK nodes enable agentic workflows with:
+ * - Multiple agents (LLM, Sequential, Parallel, Loop)
+ * - Global tools (HTTP, Agent delegation)
+ * - Human-in-the-Loop (HITL) interactions
+ * - Multi-agent orchestration patterns
+ *
+ * Usage:
+ * ```typescript
+ * graph.adk("customer_support")
+ *   .withWorkflow(builder =>
+ *     builder
+ *       .rootAgent("support_agent")
+ *       .agent(createLlmAgent({ ... }))
+ *       .httpTool(createHttpTool({ ... }))
+ *       .build()
+ *   )
+ *   .withDependencies("fetch_user_data")
+ *   .withActivityConfig({ ... })
+ *   .end();
+ * ```
+ */
+export declare class AdkNodeBuilder extends AbstractNodeBuilder<AdkNode> {
+    private config?;
+    private dependencies;
+    private activityConfig?;
+    /**
+     * Define the ADK workflow using a fluent builder.
+     *
+     * The builder function receives an AdkWorkflowBuilder instance that provides
+     * methods for composing agents, tools, and workflow settings.
+     *
+     * @param builderFn - Function that builds the ADK workflow configuration
+     * @example
+     * ```typescript
+     * .withWorkflow(builder =>
+     *   builder
+     *     .rootAgent("main_agent")
+     *     .agent(createLlmAgent({ id: "main_agent", ... }))
+     *     .build()
+     * )
+     * ```
+     */
+    withWorkflow(builderFn: (builder: AdkWorkflowBuilder) => ADKWorkflowDefinition): this;
+    /**
+     * Set the dependencies for this ADK node.
+     *
+     * Dependencies are other node IDs that must complete before this ADK node executes.
+     *
+     * @param deps - Node IDs that this node depends on
+     * @example
+     * ```typescript
+     * .withDependencies("fetch_user_data", "validate_input")
+     * ```
+     */
+    withDependencies(...deps: string[]): this;
+    /**
+     * Set the Temporal activity configuration for this ADK node.
+     *
+     * Controls retry policies, timeouts, and other Temporal activity settings.
+     *
+     * @param config - Activity configuration
+     * @example
+     * ```typescript
+     * .withActivityConfig({
+     *   startToCloseTimeout: "5m",
+     *   retryPolicy: { maximumAttempts: 3 }
+     * })
+     * ```
+     */
+    withActivityConfig(config: ActivityConfig): this;
+    /**
+     * Set the maximum orchestration cycles for the ADK workflow.
+     *
+     * This is a shorthand for setting maxOrchestrationCycles in the workflow config.
+     * Provides a safety limit for autonomous workflows.
+     *
+     * @param cycles - Maximum number of workflow iterations
+     * @example
+     * ```typescript
+     * .withMaxCycles(10)
+     * ```
+     */
+    withMaxCycles(cycles: number): this;
+    /**
+     * Set the initial user input/prompt for the ADK workflow.
+     *
+     * This is the user's initial message that starts the agentic workflow.
+     *
+     * @param prompt - Initial user message/prompt
+     * @example
+     * ```typescript
+     * .withInitialPrompt("Help me process this insurance claim")
+     * ```
+     */
+    withInitialPrompt(prompt: string): this;
+    /**
+     * Seed the ADK workflow with initial state.
+     *
+     * This allows passing state from external workflows or systems into the ADK workflow.
+     * The state is available to all agents via the session state.
+     *
+     * @param state - Initial state object
+     * @example
+     * ```typescript
+     * .withState({
+     *   user_profile: { name: "John", id: "123" },
+     *   context: { source: "typescript_workflow" }
+     * })
+     * ```
+     */
+    withState(state: Record<string, any>): this;
+    /**
+     * Build the ADK node.
+     *
+     * Validates that the workflow configuration is set and returns the complete ADK node.
+     *
+     * @returns Complete ADK node definition
+     * @throws Error if workflow configuration is missing
+     */
+    build(): AdkNode;
+}
+//# sourceMappingURL=adk-node-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adk-node-builder.d.ts","sourceRoot":"","sources":["../../src/core/adk-node-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAC,CAAiB;IAExC;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,qBAAqB,GAAG,IAAI;IAMrF;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzC;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKhD;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWnC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQvC;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQ3C;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO;CAejB"}

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

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdkNodeBuilder = void 0;
+const adk_workflow_builder_1 = require("./adk-workflow-builder");
+const base_builder_1 = require("./base-builder");
+/**
+ * Builder for ADK (Agent Development Kit) nodes in the workflow graph.
+ *
+ * ADK nodes enable agentic workflows with:
+ * - Multiple agents (LLM, Sequential, Parallel, Loop)
+ * - Global tools (HTTP, Agent delegation)
+ * - Human-in-the-Loop (HITL) interactions
+ * - Multi-agent orchestration patterns
+ *
+ * Usage:
+ * ```typescript
+ * graph.adk("customer_support")
+ *   .withWorkflow(builder =>
+ *     builder
+ *       .rootAgent("support_agent")
+ *       .agent(createLlmAgent({ ... }))
+ *       .httpTool(createHttpTool({ ... }))
+ *       .build()
+ *   )
+ *   .withDependencies("fetch_user_data")
+ *   .withActivityConfig({ ... })
+ *   .end();
+ * ```
+ */
+class AdkNodeBuilder extends base_builder_1.AbstractNodeBuilder {
+    constructor() {
+        super(...arguments);
+        this.dependencies = [];
+    }
+    /**
+     * Define the ADK workflow using a fluent builder.
+     *
+     * The builder function receives an AdkWorkflowBuilder instance that provides
+     * methods for composing agents, tools, and workflow settings.
+     *
+     * @param builderFn - Function that builds the ADK workflow configuration
+     * @example
+     * ```typescript
+     * .withWorkflow(builder =>
+     *   builder
+     *     .rootAgent("main_agent")
+     *     .agent(createLlmAgent({ id: "main_agent", ... }))
+     *     .build()
+     * )
+     * ```
+     */
+    withWorkflow(builderFn) {
+        const builder = new adk_workflow_builder_1.AdkWorkflowBuilder();
+        this.config = builderFn(builder);
+        return this;
+    }
+    /**
+     * Set the dependencies for this ADK node.
+     *
+     * Dependencies are other node IDs that must complete before this ADK node executes.
+     *
+     * @param deps - Node IDs that this node depends on
+     * @example
+     * ```typescript
+     * .withDependencies("fetch_user_data", "validate_input")
+     * ```
+     */
+    withDependencies(...deps) {
+        this.dependencies = deps;
+        return this;
+    }
+    /**
+     * Set the Temporal activity configuration for this ADK node.
+     *
+     * Controls retry policies, timeouts, and other Temporal activity settings.
+     *
+     * @param config - Activity configuration
+     * @example
+     * ```typescript
+     * .withActivityConfig({
+     *   startToCloseTimeout: "5m",
+     *   retryPolicy: { maximumAttempts: 3 }
+     * })
+     * ```
+     */
+    withActivityConfig(config) {
+        this.activityConfig = config;
+        return this;
+    }
+    /**
+     * Set the maximum orchestration cycles for the ADK workflow.
+     *
+     * This is a shorthand for setting maxOrchestrationCycles in the workflow config.
+     * Provides a safety limit for autonomous workflows.
+     *
+     * @param cycles - Maximum number of workflow iterations
+     * @example
+     * ```typescript
+     * .withMaxCycles(10)
+     * ```
+     */
+    withMaxCycles(cycles) {
+        if (!this.config) {
+            throw new Error("Must call withWorkflow() before withMaxCycles()");
+        }
+        if (cycles <= 0 || !Number.isInteger(cycles)) {
+            throw new Error("maxOrchestrationCycles must be a positive integer");
+        }
+        this.config.maxOrchestrationCycles = cycles;
+        return this;
+    }
+    /**
+     * Set the initial user input/prompt for the ADK workflow.
+     *
+     * This is the user's initial message that starts the agentic workflow.
+     *
+     * @param prompt - Initial user message/prompt
+     * @example
+     * ```typescript
+     * .withInitialPrompt("Help me process this insurance claim")
+     * ```
+     */
+    withInitialPrompt(prompt) {
+        if (!this.config) {
+            throw new Error("Must call withWorkflow() before withInitialPrompt()");
+        }
+        this.config.initialUserInput = prompt;
+        return this;
+    }
+    /**
+     * Seed the ADK workflow with initial state.
+     *
+     * This allows passing state from external workflows or systems into the ADK workflow.
+     * The state is available to all agents via the session state.
+     *
+     * @param state - Initial state object
+     * @example
+     * ```typescript
+     * .withState({
+     *   user_profile: { name: "John", id: "123" },
+     *   context: { source: "typescript_workflow" }
+     * })
+     * ```
+     */
+    withState(state) {
+        if (!this.config) {
+            throw new Error("Must call withWorkflow() before withState()");
+        }
+        this.config.state = state;
+        return this;
+    }
+    /**
+     * Build the ADK node.
+     *
+     * Validates that the workflow configuration is set and returns the complete ADK node.
+     *
+     * @returns Complete ADK node definition
+     * @throws Error if workflow configuration is missing
+     */
+    build() {
+        if (!this.config) {
+            throw new Error("ADK workflow configuration is required. Call withWorkflow() before end().");
+        }
+        const node = {
+            id: this.id,
+            type: "adk",
+            config: this.config,
+            dependencies: this.dependencies.length > 0 ? this.dependencies : undefined,
+            activityConfig: this.activityConfig,
+        };
+        return node;
+    }
+}
+exports.AdkNodeBuilder = AdkNodeBuilder;
+//# sourceMappingURL=adk-node-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adk-node-builder.js","sourceRoot":"","sources":["../../src/core/adk-node-builder.ts"],"names":[],"mappings":";;;AACA,iEAA4D;AAC5D,iDAAqD;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,cAAe,SAAQ,kCAA4B;IAAhE;;QAEU,iBAAY,GAAa,EAAE,CAAC;IAqJtC,CAAC;IAlJC;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,SAAiE;QAC5E,MAAM,OAAO,GAAG,IAAI,yCAAkB,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,GAAG,IAAc;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,MAAsB;QACvC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,MAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,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,MAAM,CAAC,sBAAsB,GAAG,MAAM,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,MAAc;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAA0B;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,IAAI,GAAY;YACpB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;YAC1E,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAvJD,wCAuJC"}

package/dist/core/adk-workflow-builder.d.ts

@@ -0,0 +1,74 @@
+import type { ADKWorkflowDefinition, AgentConfig, GlobalToolDefinition } from "@graph-compose/core";
+/**
+ * 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();
+ * ```
+ */
+export declare class AdkWorkflowBuilder {
+    private agents;
+    private globalTools;
+    private rootAgentId?;
+    private maxOrchestrationCycles?;
+    /**
+     * 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: string): 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: AgentConfig): 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: GlobalToolDefinition): 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: GlobalToolDefinition): 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: number): 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(): ADKWorkflowDefinition;
+}
+//# sourceMappingURL=adk-workflow-builder.d.ts.map

package/dist/core/adk-workflow-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adk-workflow-builder.d.ts","sourceRoot":"","sources":["../../src/core/adk-workflow-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKhC;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAKrC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAUhD;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAUjD;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQnC;;;;;;;;OAQG;IACH,KAAK,IAAI,qBAAqB;CAoD/B"}