diff --git a/.claude/launch.json b/.claude/launch.json
index 606ffb2..d83cc83 100644
--- a/.claude/launch.json
+++ b/.claude/launch.json
@@ -15,6 +15,15 @@
         "cd playground && flutter run -d web-server --web-port=8123"
       ],
       "port": 8123
+    },
+    {
+      "name": "stacflow-example",
+      "runtimeExecutable": "sh",
+      "runtimeArgs": [
+        "-c",
+        "cd packages/stacflow/example && flutter run -d web-server --web-port=8124"
+      ],
+      "port": 8124
     }
   ]
 }
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index fede0cc..d45c429 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -18,11 +18,11 @@
 
 ## Checklist
 
-- [ ] `flutter analyze lib` and `flutter analyze` in `example/` and `playground/` are clean
-- [ ] `dart format .` applied
+- [ ] `dart run melos run analyze` is clean
+- [ ] `dart run melos run format` applied
 - [ ] Exercised in the playground — with a stage demo added or updated if this is a new component or variant
-- [ ] Any new entry under `dependencies:` in `pubspec.yaml` is flutter.dev-published, forces no configuration on hosts that never use the feature, and is argued in this PR
+- [ ] Any new entry under `dependencies:` in `packages/flow_ui/pubspec.yaml` is flutter.dev-published, forces no configuration on hosts that never use the feature, and is argued in this PR
 - [ ] Nothing model-facing — no prompts, schemas, or provider/network calls
-- [ ] New public API is exported from `lib/flow_ui.dart` and documented in `docs/` and the README table
-- [ ] `CHANGELOG.md` updated for user-facing changes, with breaking changes called out
+- [ ] New public API is exported from `packages/flow_ui/lib/flow_ui.dart` and documented in `docs/` and the README table
+- [ ] `packages/flow_ui/CHANGELOG.md` updated for user-facing changes, with breaking changes called out
 - [ ] PR title follows conventional commits (`feat:`, `fix:`, `refactor:`, `docs:`, `chore:`)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 82f33c7..b2648eb 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -6,7 +6,6 @@ on:
   pull_request:
   workflow_dispatch:
 
-# A new push to the same ref supersedes the run already in flight.
 concurrency:
   group: ci-${{ github.ref }}
   cancel-in-progress: true
@@ -15,8 +14,8 @@ permissions:
   contents: read
 
 jobs:
-  package:
-    name: Package
+  workspace:
+    name: Workspace
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
@@ -28,60 +27,73 @@ jobs:
 
       - run: flutter pub get
 
+      - name: Example key file
+        run: cp packages/stacflow/example/lib/env.example.dart packages/stacflow/example/lib/env.dart
+
       - name: Format
         run: dart format --output=none --set-exit-if-changed .
 
-      # Scoped to lib/: from the repo root the analyzer also walks into
-      # example/ and playground/, which resolve their own dependencies and
-      # are analysed in the `apps` job instead.
       - name: Analyze
-        run: flutter analyze lib
+        run: dart run melos run analyze
 
-      # test/ is deliberately empty while the component surface is still being
-      # reshaped design-first; this runs the day the first test lands.
       - name: Test
-        run: |
-          if find test -name '*_test.dart' 2>/dev/null | grep -q .; then
-            flutter test
-          else
-            echo "No tests yet — skipping."
-          fi
-
-      # Catches packaging mistakes (a stale .pubignore, a missing asset, a
-      # broken README link) before a release tag, not after.
+        run: dart run melos run test
+
+  package:
+    name: flow_ui package
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/flow_ui
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - run: flutter pub get
+
+      - run: flutter analyze
+
       - name: Publish dry run
         run: flutter pub publish --dry-run
 
   apps:
-    name: ${{ matrix.app }}
+    name: ${{ matrix.name }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        app: [example, playground]
+        include:
+          - name: example
+            dir: packages/flow_ui/example
+          - name: stacflow example
+            dir: packages/stacflow/example
+          - name: playground
+            dir: playground
     steps:
       - uses: actions/checkout@v7
 
-      # The example reads its Gemini key from lib/env.g.dart, which is
-      # gitignored so a real key can never land in a commit — meaning a
-      # fresh checkout doesn't have it. Stub it with an empty key, the
-      # same state a fresh clone runs with (see example/README.md).
-      - name: Stub the example's key file
-        if: matrix.app == 'example'
-        run: |
-          printf '// CI stub — the real file is gitignored.\nconst String apiKey = %s;\n' "''" \
-            > example/lib/env.g.dart
-
       - uses: subosito/flutter-action@v2
         with:
           channel: stable
           cache: true
 
+      - name: Example key file
+        if: matrix.dir == 'packages/stacflow/example'
+        run: cp lib/env.example.dart lib/env.dart
+        working-directory: ${{ matrix.dir }}
+
       - run: flutter pub get
-        working-directory: ${{ matrix.app }}
+        working-directory: ${{ matrix.dir }}
 
       - run: flutter analyze
-        working-directory: ${{ matrix.app }}
+        working-directory: ${{ matrix.dir }}
+
+      - run: flutter build web --release
+        working-directory: ${{ matrix.dir }}
 
   docs:
     name: Docs site
@@ -89,8 +101,6 @@ jobs:
     steps:
       - uses: actions/checkout@v7
 
-      # `build:site` compiles the playground to wasm before Astro builds, so
-      # this job needs both toolchains.
       - uses: subosito/flutter-action@v2
         with:
           channel: stable
@@ -105,7 +115,41 @@ jobs:
       - run: npm ci
         working-directory: docs
 
-      # The same build the deploy runs: playground → public/playground, then
-      # the site. Keeps a broken playground from reaching flowui.stac.dev.
       - run: npm run build:site
         working-directory: docs
+
+  # Dependency-direction rules the analyzer cannot express. Greps anchor to
+  # import/export directives so prose in doc comments never trips them.
+  boundaries:
+    name: Boundaries
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: flow_ui never depends on the SDK package
+        run: |
+          ! grep -rnE "^\s*(import|export)\s+'package:stacflow/" packages/flow_ui/lib \
+            || { echo "::error::flow_ui is the presentation layer; the SDK depends on it, never the reverse"; exit 1; }
+          ! grep -nE "^\s*stacflow:" packages/flow_ui/pubspec.yaml \
+            || { echo "::error::flow_ui must not depend on the SDK package"; exit 1; }
+
+  contracts:
+    name: Contracts
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - run: flutter pub get
+
+      - name: Generated Dart matches contracts/
+        run: |
+          dart run tool/contracts_gen.dart
+          dart format packages/stacflow/lib/src/generated >/dev/null
+          git add -N packages/stacflow/lib/src/generated
+          git diff --exit-code -- packages/stacflow/lib/src/generated \
+            || { echo "::error::generated types are stale: run dart run tool/contracts_gen.dart && dart format packages/stacflow/lib/src/generated"; exit 1; }
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index da0b86f..ac32566 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -1,33 +1,62 @@
-# One release trigger, everything ships: pushing a version tag publishes
-# the package to pub.dev AND deploys the docs site — playground included,
-# it's built into dist/playground/ — to Cloudflare Pages.
+# One tag per package release:
 #
-#   git tag v0.2.0 && git push origin v0.2.0
+#   git tag flow_ui-v0.4.0 && git push origin flow_ui-v0.4.0
 #
-# Package authentication is OIDC — no token lives in this repo. It requires
-# automated publishing to be enabled once on pub.dev (flow_ui → Admin →
-# Automated publishing) for StacDev/flow_ui with the tag pattern
-# `v{{version}}`.
+# publishes packages/flow_ui to pub.dev and deploys the docs site (playground
+# included) to Cloudflare Pages. Publishing is OIDC: pub.dev → flow_ui → Admin
+# → Automated publishing must list StacDev/flow_ui with the tag pattern
+# `flow_ui-v{{version}}`. A future package gets its own tag glob below, a
+# `case` line in `meta`, and its own pub.dev tag pattern.
 #
-# The site deploy needs one-time repo configuration:
-#   secrets: CLOUDFLARE_API_TOKEN  (Pages:Edit permission)
-#            CLOUDFLARE_ACCOUNT_ID
-#   variable: CLOUDFLARE_PAGES_PROJECT  (the Pages project serving
-#             flowui.stac.dev)
+# Site deploy configuration: secrets CLOUDFLARE_API_TOKEN (Pages:Edit) and
+# CLOUDFLARE_ACCOUNT_ID; variable CLOUDFLARE_PAGES_PROJECT.
 name: Publish
 
 on:
   push:
-    tags: ['v[0-9]+.[0-9]+.[0-9]+*']
-  # Redeploy the site without cutting a release, e.g. after a docs fix.
+    tags:
+      - 'flow_ui-v[0-9]+.[0-9]+.[0-9]+*'
+      - 'stacflow-v[0-9]+.[0-9]+.[0-9]+*'
+  # Redeploy the site without cutting a release.
   workflow_dispatch:
 
 jobs:
-  # The quality gate: the release only ships with full pub.dev points.
-  # Comparing granted against pana's own max (160 today) keeps the gate
-  # honest if pub.dev ever raises the ceiling.
+  meta:
+    name: Resolve package from tag
+    runs-on: ubuntu-latest
+    outputs:
+      package: ${{ steps.tag.outputs.package }}
+      dir: ${{ steps.tag.outputs.dir }}
+      version: ${{ steps.tag.outputs.version }}
+    steps:
+      - uses: actions/checkout@v7
+
+      - id: tag
+        shell: bash
+        run: |
+          if [ "$GITHUB_EVENT_NAME" != push ]; then
+            printf 'package=flow_ui\ndir=packages/flow_ui\nversion=\n' >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          tag="$GITHUB_REF_NAME"
+          package="${tag%-v*}"
+          version="${tag#"$package-v"}"
+          case "$package" in
+            flow_ui) dir=packages/flow_ui ;;
+            stacflow) dir=packages/stacflow ;;
+            *) echo "::error::no package for tag $tag"; exit 1 ;;
+          esac
+          pubspec_version=$(sed -n 's/^version:[[:space:]]*//p' "$dir/pubspec.yaml" | tr -d '[:space:]')
+          if [ "$version" != "$pubspec_version" ]; then
+            echo "::error::tag says $version, $dir/pubspec.yaml says $pubspec_version"
+            exit 1
+          fi
+          printf 'package=%s\ndir=%s\nversion=%s\n' "$package" "$dir" "$version" >> "$GITHUB_OUTPUT"
+
+  # The release only ships with full pub.dev points.
   pana:
     name: Pana score gate
+    needs: meta
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
@@ -42,11 +71,11 @@ jobs:
       - name: Require a perfect score
         run: |
           dart pub global activate pana
-          dart pub global run pana --no-warning --json . > pana.json
+          dart pub global run pana --no-warning --json "${{ needs.meta.outputs.dir }}" > pana.json
           granted=$(jq -r '.scores.grantedPoints' pana.json)
           max=$(jq -r '.scores.maxPoints' pana.json)
           echo "pana: $granted / $max"
-          if [ "$granted" != "$max" ]; then
+          if [ "$granted" -lt "$max" ]; then
             echo "Points were dropped in these sections:"
             jq -r '.report.sections[]
                    | select(.grantedPoints < .maxPoints)
@@ -56,22 +85,21 @@ jobs:
           fi
 
   package:
-    # Manual dispatches redeploy the site only — pub.dev is tags-only.
     if: github.event_name == 'push'
-    needs: pana
+    needs: [meta, pana]
     permissions:
-      id-token: write # Required to mint the OIDC token pub.dev verifies.
+      id-token: write
     uses: dart-lang/setup-dart/.github/workflows/publish.yml@v1
+    with:
+      working-directory: ${{ needs.meta.outputs.dir }}
 
   site:
     name: Docs + playground
-    needs: pana
+    needs: [meta, pana]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
 
-      # `build:site` compiles the playground to wasm before Astro builds,
-      # so this job needs both toolchains — the same build CI validates.
       - uses: subosito/flutter-action@v2
         with:
           channel: stable
diff --git a/.gitignore b/.gitignore
index 1e0c933..bff98da 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,17 +16,13 @@ migrate_working_dir/
 *.iws
 .idea/
 .env
+.codex/
 
-# The .vscode folder contains launch configuration and tasks you configure in
-# VS Code which you may wish to be included in version control, so this line
-# is commented out by default.
-#.vscode/
-
-# Flutter/Dart/Pub related
-# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
-/pubspec.lock
+# Flutter/Dart/Pub related. The root pubspec.lock is committed: the
+# workspace holds apps.
 **/doc/api/
 .dart_tool/
 .flutter-plugins-dependencies
-/build/
-/coverage/
+build/
+coverage/
+pubspec_overrides.yaml
diff --git a/.pubignore b/.pubignore
deleted file mode 100644
index 385b939..0000000
--- a/.pubignore
+++ /dev/null
@@ -1,39 +0,0 @@
-# .pubignore replaces .gitignore for publishing, so it repeats the relevant
-# rules and adds the repo-only files the package archive should not carry.
-
-# From .gitignore
-*.class
-*.log
-*.pyc
-*.swp
-.DS_Store
-.atom/
-.buildlog/
-.history
-.svn/
-migrate_working_dir/
-*.iml
-*.ipr
-*.iws
-.idea/
-.env
-# Unrooted (unlike .gitignore) so example/ stays covered even when
-# publishing from outside a git checkout, where .gitignore files are not
-# consulted.
-pubspec.lock
-**/doc/api/
-.dart_tool/
-.flutter-plugins-dependencies
-build/
-/coverage/
-
-# Repo-only: the playground app, the documentation site, README screenshots
-# (pub.dev loads them from the repository), and development/agent docs
-playground/
-docs/
-doc/
-AGENTS.md
-CLAUDE.md
-.claude/
-.vscode/
-.metadata
diff --git a/.vscode/launch.json b/.vscode/launch.json
index 8edc41a..c612b35 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -12,7 +12,13 @@
         },
         {
             "name": "example",
-            "cwd": "example",
+            "cwd": "packages/flow_ui/example",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "stacflow example",
+            "cwd": "packages/stacflow/example",
             "request": "launch",
             "type": "dart"
         }
diff --git a/AGENTS.md b/AGENTS.md
index a2dc0e8..d0f7af3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,7 +4,7 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
 
 ## What this is
 
-**flow_ui** is a chat/assistant UI component library for Flutter — the presentation layer for AI assistant interfaces. It is a plain Flutter package (no codegen, no melos). Downstream packages depend on the public API exported from `lib/flow_ui.dart`, so treat it as a compatibility surface.
+**flow_ui** is a chat/assistant UI component library for Flutter — the presentation layer for AI assistant interfaces. It is a plain Flutter package (no codegen) at `packages/flow_ui/`, inside a pub workspace driven by melos. Downstream packages depend on the public API exported from `lib/flow_ui.dart`, so treat it as a compatibility surface.
 
 Two hard constraints shape everything here:
 
@@ -15,19 +15,24 @@ The theme, the conversation components (message, thread, streaming text, actions
 
 ## Layout
 
-- Package at the repo root: `lib/`, `test/`, `pubspec.yaml`.
-- `playground/` — the Flow UI Playground: a full Flutter app depending on the package via `path: ../`. Use it to demo and manually exercise components (every component has a stage demo, with variant pills and code snippets).
+- Root `pubspec.yaml` is the pub workspace (members under `workspace:`) with the melos scripts; root `analysis_options.yaml` (very_good_analysis) governs `tool/` and the SDK package only.
+- `packages/flow_ui/` — the published package: `lib/`, `example/` (the README's chat screen against Gemini), `assets/`, its own flutter_lints `analysis_options.yaml` and `.pubignore`.
+- `packages/stacflow/` — the StacFlow SDK package (see "SDK package"), with `example/` (the README's chat screen against Gemini; flutter_lints like the flow_ui example).
+- `playground/` — the Flow UI Playground: a full Flutter app and workspace member depending on `flow_ui: ^0.4.0`. Use it to demo and manually exercise components (every component has a stage demo, with variant pills and code snippets).
+- `docs/` — the Astro site behind flowui.stac.dev. `contracts/` and `tool/` — the SDK wire contract and its codegen.
 
 ## Commands
 
+**Don't write comments unless asked.** No doc comments, file headers or inline explanations in new or edited code; the code and the commit message carry the intent. The one exception is a comment a lint requires (for example `document_ignores` above an `// ignore`), kept to one line. Public API dartdoc is written only when the user asks for it.
+
 From the repo root:
 
 ```bash
-flutter test                                  # all tests
-flutter test test/some_widget_test.dart       # single file
-flutter test --plain-name "some test name"    # single test by name
-flutter analyze
-dart format .
+flutter pub get                    # resolves the whole workspace
+dart run melos run analyze         # dart analyze --fatal-infos in every member
+dart run melos run format
+dart run melos run test            # SDK package tests; flow_ui has none yet
+cd packages/flow_ui && flutter analyze && flutter pub publish --dry-run
 ```
 
 Playground app:
@@ -38,6 +43,29 @@ flutter pub get
 flutter run -d chrome    # or any device
 ```
 
+## SDK package
+
+`packages/stacflow` is the StacFlow SDK: `StacFlowChat` (the controller) and `StacFlowChatView` on flow_ui, wired to Gemini, OpenAI and Claude with the developer's own key. One entrypoint, `package:stacflow/stacflow.dart`, which also re-exports flow_ui. Layout: `src/chat` (controller, state, view, and the flow_ui-to-wire reduction in `wire_history.dart`), `src/transport` (the `TurnTransport` seam, `TurnRequest` and the wire types, ids, the SSE parser; pure Dart), `src/providers` (the interface, the shared HTTP runner, one adapter per provider; pure Dart), `src/tools` (`Tool`, the call records and `runToolLoop`, the client-side tool loop shared by the controller and the smoke script; pure Dart). Rules:
+
+- `stacflow` depends on `flow_ui`, never the reverse (CI grep).
+- Adapters emit the generated `SseEvent` union: `start` first, one `done` last, `seq` from 0. The runner in `turn_runner.dart` owns HTTP, abort, timeouts, key scrubbing and the tool-call bookkeeping (ids, argument buffering, the upgrade of `complete()` to `done{awaiting_client_tools}`); an adapter only declares `TurnRequest.tools`, maps frames, encodes the wire tool parts in history and replays its own raw content within a turn where the provider requires it (Gemini signatures and ids, Claude thinking blocks).
+- The loop in `tool_loop.dart` owns dispatch, approval, timeouts, abort and the continuation segments; the controller only renders blocks into parts, keeps `ChatState.toolCalls`, and answers confirmations. `contracts/` is unchanged by tools: provider call ids ride inside the `tc_` ids.
+- The API key is a private field set on exactly one header, and never appears in URLs, logs, `toString` or error text.
+- No tests for now. Verify with `dart analyze --fatal-infos`, the smoke script (`cd packages/stacflow && dart run --define=PROVIDER=gemini --define=GEMINI_API_KEY=... tool/smoke.dart`, also `anthropic` and `openai`; `--define=ABORT_AFTER_FIRST_DELTA=true` and `--define=IMAGE=path.png` exercise abort and image input; `--define=TOOLS=true` registers a `get_time` tool and runs the loop, with `TOOL_PERMISSION=destructive` and `DECLINE=true` for the approval paths), and the example app (`cd packages/stacflow/example && flutter run` with the key in `lib/env.dart`, copied from `lib/env.example.dart` and gitignored; the `stacflow-example` entry in `.claude/launch.json` serves it on port 8124). Keep the example the runnable form of the README quickstart, against Gemini only, with the `set_theme` tool as its one tool.
+
+`contracts/` is the wire contract (SSE events, error codes); CI regenerates the Dart from it and fails on drift. After editing anything under `contracts/`:
+
+```bash
+dart run tool/contracts_gen.dart                      # regenerates packages/stacflow/lib/src/generated
+dart format packages/stacflow/lib/src/generated
+```
+
+Never hand-edit the generated directory: the analyzer excludes it and CI regenerates it.
+
+## Releases
+
+Per-package tags: `flow_ui-v<version>` publishes `packages/flow_ui` and deploys the docs site (`.github/workflows/publish.yml`). Before tagging, bump `version:` in `packages/flow_ui/pubspec.yaml`, the `flow_ui:` constraint in `packages/flow_ui/example`, `playground` and `packages/stacflow` (pre-1.0 caret ranges), and `CHANGELOG.md`. `stacflow-v<version>` publishes `packages/stacflow` the same way; before tagging, bump `version:` in `packages/stacflow/pubspec.yaml`, the `stacflow:` constraint in `packages/stacflow/example`, and its `CHANGELOG.md`. The pana gate wants a perfect score from both packages.
+
 ## Commits
 
 Commit messages are conventional commits with a brief summary line:
diff --git a/CLAUDE.md b/CLAUDE.md
index 19940f1..ebb6e39 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## What this is
 
-**flow_ui** is a chat/assistant UI component library for Flutter — the presentation layer for AI assistant interfaces. It is a plain Flutter package (no codegen, no melos). Downstream packages depend on the public API exported from `lib/flow_ui.dart`, so treat it as a compatibility surface.
+**flow_ui** is a chat/assistant UI component library for Flutter — the presentation layer for AI assistant interfaces. It is a plain Flutter package (no codegen) at `packages/flow_ui/`, inside a pub workspace driven by melos. Downstream packages depend on the public API exported from `lib/flow_ui.dart`, so treat it as a compatibility surface.
 
 Two hard constraints shape everything here:
 
@@ -15,19 +15,26 @@ The theme, the conversation components (message, thread, streaming text, actions
 
 ## Layout
 
-- Package at the repo root: `lib/`, `test/`, `pubspec.yaml`.
-- `playground/` — the Flow UI Playground: a full Flutter app depending on the package via `path: ../`. Use it to demo and manually exercise components (every component has a stage demo, with variant pills and code snippets).
+- Root `pubspec.yaml` is the pub workspace (members under `workspace:`) with the melos scripts; root `analysis_options.yaml` (very_good_analysis) governs `tool/` and the SDK package only.
+- `packages/flow_ui/` — the published package: `lib/`, `example/` (the README's chat screen against Gemini), `assets/`, its own flutter_lints `analysis_options.yaml` and `.pubignore`.
+- `packages/stacflow/` — the StacFlow SDK package (see "SDK package"), with `example/` (the README's chat screen against Gemini; flutter_lints like the flow_ui example).
+- `playground/` — the Flow UI Playground: a full Flutter app and workspace member depending on `flow_ui: ^0.4.0`. Use it to demo and manually exercise components (every component has a stage demo, with variant pills and code snippets).
+- `docs/` — the Astro site behind flowui.stac.dev. `contracts/` and `tool/` — the SDK wire contract and its codegen.
 
 ## Commands
 
-**Don't write tests for now.** `test/` is deliberately empty — the component surface is still being reshaped design-first, so tests written now would mostly encode values about to change. Verify a change with `flutter analyze` and by exercising it in the `playground/` app, not by adding a test file. If something seems to genuinely need one, say so and let the user decide.
+**Don't write tests for now.** `packages/flow_ui` has no `test/` yet: the component surface is still being reshaped design-first, so tests written now would mostly encode values about to change. Verify a change with `flutter analyze` and by exercising it in the `playground/` app, not by adding a test file. If something seems to genuinely need one, say so and let the user decide.
+
+**Don't write comments unless asked.** No doc comments, file headers or inline explanations in new or edited code; the code and the commit message carry the intent. The one exception is a comment a lint requires (for example `document_ignores` above an `// ignore`), kept to one line. Public API dartdoc is written only when the user asks for it.
 
 From the repo root:
 
 ```bash
-flutter analyze
-dart format .
-flutter test                                  # all tests (see above — none yet)
+flutter pub get                    # resolves the whole workspace
+dart run melos run analyze         # dart analyze --fatal-infos in every member
+dart run melos run format
+dart run melos run test            # SDK package tests; flow_ui has none yet
+cd packages/flow_ui && flutter analyze && flutter pub publish --dry-run
 ```
 
 Playground app:
@@ -38,6 +45,29 @@ flutter pub get
 flutter run -d chrome    # or any device
 ```
 
+## SDK package
+
+`packages/stacflow` is the StacFlow SDK: `StacFlowChat` (the controller) and `StacFlowChatView` on flow_ui, wired to Gemini, OpenAI and Claude with the developer's own key. One entrypoint, `package:stacflow/stacflow.dart`, which also re-exports flow_ui. Layout: `src/chat` (controller, state, view, and the flow_ui-to-wire reduction in `wire_history.dart`), `src/transport` (the `TurnTransport` seam, `TurnRequest` and the wire types, ids, the SSE parser; pure Dart), `src/providers` (the interface, the shared HTTP runner, one adapter per provider; pure Dart), `src/tools` (`Tool`, the call records and `runToolLoop`, the client-side tool loop shared by the controller and the smoke script; pure Dart). Rules:
+
+- `stacflow` depends on `flow_ui`, never the reverse (CI grep).
+- Adapters emit the generated `SseEvent` union: `start` first, one `done` last, `seq` from 0. The runner in `turn_runner.dart` owns HTTP, abort, timeouts, key scrubbing and the tool-call bookkeeping (ids, argument buffering, the upgrade of `complete()` to `done{awaiting_client_tools}`); an adapter only declares `TurnRequest.tools`, maps frames, encodes the wire tool parts in history and replays its own raw content within a turn where the provider requires it (Gemini signatures and ids, Claude thinking blocks).
+- The loop in `tool_loop.dart` owns dispatch, approval, timeouts, abort and the continuation segments; the controller only renders blocks into parts, keeps `ChatState.toolCalls`, and answers confirmations. `contracts/` is unchanged by tools: provider call ids ride inside the `tc_` ids.
+- The API key is a private field set on exactly one header, and never appears in URLs, logs, `toString` or error text.
+- No tests for now. Verify with `dart analyze --fatal-infos`, the smoke script (`cd packages/stacflow && dart run --define=PROVIDER=gemini --define=GEMINI_API_KEY=... tool/smoke.dart`, also `anthropic` and `openai`; `--define=ABORT_AFTER_FIRST_DELTA=true` and `--define=IMAGE=path.png` exercise abort and image input; `--define=TOOLS=true` registers a `get_time` tool and runs the loop, with `TOOL_PERMISSION=destructive` and `DECLINE=true` for the approval paths), and the example app (`cd packages/stacflow/example && flutter run` with the key in `lib/env.dart`, copied from `lib/env.example.dart` and gitignored; the `stacflow-example` entry in `.claude/launch.json` serves it on port 8124). Keep the example the runnable form of the README quickstart, against Gemini only, with the `set_theme` tool as its one tool.
+
+`contracts/` is the wire contract (SSE events, error codes); CI regenerates the Dart from it and fails on drift. After editing anything under `contracts/`:
+
+```bash
+dart run tool/contracts_gen.dart                      # regenerates packages/stacflow/lib/src/generated
+dart format packages/stacflow/lib/src/generated
+```
+
+Never hand-edit the generated directory: the analyzer excludes it and CI regenerates it.
+
+## Releases
+
+Per-package tags: `flow_ui-v<version>` publishes `packages/flow_ui` and deploys the docs site (`.github/workflows/publish.yml`). Before tagging, bump `version:` in `packages/flow_ui/pubspec.yaml`, the `flow_ui:` constraint in `packages/flow_ui/example`, `playground` and `packages/stacflow` (pre-1.0 caret ranges), and `CHANGELOG.md`. `stacflow-v<version>` publishes `packages/stacflow` the same way; before tagging, bump `version:` in `packages/stacflow/pubspec.yaml`, the `stacflow:` constraint in `packages/stacflow/example`, and its `CHANGELOG.md`. The pana gate wants a perfect score from both packages.
+
 ## Commits
 
 Commit messages are conventional commits with a brief summary line:
diff --git a/README.md b/README.md
index 017e687..0ebc4a4 100644
--- a/README.md
+++ b/README.md
@@ -1,311 +1,37 @@
 <p align="center">
-  <img src="assets/flow_ui_logo.svg" width="76" alt="Flow UI logo">
+  <img src="packages/flow_ui/assets/flow_ui_logo.svg" width="76" alt="Flow UI logo">
 </p>
 
 <h1 align="center">flow_ui</h1>
 
-<p align="center">
-  <a href="https://pub.dev/packages/flow_ui"><img src="https://img.shields.io/pub/v/flow_ui.svg" alt="pub package"></a>
-  <a href="https://pub.dev/packages/flow_ui/score"><img src="https://img.shields.io/pub/points/flow_ui" alt="pub points"></a>
-  <a href="https://github.com/StacDev/flow_ui"><img src="https://img.shields.io/github/stars/StacDev/flow_ui?style=flat&logo=github&color=8250df" alt="github stars"></a>
-  <a href="https://github.com/StacDev/flow_ui/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license: MIT"></a>
-</p>
-
 <p align="center">
   📚 <a href="https://flowui.stac.dev/">Documentation</a>
   · 🧩 <a href="https://flowui.stac.dev/playground">Playground</a>
-  · 🤓 <a href="https://pub.dev/documentation/flow_ui/latest/">API Reference</a>
-  · 🗺️ <a href="https://flowui.stac.dev/roadmap">Roadmap</a>
+  · 📦 <a href="https://pub.dev/packages/flow_ui">pub.dev</a>
 </p>
 
 <p align="center">
-<a href="https://flowui.stac.dev/">Flow UI</a> is an open-source Flutter UI library to build production-grade Chat &amp; AI assistant interfaces.
+Flutter UI library for AI chat interfaces, and the StacFlow SDK built on it.
 </p>
 
-![The flow_ui chat surface](assets/chat_zero_light.png)
-
-> [!IMPORTANT]
-> flow_ui is pre-1.0. The API is still settling, and minor releases may
-> carry breaking changes — pin a minor version and read the
-> [changelog](CHANGELOG.md) when upgrading.
-
-## What's in the box
-
-| Component | What it does |
-|---|---|
-| [`FlowChatView`](https://flowui.stac.dev/components/chat-view) | The full chat surface: bounded thread over a composer, centred at a readable width, with a zero state (greeting, lifted composer, starters), a jump-to-latest button, and drag-and-drop with a washed invitation overlay (web) |
-| [`FlowThread`](https://flowui.stac.dev/components/message-thread) | Scrollable conversation: reads from the top, anchoring to the newest message once it outgrows the viewport; text selects across turns and copies with its line breaks |
-| [`FlowThreadList`](https://flowui.stac.dev/components/thread-list) | Conversation history for a side panel — host-labeled sections, single selection by id, unread and pinned marks |
-| [`FlowMessage`](https://flowui.stac.dev/components/message-thread) | One turn — ink-wash user bubble, plain assistant, error bubble, typed content parts |
-| [`FlowStreamingText`](https://flowui.stac.dev/components/streaming-text) | Animated text reveal while a reply arrives |
-| [`FlowThinkingIndicator`](https://flowui.stac.dev/components/thinking-indicator) | Turning, breathing asterisk with a shimmering label |
-| [`FlowShimmerText`](https://flowui.stac.dev/components/shimmer-text) | Sweeping text highlight, static once settled |
-| [`FlowCodeBlock`](https://flowui.stac.dev/components/code-block) | Fenced code with built-in synchronous highlighting, a header label, and a copy affordance — languages host-extensible |
-| [`FlowMarkdown`](https://flowui.stac.dev/components/markdown) | Assistant prose typeset from a built-in parser — headings, emphasis, lists, quotes, tables, links, and fences composing the code block; assistant turns render it by default and it streams gracefully |
-| [`FlowErrorState`](https://flowui.stac.dev/components/error-state) | Failure card with a host-written message and retry pill — failed turns render it automatically |
-| [`FlowConfirmation`](https://flowui.stac.dev/components/confirmation) | Approval card — an asterisk-marked request with approve and reject buttons that settles into the outcome; confirmation parts render it in a thread |
-| [`FlowToast`](https://flowui.stac.dev/components/toast) | Floating notice: a glyph, one wrapping line and a cross on a frosted card; `showFlowToast` floats it in the nearest Overlay, stacked and auto-dismissing, with a handle to dismiss it early |
-| [`FlowTool`](https://flowui.stac.dev/components/tool) | Tool-call card: one status mark that settles from a turning asterisk into a check or an error glyph, the call's title and primary argument, and its input and output behind a disclosure; tool parts render it in a thread |
-| [`FlowMessageActions`](https://flowui.stac.dev/components/message-actions) | Copy / regenerate / edit / feedback row under a message |
-| [`FlowComposer`](https://flowui.stac.dev/components/composer) | Multiline input with send/stop, attachments strip, the platform's file dialog (`showFlowAttachmentPicker` from your own menu, or a built-in attach button), image paste and card-scoped drop (web), and leading/trailing action slots |
-| [`FlowMenu`](https://flowui.stac.dev/components/menu) | Icon-triggered menu with groups, submenus, and toggles — anchored card on desktop, bottom sheet on phones |
-| [`FlowModelSelector`](https://flowui.stac.dev/components/model-selector) | Model picker with effort and overflow submenus, sheet on phones |
-| [`FlowPill`](https://flowui.stac.dev/components/pill) | Removable pill for an enabled tool or mode in the composer's action row — label auto-drops on phones |
-| [`FlowAttachmentGroup`](https://flowui.stac.dev/components/attachments) | Image and file tiles with a type pill |
-| [`FlowAttachmentPreview`](https://flowui.stac.dev/components/attachments) | Full-screen image viewer with zoom and paging |
-| [`FlowDropTarget`](https://flowui.stac.dev/components/chat-view) | File-drop detection for any subtree (web) — decoded attachments out, hover state for your own treatment |
-| [`FlowSuggestion`](https://flowui.stac.dev/components/suggestions) / [`FlowSuggestionGroup`](https://flowui.stac.dev/components/suggestions) | Prompt starters — plain or outlined; scroll, wrap, or column layouts |
-| [`FlowGreeting`](https://flowui.stac.dev/components/greeting) | Zero-state headline |
-| [`FlowTheme`](https://flowui.stac.dev/theming) | Design tokens (colors and typography) as a `ThemeExtension`, with light and dark presets |
-
-## Getting started
-
-```yaml
-dependencies:
-  flow_ui: ^0.3.0
-```
-
-Install the theme once (optional — without it, components fall back to a
-preset matching the ambient brightness):
+## Packages
 
-```dart
-MaterialApp(
-  theme: ThemeData(extensions: [FlowTheme.light()]),
-  darkTheme: ThemeData(
-    brightness: Brightness.dark,
-    extensions: [FlowTheme.dark()],
-  ),
-)
-```
-
-The default typography — Google Sans and Google Sans Code — arrives through
-[google_fonts](https://pub.dev/packages/google_fonts): each cut is fetched
-on first use and cached on the device, so there is no font to bundle. The
-fetch needs network access: `android.permission.INTERNET` in an Android
-app's main manifest (Flutter's template grants it only to debug and profile)
-and the `com.apple.security.network.client` entitlement in a sandboxed macOS
-app; without it text falls back to the platform face. To render offline on
-first launch, ship the files under a `google_fonts/` asset folder.
-
-## Build a chat screen
-
-Messages are pure view models. Your app maps its own transport into
-`FlowMessageData`, and streaming is data, not streams: while a reply arrives,
-rebuild with `copyWith` carrying the grown text.
-
-```dart
-class ChatPage extends StatefulWidget {
-  const ChatPage({super.key});
+This repository is a Dart pub workspace.
 
-  @override
-  State<ChatPage> createState() => _ChatPageState();
-}
+| Package | What it is | Status |
+|---|---|---|
+| [`packages/flow_ui`](packages/flow_ui) | The chat and assistant UI component library | [![pub package](https://img.shields.io/pub/v/flow_ui.svg)](https://pub.dev/packages/flow_ui) |
+| [`packages/stacflow`](packages/stacflow) | Streaming AI chat on flow_ui with Gemini, OpenAI and Claude using your own key: `StacFlowChat` and `StacFlowChatView` | Pre-release, not published |
 
-class _ChatPageState extends State<ChatPage> {
-  final ScrollController _scroll = ScrollController();
-  List<FlowMessageData> _messages = const [];
-  bool _generating = false;
-
-  void _send(String text) async {
-    final id = DateTime.now().microsecondsSinceEpoch.toString();
-    setState(() {
-      _messages = [
-        ..._messages,
-        FlowMessageData.text(id: id, role: FlowMessageRole.user, text: text),
-        // An empty pending reply renders the thinking indicator.
-        FlowMessageData(
-          id: '$id-reply',
-          role: FlowMessageRole.assistant,
-          status: FlowMessageStatus.pending,
-        ),
-      ];
-      _generating = true;
-    });
-
-    // Feed chunks from your backend as they arrive.
-    var streamed = '';
-    await for (final chunk in myBackend.reply(text)) {
-      streamed += chunk;
-      setState(() {
-        _messages = [
-          ..._messages.sublist(0, _messages.length - 1),
-          _messages.last.copyWith(
-            parts: [FlowTextPart(streamed)],
-            status: FlowMessageStatus.streaming,
-          ),
-        ];
-      });
-    }
-
-    setState(() {
-      _messages = [
-        ..._messages.sublist(0, _messages.length - 1),
-        _messages.last.copyWith(status: FlowMessageStatus.complete),
-      ];
-      _generating = false;
-    });
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      body: FlowChatView(
-        empty: _messages.isEmpty,
-        greeting: const FlowGreeting(
-          icon: Icons.wb_twilight,
-          text: 'Good afternoon',
-        ),
-        suggestions: FlowSuggestionGroup(
-          layout: FlowSuggestionLayout.column,
-          suggestions: [
-            FlowSuggestion(
-              label: 'Write an essay about life and enjoyment',
-              icon: Icons.edit_note,
-              onTap: () => _send('Write an essay about life and enjoyment'),
-            ),
-            FlowSuggestion(
-              label: 'Create a Monday briefing from my tasks',
-              icon: Icons.event_available,
-              onTap: () => _send('Create a Monday briefing from my tasks'),
-            ),
-          ],
-        ),
-        thread: FlowThread(
-          messages: _messages,
-          controller: _scroll,
-          thinkingLabel: 'Thinking…',
-        ),
-        threadController: _scroll,
-        jumpToLatestTooltip: 'Jump to latest',
-        composer: FlowComposer(
-          placeholder: 'How can I help you today?',
-          isStreaming: _generating,
-          onSend: _send,
-          onStop: myBackend.stop,
-        ),
-      ),
-    );
-  }
-}
-```
+Also here: [`playground/`](playground), every component on a stage, hosted at [flowui.stac.dev/playground](https://flowui.stac.dev/playground); [`docs/`](docs), the site; [`contracts/`](contracts), the SDK wire contract, with its codegen in [`tool/`](tool).
 
-`FlowChatView` is body-only — it builds no `Scaffold` and no app bar, so
-your app keeps the chrome, the background, and the keyboard inset. See
-[`example/lib/main.dart`](example/lib/main.dart) for a complete runnable
-version of this page, and the [live playground](https://flowui.stac.dev/playground)
-for a demo of every component with variants and code snippets.
-
-## Composer accessories
-
-The composer takes leading and trailing action slots. Drop in a `FlowMenu`
-(attachments, toggles) and a `FlowModelSelector` — both render an anchored
-card on wide layouts and a bottom sheet on phones:
-
-```dart
-FlowComposer(
-  onSend: _send,
-  leadingActions: [
-    FlowMenu(
-      icon: Icons.add,
-      tooltip: 'Add to chat',
-      entries: const [
-        FlowMenuOption(id: 'files', icon: Icons.attach_file, label: 'Add files'),
-        FlowMenuDivider(),
-        FlowMenuOption(id: 'web', icon: Icons.public, label: 'Web search', selected: true),
-      ],
-      onSelected: _handleMenu,
-    ),
-  ],
-  trailingActions: [
-    FlowModelSelector(
-      models: const [
-        FlowModelOption(id: 'fast', label: 'Fast', description: 'Quick answers'),
-        FlowModelOption(id: 'smart', label: 'Smart', description: 'Hard problems'),
-      ],
-      selectedId: _modelId,
-      onSelected: (id) => setState(() => _modelId = id),
-    ),
-  ],
-)
-```
-
-## Message content is typed parts
-
-A message holds an ordered list of sealed `FlowMessagePart`s —
-`FlowTextPart`, `FlowAttachmentPart`, and `FlowCustomPart` for anything the
-package doesn't know about. Custom parts render through a builder you supply,
-so hosts can inject arbitrary widgets (tool cards, citations, charts) without
-forking the message renderer:
-
-```dart
-FlowThread(
-  messages: _messages,
-  customPartBuilder: (context, message, part) {
-    return switch (part.type) {
-      'order-card' => OrderCard(order: part.data as Order),
-      _ => null, // unknown parts are skipped
-    };
-  },
-)
-```
-
-Attachments carry an `ImageProvider`, so network, file, memory, and asset
-images all work. Build them yourself, or let the package hand them to you
-ready-made — `showFlowAttachmentPicker` opens the platform's file dialog
-from your own menu (or the composer's built-in button does), and on the
-web the surface takes drops and the field takes pasted images:
-
-```dart
-FlowMessageData(
-  id: 'm1',
-  role: FlowMessageRole.user,
-  parts: [
-    FlowAttachmentPart([
-      FlowAttachment(id: 'a1', thumbnail: NetworkImage(url), kind: 'JPG', label: 'sunset.jpg'),
-    ]),
-    FlowTextPart('What do you think of this shot?'),
-  ],
-)
-```
-
-## Theming
-
-`FlowTheme` carries two token sets — colors and typography. Role names follow
-Material 3's `ColorScheme`, so an existing scheme maps across, with one
-addition: the design draws content at three ink levels (`onSurface`,
-`onSurfaceVariant`, `onSurfaceMuted`) where M3 names two. Start from a preset
-and override what your brand needs:
-
-```dart
-FlowTheme(
-  colors: FlowColors.dark.copyWith(primary: const Color(0xFF6C5CE7)),
-  typography: FlowTypography.standard,
-)
-```
-
-Spacing and corner radii are deliberately not tokens. Following Material's
-structure, each component bakes its own metrics from the Flow UI design file
-and exposes per-widget overrides (`padding:`, `borderRadius:`) where hosts
-retheme. Strings shown to the user (tooltips, placeholders, labels) are
-host-supplied, so localization stays in your app — the one exception, the
-model selector's `effortLabel` and `moreModelsLabel` English defaults, is
-overridable the same way.
-
-## Docs & playground
-
-Full documentation lives at [flowui.stac.dev](https://flowui.stac.dev/), and
-every component has a stage in the
-[live playground](https://flowui.stac.dev/playground) — variant pills and
-code snippets included. The playground is also
-[in the repo](https://github.com/StacDev/flow_ui/tree/main/playground) to run
-locally:
+## Development
 
 ```bash
+flutter pub get                 # resolves the whole workspace
+dart run melos run analyze
+dart run melos run test
 cd playground && flutter run -d chrome
 ```
 
-## License
-
-Code is released under the [MIT License](LICENSE). Google Sans and Google
-Sans Code are fetched from Google Fonts under the
-[SIL Open Font License](https://openfontlicense.org), not bundled.
+Package docs: [flow_ui README](packages/flow_ui/README.md). Licensed under [MIT](LICENSE).
diff --git a/analysis_options.yaml b/analysis_options.yaml
index 534f26d..376dd57 100644
--- a/analysis_options.yaml
+++ b/analysis_options.yaml
@@ -1,13 +1,15 @@
+# Governs tool/ and the stacflow package. packages/flow_ui, its example and
+# playground keep their own flutter_lints files (nearest file wins).
+include: package:very_good_analysis/analysis_options.yaml
+
 analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
   exclude:
-    - build/**
-    - android/**
-    - ios/**
-    - web/**
-    - windows/**
-    - macos/**
-    - linux/**
-include: package:flutter_lints/flutter.yaml
-
-# Additional information about this file can be found at
-# https://dart.dev/guides/language/analysis-options
+    - "**/build/**"
+    - "**/lib/src/generated/**"
+    - docs/**
+  errors:
+    public_member_api_docs: ignore
diff --git a/contracts/README.md b/contracts/README.md
new file mode 100644
index 0000000..44453a0
--- /dev/null
+++ b/contracts/README.md
@@ -0,0 +1,15 @@
+# contracts/
+
+The stacflow wire contract: the event stream a transport produces for one
+model segment, and the error codes it can carry. `tool/contracts_gen.dart`
+generates `packages/stacflow/lib/src/generated/` from these files. The
+generated directory is never hand-edited; CI regenerates it and fails on
+drift.
+
+| File | What it defines |
+|---|---|
+| `sse-events.schema.json` | The SSE streaming protocol: six events, framing rules, ordering invariants |
+| `error-codes.json` | The error-code registry with failure-class attribution |
+
+Evolution is additive: new event names, new optional fields, new error
+codes. Decoders never throw on unknown events or fields.
diff --git a/contracts/error-codes.json b/contracts/error-codes.json
new file mode 100644
index 0000000..182bdb7
--- /dev/null
+++ b/contracts/error-codes.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "description": "The additively growing error-code registry. `failure_class` says who failed; `http` is the status an HTTP transport would use; SSE error events carry the same code and class. Clients map `code` to localized strings; `message` on the wire is user-safe English.",
+  "codes": {
+    "validation_failed": { "failure_class": "gateway", "http": 422, "retryable": false, "description": "The request failed validation before it was sent." },
+    "provider_error": { "failure_class": "provider", "http": 502, "retryable": true, "description": "The model provider failed; upstream carries {provider, status, code}." },
+    "provider_rate_limited": { "failure_class": "provider", "http": 429, "retryable": true, "description": "The developer's provider key is rate-limited or out of quota upstream." },
+    "provider_auth_failed": { "failure_class": "provider", "http": 502, "retryable": false, "description": "The provider rejected the API key." },
+    "segment_timeout": { "failure_class": "timeout", "http": 504, "retryable": true, "description": "The provider stream stalled past the segment deadline." },
+    "cancelled": { "failure_class": "cancelled", "http": 499, "retryable": false, "description": "The client stopped the stream; the segment ends done{cancelled}." }
+  }
+}
diff --git a/contracts/sse-events.schema.json b/contracts/sse-events.schema.json
new file mode 100644
index 0000000..6688de3
--- /dev/null
+++ b/contracts/sse-events.schema.json
@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stacflow.ai/contracts/sse-events.schema.json",
+  "title": "StacFlow SSE protocol v1",
+  "description": "The normalized event stream a transport produces for one model segment. Framing: Content-Type text/event-stream; the SSE `event:` field carries the event name; `data:` carries exactly one JSON object on one line; the SSE `id:` field carries the decimal `seq`. `seq` is 0-based and strictly monotonic per stream with no gaps. Stream-scoped identity is stated once in `start` and never repeated. Every stream ends with exactly one `done`; a socket close without `done` is a retryable transport failure, never a protocol state. The Dart provider adapters emit this event union directly. Evolution is additive-only; decoders must ignore unknown event names and unknown fields.",
+  "x-stacflow-protocol": {
+    "version": 1,
+    "events": {
+      "start": "#/$defs/StartEvent",
+      "delta": "#/$defs/DeltaEvent",
+      "tool_call": "#/$defs/ToolCallEvent",
+      "usage": "#/$defs/UsageEvent",
+      "error": "#/$defs/ErrorEvent",
+      "done": "#/$defs/DoneEvent"
+    },
+    "ordering": [
+      "Per tool call: phase start, then zero or more phase delta, then phase end.",
+      "Assistant text may interleave BETWEEN tool calls, never inside one call's phases.",
+      "Tool calls are serialized in v1: no overlapping starts.",
+      "`error` is non-terminal by itself and is always followed by `done`.",
+      "`done` is always last and occurs exactly once."
+    ]
+  },
+  "oneOf": [
+    { "$ref": "#/$defs/StartEvent" },
+    { "$ref": "#/$defs/DeltaEvent" },
+    { "$ref": "#/$defs/ToolCallEvent" },
+    { "$ref": "#/$defs/UsageEvent" },
+    { "$ref": "#/$defs/ErrorEvent" },
+    { "$ref": "#/$defs/DoneEvent" }
+  ],
+  "$defs": {
+    "Seq": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "0-based, strictly monotonic per stream, no gaps. Mirrored in the SSE id: field."
+    },
+    "TurnId": { "type": "string", "pattern": "^trn_[A-Za-z0-9]+$" },
+    "ThreadId": { "type": "string", "pattern": "^thr_[A-Za-z0-9]+$" },
+    "MessageId": { "type": "string", "pattern": "^msg_[A-Za-z0-9]+$" },
+    "ToolCallId": { "type": "string", "pattern": "^tc_[A-Za-z0-9]+$" },
+    "AgentVersionId": { "type": "string", "pattern": "^agv_[A-Za-z0-9]+$" },
+    "FailureClass": {
+      "type": "string",
+      "enum": ["provider", "developer_api", "gateway", "policy", "timeout", "cancelled"],
+      "description": "The wire-level attribution enum (D18), shared by SSE error events, tool_results entries, and analytics."
+    },
+    "Upstream": {
+      "type": "object",
+      "description": "Structured upstream attribution: which provider/backend actually failed, regardless of the observed HTTP status.",
+      "properties": {
+        "provider": { "type": "string" },
+        "status": { "type": "integer" },
+        "code": { "type": "string" }
+      },
+      "additionalProperties": true
+    },
+    "StartEvent": {
+      "type": "object",
+      "description": "First event of every stream (seq 0). Declares stream-scoped identity once. `segment` is the 0-based continuation index within the turn; `message_id` is the assistant message being built, stable across all segments of the turn.",
+      "properties": {
+        "seq": { "$ref": "#/$defs/Seq" },
+        "protocol": { "const": 1 },
+        "turn_id": { "$ref": "#/$defs/TurnId" },
+        "segment": { "type": "integer", "minimum": 0 },
+        "message_id": { "$ref": "#/$defs/MessageId" },
+        "thread_id": { "$ref": "#/$defs/ThreadId" },
+        "model": { "type": "string" },
+        "agent_version_id": { "$ref": "#/$defs/AgentVersionId" }
+      },
+      "required": ["seq", "protocol", "turn_id", "segment", "message_id", "thread_id", "model", "agent_version_id"],
+      "additionalProperties": true
+    },
+    "DeltaEvent": {
+      "type": "object",
+      "description": "Assistant text delta.",
+      "properties": {
+        "seq": { "$ref": "#/$defs/Seq" },
+        "text": { "type": "string" }
+      },
+      "required": ["seq", "text"],
+      "additionalProperties": true
+    },
+    "ToolCallEvent": {
+      "type": "object",
+      "description": "One tool call, streamed in three phases. `args` at phase end is complete canonical JSON and is authoritative over concatenated deltas. `permission_class` comes from the registered tool so the SDK can stage the confirmation card before the arguments finish streaming. `executor` is \"client\" in v1 (\"server\" reserved).",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "seq": { "$ref": "#/$defs/Seq" },
+            "phase": { "const": "start" },
+            "tool_call_id": { "$ref": "#/$defs/ToolCallId" },
+            "tool_name": { "type": "string" },
+            "executor": { "type": "string", "enum": ["client", "server"] },
+            "permission_class": { "type": "string", "enum": ["read", "write", "destructive"] }
+          },
+          "required": ["seq", "phase", "tool_call_id", "tool_name", "executor", "permission_class"],
+          "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "seq": { "$ref": "#/$defs/Seq" },
+            "phase": { "const": "delta" },
+            "tool_call_id": { "$ref": "#/$defs/ToolCallId" },
+            "args_delta": { "type": "string", "description": "Raw JSON fragment; enables progressive argument rendering. Consumers may ignore deltas entirely." }
+          },
+          "required": ["seq", "phase", "tool_call_id", "args_delta"],
+          "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "seq": { "$ref": "#/$defs/Seq" },
+            "phase": { "const": "end" },
+            "tool_call_id": { "$ref": "#/$defs/ToolCallId" },
+            "args": { "type": "object", "additionalProperties": true }
+          },
+          "required": ["seq", "phase", "tool_call_id", "args"],
+          "additionalProperties": true
+        }
+      ]
+    },
+    "UsageEvent": {
+      "type": "object",
+      "description": "One per provider call; additive across a stream.",
+      "properties": {
+        "seq": { "$ref": "#/$defs/Seq" },
+        "provider_call": { "type": "integer", "minimum": 0 },
+        "model": { "type": "string" },
+        "input_tokens": { "type": "integer", "minimum": 0 },
+        "output_tokens": { "type": "integer", "minimum": 0 }
+      },
+      "required": ["seq", "provider_call", "model", "input_tokens", "output_tokens"],
+      "additionalProperties": true
+    },
+    "ErrorEvent": {
+      "type": "object",
+      "description": "Non-terminal by itself; always followed by done. `code` comes from error-codes.json (additively growing); `message` is user-safe English — clients map `code` to localized strings.",
+      "properties": {
+        "seq": { "$ref": "#/$defs/Seq" },
+        "failure_class": { "$ref": "#/$defs/FailureClass" },
+        "code": { "type": "string" },
+        "message": { "type": "string" },
+        "retryable": { "type": "boolean" },
+        "upstream": { "$ref": "#/$defs/Upstream" }
+      },
+      "required": ["seq", "failure_class", "code", "message", "retryable"],
+      "additionalProperties": true
+    },
+    "DoneEvent": {
+      "type": "object",
+      "description": "Always last, exactly once. `awaiting_client_tools` ends the segment pending client execution; the turn continues via a tool_results POST.",
+      "properties": {
+        "seq": { "$ref": "#/$defs/Seq" },
+        "status": { "type": "string", "enum": ["complete", "awaiting_client_tools", "error", "cancelled"] },
+        "turn_id": { "$ref": "#/$defs/TurnId" },
+        "pending_tool_call_ids": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ToolCallId" },
+          "minItems": 1
+        }
+      },
+      "required": ["seq", "status", "turn_id"],
+      "if": { "properties": { "status": { "const": "awaiting_client_tools" } } },
+      "then": { "required": ["seq", "status", "turn_id", "pending_tool_call_ids"] },
+      "additionalProperties": true
+    }
+  }
+}
diff --git a/docs/README.md b/docs/README.md
index ed869b1..a0d29e0 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -12,7 +12,7 @@ npm run build    # static site in dist/
 Google Sans loads from Google Fonts via the `<link>` in `astro.config.mjs` —
 the same source the package fetches from at runtime. Brand colors in
 `src/styles/theme.css` mirror the package's design tokens in
-`lib/src/theme/flow_colors.dart`.
+`packages/flow_ui/lib/src/theme/flow_colors.dart`.
 
 `npm run playground` builds the repo's `playground/` Flutter app for the
 web into `public/playground/` — served at `/playground/<component>` (path
diff --git a/docs/src/content/docs/getting-started.mdx b/docs/src/content/docs/getting-started.mdx
index f32c335..a3ef287 100644
--- a/docs/src/content/docs/getting-started.mdx
+++ b/docs/src/content/docs/getting-started.mdx
@@ -20,7 +20,7 @@ One line in your pubspec:
 
 ```yaml title="pubspec.yaml"
 dependencies:
-  flow_ui: ^0.3.0
+  flow_ui: ^0.4.0
 ```
 
 That brings in the Flutter SDK, `material_ui`, `file_selector` — the
@@ -94,9 +94,10 @@ snippets included. It is also in the repo to run locally:
 cd playground && flutter run -d chrome
 ```
 
-For a minimal starting point, the repo's `example/` is the full chat screen
-from the README as a single-file app: generate platform runners once with
-`flutter create . --platforms=web`, then `flutter run -d chrome`.
+For a minimal starting point, the repo's `packages/flow_ui/example/` is the
+full chat screen from the README as a single-file app, platform runners
+checked in: `cd packages/flow_ui/example`, then
+`flutter run -d chrome --dart-define=GEMINI_API_KEY=...`.
 
 ## Next
 
diff --git a/example/pubspec.lock b/example/pubspec.lock
deleted file mode 100644
index 2a60bc3..0000000
--- a/example/pubspec.lock
+++ /dev/null
@@ -1,542 +0,0 @@
-# Generated by pub
-# See https://dart.dev/tools/pub/glossary#lockfile
-packages:
-  args:
-    dependency: transitive
-    description:
-      name: args
-      sha256: d0481093c50b1da8910eb0bb301626d4d8eb7284aa739614d2b394ee09e3ea04
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.7.0"
-  async:
-    dependency: transitive
-    description:
-      name: async
-      sha256: e2eb0491ba5ddb6177742d2da23904574082139b07c1e33b8503b9f46f3e1a37
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.13.1"
-  boolean_selector:
-    dependency: transitive
-    description:
-      name: boolean_selector
-      sha256: "8aab1771e1243a5063b8b0ff68042d67334e3feab9e95b9490f9a6ebf73b42ea"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.1.2"
-  characters:
-    dependency: transitive
-    description:
-      name: characters
-      sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.4.1"
-  clock:
-    dependency: transitive
-    description:
-      name: clock
-      sha256: fddb70d9b5277016c77a80201021d40a2247104d9f4aa7bab7157b7e3f05b84b
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.1.2"
-  code_assets:
-    dependency: transitive
-    description:
-      name: code_assets
-      sha256: bf394f466ba9205f1812a0433b392d6af280f155f56651eda7c18cc32ed493b8
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.2.1"
-  collection:
-    dependency: transitive
-    description:
-      name: collection
-      sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.19.1"
-  cross_file:
-    dependency: transitive
-    description:
-      name: cross_file
-      sha256: f141ea4f277af142a0356955707f6556f37b03947d39d55585981a06ca437bd6
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.3.5+5"
-  crypto:
-    dependency: transitive
-    description:
-      name: crypto
-      sha256: c8ea0233063ba03258fbcf2ca4d6dadfefe14f02fab57702265467a19f27fadf
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.0.7"
-  cupertino_ui:
-    dependency: transitive
-    description:
-      name: cupertino_ui
-      sha256: "7ed8ce4159d342eec4c65f4ea6eec57adaf9365404378541f38efc1da20a5b3d"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.0.0"
-  fake_async:
-    dependency: transitive
-    description:
-      name: fake_async
-      sha256: "5368f224a74523e8d2e7399ea1638b37aecfca824a3cc4dfdf77bf1fa905ac44"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.3.3"
-  ffi:
-    dependency: transitive
-    description:
-      name: ffi
-      sha256: "6d7fd89431262d8f3125e81b50d3847a091d846eafcd4fdb88dd06f36d705a45"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.2.0"
-  file_selector:
-    dependency: transitive
-    description:
-      name: file_selector
-      sha256: bd15e43e9268db636b53eeaca9f56324d1622af30e5c34d6e267649758c84d9a
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.1.0"
-  file_selector_android:
-    dependency: transitive
-    description:
-      name: file_selector_android
-      sha256: "1d45e9910f68c16eb0c74f0b10097ad81aed516ea28054c027137e8f7d75e840"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.5.2+9"
-  file_selector_ios:
-    dependency: transitive
-    description:
-      name: file_selector_ios
-      sha256: e2ecf2885c121691ce13b60db3508f53c01f869fb6e8dc5c1cfa771e4c46aeca
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.5.3+5"
-  file_selector_linux:
-    dependency: transitive
-    description:
-      name: file_selector_linux
-      sha256: "2567f398e06ac72dcf2e98a0c95df2a9edd03c2c2e0cacd4780f20cdf56263a0"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.9.4"
-  file_selector_macos:
-    dependency: transitive
-    description:
-      name: file_selector_macos
-      sha256: "5e0bbe9c312416f1787a68259ea1505b52f258c587f12920422671807c4d618a"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.9.5"
-  file_selector_platform_interface:
-    dependency: transitive
-    description:
-      name: file_selector_platform_interface
-      sha256: "35e0bd61ebcdb91a3505813b055b09b79dfdc7d0aee9c09a7ba59ae4bb13dc85"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.7.0"
-  file_selector_web:
-    dependency: transitive
-    description:
-      name: file_selector_web
-      sha256: "73181fbc5257776d8ecaa6a94ab3c8e920ad143b9132a6d984a9271dfc6928d3"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.9.5"
-  file_selector_windows:
-    dependency: transitive
-    description:
-      name: file_selector_windows
-      sha256: "62197474ae75893a62df75939c777763d39c2bc5f73ce5b88497208bc269abfd"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.9.3+5"
-  flow_ui:
-    dependency: "direct main"
-    description:
-      path: ".."
-      relative: true
-    source: path
-    version: "0.2.0"
-  flutter:
-    dependency: "direct main"
-    description: flutter
-    source: sdk
-    version: "0.0.0"
-  flutter_lints:
-    dependency: "direct dev"
-    description:
-      name: flutter_lints
-      sha256: "3105dc8492f6183fb076ccf1f351ac3d60564bff92e20bfc4af9cc1651f4e7e1"
-      url: "https://pub.dev"
-    source: hosted
-    version: "6.0.0"
-  flutter_localizations:
-    dependency: transitive
-    description: flutter
-    source: sdk
-    version: "0.0.0"
-  flutter_test:
-    dependency: "direct dev"
-    description: flutter
-    source: sdk
-    version: "0.0.0"
-  flutter_web_plugins:
-    dependency: transitive
-    description: flutter
-    source: sdk
-    version: "0.0.0"
-  google_fonts:
-    dependency: transitive
-    description:
-      name: google_fonts
-      sha256: e3cb3ee6b47fd2472c23de6da5744796a4da195137759ddb3fbcc9467b7b3c7d
-      url: "https://pub.dev"
-    source: hosted
-    version: "8.2.1"
-  hooks:
-    dependency: transitive
-    description:
-      name: hooks
-      sha256: "9a62a50b50b769a737bc0a8ff381f333529df3ab746b2f6b02e83760231455ba"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.0.2"
-  http:
-    dependency: "direct main"
-    description:
-      name: http
-      sha256: "87721a4a50b19c7f1d49001e51409bddc46303966ce89a65af4f4e6004896412"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.6.0"
-  http_parser:
-    dependency: transitive
-    description:
-      name: http_parser
-      sha256: "178d74305e7866013777bab2c3d8726205dc5a4dd935297175b19a23a2e66571"
-      url: "https://pub.dev"
-    source: hosted
-    version: "4.1.2"
-  intl:
-    dependency: transitive
-    description:
-      name: intl
-      sha256: "1ca20c894b1717686a2319b8548763d812bc0aabdac580420a44c5178c57a867"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.20.3"
-  jni:
-    dependency: transitive
-    description:
-      name: jni
-      sha256: f038e58b4dc2c9037f50e233175086337e0b305e356d28211bf55f21c504cbd3
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.0.3"
-  jni_flutter:
-    dependency: transitive
-    description:
-      name: jni_flutter
-      sha256: "7b717011ea40d04fd47c2731d3d1d36eb99eba3435c2753d62489e8c3c9991d5"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.0.2"
-  jni_util:
-    dependency: transitive
-    description:
-      name: jni_util
-      sha256: "1ba86da04a5f2bf18fde2edb235587e70c5b0fc5bd4ba955f46b00942c3fc35f"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.0.0"
-  leak_tracker:
-    dependency: transitive
-    description:
-      name: leak_tracker
-      sha256: "33e2e26bdd85a0112ec15400c8cbffea70d0f9c3407491f672a2fad47915e2de"
-      url: "https://pub.dev"
-    source: hosted
-    version: "11.0.2"
-  leak_tracker_flutter_testing:
-    dependency: transitive
-    description:
-      name: leak_tracker_flutter_testing
-      sha256: "1dbc140bb5a23c75ea9c4811222756104fbcd1a27173f0c34ca01e16bea473c1"
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.0.10"
-  leak_tracker_testing:
-    dependency: transitive
-    description:
-      name: leak_tracker_testing
-      sha256: "8d5a2d49f4a66b49744b23b018848400d23e54caf9463f4eb20df3eb8acb2eb1"
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.0.2"
-  lints:
-    dependency: transitive
-    description:
-      name: lints
-      sha256: "12f842a479589fea194fe5c5a3095abc7be0c1f2ddfa9a0e76aed1dbd26a87df"
-      url: "https://pub.dev"
-    source: hosted
-    version: "6.1.0"
-  logging:
-    dependency: transitive
-    description:
-      name: logging
-      sha256: c8245ada5f1717ed44271ed1c26b8ce85ca3228fd2ffdb75468ab01979309d61
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.3.0"
-  matcher:
-    dependency: transitive
-    description:
-      name: matcher
-      sha256: "31bd099b47c10cd1aeb55146a2d46ce0277630ecef3f7dae54ad7873f36696cd"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.12.20"
-  material_color_utilities:
-    dependency: transitive
-    description:
-      name: material_color_utilities
-      sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.13.0"
-  material_ui:
-    dependency: "direct main"
-    description:
-      name: material_ui
-      sha256: "4f3f38b9953df0a87d6bf5f21880029f77c47048487d5339410c39936be4683b"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.0.1"
-  meta:
-    dependency: transitive
-    description:
-      name: meta
-      sha256: "307249ce4ff29d58a18e97f6345f539382eb9c9c29ecda628900f31de0443dd9"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.19.0"
-  objective_c:
-    dependency: transitive
-    description:
-      name: objective_c
-      sha256: b7fb95a6d9a4f009edd63dc5ac69f07420b23a16161c6dd8660290b59c602e8e
-      url: "https://pub.dev"
-    source: hosted
-    version: "9.5.0"
-  package_config:
-    dependency: transitive
-    description:
-      name: package_config
-      sha256: ffcf4cf3d6c0b74ac43708d9f56625506e8a68aa935abe9d267a7330f320eb5d
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.0.0"
-  path:
-    dependency: transitive
-    description:
-      name: path
-      sha256: "75cca69d1490965be98c73ceaea117e8a04dd21217b37b292c9ddbec0d955bc5"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.9.1"
-  path_provider:
-    dependency: transitive
-    description:
-      name: path_provider
-      sha256: a7f4874f987173da295a61c181b8ee71dab59b332a486b391babf26a1b884825
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.1.6"
-  path_provider_android:
-    dependency: transitive
-    description:
-      name: path_provider_android
-      sha256: "69cbd515a62b94d32a7944f086b2f82b4ac40a1d45bebfc00813a430ab2dabcd"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.3.1"
-  path_provider_foundation:
-    dependency: transitive
-    description:
-      name: path_provider_foundation
-      sha256: "2a376b7d6392d80cd3705782d2caa734ca4727776db0b6ec36ef3f1855197699"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.6.0"
-  path_provider_linux:
-    dependency: transitive
-    description:
-      name: path_provider_linux
-      sha256: "58c2005f147315b11e9b4a7bc889cd5203e250cba8e3f012dae259b4972b5c16"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.2.2"
-  path_provider_platform_interface:
-    dependency: transitive
-    description:
-      name: path_provider_platform_interface
-      sha256: "484838772624c3a4b94f1e44a3e19897fee738f2d5c4ce448443b0417f7c9dda"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.1.3"
-  path_provider_windows:
-    dependency: transitive
-    description:
-      name: path_provider_windows
-      sha256: bd6f00dbd873bfb70d0761682da2b3a2c2fccc2b9e84c495821639601d81afe7
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.3.0"
-  platform:
-    dependency: transitive
-    description:
-      name: platform
-      sha256: "5d6b1b0036a5f331ebc77c850ebc8506cbc1e9416c27e59b439f917a902a4984"
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.1.6"
-  plugin_platform_interface:
-    dependency: transitive
-    description:
-      name: plugin_platform_interface
-      sha256: "4820fbfdb9478b1ebae27888254d445073732dae3d6ea81f0b7e06d5dedc3f02"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.1.8"
-  pub_semver:
-    dependency: transitive
-    description:
-      name: pub_semver
-      sha256: "5bfcf68ca79ef689f8990d1160781b4bad40a3bd5e5218ad4076ddb7f4081585"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.2.0"
-  record_use:
-    dependency: transitive
-    description:
-      name: record_use
-      sha256: "2551bd8eecfe95d14ae75f6021ad0248be5c27f138c2ec12fcb52b500b3ba1ed"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.6.0"
-  sky_engine:
-    dependency: transitive
-    description: flutter
-    source: sdk
-    version: "0.0.0"
-  source_span:
-    dependency: transitive
-    description:
-      name: source_span
-      sha256: "56a02f1f4cd1a2d96303c0144c93bd6d909eea6bee6bf5a0e0b685edbd4c47ab"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.10.2"
-  stack_trace:
-    dependency: transitive
-    description:
-      name: stack_trace
-      sha256: "8b27215b45d22309b5cddda1aa2b19bdfec9df0e765f2de506401c071d38d1b1"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.12.1"
-  stream_channel:
-    dependency: transitive
-    description:
-      name: stream_channel
-      sha256: "969e04c80b8bcdf826f8f16579c7b14d780458bd97f56d107d3950fdbeef059d"
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.1.4"
-  string_scanner:
-    dependency: transitive
-    description:
-      name: string_scanner
-      sha256: "921cd31725b72fe181906c6a94d987c78e3b98c2e205b397ea399d4054872b43"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.4.1"
-  term_glyph:
-    dependency: transitive
-    description:
-      name: term_glyph
-      sha256: "7f554798625ea768a7518313e58f83891c7f5024f88e46e7182a4558850a4b8e"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.2.2"
-  test_api:
-    dependency: transitive
-    description:
-      name: test_api
-      sha256: "2a122cbe059f8b610d3a5415f42e255b6c17b1f21eee1d960f31080237fb4f11"
-      url: "https://pub.dev"
-    source: hosted
-    version: "0.7.12"
-  typed_data:
-    dependency: transitive
-    description:
-      name: typed_data
-      sha256: f9049c039ebfeb4cf7a7104a675823cd72dba8297f264b6637062516699fa006
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.4.0"
-  vector_math:
-    dependency: transitive
-    description:
-      name: vector_math
-      sha256: f36f9f3be64c6198714492bb455c11056e33e2f85d9a0b676a48301e44fdcf47
-      url: "https://pub.dev"
-    source: hosted
-    version: "2.4.2"
-  vm_service:
-    dependency: transitive
-    description:
-      name: vm_service
-      sha256: "5f37239c4851efcef929cea7824e76df7f2f0970aef85d66bbc430afa40e72f0"
-      url: "https://pub.dev"
-    source: hosted
-    version: "15.3.0"
-  web:
-    dependency: transitive
-    description:
-      name: web
-      sha256: "868d88a33d8a87b18ffc05f9f030ba328ffefba92d6c127917a2ba740f9cfe4a"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.1.1"
-  xdg_directories:
-    dependency: transitive
-    description:
-      name: xdg_directories
-      sha256: "7a3f37b05d989967cdddcbb571f1ea834867ae2faa29725fd085180e0883aa15"
-      url: "https://pub.dev"
-    source: hosted
-    version: "1.1.0"
-  yaml:
-    dependency: transitive
-    description:
-      name: yaml
-      sha256: b9da305ac7c39faa3f030eccd175340f968459dae4af175130b3fc47e40d76ce
-      url: "https://pub.dev"
-    source: hosted
-    version: "3.1.3"
-sdks:
-  dart: ">=3.12.2 <4.0.0"
-  flutter: ">=3.44.0"
diff --git a/.metadata b/packages/flow_ui/.metadata
similarity index 100%
rename from .metadata
rename to packages/flow_ui/.metadata
diff --git a/packages/flow_ui/.pubignore b/packages/flow_ui/.pubignore
new file mode 100644
index 0000000..a70b1b1
--- /dev/null
+++ b/packages/flow_ui/.pubignore
@@ -0,0 +1,25 @@
+# Replaces .gitignore for publishing. Unrooted so example/ stays covered when
+# publishing from outside a git checkout.
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+*.iml
+*.ipr
+*.iws
+.idea/
+.env
+.metadata
+pubspec.lock
+**/doc/api/
+.dart_tool/
+.flutter-plugins-dependencies
+build/
+coverage/
+doc/
diff --git a/CHANGELOG.md b/packages/flow_ui/CHANGELOG.md
similarity index 100%
rename from CHANGELOG.md
rename to packages/flow_ui/CHANGELOG.md
diff --git a/packages/flow_ui/LICENSE b/packages/flow_ui/LICENSE
new file mode 100644
index 0000000..ee6ff7f
--- /dev/null
+++ b/packages/flow_ui/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stac
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/packages/flow_ui/README.md b/packages/flow_ui/README.md
new file mode 100644
index 0000000..78dcce7
--- /dev/null
+++ b/packages/flow_ui/README.md
@@ -0,0 +1,311 @@
+<p align="center">
+  <img src="assets/flow_ui_logo.svg" width="76" alt="Flow UI logo">
+</p>
+
+<h1 align="center">flow_ui</h1>
+
+<p align="center">
+  <a href="https://pub.dev/packages/flow_ui"><img src="https://img.shields.io/pub/v/flow_ui.svg" alt="pub package"></a>
+  <a href="https://pub.dev/packages/flow_ui/score"><img src="https://img.shields.io/pub/points/flow_ui" alt="pub points"></a>
+  <a href="https://github.com/StacDev/flow_ui"><img src="https://img.shields.io/github/stars/StacDev/flow_ui?style=flat&logo=github&color=8250df" alt="github stars"></a>
+  <a href="https://github.com/StacDev/flow_ui/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license: MIT"></a>
+</p>
+
+<p align="center">
+  📚 <a href="https://flowui.stac.dev/">Documentation</a>
+  · 🧩 <a href="https://flowui.stac.dev/playground">Playground</a>
+  · 🤓 <a href="https://pub.dev/documentation/flow_ui/latest/">API Reference</a>
+  · 🗺️ <a href="https://flowui.stac.dev/roadmap">Roadmap</a>
+</p>
+
+<p align="center">
+<a href="https://flowui.stac.dev/">Flow UI</a> is an open-source Flutter UI library to build production-grade Chat &amp; AI assistant interfaces.
+</p>
+
+![The flow_ui chat surface](assets/chat_zero_light.png)
+
+> [!IMPORTANT]
+> flow_ui is pre-1.0. The API is still settling, and minor releases may
+> carry breaking changes — pin a minor version and read the
+> [changelog](CHANGELOG.md) when upgrading.
+
+## What's in the box
+
+| Component | What it does |
+|---|---|
+| [`FlowChatView`](https://flowui.stac.dev/components/chat-view) | The full chat surface: bounded thread over a composer, centred at a readable width, with a zero state (greeting, lifted composer, starters), a jump-to-latest button, and drag-and-drop with a washed invitation overlay (web) |
+| [`FlowThread`](https://flowui.stac.dev/components/message-thread) | Scrollable conversation: reads from the top, anchoring to the newest message once it outgrows the viewport; text selects across turns and copies with its line breaks |
+| [`FlowThreadList`](https://flowui.stac.dev/components/thread-list) | Conversation history for a side panel — host-labeled sections, single selection by id, unread and pinned marks |
+| [`FlowMessage`](https://flowui.stac.dev/components/message-thread) | One turn — ink-wash user bubble, plain assistant, error bubble, typed content parts |
+| [`FlowStreamingText`](https://flowui.stac.dev/components/streaming-text) | Animated text reveal while a reply arrives |
+| [`FlowThinkingIndicator`](https://flowui.stac.dev/components/thinking-indicator) | Turning, breathing asterisk with a shimmering label |
+| [`FlowShimmerText`](https://flowui.stac.dev/components/shimmer-text) | Sweeping text highlight, static once settled |
+| [`FlowCodeBlock`](https://flowui.stac.dev/components/code-block) | Fenced code with built-in synchronous highlighting, a header label, and a copy affordance — languages host-extensible |
+| [`FlowMarkdown`](https://flowui.stac.dev/components/markdown) | Assistant prose typeset from a built-in parser — headings, emphasis, lists, quotes, tables, links, and fences composing the code block; assistant turns render it by default and it streams gracefully |
+| [`FlowErrorState`](https://flowui.stac.dev/components/error-state) | Failure card with a host-written message and retry pill — failed turns render it automatically |
+| [`FlowConfirmation`](https://flowui.stac.dev/components/confirmation) | Approval card — an asterisk-marked request with approve and reject buttons that settles into the outcome; confirmation parts render it in a thread |
+| [`FlowToast`](https://flowui.stac.dev/components/toast) | Floating notice: a glyph, one wrapping line and a cross on a frosted card; `showFlowToast` floats it in the nearest Overlay, stacked and auto-dismissing, with a handle to dismiss it early |
+| [`FlowTool`](https://flowui.stac.dev/components/tool) | Tool-call card: one status mark that settles from a turning asterisk into a check or an error glyph, the call's title and primary argument, and its input and output behind a disclosure; tool parts render it in a thread |
+| [`FlowMessageActions`](https://flowui.stac.dev/components/message-actions) | Copy / regenerate / edit / feedback row under a message |
+| [`FlowComposer`](https://flowui.stac.dev/components/composer) | Multiline input with send/stop, attachments strip, the platform's file dialog (`showFlowAttachmentPicker` from your own menu, or a built-in attach button), image paste and card-scoped drop (web), and leading/trailing action slots |
+| [`FlowMenu`](https://flowui.stac.dev/components/menu) | Icon-triggered menu with groups, submenus, and toggles — anchored card on desktop, bottom sheet on phones |
+| [`FlowModelSelector`](https://flowui.stac.dev/components/model-selector) | Model picker with effort and overflow submenus, sheet on phones |
+| [`FlowPill`](https://flowui.stac.dev/components/pill) | Removable pill for an enabled tool or mode in the composer's action row — label auto-drops on phones |
+| [`FlowAttachmentGroup`](https://flowui.stac.dev/components/attachments) | Image and file tiles with a type pill |
+| [`FlowAttachmentPreview`](https://flowui.stac.dev/components/attachments) | Full-screen image viewer with zoom and paging |
+| [`FlowDropTarget`](https://flowui.stac.dev/components/chat-view) | File-drop detection for any subtree (web) — decoded attachments out, hover state for your own treatment |
+| [`FlowSuggestion`](https://flowui.stac.dev/components/suggestions) / [`FlowSuggestionGroup`](https://flowui.stac.dev/components/suggestions) | Prompt starters — plain or outlined; scroll, wrap, or column layouts |
+| [`FlowGreeting`](https://flowui.stac.dev/components/greeting) | Zero-state headline |
+| [`FlowTheme`](https://flowui.stac.dev/theming) | Design tokens (colors and typography) as a `ThemeExtension`, with light and dark presets |
+
+## Getting started
+
+```yaml
+dependencies:
+  flow_ui: ^0.4.0
+```
+
+Install the theme once (optional — without it, components fall back to a
+preset matching the ambient brightness):
+
+```dart
+MaterialApp(
+  theme: ThemeData(extensions: [FlowTheme.light()]),
+  darkTheme: ThemeData(
+    brightness: Brightness.dark,
+    extensions: [FlowTheme.dark()],
+  ),
+)
+```
+
+The default typography — Google Sans and Google Sans Code — arrives through
+[google_fonts](https://pub.dev/packages/google_fonts): each cut is fetched
+on first use and cached on the device, so there is no font to bundle. The
+fetch needs network access: `android.permission.INTERNET` in an Android
+app's main manifest (Flutter's template grants it only to debug and profile)
+and the `com.apple.security.network.client` entitlement in a sandboxed macOS
+app; without it text falls back to the platform face. To render offline on
+first launch, ship the files under a `google_fonts/` asset folder.
+
+## Build a chat screen
+
+Messages are pure view models. Your app maps its own transport into
+`FlowMessageData`, and streaming is data, not streams: while a reply arrives,
+rebuild with `copyWith` carrying the grown text.
+
+```dart
+class ChatPage extends StatefulWidget {
+  const ChatPage({super.key});
+
+  @override
+  State<ChatPage> createState() => _ChatPageState();
+}
+
+class _ChatPageState extends State<ChatPage> {
+  final ScrollController _scroll = ScrollController();
+  List<FlowMessageData> _messages = const [];
+  bool _generating = false;
+
+  void _send(String text) async {
+    final id = DateTime.now().microsecondsSinceEpoch.toString();
+    setState(() {
+      _messages = [
+        ..._messages,
+        FlowMessageData.text(id: id, role: FlowMessageRole.user, text: text),
+        // An empty pending reply renders the thinking indicator.
+        FlowMessageData(
+          id: '$id-reply',
+          role: FlowMessageRole.assistant,
+          status: FlowMessageStatus.pending,
+        ),
+      ];
+      _generating = true;
+    });
+
+    // Feed chunks from your backend as they arrive.
+    var streamed = '';
+    await for (final chunk in myBackend.reply(text)) {
+      streamed += chunk;
+      setState(() {
+        _messages = [
+          ..._messages.sublist(0, _messages.length - 1),
+          _messages.last.copyWith(
+            parts: [FlowTextPart(streamed)],
+            status: FlowMessageStatus.streaming,
+          ),
+        ];
+      });
+    }
+
+    setState(() {
+      _messages = [
+        ..._messages.sublist(0, _messages.length - 1),
+        _messages.last.copyWith(status: FlowMessageStatus.complete),
+      ];
+      _generating = false;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      body: FlowChatView(
+        empty: _messages.isEmpty,
+        greeting: const FlowGreeting(
+          icon: Icons.wb_twilight,
+          text: 'Good afternoon',
+        ),
+        suggestions: FlowSuggestionGroup(
+          layout: FlowSuggestionLayout.column,
+          suggestions: [
+            FlowSuggestion(
+              label: 'Write an essay about life and enjoyment',
+              icon: Icons.edit_note,
+              onTap: () => _send('Write an essay about life and enjoyment'),
+            ),
+            FlowSuggestion(
+              label: 'Create a Monday briefing from my tasks',
+              icon: Icons.event_available,
+              onTap: () => _send('Create a Monday briefing from my tasks'),
+            ),
+          ],
+        ),
+        thread: FlowThread(
+          messages: _messages,
+          controller: _scroll,
+          thinkingLabel: 'Thinking…',
+        ),
+        threadController: _scroll,
+        jumpToLatestTooltip: 'Jump to latest',
+        composer: FlowComposer(
+          placeholder: 'How can I help you today?',
+          isStreaming: _generating,
+          onSend: _send,
+          onStop: myBackend.stop,
+        ),
+      ),
+    );
+  }
+}
+```
+
+`FlowChatView` is body-only — it builds no `Scaffold` and no app bar, so
+your app keeps the chrome, the background, and the keyboard inset. See
+[`example/lib/main.dart`](example/lib/main.dart) for a complete runnable
+version of this page, and the [live playground](https://flowui.stac.dev/playground)
+for a demo of every component with variants and code snippets.
+
+## Composer accessories
+
+The composer takes leading and trailing action slots. Drop in a `FlowMenu`
+(attachments, toggles) and a `FlowModelSelector` — both render an anchored
+card on wide layouts and a bottom sheet on phones:
+
+```dart
+FlowComposer(
+  onSend: _send,
+  leadingActions: [
+    FlowMenu(
+      icon: Icons.add,
+      tooltip: 'Add to chat',
+      entries: const [
+        FlowMenuOption(id: 'files', icon: Icons.attach_file, label: 'Add files'),
+        FlowMenuDivider(),
+        FlowMenuOption(id: 'web', icon: Icons.public, label: 'Web search', selected: true),
+      ],
+      onSelected: _handleMenu,
+    ),
+  ],
+  trailingActions: [
+    FlowModelSelector(
+      models: const [
+        FlowModelOption(id: 'fast', label: 'Fast', description: 'Quick answers'),
+        FlowModelOption(id: 'smart', label: 'Smart', description: 'Hard problems'),
+      ],
+      selectedId: _modelId,
+      onSelected: (id) => setState(() => _modelId = id),
+    ),
+  ],
+)
+```
+
+## Message content is typed parts
+
+A message holds an ordered list of sealed `FlowMessagePart`s —
+`FlowTextPart`, `FlowAttachmentPart`, and `FlowCustomPart` for anything the
+package doesn't know about. Custom parts render through a builder you supply,
+so hosts can inject arbitrary widgets (tool cards, citations, charts) without
+forking the message renderer:
+
+```dart
+FlowThread(
+  messages: _messages,
+  customPartBuilder: (context, message, part) {
+    return switch (part.type) {
+      'order-card' => OrderCard(order: part.data as Order),
+      _ => null, // unknown parts are skipped
+    };
+  },
+)
+```
+
+Attachments carry an `ImageProvider`, so network, file, memory, and asset
+images all work. Build them yourself, or let the package hand them to you
+ready-made — `showFlowAttachmentPicker` opens the platform's file dialog
+from your own menu (or the composer's built-in button does), and on the
+web the surface takes drops and the field takes pasted images:
+
+```dart
+FlowMessageData(
+  id: 'm1',
+  role: FlowMessageRole.user,
+  parts: [
+    FlowAttachmentPart([
+      FlowAttachment(id: 'a1', thumbnail: NetworkImage(url), kind: 'JPG', label: 'sunset.jpg'),
+    ]),
+    FlowTextPart('What do you think of this shot?'),
+  ],
+)
+```
+
+## Theming
+
+`FlowTheme` carries two token sets — colors and typography. Role names follow
+Material 3's `ColorScheme`, so an existing scheme maps across, with one
+addition: the design draws content at three ink levels (`onSurface`,
+`onSurfaceVariant`, `onSurfaceMuted`) where M3 names two. Start from a preset
+and override what your brand needs:
+
+```dart
+FlowTheme(
+  colors: FlowColors.dark.copyWith(primary: const Color(0xFF6C5CE7)),
+  typography: FlowTypography.standard,
+)
+```
+
+Spacing and corner radii are deliberately not tokens. Following Material's
+structure, each component bakes its own metrics from the Flow UI design file
+and exposes per-widget overrides (`padding:`, `borderRadius:`) where hosts
+retheme. Strings shown to the user (tooltips, placeholders, labels) are
+host-supplied, so localization stays in your app — the one exception, the
+model selector's `effortLabel` and `moreModelsLabel` English defaults, is
+overridable the same way.
+
+## Docs & playground
+
+Full documentation lives at [flowui.stac.dev](https://flowui.stac.dev/), and
+every component has a stage in the
+[live playground](https://flowui.stac.dev/playground) — variant pills and
+code snippets included. The playground is also
+[in the repo](https://github.com/StacDev/flow_ui/tree/main/playground) to run
+locally:
+
+```bash
+cd playground && flutter run -d chrome
+```
+
+## License
+
+Code is released under the [MIT License](LICENSE). Google Sans and Google
+Sans Code are fetched from Google Fonts under the
+[SIL Open Font License](https://openfontlicense.org), not bundled.
diff --git a/packages/flow_ui/analysis_options.yaml b/packages/flow_ui/analysis_options.yaml
new file mode 100644
index 0000000..534f26d
--- /dev/null
+++ b/packages/flow_ui/analysis_options.yaml
@@ -0,0 +1,13 @@
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options
diff --git a/assets/chat_zero_light.png b/packages/flow_ui/assets/chat_zero_light.png
similarity index 100%
rename from assets/chat_zero_light.png
rename to packages/flow_ui/assets/chat_zero_light.png
diff --git a/assets/flow_ui_logo.svg b/packages/flow_ui/assets/flow_ui_logo.svg
similarity index 100%
rename from assets/flow_ui_logo.svg
rename to packages/flow_ui/assets/flow_ui_logo.svg
diff --git a/example/.gitignore b/packages/flow_ui/example/.gitignore
similarity index 89%
rename from example/.gitignore
rename to packages/flow_ui/example/.gitignore
index bc3656c..c7d1b41 100644
--- a/example/.gitignore
+++ b/packages/flow_ui/example/.gitignore
@@ -23,8 +23,8 @@ migrate_working_dir/
 # is commented out by default.
 #.vscode/
 
-# Your Gemini API key lives here — created by hand, never committed.
-lib/env.g.dart
+# Your Gemini API key, for --dart-define-from-file. Never committed.
+env.json
 
 # Flutter/Dart/Pub related
 **/doc/api/
diff --git a/example/.metadata b/packages/flow_ui/example/.metadata
similarity index 100%
rename from example/.metadata
rename to packages/flow_ui/example/.metadata
diff --git a/example/README.md b/packages/flow_ui/example/README.md
similarity index 58%
rename from example/README.md
rename to packages/flow_ui/example/README.md
index c518c5e..b8dc394 100644
--- a/example/README.md
+++ b/packages/flow_ui/example/README.md
@@ -8,18 +8,22 @@ the selector, ask for a picture, and it comes back through
 `FlowImagePart`, shimmering until the bytes land. flow_ui renders the
 state; `gemini_api.dart` is the host-side transport it never sees.
 
-Set up a key once — grab one from [Google AI Studio](https://aistudio.google.com/apikey)
-and create `lib/env.g.dart` with it (the file is gitignored, so your key
-stays on your machine):
+Grab a key from [Google AI Studio](https://aistudio.google.com/apikey) and
+pass it at launch. Platform runners are checked in, so it runs directly:
 
-```dart
-const String apiKey = 'AIza...';
+```bash
+flutter run --dart-define=GEMINI_API_KEY=AIza...
 ```
 
-Platform runners are checked in, so it launches directly:
+Or keep the key in a gitignored `env.json` next to this README and pass the
+file instead:
+
+```json
+{ "GEMINI_API_KEY": "AIza..." }
+```
 
 ```bash
-flutter run
+flutter run --dart-define-from-file=env.json
 ```
 
 With an empty key the app still runs — sending just answers with the
@@ -30,5 +34,9 @@ the hosted [playground](https://flowui.stac.dev/playground), or run it from
 [the repo](https://github.com/StacDev/flow_ui/tree/main/playground):
 
 ```bash
-cd ../playground && flutter run -d chrome
+cd playground && flutter run -d chrome   # from the repo root
 ```
+
+The example resolves through the repo's pub workspace (`resolution: workspace`
+in its pubspec). To use it outside the repo, delete that line and depend on
+`flow_ui` from pub.dev.
diff --git a/example/analysis_options.yaml b/packages/flow_ui/example/analysis_options.yaml
similarity index 100%
rename from example/analysis_options.yaml
rename to packages/flow_ui/example/analysis_options.yaml
diff --git a/example/android/.gitignore b/packages/flow_ui/example/android/.gitignore
similarity index 100%
rename from example/android/.gitignore
rename to packages/flow_ui/example/android/.gitignore
diff --git a/example/android/app/build.gradle.kts b/packages/flow_ui/example/android/app/build.gradle.kts
similarity index 100%
rename from example/android/app/build.gradle.kts
rename to packages/flow_ui/example/android/app/build.gradle.kts
diff --git a/example/android/app/src/debug/AndroidManifest.xml b/packages/flow_ui/example/android/app/src/debug/AndroidManifest.xml
similarity index 100%
rename from example/android/app/src/debug/AndroidManifest.xml
rename to packages/flow_ui/example/android/app/src/debug/AndroidManifest.xml
diff --git a/example/android/app/src/main/AndroidManifest.xml b/packages/flow_ui/example/android/app/src/main/AndroidManifest.xml
similarity index 100%
rename from example/android/app/src/main/AndroidManifest.xml
rename to packages/flow_ui/example/android/app/src/main/AndroidManifest.xml
diff --git a/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt b/packages/flow_ui/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt
similarity index 100%
rename from example/android/app/src/main/kotlin/com/example/example/MainActivity.kt
rename to packages/flow_ui/example/android/app/src/main/kotlin/com/example/example/MainActivity.kt
diff --git a/example/android/app/src/main/res/drawable-v21/launch_background.xml b/packages/flow_ui/example/android/app/src/main/res/drawable-v21/launch_background.xml
similarity index 100%
rename from example/android/app/src/main/res/drawable-v21/launch_background.xml
rename to packages/flow_ui/example/android/app/src/main/res/drawable-v21/launch_background.xml
diff --git a/example/android/app/src/main/res/drawable/launch_background.xml b/packages/flow_ui/example/android/app/src/main/res/drawable/launch_background.xml
similarity index 100%
rename from example/android/app/src/main/res/drawable/launch_background.xml
rename to packages/flow_ui/example/android/app/src/main/res/drawable/launch_background.xml
diff --git a/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/packages/flow_ui/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png
similarity index 100%
rename from example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png
rename to packages/flow_ui/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png
diff --git a/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/packages/flow_ui/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png
similarity index 100%
rename from example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png
rename to packages/flow_ui/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png
diff --git a/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png b/packages/flow_ui/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png
similarity index 100%
rename from example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png
rename to packages/flow_ui/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png
diff --git a/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/packages/flow_ui/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
similarity index 100%
rename from example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
rename to packages/flow_ui/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
diff --git a/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/packages/flow_ui/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
similarity index 100%
rename from example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
rename to packages/flow_ui/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
diff --git a/example/android/app/src/main/res/values-night/styles.xml b/packages/flow_ui/example/android/app/src/main/res/values-night/styles.xml
similarity index 100%
rename from example/android/app/src/main/res/values-night/styles.xml
rename to packages/flow_ui/example/android/app/src/main/res/values-night/styles.xml
diff --git a/example/android/app/src/main/res/values/styles.xml b/packages/flow_ui/example/android/app/src/main/res/values/styles.xml
similarity index 100%
rename from example/android/app/src/main/res/values/styles.xml
rename to packages/flow_ui/example/android/app/src/main/res/values/styles.xml
diff --git a/example/android/app/src/profile/AndroidManifest.xml b/packages/flow_ui/example/android/app/src/profile/AndroidManifest.xml
similarity index 100%
rename from example/android/app/src/profile/AndroidManifest.xml
rename to packages/flow_ui/example/android/app/src/profile/AndroidManifest.xml
diff --git a/example/android/build.gradle.kts b/packages/flow_ui/example/android/build.gradle.kts
similarity index 100%
rename from example/android/build.gradle.kts
rename to packages/flow_ui/example/android/build.gradle.kts
diff --git a/example/android/gradle.properties b/packages/flow_ui/example/android/gradle.properties
similarity index 100%
rename from example/android/gradle.properties
rename to packages/flow_ui/example/android/gradle.properties
diff --git a/example/android/gradle/wrapper/gradle-wrapper.properties b/packages/flow_ui/example/android/gradle/wrapper/gradle-wrapper.properties
similarity index 100%
rename from example/android/gradle/wrapper/gradle-wrapper.properties
rename to packages/flow_ui/example/android/gradle/wrapper/gradle-wrapper.properties
diff --git a/example/android/settings.gradle.kts b/packages/flow_ui/example/android/settings.gradle.kts
similarity index 100%
rename from example/android/settings.gradle.kts
rename to packages/flow_ui/example/android/settings.gradle.kts
diff --git a/example/ios/.gitignore b/packages/flow_ui/example/ios/.gitignore
similarity index 100%
rename from example/ios/.gitignore
rename to packages/flow_ui/example/ios/.gitignore
diff --git a/example/ios/Flutter/AppFrameworkInfo.plist b/packages/flow_ui/example/ios/Flutter/AppFrameworkInfo.plist
similarity index 100%
rename from example/ios/Flutter/AppFrameworkInfo.plist
rename to packages/flow_ui/example/ios/Flutter/AppFrameworkInfo.plist
diff --git a/example/ios/Flutter/Debug.xcconfig b/packages/flow_ui/example/ios/Flutter/Debug.xcconfig
similarity index 100%
rename from example/ios/Flutter/Debug.xcconfig
rename to packages/flow_ui/example/ios/Flutter/Debug.xcconfig
diff --git a/example/ios/Flutter/Release.xcconfig b/packages/flow_ui/example/ios/Flutter/Release.xcconfig
similarity index 100%
rename from example/ios/Flutter/Release.xcconfig
rename to packages/flow_ui/example/ios/Flutter/Release.xcconfig
diff --git a/example/ios/Runner.xcodeproj/project.pbxproj b/packages/flow_ui/example/ios/Runner.xcodeproj/project.pbxproj
similarity index 100%
rename from example/ios/Runner.xcodeproj/project.pbxproj
rename to packages/flow_ui/example/ios/Runner.xcodeproj/project.pbxproj
diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata
similarity index 100%
rename from example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata
rename to packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata
diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
similarity index 100%
rename from example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
rename to packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
similarity index 100%
rename from example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
rename to packages/flow_ui/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
diff --git a/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/flow_ui/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
similarity index 100%
rename from example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
rename to packages/flow_ui/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
diff --git a/example/ios/Runner.xcworkspace/contents.xcworkspacedata b/packages/flow_ui/example/ios/Runner.xcworkspace/contents.xcworkspacedata
similarity index 100%
rename from example/ios/Runner.xcworkspace/contents.xcworkspacedata
rename to packages/flow_ui/example/ios/Runner.xcworkspace/contents.xcworkspacedata
diff --git a/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/flow_ui/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
similarity index 100%
rename from example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
rename to packages/flow_ui/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
diff --git a/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/flow_ui/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
similarity index 100%
rename from example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
rename to packages/flow_ui/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
diff --git a/example/ios/Runner/AppDelegate.swift b/packages/flow_ui/example/ios/Runner/AppDelegate.swift
similarity index 100%
rename from example/ios/Runner/AppDelegate.swift
rename to packages/flow_ui/example/ios/Runner/AppDelegate.swift
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json
diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png
diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png
diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png
diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md
similarity index 100%
rename from example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md
rename to packages/flow_ui/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md
diff --git a/example/ios/Runner/Base.lproj/LaunchScreen.storyboard b/packages/flow_ui/example/ios/Runner/Base.lproj/LaunchScreen.storyboard
similarity index 100%
rename from example/ios/Runner/Base.lproj/LaunchScreen.storyboard
rename to packages/flow_ui/example/ios/Runner/Base.lproj/LaunchScreen.storyboard
diff --git a/example/ios/Runner/Base.lproj/Main.storyboard b/packages/flow_ui/example/ios/Runner/Base.lproj/Main.storyboard
similarity index 100%
rename from example/ios/Runner/Base.lproj/Main.storyboard
rename to packages/flow_ui/example/ios/Runner/Base.lproj/Main.storyboard
diff --git a/example/ios/Runner/Info.plist b/packages/flow_ui/example/ios/Runner/Info.plist
similarity index 100%
rename from example/ios/Runner/Info.plist
rename to packages/flow_ui/example/ios/Runner/Info.plist
diff --git a/example/ios/Runner/Runner-Bridging-Header.h b/packages/flow_ui/example/ios/Runner/Runner-Bridging-Header.h
similarity index 100%
rename from example/ios/Runner/Runner-Bridging-Header.h
rename to packages/flow_ui/example/ios/Runner/Runner-Bridging-Header.h
diff --git a/example/ios/Runner/SceneDelegate.swift b/packages/flow_ui/example/ios/Runner/SceneDelegate.swift
similarity index 100%
rename from example/ios/Runner/SceneDelegate.swift
rename to packages/flow_ui/example/ios/Runner/SceneDelegate.swift
diff --git a/example/ios/RunnerTests/RunnerTests.swift b/packages/flow_ui/example/ios/RunnerTests/RunnerTests.swift
similarity index 100%
rename from example/ios/RunnerTests/RunnerTests.swift
rename to packages/flow_ui/example/ios/RunnerTests/RunnerTests.swift
diff --git a/packages/flow_ui/example/lib/env.dart b/packages/flow_ui/example/lib/env.dart
new file mode 100644
index 0000000..df9648b
--- /dev/null
+++ b/packages/flow_ui/example/lib/env.dart
@@ -0,0 +1,5 @@
+/// The Gemini key, passed at launch so it never lands in a commit:
+///   flutter run --dart-define=GEMINI_API_KEY=AIza...
+/// or from a gitignored file: flutter run --dart-define-from-file=env.json
+/// Empty when neither is given: the app runs and sending shows the error card.
+const String apiKey = String.fromEnvironment('GEMINI_API_KEY');
diff --git a/example/lib/gemini_api.dart b/packages/flow_ui/example/lib/gemini_api.dart
similarity index 98%
rename from example/lib/gemini_api.dart
rename to packages/flow_ui/example/lib/gemini_api.dart
index b09c4fd..b6e0817 100644
--- a/example/lib/gemini_api.dart
+++ b/packages/flow_ui/example/lib/gemini_api.dart
@@ -65,8 +65,8 @@ class GeminiApi {
   Stream<GeminiDelta> streamReply(List<FlowMessageData> history) async* {
     if (apiKey.isEmpty) {
       throw GeminiApiException(
-        'No API key. Paste yours into example/lib/env.g.dart — grab one '
-        'from Google AI Studio.',
+        'No API key. Pass one with --dart-define=GEMINI_API_KEY=... '
+        '(see example/README.md).',
       );
     }
 
diff --git a/example/lib/main.dart b/packages/flow_ui/example/lib/main.dart
similarity index 99%
rename from example/lib/main.dart
rename to packages/flow_ui/example/lib/main.dart
index 47e340c..e507399 100644
--- a/example/lib/main.dart
+++ b/packages/flow_ui/example/lib/main.dart
@@ -4,8 +4,8 @@ import 'package:flow_ui/flow_ui.dart';
 import 'package:flutter/services.dart';
 import 'package:material_ui/material_ui.dart';
 
-// The API key lives in env.g.dart — paste yours there.
-import 'env.g.dart';
+// The API key arrives through --dart-define (see env.dart).
+import 'env.dart';
 import 'gemini_api.dart';
 
 void main() {
diff --git a/example/linux/.gitignore b/packages/flow_ui/example/linux/.gitignore
similarity index 100%
rename from example/linux/.gitignore
rename to packages/flow_ui/example/linux/.gitignore
diff --git a/example/linux/CMakeLists.txt b/packages/flow_ui/example/linux/CMakeLists.txt
similarity index 100%
rename from example/linux/CMakeLists.txt
rename to packages/flow_ui/example/linux/CMakeLists.txt
diff --git a/example/linux/flutter/CMakeLists.txt b/packages/flow_ui/example/linux/flutter/CMakeLists.txt
similarity index 100%
rename from example/linux/flutter/CMakeLists.txt
rename to packages/flow_ui/example/linux/flutter/CMakeLists.txt
diff --git a/example/linux/flutter/generated_plugin_registrant.cc b/packages/flow_ui/example/linux/flutter/generated_plugin_registrant.cc
similarity index 100%
rename from example/linux/flutter/generated_plugin_registrant.cc
rename to packages/flow_ui/example/linux/flutter/generated_plugin_registrant.cc
diff --git a/example/linux/flutter/generated_plugin_registrant.h b/packages/flow_ui/example/linux/flutter/generated_plugin_registrant.h
similarity index 100%
rename from example/linux/flutter/generated_plugin_registrant.h
rename to packages/flow_ui/example/linux/flutter/generated_plugin_registrant.h
diff --git a/example/linux/flutter/generated_plugins.cmake b/packages/flow_ui/example/linux/flutter/generated_plugins.cmake
similarity index 100%
rename from example/linux/flutter/generated_plugins.cmake
rename to packages/flow_ui/example/linux/flutter/generated_plugins.cmake
diff --git a/example/linux/runner/CMakeLists.txt b/packages/flow_ui/example/linux/runner/CMakeLists.txt
similarity index 100%
rename from example/linux/runner/CMakeLists.txt
rename to packages/flow_ui/example/linux/runner/CMakeLists.txt
diff --git a/example/linux/runner/main.cc b/packages/flow_ui/example/linux/runner/main.cc
similarity index 100%
rename from example/linux/runner/main.cc
rename to packages/flow_ui/example/linux/runner/main.cc
diff --git a/example/linux/runner/my_application.cc b/packages/flow_ui/example/linux/runner/my_application.cc
similarity index 100%
rename from example/linux/runner/my_application.cc
rename to packages/flow_ui/example/linux/runner/my_application.cc
diff --git a/example/linux/runner/my_application.h b/packages/flow_ui/example/linux/runner/my_application.h
similarity index 100%
rename from example/linux/runner/my_application.h
rename to packages/flow_ui/example/linux/runner/my_application.h
diff --git a/example/macos/.gitignore b/packages/flow_ui/example/macos/.gitignore
similarity index 100%
rename from example/macos/.gitignore
rename to packages/flow_ui/example/macos/.gitignore
diff --git a/example/macos/Flutter/Flutter-Debug.xcconfig b/packages/flow_ui/example/macos/Flutter/Flutter-Debug.xcconfig
similarity index 100%
rename from example/macos/Flutter/Flutter-Debug.xcconfig
rename to packages/flow_ui/example/macos/Flutter/Flutter-Debug.xcconfig
diff --git a/example/macos/Flutter/Flutter-Release.xcconfig b/packages/flow_ui/example/macos/Flutter/Flutter-Release.xcconfig
similarity index 100%
rename from example/macos/Flutter/Flutter-Release.xcconfig
rename to packages/flow_ui/example/macos/Flutter/Flutter-Release.xcconfig
diff --git a/example/macos/Flutter/GeneratedPluginRegistrant.swift b/packages/flow_ui/example/macos/Flutter/GeneratedPluginRegistrant.swift
similarity index 100%
rename from example/macos/Flutter/GeneratedPluginRegistrant.swift
rename to packages/flow_ui/example/macos/Flutter/GeneratedPluginRegistrant.swift
diff --git a/example/macos/Runner.xcodeproj/project.pbxproj b/packages/flow_ui/example/macos/Runner.xcodeproj/project.pbxproj
similarity index 100%
rename from example/macos/Runner.xcodeproj/project.pbxproj
rename to packages/flow_ui/example/macos/Runner.xcodeproj/project.pbxproj
diff --git a/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/flow_ui/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
similarity index 100%
rename from example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
rename to packages/flow_ui/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
diff --git a/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/flow_ui/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
similarity index 100%
rename from example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
rename to packages/flow_ui/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
diff --git a/example/macos/Runner.xcworkspace/contents.xcworkspacedata b/packages/flow_ui/example/macos/Runner.xcworkspace/contents.xcworkspacedata
similarity index 100%
rename from example/macos/Runner.xcworkspace/contents.xcworkspacedata
rename to packages/flow_ui/example/macos/Runner.xcworkspace/contents.xcworkspacedata
diff --git a/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/flow_ui/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
similarity index 100%
rename from example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
rename to packages/flow_ui/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
diff --git a/example/macos/Runner/AppDelegate.swift b/packages/flow_ui/example/macos/Runner/AppDelegate.swift
similarity index 100%
rename from example/macos/Runner/AppDelegate.swift
rename to packages/flow_ui/example/macos/Runner/AppDelegate.swift
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png
diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png b/packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png
similarity index 100%
rename from example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png
rename to packages/flow_ui/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png
diff --git a/example/macos/Runner/Base.lproj/MainMenu.xib b/packages/flow_ui/example/macos/Runner/Base.lproj/MainMenu.xib
similarity index 100%
rename from example/macos/Runner/Base.lproj/MainMenu.xib
rename to packages/flow_ui/example/macos/Runner/Base.lproj/MainMenu.xib
diff --git a/example/macos/Runner/Configs/AppInfo.xcconfig b/packages/flow_ui/example/macos/Runner/Configs/AppInfo.xcconfig
similarity index 100%
rename from example/macos/Runner/Configs/AppInfo.xcconfig
rename to packages/flow_ui/example/macos/Runner/Configs/AppInfo.xcconfig
diff --git a/example/macos/Runner/Configs/Debug.xcconfig b/packages/flow_ui/example/macos/Runner/Configs/Debug.xcconfig
similarity index 100%
rename from example/macos/Runner/Configs/Debug.xcconfig
rename to packages/flow_ui/example/macos/Runner/Configs/Debug.xcconfig
diff --git a/example/macos/Runner/Configs/Release.xcconfig b/packages/flow_ui/example/macos/Runner/Configs/Release.xcconfig
similarity index 100%
rename from example/macos/Runner/Configs/Release.xcconfig
rename to packages/flow_ui/example/macos/Runner/Configs/Release.xcconfig
diff --git a/example/macos/Runner/Configs/Warnings.xcconfig b/packages/flow_ui/example/macos/Runner/Configs/Warnings.xcconfig
similarity index 100%
rename from example/macos/Runner/Configs/Warnings.xcconfig
rename to packages/flow_ui/example/macos/Runner/Configs/Warnings.xcconfig
diff --git a/example/macos/Runner/DebugProfile.entitlements b/packages/flow_ui/example/macos/Runner/DebugProfile.entitlements
similarity index 100%
rename from example/macos/Runner/DebugProfile.entitlements
rename to packages/flow_ui/example/macos/Runner/DebugProfile.entitlements
diff --git a/example/macos/Runner/Info.plist b/packages/flow_ui/example/macos/Runner/Info.plist
similarity index 100%
rename from example/macos/Runner/Info.plist
rename to packages/flow_ui/example/macos/Runner/Info.plist
diff --git a/example/macos/Runner/MainFlutterWindow.swift b/packages/flow_ui/example/macos/Runner/MainFlutterWindow.swift
similarity index 100%
rename from example/macos/Runner/MainFlutterWindow.swift
rename to packages/flow_ui/example/macos/Runner/MainFlutterWindow.swift
diff --git a/example/macos/Runner/Release.entitlements b/packages/flow_ui/example/macos/Runner/Release.entitlements
similarity index 100%
rename from example/macos/Runner/Release.entitlements
rename to packages/flow_ui/example/macos/Runner/Release.entitlements
diff --git a/example/macos/RunnerTests/RunnerTests.swift b/packages/flow_ui/example/macos/RunnerTests/RunnerTests.swift
similarity index 100%
rename from example/macos/RunnerTests/RunnerTests.swift
rename to packages/flow_ui/example/macos/RunnerTests/RunnerTests.swift
diff --git a/example/pubspec.yaml b/packages/flow_ui/example/pubspec.yaml
similarity index 89%
rename from example/pubspec.yaml
rename to packages/flow_ui/example/pubspec.yaml
index d1599eb..9dae1e0 100644
--- a/example/pubspec.yaml
+++ b/packages/flow_ui/example/pubspec.yaml
@@ -7,12 +7,13 @@ environment:
   sdk: ^3.12.2
   flutter: ">=3.44.0"
 
+resolution: workspace
+
 dependencies:
   flutter:
     sdk: flutter
 
-  flow_ui:
-    path: ../
+  flow_ui: ^0.4.0
   material_ui: ^1.0.1
   http: ^1.2.0
 
diff --git a/example/web/favicon.png b/packages/flow_ui/example/web/favicon.png
similarity index 100%
rename from example/web/favicon.png
rename to packages/flow_ui/example/web/favicon.png
diff --git a/example/web/icons/Icon-192.png b/packages/flow_ui/example/web/icons/Icon-192.png
similarity index 100%
rename from example/web/icons/Icon-192.png
rename to packages/flow_ui/example/web/icons/Icon-192.png
diff --git a/example/web/icons/Icon-512.png b/packages/flow_ui/example/web/icons/Icon-512.png
similarity index 100%
rename from example/web/icons/Icon-512.png
rename to packages/flow_ui/example/web/icons/Icon-512.png
diff --git a/example/web/icons/Icon-maskable-192.png b/packages/flow_ui/example/web/icons/Icon-maskable-192.png
similarity index 100%
rename from example/web/icons/Icon-maskable-192.png
rename to packages/flow_ui/example/web/icons/Icon-maskable-192.png
diff --git a/example/web/icons/Icon-maskable-512.png b/packages/flow_ui/example/web/icons/Icon-maskable-512.png
similarity index 100%
rename from example/web/icons/Icon-maskable-512.png
rename to packages/flow_ui/example/web/icons/Icon-maskable-512.png
diff --git a/example/web/index.html b/packages/flow_ui/example/web/index.html
similarity index 100%
rename from example/web/index.html
rename to packages/flow_ui/example/web/index.html
diff --git a/example/web/manifest.json b/packages/flow_ui/example/web/manifest.json
similarity index 100%
rename from example/web/manifest.json
rename to packages/flow_ui/example/web/manifest.json
diff --git a/example/windows/.gitignore b/packages/flow_ui/example/windows/.gitignore
similarity index 100%
rename from example/windows/.gitignore
rename to packages/flow_ui/example/windows/.gitignore
diff --git a/example/windows/CMakeLists.txt b/packages/flow_ui/example/windows/CMakeLists.txt
similarity index 100%
rename from example/windows/CMakeLists.txt
rename to packages/flow_ui/example/windows/CMakeLists.txt
diff --git a/example/windows/flutter/CMakeLists.txt b/packages/flow_ui/example/windows/flutter/CMakeLists.txt
similarity index 100%
rename from example/windows/flutter/CMakeLists.txt
rename to packages/flow_ui/example/windows/flutter/CMakeLists.txt
diff --git a/example/windows/flutter/generated_plugin_registrant.cc b/packages/flow_ui/example/windows/flutter/generated_plugin_registrant.cc
similarity index 100%
rename from example/windows/flutter/generated_plugin_registrant.cc
rename to packages/flow_ui/example/windows/flutter/generated_plugin_registrant.cc
diff --git a/example/windows/flutter/generated_plugin_registrant.h b/packages/flow_ui/example/windows/flutter/generated_plugin_registrant.h
similarity index 100%
rename from example/windows/flutter/generated_plugin_registrant.h
rename to packages/flow_ui/example/windows/flutter/generated_plugin_registrant.h
diff --git a/example/windows/flutter/generated_plugins.cmake b/packages/flow_ui/example/windows/flutter/generated_plugins.cmake
similarity index 100%
rename from example/windows/flutter/generated_plugins.cmake
rename to packages/flow_ui/example/windows/flutter/generated_plugins.cmake
diff --git a/example/windows/runner/CMakeLists.txt b/packages/flow_ui/example/windows/runner/CMakeLists.txt
similarity index 100%
rename from example/windows/runner/CMakeLists.txt
rename to packages/flow_ui/example/windows/runner/CMakeLists.txt
diff --git a/example/windows/runner/Runner.rc b/packages/flow_ui/example/windows/runner/Runner.rc
similarity index 100%
rename from example/windows/runner/Runner.rc
rename to packages/flow_ui/example/windows/runner/Runner.rc
diff --git a/example/windows/runner/flutter_window.cpp b/packages/flow_ui/example/windows/runner/flutter_window.cpp
similarity index 100%
rename from example/windows/runner/flutter_window.cpp
rename to packages/flow_ui/example/windows/runner/flutter_window.cpp
diff --git a/example/windows/runner/flutter_window.h b/packages/flow_ui/example/windows/runner/flutter_window.h
similarity index 100%
rename from example/windows/runner/flutter_window.h
rename to packages/flow_ui/example/windows/runner/flutter_window.h
diff --git a/example/windows/runner/main.cpp b/packages/flow_ui/example/windows/runner/main.cpp
similarity index 100%
rename from example/windows/runner/main.cpp
rename to packages/flow_ui/example/windows/runner/main.cpp
diff --git a/example/windows/runner/resource.h b/packages/flow_ui/example/windows/runner/resource.h
similarity index 100%
rename from example/windows/runner/resource.h
rename to packages/flow_ui/example/windows/runner/resource.h
diff --git a/example/windows/runner/resources/app_icon.ico b/packages/flow_ui/example/windows/runner/resources/app_icon.ico
similarity index 100%
rename from example/windows/runner/resources/app_icon.ico
rename to packages/flow_ui/example/windows/runner/resources/app_icon.ico
diff --git a/example/windows/runner/runner.exe.manifest b/packages/flow_ui/example/windows/runner/runner.exe.manifest
similarity index 100%
rename from example/windows/runner/runner.exe.manifest
rename to packages/flow_ui/example/windows/runner/runner.exe.manifest
diff --git a/example/windows/runner/utils.cpp b/packages/flow_ui/example/windows/runner/utils.cpp
similarity index 100%
rename from example/windows/runner/utils.cpp
rename to packages/flow_ui/example/windows/runner/utils.cpp
diff --git a/example/windows/runner/utils.h b/packages/flow_ui/example/windows/runner/utils.h
similarity index 100%
rename from example/windows/runner/utils.h
rename to packages/flow_ui/example/windows/runner/utils.h
diff --git a/example/windows/runner/win32_window.cpp b/packages/flow_ui/example/windows/runner/win32_window.cpp
similarity index 100%
rename from example/windows/runner/win32_window.cpp
rename to packages/flow_ui/example/windows/runner/win32_window.cpp
diff --git a/example/windows/runner/win32_window.h b/packages/flow_ui/example/windows/runner/win32_window.h
similarity index 100%
rename from example/windows/runner/win32_window.h
rename to packages/flow_ui/example/windows/runner/win32_window.h
diff --git a/lib/flow_ui.dart b/packages/flow_ui/lib/flow_ui.dart
similarity index 100%
rename from lib/flow_ui.dart
rename to packages/flow_ui/lib/flow_ui.dart
diff --git a/lib/src/models/flow_attachment.dart b/packages/flow_ui/lib/src/models/flow_attachment.dart
similarity index 100%
rename from lib/src/models/flow_attachment.dart
rename to packages/flow_ui/lib/src/models/flow_attachment.dart
diff --git a/lib/src/models/flow_attachment_options.dart b/packages/flow_ui/lib/src/models/flow_attachment_options.dart
similarity index 100%
rename from lib/src/models/flow_attachment_options.dart
rename to packages/flow_ui/lib/src/models/flow_attachment_options.dart
diff --git a/lib/src/models/flow_message_data.dart b/packages/flow_ui/lib/src/models/flow_message_data.dart
similarity index 100%
rename from lib/src/models/flow_message_data.dart
rename to packages/flow_ui/lib/src/models/flow_message_data.dart
diff --git a/lib/src/models/flow_message_part.dart b/packages/flow_ui/lib/src/models/flow_message_part.dart
similarity index 100%
rename from lib/src/models/flow_message_part.dart
rename to packages/flow_ui/lib/src/models/flow_message_part.dart
diff --git a/lib/src/styles/flow_chat_view_style.dart b/packages/flow_ui/lib/src/styles/flow_chat_view_style.dart
similarity index 100%
rename from lib/src/styles/flow_chat_view_style.dart
rename to packages/flow_ui/lib/src/styles/flow_chat_view_style.dart
diff --git a/lib/src/styles/flow_code_block_style.dart b/packages/flow_ui/lib/src/styles/flow_code_block_style.dart
similarity index 100%
rename from lib/src/styles/flow_code_block_style.dart
rename to packages/flow_ui/lib/src/styles/flow_code_block_style.dart
diff --git a/lib/src/styles/flow_composer_style.dart b/packages/flow_ui/lib/src/styles/flow_composer_style.dart
similarity index 100%
rename from lib/src/styles/flow_composer_style.dart
rename to packages/flow_ui/lib/src/styles/flow_composer_style.dart
diff --git a/lib/src/styles/flow_confirmation_style.dart b/packages/flow_ui/lib/src/styles/flow_confirmation_style.dart
similarity index 100%
rename from lib/src/styles/flow_confirmation_style.dart
rename to packages/flow_ui/lib/src/styles/flow_confirmation_style.dart
diff --git a/lib/src/styles/flow_error_state_style.dart b/packages/flow_ui/lib/src/styles/flow_error_state_style.dart
similarity index 100%
rename from lib/src/styles/flow_error_state_style.dart
rename to packages/flow_ui/lib/src/styles/flow_error_state_style.dart
diff --git a/lib/src/styles/flow_markdown_style.dart b/packages/flow_ui/lib/src/styles/flow_markdown_style.dart
similarity index 100%
rename from lib/src/styles/flow_markdown_style.dart
rename to packages/flow_ui/lib/src/styles/flow_markdown_style.dart
diff --git a/lib/src/styles/flow_menu_style.dart b/packages/flow_ui/lib/src/styles/flow_menu_style.dart
similarity index 100%
rename from lib/src/styles/flow_menu_style.dart
rename to packages/flow_ui/lib/src/styles/flow_menu_style.dart
diff --git a/lib/src/styles/flow_message_actions_style.dart b/packages/flow_ui/lib/src/styles/flow_message_actions_style.dart
similarity index 100%
rename from lib/src/styles/flow_message_actions_style.dart
rename to packages/flow_ui/lib/src/styles/flow_message_actions_style.dart
diff --git a/lib/src/styles/flow_message_style.dart b/packages/flow_ui/lib/src/styles/flow_message_style.dart
similarity index 100%
rename from lib/src/styles/flow_message_style.dart
rename to packages/flow_ui/lib/src/styles/flow_message_style.dart
diff --git a/lib/src/styles/flow_pill_style.dart b/packages/flow_ui/lib/src/styles/flow_pill_style.dart
similarity index 100%
rename from lib/src/styles/flow_pill_style.dart
rename to packages/flow_ui/lib/src/styles/flow_pill_style.dart
diff --git a/lib/src/styles/flow_suggestion_style.dart b/packages/flow_ui/lib/src/styles/flow_suggestion_style.dart
similarity index 100%
rename from lib/src/styles/flow_suggestion_style.dart
rename to packages/flow_ui/lib/src/styles/flow_suggestion_style.dart
diff --git a/lib/src/styles/flow_thread_list_style.dart b/packages/flow_ui/lib/src/styles/flow_thread_list_style.dart
similarity index 100%
rename from lib/src/styles/flow_thread_list_style.dart
rename to packages/flow_ui/lib/src/styles/flow_thread_list_style.dart
diff --git a/lib/src/styles/flow_toast_style.dart b/packages/flow_ui/lib/src/styles/flow_toast_style.dart
similarity index 100%
rename from lib/src/styles/flow_toast_style.dart
rename to packages/flow_ui/lib/src/styles/flow_toast_style.dart
diff --git a/lib/src/styles/flow_tool_style.dart b/packages/flow_ui/lib/src/styles/flow_tool_style.dart
similarity index 100%
rename from lib/src/styles/flow_tool_style.dart
rename to packages/flow_ui/lib/src/styles/flow_tool_style.dart
diff --git a/lib/src/theme/flow_colors.dart b/packages/flow_ui/lib/src/theme/flow_colors.dart
similarity index 100%
rename from lib/src/theme/flow_colors.dart
rename to packages/flow_ui/lib/src/theme/flow_colors.dart
diff --git a/lib/src/theme/flow_syntax_colors.dart b/packages/flow_ui/lib/src/theme/flow_syntax_colors.dart
similarity index 100%
rename from lib/src/theme/flow_syntax_colors.dart
rename to packages/flow_ui/lib/src/theme/flow_syntax_colors.dart
diff --git a/lib/src/theme/flow_theme.dart b/packages/flow_ui/lib/src/theme/flow_theme.dart
similarity index 100%
rename from lib/src/theme/flow_theme.dart
rename to packages/flow_ui/lib/src/theme/flow_theme.dart
diff --git a/lib/src/theme/flow_typography.dart b/packages/flow_ui/lib/src/theme/flow_typography.dart
similarity index 100%
rename from lib/src/theme/flow_typography.dart
rename to packages/flow_ui/lib/src/theme/flow_typography.dart
diff --git a/lib/src/utils/flow_asterisk_painter.dart b/packages/flow_ui/lib/src/utils/flow_asterisk_painter.dart
similarity index 100%
rename from lib/src/utils/flow_asterisk_painter.dart
rename to packages/flow_ui/lib/src/utils/flow_asterisk_painter.dart
diff --git a/lib/src/utils/flow_attachment_error.dart b/packages/flow_ui/lib/src/utils/flow_attachment_error.dart
similarity index 100%
rename from lib/src/utils/flow_attachment_error.dart
rename to packages/flow_ui/lib/src/utils/flow_attachment_error.dart
diff --git a/lib/src/utils/flow_attachment_intake.dart b/packages/flow_ui/lib/src/utils/flow_attachment_intake.dart
similarity index 100%
rename from lib/src/utils/flow_attachment_intake.dart
rename to packages/flow_ui/lib/src/utils/flow_attachment_intake.dart
diff --git a/lib/src/utils/flow_chip_text.dart b/packages/flow_ui/lib/src/utils/flow_chip_text.dart
similarity index 100%
rename from lib/src/utils/flow_chip_text.dart
rename to packages/flow_ui/lib/src/utils/flow_chip_text.dart
diff --git a/lib/src/utils/flow_circle_button.dart b/packages/flow_ui/lib/src/utils/flow_circle_button.dart
similarity index 100%
rename from lib/src/utils/flow_circle_button.dart
rename to packages/flow_ui/lib/src/utils/flow_circle_button.dart
diff --git a/lib/src/utils/flow_clipboard_paste.dart b/packages/flow_ui/lib/src/utils/flow_clipboard_paste.dart
similarity index 100%
rename from lib/src/utils/flow_clipboard_paste.dart
rename to packages/flow_ui/lib/src/utils/flow_clipboard_paste.dart
diff --git a/lib/src/utils/flow_clipboard_paste_stub.dart b/packages/flow_ui/lib/src/utils/flow_clipboard_paste_stub.dart
similarity index 100%
rename from lib/src/utils/flow_clipboard_paste_stub.dart
rename to packages/flow_ui/lib/src/utils/flow_clipboard_paste_stub.dart
diff --git a/lib/src/utils/flow_clipboard_paste_web.dart b/packages/flow_ui/lib/src/utils/flow_clipboard_paste_web.dart
similarity index 100%
rename from lib/src/utils/flow_clipboard_paste_web.dart
rename to packages/flow_ui/lib/src/utils/flow_clipboard_paste_web.dart
diff --git a/lib/src/utils/flow_file_drop.dart b/packages/flow_ui/lib/src/utils/flow_file_drop.dart
similarity index 100%
rename from lib/src/utils/flow_file_drop.dart
rename to packages/flow_ui/lib/src/utils/flow_file_drop.dart
diff --git a/lib/src/utils/flow_file_drop_stub.dart b/packages/flow_ui/lib/src/utils/flow_file_drop_stub.dart
similarity index 100%
rename from lib/src/utils/flow_file_drop_stub.dart
rename to packages/flow_ui/lib/src/utils/flow_file_drop_stub.dart
diff --git a/lib/src/utils/flow_file_drop_web.dart b/packages/flow_ui/lib/src/utils/flow_file_drop_web.dart
similarity index 100%
rename from lib/src/utils/flow_file_drop_web.dart
rename to packages/flow_ui/lib/src/utils/flow_file_drop_web.dart
diff --git a/lib/src/utils/flow_file_picker.dart b/packages/flow_ui/lib/src/utils/flow_file_picker.dart
similarity index 100%
rename from lib/src/utils/flow_file_picker.dart
rename to packages/flow_ui/lib/src/utils/flow_file_picker.dart
diff --git a/lib/src/utils/flow_gradient_outline.dart b/packages/flow_ui/lib/src/utils/flow_gradient_outline.dart
similarity index 100%
rename from lib/src/utils/flow_gradient_outline.dart
rename to packages/flow_ui/lib/src/utils/flow_gradient_outline.dart
diff --git a/lib/src/utils/flow_markdown_parser.dart b/packages/flow_ui/lib/src/utils/flow_markdown_parser.dart
similarity index 100%
rename from lib/src/utils/flow_markdown_parser.dart
rename to packages/flow_ui/lib/src/utils/flow_markdown_parser.dart
diff --git a/lib/src/utils/flow_menu_core.dart b/packages/flow_ui/lib/src/utils/flow_menu_core.dart
similarity index 100%
rename from lib/src/utils/flow_menu_core.dart
rename to packages/flow_ui/lib/src/utils/flow_menu_core.dart
diff --git a/lib/src/utils/flow_menu_sheet.dart b/packages/flow_ui/lib/src/utils/flow_menu_sheet.dart
similarity index 100%
rename from lib/src/utils/flow_menu_sheet.dart
rename to packages/flow_ui/lib/src/utils/flow_menu_sheet.dart
diff --git a/lib/src/utils/flow_reveal_engine.dart b/packages/flow_ui/lib/src/utils/flow_reveal_engine.dart
similarity index 100%
rename from lib/src/utils/flow_reveal_engine.dart
rename to packages/flow_ui/lib/src/utils/flow_reveal_engine.dart
diff --git a/lib/src/utils/flow_selection.dart b/packages/flow_ui/lib/src/utils/flow_selection.dart
similarity index 100%
rename from lib/src/utils/flow_selection.dart
rename to packages/flow_ui/lib/src/utils/flow_selection.dart
diff --git a/lib/src/utils/flow_shimmer_sweep.dart b/packages/flow_ui/lib/src/utils/flow_shimmer_sweep.dart
similarity index 100%
rename from lib/src/utils/flow_shimmer_sweep.dart
rename to packages/flow_ui/lib/src/utils/flow_shimmer_sweep.dart
diff --git a/lib/src/utils/flow_syntax_highlighter.dart b/packages/flow_ui/lib/src/utils/flow_syntax_highlighter.dart
similarity index 100%
rename from lib/src/utils/flow_syntax_highlighter.dart
rename to packages/flow_ui/lib/src/utils/flow_syntax_highlighter.dart
diff --git a/lib/src/utils/flow_toast_layer.dart b/packages/flow_ui/lib/src/utils/flow_toast_layer.dart
similarity index 100%
rename from lib/src/utils/flow_toast_layer.dart
rename to packages/flow_ui/lib/src/utils/flow_toast_layer.dart
diff --git a/lib/src/utils/flow_web_dom.dart b/packages/flow_ui/lib/src/utils/flow_web_dom.dart
similarity index 100%
rename from lib/src/utils/flow_web_dom.dart
rename to packages/flow_ui/lib/src/utils/flow_web_dom.dart
diff --git a/lib/src/widgets/flow_attachment_group.dart b/packages/flow_ui/lib/src/widgets/flow_attachment_group.dart
similarity index 100%
rename from lib/src/widgets/flow_attachment_group.dart
rename to packages/flow_ui/lib/src/widgets/flow_attachment_group.dart
diff --git a/lib/src/widgets/flow_attachment_preview.dart b/packages/flow_ui/lib/src/widgets/flow_attachment_preview.dart
similarity index 100%
rename from lib/src/widgets/flow_attachment_preview.dart
rename to packages/flow_ui/lib/src/widgets/flow_attachment_preview.dart
diff --git a/lib/src/widgets/flow_chat_view.dart b/packages/flow_ui/lib/src/widgets/flow_chat_view.dart
similarity index 100%
rename from lib/src/widgets/flow_chat_view.dart
rename to packages/flow_ui/lib/src/widgets/flow_chat_view.dart
diff --git a/lib/src/widgets/flow_code_block.dart b/packages/flow_ui/lib/src/widgets/flow_code_block.dart
similarity index 100%
rename from lib/src/widgets/flow_code_block.dart
rename to packages/flow_ui/lib/src/widgets/flow_code_block.dart
diff --git a/lib/src/widgets/flow_composer.dart b/packages/flow_ui/lib/src/widgets/flow_composer.dart
similarity index 100%
rename from lib/src/widgets/flow_composer.dart
rename to packages/flow_ui/lib/src/widgets/flow_composer.dart
diff --git a/lib/src/widgets/flow_confirmation.dart b/packages/flow_ui/lib/src/widgets/flow_confirmation.dart
similarity index 100%
rename from lib/src/widgets/flow_confirmation.dart
rename to packages/flow_ui/lib/src/widgets/flow_confirmation.dart
diff --git a/lib/src/widgets/flow_drop_target.dart b/packages/flow_ui/lib/src/widgets/flow_drop_target.dart
similarity index 100%
rename from lib/src/widgets/flow_drop_target.dart
rename to packages/flow_ui/lib/src/widgets/flow_drop_target.dart
diff --git a/lib/src/widgets/flow_error_state.dart b/packages/flow_ui/lib/src/widgets/flow_error_state.dart
similarity index 100%
rename from lib/src/widgets/flow_error_state.dart
rename to packages/flow_ui/lib/src/widgets/flow_error_state.dart
diff --git a/lib/src/widgets/flow_greeting.dart b/packages/flow_ui/lib/src/widgets/flow_greeting.dart
similarity index 100%
rename from lib/src/widgets/flow_greeting.dart
rename to packages/flow_ui/lib/src/widgets/flow_greeting.dart
diff --git a/lib/src/widgets/flow_markdown.dart b/packages/flow_ui/lib/src/widgets/flow_markdown.dart
similarity index 100%
rename from lib/src/widgets/flow_markdown.dart
rename to packages/flow_ui/lib/src/widgets/flow_markdown.dart
diff --git a/lib/src/widgets/flow_menu.dart b/packages/flow_ui/lib/src/widgets/flow_menu.dart
similarity index 100%
rename from lib/src/widgets/flow_menu.dart
rename to packages/flow_ui/lib/src/widgets/flow_menu.dart
diff --git a/lib/src/widgets/flow_message.dart b/packages/flow_ui/lib/src/widgets/flow_message.dart
similarity index 100%
rename from lib/src/widgets/flow_message.dart
rename to packages/flow_ui/lib/src/widgets/flow_message.dart
diff --git a/lib/src/widgets/flow_message_actions.dart b/packages/flow_ui/lib/src/widgets/flow_message_actions.dart
similarity index 100%
rename from lib/src/widgets/flow_message_actions.dart
rename to packages/flow_ui/lib/src/widgets/flow_message_actions.dart
diff --git a/lib/src/widgets/flow_model_selector.dart b/packages/flow_ui/lib/src/widgets/flow_model_selector.dart
similarity index 100%
rename from lib/src/widgets/flow_model_selector.dart
rename to packages/flow_ui/lib/src/widgets/flow_model_selector.dart
diff --git a/lib/src/widgets/flow_pill.dart b/packages/flow_ui/lib/src/widgets/flow_pill.dart
similarity index 100%
rename from lib/src/widgets/flow_pill.dart
rename to packages/flow_ui/lib/src/widgets/flow_pill.dart
diff --git a/lib/src/widgets/flow_shimmer_text.dart b/packages/flow_ui/lib/src/widgets/flow_shimmer_text.dart
similarity index 100%
rename from lib/src/widgets/flow_shimmer_text.dart
rename to packages/flow_ui/lib/src/widgets/flow_shimmer_text.dart
diff --git a/lib/src/widgets/flow_streaming_text.dart b/packages/flow_ui/lib/src/widgets/flow_streaming_text.dart
similarity index 100%
rename from lib/src/widgets/flow_streaming_text.dart
rename to packages/flow_ui/lib/src/widgets/flow_streaming_text.dart
diff --git a/lib/src/widgets/flow_suggestion.dart b/packages/flow_ui/lib/src/widgets/flow_suggestion.dart
similarity index 100%
rename from lib/src/widgets/flow_suggestion.dart
rename to packages/flow_ui/lib/src/widgets/flow_suggestion.dart
diff --git a/lib/src/widgets/flow_thinking_indicator.dart b/packages/flow_ui/lib/src/widgets/flow_thinking_indicator.dart
similarity index 100%
rename from lib/src/widgets/flow_thinking_indicator.dart
rename to packages/flow_ui/lib/src/widgets/flow_thinking_indicator.dart
diff --git a/lib/src/widgets/flow_thread.dart b/packages/flow_ui/lib/src/widgets/flow_thread.dart
similarity index 100%
rename from lib/src/widgets/flow_thread.dart
rename to packages/flow_ui/lib/src/widgets/flow_thread.dart
diff --git a/lib/src/widgets/flow_thread_list.dart b/packages/flow_ui/lib/src/widgets/flow_thread_list.dart
similarity index 100%
rename from lib/src/widgets/flow_thread_list.dart
rename to packages/flow_ui/lib/src/widgets/flow_thread_list.dart
diff --git a/lib/src/widgets/flow_toast.dart b/packages/flow_ui/lib/src/widgets/flow_toast.dart
similarity index 100%
rename from lib/src/widgets/flow_toast.dart
rename to packages/flow_ui/lib/src/widgets/flow_toast.dart
diff --git a/lib/src/widgets/flow_tool.dart b/packages/flow_ui/lib/src/widgets/flow_tool.dart
similarity index 100%
rename from lib/src/widgets/flow_tool.dart
rename to packages/flow_ui/lib/src/widgets/flow_tool.dart
diff --git a/packages/flow_ui/pubspec.yaml b/packages/flow_ui/pubspec.yaml
new file mode 100644
index 0000000..44fd76a
--- /dev/null
+++ b/packages/flow_ui/pubspec.yaml
@@ -0,0 +1,42 @@
+name: flow_ui
+description: Flow UI is an open-source Flutter UI library to build production-grade Chat & AI assistant interfaces.
+version: 0.4.0
+homepage: https://flowui.stac.dev/
+repository: https://github.com/StacDev/flow_ui/tree/main/packages/flow_ui
+issue_tracker: https://github.com/StacDev/flow_ui/issues
+documentation: https://flowui.stac.dev/
+topics:
+  - ai
+  - chat
+  - chatbot
+  - assistant
+  - ui
+
+environment:
+  sdk: ^3.12.2
+  flutter: ">=3.44.0"
+
+resolution: workspace
+
+dependencies:
+  flutter:
+    sdk: flutter
+  # Google Sans and Google Sans Code, fetched from Google Fonts at runtime —
+  # the one dependency outside flutter.dev's packages; no font files ship.
+  google_fonts: ^8.2.1
+  material_ui: ^1.0.0
+  # The composer's built-in attach button opens this. flutter.dev-published
+  # and endorsed on all six platforms, and — unlike image_picker — it adds
+  # no permission, no FileProvider and no Play-services entry to a host's
+  # Android manifest, and no Info.plist strings to a host's iOS build. The
+  # one thing a host must do is a macOS entitlement
+  # (com.apple.security.files.user-selected.read-only); without it the
+  # dialog opens onto nothing. Hosts that never wire an attach callback
+  # ship this and configure nothing.
+  file_selector: ^1.1.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^6.0.0
+
diff --git a/packages/stacflow/.pubignore b/packages/stacflow/.pubignore
new file mode 100644
index 0000000..cedf0d5
--- /dev/null
+++ b/packages/stacflow/.pubignore
@@ -0,0 +1,25 @@
+# Replaces .gitignore for publishing.
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+*.iml
+*.ipr
+*.iws
+.idea/
+.env
+.metadata
+pubspec.lock
+**/doc/api/
+.dart_tool/
+.flutter-plugins-dependencies
+build/
+coverage/
+doc/
+tool/
diff --git a/packages/stacflow/CHANGELOG.md b/packages/stacflow/CHANGELOG.md
new file mode 100644
index 0000000..59e5c75
--- /dev/null
+++ b/packages/stacflow/CHANGELOG.md
@@ -0,0 +1,7 @@
+## 0.1.0
+
+- First release: `StacFlowChat`, the chat controller, and `StacFlowChatView`, the ready-made screen built on flow_ui, with streaming, stop, retry, regenerate, edit-and-resend, image attachments, copy, feedback and a model selector.
+- `GeminiProvider`, `OpenAIProvider` (Chat Completions, with `baseUrl` for Ollama, Groq, OpenRouter, LM Studio and vLLM) and `AnthropicProvider`, each streaming replies and taking image input, all called with the developer's own key.
+- `AgentConfig` for instructions and sampling, `FlowStrings` for every string the SDK shows, `ChatError` for failed turns.
+- Tools: `Tool` registered with `StacFlowChat(tools:)`, run by the pure-Dart `runToolLoop` with results fed back to the model; permission classes `read`, `write` and `destructive`, the confirmation card for gated calls, a tool card per call, `toolBodyBuilder` on the view, `ChatState.toolCalls`, `respondToToolCall`, `maxToolRounds` and the new `FlowStrings` for approvals and tool failures. Calls and results are replayed to the model in later turns.
+- Adapters emit the wire `SseEvent` union, tool calls included; `TurnTransport`, `TurnRequest` and the wire types are public for custom providers.
diff --git a/packages/stacflow/LICENSE b/packages/stacflow/LICENSE
new file mode 100644
index 0000000..ee6ff7f
--- /dev/null
+++ b/packages/stacflow/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stac
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/packages/stacflow/README.md b/packages/stacflow/README.md
new file mode 100644
index 0000000..6a071f6
--- /dev/null
+++ b/packages/stacflow/README.md
@@ -0,0 +1,201 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/StacDev/flow_ui/main/packages/flow_ui/assets/flow_ui_logo.svg" width="76" alt="Flow UI logo">
+</p>
+
+<h1 align="center">stacflow</h1>
+
+<p align="center">
+  🎨 <a href="https://pub.dev/packages/flow_ui">flow_ui</a>
+  · 🧩 <a href="https://flowui.stac.dev/playground">Playground</a>
+</p>
+
+<p align="center">
+Streaming AI chat for Flutter, built on flow_ui, talking to Gemini, OpenAI or Claude with your own API key.
+</p>
+
+> [!IMPORTANT]
+> stacflow is pre-1.0. The API is still settling, and minor releases may
+> carry breaking changes: pin a minor version and read the changelog when
+> upgrading.
+
+## Quickstart
+
+```yaml
+dependencies:
+  stacflow: ^0.1.0
+```
+
+```dart
+import 'package:material_ui/material_ui.dart';
+import 'package:stacflow/stacflow.dart';
+
+void main() => runApp(const App());
+
+class App extends StatelessWidget {
+  const App({super.key});
+
+  @override
+  Widget build(BuildContext context) => MaterialApp(
+    theme: ThemeData(extensions: [FlowTheme.light()]),
+    darkTheme: ThemeData(
+      brightness: Brightness.dark,
+      extensions: [FlowTheme.dark()],
+    ),
+    home: const ChatScreen(),
+  );
+}
+
+class ChatScreen extends StatefulWidget {
+  const ChatScreen({super.key});
+
+  @override
+  State<ChatScreen> createState() => _ChatScreenState();
+}
+
+class _ChatScreenState extends State<ChatScreen> {
+  late final chat = StacFlowChat(
+    provider: GeminiProvider(
+      apiKey: const String.fromEnvironment('GEMINI_API_KEY'),
+    ),
+  );
+
+  @override
+  void dispose() {
+    chat.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) =>
+      Scaffold(body: StacFlowChatView(chat: chat));
+}
+```
+
+```bash
+flutter run --dart-define=GEMINI_API_KEY=AIza...
+```
+
+That is the whole integration. The view streams replies with a thinking
+indicator, renders markdown and code, stops mid-reply, retries failed
+turns, regenerates, takes image attachments from the picker, a drop or a
+paste, copies replies, records feedback, offers a model selector when
+the provider lists more than one model, and runs the tools you register,
+asking first when a tool is destructive. One import brings flow_ui along,
+so every widget it exports is available too.
+
+## Example
+
+[`example/`](https://github.com/StacDev/flow_ui/tree/main/packages/stacflow/example)
+is this screen, runnable against Gemini:
+
+```bash
+cd example && flutter run --dart-define=GEMINI_API_KEY=AIza...
+```
+
+## Providers
+
+| Provider | Class | Default model | Key |
+|---|---|---|---|
+| Gemini | `GeminiProvider` | `gemini-3.6-flash` | An AI Studio API key |
+| OpenAI, and any compatible server | `OpenAIProvider` | `gpt-5-mini` | An OpenAI API key; set `baseUrl` for Ollama, Groq, OpenRouter, LM Studio or vLLM |
+| Claude | `AnthropicProvider` | `claude-opus-5` | An Anthropic API key; `claude-sonnet-5` is the cheaper model |
+
+Every provider takes `model`, `baseUrl`, extra `headers`, an `httpClient`,
+the `models` a selector should offer, and first-byte and idle timeouts.
+Instructions and sampling live on the chat:
+
+```dart
+StacFlowChat(
+  provider: AnthropicProvider(
+    apiKey: key,
+    models: const [
+      ModelOption(id: 'claude-opus-5', label: 'Claude Opus 5'),
+      ModelOption(id: 'claude-sonnet-5', label: 'Claude Sonnet 5'),
+    ],
+  ),
+  agent: const AgentConfig(instructions: 'You are a concise assistant.'),
+)
+```
+
+## Tools
+
+A tool is an action the app lets the model take. Register it on the chat
+with a name, a description the model reads, a JSON Schema for its
+arguments and the handler that runs it:
+
+```dart
+StacFlowChat(
+  provider: GeminiProvider(apiKey: key),
+  tools: [
+    Tool(
+      name: 'set_theme',
+      description: 'Switches the app between light and dark mode.',
+      parameters: const {
+        'type': 'object',
+        'properties': {
+          'mode': {'type': 'string', 'enum': ['light', 'dark', 'system']},
+        },
+        'required': ['mode'],
+      },
+      label: 'Set theme',
+      detail: (args) => args['mode'] as String?,
+      run: (call) {
+        themeMode.value = ThemeMode.values.byName(call.args['mode'] as String);
+        return {'mode': call.args['mode']};
+      },
+    ),
+  ],
+)
+```
+
+When the model calls it, the thread shows a tool card that moves from
+pending to complete, with the arguments and the result behind a
+disclosure, and the model finishes its reply with the result in hand. A
+handler returns any JSON-encodable value; throw a `ToolException` to fail
+in your own words, and check `call.isAborted` in long handlers, since a
+stop, a timeout or the end of the turn cancels the call.
+
+Every tool carries a permission: `read` runs silently, `write` (the
+default) runs unless the tool sets `confirm: true`, and `destructive`
+always shows a confirmation card first. The card's question comes from
+`confirmation`, or "Allow <label> to run?" by default; a decline goes back
+to the model as a declined result so it can respond. `toolBodyBuilder` on
+the view renders content under a card, such as a table for a query
+result. A turn may call tools in up to `maxToolRounds` segments (8 by
+default) before it fails with a retryable error. Calls and results are
+replayed to the model in later turns, so it keeps knowing what it did.
+
+## Keys, plainly
+
+A key compiled into a shipped app can be extracted from the binary. Use
+`--dart-define` or `--dart-define-from-file=env.json` while developing.
+For production, put the key behind a server you own and point
+`OpenAIProvider(baseUrl: ...)` or the other providers' `baseUrl` at it. On
+the web, Claude requests carry the header
+Anthropic requires for direct browser calls, which means the key travels
+to the browser: fine for a demo, not for a public site.
+
+## Headless
+
+`StacFlowChat` works without the view. `chat.state` is a
+`ValueListenable<ChatState>` with the messages, the pending attachments,
+the last error and the last turn's timing and token counts; `send`,
+`stop`, `retry`, `regenerate`, `editAndResend`, `addAttachments`,
+`selectModel` and `newConversation` drive it. Any flow_ui layout, or your
+own, renders `state.messages`.
+
+## Strings
+
+Every string the SDK shows comes from `FlowStrings`, with English
+defaults. Subclass it, override what you need, and pass it to the chat or
+the view.
+
+## Not in 0.1
+
+Thread persistence and image generation. The `SseEvent` types,
+`TurnTransport` and `TurnRequest` are public so a custom provider can be
+written today.
+
+## License
+
+MIT. Part of the [flow_ui](https://github.com/StacDev/flow_ui) repository.
diff --git a/packages/stacflow/analysis_options.yaml b/packages/stacflow/analysis_options.yaml
new file mode 100644
index 0000000..c4a4717
--- /dev/null
+++ b/packages/stacflow/analysis_options.yaml
@@ -0,0 +1,5 @@
+include: ../../analysis_options.yaml
+
+analyzer:
+  exclude:
+    - build/**
diff --git a/packages/stacflow/example/.gitignore b/packages/stacflow/example/.gitignore
new file mode 100644
index 0000000..6e7aaa4
--- /dev/null
+++ b/packages/stacflow/example/.gitignore
@@ -0,0 +1,51 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+/coverage/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+# Widget Preview related
+.widget_preview/
+
+# The API key, copied from lib/env.example.dart. Never committed.
+lib/env.dart
diff --git a/packages/stacflow/example/.metadata b/packages/stacflow/example/.metadata
new file mode 100644
index 0000000..615dfd4
--- /dev/null
+++ b/packages/stacflow/example/.metadata
@@ -0,0 +1,45 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "d3b14c876900e553bc736ca19295fc09e3853e8e"
+  channel: "stable"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: android
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: ios
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: linux
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: macos
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: web
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+    - platform: windows
+      create_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+      base_revision: d3b14c876900e553bc736ca19295fc09e3853e8e
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'
diff --git a/packages/stacflow/example/README.md b/packages/stacflow/example/README.md
new file mode 100644
index 0000000..c802c0f
--- /dev/null
+++ b/packages/stacflow/example/README.md
@@ -0,0 +1,30 @@
+# stacflow example
+
+The README's chat screen, runnable: a `StacFlowChat` on `GeminiProvider`
+driving `StacFlowChatView`, with one tool, `set_theme`, so asking for
+dark mode flips the app and shows the tool card. The selector in the
+composer switches between two Gemini models and the plus button in the
+app bar starts a new conversation. Streaming behind the thinking
+indicator, stop, retry from the error card, regenerate, edit a turn,
+images from the picker, a drop or a paste, copy and feedback all come
+from the view; nothing here is wired by hand.
+
+Grab a key from [Google AI Studio](https://aistudio.google.com/apikey), copy
+`lib/env.example.dart` to `lib/env.dart` and paste it in. `lib/env.dart` is
+gitignored, so the key never reaches the repository. Platform runners are
+checked in, so it then runs directly:
+
+```bash
+cp lib/env.example.dart lib/env.dart
+flutter run
+```
+
+A `--dart-define=GEMINI_API_KEY=AIza...` at launch overrides the file.
+
+With an empty key the app still runs; sending answers with the error card.
+On the web the key travels to the browser: fine for this demo, not for a
+public site.
+
+The example resolves through the repo's pub workspace (`resolution: workspace`
+in its pubspec). To use it outside the repo, delete that line and depend on
+`stacflow` from pub.dev.
diff --git a/packages/stacflow/example/analysis_options.yaml b/packages/stacflow/example/analysis_options.yaml
new file mode 100644
index 0000000..cedcc10
--- /dev/null
+++ b/packages/stacflow/example/analysis_options.yaml
@@ -0,0 +1,38 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  exclude:
+    - build/**
+    - android/**
+    - ios/**
+    - web/**
+    - windows/**
+    - macos/**
+    - linux/**
+
+linter:
+  # The lint rules applied to this project can be customized in the
+  # section below to disable rules from the `package:flutter_lints/flutter.yaml`
+  # included above or to enable additional rules. A list of all available lints
+  # and their documentation is published at https://dart.dev/lints.
+  #
+  # Instead of disabling a lint rule for the entire project in the
+  # section below, it can also be suppressed for a single line of code
+  # or a specific dart file by using the `// ignore: name_of_lint` and
+  # `// ignore_for_file: name_of_lint` syntax on the line or in the file
+  # producing the lint.
+  rules:
+    # avoid_print: false  # Uncomment to disable the `avoid_print` rule
+    # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options
diff --git a/packages/stacflow/example/android/.gitignore b/packages/stacflow/example/android/.gitignore
new file mode 100644
index 0000000..be3943c
--- /dev/null
+++ b/packages/stacflow/example/android/.gitignore
@@ -0,0 +1,14 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+.cxx/
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/to/reference-keystore
+key.properties
+**/*.keystore
+**/*.jks
diff --git a/packages/stacflow/example/android/app/build.gradle.kts b/packages/stacflow/example/android/app/build.gradle.kts
new file mode 100644
index 0000000..1b1c724
--- /dev/null
+++ b/packages/stacflow/example/android/app/build.gradle.kts
@@ -0,0 +1,49 @@
+plugins {
+    id("com.android.application")
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id("dev.flutter.flutter-gradle-plugin")
+}
+
+android {
+    namespace = "dev.stac.stacflow_example"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId = "dev.stac.stacflow_example"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
+        minSdk = flutter.minSdkVersion
+        targetSdk = flutter.targetSdkVersion
+        // Uses the version code from pubspec.yaml. When using split APKs, 1000 * ABI_VERSION
+        // is added automatically by Flutter. (https://developer.android.com/studio/build/configure-apk-splits#configure-APK-versions)
+        // You can force using the value of versionCode by specifying the `-P force-version-code-ignoring-abi=true`
+        // flag during build.
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+    }
+
+    buildTypes {
+        release {
+            // TODO: Add your own signing config for the release build.
+            // Signing with the debug keys for now, so `flutter run --release` works.
+            signingConfig = signingConfigs.getByName("debug")
+        }
+    }
+}
+
+kotlin {
+    compilerOptions {
+        jvmTarget = org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17
+    }
+}
+
+flutter {
+    source = "../.."
+}
diff --git a/packages/stacflow/example/android/app/src/debug/AndroidManifest.xml b/packages/stacflow/example/android/app/src/debug/AndroidManifest.xml
new file mode 100644
index 0000000..399f698
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/debug/AndroidManifest.xml
@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>
diff --git a/packages/stacflow/example/android/app/src/main/AndroidManifest.xml b/packages/stacflow/example/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..1a98a04
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,46 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <application
+        android:label="stacflow_example"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:taskAffinity=""
+            android:theme="@style/LaunchTheme"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
+            android:hardwareAccelerated="true"
+            android:windowSoftInputMode="adjustResize">
+            <!-- Specifies an Android theme to apply to this Activity as soon as
+                 the Android process has started. This theme is visible to the user
+                 while the Flutter UI initializes. After that, this theme continues
+                 to determine the Window background behind the Flutter UI. -->
+            <meta-data
+              android:name="io.flutter.embedding.android.NormalTheme"
+              android:resource="@style/NormalTheme"
+              />
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <!-- Don't delete the meta-data below.
+             This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
+        <meta-data
+            android:name="flutterEmbedding"
+            android:value="2" />
+    </application>
+    <!-- Required to query activities that can process text, see:
+         https://developer.android.com/training/package-visibility and
+         https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
+
+         In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
+    <queries>
+        <intent>
+            <action android:name="android.intent.action.PROCESS_TEXT"/>
+            <data android:mimeType="text/plain"/>
+        </intent>
+    </queries>
+</manifest>
diff --git a/packages/stacflow/example/android/app/src/main/kotlin/dev/stac/stacflow_example/MainActivity.kt b/packages/stacflow/example/android/app/src/main/kotlin/dev/stac/stacflow_example/MainActivity.kt
new file mode 100644
index 0000000..1e0e699
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/kotlin/dev/stac/stacflow_example/MainActivity.kt
@@ -0,0 +1,5 @@
+package dev.stac.stacflow_example
+
+import io.flutter.embedding.android.FlutterActivity
+
+class MainActivity : FlutterActivity()
diff --git a/packages/stacflow/example/android/app/src/main/res/drawable-v21/launch_background.xml b/packages/stacflow/example/android/app/src/main/res/drawable-v21/launch_background.xml
new file mode 100644
index 0000000..f74085f
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/res/drawable-v21/launch_background.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Modify this file to customize your launch splash screen -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:drawable="?android:colorBackground" />
+
+    <!-- You can insert your own image assets here -->
+    <!-- <item>
+        <bitmap
+            android:gravity="center"
+            android:src="@mipmap/launch_image" />
+    </item> -->
+</layer-list>
diff --git a/packages/stacflow/example/android/app/src/main/res/drawable/launch_background.xml b/packages/stacflow/example/android/app/src/main/res/drawable/launch_background.xml
new file mode 100644
index 0000000..304732f
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/res/drawable/launch_background.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Modify this file to customize your launch splash screen -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:drawable="@android:color/white" />
+
+    <!-- You can insert your own image assets here -->
+    <!-- <item>
+        <bitmap
+            android:gravity="center"
+            android:src="@mipmap/launch_image" />
+    </item> -->
+</layer-list>
diff --git a/packages/stacflow/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/packages/stacflow/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png
new file mode 100644
index 0000000..db77bb4
Binary files /dev/null and b/packages/stacflow/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png differ
diff --git a/packages/stacflow/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/packages/stacflow/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png
new file mode 100644
index 0000000..17987b7
Binary files /dev/null and b/packages/stacflow/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png differ
diff --git a/packages/stacflow/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png b/packages/stacflow/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png
new file mode 100644
index 0000000..09d4391
Binary files /dev/null and b/packages/stacflow/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png differ
diff --git a/packages/stacflow/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/packages/stacflow/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
new file mode 100644
index 0000000..d5f1c8d
Binary files /dev/null and b/packages/stacflow/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png differ
diff --git a/packages/stacflow/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/packages/stacflow/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
new file mode 100644
index 0000000..4d6372e
Binary files /dev/null and b/packages/stacflow/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png differ
diff --git a/packages/stacflow/example/android/app/src/main/res/values-night/styles.xml b/packages/stacflow/example/android/app/src/main/res/values-night/styles.xml
new file mode 100644
index 0000000..06952be
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/res/values-night/styles.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
+    <style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
+        <!-- Show a splash screen on the activity. Automatically removed when
+             the Flutter engine draws its first frame -->
+        <item name="android:windowBackground">@drawable/launch_background</item>
+    </style>
+    <!-- Theme applied to the Android Window as soon as the process has started.
+         This theme determines the color of the Android Window while your
+         Flutter UI initializes, as well as behind your Flutter UI while its
+         running.
+
+         This Theme is only used starting with V2 of Flutter's Android embedding. -->
+    <style name="NormalTheme" parent="@android:style/Theme.Black.NoTitleBar">
+        <item name="android:windowBackground">?android:colorBackground</item>
+    </style>
+</resources>
diff --git a/packages/stacflow/example/android/app/src/main/res/values/styles.xml b/packages/stacflow/example/android/app/src/main/res/values/styles.xml
new file mode 100644
index 0000000..cb1ef88
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/main/res/values/styles.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
+    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
+        <!-- Show a splash screen on the activity. Automatically removed when
+             the Flutter engine draws its first frame -->
+        <item name="android:windowBackground">@drawable/launch_background</item>
+    </style>
+    <!-- Theme applied to the Android Window as soon as the process has started.
+         This theme determines the color of the Android Window while your
+         Flutter UI initializes, as well as behind your Flutter UI while its
+         running.
+
+         This Theme is only used starting with V2 of Flutter's Android embedding. -->
+    <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
+        <item name="android:windowBackground">?android:colorBackground</item>
+    </style>
+</resources>
diff --git a/packages/stacflow/example/android/app/src/profile/AndroidManifest.xml b/packages/stacflow/example/android/app/src/profile/AndroidManifest.xml
new file mode 100644
index 0000000..399f698
--- /dev/null
+++ b/packages/stacflow/example/android/app/src/profile/AndroidManifest.xml
@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>
diff --git a/packages/stacflow/example/android/build.gradle.kts b/packages/stacflow/example/android/build.gradle.kts
new file mode 100644
index 0000000..dbee657
--- /dev/null
+++ b/packages/stacflow/example/android/build.gradle.kts
@@ -0,0 +1,24 @@
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+val newBuildDir: Directory =
+    rootProject.layout.buildDirectory
+        .dir("../../build")
+        .get()
+rootProject.layout.buildDirectory.value(newBuildDir)
+
+subprojects {
+    val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name)
+    project.layout.buildDirectory.value(newSubprojectBuildDir)
+}
+subprojects {
+    project.evaluationDependsOn(":app")
+}
+
+tasks.register<Delete>("clean") {
+    delete(rootProject.layout.buildDirectory)
+}
diff --git a/packages/stacflow/example/android/gradle.properties b/packages/stacflow/example/android/gradle.properties
new file mode 100644
index 0000000..e96108c
--- /dev/null
+++ b/packages/stacflow/example/android/gradle.properties
@@ -0,0 +1,6 @@
+org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
+android.useAndroidX=true
+# This newDsl flag was added by the Flutter template
+android.newDsl=false
+# This builtInKotlin flag was added by the Flutter template
+android.builtInKotlin=false
diff --git a/packages/stacflow/example/android/gradle/wrapper/gradle-wrapper.properties b/packages/stacflow/example/android/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 0000000..a20f2c4
--- /dev/null
+++ b/packages/stacflow/example/android/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-all.zip
diff --git a/packages/stacflow/example/android/settings.gradle.kts b/packages/stacflow/example/android/settings.gradle.kts
new file mode 100644
index 0000000..b28021a
--- /dev/null
+++ b/packages/stacflow/example/android/settings.gradle.kts
@@ -0,0 +1,26 @@
+pluginManagement {
+    val flutterSdkPath =
+        run {
+            val properties = java.util.Properties()
+            file("local.properties").inputStream().use { properties.load(it) }
+            val flutterSdkPath = properties.getProperty("flutter.sdk")
+            require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
+            flutterSdkPath
+        }
+
+    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
+
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+plugins {
+    id("dev.flutter.flutter-plugin-loader") version "1.0.0"
+    id("com.android.application") version "9.1.0" apply false
+    id("org.jetbrains.kotlin.android") version "2.4.0" apply false
+}
+
+include(":app")
diff --git a/packages/stacflow/example/ios/.gitignore b/packages/stacflow/example/ios/.gitignore
new file mode 100644
index 0000000..7a7f987
--- /dev/null
+++ b/packages/stacflow/example/ios/.gitignore
@@ -0,0 +1,34 @@
+**/dgph
+*.mode1v3
+*.mode2v3
+*.moved-aside
+*.pbxuser
+*.perspectivev3
+**/*sync/
+.sconsign.dblite
+.tags*
+**/.vagrant/
+**/DerivedData/
+Icon?
+**/Pods/
+**/.symlinks/
+profile
+xcuserdata
+**/.generated/
+Flutter/App.framework
+Flutter/Flutter.framework
+Flutter/Flutter.podspec
+Flutter/Generated.xcconfig
+Flutter/ephemeral/
+Flutter/app.flx
+Flutter/app.zip
+Flutter/flutter_assets/
+Flutter/flutter_export_environment.sh
+ServiceDefinitions.json
+Runner/GeneratedPluginRegistrant.*
+
+# Exceptions to above rules.
+!default.mode1v3
+!default.mode2v3
+!default.pbxuser
+!default.perspectivev3
diff --git a/packages/stacflow/example/ios/Flutter/AppFrameworkInfo.plist b/packages/stacflow/example/ios/Flutter/AppFrameworkInfo.plist
new file mode 100644
index 0000000..391a902
--- /dev/null
+++ b/packages/stacflow/example/ios/Flutter/AppFrameworkInfo.plist
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>en</string>
+  <key>CFBundleExecutable</key>
+  <string>App</string>
+  <key>CFBundleIdentifier</key>
+  <string>io.flutter.flutter.app</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>App</string>
+  <key>CFBundlePackageType</key>
+  <string>FMWK</string>
+  <key>CFBundleShortVersionString</key>
+  <string>1.0</string>
+  <key>CFBundleSignature</key>
+  <string>????</string>
+  <key>CFBundleVersion</key>
+  <string>1.0</string>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Flutter/Debug.xcconfig b/packages/stacflow/example/ios/Flutter/Debug.xcconfig
new file mode 100644
index 0000000..592ceee
--- /dev/null
+++ b/packages/stacflow/example/ios/Flutter/Debug.xcconfig
@@ -0,0 +1 @@
+#include "Generated.xcconfig"
diff --git a/packages/stacflow/example/ios/Flutter/Release.xcconfig b/packages/stacflow/example/ios/Flutter/Release.xcconfig
new file mode 100644
index 0000000..592ceee
--- /dev/null
+++ b/packages/stacflow/example/ios/Flutter/Release.xcconfig
@@ -0,0 +1 @@
+#include "Generated.xcconfig"
diff --git a/packages/stacflow/example/ios/Runner.xcodeproj/project.pbxproj b/packages/stacflow/example/ios/Runner.xcodeproj/project.pbxproj
new file mode 100644
index 0000000..f266db3
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcodeproj/project.pbxproj
@@ -0,0 +1,650 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 54;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */ = {isa = PBXBuildFile; fileRef = 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */; };
+		331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; };
+		3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; };
+		74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; };
+		7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */; };
+		78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */ = {isa = PBXBuildFile; productRef = 78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */; };
+		97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; };
+		97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FD1CF9000F007C117D /* Assets.xcassets */; };
+		97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXContainerItemProxy section */
+		331C8085294A63A400263BE5 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 97C146E61CF9000F007C117D /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 97C146ED1CF9000F007C117D;
+			remoteInfo = Runner;
+		};
+/* End PBXContainerItemProxy section */
+
+/* Begin PBXCopyFilesBuildPhase section */
+		9705A1C41CF9048500538489 /* Embed Frameworks */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "";
+			dstSubfolderSpec = 10;
+			files = (
+			);
+			name = "Embed Frameworks";
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = GeneratedPluginRegistrant.h; sourceTree = "<group>"; };
+		1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = GeneratedPluginRegistrant.m; sourceTree = "<group>"; };
+		331C807B294A618700263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = "<group>"; };
+		331C8081294A63A400263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
+		3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = "<group>"; };
+		74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = "<group>"; };
+		74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+		7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = "<group>"; };
+		78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */ = {isa = PBXFileReference; lastKnownFileType = wrapper; name = FlutterGeneratedPluginSwiftPackage; path = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage; sourceTree = "<group>"; };
+		7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = "<group>"; };
+		9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Debug.xcconfig; path = Flutter/Debug.xcconfig; sourceTree = "<group>"; };
+		9740EEB31CF90195004384FC /* Generated.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Generated.xcconfig; path = Flutter/Generated.xcconfig; sourceTree = "<group>"; };
+		97C146EE1CF9000F007C117D /* Runner.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Runner.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		97C146FB1CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
+		97C146FD1CF9000F007C117D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
+		97C147001CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
+		97C147021CF9000F007C117D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		97C146EB1CF9000F007C117D /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		331C8082294A63A400263BE5 /* RunnerTests */ = {
+			isa = PBXGroup;
+			children = (
+				331C807B294A618700263BE5 /* RunnerTests.swift */,
+			);
+			path = RunnerTests;
+			sourceTree = "<group>";
+		};
+		9740EEB11CF90186004384FC /* Flutter */ = {
+			isa = PBXGroup;
+			children = (
+				78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */,
+				3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */,
+				9740EEB21CF90195004384FC /* Debug.xcconfig */,
+				7AFA3C8E1D35360C0083082E /* Release.xcconfig */,
+				9740EEB31CF90195004384FC /* Generated.xcconfig */,
+			);
+			name = Flutter;
+			sourceTree = "<group>";
+		};
+		97C146E51CF9000F007C117D = {
+			isa = PBXGroup;
+			children = (
+				9740EEB11CF90186004384FC /* Flutter */,
+				97C146F01CF9000F007C117D /* Runner */,
+				97C146EF1CF9000F007C117D /* Products */,
+				331C8082294A63A400263BE5 /* RunnerTests */,
+			);
+			sourceTree = "<group>";
+		};
+		97C146EF1CF9000F007C117D /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				97C146EE1CF9000F007C117D /* Runner.app */,
+				331C8081294A63A400263BE5 /* RunnerTests.xctest */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		97C146F01CF9000F007C117D /* Runner */ = {
+			isa = PBXGroup;
+			children = (
+				97C146FA1CF9000F007C117D /* Main.storyboard */,
+				97C146FD1CF9000F007C117D /* Assets.xcassets */,
+				97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */,
+				97C147021CF9000F007C117D /* Info.plist */,
+				1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */,
+				1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */,
+				74858FAE1ED2DC5600515810 /* AppDelegate.swift */,
+				7884E8672EC3CC0400C636F2 /* SceneDelegate.swift */,
+				74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */,
+			);
+			path = Runner;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		331C8080294A63A400263BE5 /* RunnerTests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */;
+			buildPhases = (
+				331C807D294A63A400263BE5 /* Sources */,
+				331C807F294A63A400263BE5 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				331C8086294A63A400263BE5 /* PBXTargetDependency */,
+			);
+			name = RunnerTests;
+			productName = RunnerTests;
+			productReference = 331C8081294A63A400263BE5 /* RunnerTests.xctest */;
+			productType = "com.apple.product-type.bundle.unit-test";
+		};
+		97C146ED1CF9000F007C117D /* Runner */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */;
+			buildPhases = (
+				9740EEB61CF901F6004384FC /* Run Script */,
+				97C146EA1CF9000F007C117D /* Sources */,
+				97C146EB1CF9000F007C117D /* Frameworks */,
+				97C146EC1CF9000F007C117D /* Resources */,
+				9705A1C41CF9048500538489 /* Embed Frameworks */,
+				3B06AD1E1E4923F5004D2608 /* Thin Binary */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = Runner;
+			packageProductDependencies = (
+				78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */,
+			);
+			productName = Runner;
+			productReference = 97C146EE1CF9000F007C117D /* Runner.app */;
+			productType = "com.apple.product-type.application";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		97C146E61CF9000F007C117D /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				BuildIndependentTargetsInParallel = YES;
+				LastUpgradeCheck = 1510;
+				ORGANIZATIONNAME = "";
+				TargetAttributes = {
+					331C8080294A63A400263BE5 = {
+						CreatedOnToolsVersion = 14.0;
+						TestTargetID = 97C146ED1CF9000F007C117D;
+					};
+					97C146ED1CF9000F007C117D = {
+						CreatedOnToolsVersion = 7.3.1;
+						LastSwiftMigration = 1100;
+					};
+				};
+			};
+			buildConfigurationList = 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */;
+			compatibilityVersion = "Xcode 9.3";
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 97C146E51CF9000F007C117D;
+			packageReferences = (
+				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */,
+			);
+			productRefGroup = 97C146EF1CF9000F007C117D /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				97C146ED1CF9000F007C117D /* Runner */,
+				331C8080294A63A400263BE5 /* RunnerTests */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		331C807F294A63A400263BE5 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		97C146EC1CF9000F007C117D /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */,
+				3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */,
+				97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */,
+				97C146FC1CF9000F007C117D /* Main.storyboard in Resources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXShellScriptBuildPhase section */
+		3B06AD1E1E4923F5004D2608 /* Thin Binary */ = {
+			isa = PBXShellScriptBuildPhase;
+			alwaysOutOfDate = 1;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputPaths = (
+				"${TARGET_BUILD_DIR}/${INFOPLIST_PATH}",
+			);
+			name = "Thin Binary";
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" embed_and_thin";
+		};
+		9740EEB61CF901F6004384FC /* Run Script */ = {
+			isa = PBXShellScriptBuildPhase;
+			alwaysOutOfDate = 1;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputPaths = (
+			);
+			name = "Run Script";
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build";
+		};
+/* End PBXShellScriptBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		331C807D294A63A400263BE5 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		97C146EA1CF9000F007C117D /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */,
+				1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */,
+				7884E8682EC3CC0700C636F2 /* SceneDelegate.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXTargetDependency section */
+		331C8086294A63A400263BE5 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 97C146ED1CF9000F007C117D /* Runner */;
+			targetProxy = 331C8085294A63A400263BE5 /* PBXContainerItemProxy */;
+		};
+/* End PBXTargetDependency section */
+
+/* Begin PBXVariantGroup section */
+		97C146FA1CF9000F007C117D /* Main.storyboard */ = {
+			isa = PBXVariantGroup;
+			children = (
+				97C146FB1CF9000F007C117D /* Base */,
+			);
+			name = Main.storyboard;
+			sourceTree = "<group>";
+		};
+		97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */ = {
+			isa = PBXVariantGroup;
+			children = (
+				97C147001CF9000F007C117D /* Base */,
+			);
+			name = LaunchScreen.storyboard;
+			sourceTree = "<group>";
+		};
+/* End PBXVariantGroup section */
+
+/* Begin XCBuildConfiguration section */
+		249021D3217E4FDB00AE95B9 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SUPPORTED_PLATFORMS = iphoneos;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Profile;
+		};
+		249021D4217E4FDB00AE95B9 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				DEVELOPMENT_TEAM = W2B7PMH9SQ;
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = Profile;
+		};
+		331C8088294A63A400263BE5 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = Debug;
+		};
+		331C8089294A63A400263BE5 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = Release;
+		};
+		331C808A294A63A400263BE5 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner";
+			};
+			name = Profile;
+		};
+		97C147031CF9000F007C117D /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = Debug;
+		};
+		97C147041CF9000F007C117D /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SUPPORTED_PLATFORMS = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		97C147061CF9000F007C117D /* Debug */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				DEVELOPMENT_TEAM = W2B7PMH9SQ;
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = Debug;
+		};
+		97C147071CF9000F007C117D /* Release */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
+				DEVELOPMENT_TEAM = W2B7PMH9SQ;
+				ENABLE_BITCODE = NO;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
+				SWIFT_VERSION = 5.0;
+				VERSIONING_SYSTEM = "apple-generic";
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				331C8088294A63A400263BE5 /* Debug */,
+				331C8089294A63A400263BE5 /* Release */,
+				331C808A294A63A400263BE5 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				97C147031CF9000F007C117D /* Debug */,
+				97C147041CF9000F007C117D /* Release */,
+				249021D3217E4FDB00AE95B9 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				97C147061CF9000F007C117D /* Debug */,
+				97C147071CF9000F007C117D /* Release */,
+				249021D4217E4FDB00AE95B9 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+
+/* Begin XCLocalSwiftPackageReference section */
+		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */ = {
+			isa = XCLocalSwiftPackageReference;
+			relativePath = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage;
+		};
+/* End XCLocalSwiftPackageReference section */
+
+/* Begin XCSwiftPackageProductDependency section */
+		78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */ = {
+			isa = XCSwiftPackageProductDependency;
+			productName = FlutterGeneratedPluginSwiftPackage;
+		};
+/* End XCSwiftPackageProductDependency section */
+	};
+	rootObject = 97C146E61CF9000F007C117D /* Project object */;
+}
diff --git a/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata
new file mode 100644
index 0000000..919434a
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>
diff --git a/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 0000000..18d9810
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
new file mode 100644
index 0000000..f9b0d7c
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>PreviewsEnabled</key>
+	<false/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/stacflow/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
new file mode 100644
index 0000000..c3fedb2
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1510"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <PreActions>
+         <ExecutionAction
+            ActionType = "Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction">
+            <ActionContent
+               title = "Run Prepare Flutter Framework Script"
+               scriptText = "/bin/sh &quot;$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh&quot; prepare&#10;">
+               <EnvironmentBuildable>
+                  <BuildableReference
+                     BuildableIdentifier = "primary"
+                     BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+                     BuildableName = "Runner.app"
+                     BlueprintName = "Runner"
+                     ReferencedContainer = "container:Runner.xcodeproj">
+                  </BuildableReference>
+               </EnvironmentBuildable>
+            </ActionContent>
+         </ExecutionAction>
+      </PreActions>
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+               BuildableName = "Runner.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      customLLDBInitFile = "$(SRCROOT)/Flutter/ephemeral/flutter_lldbinit"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <Testables>
+         <TestableReference
+            skipped = "NO"
+            parallelizable = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "331C8080294A63A400263BE5"
+               BuildableName = "RunnerTests.xctest"
+               BlueprintName = "RunnerTests"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      customLLDBInitFile = "$(SRCROOT)/Flutter/ephemeral/flutter_lldbinit"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      enableGPUValidationMode = "1"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "97C146ED1CF9000F007C117D"
+            BuildableName = "Runner.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>
diff --git a/packages/stacflow/example/ios/Runner.xcworkspace/contents.xcworkspacedata b/packages/stacflow/example/ios/Runner.xcworkspace/contents.xcworkspacedata
new file mode 100644
index 0000000..1d526a1
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcworkspace/contents.xcworkspacedata
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "group:Runner.xcodeproj">
+   </FileRef>
+</Workspace>
diff --git a/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 0000000..18d9810
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
new file mode 100644
index 0000000..f9b0d7c
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>PreviewsEnabled</key>
+	<false/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Runner/AppDelegate.swift b/packages/stacflow/example/ios/Runner/AppDelegate.swift
new file mode 100644
index 0000000..c30b367
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/AppDelegate.swift
@@ -0,0 +1,16 @@
+import Flutter
+import UIKit
+
+@main
+@objc class AppDelegate: FlutterAppDelegate, FlutterImplicitEngineDelegate {
+  override func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+  ) -> Bool {
+    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
+  }
+
+  func didInitializeImplicitFlutterEngine(_ engineBridge: FlutterImplicitEngineBridge) {
+    GeneratedPluginRegistrant.register(with: engineBridge.pluginRegistry)
+  }
+}
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
new file mode 100644
index 0000000..d36b1fa
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
@@ -0,0 +1,122 @@
+{
+  "images" : [
+    {
+      "size" : "20x20",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-20x20@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "20x20",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-20x20@3x.png",
+      "scale" : "3x"
+    },
+    {
+      "size" : "29x29",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-29x29@1x.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "29x29",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-29x29@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "29x29",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-29x29@3x.png",
+      "scale" : "3x"
+    },
+    {
+      "size" : "40x40",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-40x40@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "40x40",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-40x40@3x.png",
+      "scale" : "3x"
+    },
+    {
+      "size" : "60x60",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-60x60@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "60x60",
+      "idiom" : "iphone",
+      "filename" : "Icon-App-60x60@3x.png",
+      "scale" : "3x"
+    },
+    {
+      "size" : "20x20",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-20x20@1x.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "20x20",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-20x20@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "29x29",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-29x29@1x.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "29x29",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-29x29@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "40x40",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-40x40@1x.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "40x40",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-40x40@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "76x76",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-76x76@1x.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "76x76",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-76x76@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "83.5x83.5",
+      "idiom" : "ipad",
+      "filename" : "Icon-App-83.5x83.5@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "1024x1024",
+      "idiom" : "ios-marketing",
+      "filename" : "Icon-App-1024x1024@1x.png",
+      "scale" : "1x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
new file mode 100644
index 0000000..dc9ada4
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png
new file mode 100644
index 0000000..7353c41
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png
new file mode 100644
index 0000000..797d452
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png
new file mode 100644
index 0000000..6ed2d93
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png
new file mode 100644
index 0000000..4cd7b00
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png
new file mode 100644
index 0000000..fe73094
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png
new file mode 100644
index 0000000..321773c
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png
new file mode 100644
index 0000000..797d452
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png
new file mode 100644
index 0000000..502f463
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png
new file mode 100644
index 0000000..0ec3034
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png
new file mode 100644
index 0000000..0ec3034
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png
new file mode 100644
index 0000000..e9f5fea
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png
new file mode 100644
index 0000000..84ac32a
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png
new file mode 100644
index 0000000..8953cba
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png
new file mode 100644
index 0000000..0467bf1
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json
new file mode 100644
index 0000000..0bedcf2
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json
@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "idiom" : "universal",
+      "filename" : "LaunchImage.png",
+      "scale" : "1x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "LaunchImage@2x.png",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "universal",
+      "filename" : "LaunchImage@3x.png",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png
new file mode 100644
index 0000000..9da19ea
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png
new file mode 100644
index 0000000..9da19ea
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png
new file mode 100644
index 0000000..9da19ea
Binary files /dev/null and b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png differ
diff --git a/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md
new file mode 100644
index 0000000..89c2725
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md
@@ -0,0 +1,5 @@
+# Launch Screen Assets
+
+You can customize the launch screen with your own desired assets by replacing the image files in this directory.
+
+You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images.
\ No newline at end of file
diff --git a/packages/stacflow/example/ios/Runner/Base.lproj/LaunchScreen.storyboard b/packages/stacflow/example/ios/Runner/Base.lproj/LaunchScreen.storyboard
new file mode 100644
index 0000000..f2e259c
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Base.lproj/LaunchScreen.storyboard
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="12121" systemVersion="16G29" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" colorMatched="YES" initialViewController="01J-lp-oVM">
+    <dependencies>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="12089"/>
+    </dependencies>
+    <scenes>
+        <!--View Controller-->
+        <scene sceneID="EHf-IW-A2E">
+            <objects>
+                <viewController id="01J-lp-oVM" sceneMemberID="viewController">
+                    <layoutGuides>
+                        <viewControllerLayoutGuide type="top" id="Ydg-fD-yQy"/>
+                        <viewControllerLayoutGuide type="bottom" id="xbc-2k-c8Z"/>
+                    </layoutGuides>
+                    <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <imageView opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" image="LaunchImage" translatesAutoresizingMaskIntoConstraints="NO" id="YRO-k0-Ey4">
+                            </imageView>
+                        </subviews>
+                        <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                        <constraints>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="centerX" secondItem="Ze5-6b-2t3" secondAttribute="centerX" id="1a2-6s-vTC"/>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="centerY" secondItem="Ze5-6b-2t3" secondAttribute="centerY" id="4X2-HB-R7a"/>
+                        </constraints>
+                    </view>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="iYj-Kq-Ea1" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="53" y="375"/>
+        </scene>
+    </scenes>
+    <resources>
+        <image name="LaunchImage" width="168" height="185"/>
+    </resources>
+</document>
diff --git a/packages/stacflow/example/ios/Runner/Base.lproj/Main.storyboard b/packages/stacflow/example/ios/Runner/Base.lproj/Main.storyboard
new file mode 100644
index 0000000..f3c2851
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Base.lproj/Main.storyboard
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="10117" systemVersion="15F34" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" initialViewController="BYZ-38-t0r">
+    <dependencies>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="10085"/>
+    </dependencies>
+    <scenes>
+        <!--Flutter View Controller-->
+        <scene sceneID="tne-QT-ifu">
+            <objects>
+                <viewController id="BYZ-38-t0r" customClass="FlutterViewController" sceneMemberID="viewController">
+                    <layoutGuides>
+                        <viewControllerLayoutGuide type="top" id="y3c-jy-aDJ"/>
+                        <viewControllerLayoutGuide type="bottom" id="wfy-db-euE"/>
+                    </layoutGuides>
+                    <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
+                        <rect key="frame" x="0.0" y="0.0" width="600" height="600"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                    </view>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
+            </objects>
+        </scene>
+    </scenes>
+</document>
diff --git a/packages/stacflow/example/ios/Runner/Info.plist b/packages/stacflow/example/ios/Runner/Info.plist
new file mode 100644
index 0000000..e8d1b19
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Info.plist
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>Stacflow Example</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>stacflow_example</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(FLUTTER_BUILD_NAME)</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(FLUTTER_BUILD_NUMBER)</string>
+	<key>LSRequiresIPhoneOS</key>
+	<true/>
+	<key>UIApplicationSceneManifest</key>
+	<dict>
+		<key>UIApplicationSupportsMultipleScenes</key>
+		<false/>
+		<key>UISceneConfigurations</key>
+		<dict>
+			<key>UIWindowSceneSessionRoleApplication</key>
+			<array>
+				<dict>
+					<key>UISceneClassName</key>
+					<string>UIWindowScene</string>
+					<key>UISceneConfigurationName</key>
+					<string>flutter</string>
+					<key>UISceneDelegateClassName</key>
+					<string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
+					<key>UISceneStoryboardFile</key>
+					<string>Main</string>
+				</dict>
+			</array>
+		</dict>
+	</dict>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
+	<key>UILaunchStoryboardName</key>
+	<string>LaunchScreen</string>
+	<key>UIMainStoryboardFile</key>
+	<string>Main</string>
+	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationPortraitUpsideDown</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/ios/Runner/Runner-Bridging-Header.h b/packages/stacflow/example/ios/Runner/Runner-Bridging-Header.h
new file mode 100644
index 0000000..308a2a5
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/Runner-Bridging-Header.h
@@ -0,0 +1 @@
+#import "GeneratedPluginRegistrant.h"
diff --git a/packages/stacflow/example/ios/Runner/SceneDelegate.swift b/packages/stacflow/example/ios/Runner/SceneDelegate.swift
new file mode 100644
index 0000000..b9ce8ea
--- /dev/null
+++ b/packages/stacflow/example/ios/Runner/SceneDelegate.swift
@@ -0,0 +1,6 @@
+import Flutter
+import UIKit
+
+class SceneDelegate: FlutterSceneDelegate {
+
+}
diff --git a/packages/stacflow/example/ios/RunnerTests/RunnerTests.swift b/packages/stacflow/example/ios/RunnerTests/RunnerTests.swift
new file mode 100644
index 0000000..86a7c3b
--- /dev/null
+++ b/packages/stacflow/example/ios/RunnerTests/RunnerTests.swift
@@ -0,0 +1,12 @@
+import Flutter
+import UIKit
+import XCTest
+
+class RunnerTests: XCTestCase {
+
+  func testExample() {
+    // If you add code to the Runner application, consider adding tests here.
+    // See https://developer.apple.com/documentation/xctest for more information about using XCTest.
+  }
+
+}
diff --git a/packages/stacflow/example/lib/env.example.dart b/packages/stacflow/example/lib/env.example.dart
new file mode 100644
index 0000000..a98127c
--- /dev/null
+++ b/packages/stacflow/example/lib/env.example.dart
@@ -0,0 +1 @@
+const String geminiApiKey = '';
diff --git a/packages/stacflow/example/lib/main.dart b/packages/stacflow/example/lib/main.dart
new file mode 100644
index 0000000..90e612e
--- /dev/null
+++ b/packages/stacflow/example/lib/main.dart
@@ -0,0 +1,114 @@
+import 'package:material_ui/material_ui.dart';
+import 'package:stacflow/stacflow.dart';
+
+import 'env.dart';
+
+final ValueNotifier<ThemeMode> themeMode = ValueNotifier(ThemeMode.system);
+
+void main() => runApp(const ExampleApp());
+
+class ExampleApp extends StatelessWidget {
+  const ExampleApp({super.key});
+
+  @override
+  Widget build(BuildContext context) => ValueListenableBuilder<ThemeMode>(
+    valueListenable: themeMode,
+    builder: (context, mode, _) => MaterialApp(
+      title: 'StacFlow example',
+      theme: ThemeData(extensions: [FlowTheme.light()]),
+      darkTheme: ThemeData(
+        brightness: Brightness.dark,
+        extensions: [FlowTheme.dark()],
+      ),
+      themeMode: mode,
+      home: const ChatScreen(),
+    ),
+  );
+}
+
+class ChatScreen extends StatefulWidget {
+  const ChatScreen({super.key});
+
+  @override
+  State<ChatScreen> createState() => _ChatScreenState();
+}
+
+class _ChatScreenState extends State<ChatScreen> {
+  final StacFlowChat _chat = StacFlowChat(
+    provider: GeminiProvider(
+      apiKey: const String.fromEnvironment(
+        'GEMINI_API_KEY',
+        defaultValue: geminiApiKey,
+      ),
+      models: const [
+        ModelOption(id: 'gemini-3.6-flash', label: 'Gemini 3.6 Flash'),
+        ModelOption(
+          id: 'gemini-3.5-flash-lite',
+          label: 'Gemini 3.5 Flash Lite',
+        ),
+      ],
+    ),
+    agent: const AgentConfig(instructions: 'You are a concise assistant.'),
+    tools: [
+      Tool(
+        name: 'set_theme',
+        description: 'Switches the app between light and dark mode.',
+        parameters: const {
+          'type': 'object',
+          'properties': {
+            'mode': {
+              'type': 'string',
+              'enum': ['light', 'dark', 'system'],
+              'description': 'The theme to apply.',
+            },
+          },
+          'required': ['mode'],
+        },
+        label: 'Set theme',
+        detail: (args) => args['mode'] as String?,
+        run: (call) {
+          final mode = switch (call.args['mode']) {
+            'light' => ThemeMode.light,
+            'dark' => ThemeMode.dark,
+            'system' => ThemeMode.system,
+            _ => throw const ToolException(
+              'mode must be light, dark or system',
+            ),
+          };
+          themeMode.value = mode;
+          return {'mode': mode.name};
+        },
+      ),
+    ],
+  );
+
+  @override
+  void dispose() {
+    _chat.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) => Scaffold(
+    appBar: AppBar(
+      title: const Text('StacFlow'),
+      actions: [
+        IconButton(
+          tooltip: 'New chat',
+          icon: const Icon(Icons.add_comment_outlined),
+          onPressed: _chat.newConversation,
+        ),
+      ],
+    ),
+    body: StacFlowChatView(
+      chat: _chat,
+      greeting: const FlowGreeting(text: 'What can I help with?'),
+      suggestions: const [
+        'Switch to dark mode',
+        'Explain how streaming responses work',
+        'What is the difference between const and final in Dart?',
+      ],
+      showEditAction: true,
+    ),
+  );
+}
diff --git a/packages/stacflow/example/linux/.gitignore b/packages/stacflow/example/linux/.gitignore
new file mode 100644
index 0000000..d3896c9
--- /dev/null
+++ b/packages/stacflow/example/linux/.gitignore
@@ -0,0 +1 @@
+flutter/ephemeral
diff --git a/packages/stacflow/example/linux/CMakeLists.txt b/packages/stacflow/example/linux/CMakeLists.txt
new file mode 100644
index 0000000..d518187
--- /dev/null
+++ b/packages/stacflow/example/linux/CMakeLists.txt
@@ -0,0 +1,128 @@
+# Project-level configuration.
+cmake_minimum_required(VERSION 3.13)
+project(runner LANGUAGES CXX)
+
+# The name of the executable created for the application. Change this to change
+# the on-disk name of your application.
+set(BINARY_NAME "stacflow_example")
+# The unique GTK application identifier for this application. See:
+# https://wiki.gnome.org/HowDoI/ChooseApplicationID
+set(APPLICATION_ID "dev.stac.stacflow_example")
+
+# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
+# versions of CMake.
+cmake_policy(SET CMP0063 NEW)
+
+# Load bundled libraries from the lib/ directory relative to the binary.
+set(CMAKE_INSTALL_RPATH "$ORIGIN/lib")
+
+# Root filesystem for cross-building.
+if(FLUTTER_TARGET_PLATFORM_SYSROOT)
+  set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT})
+  set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT})
+  set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+  set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
+  set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+  set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+endif()
+
+# Define build configuration options.
+if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+  set(CMAKE_BUILD_TYPE "Debug" CACHE
+    STRING "Flutter build mode" FORCE)
+  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
+    "Debug" "Profile" "Release")
+endif()
+
+# Compilation settings that should be applied to most targets.
+#
+# Be cautious about adding new options here, as plugins use this function by
+# default. In most cases, you should add new options to specific targets instead
+# of modifying this function.
+function(APPLY_STANDARD_SETTINGS TARGET)
+  target_compile_features(${TARGET} PUBLIC cxx_std_14)
+  target_compile_options(${TARGET} PRIVATE -Wall -Werror)
+  target_compile_options(${TARGET} PRIVATE "$<$<NOT:$<CONFIG:Debug>>:-O3>")
+  target_compile_definitions(${TARGET} PRIVATE "$<$<NOT:$<CONFIG:Debug>>:NDEBUG>")
+endfunction()
+
+# Flutter library and tool build rules.
+set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter")
+add_subdirectory(${FLUTTER_MANAGED_DIR})
+
+# System-level dependencies.
+find_package(PkgConfig REQUIRED)
+pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
+
+# Application build; see runner/CMakeLists.txt.
+add_subdirectory("runner")
+
+# Run the Flutter tool portions of the build. This must not be removed.
+add_dependencies(${BINARY_NAME} flutter_assemble)
+
+# Only the install-generated bundle's copy of the executable will launch
+# correctly, since the resources must in the right relative locations. To avoid
+# people trying to run the unbundled copy, put it in a subdirectory instead of
+# the default top-level location.
+set_target_properties(${BINARY_NAME}
+  PROPERTIES
+  RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run"
+)
+
+
+# Generated plugin build rules, which manage building the plugins and adding
+# them to the application.
+include(flutter/generated_plugins.cmake)
+
+
+# === Installation ===
+# By default, "installing" just makes a relocatable bundle in the build
+# directory.
+set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
+if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
+  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
+endif()
+
+# Start with a clean build bundle directory every time.
+install(CODE "
+  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
+  " COMPONENT Runtime)
+
+set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
+set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")
+
+install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
+  COMPONENT Runtime)
+
+install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
+  COMPONENT Runtime)
+
+install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+  COMPONENT Runtime)
+
+foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
+  install(FILES "${bundled_library}"
+    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+    COMPONENT Runtime)
+endforeach(bundled_library)
+
+# Copy the native assets provided by the build.dart from all packages.
+set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
+install(DIRECTORY "${NATIVE_ASSETS_DIR}"
+   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+   COMPONENT Runtime)
+
+# Fully re-copy the assets directory on each build to avoid having stale files
+# from a previous install.
+set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
+install(CODE "
+  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
+  " COMPONENT Runtime)
+install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
+  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
+
+# Install the AOT library on non-Debug builds only.
+if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
+  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+    COMPONENT Runtime)
+endif()
diff --git a/packages/stacflow/example/linux/flutter/CMakeLists.txt b/packages/stacflow/example/linux/flutter/CMakeLists.txt
new file mode 100644
index 0000000..d5bd016
--- /dev/null
+++ b/packages/stacflow/example/linux/flutter/CMakeLists.txt
@@ -0,0 +1,88 @@
+# This file controls Flutter-level build steps. It should not be edited.
+cmake_minimum_required(VERSION 3.10)
+
+set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")
+
+# Configuration provided via flutter tool.
+include(${EPHEMERAL_DIR}/generated_config.cmake)
+
+# TODO: Move the rest of this into files in ephemeral. See
+# https://github.com/flutter/flutter/issues/57146.
+
+# Serves the same purpose as list(TRANSFORM ... PREPEND ...),
+# which isn't available in 3.10.
+function(list_prepend LIST_NAME PREFIX)
+    set(NEW_LIST "")
+    foreach(element ${${LIST_NAME}})
+        list(APPEND NEW_LIST "${PREFIX}${element}")
+    endforeach(element)
+    set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE)
+endfunction()
+
+# === Flutter Library ===
+# System-level dependencies.
+find_package(PkgConfig REQUIRED)
+pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
+pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0)
+pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0)
+
+set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so")
+
+# Published to parent scope for install step.
+set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
+set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
+set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
+set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE)
+
+list(APPEND FLUTTER_LIBRARY_HEADERS
+  "fl_basic_message_channel.h"
+  "fl_binary_codec.h"
+  "fl_binary_messenger.h"
+  "fl_dart_project.h"
+  "fl_engine.h"
+  "fl_json_message_codec.h"
+  "fl_json_method_codec.h"
+  "fl_message_codec.h"
+  "fl_method_call.h"
+  "fl_method_channel.h"
+  "fl_method_codec.h"
+  "fl_method_response.h"
+  "fl_plugin_registrar.h"
+  "fl_plugin_registry.h"
+  "fl_standard_message_codec.h"
+  "fl_standard_method_codec.h"
+  "fl_string_codec.h"
+  "fl_value.h"
+  "fl_view.h"
+  "flutter_linux.h"
+)
+list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/")
+add_library(flutter INTERFACE)
+target_include_directories(flutter INTERFACE
+  "${EPHEMERAL_DIR}"
+)
+target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}")
+target_link_libraries(flutter INTERFACE
+  PkgConfig::GTK
+  PkgConfig::GLIB
+  PkgConfig::GIO
+)
+add_dependencies(flutter flutter_assemble)
+
+# === Flutter tool backend ===
+# _phony_ is a non-existent file to force this command to run every time,
+# since currently there's no way to get a full input/output list from the
+# flutter tool.
+add_custom_command(
+  OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS}
+    ${CMAKE_CURRENT_BINARY_DIR}/_phony_
+  COMMAND ${CMAKE_COMMAND} -E env
+    ${FLUTTER_TOOL_ENVIRONMENT}
+    "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh"
+      ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE}
+  VERBATIM
+)
+add_custom_target(flutter_assemble DEPENDS
+  "${FLUTTER_LIBRARY}"
+  ${FLUTTER_LIBRARY_HEADERS}
+)
diff --git a/packages/stacflow/example/linux/flutter/generated_plugin_registrant.cc b/packages/stacflow/example/linux/flutter/generated_plugin_registrant.cc
new file mode 100644
index 0000000..64a0ece
--- /dev/null
+++ b/packages/stacflow/example/linux/flutter/generated_plugin_registrant.cc
@@ -0,0 +1,15 @@
+//
+//  Generated file. Do not edit.
+//
+
+// clang-format off
+
+#include "generated_plugin_registrant.h"
+
+#include <file_selector_linux/file_selector_plugin.h>
+
+void fl_register_plugins(FlPluginRegistry* registry) {
+  g_autoptr(FlPluginRegistrar) file_selector_linux_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "FileSelectorPlugin");
+  file_selector_plugin_register_with_registrar(file_selector_linux_registrar);
+}
diff --git a/packages/stacflow/example/linux/flutter/generated_plugin_registrant.h b/packages/stacflow/example/linux/flutter/generated_plugin_registrant.h
new file mode 100644
index 0000000..e0f0a47
--- /dev/null
+++ b/packages/stacflow/example/linux/flutter/generated_plugin_registrant.h
@@ -0,0 +1,15 @@
+//
+//  Generated file. Do not edit.
+//
+
+// clang-format off
+
+#ifndef GENERATED_PLUGIN_REGISTRANT_
+#define GENERATED_PLUGIN_REGISTRANT_
+
+#include <flutter_linux/flutter_linux.h>
+
+// Registers Flutter plugins.
+void fl_register_plugins(FlPluginRegistry* registry);
+
+#endif  // GENERATED_PLUGIN_REGISTRANT_
diff --git a/packages/stacflow/example/linux/flutter/generated_plugins.cmake b/packages/stacflow/example/linux/flutter/generated_plugins.cmake
new file mode 100644
index 0000000..a630fa9
--- /dev/null
+++ b/packages/stacflow/example/linux/flutter/generated_plugins.cmake
@@ -0,0 +1,25 @@
+#
+# Generated file, do not edit.
+#
+
+list(APPEND FLUTTER_PLUGIN_LIST
+  file_selector_linux
+)
+
+list(APPEND FLUTTER_FFI_PLUGIN_LIST
+  jni
+)
+
+set(PLUGIN_BUNDLED_LIBRARIES)
+
+foreach(plugin ${FLUTTER_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin})
+  target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES $<TARGET_FILE:${plugin}_plugin>)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries})
+endforeach(plugin)
+
+foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin})
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries})
+endforeach(ffi_plugin)
diff --git a/packages/stacflow/example/linux/runner/CMakeLists.txt b/packages/stacflow/example/linux/runner/CMakeLists.txt
new file mode 100644
index 0000000..e97dabc
--- /dev/null
+++ b/packages/stacflow/example/linux/runner/CMakeLists.txt
@@ -0,0 +1,26 @@
+cmake_minimum_required(VERSION 3.13)
+project(runner LANGUAGES CXX)
+
+# Define the application target. To change its name, change BINARY_NAME in the
+# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer
+# work.
+#
+# Any new source files that you add to the application should be added here.
+add_executable(${BINARY_NAME}
+  "main.cc"
+  "my_application.cc"
+  "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc"
+)
+
+# Apply the standard set of build settings. This can be removed for applications
+# that need different build settings.
+apply_standard_settings(${BINARY_NAME})
+
+# Add preprocessor definitions for the application ID.
+add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}")
+
+# Add dependency libraries. Add any application-specific dependencies here.
+target_link_libraries(${BINARY_NAME} PRIVATE flutter)
+target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK)
+
+target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")
diff --git a/packages/stacflow/example/linux/runner/main.cc b/packages/stacflow/example/linux/runner/main.cc
new file mode 100644
index 0000000..e7c5c54
--- /dev/null
+++ b/packages/stacflow/example/linux/runner/main.cc
@@ -0,0 +1,6 @@
+#include "my_application.h"
+
+int main(int argc, char** argv) {
+  g_autoptr(MyApplication) app = my_application_new();
+  return g_application_run(G_APPLICATION(app), argc, argv);
+}
diff --git a/packages/stacflow/example/linux/runner/my_application.cc b/packages/stacflow/example/linux/runner/my_application.cc
new file mode 100644
index 0000000..449d756
--- /dev/null
+++ b/packages/stacflow/example/linux/runner/my_application.cc
@@ -0,0 +1,148 @@
+#include "my_application.h"
+
+#include <flutter_linux/flutter_linux.h>
+#ifdef GDK_WINDOWING_X11
+#include <gdk/gdkx.h>
+#endif
+
+#include "flutter/generated_plugin_registrant.h"
+
+struct _MyApplication {
+  GtkApplication parent_instance;
+  char** dart_entrypoint_arguments;
+};
+
+G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION)
+
+// Called when first Flutter frame received.
+static void first_frame_cb(MyApplication* self, FlView* view) {
+  gtk_widget_show(gtk_widget_get_toplevel(GTK_WIDGET(view)));
+}
+
+// Implements GApplication::activate.
+static void my_application_activate(GApplication* application) {
+  MyApplication* self = MY_APPLICATION(application);
+  GtkWindow* window =
+      GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application)));
+
+  // Use a header bar when running in GNOME as this is the common style used
+  // by applications and is the setup most users will be using (e.g. Ubuntu
+  // desktop).
+  // If running on X and not using GNOME then just use a traditional title bar
+  // in case the window manager does more exotic layout, e.g. tiling.
+  // If running on Wayland assume the header bar will work (may need changing
+  // if future cases occur).
+  gboolean use_header_bar = TRUE;
+#ifdef GDK_WINDOWING_X11
+  GdkScreen* screen = gtk_window_get_screen(window);
+  if (GDK_IS_X11_SCREEN(screen)) {
+    const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen);
+    if (g_strcmp0(wm_name, "GNOME Shell") != 0) {
+      use_header_bar = FALSE;
+    }
+  }
+#endif
+  if (use_header_bar) {
+    GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new());
+    gtk_widget_show(GTK_WIDGET(header_bar));
+    gtk_header_bar_set_title(header_bar, "stacflow_example");
+    gtk_header_bar_set_show_close_button(header_bar, TRUE);
+    gtk_window_set_titlebar(window, GTK_WIDGET(header_bar));
+  } else {
+    gtk_window_set_title(window, "stacflow_example");
+  }
+
+  gtk_window_set_default_size(window, 1280, 720);
+
+  g_autoptr(FlDartProject) project = fl_dart_project_new();
+  fl_dart_project_set_dart_entrypoint_arguments(
+      project, self->dart_entrypoint_arguments);
+
+  FlView* view = fl_view_new(project);
+  GdkRGBA background_color;
+  // Background defaults to black, override it here if necessary, e.g. #00000000
+  // for transparent.
+  gdk_rgba_parse(&background_color, "#000000");
+  fl_view_set_background_color(view, &background_color);
+  gtk_widget_show(GTK_WIDGET(view));
+  gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view));
+
+  // Show the window when Flutter renders.
+  // Requires the view to be realized so we can start rendering.
+  g_signal_connect_swapped(view, "first-frame", G_CALLBACK(first_frame_cb),
+                           self);
+  gtk_widget_realize(GTK_WIDGET(view));
+
+  fl_register_plugins(FL_PLUGIN_REGISTRY(view));
+
+  gtk_widget_grab_focus(GTK_WIDGET(view));
+}
+
+// Implements GApplication::local_command_line.
+static gboolean my_application_local_command_line(GApplication* application,
+                                                  gchar*** arguments,
+                                                  int* exit_status) {
+  MyApplication* self = MY_APPLICATION(application);
+  // Strip out the first argument as it is the binary name.
+  self->dart_entrypoint_arguments = g_strdupv(*arguments + 1);
+
+  g_autoptr(GError) error = nullptr;
+  if (!g_application_register(application, nullptr, &error)) {
+    g_warning("Failed to register: %s", error->message);
+    *exit_status = 1;
+    return TRUE;
+  }
+
+  g_application_activate(application);
+  *exit_status = 0;
+
+  return TRUE;
+}
+
+// Implements GApplication::startup.
+static void my_application_startup(GApplication* application) {
+  // MyApplication* self = MY_APPLICATION(object);
+
+  // Perform any actions required at application startup.
+
+  G_APPLICATION_CLASS(my_application_parent_class)->startup(application);
+}
+
+// Implements GApplication::shutdown.
+static void my_application_shutdown(GApplication* application) {
+  // MyApplication* self = MY_APPLICATION(object);
+
+  // Perform any actions required at application shutdown.
+
+  G_APPLICATION_CLASS(my_application_parent_class)->shutdown(application);
+}
+
+// Implements GObject::dispose.
+static void my_application_dispose(GObject* object) {
+  MyApplication* self = MY_APPLICATION(object);
+  g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev);
+  G_OBJECT_CLASS(my_application_parent_class)->dispose(object);
+}
+
+static void my_application_class_init(MyApplicationClass* klass) {
+  G_APPLICATION_CLASS(klass)->activate = my_application_activate;
+  G_APPLICATION_CLASS(klass)->local_command_line =
+      my_application_local_command_line;
+  G_APPLICATION_CLASS(klass)->startup = my_application_startup;
+  G_APPLICATION_CLASS(klass)->shutdown = my_application_shutdown;
+  G_OBJECT_CLASS(klass)->dispose = my_application_dispose;
+}
+
+static void my_application_init(MyApplication* self) {}
+
+MyApplication* my_application_new() {
+  // Set the program name to the application ID, which helps various systems
+  // like GTK and desktop environments map this running application to its
+  // corresponding .desktop file. This ensures better integration by allowing
+  // the application to be recognized beyond its binary name.
+  g_set_prgname(APPLICATION_ID);
+
+  return MY_APPLICATION(g_object_new(my_application_get_type(),
+                                     "application-id", APPLICATION_ID, "flags",
+                                     G_APPLICATION_NON_UNIQUE, nullptr));
+}
diff --git a/packages/stacflow/example/linux/runner/my_application.h b/packages/stacflow/example/linux/runner/my_application.h
new file mode 100644
index 0000000..db16367
--- /dev/null
+++ b/packages/stacflow/example/linux/runner/my_application.h
@@ -0,0 +1,21 @@
+#ifndef FLUTTER_MY_APPLICATION_H_
+#define FLUTTER_MY_APPLICATION_H_
+
+#include <gtk/gtk.h>
+
+G_DECLARE_FINAL_TYPE(MyApplication,
+                     my_application,
+                     MY,
+                     APPLICATION,
+                     GtkApplication)
+
+/**
+ * my_application_new:
+ *
+ * Creates a new Flutter-based application.
+ *
+ * Returns: a new #MyApplication.
+ */
+MyApplication* my_application_new();
+
+#endif  // FLUTTER_MY_APPLICATION_H_
diff --git a/packages/stacflow/example/macos/.gitignore b/packages/stacflow/example/macos/.gitignore
new file mode 100644
index 0000000..746adbb
--- /dev/null
+++ b/packages/stacflow/example/macos/.gitignore
@@ -0,0 +1,7 @@
+# Flutter-related
+**/Flutter/ephemeral/
+**/Pods/
+
+# Xcode-related
+**/dgph
+**/xcuserdata/
diff --git a/packages/stacflow/example/macos/Flutter/Flutter-Debug.xcconfig b/packages/stacflow/example/macos/Flutter/Flutter-Debug.xcconfig
new file mode 100644
index 0000000..c2efd0b
--- /dev/null
+++ b/packages/stacflow/example/macos/Flutter/Flutter-Debug.xcconfig
@@ -0,0 +1 @@
+#include "ephemeral/Flutter-Generated.xcconfig"
diff --git a/packages/stacflow/example/macos/Flutter/Flutter-Release.xcconfig b/packages/stacflow/example/macos/Flutter/Flutter-Release.xcconfig
new file mode 100644
index 0000000..c2efd0b
--- /dev/null
+++ b/packages/stacflow/example/macos/Flutter/Flutter-Release.xcconfig
@@ -0,0 +1 @@
+#include "ephemeral/Flutter-Generated.xcconfig"
diff --git a/packages/stacflow/example/macos/Flutter/GeneratedPluginRegistrant.swift b/packages/stacflow/example/macos/Flutter/GeneratedPluginRegistrant.swift
new file mode 100644
index 0000000..14b5f7c
--- /dev/null
+++ b/packages/stacflow/example/macos/Flutter/GeneratedPluginRegistrant.swift
@@ -0,0 +1,12 @@
+//
+//  Generated file. Do not edit.
+//
+
+import FlutterMacOS
+import Foundation
+
+import file_selector_macos
+
+func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
+  FileSelectorPlugin.register(with: registry.registrar(forPlugin: "FileSelectorPlugin"))
+}
diff --git a/packages/stacflow/example/macos/Runner.xcodeproj/project.pbxproj b/packages/stacflow/example/macos/Runner.xcodeproj/project.pbxproj
new file mode 100644
index 0000000..c533a9c
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner.xcodeproj/project.pbxproj
@@ -0,0 +1,729 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 54;
+	objects = {
+
+/* Begin PBXAggregateTarget section */
+		33CC111A2044C6BA0003C045 /* Flutter Assemble */ = {
+			isa = PBXAggregateTarget;
+			buildConfigurationList = 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */;
+			buildPhases = (
+				33CC111E2044C6BF0003C045 /* ShellScript */,
+			);
+			dependencies = (
+			);
+			name = "Flutter Assemble";
+			productName = FLX;
+		};
+/* End PBXAggregateTarget section */
+
+/* Begin PBXBuildFile section */
+		331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C80D7294CF71000263BE5 /* RunnerTests.swift */; };
+		335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */ = {isa = PBXBuildFile; fileRef = 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */; };
+		33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC10F02044A3C60003C045 /* AppDelegate.swift */; };
+		33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F22044A3C60003C045 /* Assets.xcassets */; };
+		33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F42044A3C60003C045 /* MainMenu.xib */; };
+		33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */; };
+		78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */ = {isa = PBXBuildFile; productRef = 78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXContainerItemProxy section */
+		331C80D9294CF71000263BE5 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 33CC10E52044A3C60003C045 /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 33CC10EC2044A3C60003C045;
+			remoteInfo = Runner;
+		};
+		33CC111F2044C79F0003C045 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 33CC10E52044A3C60003C045 /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 33CC111A2044C6BA0003C045;
+			remoteInfo = FLX;
+		};
+/* End PBXContainerItemProxy section */
+
+/* Begin PBXCopyFilesBuildPhase section */
+		33CC110E2044A8840003C045 /* Bundle Framework */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "";
+			dstSubfolderSpec = 10;
+			files = (
+			);
+			name = "Bundle Framework";
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		331C80D5294CF71000263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
+		331C80D7294CF71000263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = "<group>"; };
+		333000ED22D3DE5D00554162 /* Warnings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Warnings.xcconfig; sourceTree = "<group>"; };
+		335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = GeneratedPluginRegistrant.swift; sourceTree = "<group>"; };
+		33CC10ED2044A3C60003C045 /* stacflow_example.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "stacflow_example.app"; sourceTree = BUILT_PRODUCTS_DIR; };
+		33CC10F02044A3C60003C045 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+		33CC10F22044A3C60003C045 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; name = Assets.xcassets; path = Runner/Assets.xcassets; sourceTree = "<group>"; };
+		33CC10F52044A3C60003C045 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/MainMenu.xib; sourceTree = "<group>"; };
+		33CC10F72044A3C60003C045 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = Info.plist; path = Runner/Info.plist; sourceTree = "<group>"; };
+		33CC11122044BFA00003C045 /* MainFlutterWindow.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainFlutterWindow.swift; sourceTree = "<group>"; };
+		33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Debug.xcconfig"; sourceTree = "<group>"; };
+		33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Release.xcconfig"; sourceTree = "<group>"; };
+		33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = "Flutter-Generated.xcconfig"; path = "ephemeral/Flutter-Generated.xcconfig"; sourceTree = "<group>"; };
+		33E51913231747F40026EE4D /* DebugProfile.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DebugProfile.entitlements; sourceTree = "<group>"; };
+		33E51914231749380026EE4D /* Release.entitlements */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.entitlements; path = Release.entitlements; sourceTree = "<group>"; };
+		33E5194F232828860026EE4D /* AppInfo.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = AppInfo.xcconfig; sourceTree = "<group>"; };
+		78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */ = {isa = PBXFileReference; lastKnownFileType = wrapper; name = FlutterGeneratedPluginSwiftPackage; path = ephemeral/Packages/FlutterGeneratedPluginSwiftPackage; sourceTree = "<group>"; };
+		7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Release.xcconfig; sourceTree = "<group>"; };
+		9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; path = Debug.xcconfig; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		331C80D2294CF70F00263BE5 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		33CC10EA2044A3C60003C045 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		331C80D6294CF71000263BE5 /* RunnerTests */ = {
+			isa = PBXGroup;
+			children = (
+				331C80D7294CF71000263BE5 /* RunnerTests.swift */,
+			);
+			path = RunnerTests;
+			sourceTree = "<group>";
+		};
+		33BA886A226E78AF003329D5 /* Configs */ = {
+			isa = PBXGroup;
+			children = (
+				33E5194F232828860026EE4D /* AppInfo.xcconfig */,
+				9740EEB21CF90195004384FC /* Debug.xcconfig */,
+				7AFA3C8E1D35360C0083082E /* Release.xcconfig */,
+				333000ED22D3DE5D00554162 /* Warnings.xcconfig */,
+			);
+			path = Configs;
+			sourceTree = "<group>";
+		};
+		33CC10E42044A3C60003C045 = {
+			isa = PBXGroup;
+			children = (
+				33FAB671232836740065AC1E /* Runner */,
+				33CEB47122A05771004F2AC0 /* Flutter */,
+				331C80D6294CF71000263BE5 /* RunnerTests */,
+				33CC10EE2044A3C60003C045 /* Products */,
+				D73912EC22F37F3D000D13A0 /* Frameworks */,
+			);
+			sourceTree = "<group>";
+		};
+		33CC10EE2044A3C60003C045 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				33CC10ED2044A3C60003C045 /* stacflow_example.app */,
+				331C80D5294CF71000263BE5 /* RunnerTests.xctest */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		33CC11242044D66E0003C045 /* Resources */ = {
+			isa = PBXGroup;
+			children = (
+				33CC10F22044A3C60003C045 /* Assets.xcassets */,
+				33CC10F42044A3C60003C045 /* MainMenu.xib */,
+				33CC10F72044A3C60003C045 /* Info.plist */,
+			);
+			name = Resources;
+			path = ..;
+			sourceTree = "<group>";
+		};
+		33CEB47122A05771004F2AC0 /* Flutter */ = {
+			isa = PBXGroup;
+			children = (
+				78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */,
+				335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */,
+				33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */,
+				33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */,
+				33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */,
+			);
+			path = Flutter;
+			sourceTree = "<group>";
+		};
+		33FAB671232836740065AC1E /* Runner */ = {
+			isa = PBXGroup;
+			children = (
+				33CC10F02044A3C60003C045 /* AppDelegate.swift */,
+				33CC11122044BFA00003C045 /* MainFlutterWindow.swift */,
+				33E51913231747F40026EE4D /* DebugProfile.entitlements */,
+				33E51914231749380026EE4D /* Release.entitlements */,
+				33CC11242044D66E0003C045 /* Resources */,
+				33BA886A226E78AF003329D5 /* Configs */,
+			);
+			path = Runner;
+			sourceTree = "<group>";
+		};
+		D73912EC22F37F3D000D13A0 /* Frameworks */ = {
+			isa = PBXGroup;
+			children = (
+			);
+			name = Frameworks;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		331C80D4294CF70F00263BE5 /* RunnerTests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */;
+			buildPhases = (
+				331C80D1294CF70F00263BE5 /* Sources */,
+				331C80D2294CF70F00263BE5 /* Frameworks */,
+				331C80D3294CF70F00263BE5 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				331C80DA294CF71000263BE5 /* PBXTargetDependency */,
+			);
+			name = RunnerTests;
+			productName = RunnerTests;
+			productReference = 331C80D5294CF71000263BE5 /* RunnerTests.xctest */;
+			productType = "com.apple.product-type.bundle.unit-test";
+		};
+		33CC10EC2044A3C60003C045 /* Runner */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */;
+			buildPhases = (
+				33CC10E92044A3C60003C045 /* Sources */,
+				33CC10EA2044A3C60003C045 /* Frameworks */,
+				33CC10EB2044A3C60003C045 /* Resources */,
+				33CC110E2044A8840003C045 /* Bundle Framework */,
+				3399D490228B24CF009A79C7 /* ShellScript */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				33CC11202044C79F0003C045 /* PBXTargetDependency */,
+			);
+			name = Runner;
+			packageProductDependencies = (
+				78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */,
+			);
+			productName = Runner;
+			productReference = 33CC10ED2044A3C60003C045 /* stacflow_example.app */;
+			productType = "com.apple.product-type.application";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		33CC10E52044A3C60003C045 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				BuildIndependentTargetsInParallel = YES;
+				LastSwiftUpdateCheck = 0920;
+				LastUpgradeCheck = 1510;
+				ORGANIZATIONNAME = "";
+				TargetAttributes = {
+					331C80D4294CF70F00263BE5 = {
+						CreatedOnToolsVersion = 14.0;
+						TestTargetID = 33CC10EC2044A3C60003C045;
+					};
+					33CC10EC2044A3C60003C045 = {
+						CreatedOnToolsVersion = 9.2;
+						LastSwiftMigration = 1100;
+						ProvisioningStyle = Automatic;
+						SystemCapabilities = {
+							com.apple.Sandbox = {
+								enabled = 1;
+							};
+						};
+					};
+					33CC111A2044C6BA0003C045 = {
+						CreatedOnToolsVersion = 9.2;
+						ProvisioningStyle = Manual;
+					};
+				};
+			};
+			buildConfigurationList = 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */;
+			compatibilityVersion = "Xcode 9.3";
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 33CC10E42044A3C60003C045;
+			packageReferences = (
+				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */,
+			);
+			productRefGroup = 33CC10EE2044A3C60003C045 /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				33CC10EC2044A3C60003C045 /* Runner */,
+				331C80D4294CF70F00263BE5 /* RunnerTests */,
+				33CC111A2044C6BA0003C045 /* Flutter Assemble */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		331C80D3294CF70F00263BE5 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		33CC10EB2044A3C60003C045 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */,
+				33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXShellScriptBuildPhase section */
+		3399D490228B24CF009A79C7 /* ShellScript */ = {
+			isa = PBXShellScriptBuildPhase;
+			alwaysOutOfDate = 1;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+			);
+			inputPaths = (
+			);
+			outputFileListPaths = (
+			);
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "echo \"$PRODUCT_NAME.app\" > \"$PROJECT_DIR\"/Flutter/ephemeral/.app_filename && \"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh embed\n";
+		};
+		33CC111E2044C6BF0003C045 /* ShellScript */ = {
+			isa = PBXShellScriptBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+				Flutter/ephemeral/FlutterInputs.xcfilelist,
+			);
+			inputPaths = (
+				Flutter/ephemeral/tripwire,
+			);
+			outputFileListPaths = (
+				Flutter/ephemeral/FlutterOutputs.xcfilelist,
+			);
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "\"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh && touch Flutter/ephemeral/tripwire";
+		};
+/* End PBXShellScriptBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		331C80D1294CF70F00263BE5 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		33CC10E92044A3C60003C045 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */,
+				33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */,
+				335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXTargetDependency section */
+		331C80DA294CF71000263BE5 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 33CC10EC2044A3C60003C045 /* Runner */;
+			targetProxy = 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */;
+		};
+		33CC11202044C79F0003C045 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 33CC111A2044C6BA0003C045 /* Flutter Assemble */;
+			targetProxy = 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */;
+		};
+/* End PBXTargetDependency section */
+
+/* Begin PBXVariantGroup section */
+		33CC10F42044A3C60003C045 /* MainMenu.xib */ = {
+			isa = PBXVariantGroup;
+			children = (
+				33CC10F52044A3C60003C045 /* Base */,
+			);
+			name = MainMenu.xib;
+			path = Runner;
+			sourceTree = "<group>";
+		};
+/* End PBXVariantGroup section */
+
+/* Begin XCBuildConfiguration section */
+		331C80DB294CF71000263BE5 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/stacflow_example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/stacflow_example";
+			};
+			name = Debug;
+		};
+		331C80DC294CF71000263BE5 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/stacflow_example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/stacflow_example";
+			};
+			name = Release;
+		};
+		331C80DD294CF71000263BE5 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CURRENT_PROJECT_VERSION = 1;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample.RunnerTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/stacflow_example.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/stacflow_example";
+			};
+			name = Profile;
+		};
+		338D0CE9231458BD00FA5F75 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CODE_SIGN_IDENTITY = "-";
+				COPY_PHASE_STRIP = NO;
+				DEAD_CODE_STRIPPING = YES;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu11;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 12.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = macosx;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+			};
+			name = Profile;
+		};
+		338D0CEA231458BD00FA5F75 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Profile;
+		};
+		338D0CEB231458BD00FA5F75 /* Profile */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_STYLE = Manual;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+			};
+			name = Profile;
+		};
+		33CC10F92044A3C60003C045 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CODE_SIGN_IDENTITY = "-";
+				COPY_PHASE_STRIP = NO;
+				DEAD_CODE_STRIPPING = YES;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu11;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 12.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = macosx;
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+			};
+			name = Debug;
+		};
+		33CC10FA2044A3C60003C045 /* Release */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CODE_SIGN_IDENTITY = "-";
+				COPY_PHASE_STRIP = NO;
+				DEAD_CODE_STRIPPING = YES;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				GCC_C_LANGUAGE_STANDARD = gnu11;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 12.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = macosx;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+			};
+			name = Release;
+		};
+		33CC10FC2044A3C60003C045 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Debug;
+		};
+		33CC10FD2044A3C60003C045 /* Release */ = {
+			isa = XCBuildConfiguration;
+			baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_ENTITLEMENTS = Runner/Release.entitlements;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				INFOPLIST_FILE = Runner/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Release;
+		};
+		33CC111C2044C6BA0003C045 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_STYLE = Manual;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+			};
+			name = Debug;
+		};
+		33CC111D2044C6BA0003C045 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_STYLE = Automatic;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				331C80DB294CF71000263BE5 /* Debug */,
+				331C80DC294CF71000263BE5 /* Release */,
+				331C80DD294CF71000263BE5 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				33CC10F92044A3C60003C045 /* Debug */,
+				33CC10FA2044A3C60003C045 /* Release */,
+				338D0CE9231458BD00FA5F75 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				33CC10FC2044A3C60003C045 /* Debug */,
+				33CC10FD2044A3C60003C045 /* Release */,
+				338D0CEA231458BD00FA5F75 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				33CC111C2044C6BA0003C045 /* Debug */,
+				33CC111D2044C6BA0003C045 /* Release */,
+				338D0CEB231458BD00FA5F75 /* Profile */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+
+/* Begin XCLocalSwiftPackageReference section */
+		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */ = {
+			isa = XCLocalSwiftPackageReference;
+			relativePath = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage;
+		};
+/* End XCLocalSwiftPackageReference section */
+
+/* Begin XCSwiftPackageProductDependency section */
+		78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */ = {
+			isa = XCSwiftPackageProductDependency;
+			productName = FlutterGeneratedPluginSwiftPackage;
+		};
+/* End XCSwiftPackageProductDependency section */
+	};
+	rootObject = 33CC10E52044A3C60003C045 /* Project object */;
+}
diff --git a/packages/stacflow/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/stacflow/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 0000000..18d9810
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/packages/stacflow/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
new file mode 100644
index 0000000..c5404e8
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1510"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <PreActions>
+         <ExecutionAction
+            ActionType = "Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction">
+            <ActionContent
+               title = "Run Prepare Flutter Framework Script"
+               scriptText = "&quot;$FLUTTER_ROOT&quot;/packages/flutter_tools/bin/macos_assemble.sh prepare&#10;">
+               <EnvironmentBuildable>
+                  <BuildableReference
+                     BuildableIdentifier = "primary"
+                     BlueprintIdentifier = "33CC10EC2044A3C60003C045"
+                     BuildableName = "stacflow_example.app"
+                     BlueprintName = "Runner"
+                     ReferencedContainer = "container:Runner.xcodeproj">
+                  </BuildableReference>
+               </EnvironmentBuildable>
+            </ActionContent>
+         </ExecutionAction>
+      </PreActions>
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "33CC10EC2044A3C60003C045"
+               BuildableName = "stacflow_example.app"
+               BlueprintName = "Runner"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "33CC10EC2044A3C60003C045"
+            BuildableName = "stacflow_example.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <Testables>
+         <TestableReference
+            skipped = "NO"
+            parallelizable = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "331C80D4294CF70F00263BE5"
+               BuildableName = "RunnerTests.xctest"
+               BlueprintName = "RunnerTests"
+               ReferencedContainer = "container:Runner.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      enableGPUValidationMode = "1"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "33CC10EC2044A3C60003C045"
+            BuildableName = "stacflow_example.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Profile"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "33CC10EC2044A3C60003C045"
+            BuildableName = "stacflow_example.app"
+            BlueprintName = "Runner"
+            ReferencedContainer = "container:Runner.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>
diff --git a/packages/stacflow/example/macos/Runner.xcworkspace/contents.xcworkspacedata b/packages/stacflow/example/macos/Runner.xcworkspace/contents.xcworkspacedata
new file mode 100644
index 0000000..1d526a1
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner.xcworkspace/contents.xcworkspacedata
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "group:Runner.xcodeproj">
+   </FileRef>
+</Workspace>
diff --git a/packages/stacflow/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/packages/stacflow/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
new file mode 100644
index 0000000..18d9810
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/macos/Runner/AppDelegate.swift b/packages/stacflow/example/macos/Runner/AppDelegate.swift
new file mode 100644
index 0000000..b3c1761
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/AppDelegate.swift
@@ -0,0 +1,13 @@
+import Cocoa
+import FlutterMacOS
+
+@main
+class AppDelegate: FlutterAppDelegate {
+  override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
+    return true
+  }
+
+  override func applicationSupportsSecureRestorableState(_ app: NSApplication) -> Bool {
+    return true
+  }
+}
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
new file mode 100644
index 0000000..a2ec33f
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json
@@ -0,0 +1,68 @@
+{
+  "images" : [
+    {
+      "size" : "16x16",
+      "idiom" : "mac",
+      "filename" : "app_icon_16.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "16x16",
+      "idiom" : "mac",
+      "filename" : "app_icon_32.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "32x32",
+      "idiom" : "mac",
+      "filename" : "app_icon_32.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "32x32",
+      "idiom" : "mac",
+      "filename" : "app_icon_64.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "128x128",
+      "idiom" : "mac",
+      "filename" : "app_icon_128.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "128x128",
+      "idiom" : "mac",
+      "filename" : "app_icon_256.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "256x256",
+      "idiom" : "mac",
+      "filename" : "app_icon_256.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "256x256",
+      "idiom" : "mac",
+      "filename" : "app_icon_512.png",
+      "scale" : "2x"
+    },
+    {
+      "size" : "512x512",
+      "idiom" : "mac",
+      "filename" : "app_icon_512.png",
+      "scale" : "1x"
+    },
+    {
+      "size" : "512x512",
+      "idiom" : "mac",
+      "filename" : "app_icon_1024.png",
+      "scale" : "2x"
+    }
+  ],
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png
new file mode 100644
index 0000000..82b6f9d
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png
new file mode 100644
index 0000000..13b35eb
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png
new file mode 100644
index 0000000..0a3f5fa
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png
new file mode 100644
index 0000000..bdb5722
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png
new file mode 100644
index 0000000..f083318
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png
new file mode 100644
index 0000000..326c0e7
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png differ
diff --git a/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png
new file mode 100644
index 0000000..2f1632c
Binary files /dev/null and b/packages/stacflow/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png differ
diff --git a/packages/stacflow/example/macos/Runner/Base.lproj/MainMenu.xib b/packages/stacflow/example/macos/Runner/Base.lproj/MainMenu.xib
new file mode 100644
index 0000000..80e867a
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Base.lproj/MainMenu.xib
@@ -0,0 +1,343 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.Cocoa.XIB" version="3.0" toolsVersion="14490.70" targetRuntime="MacOSX.Cocoa" propertyAccessControl="none" useAutolayout="YES" customObjectInstantitationMethod="direct">
+    <dependencies>
+        <deployment identifier="macosx"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.CocoaPlugin" version="14490.70"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+    </dependencies>
+    <objects>
+        <customObject id="-2" userLabel="File's Owner" customClass="NSApplication">
+            <connections>
+                <outlet property="delegate" destination="Voe-Tx-rLC" id="GzC-gU-4Uq"/>
+            </connections>
+        </customObject>
+        <customObject id="-1" userLabel="First Responder" customClass="FirstResponder"/>
+        <customObject id="-3" userLabel="Application" customClass="NSObject"/>
+        <customObject id="Voe-Tx-rLC" customClass="AppDelegate" customModule="Runner" customModuleProvider="target">
+            <connections>
+                <outlet property="applicationMenu" destination="uQy-DD-JDr" id="XBo-yE-nKs"/>
+                <outlet property="mainFlutterWindow" destination="QvC-M9-y7g" id="gIp-Ho-8D9"/>
+            </connections>
+        </customObject>
+        <customObject id="YLy-65-1bz" customClass="NSFontManager"/>
+        <menu title="Main Menu" systemMenu="main" id="AYu-sK-qS6">
+            <items>
+                <menuItem title="APP_NAME" id="1Xt-HY-uBw">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="APP_NAME" systemMenu="apple" id="uQy-DD-JDr">
+                        <items>
+                            <menuItem title="About APP_NAME" id="5kV-Vb-QxS">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="orderFrontStandardAboutPanel:" target="-1" id="Exp-CZ-Vem"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="VOq-y0-SEH"/>
+                            <menuItem title="Preferences…" keyEquivalent="," id="BOF-NM-1cW"/>
+                            <menuItem isSeparatorItem="YES" id="wFC-TO-SCJ"/>
+                            <menuItem title="Services" id="NMo-om-nkz">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Services" systemMenu="services" id="hz9-B4-Xy5"/>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="4je-JR-u6R"/>
+                            <menuItem title="Hide APP_NAME" keyEquivalent="h" id="Olw-nP-bQN">
+                                <connections>
+                                    <action selector="hide:" target="-1" id="PnN-Uc-m68"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Hide Others" keyEquivalent="h" id="Vdr-fp-XzO">
+                                <modifierMask key="keyEquivalentModifierMask" option="YES" command="YES"/>
+                                <connections>
+                                    <action selector="hideOtherApplications:" target="-1" id="VT4-aY-XCT"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Show All" id="Kd2-mp-pUS">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="unhideAllApplications:" target="-1" id="Dhg-Le-xox"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="kCx-OE-vgT"/>
+                            <menuItem title="Quit APP_NAME" keyEquivalent="q" id="4sb-4s-VLi">
+                                <connections>
+                                    <action selector="terminate:" target="-1" id="Te7-pn-YzF"/>
+                                </connections>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+                <menuItem title="Edit" id="5QF-Oa-p0T">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="Edit" id="W48-6f-4Dl">
+                        <items>
+                            <menuItem title="Undo" keyEquivalent="z" id="dRJ-4n-Yzg">
+                                <connections>
+                                    <action selector="undo:" target="-1" id="M6e-cu-g7V"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Redo" keyEquivalent="Z" id="6dh-zS-Vam">
+                                <connections>
+                                    <action selector="redo:" target="-1" id="oIA-Rs-6OD"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="WRV-NI-Exz"/>
+                            <menuItem title="Cut" keyEquivalent="x" id="uRl-iY-unG">
+                                <connections>
+                                    <action selector="cut:" target="-1" id="YJe-68-I9s"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Copy" keyEquivalent="c" id="x3v-GG-iWU">
+                                <connections>
+                                    <action selector="copy:" target="-1" id="G1f-GL-Joy"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Paste" keyEquivalent="v" id="gVA-U4-sdL">
+                                <connections>
+                                    <action selector="paste:" target="-1" id="UvS-8e-Qdg"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Paste and Match Style" keyEquivalent="V" id="WeT-3V-zwk">
+                                <modifierMask key="keyEquivalentModifierMask" option="YES" command="YES"/>
+                                <connections>
+                                    <action selector="pasteAsPlainText:" target="-1" id="cEh-KX-wJQ"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Delete" id="pa3-QI-u2k">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="delete:" target="-1" id="0Mk-Ml-PaM"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Select All" keyEquivalent="a" id="Ruw-6m-B2m">
+                                <connections>
+                                    <action selector="selectAll:" target="-1" id="VNm-Mi-diN"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="uyl-h8-XO2"/>
+                            <menuItem title="Find" id="4EN-yA-p0u">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Find" id="1b7-l0-nxx">
+                                    <items>
+                                        <menuItem title="Find…" tag="1" keyEquivalent="f" id="Xz5-n4-O0W">
+                                            <connections>
+                                                <action selector="performFindPanelAction:" target="-1" id="cD7-Qs-BN4"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Find and Replace…" tag="12" keyEquivalent="f" id="YEy-JH-Tfz">
+                                            <modifierMask key="keyEquivalentModifierMask" option="YES" command="YES"/>
+                                            <connections>
+                                                <action selector="performFindPanelAction:" target="-1" id="WD3-Gg-5AJ"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Find Next" tag="2" keyEquivalent="g" id="q09-fT-Sye">
+                                            <connections>
+                                                <action selector="performFindPanelAction:" target="-1" id="NDo-RZ-v9R"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Find Previous" tag="3" keyEquivalent="G" id="OwM-mh-QMV">
+                                            <connections>
+                                                <action selector="performFindPanelAction:" target="-1" id="HOh-sY-3ay"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Use Selection for Find" tag="7" keyEquivalent="e" id="buJ-ug-pKt">
+                                            <connections>
+                                                <action selector="performFindPanelAction:" target="-1" id="U76-nv-p5D"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Jump to Selection" keyEquivalent="j" id="S0p-oC-mLd">
+                                            <connections>
+                                                <action selector="centerSelectionInVisibleArea:" target="-1" id="IOG-6D-g5B"/>
+                                            </connections>
+                                        </menuItem>
+                                    </items>
+                                </menu>
+                            </menuItem>
+                            <menuItem title="Spelling and Grammar" id="Dv1-io-Yv7">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Spelling" id="3IN-sU-3Bg">
+                                    <items>
+                                        <menuItem title="Show Spelling and Grammar" keyEquivalent=":" id="HFo-cy-zxI">
+                                            <connections>
+                                                <action selector="showGuessPanel:" target="-1" id="vFj-Ks-hy3"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Check Document Now" keyEquivalent=";" id="hz2-CU-CR7">
+                                            <connections>
+                                                <action selector="checkSpelling:" target="-1" id="fz7-VC-reM"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem isSeparatorItem="YES" id="bNw-od-mp5"/>
+                                        <menuItem title="Check Spelling While Typing" id="rbD-Rh-wIN">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleContinuousSpellChecking:" target="-1" id="7w6-Qz-0kB"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Check Grammar With Spelling" id="mK6-2p-4JG">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleGrammarChecking:" target="-1" id="muD-Qn-j4w"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Correct Spelling Automatically" id="78Y-hA-62v">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticSpellingCorrection:" target="-1" id="2lM-Qi-WAP"/>
+                                            </connections>
+                                        </menuItem>
+                                    </items>
+                                </menu>
+                            </menuItem>
+                            <menuItem title="Substitutions" id="9ic-FL-obx">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Substitutions" id="FeM-D8-WVr">
+                                    <items>
+                                        <menuItem title="Show Substitutions" id="z6F-FW-3nz">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="orderFrontSubstitutionsPanel:" target="-1" id="oku-mr-iSq"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem isSeparatorItem="YES" id="gPx-C9-uUO"/>
+                                        <menuItem title="Smart Copy/Paste" id="9yt-4B-nSM">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleSmartInsertDelete:" target="-1" id="3IJ-Se-DZD"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Smart Quotes" id="hQb-2v-fYv">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticQuoteSubstitution:" target="-1" id="ptq-xd-QOA"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Smart Dashes" id="rgM-f4-ycn">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticDashSubstitution:" target="-1" id="oCt-pO-9gS"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Smart Links" id="cwL-P1-jid">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticLinkDetection:" target="-1" id="Gip-E3-Fov"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Data Detectors" id="tRr-pd-1PS">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticDataDetection:" target="-1" id="R1I-Nq-Kbl"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Text Replacement" id="HFQ-gK-NFA">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="toggleAutomaticTextReplacement:" target="-1" id="DvP-Fe-Py6"/>
+                                            </connections>
+                                        </menuItem>
+                                    </items>
+                                </menu>
+                            </menuItem>
+                            <menuItem title="Transformations" id="2oI-Rn-ZJC">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Transformations" id="c8a-y6-VQd">
+                                    <items>
+                                        <menuItem title="Make Upper Case" id="vmV-6d-7jI">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="uppercaseWord:" target="-1" id="sPh-Tk-edu"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Make Lower Case" id="d9M-CD-aMd">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="lowercaseWord:" target="-1" id="iUZ-b5-hil"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Capitalize" id="UEZ-Bs-lqG">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="capitalizeWord:" target="-1" id="26H-TL-nsh"/>
+                                            </connections>
+                                        </menuItem>
+                                    </items>
+                                </menu>
+                            </menuItem>
+                            <menuItem title="Speech" id="xrE-MZ-jX0">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Speech" id="3rS-ZA-NoH">
+                                    <items>
+                                        <menuItem title="Start Speaking" id="Ynk-f8-cLZ">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="startSpeaking:" target="-1" id="654-Ng-kyl"/>
+                                            </connections>
+                                        </menuItem>
+                                        <menuItem title="Stop Speaking" id="Oyz-dy-DGm">
+                                            <modifierMask key="keyEquivalentModifierMask"/>
+                                            <connections>
+                                                <action selector="stopSpeaking:" target="-1" id="dX8-6p-jy9"/>
+                                            </connections>
+                                        </menuItem>
+                                    </items>
+                                </menu>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+                <menuItem title="View" id="H8h-7b-M4v">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="View" id="HyV-fh-RgO">
+                        <items>
+                            <menuItem title="Enter Full Screen" keyEquivalent="f" id="4J7-dP-txa">
+                                <modifierMask key="keyEquivalentModifierMask" control="YES" command="YES"/>
+                                <connections>
+                                    <action selector="toggleFullScreen:" target="-1" id="dU3-MA-1Rq"/>
+                                </connections>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+                <menuItem title="Window" id="aUF-d1-5bR">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="Window" systemMenu="window" id="Td7-aD-5lo">
+                        <items>
+                            <menuItem title="Minimize" keyEquivalent="m" id="OY7-WF-poV">
+                                <connections>
+                                    <action selector="performMiniaturize:" target="-1" id="VwT-WD-YPe"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Zoom" id="R4o-n2-Eq4">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="performZoom:" target="-1" id="DIl-cC-cCs"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="eu3-7i-yIM"/>
+                            <menuItem title="Bring All to Front" id="LE2-aR-0XJ">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="arrangeInFront:" target="-1" id="DRN-fu-gQh"/>
+                                </connections>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+                <menuItem title="Help" id="EPT-qC-fAb">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="Help" systemMenu="help" id="rJ0-wn-3NY"/>
+                </menuItem>
+            </items>
+            <point key="canvasLocation" x="142" y="-258"/>
+        </menu>
+        <window title="APP_NAME" allowsToolTipsWhenApplicationIsInactive="NO" autorecalculatesKeyViewLoop="NO" releasedWhenClosed="NO" animationBehavior="default" id="QvC-M9-y7g" customClass="MainFlutterWindow" customModule="Runner" customModuleProvider="target">
+            <windowStyleMask key="styleMask" titled="YES" closable="YES" miniaturizable="YES" resizable="YES"/>
+            <rect key="contentRect" x="335" y="390" width="800" height="600"/>
+            <rect key="screenRect" x="0.0" y="0.0" width="2560" height="1577"/>
+            <view key="contentView" wantsLayer="YES" id="EiT-Mj-1SZ">
+                <rect key="frame" x="0.0" y="0.0" width="800" height="600"/>
+                <autoresizingMask key="autoresizingMask"/>
+            </view>
+        </window>
+    </objects>
+</document>
diff --git a/packages/stacflow/example/macos/Runner/Configs/AppInfo.xcconfig b/packages/stacflow/example/macos/Runner/Configs/AppInfo.xcconfig
new file mode 100644
index 0000000..9a62389
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Configs/AppInfo.xcconfig
@@ -0,0 +1,14 @@
+// Application-level settings for the Runner target.
+//
+// This may be replaced with something auto-generated from metadata (e.g., pubspec.yaml) in the
+// future. If not, the values below would default to using the project name when this becomes a
+// 'flutter create' template.
+
+// The application's name. By default this is also the title of the Flutter window.
+PRODUCT_NAME = stacflow_example
+
+// The application's bundle identifier
+PRODUCT_BUNDLE_IDENTIFIER = dev.stac.stacflowExample
+
+// The copyright displayed in application information
+PRODUCT_COPYRIGHT = Copyright © 2026 dev.stac. All rights reserved.
diff --git a/packages/stacflow/example/macos/Runner/Configs/Debug.xcconfig b/packages/stacflow/example/macos/Runner/Configs/Debug.xcconfig
new file mode 100644
index 0000000..36b0fd9
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Configs/Debug.xcconfig
@@ -0,0 +1,2 @@
+#include "../../Flutter/Flutter-Debug.xcconfig"
+#include "Warnings.xcconfig"
diff --git a/packages/stacflow/example/macos/Runner/Configs/Release.xcconfig b/packages/stacflow/example/macos/Runner/Configs/Release.xcconfig
new file mode 100644
index 0000000..dff4f49
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Configs/Release.xcconfig
@@ -0,0 +1,2 @@
+#include "../../Flutter/Flutter-Release.xcconfig"
+#include "Warnings.xcconfig"
diff --git a/packages/stacflow/example/macos/Runner/Configs/Warnings.xcconfig b/packages/stacflow/example/macos/Runner/Configs/Warnings.xcconfig
new file mode 100644
index 0000000..42bcbf4
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Configs/Warnings.xcconfig
@@ -0,0 +1,13 @@
+WARNING_CFLAGS = -Wall -Wconditional-uninitialized -Wnullable-to-nonnull-conversion -Wmissing-method-return-type -Woverlength-strings
+GCC_WARN_UNDECLARED_SELECTOR = YES
+CLANG_UNDEFINED_BEHAVIOR_SANITIZER_NULLABILITY = YES
+CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE
+CLANG_WARN__DUPLICATE_METHOD_MATCH = YES
+CLANG_WARN_PRAGMA_PACK = YES
+CLANG_WARN_STRICT_PROTOTYPES = YES
+CLANG_WARN_COMMA = YES
+GCC_WARN_STRICT_SELECTOR_MATCH = YES
+CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES
+CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES
+GCC_WARN_SHADOW = YES
+CLANG_WARN_UNREACHABLE_CODE = YES
diff --git a/packages/stacflow/example/macos/Runner/DebugProfile.entitlements b/packages/stacflow/example/macos/Runner/DebugProfile.entitlements
new file mode 100644
index 0000000..8165abf
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/DebugProfile.entitlements
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.cs.allow-jit</key>
+	<true/>
+	<key>com.apple.security.network.server</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+	<key>com.apple.security.files.user-selected.read-only</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/macos/Runner/Info.plist b/packages/stacflow/example/macos/Runner/Info.plist
new file mode 100644
index 0000000..4789daa
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Info.plist
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIconFile</key>
+	<string></string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(FLUTTER_BUILD_NAME)</string>
+	<key>CFBundleVersion</key>
+	<string>$(FLUTTER_BUILD_NUMBER)</string>
+	<key>LSMinimumSystemVersion</key>
+	<string>$(MACOSX_DEPLOYMENT_TARGET)</string>
+	<key>NSHumanReadableCopyright</key>
+	<string>$(PRODUCT_COPYRIGHT)</string>
+	<key>NSMainNibFile</key>
+	<string>MainMenu</string>
+	<key>NSPrincipalClass</key>
+	<string>NSApplication</string>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/macos/Runner/MainFlutterWindow.swift b/packages/stacflow/example/macos/Runner/MainFlutterWindow.swift
new file mode 100644
index 0000000..3cc05eb
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/MainFlutterWindow.swift
@@ -0,0 +1,15 @@
+import Cocoa
+import FlutterMacOS
+
+class MainFlutterWindow: NSWindow {
+  override func awakeFromNib() {
+    let flutterViewController = FlutterViewController()
+    let windowFrame = self.frame
+    self.contentViewController = flutterViewController
+    self.setFrame(windowFrame, display: true)
+
+    RegisterGeneratedPlugins(registry: flutterViewController)
+
+    super.awakeFromNib()
+  }
+}
diff --git a/packages/stacflow/example/macos/Runner/Release.entitlements b/packages/stacflow/example/macos/Runner/Release.entitlements
new file mode 100644
index 0000000..741903e
--- /dev/null
+++ b/packages/stacflow/example/macos/Runner/Release.entitlements
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+	<key>com.apple.security.files.user-selected.read-only</key>
+	<true/>
+</dict>
+</plist>
diff --git a/packages/stacflow/example/macos/RunnerTests/RunnerTests.swift b/packages/stacflow/example/macos/RunnerTests/RunnerTests.swift
new file mode 100644
index 0000000..61f3bd1
--- /dev/null
+++ b/packages/stacflow/example/macos/RunnerTests/RunnerTests.swift
@@ -0,0 +1,12 @@
+import Cocoa
+import FlutterMacOS
+import XCTest
+
+class RunnerTests: XCTestCase {
+
+  func testExample() {
+    // If you add code to the Runner application, consider adding tests here.
+    // See https://developer.apple.com/documentation/xctest for more information about using XCTest.
+  }
+
+}
diff --git a/packages/stacflow/example/pubspec.yaml b/packages/stacflow/example/pubspec.yaml
new file mode 100644
index 0000000..3c3e00b
--- /dev/null
+++ b/packages/stacflow/example/pubspec.yaml
@@ -0,0 +1,23 @@
+name: stacflow_example
+description: The stacflow chat screen against Gemini with your own key.
+publish_to: 'none'
+version: 1.0.0+1
+
+environment:
+  sdk: ^3.13.0
+  flutter: ">=3.44.0"
+
+resolution: workspace
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+  material_ui: ^1.0.0
+  stacflow: ^0.0.1
+
+dev_dependencies:
+  flutter_lints: ^6.0.0
+
+flutter:
+  uses-material-design: true
diff --git a/packages/stacflow/example/web/favicon.png b/packages/stacflow/example/web/favicon.png
new file mode 100644
index 0000000..8aaa46a
Binary files /dev/null and b/packages/stacflow/example/web/favicon.png differ
diff --git a/packages/stacflow/example/web/icons/Icon-192.png b/packages/stacflow/example/web/icons/Icon-192.png
new file mode 100644
index 0000000..b749bfe
Binary files /dev/null and b/packages/stacflow/example/web/icons/Icon-192.png differ
diff --git a/packages/stacflow/example/web/icons/Icon-512.png b/packages/stacflow/example/web/icons/Icon-512.png
new file mode 100644
index 0000000..88cfd48
Binary files /dev/null and b/packages/stacflow/example/web/icons/Icon-512.png differ
diff --git a/packages/stacflow/example/web/icons/Icon-maskable-192.png b/packages/stacflow/example/web/icons/Icon-maskable-192.png
new file mode 100644
index 0000000..eb9b4d7
Binary files /dev/null and b/packages/stacflow/example/web/icons/Icon-maskable-192.png differ
diff --git a/packages/stacflow/example/web/icons/Icon-maskable-512.png b/packages/stacflow/example/web/icons/Icon-maskable-512.png
new file mode 100644
index 0000000..d69c566
Binary files /dev/null and b/packages/stacflow/example/web/icons/Icon-maskable-512.png differ
diff --git a/packages/stacflow/example/web/index.html b/packages/stacflow/example/web/index.html
new file mode 100644
index 0000000..e284735
--- /dev/null
+++ b/packages/stacflow/example/web/index.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <!--
+    If you are serving your web app in a path other than the root, change the
+    href value below to reflect the base path you are serving from.
+
+    The path provided below has to start and end with a slash "/" in order for
+    it to work correctly.
+
+    For more details:
+    * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base
+
+    This is a placeholder for base href that will be replaced by the value of
+    the `--base-href` argument provided to `flutter build`.
+  -->
+  <base href="$FLUTTER_BASE_HREF">
+
+  <meta charset="UTF-8">
+  <meta content="IE=Edge" http-equiv="X-UA-Compatible">
+  <meta name="description" content="A new Flutter project.">
+
+  <!-- iOS meta tags & icons -->
+  <meta name="mobile-web-app-capable" content="yes">
+  <meta name="apple-mobile-web-app-status-bar-style" content="black">
+  <meta name="apple-mobile-web-app-title" content="stacflow_example">
+  <link rel="apple-touch-icon" href="icons/Icon-192.png">
+
+  <!-- Favicon -->
+  <link rel="icon" type="image/png" href="favicon.png"/>
+
+  <title>stacflow_example</title>
+  <link rel="manifest" href="manifest.json">
+</head>
+<body>
+  <!--
+    You can customize the "flutter_bootstrap.js" script.
+    This is useful to provide a custom configuration to the Flutter loader
+    or to give the user feedback during the initialization process.
+
+    For more details:
+    * https://docs.flutter.dev/platform-integration/web/initialization
+  -->
+  <script src="flutter_bootstrap.js" async></script>
+</body>
+</html>
diff --git a/packages/stacflow/example/web/manifest.json b/packages/stacflow/example/web/manifest.json
new file mode 100644
index 0000000..54f3613
--- /dev/null
+++ b/packages/stacflow/example/web/manifest.json
@@ -0,0 +1,35 @@
+{
+    "name": "stacflow_example",
+    "short_name": "stacflow_example",
+    "start_url": ".",
+    "display": "standalone",
+    "background_color": "#0175C2",
+    "theme_color": "#0175C2",
+    "description": "A new Flutter project.",
+    "orientation": "portrait-primary",
+    "prefer_related_applications": false,
+    "icons": [
+        {
+            "src": "icons/Icon-192.png",
+            "sizes": "192x192",
+            "type": "image/png"
+        },
+        {
+            "src": "icons/Icon-512.png",
+            "sizes": "512x512",
+            "type": "image/png"
+        },
+        {
+            "src": "icons/Icon-maskable-192.png",
+            "sizes": "192x192",
+            "type": "image/png",
+            "purpose": "maskable"
+        },
+        {
+            "src": "icons/Icon-maskable-512.png",
+            "sizes": "512x512",
+            "type": "image/png",
+            "purpose": "maskable"
+        }
+    ]
+}
diff --git a/packages/stacflow/example/windows/.gitignore b/packages/stacflow/example/windows/.gitignore
new file mode 100644
index 0000000..d492d0d
--- /dev/null
+++ b/packages/stacflow/example/windows/.gitignore
@@ -0,0 +1,17 @@
+flutter/ephemeral/
+
+# Visual Studio user-specific files.
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# Visual Studio build-related files.
+x64/
+x86/
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!*.[Cc]ache/
diff --git a/packages/stacflow/example/windows/CMakeLists.txt b/packages/stacflow/example/windows/CMakeLists.txt
new file mode 100644
index 0000000..f2db9b8
--- /dev/null
+++ b/packages/stacflow/example/windows/CMakeLists.txt
@@ -0,0 +1,108 @@
+# Project-level configuration.
+cmake_minimum_required(VERSION 3.14)
+project(stacflow_example LANGUAGES CXX)
+
+# The name of the executable created for the application. Change this to change
+# the on-disk name of your application.
+set(BINARY_NAME "stacflow_example")
+
+# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
+# versions of CMake.
+cmake_policy(VERSION 3.14...3.25)
+
+# Define build configuration option.
+get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+if(IS_MULTICONFIG)
+  set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release"
+    CACHE STRING "" FORCE)
+else()
+  if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+    set(CMAKE_BUILD_TYPE "Debug" CACHE
+      STRING "Flutter build mode" FORCE)
+    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
+      "Debug" "Profile" "Release")
+  endif()
+endif()
+# Define settings for the Profile build mode.
+set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}")
+set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}")
+set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}")
+set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}")
+
+# Use Unicode for all projects.
+add_definitions(-DUNICODE -D_UNICODE)
+
+# Compilation settings that should be applied to most targets.
+#
+# Be cautious about adding new options here, as plugins use this function by
+# default. In most cases, you should add new options to specific targets instead
+# of modifying this function.
+function(APPLY_STANDARD_SETTINGS TARGET)
+  target_compile_features(${TARGET} PUBLIC cxx_std_17)
+  target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100")
+  target_compile_options(${TARGET} PRIVATE /EHsc)
+  target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0")
+  target_compile_definitions(${TARGET} PRIVATE "$<$<CONFIG:Debug>:_DEBUG>")
+endfunction()
+
+# Flutter library and tool build rules.
+set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter")
+add_subdirectory(${FLUTTER_MANAGED_DIR})
+
+# Application build; see runner/CMakeLists.txt.
+add_subdirectory("runner")
+
+
+# Generated plugin build rules, which manage building the plugins and adding
+# them to the application.
+include(flutter/generated_plugins.cmake)
+
+
+# === Installation ===
+# Support files are copied into place next to the executable, so that it can
+# run in place. This is done instead of making a separate bundle (as on Linux)
+# so that building and running from within Visual Studio will work.
+set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
+# Make the "install" step default, as it's required to run.
+set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
+if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
+  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
+endif()
+
+set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
+set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")
+
+install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
+  COMPONENT Runtime)
+
+install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
+  COMPONENT Runtime)
+
+install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+  COMPONENT Runtime)
+
+if(PLUGIN_BUNDLED_LIBRARIES)
+  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
+    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+    COMPONENT Runtime)
+endif()
+
+# Copy the native assets provided by the build.dart from all packages.
+set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
+install(DIRECTORY "${NATIVE_ASSETS_DIR}"
+   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+   COMPONENT Runtime)
+
+# Fully re-copy the assets directory on each build to avoid having stale files
+# from a previous install.
+set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
+install(CODE "
+  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
+  " COMPONENT Runtime)
+install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
+  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
+
+# Install the AOT library on non-Debug builds only.
+install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
+  CONFIGURATIONS Profile;Release
+  COMPONENT Runtime)
diff --git a/packages/stacflow/example/windows/flutter/CMakeLists.txt b/packages/stacflow/example/windows/flutter/CMakeLists.txt
new file mode 100644
index 0000000..903f489
--- /dev/null
+++ b/packages/stacflow/example/windows/flutter/CMakeLists.txt
@@ -0,0 +1,109 @@
+# This file controls Flutter-level build steps. It should not be edited.
+cmake_minimum_required(VERSION 3.14)
+
+set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")
+
+# Configuration provided via flutter tool.
+include(${EPHEMERAL_DIR}/generated_config.cmake)
+
+# TODO: Move the rest of this into files in ephemeral. See
+# https://github.com/flutter/flutter/issues/57146.
+set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper")
+
+# Set fallback configurations for older versions of the flutter tool.
+if (NOT DEFINED FLUTTER_TARGET_PLATFORM)
+  set(FLUTTER_TARGET_PLATFORM "windows-x64")
+endif()
+
+# === Flutter Library ===
+set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll")
+
+# Published to parent scope for install step.
+set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
+set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
+set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
+set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE)
+
+list(APPEND FLUTTER_LIBRARY_HEADERS
+  "flutter_export.h"
+  "flutter_windows.h"
+  "flutter_messenger.h"
+  "flutter_plugin_registrar.h"
+  "flutter_texture_registrar.h"
+)
+list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/")
+add_library(flutter INTERFACE)
+target_include_directories(flutter INTERFACE
+  "${EPHEMERAL_DIR}"
+)
+target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib")
+add_dependencies(flutter flutter_assemble)
+
+# === Wrapper ===
+list(APPEND CPP_WRAPPER_SOURCES_CORE
+  "core_implementations.cc"
+  "standard_codec.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/")
+list(APPEND CPP_WRAPPER_SOURCES_PLUGIN
+  "plugin_registrar.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/")
+list(APPEND CPP_WRAPPER_SOURCES_APP
+  "flutter_engine.cc"
+  "flutter_view_controller.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/")
+
+# Wrapper sources needed for a plugin.
+add_library(flutter_wrapper_plugin STATIC
+  ${CPP_WRAPPER_SOURCES_CORE}
+  ${CPP_WRAPPER_SOURCES_PLUGIN}
+)
+apply_standard_settings(flutter_wrapper_plugin)
+set_target_properties(flutter_wrapper_plugin PROPERTIES
+  POSITION_INDEPENDENT_CODE ON)
+set_target_properties(flutter_wrapper_plugin PROPERTIES
+  CXX_VISIBILITY_PRESET hidden)
+target_link_libraries(flutter_wrapper_plugin PUBLIC flutter)
+target_include_directories(flutter_wrapper_plugin PUBLIC
+  "${WRAPPER_ROOT}/include"
+)
+add_dependencies(flutter_wrapper_plugin flutter_assemble)
+
+# Wrapper sources needed for the runner.
+add_library(flutter_wrapper_app STATIC
+  ${CPP_WRAPPER_SOURCES_CORE}
+  ${CPP_WRAPPER_SOURCES_APP}
+)
+apply_standard_settings(flutter_wrapper_app)
+target_link_libraries(flutter_wrapper_app PUBLIC flutter)
+target_include_directories(flutter_wrapper_app PUBLIC
+  "${WRAPPER_ROOT}/include"
+)
+add_dependencies(flutter_wrapper_app flutter_assemble)
+
+# === Flutter tool backend ===
+# _phony_ is a non-existent file to force this command to run every time,
+# since currently there's no way to get a full input/output list from the
+# flutter tool.
+set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_")
+set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE)
+add_custom_command(
+  OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS}
+    ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN}
+    ${CPP_WRAPPER_SOURCES_APP}
+    ${PHONY_OUTPUT}
+  COMMAND ${CMAKE_COMMAND} -E env
+    ${FLUTTER_TOOL_ENVIRONMENT}
+    "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat"
+      ${FLUTTER_TARGET_PLATFORM} $<CONFIG>
+  VERBATIM
+)
+add_custom_target(flutter_assemble DEPENDS
+  "${FLUTTER_LIBRARY}"
+  ${FLUTTER_LIBRARY_HEADERS}
+  ${CPP_WRAPPER_SOURCES_CORE}
+  ${CPP_WRAPPER_SOURCES_PLUGIN}
+  ${CPP_WRAPPER_SOURCES_APP}
+)
diff --git a/packages/stacflow/example/windows/flutter/generated_plugin_registrant.cc b/packages/stacflow/example/windows/flutter/generated_plugin_registrant.cc
new file mode 100644
index 0000000..77ab7a0
--- /dev/null
+++ b/packages/stacflow/example/windows/flutter/generated_plugin_registrant.cc
@@ -0,0 +1,14 @@
+//
+//  Generated file. Do not edit.
+//
+
+// clang-format off
+
+#include "generated_plugin_registrant.h"
+
+#include <file_selector_windows/file_selector_windows.h>
+
+void RegisterPlugins(flutter::PluginRegistry* registry) {
+  FileSelectorWindowsRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("FileSelectorWindows"));
+}
diff --git a/packages/stacflow/example/windows/flutter/generated_plugin_registrant.h b/packages/stacflow/example/windows/flutter/generated_plugin_registrant.h
new file mode 100644
index 0000000..dc139d8
--- /dev/null
+++ b/packages/stacflow/example/windows/flutter/generated_plugin_registrant.h
@@ -0,0 +1,15 @@
+//
+//  Generated file. Do not edit.
+//
+
+// clang-format off
+
+#ifndef GENERATED_PLUGIN_REGISTRANT_
+#define GENERATED_PLUGIN_REGISTRANT_
+
+#include <flutter/plugin_registry.h>
+
+// Registers Flutter plugins.
+void RegisterPlugins(flutter::PluginRegistry* registry);
+
+#endif  // GENERATED_PLUGIN_REGISTRANT_
diff --git a/packages/stacflow/example/windows/flutter/generated_plugins.cmake b/packages/stacflow/example/windows/flutter/generated_plugins.cmake
new file mode 100644
index 0000000..277a56f
--- /dev/null
+++ b/packages/stacflow/example/windows/flutter/generated_plugins.cmake
@@ -0,0 +1,25 @@
+#
+# Generated file, do not edit.
+#
+
+list(APPEND FLUTTER_PLUGIN_LIST
+  file_selector_windows
+)
+
+list(APPEND FLUTTER_FFI_PLUGIN_LIST
+  jni
+)
+
+set(PLUGIN_BUNDLED_LIBRARIES)
+
+foreach(plugin ${FLUTTER_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin})
+  target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES $<TARGET_FILE:${plugin}_plugin>)
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries})
+endforeach(plugin)
+
+foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST})
+  add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin})
+  list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries})
+endforeach(ffi_plugin)
diff --git a/packages/stacflow/example/windows/runner/CMakeLists.txt b/packages/stacflow/example/windows/runner/CMakeLists.txt
new file mode 100644
index 0000000..394917c
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/CMakeLists.txt
@@ -0,0 +1,40 @@
+cmake_minimum_required(VERSION 3.14)
+project(runner LANGUAGES CXX)
+
+# Define the application target. To change its name, change BINARY_NAME in the
+# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer
+# work.
+#
+# Any new source files that you add to the application should be added here.
+add_executable(${BINARY_NAME} WIN32
+  "flutter_window.cpp"
+  "main.cpp"
+  "utils.cpp"
+  "win32_window.cpp"
+  "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc"
+  "Runner.rc"
+  "runner.exe.manifest"
+)
+
+# Apply the standard set of build settings. This can be removed for applications
+# that need different build settings.
+apply_standard_settings(${BINARY_NAME})
+
+# Add preprocessor definitions for the build version.
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}")
+
+# Disable Windows macros that collide with C++ standard library functions.
+target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX")
+
+# Add dependency libraries and include directories. Add any application-specific
+# dependencies here.
+target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app)
+target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib")
+target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")
+
+# Run the Flutter tool portions of the build. This must not be removed.
+add_dependencies(${BINARY_NAME} flutter_assemble)
diff --git a/packages/stacflow/example/windows/runner/Runner.rc b/packages/stacflow/example/windows/runner/Runner.rc
new file mode 100644
index 0000000..5590aa9
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/Runner.rc
@@ -0,0 +1,121 @@
+// Microsoft Visual C++ generated resource script.
+//
+#pragma code_page(65001)
+#include "resource.h"
+
+#define APSTUDIO_READONLY_SYMBOLS
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 2 resource.
+//
+#include "winres.h"
+
+/////////////////////////////////////////////////////////////////////////////
+#undef APSTUDIO_READONLY_SYMBOLS
+
+/////////////////////////////////////////////////////////////////////////////
+// English (United States) resources
+
+#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU)
+LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
+
+#ifdef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// TEXTINCLUDE
+//
+
+1 TEXTINCLUDE
+BEGIN
+    "resource.h\0"
+END
+
+2 TEXTINCLUDE
+BEGIN
+    "#include ""winres.h""\r\n"
+    "\0"
+END
+
+3 TEXTINCLUDE
+BEGIN
+    "\r\n"
+    "\0"
+END
+
+#endif    // APSTUDIO_INVOKED
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Icon
+//
+
+// Icon with lowest ID value placed first to ensure application icon
+// remains consistent on all systems.
+IDI_APP_ICON            ICON                    "resources\\app_icon.ico"
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Version
+//
+
+#if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD)
+#define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD
+#else
+#define VERSION_AS_NUMBER 1,0,0,0
+#endif
+
+#if defined(FLUTTER_VERSION)
+#define VERSION_AS_STRING FLUTTER_VERSION
+#else
+#define VERSION_AS_STRING "1.0.0"
+#endif
+
+VS_VERSION_INFO VERSIONINFO
+ FILEVERSION VERSION_AS_NUMBER
+ PRODUCTVERSION VERSION_AS_NUMBER
+ FILEFLAGSMASK VS_FFI_FILEFLAGSMASK
+#ifdef _DEBUG
+ FILEFLAGS VS_FF_DEBUG
+#else
+ FILEFLAGS 0x0L
+#endif
+ FILEOS VOS__WINDOWS32
+ FILETYPE VFT_APP
+ FILESUBTYPE 0x0L
+BEGIN
+    BLOCK "StringFileInfo"
+    BEGIN
+        BLOCK "040904e4"
+        BEGIN
+            VALUE "CompanyName", "dev.stac" "\0"
+            VALUE "FileDescription", "stacflow_example" "\0"
+            VALUE "FileVersion", VERSION_AS_STRING "\0"
+            VALUE "InternalName", "stacflow_example" "\0"
+            VALUE "LegalCopyright", "Copyright (C) 2026 dev.stac. All rights reserved." "\0"
+            VALUE "OriginalFilename", "stacflow_example.exe" "\0"
+            VALUE "ProductName", "stacflow_example" "\0"
+            VALUE "ProductVersion", VERSION_AS_STRING "\0"
+        END
+    END
+    BLOCK "VarFileInfo"
+    BEGIN
+        VALUE "Translation", 0x409, 1252
+    END
+END
+
+#endif    // English (United States) resources
+/////////////////////////////////////////////////////////////////////////////
+
+
+
+#ifndef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 3 resource.
+//
+
+
+/////////////////////////////////////////////////////////////////////////////
+#endif    // not APSTUDIO_INVOKED
diff --git a/packages/stacflow/example/windows/runner/flutter_window.cpp b/packages/stacflow/example/windows/runner/flutter_window.cpp
new file mode 100644
index 0000000..955ee30
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/flutter_window.cpp
@@ -0,0 +1,71 @@
+#include "flutter_window.h"
+
+#include <optional>
+
+#include "flutter/generated_plugin_registrant.h"
+
+FlutterWindow::FlutterWindow(const flutter::DartProject& project)
+    : project_(project) {}
+
+FlutterWindow::~FlutterWindow() {}
+
+bool FlutterWindow::OnCreate() {
+  if (!Win32Window::OnCreate()) {
+    return false;
+  }
+
+  RECT frame = GetClientArea();
+
+  // The size here must match the window dimensions to avoid unnecessary surface
+  // creation / destruction in the startup path.
+  flutter_controller_ = std::make_unique<flutter::FlutterViewController>(
+      frame.right - frame.left, frame.bottom - frame.top, project_);
+  // Ensure that basic setup of the controller was successful.
+  if (!flutter_controller_->engine() || !flutter_controller_->view()) {
+    return false;
+  }
+  RegisterPlugins(flutter_controller_->engine());
+  SetChildContent(flutter_controller_->view()->GetNativeWindow());
+
+  flutter_controller_->engine()->SetNextFrameCallback([&]() {
+    this->Show();
+  });
+
+  // Flutter can complete the first frame before the "show window" callback is
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
+  flutter_controller_->ForceRedraw();
+
+  return true;
+}
+
+void FlutterWindow::OnDestroy() {
+  if (flutter_controller_) {
+    flutter_controller_ = nullptr;
+  }
+
+  Win32Window::OnDestroy();
+}
+
+LRESULT
+FlutterWindow::MessageHandler(HWND hwnd, UINT const message,
+                              WPARAM const wparam,
+                              LPARAM const lparam) noexcept {
+  // Give Flutter, including plugins, an opportunity to handle window messages.
+  if (flutter_controller_) {
+    std::optional<LRESULT> result =
+        flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam,
+                                                      lparam);
+    if (result) {
+      return *result;
+    }
+  }
+
+  switch (message) {
+    case WM_FONTCHANGE:
+      flutter_controller_->engine()->ReloadSystemFonts();
+      break;
+  }
+
+  return Win32Window::MessageHandler(hwnd, message, wparam, lparam);
+}
diff --git a/packages/stacflow/example/windows/runner/flutter_window.h b/packages/stacflow/example/windows/runner/flutter_window.h
new file mode 100644
index 0000000..6da0652
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/flutter_window.h
@@ -0,0 +1,33 @@
+#ifndef RUNNER_FLUTTER_WINDOW_H_
+#define RUNNER_FLUTTER_WINDOW_H_
+
+#include <flutter/dart_project.h>
+#include <flutter/flutter_view_controller.h>
+
+#include <memory>
+
+#include "win32_window.h"
+
+// A window that does nothing but host a Flutter view.
+class FlutterWindow : public Win32Window {
+ public:
+  // Creates a new FlutterWindow hosting a Flutter view running |project|.
+  explicit FlutterWindow(const flutter::DartProject& project);
+  virtual ~FlutterWindow();
+
+ protected:
+  // Win32Window:
+  bool OnCreate() override;
+  void OnDestroy() override;
+  LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam,
+                         LPARAM const lparam) noexcept override;
+
+ private:
+  // The project to run.
+  flutter::DartProject project_;
+
+  // The Flutter instance hosted by this window.
+  std::unique_ptr<flutter::FlutterViewController> flutter_controller_;
+};
+
+#endif  // RUNNER_FLUTTER_WINDOW_H_
diff --git a/packages/stacflow/example/windows/runner/main.cpp b/packages/stacflow/example/windows/runner/main.cpp
new file mode 100644
index 0000000..ee5bbe1
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/main.cpp
@@ -0,0 +1,43 @@
+#include <flutter/dart_project.h>
+#include <flutter/flutter_view_controller.h>
+#include <windows.h>
+
+#include "flutter_window.h"
+#include "utils.h"
+
+int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev,
+                      _In_ wchar_t *command_line, _In_ int show_command) {
+  // Attach to console when present (e.g., 'flutter run') or create a
+  // new console when running with a debugger.
+  if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) {
+    CreateAndAttachConsole();
+  }
+
+  // Initialize COM, so that it is available for use in the library and/or
+  // plugins.
+  ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED);
+
+  flutter::DartProject project(L"data");
+
+  std::vector<std::string> command_line_arguments =
+      GetCommandLineArguments();
+
+  project.set_dart_entrypoint_arguments(std::move(command_line_arguments));
+
+  FlutterWindow window(project);
+  Win32Window::Point origin(10, 10);
+  Win32Window::Size size(1280, 720);
+  if (!window.Create(L"stacflow_example", origin, size)) {
+    return EXIT_FAILURE;
+  }
+  window.SetQuitOnClose(true);
+
+  ::MSG msg;
+  while (::GetMessage(&msg, nullptr, 0, 0)) {
+    ::TranslateMessage(&msg);
+    ::DispatchMessage(&msg);
+  }
+
+  ::CoUninitialize();
+  return EXIT_SUCCESS;
+}
diff --git a/packages/stacflow/example/windows/runner/resource.h b/packages/stacflow/example/windows/runner/resource.h
new file mode 100644
index 0000000..66a65d1
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/resource.h
@@ -0,0 +1,16 @@
+//{{NO_DEPENDENCIES}}
+// Microsoft Visual C++ generated include file.
+// Used by Runner.rc
+//
+#define IDI_APP_ICON                    101
+
+// Next default values for new objects
+//
+#ifdef APSTUDIO_INVOKED
+#ifndef APSTUDIO_READONLY_SYMBOLS
+#define _APS_NEXT_RESOURCE_VALUE        102
+#define _APS_NEXT_COMMAND_VALUE         40001
+#define _APS_NEXT_CONTROL_VALUE         1001
+#define _APS_NEXT_SYMED_VALUE           101
+#endif
+#endif
diff --git a/packages/stacflow/example/windows/runner/resources/app_icon.ico b/packages/stacflow/example/windows/runner/resources/app_icon.ico
new file mode 100644
index 0000000..c04e20c
Binary files /dev/null and b/packages/stacflow/example/windows/runner/resources/app_icon.ico differ
diff --git a/packages/stacflow/example/windows/runner/runner.exe.manifest b/packages/stacflow/example/windows/runner/runner.exe.manifest
new file mode 100644
index 0000000..153653e
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/runner.exe.manifest
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+  <application xmlns="urn:schemas-microsoft-com:asm.v3">
+    <windowsSettings>
+      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness>
+    </windowsSettings>
+  </application>
+  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+    <application>
+      <!-- Windows 10 and Windows 11 -->
+      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>
+    </application>
+  </compatibility>
+</assembly>
diff --git a/packages/stacflow/example/windows/runner/utils.cpp b/packages/stacflow/example/windows/runner/utils.cpp
new file mode 100644
index 0000000..3cb7146
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/utils.cpp
@@ -0,0 +1,69 @@
+#include "utils.h"
+
+#include <flutter_windows.h>
+#include <io.h>
+#include <stdio.h>
+#include <windows.h>
+
+#include <iostream>
+
+void CreateAndAttachConsole() {
+  if (::AllocConsole()) {
+    FILE *unused;
+    if (freopen_s(&unused, "CONOUT$", "w", stdout)) {
+      _dup2(_fileno(stdout), 1);
+    }
+    if (freopen_s(&unused, "CONOUT$", "w", stderr)) {
+      _dup2(_fileno(stdout), 2);
+    }
+    std::ios::sync_with_stdio();
+    FlutterDesktopResyncOutputStreams();
+  }
+}
+
+std::vector<std::string> GetCommandLineArguments() {
+  // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use.
+  int argc;
+  wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc);
+  if (argv == nullptr) {
+    return std::vector<std::string>();
+  }
+
+  std::vector<std::string> command_line_arguments;
+
+  // Skip the first argument as it's the binary name.
+  for (int i = 1; i < argc; i++) {
+    command_line_arguments.push_back(Utf8FromUtf16(argv[i]));
+  }
+
+  ::LocalFree(argv);
+
+  return command_line_arguments;
+}
+
+std::string Utf8FromUtf16(const wchar_t* utf16_string) {
+  if (utf16_string == nullptr) {
+    return std::string();
+  }
+  // First, find the length of the string with a safe upper bound (CWE-126).
+  // UNICODE_STRING_MAX_CHARS (32767) is the maximum length of a UNICODE_STRING.
+  int input_length = static_cast<int>(wcsnlen(utf16_string, UNICODE_STRING_MAX_CHARS));
+  // Now use that bounded length to determine the required buffer size.
+  // When an explicit length is passed, WideCharToMultiByte does not include
+  // the null terminator in its returned size.
+  int target_length = ::WideCharToMultiByte(
+      CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string,
+      input_length, nullptr, 0, nullptr, nullptr);
+  std::string utf8_string;
+  if (target_length == 0 || static_cast<size_t>(target_length) > utf8_string.max_size()) {
+    return utf8_string;
+  }
+  utf8_string.resize(target_length);
+  int converted_length = ::WideCharToMultiByte(
+      CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string,
+      input_length, utf8_string.data(), target_length, nullptr, nullptr);
+  if (converted_length == 0) {
+    return std::string();
+  }
+  return utf8_string;
+}
diff --git a/packages/stacflow/example/windows/runner/utils.h b/packages/stacflow/example/windows/runner/utils.h
new file mode 100644
index 0000000..3879d54
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/utils.h
@@ -0,0 +1,19 @@
+#ifndef RUNNER_UTILS_H_
+#define RUNNER_UTILS_H_
+
+#include <string>
+#include <vector>
+
+// Creates a console for the process, and redirects stdout and stderr to
+// it for both the runner and the Flutter library.
+void CreateAndAttachConsole();
+
+// Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string
+// encoded in UTF-8. Returns an empty std::string on failure.
+std::string Utf8FromUtf16(const wchar_t* utf16_string);
+
+// Gets the command line arguments passed in as a std::vector<std::string>,
+// encoded in UTF-8. Returns an empty std::vector<std::string> on failure.
+std::vector<std::string> GetCommandLineArguments();
+
+#endif  // RUNNER_UTILS_H_
diff --git a/packages/stacflow/example/windows/runner/win32_window.cpp b/packages/stacflow/example/windows/runner/win32_window.cpp
new file mode 100644
index 0000000..60608d0
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/win32_window.cpp
@@ -0,0 +1,288 @@
+#include "win32_window.h"
+
+#include <dwmapi.h>
+#include <flutter_windows.h>
+
+#include "resource.h"
+
+namespace {
+
+/// Window attribute that enables dark mode window decorations.
+///
+/// Redefined in case the developer's machine has a Windows SDK older than
+/// version 10.0.22000.0.
+/// See: https://docs.microsoft.com/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute
+#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE
+#define DWMWA_USE_IMMERSIVE_DARK_MODE 20
+#endif
+
+constexpr const wchar_t kWindowClassName[] = L"FLUTTER_RUNNER_WIN32_WINDOW";
+
+/// Registry key for app theme preference.
+///
+/// A value of 0 indicates apps should use dark mode. A non-zero or missing
+/// value indicates apps should use light mode.
+constexpr const wchar_t kGetPreferredBrightnessRegKey[] =
+  L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize";
+constexpr const wchar_t kGetPreferredBrightnessRegValue[] = L"AppsUseLightTheme";
+
+// The number of Win32Window objects that currently exist.
+static int g_active_window_count = 0;
+
+using EnableNonClientDpiScaling = BOOL __stdcall(HWND hwnd);
+
+// Scale helper to convert logical scaler values to physical using passed in
+// scale factor
+int Scale(int source, double scale_factor) {
+  return static_cast<int>(source * scale_factor);
+}
+
+// Dynamically loads the |EnableNonClientDpiScaling| from the User32 module.
+// This API is only needed for PerMonitor V1 awareness mode.
+void EnableFullDpiSupportIfAvailable(HWND hwnd) {
+  HMODULE user32_module = LoadLibraryA("User32.dll");
+  if (!user32_module) {
+    return;
+  }
+  auto enable_non_client_dpi_scaling =
+      reinterpret_cast<EnableNonClientDpiScaling*>(
+          GetProcAddress(user32_module, "EnableNonClientDpiScaling"));
+  if (enable_non_client_dpi_scaling != nullptr) {
+    enable_non_client_dpi_scaling(hwnd);
+  }
+  FreeLibrary(user32_module);
+}
+
+}  // namespace
+
+// Manages the Win32Window's window class registration.
+class WindowClassRegistrar {
+ public:
+  ~WindowClassRegistrar() = default;
+
+  // Returns the singleton registrar instance.
+  static WindowClassRegistrar* GetInstance() {
+    if (!instance_) {
+      instance_ = new WindowClassRegistrar();
+    }
+    return instance_;
+  }
+
+  // Returns the name of the window class, registering the class if it hasn't
+  // previously been registered.
+  const wchar_t* GetWindowClass();
+
+  // Unregisters the window class. Should only be called if there are no
+  // instances of the window.
+  void UnregisterWindowClass();
+
+ private:
+  WindowClassRegistrar() = default;
+
+  static WindowClassRegistrar* instance_;
+
+  bool class_registered_ = false;
+};
+
+WindowClassRegistrar* WindowClassRegistrar::instance_ = nullptr;
+
+const wchar_t* WindowClassRegistrar::GetWindowClass() {
+  if (!class_registered_) {
+    WNDCLASS window_class{};
+    window_class.hCursor = LoadCursor(nullptr, IDC_ARROW);
+    window_class.lpszClassName = kWindowClassName;
+    window_class.style = CS_HREDRAW | CS_VREDRAW;
+    window_class.cbClsExtra = 0;
+    window_class.cbWndExtra = 0;
+    window_class.hInstance = GetModuleHandle(nullptr);
+    window_class.hIcon =
+        LoadIcon(window_class.hInstance, MAKEINTRESOURCE(IDI_APP_ICON));
+    window_class.hbrBackground = 0;
+    window_class.lpszMenuName = nullptr;
+    window_class.lpfnWndProc = Win32Window::WndProc;
+    RegisterClass(&window_class);
+    class_registered_ = true;
+  }
+  return kWindowClassName;
+}
+
+void WindowClassRegistrar::UnregisterWindowClass() {
+  UnregisterClass(kWindowClassName, nullptr);
+  class_registered_ = false;
+}
+
+Win32Window::Win32Window() {
+  ++g_active_window_count;
+}
+
+Win32Window::~Win32Window() {
+  --g_active_window_count;
+  Destroy();
+}
+
+bool Win32Window::Create(const std::wstring& title,
+                         const Point& origin,
+                         const Size& size) {
+  Destroy();
+
+  const wchar_t* window_class =
+      WindowClassRegistrar::GetInstance()->GetWindowClass();
+
+  const POINT target_point = {static_cast<LONG>(origin.x),
+                              static_cast<LONG>(origin.y)};
+  HMONITOR monitor = MonitorFromPoint(target_point, MONITOR_DEFAULTTONEAREST);
+  UINT dpi = FlutterDesktopGetDpiForMonitor(monitor);
+  double scale_factor = dpi / 96.0;
+
+  HWND window = CreateWindow(
+      window_class, title.c_str(), WS_OVERLAPPEDWINDOW,
+      Scale(origin.x, scale_factor), Scale(origin.y, scale_factor),
+      Scale(size.width, scale_factor), Scale(size.height, scale_factor),
+      nullptr, nullptr, GetModuleHandle(nullptr), this);
+
+  if (!window) {
+    return false;
+  }
+
+  UpdateTheme(window);
+
+  return OnCreate();
+}
+
+bool Win32Window::Show() {
+  return ShowWindow(window_handle_, SW_SHOWNORMAL);
+}
+
+// static
+LRESULT CALLBACK Win32Window::WndProc(HWND const window,
+                                      UINT const message,
+                                      WPARAM const wparam,
+                                      LPARAM const lparam) noexcept {
+  if (message == WM_NCCREATE) {
+    auto window_struct = reinterpret_cast<CREATESTRUCT*>(lparam);
+    SetWindowLongPtr(window, GWLP_USERDATA,
+                     reinterpret_cast<LONG_PTR>(window_struct->lpCreateParams));
+
+    auto that = static_cast<Win32Window*>(window_struct->lpCreateParams);
+    EnableFullDpiSupportIfAvailable(window);
+    that->window_handle_ = window;
+  } else if (Win32Window* that = GetThisFromHandle(window)) {
+    return that->MessageHandler(window, message, wparam, lparam);
+  }
+
+  return DefWindowProc(window, message, wparam, lparam);
+}
+
+LRESULT
+Win32Window::MessageHandler(HWND hwnd,
+                            UINT const message,
+                            WPARAM const wparam,
+                            LPARAM const lparam) noexcept {
+  switch (message) {
+    case WM_DESTROY:
+      window_handle_ = nullptr;
+      Destroy();
+      if (quit_on_close_) {
+        PostQuitMessage(0);
+      }
+      return 0;
+
+    case WM_DPICHANGED: {
+      auto newRectSize = reinterpret_cast<RECT*>(lparam);
+      LONG newWidth = newRectSize->right - newRectSize->left;
+      LONG newHeight = newRectSize->bottom - newRectSize->top;
+
+      SetWindowPos(hwnd, nullptr, newRectSize->left, newRectSize->top, newWidth,
+                   newHeight, SWP_NOZORDER | SWP_NOACTIVATE);
+
+      return 0;
+    }
+    case WM_SIZE: {
+      RECT rect = GetClientArea();
+      if (child_content_ != nullptr) {
+        // Size and position the child window.
+        MoveWindow(child_content_, rect.left, rect.top, rect.right - rect.left,
+                   rect.bottom - rect.top, TRUE);
+      }
+      return 0;
+    }
+
+    case WM_ACTIVATE:
+      if (child_content_ != nullptr) {
+        SetFocus(child_content_);
+      }
+      return 0;
+
+    case WM_DWMCOLORIZATIONCOLORCHANGED:
+      UpdateTheme(hwnd);
+      return 0;
+  }
+
+  return DefWindowProc(window_handle_, message, wparam, lparam);
+}
+
+void Win32Window::Destroy() {
+  OnDestroy();
+
+  if (window_handle_) {
+    DestroyWindow(window_handle_);
+    window_handle_ = nullptr;
+  }
+  if (g_active_window_count == 0) {
+    WindowClassRegistrar::GetInstance()->UnregisterWindowClass();
+  }
+}
+
+Win32Window* Win32Window::GetThisFromHandle(HWND const window) noexcept {
+  return reinterpret_cast<Win32Window*>(
+      GetWindowLongPtr(window, GWLP_USERDATA));
+}
+
+void Win32Window::SetChildContent(HWND content) {
+  child_content_ = content;
+  SetParent(content, window_handle_);
+  RECT frame = GetClientArea();
+
+  MoveWindow(content, frame.left, frame.top, frame.right - frame.left,
+             frame.bottom - frame.top, true);
+
+  SetFocus(child_content_);
+}
+
+RECT Win32Window::GetClientArea() {
+  RECT frame;
+  GetClientRect(window_handle_, &frame);
+  return frame;
+}
+
+HWND Win32Window::GetHandle() {
+  return window_handle_;
+}
+
+void Win32Window::SetQuitOnClose(bool quit_on_close) {
+  quit_on_close_ = quit_on_close;
+}
+
+bool Win32Window::OnCreate() {
+  // No-op; provided for subclasses.
+  return true;
+}
+
+void Win32Window::OnDestroy() {
+  // No-op; provided for subclasses.
+}
+
+void Win32Window::UpdateTheme(HWND const window) {
+  DWORD light_mode;
+  DWORD light_mode_size = sizeof(light_mode);
+  LSTATUS result = RegGetValue(HKEY_CURRENT_USER, kGetPreferredBrightnessRegKey,
+                               kGetPreferredBrightnessRegValue,
+                               RRF_RT_REG_DWORD, nullptr, &light_mode,
+                               &light_mode_size);
+
+  if (result == ERROR_SUCCESS) {
+    BOOL enable_dark_mode = light_mode == 0;
+    DwmSetWindowAttribute(window, DWMWA_USE_IMMERSIVE_DARK_MODE,
+                          &enable_dark_mode, sizeof(enable_dark_mode));
+  }
+}
diff --git a/packages/stacflow/example/windows/runner/win32_window.h b/packages/stacflow/example/windows/runner/win32_window.h
new file mode 100644
index 0000000..e901dde
--- /dev/null
+++ b/packages/stacflow/example/windows/runner/win32_window.h
@@ -0,0 +1,102 @@
+#ifndef RUNNER_WIN32_WINDOW_H_
+#define RUNNER_WIN32_WINDOW_H_
+
+#include <windows.h>
+
+#include <functional>
+#include <memory>
+#include <string>
+
+// A class abstraction for a high DPI-aware Win32 Window. Intended to be
+// inherited from by classes that wish to specialize with custom
+// rendering and input handling
+class Win32Window {
+ public:
+  struct Point {
+    unsigned int x;
+    unsigned int y;
+    Point(unsigned int x, unsigned int y) : x(x), y(y) {}
+  };
+
+  struct Size {
+    unsigned int width;
+    unsigned int height;
+    Size(unsigned int width, unsigned int height)
+        : width(width), height(height) {}
+  };
+
+  Win32Window();
+  virtual ~Win32Window();
+
+  // Creates a win32 window with |title| that is positioned and sized using
+  // |origin| and |size|. New windows are created on the default monitor. Window
+  // sizes are specified to the OS in physical pixels, hence to ensure a
+  // consistent size this function will scale the inputted width and height as
+  // as appropriate for the default monitor. The window is invisible until
+  // |Show| is called. Returns true if the window was created successfully.
+  bool Create(const std::wstring& title, const Point& origin, const Size& size);
+
+  // Show the current window. Returns true if the window was successfully shown.
+  bool Show();
+
+  // Release OS resources associated with window.
+  void Destroy();
+
+  // Inserts |content| into the window tree.
+  void SetChildContent(HWND content);
+
+  // Returns the backing Window handle to enable clients to set icon and other
+  // window properties. Returns nullptr if the window has been destroyed.
+  HWND GetHandle();
+
+  // If true, closing this window will quit the application.
+  void SetQuitOnClose(bool quit_on_close);
+
+  // Return a RECT representing the bounds of the current client area.
+  RECT GetClientArea();
+
+ protected:
+  // Processes and route salient window messages for mouse handling,
+  // size change and DPI. Delegates handling of these to member overloads that
+  // inheriting classes can handle.
+  virtual LRESULT MessageHandler(HWND window,
+                                 UINT const message,
+                                 WPARAM const wparam,
+                                 LPARAM const lparam) noexcept;
+
+  // Called when CreateAndShow is called, allowing subclass window-related
+  // setup. Subclasses should return false if setup fails.
+  virtual bool OnCreate();
+
+  // Called when Destroy is called.
+  virtual void OnDestroy();
+
+ private:
+  friend class WindowClassRegistrar;
+
+  // OS callback called by message pump. Handles the WM_NCCREATE message which
+  // is passed when the non-client area is being created and enables automatic
+  // non-client DPI scaling so that the non-client area automatically
+  // responds to changes in DPI. All other messages are handled by
+  // MessageHandler.
+  static LRESULT CALLBACK WndProc(HWND const window,
+                                  UINT const message,
+                                  WPARAM const wparam,
+                                  LPARAM const lparam) noexcept;
+
+  // Retrieves a class instance pointer for |window|
+  static Win32Window* GetThisFromHandle(HWND const window) noexcept;
+
+  // Update the window frame's theme to match the system theme.
+  static void UpdateTheme(HWND const window);
+
+  bool quit_on_close_ = false;
+
+  // window handle for top level window.
+  HWND window_handle_ = nullptr;
+
+  // window handle for hosted content.
+  HWND child_content_ = nullptr;
+};
+
+#endif  // RUNNER_WIN32_WINDOW_H_
diff --git a/packages/stacflow/lib/src/chat/chat_state.dart b/packages/stacflow/lib/src/chat/chat_state.dart
new file mode 100644
index 0000000..5d88632
--- /dev/null
+++ b/packages/stacflow/lib/src/chat/chat_state.dart
@@ -0,0 +1,118 @@
+import 'package:flow_ui/flow_ui.dart';
+import 'package:flutter/foundation.dart';
+import 'package:stacflow/src/errors.dart';
+import 'package:stacflow/src/tools/tool.dart';
+
+/// Tokens a turn consumed, as the provider reported them.
+@immutable
+final class ChatUsage {
+  const new({
+    required this.model,
+    required this.inputTokens,
+    required this.outputTokens,
+  });
+
+  final String model;
+  final int inputTokens;
+  final int outputTokens;
+}
+
+/// How the last turn went: time to the first token, total time, tokens.
+@immutable
+final class ChatTurnStats {
+  const new({required this.total, this.firstToken, this.usage});
+
+  final Duration total;
+  final Duration? firstToken;
+  final ChatUsage? usage;
+}
+
+/// Everything a chat shows, as one immutable value per change.
+@immutable
+final class ChatState {
+  new({
+    required this.model,
+    required this.threadId,
+    List<FlowMessageData> messages = const [],
+    this.isGenerating = false,
+    List<FlowAttachment> pendingAttachments = const [],
+    this.attachmentError,
+    Map<String, bool> feedback = const {},
+    this.copiedCodePart,
+    this.error,
+    this.lastTurn,
+    Map<String, ToolCallRecord> toolCalls = const {},
+  }) : messages = List.unmodifiable(messages),
+       pendingAttachments = List.unmodifiable(pendingAttachments),
+       feedback = Map.unmodifiable(feedback),
+       toolCalls = Map.unmodifiable(toolCalls);
+
+  /// The model answering the next turn.
+  final String model;
+
+  /// The conversation's id; a new conversation gets a new one.
+  final String threadId;
+
+  /// The thread, oldest first.
+  final List<FlowMessageData> messages;
+
+  /// Whether a reply is being generated.
+  final bool isGenerating;
+
+  /// Attachments waiting to go with the next message.
+  final List<FlowAttachment> pendingAttachments;
+
+  /// The composer's banner text after a refused file, if any.
+  final String? attachmentError;
+
+  /// Thumbs per message id: true for up, false for down.
+  final Map<String, bool> feedback;
+
+  /// The code part whose copy confirmation is showing.
+  final FlowCodePart? copiedCodePart;
+
+  /// The last turn's failure, cleared by the next send.
+  final ChatError? error;
+
+  /// Timing and tokens of the last settled turn.
+  final ChatTurnStats? lastTurn;
+
+  /// Every tool call the thread made, by id: the records behind the tool
+  /// cards and the history sent to the model.
+  final Map<String, ToolCallRecord> toolCalls;
+
+  /// A copy with the given fields replaced; the `clear` flags null a field.
+  ChatState copyWith({
+    String? model,
+    String? threadId,
+    List<FlowMessageData>? messages,
+    bool? isGenerating,
+    List<FlowAttachment>? pendingAttachments,
+    String? attachmentError,
+    Map<String, bool>? feedback,
+    FlowCodePart? copiedCodePart,
+    ChatError? error,
+    ChatTurnStats? lastTurn,
+    Map<String, ToolCallRecord>? toolCalls,
+    bool clearAttachmentError = false,
+    bool clearCopiedCodePart = false,
+    bool clearError = false,
+    bool clearLastTurn = false,
+  }) => ChatState(
+    model: model ?? this.model,
+    threadId: threadId ?? this.threadId,
+    messages: messages ?? this.messages,
+    isGenerating: isGenerating ?? this.isGenerating,
+    pendingAttachments: pendingAttachments ?? this.pendingAttachments,
+    attachmentError: clearAttachmentError
+        ? null
+        : attachmentError ?? this.attachmentError,
+    feedback: feedback ?? this.feedback,
+    copiedCodePart: clearCopiedCodePart
+        ? null
+        : copiedCodePart ?? this.copiedCodePart,
+    error: clearError ? null : error ?? this.error,
+    lastTurn: clearLastTurn ? null : lastTurn ?? this.lastTurn,
+    toolCalls: toolCalls ?? this.toolCalls,
+  );
+}
diff --git a/packages/stacflow/lib/src/chat/stacflow_chat.dart b/packages/stacflow/lib/src/chat/stacflow_chat.dart
new file mode 100644
index 0000000..8625b02
--- /dev/null
+++ b/packages/stacflow/lib/src/chat/stacflow_chat.dart
@@ -0,0 +1,713 @@
+import 'dart:async';
+import 'dart:convert';
+
+import 'package:flow_ui/flow_ui.dart';
+import 'package:flutter/foundation.dart';
+import 'package:flutter/services.dart';
+import 'package:stacflow/src/chat/chat_state.dart';
+import 'package:stacflow/src/chat/wire_history.dart';
+import 'package:stacflow/src/errors.dart';
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/strings.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/tools/tool_loop.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+/// A chat against one provider: it holds the thread, runs each turn with
+/// the app's tools, and exposes everything as one [ChatState] per change.
+final class StacFlowChat {
+  new({
+    required StacFlowProvider provider,
+    this.agent = const AgentConfig(),
+    this.tools = const [],
+    this.maxToolRounds = 8,
+    this.strings = const FlowStrings(),
+    this.attachmentOptions = const FlowAttachmentOptions(),
+    List<FlowMessageData> initialMessages = const [],
+    IdGenerator? ids,
+  }) : assert(
+         tools.every((tool) => Tool.isValidName(tool.name)),
+         'tool names use letters, digits, underscores and dashes, at most '
+         '64 characters',
+       ),
+       assert(
+         tools.every((tool) => tool.description.isNotEmpty),
+         'every tool needs a description',
+       ),
+       assert(
+         tools.map((tool) => tool.name).toSet().length == tools.length,
+         'tool names must be unique',
+       ),
+       _provider = provider,
+       _ids = ids ?? IdGenerator(),
+       _toolsByName = {for (final tool in tools) tool.name: tool} {
+    _state = ValueNotifier(
+      ChatState(
+        model: provider.model,
+        threadId: _ids.thread(),
+        messages: initialMessages,
+      ),
+    );
+  }
+
+  /// The type of the custom part that follows every tool card; its data
+  /// is the call's [ToolCallRecord].
+  static const String toolPartType = 'stacflow.tool';
+
+  /// The instructions and sampling settings every turn carries.
+  final AgentConfig agent;
+
+  /// The actions the model may take.
+  final List<Tool> tools;
+
+  /// How many segments of one turn may call tools before the turn fails.
+  final int maxToolRounds;
+
+  /// The words the chat shows.
+  final FlowStrings strings;
+
+  /// What the composer accepts as an attachment.
+  final FlowAttachmentOptions attachmentOptions;
+
+  final IdGenerator _ids;
+  final Map<String, Tool> _toolsByName;
+  late final ValueNotifier<ChatState> _state;
+  StacFlowProvider _provider;
+  _Turn? _turn;
+  Timer? _copiedReset;
+  bool _disposed = false;
+
+  /// The state, re-emitted whole on every change.
+  ValueListenable<ChatState> get state => _state;
+
+  /// The provider answering the next turn.
+  StacFlowProvider get provider => _provider;
+
+  /// The thread, oldest first.
+  List<FlowMessageData> get messages => _state.value.messages;
+
+  /// Whether a reply is being generated.
+  bool get isGenerating => _state.value.isGenerating;
+
+  /// Attachments waiting to go with the next message.
+  List<FlowAttachment> get pendingAttachments =>
+      _state.value.pendingAttachments;
+
+  /// Sends [text] with the pending attachments and resolves when the reply
+  /// settles. Does nothing while generating or with nothing to send.
+  Future<void> send(String text) {
+    final pending = pendingAttachments;
+    if (isGenerating || (text.isEmpty && pending.isEmpty)) {
+      return Future.value();
+    }
+    final message = FlowMessageData(
+      id: _ids.message(),
+      role: FlowMessageRole.user,
+      timestamp: DateTime.now(),
+      parts: [
+        if (pending.isNotEmpty) FlowAttachmentPart(List.of(pending)),
+        if (text.isNotEmpty) FlowTextPart(text),
+      ],
+    );
+    _update(
+      (s) => s.copyWith(
+        messages: [...s.messages, message],
+        pendingAttachments: const [],
+        clearAttachmentError: true,
+        clearError: true,
+      ),
+    );
+    return _generate();
+  }
+
+  /// Aborts the reply being generated, keeping any text that arrived.
+  void stop() {
+    final turn = _turn;
+    if (turn == null) return;
+    turn.abort.complete();
+    unawaited(turn.cancel());
+    _finishCancelled(turn);
+  }
+
+  /// Drops the failed reply [message] and asks again.
+  Future<void> retry(FlowMessageData message) {
+    if (isGenerating) return Future.value();
+    _update(
+      (s) => _withMessages(s, [
+        for (final m in s.messages)
+          if (m.id != message.id) m,
+      ]),
+    );
+    return _generate();
+  }
+
+  /// Drops the latest reply and asks again.
+  Future<void> regenerate() {
+    if (isGenerating || messages.isEmpty) return Future.value();
+    final last = messages.last;
+    if (last.role == FlowMessageRole.assistant) {
+      _update(
+        (s) => _withMessages(s, s.messages.sublist(0, s.messages.length - 1)),
+      );
+    }
+    return _generate();
+  }
+
+  /// Replaces the user turn [messageId] and everything after it with
+  /// [text], keeping that turn's attachments, and asks again.
+  Future<void> editAndResend(String messageId, String text) {
+    if (isGenerating) return Future.value();
+    final index = messages.indexWhere(
+      (m) => m.id == messageId && m.role == FlowMessageRole.user,
+    );
+    if (index == -1) return Future.value();
+    final attachments = [
+      for (final part in messages[index].parts)
+        if (part is FlowAttachmentPart) ...part.attachments,
+    ];
+    _update(
+      (s) => _withMessages(
+        s,
+        s.messages.sublist(0, index),
+      ).copyWith(pendingAttachments: attachments),
+    );
+    return send(text);
+  }
+
+  /// Answers the confirmation card of the tool call [toolCallId]; ignored
+  /// unless that call is waiting.
+  void respondToToolCall(String toolCallId, {required bool approved}) {
+    final turn = _turn;
+    final block = turn?.tool(toolCallId);
+    final approval = block?.approval;
+    if (turn == null ||
+        block == null ||
+        approval == null ||
+        approval.isCompleted) {
+      return;
+    }
+    block.confirmation = approved
+        ? FlowConfirmationStatus.approved
+        : FlowConfirmationStatus.rejected;
+    approval.complete(approved);
+    _render(turn);
+  }
+
+  /// The flow_ui form of [respondToToolCall]: answers the tool call whose
+  /// card [part] sits under in [message].
+  void respondToConfirmation(
+    FlowMessageData message,
+    FlowConfirmationPart part, {
+    required bool approved,
+  }) {
+    final index = message.parts.indexWhere((p) => identical(p, part));
+    for (var i = index - 1; i >= 0; i--) {
+      if (message.parts[i] case FlowToolPart(:final id?)) {
+        respondToToolCall(id, approved: approved);
+        return;
+      }
+    }
+  }
+
+  /// Adds picked, dropped or pasted files to the next message.
+  void addAttachments(List<FlowAttachment> attachments) {
+    if (attachments.isEmpty) return;
+    _update(
+      (s) => s.copyWith(
+        pendingAttachments: [...s.pendingAttachments, ...attachments],
+        clearAttachmentError: true,
+      ),
+    );
+  }
+
+  /// Removes a pending attachment by id.
+  void removeAttachment(String id) {
+    _update(
+      (s) => s.copyWith(
+        pendingAttachments: [
+          for (final a in s.pendingAttachments)
+            if (a.id != id) a,
+        ],
+      ),
+    );
+  }
+
+  /// Records a refused file for the composer's banner.
+  void rejectAttachment(String name, FlowAttachmentRejection reason) {
+    _update(
+      (s) =>
+          s.copyWith(attachmentError: strings.attachmentRejected(name, reason)),
+    );
+  }
+
+  /// Clears the composer's banner.
+  void dismissAttachmentError() {
+    _update((s) => s.copyWith(clearAttachmentError: true));
+  }
+
+  /// Thumbs a reply up or down; the same thumb again clears it.
+  void setFeedback(String messageId, {required bool positive}) {
+    _update((s) {
+      final feedback = Map<String, bool>.of(s.feedback);
+      if (feedback[messageId] == positive) {
+        feedback.remove(messageId);
+      } else {
+        feedback[messageId] = positive;
+      }
+      return s.copyWith(feedback: feedback);
+    });
+  }
+
+  /// Copies the message's text to the clipboard.
+  Future<void> copy(FlowMessageData message) {
+    final text = [
+      for (final part in message.parts)
+        if (part is FlowTextPart) part.text,
+    ].join('\n');
+    return Clipboard.setData(ClipboardData(text: text));
+  }
+
+  /// Copies a code block and shows its copied state for two seconds.
+  Future<void> copyCode(FlowCodePart part) {
+    _copiedReset?.cancel();
+    _update((s) => s.copyWith(copiedCodePart: part));
+    _copiedReset = Timer(const Duration(seconds: 2), () {
+      _copiedReset = null;
+      if (_disposed) return;
+      if (identical(_state.value.copiedCodePart, part)) {
+        _update((s) => s.copyWith(clearCopiedCodePart: true));
+      }
+    });
+    return Clipboard.setData(ClipboardData(text: part.code));
+  }
+
+  /// Answers the next turns with [modelId]; the turn in flight keeps its
+  /// model.
+  void selectModel(String modelId) {
+    _provider = _provider.withModel(modelId);
+    _update((s) => s.copyWith(model: modelId));
+  }
+
+  /// Starts an empty thread with a new id.
+  void newConversation() {
+    stop();
+    _update((s) => ChatState(model: s.model, threadId: _ids.thread()));
+  }
+
+  /// Releases the chat; the reply in flight is aborted.
+  void dispose() {
+    if (_disposed) return;
+    final turn = _turn;
+    if (turn != null) {
+      turn.abort.complete();
+      unawaited(turn.cancel());
+      _settleToolCalls(turn);
+      turn.completer.complete();
+    }
+    _turn = null;
+    _copiedReset?.cancel();
+    _disposed = true;
+    _state.dispose();
+  }
+
+  Future<void> _generate() {
+    final history = wireHistoryOf(messages, toolCalls: _state.value.toolCalls);
+    final ids = TurnIds.generate(threadId: _state.value.threadId, ids: _ids);
+    final placeholder = FlowMessageData(
+      id: ids.messageId,
+      role: FlowMessageRole.assistant,
+      status: FlowMessageStatus.pending,
+      timestamp: DateTime.now(),
+    );
+    _update(
+      (s) => s.copyWith(
+        messages: [...s.messages, placeholder],
+        isGenerating: true,
+        clearError: true,
+      ),
+    );
+    final turn = _Turn(ids: ids);
+    _turn = turn;
+    turn.subscription =
+        runToolLoop(
+          transport: _provider,
+          request: TurnRequest(
+            history: history,
+            agent: agent,
+            ids: ids,
+            abortTrigger: turn.abort.future,
+            tools: tools,
+          ),
+          approve: (record) => _approve(turn, record),
+          onCall: (record) => _onToolCall(turn, record),
+          maxRounds: maxToolRounds,
+        ).listen(
+          (event) => _onEvent(turn, event),
+          onError: (Object error) => _onStreamError(turn, error),
+          onDone: () => _onStreamDone(turn),
+          cancelOnError: true,
+        );
+    return turn.completer.future;
+  }
+
+  void _onEvent(_Turn turn, SseEvent event) {
+    if (!identical(_turn, turn)) return;
+    switch (event) {
+      case StartEvent(:final segment):
+        if (segment > 0) turn.breakText();
+      case DeltaEvent(:final text):
+        turn
+          ..write(text)
+          ..firstDeltaAt ??= DateTime.now();
+        _render(turn);
+      case ToolCallDeltaEvent(:final toolCallId, :final argsDelta):
+        final block = turn.tool(toolCallId);
+        if (block != null) {
+          block.argsBuffer.write(argsDelta);
+          _render(turn);
+        }
+      case UsageEvent(:final model, :final inputTokens, :final outputTokens):
+        final previous = turn.usage;
+        turn.usage = ChatUsage(
+          model: model,
+          inputTokens: (previous?.inputTokens ?? 0) + inputTokens,
+          outputTokens: (previous?.outputTokens ?? 0) + outputTokens,
+        );
+      case ErrorEvent():
+        _fail(turn, ChatError.fromEvent(event, strings));
+      case DoneEvent(:final status):
+        switch (status) {
+          case DoneEventStatus.complete:
+            _finishComplete(turn);
+          case DoneEventStatus.awaitingClientTools:
+            break;
+          case DoneEventStatus.error:
+            if (turn.error == null) {
+              _fail(
+                turn,
+                ChatError.runtime(code: 'internal', strings: strings),
+              );
+            }
+            _settle(turn);
+          case DoneEventStatus.cancelled:
+            _finishCancelled(turn);
+        }
+      case ToolCallStartEvent():
+      case ToolCallEndEvent():
+      case SseUnknownEvent():
+        break;
+    }
+  }
+
+  void _onToolCall(_Turn turn, ToolCallRecord record) {
+    if (!identical(_turn, turn)) return;
+    _update((s) => s.copyWith(toolCalls: {...s.toolCalls, record.id: record}));
+    final block = turn.tool(record.id) ?? turn.addTool(record.id);
+    if (record.status != ToolCallStatus.pending && block.input == null) {
+      block
+        ..input = _pretty(record.args)
+        ..detail = _toolsByName[record.name]?.detail?.call(record.args);
+    }
+    if (record.status == ToolCallStatus.ok) {
+      final result = record.result;
+      final structured = result is Map || result is List;
+      block
+        ..output = structured ? _pretty(result) : result?.toString()
+        ..outputLanguage = structured ? 'json' : null;
+    }
+    _render(turn);
+  }
+
+  Future<bool> _approve(_Turn turn, ToolCallRecord record) {
+    if (!identical(_turn, turn)) return Future.value(false);
+    final block = turn.tool(record.id) ?? turn.addTool(record.id);
+    final tool = _toolsByName[record.name];
+    final approval = Completer<bool>();
+    block
+      ..confirmation = FlowConfirmationStatus.pending
+      ..confirmationMessage =
+          tool?.confirmation?.call(record.args) ??
+          strings.approvalMessage(tool?.label ?? record.name)
+      ..approval = approval;
+    _render(turn);
+    return approval.future;
+  }
+
+  void _onStreamError(_Turn turn, Object error) {
+    if (!identical(_turn, turn)) return;
+    _fail(
+      turn,
+      ChatError.runtime(
+        code: 'network',
+        strings: strings,
+        detail: error is ProviderTransportException ? error.message : null,
+      ),
+    );
+    _settle(turn);
+  }
+
+  void _onStreamDone(_Turn turn) {
+    if (!identical(_turn, turn) || turn.settled) return;
+    _fail(turn, ChatError.runtime(code: 'stream_closed', strings: strings));
+    _settle(turn);
+  }
+
+  void _fail(_Turn turn, ChatError error) {
+    turn.error = error;
+    _settleToolCalls(turn);
+    _replace(
+      turn.ids.messageId,
+      status: FlowMessageStatus.error,
+      parts: [
+        ..._partsOf(turn),
+        FlowErrorPart(message: error.message, retryable: error.retryable),
+      ],
+    );
+  }
+
+  void _finishComplete(_Turn turn) {
+    if (turn.hasParts) {
+      _render(turn, status: FlowMessageStatus.complete);
+    } else {
+      _remove(turn.ids.messageId);
+    }
+    _settle(turn);
+  }
+
+  void _finishCancelled(_Turn turn) {
+    _settleToolCalls(turn);
+    _finishComplete(turn);
+  }
+
+  void _settleToolCalls(_Turn turn) {
+    final now = DateTime.now();
+    for (final block in turn.blocks) {
+      if (block is! _ToolBlock) continue;
+      final record = _state.value.toolCalls[block.id];
+      if (record != null && !record.isSettled) {
+        final settled = record.copyWith(
+          status: ToolCallStatus.error,
+          error: ToolCallError.cancelled,
+          finishedAt: now,
+        );
+        _update(
+          (s) => s.copyWith(toolCalls: {...s.toolCalls, settled.id: settled}),
+        );
+      }
+      if (block.confirmation == FlowConfirmationStatus.pending) {
+        block.confirmation = FlowConfirmationStatus.rejected;
+      }
+      final approval = block.approval;
+      if (approval != null && !approval.isCompleted) approval.complete(false);
+    }
+  }
+
+  void _settle(_Turn turn) {
+    if (turn.settled) return;
+    turn.settled = true;
+    if (identical(_turn, turn)) _turn = null;
+    final now = DateTime.now();
+    final firstDeltaAt = turn.firstDeltaAt;
+    _update(
+      (s) => s.copyWith(
+        isGenerating: false,
+        error: turn.error,
+        lastTurn: ChatTurnStats(
+          total: now.difference(turn.startedAt),
+          firstToken: firstDeltaAt?.difference(turn.startedAt),
+          usage: turn.usage,
+        ),
+      ),
+    );
+    turn.completer.complete();
+  }
+
+  void _render(
+    _Turn turn, {
+    FlowMessageStatus status = FlowMessageStatus.streaming,
+  }) {
+    _replace(
+      turn.ids.messageId,
+      parts: _partsOf(turn),
+      status: turn.hasParts ? status : FlowMessageStatus.pending,
+    );
+  }
+
+  List<FlowMessagePart> _partsOf(_Turn turn) {
+    final toolCalls = _state.value.toolCalls;
+    final parts = <FlowMessagePart>[];
+    for (final block in turn.blocks) {
+      switch (block) {
+        case _TextBlock(:final text):
+          if (text.isNotEmpty) parts.add(FlowTextPart(text.toString()));
+        case _ToolBlock():
+          final record = toolCalls[block.id];
+          if (record == null) continue;
+          parts.add(
+            FlowToolPart(
+              id: record.id,
+              name: record.name,
+              title: _toolsByName[record.name]?.label,
+              detail: block.detail,
+              input: record.status == ToolCallStatus.pending
+                  ? (block.argsBuffer.isEmpty
+                        ? null
+                        : block.argsBuffer.toString())
+                  : block.input,
+              output: block.output,
+              outputLanguage: block.outputLanguage,
+              status: switch (record.status) {
+                ToolCallStatus.pending ||
+                ToolCallStatus.awaitingApproval => FlowToolStatus.pending,
+                ToolCallStatus.running => FlowToolStatus.running,
+                ToolCallStatus.ok => FlowToolStatus.complete,
+                ToolCallStatus.error ||
+                ToolCallStatus.declined => FlowToolStatus.error,
+              },
+              errorMessage: switch (record.status) {
+                ToolCallStatus.error => strings.toolError(
+                  record.error?.code ?? '',
+                  detail: record.error?.message,
+                ),
+                ToolCallStatus.declined => strings.toolDeclined,
+                _ => null,
+              },
+            ),
+          );
+          if (block.confirmation case final confirmation?) {
+            parts.add(
+              FlowConfirmationPart(
+                title: strings.approvalTitle,
+                message: block.confirmationMessage,
+                status: confirmation,
+              ),
+            );
+          }
+          parts.add(FlowCustomPart(type: toolPartType, data: record));
+      }
+    }
+    return parts;
+  }
+
+  ChatState _withMessages(ChatState s, List<FlowMessageData> messages) {
+    final kept = <String>{
+      for (final message in messages)
+        for (final part in message.parts)
+          if (part case FlowToolPart(:final id?)) id,
+    };
+    return s.copyWith(
+      messages: messages,
+      toolCalls: {
+        for (final entry in s.toolCalls.entries)
+          if (kept.contains(entry.key)) entry.key: entry.value,
+      },
+    );
+  }
+
+  void _replace(
+    String id, {
+    List<FlowMessagePart>? parts,
+    FlowMessageStatus? status,
+  }) {
+    _update(
+      (s) => s.copyWith(
+        messages: [
+          for (final m in s.messages)
+            if (m.id == id) m.copyWith(parts: parts, status: status) else m,
+        ],
+      ),
+    );
+  }
+
+  void _remove(String id) {
+    _update(
+      (s) => s.copyWith(
+        messages: [
+          for (final m in s.messages)
+            if (m.id != id) m,
+        ],
+      ),
+    );
+  }
+
+  void _update(ChatState Function(ChatState state) change) {
+    if (_disposed) return;
+    _state.value = change(_state.value);
+  }
+}
+
+String _pretty(Object? value) =>
+    const JsonEncoder.withIndent('  ').convert(value);
+
+final class _Turn {
+  new({required this.ids});
+
+  final TurnIds ids;
+  final Completer<void> abort = Completer<void>();
+  final Completer<void> completer = Completer<void>();
+  final DateTime startedAt = DateTime.now();
+  final List<_Block> blocks = [];
+  StreamSubscription<SseEvent>? subscription;
+  DateTime? firstDeltaAt;
+  ChatUsage? usage;
+  ChatError? error;
+  bool settled = false;
+
+  bool get hasParts => blocks.any(
+    (block) => switch (block) {
+      _TextBlock(:final text) => text.isNotEmpty,
+      _ToolBlock() => true,
+    },
+  );
+
+  void write(String delta) {
+    final last = blocks.isEmpty ? null : blocks.last;
+    if (last is _TextBlock) {
+      last.text.write(delta);
+    } else {
+      blocks.add(_TextBlock()..text.write(delta));
+    }
+  }
+
+  void breakText() {
+    final last = blocks.isEmpty ? null : blocks.last;
+    if (last is _TextBlock && last.text.isNotEmpty) blocks.add(_TextBlock());
+  }
+
+  _ToolBlock? tool(String id) {
+    for (final block in blocks) {
+      if (block is _ToolBlock && block.id == id) return block;
+    }
+    return null;
+  }
+
+  _ToolBlock addTool(String id) {
+    final block = _ToolBlock(id);
+    blocks.add(block);
+    return block;
+  }
+
+  Future<void> cancel() => subscription?.cancel() ?? Future.value();
+}
+
+sealed class _Block;
+
+final class _TextBlock extends _Block {
+  final StringBuffer text = StringBuffer();
+}
+
+final class _ToolBlock extends _Block {
+  new(this.id);
+
+  final String id;
+  final StringBuffer argsBuffer = StringBuffer();
+  String? input;
+  String? detail;
+  String? output;
+  String? outputLanguage;
+  FlowConfirmationStatus? confirmation;
+  String? confirmationMessage;
+  Completer<bool>? approval;
+}
diff --git a/packages/stacflow/lib/src/chat/stacflow_chat_view.dart b/packages/stacflow/lib/src/chat/stacflow_chat_view.dart
new file mode 100644
index 0000000..69dbaa5
--- /dev/null
+++ b/packages/stacflow/lib/src/chat/stacflow_chat_view.dart
@@ -0,0 +1,315 @@
+import 'dart:async';
+
+import 'package:flow_ui/flow_ui.dart';
+import 'package:material_ui/material_ui.dart';
+import 'package:stacflow/src/chat/chat_state.dart';
+import 'package:stacflow/src/chat/stacflow_chat.dart';
+import 'package:stacflow/src/strings.dart';
+import 'package:stacflow/src/tools/tool.dart';
+
+/// Builds the content shown under a tool card for [record], or null for
+/// none; called for every call in every status.
+typedef ToolBodyBuilder = Widget? Function(
+  BuildContext context,
+  ToolCallRecord record,
+);
+
+/// The finished chat screen for a [StacFlowChat]: thread, composer,
+/// attachments, message actions, tool cards and model selector. Body-only;
+/// put it in a Scaffold under material_ui's MaterialApp.
+class StacFlowChatView extends StatefulWidget {
+  const new({
+    required this.chat,
+    super.key,
+    this.greeting,
+    this.suggestions = const <String>[],
+    this.suggestionsLayout = FlowSuggestionLayout.column,
+    this.header,
+    this.strings,
+    this.showModelSelector = true,
+    this.showActions = true,
+    this.showEditAction = false,
+    this.onLinkTap,
+    this.toolBodyBuilder,
+    this.leadingActions = const <Widget>[],
+    this.trailingActions = const <Widget>[],
+    this.maxContentWidth = 760,
+    this.style,
+    this.composerStyle,
+  });
+
+  /// The chat this screen shows and drives.
+  final StacFlowChat chat;
+
+  /// Renders content under a tool card, e.g. a table for a query result.
+  final ToolBodyBuilder? toolBodyBuilder;
+
+  /// Shown above the composer while the thread is empty.
+  final Widget? greeting;
+
+  /// Prompt starters shown while the thread is empty; a tap sends one.
+  final List<String> suggestions;
+
+  final FlowSuggestionLayout suggestionsLayout;
+
+  /// A full-width bar above the thread.
+  final Widget? header;
+
+  /// Overrides the chat's strings for this screen.
+  final FlowStrings? strings;
+
+  /// Shows a model selector when the provider offers more than one model.
+  final bool showModelSelector;
+
+  /// Shows copy, feedback and regenerate under settled replies.
+  final bool showActions;
+
+  /// Shows an edit action under user turns; sending then replaces that
+  /// turn and everything after it.
+  final bool showEditAction;
+
+  /// Called with the href of a tapped link; links render as prose when
+  /// null.
+  final ValueChanged<String>? onLinkTap;
+
+  /// Extra composer actions before the attach button.
+  final List<Widget> leadingActions;
+
+  /// Extra composer actions before the model selector.
+  final List<Widget> trailingActions;
+
+  final double maxContentWidth;
+  final FlowChatViewStyle? style;
+  final FlowComposerStyle? composerStyle;
+
+  @override
+  State<StacFlowChatView> createState() => _StacFlowChatViewState();
+}
+
+class _StacFlowChatViewState extends State<StacFlowChatView> {
+  final ScrollController _scroll = ScrollController();
+  final TextEditingController _text = TextEditingController();
+  String? _editingId;
+
+  StacFlowChat get _chat => widget.chat;
+
+  FlowStrings get _strings => widget.strings ?? _chat.strings;
+
+  @override
+  void initState() {
+    super.initState();
+    _text.addListener(_onTextChanged);
+  }
+
+  @override
+  void dispose() {
+    _text
+      ..removeListener(_onTextChanged)
+      ..dispose();
+    _scroll.dispose();
+    super.dispose();
+  }
+
+  void _onTextChanged() {
+    if (_editingId != null && _text.text.isEmpty) {
+      setState(() => _editingId = null);
+    }
+  }
+
+  void _send(String text) {
+    final editingId = _editingId;
+    if (editingId != null) {
+      _editingId = null;
+      unawaited(_chat.editAndResend(editingId, text));
+    } else {
+      unawaited(_chat.send(text));
+    }
+  }
+
+  void _insertContent(KeyboardInsertedContent content) {
+    final data = content.data;
+    if (data == null || data.isEmpty) return;
+    _chat.addAttachments([
+      FlowAttachment(
+        id: 'kbd_${DateTime.now().microsecondsSinceEpoch}',
+        thumbnail: MemoryImage(data),
+        label: 'keyboard image',
+        bytes: data,
+        mimeType: content.mimeType,
+      ),
+    ]);
+  }
+
+  void _edit(FlowMessageData message) {
+    _text.text = [
+      for (final part in message.parts)
+        if (part is FlowTextPart) part.text,
+    ].join('\n');
+    setState(() => _editingId = message.id);
+  }
+
+  void _copy(BuildContext context, FlowMessageData message) {
+    unawaited(_chat.copy(message));
+    showFlowToast(
+      context: context,
+      icon: Icons.copy_outlined,
+      message: _strings.copied,
+      dismissTooltip: _strings.dismiss,
+    );
+  }
+
+  Widget? _actions(
+    BuildContext context,
+    ChatState state,
+    FlowMessageData message,
+  ) {
+    final strings = _strings;
+    if (message.role == FlowMessageRole.user) {
+      if (!widget.showEditAction) return null;
+      return FlowMessageActions(
+        actions: [
+          FlowMessageAction.edit(
+            tooltip: strings.edit,
+            onPressed: state.isGenerating ? null : () => _edit(message),
+          ),
+        ],
+      );
+    }
+    if (message.role != FlowMessageRole.assistant ||
+        message.status != FlowMessageStatus.complete) {
+      return null;
+    }
+    final feedback = state.feedback[message.id];
+    final isLatest = message.id == state.messages.last.id;
+    return FlowMessageActions(
+      actions: [
+        FlowMessageAction.copy(
+          tooltip: strings.copy,
+          onPressed: () => _copy(context, message),
+        ),
+        FlowMessageAction.thumbUp(
+          tooltip: strings.goodResponse,
+          selected: feedback == true,
+          onPressed: () => _chat.setFeedback(message.id, positive: true),
+        ),
+        FlowMessageAction.thumbDown(
+          tooltip: strings.badResponse,
+          selected: feedback == false,
+          onPressed: () => _chat.setFeedback(message.id, positive: false),
+        ),
+        if (isLatest)
+          FlowMessageAction.regenerate(
+            tooltip: strings.regenerate,
+            onPressed: state.isGenerating
+                ? null
+                : () => unawaited(_chat.regenerate()),
+          ),
+      ],
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) => ValueListenableBuilder<ChatState>(
+    valueListenable: _chat.state,
+    builder: (context, state, _) {
+      final strings = _strings;
+      final models = _chat.provider.models;
+      final onLinkTap = widget.onLinkTap;
+      return FlowChatView(
+        header: widget.header,
+        empty: state.messages.isEmpty,
+        greeting: widget.greeting,
+        suggestions: widget.suggestions.isEmpty
+            ? null
+            : FlowSuggestionGroup(
+                layout: widget.suggestionsLayout,
+                suggestions: [
+                  for (final suggestion in widget.suggestions)
+                    FlowSuggestion(
+                      label: suggestion,
+                      onTap: () => _send(suggestion),
+                    ),
+                ],
+              ),
+        thread: FlowThread(
+          messages: state.messages,
+          controller: _scroll,
+          thinkingLabel: strings.thinking,
+          errorTitle: strings.errorTitle,
+          retryLabel: strings.retry,
+          onRetry: (message) => unawaited(_chat.retry(message)),
+          onLinkTap: onLinkTap == null
+              ? null
+              : (message, href) => onLinkTap(href),
+          onCodeCopy: (part) => unawaited(_chat.copyCode(part)),
+          copiedCodePart: state.copiedCodePart,
+          codeCopyTooltip: strings.copyCode,
+          onConfirmationRespond: (message, part, approved) =>
+              _chat.respondToConfirmation(message, part, approved: approved),
+          approveLabel: strings.approve,
+          rejectLabel: strings.reject,
+          approvedLabel: strings.approved,
+          rejectedLabel: strings.rejected,
+          toolInputLabel: strings.toolInput,
+          toolOutputLabel: strings.toolOutput,
+          customPartBuilder: (context, message, part) {
+            if (part.type != StacFlowChat.toolPartType) return null;
+            final record = part.data;
+            return record is ToolCallRecord
+                ? widget.toolBodyBuilder?.call(context, record)
+                : null;
+          },
+          messageFooter: widget.showActions || widget.showEditAction
+              ? (message) => _actions(context, state, message)
+              : null,
+        ),
+        threadController: _scroll,
+        jumpToLatestTooltip: strings.jumpToLatest,
+        maxContentWidth: widget.maxContentWidth,
+        onAttachmentsDropped: _chat.addAttachments,
+        onAttachmentRejected: _chat.rejectAttachment,
+        attachmentOptions: _chat.attachmentOptions,
+        dropLabel: strings.dropFiles,
+        style: widget.style,
+        composer: FlowComposer(
+          isStreaming: state.isGenerating,
+          onSend: _send,
+          onStop: _chat.stop,
+          controller: _text,
+          placeholder: strings.placeholder,
+          attachments: state.pendingAttachments,
+          onRemoveAttachment: _chat.removeAttachment,
+          removeAttachmentTooltip: strings.removeAttachment,
+          onAttachmentsPicked: _chat.addAttachments,
+          onAttachmentsDropped: _chat.addAttachments,
+          onAttachmentsPasted: _chat.addAttachments,
+          onAttachmentRejected: _chat.rejectAttachment,
+          attachmentOptions: _chat.attachmentOptions,
+          attachTooltip: strings.attach,
+          errorMessage: state.attachmentError,
+          onErrorDismiss: _chat.dismissAttachmentError,
+          errorDismissTooltip: strings.dismiss,
+          onContentInserted: _insertContent,
+          leadingActions: widget.leadingActions,
+          trailingActions: [
+            ...widget.trailingActions,
+            if (widget.showModelSelector && models.length > 1)
+              FlowModelSelector(
+                models: [
+                  for (final option in models)
+                    FlowModelOption(
+                      id: option.id,
+                      label: option.label,
+                      description: option.description,
+                    ),
+                ],
+                selectedId: state.model,
+                onSelected: _chat.selectModel,
+              ),
+          ],
+          style: widget.composerStyle,
+        ),
+      );
+    },
+  );
+}
diff --git a/packages/stacflow/lib/src/chat/wire_history.dart b/packages/stacflow/lib/src/chat/wire_history.dart
new file mode 100644
index 0000000..ee41ac0
--- /dev/null
+++ b/packages/stacflow/lib/src/chat/wire_history.dart
@@ -0,0 +1,139 @@
+import 'dart:typed_data';
+
+import 'package:flow_ui/flow_ui.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+List<WireMessage> wireHistoryOf(
+  List<FlowMessageData> history, {
+  Map<String, ToolCallRecord> toolCalls = const {},
+}) {
+  final messages = <WireMessage>[];
+  for (final message in history) {
+    if (message.role == FlowMessageRole.system ||
+        message.status != FlowMessageStatus.complete) {
+      continue;
+    }
+    if (message.role == FlowMessageRole.assistant) {
+      _appendAssistant(messages, message.parts, toolCalls);
+    } else {
+      _append(messages, WireRole.user, _wirePartsOf(message.parts));
+    }
+  }
+  assert(
+    messages.isEmpty || messages.last.role == WireRole.user,
+    'the wire history must end with a user turn',
+  );
+  return messages;
+}
+
+void _append(List<WireMessage> messages, WireRole role, List<WirePart> parts) {
+  if (parts.isEmpty) return;
+  if (messages.isEmpty && role == WireRole.assistant) return;
+  if (messages.isNotEmpty && messages.last.role == role) {
+    final previous = messages.removeLast();
+    messages.add(WireMessage(role: role, parts: [...previous.parts, ...parts]));
+  } else {
+    messages.add(WireMessage(role: role, parts: parts));
+  }
+}
+
+void _appendAssistant(
+  List<WireMessage> messages,
+  List<FlowMessagePart> parts,
+  Map<String, ToolCallRecord> toolCalls,
+) {
+  var current = <WirePart>[];
+  var calls = <ToolCallRecord>[];
+  void flush() {
+    if (messages.isNotEmpty) {
+      _append(messages, WireRole.assistant, current);
+      _append(messages, WireRole.user, [
+        for (final record in calls) WireToolResultPart.of(record),
+      ]);
+    }
+    current = [];
+    calls = [];
+  }
+
+  for (var index = 0; index < parts.length; index++) {
+    final part = parts[index];
+    switch (part) {
+      case FlowToolPart(:final id?):
+        final record = toolCalls[id];
+        if (record == null) continue;
+        if (calls.isNotEmpty && record.segment != calls.last.segment) flush();
+        current.add(WireToolCallPart.of(record));
+        calls.add(record);
+      case FlowToolPart():
+      case FlowConfirmationPart():
+      case FlowCustomPart():
+      case FlowErrorPart():
+      case FlowAttachmentPart():
+        continue;
+      case FlowTextPart():
+      case FlowImagePart():
+      case FlowCodePart():
+        if (calls.isNotEmpty &&
+            !_callFollowsInSegment(
+              parts,
+              index,
+              calls.last.segment,
+              toolCalls,
+            )) {
+          flush();
+        }
+        current.addAll(_wirePartsOf([part]));
+    }
+  }
+  flush();
+}
+
+bool _callFollowsInSegment(
+  List<FlowMessagePart> parts,
+  int index,
+  int segment,
+  Map<String, ToolCallRecord> toolCalls,
+) {
+  for (var i = index + 1; i < parts.length; i++) {
+    if (parts[i] case FlowToolPart(:final id?)) {
+      final record = toolCalls[id];
+      if (record != null) return record.segment == segment;
+    }
+  }
+  return false;
+}
+
+List<WirePart> _wirePartsOf(List<FlowMessagePart> parts) {
+  final out = <WirePart>[];
+  for (final part in parts) {
+    switch (part) {
+      case FlowTextPart(:final text) when text.isNotEmpty:
+        out.add(WireTextPart(text));
+      case FlowAttachmentPart(:final attachments):
+        for (final attachment in attachments) {
+          final image = _imageOf(attachment.bytes, attachment.mimeType);
+          if (image != null) out.add(image);
+        }
+      case FlowImagePart(:final bytes, :final mimeType):
+        final image = _imageOf(bytes, mimeType);
+        if (image != null) out.add(image);
+      case FlowCodePart(:final code, :final language):
+        out.add(WireTextPart('```${language ?? ''}\n$code\n```'));
+      case FlowTextPart():
+      case FlowErrorPart():
+      case FlowConfirmationPart():
+      case FlowToolPart():
+      case FlowCustomPart():
+        break;
+    }
+  }
+  return out;
+}
+
+WireImagePart? _imageOf(Uint8List? bytes, String? mimeType) {
+  if (bytes == null || mimeType == null || !mimeType.startsWith('image/')) {
+    return null;
+  }
+  return WireImagePart(bytes: bytes, mimeType: mimeType);
+}
diff --git a/packages/stacflow/lib/src/errors.dart b/packages/stacflow/lib/src/errors.dart
new file mode 100644
index 0000000..3ee577d
--- /dev/null
+++ b/packages/stacflow/lib/src/errors.dart
@@ -0,0 +1,68 @@
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/strings.dart';
+
+/// Who is responsible for a failed turn: the wire classes, plus `runtime`
+/// for faults that never left the device.
+enum ChatFailureClass {
+  provider,
+  developerApi,
+  gateway,
+  policy,
+  timeout,
+  cancelled,
+  runtime,
+}
+
+/// A failed turn: a stable [code], a user-safe [message], and where the
+/// fault lies. [detail] is the provider's own wording, when there is one.
+final class ChatError {
+  const new({
+    required this.failureClass,
+    required this.code,
+    required this.message,
+    required this.retryable,
+    this.detail,
+    this.upstream,
+  });
+
+  /// The error a provider reported on the wire, worded by [strings].
+  factory fromEvent(ErrorEvent event, FlowStrings strings) => ChatError(
+    failureClass: switch (event.failureClass) {
+      FailureClass.provider => ChatFailureClass.provider,
+      FailureClass.developerApi => ChatFailureClass.developerApi,
+      FailureClass.gateway => ChatFailureClass.gateway,
+      FailureClass.policy => ChatFailureClass.policy,
+      FailureClass.timeout => ChatFailureClass.timeout,
+      FailureClass.cancelled => ChatFailureClass.cancelled,
+    },
+    code: event.code,
+    message: strings.errorMessage(event.code, detail: event.message),
+    retryable: event.retryable,
+    detail: event.message,
+    upstream: event.upstream,
+  );
+
+  /// A fault on the device: no network, a closed stream, a bug.
+  factory runtime({
+    required String code,
+    required FlowStrings strings,
+    bool retryable = true,
+    String? detail,
+  }) => ChatError(
+    failureClass: ChatFailureClass.runtime,
+    code: code,
+    message: strings.errorMessage(code, detail: detail),
+    retryable: retryable,
+    detail: detail,
+  );
+
+  final ChatFailureClass failureClass;
+  final String code;
+  final String message;
+  final String? detail;
+  final bool retryable;
+  final Upstream? upstream;
+
+  @override
+  String toString() => 'ChatError($code, ${failureClass.name})';
+}
diff --git a/packages/stacflow/lib/src/generated/error_codes.dart b/packages/stacflow/lib/src/generated/error_codes.dart
new file mode 100644
index 0000000..c9fa3b5
--- /dev/null
+++ b/packages/stacflow/lib/src/generated/error_codes.dart
@@ -0,0 +1,69 @@
+// GENERATED CODE - DO NOT EDIT.
+// Source: contracts/ - regenerate with `dart run tool/contracts_gen.dart`.
+// coverage:ignore-file
+
+import 'sse_events.dart';
+
+/// One entry of the error-code registry (contracts/error-codes.json).
+final class ErrorCodeInfo {
+  const ErrorCodeInfo({
+    required this.failureClass,
+    required this.http,
+    required this.retryable,
+    required this.description,
+  });
+  final FailureClass failureClass;
+  final int http;
+  final bool retryable;
+  final String description;
+}
+
+/// The frozen, additively growing error-code registry.
+abstract final class ErrorCodes {
+  static const String validationFailed = 'validation_failed';
+  static const String providerError = 'provider_error';
+  static const String providerRateLimited = 'provider_rate_limited';
+  static const String providerAuthFailed = 'provider_auth_failed';
+  static const String segmentTimeout = 'segment_timeout';
+  static const String cancelled = 'cancelled';
+
+  static const Map<String, ErrorCodeInfo> registry = {
+    'validation_failed': ErrorCodeInfo(
+      failureClass: FailureClass.gateway,
+      http: 422,
+      retryable: false,
+      description: 'The request failed validation before it was sent.',
+    ),
+    'provider_error': ErrorCodeInfo(
+      failureClass: FailureClass.provider,
+      http: 502,
+      retryable: true,
+      description: 'The model provider failed; upstream carries {provider, status, code}.',
+    ),
+    'provider_rate_limited': ErrorCodeInfo(
+      failureClass: FailureClass.provider,
+      http: 429,
+      retryable: true,
+      description: 'The developer\'s provider key is rate-limited or out of quota upstream.',
+    ),
+    'provider_auth_failed': ErrorCodeInfo(
+      failureClass: FailureClass.provider,
+      http: 502,
+      retryable: false,
+      description: 'The provider rejected the API key.',
+    ),
+    'segment_timeout': ErrorCodeInfo(
+      failureClass: FailureClass.timeout,
+      http: 504,
+      retryable: true,
+      description: 'The provider stream stalled past the segment deadline.',
+    ),
+    'cancelled': ErrorCodeInfo(
+      failureClass: FailureClass.cancelled,
+      http: 499,
+      retryable: false,
+      description:
+          'The client stopped the stream; the segment ends done{cancelled}.',
+    ),
+  };
+}
diff --git a/packages/stacflow/lib/src/generated/sse_events.dart b/packages/stacflow/lib/src/generated/sse_events.dart
new file mode 100644
index 0000000..13bb419
--- /dev/null
+++ b/packages/stacflow/lib/src/generated/sse_events.dart
@@ -0,0 +1,385 @@
+// GENERATED CODE - DO NOT EDIT.
+// Source: contracts/ - regenerate with `dart run tool/contracts_gen.dart`.
+// coverage:ignore-file
+
+/// The StacFlow SSE protocol v1 (contracts/sse-events.schema.json).
+///
+/// `SseEvent.decode` NEVER throws: unknown event names and payloads that
+/// fail to decode become [SseUnknownEvent] - the additive-evolution
+/// compatibility mechanism. Local-mode provider adapters emit this same
+/// union, so cloud and local modes share one event grammar.
+library;
+
+sealed class SseEvent {
+  const SseEvent();
+  int get seq;
+
+  /// Decodes one SSE frame. Never throws.
+  static SseEvent decode(String event, Map<String, dynamic> data) {
+    try {
+      return switch (event) {
+        'start' => StartEvent.fromJson(data),
+        'delta' => DeltaEvent.fromJson(data),
+        'tool_call' => ToolCallEvent.fromJson(data),
+        'usage' => UsageEvent.fromJson(data),
+        'error' => ErrorEvent.fromJson(data),
+        'done' => DoneEvent.fromJson(data),
+        _ => SseUnknownEvent(event, data),
+      };
+    } on Object {
+      return SseUnknownEvent(event, data);
+    }
+  }
+}
+
+/// Passthrough for event names or shapes this build does not know.
+final class SseUnknownEvent extends SseEvent {
+  const SseUnknownEvent(this.event, this.data);
+  final String event;
+  final Map<String, dynamic> data;
+  @override
+  int get seq => data['seq'] is int ? data['seq'] as int : -1;
+}
+
+sealed class ToolCallEvent extends SseEvent {
+  const ToolCallEvent();
+  String get toolCallId;
+
+  factory ToolCallEvent.fromJson(Map<String, dynamic> json) =>
+      switch (json['phase'] as String) {
+        'start' => ToolCallStartEvent.fromJson(json),
+        'delta' => ToolCallDeltaEvent.fromJson(json),
+        'end' => ToolCallEndEvent.fromJson(json),
+        final other => throw FormatException('unknown phase: $other'),
+      };
+}
+
+enum FailureClass {
+  provider('provider'),
+  developerApi('developer_api'),
+  gateway('gateway'),
+  policy('policy'),
+  timeout('timeout'),
+  cancelled('cancelled');
+
+  const FailureClass(this.wire);
+  final String wire;
+  static FailureClass fromWire(String wire) =>
+      values.firstWhere((v) => v.wire == wire);
+}
+
+enum ToolCallStartEventExecutor {
+  client('client'),
+  server('server');
+
+  const ToolCallStartEventExecutor(this.wire);
+  final String wire;
+  static ToolCallStartEventExecutor fromWire(String wire) =>
+      values.firstWhere((v) => v.wire == wire);
+}
+
+enum ToolCallStartEventPermissionClass {
+  read('read'),
+  write('write'),
+  destructive('destructive');
+
+  const ToolCallStartEventPermissionClass(this.wire);
+  final String wire;
+  static ToolCallStartEventPermissionClass fromWire(String wire) =>
+      values.firstWhere((v) => v.wire == wire);
+}
+
+enum DoneEventStatus {
+  complete('complete'),
+  awaitingClientTools('awaiting_client_tools'),
+  error('error'),
+  cancelled('cancelled');
+
+  const DoneEventStatus(this.wire);
+  final String wire;
+  static DoneEventStatus fromWire(String wire) =>
+      values.firstWhere((v) => v.wire == wire);
+}
+
+final class Upstream {
+  const Upstream({this.provider, this.status, this.code});
+
+  factory Upstream.fromJson(Map<String, dynamic> json) => Upstream(
+    provider: json['provider'] as String?,
+    status: json['status'] as int?,
+    code: json['code'] as String?,
+  );
+
+  final String? provider;
+  final int? status;
+  final String? code;
+
+  Map<String, dynamic> toJson() => <String, dynamic>{}
+    ..addAll(
+      provider == null
+          ? const <String, dynamic>{}
+          : <String, dynamic>{'provider': provider},
+    )
+    ..addAll(
+      status == null
+          ? const <String, dynamic>{}
+          : <String, dynamic>{'status': status},
+    )
+    ..addAll(
+      code == null
+          ? const <String, dynamic>{}
+          : <String, dynamic>{'code': code},
+    );
+}
+
+final class StartEvent extends SseEvent {
+  const StartEvent({
+    required this.seq,
+    required this.turnId,
+    required this.segment,
+    required this.messageId,
+    required this.threadId,
+    required this.model,
+    required this.agentVersionId,
+  });
+
+  factory StartEvent.fromJson(Map<String, dynamic> json) => StartEvent(
+    seq: json['seq'] as int,
+    turnId: json['turn_id'] as String,
+    segment: json['segment'] as int,
+    messageId: json['message_id'] as String,
+    threadId: json['thread_id'] as String,
+    model: json['model'] as String,
+    agentVersionId: json['agent_version_id'] as String,
+  );
+
+  final int seq;
+  final String turnId;
+  final int segment;
+  final String messageId;
+  final String threadId;
+  final String model;
+  final String agentVersionId;
+  int get protocol => 1;
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'protocol': 1,
+    'seq': seq,
+    'turn_id': turnId,
+    'segment': segment,
+    'message_id': messageId,
+    'thread_id': threadId,
+    'model': model,
+    'agent_version_id': agentVersionId,
+  };
+}
+
+final class DeltaEvent extends SseEvent {
+  const DeltaEvent({required this.seq, required this.text});
+
+  factory DeltaEvent.fromJson(Map<String, dynamic> json) =>
+      DeltaEvent(seq: json['seq'] as int, text: json['text'] as String);
+
+  final int seq;
+  final String text;
+
+  Map<String, dynamic> toJson() => <String, dynamic>{'seq': seq, 'text': text};
+}
+
+final class ToolCallStartEvent extends ToolCallEvent {
+  const ToolCallStartEvent({
+    required this.seq,
+    required this.toolCallId,
+    required this.toolName,
+    required this.executor,
+    required this.permissionClass,
+  });
+
+  factory ToolCallStartEvent.fromJson(Map<String, dynamic> json) =>
+      ToolCallStartEvent(
+        seq: json['seq'] as int,
+        toolCallId: json['tool_call_id'] as String,
+        toolName: json['tool_name'] as String,
+        executor: ToolCallStartEventExecutor.fromWire(
+          json['executor'] as String,
+        ),
+        permissionClass: ToolCallStartEventPermissionClass.fromWire(
+          json['permission_class'] as String,
+        ),
+      );
+
+  final int seq;
+  final String toolCallId;
+  final String toolName;
+  final ToolCallStartEventExecutor executor;
+  final ToolCallStartEventPermissionClass permissionClass;
+  String get phase => 'start';
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'phase': 'start',
+    'seq': seq,
+    'tool_call_id': toolCallId,
+    'tool_name': toolName,
+    'executor': executor.wire,
+    'permission_class': permissionClass.wire,
+  };
+}
+
+final class ToolCallDeltaEvent extends ToolCallEvent {
+  const ToolCallDeltaEvent({
+    required this.seq,
+    required this.toolCallId,
+    required this.argsDelta,
+  });
+
+  factory ToolCallDeltaEvent.fromJson(Map<String, dynamic> json) =>
+      ToolCallDeltaEvent(
+        seq: json['seq'] as int,
+        toolCallId: json['tool_call_id'] as String,
+        argsDelta: json['args_delta'] as String,
+      );
+
+  final int seq;
+  final String toolCallId;
+  final String argsDelta;
+  String get phase => 'delta';
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'phase': 'delta',
+    'seq': seq,
+    'tool_call_id': toolCallId,
+    'args_delta': argsDelta,
+  };
+}
+
+final class ToolCallEndEvent extends ToolCallEvent {
+  const ToolCallEndEvent({
+    required this.seq,
+    required this.toolCallId,
+    required this.args,
+  });
+
+  factory ToolCallEndEvent.fromJson(Map<String, dynamic> json) =>
+      ToolCallEndEvent(
+        seq: json['seq'] as int,
+        toolCallId: json['tool_call_id'] as String,
+        args: (json['args'] as Map).cast<String, dynamic>(),
+      );
+
+  final int seq;
+  final String toolCallId;
+  final Map<String, dynamic> args;
+  String get phase => 'end';
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'phase': 'end',
+    'seq': seq,
+    'tool_call_id': toolCallId,
+    'args': args,
+  };
+}
+
+final class UsageEvent extends SseEvent {
+  const UsageEvent({
+    required this.seq,
+    required this.providerCall,
+    required this.model,
+    required this.inputTokens,
+    required this.outputTokens,
+  });
+
+  factory UsageEvent.fromJson(Map<String, dynamic> json) => UsageEvent(
+    seq: json['seq'] as int,
+    providerCall: json['provider_call'] as int,
+    model: json['model'] as String,
+    inputTokens: json['input_tokens'] as int,
+    outputTokens: json['output_tokens'] as int,
+  );
+
+  final int seq;
+  final int providerCall;
+  final String model;
+  final int inputTokens;
+  final int outputTokens;
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'seq': seq,
+    'provider_call': providerCall,
+    'model': model,
+    'input_tokens': inputTokens,
+    'output_tokens': outputTokens,
+  };
+}
+
+final class ErrorEvent extends SseEvent {
+  const ErrorEvent({
+    required this.seq,
+    required this.failureClass,
+    required this.code,
+    required this.message,
+    required this.retryable,
+    this.upstream,
+  });
+
+  factory ErrorEvent.fromJson(Map<String, dynamic> json) => ErrorEvent(
+    seq: json['seq'] as int,
+    failureClass: FailureClass.fromWire(json['failure_class'] as String),
+    code: json['code'] as String,
+    message: json['message'] as String,
+    retryable: json['retryable'] as bool,
+    upstream: json['upstream'] == null
+        ? null
+        : Upstream.fromJson((json['upstream'] as Map).cast<String, dynamic>()),
+  );
+
+  final int seq;
+  final FailureClass failureClass;
+  final String code;
+  final String message;
+  final bool retryable;
+  final Upstream? upstream;
+
+  Map<String, dynamic> toJson() =>
+      <String, dynamic>{
+        'seq': seq,
+        'failure_class': failureClass.wire,
+        'code': code,
+        'message': message,
+        'retryable': retryable,
+      }..addAll(
+        upstream == null
+            ? const <String, dynamic>{}
+            : <String, dynamic>{'upstream': upstream!.toJson()},
+      );
+}
+
+final class DoneEvent extends SseEvent {
+  const DoneEvent({
+    required this.seq,
+    required this.status,
+    required this.turnId,
+    this.pendingToolCallIds,
+  });
+
+  factory DoneEvent.fromJson(Map<String, dynamic> json) => DoneEvent(
+    seq: json['seq'] as int,
+    status: DoneEventStatus.fromWire(json['status'] as String),
+    turnId: json['turn_id'] as String,
+    pendingToolCallIds: json['pending_tool_call_ids'] == null
+        ? null
+        : List<String>.from(json['pending_tool_call_ids'] as List),
+  );
+
+  final int seq;
+  final DoneEventStatus status;
+  final String turnId;
+  final List<String>? pendingToolCallIds;
+
+  Map<String, dynamic> toJson() =>
+      <String, dynamic>{'seq': seq, 'status': status.wire, 'turn_id': turnId}
+        ..addAll(
+          pendingToolCallIds == null
+              ? const <String, dynamic>{}
+              : <String, dynamic>{'pending_tool_call_ids': pendingToolCallIds},
+        );
+}
diff --git a/packages/stacflow/lib/src/providers/anthropic_provider.dart b/packages/stacflow/lib/src/providers/anthropic_provider.dart
new file mode 100644
index 0000000..e6907ee
--- /dev/null
+++ b/packages/stacflow/lib/src/providers/anthropic_provider.dart
@@ -0,0 +1,407 @@
+import 'dart:convert';
+import 'dart:typed_data';
+
+import 'package:http/http.dart' as http;
+import 'package:stacflow/src/generated/error_codes.dart';
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/providers/turn_runner.dart';
+import 'package:stacflow/src/transport/sse_parser.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+/// Anthropic's Messages API, called directly with an API key. Browser
+/// calls send the header Anthropic requires for that, so the key travels
+/// to the browser; keep that for development builds.
+final class AnthropicProvider implements StacFlowProvider {
+  new({
+    required this._apiKey,
+    this.model = defaultModel,
+    this.baseUrl = 'https://api.anthropic.com',
+    this.headers = const {},
+    http.Client? httpClient,
+    List<ModelOption>? models,
+    this.maxTokens = 64000,
+    this.firstByteTimeout = const Duration(seconds: 30),
+    this.idleTimeout = const Duration(seconds: 90),
+  }) : _client = httpClient,
+       models = models ?? [ModelOption(id: model, label: model)];
+
+  /// The model used when none is given; `claude-sonnet-5` is the cheaper
+  /// choice.
+  static const String defaultModel = 'claude-opus-5';
+
+  @override
+  final String model;
+
+  /// The API origin; point it at a proxy that holds the key in production.
+  final String baseUrl;
+
+  /// Extra request headers, sent before the SDK's own.
+  final Map<String, String> headers;
+
+  @override
+  final List<ModelOption> models;
+
+  /// The reply length limit the API requires, unless the agent sets one.
+  final int maxTokens;
+
+  /// How long to wait for the response headers.
+  final Duration firstByteTimeout;
+
+  /// How long to wait between chunks of the reply.
+  final Duration idleTimeout;
+
+  final String _apiKey;
+  final http.Client? _client;
+  final Map<String, List<Map<String, dynamic>>> _replay = {};
+
+  @override
+  String get id => 'anthropic';
+
+  @override
+  StacFlowProvider withModel(String model) => AnthropicProvider(
+    apiKey: _apiKey,
+    model: model,
+    baseUrl: baseUrl,
+    headers: headers,
+    httpClient: _client,
+    models: models,
+    maxTokens: maxTokens,
+    firstByteTimeout: firstByteTimeout,
+    idleTimeout: idleTimeout,
+  );
+
+  @override
+  Stream<SseEvent> run(TurnRequest request) {
+    if (request.segment == 0) _replay.clear();
+    return runTurn(
+      turn: _AnthropicTurn(this, request, _apiKey),
+      request: request,
+      providerId: id,
+      model: model,
+      apiKey: _apiKey,
+      client: _client,
+      firstByteTimeout: firstByteTimeout,
+      idleTimeout: idleTimeout,
+    );
+  }
+
+  @override
+  String toString() => 'AnthropicProvider(model: $model)';
+}
+
+final class _AnthropicTurn extends ProviderTurn {
+  new(this.provider, this.request, this._apiKey);
+
+  final AnthropicProvider provider;
+  final TurnRequest request;
+  final String _apiKey;
+
+  static const Set<String> _imageTypes = {
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+  };
+
+  static const Set<String> _schemaMeta = {r'$schema', r'$id', r'$comment'};
+
+  String? _stopReason;
+  final Map<int, Map<String, dynamic>> _blocks = {};
+  final Map<int, String> _callIds = {};
+  final Map<int, StringBuffer> _partialJson = {};
+  final Map<int, StringBuffer> _thinking = {};
+
+  @override
+  Uri get url => Uri.parse('${_trimSlash(provider.baseUrl)}/v1/messages');
+
+  @override
+  Map<String, String> get headers => {
+    ...provider.headers,
+    'content-type': 'application/json',
+    'accept': 'text/event-stream',
+    'anthropic-version': '2023-06-01',
+    'anthropic-dangerous-direct-browser-access': 'true',
+    'x-api-key': _apiKey,
+  };
+
+  @override
+  Uint8List get body {
+    final agent = request.agent;
+    final json = <String, Object?>{
+      'model': provider.model,
+      'max_tokens': agent.maxOutputTokens ?? provider.maxTokens,
+      'stream': true,
+      if (agent.instructions case final instructions?
+          when instructions.isNotEmpty)
+        'system': instructions,
+      if (agent.temperature != null) 'temperature': agent.temperature,
+      if (request.tools.isNotEmpty)
+        'tools': [
+          for (final tool in request.tools)
+            {
+              'name': tool.name,
+              'description': tool.description,
+              'input_schema': {
+                for (final entry in tool.parameters.entries)
+                  if (!_schemaMeta.contains(entry.key)) entry.key: entry.value,
+                'type': 'object',
+              },
+            },
+        ],
+      'messages': [
+        for (final message in withToolResults(request.history))
+          _message(message),
+      ],
+    };
+    return utf8.encode(jsonEncode(json));
+  }
+
+  Map<String, Object?> _message(WireMessage message) {
+    final isUser = message.role == WireRole.user;
+    if (!isUser) {
+      final calls = message.parts.whereType<WireToolCallPart>();
+      final cached = calls.isEmpty ? null : provider._replay[calls.first.id];
+      if (cached != null) return {'role': 'assistant', 'content': cached};
+    }
+    final results = <Map<String, Object?>>[];
+    final others = <Map<String, Object?>>[];
+    for (final part in message.parts) {
+      switch (part) {
+        case WireTextPart(:final text) when text.trim().isNotEmpty:
+          others.add({'type': 'text', 'text': text});
+        case WireImagePart(:final bytes, :final mimeType)
+            when isUser && _imageTypes.contains(mimeType):
+          others.add({
+            'type': 'image',
+            'source': {
+              'type': 'base64',
+              'media_type': mimeType,
+              'data': base64Encode(bytes),
+            },
+          });
+        case WireToolCallPart(:final id, :final name, :final args) when !isUser:
+          others.add({
+            'type': 'tool_use',
+            'id': providerCallIdOf(id) ?? id,
+            'name': name,
+            'input': args,
+          });
+        case WireToolResultPart(:final id, :final status, :final result)
+            when isUser:
+          results.add({
+            'type': 'tool_result',
+            'tool_use_id': providerCallIdOf(id) ?? id,
+            if (status != WireToolResultStatus.ok || result != null)
+              'content': resultText(part),
+            if (status != WireToolResultStatus.ok) 'is_error': true,
+          });
+        case WireTextPart():
+        case WireImagePart():
+        case WireToolCallPart():
+        case WireToolResultPart():
+          break;
+      }
+    }
+    return {
+      'role': isUser ? 'user' : 'assistant',
+      'content': [...results, ...others],
+    };
+  }
+
+  @override
+  void onFrame(SseFrame frame, TurnEmitter out) {
+    final json = decodeJsonObject(frame.data);
+    if (json == null) return;
+    final type = frame.event ?? stringAt(json, 'type');
+    switch (type) {
+      case 'message_start':
+        final message = objectAt(json, 'message');
+        final usage = message == null ? null : objectAt(message, 'usage');
+        if (usage != null) {
+          out.usage(inputTokens: intAt(usage, 'input_tokens'));
+        }
+      case 'content_block_start':
+        _onBlockStart(json, out);
+      case 'content_block_delta':
+        _onBlockDelta(json, out);
+      case 'content_block_stop':
+        _onBlockStop(json, out);
+      case 'message_delta':
+        final delta = objectAt(json, 'delta');
+        _stopReason = delta == null
+            ? _stopReason
+            : stringAt(delta, 'stop_reason') ?? _stopReason;
+        final usage = objectAt(json, 'usage');
+        if (usage != null) {
+          out.usage(
+            inputTokens: intAt(usage, 'input_tokens'),
+            outputTokens: intAt(usage, 'output_tokens'),
+          );
+        }
+      case 'message_stop':
+        if (_stopReason == 'refusal') {
+          out.fail(
+            const ProviderFailure(
+              code: ErrorCodes.providerError,
+              message: 'The model declined this request.',
+              retryable: false,
+              status: 200,
+              upstreamCode: 'refusal',
+            ),
+          );
+        } else {
+          _stopReason ??= 'end_turn';
+          _cacheReplay();
+          out.complete();
+        }
+      case 'error':
+        out.fail(_failure(200, objectAt(json, 'error')));
+    }
+  }
+
+  void _onBlockStart(Map<String, dynamic> json, TurnEmitter out) {
+    final index = intAt(json, 'index') ?? _blocks.length;
+    final block = objectAt(json, 'content_block');
+    if (block == null) return;
+    switch (stringAt(block, 'type')) {
+      case 'text':
+        _blocks[index] = {
+          'type': 'text',
+          'text': stringAt(block, 'text') ?? '',
+        };
+      case 'tool_use':
+        final name = stringAt(block, 'name') ?? '';
+        final providerId = stringAt(block, 'id');
+        final id = out.toolCallStart(name: name, providerCallId: providerId);
+        _callIds[index] = id;
+        _partialJson[index] = StringBuffer();
+        _blocks[index] = {
+          'type': 'tool_use',
+          'id': providerId ?? id,
+          'name': name,
+          'input': <String, dynamic>{},
+        };
+      case 'thinking':
+        _thinking[index] = StringBuffer(stringAt(block, 'thinking') ?? '');
+        _blocks[index] = {
+          'type': 'thinking',
+          'thinking': '',
+          'signature': stringAt(block, 'signature') ?? '',
+        };
+      case 'redacted_thinking':
+        _blocks[index] = {
+          'type': 'redacted_thinking',
+          'data': stringAt(block, 'data') ?? '',
+        };
+    }
+  }
+
+  void _onBlockDelta(Map<String, dynamic> json, TurnEmitter out) {
+    final index = intAt(json, 'index') ?? -1;
+    final delta = objectAt(json, 'delta');
+    if (delta == null) return;
+    switch (stringAt(delta, 'type')) {
+      case 'text_delta':
+        final text = stringAt(delta, 'text') ?? '';
+        out.delta(text);
+        final block = _blocks[index];
+        if (block != null && block['type'] == 'text') {
+          block['text'] = '${block['text']}$text';
+        }
+      case 'input_json_delta':
+        final id = _callIds[index];
+        final fragment = stringAt(delta, 'partial_json') ?? '';
+        if (id != null) {
+          out.toolCallDelta(id, fragment);
+          _partialJson[index]?.write(fragment);
+        }
+      case 'thinking_delta':
+        _thinking[index]?.write(stringAt(delta, 'thinking') ?? '');
+      case 'signature_delta':
+        final block = _blocks[index];
+        if (block != null) {
+          block['signature'] = stringAt(delta, 'signature') ?? '';
+        }
+    }
+  }
+
+  void _onBlockStop(Map<String, dynamic> json, TurnEmitter out) {
+    final index = intAt(json, 'index') ?? -1;
+    final thinking = _thinking[index];
+    final block = _blocks[index];
+    if (thinking != null && block != null) {
+      block['thinking'] = thinking.toString();
+    }
+    final id = _callIds[index];
+    if (id == null) return;
+    final raw = (_partialJson[index]?.toString() ?? '').trim();
+    final args = raw.isEmpty ? <String, dynamic>{} : decodeJsonObject(raw);
+    if (args == null) {
+      out.toolCallEnd(id);
+      return;
+    }
+    block?['input'] = args;
+    out.toolCallEnd(id, args: args);
+  }
+
+  void _cacheReplay() {
+    if (_callIds.isEmpty) return;
+    final indices = _blocks.keys.toList()..sort();
+    final content = [
+      for (final index in indices)
+        if (_blocks[index] case final block?
+            when block['type'] != 'text' ||
+                (block['text'] as String).isNotEmpty)
+          block,
+    ];
+    final firstCall = (_callIds.keys.toList()..sort()).first;
+    provider._replay[_callIds[firstCall]!] = content;
+  }
+
+  @override
+  void onEnd(TurnEmitter out) {
+    if (_stopReason != null) {
+      _cacheReplay();
+      out.complete();
+    } else {
+      out.transportFailure(
+        const ProviderTransportException(
+          'The stream ended before the reply was complete.',
+        ),
+      );
+    }
+  }
+
+  @override
+  ProviderFailure mapHttpError(int status, String body) {
+    final json = decodeJsonObject(body);
+    return _failure(status, json == null ? null : objectAt(json, 'error'));
+  }
+
+  ProviderFailure _failure(int status, Map<String, dynamic>? error) {
+    final type = error == null ? null : stringAt(error, 'type');
+    final message = error == null ? null : stringAt(error, 'message');
+    final (code, retryable) = switch (type) {
+      'overloaded_error' || 'api_error' => (ErrorCodes.providerError, true),
+      'rate_limit_error' => (ErrorCodes.providerRateLimited, true),
+      'authentication_error' ||
+      'permission_error' => (ErrorCodes.providerAuthFailed, false),
+      'invalid_request_error' ||
+      'request_too_large' => (ErrorCodes.validationFailed, false),
+      _ => (null, null),
+    };
+    return httpFailure(
+      status,
+      provider: provider.id,
+      detail: message == null ? null : scrub(message, apiKey: _apiKey),
+      upstreamCode: type,
+      code: code,
+      retryable: retryable,
+    );
+  }
+}
+
+String _trimSlash(String url) =>
+    url.endsWith('/') ? url.substring(0, url.length - 1) : url;
diff --git a/packages/stacflow/lib/src/providers/gemini_provider.dart b/packages/stacflow/lib/src/providers/gemini_provider.dart
new file mode 100644
index 0000000..500893b
--- /dev/null
+++ b/packages/stacflow/lib/src/providers/gemini_provider.dart
@@ -0,0 +1,376 @@
+import 'dart:convert';
+import 'dart:typed_data';
+
+import 'package:http/http.dart' as http;
+import 'package:stacflow/src/generated/error_codes.dart';
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/providers/turn_runner.dart';
+import 'package:stacflow/src/transport/sse_parser.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+/// Google's Gemini API, called directly with an API key from AI Studio.
+final class GeminiProvider implements StacFlowProvider {
+  new({
+    required this._apiKey,
+    this.model = defaultModel,
+    this.baseUrl = 'https://generativelanguage.googleapis.com',
+    this.headers = const {},
+    http.Client? httpClient,
+    List<ModelOption>? models,
+    this.firstByteTimeout = const Duration(seconds: 30),
+    this.idleTimeout = const Duration(seconds: 90),
+  }) : _client = httpClient,
+       models = models ?? [ModelOption(id: model, label: model)];
+
+  /// The model used when none is given.
+  static const String defaultModel = 'gemini-3.6-flash';
+
+  @override
+  final String model;
+
+  /// The API origin; point it at a proxy that holds the key in production.
+  final String baseUrl;
+
+  /// Extra request headers, sent before the SDK's own.
+  final Map<String, String> headers;
+
+  @override
+  final List<ModelOption> models;
+
+  /// How long to wait for the response headers.
+  final Duration firstByteTimeout;
+
+  /// How long to wait between chunks of the reply.
+  final Duration idleTimeout;
+
+  final String _apiKey;
+  final http.Client? _client;
+  final Map<String, List<Map<String, dynamic>>> _replay = {};
+
+  @override
+  String get id => 'gemini';
+
+  @override
+  StacFlowProvider withModel(String model) => GeminiProvider(
+    apiKey: _apiKey,
+    model: model,
+    baseUrl: baseUrl,
+    headers: headers,
+    httpClient: _client,
+    models: models,
+    firstByteTimeout: firstByteTimeout,
+    idleTimeout: idleTimeout,
+  );
+
+  @override
+  Stream<SseEvent> run(TurnRequest request) {
+    if (request.segment == 0) _replay.clear();
+    return runTurn(
+      turn: _GeminiTurn(this, request, _apiKey),
+      request: request,
+      providerId: id,
+      model: model,
+      apiKey: _apiKey,
+      client: _client,
+      firstByteTimeout: firstByteTimeout,
+      idleTimeout: idleTimeout,
+    );
+  }
+
+  @override
+  String toString() => 'GeminiProvider(model: $model)';
+}
+
+final class _GeminiTurn extends ProviderTurn {
+  new(this.provider, this.request, this._apiKey);
+
+  final GeminiProvider provider;
+  final TurnRequest request;
+  final String _apiKey;
+
+  static const Set<String> _imageTypes = {
+    'image/png',
+    'image/jpeg',
+    'image/webp',
+    'image/heic',
+    'image/heif',
+  };
+
+  static const Set<String> _schemaKeywords = {
+    'type',
+    'format',
+    'title',
+    'description',
+    'nullable',
+    'enum',
+    'properties',
+    'required',
+    'items',
+    'minItems',
+    'maxItems',
+    'minimum',
+    'maximum',
+    'minLength',
+    'maxLength',
+    'pattern',
+    'anyOf',
+    'default',
+  };
+
+  bool _sawFrame = false;
+  final List<Map<String, dynamic>> _parts = [];
+  final List<String> _callIds = [];
+
+  @override
+  Uri get url {
+    final base = provider.baseUrl.endsWith('/')
+        ? provider.baseUrl.substring(0, provider.baseUrl.length - 1)
+        : provider.baseUrl;
+    return Uri.parse(
+      '$base/v1beta/models/${provider.model}:streamGenerateContent?alt=sse',
+    );
+  }
+
+  @override
+  Map<String, String> get headers => {
+    ...provider.headers,
+    'content-type': 'application/json',
+    'accept': 'text/event-stream',
+    'x-goog-api-key': _apiKey,
+  };
+
+  @override
+  Uint8List get body {
+    final agent = request.agent;
+    final generationConfig = <String, Object?>{
+      if (agent.temperature != null) 'temperature': agent.temperature,
+      if (agent.maxOutputTokens != null)
+        'maxOutputTokens': agent.maxOutputTokens,
+    };
+    final json = <String, Object?>{
+      if (agent.instructions case final instructions?
+          when instructions.isNotEmpty)
+        'systemInstruction': {
+          'parts': [
+            {'text': instructions},
+          ],
+        },
+      if (request.tools.isNotEmpty)
+        'tools': [
+          {
+            'functionDeclarations': [
+              for (final tool in request.tools)
+                {
+                  'name': tool.name,
+                  'description': tool.description,
+                  'parameters': providerSchema(
+                    tool.parameters,
+                    keywords: _schemaKeywords,
+                  ),
+                },
+            ],
+          },
+        ],
+      'contents': [
+        for (final message in withToolResults(request.history))
+          _content(message),
+      ],
+      if (generationConfig.isNotEmpty) 'generationConfig': generationConfig,
+    };
+    return utf8.encode(jsonEncode(json));
+  }
+
+  Map<String, Object?> _content(WireMessage message) {
+    final isUser = message.role == WireRole.user;
+    if (!isUser) {
+      final calls = message.parts.whereType<WireToolCallPart>();
+      final cached = calls.isEmpty ? null : provider._replay[calls.first.id];
+      if (cached != null) return {'role': 'model', 'parts': cached};
+    }
+    final results = <Map<String, Object?>>[];
+    final others = <Map<String, Object?>>[];
+    for (final part in message.parts) {
+      switch (part) {
+        case WireTextPart(:final text):
+          others.add({'text': text});
+        case WireImagePart(:final bytes, :final mimeType)
+            when _imageTypes.contains(mimeType):
+          others.add({
+            'inlineData': {'mimeType': mimeType, 'data': base64Encode(bytes)},
+          });
+        case WireToolCallPart(:final id, :final name, :final args) when !isUser:
+          final providerId = providerCallIdOf(id);
+          others.add({
+            'functionCall': {'id': ?providerId, 'name': name, 'args': args},
+          });
+        case WireToolResultPart(:final id, :final name) when isUser:
+          final providerId = providerCallIdOf(id);
+          results.add({
+            'functionResponse': {
+              'id': ?providerId,
+              'name': name,
+              'response': _response(part),
+            },
+          });
+        case WireImagePart():
+        case WireToolCallPart():
+        case WireToolResultPart():
+          break;
+      }
+    }
+    return {
+      'role': isUser ? 'user' : 'model',
+      'parts': [...results, ...others],
+    };
+  }
+
+  Map<String, Object?> _response(WireToolResultPart part) =>
+      switch (part.status) {
+        WireToolResultStatus.ok => switch (part.result) {
+          final Map<dynamic, dynamic> map => map.cast<String, Object?>(),
+          final other => {'output': other},
+        },
+        WireToolResultStatus.declined => {'error': declinedSentence},
+        WireToolResultStatus.error => {
+          'error': part.error ?? 'The tool failed.',
+        },
+      };
+
+  @override
+  void onFrame(SseFrame frame, TurnEmitter out) {
+    final json = decodeJsonObject(frame.data);
+    if (json == null) return;
+    _sawFrame = true;
+    if (objectAt(json, 'error') case final error?) {
+      out.fail(_failure(intAt(error, 'code') ?? 502, error));
+      return;
+    }
+    final candidates = objectsAt(json, 'candidates');
+    if (candidates.isEmpty) {
+      final feedback = objectAt(json, 'promptFeedback');
+      final reason = feedback == null
+          ? null
+          : stringAt(feedback, 'blockReason');
+      if (reason != null) {
+        out.fail(
+          ProviderFailure(
+            code: ErrorCodes.providerError,
+            message: 'The request was blocked by the provider ($reason).',
+            retryable: false,
+            status: 200,
+            upstreamCode: reason,
+          ),
+        );
+      }
+      return;
+    }
+    final candidate = candidates.first;
+    final content = objectAt(candidate, 'content');
+    if (content != null) {
+      for (final part in objectsAt(content, 'parts')) {
+        if (part['thought'] == true) continue;
+        _parts.add(part);
+        final text = stringAt(part, 'text');
+        if (text != null) out.delta(text);
+        final call = objectAt(part, 'functionCall');
+        if (call != null) {
+          final id = out.toolCallStart(
+            name: stringAt(call, 'name') ?? '',
+            providerCallId: stringAt(call, 'id'),
+          );
+          _callIds.add(id);
+          out.toolCallEnd(
+            id,
+            args: objectAt(call, 'args') ?? <String, dynamic>{},
+          );
+        }
+      }
+    }
+    if (objectAt(json, 'usageMetadata') case final usage?) {
+      final output = intAt(usage, 'candidatesTokenCount');
+      final thoughts = intAt(usage, 'thoughtsTokenCount') ?? 0;
+      out.usage(
+        inputTokens: intAt(usage, 'promptTokenCount'),
+        outputTokens: output == null ? null : output + thoughts,
+      );
+    }
+    final finish = stringAt(candidate, 'finishReason');
+    if (finish == 'MALFORMED_FUNCTION_CALL') {
+      out.fail(
+        ProviderFailure(
+          code: ErrorCodes.providerError,
+          message:
+              stringAt(candidate, 'finishMessage') ??
+              'The model produced a malformed tool call.',
+          retryable: true,
+          status: 200,
+          upstreamCode: finish,
+        ),
+      );
+    } else if (finish != null && finish != 'STOP' && finish != 'MAX_TOKENS') {
+      out.fail(
+        ProviderFailure(
+          code: ErrorCodes.providerError,
+          message: 'The reply was cut short by the provider ($finish).',
+          retryable: false,
+          status: 200,
+          upstreamCode: finish,
+        ),
+      );
+    }
+  }
+
+  @override
+  void onEnd(TurnEmitter out) {
+    if (_sawFrame) {
+      if (_callIds.isNotEmpty) {
+        provider._replay[_callIds.first] = List.of(_parts);
+      }
+      out.complete();
+    } else {
+      out.transportFailure(
+        const ProviderTransportException(
+          'The stream ended before any data arrived.',
+        ),
+      );
+    }
+  }
+
+  @override
+  ProviderFailure mapHttpError(int status, String body) {
+    final json = decodeJsonObject(body);
+    final error = json == null ? null : objectAt(json, 'error');
+    return _failure(status, error);
+  }
+
+  ProviderFailure _failure(int status, Map<String, dynamic>? error) {
+    final message = error == null ? null : stringAt(error, 'message');
+    final upstreamCode = error == null
+        ? null
+        : stringAt(error, 'status') ?? stringAt(error, 'code');
+    final detail = message == null ? null : scrub(message, apiKey: _apiKey);
+    final invalidKey =
+        status == 400 &&
+        (upstreamCode == 'INVALID_ARGUMENT' &&
+                (message?.contains('API key') ?? false) ||
+            _hasReason(error, 'API_KEY_INVALID'));
+    return httpFailure(
+      status,
+      provider: provider.id,
+      detail: detail,
+      upstreamCode: upstreamCode,
+      code: invalidKey ? ErrorCodes.providerAuthFailed : null,
+      retryable: invalidKey ? false : null,
+    );
+  }
+
+  static bool _hasReason(Map<String, dynamic>? error, String reason) {
+    if (error == null) return false;
+    for (final detail in objectsAt(error, 'details')) {
+      if (stringAt(detail, 'reason') == reason) return true;
+    }
+    return false;
+  }
+}
diff --git a/packages/stacflow/lib/src/providers/openai_provider.dart b/packages/stacflow/lib/src/providers/openai_provider.dart
new file mode 100644
index 0000000..156a6ca
--- /dev/null
+++ b/packages/stacflow/lib/src/providers/openai_provider.dart
@@ -0,0 +1,397 @@
+import 'dart:convert';
+import 'dart:typed_data';
+
+import 'package:http/http.dart' as http;
+import 'package:stacflow/src/generated/error_codes.dart';
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/providers/turn_runner.dart';
+import 'package:stacflow/src/transport/sse_parser.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+/// OpenAI's Chat Completions API, called directly with an API key. Point
+/// [baseUrl] at any compatible server: Ollama, Groq, OpenRouter, LM Studio,
+/// vLLM, or a proxy of your own that holds the key.
+final class OpenAIProvider implements StacFlowProvider {
+  new({
+    required this._apiKey,
+    this.model = defaultModel,
+    this.baseUrl = 'https://api.openai.com/v1',
+    this.headers = const {},
+    http.Client? httpClient,
+    List<ModelOption>? models,
+    this.includeUsage = true,
+    this.firstByteTimeout = const Duration(seconds: 30),
+    this.idleTimeout = const Duration(seconds: 90),
+  }) : _client = httpClient,
+       models = models ?? [ModelOption(id: model, label: model)];
+
+  /// The model used when none is given.
+  static const String defaultModel = 'gpt-5-mini';
+
+  @override
+  final String model;
+
+  /// The API origin, including the version path.
+  final String baseUrl;
+
+  /// Extra request headers, sent before the SDK's own.
+  final Map<String, String> headers;
+
+  @override
+  final List<ModelOption> models;
+
+  /// Asks for token counts in the final chunk; turn off for compatible
+  /// servers that reject `stream_options`.
+  final bool includeUsage;
+
+  /// How long to wait for the response headers.
+  final Duration firstByteTimeout;
+
+  /// How long to wait between chunks of the reply.
+  final Duration idleTimeout;
+
+  final String _apiKey;
+  final http.Client? _client;
+
+  @override
+  String get id => 'openai';
+
+  @override
+  StacFlowProvider withModel(String model) => OpenAIProvider(
+    apiKey: _apiKey,
+    model: model,
+    baseUrl: baseUrl,
+    headers: headers,
+    httpClient: _client,
+    models: models,
+    includeUsage: includeUsage,
+    firstByteTimeout: firstByteTimeout,
+    idleTimeout: idleTimeout,
+  );
+
+  @override
+  Stream<SseEvent> run(TurnRequest request) => runTurn(
+    turn: _OpenAITurn(this, request, _apiKey),
+    request: request,
+    providerId: id,
+    model: model,
+    apiKey: _apiKey,
+    client: _client,
+    firstByteTimeout: firstByteTimeout,
+    idleTimeout: idleTimeout,
+  );
+
+  @override
+  String toString() => 'OpenAIProvider(model: $model)';
+}
+
+final class _OpenAITurn extends ProviderTurn {
+  new(this.provider, this.request, this._apiKey);
+
+  final OpenAIProvider provider;
+  final TurnRequest request;
+  final String _apiKey;
+
+  static const Set<String> _imageTypes = {
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+  };
+
+  static const Set<String> _finalCodes = {
+    'insufficient_quota',
+    'billing_hard_limit_reached',
+    'credit_balance_exhausted',
+  };
+
+  static const Set<String> _schemaMeta = {r'$schema', r'$id', r'$comment'};
+
+  String? _finishReason;
+  final Map<int, _PendingCall> _calls = {};
+  int? _liveIndex;
+  int? _lastIndex;
+
+  @override
+  Uri get url {
+    final base = provider.baseUrl.endsWith('/')
+        ? provider.baseUrl.substring(0, provider.baseUrl.length - 1)
+        : provider.baseUrl;
+    return Uri.parse('$base/chat/completions');
+  }
+
+  @override
+  Map<String, String> get headers => {
+    ...provider.headers,
+    'content-type': 'application/json',
+    'accept': 'text/event-stream',
+    'authorization': 'Bearer $_apiKey',
+  };
+
+  @override
+  Uint8List get body {
+    final agent = request.agent;
+    final json = <String, Object?>{
+      'model': provider.model,
+      'stream': true,
+      if (provider.includeUsage) 'stream_options': {'include_usage': true},
+      if (request.tools.isNotEmpty)
+        'tools': [
+          for (final tool in request.tools)
+            {
+              'type': 'function',
+              'function': {
+                'name': tool.name,
+                'description': tool.description,
+                'parameters': {
+                  for (final entry in tool.parameters.entries)
+                    if (!_schemaMeta.contains(entry.key))
+                      entry.key: entry.value,
+                  'type': 'object',
+                },
+              },
+            },
+        ],
+      'messages': [
+        if (agent.instructions case final instructions?
+            when instructions.isNotEmpty)
+          {'role': 'system', 'content': instructions},
+        for (final message in withToolResults(request.history))
+          ..._messages(message),
+      ],
+      if (agent.temperature != null) 'temperature': agent.temperature,
+      if (agent.maxOutputTokens != null)
+        'max_completion_tokens': agent.maxOutputTokens,
+    };
+    return utf8.encode(jsonEncode(json));
+  }
+
+  List<Map<String, Object?>> _messages(WireMessage message) {
+    if (message.role == WireRole.assistant) {
+      final calls = message.parts.whereType<WireToolCallPart>().toList();
+      if (calls.isEmpty) return [_message(message)];
+      final text = [
+        for (final part in message.parts)
+          if (part is WireTextPart) part.text,
+      ].join('\n');
+      return [
+        {
+          'role': 'assistant',
+          'content': text.isEmpty ? null : text,
+          'tool_calls': [
+            for (final call in calls)
+              {
+                'id': providerCallIdOf(call.id) ?? call.id,
+                'type': 'function',
+                'function': {
+                  'name': call.name,
+                  'arguments': jsonEncode(call.args),
+                },
+              },
+          ],
+        },
+      ];
+    }
+    final results = message.parts.whereType<WireToolResultPart>().toList();
+    final rest = [
+      for (final part in message.parts)
+        if (part is! WireToolResultPart) part,
+    ];
+    return [
+      for (final result in results)
+        {
+          'role': 'tool',
+          'tool_call_id': providerCallIdOf(result.id) ?? result.id,
+          'content': resultText(result),
+        },
+      if (rest.isNotEmpty)
+        _message(WireMessage(role: WireRole.user, parts: rest)),
+    ];
+  }
+
+  Map<String, Object?> _message(WireMessage message) {
+    final role = message.role == WireRole.user ? 'user' : 'assistant';
+    final textOnly = message.parts.every((part) => part is WireTextPart);
+    if (textOnly) {
+      return {
+        'role': role,
+        'content': [
+          for (final part in message.parts)
+            if (part is WireTextPart) part.text,
+        ].join('\n'),
+      };
+    }
+    return {
+      'role': role,
+      'content': [
+        for (final part in message.parts)
+          switch (part) {
+            WireTextPart(:final text) => {'type': 'text', 'text': text},
+            WireImagePart(:final bytes, :final mimeType)
+                when message.role == WireRole.user &&
+                    _imageTypes.contains(mimeType) =>
+              {
+                'type': 'image_url',
+                'image_url': {
+                  'url': 'data:$mimeType;base64,${base64Encode(bytes)}',
+                },
+              },
+            WireImagePart() ||
+            WireToolCallPart() ||
+            WireToolResultPart() => null,
+          },
+      ].nonNulls.toList(),
+    };
+  }
+
+  @override
+  void onFrame(SseFrame frame, TurnEmitter out) {
+    if (frame.data.trim() == '[DONE]') {
+      _finishReason ??= 'stop';
+      _flushCalls(out);
+      out.complete();
+      return;
+    }
+    final json = decodeJsonObject(frame.data);
+    if (json == null) return;
+    if (objectAt(json, 'error') case final error?) {
+      out.fail(_failure(200, error));
+      return;
+    }
+    final choices = objectsAt(json, 'choices');
+    if (choices.isNotEmpty) {
+      final choice = choices.first;
+      final delta = objectAt(choice, 'delta');
+      if (delta != null) {
+        final content = stringAt(delta, 'content');
+        if (content != null) out.delta(content);
+        for (final call in objectsAt(delta, 'tool_calls')) {
+          _onToolCallChunk(call, out);
+        }
+      }
+      final finish = stringAt(choice, 'finish_reason');
+      if (finish != null) {
+        _finishReason = finish;
+        _flushCalls(out);
+        if (finish == 'content_filter') {
+          out.fail(
+            const ProviderFailure(
+              code: ErrorCodes.providerError,
+              message: 'The reply was blocked by the content filter.',
+              retryable: false,
+              status: 200,
+              upstreamCode: 'content_filter',
+            ),
+          );
+        }
+      }
+    }
+    if (objectAt(json, 'usage') case final usage?) {
+      out.usage(
+        inputTokens: intAt(usage, 'prompt_tokens'),
+        outputTokens: intAt(usage, 'completion_tokens'),
+      );
+    }
+  }
+
+  void _onToolCallChunk(Map<String, dynamic> call, TurnEmitter out) {
+    final function = objectAt(call, 'function');
+    final name = function == null ? null : stringAt(function, 'name');
+    final fragment = function == null ? null : stringAt(function, 'arguments');
+    final named = name != null && name.isNotEmpty;
+    final index =
+        intAt(call, 'index') ??
+        (named ? _calls.length : _lastIndex ?? _calls.length);
+    _lastIndex = index;
+    final pending = _calls[index] ??= _PendingCall();
+    if (named && pending.name == null) {
+      pending
+        ..name = name
+        ..providerId = stringAt(call, 'id');
+    }
+    if (_liveIndex == index) {
+      if (fragment != null && fragment.isNotEmpty) {
+        out.toolCallDelta(pending.id, fragment);
+      }
+      return;
+    }
+    if (fragment != null && fragment.isNotEmpty) pending.args.write(fragment);
+    final pendingName = pending.name;
+    if (_liveIndex == null && pendingName != null) {
+      _liveIndex = index;
+      pending.id = out.toolCallStart(
+        name: pendingName,
+        providerCallId: pending.providerId,
+      );
+      final held = pending.args.toString();
+      pending.args.clear();
+      if (held.isNotEmpty) out.toolCallDelta(pending.id, held);
+    }
+  }
+
+  void _flushCalls(TurnEmitter out) {
+    if (_liveIndex case final live?) {
+      _liveIndex = null;
+      if (_calls.remove(live) case final pending?) out.toolCallEnd(pending.id);
+    }
+    final indices = _calls.keys.toList()..sort();
+    for (final index in indices) {
+      final pending = _calls.remove(index)!;
+      final name = pending.name;
+      if (name == null) continue;
+      final id = out.toolCallStart(
+        name: name,
+        providerCallId: pending.providerId,
+      );
+      final args = pending.args.toString();
+      if (args.isNotEmpty) out.toolCallDelta(id, args);
+      out.toolCallEnd(id);
+    }
+  }
+
+  @override
+  void onEnd(TurnEmitter out) {
+    if (_finishReason != null) {
+      _flushCalls(out);
+      out.complete();
+    } else {
+      out.transportFailure(
+        const ProviderTransportException(
+          'The stream ended before the reply was complete.',
+        ),
+      );
+    }
+  }
+
+  @override
+  ProviderFailure mapHttpError(int status, String body) {
+    final json = decodeJsonObject(body);
+    return _failure(status, json == null ? null : objectAt(json, 'error'));
+  }
+
+  ProviderFailure _failure(int status, Map<String, dynamic>? error) {
+    final message = error == null ? null : stringAt(error, 'message');
+    final code = error == null ? null : stringAt(error, 'code');
+    final type = error == null ? null : stringAt(error, 'type');
+    final upstream = code ?? type;
+    return httpFailure(
+      status,
+      provider: provider.id,
+      detail: message == null ? null : scrub(message, apiKey: _apiKey),
+      upstreamCode: upstream,
+      retryable: status == 429 && upstream != null
+          ? !(_finalCodes.contains(upstream) ||
+                upstream.endsWith('spend_limit_exceeded'))
+          : null,
+    );
+  }
+}
+
+final class _PendingCall {
+  String? name;
+  String? providerId;
+  String id = '';
+  final StringBuffer args = StringBuffer();
+}
diff --git a/packages/stacflow/lib/src/providers/provider.dart b/packages/stacflow/lib/src/providers/provider.dart
new file mode 100644
index 0000000..3eedfad
--- /dev/null
+++ b/packages/stacflow/lib/src/providers/provider.dart
@@ -0,0 +1,49 @@
+import 'package:stacflow/src/transport/turn_transport.dart';
+
+/// What every turn carries besides the conversation: the system
+/// instructions and the sampling knobs. Unset fields are left out of the
+/// request.
+final class AgentConfig {
+  const new({this.instructions, this.temperature, this.maxOutputTokens});
+
+  final String? instructions;
+  final double? temperature;
+  final int? maxOutputTokens;
+}
+
+/// A model a provider can be pointed at, as a selector shows it.
+final class ModelOption {
+  const new({required this.id, required this.label, this.description});
+
+  final String id;
+  final String label;
+  final String? description;
+}
+
+/// One model API spoken natively with the developer's own key.
+abstract interface class StacFlowProvider implements TurnTransport {
+  /// `gemini`, `openai` or `anthropic`; reported as the upstream provider
+  /// on errors.
+  String get id;
+
+  /// The model sent on the wire.
+  String get model;
+
+  /// The models a selector can offer; always contains [model].
+  List<ModelOption> get models;
+
+  /// The same provider aimed at another model.
+  StacFlowProvider withModel(String model);
+}
+
+/// The network failed before a response arrived, or the connection closed
+/// mid-stream. Worth retrying; never carries headers or URLs.
+final class ProviderTransportException implements Exception {
+  const new(this.message, {this.cause});
+
+  final String message;
+  final Object? cause;
+
+  @override
+  String toString() => 'ProviderTransportException: $message';
+}
diff --git a/packages/stacflow/lib/src/providers/turn_runner.dart b/packages/stacflow/lib/src/providers/turn_runner.dart
new file mode 100644
index 0000000..718a8a6
--- /dev/null
+++ b/packages/stacflow/lib/src/providers/turn_runner.dart
@@ -0,0 +1,545 @@
+import 'dart:async';
+import 'dart:convert';
+import 'dart:math';
+import 'dart:typed_data';
+
+import 'package:http/http.dart' as http;
+import 'package:stacflow/src/generated/error_codes.dart';
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/transport/sse_parser.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+final class ProviderFailure {
+  const new({
+    required this.code,
+    required this.message,
+    this.retryable,
+    this.status,
+    this.upstreamCode,
+  });
+
+  final String code;
+  final String message;
+  final bool? retryable;
+  final int? status;
+  final String? upstreamCode;
+}
+
+abstract base class ProviderTurn {
+  Uri get url;
+  Map<String, String> get headers;
+  Uint8List get body;
+  void onFrame(SseFrame frame, TurnEmitter out);
+  void onEnd(TurnEmitter out);
+  ProviderFailure mapHttpError(int status, String body);
+}
+
+final class TurnEmitter {
+  new({
+    required this.ids,
+    required this.segment,
+    required this.model,
+    required this.providerId,
+    required List<Tool> tools,
+    required this._sink,
+    required this._errorSink,
+    required this._onTerminal,
+  }) : _tools = {for (final tool in tools) tool.name: tool};
+
+  static final IdGenerator _minter = IdGenerator();
+
+  final TurnIds ids;
+  final int segment;
+  final String model;
+  final String providerId;
+  final Map<String, Tool> _tools;
+  final void Function(SseEvent event) _sink;
+  final void Function(Object error) _errorSink;
+  final void Function() _onTerminal;
+
+  int _seq = 0;
+  bool _done = false;
+  int? _inputTokens;
+  int? _outputTokens;
+  _OpenCall? _open;
+  final List<String> _callIds = [];
+  final StringBuffer _heldText = StringBuffer();
+
+  bool get isDone => _done;
+
+  List<String> get toolCallIds => List.unmodifiable(_callIds);
+
+  void start() {
+    _sink(
+      StartEvent(
+        seq: _seq++,
+        turnId: ids.turnId,
+        segment: segment,
+        messageId: ids.messageId,
+        threadId: ids.threadId,
+        model: model,
+        agentVersionId: TurnIds.agentVersionId,
+      ),
+    );
+  }
+
+  void delta(String text) {
+    if (_done || text.isEmpty) return;
+    if (_open != null) {
+      _heldText.write(text);
+      return;
+    }
+    _sink(DeltaEvent(seq: _seq++, text: text));
+  }
+
+  String toolCallStart({required String name, String? providerCallId}) {
+    final open = _open;
+    if (open != null) {
+      toolCallEnd(open.id);
+      if (_done) return open.id;
+    }
+    if (_done) return '';
+    final id = providerCallId == null || providerCallId.isEmpty
+        ? _minter.toolCall()
+        : toolCallIdFor(providerCallId);
+    final permission = _tools[name]?.permission ?? ToolPermission.read;
+    _open = _OpenCall(id, name);
+    _callIds.add(id);
+    _sink(
+      ToolCallStartEvent(
+        seq: _seq++,
+        toolCallId: id,
+        toolName: name,
+        executor: ToolCallStartEventExecutor.client,
+        permissionClass: switch (permission) {
+          ToolPermission.read => ToolCallStartEventPermissionClass.read,
+          ToolPermission.write => ToolCallStartEventPermissionClass.write,
+          ToolPermission.destructive =>
+            ToolCallStartEventPermissionClass.destructive,
+        },
+      ),
+    );
+    return id;
+  }
+
+  void toolCallDelta(String id, String fragment) {
+    final open = _open;
+    if (_done || open == null || open.id != id || fragment.isEmpty) return;
+    open.buffer.write(fragment);
+    _sink(ToolCallDeltaEvent(seq: _seq++, toolCallId: id, argsDelta: fragment));
+  }
+
+  void toolCallEnd(String id, {Map<String, dynamic>? args}) {
+    final open = _open;
+    if (_done || open == null || open.id != id) return;
+    final raw = open.buffer.toString().trim();
+    final parsed = args ?? decodeJsonObject(raw.isEmpty ? '{}' : raw);
+    _open = null;
+    if (parsed == null) {
+      fail(
+        ProviderFailure(
+          code: ErrorCodes.providerError,
+          message: 'The model sent malformed arguments for ${open.name}.',
+          retryable: true,
+          status: 200,
+          upstreamCode: 'malformed_tool_args',
+        ),
+      );
+      return;
+    }
+    _sink(ToolCallEndEvent(seq: _seq++, toolCallId: id, args: parsed));
+    if (_heldText.isNotEmpty) {
+      final text = _heldText.toString();
+      _heldText.clear();
+      _sink(DeltaEvent(seq: _seq++, text: text));
+    }
+  }
+
+  void usage({int? inputTokens, int? outputTokens}) {
+    if (inputTokens != null) _inputTokens = inputTokens;
+    if (outputTokens != null) _outputTokens = outputTokens;
+  }
+
+  void complete() => _finish(DoneEventStatus.complete);
+
+  void cancel() => _finish(DoneEventStatus.cancelled);
+
+  void fail(ProviderFailure failure) {
+    if (_done) return;
+    _open = null;
+    _flushUsage();
+    final info = ErrorCodes.registry[failure.code];
+    _sink(
+      ErrorEvent(
+        seq: _seq++,
+        failureClass: info?.failureClass ?? FailureClass.provider,
+        code: failure.code,
+        message: failure.message,
+        retryable: failure.retryable ?? info?.retryable ?? true,
+        upstream: Upstream(
+          provider: providerId,
+          status: failure.status,
+          code: failure.upstreamCode,
+        ),
+      ),
+    );
+    _finish(DoneEventStatus.error);
+  }
+
+  void transportFailure(ProviderTransportException exception) {
+    if (_done) return;
+    _done = true;
+    _errorSink(exception);
+    _onTerminal();
+  }
+
+  void _finish(DoneEventStatus status) {
+    if (_done) return;
+    final open = _open;
+    if (status == DoneEventStatus.complete && open != null) {
+      toolCallEnd(open.id);
+      if (_done) return;
+    }
+    if (status != DoneEventStatus.cancelled) _flushUsage();
+    final awaiting = status == DoneEventStatus.complete && _callIds.isNotEmpty;
+    _sink(
+      DoneEvent(
+        seq: _seq++,
+        status: awaiting ? DoneEventStatus.awaitingClientTools : status,
+        turnId: ids.turnId,
+        pendingToolCallIds: awaiting ? List.unmodifiable(_callIds) : null,
+      ),
+    );
+    _done = true;
+    _onTerminal();
+  }
+
+  void _flushUsage() {
+    if (_inputTokens == null && _outputTokens == null) return;
+    _sink(
+      UsageEvent(
+        seq: _seq++,
+        providerCall: segment,
+        model: model,
+        inputTokens: _inputTokens ?? 0,
+        outputTokens: _outputTokens ?? 0,
+      ),
+    );
+    _inputTokens = null;
+    _outputTokens = null;
+  }
+}
+
+final class _OpenCall {
+  new(this.id, this.name);
+
+  final String id;
+  final String name;
+  final StringBuffer buffer = StringBuffer();
+}
+
+Stream<SseEvent> runTurn({
+  required ProviderTurn turn,
+  required TurnRequest request,
+  required String providerId,
+  required String model,
+  required String apiKey,
+  required http.Client? client,
+  required Duration firstByteTimeout,
+  required Duration idleTimeout,
+}) {
+  late final StreamController<SseEvent> controller;
+  late final TurnEmitter emitter;
+  StreamSubscription<SseFrame>? subscription;
+  http.Client? owned;
+  final abortSignal = Completer<void>();
+  var finished = false;
+
+  void finish() {
+    if (finished) return;
+    finished = true;
+    unawaited(subscription?.cancel());
+    if (!abortSignal.isCompleted) abortSignal.complete();
+    owned?.close();
+    unawaited(controller.close());
+  }
+
+  ProviderFailure timeoutFailure() => const ProviderFailure(
+    code: ErrorCodes.segmentTimeout,
+    message: 'The model did not answer in time.',
+    retryable: true,
+  );
+
+  Future<void> run() async {
+    emitter.start();
+    if (apiKey.trim().isEmpty) {
+      emitter.fail(
+        ProviderFailure(
+          code: ErrorCodes.providerAuthFailed,
+          message: 'No API key was set for $providerId.',
+          retryable: false,
+        ),
+      );
+      return;
+    }
+    final effective = client ?? (owned = http.Client());
+    final http.StreamedResponse response;
+    try {
+      final httpRequest =
+          http.AbortableRequest(
+              'POST',
+              turn.url,
+              abortTrigger: abortSignal.future,
+            )
+            ..headers.addAll(turn.headers)
+            ..bodyBytes = turn.body;
+      response = await effective.send(httpRequest).timeout(firstByteTimeout);
+    } on TimeoutException {
+      emitter.fail(timeoutFailure());
+      return;
+    } on http.RequestAbortedException {
+      emitter.cancel();
+      return;
+    } on http.ClientException catch (error) {
+      emitter.transportFailure(
+        ProviderTransportException(
+          'The connection to ${turn.url.host} failed before a response '
+          'arrived.',
+          cause: error,
+        ),
+      );
+      return;
+    }
+    if (emitter.isDone) return;
+    if (response.statusCode != 200) {
+      var body = '';
+      try {
+        body = await _readCapped(response.stream).timeout(idleTimeout);
+      } on Object {
+        body = '';
+      }
+      emitter.fail(turn.mapHttpError(response.statusCode, body));
+      return;
+    }
+    subscription = response.stream
+        .timeout(idleTimeout)
+        .transform(const SseDecoder())
+        .listen(
+          (frame) {
+            if (!emitter.isDone) turn.onFrame(frame, emitter);
+          },
+          onError: (Object error) {
+            if (emitter.isDone) return;
+            if (error is TimeoutException) {
+              emitter.fail(timeoutFailure());
+            } else if (error is http.RequestAbortedException) {
+              emitter.cancel();
+            } else {
+              emitter.transportFailure(
+                ProviderTransportException(
+                  'The connection to ${turn.url.host} was lost mid-stream.',
+                  cause: error,
+                ),
+              );
+            }
+          },
+          onDone: () {
+            if (!emitter.isDone) turn.onEnd(emitter);
+          },
+          cancelOnError: true,
+        );
+  }
+
+  controller = StreamController<SseEvent>(
+    onListen: () {
+      unawaited(
+        request.abortTrigger.then((_) {
+          if (emitter.isDone) return;
+          if (!abortSignal.isCompleted) abortSignal.complete();
+          emitter.cancel();
+        }),
+      );
+      unawaited(run());
+    },
+    onCancel: finish,
+  );
+  emitter = TurnEmitter(
+    ids: request.ids,
+    segment: request.segment,
+    model: model,
+    providerId: providerId,
+    tools: request.tools,
+    sink: controller.add,
+    errorSink: controller.addError,
+    onTerminal: finish,
+  );
+  return controller.stream;
+}
+
+Future<String> _readCapped(Stream<List<int>> stream) async {
+  final bytes = await stream.toList();
+  final all = bytes.expand((chunk) => chunk).toList();
+  final capped = all.sublist(0, min(all.length, 64 * 1024));
+  return const Utf8Decoder(allowMalformed: true).convert(capped);
+}
+
+String scrub(String text, {required String apiKey, int maxLength = 300}) {
+  var out = text.trim();
+  if (apiKey.isNotEmpty) out = out.replaceAll(apiKey, '[redacted]');
+  if (out.length > maxLength) out = '${out.substring(0, maxLength)}...';
+  return out;
+}
+
+ProviderFailure httpFailure(
+  int status, {
+  required String provider,
+  String? detail,
+  String? upstreamCode,
+  String? code,
+  bool? retryable,
+}) {
+  final (defaultCode, defaultRetryable) = switch (status) {
+    401 || 403 => (ErrorCodes.providerAuthFailed, false),
+    429 => (ErrorCodes.providerRateLimited, true),
+    400 || 404 || 413 || 422 => (ErrorCodes.validationFailed, false),
+    408 || 500 || 502 || 503 || 504 || 529 => (ErrorCodes.providerError, true),
+    _ => (ErrorCodes.providerError, status >= 500),
+  };
+  return ProviderFailure(
+    code: code ?? defaultCode,
+    message: detail == null || detail.isEmpty
+        ? 'HTTP $status from $provider.'
+        : detail,
+    retryable: retryable ?? defaultRetryable,
+    status: status,
+    upstreamCode: upstreamCode,
+  );
+}
+
+const String declinedSentence =
+    'The user declined to run this tool call. Do not retry it or work '
+    'around it; ask the user how they want to proceed.';
+
+Map<String, dynamic> providerSchema(
+  Map<String, dynamic> schema, {
+  required Set<String> keywords,
+}) {
+  final out = <String, dynamic>{};
+  for (final entry in schema.entries) {
+    final key = entry.key;
+    final value = entry.value;
+    if (!keywords.contains(key)) continue;
+    out[key] = switch (key) {
+      'properties' when value is Map => {
+        for (final property in value.entries)
+          '${property.key}': property.value is Map
+              ? providerSchema(
+                  (property.value as Map).cast<String, dynamic>(),
+                  keywords: keywords,
+                )
+              : property.value,
+      },
+      'items' when value is Map => providerSchema(
+        value.cast<String, dynamic>(),
+        keywords: keywords,
+      ),
+      'anyOf' || 'oneOf' || 'allOf' when value is List => [
+        for (final option in value)
+          if (option is Map)
+            providerSchema(option.cast<String, dynamic>(), keywords: keywords),
+      ],
+      _ => value,
+    };
+  }
+  return out;
+}
+
+String resultText(WireToolResultPart part) {
+  switch (part.status) {
+    case WireToolResultStatus.ok:
+      final result = part.result;
+      return result is String ? result : jsonEncode(result);
+    case WireToolResultStatus.declined:
+      return jsonEncode({'error': declinedSentence});
+    case WireToolResultStatus.error:
+      return jsonEncode({'error': part.error ?? 'The tool failed.'});
+  }
+}
+
+List<WireMessage> withToolResults(List<WireMessage> history) {
+  final out = <WireMessage>[];
+  var index = 0;
+  while (index < history.length) {
+    final message = history[index++];
+    out.add(message);
+    if (message.role != WireRole.assistant) continue;
+    final calls = [
+      for (final part in message.parts)
+        if (part is WireToolCallPart) part,
+    ];
+    if (calls.isEmpty) continue;
+    final next = index < history.length ? history[index] : null;
+    final user = next != null && next.role == WireRole.user ? next : null;
+    final answered = {
+      if (user != null)
+        for (final part in user.parts)
+          if (part is WireToolResultPart) part.id,
+    };
+    final missing = [
+      for (final call in calls)
+        if (!answered.contains(call.id))
+          WireToolResultPart(
+            id: call.id,
+            name: call.name,
+            status: WireToolResultStatus.error,
+            error: 'Not executed.',
+          ),
+    ];
+    if (missing.isEmpty) continue;
+    if (user != null) {
+      index++;
+      out.add(
+        WireMessage(role: WireRole.user, parts: [...missing, ...user.parts]),
+      );
+    } else {
+      out.add(WireMessage(role: WireRole.user, parts: missing));
+    }
+  }
+  return out;
+}
+
+Map<String, dynamic>? decodeJsonObject(String text) {
+  try {
+    final decoded = jsonDecode(text);
+    return decoded is Map<String, dynamic> ? decoded : null;
+  } on FormatException {
+    return null;
+  }
+}
+
+Map<String, dynamic>? objectAt(Map<String, dynamic> json, String key) {
+  final value = json[key];
+  return value is Map<String, dynamic> ? value : null;
+}
+
+List<Map<String, dynamic>> objectsAt(Map<String, dynamic> json, String key) {
+  final value = json[key];
+  if (value is! List) return const [];
+  return [
+    for (final item in value)
+      if (item is Map<String, dynamic>) item,
+  ];
+}
+
+String? stringAt(Map<String, dynamic> json, String key) {
+  final value = json[key];
+  return value is String ? value : null;
+}
+
+int? intAt(Map<String, dynamic> json, String key) {
+  final value = json[key];
+  return value is int ? value : null;
+}
diff --git a/packages/stacflow/lib/src/strings.dart b/packages/stacflow/lib/src/strings.dart
new file mode 100644
index 0000000..c2c6ada
--- /dev/null
+++ b/packages/stacflow/lib/src/strings.dart
@@ -0,0 +1,83 @@
+import 'package:flow_ui/flow_ui.dart';
+
+/// Every string the SDK shows, with English defaults. Subclass and override
+/// to localise.
+class FlowStrings {
+  const new();
+
+  String get thinking => 'Thinking...';
+  String get placeholder => 'How can I help you today?';
+  String get errorTitle => 'Something went wrong';
+  String get retry => 'Try again';
+  String get copy => 'Copy';
+  String get copied => 'Copied';
+  String get copyCode => 'Copy code';
+  String get dismiss => 'Dismiss';
+  String get goodResponse => 'Good response';
+  String get badResponse => 'Bad response';
+  String get regenerate => 'Regenerate';
+  String get edit => 'Edit';
+  String get jumpToLatest => 'Jump to latest';
+  String get attach => 'Attach';
+  String get dropFiles => 'Drop files to attach';
+  String get removeAttachment => 'Remove';
+  String get approvalTitle => 'Approval required';
+  String get approve => 'Approve';
+  String get reject => 'Reject';
+  String get approved => 'Approved';
+  String get rejected => 'Rejected';
+  String get toolInput => 'Input';
+  String get toolOutput => 'Output';
+  String get toolDeclined => 'You declined this call.';
+  String get toolFailed => 'The tool failed.';
+  String get toolTimedOut => 'The tool took too long to finish.';
+  String get toolCancelled => 'The call was stopped.';
+  String get toolUnknown =>
+      'The model asked for a tool this app does not have.';
+  String get errorAuth =>
+      'The API key was rejected. Check the key and try again.';
+  String get errorRateLimited =>
+      'The model is busy right now. Try again in a moment.';
+  String get errorTimeout => 'The model took too long to answer.';
+  String get errorNetwork =>
+      'Could not reach the model. Check your connection and try again.';
+  String get errorProvider => 'The model returned an error.';
+  String get errorToolRounds =>
+      'The model kept calling tools without answering. Try again.';
+  String get errorGeneric => 'Something went wrong. Try again.';
+
+  /// The error card's text for a failed turn, by error [code]; [detail] is
+  /// the provider's own message when it is worth showing.
+  String errorMessage(String code, {String? detail}) => switch (code) {
+    'provider_auth_failed' => errorAuth,
+    'provider_rate_limited' => errorRateLimited,
+    'segment_timeout' => errorTimeout,
+    'network' || 'stream_closed' => errorNetwork,
+    'tool_rounds_exceeded' => errorToolRounds,
+    'provider_error' || 'validation_failed' =>
+      detail == null || detail.isEmpty ? errorProvider : detail,
+    _ => errorGeneric,
+  };
+
+  /// The confirmation card's question when the tool writes none.
+  String approvalMessage(String label) => 'Allow $label to run?';
+
+  /// The tool card's failure line, by error [code]; [detail] is the tool's
+  /// own message when it wrote one.
+  String toolError(String code, {String? detail}) => switch (code) {
+    'declined' => toolDeclined,
+    'timeout' => toolTimedOut,
+    'cancelled' => toolCancelled,
+    'unknown_tool' => toolUnknown,
+    'tool_error' => detail == null || detail.isEmpty ? toolFailed : detail,
+    _ => toolFailed,
+  };
+
+  /// The composer's banner for a file it refused.
+  String attachmentRejected(String name, FlowAttachmentRejection reason) =>
+      switch (reason) {
+        FlowAttachmentRejection.tooLarge => '$name is too large.',
+        FlowAttachmentRejection.unsupportedType => '$name is not an image.',
+        FlowAttachmentRejection.unreadable => '$name could not be read.',
+      };
+}
diff --git a/packages/stacflow/lib/src/tools/tool.dart b/packages/stacflow/lib/src/tools/tool.dart
new file mode 100644
index 0000000..61f204b
--- /dev/null
+++ b/packages/stacflow/lib/src/tools/tool.dart
@@ -0,0 +1,199 @@
+import 'dart:async';
+
+/// What a tool may do. Read runs silently, write runs unless the tool
+/// asks to confirm, destructive always asks first.
+enum ToolPermission { read, write, destructive }
+
+/// An action the app lets the model take: the model reads [description]
+/// and [parameters], the SDK runs [run] with the arguments it chose.
+final class Tool {
+  const new({
+    required this.name,
+    required this.description,
+    required this.run,
+    this.parameters = emptyParameters,
+    this.permission = ToolPermission.write,
+    this.confirm = false,
+    this.label,
+    this.detail,
+    this.confirmation,
+    this.timeout = const Duration(seconds: 30),
+  }) : assert(
+         permission != ToolPermission.read || !confirm,
+         'read tools run without asking',
+       );
+
+  /// A parameter schema for a tool that takes nothing.
+  static const Map<String, dynamic> emptyParameters = {
+    'type': 'object',
+    'properties': <String, dynamic>{},
+  };
+
+  /// Letters, digits, underscores and dashes, at most 64 characters.
+  static bool isValidName(String name) => _namePattern.hasMatch(name);
+
+  static final RegExp _namePattern = RegExp(r'^[A-Za-z0-9_-]{1,64}$');
+
+  /// The name the model calls; unique within a chat.
+  final String name;
+
+  /// What the tool does and when to use it, written for the model.
+  final String description;
+
+  /// A JSON Schema object describing the arguments.
+  final Map<String, dynamic> parameters;
+
+  final ToolPermission permission;
+
+  /// Asks the user before running a write tool.
+  final bool confirm;
+
+  /// The card's title; the name shows when null.
+  final String? label;
+
+  /// The card's chip for a call's arguments, e.g. the file being deleted.
+  final String? Function(Map<String, dynamic> args)? detail;
+
+  /// The confirmation card's question for a call's arguments.
+  final String Function(Map<String, dynamic> args)? confirmation;
+
+  /// Runs the call and returns a JSON-encodable result; throw a
+  /// [ToolException] to report a failure in your own words.
+  final FutureOr<Object?> Function(ToolCall call) run;
+
+  /// How long a call may run before it fails.
+  final Duration timeout;
+
+  /// Whether a call waits for the user's approval before it runs.
+  bool get requiresConfirmation => switch (permission) {
+    ToolPermission.read => false,
+    ToolPermission.write => confirm,
+    ToolPermission.destructive => true,
+  };
+}
+
+/// One call of a tool, as its handler receives it.
+final class ToolCall {
+  new({
+    required this.id,
+    required this.name,
+    required this.args,
+    required this.aborted,
+  }) {
+    unawaited(aborted.then((_) => _isAborted = true));
+  }
+
+  final String id;
+  final String name;
+  final Map<String, dynamic> args;
+
+  /// Completes when the call is stopped, times out or the turn ends.
+  final Future<void> aborted;
+
+  bool _isAborted = false;
+
+  /// Whether [aborted] has completed.
+  bool get isAborted => _isAborted;
+}
+
+/// A failure a tool reports in its own words; the message reaches the
+/// card and the model.
+class ToolException implements Exception {
+  const new(this.message);
+
+  final String message;
+
+  @override
+  String toString() => 'ToolException: $message';
+}
+
+/// Where a tool call stands.
+enum ToolCallStatus { pending, awaitingApproval, running, ok, error, declined }
+
+/// The codes a [ToolCallError] carries.
+abstract final class ToolErrorCodes {
+  static const String declined = 'declined';
+  static const String cancelled = 'cancelled';
+  static const String timeout = 'timeout';
+  static const String unknownTool = 'unknown_tool';
+  static const String toolError = 'tool_error';
+  static const String toolFailed = 'tool_failed';
+  static const String roundsExceeded = 'tool_rounds_exceeded';
+}
+
+/// Why a tool call did not return a result.
+final class ToolCallError {
+  const new({required this.code, required this.message});
+
+  static const ToolCallError cancelled = ToolCallError(
+    code: ToolErrorCodes.cancelled,
+    message: 'The call was cancelled.',
+  );
+
+  final String code;
+
+  /// Model-facing English; the card shows the SDK's own wording.
+  final String message;
+}
+
+/// One tool call the thread made: its arguments, status and outcome.
+final class ToolCallRecord {
+  const new({
+    required this.id,
+    required this.name,
+    required this.segment,
+    this.args = const {},
+    this.status = ToolCallStatus.pending,
+    this.result,
+    this.error,
+    this.startedAt,
+    this.finishedAt,
+  });
+
+  final String id;
+  final String name;
+
+  /// The turn segment that made the call.
+  final int segment;
+
+  /// Empty until the model finishes streaming them.
+  final Map<String, dynamic> args;
+
+  final ToolCallStatus status;
+
+  /// The JSON value the tool returned, once [status] is ok.
+  final Object? result;
+
+  /// Set when [status] is error or declined.
+  final ToolCallError? error;
+
+  final DateTime? startedAt;
+  final DateTime? finishedAt;
+
+  /// Whether the call has an outcome.
+  bool get isSettled => switch (status) {
+    ToolCallStatus.ok ||
+    ToolCallStatus.error ||
+    ToolCallStatus.declined => true,
+    _ => false,
+  };
+
+  ToolCallRecord copyWith({
+    Map<String, dynamic>? args,
+    ToolCallStatus? status,
+    Object? result,
+    ToolCallError? error,
+    DateTime? startedAt,
+    DateTime? finishedAt,
+  }) => ToolCallRecord(
+    id: id,
+    name: name,
+    segment: segment,
+    args: args ?? this.args,
+    status: status ?? this.status,
+    result: result ?? this.result,
+    error: error ?? this.error,
+    startedAt: startedAt ?? this.startedAt,
+    finishedAt: finishedAt ?? this.finishedAt,
+  );
+}
diff --git a/packages/stacflow/lib/src/tools/tool_loop.dart b/packages/stacflow/lib/src/tools/tool_loop.dart
new file mode 100644
index 0000000..837da77
--- /dev/null
+++ b/packages/stacflow/lib/src/tools/tool_loop.dart
@@ -0,0 +1,381 @@
+import 'dart:async';
+import 'dart:convert';
+
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+import 'package:stacflow/src/transport/turn_transport.dart';
+
+/// Decides whether a gated call may run.
+typedef ToolApprover = Future<bool> Function(ToolCallRecord record);
+
+/// Hears every change to a call's record.
+typedef ToolCallObserver = void Function(ToolCallRecord record);
+
+/// Runs one turn with client-side tools: every segment's events as one
+/// stream, handlers run between segments, results fed back until the
+/// model answers or [maxRounds] segments have called tools.
+Stream<SseEvent> runToolLoop({
+  required TurnTransport transport,
+  required TurnRequest request,
+  required ToolApprover approve,
+  required ToolCallObserver onCall,
+  int maxRounds = 8,
+}) => _ToolLoop(
+  transport: transport,
+  request: request,
+  approve: approve,
+  onCall: onCall,
+  maxRounds: maxRounds,
+).stream;
+
+final class _ToolLoop {
+  new({
+    required this.transport,
+    required this.request,
+    required this.approve,
+    required this.onCall,
+    required this.maxRounds,
+  }) : _tools = {for (final tool in request.tools) tool.name: tool} {
+    _controller = StreamController<SseEvent>(
+      onListen: _start,
+      onCancel: _finish,
+      sync: true,
+    );
+  }
+
+  final TurnTransport transport;
+  final TurnRequest request;
+  final ToolApprover approve;
+  final ToolCallObserver onCall;
+  final int maxRounds;
+  final Map<String, Tool> _tools;
+  final Map<String, ToolCallRecord> _records = {};
+  final Completer<void> _abort = Completer<void>();
+  late final StreamController<SseEvent> _controller;
+  StreamSubscription<SseEvent>? _subscription;
+  _Segment? _segment;
+  bool _finished = false;
+
+  Stream<SseEvent> get stream => _controller.stream;
+
+  void _start() {
+    unawaited(request.abortTrigger.then((_) => _cancelHandlers()));
+    _runSegment(request.history, 0);
+  }
+
+  void _runSegment(List<WireMessage> history, int index) {
+    if (_finished) return;
+    final segment = _Segment(index: index, history: history);
+    _segment = segment;
+    _subscription = transport
+        .run(
+          TurnRequest(
+            history: history,
+            agent: request.agent,
+            ids: request.ids,
+            abortTrigger: request.abortTrigger,
+            tools: request.tools,
+            segment: index,
+          ),
+        )
+        .listen(
+          (event) => _onEvent(segment, event),
+          onError: (Object error, StackTrace stack) {
+            if (_finished) return;
+            _cancelHandlers();
+            _controller.addError(error, stack);
+            _finish();
+          },
+          onDone: () {
+            if (!segment.done) _finish();
+          },
+          cancelOnError: true,
+        );
+  }
+
+  void _onEvent(_Segment segment, SseEvent event) {
+    if (_finished || !identical(_segment, segment)) return;
+    switch (event) {
+      case DeltaEvent(:final text):
+        segment.text.write(text);
+        _controller.add(event);
+      case ToolCallStartEvent(:final toolCallId, :final toolName):
+        segment.flushText();
+        final record = ToolCallRecord(
+          id: toolCallId,
+          name: toolName,
+          segment: segment.index,
+        );
+        _records[toolCallId] = record;
+        segment.callIds.add(toolCallId);
+        onCall(record);
+        _controller.add(event);
+      case ToolCallEndEvent(:final toolCallId, :final args):
+        final record = _records[toolCallId];
+        if (record == null) {
+          _controller.add(event);
+          return;
+        }
+        final updated = record.copyWith(args: args);
+        _records[toolCallId] = updated;
+        segment.parts.add(WireToolCallPart.of(updated));
+        _controller.add(event);
+        segment.dispatched.add(_dispatch(updated));
+      case DoneEvent(:final status, :final seq, :final turnId):
+        segment
+          ..done = true
+          ..flushText();
+        switch (status) {
+          case DoneEventStatus.complete:
+          case DoneEventStatus.awaitingClientTools:
+            if (segment.callIds.isEmpty) {
+              _controller.add(event);
+              _finish();
+            } else {
+              _controller.add(
+                DoneEvent(
+                  seq: seq,
+                  status: DoneEventStatus.awaitingClientTools,
+                  turnId: turnId,
+                  pendingToolCallIds: List.of(segment.callIds),
+                ),
+              );
+              unawaited(_continue(segment, seq));
+            }
+          case DoneEventStatus.error:
+          case DoneEventStatus.cancelled:
+            _cancelHandlers();
+            _controller.add(event);
+            _finish();
+        }
+      case _:
+        _controller.add(event);
+    }
+  }
+
+  Future<void> _continue(_Segment segment, int lastSeq) async {
+    await Future.wait(segment.dispatched);
+    if (_finished) return;
+    if (_abort.isCompleted) {
+      _controller.add(
+        DoneEvent(
+          seq: lastSeq + 1,
+          status: DoneEventStatus.cancelled,
+          turnId: request.ids.turnId,
+        ),
+      );
+      _finish();
+      return;
+    }
+    final exceeded = segment.callIds.any(
+      (id) => _records[id]?.error?.code == ToolErrorCodes.roundsExceeded,
+    );
+    if (exceeded) {
+      _controller
+        ..add(
+          ErrorEvent(
+            seq: lastSeq + 1,
+            failureClass: FailureClass.policy,
+            code: ToolErrorCodes.roundsExceeded,
+            message:
+                'The model called tools in more than $maxRounds segments '
+                'of one turn.',
+            retryable: true,
+          ),
+        )
+        ..add(
+          DoneEvent(
+            seq: lastSeq + 2,
+            status: DoneEventStatus.error,
+            turnId: request.ids.turnId,
+          ),
+        );
+      _finish();
+      return;
+    }
+    _runSegment([
+      ...segment.history,
+      WireMessage(role: WireRole.assistant, parts: segment.parts),
+      WireMessage(
+        role: WireRole.user,
+        parts: [
+          for (final id in segment.callIds)
+            WireToolResultPart.of(_records[id]!),
+        ],
+      ),
+    ], segment.index + 1);
+  }
+
+  Future<void> _dispatch(ToolCallRecord initial) async {
+    var record = initial;
+    void update(
+      ToolCallStatus status, {
+      Object? result,
+      ToolCallError? error,
+      DateTime? startedAt,
+      DateTime? finishedAt,
+    }) {
+      record = record.copyWith(
+        status: status,
+        result: result,
+        error: error,
+        startedAt: startedAt,
+        finishedAt: finishedAt,
+      );
+      _records[record.id] = record;
+      onCall(record);
+    }
+
+    void settle(ToolCallStatus status, {Object? result, ToolCallError? error}) {
+      update(status, result: result, error: error, finishedAt: DateTime.now());
+    }
+
+    final tool = _tools[record.name];
+    if (tool == null) {
+      settle(
+        ToolCallStatus.error,
+        error: ToolCallError(
+          code: ToolErrorCodes.unknownTool,
+          message: 'No tool named "${record.name}" is registered.',
+        ),
+      );
+      return;
+    }
+    if (record.segment >= maxRounds) {
+      settle(
+        ToolCallStatus.error,
+        error: const ToolCallError(
+          code: ToolErrorCodes.roundsExceeded,
+          message: 'Tool calls are not allowed in this segment.',
+        ),
+      );
+      return;
+    }
+    if (tool.requiresConfirmation) {
+      update(ToolCallStatus.awaitingApproval);
+      var approved = false;
+      try {
+        approved = await Future.any([
+          approve(record),
+          _abort.future.then((_) => false),
+        ]);
+      } on Object {
+        approved = false;
+      }
+      if (_abort.isCompleted) {
+        settle(ToolCallStatus.error, error: ToolCallError.cancelled);
+        return;
+      }
+      if (!approved) {
+        settle(
+          ToolCallStatus.declined,
+          error: const ToolCallError(
+            code: ToolErrorCodes.declined,
+            message: 'The user declined this call.',
+          ),
+        );
+        return;
+      }
+    }
+    update(ToolCallStatus.running, startedAt: DateTime.now());
+    final callAbort = Completer<void>();
+    unawaited(
+      _abort.future.then((_) {
+        if (!callAbort.isCompleted) callAbort.complete();
+      }),
+    );
+    final call = ToolCall(
+      id: record.id,
+      name: record.name,
+      args: record.args,
+      aborted: callAbort.future,
+    );
+    final done = Completer<Object?>();
+    unawaited(
+      Future.sync(() => tool.run(call)).then(
+        (value) {
+          if (!done.isCompleted) done.complete(value);
+        },
+        onError: (Object error, StackTrace stack) {
+          if (!done.isCompleted) done.completeError(error, stack);
+        },
+      ),
+    );
+    unawaited(
+      _abort.future.then((_) {
+        if (!done.isCompleted) done.completeError(const _Aborted());
+      }),
+    );
+    try {
+      final value = await done.future.timeout(tool.timeout);
+      settle(ToolCallStatus.ok, result: _normalize(value));
+    } on TimeoutException {
+      if (!callAbort.isCompleted) callAbort.complete();
+      settle(
+        ToolCallStatus.error,
+        error: ToolCallError(
+          code: ToolErrorCodes.timeout,
+          message:
+              'The tool did not finish within '
+              '${tool.timeout.inSeconds} seconds.',
+        ),
+      );
+    } on _Aborted {
+      settle(ToolCallStatus.error, error: ToolCallError.cancelled);
+    } on ToolException catch (error) {
+      settle(
+        ToolCallStatus.error,
+        error: ToolCallError(
+          code: ToolErrorCodes.toolError,
+          message: error.message,
+        ),
+      );
+    } on Object catch (error) {
+      settle(
+        ToolCallStatus.error,
+        error: ToolCallError(
+          code: ToolErrorCodes.toolFailed,
+          message: error.toString(),
+        ),
+      );
+    }
+  }
+
+  void _cancelHandlers() {
+    if (!_abort.isCompleted) _abort.complete();
+  }
+
+  void _finish() {
+    if (_finished) return;
+    _finished = true;
+    _cancelHandlers();
+    unawaited(_subscription?.cancel());
+    unawaited(_controller.close());
+  }
+}
+
+Object? _normalize(Object? value) =>
+    jsonDecode(jsonEncode(value, toEncodable: (object) => object.toString()));
+
+final class _Segment {
+  new({required this.index, required this.history});
+
+  final int index;
+  final List<WireMessage> history;
+  final StringBuffer text = StringBuffer();
+  final List<WirePart> parts = [];
+  final List<Future<void>> dispatched = [];
+  final List<String> callIds = [];
+  bool done = false;
+
+  void flushText() {
+    if (text.isEmpty) return;
+    parts.add(WireTextPart(text.toString()));
+    text.clear();
+  }
+}
+
+final class _Aborted implements Exception {
+  const new();
+}
diff --git a/packages/stacflow/lib/src/transport/sse_parser.dart b/packages/stacflow/lib/src/transport/sse_parser.dart
new file mode 100644
index 0000000..ef09fff
--- /dev/null
+++ b/packages/stacflow/lib/src/transport/sse_parser.dart
@@ -0,0 +1,88 @@
+import 'dart:async';
+import 'dart:convert';
+
+final class SseFrame {
+  const new({required this.data, this.event, this.id, this.retry});
+
+  final String data;
+  final String? event;
+  final String? id;
+  final int? retry;
+
+  @override
+  String toString() => 'SseFrame(event: $event, data: $data)';
+}
+
+final class SseDecoder extends StreamTransformerBase<List<int>, SseFrame> {
+  const new();
+
+  @override
+  Stream<SseFrame> bind(Stream<List<int>> stream) => stream
+      .transform(const Utf8Decoder(allowMalformed: true))
+      .transform(const LineSplitter())
+      .transform(const SseLineParser());
+}
+
+final class SseLineParser extends StreamTransformerBase<String, SseFrame> {
+  const new();
+
+  @override
+  Stream<SseFrame> bind(Stream<String> stream) {
+    final builder = _FrameBuilder();
+    return stream.expand(builder.feed);
+  }
+}
+
+final class _FrameBuilder {
+  final StringBuffer _data = StringBuffer();
+  String? _event;
+  String? _id;
+  int? _retry;
+  bool _first = true;
+
+  static final RegExp _digits = RegExp(r'^\d+$');
+  static final String _bom = String.fromCharCode(0xFEFF);
+  static final String _nul = String.fromCharCode(0);
+
+  Iterable<SseFrame> feed(String rawLine) {
+    var line = rawLine;
+    if (_first) {
+      _first = false;
+      if (line.startsWith(_bom)) line = line.substring(1);
+    }
+    if (line.isEmpty) return _dispatch();
+    if (line.startsWith(':')) return const [];
+    final colon = line.indexOf(':');
+    final field = colon == -1 ? line : line.substring(0, colon);
+    var value = colon == -1 ? '' : line.substring(colon + 1);
+    if (value.startsWith(' ')) value = value.substring(1);
+    switch (field) {
+      case 'data':
+        _data
+          ..write(value)
+          ..write('\n');
+      case 'event':
+        _event = value;
+      case 'id':
+        if (!value.contains(_nul)) _id = value;
+      case 'retry':
+        if (_digits.hasMatch(value)) _retry = int.parse(value);
+    }
+    return const [];
+  }
+
+  Iterable<SseFrame> _dispatch() {
+    if (_data.isEmpty) {
+      _event = null;
+      return const [];
+    }
+    var data = _data.toString();
+    if (data.endsWith('\n')) data = data.substring(0, data.length - 1);
+    final frame = SseFrame(data: data, event: _event, id: _id, retry: _retry);
+    _data.clear();
+    _event = null;
+    _id = null;
+    _retry = null;
+    return [frame];
+  }
+}
diff --git a/packages/stacflow/lib/src/transport/turn_ids.dart b/packages/stacflow/lib/src/transport/turn_ids.dart
new file mode 100644
index 0000000..e7d78d9
--- /dev/null
+++ b/packages/stacflow/lib/src/transport/turn_ids.dart
@@ -0,0 +1,87 @@
+import 'dart:convert';
+import 'dart:math';
+
+/// Mints the `thr_`, `trn_`, `msg_` and `tc_` ids a chat uses. Inject one
+/// with a seeded [Random] for reproducible ids.
+class IdGenerator {
+  new({Random? random}) : _random = random ?? Random.secure();
+
+  static const String _alphabet =
+      'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+
+  final Random _random;
+
+  /// [prefix] followed by 16 base62 characters.
+  String next(String prefix) {
+    final buffer = StringBuffer(prefix);
+    for (var i = 0; i < 16; i++) {
+      buffer.write(_alphabet[_random.nextInt(_alphabet.length)]);
+    }
+    return buffer.toString();
+  }
+
+  /// A fresh thread id.
+  String thread() => next('thr_');
+
+  /// A fresh turn id.
+  String turn() => next('trn_');
+
+  /// A fresh message id.
+  String message() => next('msg_');
+
+  /// A fresh tool-call id, for a call the provider did not name.
+  String toolCall() => next('tc_x');
+}
+
+/// A tool-call id that carries [providerCallId], recoverable through
+/// [providerCallIdOf].
+String toolCallIdFor(String providerCallId) {
+  final buffer = StringBuffer('tc_');
+  for (final byte in utf8.encode(providerCallId)) {
+    buffer.write(byte.toRadixString(16).padLeft(2, '0'));
+  }
+  return buffer.toString();
+}
+
+/// The provider's own call id inside an id from [toolCallIdFor]; null for
+/// ids the SDK minted.
+String? providerCallIdOf(String toolCallId) {
+  if (!toolCallId.startsWith('tc_')) return null;
+  final hex = toolCallId.substring(3);
+  if (hex.isEmpty || hex.length.isOdd || !_hexPattern.hasMatch(hex)) {
+    return null;
+  }
+  final bytes = [
+    for (var i = 0; i < hex.length; i += 2)
+      int.parse(hex.substring(i, i + 2), radix: 16),
+  ];
+  return utf8.decode(bytes, allowMalformed: true);
+}
+
+final RegExp _hexPattern = RegExp(r'^[0-9a-f]+$');
+
+/// The identity of one turn on the wire.
+final class TurnIds {
+  const new({
+    required this.turnId,
+    required this.messageId,
+    required this.threadId,
+  });
+
+  /// Fresh turn and message ids under [threadId].
+  factory generate({required String threadId, IdGenerator? ids}) {
+    final generator = ids ?? IdGenerator();
+    return TurnIds(
+      turnId: generator.turn(),
+      messageId: generator.message(),
+      threadId: threadId,
+    );
+  }
+
+  /// The agent version reported when no agent is deployed anywhere.
+  static const String agentVersionId = 'agv_direct';
+
+  final String turnId;
+  final String messageId;
+  final String threadId;
+}
diff --git a/packages/stacflow/lib/src/transport/turn_request.dart b/packages/stacflow/lib/src/transport/turn_request.dart
new file mode 100644
index 0000000..dbf54f4
--- /dev/null
+++ b/packages/stacflow/lib/src/transport/turn_request.dart
@@ -0,0 +1,115 @@
+import 'dart:typed_data';
+
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+
+/// One turn's input: the conversation as providers see it, the agent
+/// settings, the tools, the ids and the future that cancels it.
+final class TurnRequest {
+  const new({
+    required this.history,
+    required this.agent,
+    required this.ids,
+    required this.abortTrigger,
+    this.tools = const [],
+    this.segment = 0,
+  });
+
+  /// Oldest first, ending with the user turn being answered.
+  final List<WireMessage> history;
+  final AgentConfig agent;
+  final TurnIds ids;
+  final Future<void> abortTrigger;
+
+  /// The tools declared to the model; empty declares none.
+  final List<Tool> tools;
+
+  /// 0 for a turn's first request, one more for each continuation that
+  /// carries tool results.
+  final int segment;
+}
+
+/// Who wrote a wire message.
+enum WireRole { user, assistant }
+
+/// A piece of a wire message.
+sealed class WirePart {
+  const new();
+}
+
+/// Plain text.
+final class WireTextPart extends WirePart {
+  const new(this.text);
+
+  final String text;
+}
+
+/// An inline image.
+final class WireImagePart extends WirePart {
+  const new({required this.bytes, required this.mimeType});
+
+  final Uint8List bytes;
+  final String mimeType;
+}
+
+/// A tool call the model made; only on assistant messages.
+final class WireToolCallPart extends WirePart {
+  const new({required this.id, required this.name, required this.args});
+
+  /// The call as [record] holds it.
+  factory of(ToolCallRecord record) =>
+      WireToolCallPart(id: record.id, name: record.name, args: record.args);
+
+  final String id;
+  final String name;
+  final Map<String, dynamic> args;
+}
+
+/// How a tool call ended, as the model hears it.
+enum WireToolResultStatus { ok, error, declined }
+
+/// A tool's answer; only on user messages, ahead of any other part.
+final class WireToolResultPart extends WirePart {
+  const new({
+    required this.id,
+    required this.name,
+    required this.status,
+    this.result,
+    this.error,
+  });
+
+  /// The outcome [record] holds; a call that never ran reports it was
+  /// cancelled.
+  factory of(ToolCallRecord record) => WireToolResultPart(
+    id: record.id,
+    name: record.name,
+    status: switch (record.status) {
+      ToolCallStatus.ok => WireToolResultStatus.ok,
+      ToolCallStatus.declined => WireToolResultStatus.declined,
+      _ => WireToolResultStatus.error,
+    },
+    result: record.result,
+    error: record.status == ToolCallStatus.ok
+        ? null
+        : record.error?.message ?? ToolCallError.cancelled.message,
+  );
+
+  final String id;
+  final String name;
+  final WireToolResultStatus status;
+
+  /// The JSON value the tool returned, when [status] is ok.
+  final Object? result;
+
+  /// The reason, when [status] is error or declined.
+  final String? error;
+}
+
+/// One message as providers see it.
+final class WireMessage {
+  const new({required this.role, required this.parts});
+
+  final WireRole role;
+  final List<WirePart> parts;
+}
diff --git a/packages/stacflow/lib/src/transport/turn_transport.dart b/packages/stacflow/lib/src/transport/turn_transport.dart
new file mode 100644
index 0000000..d3d9d64
--- /dev/null
+++ b/packages/stacflow/lib/src/transport/turn_transport.dart
@@ -0,0 +1,10 @@
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+/// Where a turn's events come from: a provider today, a gateway later.
+/// A run emits `start` first, exactly one `done` last, with `seq` strictly
+/// increasing from 0.
+abstract interface class TurnTransport {
+  /// Runs one turn and streams its events.
+  Stream<SseEvent> run(TurnRequest request);
+}
diff --git a/packages/stacflow/lib/stacflow.dart b/packages/stacflow/lib/stacflow.dart
new file mode 100644
index 0000000..5b189db
--- /dev/null
+++ b/packages/stacflow/lib/stacflow.dart
@@ -0,0 +1,24 @@
+/// The StacFlow SDK: flow_ui's chat surface wired to Gemini, OpenAI and
+/// Claude with the developer's own key, plus the tools the app lets the
+/// model call.
+library;
+
+export 'package:flow_ui/flow_ui.dart';
+
+export 'src/chat/chat_state.dart';
+export 'src/chat/stacflow_chat.dart';
+export 'src/chat/stacflow_chat_view.dart';
+export 'src/errors.dart';
+export 'src/generated/error_codes.dart';
+export 'src/generated/sse_events.dart';
+export 'src/providers/anthropic_provider.dart' show AnthropicProvider;
+export 'src/providers/gemini_provider.dart' show GeminiProvider;
+export 'src/providers/openai_provider.dart' show OpenAIProvider;
+export 'src/providers/provider.dart';
+export 'src/strings.dart';
+export 'src/tools/tool.dart';
+export 'src/tools/tool_loop.dart'
+    show ToolApprover, ToolCallObserver, runToolLoop;
+export 'src/transport/turn_ids.dart';
+export 'src/transport/turn_request.dart';
+export 'src/transport/turn_transport.dart';
diff --git a/packages/stacflow/pubspec.yaml b/packages/stacflow/pubspec.yaml
new file mode 100644
index 0000000..68d7938
--- /dev/null
+++ b/packages/stacflow/pubspec.yaml
@@ -0,0 +1,24 @@
+name: stacflow
+description: Streaming AI chat for Flutter on flow_ui, talking to Gemini, OpenAI or Claude with your own API key.
+version: 0.0.1
+homepage: https://flowui.stac.dev/
+repository: https://github.com/StacDev/flow_ui/tree/main/packages/stacflow
+issue_tracker: https://github.com/StacDev/flow_ui/issues
+publish_to: none # until the 0.1 release
+
+environment:
+  sdk: ^3.13.0
+  flutter: ">=3.44.0"
+
+resolution: workspace
+
+dependencies:
+  flow_ui: ^0.4.0
+  flutter:
+    sdk: flutter
+  http: ^1.6.0
+  material_ui: ^1.0.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
diff --git a/packages/stacflow/tool/smoke.dart b/packages/stacflow/tool/smoke.dart
new file mode 100644
index 0000000..69772bf
--- /dev/null
+++ b/packages/stacflow/tool/smoke.dart
@@ -0,0 +1,120 @@
+import 'dart:async';
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:stacflow/src/generated/sse_events.dart';
+import 'package:stacflow/src/providers/anthropic_provider.dart';
+import 'package:stacflow/src/providers/gemini_provider.dart';
+import 'package:stacflow/src/providers/openai_provider.dart';
+import 'package:stacflow/src/providers/provider.dart';
+import 'package:stacflow/src/tools/tool.dart';
+import 'package:stacflow/src/tools/tool_loop.dart';
+import 'package:stacflow/src/transport/turn_ids.dart';
+import 'package:stacflow/src/transport/turn_request.dart';
+
+const String _providerName = String.fromEnvironment(
+  'PROVIDER',
+  defaultValue: 'gemini',
+);
+const String _prompt = String.fromEnvironment(
+  'PROMPT',
+  defaultValue: 'Say hello in five words.',
+);
+const String _imagePath = String.fromEnvironment('IMAGE');
+const String _openAiBaseUrl = String.fromEnvironment('OPENAI_BASE_URL');
+const bool _abortAfterFirstDelta = bool.fromEnvironment(
+  'ABORT_AFTER_FIRST_DELTA',
+);
+const bool _tools = bool.fromEnvironment('TOOLS');
+const String _toolPermission = String.fromEnvironment(
+  'TOOL_PERMISSION',
+  defaultValue: 'read',
+);
+const bool _decline = bool.fromEnvironment('DECLINE');
+
+Future<void> main() async {
+  final provider = switch (_providerName) {
+    'gemini' => GeminiProvider(
+      apiKey: const String.fromEnvironment('GEMINI_API_KEY'),
+    ),
+    'anthropic' => AnthropicProvider(
+      apiKey: const String.fromEnvironment('ANTHROPIC_API_KEY'),
+    ),
+    'openai' => OpenAIProvider(
+      apiKey: const String.fromEnvironment('OPENAI_API_KEY'),
+      baseUrl: _openAiBaseUrl.isEmpty
+          ? 'https://api.openai.com/v1'
+          : _openAiBaseUrl,
+    ),
+    _ => throw ArgumentError.value(_providerName, 'PROVIDER'),
+  };
+  final ids = IdGenerator();
+  final abort = Completer<void>();
+  final parts = <WirePart>[
+    if (_imagePath.isNotEmpty)
+      WireImagePart(
+        bytes: File(_imagePath).readAsBytesSync(),
+        mimeType: _imagePath.endsWith('.png') ? 'image/png' : 'image/jpeg',
+      ),
+    const WireTextPart(_prompt),
+  ];
+  final tools = [
+    if (_tools)
+      Tool(
+        name: 'get_time',
+        description: 'The current local date and time.',
+        permission: switch (_toolPermission) {
+          'write' => ToolPermission.write,
+          'destructive' => ToolPermission.destructive,
+          _ => ToolPermission.read,
+        },
+        run: (call) => {'now': DateTime.now().toIso8601String()},
+      ),
+  ];
+  final request = TurnRequest(
+    history: [WireMessage(role: WireRole.user, parts: parts)],
+    agent: const AgentConfig(),
+    ids: TurnIds.generate(threadId: ids.thread(), ids: ids),
+    abortTrigger: abort.future,
+    tools: tools,
+  );
+  stdout.writeln('provider: $provider');
+  final started = DateTime.now();
+  int elapsed() => DateTime.now().difference(started).inMilliseconds;
+  final stream = runToolLoop(
+    transport: provider,
+    request: request,
+    approve: (record) async => !_decline,
+    onCall: (record) => stdout.writeln(
+      '[${elapsed()}ms] tool ${record.id} ${record.name} '
+      '${record.status.name} args=${jsonEncode(record.args)} '
+      'result=${jsonEncode(record.result)} error=${record.error?.message}',
+    ),
+  );
+  try {
+    await for (final event in stream) {
+      stdout.writeln('[${elapsed()}ms] ${_describe(event)}');
+      if (_abortAfterFirstDelta && event is DeltaEvent && !abort.isCompleted) {
+        abort.complete();
+      }
+    }
+  } on ProviderTransportException catch (error) {
+    stdout.writeln('transport failure: $error');
+  }
+}
+
+String _describe(SseEvent event) => switch (event) {
+  StartEvent() => 'start ${jsonEncode(event.toJson())}',
+  DeltaEvent() => 'delta ${jsonEncode(event.text)}',
+  UsageEvent() => 'usage ${jsonEncode(event.toJson())}',
+  ErrorEvent() => 'error ${jsonEncode(event.toJson())}',
+  DoneEvent() => 'done ${jsonEncode(event.toJson())}',
+  ToolCallStartEvent() =>
+    'tool_call start ${event.toolCallId} ${event.toolName} '
+        '${event.permissionClass.wire}',
+  ToolCallDeltaEvent() =>
+    'tool_call delta ${event.toolCallId} ${jsonEncode(event.argsDelta)}',
+  ToolCallEndEvent() =>
+    'tool_call end ${event.toolCallId} ${jsonEncode(event.args)}',
+  SseUnknownEvent() => 'unknown ${event.event}',
+};
diff --git a/playground/README.md b/playground/README.md
index 451c569..f392963 100644
--- a/playground/README.md
+++ b/playground/README.md
@@ -1,6 +1,6 @@
 # Flow UI Playground
 
-The workbench for [flow_ui](../): every component on a stage, with variant
+The workbench for [flow_ui](../packages/flow_ui/): every component on a stage, with variant
 pills and the code that renders them.
 
 ```bash
diff --git a/playground/pubspec.yaml b/playground/pubspec.yaml
index e40256d..299473c 100644
--- a/playground/pubspec.yaml
+++ b/playground/pubspec.yaml
@@ -28,13 +28,14 @@ environment:
 # dependencies can be manually updated by changing the version numbers below to
 # the latest version available on pub.dev. To see which dependencies have newer
 # versions available, run `flutter pub outdated`.
+resolution: workspace
+
 dependencies:
   flutter:
     sdk: flutter
   material_ui: ^1.0.0
   # The component library under demo.
-  flow_ui:
-    path: ../
+  flow_ui: ^0.4.0
   # Renders the logo's SVG asset — app-only.
   flutter_svg: ^2.0.10
   # The icon set the design is drawn in.
diff --git a/playground/pubspec.lock b/pubspec.lock
similarity index 74%
rename from playground/pubspec.lock
rename to pubspec.lock
index 7495aef..95b9e70 100644
--- a/playground/pubspec.lock
+++ b/pubspec.lock
@@ -1,6 +1,14 @@
 # Generated by pub
 # See https://dart.dev/tools/pub/glossary#lockfile
 packages:
+  ansi_styles:
+    dependency: transitive
+    description:
+      name: ansi_styles
+      sha256: "9c656cc12b3c27b17dd982b2cc5c0cfdfbdabd7bc8f3ae5e8542d9867b47ce8a"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.3.2+1"
   args:
     dependency: transitive
     description:
@@ -33,6 +41,38 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.4.1"
+  charcode:
+    dependency: transitive
+    description:
+      name: charcode
+      sha256: fb0f1107cac15a5ea6ef0a6ef71a807b9e4267c713bb93e00e92d737cc8dbd8a
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.4.0"
+  checked_yaml:
+    dependency: transitive
+    description:
+      name: checked_yaml
+      sha256: "959525d3162f249993882720d52b7e0c833978df229be20702b33d48d91de70f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.0.4"
+  cli_launcher:
+    dependency: transitive
+    description:
+      name: cli_launcher
+      sha256: "96883f87648524292e24e2cc6a369fbdf64883473fe3e3ddadd3d857bf16a484"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.3.3+2"
+  cli_util:
+    dependency: transitive
+    description:
+      name: cli_util
+      sha256: "71e43f1976c3eae2d9468a5b4d6600bf8cae61508b87f27fa1799228935d48ab"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.5.2"
   clock:
     dependency: transitive
     description:
@@ -45,10 +85,10 @@ packages:
     dependency: transitive
     description:
       name: code_assets
-      sha256: bf394f466ba9205f1812a0433b392d6af280f155f56651eda7c18cc32ed493b8
+      sha256: cfd4f5f575a49c5f10ca856e9846073f1e6c3ee94912377eea5f6cefc5272941
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.1"
+    version: "2.0.0"
   collection:
     dependency: transitive
     description:
@@ -57,14 +97,22 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.19.1"
+  conventional_commit:
+    dependency: transitive
+    description:
+      name: conventional_commit
+      sha256: c40b1b449ce2a63fa2ce852f35e3890b1e182f5951819934c0e4a66254bc0dc3
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.6.1+1"
   cross_file:
     dependency: transitive
     description:
       name: cross_file
-      sha256: f141ea4f277af142a0356955707f6556f37b03947d39d55585981a06ca437bd6
+      sha256: "92c9c43c383bfa1c32079d3bc492d55d6d4318044b7b47edaff8971cbb555c51"
       url: "https://pub.dev"
     source: hosted
-    version: "0.3.5+5"
+    version: "0.3.5+4"
   crypto:
     dependency: transitive
     description:
@@ -74,7 +122,7 @@ packages:
     source: hosted
     version: "3.0.7"
   cupertino_icons:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: cupertino_icons
       sha256: "41e005c33bd814be4d3096aff55b1908d419fde52ca656c8c47719ec745873cd"
@@ -105,6 +153,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.2.0"
+  file:
+    dependency: transitive
+    description:
+      name: file
+      sha256: a3b4f84adafef897088c160faf7dfffb7696046cb13ae90b508c2cbc95d3b8d4
+      url: "https://pub.dev"
+    source: hosted
+    version: "7.0.1"
   file_selector:
     dependency: transitive
     description:
@@ -169,20 +225,13 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.9.3+5"
-  flow_ui:
-    dependency: "direct main"
-    description:
-      path: ".."
-      relative: true
-    source: path
-    version: "0.2.0"
   flutter:
-    dependency: "direct main"
+    dependency: transitive
     description: flutter
     source: sdk
     version: "0.0.0"
   flutter_lints:
-    dependency: "direct dev"
+    dependency: transitive
     description:
       name: flutter_lints
       sha256: "3105dc8492f6183fb076ccf1f351ac3d60564bff92e20bfc4af9cc1651f4e7e1"
@@ -195,7 +244,7 @@ packages:
     source: sdk
     version: "0.0.0"
   flutter_svg:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: flutter_svg
       sha256: "35882981abcbfb8c15b286f0cd690ff25bac12d95eff3e25ee207f37d4c42e7f"
@@ -203,39 +252,55 @@ packages:
     source: hosted
     version: "2.3.0"
   flutter_test:
-    dependency: "direct dev"
+    dependency: transitive
     description: flutter
     source: sdk
     version: "0.0.0"
   flutter_web_plugins:
-    dependency: "direct main"
+    dependency: transitive
     description: flutter
     source: sdk
     version: "0.0.0"
+  glob:
+    dependency: transitive
+    description:
+      name: glob
+      sha256: "218aeb56050c714f62a3182775320dfa04602b55074873e24e31bbd39bda96fb"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.0"
   go_router:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: go_router
-      sha256: "2e7fcb9ac4d52ec06cd940552f12e66ee71fccbcadb09a067cb9fe20462b5bf3"
+      sha256: "008ab21d89d0de8ccd79586838f7533f126c2d894f50bf25f2947888d3c225b5"
       url: "https://pub.dev"
     source: hosted
-    version: "18.0.0"
+    version: "18.0.1"
   google_fonts:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: google_fonts
       sha256: e3cb3ee6b47fd2472c23de6da5744796a4da195137759ddb3fbcc9467b7b3c7d
       url: "https://pub.dev"
     source: hosted
     version: "8.2.1"
+  graphs:
+    dependency: transitive
+    description:
+      name: graphs
+      sha256: "741bbf84165310a68ff28fe9e727332eef1407342fca52759cb21ad8177bb8d0"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.3.2"
   hooks:
     dependency: transitive
     description:
       name: hooks
-      sha256: "9a62a50b50b769a737bc0a8ff381f333529df3ab746b2f6b02e83760231455ba"
+      sha256: eaac480a35ec0814146c2c48d96aaa829e0e44a7662c88ae84c9edf4bc35651f
       url: "https://pub.dev"
     source: hosted
-    version: "2.0.2"
+    version: "2.2.0"
   http:
     dependency: transitive
     description:
@@ -260,6 +325,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.20.3"
+  io:
+    dependency: transitive
+    description:
+      name: io
+      sha256: "2635216ca6a737e60de577ffa1a48a0bec76ca8a62917cfc1bb88c14c570646f"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.1.0"
   jni:
     dependency: transitive
     description:
@@ -284,6 +357,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.0.0"
+  json_annotation:
+    dependency: transitive
+    description:
+      name: json_annotation
+      sha256: "2a743920d81b7910627f68ee2c9ac1fc0bfee32b9fc3403587d7c6791ca12f80"
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.12.0"
   leak_tracker:
     dependency: transitive
     description:
@@ -341,13 +422,21 @@ packages:
     source: hosted
     version: "0.13.0"
   material_ui:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: material_ui
-      sha256: d9b4f6c69b80bc83d0a14357c86e4c14c8076e807ae73cf2960c8560f623995f
+      sha256: "9c0156b0cf8b3f56d365c8ffe051a720be3cae9eec55119f01e01b986ffb7101"
       url: "https://pub.dev"
     source: hosted
-    version: "1.0.0"
+    version: "1.1.1"
+  melos:
+    dependency: "direct dev"
+    description:
+      name: melos
+      sha256: "5fc1a858e3d90fdc42f2f423b95f901214bbc3d9e80c99125d9352f12453721d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "7.8.2"
   meta:
     dependency: transitive
     description:
@@ -356,22 +445,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.19.0"
+  mustache_template:
+    dependency: transitive
+    description:
+      name: mustache_template
+      sha256: c689b4d59176f8c7a2860aab765d205916aa5b06cfafff7613bfcc42fa996143
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.0.5"
   objective_c:
     dependency: transitive
     description:
       name: objective_c
-      sha256: b7fb95a6d9a4f009edd63dc5ac69f07420b23a16161c6dd8660290b59c602e8e
+      sha256: ad56fd53a78ff6b1472fa59ff2a4e8b8ccabafc586fc263a1dfad0b99b5553e3
       url: "https://pub.dev"
     source: hosted
-    version: "9.5.0"
+    version: "9.6.0"
   package_config:
     dependency: transitive
     description:
       name: package_config
-      sha256: ffcf4cf3d6c0b74ac43708d9f56625506e8a68aa935abe9d267a7330f320eb5d
+      sha256: f096c55ebb7deb7e384101542bfba8c52696c1b56fca2eb62827989ef2353bbc
       url: "https://pub.dev"
     source: hosted
-    version: "3.0.0"
+    version: "2.2.0"
   path:
     dependency: transitive
     description:
@@ -445,7 +542,7 @@ packages:
     source: hosted
     version: "7.0.2"
   phosphoricons_flutter:
-    dependency: "direct main"
+    dependency: transitive
     description:
       name: phosphoricons_flutter
       sha256: "34e4a00cc1a4be87c60edfcfcd5de23c005dc69945a5d77e08d33e6d23c0e793"
@@ -468,6 +565,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.1.8"
+  pool:
+    dependency: transitive
+    description:
+      name: pool
+      sha256: "4177f68c237ea2128d1bee66ac17b2ce05ba3dbaafcbdd54c5d40a39d0b6b11c"
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.5.3"
+  process:
+    dependency: transitive
+    description:
+      name: process
+      sha256: "4242ba3508d37e01808bdf71ad1d5bb93a8d671bf2e7450e6b1b353fb0808891"
+      url: "https://pub.dev"
+    source: hosted
+    version: "5.0.6"
+  prompts:
+    dependency: transitive
+    description:
+      name: prompts
+      sha256: "3773b845e85a849f01e793c4fc18a45d52d7783b4cb6c0569fad19f9d0a774a1"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.0.0"
   pub_semver:
     dependency: transitive
     description:
@@ -476,14 +597,30 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.2.0"
+  pub_updater:
+    dependency: transitive
+    description:
+      name: pub_updater
+      sha256: "739a0161d73a6974c0675b864fb0cf5147305f7b077b7f03a58fa7a9ab3e7e7d"
+      url: "https://pub.dev"
+    source: hosted
+    version: "0.5.0"
+  pubspec_parse:
+    dependency: transitive
+    description:
+      name: pubspec_parse
+      sha256: c38b81cbf34450b67e0265d73433569d12e34782e30ed769c9cc99c9d5f2e796
+      url: "https://pub.dev"
+    source: hosted
+    version: "1.6.0"
   record_use:
     dependency: transitive
     description:
       name: record_use
-      sha256: "2551bd8eecfe95d14ae75f6021ad0248be5c27f138c2ec12fcb52b500b3ba1ed"
+      sha256: "1cb8564af8d43b464294411db9217f5ec04891c6f22ee2c32d73ae05e88a6bd2"
       url: "https://pub.dev"
     source: hosted
-    version: "0.6.0"
+    version: "1.1.1"
   sky_engine:
     dependency: transitive
     description: flutter
@@ -577,6 +714,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "2.4.2"
+  very_good_analysis:
+    dependency: "direct dev"
+    description:
+      name: very_good_analysis
+      sha256: "0bd5eb8d6be76aa0d71e70cbdae6cac8f784f761170568e3c2214a6948c7f6d3"
+      url: "https://pub.dev"
+    source: hosted
+    version: "11.0.0"
   vm_service:
     dependency: transitive
     description:
@@ -617,6 +762,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "3.1.3"
+  yaml_edit:
+    dependency: transitive
+    description:
+      name: yaml_edit
+      sha256: "07c9e63ba42519745182b88ca12264a7ba2484d8239958778dfe4d44fe760488"
+      url: "https://pub.dev"
+    source: hosted
+    version: "2.2.4"
 sdks:
-  dart: ">=3.12.2 <4.0.0"
+  dart: ">=3.13.0 <4.0.0"
   flutter: ">=3.44.0"
diff --git a/pubspec.yaml b/pubspec.yaml
index e7e5e66..5268b59 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,40 +1,36 @@
-name: flow_ui
-description: Flow UI is an open-source Flutter UI library to build production-grade Chat & AI assistant interfaces.
-version: 0.3.0
-homepage: https://flowui.stac.dev/
-repository: https://github.com/StacDev/flow_ui
-issue_tracker: https://github.com/StacDev/flow_ui/issues
-documentation: https://flowui.stac.dev/
-topics:
-  - ai
-  - chat
-  - chatbot
-  - assistant
-  - ui
+name: flow_ui_workspace
+description: Pub workspace for flow_ui and the StacFlow SDK packages built on it. Not published.
+publish_to: none
 
 environment:
-  sdk: ^3.12.2
+  sdk: ^3.13.0
   flutter: ">=3.44.0"
 
-dependencies:
-  flutter:
-    sdk: flutter
-  # Google Sans and Google Sans Code, fetched from Google Fonts at runtime —
-  # the one dependency outside flutter.dev's packages; no font files ship.
-  google_fonts: ^8.2.1
-  material_ui: ^1.0.0
-  # The composer's built-in attach button opens this. flutter.dev-published
-  # and endorsed on all six platforms, and — unlike image_picker — it adds
-  # no permission, no FileProvider and no Play-services entry to a host's
-  # Android manifest, and no Info.plist strings to a host's iOS build. The
-  # one thing a host must do is a macOS entitlement
-  # (com.apple.security.files.user-selected.read-only); without it the
-  # dialog opens onto nothing. Hosts that never wire an attach callback
-  # ship this and configure nothing.
-  file_selector: ^1.1.0
+workspace:
+  - packages/flow_ui
+  - packages/flow_ui/example
+  - packages/stacflow
+  - packages/stacflow/example
+  - playground
 
 dev_dependencies:
-  flutter_test:
-    sdk: flutter
-  flutter_lints: ^6.0.0
+  melos: ^7.7.0
+  very_good_analysis: ^11.0.0
 
+melos:
+  scripts:
+    analyze:
+      description: dart analyze --fatal-infos in every member, with the nearest analysis_options.yaml
+      run: dart run melos exec -- dart analyze --fatal-infos .
+    format:
+      description: Format every member in place
+      run: dart run melos exec -- dart format .
+    format:check:
+      description: Fails on unformatted files
+      run: dart format --output=none --set-exit-if-changed .
+    test:
+      description: Tests in every member that has a test/ directory
+      run: dart run melos exec --dir-exists=test -- flutter test
+    publish:dry-run:
+      description: Packaging smoke for every publishable member
+      run: dart run melos exec --no-private -- flutter pub publish --dry-run
diff --git a/tool/README.md b/tool/README.md
new file mode 100644
index 0000000..c497b0a
--- /dev/null
+++ b/tool/README.md
@@ -0,0 +1,7 @@
+# tool/
+
+Workspace tooling. Run everything from the repo root.
+
+| Script | What it does |
+|---|---|
+| `contracts_gen.dart` | Generates `packages/stacflow/lib/src/generated/` from `contracts/`. `dart run tool/contracts_gen.dart`, then `dart format packages/stacflow/lib/src/generated`. Deterministic; CI regenerates and fails on drift. |
diff --git a/tool/contracts_gen.dart b/tool/contracts_gen.dart
new file mode 100644
index 0000000..04d0e32
--- /dev/null
+++ b/tool/contracts_gen.dart
@@ -0,0 +1,594 @@
+// Generates Dart types in packages/stacflow/lib/src/generated/ from the
+// contracts/ tree (dev-plan D2). Deterministic: same inputs, byte-identical
+// output. CI regenerates and fails on drift. Never edit the generated files.
+//
+// Run from the workspace root:  dart run tool/contracts_gen.dart
+import 'dart:convert';
+import 'dart:io';
+
+const _outDir = 'packages/stacflow/lib/src/generated';
+
+const _header = '''
+// GENERATED CODE - DO NOT EDIT.
+// Source: contracts/ - regenerate with `dart run tool/contracts_gen.dart`.
+// coverage:ignore-file
+''';
+
+// JSON-Schema primitives ($defs / components) that map straight to Dart types.
+const _primRefs = <String, String>{
+  'Seq': 'int',
+  'TurnId': 'String',
+  'ThreadId': 'String',
+  'MessageId': 'String',
+  'ToolCallId': 'String',
+  'AgentVersionId': 'String',
+  'ManifestHash': 'String',
+};
+
+Map<String, dynamic> _asMap(Object? o) =>
+    (o! as Map).map((k, v) => MapEntry(k as String, v));
+
+String _pascal(String s) => s
+    .split(RegExp(r'[_\-]'))
+    .where((p) => p.isNotEmpty)
+    .map((p) => p[0].toUpperCase() + p.substring(1))
+    .join();
+
+String _camel(String s) {
+  final p = _pascal(s);
+  return p[0].toLowerCase() + p.substring(1);
+}
+
+String _refName(String ref) => ref.split('/').last;
+
+/// Collects enums discovered while walking schemas so they emit once.
+class EnumReg {
+  final Map<String, List<String>> enums = {}; // name -> wire values
+  String register(String name, List<String> values) {
+    final existing = enums[name];
+    if (existing != null && existing.join(',') != values.join(',')) {
+      throw StateError('enum name collision: $name');
+    }
+    enums[name] = values;
+    return name;
+  }
+
+  String emit() {
+    final b = StringBuffer();
+    for (final e in enums.entries) {
+      b.writeln('enum ${e.key} {');
+      for (final v in e.value) {
+        b.writeln("  ${_camel(v)}('$v'),");
+      }
+      b.writeln(';\n');
+      b.writeln('  const ${e.key}(this.wire);');
+      b.writeln('  final String wire;');
+      b.writeln('  static ${e.key} fromWire(String wire) =>');
+      b.writeln('      values.firstWhere((v) => v.wire == wire);');
+      b.writeln('}\n');
+    }
+    return b.toString();
+  }
+}
+
+/// One field of a generated class.
+class Field {
+  Field(this.wire, this.type, {required this.required, this.kind = 'plain'});
+  final String wire; // wire key
+  final String type; // dart type WITHOUT nullability suffix
+  final bool required;
+  final String kind; // plain | enumT | classT | jsonMap | list:<inner-kind>
+  String get name => _camel(wire);
+  String get dartType => required ? type : '$type?';
+}
+
+class ClassSpec {
+  ClassSpec(
+    this.name,
+    this.fields, {
+    this.extendsName,
+    this.consts = const {},
+    this.doc,
+  });
+  final String name;
+  final List<Field> fields;
+  final String? extendsName;
+  final Map<String, String> consts; // wire key -> const value (discriminators)
+  final String? doc;
+}
+
+String _emitClass(ClassSpec c) {
+  final b = StringBuffer();
+  if (c.doc != null) b.writeln('/// ${c.doc}');
+  final ext = c.extendsName != null ? ' extends ${c.extendsName}' : '';
+  b.writeln('final class ${c.name}$ext {');
+  // ctor
+  b.writeln('  const ${c.name}({');
+  for (final f in c.fields) {
+    b.writeln(
+      f.required ? '    required this.${f.name},' : '    this.${f.name},',
+    );
+  }
+  b.writeln('  });\n');
+  // fromJson
+  b.writeln(
+    '  factory ${c.name}.fromJson(Map<String, dynamic> json) => ${c.name}(',
+  );
+  for (final f in c.fields) {
+    b.writeln('        ${f.name}: ${_decodeExpr(f)},');
+  }
+  b.writeln('      );\n');
+  // fields
+  for (final f in c.fields) {
+    b.writeln('  final ${f.dartType} ${f.name};');
+  }
+  for (final e in c.consts.entries) {
+    // Values are stored as Dart literals ("'text'" or "1").
+    final type = e.value.startsWith("'") ? 'String' : 'int';
+    b.writeln('  $type get ${_camel(e.key)} => ${e.value};');
+  }
+  b.writeln();
+  // toJson
+  b.writeln('  Map<String, dynamic> toJson() => <String, dynamic>{');
+  for (final e in c.consts.entries) {
+    b.writeln("        '${e.key}': ${e.value},");
+  }
+  for (final f in c.fields.where((f) => f.required)) {
+    b.writeln("        '${f.wire}': ${_encodeExpr(f)},");
+  }
+  b.writeln('      }');
+  for (final f in c.fields.where((f) => !f.required)) {
+    b.writeln('    ..addAll(${f.name} == null');
+    b.writeln('        ? const <String, dynamic>{}');
+    b.writeln("        : <String, dynamic>{'${f.wire}': ${_encodeExpr(f)}})");
+  }
+  b.writeln('      ;');
+  b.writeln('}\n');
+  return b.toString();
+}
+
+String _decodeExpr(Field f) {
+  final j = "json['${f.wire}']";
+  switch (f.kind) {
+    case 'enumT':
+      return f.required
+          ? '${f.type}.fromWire($j as String)'
+          : '$j == null ? null : ${f.type}.fromWire($j as String)';
+    case 'classT':
+      return f.required
+          ? '${f.type}.fromJson(($j as Map).cast<String, dynamic>())'
+          : '$j == null ? null : ${f.type}.fromJson(($j as Map).cast<String, dynamic>())';
+    case 'jsonMap':
+      return f.required
+          ? '($j as Map).cast<String, dynamic>()'
+          : '($j as Map?)?.cast<String, dynamic>()';
+    // NOTE: .cast() views are LAZY - a wrong element type would escape
+    // SseEvent.decode's try/catch and throw on first read, breaking the
+    // never-throw guarantee. .from() copies and checks eagerly.
+    case 'mapInt':
+      return f.required
+          ? 'Map<String, int>.from($j as Map)'
+          : '$j == null ? null : Map<String, int>.from($j as Map)';
+    case 'listString':
+      return f.required
+          ? 'List<String>.from($j as List)'
+          : '$j == null ? null : List<String>.from($j as List)';
+    case 'listJsonMap':
+      return f.required
+          ? '($j as List).map((e) => (e as Map).cast<String, dynamic>()).toList()'
+          : '($j as List?)?.map((e) => (e as Map).cast<String, dynamic>()).toList()';
+    default:
+      if (f.kind.startsWith('listClass:')) {
+        final inner = f.kind.substring(10);
+        final expr =
+            '($j as List).map((e) => $inner.fromJson((e as Map).cast<String, dynamic>())).toList()';
+        return f.required ? expr : '$j == null ? null : $expr';
+      }
+      if (f.kind.startsWith('mapClass:')) {
+        final v = f.kind.substring(9);
+        final expr =
+            '($j as Map).map((k, v) => MapEntry(k as String, $v.fromJson((v as Map).cast<String, dynamic>())))';
+        return f.required ? expr : '$j == null ? null : $expr';
+      }
+      return f.required ? '$j as ${f.type}' : '$j as ${f.type}?';
+  }
+}
+
+String _encodeExpr(Field f) {
+  final n = f.name;
+  final bang = f.required ? '' : '!';
+  switch (f.kind) {
+    case 'enumT':
+      return '$n$bang.wire';
+    case 'classT':
+      return '$n$bang.toJson()';
+    default:
+      if (f.kind.startsWith('listClass:')) {
+        return '$n$bang.map((e) => e.toJson()).toList()';
+      }
+      if (f.kind.startsWith('mapClass:')) {
+        return '$n$bang.map((k, v) => MapEntry(k, v.toJson()))';
+      }
+      return n;
+  }
+}
+
+/// Resolves a schema node into a [Field]. Registers inline enums under
+/// `owner` + field name; resolves $refs against prims, enums, or classes.
+Field _fieldFor(
+  String owner,
+  String wire,
+  Map<String, dynamic> schema, {
+  required bool required,
+  required EnumReg enums,
+  required Set<String> classNames,
+  required void Function(String name, Map<String, dynamic> schema) onAnon,
+}) {
+  final ref = schema[r'$ref'] as String?;
+  if (ref != null) {
+    final name = _refName(ref);
+    final prim = _primRefs[name];
+    if (prim != null) return Field(wire, prim, required: required);
+    if (name == 'FailureClass') {
+      return Field(wire, 'FailureClass', required: required, kind: 'enumT');
+    }
+    return Field(wire, name, required: required, kind: 'classT');
+  }
+  final enumVals = schema['enum'] as List?;
+  if (enumVals != null) {
+    final name = enums.register(owner + _pascal(wire), enumVals.cast<String>());
+    return Field(wire, name, required: required, kind: 'enumT');
+  }
+  var type = schema['type'];
+  var nullable = false;
+  if (type is List) {
+    nullable = type.contains('null');
+    type = type.firstWhere((t) => t != 'null');
+  }
+  final isRequired = required && !nullable;
+  switch (type) {
+    case 'string':
+      return Field(wire, 'String', required: isRequired);
+    case 'integer':
+      return Field(wire, 'int', required: isRequired);
+    case 'number':
+      return Field(wire, 'double', required: isRequired);
+    case 'boolean':
+      return Field(wire, 'bool', required: isRequired);
+    case 'array':
+      final items = _asMap(schema['items'] ?? <String, dynamic>{});
+      final itemRef = items[r'$ref'] as String?;
+      if (itemRef != null) {
+        final n = _refName(itemRef);
+        final prim = _primRefs[n];
+        if (prim == 'String') {
+          return Field(
+            wire,
+            'List<String>',
+            required: isRequired,
+            kind: 'listString',
+          );
+        }
+        return Field(
+          wire,
+          'List<$n>',
+          required: isRequired,
+          kind: 'listClass:$n',
+        );
+      }
+      if (items['type'] == 'string') {
+        return Field(
+          wire,
+          'List<String>',
+          required: isRequired,
+          kind: 'listString',
+        );
+      }
+      return Field(
+        wire,
+        'List<Map<String, dynamic>>',
+        required: isRequired,
+        kind: 'listJsonMap',
+      );
+    case 'object':
+    default:
+      final props = schema['properties'];
+      if (props != null) {
+        final anonName = owner + _pascal(wire);
+        onAnon(anonName, schema);
+        return Field(wire, anonName, required: isRequired, kind: 'classT');
+      }
+      final addl = schema['additionalProperties'];
+      if (addl is Map) {
+        final a = _asMap(addl);
+        if (a['type'] == 'integer') {
+          return Field(
+            wire,
+            'Map<String, int>',
+            required: isRequired,
+            kind: 'mapInt',
+          );
+        }
+        if (a['properties'] != null) {
+          final anonName = '$owner${_pascal(wire)}Value';
+          onAnon(anonName, a);
+          return Field(
+            wire,
+            'Map<String, $anonName>',
+            required: isRequired,
+            kind: 'mapClass:$anonName',
+          );
+        }
+      }
+      return Field(
+        wire,
+        'Map<String, dynamic>',
+        required: isRequired,
+        kind: 'jsonMap',
+      );
+  }
+}
+
+ClassSpec _classFromObjectSchema(
+  String name,
+  Map<String, dynamic> schema, {
+  required EnumReg enums,
+  required Set<String> classNames,
+  required List<ClassSpec> sink,
+  String? extendsName,
+}) {
+  final props = _asMap(schema['properties'] ?? <String, dynamic>{});
+  final required = ((schema['required'] as List?) ?? const <dynamic>[])
+      .cast<String>()
+      .toSet();
+  final fields = <Field>[];
+  final consts = <String, String>{};
+  props.forEach((wire, raw) {
+    final p = _asMap(raw);
+    final constVal = p['const'];
+    if (constVal is String) {
+      consts[wire] = "'$constVal'";
+      return;
+    }
+    if (constVal is int) {
+      consts[wire] = '$constVal';
+      return;
+    }
+    fields.add(
+      _fieldFor(
+        name,
+        wire,
+        p,
+        required: required.contains(wire),
+        enums: enums,
+        classNames: classNames,
+        onAnon: (n, s) {
+          if (classNames.add(n)) {
+            sink.add(
+              _classFromObjectSchema(
+                n,
+                s,
+                enums: enums,
+                classNames: classNames,
+                sink: sink,
+              ),
+            );
+          }
+        },
+      ),
+    );
+  });
+  return ClassSpec(
+    name,
+    fields,
+    extendsName: extendsName,
+    consts: consts,
+    doc: null,
+  );
+}
+
+// ───────────────────────── sse_events.dart ─────────────────────────
+
+String _genSse(Map<String, dynamic> doc) {
+  final defs = _asMap(doc[r'$defs']);
+  final events = _asMap(
+    _asMap(doc['x-stacflow-protocol'])['events'],
+  ); // name -> $ref
+  final enums = EnumReg()
+    ..register(
+      'FailureClass',
+      (_asMap(defs['FailureClass'])['enum'] as List).cast<String>(),
+    );
+  final classNames = <String>{};
+  final sink = <ClassSpec>[];
+
+  // Upstream (shared attribution object).
+  sink.add(
+    _classFromObjectSchema(
+      'Upstream',
+      _asMap(defs['Upstream']),
+      enums: enums,
+      classNames: classNames,
+      sink: sink,
+    ),
+  );
+
+  final decodeCases = <String, String>{}; // event name -> expression
+  final classes = <ClassSpec>[];
+  final toolCallVariants = <String, String>{}; // phase -> class name
+
+  events.forEach((eventName, refRaw) {
+    final defName = _refName(refRaw as String);
+    final def = _asMap(defs[defName]);
+    final oneOf = def['oneOf'] as List?;
+    if (oneOf != null) {
+      for (final vRaw in oneOf) {
+        final v = _asMap(vRaw);
+        final phase =
+            _asMap(_asMap(v['properties'])['phase'])['const'] as String;
+        final vName = 'ToolCall${_pascal(phase)}Event';
+        toolCallVariants[phase] = vName;
+        classes.add(
+          _classFromObjectSchema(
+            vName,
+            v,
+            enums: enums,
+            classNames: classNames,
+            sink: sink,
+            extendsName: 'ToolCallEvent',
+          ),
+        );
+      }
+      decodeCases[eventName] = 'ToolCallEvent.fromJson(data)';
+    } else {
+      classes.add(
+        _classFromObjectSchema(
+          defName,
+          def,
+          enums: enums,
+          classNames: classNames,
+          sink: sink,
+          extendsName: 'SseEvent',
+        ),
+      );
+      decodeCases[eventName] = '$defName.fromJson(data)';
+    }
+  });
+
+  final b = StringBuffer()
+    ..writeln(_header)
+    ..writeln(
+      '/// The StacFlow SSE protocol v1 (contracts/sse-events.schema.json).',
+    )
+    ..writeln('///')
+    ..writeln(
+      '/// `SseEvent.decode` NEVER throws: unknown event names and payloads that',
+    )
+    ..writeln(
+      '/// fail to decode become [SseUnknownEvent] - the additive-evolution',
+    )
+    ..writeln(
+      '/// compatibility mechanism. Local-mode provider adapters emit this same',
+    )
+    ..writeln('/// union, so cloud and local modes share one event grammar.')
+    ..writeln('library;\n')
+    ..writeln('sealed class SseEvent {')
+    ..writeln('  const SseEvent();')
+    ..writeln('  int get seq;\n')
+    ..writeln('  /// Decodes one SSE frame. Never throws.')
+    ..writeln(
+      '  static SseEvent decode(String event, Map<String, dynamic> data) {',
+    )
+    ..writeln('    try {')
+    ..writeln('      return switch (event) {');
+  decodeCases.forEach((name, expr) {
+    b.writeln("        '$name' => $expr,");
+  });
+  b
+    ..writeln('        _ => SseUnknownEvent(event, data),')
+    ..writeln('      };')
+    ..writeln('    } on Object {')
+    ..writeln('      return SseUnknownEvent(event, data);')
+    ..writeln('    }')
+    ..writeln('  }')
+    ..writeln('}\n')
+    ..writeln(
+      '/// Passthrough for event names or shapes this build does not know.',
+    )
+    ..writeln('final class SseUnknownEvent extends SseEvent {')
+    ..writeln('  const SseUnknownEvent(this.event, this.data);')
+    ..writeln('  final String event;')
+    ..writeln('  final Map<String, dynamic> data;')
+    ..writeln('  @override')
+    ..writeln("  int get seq => data['seq'] is int ? data['seq'] as int : -1;")
+    ..writeln('}\n')
+    ..writeln('sealed class ToolCallEvent extends SseEvent {')
+    ..writeln('  const ToolCallEvent();')
+    ..writeln('  String get toolCallId;\n')
+    ..writeln('  factory ToolCallEvent.fromJson(Map<String, dynamic> json) =>')
+    ..writeln("      switch (json['phase'] as String) {");
+  toolCallVariants.forEach((phase, cls) {
+    b.writeln("        '$phase' => $cls.fromJson(json),");
+  });
+  b
+    ..writeln(
+      "        final other => throw FormatException('unknown phase: \$other'),",
+    )
+    ..writeln('      };')
+    ..writeln('}\n')
+    ..writeln(enums.emit());
+  for (final c in [...sink, ...classes]) {
+    // Event classes need @override on seq / toolCallId getters via fields:
+    b.writeln(_emitClass(_overrideMarkers(c)));
+  }
+  return b.toString();
+}
+
+/// Adds `@override`-safe naming: seq and toolCallId are declared as getters on
+/// the sealed parents; fields satisfy them automatically in Dart, so nothing
+/// to rewrite - kept as a seam for future adjustments.
+ClassSpec _overrideMarkers(ClassSpec c) => c;
+
+// ───────────────────────── error_codes.dart ─────────────────────────
+
+String _genErrorCodes(Map<String, dynamic> doc) {
+  final codes = _asMap(doc['codes']);
+  final b = StringBuffer()
+    ..writeln(_header)
+    ..writeln("import 'sse_events.dart';\n")
+    ..writeln(
+      '/// One entry of the error-code registry (contracts/error-codes.json).',
+    )
+    ..writeln('final class ErrorCodeInfo {')
+    ..writeln('  const ErrorCodeInfo({')
+    ..writeln('    required this.failureClass,')
+    ..writeln('    required this.http,')
+    ..writeln('    required this.retryable,')
+    ..writeln('    required this.description,')
+    ..writeln('  });')
+    ..writeln('  final FailureClass failureClass;')
+    ..writeln('  final int http;')
+    ..writeln('  final bool retryable;')
+    ..writeln('  final String description;')
+    ..writeln('}\n')
+    ..writeln('/// The frozen, additively growing error-code registry.')
+    ..writeln('abstract final class ErrorCodes {');
+  codes.forEach((code, _) {
+    b.writeln("  static const String ${_camel(code)} = '$code';");
+  });
+  b
+    ..writeln()
+    ..writeln('  static const Map<String, ErrorCodeInfo> registry = {');
+  codes.forEach((code, raw) {
+    final c = _asMap(raw);
+    final fc = _camel(c['failure_class'] as String);
+    final desc = (c['description'] as String).replaceAll("'", r"\'");
+    b
+      ..writeln("    '$code': ErrorCodeInfo(")
+      ..writeln('      failureClass: FailureClass.$fc,')
+      ..writeln("      http: ${c['http']},")
+      ..writeln("      retryable: ${c['retryable']},")
+      ..writeln("      description: '$desc',")
+      ..writeln('    ),');
+  });
+  b
+    ..writeln('  };')
+    ..writeln('}');
+  return b.toString();
+}
+
+// ───────────────────────── main ─────────────────────────
+
+void main() {
+  final sse = jsonDecode(
+    File('contracts/sse-events.schema.json').readAsStringSync(),
+  ) as Map<String, dynamic>;
+  final errors = jsonDecode(
+    File('contracts/error-codes.json').readAsStringSync(),
+  ) as Map<String, dynamic>;
+
+  Directory(_outDir).createSync(recursive: true);
+  File('$_outDir/sse_events.dart').writeAsStringSync(_genSse(sse));
+  File('$_outDir/error_codes.dart').writeAsStringSync(_genErrorCodes(errors));
+  stdout.writeln('generated 2 files into $_outDir');
+}