WorkflowSnapshot

One immutable bundle of the records an agent or developer-tool app shows: messages, tool calls, approvals, tasks, logs, and more, each in the type the matching widget takes (such as MessageEntry for MessageList).

Import: package:fleury/fleury.dart, or package:fleury/fleury_core.dart in browser code.

Usage

final snapshot = WorkflowSnapshot(
  title: 'Release',
  tasks: const [
    TaskGraphNode(id: 'tests', title: 'Run tests', status: TaskGraphStatus.succeeded),
    TaskGraphNode(id: 'build', title: 'Build image', status: TaskGraphStatus.running),
  ],
);

// Derived, safe aggregate state: health, counts, semantic state.
final summary = snapshot.summary;
Text('${summary.health.name}: ${summary.activeTaskCount} of ${summary.taskCount} tasks remaining')

Details

It draws nothing itself. Build a new snapshot from your app’s state when that state changes, pass its lists to the widgets that display them, and read summary for derived counts and an overall WorkflowHealth. Lookup helpers such as toolCallById find a record by id, and toSemanticState exposes the summary to tests and agents.

Constructors

WorkflowSnapshot()

Parameter	Type	Default	Description
id:	Object?	—	Optional stable workflow identity.
title:	String?	—	Human-readable workflow title.
messages:	List<MessageEntry>	const <MessageEntry>[]	Conversation or transcript messages in this workflow.
toolCalls:	List<ToolCallRecord>	const <ToolCallRecord>[]	Tool calls attached to the workflow.
approvals:	List<ApprovalRequest>	const <ApprovalRequest>[]	Approval requests waiting for the user. Any request here makes summary report WorkflowHealth.needsAttention (unless something failed), so remove answered ones.
tasks:	List<TaskGraphNode>	const <TaskGraphNode>[]	Task graph nodes representing planned or running work.
modelStatus:	ModelStatusInfo?	—	Current model/runtime status, if known.
contextItems:	List<ContextItem>	const <ContextItem>[]	Context items currently attached to the workflow.
fileMentions:	List<FileMentionEntry>	const <FileMentionEntry>[]	Mentionable files or paths associated with the workflow.
conversations:	List<ConversationEntry>	const <ConversationEntry>[]	Conversation summaries available to the workflow.
traceEvents:	List<TraceTimelineEntry>	const <TraceTimelineEntry>[]	Trace or timeline events for active work.
patchFiles:	List<PatchReviewFile>	const <PatchReviewFile>[]	Patch files currently under review.
logEntries:	List<LogEntry>	const <LogEntry>[]	Log rows associated with the workflow.
metadata:	Map<String, Object?>	const <String, Object?>{}	App-specific semantic state carried by the snapshot.

Source

WorkflowSnapshot is defined in packages/fleury/lib/src/catalog/workflow_snapshot.dart.

Category: Agent surfaces · All widgets

Live demo

workflowsnapshot_example.dart

Restart Run Expand

Example · editable Revert Format

class _WorkflowSnapshotExampleState extends State<_WorkflowSnapshotExample> {
  static const _plan = <String>['Run tests', 'Build image', 'Deploy'];

  List<TaskGraphStatus> _statuses = [
    TaskGraphStatus.succeeded,
    TaskGraphStatus.running,
    TaskGraphStatus.pending,
  ];

  WorkflowSnapshot get _snapshot => WorkflowSnapshot(
    title: 'Release',
    tasks: [
      for (var i = 0; i < _plan.length; i++)
        TaskGraphNode(id: 'task-$i', title: _plan[i], status: _statuses[i]),
    ],
  );

  void _advance() => setState(() {
    final running = _statuses.indexOf(TaskGraphStatus.running);
    final pending = _statuses.indexOf(TaskGraphStatus.pending);
    _statuses = [..._statuses];
    if (running >= 0) _statuses[running] = TaskGraphStatus.succeeded;
    if (pending >= 0) _statuses[pending] = TaskGraphStatus.running;
  });

  void _fail() => setState(() {
    final running = _statuses.indexOf(TaskGraphStatus.running);
    if (running < 0) return;
    _statuses = [..._statuses]..[running] = TaskGraphStatus.failed;
  });

  void _reset() => setState(() {
    _statuses = [
      TaskGraphStatus.running,
      TaskGraphStatus.pending,
      TaskGraphStatus.pending,
    ];
  });

  @override
  Widget build(BuildContext context) {
    final snapshot = _snapshot;
    final summary = snapshot.summary;
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        SizedBox(height: 4, child: TaskGraph(nodes: snapshot.tasks)),
        Text(
          'health: ${summary.health.name} · '
          '${summary.activeTaskCount} of ${summary.taskCount} remaining · '
          '${summary.failedTaskCount} failed',
          style: const CellStyle(bold: true),
        ),
        const SizedBox(height: 1),
        Row(
          children: [
            Button(text: 'Advance', autofocus: true, onPressed: _advance),
            const SizedBox(width: 1),
            Button(text: 'Fail', onPressed: _fail),
            const SizedBox(width: 1),
            Button(text: 'Reset', onPressed: _reset),
          ],
        ),
      ],
    );
  }
}

Live preview

Live · interactive

click & type to interact ⓘ how this demo runs ⛶ Expand