@strands-agents/sdk 0.4.0 → 0.6.0

package/dist/src/multiagent/graph.js

@@ -0,0 +1,394 @@
+import { Agent } from '../agent/agent.js';
+import { TextBlock } from '../types/messages.js';
+import { HookableEvent } from '../hooks/events.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+import { AgentNode, MultiAgentNode, Node } from './nodes.js';
+import { MultiAgentState, MultiAgentResult, NodeResult, Status } from './state.js';
+import { AfterMultiAgentInvocationEvent, AfterNodeCallEvent, BeforeMultiAgentInvocationEvent, BeforeNodeCallEvent, MultiAgentHandoffEvent, MultiAgentInitializedEvent, MultiAgentResultEvent, NodeCancelEvent, } from './events.js';
+import { Edge } from './edge.js';
+import { Queue } from './queue.js';
+/**
+ * Directed graph orchestration pattern.
+ *
+ * Agents execute as nodes in a dependency graph, with edges defining execution order
+ * and optional conditions controlling routing. Source nodes (those with no incoming edges)
+ * run first, and downstream nodes execute once all their dependencies complete. Parallel
+ * execution is supported up to a configurable concurrency limit.
+ *
+ * Key design choices vs the Python SDK:
+ * - Construction uses a declarative options object rather than a mutable GraphBuilder.
+ *   Nodes and edges are passed directly to the constructor.
+ * - Dependency resolution uses AND semantics: a node runs only when all incoming edges
+ *   are satisfied. Python uses OR semantics, firing a node when any single incoming
+ *   edge from the completed batch is satisfied.
+ * - Nodes are launched individually as they become ready (up to maxConcurrency). Python
+ *   executes in discrete batches, waiting for the entire batch to complete before
+ *   scheduling the next set of nodes.
+ * - Agent nodes are stateless by default (snapshot/restore on each execution). Python
+ *   accumulates agent state across executions unless `reset_on_revisit` is enabled.
+ * - Node failures produce a FAILED result, allowing parallel paths to continue.
+ *   Orchestrator-level limits (maxSteps) throw exceptions. Python does the inverse:
+ *   node failures throw exceptions (fail-fast), while limit violations return a
+ *   FAILED result.
+ *
+ * @example
+ * ```typescript
+ * const graph = new Graph({
+ *   nodes: [researcher, writer],
+ *   edges: [['researcher', 'writer']],
+ * })
+ *
+ * const result = await graph.invoke('Explain quantum computing')
+ * ```
+ */
+export class Graph {
+    id;
+    nodes;
+    edges;
+    config;
+    hooks;
+    _sources;
+    _initialized;
+    constructor(options) {
+        const { id, nodes, edges, sources, hooks, ...config } = options;
+        this.id = id ?? 'graph';
+        this.config = {
+            maxConcurrency: config.maxConcurrency ?? Infinity,
+            maxSteps: config.maxSteps ?? Infinity,
+        };
+        this._validateConfig();
+        this.nodes = this._resolveNodes(nodes);
+        this.edges = this._resolveEdges(edges);
+        this._sources = this._resolveSources(sources);
+        this._validateSources();
+        this.hooks = new HookRegistryImplementation();
+        this.hooks.addAllHooks(hooks ?? []);
+        this._initialized = false;
+    }
+    /**
+     * Initialize the graph. Invokes the {@link MultiAgentInitializedEvent} callback.
+     * Called automatically on first invocation.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        await this.hooks.invokeCallbacks(new MultiAgentInitializedEvent({ orchestrator: this }));
+        this._initialized = true;
+    }
+    /**
+     * Invoke graph and return final result (consumes stream).
+     *
+     * @param input - The input to pass to entry point nodes
+     * @returns Promise resolving to the final MultiAgentResult
+     */
+    async invoke(input) {
+        const gen = this.stream(input);
+        let next = await gen.next();
+        while (!next.done) {
+            next = await gen.next();
+        }
+        return next.value;
+    }
+    /**
+     * Stream graph execution, yielding events as nodes execute.
+     * Invokes hook callbacks for each event before yielding.
+     *
+     * @param input - The input to pass to entry nodes
+     * @returns Async generator yielding streaming events and returning a MultiAgentResult
+     */
+    async *stream(input) {
+        await this.initialize();
+        const gen = this._stream(input);
+        try {
+            let next = await gen.next();
+            while (!next.done) {
+                if (next.value instanceof HookableEvent) {
+                    await this.hooks.invokeCallbacks(next.value);
+                }
+                yield next.value;
+                next = await gen.next();
+            }
+            return next.value;
+        }
+        finally {
+            await gen.return(undefined);
+        }
+    }
+    async *_stream(input) {
+        const state = new MultiAgentState({ nodeIds: [...this.nodes.keys()] });
+        const queue = new Queue();
+        const targets = [...this._sources];
+        const streams = new Map();
+        yield new BeforeMultiAgentInvocationEvent({ orchestrator: this, state });
+        try {
+            while (targets.length > 0 || streams.size > 0) {
+                while (targets.length > 0 && streams.size < this.config.maxConcurrency) {
+                    const node = targets.shift();
+                    this._checkSteps(state);
+                    state.steps++;
+                    streams.set(node.id, this._streamNode(node, input, state, queue));
+                }
+                await queue.wait();
+                while (queue.size > 0) {
+                    const { data, ack } = queue.shift();
+                    if (data.type === 'event') {
+                        yield data.event;
+                        ack();
+                        continue;
+                    }
+                    if (data.type === 'error') {
+                        streams.delete(data.node.id);
+                        ack();
+                        throw data.error;
+                    }
+                    const { node, result } = data;
+                    streams.delete(node.id);
+                    ack();
+                    state.results.push(result);
+                    const ready = await this._findReady(node, state, streams, targets);
+                    if (ready.length > 0) {
+                        yield new MultiAgentHandoffEvent({
+                            source: node.id,
+                            targets: ready.map((n) => n.id),
+                        });
+                        targets.push(...ready);
+                    }
+                }
+            }
+        }
+        finally {
+            queue.dispose();
+            await Promise.allSettled(streams.values());
+            yield new AfterMultiAgentInvocationEvent({ orchestrator: this, state });
+        }
+        const result = new MultiAgentResult({
+            results: state.results,
+            content: this._resolveContent(state),
+            duration: Date.now() - state.startTime,
+        });
+        yield new MultiAgentResultEvent({ result });
+        return result;
+    }
+    /**
+     * Executes a single node, pushing streaming events to the shared queue in real-time.
+     */
+    async _streamNode(node, input, state, queue) {
+        const nodeState = state.node(node.id);
+        const beforeEvent = new BeforeNodeCallEvent({ orchestrator: this, state, nodeId: node.id });
+        await queue.send({ type: 'event', node, event: beforeEvent });
+        if (beforeEvent.cancel) {
+            const message = typeof beforeEvent.cancel === 'string' ? beforeEvent.cancel : 'node cancelled by hook';
+            const result = new NodeResult({ nodeId: node.id, status: Status.CANCELLED, duration: 0 });
+            nodeState.status = Status.CANCELLED;
+            nodeState.results.push(result);
+            await queue.send({
+                type: 'event',
+                node,
+                event: new NodeCancelEvent({ nodeId: node.id, message }),
+            });
+            await queue.send({
+                type: 'event',
+                node,
+                event: new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id }),
+            });
+            queue.push({ type: 'result', node, result });
+            return;
+        }
+        try {
+            const nodeInput = this._resolveNodeInput(node, input, state);
+            const gen = node.stream(nodeInput, state);
+            let next = await gen.next();
+            while (!next.done) {
+                await queue.send({ type: 'event', node, event: next.value });
+                next = await gen.next();
+            }
+            queue.push({ type: 'result', node, result: next.value });
+            await queue.send({
+                type: 'event',
+                node,
+                event: new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id }),
+            });
+        }
+        catch (error) {
+            await queue.send({
+                type: 'event',
+                node,
+                event: new AfterNodeCallEvent({
+                    orchestrator: this,
+                    state,
+                    nodeId: node.id,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                }),
+            });
+            queue.push({
+                type: 'error',
+                node,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+        }
+    }
+    _validateConfig() {
+        if (this.config.maxConcurrency < 1) {
+            throw new Error(`max_concurrency=<${this.config.maxConcurrency}> | must be at least 1`);
+        }
+        if (this.config.maxSteps < 1) {
+            throw new Error(`max_steps=<${this.config.maxSteps}> | must be at least 1`);
+        }
+    }
+    _validateSources() {
+        if (this._sources.length === 0) {
+            throw new Error('graph has no source nodes');
+        }
+        const visited = new Set();
+        const adjacency = new Map();
+        for (const edge of this.edges) {
+            const targets = adjacency.get(edge.source.id) ?? [];
+            targets.push(edge.target.id);
+            adjacency.set(edge.source.id, targets);
+        }
+        const queue = this._sources.map((n) => n.id);
+        while (queue.length > 0) {
+            const id = queue.shift();
+            if (visited.has(id))
+                continue;
+            visited.add(id);
+            for (const target of adjacency.get(id) ?? []) {
+                queue.push(target);
+            }
+        }
+        for (const id of this.nodes.keys()) {
+            if (!visited.has(id)) {
+                throw new Error(`node_id=<${id}> | unreachable from any source node`);
+            }
+        }
+    }
+    _resolveNodes(definitions) {
+        const nodes = new Map();
+        for (const definition of definitions) {
+            let node;
+            if (definition instanceof Node) {
+                node = definition;
+            }
+            else if ('type' in definition) {
+                switch (definition.type) {
+                    case 'agent': {
+                        const { type: _, ...options } = definition;
+                        node = new AgentNode(options);
+                        break;
+                    }
+                    case 'multiAgent': {
+                        const { type: _, ...options } = definition;
+                        node = new MultiAgentNode(options);
+                        break;
+                    }
+                    default:
+                        throw new Error('unknown node definition type');
+                }
+            }
+            else if (definition instanceof Agent) {
+                node = new AgentNode({ agent: definition });
+            }
+            else {
+                node = new MultiAgentNode({ orchestrator: definition });
+            }
+            if (nodes.has(node.id)) {
+                throw new Error(`node_id=<${node.id}> | duplicate node id`);
+            }
+            nodes.set(node.id, node);
+        }
+        return nodes;
+    }
+    _resolveEdges(definitions) {
+        const edges = [];
+        for (const definition of definitions) {
+            const [sourceId, targetId, handler] = Array.isArray(definition)
+                ? [definition[0], definition[1], undefined]
+                : [definition.source, definition.target, definition.handler];
+            const source = this.nodes.get(sourceId);
+            const target = this.nodes.get(targetId);
+            if (!source) {
+                throw new Error(`source=<${sourceId}> | edge references unknown source node`);
+            }
+            if (!target) {
+                throw new Error(`target=<${targetId}> | edge references unknown target node`);
+            }
+            edges.push(new Edge({ source, target, ...(handler && { handler }) }));
+        }
+        return edges;
+    }
+    _resolveSources(sourceIds) {
+        if (sourceIds) {
+            const sources = [];
+            for (const id of sourceIds) {
+                const node = this.nodes.get(id);
+                if (!node) {
+                    throw new Error(`source=<${id}> | source references unknown node`);
+                }
+                sources.push(node);
+            }
+            return sources;
+        }
+        const targetIds = new Set(this.edges.map((e) => e.target.id));
+        return [...this.nodes.values()].filter((node) => !targetIds.has(node.id));
+    }
+    /**
+     * Identifies terminus nodes and returns their combined content.
+     * A terminus node is where an execution path ended: completed with no
+     * downstream progress, or failed/cancelled.
+     */
+    _resolveContent(state) {
+        for (const [id, ns] of state.nodes.entries()) {
+            if (ns.status === Status.FAILED || ns.status === Status.CANCELLED) {
+                ns.terminus = true;
+            }
+            else if (ns.status === Status.COMPLETED) {
+                ns.terminus = !this.edges
+                    .filter((e) => e.source.id === id)
+                    .some((e) => state.node(e.target.id)?.status !== Status.PENDING);
+            }
+        }
+        return [...state.nodes.values()].filter((ns) => ns.terminus).flatMap((ns) => ns.content);
+    }
+    /**
+     * Builds the input for a node by combining the original task with dependency outputs.
+     */
+    _resolveNodeInput(node, input, state) {
+        const deps = [];
+        for (const edge of this.edges.filter((e) => e.target.id === node.id)) {
+            const ns = state.node(edge.source.id);
+            if (ns.content.length > 0) {
+                deps.push(new TextBlock(`[node: ${edge.source.id}]`), ...ns.content);
+            }
+        }
+        if (deps.length === 0)
+            return input;
+        const blocks = typeof input === 'string' ? [new TextBlock(input)] : input;
+        return [...blocks, ...deps];
+    }
+    _checkSteps(state) {
+        if (state.steps >= this.config.maxSteps) {
+            throw new Error(`steps=<${state.steps}> | max steps reached`);
+        }
+    }
+    /**
+     * Finds downstream nodes that are ready to execute after a node completes.
+     * A target is ready when all its incoming edge sources are COMPLETED.
+     */
+    async _findReady(node, state, streams, targets) {
+        if (state.node(node.id)?.status !== Status.COMPLETED)
+            return [];
+        const ready = [];
+        for (const edge of this.edges.filter((e) => e.source.id === node.id)) {
+            if (!(await edge.handler(state)))
+                continue;
+            if (streams.has(edge.target.id) || targets.some((n) => n.id === edge.target.id))
+                continue;
+            const deps = this.edges.filter((e) => e.target.id === edge.target.id);
+            if (deps.every((e) => state.node(e.source.id)?.status === Status.COMPLETED)) {
+                ready.push(edge.target);
+            }
+        }
+        return ready;
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/src/multiagent/graph.js.map

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

package/dist/src/multiagent/index.d.ts

@@ -1,11 +1,17 @@
 /**
  * Multi-agent orchestration module.
  */
-export { MultiAgentState, Status, NodeResult } from './state.js';
-export type { NodeResultUpdate } from './state.js';
-export { Node, AgentNode } from './nodes.js';
-export type { NodeConfig } from './nodes.js';
-export { NodeStreamUpdateEvent } from './events.js';
+export { MultiAgentState, NodeState, Status, NodeResult, MultiAgentResult } from './state.js';
+export type { NodeResultUpdate, ResultStatus } from './state.js';
+export { Node, AgentNode, MultiAgentNode } from './nodes.js';
+export type { NodeConfig, AgentNodeOptions, MultiAgentNodeOptions, NodeDefinition, NodeType } from './nodes.js';
+export type { MultiAgentBase } from './base.js';
+export { MultiAgentInitializedEvent, BeforeMultiAgentInvocationEvent, AfterMultiAgentInvocationEvent, BeforeNodeCallEvent, AfterNodeCallEvent, NodeStreamUpdateEvent, NodeResultEvent, NodeCancelEvent, MultiAgentHandoffEvent, MultiAgentResultEvent, } from './events.js';
 export type { MultiAgentStreamEvent } from './events.js';
-export type { NodeType } from './types.js';
+export { Edge } from './edge.js';
+export type { EdgeHandler, EdgeDefinition } from './edge.js';
+export { Graph } from './graph.js';
+export type { GraphConfig, GraphOptions } from './graph.js';
+export { Swarm } from './swarm.js';
+export type { SwarmConfig, SwarmNodeDefinition, SwarmOptions } from './swarm.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/multiagent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/multiagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/multiagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7F,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/G,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,EAC9B,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/multiagent/index.js

@@ -1,7 +1,10 @@
 /**
  * Multi-agent orchestration module.
  */
-export { MultiAgentState, Status, NodeResult } from './state.js';
-export { Node, AgentNode } from './nodes.js';
-export { NodeStreamUpdateEvent } from './events.js';
+export { MultiAgentState, NodeState, Status, NodeResult, MultiAgentResult } from './state.js';
+export { Node, AgentNode, MultiAgentNode } from './nodes.js';
+export { MultiAgentInitializedEvent, BeforeMultiAgentInvocationEvent, AfterMultiAgentInvocationEvent, BeforeNodeCallEvent, AfterNodeCallEvent, NodeStreamUpdateEvent, NodeResultEvent, NodeCancelEvent, MultiAgentHandoffEvent, MultiAgentResultEvent, } from './events.js';
+export { Edge } from './edge.js';
+export { Graph } from './graph.js';
+export { Swarm } from './swarm.js';
 //# sourceMappingURL=index.js.map

package/dist/src/multiagent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/multiagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGhE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAG5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/multiagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG7F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAK5D,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,EAC9B,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGlC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/multiagent/nodes.d.ts

@@ -1,15 +1,20 @@
 import type { Agent, InvokeArgs } from '../agent/agent.js';
 import type { MultiAgentStreamEvent } from './events.js';
-import { MultiAgentState, NodeResult } from './state.js';
-import type { NodeResultUpdate } from './state.js';
+import { NodeResult } from './state.js';
+import type { MultiAgentState, NodeResultUpdate } from './state.js';
+import type { MultiAgentBase } from './base.js';
+/**
+ * Known node type identifiers with extensibility for custom nodes.
+ */
+export type NodeType = 'agentNode' | 'multiAgentNode' | (string & {});
 /**
  * Configuration for a node execution.
  */
 export interface NodeConfig {
     /**
-     * Maximum execution time for this node in milliseconds.
+     * Optional description of what this node does.
      */
-    timeout?: number;
+    description?: string;
 }
 /**
  * Abstract base class for all multi-agent orchestration nodes.
@@ -19,15 +24,16 @@ export interface NodeConfig {
  * delegates to {@link handle} for node-specific execution logic.
  */
 export declare abstract class Node {
+    readonly type: string;
     /** Unique identifier for this node within the orchestration. */
     readonly id: string;
-    /** Optional per-node configuration. */
-    readonly config?: NodeConfig;
+    /** Per-node configuration. */
+    readonly config: NodeConfig;
     /**
      * @param id - Unique identifier for this node within the orchestration
-     * @param config - Optional per-node configuration
+     * @param config - Per-node configuration
      */
-    constructor(id: string, config?: NodeConfig);
+    constructor(id: string, config: NodeConfig);
     /**
      * Execute the node. Handles duration measurement, error capture,
      * and delegates to handle() for node-specific logic.
@@ -46,6 +52,13 @@ export declare abstract class Node {
      */
     abstract handle(args: InvokeArgs, state: MultiAgentState): AsyncGenerator<MultiAgentStreamEvent, NodeResultUpdate, undefined>;
 }
+/**
+ * Options for creating an {@link AgentNode}.
+ */
+export interface AgentNodeOptions {
+    /** The agent to wrap as a node. */
+    agent: Agent;
+}
 /**
  * Node that wraps an Agent instance for multi-agent orchestration.
  *
@@ -55,21 +68,58 @@ export declare abstract class Node {
 export declare class AgentNode extends Node {
     readonly type: "agentNode";
     private readonly _agent;
-    /**
-     * @param id - Unique identifier for this node within the orchestration
-     * @param agent - The Agent instance to wrap
-     * @param config - Optional per-node configuration
-     */
-    constructor(id: string, agent: Agent, config?: NodeConfig);
+    constructor(options: AgentNodeOptions);
     get agent(): Agent;
     /**
      * Executes the wrapped agent, yielding each agent streaming event
-     * wrapped in a {@link MultiAgentNodeStreamEvent}.
+     * wrapped in a {@link NodeStreamUpdateEvent}.
      *
      * @param args - Input to pass to the agent
-     * @param state - The current multi-agent state (unused by AgentNode)
+     * @param state - The current multi-agent state
      * @returns Async generator yielding streaming events and returning the agent's content blocks
      */
+    handle(args: InvokeArgs, state: MultiAgentState): AsyncGenerator<MultiAgentStreamEvent, NodeResultUpdate, undefined>;
+}
+/**
+ * Options for creating a {@link MultiAgentNode}.
+ */
+export interface MultiAgentNodeOptions extends NodeConfig {
+    /** The orchestrator to wrap as a node. */
+    orchestrator: MultiAgentBase;
+}
+/**
+ * Node that wraps a multi-agent orchestrator (e.g. Graph) for nested composition.
+ *
+ * Inner {@link NodeStreamUpdateEvent}s pass through to preserve the original
+ * node's identity. All other events are wrapped in a new {@link NodeStreamUpdateEvent}
+ * tagged with this node's identity.
+ */
+export declare class MultiAgentNode extends Node {
+    readonly type: "multiAgentNode";
+    private readonly _orchestrator;
+    constructor(options: MultiAgentNodeOptions);
+    get orchestrator(): MultiAgentBase;
+    /**
+     * Executes the wrapped orchestrator. Inner {@link NodeStreamUpdateEvent}s
+     * pass through as-is; all other events are wrapped in a new
+     * {@link NodeStreamUpdateEvent} tagged with this node's identity.
+     *
+     * @param args - Input to pass to the orchestrator
+     * @param _state - The current multi-agent state (unused)
+     * @returns Async generator yielding streaming events and returning the orchestrator's content
+     */
     handle(args: InvokeArgs, _state: MultiAgentState): AsyncGenerator<MultiAgentStreamEvent, NodeResultUpdate, undefined>;
 }
+/**
+ * A node definition accepted by orchestration constructors.
+ *
+ * Pass an {@link Agent} or {@link MultiAgentBase} directly for the simple case,
+ * use typed options objects for per-node configuration, or provide pre-built
+ * {@link Node} instances for full control.
+ */
+export type NodeDefinition = Agent | MultiAgentBase | Node | (AgentNodeOptions & {
+    type: 'agent';
+}) | (MultiAgentNodeOptions & {
+    type: 'multiAgent';
+});
 //# sourceMappingURL=nodes.d.ts.map

package/dist/src/multiagent/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/multiagent/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAU,MAAM,YAAY,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,8BAAsB,IAAI;IACxB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAA;IAE5B;;;OAGG;gBACS,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU;IAK3C;;;;;;;OAOG;IACI,MAAM,CACX,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,cAAc,CAAC,qBAAqB,EAAE,UAAU,EAAE,SAAS,CAAC;IAsB/D;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CACb,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;CACtE;AAED;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,IAAI;IACjC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAO;IAE9B;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,UAAU;IAKzD,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED;;;;;;;OAOG;IACI,MAAM,CACX,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,eAAe,GACtB,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;CActE"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/multiagent/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAA;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAE,UAAU,EAAU,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAG/C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;GAMG;AACH,8BAAsB,IAAI;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAS;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAE3B;;;OAGG;gBACS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;IAK1C;;;;;;;OAOG;IACI,MAAM,CACX,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,cAAc,CAAC,qBAAqB,EAAE,UAAU,EAAE,SAAS,CAAC;IAgC/D;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CACb,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAA;CACb;AAED;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,IAAI;IACjC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAO;gBAElB,OAAO,EAAE,gBAAgB;IAWrC,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED;;;;;;;OAOG;IACI,MAAM,CACX,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;CAsBtE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,0CAA0C;IAC1C,YAAY,EAAE,cAAc,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,OAAO,EAAE,qBAAqB;IAM1C,IAAI,YAAY,IAAI,cAAc,CAEjC;IAED;;;;;;;;OAQG;IACI,MAAM,CACX,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,eAAe,GACtB,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;CActE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,cAAc,GACd,IAAI,GACJ,CAAC,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GACtC,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAA"}