@strands-agents/sdk 1.0.0 → 1.2.0

package/dist/src/multiagent/state.js

@@ -2,6 +2,7 @@ import { StateStore } from '../state-store.js';
 import { contentBlockFromData } from '../types/messages.js';
 import { accumulateUsage, createEmptyUsage } from '../models/streaming.js';
 import { normalizeError, serializeError } from '../errors.js';
+import { Interrupt } from '../interrupt.js';
 import { loadStateFromJSONSymbol, stateToJSONSymbol, serializeStateSerializable, loadStateSerializable, } from '../types/serializable.js';
 /**
  * Execution lifecycle status shared across all multi-agent patterns.
@@ -17,6 +18,8 @@ export const Status = {
     FAILED: 'FAILED',
     /** Execution was cancelled before or during processing. */
     CANCELLED: 'CANCELLED',
+    /** Execution paused awaiting an interrupt response; can be resumed. */
+    INTERRUPTED: 'INTERRUPTED',
 };
 /**
  * Result of executing a single node.
@@ -33,6 +36,8 @@ export class NodeResult {
     structuredOutput;
     /** Token usage from the node execution. */
     usage;
+    /** Interrupts raised by the underlying agent/orchestrator. Present iff `status === 'INTERRUPTED'`. */
+    interrupts;
     constructor(data) {
         this.nodeId = data.nodeId;
         this.status = data.status;
@@ -44,6 +49,8 @@ export class NodeResult {
             this.structuredOutput = data.structuredOutput;
         if ('usage' in data)
             this.usage = data.usage;
+        if (data.interrupts && data.interrupts.length > 0)
+            this.interrupts = data.interrupts;
     }
     /** Serializes this result to a JSON-compatible value. */
     toJSON() {
@@ -56,6 +63,7 @@ export class NodeResult {
             ...(this.error && { error: serializeError(this.error) }),
             ...(this.structuredOutput !== undefined && { structuredOutput: this.structuredOutput }),
             ...(this.usage && { usage: { ...this.usage } }),
+            ...(this.interrupts && { interrupts: this.interrupts.map((i) => i.toJSON()) }),
         };
     }
     /** Creates a NodeResult from a previously serialized JSON value. */
@@ -69,6 +77,9 @@ export class NodeResult {
             ...(json.error && { error: normalizeError(json.error) }),
             ...(json.structuredOutput !== undefined && { structuredOutput: json.structuredOutput }),
             ...(json.usage && { usage: json.usage }),
+            ...(json.interrupts && {
+                interrupts: json.interrupts.map((i) => Interrupt.fromJSON(i)),
+            }),
         });
     }
 }
@@ -83,11 +94,21 @@ export class NodeState {
     /** Node execution start time in milliseconds since epoch. */
     startTime;
     results;
+    /** Unanswered interrupts raised during this node's most recent run. Populated when `status === 'INTERRUPTED'`. */
+    interrupts;
+    /**
+     * Snapshot of the node's underlying runnable (Agent or nested orchestrator) captured
+     * when the node returned INTERRUPTED. Loaded back into the runnable on resume so it
+     * can pick up mid-execution without losing its interrupt bookkeeping. Cleared when
+     * the node completes.
+     */
+    interruptedSnapshot;
     constructor() {
         this.status = Status.PENDING;
         this.terminus = false;
         this.startTime = Date.now();
         this.results = [];
+        this.interrupts = [];
     }
     /** Content from the most recent result, or empty array if none. */
     get content() {
@@ -101,6 +122,8 @@ export class NodeState {
             terminus: this.terminus,
             startTime: this.startTime,
             results: this.results.map((res) => res.toJSON()),
+            interrupts: this.interrupts.map((i) => i.toJSON()),
+            ...(this.interruptedSnapshot && { interruptedSnapshot: { ...this.interruptedSnapshot } }),
         };
     }
     /** Loads state from a previously serialized JSON value. */
@@ -113,6 +136,13 @@ export class NodeState {
         for (const entry of data.results) {
             this.results.push(NodeResult.fromJSON(entry));
         }
+        this.interrupts = (data.interrupts ?? []).map((i) => Interrupt.fromJSON(i));
+        if (data.interruptedSnapshot) {
+            this.interruptedSnapshot = data.interruptedSnapshot;
+        }
+        else {
+            delete this.interruptedSnapshot;
+        }
     }
 }
 /**
@@ -128,6 +158,8 @@ export class MultiAgentResult {
     error;
     /** Aggregated token usage across all node results. */
     usage;
+    /** Interrupts aggregated across all node results. Present when any node ended INTERRUPTED. */
+    interrupts;
     constructor(data) {
         this.status = data.status ?? this._resolveStatus(data.results);
         this.results = data.results;
@@ -136,6 +168,9 @@ export class MultiAgentResult {
         if ('error' in data)
             this.error = data.error;
         this.usage = this._aggregateNodeUsage(data.results);
+        const interrupts = data.interrupts ?? data.results.flatMap((r) => r.interrupts ?? []);
+        if (interrupts.length > 0)
+            this.interrupts = interrupts;
     }
     /** Serializes this result to a JSON-compatible value. */
     toJSON() {
@@ -147,6 +182,7 @@ export class MultiAgentResult {
             duration: this.duration,
             usage: { ...this.usage },
             ...(this.error && { error: serializeError(this.error) }),
+            ...(this.interrupts && { interrupts: this.interrupts.map((i) => i.toJSON()) }),
         };
     }
     /** Creates a MultiAgentResult from a previously serialized JSON value. */
@@ -158,12 +194,24 @@ export class MultiAgentResult {
             content: json.content.map((c) => contentBlockFromData(c)),
             duration: json.duration,
             ...(json.error && { error: normalizeError(json.error) }),
+            ...(json.interrupts && {
+                interrupts: json.interrupts.map((i) => Interrupt.fromJSON(i)),
+            }),
         });
     }
-    /** Derives the aggregate status from individual node results. */
+    /**
+     * Derives the aggregate status from individual node results.
+     *
+     * Precedence: FAILED \> INTERRUPTED \> CANCELLED \> COMPLETED. INTERRUPTED outranks
+     * CANCELLED because parallel-graph short-circuit aborts siblings as CANCELLED when
+     * one node interrupts — the actionable "resume me" signal should surface over the
+     * collateral cancellations.
+     */
     _resolveStatus(results) {
         if (results.some((result) => result.status === Status.FAILED))
             return Status.FAILED;
+        if (results.some((result) => result.status === Status.INTERRUPTED))
+            return Status.INTERRUPTED;
         if (results.some((result) => result.status === Status.CANCELLED))
             return Status.CANCELLED;
         return Status.COMPLETED;
@@ -179,6 +227,21 @@ export class MultiAgentResult {
         return usage;
     }
 }
+/**
+ * Rehydrates a serialized `_pendingInput` back to its runtime shape. `string` round-trips
+ * as-is; array inputs (which serialize as `ContentBlockData[]` via each block's `toJSON`)
+ * are mapped through `contentBlockFromData` so downstream callers see `ContentBlock[]`
+ * instead of raw data objects.
+ */
+function rehydratePendingInput(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((entry) => contentBlockFromData(entry));
+    }
+    // Unexpected shape — pass through so callers see the exact value and can diagnose.
+    return value;
+}
 /**
  * Per-execution state for multi-agent orchestration, created fresh each invocation.
  */
@@ -191,6 +254,15 @@ export class MultiAgentState {
     results;
     /** App-level key-value state accessible from hooks, edge handlers, and custom nodes. */
     app;
+    /**
+     * The invocation's input, carried through an interrupt pause so that resuming a
+     * run (on the same instance, or via a SessionManager) can re-enter nodes that
+     * never ran (hook-gated source/start nodes) with the original content. Cleared
+     * when the invocation terminates in any non-INTERRUPTED state.
+     *
+     * @internal — not part of the public state shape; orchestrator-owned.
+     */
+    _pendingInput;
     _nodes;
     constructor(data) {
         this.startTime = Date.now();
@@ -229,6 +301,7 @@ export class MultiAgentState {
             results: this.results.map((result) => result.toJSON()),
             app: serializeStateSerializable(this.app),
             nodes,
+            ...(this._pendingInput !== undefined && { _pendingInput: this._pendingInput }),
         };
     }
     /** Loads state from a previously serialized JSON value. */
@@ -250,6 +323,12 @@ export class MultiAgentState {
                 this._nodes.set(id, nodeState);
             }
         }
+        if (data._pendingInput !== undefined) {
+            this._pendingInput = rehydratePendingInput(data._pendingInput);
+        }
+        else {
+            delete this._pendingInput;
+        }
     }
 }
 //# sourceMappingURL=state.js.map

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

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

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

@@ -14,8 +14,22 @@ import type { MultiAgentStreamEvent } from './events.js';
  * Runtime configuration for swarm execution.
  */
 export interface SwarmConfig {
-    /** Max total agent executions (including start). Defaults to Infinity. */
+    /** Max total agent executions (including start). Defaults to `Infinity` (no limit). */
     maxSteps?: number;
+    /**
+     * Wall-clock ceiling for the entire swarm invocation, in milliseconds. Defaults to `Infinity`
+     * (no limit). Composed with each node's cancel signal, so a node that exceeds this bound
+     * mid-execution will be aborted (cooperatively).
+     */
+    timeout?: number;
+    /**
+     * Fallback per-node wall-clock ceiling in milliseconds. Applied to any node that doesn't
+     * set its own `timeout`. Defaults to `Infinity` (no limit).
+     *
+     * Enforced via `AbortSignal` — cancellation is cooperative, so a tool that neither polls
+     * its cancel signal nor forwards it to a cancellable API can run past this deadline.
+     */
+    nodeTimeout?: number;
 }
 /**
  * Input type for swarm nodes. Pass an {@link InvokableAgent} directly for the simple case,
@@ -74,6 +88,13 @@ export declare class Swarm implements MultiAgent {
     readonly start: AgentNode;
     readonly sessionManager?: SessionManager | undefined;
     private _initialized;
+    /**
+     * State retained across invocations when a run ends INTERRUPTED. Lets
+     * `swarm.invoke(responses)` resume on the same instance without requiring a
+     * SessionManager, mirroring single-agent ergonomics. Cleared when a run
+     * terminates in any non-INTERRUPTED state.
+     */
+    private _pendingInterruptState?;
     constructor(options: SwarmOptions);
     /**
      * Initialize the swarm. Invokes the {@link MultiAgentInitializedEvent} callback.
@@ -106,11 +127,19 @@ export declare class Swarm implements MultiAgent {
      */
     stream(input: MultiAgentInput, options?: MultiAgentInvokeOptions): AsyncGenerator<MultiAgentStreamEvent, MultiAgentResult, undefined>;
     private _stream;
+    /** Invokes hook callbacks on an event, then yields it. */
+    private _emit;
     private _streamNode;
     private _validateConfig;
     private _resolveNodes;
     private _resolveStart;
     private _resolveContent;
+    /**
+     * Builds the input for the next node after a handoff, or returns the input as-is
+     * when there is no handoff (initial or resume invocation). The caller passes the
+     * original `MultiAgentInput` through; resume responses flow through here untouched
+     * so the underlying agent sees them directly.
+     */
     private _resolveNodeInput;
     /**
      * Checks whether the swarm has exceeded its step limit with work still pending.

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

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

package/dist/src/multiagent/swarm.js

@@ -1,4 +1,7 @@
 import { logger } from '../logging/logger.js';
+import { warnOnce } from '../logging/warn-once.js';
+import { applyOrchestratorHookResponses, dropStaleInterruptedResult, extractResumeResponses, groupInterruptResponsesByNode, recordHookInterrupt, } from './multiagent.js';
+import { InterruptError } from '../interrupt.js';
 import { z } from 'zod';
 import { HookableEvent } from '../hooks/events.js';
 import { HookRegistryImplementation } from '../hooks/registry.js';
@@ -6,7 +9,7 @@ import { MultiAgentPluginRegistry } from './plugins.js';
 import { TextBlock } from '../types/messages.js';
 import { AgentNode } from './nodes.js';
 import { MultiAgentState, MultiAgentResult, NodeResult, Status } from './state.js';
-import { AfterMultiAgentInvocationEvent, AfterNodeCallEvent, BeforeMultiAgentInvocationEvent, BeforeNodeCallEvent, MultiAgentHandoffEvent, MultiAgentInitializedEvent, MultiAgentResultEvent, NodeCancelEvent, } from './events.js';
+import { AfterMultiAgentInvocationEvent, AfterNodeCallEvent, BeforeMultiAgentInvocationEvent, BeforeNodeCallEvent, MultiAgentHandoffEvent, MultiAgentInitializedEvent, MultiAgentResultEvent, NodeCancelEvent, NodeResultEvent, } from './events.js';
 import { Tracer } from '../telemetry/tracer.js';
 import { normalizeError } from '../errors.js';
 /**
@@ -47,13 +50,25 @@ export class Swarm {
     start;
     sessionManager;
     _initialized;
+    /**
+     * State retained across invocations when a run ends INTERRUPTED. Lets
+     * `swarm.invoke(responses)` resume on the same instance without requiring a
+     * SessionManager, mirroring single-agent ergonomics. Cleared when a run
+     * terminates in any non-INTERRUPTED state.
+     */
+    _pendingInterruptState;
     constructor(options) {
         const { id, nodes, start, sessionManager, plugins, traceAttributes, ...config } = options;
         this.id = id ?? 'swarm';
         this.config = {
             maxSteps: config.maxSteps ?? Infinity,
+            timeout: config.timeout ?? Infinity,
+            nodeTimeout: config.nodeTimeout ?? Infinity,
         };
         this._validateConfig();
+        if (this.config.maxSteps === Infinity && this.config.timeout === Infinity) {
+            warnOnce(logger, 'swarm has no maxSteps or timeout set; execution is unbounded');
+        }
         this.nodes = this._resolveNodes(nodes);
         this.start = this._resolveStart(start);
         this.sessionManager = sessionManager;
@@ -117,47 +132,106 @@ export class Swarm {
         // Shared by reference across every node so mutations in one node's agent
         // are visible to the next.
         const invocationState = options?.invocationState ?? {};
-        const gen = this._stream(input, invocationState);
+        // Hook invocation lives in `_stream` so hook-raised `InterruptError`s land in the
+        // same frame as the execution loop.
+        const gen = this._stream(input, invocationState, options?.cancelSignal);
         let next = await gen.next();
         while (!next.done) {
-            if (next.value instanceof HookableEvent) {
-                await this._hookRegistry.invokeCallbacks(next.value);
-            }
             yield next.value;
             next = await gen.next();
         }
         return next.value;
     }
-    async *_stream(input, invocationState) {
-        const state = new MultiAgentState({
-            nodeIds: [...this.nodes.keys()],
-        });
+    async *_stream(input, invocationState, externalCancelSignal) {
+        // Reuse state from a prior INTERRUPTED run so `swarm.invoke(responses)` can
+        // resume on the same instance without a SessionManager.
+        const state = this._pendingInterruptState ??
+            new MultiAgentState({
+                nodeIds: [...this.nodes.keys()],
+            });
+        delete this._pendingInterruptState;
         const multiAgentSpan = this._tracer.startMultiAgentSpan({
             orchestratorId: this.id,
             orchestratorType: 'swarm',
             input,
         });
         // SessionManager (or plugins) may restore state.results here via the hook
-        yield new BeforeMultiAgentInvocationEvent({ orchestrator: this, state, invocationState });
-        // Resume: if state was restored from a snapshot, derive the next node from the last handoff
-        const resumeNode = this._findResumeNode(state);
-        let node = resumeNode?.node ?? this.start;
-        let handoff = resumeNode?.lastHandoff;
+        yield* this._emit(new BeforeMultiAgentInvocationEvent({ orchestrator: this, state, invocationState }));
+        // Resume input bypasses handoff-derived resume (goes straight to the interrupted
+        // node). On fresh runs, stash the input for replay if a hook-gate pauses before
+        // the node runs.
+        const resumeResponses = extractResumeResponses(input);
+        const interruptResponsesByNode = resumeResponses ? groupInterruptResponsesByNode(resumeResponses, state) : undefined;
+        if (!resumeResponses) {
+            state._pendingInput = input;
+        }
+        let node;
+        let handoff;
+        let nextInput = input;
+        if (interruptResponsesByNode) {
+            // Swarm runs sequentially, so at most one node can be INTERRUPTED per run.
+            // Assert the invariant so a future change that accidentally produces multiple
+            // interrupted nodes surfaces loudly rather than silently taking the first.
+            if (interruptResponsesByNode.size > 1) {
+                throw new Error(`swarm_id=<${this.id}>, interrupted_nodes=<${[...interruptResponsesByNode.keys()].join(',')}> | swarm cannot have multiple interrupted nodes simultaneously`);
+            }
+            const entry = interruptResponsesByNode.entries().next().value;
+            if (!entry)
+                throw new Error(`swarm_id=<${this.id}> | no interrupt responses to route`);
+            const [nodeId, responses] = entry;
+            const resolvedNode = this.nodes.get(nodeId);
+            if (!resolvedNode) {
+                throw new Error(`node_id=<${nodeId}>, swarm_id=<${this.id}> | resume response targets a node missing from the swarm; topology changed between save and resume?`);
+            }
+            node = resolvedNode;
+            const resolvedNodeState = state.node(nodeId);
+            if (!resolvedNodeState) {
+                throw new Error(`node_id=<${nodeId}>, swarm_id=<${this.id}> | routed interrupt response targets a node missing from state; topology changed between save and resume?`);
+            }
+            // Orchestrator hooks consume matching responses; leftovers go to the child
+            // agent. If the hook consumed everything, replay the original invocation input.
+            const forwarded = applyOrchestratorHookResponses(resolvedNodeState, responses);
+            nextInput = forwarded.length > 0 ? forwarded : (state._pendingInput ?? '');
+        }
+        else {
+            const resumeNode = this._findResumeNode(state);
+            node = resumeNode?.node ?? this.start;
+            handoff = resumeNode?.lastHandoff;
+        }
         let caughtError;
         let result;
+        // Swarm-level timeout composes with each node's signal so a hung node still gets
+        // aborted. Timer starts fresh per invocation; human response time between resumes
+        // is not deducted.
+        const execController = Number.isFinite(this.config.timeout) ? new AbortController() : undefined;
+        const execTimeoutHandle = execController ? setTimeout(() => execController.abort(), this.config.timeout) : undefined;
+        const nodeCancelSignal = execController && externalCancelSignal
+            ? AbortSignal.any([execController.signal, externalCancelSignal])
+            : (execController?.signal ?? externalCancelSignal);
         try {
             while (state.steps < this.config.maxSteps) {
+                if (execController?.signal.aborted) {
+                    throw new Error(`timeout=<${this.config.timeout}>, swarm_id=<${this.id}> | swarm exceeded wall-clock budget`);
+                }
+                if (externalCancelSignal?.aborted) {
+                    throw new Error(`swarm_id=<${this.id}> | swarm cancelled by external signal`);
+                }
                 state.steps++;
-                // Execute current node
-                const nodeResult = yield* this._streamNode(node, input, state, handoff, multiAgentSpan, invocationState);
+                // After the first step (which may use routed resume responses), revert to the
+                // original input so post-handoff nodes see fresh content.
+                const nodeResult = yield* this._streamNode(node, nextInput, state, handoff, multiAgentSpan, invocationState, nodeCancelSignal);
+                nextInput = input;
                 handoff = nodeResult.structuredOutput;
+                if (execController?.signal.aborted) {
+                    throw new Error(`timeout=<${this.config.timeout}>, swarm_id=<${this.id}>, node_id=<${node.id}> | swarm exceeded wall-clock budget during node execution`);
+                }
                 // Check for terminal conditions
-                if (nodeResult.status === Status.FAILED || !handoff?.agentId) {
+                if (nodeResult.status === Status.FAILED || nodeResult.status === Status.INTERRUPTED || !handoff?.agentId) {
                     break;
                 }
                 // Hand off to next agent
                 const target = this.nodes.get(handoff.agentId);
-                yield new MultiAgentHandoffEvent({ source: node.id, targets: [target.id], state, invocationState });
+                yield* this._emit(new MultiAgentHandoffEvent({ source: node.id, targets: [target.id], state, invocationState }));
                 logger.debug(`source=<${node.id}>, target=<${target.id}> | swarm handoff`);
                 node = target;
             }
@@ -167,70 +241,123 @@ export class Swarm {
                 content: this._resolveContent(state),
                 duration: Date.now() - state.startTime,
             });
+            // Stash on interrupt so same-instance resume has state; otherwise start fresh.
+            if (result.status === Status.INTERRUPTED) {
+                this._pendingInterruptState = state;
+            }
+            else {
+                delete this._pendingInterruptState;
+                delete state._pendingInput;
+            }
         }
         catch (error) {
             caughtError = normalizeError(error);
             throw caughtError;
         }
         finally {
+            if (execTimeoutHandle !== undefined)
+                clearTimeout(execTimeoutHandle);
             this._tracer.endMultiAgentSpan(multiAgentSpan, {
                 duration: Date.now() - state.startTime,
                 ...(result && { usage: result.usage }),
                 ...(caughtError && { error: caughtError }),
             });
-            yield new AfterMultiAgentInvocationEvent({ orchestrator: this, state, invocationState });
+            yield* this._emit(new AfterMultiAgentInvocationEvent({ orchestrator: this, state, invocationState }));
         }
-        yield new MultiAgentResultEvent({ result, invocationState });
+        yield* this._emit(new MultiAgentResultEvent({ result, invocationState }));
         return result;
     }
-    async *_streamNode(node, input, state, handoff, multiAgentSpan, invocationState) {
+    /** Invokes hook callbacks on an event, then yields it. */
+    async *_emit(event) {
+        await this._hookRegistry.invokeCallbacks(event);
+        yield event;
+    }
+    async *_streamNode(node, input, state, handoff, multiAgentSpan, invocationState, executionSignal) {
         const nodeState = state.node(node.id);
         const handoffSchema = this._buildHandoffSchema(node.id);
         const nodeSpan = this._tracer.withSpanContext(multiAgentSpan, () => this._tracer.startNodeSpan({ nodeId: node.id, nodeType: node.type }));
         const beforeEvent = new BeforeNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState });
+        try {
+            await this._hookRegistry.invokeCallbacks(beforeEvent);
+        }
+        catch (error) {
+            if (error instanceof InterruptError) {
+                const result = recordHookInterrupt(node.id, nodeState);
+                state.results.push(result);
+                yield beforeEvent;
+                yield* this._emit(new NodeResultEvent({ nodeId: node.id, nodeType: node.type, state, result, invocationState }));
+                yield* this._emit(new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState }));
+                this._tracer.endNodeSpan(nodeSpan, { status: Status.INTERRUPTED, duration: result.duration });
+                return result;
+            }
+            throw error;
+        }
         yield beforeEvent;
         if (beforeEvent.cancel) {
             const message = typeof beforeEvent.cancel === 'string' ? beforeEvent.cancel : 'node cancelled by hook';
+            // Cancel path doesn't go through Node.stream, so do its INTERRUPTED cleanup here.
+            dropStaleInterruptedResult(node.id, nodeState, state);
             const result = new NodeResult({ nodeId: node.id, status: Status.CANCELLED, duration: 0 });
             nodeState.status = Status.CANCELLED;
             nodeState.results.push(result);
             state.results.push(result);
-            yield new NodeCancelEvent({ nodeId: node.id, state, message, invocationState });
-            yield new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState });
+            yield* this._emit(new NodeCancelEvent({ nodeId: node.id, state, message, invocationState }));
+            yield* this._emit(new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState }));
             this._tracer.endNodeSpan(nodeSpan, { status: Status.CANCELLED, duration: 0 });
             return result;
         }
         const nodeInput = this._resolveNodeInput(input, handoff);
+        const nodeTimeout = node.timeout ?? this.config.nodeTimeout;
+        const timeoutController = Number.isFinite(nodeTimeout) ? new AbortController() : undefined;
+        const timeoutHandle = timeoutController ? setTimeout(() => timeoutController.abort(), nodeTimeout) : undefined;
+        const signals = [executionSignal, timeoutController?.signal].filter((s) => s !== undefined);
+        const cancelSignal = signals.length > 0 ? AbortSignal.any(signals) : undefined;
         try {
-            const gen = this._tracer.withSpanContext(nodeSpan, () => node.stream(nodeInput, state, { structuredOutputSchema: handoffSchema, invocationState }));
+            const gen = this._tracer.withSpanContext(nodeSpan, () => node.stream(nodeInput, state, {
+                structuredOutputSchema: handoffSchema,
+                invocationState,
+                ...(cancelSignal && { cancelSignal }),
+            }));
             let next = await this._tracer.withSpanContext(nodeSpan, () => gen.next());
             while (!next.done) {
-                yield next.value;
+                if (next.value instanceof HookableEvent) {
+                    yield* this._emit(next.value);
+                }
+                else {
+                    yield next.value;
+                }
                 next = await this._tracer.withSpanContext(nodeSpan, () => gen.next());
             }
+            if (timeoutController?.signal.aborted) {
+                throw new Error(`node_timeout=<${nodeTimeout}>, node_id=<${node.id}>, swarm_id=<${this.id}> | node exceeded wall-clock budget`);
+            }
             const result = next.value;
             this._tracer.endNodeSpan(nodeSpan, { status: result.status, duration: result.duration, usage: result.usage });
             state.results.push(result);
-            yield new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState });
+            yield* this._emit(new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState }));
             return result;
         }
         catch (error) {
             const nodeError = normalizeError(error);
             this._tracer.endNodeSpan(nodeSpan, { error: nodeError });
-            yield new AfterNodeCallEvent({
-                orchestrator: this,
-                state,
-                nodeId: node.id,
-                invocationState,
-                error: nodeError,
-            });
+            yield* this._emit(new AfterNodeCallEvent({ orchestrator: this, state, nodeId: node.id, invocationState, error: nodeError }));
             throw nodeError;
         }
+        finally {
+            if (timeoutHandle !== undefined)
+                clearTimeout(timeoutHandle);
+        }
     }
     _validateConfig() {
         if (this.config.maxSteps < 1) {
             throw new Error(`max_steps=<${this.config.maxSteps}> | must be at least 1`);
         }
+        if (this.config.timeout < 1) {
+            throw new Error(`timeout=<${this.config.timeout}> | must be at least 1`);
+        }
+        if (this.config.nodeTimeout < 1) {
+            throw new Error(`node_timeout=<${this.config.nodeTimeout}> | must be at least 1`);
+        }
     }
     _resolveNodes(definitions) {
         if (definitions.length === 0) {
@@ -265,6 +392,12 @@ export class Swarm {
         }
         return [...last.content];
     }
+    /**
+     * Builds the input for the next node after a handoff, or returns the input as-is
+     * when there is no handoff (initial or resume invocation). The caller passes the
+     * original `MultiAgentInput` through; resume responses flow through here untouched
+     * so the underlying agent sees them directly.
+     */
     _resolveNodeInput(input, handoff) {
         if (!handoff)
             return input;