agent_kit

0.1.4: embed animated demo GIF inline in README for pub.dev page

Changed

• Embed animated demo GIF inline at the top of the README so it renders (and animates) directly on the pub.dev package page, not only inside the screenshots carousel. Matches the streamdown package pattern.

Adds screenshots block to pubspec so pub.dev renders demo GIFs and cover image on the package page.

Added

• screenshots: block in pubspec.yaml so pub.dev now renders the agent demo GIFs and tool-call cover image on the package page.

See CHANGELOG.md. Published to pub.dev: https://pub.dev/packages/agent_kit

Fixed

• AgentTimeline consolidation now treats ThinkingEvent as a singleton channel, not just a "collapse consecutive" rule. A Thinking → Plan → Thinking sequence (which happens any time the user triggers a replay or the agent emits a fresh reasoning step after a tool call) used to produce two ThinkingBubble children sharing the const timeline-think key and crashed the build with a Duplicate keys found … timeline-think assertion. The latest ThinkingEvent now replaces the previous one anywhere in the consolidated list, mirroring how PlanEvent and CitationEvent are already handled.

Repeated ToolCallEvents for the same call.id now update one card in
place instead of creating duplicate widget keys. Consecutive
ThinkingEvents and successive Plan/Citation snapshots collapse to a
single live widget.

Fixes assertion: 'Duplicate keys found ... timeline-tool-'.

Fixed

• AgentTimeline now consolidates the raw event stream before rendering, so repeated ToolCallEvents with the same call.id update a single card in place instead of producing duplicate widget keys. Consecutive ThinkingEvents, and successive PlanEvent / CitationEvent snapshots, are also collapsed to a single live widget. Fixes the Duplicate keys found … timeline-tool-<id> assertion when feeding state transitions for the same tool call into AgentView.

Drop-in Flutter widgets for AI agent UIs — tool-call cards, thinking
bubbles, citation chips, plan-progress timelines. Backend-agnostic.

• Core models: ToolCall, ThinkingStep, Citation, PlanStep + sealed AgentEvent
• Widgets: ToolCallCard, ToolCallFeed, ThinkingBubble, ReasoningTrace,
  CitationChip, CitationCard, CitationList, PlanProgress, AgentTimeline
• Composition: AgentView, AgentEventBuilder
• Theme: AgentKitTheme with light/dark + density presets
• 55 tests passing, 0 analyzer issues, dart pub publish dry-run clean

First public release. Drop-in widgets for the non-text parts of AI agent UIs.

Added

• Core models
  • ToolCall + ToolCallState (pending / running / success / failed / cancelled) — immutable snapshots advance via copyWith as streams update.
  • ThinkingStep for reasoning prose with an isStreaming flag.
  • Citation for retrieval sources (id, title, url, snippet).
  • PlanStep + PlanStepState (pending / running / done / failed / skipped) with nested sub-step support.
  • AgentEvent Dart 3 sealed union over the above + AgentEventStream typedef.
  • toJson / fromJson on every model. No code-gen.
• Tool widgets
  • ToolCallCard — collapsible card with animated state icon, args pretty-printed as JSON, smart result preview (string / JSON / image URL), error + retry slot, compact / expanded modes.
  • ToolCallFeed — vertical feed keyed by ToolCall.id.
  • ToolRenderer.register(name, builder) extension API for custom per-tool bodies.
• Thinking widgets
  • ThinkingBubble — pulsing dot indicator, animated streaming label, auto-collapses when the step settles.
  • ReasoningTrace — collapsible numbered reasoning log.
• Citation widgets
  • CitationChip — numbered inline badge, url_launcher tap.
  • CitationCard — favicon, host, title, snippet.
  • CitationList — horizontal scrolling source strip.
• Plan / timeline widgets
  • PlanProgress — vertical stepper with state-coloured markers, nested sub-steps, optional Cancel slot.
  • AgentTimeline — chronological mix of every event kind.
• Composition layer
  • AgentView — stream-in, widgets-out, 5-line integration.
  • AgentEventBuilder — low-level builder for custom layouts.
• Theme
  • AgentKitTheme with fromColorScheme, light(), dark() constructors, per-state colours, density presets, and an AgentKitThemeScope InheritedWidget.

Quality

• 55 unit + widget tests passing.
• flutter analyze with strict casts / inference / raw-types: zero issues.
• RepaintBoundary on every card; stable widget keys per event id.
• No AI-provider SDK dependencies.