@strands-agents/sdk 1.0.0 → 1.2.0

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

@@ -2,13 +2,30 @@ import type { InvocationState, InvokeArgs } from '../types/agent.js';
 import type { Message, MessageData } from '../types/messages.js';
 import type { HookableEvent } from '../hooks/events.js';
 import type { HookCallback, HookableEventConstructor, HookCleanup } from '../hooks/types.js';
+import type { InterruptResponseContentData } from '../types/interrupt.js';
+import { InterruptResponseContent } from '../types/interrupt.js';
 import type { MultiAgentStreamEvent } from './events.js';
-import type { MultiAgentResult } from './state.js';
+import { NodeResult } from './state.js';
+import type { MultiAgentResult, MultiAgentState, NodeState } from './state.js';
 /**
- * Input type for multi-agent orchestrators. Excludes `Message[]` and `MessageData[]`
- * from {@link InvokeArgs} since orchestrators route content blocks between nodes.
+ * Input type for multi-agent orchestrators. Excludes `Message[]` / `MessageData[]`
+ * since orchestrators route content blocks between nodes rather than replaying raw
+ * conversation history.
+ *
+ * Accepts `InterruptResponseContent[]` / `InterruptResponseContentData[]` for resuming
+ * from an interrupted run — orchestrators detect resume input at the entry point and
+ * route responses to the interrupted nodes rather than flowing through dependency
+ * resolution.
  */
 export type MultiAgentInput = Exclude<InvokeArgs, Message[] | MessageData[]>;
+/**
+ * The non-resume subset of {@link MultiAgentInput}. Internal orchestrator helpers that
+ * participate in dependency resolution / handoff routing accept this narrower type so
+ * they don't need to re-check for {@link InterruptResponseContent} entries at each call.
+ *
+ * @internal
+ */
+export type MultiAgentContentInput = Exclude<MultiAgentInput, InterruptResponseContent[] | InterruptResponseContentData[]>;
 /**
  * Options for a single multi-agent orchestrator invocation.
  */
@@ -19,6 +36,18 @@ export interface MultiAgentInvokeOptions {
      * {@link InvocationState} for details. Defaults to `{}` when omitted.
      */
     invocationState?: InvocationState;
+    /**
+     * Cancellation signal forwarded to every node (and into any nested orchestrators
+     * via `MultiAgentNode`). Composed with the orchestrator's own timeout and
+     * short-circuit signals, matching {@link InvokeOptions.cancelSignal} on the
+     * single-agent path. Cooperative — honored by nodes that forward it to their
+     * underlying agents/tools.
+     *
+     * When this signal aborts, the orchestrator throws rather than returning a clean
+     * result. This matches single-agent behavior: external cancellation is treated as
+     * an exceptional exit, not a normal terminal state.
+     */
+    cancelSignal?: AbortSignal;
 }
 /**
  * Interface for any multi-agent orchestrator that can stream execution.
@@ -51,4 +80,49 @@ export interface MultiAgent {
      */
     addHook<T extends HookableEvent>(eventType: HookableEventConstructor<T>, callback: HookCallback<T>): HookCleanup;
 }
+/**
+ * Detects whether a {@link MultiAgentInput} is a resume from an interrupted run and
+ * normalizes its entries to {@link InterruptResponseContent} instances.
+ *
+ * Returns `undefined` for fresh input (string / content blocks / empty array).
+ */
+export declare function extractResumeResponses(input: MultiAgentInput): InterruptResponseContent[] | undefined;
+/**
+ * Groups a flat list of interrupt responses by the node that raised each interrupt.
+ *
+ * For each response, finds the node whose `NodeState.interrupts` contains an entry
+ * with a matching id. Ids are globally unique (derived from model-assigned
+ * `toolUseId`s) so each response maps to exactly one node. Nested orchestrators
+ * carry their subtree's interrupts on the wrapping `MultiAgentNode`'s state, so a
+ * matching response is forwarded as-is to the nested orchestrator, which does its
+ * own grouping recursively.
+ *
+ * @throws Error if any response's interrupt id does not match any tracked node
+ */
+export declare function groupInterruptResponsesByNode(responses: InterruptResponseContent[], state: MultiAgentState): Map<string, InterruptResponseContent[]>;
+/**
+ * Removes a stale INTERRUPTED result for the given node from both per-node history
+ * and the orchestrator-level aggregate so a fresh result (from resume or cancel)
+ * replaces it cleanly. No-op if the node isn't in an INTERRUPTED state.
+ */
+export declare function dropStaleInterruptedResult(nodeId: string, nodeState: NodeState, state: MultiAgentState): void;
+/**
+ * Records a hook-raised interrupt on a node that hadn't started executing: builds
+ * the INTERRUPTED {@link NodeResult}, transitions `nodeState.status`, and appends
+ * the result to `nodeState.results`. Returns the result so callers can route it
+ * into their own queue/lifecycle machinery.
+ *
+ * Shared between Graph and Swarm so their hook-interrupt branches don't drift.
+ */
+export declare function recordHookInterrupt(nodeId: string, nodeState: NodeState): NodeResult;
+/**
+ * Applies interrupt responses to a node's own orchestrator-level interrupts and
+ * returns the remaining responses — those bound for the child agent's interrupts.
+ *
+ * Orchestrator hooks (source `'multiagent-hook'`) store their interrupts on
+ * `NodeState.interrupts` directly; the hook re-runs on resume and reads the stored
+ * response. Agent-level interrupts aren't answerable here — they flow to the child
+ * agent as resume input and are applied by the agent's own interrupt machinery.
+ */
+export declare function applyOrchestratorHookResponses(nodeState: NodeState, responses: InterruptResponseContent[]): InterruptResponseContent[];
 //# sourceMappingURL=multiagent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"multiagent.d.ts","sourceRoot":"","sources":["../../../src/multiagent/multiagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE5F;;;;;OAKG;IACH,MAAM,CACJ,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;IAErE;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAA;CACjH"}
+{"version":3,"file":"multiagent.d.ts","sourceRoot":"","sources":["../../../src/multiagent/multiagent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,wBAAwB,EAA8B,MAAM,uBAAuB,CAAA;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,UAAU,EAAU,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE9E;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC,CAAA;AAE5E;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,eAAe,EACf,wBAAwB,EAAE,GAAG,4BAA4B,EAAE,CAC5D,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,WAAW,CAAA;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE5F;;;;;OAKG;IACH,MAAM,CACJ,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;IAErE;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAA;CACjH;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,wBAAwB,EAAE,GAAG,SAAS,CAerG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,wBAAwB,EAAE,EACrC,KAAK,EAAE,eAAe,GACrB,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAmBzC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAO7G;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,UAAU,CAUpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,wBAAwB,EAAE,GACpC,wBAAwB,EAAE,CAa5B"}

package/dist/src/multiagent/multiagent.js

@@ -1,2 +1,116 @@
-export {};
+import { InterruptResponseContent, isInterruptResponseContent } from '../types/interrupt.js';
+import { NodeResult, Status } from './state.js';
+/**
+ * Detects whether a {@link MultiAgentInput} is a resume from an interrupted run and
+ * normalizes its entries to {@link InterruptResponseContent} instances.
+ *
+ * Returns `undefined` for fresh input (string / content blocks / empty array).
+ */
+export function extractResumeResponses(input) {
+    if (!Array.isArray(input) || input.length === 0)
+        return undefined;
+    if (!isInterruptResponseContent(input[0]))
+        return undefined;
+    const responses = [];
+    for (const entry of input) {
+        if (entry instanceof InterruptResponseContent) {
+            responses.push(entry);
+        }
+        else if (isInterruptResponseContent(entry)) {
+            responses.push(InterruptResponseContent.fromJSON(entry));
+        }
+        else {
+            throw new TypeError('Must resume from interrupt with a list of interruptResponse content blocks only');
+        }
+    }
+    return responses;
+}
+/**
+ * Groups a flat list of interrupt responses by the node that raised each interrupt.
+ *
+ * For each response, finds the node whose `NodeState.interrupts` contains an entry
+ * with a matching id. Ids are globally unique (derived from model-assigned
+ * `toolUseId`s) so each response maps to exactly one node. Nested orchestrators
+ * carry their subtree's interrupts on the wrapping `MultiAgentNode`'s state, so a
+ * matching response is forwarded as-is to the nested orchestrator, which does its
+ * own grouping recursively.
+ *
+ * @throws Error if any response's interrupt id does not match any tracked node
+ */
+export function groupInterruptResponsesByNode(responses, state) {
+    const grouped = new Map();
+    for (const response of responses) {
+        const id = response.interruptResponse.interruptId;
+        let target;
+        for (const [nodeId, nodeState] of state.nodes) {
+            if (nodeState.interrupts.some((i) => i.id === id)) {
+                target = nodeId;
+                break;
+            }
+        }
+        if (!target) {
+            throw new Error(`interrupt_id=<${id}> | no node found with matching interrupt`);
+        }
+        const bucket = grouped.get(target) ?? [];
+        bucket.push(response);
+        grouped.set(target, bucket);
+    }
+    return grouped;
+}
+/**
+ * Removes a stale INTERRUPTED result for the given node from both per-node history
+ * and the orchestrator-level aggregate so a fresh result (from resume or cancel)
+ * replaces it cleanly. No-op if the node isn't in an INTERRUPTED state.
+ */
+export function dropStaleInterruptedResult(nodeId, nodeState, state) {
+    if (nodeState.status !== Status.INTERRUPTED)
+        return;
+    if (nodeState.results[nodeState.results.length - 1]?.status === Status.INTERRUPTED) {
+        nodeState.results.pop();
+    }
+    const idx = state.results.findIndex((r) => r.nodeId === nodeId && r.status === Status.INTERRUPTED);
+    if (idx >= 0)
+        state.results.splice(idx, 1);
+}
+/**
+ * Records a hook-raised interrupt on a node that hadn't started executing: builds
+ * the INTERRUPTED {@link NodeResult}, transitions `nodeState.status`, and appends
+ * the result to `nodeState.results`. Returns the result so callers can route it
+ * into their own queue/lifecycle machinery.
+ *
+ * Shared between Graph and Swarm so their hook-interrupt branches don't drift.
+ */
+export function recordHookInterrupt(nodeId, nodeState) {
+    const result = new NodeResult({
+        nodeId,
+        status: Status.INTERRUPTED,
+        duration: Date.now() - nodeState.startTime,
+        interrupts: nodeState.interrupts,
+    });
+    nodeState.status = Status.INTERRUPTED;
+    nodeState.results.push(result);
+    return result;
+}
+/**
+ * Applies interrupt responses to a node's own orchestrator-level interrupts and
+ * returns the remaining responses — those bound for the child agent's interrupts.
+ *
+ * Orchestrator hooks (source `'multiagent-hook'`) store their interrupts on
+ * `NodeState.interrupts` directly; the hook re-runs on resume and reads the stored
+ * response. Agent-level interrupts aren't answerable here — they flow to the child
+ * agent as resume input and are applied by the agent's own interrupt machinery.
+ */
+export function applyOrchestratorHookResponses(nodeState, responses) {
+    const forwarded = [];
+    for (const response of responses) {
+        const local = nodeState.interrupts.find((i) => i.id === response.interruptResponse.interruptId && i.source === 'multiagent-hook');
+        if (local) {
+            local.response = response.interruptResponse.response;
+        }
+        else {
+            forwarded.push(response);
+        }
+    }
+    return forwarded;
+}
 //# sourceMappingURL=multiagent.js.map

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

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

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

@@ -32,6 +32,11 @@ export interface NodeInputOptions {
      * hooks/tools can read state written by a previous node.
      */
     invocationState?: InvocationState;
+    /**
+     * Cancellation signal forwarded to the node's underlying agent. Used by
+     * orchestrators to enforce per-node timeouts or propagate external cancellation.
+     */
+    cancelSignal?: AbortSignal;
 }
 /**
  * Abstract base class for all multi-agent orchestration nodes.
@@ -77,6 +82,13 @@ export declare abstract class Node {
 export interface AgentNodeOptions {
     /** The agent to wrap as a node. */
     agent: InvokableAgent;
+    /**
+     * Per-node wall-clock ceiling in milliseconds. Overrides the orchestrator's
+     * default node timeout. Cancellation is cooperative — a tool that neither
+     * polls its cancel signal nor forwards it to a cancellable API can run past
+     * this deadline.
+     */
+    timeout?: number;
 }
 /**
  * Node that wraps an {@link InvokableAgent} instance for multi-agent orchestration.
@@ -87,6 +99,12 @@ export interface AgentNodeOptions {
 export declare class AgentNode extends Node {
     readonly type: "agentNode";
     private readonly _agent;
+    /**
+     * Per-node wall-clock ceiling in milliseconds. When set, overrides the orchestrator's
+     * `nodeTimeout` for this node. Undefined means "fall back to the orchestrator's setting."
+     * See {@link AgentNodeOptions.timeout}.
+     */
+    readonly timeout?: number;
     constructor(options: AgentNodeOptions);
     get agent(): InvokableAgent;
     /**

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

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

package/dist/src/multiagent/nodes.js

@@ -1,9 +1,10 @@
 import { Agent } from '../agent/agent.js';
-import { takeSnapshot, loadSnapshot } from '../agent/snapshot.js';
+import { dropStaleInterruptedResult } from './multiagent.js';
 import { NodeStreamUpdateEvent, NodeResultEvent } from './events.js';
 import { NodeResult, Status } from './state.js';
 import { logger } from '../logging/logger.js';
 import { normalizeError } from '../errors.js';
+import { omitUndefined } from '../types/json.js';
 /**
  * Abstract base class for all multi-agent orchestration nodes.
  *
@@ -36,6 +37,8 @@ export class Node {
      */
     async *stream(input, state, options) {
         const nodeState = state.node(this.id);
+        // Resuming from INTERRUPTED: drop the stale result so the fresh one replaces it.
+        dropStaleInterruptedResult(this.id, nodeState, state);
         nodeState.status = Status.EXECUTING;
         nodeState.startTime = Date.now();
         // Resolve invocationState once — the same reference is threaded into handle()
@@ -45,26 +48,38 @@ export class Node {
         let result;
         try {
             const update = yield* this.handle(input, state, resolvedOptions);
+            const defaultStatus = update.interrupts && update.interrupts.length > 0 ? Status.INTERRUPTED : Status.COMPLETED;
             result = new NodeResult({
                 nodeId: this.id,
-                status: Status.COMPLETED,
+                status: defaultStatus,
                 duration: Date.now() - nodeState.startTime,
                 content: [],
                 ...update,
             });
         }
         catch (error) {
+            // Orchestrator cancellation (short-circuit or external) maps thrown errors to
+            // CANCELLED — node was stopped, not broken.
+            const status = options?.cancelSignal?.aborted ? Status.CANCELLED : Status.FAILED;
             result = new NodeResult({
                 nodeId: this.id,
-                status: Status.FAILED,
+                status,
                 duration: Date.now() - nodeState.startTime,
                 error: normalizeError(error),
             });
-            logger.warn(`node_id=<${this.id}>, error=<${result.error?.message}> | node execution failed`);
+            if (status === Status.FAILED) {
+                logger.warn(`node_id=<${this.id}>, error=<${result.error?.message}> | node execution failed`);
+            }
         }
         finally {
             nodeState.status = result.status;
             nodeState.results.push(result);
+            nodeState.interrupts = result.interrupts ?? [];
+            // Clear the stored snapshot on non-INTERRUPTED terminal states; `handle()`
+            // repopulates it above if this run itself interrupted.
+            if (result.status !== Status.INTERRUPTED) {
+                delete nodeState.interruptedSnapshot;
+            }
         }
         yield new NodeResultEvent({
             nodeId: this.id,
@@ -85,13 +100,25 @@ export class Node {
 export class AgentNode extends Node {
     type = 'agentNode';
     _agent;
+    /**
+     * Per-node wall-clock ceiling in milliseconds. When set, overrides the orchestrator's
+     * `nodeTimeout` for this node. Undefined means "fall back to the orchestrator's setting."
+     * See {@link AgentNodeOptions.timeout}.
+     */
+    timeout;
     constructor(options) {
-        const { agent, ...config } = options;
+        const { agent, timeout, ...config } = options;
         super(agent.id, {
             ...config,
             ...(agent.description !== undefined && { description: agent.description }),
         });
         this._agent = agent;
+        if (timeout !== undefined) {
+            if (timeout < 1) {
+                throw new Error(`timeout=<${timeout}>, node_id=<${agent.id}> | must be at least 1`);
+            }
+            this.timeout = timeout;
+        }
     }
     get agent() {
         return this._agent;
@@ -109,13 +136,18 @@ export class AgentNode extends Node {
         // Resolve once per handle() call — Node.stream() normally supplies this;
         // handle() is public API, so direct callers get per-call state.
         const invocationState = options?.invocationState ?? {};
-        // Only Agent instances support snapshot/restore for state isolation
-        const snapshot = this._agent instanceof Agent
-            ? takeSnapshot(this._agent, { include: ['messages', 'state', 'modelState'] })
-            : undefined;
+        // Only Agent instances support snapshot/restore for state isolation.
+        const isAgent = this._agent instanceof Agent;
+        const preRunSnapshot = isAgent ? this._agent.takeSnapshot({ preset: 'session' }) : undefined;
+        // Rehydrate agent state from a prior INTERRUPTED run (messages + interrupt state).
+        const nodeState = state.node(this.id);
+        if (isAgent && nodeState?.interruptedSnapshot) {
+            this._agent.loadSnapshot(nodeState.interruptedSnapshot);
+        }
         try {
             const invokeOptions = {
                 ...(options?.structuredOutputSchema && { structuredOutputSchema: options.structuredOutputSchema }),
+                ...(options?.cancelSignal && { cancelSignal: options.cancelSignal }),
                 invocationState,
             };
             const gen = this._agent.stream(input, invokeOptions);
@@ -125,22 +157,32 @@ export class AgentNode extends Node {
                     nodeId: this.id,
                     nodeType: this.type,
                     state,
-                    inner: this._agent instanceof Agent
+                    inner: isAgent
                         ? { source: 'agent', event: next.value }
                         : { source: 'custom', event: next.value },
                     invocationState,
                 });
                 next = await gen.next();
             }
-            return {
-                content: next.value.lastMessage.content,
-                ...('structuredOutput' in next.value && { structuredOutput: next.value.structuredOutput }),
-                ...(next.value.metrics?.accumulatedUsage && { usage: next.value.metrics.accumulatedUsage }),
-            };
+            const agentResult = next.value;
+            const interrupted = agentResult.stopReason === 'interrupt' && agentResult.interrupts && agentResult.interrupts.length > 0;
+            // Capture post-interrupt state for the next resume cycle. Only Agent instances
+            // are snapshottable.
+            if (interrupted && isAgent && nodeState) {
+                nodeState.interruptedSnapshot = this._agent.takeSnapshot({ preset: 'session' });
+            }
+            return omitUndefined({
+                content: agentResult.lastMessage.content,
+                structuredOutput: 'structuredOutput' in agentResult ? agentResult.structuredOutput : undefined,
+                usage: agentResult.metrics?.accumulatedUsage,
+                interrupts: interrupted ? agentResult.interrupts : undefined,
+            });
         }
         finally {
-            if (snapshot) {
-                loadSnapshot(this._agent, snapshot);
+            // Restore pre-run state — keeps the agent observably unchanged across runs.
+            if (preRunSnapshot) {
+                ;
+                this._agent.loadSnapshot(preRunSnapshot);
             }
         }
     }
@@ -178,7 +220,10 @@ export class MultiAgentNode extends Node {
         // Resolve once per handle() call — Node.stream() normally supplies this;
         // handle() is public API, so direct callers get per-call state.
         const invocationState = options?.invocationState ?? {};
-        const gen = this._orchestrator.stream(input, { invocationState });
+        const gen = this._orchestrator.stream(input, {
+            invocationState,
+            ...(options?.cancelSignal && { cancelSignal: options.cancelSignal }),
+        });
         let next = await gen.next();
         while (!next.done) {
             const event = next.value;
@@ -197,12 +242,14 @@ export class MultiAgentNode extends Node {
             next = await gen.next();
         }
         const innerResult = next.value;
-        return {
+        const interrupted = innerResult.interrupts && innerResult.interrupts.length > 0;
+        return omitUndefined({
             content: innerResult.content,
             usage: innerResult.usage,
-            ...(innerResult.status !== Status.COMPLETED && { status: innerResult.status }),
-            ...(innerResult.error && { error: innerResult.error }),
-        };
+            status: innerResult.status !== Status.COMPLETED ? innerResult.status : undefined,
+            error: innerResult.error,
+            interrupts: interrupted ? innerResult.interrupts : undefined,
+        });
     }
 }
 //# sourceMappingURL=nodes.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/multiagent/nodes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/multiagent/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAGzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAwChD;;;;;;GAMG;AACH,MAAM,OAAgB,IAAI;IACf,IAAI,GAAW,MAAM,CAAA;IAC9B,gEAAgE;IACvD,EAAE,CAAQ;IACnB,8BAA8B;IACrB,MAAM,CAAY;IAE3B;;;OAGG;IACH,YAAY,EAAU,EAAE,MAAkB;QACxC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,KAAsB,EACtB,KAAsB,EACtB,OAA0B;QAE1B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAE,CAAA;QAEtC,iFAAiF;QACjF,0BAA0B,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QAErD,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAA;QACnC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEhC,8EAA8E;QAC9E,+EAA+E;QAC/E,MAAM,eAAe,GAAoB,OAAO,EAAE,eAAe,IAAI,EAAE,CAAA;QACvE,MAAM,eAAe,GAAqB,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,CAAA;QAEzE,IAAI,MAAkB,CAAA;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,CAAA;YAChE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAA;YAC/G,MAAM,GAAG,IAAI,UAAU,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,SAAS;gBAC1C,OAAO,EAAE,EAAE;gBACX,GAAG,MAAM;aACV,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8EAA8E;YAC9E,4CAA4C;YAC5C,MAAM,MAAM,GAAG,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;YAChF,MAAM,GAAG,IAAI,UAAU,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,SAAS;gBAC1C,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;aAC7B,CAAC,CAAA;YACF,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,aAAa,MAAM,CAAC,KAAK,EAAE,OAAO,2BAA2B,CAAC,CAAA;YAC/F,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,MAAM,GAAG,MAAO,CAAC,MAAM,CAAA;YACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAO,CAAC,CAAA;YAC/B,SAAS,CAAC,UAAU,GAAG,MAAO,CAAC,UAAU,IAAI,EAAE,CAAA;YAC/C,2EAA2E;YAC3E,uDAAuD;YACvD,IAAI,MAAO,CAAC,MAAM,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC1C,OAAO,SAAS,CAAC,mBAAmB,CAAA;YACtC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,eAAe,CAAC;YACxB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK;YACL,MAAM;YACN,eAAe;SAChB,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC;CAeF;AAiBD;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,IAAI;IACxB,IAAI,GAAG,WAAoB,CAAA;IACnB,MAAM,CAAgB;IACvC;;;;OAIG;IACM,OAAO,CAAS;IAEzB,YAAY,OAAyB;QACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;QAE7C,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE;YACd,GAAG,MAAM;YACT,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;SAC3E,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,eAAe,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAA;YACrF,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACxB,CAAC;IACH,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,KAAsB,EACtB,KAAsB,EACtB,OAA0B;QAE1B,yEAAyE;QACzE,gEAAgE;QAChE,MAAM,eAAe,GAAoB,OAAO,EAAE,eAAe,IAAI,EAAE,CAAA;QAEvE,qEAAqE;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,YAAY,KAAK,CAAA;QAC5C,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAE5F,mFAAmF;QACnF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,OAAO,IAAI,SAAS,EAAE,mBAAmB,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;QACzD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,GAAkB;gBACnC,GAAG,CAAC,OAAO,EAAE,sBAAsB,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,sBAAsB,EAAE,CAAC;gBAClG,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;gBACpE,eAAe;aAChB,CAAA;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;YACpD,IAAI,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,qBAAqB,CAAC;oBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK;oBACL,KAAK,EAAE,OAAO;wBACZ,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAyB,EAAE;wBAC5D,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;oBAC3C,eAAe;iBAChB,CAAC,CAAA;gBACF,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YACzB,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAA;YAC9B,MAAM,WAAW,GACf,WAAW,CAAC,UAAU,KAAK,WAAW,IAAI,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;YAEvG,+EAA+E;YAC/E,qBAAqB;YACrB,IAAI,WAAW,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;gBACxC,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;YACjF,CAAC;YAED,OAAO,aAAa,CAAC;gBACnB,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO;gBACxC,gBAAgB,EAAE,kBAAkB,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;gBAC9F,KAAK,EAAE,WAAW,CAAC,OAAO,EAAE,gBAAgB;gBAC5C,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC7D,CAAC,CAAA;QACJ,CAAC;gBAAS,CAAC;YACT,4EAA4E;YAC5E,IAAI,cAAc,EAAE,CAAC;gBACnB,CAAC;gBAAC,IAAI,CAAC,MAAgB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAUD;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,IAAI;IAC7B,IAAI,GAAG,gBAAyB,CAAA;IACxB,aAAa,CAAY;IAE1C,YAAY,OAA8B;QACxC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;QAC3C,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAA;IACnC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,KAAsB,EACtB,KAAsB,EACtB,OAA0B;QAE1B,yEAAyE;QACzE,gEAAgE;QAChE,MAAM,eAAe,GAAoB,OAAO,EAAE,eAAe,IAAI,EAAE,CAAA;QAEvE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE;YAC3C,eAAe;YACf,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;SACrE,CAAC,CAAA;QACF,IAAI,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;YACxB,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAA;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,qBAAqB,CAAC;oBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK;oBACL,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE;oBACtC,eAAe;iBAChB,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAA;QAC9B,MAAM,WAAW,GAAG,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;QAE/E,OAAO,aAAa,CAAC;YACnB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAChF,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAA;IACJ,CAAC;CACF"}

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

@@ -3,6 +3,9 @@ import { type ContentBlock } from '../types/messages.js';
 import type { Usage } from '../models/streaming.js';
 import type { z } from 'zod';
 import type { JSONValue } from '../types/json.js';
+import { Interrupt } from '../interrupt.js';
+import type { MultiAgentInput } from './multiagent.js';
+import type { Snapshot } from '../types/snapshot.js';
 import { loadStateFromJSONSymbol, stateToJSONSymbol, type StateSerializable } from '../types/serializable.js';
 /**
  * Execution lifecycle status shared across all multi-agent patterns.
@@ -18,15 +21,17 @@ export declare const Status: {
     readonly FAILED: "FAILED";
     /** Execution was cancelled before or during processing. */
     readonly CANCELLED: "CANCELLED";
+    /** Execution paused awaiting an interrupt response; can be resumed. */
+    readonly INTERRUPTED: "INTERRUPTED";
 };
 /**
  * Union of all valid status values.
  */
 export type Status = (typeof Status)[keyof typeof Status];
 /**
- * Subset of {@link Status} representing terminal outcomes.
+ * Subset of {@link Status} valid for a {@link NodeResult}.
  */
-export type ResultStatus = typeof Status.COMPLETED | typeof Status.FAILED | typeof Status.CANCELLED;
+export type ResultStatus = typeof Status.COMPLETED | typeof Status.FAILED | typeof Status.CANCELLED | typeof Status.INTERRUPTED;
 /**
  * Result of executing a single node.
  */
@@ -42,6 +47,8 @@ export declare class NodeResult {
     readonly structuredOutput?: z.output<z.ZodType>;
     /** Token usage from the node execution. */
     readonly usage?: Usage;
+    /** Interrupts raised by the underlying agent/orchestrator. Present iff `status === 'INTERRUPTED'`. */
+    readonly interrupts?: Interrupt[];
     constructor(data: {
         nodeId: string;
         status: ResultStatus;
@@ -50,6 +57,7 @@ export declare class NodeResult {
         error?: Error;
         structuredOutput?: z.output<z.ZodType>;
         usage?: Usage;
+        interrupts?: Interrupt[];
     });
     /** Serializes this result to a JSON-compatible value. */
     toJSON(): JSONValue;
@@ -75,6 +83,15 @@ export declare class NodeState implements StateSerializable {
     /** Node execution start time in milliseconds since epoch. */
     startTime: number;
     readonly results: NodeResult[];
+    /** Unanswered interrupts raised during this node's most recent run. Populated when `status === 'INTERRUPTED'`. */
+    interrupts: Interrupt[];
+    /**
+     * 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?: Snapshot;
     constructor();
     /** Content from the most recent result, or empty array if none. */
     get content(): readonly ContentBlock[];
@@ -96,18 +113,28 @@ export declare class MultiAgentResult {
     readonly error?: Error;
     /** Aggregated token usage across all node results. */
     readonly usage: Usage;
+    /** Interrupts aggregated across all node results. Present when any node ended INTERRUPTED. */
+    readonly interrupts?: Interrupt[];
     constructor(data: {
         status?: ResultStatus;
         results: NodeResult[];
         content?: ContentBlock[];
         duration: number;
         error?: Error;
+        interrupts?: Interrupt[];
     });
     /** Serializes this result to a JSON-compatible value. */
     toJSON(): JSONValue;
     /** Creates a MultiAgentResult from a previously serialized JSON value. */
     static fromJSON(data: JSONValue): MultiAgentResult;
-    /** 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.
+     */
     private _resolveStatus;
     /** Sums token usage across all node results. */
     private _aggregateNodeUsage;
@@ -124,6 +151,15 @@ export declare class MultiAgentState implements StateSerializable {
     readonly results: NodeResult[];
     /** App-level key-value state accessible from hooks, edge handlers, and custom nodes. */
     readonly app: StateStore;
+    /**
+     * 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?: MultiAgentInput;
     private readonly _nodes;
     constructor(data?: {
         nodeIds?: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/multiagent/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/multiagent/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,sBAAsB,CAAA;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EAGjB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,qCAAqC;;IAErC,0CAA0C;;IAE1C,uCAAuC;;IAEvC,sCAAsC;;IAEtC,2DAA2D;;IAE3D,uEAAuE;;CAE/D,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,MAAM,CAAC,SAAS,GACvB,OAAO,MAAM,CAAC,MAAM,GACpB,OAAO,MAAM,CAAC,SAAS,GACvB,OAAO,MAAM,CAAC,WAAW,CAAA;AAE7B;;GAEG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC/C,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,sGAAsG;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;gBAErB,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,YAAY,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;QACxB,KAAK,CAAC,EAAE,KAAK,CAAA;QACb,gBAAgB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACtC,KAAK,CAAC,EAAE,KAAK,CAAA;QACb,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;KACzB;IAWD,yDAAyD;IACzD,MAAM,IAAI,SAAS;IAcnB,oEAAoE;IACpE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU;CAe7C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;AAEhE;;GAEG;AACH,qBAAa,SAAU,YAAW,iBAAiB;IACjD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;IAC9B,kHAAkH;IAClH,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,QAAQ,CAAA;;IAU9B,mEAAmE;IACnE,IAAI,OAAO,IAAI,SAAS,YAAY,EAAE,CAGrC;IAED,oDAAoD;IACpD,CAAC,iBAAiB,CAAC,IAAI,SAAS;IAWhC,2DAA2D;IAC3D,CAAC,uBAAuB,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAgBjD;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;gBAErB,IAAI,EAAE;QAChB,MAAM,CAAC,EAAE,YAAY,CAAA;QACrB,OAAO,EAAE,UAAU,EAAE,CAAA;QACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,KAAK,CAAA;QACb,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;KACzB;IAWD,yDAAyD;IACzD,MAAM,IAAI,SAAS;IAanB,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB;IAclD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAOtB,gDAAgD;IAChD,OAAO,CAAC,mBAAmB;CAQ5B;AAiBD;;GAEG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAA;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAWzC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIvC;;OAEG;IACH,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAE1C;IAED,oDAAoD;IACpD,CAAC,iBAAiB,CAAC,IAAI,SAAS;IAehC,2DAA2D;IAC3D,CAAC,uBAAuB,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAwBjD"}