ParallelAgent class

Workflow agent that runs sub-agents concurrently.

Inheritance

Constructors

ParallelAgent({required String name, String description = '', List<BaseAgent>? subAgents, Object? beforeAgentCallback, Object? afterAgentCallback})
Creates a parallel agent.

Properties

afterAgentCallback Object?
Callback(s) invoked after agent execution.
getter/setter pairinherited
beforeAgentCallback Object?
Callback(s) invoked before agent execution.
getter/setter pairinherited
canonicalAfterAgentCallbacks List<AgentLifecycleCallback>
Canonical after-agent callbacks.
no setterinherited
canonicalBeforeAgentCallbacks List<AgentLifecycleCallback>
Canonical before-agent callbacks.
no setterinherited
description String
Human-readable description.
getter/setter pairinherited
hashCode int
The hash code for this object.
no setterinherited
name String
Agent name.
getter/setter pairinherited
parentAgent BaseAgent?
Parent agent in the hierarchy, if any.
getter/setter pairinherited
rootAgent BaseAgent
The top-most ancestor in this agent hierarchy.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
subAgents List<BaseAgent>
Child agents that this agent may delegate to.
getter/setter pairinherited

Methods

clone({Map<String, Object?>? update}) ParallelAgent
Returns a cloned parallel agent with optional field overrides.
override
cloneFieldValue<T>({required Map<String, Object?> update, required String fieldName, required T currentValue}) → T
Reads typed field overrides for clone operations.
inherited
cloneListFieldValue<T>({required Map<String, Object?> update, required String fieldName, required List<T> currentValue}) List<T>
Reads list field overrides for clone operations.
inherited
cloneObjectFieldValue({required Map<String, Object?> update, required String fieldName, required Object? currentValue}) Object?
Reads object field overrides while preserving list copy semantics.
inherited
cloneSubAgentsField(Map<String, Object?> update) List<BaseAgent>
Resolves cloned sub-agent lists from update or existing sub-agents.
inherited
createAgentStateEvent(InvocationContext context) Event
Creates an event containing this agent's latest serialized state.
inherited
createInvocationContext(InvocationContext parentContext) InvocationContext
Creates a child invocation context for this agent.
inherited
findAgent(String targetName) BaseAgent?
Finds an agent named targetName in this subtree.
inherited
findSubAgent(String targetName) BaseAgent?
Finds a descendant agent named targetName.
inherited
loadAgentState(InvocationContext context) BaseAgentState?
Loads this agent's serialized state from context, if present.
inherited
normalizeCloneUpdate(Map<String, Object?>? update) Map<String, Object?>
Normalizes clone update maps into mutable JSON-like maps.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
relinkClonedSubAgents(BaseAgent clonedAgent) → void
Re-links parent pointers for clonedAgent and its sub-agents.
inherited
runAsync(InvocationContext parentContext) Stream<Event>
Runs the agent asynchronously with lifecycle callbacks.
inherited
runAsyncImpl(InvocationContext context) Stream<Event>
Runs sub-agents concurrently and merges their emitted events.
override
runLive(InvocationContext parentContext) Stream<Event>
Runs the agent in live mode with lifecycle callbacks.
inherited
runLiveImpl(InvocationContext context) Stream<Event>
Runs live mode using async parallel execution semantics.
override
toString() String
A string representation of this object.
inherited
validateCloneUpdateFields({required Map<String, Object?> update, required Set<String> allowedFields}) → void
Validates clone-update update keys against allowedFields.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited