agent_kit 0.1.4

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

Changelog

0.1.4 — 2026-06-10

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.

0.1.3 — 2026-06-10

Added

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

0.1.2 — 2026-06-03

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.

0.1.1 — 2026-06-03

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.

0.1.0 — 2026-06-03

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.