Events¶

Event models for real-time dashboard.

Defines 5 core event types that capture agent execution lifecycle. All schemas match DATA_MODEL.md specification exactly.

Classes¶

SubscriptionInfo ¶

Bases: BaseModel

Subscription configuration for an agent.

VisibilitySpec ¶

Bases: BaseModel

Visibility specification for artifacts.

Matches visibility types from flock.visibility module.

AgentActivatedEvent ¶

Bases: BaseModel

Event emitted when agent begins consuming artifacts.

Corresponds to on_pre_consume lifecycle hook. Schema per DATA_MODEL.md lines 53-66.

MessagePublishedEvent ¶

Bases: BaseModel

Event emitted when artifact is published to blackboard.

Corresponds to on_post_publish lifecycle hook. Schema per DATA_MODEL.md lines 100-115.

StreamingOutputEvent ¶

Bases: BaseModel

Event emitted when agent generates LLM tokens or logs.

For Phase 1: This is optional and not fully implemented. Schema per DATA_MODEL.md lines 152-159.

Phase 6 Extension: Added artifact_id for message node streaming in blackboard view.

AgentCompletedEvent ¶

Bases: BaseModel

Event emitted when agent execution finishes successfully.

Corresponds to on_terminate lifecycle hook. Schema per DATA_MODEL.md lines 205-212.

AgentErrorEvent ¶

Bases: BaseModel

Event emitted when agent execution fails.

Corresponds to on_error lifecycle hook. Schema per DATA_MODEL.md lines 247-253.

CorrelationGroupUpdatedEvent ¶

Bases: BaseModel

Event emitted when artifact added to correlation group.

Phase 1.2: Logic Operations UX Enhancement Emitted when an artifact is added to a JoinSpec correlation group that has not yet collected all required types.

BatchItemAddedEvent ¶

Bases: BaseModel

Event emitted when artifact added to batch accumulator.

Phase 1.2: Logic Operations UX Enhancement Emitted when an artifact is added to a BatchSpec accumulator that has not yet reached its flush threshold.