@strands-agents/sdk 0.4.0 → 0.6.0

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

@@ -1,12 +1,87 @@
-import { StreamEvent } from '../hooks/events.js';
+import { HookableEvent } from '../hooks/events.js';
 import type { AgentStreamEvent } from '../types/agent.js';
-import type { NodeType } from './types.js';
+import type { MultiAgentResult, MultiAgentState, NodeResult } from './state.js';
+import type { MultiAgentBase } from './base.js';
+import type { NodeType } from './nodes.js';
+/**
+ * Event triggered when a multi-agent orchestrator has finished initialization.
+ */
+export declare class MultiAgentInitializedEvent extends HookableEvent {
+    readonly type: "multiAgentInitializedEvent";
+    readonly orchestrator: MultiAgentBase;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+    });
+}
+/**
+ * Event triggered before orchestrator execution starts.
+ */
+export declare class BeforeMultiAgentInvocationEvent extends HookableEvent {
+    readonly type: "beforeMultiAgentInvocationEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+    });
+}
+/**
+ * Event triggered after orchestrator execution completes.
+ */
+export declare class AfterMultiAgentInvocationEvent extends HookableEvent {
+    readonly type: "afterMultiAgentInvocationEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered before a node begins execution.
+ * Hook callbacks can set {@link cancel} to prevent the node from executing.
+ */
+export declare class BeforeNodeCallEvent extends HookableEvent {
+    readonly type: "beforeNodeCallEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    readonly nodeId: string;
+    /**
+     * Set by hook callbacks to cancel node execution.
+     * When set to `true`, a default cancel message is used.
+     * When set to a string, that string is used as the cancel message.
+     */
+    cancel: boolean | string;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+        nodeId: string;
+    });
+}
+/**
+ * Event triggered after a node completes execution.
+ */
+export declare class AfterNodeCallEvent extends HookableEvent {
+    readonly type: "afterNodeCallEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    readonly nodeId: string;
+    readonly error?: Error;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+        nodeId: string;
+        error?: Error;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
 /**
  * Wraps an inner streaming event from a node with the node's identity.
  * Emitted during node execution to propagate agent-level or nested
  * multi-agent events up to the orchestration layer.
  */
-export declare class NodeStreamUpdateEvent extends StreamEvent {
+export declare class NodeStreamUpdateEvent extends HookableEvent {
     readonly type: "nodeStreamUpdateEvent";
     readonly nodeId: string;
     readonly nodeType: NodeType;
@@ -17,8 +92,58 @@ export declare class NodeStreamUpdateEvent extends StreamEvent {
         event: AgentStreamEvent | Exclude<MultiAgentStreamEvent, NodeStreamUpdateEvent>;
     });
 }
+/**
+ * Event triggered when a node finishes execution.
+ * Wraps the {@link NodeResult} for the completed node.
+ */
+export declare class NodeResultEvent extends HookableEvent {
+    readonly type: "nodeResultEvent";
+    readonly nodeId: string;
+    readonly nodeType: NodeType;
+    readonly result: NodeResult;
+    constructor(data: {
+        nodeId: string;
+        nodeType: NodeType;
+        result: NodeResult;
+    });
+}
+/**
+ * Event triggered when execution transitions between nodes.
+ */
+export declare class MultiAgentHandoffEvent extends HookableEvent {
+    readonly type: "multiAgentHandoffEvent";
+    readonly source: string;
+    readonly targets: string[];
+    constructor(data: {
+        source: string;
+        targets: string[];
+    });
+}
+/**
+ * Event triggered when a node is cancelled via {@link BeforeNodeCallEvent.cancel}.
+ */
+export declare class NodeCancelEvent extends HookableEvent {
+    readonly type: "nodeCancelEvent";
+    readonly nodeId: string;
+    readonly message: string;
+    constructor(data: {
+        nodeId: string;
+        message: string;
+    });
+}
+/**
+ * Event triggered as the final event in the multi-agent stream.
+ * Wraps the {@link MultiAgentResult} containing the aggregate outcome.
+ */
+export declare class MultiAgentResultEvent extends HookableEvent {
+    readonly type: "multiAgentResultEvent";
+    readonly result: MultiAgentResult;
+    constructor(data: {
+        result: MultiAgentResult;
+    });
+}
 /**
  * Union of all multi-agent streaming events.
  */
-export type MultiAgentStreamEvent = NodeStreamUpdateEvent;
+export type MultiAgentStreamEvent = BeforeMultiAgentInvocationEvent | AfterMultiAgentInvocationEvent | BeforeNodeCallEvent | AfterNodeCallEvent | NodeStreamUpdateEvent | NodeResultEvent | NodeCancelEvent | MultiAgentHandoffEvent | MultiAgentResultEvent;
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/multiagent/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAS;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;gBAE5E,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,QAAQ,CAAA;QAClB,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;KAChF;CAMF;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/multiagent/events.ts"],"names":[],"mappings":"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"}

package/dist/src/multiagent/events.js

@@ -1,10 +1,94 @@
-import { StreamEvent } from '../hooks/events.js';
+import { HookableEvent } from '../hooks/events.js';
+/**
+ * Event triggered when a multi-agent orchestrator has finished initialization.
+ */
+export class MultiAgentInitializedEvent extends HookableEvent {
+    type = 'multiAgentInitializedEvent';
+    orchestrator;
+    constructor(data) {
+        super();
+        this.orchestrator = data.orchestrator;
+    }
+}
+/**
+ * Event triggered before orchestrator execution starts.
+ */
+export class BeforeMultiAgentInvocationEvent extends HookableEvent {
+    type = 'beforeMultiAgentInvocationEvent';
+    orchestrator;
+    state;
+    constructor(data) {
+        super();
+        this.orchestrator = data.orchestrator;
+        this.state = data.state;
+    }
+}
+/**
+ * Event triggered after orchestrator execution completes.
+ */
+export class AfterMultiAgentInvocationEvent extends HookableEvent {
+    type = 'afterMultiAgentInvocationEvent';
+    orchestrator;
+    state;
+    constructor(data) {
+        super();
+        this.orchestrator = data.orchestrator;
+        this.state = data.state;
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
+/**
+ * Event triggered before a node begins execution.
+ * Hook callbacks can set {@link cancel} to prevent the node from executing.
+ */
+export class BeforeNodeCallEvent extends HookableEvent {
+    type = 'beforeNodeCallEvent';
+    orchestrator;
+    state;
+    nodeId;
+    /**
+     * Set by hook callbacks to cancel node execution.
+     * When set to `true`, a default cancel message is used.
+     * When set to a string, that string is used as the cancel message.
+     */
+    cancel = false;
+    constructor(data) {
+        super();
+        this.orchestrator = data.orchestrator;
+        this.state = data.state;
+        this.nodeId = data.nodeId;
+    }
+}
+/**
+ * Event triggered after a node completes execution.
+ */
+export class AfterNodeCallEvent extends HookableEvent {
+    type = 'afterNodeCallEvent';
+    orchestrator;
+    state;
+    nodeId;
+    error;
+    constructor(data) {
+        super();
+        this.orchestrator = data.orchestrator;
+        this.state = data.state;
+        this.nodeId = data.nodeId;
+        if (data.error !== undefined) {
+            this.error = data.error;
+        }
+    }
+    _shouldReverseCallbacks() {
+        return true;
+    }
+}
 /**
  * Wraps an inner streaming event from a node with the node's identity.
  * Emitted during node execution to propagate agent-level or nested
  * multi-agent events up to the orchestration layer.
  */
-export class NodeStreamUpdateEvent extends StreamEvent {
+export class NodeStreamUpdateEvent extends HookableEvent {
     type = 'nodeStreamUpdateEvent';
     nodeId;
     nodeType;
@@ -16,4 +100,58 @@ export class NodeStreamUpdateEvent extends StreamEvent {
         this.event = data.event;
     }
 }
+/**
+ * Event triggered when a node finishes execution.
+ * Wraps the {@link NodeResult} for the completed node.
+ */
+export class NodeResultEvent extends HookableEvent {
+    type = 'nodeResultEvent';
+    nodeId;
+    nodeType;
+    result;
+    constructor(data) {
+        super();
+        this.nodeId = data.nodeId;
+        this.nodeType = data.nodeType;
+        this.result = data.result;
+    }
+}
+/**
+ * Event triggered when execution transitions between nodes.
+ */
+export class MultiAgentHandoffEvent extends HookableEvent {
+    type = 'multiAgentHandoffEvent';
+    source;
+    targets;
+    constructor(data) {
+        super();
+        this.source = data.source;
+        this.targets = data.targets;
+    }
+}
+/**
+ * Event triggered when a node is cancelled via {@link BeforeNodeCallEvent.cancel}.
+ */
+export class NodeCancelEvent extends HookableEvent {
+    type = 'nodeCancelEvent';
+    nodeId;
+    message;
+    constructor(data) {
+        super();
+        this.nodeId = data.nodeId;
+        this.message = data.message;
+    }
+}
+/**
+ * Event triggered as the final event in the multi-agent stream.
+ * Wraps the {@link MultiAgentResult} containing the aggregate outcome.
+ */
+export class MultiAgentResultEvent extends HookableEvent {
+    type = 'multiAgentResultEvent';
+    result;
+    constructor(data) {
+        super();
+        this.result = data.result;
+    }
+}
 //# sourceMappingURL=events.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/multiagent/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IAC3C,IAAI,GAAG,uBAAgC,CAAA;IACvC,MAAM,CAAQ;IACd,QAAQ,CAAU;IAClB,KAAK,CAA0E;IAExF,YAAY,IAIX;QACC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACzB,CAAC;CACF"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/multiagent/events.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,125 @@
+import type { InvokeArgs } from '../agent/agent.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+import type { HookProvider } from '../hooks/types.js';
+import type { NodeDefinition } from './nodes.js';
+import { Node } from './nodes.js';
+import { MultiAgentResult } from './state.js';
+import type { MultiAgentBase } from './base.js';
+import type { MultiAgentStreamEvent } from './events.js';
+import type { EdgeDefinition } from './edge.js';
+import { Edge } from './edge.js';
+/**
+ * Runtime configuration for graph execution.
+ */
+export interface GraphConfig {
+    /** Max nodes executing in parallel. */
+    maxConcurrency?: number;
+    /** Max total steps (prevents infinite loops in cyclic graphs). */
+    maxSteps?: number;
+}
+/**
+ * Options for creating a Graph instance.
+ */
+export interface GraphOptions extends GraphConfig {
+    /** Unique identifier for this graph. Defaults to `'graph'`. */
+    id?: string;
+    /** Node definitions to construct the graph from. */
+    nodes: NodeDefinition[];
+    /** Edge definitions describing connections between nodes. */
+    edges: EdgeDefinition[];
+    /** Explicit source node IDs. If omitted, auto-detected from nodes with no incoming edges. */
+    sources?: string[];
+    /** Hook providers for event-driven extensibility. */
+    hooks?: HookProvider[];
+}
+/**
+ * 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 declare class Graph implements MultiAgentBase {
+    readonly id: string;
+    readonly nodes: ReadonlyMap<string, Node>;
+    readonly edges: readonly Edge[];
+    readonly config: Required<GraphConfig>;
+    readonly hooks: HookRegistryImplementation;
+    private readonly _sources;
+    private _initialized;
+    constructor(options: GraphOptions);
+    /**
+     * Initialize the graph. Invokes the {@link MultiAgentInitializedEvent} callback.
+     * Called automatically on first invocation.
+     */
+    initialize(): Promise<void>;
+    /**
+     * 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
+     */
+    invoke(input: InvokeArgs): Promise<MultiAgentResult>;
+    /**
+     * 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
+     */
+    stream(input: InvokeArgs): AsyncGenerator<MultiAgentStreamEvent, MultiAgentResult, undefined>;
+    private _stream;
+    /**
+     * Executes a single node, pushing streaming events to the shared queue in real-time.
+     */
+    private _streamNode;
+    private _validateConfig;
+    private _validateSources;
+    private _resolveNodes;
+    private _resolveEdges;
+    private _resolveSources;
+    /**
+     * 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.
+     */
+    private _resolveContent;
+    /**
+     * Builds the input for a node by combining the original task with dependency outputs.
+     */
+    private _resolveNodeInput;
+    private _checkSteps;
+    /**
+     * Finds downstream nodes that are ready to execute after a node completes.
+     * A target is ready when all its incoming edge sources are COMPLETED.
+     */
+    private _findReady;
+}
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/multiagent/graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAInD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAA6B,IAAI,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAmB,gBAAgB,EAAsB,MAAM,YAAY,CAAA;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAWxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,6DAA6D;IAC7D,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,KAAM,YAAW,cAAc;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,YAAY;IAqBjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS1D;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC;YAmBrF,OAAO;IAmEtB;;OAEG;YACW,WAAW;IA6DzB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,aAAa;IAsCrB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,eAAe;IAiBvB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,WAAW;IAMnB;;;OAGG;YACW,UAAU;CAuBzB"}