Pricing

from $0.01 / 1,000 results

PRD to Flutter APK

Turn a JSON product spec into a compiling Flutter app: widget tree, Riverpod state, static analysis with an automatic repair loop, then a packaged Android APK. Generating and reading the source is free — you only pay for the packaged APK. Open source, MIT.

Pricing

from $0.01 / 1,000 results

Rating

0.0

(0)

Developer

Andres Gomez

Actor stats

Bookmarked

Total users

Monthly active users

6 days ago

Last modified

Apk Scraper

thenetaji/apk-downloader

📱 Find and extract direct download links for APK files from websites. Also discovers other downloadable content like videos, images, and audio files. Perfect for gathering Android apps and media files from various sources.

The Netaji

104

5.0

F-Droid App Catalog Scraper

datamule/f-droid-scraper

Scrape structured metadata for open-source Android apps from F-Droid — package, name, license, categories, author, source/website/issue links, version, anti-features, icon and APK URL. Query by keyword, package ID, or category. Pay per app.

Datamule

Pub.dev Scraper | Dart and Flutter Packages

parseforge/pub-dev-scraper

Pull Dart and Flutter package data from pub.dev including name, version, publisher, pub points, popularity, likes, platforms, dependencies, and license. Track the Flutter ecosystem, audit deps, and build developer tooling for mobile, web, and desktop Dart projects.

ParseForge

Pub.dev Package Scraper — Dart & Flutter Package Metadata

klondikeking/pub-dev-scraper

Extract metadata, scores, dependencies, and publisher details for Dart and Flutter packages from the public Pub.dev API.

Pierrick McD0nald

pub.dev Flutter & Dart Package Vendor Leads Scraper

gocreative.ai/pubdev-flutter-vendor-leads

Scrapes pub.dev for Flutter and Dart package publishers. Returns company domains, homepages, repositories, SDK constraints, and pub.dev listing URLs. Ideal for targeting mobile dev agencies, SDK vendors, and Flutter ecosystem companies.

GoCreative AI

Built-Hidden Asset Finder

z3n_m4nt1s/built-hidden-asset-finder

Compare a file manifest or packaged project tree against its docs to surface built-but-undocumented scripts, pages, configs, and modules.

theCR8Fconclave SYST3MS

a

tan_asp/danish-grocery-scraper

jens

F-Droid Open Source Android Apps Scraper

parseforge/fdroid-apps-scraper

Browse free and open source Android apps published on F-Droid. Each app returns the name, summary, license, categories, author, website, source code link, added date, last updated date, and an icon. Useful for tracking open source apps, auditing licenses, and studying the mobile ecosystem.

ParseForge

Tencent App Store Scraper

unfenced-group/tencent-app-store-scraper

Scrape app listings from the Tencent App Store (应用宝 / sj.qq.com): name, developer, category, rating, download count, version, APK size, permissions, ICP filing, screenshots, editorial description and iOS cross-platform link. Browse rankings or fetch by package name. No API key required.

Unfenced Group

RDW Netherlands Vehicle Data Scraper

rainminer/rdw-nl-scraper

Scrape Dutch RDW open vehicle registry records for plate lookups and fleet research. Export kenteken, make, model, vehicle type, APK expiry, and seating to JSON or CSV for automotive data pipelines.

rainminer

.actorignore

# What `apify push` must not upload.
#
# The CLI already excludes anything matched by .gitignore, so the secrets below
# are covered twice over. They are repeated here deliberately: the cost of the
# duplication is a few lines, and the cost of relying on one mechanism is
# uploading a funded wallet's private key to a third party because someone
# reorganised .gitignore. Belt and braces is the right trade at that ratio.
.env
.env.*
.x402-*.json

# Everything the Actor image does not build from. Dockerfile.actor copies
# pyproject.toml, poetry.lock, README.md and src/ — nothing else is needed at
# build time, and a smaller upload is a faster push.
tests/
evals/
docs/
scripts/
deploy/
emulator/
generated_apps/
examples/generated-field-notes/
.github/
.pytest_cache/
__pycache__/
*.pyc

# The service's own image and compose stack. The Actor builds from
# Dockerfile.actor and has no use for either.
Dockerfile
docker-compose.yml

.dockerignore

# Generated apps are gigabytes of Gradle output and belong to a build, not the
# image. Sending them would also ship whatever a previous buyer's PRD produced.
generated_apps/
emulator/

# Keys. These hold funded private keys — the testnet payer, and any mainnet
# payer file created for a live purchase. Gitignored, and they must not reach an
# image either. Globbed so a new key file is excluded on creation.
.env
.env.deploy
.x402-*.json

.git/
.github/
.pytest_cache/
**/__pycache__/
*.pyc

# The image runs the service. Tests, evals and the verification scripts need a
# browser, an emulator and a JDK 21, none of which belong in a production image.
tests/
evals/
scripts/
docs/

.gitattributes

# Shell scripts must keep LF endings even on a Windows checkout. Git's autocrlf
# rewrites them to CRLF, `git archive` ships exactly what is in the working tree,
# and `#!/bin/sh` with a trailing carriage return fails on Linux as
# `set: Illegal option -` — an error that names neither the file nor the reason.
# This deployment ships from a Windows machine to a Linux box every time.
*.sh text eol=lf

# Same reasoning: these are read by tools inside the Linux container.
Dockerfile text eol=lf
*.yml text eol=lf
Caddyfile text eol=lf

.gitignore

__pycache__/
*.py[cod]
.venv/
.pytest_cache/
.env

# Deployment configuration: holds the Anthropic key and the receiving address.
.env.deploy

# Agent output — build artifacts, not source
generated_apps/

# Payer private keys. The testnet one is throwaway and must never be reused on
# mainnet; a mainnet payer file holds a key with real money behind it. The glob
# covers both, so a new key file is ignored the moment it is created rather than
# when someone remembers to add it.
.x402-*.json

# Runtime logs from the emulator suite, not part of its config.
emulator/*-debug.log

claude.md

1# App-Generation Microservice (Agentic Build System)
2
3You are the Supervisor Agent for a Machine-to-Machine (M2M) microservice. Your primary directive is to orchestrate a LangGraph/Deep Agents loop that takes a JSON Product Requirements Document (PRD) and outputs a fully compiled Flutter mobile application.
4
5Speed matters for M2M buyers, but zero-error compilation is non-negotiable: if the generated code fails the CI/CD pipeline, the agentic loop has failed.
6
7## 1. Core Architecture (The Loop)
8
9Do not build monolithic code. Use a progressive-disclosure multi-agent pattern to prevent hallucination cascades — delegate strictly across these boundaries:
10
111. **Planning Subagent** — drafts `DESIGN.md` and sets up `pubspec.yaml`.
122. **GenUI Subagent** — writes the Flutter widget tree using the GenUI SDK only. No business logic.
133. **Logic Subagent** — injects Firebase logic and state (Riverpod) into the UI callbacks.
144. **QA/Compiler Subagent** — analyzes the Dart codebase via the MCP server and hot-reloads.
15
16## 2. Execution Commands
17
18Do not guess how to run this project. Use these exact commands when testing or executing loops:
19
20| Step | Command |
21|---|---|
22| Start the orchestrator | `poetry run python src/supervisor.py` |
23| Run local Dart MCP server | `mcp_dart start --workspace ./generated_apps` |
24| Trigger QA static analysis | `flutter analyze` (run inside the build dir) |
25| Run the eval sweep | `poetry run python evals/run.py --analyzer dart --flutter-root "C:\flutter"` |
26| Run build pipeline | `poetry run python src/supervisor.py <prd> --execute --analyzer dart --flutter-root "C:lutter"` |
27
28The Flutter SDK lives at `C:\flutter` (3.44.8 / Dart 3.12.2) and is deliberately
29**not** on PATH — pass `--flutter-root` or set `$FLUTTER_ROOT`. `flutter analyze`
30is used rather than `dart analyze` because it runs `pub get` first; without a
31resolved `.dart_tool/package_config.json`, every `package:flutter/...` import
32reports as an unresolved URI and the real diagnostics are buried.
33
34Packaging calls `flutter build apk` rather than a `fastlane` lane: fastlane is a
35Ruby tool and every lane it would run here wraps that one command, so dropping it
36removes a language runtime from the build environment. Reinstate it when signing
37or Play-upload steps justify it. Android SDK 36 + build-tools 36 live at
38`C:\Android`, JDK 17 under `C:\Program Files\Microsoft`; both are registered
39with `flutter config`, so no PATH changes are needed.
40
41## 3. Conventions and Tradeoffs
42
43* **Strict over clever** — use the pre-approved, opinionated Flutter templates. Do not invent custom UI painting logic or complex animations; standard Material/Cupertino widgets keep the automated CI/CD pipeline passing.
44* **Separation of concerns** — UI files (`lib/ui/`) and state files (`lib/providers/`) never mix. The GenUI agent owns the former; the Logic agent owns the latter.
45* **State management** — use Riverpod. No `setState`, except for a strictly localized animation toggle.
46
47## 4. Safety Gate: Payment Verification
48
49Never trigger the packaging step unless the `x402_payment_verified` flag returns `true` in the Supervisor payload. This check is not optional and must never be bypassed, including during retries or debugging.
50
51## 5. Common Agent Mistakes (Gotchas)
52
53* **Dart MCP desync** — if the QA Subagent throws a "Method not found" error during compilation, do not rewrite the entire file. Feed the exact stack trace back to the Logic Subagent so it can patch the specific callback.
54* **Overwriting specs** — do not modify `DESIGN.md` once the GenUI phase has started. Changes must flow downstream only, never upstream.
55
56## 6. Subagent Configuration Files
57
58To preserve context memory, do not load all subagent system prompts at once. When you need to repair or adjust a specific agent's behavior, read its dedicated configuration file:
59
60* GenUI Agent guidelines: `docs/agents/genui_subagent.md`
61* Logic Agent guidelines: `docs/agents/logic_subagent.md`
62* QA Agent debugging trees: `docs/agents/qa_subagent.md`

Dockerfile.actor

# The Apify Actor image.
#
# Self-contained rather than `FROM appgen-base`, because Apify builds this on
# its own runners and cannot pull an image that only exists on our machine. That
# means the toolchain instructions below are duplicated from ./Dockerfile, which
# is a real risk: the whole promise of the service is that generated code
# compiles, and two images pinned to different SDKs would let the Actor and the
# hosted service claim the same guarantee while building differently.
#
# `test_the_two_images_pin_the_same_toolchain` fails if any pinned version here
# stops matching ./Dockerfile. Change one, change both.
#
# A cold build measured 5m30s and 2.61 GB, against Apify's 30-minute build
# timeout — the margin is why this approach is viable at all.
FROM python:3.12-slim-bookworm

# amd64 only: the Flutter Linux SDK is x64 and the Android build-tools ship
# x86_64 ELF binaries. Caught here rather than several minutes later inside
# Gradle, with an exec-format error that names none of this.
RUN arch="$(dpkg --print-architecture)"; \
    if [ "$arch" != "amd64" ]; then \
        echo "This image is amd64-only. Detected: $arch." >&2; \
        exit 1; \
    fi

RUN apt-get update && apt-get install -y --no-install-recommends \
        ca-certificates \
        curl \
        git \
        openjdk-17-jdk-headless \
        unzip \
        xz-utils \
        zip \
    && rm -rf /var/lib/apt/lists/*

ENV FLUTTER_VERSION=3.44.8 \
    FLUTTER_ROOT=/opt/flutter \
    ANDROID_SDK_ROOT=/opt/android \
    ANDROID_HOME=/opt/android \
    JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH="${FLUTTER_ROOT}/bin:${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin:${ANDROID_SDK_ROOT}/platform-tools:${PATH}"

RUN curl -fsSL --retry 3 \
        "https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_${FLUTTER_VERSION}-stable.tar.xz" \
        -o /tmp/flutter.tar.xz \
    && tar -xJf /tmp/flutter.tar.xz -C /opt \
    && rm /tmp/flutter.tar.xz

# The two `test` lines are the real check: `flutter doctor` exits 0 with pieces
# of the toolchain missing, and apksigner is what src/build/signing.py shells
# out to in order to prove a release APK is unsigned.
RUN curl -fsSL --retry 3 \
        "https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip" \
        -o /tmp/cmdline-tools.zip \
    && mkdir -p "${ANDROID_SDK_ROOT}/cmdline-tools" \
    && unzip -q /tmp/cmdline-tools.zip -d "${ANDROID_SDK_ROOT}/cmdline-tools" \
    && mv "${ANDROID_SDK_ROOT}/cmdline-tools/cmdline-tools" "${ANDROID_SDK_ROOT}/cmdline-tools/latest" \
    && rm /tmp/cmdline-tools.zip \
    && yes | sdkmanager --licenses > /dev/null \
    && sdkmanager --install "platforms;android-36" "build-tools;36.0.0" "platform-tools" > /dev/null \
    && test -d "${ANDROID_SDK_ROOT}/platforms/android-36" \
    && test -x "${ANDROID_SDK_ROOT}/build-tools/36.0.0/apksigner"

# System-wide as root, before the user switch: a RUN after `USER` cannot write
# to the system site-packages, and that failure reads like a broken dependency.
ENV POETRY_VIRTUALENVS_CREATE=false \
    PIP_NO_CACHE_DIR=1 \
    PYTHONUNBUFFERED=1
WORKDIR /app
COPY pyproject.toml poetry.lock README.md ./
RUN pip install "poetry>=2.0" \
    && poetry install --only main --no-root \
    && pip install "apify>=2.0.0" \
    && python -c "import apify"

# Builds run unprivileged: the Flutter tool refuses some operations as root, and
# git reports "dubious ownership" on a checkout it does not own, which surfaces
# as a Flutter version error rather than a permissions one.
RUN useradd --create-home --shell /bin/bash builder \
    && mkdir -p /tmp/actor-build \
    && chown -R builder:builder /opt/flutter /opt/android /tmp/actor-build /app

USER builder
RUN git config --global --add safe.directory /opt/flutter \
    && flutter config --android-sdk "${ANDROID_SDK_ROOT}" --no-analytics \
    && flutter precache --android \
    && flutter --version

COPY --chown=builder:builder src ./src

# Apify gives the Actor a writable working directory but no mounted volume.
ENV BUILD_ROOT=/tmp/actor-build

# Runs once and exits rather than serving.
CMD ["python", "-m", "src.actor.main"]

LICENSE

MIT License

Copyright (c) 2026 Andres

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.

poetry.lock

# This file is automatically @generated by Poetry 2.4.1 and should not be changed by hand.

[[package]]
name = "annotated-doc"
version = "0.0.5"
description = "Document parameters, class attributes, return types, and variables inline, with Annotated."
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "annotated_doc-0.0.5-py3-none-any.whl", hash = "sha256:117bac03a25ede5df5440e855b32d556049ca169ead221505badf432fed4b101"},
    {file = "annotated_doc-0.0.5.tar.gz", hash = "sha256:c7e58ce09192557605d8bbd92836d7e1d520ac9580096042c0bfd197efacf1bb"},
]

[[package]]
name = "annotated-types"
version = "0.8.0"
description = "Reusable constraint types to use with typing.Annotated"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "annotated_types-0.8.0-py3-none-any.whl", hash = "sha256:f072f4d804ea359e4eaf198b1af7a8b0943881a87f31bb764f8bf219bb9419e0"},
    {file = "annotated_types-0.8.0.tar.gz", hash = "sha256:13b2beaad985e05e2d6407ee4c4f35590b11f8d693a258a561055cac8f64cab7"},
]

[[package]]
name = "anthropic"
version = "0.120.0"
description = "The official Python library for the anthropic API"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "anthropic-0.120.0-py3-none-any.whl", hash = "sha256:591bd531563ec7b63a1e138f5c11f14cb94edda99623b349c2ce2ece8e08b8a5"},
    {file = "anthropic-0.120.0.tar.gz", hash = "sha256:6ba6007dc9b00365b20f6101a6618f5196ac1ceef81512e4b5cc0e7436d4975d"},
]

[package.dependencies]
anyio = ">=3.5.0,<5"
distro = ">=1.7.0,<2"
docstring-parser = ">=0.15,<1"
httpx = ">=0.25.0,<1"
jiter = ">=0.4.0,<1"
pydantic = ">=1.9.0,<3"
sniffio = "*"
typing-extensions = ">=4.14,<5"

[package.extras]
aiohttp = ["aiohttp", "httpx-aiohttp (>=0.1.9,<1)"]
aws = ["boto3 (>=1.28.57)", "botocore (>=1.31.57)"]
bedrock = ["boto3 (>=1.28.57)", "botocore (>=1.31.57)"]
google-cloud = ["google-auth[requests] (>=2,<3)"]
mcp = ["mcp (>=1.0) ; python_version >= \"3.10\""]
vertex = ["google-auth[requests] (>=2,<3)"]
webhooks = ["standardwebhooks (>=1.0.1,<2)"]

[[package]]
name = "anyio"
version = "4.14.2"
description = "High-level concurrency and networking framework on top of asyncio or Trio"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "anyio-4.14.2-py3-none-any.whl", hash = "sha256:9f505dda5ac9f0c8309b5e8bd445a8c2bf7246f3ce950121e45ea15bc41d1494"},
    {file = "anyio-4.14.2.tar.gz", hash = "sha256:cfa139f3ed1a23ee8f88a145ddb5ac7605b8bbfd8592baacd7ce3d8bb4313c7f"},
]

[package.dependencies]
idna = ">=2.8"
typing_extensions = {version = ">=4.5", markers = "python_version < \"3.13\""}

[package.extras]
trio = ["trio (>=0.32.0)"]

[[package]]
name = "bitarray"
version = "3.9.2"
description = "efficient arrays of booleans -- C extension"
optional = false
python-versions = ">=3.7"
groups = ["main"]
files = [
    {file = "bitarray-3.9.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:a334e162a24c4e85babffb78823d83aa04c882a7dd40c2106b668a8cde3da752"},
    {file = "bitarray-3.9.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8855aab242b4865e7ac7e14b6ce80f4cdf213984f260f31d92505d6877c620f9"},
    {file = "bitarray-3.9.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:cf06a3a5263268a35ed0d5513309791040ec8e8d3089bb5af12f51979dbf0a2a"},
    {file = "bitarray-3.9.2-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b82130cfba659e6a9da81298f43be678e99c598e64d814cfa86f0df8c1e230aa"},
    {file = "bitarray-3.9.2-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2ebc32a4fd8659a848d2c92ca5d75a1029cff9711bedbf3a32c515a19d4b3868"},
    {file = "bitarray-3.9.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:047e6ad06ffe606cdc9d75b83effc5f14ab11f30bf6ca38fd98553410e23880b"},
    {file = "bitarray-3.9.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:42e7735c20e3e8e8044bd566ffa8461ad4870a8459c5d3fe9d43984eaa2d6104"},
    {file = "bitarray-3.9.2-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:23aa70b05518ee20d965a8cbd1e168ba4085647f12d7bdb654412a253c476652"},
    {file = "bitarray-3.9.2-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:0197a8970233d65e04357308d52e5310ea8219e07587f8db8a98d7ac21b7de50"},
    {file = "bitarray-3.9.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:ac1a5b7919ab373df270f268ab35c49aa311ed06412290313cecfae9406003ee"},
    {file = "bitarray-3.9.2-cp310-cp310-win32.whl", hash = "sha256:3aba64f5b449f50498185c81ba16dc9b819b06d985630f1b630e836081cf5051"},
    {file = "bitarray-3.9.2-cp310-cp310-win_amd64.whl", hash = "sha256:3a6bda7bd4a77926a18dc9890acad77ae96c2e4d9ff163a20438a67a23d7d956"},
    {file = "bitarray-3.9.2-cp310-cp310-win_arm64.whl", hash = "sha256:4f9576e2e417eb4b45257c135b40d5e465969382dbf4291377f4b7327ca74603"},
    {file = "bitarray-3.9.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:38c850db9ae8602e21c5c29193546a7ac85f1a70adfd4d65853154825675fce2"},
    {file = "bitarray-3.9.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:06df682d5b9ef233a21fab71912f131b2c295913202f2ad5370e44b0e0b26241"},
    {file = "bitarray-3.9.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d0c064263c54fffe8fdfe8e20074816c67ec70608b0efb42a7d9fdf35ef67271"},
    {file = "bitarray-3.9.2-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0a61eac6a5a47cc7bc458b1f0737a701767543949580605cd85272c48121fb0a"},
    {file = "bitarray-3.9.2-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b62d7de8e4dc4ffbff407e1c7f868b84a00ac4a9919e28755fd299e86740fced"},
    {file = "bitarray-3.9.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8ea75f495073f95e96e3f3049411854b5db1693901d8b324439a170ef45088fa"},
    {file = "bitarray-3.9.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1f3eb99f3cc4ef93b4830e8532ba506be4105f15daddba9302bbd96f24b1cf72"},
    {file = "bitarray-3.9.2-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:e22236531f0193457277a7340d8bdd006f202f563f22f29abb873dc0850eb472"},
    {file = "bitarray-3.9.2-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:92a438122d35d5e5703983c7dda7de90fc25c50282ce60f73ad61a6ced3ce0bc"},
    {file = "bitarray-3.9.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:47ec58fceafd38d5839bb9d8262ca6150e222f81d1e4adc8feafda6caf360334"},
    {file = "bitarray-3.9.2-cp311-cp311-win32.whl", hash = "sha256:e8ec38401d9370684709f8cc3a0febbb742edf9fbacb1e432bcad8d023990e6d"},
    {file = "bitarray-3.9.2-cp311-cp311-win_amd64.whl", hash = "sha256:30e2516878f7745957948e1a2d877f56ceda13b5f6b51d92d2174ef1756ab473"},
    {file = "bitarray-3.9.2-cp311-cp311-win_arm64.whl", hash = "sha256:89c87ffdb399a53821cb0f5566a7d04e0f2870096a4964b038866a894b40c9c6"},
    {file = "bitarray-3.9.2-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c967be9bd2fadd58e0d2c4e139e6e7443b5dd9162e52e43ef5e2489218c4fecb"},
    {file = "bitarray-3.9.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3c17c918e569a81a2dd87794e15991c9643accf72b5c005e8791cdedcb2d6189"},
    {file = "bitarray-3.9.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eea0dc21749eeb53b163d45c3dd0524e62c0301dd512bfb4f5ef34ccce7be6ad"},
    {file = "bitarray-3.9.2-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:64fb672905884fc236ef200b9fbde529c6673a8217c62bf8651bdce4842ba366"},
    {file = "bitarray-3.9.2-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:be25330b9da322a806b29bae0147e6ea3730b6f85a5036e25f8e50247fee013a"},
    {file = "bitarray-3.9.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b7e14fd457ccea13e0adca60d93ffcd17b70184e7f485a986523241a077f3ac9"},
    {file = "bitarray-3.9.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5f719003b0d692d3088e8f783ec684bf7caf00bddb5392efbe7842ba1ff15e8e"},
    {file = "bitarray-3.9.2-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:a72e6b82f1800a08dff90a9d401ffd3f8c278644e4f6711a7458c9f16ee9446e"},
    {file = "bitarray-3.9.2-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:d043ef192ae741f0524b3d3404a2e6e8dbb6affeda421d40d46456cf6cfa1064"},
    {file = "bitarray-3.9.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:23fe97bfed91ae4c927871b779caa159000da958fe5521d92420a09ed524efdf"},
    {file = "bitarray-3.9.2-cp312-cp312-win32.whl", hash = "sha256:ff72bbdd7c01ca661cb6712e706c0e0f0bc45a6b2426f69e9517cf7508b8d294"},
    {file = "bitarray-3.9.2-cp312-cp312-win_amd64.whl", hash = "sha256:12c2e7556f7d7f3d2a2017d66159790ed6cadf849a3aa436d9c3541dd3facd6c"},
    {file = "bitarray-3.9.2-cp312-cp312-win_arm64.whl", hash = "sha256:76c0a98d85b2ed7090ff6c0fff9917a2ddffaffb82c2d0ce7d424f0830dc8dee"},
    {file = "bitarray-3.9.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5156ae1fb0d56238b2ba64b8c0da9a14dbc2e16c9d79114ad3850b7aff513b0a"},
    {file = "bitarray-3.9.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:054fc478842a95d8e9e200117a7e170cd8ec17608e3cfa451e44fc78e5ab5007"},
    {file = "bitarray-3.9.2-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d5e428a70d6e395b9fd415bba70bfb463d2b9e8010d471cb99eb0f82e91d179"},
    {file = "bitarray-3.9.2-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a34d717b362f96a767b03f350cefecd0f613a44ce774868d3635423eec1e5d75"},
    {file = "bitarray-3.9.2-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:068a100b2d3507e1ebd6f0cb3515551ddf3c7db1c98426dc854ddff985508eb8"},
    {file = "bitarray-3.9.2-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3a797165662ce08029a5975e05e928b77f979d8322cc719ba46eb8b3d9ab5c9b"},
    {file = "bitarray-3.9.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6468d775054cb4fe777d585c661df89e99f9398fa9cb31e428a9b42105e6ce48"},
    {file = "bitarray-3.9.2-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:9bd26caa42d12c747af2c3a3995b08db32ac7afa0c5262c0b6c6931293067805"},
    {file = "bitarray-3.9.2-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:11574711bae2b501141f64cf6d7a9819c9f45e7d8edcd2d9fe282b377dadb900"},
    {file = "bitarray-3.9.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:c6e16d6a8d93362f65336fc57e76fb1fe94f257bb54a843cf1a83c86887ac1ca"},
    {file = "bitarray-3.9.2-cp313-cp313-win32.whl", hash = "sha256:7fd8d649b10ba26c032c76ffb2610385496ebf5e52c44c26864e9b16ac8102b3"},
    {file = "bitarray-3.9.2-cp313-cp313-win_amd64.whl", hash = "sha256:0df2bd4b5fea65be332cf9c17351d4c68d3eb442c0e13a5bda8019554cb36ce1"},
    {file = "bitarray-3.9.2-cp313-cp313-win_arm64.whl", hash = "sha256:94278c9d37a6f4316ae1f100e98e6582369f25b1f8186bb595ee1578fbc5c52e"},
    {file = "bitarray-3.9.2-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:b0debddd2eb7d1a0417f602b2520dd6fb6897ab140c1d69b8c42a69d164ef61b"},
    {file = "bitarray-3.9.2-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:5d0387459ac35f6be40c4b809c34f34afe14aa930493e0b06f6df5d327f405c3"},
    {file = "bitarray-3.9.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5bde034041875a48ea8c0a4b272e9a6e29174b234bd4905c86a65484f34cd140"},
    {file = "bitarray-3.9.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:37c76ff084118ab1db8b826e35c01ce4d0137e66b611542e16b1f296c96e6aa6"},
    {file = "bitarray-3.9.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d12c7b574e2903477124a0d77bbc903fd4c3beaefa841f4a63c199014192447b"},
    {file = "bitarray-3.9.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bbff5cccf3a1f4129c8ad43b2bcb789882fba47c87422b30a74bc3bee98a292"},
    {file = "bitarray-3.9.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c374884716ab641c36ee4f51859fa4274fbdf0355ae7242290a29af3cf49381d"},
    {file = "bitarray-3.9.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:2fe1d36b6d816512af098699c85e9237ce5978863a336a2833ebc03f59545781"},
    {file = "bitarray-3.9.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:4f719595fde8bdf030282c8221c738248a3a73928db3087ea62db2c29de5342d"},
    {file = "bitarray-3.9.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:28c4edee03ece6768ee51c1889c5d4df05764f8ad956fed6295912dbe4aef729"},
    {file = "bitarray-3.9.2-cp314-cp314-win32.whl", hash = "sha256:f01b94e8bd0229c214f0873f8d19cf4db4602a230064317a8be00428922f7987"},
    {file = "bitarray-3.9.2-cp314-cp314-win_amd64.whl", hash = "sha256:7892775de516287fbc850cfb9476599bc399b971105fbbe216513ac4cb67d6bf"},
    {file = "bitarray-3.9.2-cp314-cp314-win_arm64.whl", hash = "sha256:7dcbf363dce364722a3cd3875be5453a36db8c476af551bc5b194ea9960c591f"},
    {file = "bitarray-3.9.2-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:732fc6464eebdfbbdb28e7a2e98424ba7633619665fb065cb6d756ffef5f6b08"},
    {file = "bitarray-3.9.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c23f1dc6f118c3a885ee2a281261da37e98c35b4361dcf2c9a9d3d70370b32e6"},
    {file = "bitarray-3.9.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ada39b08677af76c48a64f1f14e8e518315cf478004ddf4b6c580ce3625c1a9d"},
    {file = "bitarray-3.9.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:70e5a48906a8cab0b8d84ad356d8cf8f0fb533b93475da26437a4a3aed8a9a4b"},
    {file = "bitarray-3.9.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4b14351e75d76662d10c1479c8864f4076ab393a297323b85277d2253ccfb96e"},
    {file = "bitarray-3.9.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:920edc84385932401ddabe62e244774acaa69e991072768fcf7e621c29599f6f"},
    {file = "bitarray-3.9.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:3d6dd06fd0e1c88e6da86e4c0479457c74f03f66a2dc16c0c60ecce12c5dee1d"},
    {file = "bitarray-3.9.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:ee339e8f9a763499c5fc855927c8174680183e8751f03f797234a0bd1223c3ff"},
    {file = "bitarray-3.9.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:50f0ff3b5e5cfa7ca42e2469418a26d098a42e47b0e171adf9c6c69ea800d055"},
    {file = "bitarray-3.9.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:c898478e6dde8ca75970b91a602b1f48ebedff49841b89cb8495c1949b6d762c"},
    {file = "bitarray-3.9.2-cp314-cp314t-win32.whl", hash = "sha256:415675dbae4d1c58a5ae31550db6224e0785443e41d9ed74cf4371aec38d61d3"},
    {file = "bitarray-3.9.2-cp314-cp314t-win_amd64.whl", hash = "sha256:de17695646139d2a9863cf1d8ff83f1335aa3d593f2730c9ae442fb08ef80241"},
    {file = "bitarray-3.9.2-cp314-cp314t-win_arm64.whl", hash = "sha256:19105d5ff84450b341a0dc1021c7f8d63cb1ffedcdc78b46e62f4cd76f28a7f1"},
    {file = "bitarray-3.9.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:e0d5fe4857ca9bdcabc24a3b1cba18e9bb99c3fea3ff5f96fd043d194c5f4532"},
    {file = "bitarray-3.9.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:f99398936dae5752c2d327ec427fd507486e2e61e208f0c05de0d77f6c92c373"},
    {file = "bitarray-3.9.2-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dc6d2ee233f9344338615fc692332939e4be4b5aa53dd28184dfa4a29bbcffa6"},
    {file = "bitarray-3.9.2-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:10bf8636e4cc27517a11297591c3fba8b069473bf1809ab3f2f5112b2fd20b4e"},
    {file = "bitarray-3.9.2-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:86d7af467d34beb3e91e7e693d74256b9f33f16dd6f6368ffcf025e22d98a099"},
    {file = "bitarray-3.9.2-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:23781a7f237cee1ee1abd05e6af72e925ce4ead084fd415ef3ee9d99b2b6ce6f"},
    {file = "bitarray-3.9.2-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:5e0de072ab3d98db5fd13ca7db71b66a47f318005cb30e8a6d332f1d0846be25"},
    {file = "bitarray-3.9.2-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:19b3ff65ff8e9d2f3e915df06460efd7c67303f207492253853507be47f210b2"},
    {file = "bitarray-3.9.2-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:90ca3edc8af1b9457da56c05c0adbf570f82282e38dc20e7417146fa4b328e3d"},
    {file = "bitarray-3.9.2-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:ae0c83c08f194f46c1107d421956a3ef4267b2953bd1a70cb74cb8ecf17e68f9"},
    {file = "bitarray-3.9.2-cp38-cp38-win32.whl", hash = "sha256:f14f1309092c2b402748aa02cd1de0f50ee675bda9e3c20232e0ff1f799cd8d2"},
    {file = "bitarray-3.9.2-cp38-cp38-win_amd64.whl", hash = "sha256:170482925b5df114d7c1002d466823069ec0623466aad6bd7d8d01d59ae85bb9"},
    {file = "bitarray-3.9.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:e3063d006a298b557a8438fcddd9a9146d8d6deceeac5d95e1bdbb3a51b7f975"},
    {file = "bitarray-3.9.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f557b098719c0e8d6006bc08fafae6521a903d1da889e8abf5c301708f791ef2"},
    {file = "bitarray-3.9.2-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b7b23d7d2616d13023657b674ab830ab1519e4d14b9bc8433a02dcef096f5fec"},
    {file = "bitarray-3.9.2-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:86ef3c183dada46c996b86b3a7a836a2b7cc7b8efad7b059179c5432c7490071"},
    {file = "bitarray-3.9.2-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ba12d4072896600626e437ee365e74ab64170b978b2c618994b3f6583e9df759"},
    {file = "bitarray-3.9.2-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:44a0cb94d719661a1fe41e8e80208b9fd75be095438988afe034fdc9b31cc703"},
    {file = "bitarray-3.9.2-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:36b5ada31de6e2dc81ba32a504d93a3eeb312f8a4b225c3c477448e2945e5e9b"},
    {file = "bitarray-3.9.2-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:301dcda018266f3cacb50de4b4c4291ca1143171674d147d5d9e25eaabbc5181"},
    {file = "bitarray-3.9.2-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:b5eb050ca48ecd4c523554eb49325c303ff7d43f751759651fedcfa59d4697f5"},
    {file = "bitarray-3.9.2-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:8d0f2d39e1d4bcf353c9ba2ff611d730d9a4b82af4b1d473524c9ef4a20b49e9"},
    {file = "bitarray-3.9.2-cp39-cp39-win32.whl", hash = "sha256:71afda644587c31006e4137ca08abcc6927a75d1f7ed8ea60131034f1ec6d39b"},
    {file = "bitarray-3.9.2-cp39-cp39-win_amd64.whl", hash = "sha256:c058673337cd20b2b182bced0311144a22bdfc0ed77722e8366d2e97c6832764"},
    {file = "bitarray-3.9.2-cp39-cp39-win_arm64.whl", hash = "sha256:483f1f85faed53f36af0a45f20affba8008de7e0ada88cff336b8a23ef8485db"},
    {file = "bitarray-3.9.2.tar.gz", hash = "sha256:37342f81c8f8e10ee5d1e23d5eda2e8dbd9d8d3a9d90e8285181fad57f21cdc1"},
]

[[package]]
name = "certifi"
version = "2026.7.22"
description = "Python package for providing Mozilla's CA Bundle."
optional = false
python-versions = ">=3.7"
groups = ["main"]
files = [
    {file = "certifi-2026.7.22-py3-none-any.whl", hash = "sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775"},
    {file = "certifi-2026.7.22.tar.gz", hash = "sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55"},
]

[[package]]
name = "charset-normalizer"
version = "3.4.9"
description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
optional = false
python-versions = ">=3.7"
groups = ["main"]
files = [
    {file = "charset_normalizer-3.4.9-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:cd6280cf040f233bd7d3407b743b4b4c74f70e8e1c4199cb112a62c941c0772a"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:aa99adc8f081b475a12843953db36831eaf83ec33eb46a90629ca6a5de45a616"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c1225416b463483160e4af85d5fc3a9690ccb53fd4b1865a6437825f5ede3209"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:16d10d789dd9bcca1173c95af82c58433122564b7bc39385124be735a35cbe99"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9bb41182d93ea91f60b4bc8fbf4c820c69ef8a12ab2d917f3f1834f1acad07e8"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:bcf74c1df76758a395bf0af608c04c82257523f55c9868b334f06270d0f2112b"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b5314963fce9b0b12743891de876e724997864ee22aa496f903f426c7e2fa5b2"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:e9701d0049d92c16703a42771b98d560b95248949f23f8cf7b4eddd201814fb9"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:65a7ff3f705e57d392f7261b6d0550fe137c3019477431f1c355e0db0a7d3e15"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:79580094b00d1789d1f93ea55bc43cb2f611910c72235b7657f3482ddcc1b22d"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-win32.whl", hash = "sha256:432786d3561e69aeeae6c7e8648964ce0ad05736120135601f87ac26b9c83381"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-win_amd64.whl", hash = "sha256:8c041122946b7ba21bb32c45b1aa57b1be35527690aeb3c5c234521085632eee"},
    {file = "charset_normalizer-3.4.9-cp310-cp310-win_arm64.whl", hash = "sha256:375b83ed0aecfce76c16d198fbc21f3b11b337d68662bea0a995046682a11419"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:0e94703ec9684807f20cfb5eed95c70f67f2a8f21ad620146d7b5a13677b93e5"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2a441ea71902098ffe78c5abe6c494f44160b4af614ed16c3d9a3b1d17fd8ee2"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:304b13570067b2547562e308af560b3963857b1fa90bd6afd978130130fe2d6a"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4773092f8019072343a7447203308b176e10199920eb02d6195e81bbb3274c29"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:04ce310cb89c15df659582aee80a0603788732a5e017d5bd5c81158106ce249c"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:c0323c9daef75ef2e5083624b4585018a0c9d5e3b40f607eed81a311270b934b"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:871ff67ea1aad4dfd91736464934d56b32dac49f9fbe16cddba36198a7b3a0db"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:67830fc78e67501f47bb950471b2dcb9b35b140084429318e862895a8e89c993"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:3d92613ec25e43b05f042302531ec0f00b8445190e43325880cbd6ab7c2581da"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:280081916dc341820640489a66e4696049401ef1cf6dd672f672e70ad915aca3"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-win32.whl", hash = "sha256:ac351b3b8014eead140e77e9717e2992c6bbe30b63bc3422422eb84865412e3d"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-win_amd64.whl", hash = "sha256:6366a16e1a25018694d6a5d784d09b046edc9eac40ea2b54065c3052672516a1"},
    {file = "charset_normalizer-3.4.9-cp311-cp311-win_arm64.whl", hash = "sha256:1d22856ffbe153a602df38e4a5464f0b748a54002e0d69ac6d2ad0a197cc99ec"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:45b0cc4e3556cd875e09102988d1ab8356c998b596c9fced84547c8138b487a0"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9b2aff1c7b3884512b9512c3eaadd9bab39fb45042ffaaa1dd08ff2b9f8109d9"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9104ed0bd76a429d46f9ec0dbc9b08ad1d2dcdf2b00a5a0daa1c145329b35b44"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:7b86a2b16095d250c6f58b3d9b2eee6f4147754344f3dab0922f7c9bf7d226c9"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5e226f6218febc71f6c1fc2fafb91c226f75bdc1d8fb12d66823716e891608fd"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:90c44bc373b7687f6948b693cceaea1348ae0975d7474746559494468e3c1d84"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9cdef90ae47919cae358d8ab15797a800ed41da7aba5d72419fb510729e2ed4b"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:60f44ade2cf573dad7a277e6f8ca9a51a21dda572b13bd7d8539bb3cd5dbedde"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:a1786910334ed46ab1dd73222f2cd1e05c2c3bb39f6dddb4f8b36fc382058a39"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:03d07803992c6c7bbc976327f34b18b6160327fc81cb82c9d504720ac0be3b62"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-win32.whl", hash = "sha256:78841cccf1af7b40f6f716338d50c0902dbe88d9f800b3c973b7a9a0a693a642"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-win_amd64.whl", hash = "sha256:4b3dac63058cc36820b0dd072f89898604e2d39686fe05321729d00d8ac185a0"},
    {file = "charset_normalizer-3.4.9-cp312-cp312-win_arm64.whl", hash = "sha256:78fa18e436a1a0e58dbd7e02fc4473f3f32cceb12df9dfca542d075961c307d2"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:440eede837960000d74978f0eba527be106b5b9aee0daf779d395276ed0b0614"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:21e764fd1e70b6a3e205a0e46f3051701f98a8cb3fad66eeb80e48bb502f8698"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e4fd89cc178bced6ad29cb3e6dd4aa63fa5017c3524dbd0b25998fb64a87cc8b"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bd47ba7fc3ca94896759ea0109775132d3e7ab921fbf54038e1bab2e46c313c9"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:84fd18bcc17526fc2b3c1af7d2b9217d32c9c04448c16ec693b9b4f1985c3d33"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:5b10cd92fc5c498b35a8635df6d5a100207f88b63a4dc1de7ef9a548e1e2cd63"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a4fbdde9dd4a9ce5fd52c2b3a347bb50cc89483ef783f1cb00d408c13f7a96c0"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:416c229f77e5ea25b3dfd4b582f8d73d7e43c22320302b9ab128a2d3a0b38efe"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:75286256590a6320cf106a0d28970d3560aad9ee09aa7b34fb40524792436d35"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:69b157c5d3292bcd443faca052f3096f637f1e074b98212a933c074ae23dc3b8"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-win32.whl", hash = "sha256:51307f5c71007673a2bf8232ad973483d281e74cb99c8c5a990af1eefa6277d9"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-win_amd64.whl", hash = "sha256:fe2c7201c642b7c308f1675355ad7ff7b66acfe3541625efe5a3ad38f29d6115"},
    {file = "charset_normalizer-3.4.9-cp313-cp313-win_arm64.whl", hash = "sha256:611057cc5d5c0afc743ba8be6bd828c17e0aaa8643f9d0a9b9bb7dea80eb8012"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:0327fcd59a935777d83410750c50600ee9571af2846f71ce40f25b13da1ef380"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8a79d9f4d8001473a30c163556b3c3bfebec837495a412dde78b51672f6134f9"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:33bdcc2a32c0a0e861f60841a512c8acc658c87c2ac59d89e3a46dacf7d866e4"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f840ed6d8ecba8255df8c42b87fadeda98ddfc6eeec05e2dc66e26d46dd6f58a"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c25fe15c70c59eb7c5ce8c06a1f3fa1da0ecc5ea1e7a5922c40fd2fa9b0d5046"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:f7fb7d750cfa0a070d2c24e831fd3481019a60dd317ea2b39acbcebc08b6ed81"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4d1c96a7a18b9690a4d46df09e3e3382406ae3213727cd1019ebade1c4a81917"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a4cfde78a9f2880208d16a93b795726a3017d5977e08d1e162a7a31322479c41"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:d4d6fcde76f94f5cb9e43e9e9a61f16dacefd228cbbf6f1a09bd9b219a92f1a1"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:898f0e9068ca27d37f8e83a5b962821df851532e6c4a7d615c1c033f9da6eedf"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-win32.whl", hash = "sha256:c1c948747b03be832dceed96ca815cef7360de9aa19d37c730f8e3f6101aca48"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-win_amd64.whl", hash = "sha256:16b65ea0f2465b6fb52aa22de5eca612aa964ddfec00a912e26f4656cbef890b"},
    {file = "charset_normalizer-3.4.9-cp314-cp314-win_arm64.whl", hash = "sha256:40a126142a56b2dfc0aacbad1de8310cbf60da7656db0e6b16eebd48e3e93519"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:609b3ba8fcc0fb5ab7af00719d0fb6ad0cb518e48e7712d12fd68f1327951198"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:51447e9aa2684679af07ca5021c3db526e0284347ebf4ffcec1154c3350cfe32"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:cc1b0fff8ead343dae06305f954eb8468ba0ec1a97881f42489d198e4ce3c632"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:fa36ec09ef71d158186bc79e359ff5fdd6e7996fe8ab638f00d6b93139ba4fcf"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:df115d4d83168fdf2cae48ef1ff6d1cb4c466364e30861b37121de0f3bf1b990"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:f86c6358749bd4fda175388691e3ba8c46e24c5347d0afd20f9b7edfc9faf07d"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:32286a2c8d167e897177b673176c1e3e00d4057caf5d2b64eef9a3666b03018e"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:83aed2c10721ddd90f68140685391b50811a880af20654c59af6b6c66c40513c"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:cd6c3d4b783c556fa00bf540854e42f135e2f256abd29669fcd0da0f2dec79c2"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:ee2f2a527e3c1a6e6411eb4209642e138b544a2d72fe5d0d76daf77b24063534"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-win32.whl", hash = "sha256:0d861473f743244d349b50f850d10eb87aeb22bbdcc8e64f79273c94af5a8226"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-win_amd64.whl", hash = "sha256:9b8e0f3107e2200b76f6054de99016eac3ee6762713587b36baaa7e4bd2ae177"},
    {file = "charset_normalizer-3.4.9-cp314-cp314t-win_arm64.whl", hash = "sha256:19ac87f93086ce37b86e098888555c4b4bc48102279bae3350098c0ed664b501"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:253a4a220747e8b5faf57ec320c4f5efb0cef05f647420bf267143ec15dba10a"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:68ce9f4d6b26d5ccbf7fd4459bf75f74a0a146677ebba80597df60cbdb20e6f4"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:58150c9f9b9a552505912d182ccdf26f6396fb6094816ceebcbb20eecabaed94"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:df7276909358e5635ae203673ab7e509ddd224225a8d6b0790bf13eb2bde1cc5"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3c09a49d6cde137258beb3d551994a2927fd35ad5cf96aed573f61bbd67c5f84"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:231ddcbb35e2ff8973e1365db41fe0572662893b99a05deb183b68ad4c0c8bd4"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:920079c3f7456fa213e0829ed2073aaa727fd39d889ead5b4f35d0de5460d04f"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:0fa1aec2d32bcc03c8fa0f6f1712caad1adc38509f31142112e5c9daf5b9c833"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:ad41ba96094304aa090f5a30cb6e4fb3b3f1c264c523394b4c39bbacc4dc92ba"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:43b9e366a31fdd1c87d0eb08f579b4a82b723ea54338f040d6b4e518a026ea29"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-win32.whl", hash = "sha256:93d59d504b230e83c7a843251681959a0b6a9cd76f6e146ce1b8a80eb8739af9"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-win_amd64.whl", hash = "sha256:ddf4af30b417d9fe16481e9b81c27ab2a7cde1ff7ba3e85653b02db7d145dc7b"},
    {file = "charset_normalizer-3.4.9-cp39-cp39-win_arm64.whl", hash = "sha256:476743fe6dfe14a2da12e3ac79125dc84a3b2cf8094369a47a1529b0cd8549fe"},
    {file = "charset_normalizer-3.4.9-py3-none-any.whl", hash = "sha256:68e5f26a1ad57ded6d1cfb85331d1c1a195314756471d97758c48498bb4dcdf5"},
    {file = "charset_normalizer-3.4.9.tar.gz", hash = "sha256:673611bbd43f0810bec0b0f028ddeaaa501190339cac411f347ac76917c3ae7b"},
]

[[package]]
name = "ckzg"
version = "2.1.8"
description = "Python bindings for C-KZG-4844"
optional = false
python-versions = "*"
groups = ["main"]
files = [
    {file = "ckzg-2.1.8-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8dc23b189b5e061b5a2fcf609b6dc1f62098dd72cf9116e4721f995eb144b0ee"},
    {file = "ckzg-2.1.8-cp310-cp310-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:71e0e6d84a268c23c29d546a7ef4720a9d2aea597efe4def75205b6ef436900c"},
    {file = "ckzg-2.1.8-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8ccabbd5aea9cf98ae5301ec8b16119720d93f8f155a567e041e2f16b1fafc87"},
    {file = "ckzg-2.1.8-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a1dee4ec1d8e6702e6008a4d489638027cd640b5d9e5adca48a8c16aa193c6c7"},
    {file = "ckzg-2.1.8-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:697f5c4016a9f091bdf7e646be0d71e625b5106a9f78c6ab53e93e5f425aa513"},
    {file = "ckzg-2.1.8-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:50f6281f5c55240f1be254041e0c06d6348c91e21fccd0ed108151f880b6d087"},
    {file = "ckzg-2.1.8-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9371ac89c420beb6f6d236ce808c7990174dc21bde61032c39235982e4e65697"},
    {file = "ckzg-2.1.8-cp310-cp310-win_amd64.whl", hash = "sha256:c1f0f8e7a14bb4348f3ecaee92d929df3428be1f706034c961e11239d398bcdb"},
    {file = "ckzg-2.1.8-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:adb4868ec73547d040d8551538dc00ebc3822a758a7fb2b762735e097556c13b"},
    {file = "ckzg-2.1.8-cp311-cp311-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:5e42a07899e62cf8888bdefe1fa200e3248190953bacc1d872e13825b0b91a7f"},
    {file = "ckzg-2.1.8-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:369af9ec31248a942f2b249bee9f60dccfe6c8ac944095ad26c8083c9df04186"},
    {file = "ckzg-2.1.8-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dac8202240347c4af5cee9a3ebc62560ae629c8bac2b1ee313fa57cf1c9e4f0a"},
    {file = "ckzg-2.1.8-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:eff52513b32bc83e3b978cae991289cc932d801b6c08aa002d29e44a4290b2f0"},
    {file = "ckzg-2.1.8-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:23bef3d98c905152f4ff497a6243b6a14e916deef2d8a1d342175be90f6e6425"},
    {file = "ckzg-2.1.8-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:40e6e33672e474331519b7d07b8c8e0cbec3d817b6341e00fa728a94141fa8e8"},
    {file = "ckzg-2.1.8-cp311-cp311-win_amd64.whl", hash = "sha256:b84d698c81569381a3dd18a9848f8fca03273ae62045494cee5669a885697d8d"},
    {file = "ckzg-2.1.8-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:98abe138d79886e3e1fbbaf05cdf0702a4351f242ad1a8b4802343c7ba149faa"},
    {file = "ckzg-2.1.8-cp312-cp312-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:2fe01dad7c968bcdf3c063c5192bc7d7d59f66358afb5c99554e5ce2435a95aa"},
    {file = "ckzg-2.1.8-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9bdb7f51ee3cf8e45451bee8c6dce975fddadfe231174d8de9c27a3aa27741b8"},
    {file = "ckzg-2.1.8-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:10339d23e36b8a0a4e6fda7f6c72d6b2fd4e1506f7b64a661ba8c706ee33f335"},
    {file = "ckzg-2.1.8-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a4456c9027f2edcb50a2279d6035ca971a511d8b0025e6659ff407b87ad841ba"},
    {file = "ckzg-2.1.8-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:88cbec7e2010f64988c249ebb5679b73ccae1c536f4c130d4708bf7b06a8cd69"},
    {file = "ckzg-2.1.8-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a4d2581df10bdfaec00fec6daefdeaa438e66582364e1d1b705710e9d749fc47"},
    {file = "ckzg-2.1.8-cp312-cp312-win_amd64.whl", hash = "sha256:a30f2b980929e898f0b28aa6bf9ae35e7afd5884e354376ad3744669b7cacf3e"},
    {file = "ckzg-2.1.8-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:26ed4c4d3acbfdb4bfdf1ab1029219657d4565e1c63d36f2695cdfdb5ec0b569"},
    {file = "ckzg-2.1.8-cp313-cp313-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:a6899908ca3a41e6d2aa19973b398de101a6d64b5189894077ea09a3f508d3fd"},
    {file = "ckzg-2.1.8-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3db1ca21685d567eea668925c9f85ebd723db41d24bbecaa2f78d8256e1ba9c6"},
    {file = "ckzg-2.1.8-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1f27d7d16be9debf173369248ff06e97fc45826bfb0a743519b49b38539ab6c7"},
    {file = "ckzg-2.1.8-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:dadf0cd0c3c19611e8a1188a2a10316b88fbae56d806f75a67cbe846b8b7ec86"},
    {file = "ckzg-2.1.8-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:cde13789188b7bac6d5bee308532a7bd60ab5c2feeccdef2f1da41be761c7e04"},
    {file = "ckzg-2.1.8-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f2737534458547ba8ce89663f833041925b104f7906f17b2338d1b36e6c7c4d"},
    {file = "ckzg-2.1.8-cp313-cp313-win_amd64.whl", hash = "sha256:10b483ad6937878f03d556d120a43d323dcb3891eb83313aa71087b54559594b"},
    {file = "ckzg-2.1.8-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2f3e4a3ae1ff3ec811b6d2aac7a246524f72a750af95fe7a01550cdd68677d6f"},
    {file = "ckzg-2.1.8-cp314-cp314-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:9afe50a28d8d6f130797f0861d4753f76294d983f1e6ead9c17dfa14f8118ad4"},
    {file = "ckzg-2.1.8-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:da197eef7014997b976ae7bc6e0ad42c02a9faa3a4221d6699e8b777761422f1"},
    {file = "ckzg-2.1.8-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fef164b9a0c7ed57935bf78bd23e701ba82efcca180e9b29814a94928a2d5880"},
    {file = "ckzg-2.1.8-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c56f588a57d419ac314880931122796e4331be395368c8887ca3ade5c27f539c"},
    {file = "ckzg-2.1.8-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:37eecbce59271040dfab736db490a28c0e59f189b404e5820e65531dadf84ddb"},
    {file = "ckzg-2.1.8-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:acc5d33e42ac852fec08ad1991020a958e2534ac6af346a83f579b553bd0bdfd"},
    {file = "ckzg-2.1.8-cp314-cp314-win_amd64.whl", hash = "sha256:5eb3b5327dd0cbaaa6551e01a42af9780e998640c57236e460830bf9a6e6f9b4"},
    {file = "ckzg-2.1.8-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:dbd7021cdc5616df5902ec04876b9af25d17facc39851b4d6630c9c2b209e30a"},
    {file = "ckzg-2.1.8-cp314-cp314t-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:5ecbcd887fa97988ddfc3ac4d1951367fa4f6bb25a6f72d449550ea4be45b938"},
    {file = "ckzg-2.1.8-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaeaed98d7be94f7c215373f90cd06536237d6ec08d48d2be74c630e03edf73c"},
    {file = "ckzg-2.1.8-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e1030903bf9989957b73fe30a96516e75a8bc27efb65e1b6e9d3507447bfee06"},
    {file = "ckzg-2.1.8-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:ff48587f541b625dd0e471ecc866cf91462100a4429e3c21cf4f099e7dff9150"},
    {file = "ckzg-2.1.8-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:0580e8a1780d44a85c6edaa44e30a6a85565ad26593becb320d7353bc05e8627"},
    {file = "ckzg-2.1.8-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:bc8a259bc3cc321413c3c8eb0789cbe35919f4f4bb32946b0e1a484d4303629c"},
    {file = "ckzg-2.1.8-cp314-cp314t-win_amd64.whl", hash = "sha256:f41377a2a63330df64ae6f7cd806a288b21c52aa346151fd8f0551b9e0742289"},
    {file = "ckzg-2.1.8-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c4ec8234a72cebe419330e13d580048fec25e63d9526a0a9bf65ed134b6ffa9a"},
    {file = "ckzg-2.1.8-cp39-cp39-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:036b8de43a07340609a3a4445d4da542cb9487c58dc0752c2d419c7be1f3dbdb"},
    {file = "ckzg-2.1.8-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9290e8d128921f1906ffa8e6229a878a9e967ea9937697bf90c894fe523e9d11"},
    {file = "ckzg-2.1.8-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ad90fe4e55aea73e3df744b97043c43cd3227725c3f8715fbae07b4eb0acbab0"},
    {file = "ckzg-2.1.8-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:8d511e410956aa2fcde7d19f40cefcc166fa84ef3387b3c96083e3798bd21a44"},
    {file = "ckzg-2.1.8-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:e523457f3a463214e2ae8aa37f8b35d519e1a51d772734d381dd090cf7391b5c"},
    {file = "ckzg-2.1.8-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:70b67a92373b834e910bc527d538c170757ebc70bc8f99beedbfd64d1913dc80"},
    {file = "ckzg-2.1.8-cp39-cp39-win_amd64.whl", hash = "sha256:d2e709e9701d6085d79cf5d2ed12d373beffae1d93d61b0387055a14818973c0"},
    {file = "ckzg-2.1.8.tar.gz", hash = "sha256:d7bef6b425dca6995457fc59fc5b30211d9b28cbbeee0e7a7bef1372e13f29ca"},
]

[[package]]
name = "click"
version = "8.4.2"
description = "Composable command line interface toolkit"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "click-8.4.2-py3-none-any.whl", hash = "sha256:e6f9f66136c816745b9d65817da91d61d957fb16e02e4dcd0552553c5a197b76"},
    {file = "click-8.4.2.tar.gz", hash = "sha256:9a6cea6e60b17ebe0a44c5cc636d94f09bd66142c1cd7d8b4cd731c4917a15f6"},
]

[package.dependencies]
colorama = {version = "*", markers = "platform_system == \"Windows\""}

[[package]]
name = "colorama"
version = "0.4.6"
description = "Cross-platform colored terminal text."
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
groups = ["main", "dev"]
files = [
    {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"},
    {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"},
]
markers = {main = "platform_system == \"Windows\"", dev = "sys_platform == \"win32\""}

[[package]]
name = "cytoolz"
version = "1.1.0"
description = "Cython implementation of Toolz: High performance functional utilities"
optional = false
python-versions = ">=3.9"
groups = ["main"]
markers = "implementation_name == \"cpython\""
files = [
    {file = "cytoolz-1.1.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:72d7043a88ea5e61ba9d17ea0d1c1eff10f645d7edfcc4e56a31ef78be287644"},
    {file = "cytoolz-1.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:d759e9ed421bacfeb456d47af8d734c057b9912b5f2441f95b27ca35e5efab07"},
    {file = "cytoolz-1.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fdb5be8fbcc0396141189022724155a4c1c93712ac4aef8c03829af0c2a816d7"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:c8c0a513dc89bc05cc72893609118815bced5ef201f1a317b4cc3423b3a0e750"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ce94db4f8ebe842c30c0ece42ff5de977c47859088c2c363dede5a68f6906484"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b622d4f54e370c853ded94a668f94fe72c6d70e06ac102f17a2746661c27ab52"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:375a65baa5a5b4ff6a0c5ff17e170cf23312e4c710755771ca966144c24216b5"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:c0d51bcdb3203a062a78f66bbe33db5e3123048e24a5f0e1402422d79df8ee2d"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1010869529bb05dc9802b6d776a34ca1b6d48b9deec70ad5e2918ae175be5c2f"},
    {file = "cytoolz-1.1.0-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:11a8f2e83295bdb33f35454d6bafcb7845b03b5881dcaed66ecbd726c7f16772"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0499c5e0a8e688ed367a2e51cc13792ae8f08226c15f7d168589fc44b9b9cada"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:87d44e6033d4c5e95a7d39ba59b8e105ba1c29b1ccd1d215f26477cc1d64be39"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:a68cef396a7de237f7b97422a6a450dfb111722296ba217ba5b34551832f1f6e"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:06ad4c95b258141f138a93ebfdc1d76ac087afc1a82f1401100a1f44b44ba656"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:ada59a4b3c59d4ac7162e0ed08667ffa78abf48e975c8a9f9d5b9bc50720f4fd"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:a8957bcaea1ba01327a9b219d2adb84144377684f51444253890dab500ca171f"},
    {file = "cytoolz-1.1.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:6d8cdc299d67eb0f3b9ecdafeeb55eb3b7b7470e2d950ac34b05ed4c7a5572b8"},
    {file = "cytoolz-1.1.0-cp310-cp310-win32.whl", hash = "sha256:d8e08464c5cdea4f6df31e84b11ed6bfd79cedb99fbcbfdc15eb9361a6053c5a"},
    {file = "cytoolz-1.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:7e49922a7ed54262d41960bf3b835a7700327bf79cff1e9bfc73d79021132ff8"},
    {file = "cytoolz-1.1.0-cp310-cp310-win_arm64.whl", hash = "sha256:943a662d2e72ffc4438d43ab5a1de8d852237775a423236594a3b3e381b8032c"},
    {file = "cytoolz-1.1.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:dba8e5a8c6e3c789d27b0eb5e7ce5ed7d032a7a9aae17ca4ba5147b871f6e327"},
    {file = "cytoolz-1.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:44b31c05addb0889167a720123b3b497b28dd86f8a0aeaf3ae4ffa11e2c85d55"},
    {file = "cytoolz-1.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:653cb18c4fc5d8a8cfce2bce650aabcbe82957cd0536827367d10810566d5294"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:853a5b4806915020c890e1ce70cc056bbc1dd8bc44f2d74d555cccfd7aefba7d"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7b44e9de86bea013fe84fd8c399d6016bbb96c37c5290769e5c99460b9c53e5"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:098d628a801dc142e9740126be5624eb7aef1d732bc7a5719f60a2095547b485"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:779ee4096ed7a82cffab89372ffc339631c285079dbf33dbe7aff1f6174985df"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f2ce18dd99533d077e9712f9faa852f389f560351b1efd2f2bdb193a95eddde2"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ac266a34437812cf841cecbfe19f355ab9c3dd1ef231afc60415d40ff12a76e4"},
    {file = "cytoolz-1.1.0-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1920b9b9c13d60d0bb6cd14594b3bce0870022eccb430618c37156da5f2b7a55"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47caa376dafd2bdc29f8a250acf59c810ec9105cd6f7680b9a9d070aae8490ec"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:5ab2c97d8aaa522b038cca9187b1153347af22309e7c998b14750c6fdec7b1cb"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:4bce006121b120e8b359244ee140bb0b1093908efc8b739db8dbaa3f8fb42139"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7fc0f1e4e9bb384d26e73c6657bbc26abdae4ff66a95933c00f3d578be89181b"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:dd3f894ff972da1994d06ac6157d74e40dda19eb31fe5e9b7863ca4278c3a167"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:0846f49cf8a4496bd42659040e68bd0484ce6af819709cae234938e039203ba0"},
    {file = "cytoolz-1.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:16a3af394ade1973226d64bb2f9eb3336adbdea03ed5b134c1bbec5a3b20028e"},
    {file = "cytoolz-1.1.0-cp311-cp311-win32.whl", hash = "sha256:b786c9c8aeab76cc2f76011e986f7321a23a56d985b77d14f155d5e5514ea781"},
    {file = "cytoolz-1.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:ebf06d1c5344fb22fee71bf664234733e55db72d74988f2ecb7294b05e4db30c"},
    {file = "cytoolz-1.1.0-cp311-cp311-win_arm64.whl", hash = "sha256:b63f5f025fac893393b186e132e3e242de8ee7265d0cd3f5bdd4dda93f6616c9"},
    {file = "cytoolz-1.1.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:99f8e134c9be11649342853ec8c90837af4089fc8ff1e8f9a024a57d1fa08514"},
    {file = "cytoolz-1.1.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:0a6f44cf9319c30feb9a50aa513d777ef51efec16f31c404409e7deb8063df64"},
    {file = "cytoolz-1.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:945580dc158c557172fca899a35a99a16fbcebf6db0c77cb6621084bc82189f9"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:257905ec050d04f2f856854620d1e25556fd735064cebd81b460f54939b9f9d5"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:82779049f352fb3ab5e8c993ab45edbb6e02efb1f17f0b50f4972c706cc51d76"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7d3e405e435320e08c5a1633afaf285a392e2d9cef35c925d91e2a31dfd7a688"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:923df8f5591e0d20543060c29909c149ab1963a7267037b39eee03a83dbc50a8"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:25db9e4862f22ea0ae2e56c8bec9fc9fd756b655ae13e8c7b5625d7ed1c582d4"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c7a98deb11ccd8e5d9f9441ef2ff3352aab52226a2b7d04756caaa53cd612363"},
    {file = "cytoolz-1.1.0-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:dce4ee9fc99104bc77efdea80f32ca5a650cd653bcc8a1d984a931153d3d9b58"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:80d6da158f7d20c15819701bbda1c041f0944ede2f564f5c739b1bc80a9ffb8b"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:3b5c5a192abda123ad45ef716ec9082b4cf7d95e9ada8291c5c2cc5558be858b"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5b399ce7d967b1cb6280250818b786be652aa8ddffd3c0bb5c48c6220d945ab5"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:e7e29a1a03f00b4322196cfe8e2c38da9a6c8d573566052c586df83aacc5663c"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:5291b117d71652a817ec164e7011f18e6a51f8a352cc9a70ed5b976c51102fda"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:8caef62f846a9011676c51bda9189ae394cdd6bb17f2946ecaedc23243268320"},
    {file = "cytoolz-1.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:de425c5a8e3be7bb3a195e19191d28d9eb3c2038046064a92edc4505033ec9cb"},
    {file = "cytoolz-1.1.0-cp312-cp312-win32.whl", hash = "sha256:296440a870e8d1f2e1d1edf98f60f1532b9d3ab8dfbd4b25ec08cd76311e79e5"},
    {file = "cytoolz-1.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:07156987f224c6dac59aa18fb8bf91e1412f5463961862716a3381bf429c8699"},
    {file = "cytoolz-1.1.0-cp312-cp312-win_arm64.whl", hash = "sha256:23e616b38f5b3160c7bb45b0f84a8f3deb4bd26b29fb2dfc716f241c738e27b8"},
    {file = "cytoolz-1.1.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:76c9b58555300be6dde87a41faf1f97966d79b9a678b7a526fcff75d28ef4945"},
    {file = "cytoolz-1.1.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:d1d638b10d3144795655e9395566ce35807df09219fd7cacd9e6acbdef67946a"},
    {file = "cytoolz-1.1.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:26801c1a165e84786a99e03c9c9973356caaca002d66727b761fb1042878ef06"},
    {file = "cytoolz-1.1.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2a9a464542912d3272f6dccc5142df057c71c6a5cbd30439389a732df401afb7"},
    {file = "cytoolz-1.1.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ed6104fa942aa5784bf54f339563de637557e3443b105760bc4de8f16a7fc79b"},
    {file = "cytoolz-1.1.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:56161f0ab60dc4159ec343509abaf809dc88e85c7e420e354442c62e3e7cbb77"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:832bd36cc9123535f1945acf6921f8a2a15acc19cfe4065b1c9b985a28671886"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1842636b6e034f229bf084c2bcdcfd36c8437e752eefd2c74ce9e2f10415cb6e"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:823df012ab90d2f2a0f92fea453528539bf71ac1879e518524cd0c86aa6df7b9"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2f1fcf9e7e7b3487883ff3f815abc35b89dcc45c4cf81c72b7ee457aa72d197b"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4cdb3fa1772116827f263f25b0cdd44c663b6701346a56411960534a06c082de"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d1b5c95041741b81430454db65183e133976f45ac3c03454cfa8147952568529"},
    {file = "cytoolz-1.1.0-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b2079fd9f1a65f4c61e6278c8a6d4f85edf30c606df8d5b32f1add88cbbe2286"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a92a320d72bef1c7e2d4c6d875125cf57fc38be45feb3fac1bfa64ea401f54a4"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:06d1c79aa51e6a92a90b0e456ebce2288f03dd6a76c7f582bfaa3eda7692e8a5"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:e1d7be25f6971e986a52b6d3a0da28e1941850985417c35528f6823aef2cfec5"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:964b248edc31efc50a65e9eaa0c845718503823439d2fa5f8d2c7e974c2b5409"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c9ff2b3c57c79b65cb5be14a18c6fd4a06d5036fb3f33e973a9f70e9ac13ca28"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:22290b73086af600042d99f5ce52a43d4ad9872c382610413176e19fc1d4fd2d"},
    {file = "cytoolz-1.1.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a2ade74fccd080ea793382968913ee38d7a35c921df435bbf0a6aeecf0d17574"},
    {file = "cytoolz-1.1.0-cp313-cp313-win32.whl", hash = "sha256:db5dbcfda1c00e937426cbf9bdc63c24ebbc358c3263bfcbc1ab4a88dc52aa8e"},
    {file = "cytoolz-1.1.0-cp313-cp313-win_amd64.whl", hash = "sha256:9e2d3fe3b45c3eb7233746f7aca37789be3dceec3e07dcc406d3e045ea0f7bdc"},
    {file = "cytoolz-1.1.0-cp313-cp313-win_arm64.whl", hash = "sha256:32c559f95ff44a9ebcbd934acaa1e6dc8f3e6ffce4762a79a88528064873d6d5"},
    {file = "cytoolz-1.1.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:9e2cd93b28f667c5870a070ab2b8bb4397470a85c4b204f2454b0ad001cd1ca3"},
    {file = "cytoolz-1.1.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:f494124e141a9361f31d79875fe7ea459a3be2b9dadd90480427c0c52a0943d4"},
    {file = "cytoolz-1.1.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:53a3262bf221f19437ed544bf8c0e1980c81ac8e2a53d87a9bc075dba943d36f"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:47663e57d3f3f124921f38055e86a1022d0844c444ede2e8f090d3bbf80deb65"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a5a8755c4104ee4e3d5ba434c543b5f85fdee6a1f1df33d93f518294da793a60"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4d96ff3d381423af1b105295f97de86d1db51732c9566eb37378bab6670c5010"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0ec96b3d537cdf47d4e76ded199f7440715f4c71029b45445cff92c1248808c2"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:208e2f2ef90a32b0acbff3303d90d89b13570a228d491d2e622a7883a3c68148"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0d416a81bb0bd517558668e49d30a7475b5445f9bbafaab7dcf066f1e9adba36"},
    {file = "cytoolz-1.1.0-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f32e94c91ffe49af04835ee713ebd8e005c85ebe83e7e1fdcc00f27164c2d636"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:15d0c6405efc040499c46df44056a5c382f551a7624a41cf3e4c84a96b988a15"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:bf069c5381d757debae891401b88b3a346ba3a28ca45ba9251103b282463fad8"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:7d5cf15892e63411ec1bd67deff0e84317d974e6ab2cdfefdd4a7cea2989df66"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:3e3872c21170f8341656f8692f8939e8800dcee6549ad2474d4c817bdefd62cd"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:b9ddeff8e8fd65eb1fcefa61018100b2b627e759ea6ad275d2e2a93ffac147bf"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:02feeeda93e1fa3b33414eb57c2b0aefd1db8f558dd33fdfcce664a0f86056e4"},
    {file = "cytoolz-1.1.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:d08154ad45349162b6c37f12d5d1b2e6eef338e657b85e1621e4e6a4a69d64cb"},
    {file = "cytoolz-1.1.0-cp313-cp313t-win32.whl", hash = "sha256:10ae4718a056948d73ca3e1bb9ab1f95f897ec1e362f829b9d37cc29ab566c60"},
    {file = "cytoolz-1.1.0-cp313-cp313t-win_amd64.whl", hash = "sha256:1bb77bc6197e5cb19784b6a42bb0f8427e81737a630d9d7dda62ed31733f9e6c"},
    {file = "cytoolz-1.1.0-cp313-cp313t-win_arm64.whl", hash = "sha256:563dda652c6ff52d215704fbe6b491879b78d7bbbb3a9524ec8e763483cb459f"},
    {file = "cytoolz-1.1.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:d542cee7c7882d2a914a33dec4d3600416fb336734df979473249d4c53d207a1"},
    {file = "cytoolz-1.1.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:31922849b701b0f24bb62e56eb2488dcd3aa6ae3057694bd6b3b7c4c2bc27c2f"},
    {file = "cytoolz-1.1.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:e68308d32afd31943314735c1335e4ab5696110e96b405f6bdb8f2a8dc771a16"},
    {file = "cytoolz-1.1.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fc4bb48b3b866e1867f7c6411a4229e5b44be3989060663713e10efc24c9bd5f"},
    {file = "cytoolz-1.1.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:456f77207d1445025d7ef262b8370a05492dcb1490cb428b0f3bf1bd744a89b0"},
    {file = "cytoolz-1.1.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:174ebc71ebb20a9baeffce6ee07ee2cd913754325c93f99d767380d8317930f7"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:8b3604fef602bcd53415055a4f68468339192fd17be39e687ae24f476d23d56e"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3604b959a01f64c366e7d10ec7634d5f5cfe10301e27a8f090f6eb3b2a628a18"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:6db2127a3c1bc2f59f08010d2ae53a760771a9de2f67423ad8d400e9ba4276e8"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:56584745ac647993a016a21bc76399113b7595e312f8d0a1b140c9fcf9b58a27"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:db2c4c3a7f7bd7e03bb1a236a125c8feb86c75802f4ecda6ecfaf946610b2930"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:48cb8a692111a285d2b9acd16d185428176bfbffa8a7c274308525fccd01dd42"},
    {file = "cytoolz-1.1.0-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d2f344ba5eb17dcf38ee37fdde726f69053f54927db8f8a1bed6ac61e5b1890d"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:abf76b1c1abd031f098f293b6d90ee08bdaa45f8b5678430e331d991b82684b1"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:ddf9a38a5b686091265ff45b53d142e44a538cd6c2e70610d3bc6be094219032"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:946786755274f07bb2be0400f28adb31d7d85a7c7001873c0a8e24a503428fb3"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:d5b8f78b9fed79cf185ad4ddec099abeef45951bdcb416c5835ba05f0a1242c7"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:fccde6efefdbc02e676ccb352a2ccc8a8e929f59a1c6d3d60bb78e923a49ca44"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:717b7775313da5f51b0fbf50d865aa9c39cb241bd4cb605df3cf2246d6567397"},
    {file = "cytoolz-1.1.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5158744a09d0e0e4a4f82225e3a3c4ebf38f9ae74467aaa905467270e52f2794"},
    {file = "cytoolz-1.1.0-cp314-cp314-win32.whl", hash = "sha256:1ed534bdbbf063b2bb28fca7d0f6723a3e5a72b086e7c7fe6d74ae8c3e4d00e2"},
    {file = "cytoolz-1.1.0-cp314-cp314-win_amd64.whl", hash = "sha256:472c1c9a085f5ad973ec0ad7f0b9ba0969faea6f96c9e397f6293d386f3a25ec"},
    {file = "cytoolz-1.1.0-cp314-cp314-win_arm64.whl", hash = "sha256:a7ad7ca3386fa86bd301be3fa36e7f0acb024f412f665937955acfc8eb42deff"},
    {file = "cytoolz-1.1.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:64b63ed4b71b1ba813300ad0f06b8aff19a12cf51116e0e4f1ed837cea4debcf"},
    {file = "cytoolz-1.1.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:a60ba6f2ed9eb0003a737e1ee1e9fa2258e749da6477946008d4324efa25149f"},
    {file = "cytoolz-1.1.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1aa58e2434d732241f7f051e6f17657e969a89971025e24578b5cbc6f1346485"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:6965af3fc7214645970e312deb9bd35a213a1eaabcfef4f39115e60bf2f76867"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ddd2863f321d67527d3b67a93000a378ad6f967056f68c06467fe011278a6d0e"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4e6b428e9eb5126053c2ae0efa62512ff4b38ed3951f4d0888ca7005d63e56f5"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d758e5ef311d2671e0ae8c214c52e44617cf1e58bef8f022b547b9802a5a7f30"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a95416eca473e6c1179b48d86adcf528b59c63ce78f4cb9934f2e413afa9b56b"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:36c8ede93525cf11e2cc787b7156e5cecd7340193ef800b816a16f1404a8dc6d"},
    {file = "cytoolz-1.1.0-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c0c949755b6d8a649c5fbc888bc30915926f1b09fe42fea9f289e297c2f6ddd3"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e1b6d37545816905a76d9ed59fa4e332f929e879f062a39ea0f6f620405cdc27"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:05332112d4087904842b36954cd1d3fc0e463a2f4a7ef9477bd241427c593c3b"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:31538ca2fad2d688cbd962ccc3f1da847329e2258a52940f10a2ac0719e526be"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:747562aa70abf219ea16f07d50ac0157db856d447f7f498f592e097cbc77df0b"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:3dc15c48b20c0f467e15e341e102896c8422dccf8efc6322def5c1b02f074629"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:3c03137ee6103ba92d5d6ad6a510e86fded69cd67050bd8a1843f15283be17ac"},
    {file = "cytoolz-1.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:be8e298d88f88bd172b59912240558be3b7a04959375646e7fd4996401452941"},
    {file = "cytoolz-1.1.0-cp314-cp314t-win32.whl", hash = "sha256:3d407140f5604a89578285d4aac7b18b8eafa055cf776e781aabb89c48738fad"},
    {file = "cytoolz-1.1.0-cp314-cp314t-win_amd64.whl", hash = "sha256:56e5afb69eb6e1b3ffc34716ee5f92ffbdb5cb003b3a5ca4d4b0fe700e217162"},
    {file = "cytoolz-1.1.0-cp314-cp314t-win_arm64.whl", hash = "sha256:27b19b4a286b3ff52040efa42dbe403730aebe5fdfd2def704eb285e2125c63e"},
    {file = "cytoolz-1.1.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:08a63935c66488511b7b29b06233be0be5f4123622fc8fd488f28dc1b7e4c164"},
    {file = "cytoolz-1.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:93bd0afcc4cc05794507084afaefb161c3639f283ee629bd0e8654b5c0327ba8"},
    {file = "cytoolz-1.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:8f3d4da470cfd5cf44f6d682c6eb01363066e0af53ebe111225e44a618f9453d"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:ba6c12d0e6a67399f4102b4980f4f1bebdbf226ed0a68e84617709d4009b4e71"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b557071405b4aeeaa7cbec1a95d15d6c8f37622fe3f4b595311e0e226ce772c"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:cdb406001474726a47fbe903f3aba0de86f5c0b9c9861f55c09c366368225ae0"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b6072876ba56446d9ac29d349983677d6f44c6d1c6c1c6be44e66e377c57c767"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8c3784c965c9a6822d315d099c3a85b0884ac648952815891c667b469116f1d0"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0cc537ad78981df1a827773069fd3b7774f4478db43f518b1616efaf87d7d8f9"},
    {file = "cytoolz-1.1.0-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:574ee9dfdc632db8bf9237f27f2a687d1a0b90d29d5e96cab2b21fd2b419c17d"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:6594efbaea72dc58b368b53e745ad902c8d8cc41286f00b3743ceac464d5ef3f"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:7c849f9ddaf3c7faba938440f9c849235a2908b303063d49da3092a93acd695b"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:1fef0296fb3577d0a08ad9b70344ee418f728f1ec21a768ffe774437d67ac859"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:1dce1e66fdf72cc474367bd7a7f2b90ec67bb8197dc3fe8ecd08f4ce3ab950a1"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:202fe9975efaec0085cab14a6a6050418bc041f5316f2cf098c0cd2aced4c50e"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:528349434601b9d55e65c6a495494de0001c9a06b431547fea4c60b5edc7d5b3"},
    {file = "cytoolz-1.1.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:3e248cdbf2a54bafdadf4486ddd32e8352f816d3caa2014e44de99f8c525d4a8"},
    {file = "cytoolz-1.1.0-cp39-cp39-win32.whl", hash = "sha256:e63f2b70f4654648a5c6a176ae80897c0de6401f385540dce8e365019e800cfe"},
    {file = "cytoolz-1.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:f731c53ed29959f105ae622b62e39603c207ed8e8cb2a40cd4accb63d9f92901"},
    {file = "cytoolz-1.1.0-cp39-cp39-win_arm64.whl", hash = "sha256:5a2120bf9e6e8f25e1b32748424a5571e319ef03a995a8fde663fd2feec1a696"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:f32e93a55681d782fc6af939f6df36509d65122423cbc930be39b141064adff8"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:5d9bc596751cbda8073e65be02ca11706f00029768fbbbc81e11a8c290bb41aa"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:9b16660d01c3931951fab49db422c627897c38c1a1f0393a97582004019a4887"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b7de5718e2113d4efccea3f06055758cdbc17388ecc3341ba4d1d812837d7c1a"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a12a2a1a6bc44099491c05a12039efa08cc33a3d0f8c7b0566185e085e139283"},
    {file = "cytoolz-1.1.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:047defa7f5f9a32f82373dbc3957289562e8a3fa58ae02ec8e4dca4f43a33a21"},
    {file = "cytoolz-1.1.0.tar.gz", hash = "sha256:13a7bf254c3c0d28b12e2290b82aed0f0977a4c2a2bf84854fcdc7796a29f3b0"},
]

[package.dependencies]
toolz = ">=0.8.0"

[package.extras]
cython = ["cython (>=0.29)"]
test = ["pytest"]

[[package]]
name = "distro"
version = "1.9.0"
description = "Distro - an OS platform information API"
optional = false
python-versions = ">=3.6"
groups = ["main"]
files = [
    {file = "distro-1.9.0-py3-none-any.whl", hash = "sha256:7bffd925d65168f85027d8da9af6bddab658135b840670a223589bc0c8ef02b2"},
    {file = "distro-1.9.0.tar.gz", hash = "sha256:2fa77c6fd8940f116ee1d6b94a2f90b13b5ea8d019b98bc8bafdcabcdd9bdbed"},
]

[[package]]
name = "docstring-parser"
version = "0.18.0"
description = "Parse Python docstrings in reST, Google and Numpydoc format"
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "docstring_parser-0.18.0-py3-none-any.whl", hash = "sha256:b3fcbed555c47d8479be0796ef7e19c2670d428d72e96da63f3a40122860374b"},
    {file = "docstring_parser-0.18.0.tar.gz", hash = "sha256:292510982205c12b1248696f44959db3cdd1740237a968ea1e2e7a900eeb2015"},
]

[package.extras]
dev = ["pre-commit (>=2.16.0) ; python_version >= \"3.9\"", "pydoctor (>=25.4.0)", "pytest"]
docs = ["pydoctor (>=25.4.0)"]
test = ["pytest"]

[[package]]
name = "eth-abi"
version = "5.2.0"
description = "eth_abi: Python utilities for working with Ethereum ABI definitions, especially encoding and decoding"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "eth_abi-5.2.0-py3-none-any.whl", hash = "sha256:17abe47560ad753f18054f5b3089fcb588f3e3a092136a416b6c1502cb7e8877"},
    {file = "eth_abi-5.2.0.tar.gz", hash = "sha256:178703fa98c07d8eecd5ae569e7e8d159e493ebb6eeb534a8fe973fbc4e40ef0"},
]

[package.dependencies]
eth-typing = ">=3.0.0"
eth-utils = ">=2.0.0"
parsimonious = ">=0.10.0,<0.11.0"

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "eth-hash[pycryptodome]", "hypothesis (>=6.22.0,<6.108.7)", "ipython", "mypy (==1.10.0)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-pythonpath (>=0.7.1)", "pytest-timeout (>=2.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["eth-hash[pycryptodome]", "hypothesis (>=6.22.0,<6.108.7)", "pytest (>=7.0.0)", "pytest-pythonpath (>=0.7.1)", "pytest-timeout (>=2.0.0)", "pytest-xdist (>=2.4.0)"]
tools = ["hypothesis (>=6.22.0,<6.108.7)"]

[[package]]
name = "eth-account"
version = "0.13.7"
description = "eth-account: Sign Ethereum transactions and messages with local private keys"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "eth_account-0.13.7-py3-none-any.whl", hash = "sha256:39727de8c94d004ff61d10da7587509c04d2dc7eac71e04830135300bdfc6d24"},
    {file = "eth_account-0.13.7.tar.gz", hash = "sha256:5853ecbcbb22e65411176f121f5f24b8afeeaf13492359d254b16d8b18c77a46"},
]

[package.dependencies]
bitarray = ">=2.4.0"
ckzg = ">=2.0.0"
eth-abi = ">=4.0.0b2"
eth-keyfile = ">=0.7.0,<0.9.0"
eth-keys = ">=0.4.0"
eth-rlp = ">=2.1.0"
eth-utils = ">=2.0.0"
hexbytes = ">=1.2.0"
pydantic = ">=2.0.0"
rlp = ">=1.0.0"

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "coverage", "hypothesis (>=6.22.0,<6.108.7)", "ipython", "mypy (==1.10.0)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["coverage", "hypothesis (>=6.22.0,<6.108.7)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "eth-hash"
version = "0.8.0"
description = "eth-hash: The Ethereum hashing function, keccak256, sometimes (erroneously) called sha3"
optional = false
python-versions = "<4,>=3.10"
groups = ["main"]
files = [
    {file = "eth_hash-0.8.0-py3-none-any.whl", hash = "sha256:523718a51b369ab89866b929a5c93c52978cd866ea309192ad980dd8271f9fac"},
    {file = "eth_hash-0.8.0.tar.gz", hash = "sha256:b009752b620da2e9c7668014849d1f5fadbe4f138603f1871cc5d4ca706896b1"},
]

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "ipython", "mypy (==1.18.2)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel (>=0.38.1)"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
pycryptodome = ["pycryptodome (>=3.6.6,<4)"]
pysha3 = ["pysha3 (>=1.0.0,<2.0.0) ; python_version < \"3.9\"", "safe-pysha3 (>=1.0.0) ; python_version >= \"3.9\""]
test = ["pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "eth-keyfile"
version = "0.8.1"
description = "eth-keyfile: A library for handling the encrypted keyfiles used to store ethereum private keys"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "eth_keyfile-0.8.1-py3-none-any.whl", hash = "sha256:65387378b82fe7e86d7cb9f8d98e6d639142661b2f6f490629da09fddbef6d64"},
    {file = "eth_keyfile-0.8.1.tar.gz", hash = "sha256:9708bc31f386b52cca0969238ff35b1ac72bd7a7186f2a84b86110d3c973bec1"},
]

[package.dependencies]
eth-keys = ">=0.4.0"
eth-utils = ">=2"
pycryptodome = ">=3.6.6,<4"

[package.extras]
dev = ["build (>=0.9.0)", "bumpversion (>=0.5.3)", "ipython", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "towncrier (>=21,<22)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["towncrier (>=21,<22)"]
test = ["pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "eth-keys"
version = "0.7.0"
description = "eth-keys: Common API for Ethereum key operations"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "eth_keys-0.7.0-py3-none-any.whl", hash = "sha256:b0cdda8ffe8e5ba69c7c5ca33f153828edcace844f67aabd4542d7de38b159cf"},
    {file = "eth_keys-0.7.0.tar.gz", hash = "sha256:79d24fd876201df67741de3e3fefb3f4dbcbb6ace66e47e6fe662851a4547814"},
]

[package.dependencies]
eth-typing = ">=3"
eth-utils = ">=2"

[package.extras]
coincurve = ["coincurve (>=17.0.0)"]
dev = ["asn1tools (>=0.146.2)", "build (>=0.9.0)", "bump_my_version (>=0.19.0)", "coincurve (>=17.0.0)", "eth-hash[pysha3]", "factory-boy (>=3.0.1)", "hypothesis (>=5.10.3)", "ipython", "mypy (==1.10.0)", "pre-commit (>=3.4.0)", "pyasn1 (>=0.4.5)", "pytest (>=7.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["towncrier (>=24,<25)"]
test = ["asn1tools (>=0.146.2)", "eth-hash[pysha3]", "factory-boy (>=3.0.1)", "hypothesis (>=5.10.3)", "pyasn1 (>=0.4.5)", "pytest (>=7.0.0)"]

[[package]]
name = "eth-rlp"
version = "2.2.0"
description = "eth-rlp: RLP definitions for common Ethereum objects in Python"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "eth_rlp-2.2.0-py3-none-any.whl", hash = "sha256:5692d595a741fbaef1203db6a2fedffbd2506d31455a6ad378c8449ee5985c47"},
    {file = "eth_rlp-2.2.0.tar.gz", hash = "sha256:5e4b2eb1b8213e303d6a232dfe35ab8c29e2d3051b86e8d359def80cd21db83d"},
]

[package.dependencies]
eth-utils = ">=2.0.0"
hexbytes = ">=1.2.0"
rlp = ">=0.6.0"

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "eth-hash[pycryptodome]", "ipython", "mypy (==1.10.0)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["eth-hash[pycryptodome]", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "eth-typing"
version = "6.0.0"
description = "eth-typing: Common type annotations for ethereum python packages"
optional = false
python-versions = "<4,>=3.10"
groups = ["main"]
files = [
    {file = "eth_typing-6.0.0-py3-none-any.whl", hash = "sha256:ee74fb641eb36dd885e1c42c2a3055314efa532b3e71480816df70a94d35cfb9"},
    {file = "eth_typing-6.0.0.tar.gz", hash = "sha256:315dd460dc0b71c15a6cd51e3c0b70d237eec8771beb844144f3a1fb4adb2392"},
]

[package.dependencies]
typing_extensions = ">=4.5.0"

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "ipython", "mypy (==1.18.2)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel (>=0.38.1)"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "eth-utils"
version = "6.0.0"
description = "eth-utils: Common utility functions for python code that interacts with Ethereum"
optional = false
python-versions = "<4,>=3.10"
groups = ["main"]
files = [
    {file = "eth_utils-6.0.0-py3-none-any.whl", hash = "sha256:63cf48ee32c45541cb5748751909a8345c470432fb6f0fed4bd7c53fd6400469"},
    {file = "eth_utils-6.0.0.tar.gz", hash = "sha256:eb54b2f82dd300d3142c49a89da195e823f5e5284d43203593f87c67bad92a96"},
]

[package.dependencies]
cytoolz = {version = ">=0.10.1", markers = "implementation_name == \"cpython\""}
eth-hash = ">=0.3.1"
eth-typing = ">=5.0.0"
pydantic = ">=2.0.0,<3"
toolz = {version = ">0.8.2", markers = "implementation_name == \"pypy\""}

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "eth-hash[pycryptodome]", "hypothesis (>=4.43.0)", "ipython", "mypy (==1.18.2)", "mypy (==1.18.2)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel (>=0.38.1)"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["hypothesis (>=4.43.0)", "mypy (==1.18.2)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "fakeredis"
version = "2.37.0"
description = "Python implementation of redis API, can be used for testing purposes."
optional = false
python-versions = ">=3.7"
groups = ["dev"]
files = [
    {file = "fakeredis-2.37.0-py3-none-any.whl", hash = "sha256:657a2a695a1123be0c13f98db409371497bd94c29d260dd76a9fc7ce1a633745"},
    {file = "fakeredis-2.37.0.tar.gz", hash = "sha256:7461f124dcba04a80691d72270b3d1d5cd100ef14dc068c76db825940f3ed799"},
]

[package.dependencies]
redis = {version = ">=4.3", markers = "python_version > \"3.8\""}
sortedcontainers = ">=2"

[package.extras]
bf = ["pyprobables (>=0.6)"]
cf = ["pyprobables (>=0.6)"]
json = ["jsonpath-ng (>=1.6)"]
lua = ["lupa (>=2.1)"]
probabilistic = ["pyprobables (>=0.6)"]
valkey = ["valkey (>=6) ; python_version >= \"3.8\""]
vectorset = ["jsonpath-ng (>=1.6) ; python_version >= \"3.11\"", "numpy (>=2.4.0) ; python_version >= \"3.11\""]

[[package]]
name = "fastapi"
version = "0.140.13"
description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "fastapi-0.140.13-py3-none-any.whl", hash = "sha256:8b017110e1e9f30a95e8bdb8f71fbe2f0fe3af5717109e5b14f9e069df54f6d4"},
    {file = "fastapi-0.140.13.tar.gz", hash = "sha256:500172a08cf1459901f90b05c37d93060dada3b573fec8f0862445db52ba6b4b"},
]

[package.dependencies]
annotated-doc = ">=0.0.2"
pydantic = ">=2.9.0"
starlette = ">=0.46.0"
typing-extensions = ">=4.8.0"
typing-inspection = ">=0.4.2"

[package.extras]
all = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "itsdangerous (>=1.1.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "pyyaml (>=5.3.1)", "uvicorn[standard] (>=0.12.0)"]
standard = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "fastar (>=0.9.0)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
standard-no-fastapi-cloud-cli = ["email-validator (>=2.0.0)", "fastapi-cli[standard-no-fastapi-cloud-cli] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]

[[package]]
name = "h11"
version = "0.16.0"
description = "A pure-Python, bring-your-own-I/O implementation of HTTP/1.1"
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86"},
    {file = "h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1"},
]

[[package]]
name = "hexbytes"
version = "1.3.1"
description = "hexbytes: Python `bytes` subclass that decodes hex, with a readable console output"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "hexbytes-1.3.1-py3-none-any.whl", hash = "sha256:da01ff24a1a9a2b1881c4b85f0e9f9b0f51b526b379ffa23832ae7899d29c2c7"},
    {file = "hexbytes-1.3.1.tar.gz", hash = "sha256:a657eebebdfe27254336f98d8af6e2236f3f83aed164b87466b6cf6c5f5a4765"},
]

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "eth_utils (>=2.0.0)", "hypothesis (>=3.44.24)", "ipython", "mypy (==1.10.0)", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
test = ["eth_utils (>=2.0.0)", "hypothesis (>=3.44.24)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "httpcore"
version = "1.0.9"
description = "A minimal low-level HTTP client."
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55"},
    {file = "httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8"},
]

[package.dependencies]
certifi = "*"
h11 = ">=0.16"

[package.extras]
asyncio = ["anyio (>=4.0,<5.0)"]
http2 = ["h2 (>=3,<5)"]
socks = ["socksio (==1.*)"]
trio = ["trio (>=0.22.0,<1.0)"]

[[package]]
name = "httptools"
version = "0.8.0"
description = "A collection of framework independent HTTP protocol utils."
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "httptools-0.8.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:bf3b6f807c8541503cecfbb8a8dffb385640d0d96102f3d112aa8740f9b7c826"},
    {file = "httptools-0.8.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:da684f2e1aa2ee9bdcb083f3f3a68c5956750b375bc5df864d3a5f0c42a40b77"},
    {file = "httptools-0.8.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:a6f21e2a3b0067bbe7f67e34cfd16276af556e5e52f4c7503be0cb5f90e905e4"},
    {file = "httptools-0.8.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ea897f0c729581ebf72131a438a7932d9b14efef72d75ada966700cac3caaeb"},
    {file = "httptools-0.8.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:c0d726cc107fceb7d45f978483b4b70dd8caa836f5914d3434bb18628eb73813"},
    {file = "httptools-0.8.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9878eb2785ba5eb70631ad269b37976f73d647955e26c91d490eb8a4edfda4ba"},
    {file = "httptools-0.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:b205e5f5523fa039679da0dfe5a10132b2a4abeae6a86fdd1ddc035f7f836557"},
    {file = "httptools-0.8.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ed377e64805bdba4943c82717333f8f8603a13b09aff9cead2717c6c817fb168"},
    {file = "httptools-0.8.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:9518c406d7b310f05adb1a37f80acabac40504a575d7c0da6d3e365c695ac20d"},
    {file = "httptools-0.8.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:57278e6fa0424c42a8a3e454828ab4f0aff27b40cddf9679579b98c6dce6a376"},
    {file = "httptools-0.8.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bbb8caadb2b742d293169d2b458b5c001ef70e3158704aa3d3ef9597624c5d1d"},
    {file = "httptools-0.8.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:52dd695b865fe96d9d2b16b64a895f3f57bf3cb064e8383cd3b5713a069e8085"},
    {file = "httptools-0.8.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:20b4aac66ff65f7db06a375808b78f42a94970aa22e826b3cb2b43eb09174124"},
    {file = "httptools-0.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:a1b4c8e7a489a0d750d91894e9a8cdc295838f1924c0ca903ae993456fddec07"},
    {file = "httptools-0.8.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:880490234c10f70a9830743097e8958d6e4b9f5a0ffc24515023afeef984054d"},
    {file = "httptools-0.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5931891fb7b441b8a3853cf1b85c82c903defce084dd5f6771ca46e31bf862c5"},
    {file = "httptools-0.8.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b15fc622b0f869d19207c4089a501d9bcc63ca5e071ffdd2f03f922df882dcb2"},
    {file = "httptools-0.8.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:425f83884fd6343828d8c565f046cb72b6d19063f6924093e11bcd8e1548cd09"},
    {file = "httptools-0.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ef7c3c97f4311c7be57e2986629df89d49cb434dbff78eafcd48c2bff986b15a"},
    {file = "httptools-0.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a1afd7c9fbff0d9f5d489c4ce2768bd09c84a46ddefc7161e6aa82ae35c85745"},
    {file = "httptools-0.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:cd96f29b4bab1d42fa6e3d008711c75e0f79e94e06827330160e3a304227f150"},
    {file = "httptools-0.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:614ceea8ea606848bece2338ac03b3ce5324bcb4be8dc7d377ed708012fa4db8"},
    {file = "httptools-0.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2d689918c15a013c65ef52d9fd495d766893ab831a2c8d89f2ac5940a5df847c"},
    {file = "httptools-0.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:eb3028cca2fc0a6d720e52ef61d8ebb62fcbfeb1de56874546d858d3f25a26b7"},
    {file = "httptools-0.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:88bdd940f2b5d487b4d032c6afa5489a7dc4694410d43de3c38c4fb3af0dc45d"},
    {file = "httptools-0.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6a43c9dd399758ccc0531acb0a3c4a6c299ee893ee9400e9c893b7bdcfae0681"},
    {file = "httptools-0.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:0770728beb05094c809b98e814edff5fef69d26ad7d21185f2f6d5884a0ba683"},
    {file = "httptools-0.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:7685df791fad561384bfb139e77fde27a1ffd93134e016f95a0db424ffbf77b1"},
    {file = "httptools-0.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:de242a49b5d18e0a8776e654e9f6bf6d89f3875a5c35b425a0e7ce940feb3fd6"},
    {file = "httptools-0.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:159e9ab5f701ccd42e555a12f1ad8ff69702910fc1c996cf2bb66e5fcb7a231b"},
    {file = "httptools-0.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c4a9f1707e4823d54dfec6c33fa3697d302aed536ed352a7ebb5a061ddb869d0"},
    {file = "httptools-0.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d76ad7b951387e3632c8716a9bb03ac5b45c5f16119aa409db0459520887944e"},
    {file = "httptools-0.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a3b7387147361c3fd47a0bde763c5c91b5b4cd4dc9989b8ece84ff436c99843b"},
    {file = "httptools-0.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f256d6ce930c52ca1cb2a960b7da03548c454e7d28b06059ad41bfe789036ce0"},
    {file = "httptools-0.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:19d1ee275bb59ba2643ba9a3a1e51cc0c788caf2b8df506368e03f56fdd08527"},
    {file = "httptools-0.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:de1ed58a974e75d56560acc7e7fed01a454994429456f65209789992e41f2568"},
    {file = "httptools-0.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e93c227b595c6926c1acee96891dd9da4be338cfbe82e5cd3bb9d8dd7dc4ac0b"},
    {file = "httptools-0.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:2a021c3a8e65cc125390d72f59b968afca3bdcaff25bd67965e0a055a14946ca"},
    {file = "httptools-0.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48774d39cbb70e2b1f71f88852a3087ae1d3a1eb80482bb48c13067ab080c14f"},
    {file = "httptools-0.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:88eead8ec8680a9f146c655bc88445a325bd7921cfd8194c7337e9467282427d"},
    {file = "httptools-0.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2c032fa028f46871ec7e1fc59fc15e8023eab3e6bbe6ece786a1611719a5d081"},
    {file = "httptools-0.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:384c17174464c8e873398b7af24f0b1f44d992c820328413951a625323155d77"},
    {file = "httptools-0.8.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:df31ef5494f406ab6cf827b7e64a22841c6e2d654100e6a116ea15b46d02d5e8"},
    {file = "httptools-0.8.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:5eb911c515b96ee44bbd861e42cbefc488681d450545b1d02127f6136e3a86f5"},
    {file = "httptools-0.8.0-cp39-cp39-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:c08ffe3e79756e0963cbc8fe410139f38a5884874b6f2e17761bef6563fdcd9b"},
    {file = "httptools-0.8.0-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fe2a4c95aeba2209434e7b31172da572846cae8ca0bf1e7013e61b99fbbf5e72"},
    {file = "httptools-0.8.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:7b71e7d7031928c650e1006e6c03e911bf967f7c69c011d37d541c3e7bf55005"},
    {file = "httptools-0.8.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:9fc1644f415372cec4f8a5be3a64183737398f10dbb1263602a036427fe75247"},
    {file = "httptools-0.8.0-cp39-cp39-win_amd64.whl", hash = "sha256:5d7fa4ba7292c1139c0526f0b5aad507c6263c948206ea1b1cbca015c8af1b62"},
    {file = "httptools-0.8.0.tar.gz", hash = "sha256:6b2a32f18d97e16e90827d7a819ffa8dbd8cc245fc4e1fa9d1095b54ef4bd999"},
]

[[package]]
name = "httpx"
version = "0.28.1"
description = "The next generation HTTP client."
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad"},
    {file = "httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc"},
]

[package.dependencies]
anyio = "*"
certifi = "*"
httpcore = "==1.*"
idna = "*"

[package.extras]
brotli = ["brotli ; platform_python_implementation == \"CPython\"", "brotlicffi ; platform_python_implementation != \"CPython\""]
cli = ["click (==8.*)", "pygments (==2.*)", "rich (>=10,<14)"]
http2 = ["h2 (>=3,<5)"]
socks = ["socksio (==1.*)"]
zstd = ["zstandard (>=0.18.0)"]

[[package]]
name = "idna"
version = "3.18"
description = "Internationalized Domain Names in Applications (IDNA)"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "idna-3.18-py3-none-any.whl", hash = "sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2"},
    {file = "idna-3.18.tar.gz", hash = "sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848"},
]

[package.extras]
all = ["mypy (>=1.11.2)", "pytest (>=8.3.2)", "ruff (>=0.6.2)"]

[[package]]
name = "iniconfig"
version = "2.3.0"
description = "brain-dead simple config-ini parsing"
optional = false
python-versions = ">=3.10"
groups = ["dev"]
files = [
    {file = "iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12"},
    {file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
]

[[package]]
name = "jiter"
version = "0.16.0"
description = "Fast iterable JSON parser."
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "jiter-0.16.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:c5fc4f8def331036a7b8e981b4347ebe409981edbc8308a5ea842b8c3614fa6c"},
    {file = "jiter-0.16.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5a71d0d2014c3275043e1170bf3d4e771493cb0dcf07be54c567155f4d8ee64b"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:741eed508c233a76313a1c7b001f8f21b82f14327e9196ae8bd29a2cc164ae84"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3fb7bc819187b56dc48aa5c833aaf92257da8e07efdb9306156667bd2eeb491c"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7c9610fd25ebccb43fca584136f5c2fbb26802447eccd430dfdbab95a0fd5126"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4a1d68ff7ca1d3b5dee20a97a3decda7d5f15003823bf6d140c81f8561d3bc5c"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fb08c276dd02dac3a284acdd02cacc630d2e3cd6572a4b85519f35cbd133c3de"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:8fc4d94713c4697347e38faf7d6ef91547c142219bdcfc7220c4870879974244"},
    {file = "jiter-0.16.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a0f05e229edb29e68cdd0ccb83cea13b64263416120cf943767a6fd72e6787f"},
    {file = "jiter-0.16.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:2c842cbf374a8daf50b2c04212995bee34ca2ac2cdc29a901b4cdb072c9c4131"},
    {file = "jiter-0.16.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:5ed466aee31294d7cdcd4d37dfe5c42c97bc29d9a5f00eacf24504358309cb9b"},
    {file = "jiter-0.16.0-cp310-cp310-win32.whl", hash = "sha256:b42e9ff5376819c053da25809a8d4b6fa6e473b4856ebe42e298ac958be3d7f9"},
    {file = "jiter-0.16.0-cp310-cp310-win_amd64.whl", hash = "sha256:10438939205546132189c8e74a2d536a707841f3a25cd7c74ee91fe503407a26"},
    {file = "jiter-0.16.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:67fddeda1688f0cce2d2ae83ccf8a80f79936f2d2997d6cc2261f82fdb54a4d3"},
    {file = "jiter-0.16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c90c0f63df322be920eda6ce622e3083d8906ba267f8220fe7873213b8b4430e"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:64c0203212098470032aabcde9356fc168f377aade3e43def61dfe17e92f2037"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:12288303c9844e61e1651d02a9a6f6633e47d39f897d6991d1427161ce6b746e"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cf109d010b4b05a105afb3d43be36a21322d345ad3111e13d15f680afef0e5b"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:62c1b7fe1f77925acf5af68b6140b8810fa87dfd4dc0a9c8568ec2fa2a10429c"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8597d23c87f59294f83bcb6229b9ed1fccee13dbba967b46930d2f1759466fee"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:3126a5dbad56401989ac769aca0cb56005bfb3e2366eea0ca99d1a91c3c1ee03"},
    {file = "jiter-0.16.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c4b4717bdb35ae456f831a6b08d01880fff399887a6bbc526a583a406e484eea"},
    {file = "jiter-0.16.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:adff21bc78edfe086c15eb495b900306076de378dc2337c132401fc39bd79c91"},
    {file = "jiter-0.16.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:dab907db06fc593645e73109acf4581ba5b548897d28b9348dc41ddc8343b2d3"},
    {file = "jiter-0.16.0-cp311-cp311-win32.whl", hash = "sha256:560b2cf3fb03240cd34f27409a238547488708f05b7c3924f571a60422251ec7"},
    {file = "jiter-0.16.0-cp311-cp311-win_amd64.whl", hash = "sha256:e431cfc9caf44c1d5459ff77d4e64cbf85fddb6a35dad836a15c6a9ec23087c1"},
    {file = "jiter-0.16.0-cp311-cp311-win_arm64.whl", hash = "sha256:2a8e9e39cf083016137aa5cadafe3188adc2ba6ba1fbf1e5d18889ad3e9ad056"},
    {file = "jiter-0.16.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:67c3bc1760f8c99d805dcab4e644027142a53b1d5d861f18780ebdbd5d40b72a"},
    {file = "jiter-0.16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5af7780e4a26bd7d0d989592bf9ef12ebf806b74ab709223ecca37c749872ea9"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d5bf78d0e05e45cfdd66558893938d59afe3d1b1a824a202039b20e607d25a72"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f4444a83f946605990c98f625cdd3d2725bfb818158760c5748c653170a20e0e"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3a23f0e4f957e1be65752d2dfac9a5a06b1917af8dc85deb639c3b9d02e31290"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c22a488f7b9218e245a0025a9ba6b100e2e54700831cf4cf16833a27fba3ad01"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:46add52f4ad47a08bfb1219f3e673da972191489a33016edefdb5ea55bfa8c48"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:9c8a956fd72c2cf1e730d01ea080341f13aa0a97a4a33b51abebe725b7ae9ca9"},
    {file = "jiter-0.16.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:561926e0573ffe4a32498420a76d64b16c513e1ab413b9d28158a8764ac701e5"},
    {file = "jiter-0.16.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:44d019fa8cdaf89bf29c71b39e3712143fdd0ac76725c6ef954f9957a5ea8730"},
    {file = "jiter-0.16.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:0df91907609837f33341b8e6fe73b95991fdaa57caf1a0fbd343dffe826f386f"},
    {file = "jiter-0.16.0-cp312-cp312-win32.whl", hash = "sha256:51d7b836acb0108d7c77df1742332cac2a1fa04a74d6dacec46e7091f0e91274"},
    {file = "jiter-0.16.0-cp312-cp312-win_amd64.whl", hash = "sha256:1878349266f8ee36ecb1375cc5ba2f115f35fd9f0a1a4119e725e379126647f7"},
    {file = "jiter-0.16.0-cp312-cp312-win_arm64.whl", hash = "sha256:2ed5738ae4af18271a51a528b8811b0cbfa4a1858de9d83359e4169855d6a331"},
    {file = "jiter-0.16.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:41977aa5654023948c2dae2a81cbf9c43343954bef1cd59a154dd15a4d84c195"},
    {file = "jiter-0.16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d28bb3c26762358dadf3e5bf0bccd29ae987d65e6988d2e6f49829c76b003c09"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0542a7189c26920778658fc8fcf2af8bae05bae9924577f71804acef37996536"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8fb8de1e23a0cb2a7f53c335049c7b72b6db41aa6227cdcc0972a1de5cb39450"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b72d0b2990ca754a9102779ac98d8597b7cb31678958562214a007f909eab78e"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d5f91b1c27fc22a57993d5a5cb8a627cb8ed4b10502716fac1ffbfe1d19d84e8"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c682bea068a90b764577bdb78a60a4c1d1606daf9cd4c893832a37c7cc9d9026"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:8d031aabecc4f1b6276adfb42e3aabb77c89d468bf616600e8d3a11328929053"},
    {file = "jiter-0.16.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:eab2cd170150e70153de16896a1774e3a1dca80154c56b54d7a812c479a7165e"},
    {file = "jiter-0.16.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:6edb63a46e65a82c26800a868e49b2cac30dd5a4218b88d74bc2c848c8ad60bb"},
    {file = "jiter-0.16.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:659039cc50b5addcc35fcc87ae2c1833b7c0a8e5326ef631a75e4478447bcf84"},
    {file = "jiter-0.16.0-cp313-cp313-win32.whl", hash = "sha256:c9c53be232c2e206ef9cdbad81a48bfa74c3d3f08bcf8124630a8a748aad993e"},
    {file = "jiter-0.16.0-cp313-cp313-win_amd64.whl", hash = "sha256:baad945ed47f163ad833314f8e3288c396118934f94e7bbb9e243ce4b341a4fd"},
    {file = "jiter-0.16.0-cp313-cp313-win_arm64.whl", hash = "sha256:3c1fd2dbe1b0af19e987f03fe66c5f5bd105a2229c1aff4ab14890b24f41d21a"},
    {file = "jiter-0.16.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:b2c61484666ad42726029af0c00ef4541f0f3b5cdc550221f56c2343208018ee"},
    {file = "jiter-0.16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:63efadc657488f45db1c676d81e704cac2abf3fdb892def1faea61db053127e2"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cf0d73f50e7b6935677854f6e8e31d499ca7064dd24734f703e060f5b237d883"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bf3ea07d9bc8e7d03a9fbc051295462e6dbc295b894fd72457c3136e3e43d898"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:26798522707abb47d767db536e4148ceac1b14446bf028ee85e579a2e043cfe5"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bc837c1b9631be10abfe0191537fe8009838204cec7e44827401ace390ddb567"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:49060fd70737fad59d33ba9dcc0d83247dc9e77187de26053a19c16c9f32bd69"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:adbb8edeadd431bc4477879d5d371ece7cb1334486584e0f252656dd7ffada29"},
    {file = "jiter-0.16.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:31aaee5b80f672c1dc21272bcfb9cbdcfc1ea04ff50f00ed5af500b80c44fa93"},
    {file = "jiter-0.16.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:6722bcef4ffc86c835574b1b2fac6b33b9fb4a889c781e67950e891591f3c55a"},
    {file = "jiter-0.16.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:5ab4f50ff971b611d656554ea10b75f80097392c827bc32923c6eeb6386c8b00"},
    {file = "jiter-0.16.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:710cc51d4ebdcd3c1f70b232c1db1ea1344a075770422bbd4bede5708335acbe"},
    {file = "jiter-0.16.0-cp314-cp314-win32.whl", hash = "sha256:57b37fc887a32d44798e4d8ebfa7c9683ff3da1d5bf38f08d1bb3573ccb39106"},
    {file = "jiter-0.16.0-cp314-cp314-win_amd64.whl", hash = "sha256:cbd18dd5e2df96b580487b5745adf57ef64ad89ba2d9662fc3c19386acce7db8"},
    {file = "jiter-0.16.0-cp314-cp314-win_arm64.whl", hash = "sha256:a32d2027a9fa67f109ff245a3252ece3ccc32cc56703e1deab6cc846a59e0585"},
    {file = "jiter-0.16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2577196f4474ef3fc4779a088a23b0897bbf86f9ea3679c372d45b8383b43207"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:616e89e008a93c01104161c75b4988e58716b01d62307ebfe161e52a56d2a818"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0e2e9efbe042210df657bade597f66d6d75723e3d8f45a12ea6d8167ff8bbce3"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3f4d9e473a5ce7d27fef8b848df4dc16e283893d3f53b4a585e72c9595f3c284"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8d30a4a1c87713060c8d1cc59a7b6c8fb6b8ef0a6900368014c76c87922a2929"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bae96332410f866e5900d809298b1ed82735932986c672495f9701daacd80620"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:da3d7ec75dc83bb18bca888b5edfae0656a26849056c59e05a7728badd17e7af"},
    {file = "jiter-0.16.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ee6162b77d49a9939229df666dfa8af3e656b6701b54c4c84966d740e189264e"},
    {file = "jiter-0.16.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:63ffdbdae7d4499f4cda14eadc12ddcabef0fc0c081191bdc2247489cb698077"},
    {file = "jiter-0.16.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a111256a7193bea0759267b10385e5870949c239ed7b6ddbaaf57573edb38734"},
    {file = "jiter-0.16.0-cp314-cp314t-win32.whl", hash = "sha256:de5ba8763e56b793561f43bed197c9ea55776daa5e9a6b91eed68a909bc9cdbf"},
    {file = "jiter-0.16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b8a3f9a6008048fe9def7bf465180564a6e458047d2ce499149cfbe73c3ae9db"},
    {file = "jiter-0.16.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0fa25b09b13075c46f5bc174f2690525a925a4fc2f7c82969a2bbabff22386ce"},
    {file = "jiter-0.16.0-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:d8f80521644426d451e70f00c7974240cab8f6ee088aedaa9af2697153ab7805"},
    {file = "jiter-0.16.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3b21b412b899fd8bd51a3046934b59a3bb068b79f70a5c6010053ac77cc53f0c"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0758ab7747a984797cf048e8eedea1d8ef39d7994b25611daf5b48fc903e8873"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9ec553a99b0987efd7a3645a1a825cf29c224e494db267a83369fcc8da9aeda5"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f3bd327cdfa118bc1ce69c214c2678571d5bd39b8ccd0ebf43a54db00541ba9a"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:26d122613ada2b708eb714695446f40fce5bdf2edb4b02116dec62faa62dfab3"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e03a5f21a5ce96a9441b8cb32719a8b88ed5388f53e0f339c5bcf54f1317f9d0"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_31_riscv64.whl", hash = "sha256:a5c54ef4ff776d9675837ef535b3308d6e31c208d43ebc44a0f7ab8a208c68f7"},
    {file = "jiter-0.16.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b1e7923093a376d93c6eb507c77045ae258d689ba577392846a1b3f10d0b09a9"},
    {file = "jiter-0.16.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:2a0d46ef67cc58d906a6132dd3040ca70ae4f0b0d7c9c052fe432c658a69b3f6"},
    {file = "jiter-0.16.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:70a490b55634dc0d2606ce8a8e01b1d62459011beb368d15d76e1eaf62460e3d"},
    {file = "jiter-0.16.0-cp39-cp39-win32.whl", hash = "sha256:9acf1b2faec82d998811ecce7ae84d9005e53410773e9d37d61cdc424ba4581b"},
    {file = "jiter-0.16.0-cp39-cp39-win_amd64.whl", hash = "sha256:491e7d072a253b156fff46b78bceac4652a697aa8d7082c9c18c03d7b7917d24"},
    {file = "jiter-0.16.0-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:850ccb1d7eedb4200f4014b1c0e8a577de114fc3cd88faad646dcc9bc4bb12ad"},
    {file = "jiter-0.16.0-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:e34e97bda77eb63242a410243c071e28ac7e0d8c0948c5ee658498690a4b2f2f"},
    {file = "jiter-0.16.0-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b7dc85ea77d4abbae8bad0d3538678aedee75bceec4e2f6c8dfb1c74772e5aa5"},
    {file = "jiter-0.16.0-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:17ca7fae79f6d99cd9a042b75f917eaada7b895cfc7dd2ee3a16089dcaec7a85"},
    {file = "jiter-0.16.0-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:f17d61a28b4b3e0e3e2ba98490c70501403b4d196f78732439160e7fd3678127"},
    {file = "jiter-0.16.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:96e38eea538c8ddf853a35727c7be0741c76c13f04148ac5c116222f50ece3b3"},
    {file = "jiter-0.16.0-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d284fb8d94d5855d60c44fefcab4bf966f1da6fada73992b01f6f0c9bc0c6702"},
    {file = "jiter-0.16.0-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:64d613743df53199b1aa256a7d328340da6d7078aac7705a7db9d7a791e9cfd2"},
    {file = "jiter-0.16.0.tar.gz", hash = "sha256:7b24c3492c5f4f84a37946ad9cf504910cf6a782d6a4e0689b6673c5894b4a1c"},
]

[[package]]
name = "jsonpatch"
version = "1.33"
description = "Apply JSON-Patches (RFC 6902)"
optional = false
python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*"
groups = ["main"]
files = [
    {file = "jsonpatch-1.33-py2.py3-none-any.whl", hash = "sha256:0ae28c0cd062bbd8b8ecc26d7d164fbbea9652a1a3693f3b956c1eae5145dade"},
    {file = "jsonpatch-1.33.tar.gz", hash = "sha256:9fcd4009c41e6d12348b4a0ff2563ba56a2923a7dfee731d004e212e1ee5030c"},
]

[package.dependencies]
jsonpointer = ">=1.9"

[[package]]
name = "jsonpointer"
version = "3.1.1"
description = "Identify specific nodes in a JSON document (RFC 6901) "
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "jsonpointer-3.1.1-py3-none-any.whl", hash = "sha256:8ff8b95779d071ba472cf5bc913028df06031797532f08a7d5b602d8b2a488ca"},
    {file = "jsonpointer-3.1.1.tar.gz", hash = "sha256:0b801c7db33a904024f6004d526dcc53bbb8a4a0f4e32bfd10beadf60adf1900"},
]

[[package]]
name = "langchain-core"
version = "1.5.1"
description = "Building applications with LLMs through composability"
optional = false
python-versions = "<4.0.0,>=3.10.0"
groups = ["main"]
files = [
    {file = "langchain_core-1.5.1-py3-none-any.whl", hash = "sha256:c5ec8f51dd05124f950c9afd0fd8bb3f7be4e405eeb868d481b2f8ff652cb9d2"},
    {file = "langchain_core-1.5.1.tar.gz", hash = "sha256:b0df382704c6403c1e0c9603415bce09290455d4aeeb38f350d15f78ca597483"},
]

[package.dependencies]
jsonpatch = ">=1.33.0,<2.0.0"
langchain-protocol = ">=0.0.17"
langsmith = ">=0.3.45,<1.0.0"
packaging = ">=23.2.0"
pydantic = ">=2.7.4,<3.0.0"
pyyaml = ">=5.3.0,<7.0.0"
tenacity = ">=8.1.0,<8.4.0 || >8.4.0,<10.0.0"
typing-extensions = ">=4.7.0,<5.0.0"
uuid-utils = ">=0.12.0,<1.0"

[[package]]
name = "langchain-protocol"
version = "0.0.18"
description = "Python bindings for the LangChain agent streaming protocol"
optional = false
python-versions = "<4.0.0,>=3.10.0"
groups = ["main"]
files = [
    {file = "langchain_protocol-0.0.18-py3-none-any.whl", hash = "sha256:70b53a86fbf9cedc863555effe44da192ab02d556ddbf2cf95b8873adcf41b5a"},
    {file = "langchain_protocol-0.0.18.tar.gz", hash = "sha256:ec3e11782f1ed0c9db38e5a9ed01b0e7a0d3fba406faa8aef6594b73c56a63e6"},
]

[package.dependencies]
typing-extensions = ">=4.13.0,<5.0.0"

[[package]]
name = "langgraph"
version = "0.6.11"
description = "Building stateful, multi-actor applications with LLMs"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "langgraph-0.6.11-py3-none-any.whl", hash = "sha256:49268de69d85b7db3da9e2ca582a474516421c1c44be5cff390416cfa6967faa"},
    {file = "langgraph-0.6.11.tar.gz", hash = "sha256:cd5373d0a59701ab39c9f8af33a33c5704553de815318387fa7f240511e0efd7"},
]

[package.dependencies]
langchain-core = ">=0.1"
langgraph-checkpoint = ">=2.1.0,<4.0.0"
langgraph-prebuilt = ">=0.6.0,<0.7.0"
langgraph-sdk = ">=0.2.2,<0.3.0"
pydantic = ">=2.7.4"
xxhash = ">=3.5.0"

[[package]]
name = "langgraph-checkpoint"
version = "3.0.1"
description = "Library with base interfaces for LangGraph checkpoint savers."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "langgraph_checkpoint-3.0.1-py3-none-any.whl", hash = "sha256:9b04a8d0edc0474ce4eaf30c5d731cee38f11ddff50a6177eead95b5c4e4220b"},
    {file = "langgraph_checkpoint-3.0.1.tar.gz", hash = "sha256:59222f875f85186a22c494aedc65c4e985a3df27e696e5016ba0b98a5ed2cee0"},
]

[package.dependencies]
langchain-core = ">=0.2.38"
ormsgpack = ">=1.12.0"

[[package]]
name = "langgraph-prebuilt"
version = "0.6.5"
description = "Library with high-level APIs for creating and executing LangGraph agents and tools."
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "langgraph_prebuilt-0.6.5-py3-none-any.whl", hash = "sha256:b6ceb5db31c16a30a3ee3c0b923667f02e7c9e27852621abf9d5bd5603534141"},
    {file = "langgraph_prebuilt-0.6.5.tar.gz", hash = "sha256:9c63e9e867e62b345805fd1e8ea5c2df5cc112e939d714f277af84f2afe5950d"},
]

[package.dependencies]
langchain-core = ">=0.3.67"
langgraph-checkpoint = ">=2.1.0,<4.0.0"

[[package]]
name = "langgraph-sdk"
version = "0.2.15"
description = "SDK for interacting with LangGraph API"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "langgraph_sdk-0.2.15-py3-none-any.whl", hash = "sha256:746566a5d89aa47160eccc17d71682a78771c754126f6c235a68353d61ed7462"},
    {file = "langgraph_sdk-0.2.15.tar.gz", hash = "sha256:8faaafe2c1193b89f782dd66c591060cd67862aa6aaf283749b7846f331d5334"},
]

[package.dependencies]
httpx = ">=0.25.2"
orjson = ">=3.10.1"

[[package]]
name = "langsmith"
version = "0.10.10"
description = "Client library to connect to the LangSmith Observability and Evaluation Platform."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "langsmith-0.10.10-py3-none-any.whl", hash = "sha256:eb5e9da635f5853fc657cddd1c27f40a8e8b2f00c38051555d608c8e57eb605d"},
    {file = "langsmith-0.10.10.tar.gz", hash = "sha256:e0e175e9dd8de6d96dbb55244482e20590a2691ec7c5e087afc1f302e33d98fe"},
]

[package.dependencies]
anyio = ">=3.5.0"
distro = ">=1.7.0"
httpx = ">=0.23.0,<1"
orjson = {version = ">=3.9.14", markers = "platform_python_implementation != \"PyPy\""}
packaging = ">=23.2"
pydantic = ">=2,<3"
requests = ">=2.0.0"
requests-toolbelt = ">=1.0.0"
sniffio = ">=1.1"
typing-extensions = ">=4.0.0"
uuid-utils = ">=0.12.0,<1.0"
websockets = ">=15.0"
xxhash = ">=3.0.0"
zstandard = ">=0.23.0"

[package.extras]
claude-agent-sdk = ["claude-agent-sdk (>=0.1.0) ; python_version >= \"3.10\""]
google-adk = ["google-adk (>=1.0.0)", "wrapt (>=1.16.0)"]
google-adk-live = ["google-adk (>=2.3.0)"]
langsmith-pyo3 = ["langsmith-pyo3 (>=0.1.0rc2)"]
livekit = ["cachetools (>=5.0.0)", "livekit-agents (>=1.0)", "opentelemetry-api (>=1.30.0)", "opentelemetry-exporter-otlp-proto-http (>=1.30.0)", "opentelemetry-sdk (>=1.30.0)"]
openai-agents = ["openai-agents (>=0.0.3)"]
openai-realtime = ["openai (>=1.50)", "openai-agents (>=0.0.3)"]
otel = ["opentelemetry-api (>=1.30.0)", "opentelemetry-exporter-otlp-proto-http (>=1.30.0)", "opentelemetry-sdk (>=1.30.0)"]
pipecat = ["cachetools (>=5.0.0)", "opentelemetry-api (>=1.30.0)", "opentelemetry-exporter-otlp-proto-http (>=1.30.0)", "opentelemetry-sdk (>=1.30.0)", "pipecat-ai (>=1.0) ; python_version >= \"3.11\""]
pytest = ["pytest (>=7.0.0)", "rich (>=13.9.4)", "vcrpy (>=7.0.0)"]
strands-agents = ["opentelemetry-api (>=1.30.0)", "opentelemetry-exporter-otlp-proto-http (>=1.30.0)", "opentelemetry-sdk (>=1.30.0)", "strands-agents (>=0.1.0)", "strands-agents-tools (>=0.2.0)"]
vcr = ["vcrpy (>=7.0.0)"]

[[package]]
name = "orjson"
version = "3.11.9"
description = "Fast, correct Python JSON library supporting dataclasses, datetimes, and numpy"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "orjson-3.11.9-cp310-cp310-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:135869ef917b8704ea0a94e01620e0c05021c15c52036e4663baffe75e72f8ce"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:115ab5f5f4a0f203cc2a5f0fb09aee503a3f771aa08392949ab5ca230c4fbdbd"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4da3c38a2083ca4aaf9c2a36776cce3e9328e6647b10d118948f3cfb4913ffe4"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:53b50b0e14084b8f7e29c5ce84c5af0f1160169b30d8a6914231d97d2fe297d4"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:231742b4a11dad8d5380a435962c57e91b7c37b79be858f4ef1c0df1a259897e"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:34fd2317602587321faab75ab76c623a0117e80841a6413654f04e47f339a8fb"},
    {file = "orjson-3.11.9-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:71f3db16e69b667b132e0f305a833d5497da302d801508cbb051ed9a9819da47"},
    {file = "orjson-3.11.9-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0b34789fa0da61cf7bef0546b09c738fb195331e017e477096d129e9105ab03d"},
    {file = "orjson-3.11.9-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:87e4d4ab280b0c87424d47695bec2182caf8cfc17879ea78dab76680194abc13"},
    {file = "orjson-3.11.9-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:ace6c58523302d3b97b6ac5c38a5298a54b473762b6be82726b4265c41029f92"},
    {file = "orjson-3.11.9-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:97d0d932803c1b164fde11cb542a9efcb1e0f63b184537cca65887147906ff48"},
    {file = "orjson-3.11.9-cp310-cp310-win32.whl", hash = "sha256:b3afcf569c15577a9fe64627292daa3e6b3a70f4fb77a5df246a87ec21681b94"},
    {file = "orjson-3.11.9-cp310-cp310-win_amd64.whl", hash = "sha256:8697ab6a080a5c46edaad50e2bc5bd8c7ca5c66442d24104fa44ec74910a8244"},
    {file = "orjson-3.11.9-cp311-cp311-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:f01c4818b3fc9b0da8e096722a84318071eaa118df35f6ed2344da0e73a5444f"},
    {file = "orjson-3.11.9-cp311-cp311-macosx_15_0_arm64.whl", hash = "sha256:3ebca4179031ee716ed076ffadc29428e900512f6fccee8614c9983157fcf19c"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:48ee05097750de0ff69ed5b7bbcf0732182fd57a24043dcc2a1da780a5ead3a5"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a6082706765a95a6680d812e1daf1c0cfe8adec7831b3ff3b625693f3b461b1c"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:277fefe9d76ee17eb14debf399e3533d4d63b5f677a4d3719eb763536af1f4bd"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:03db380e3780fa0015ed776a90f20e8e20bb11dde13b216ce19e5718e3dfba62"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:33d7d766701847dc6729846362dc27895d2f2d2251264f9d10e7cb9878194877"},
    {file = "orjson-3.11.9-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:147302878da387104b66bb4a8b0227d1d487e976ce41a8501916161072ed87b1"},
    {file = "orjson-3.11.9-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:3513550321f8c8c811a7c3297b8a630e82dc08e4c10216d07703c997776236cd"},
    {file = "orjson-3.11.9-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:c5d001196b89fa9cf0a4ab79766cd835b991a166e4b621ba95089edc50c429ff"},
    {file = "orjson-3.11.9-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:16969c9d369c98eb084889c6e4d2d39b77c7eb38ceccf8da2a9fff62ae908980"},
    {file = "orjson-3.11.9-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:63e0efbc991250c0b3143488fa57d95affcabbfc63c99c48d625dd37779aafe2"},
    {file = "orjson-3.11.9-cp311-cp311-win32.whl", hash = "sha256:14ed654580c1ed2bc217352ec82f91b047aef82951aa71c7f64e0dcb03c0e180"},
    {file = "orjson-3.11.9-cp311-cp311-win_amd64.whl", hash = "sha256:57ea77fb70a448ce87d18fca050193202a3da5e54598f6501ca5476fb66cfe02"},
    {file = "orjson-3.11.9-cp311-cp311-win_arm64.whl", hash = "sha256:19b72ed11572a2ee51a67a903afbe5af504f84ed6f529c0fe44b0ab3fb5cc697"},
    {file = "orjson-3.11.9-cp312-cp312-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:9ef6fe90aadef185c7b128859f40beb24720b4ecea95379fc9000931179c3a49"},
    {file = "orjson-3.11.9-cp312-cp312-macosx_15_0_arm64.whl", hash = "sha256:e5c9b8f28e726e97d97696c826bc7bea5d71cecd63576dba92924a32c1961291"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:26a473dbb4162108b27901492546f83c76fdcea3d0eadff00ae7a07e18dcce09"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:011382e2a60fda9d46f1cdee31068cfc52ffe952b587d683ec0463002802a0f4"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c2d3dc759490128c5c1711a53eeaa8ee1d437fd0038ffd2b6008abf46db3f882"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d8ea516b3726d190e1b4297e6f4e7a8650347ae053868a18163b4dd3641d1fff"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:380cdce7ba24989af81d0a7013d0aaec5d0e2a21734c0e2681b1bc4f141957fe"},
    {file = "orjson-3.11.9-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:be4fa4f0af7fa18951f7ab3fc2148e223af211bf03f59e1c6034ec3f97f21d61"},
    {file = "orjson-3.11.9-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a8f5f8bc7ce7d59f08d9f99fa510c06496164a24cb5f3d34537dbd9ca30132e2"},
    {file = "orjson-3.11.9-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:4d7fde5501b944f83b3e665e1b31343ff6e154b15560a16b7130ea1e594a4206"},
    {file = "orjson-3.11.9-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:cde1a448023ba7d5bb4c01c5afb48894380b5e4956e0627266526587ef4e535f"},
    {file = "orjson-3.11.9-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:71e63adb0e1f1ed5d9e168f50a91ceb93ae6420731d222dc7da5c69409aa47aa"},
    {file = "orjson-3.11.9-cp312-cp312-win32.whl", hash = "sha256:2d057a602cdd19a0ad680417527c45b6961a095081c0f46fe0e03e304aac6470"},
    {file = "orjson-3.11.9-cp312-cp312-win_amd64.whl", hash = "sha256:59e403b1cc5a676da8eaf31f6254801b7341b3e29efa85f92b48d272637e77be"},
    {file = "orjson-3.11.9-cp312-cp312-win_arm64.whl", hash = "sha256:9af678d6488357948f1f84c6cd1c1d397c014e1ae2f98ae082a44eb48f602624"},
    {file = "orjson-3.11.9-cp313-cp313-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:4bab1b2d6141fe7b32ae71dac905666ece4f94936efbfb13d55bb7739a3a6021"},
    {file = "orjson-3.11.9-cp313-cp313-macosx_15_0_arm64.whl", hash = "sha256:844417969855fc7a41be124aafe83dc424592a7f77cd4501900c67307122b92c"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ffe02797b5e9f3a9d8292ddcd289b474ad13e81ad83cd1891a240811f1d2cb81"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0e4eed3b200023042814d2fc8a5d2e880f13b52e1ed2485e83da4f3962f7dc1a"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:8aff7da9952a5ad1cef8e68017724d96c7b9a66e99e91d6252e1b133d67a7b10"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4d4e98d6f3b8afed8bc8cd9718ec0cdf46661826beefb53fe8eafb37f2bf0362"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3a81d52442a7c99b3662333235b3adf96a1715864658b35bb797212be7bddb97"},
    {file = "orjson-3.11.9-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4e39364e726a8fff737309aff059ff67d8a8c8d5b677be7bb49a8b3e84b7e218"},
    {file = "orjson-3.11.9-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4fd66214623f1b17501df9f0543bef0b833979ab5b6ded1e1d123222866aa8c9"},
    {file = "orjson-3.11.9-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:8ecc30f10465fa1e0ce13fd01d9e22c316e5053a719a8d915d4545a09a5ff677"},
    {file = "orjson-3.11.9-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:97db4c94a7db398a5bd636273324f0b3fd58b350bbbac8bb380ceb825a9b40f4"},
    {file = "orjson-3.11.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9f78cf8fec5bd627f4082b8dfeac7871b43d7f3274904492a43dab39f18a19a0"},
    {file = "orjson-3.11.9-cp313-cp313-win32.whl", hash = "sha256:d4087e5c0209a0a8efe4de3303c234b9c44d1174161dcd851e8eea07c7560b32"},
    {file = "orjson-3.11.9-cp313-cp313-win_amd64.whl", hash = "sha256:051b102c93b4f634e89f3866b07b9a9a98915ada541f4ec30f177067b2694979"},
    {file = "orjson-3.11.9-cp313-cp313-win_arm64.whl", hash = "sha256:cce9127885941bd28f080cecf1f1d288336b7e0d812c345b08be88b572796254"},
    {file = "orjson-3.11.9-cp314-cp314-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:b6ef1979adc4bc243523f1a2ba91418030a8e29b0a99cbe7e0e2d6807d4dce6e"},
    {file = "orjson-3.11.9-cp314-cp314-macosx_15_0_arm64.whl", hash = "sha256:f36b7f32c7c0db4a719f1fc5824db4a9c6f8bd1a354debb91faf26ebf3a4c71e"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:08f4d8ebb44925c794e535b2bebc507cebf32209df81de22ae285fb0d8d66de0"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6cc7923789694fd58f001cbcac7e47abc13af4d560ebbfcf3b41a8b1a0748124"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ea5c46eb2d3af39e806b986f4b09d5c2706a1f5afde3cbf7544ce6616127173c"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f5d89a2ed90731df3be64bab0aa44f78bff39fdc9d71c291f4a8023aa46425b7"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:25e4aed0312d292c09f61af25bba34e0b2c88546041472b09088c39a4d828af1"},
    {file = "orjson-3.11.9-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aaea64f3f467d22e70eeed68bdccb3bc4f83f650446c4a03c59f2cba28a108db"},
    {file = "orjson-3.11.9-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a028425d1b440c5d92a6be1e1a020739dfe67ea87d96c6dbe828c1b30041728b"},
    {file = "orjson-3.11.9-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:5b192c6cf397e4455b11523c5cf2b18ed084c1bbd61b6c0926344d2129481972"},
    {file = "orjson-3.11.9-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ea407d4ccf5891d667d045fecae97a7a1e5e87b3b97f97ae1803c2e741130be0"},
    {file = "orjson-3.11.9-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5f63aaf97afd9f6dec5b1a68e1b8da12bfccb4cb9a9a65c3e0b6c847849e7586"},
    {file = "orjson-3.11.9-cp314-cp314-win32.whl", hash = "sha256:e30ab17845bb9fa54ccf67fa4f9f5282652d54faa6d17452f47d0f369d038673"},
    {file = "orjson-3.11.9-cp314-cp314-win_amd64.whl", hash = "sha256:32ef5f4283a3be81913947d19608eacb7c6608026851123790cd9cc8982af34b"},
    {file = "orjson-3.11.9-cp314-cp314-win_arm64.whl", hash = "sha256:eebdbdeef0094e4f5aefa20dcd4eb2368ab5e7a3b4edea27f1e7b2892e009cf9"},
    {file = "orjson-3.11.9.tar.gz", hash = "sha256:4fef17e1f8722c11587a6ef18e35902450221da0028e65dbaaa543619e68e48f"},
]

[[package]]
name = "ormsgpack"
version = "1.12.2"
description = "Fast, correct Python msgpack library supporting dataclasses, datetimes, and numpy"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "ormsgpack-1.12.2-cp310-cp310-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:c1429217f8f4d7fcb053523bbbac6bed5e981af0b85ba616e6df7cce53c19657"},
    {file = "ormsgpack-1.12.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5f13034dc6c84a6280c6c33db7ac420253852ea233fc3ee27c8875f8dd651163"},
    {file = "ormsgpack-1.12.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:59f5da97000c12bc2d50e988bdc8576b21f6ab4e608489879d35b2c07a8ab51a"},
    {file = "ormsgpack-1.12.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9e4459c3f27066beadb2b81ea48a076a417aafffff7df1d3c11c519190ed44f2"},
    {file = "ormsgpack-1.12.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:7a1c460655d7288407ffa09065e322a7231997c0d62ce914bf3a96ad2dc6dedd"},
    {file = "ormsgpack-1.12.2-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:458e4568be13d311ef7d8877275e7ccbe06c0e01b39baaac874caaa0f46d826c"},
    {file = "ormsgpack-1.12.2-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:8cde5eaa6c6cbc8622db71e4a23de56828e3d876aeb6460ffbcb5b8aff91093b"},
    {file = "ormsgpack-1.12.2-cp310-cp310-win_amd64.whl", hash = "sha256:dc7a33be14c347893edbb1ceda89afbf14c467d593a5ee92c11de4f1666b4d4f"},
    {file = "ormsgpack-1.12.2-cp311-cp311-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:bd5f4bf04c37888e864f08e740c5a573c4017f6fd6e99fa944c5c935fabf2dd9"},
    {file = "ormsgpack-1.12.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:34d5b28b3570e9fed9a5a76528fc7230c3c76333bc214798958e58e9b79cc18a"},
    {file = "ormsgpack-1.12.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3708693412c28f3538fb5a65da93787b6bbab3484f6bc6e935bfb77a62400ae5"},
    {file = "ormsgpack-1.12.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:43013a3f3e2e902e1d05e72c0f1aeb5bedbb8e09240b51e26792a3c89267e181"},
    {file = "ormsgpack-1.12.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:7c8b1667a72cbba74f0ae7ecf3105a5e01304620ed14528b2cb4320679d2869b"},
    {file = "ormsgpack-1.12.2-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:df6961442140193e517303d0b5d7bc2e20e69a879c2d774316125350c4a76b92"},
    {file = "ormsgpack-1.12.2-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c6a4c34ddef109647c769d69be65fa1de7a6022b02ad45546a69b3216573eb4a"},
    {file = "ormsgpack-1.12.2-cp311-cp311-win_amd64.whl", hash = "sha256:73670ed0375ecc303858e3613f407628dd1fca18fe6ac57b7b7ce66cc7bb006c"},
    {file = "ormsgpack-1.12.2-cp311-cp311-win_arm64.whl", hash = "sha256:c2be829954434e33601ae5da328cccce3266b098927ca7a30246a0baec2ce7bd"},
    {file = "ormsgpack-1.12.2-cp312-cp312-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:7a29d09b64b9694b588ff2f80e9826bdceb3a2b91523c5beae1fab27d5c940e7"},
    {file = "ormsgpack-1.12.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0b39e629fd2e1c5b2f46f99778450b59454d1f901bc507963168985e79f09c5d"},
    {file = "ormsgpack-1.12.2-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:958dcb270d30a7cb633a45ee62b9444433fa571a752d2ca484efdac07480876e"},
    {file = "ormsgpack-1.12.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58d379d72b6c5e964851c77cfedfb386e474adee4fd39791c2c5d9efb53505cc"},
    {file = "ormsgpack-1.12.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8463a3fc5f09832e67bdb0e2fda6d518dc4281b133166146a67f54c08496442e"},
    {file = "ormsgpack-1.12.2-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:eddffb77eff0bad4e67547d67a130604e7e2dfbb7b0cde0796045be4090f35c6"},
    {file = "ormsgpack-1.12.2-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fcd55e5f6ba0dbce624942adf9f152062135f991a0126064889f68eb850de0dd"},
    {file = "ormsgpack-1.12.2-cp312-cp312-win_amd64.whl", hash = "sha256:d024b40828f1dde5654faebd0d824f9cc29ad46891f626272dd5bfd7af2333a4"},
    {file = "ormsgpack-1.12.2-cp312-cp312-win_arm64.whl", hash = "sha256:da538c542bac7d1c8f3f2a937863dba36f013108ce63e55745941dda4b75dbb6"},
    {file = "ormsgpack-1.12.2-cp313-cp313-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:5ea60cb5f210b1cfbad8c002948d73447508e629ec375acb82910e3efa8ff355"},
    {file = "ormsgpack-1.12.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f3601f19afdbea273ed70b06495e5794606a8b690a568d6c996a90d7255e51c1"},
    {file = "ormsgpack-1.12.2-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:29a9f17a3dac6054c0dce7925e0f4995c727f7c41859adf9b5572180f640d172"},
    {file = "ormsgpack-1.12.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:39c1bd2092880e413902910388be8715f70b9f15f20779d44e673033a6146f2d"},
    {file = "ormsgpack-1.12.2-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:50b7249244382209877deedeee838aef1542f3d0fc28b8fe71ca9d7e1896a0d7"},
    {file = "ormsgpack-1.12.2-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:5af04800d844451cf102a59c74a841324868d3f1625c296a06cc655c542a6685"},
    {file = "ormsgpack-1.12.2-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:cec70477d4371cd524534cd16472d8b9cc187e0e3043a8790545a9a9b296c258"},
    {file = "ormsgpack-1.12.2-cp313-cp313-win_amd64.whl", hash = "sha256:21f4276caca5c03a818041d637e4019bc84f9d6ca8baa5ea03e5cc8bf56140e9"},
    {file = "ormsgpack-1.12.2-cp313-cp313-win_arm64.whl", hash = "sha256:baca4b6773d20a82e36d6fd25f341064244f9f86a13dead95dd7d7f996f51709"},
    {file = "ormsgpack-1.12.2-cp314-cp314-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:bc68dd5915f4acf66ff2010ee47c8906dc1cf07399b16f4089f8c71733f6e36c"},
    {file = "ormsgpack-1.12.2-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:46d084427b4132553940070ad95107266656cb646ea9da4975f85cb1a6676553"},
    {file = "ormsgpack-1.12.2-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c010da16235806cf1d7bc4c96bf286bfa91c686853395a299b3ddb49499a3e13"},
    {file = "ormsgpack-1.12.2-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:18867233df592c997154ff942a6503df274b5ac1765215bceba7a231bea2745d"},
    {file = "ormsgpack-1.12.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b009049086ddc6b8f80c76b3955df1aa22a5fbd7673c525cd63bf91f23122ede"},
    {file = "ormsgpack-1.12.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:1dcc17d92b6390d4f18f937cf0b99054824a7815818012ddca925d6e01c2e49e"},
    {file = "ormsgpack-1.12.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f04b5e896d510b07c0ad733d7fce2d44b260c5e6c402d272128f8941984e4285"},
    {file = "ormsgpack-1.12.2-cp314-cp314-win_amd64.whl", hash = "sha256:ae3aba7eed4ca7cb79fd3436eddd29140f17ea254b91604aa1eb19bfcedb990f"},
    {file = "ormsgpack-1.12.2-cp314-cp314-win_arm64.whl", hash = "sha256:118576ea6006893aea811b17429bfc561b4778fad393f5f538c84af70b01260c"},
    {file = "ormsgpack-1.12.2-cp314-cp314t-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:7121b3d355d3858781dc40dafe25a32ff8a8242b9d80c692fd548a4b1f7fd3c8"},
    {file = "ormsgpack-1.12.2-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4ee766d2e78251b7a63daf1cddfac36a73562d3ddef68cacfb41b2af64698033"},
    {file = "ormsgpack-1.12.2-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:292410a7d23de9b40444636b9b8f1e4e4b814af7f1ef476e44887e52a123f09d"},
    {file = "ormsgpack-1.12.2-cp314-cp314t-win_amd64.whl", hash = "sha256:837dd316584485b72ef451d08dd3e96c4a11d12e4963aedb40e08f89685d8ec2"},
    {file = "ormsgpack-1.12.2.tar.gz", hash = "sha256:944a2233640273bee67521795a73cf1e959538e0dfb7ac635505010455e53b33"},
]

[[package]]
name = "packaging"
version = "26.2"
description = "Core utilities for Python packages"
optional = false
python-versions = ">=3.8"
groups = ["main", "dev"]
files = [
    {file = "packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e"},
    {file = "packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661"},
]

[[package]]
name = "parsimonious"
version = "0.10.0"
description = "(Soon to be) the fastest pure-Python PEG parser I could muster"
optional = false
python-versions = "*"
groups = ["main"]
files = [
    {file = "parsimonious-0.10.0-py3-none-any.whl", hash = "sha256:982ab435fabe86519b57f6b35610aa4e4e977e9f02a14353edf4bbc75369fc0f"},
    {file = "parsimonious-0.10.0.tar.gz", hash = "sha256:8281600da180ec8ae35427a4ab4f7b82bfec1e3d1e52f80cb60ea82b9512501c"},
]

[package.dependencies]
regex = ">=2022.3.15"

[[package]]
name = "pluggy"
version = "1.6.0"
description = "plugin and hook calling mechanisms for python"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
    {file = "pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746"},
    {file = "pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3"},
]

[package.extras]
dev = ["pre-commit", "tox"]
testing = ["coverage", "pytest", "pytest-benchmark"]

[[package]]
name = "pycryptodome"
version = "3.23.0"
description = "Cryptographic library for Python"
optional = false
python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
groups = ["main"]
files = [
    {file = "pycryptodome-3.23.0-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:a176b79c49af27d7f6c12e4b178b0824626f40a7b9fed08f712291b6d54bf566"},
    {file = "pycryptodome-3.23.0-cp27-cp27m-manylinux2010_i686.whl", hash = "sha256:573a0b3017e06f2cffd27d92ef22e46aa3be87a2d317a5abf7cc0e84e321bd75"},
    {file = "pycryptodome-3.23.0-cp27-cp27m-manylinux2010_x86_64.whl", hash = "sha256:63dad881b99ca653302b2c7191998dd677226222a3f2ea79999aa51ce695f720"},
    {file = "pycryptodome-3.23.0-cp27-cp27m-win32.whl", hash = "sha256:b34e8e11d97889df57166eda1e1ddd7676da5fcd4d71a0062a760e75060514b4"},
    {file = "pycryptodome-3.23.0-cp27-cp27mu-manylinux2010_i686.whl", hash = "sha256:7ac1080a8da569bde76c0a104589c4f414b8ba296c0b3738cf39a466a9fb1818"},
    {file = "pycryptodome-3.23.0-cp27-cp27mu-manylinux2010_x86_64.whl", hash = "sha256:6fe8258e2039eceb74dfec66b3672552b6b7d2c235b2dfecc05d16b8921649a8"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:0011f7f00cdb74879142011f95133274741778abba114ceca229adbf8e62c3e4"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:90460fc9e088ce095f9ee8356722d4f10f86e5be06e2354230a9880b9c549aae"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4764e64b269fc83b00f682c47443c2e6e85b18273712b98aa43bcb77f8570477"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eb8f24adb74984aa0e5d07a2368ad95276cf38051fe2dc6605cbcf482e04f2a7"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d97618c9c6684a97ef7637ba43bdf6663a2e2e77efe0f863cce97a76af396446"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9a53a4fe5cb075075d515797d6ce2f56772ea7e6a1e5e4b96cf78a14bac3d265"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:763d1d74f56f031788e5d307029caef067febf890cd1f8bf61183ae142f1a77b"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:954af0e2bd7cea83ce72243b14e4fb518b18f0c1649b576d114973e2073b273d"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-win32.whl", hash = "sha256:257bb3572c63ad8ba40b89f6fc9d63a2a628e9f9708d31ee26560925ebe0210a"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-win_amd64.whl", hash = "sha256:6501790c5b62a29fcb227bd6b62012181d886a767ce9ed03b303d1f22eb5c625"},
    {file = "pycryptodome-3.23.0-cp313-cp313t-win_arm64.whl", hash = "sha256:9a77627a330ab23ca43b48b130e202582e91cc69619947840ea4d2d1be21eb39"},
    {file = "pycryptodome-3.23.0-cp37-abi3-macosx_10_9_universal2.whl", hash = "sha256:187058ab80b3281b1de11c2e6842a357a1f71b42cb1e15bce373f3d238135c27"},
    {file = "pycryptodome-3.23.0-cp37-abi3-macosx_10_9_x86_64.whl", hash = "sha256:cfb5cd445280c5b0a4e6187a7ce8de5a07b5f3f897f235caa11f1f435f182843"},
    {file = "pycryptodome-3.23.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:67bd81fcbe34f43ad9422ee8fd4843c8e7198dd88dd3d40e6de42ee65fbe1490"},
    {file = "pycryptodome-3.23.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c8987bd3307a39bc03df5c8e0e3d8be0c4c3518b7f044b0f4c15d1aa78f52575"},
    {file = "pycryptodome-3.23.0-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:aa0698f65e5b570426fc31b8162ed4603b0c2841cbb9088e2b01641e3065915b"},
    {file = "pycryptodome-3.23.0-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:53ecbafc2b55353edcebd64bf5da94a2a2cdf5090a6915bcca6eca6cc452585a"},
    {file = "pycryptodome-3.23.0-cp37-abi3-musllinux_1_2_i686.whl", hash = "sha256:156df9667ad9f2ad26255926524e1c136d6664b741547deb0a86a9acf5ea631f"},
    {file = "pycryptodome-3.23.0-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:dea827b4d55ee390dc89b2afe5927d4308a8b538ae91d9c6f7a5090f397af1aa"},
    {file = "pycryptodome-3.23.0-cp37-abi3-win32.whl", hash = "sha256:507dbead45474b62b2bbe318eb1c4c8ee641077532067fec9c1aa82c31f84886"},
    {file = "pycryptodome-3.23.0-cp37-abi3-win_amd64.whl", hash = "sha256:c75b52aacc6c0c260f204cbdd834f76edc9fb0d8e0da9fbf8352ef58202564e2"},
    {file = "pycryptodome-3.23.0-cp37-abi3-win_arm64.whl", hash = "sha256:11eeeb6917903876f134b56ba11abe95c0b0fd5e3330def218083c7d98bbcb3c"},
    {file = "pycryptodome-3.23.0-pp27-pypy_73-manylinux2010_x86_64.whl", hash = "sha256:350ebc1eba1da729b35ab7627a833a1a355ee4e852d8ba0447fafe7b14504d56"},
    {file = "pycryptodome-3.23.0-pp27-pypy_73-win32.whl", hash = "sha256:93837e379a3e5fd2bb00302a47aee9fdf7940d83595be3915752c74033d17ca7"},
    {file = "pycryptodome-3.23.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:ddb95b49df036ddd264a0ad246d1be5b672000f12d6961ea2c267083a5e19379"},
    {file = "pycryptodome-3.23.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d8e95564beb8782abfd9e431c974e14563a794a4944c29d6d3b7b5ea042110b4"},
    {file = "pycryptodome-3.23.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:14e15c081e912c4b0d75632acd8382dfce45b258667aa3c67caf7a4d4c13f630"},
    {file = "pycryptodome-3.23.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a7fc76bf273353dc7e5207d172b83f569540fc9a28d63171061c42e361d22353"},
    {file = "pycryptodome-3.23.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:45c69ad715ca1a94f778215a11e66b7ff989d792a4d63b68dc586a1da1392ff5"},
    {file = "pycryptodome-3.23.0-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:865d83c906b0fc6a59b510deceee656b6bc1c4fa0d82176e2b77e97a420a996a"},
    {file = "pycryptodome-3.23.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:89d4d56153efc4d81defe8b65fd0821ef8b2d5ddf8ed19df31ba2f00872b8002"},
    {file = "pycryptodome-3.23.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e3f2d0aaf8080bda0587d58fc9fe4766e012441e2eed4269a77de6aea981c8be"},
    {file = "pycryptodome-3.23.0-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:64093fc334c1eccfd3933c134c4457c34eaca235eeae49d69449dc4728079339"},
    {file = "pycryptodome-3.23.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:ce64e84a962b63a47a592690bdc16a7eaf709d2c2697ababf24a0def566899a6"},
    {file = "pycryptodome-3.23.0.tar.gz", hash = "sha256:447700a657182d60338bab09fdb27518f8856aecd80ae4c6bdddb67ff5da44ef"},
]

[[package]]
name = "pydantic"
version = "2.13.4"
description = "Data validation using Python type hints"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "pydantic-2.13.4-py3-none-any.whl", hash = "sha256:45a282cde31d808236fd7ea9d919b128653c8b38b393d1c4ab335c62924d9aba"},
    {file = "pydantic-2.13.4.tar.gz", hash = "sha256:c40756b57adaa8b1efeeced5c196f3f3b7c435f90e84ea7f443901bec8099ef6"},
]

[package.dependencies]
annotated-types = ">=0.6.0"
pydantic-core = "2.46.4"
typing-extensions = ">=4.14.1"
typing-inspection = ">=0.4.2"

[package.extras]
email = ["email-validator (>=2.0.0)"]
timezone = ["tzdata ; python_version >= \"3.9\" and platform_system == \"Windows\""]

[[package]]
name = "pydantic-core"
version = "2.46.4"
description = "Core functionality for Pydantic validation and serialization"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "pydantic_core-2.46.4-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:a396dcc17e5a0b164dbe026896245a4fa9ff402edca1dff0be3d53a517f74de4"},
    {file = "pydantic_core-2.46.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:da4b951fe36dc7c3a1ccb4e3cd1747c3542b8c9ceede8fc86cae054e764485f5"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bb63e0198ca18aad131c089b9204c23079c3afa95487e561f4c522d519e55aba"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f47286a97f0bc9b8859519809077b91b2cefe4ae47fcbf5e466a009c1c5d742b"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:905a0ed8ea6f2d61c1738835f99b699348d7857379083e5fc497fa0c967a407c"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ea793e075b70290d89d8142074262885d3f7da19634845135751bd6344f73b50"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:395aebd9183f9d112f569aeb5b2214d1a10a33bec8456447f7fbdfa51d38d4cd"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:b078afbc25f3a1436c7a1d2cd3e322497ee99615ba97c563566fdf46aff1ee01"},
    {file = "pydantic_core-2.46.4-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f747929cf940cddb5b3668a390056ddd5ba2e5010615ea2dcf4f9c4f3ab8791d"},
    {file = "pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:daa27d92c36f24388fe3ad306b174781c747627f134452e4f128ea00ce1fe8c4"},
    {file = "pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:19e51f073cd3df251856a8a4189fbdf1de4012c3ebacfb1884f94f1eb406079f"},
    {file = "pydantic_core-2.46.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:c1747f85cee84c26985853c6f3d9bd3e75da5212912443fa111c113b9c246f39"},
    {file = "pydantic_core-2.46.4-cp310-cp310-win32.whl", hash = "sha256:2f84c03c8607173d16b5a854ec68a2f9079ae03237a54fb506d13af47e1d018d"},
    {file = "pydantic_core-2.46.4-cp310-cp310-win_amd64.whl", hash = "sha256:8358a950c8909158e3df31538a7e4edc2d7265a7c54b47f0864d9e5bae9dcebf"},
    {file = "pydantic_core-2.46.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0e96592440881c74a213e5ad528e2b24d3d4f940de2766bed9010ab1d9e51594"},
    {file = "pydantic_core-2.46.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:e0d65b8c354be7fb5f720c3caa8bc940bc2d20ce749c8e06135f07f8ed95dd7c"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7bfb192b3f4b9e8a89b6277b6ce787564f62cfd272055f6e685726b111dc7826"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9037063db01f09b09e237c282b6792bd4da634b5402c4e7f0c61effed7701a04"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc010ab034c8c7452522748bf937df58020d256ccae0874463d1f4d01758af8e"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c5dac79fa1614d1e06ca695109c6105923bd9c7d1d6c918d4e637b7e6b32fd3"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f9fa868638bf362d3d138ea55829cefb3d5f4b0d7f142234382a15e2485dbec4"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:17299feefe090f2caa5b8e37222bb5f663e4935a8bfa6931d4102e5df1a9f398"},
    {file = "pydantic_core-2.46.4-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4c63ebc82684aa89d9a3bcbd13d515b3be44250dc68dd3bd81526c1cb31286c3"},
    {file = "pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:aaa2a54443eff1950ba5ddc6b6ccda0d9c84a364276a62f969bdf2a390650848"},
    {file = "pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:18e5ceec2ab67e6d5f1a9085e5a24c9c4e2ac4545730bfe668680bca05e555f3"},
    {file = "pydantic_core-2.46.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:a0f62d0a58f4e7da165457e995725421e0064f2255d8eccebc49f41bbc23b109"},
    {file = "pydantic_core-2.46.4-cp311-cp311-win32.whl", hash = "sha256:041bde0a48fd37cf71cab1c9d56d3e8625a3793fef1f7dd232b3ff37e978ecda"},
    {file = "pydantic_core-2.46.4-cp311-cp311-win_amd64.whl", hash = "sha256:6f2eeda33a839975441c86a4119e1383c50b47faf0cbb5176985565c6bb02c33"},
    {file = "pydantic_core-2.46.4-cp311-cp311-win_arm64.whl", hash = "sha256:14f4c5d6db102bd796a627bbb3a17b4cf4574b9ae861d8b7c9a9661c6dd3362d"},
    {file = "pydantic_core-2.46.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3245406455a5d98187ec35530fd772b1d799b26667980872c8d4614991e2c4a2"},
    {file = "pydantic_core-2.46.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:962ccbab7b642487b1d8b7df90ef677e03134cf1fd8880bf698649b22a69371f"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8233f2947cf85404441fd7e0085f53b10c93e0ee78611099b5c7237e36aacbf7"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3a233125ac121aa3ffba9a2b59edfc4a985a76092dc8279586ab4b71390875e7"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5b712b53160b79a5850310b912a5ef8e57e56947c8ad690c227f5c9d7e561712"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9401557acd873c3a7f3eb9383edef8ac4968f9510e340f4808d427e75667e7b4"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:926c9541b14b12b1681dca8a0b75feb510b06c6341b70a8e500c2fdcff837cce"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:56cb4851bcaf3d117eddcef4fe66afd750a50274b0da8e22be256d10e5611987"},
    {file = "pydantic_core-2.46.4-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c68fcd102d71ea85c5b2dfac3f4f8476eff42a9e078fd5faefff6d145063536b"},
    {file = "pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:b2f69dec1725e79a012d920df1707de5caf7ed5e08f3be4435e25803efc47458"},
    {file = "pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:8d0820e8192167f80d88d64038e609c31452eeca865b4e1d9950a27a4609b00b"},
    {file = "pydantic_core-2.46.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:fbdb89b3e1c94a30cc5edfce477c6e6a5dc4d8f84665b455c27582f211a1c72c"},
    {file = "pydantic_core-2.46.4-cp312-cp312-win32.whl", hash = "sha256:9aa768456404a8bf48a4406685ac2bec8e72b62c69313734fa3b73cf33b3a894"},
    {file = "pydantic_core-2.46.4-cp312-cp312-win_amd64.whl", hash = "sha256:e9c26f834c65f5752f3f06cb08cb86a913ceb7274d0db6e267808a708b46bc89"},
    {file = "pydantic_core-2.46.4-cp312-cp312-win_arm64.whl", hash = "sha256:4fc73cb559bdb54b1134a706a2802a4cddd27a0633f5abb7e53056268751ac6a"},
    {file = "pydantic_core-2.46.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:5d5902252db0d3cedf8d4a1bc68f70eeb430f7e4c7104c8c476753519b423008"},
    {file = "pydantic_core-2.46.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c94f0688e7b8d0a67abf40e57a7eaaecd17cc9586706a31b76c031f63df052b4"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f027324c56cd5406ca49c124b0db10e56c69064fec039acc571c29020cc87c76"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e739fee756ba1010f8bcccb534252e85a35fe45ae92c295a06059ce58b74ccd3"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9d56801be94b86a9da183e5f3766e6310752b99ff647e38b09a9500d88e46e76"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2412e734dcb48da14d4e4006b82b46b74f2518b8a26ee7e58c6844a6cd6d03c4"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9551187363ffc0de2a00b2e47c25aeaeb1020b69b668762966df15fc5659dd5a"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:0186750b482eefa11d7f435892b09c5c606193ef3375bcf94aa00ae6bfb66262"},
    {file = "pydantic_core-2.46.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5855698a4856556d86e8e6cd8434bc3ac0314ee8e12089ae0e143f64c6256e4e"},
    {file = "pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:cbaf13819775b7f769bf4a1f066cb6df7a28d4480081a589828ef190226881cd"},
    {file = "pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:633147d34cf4550417f12e2b1a0383973bdf5cdfde212cb09e9a581cf10820be"},
    {file = "pydantic_core-2.46.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:82cf5301172168103724d49a1444d3378cb20cdee30b116a1bd6031236298a5d"},
    {file = "pydantic_core-2.46.4-cp313-cp313-win32.whl", hash = "sha256:9fa8ae11da9e2b3126c6426f147e0fba88d96d65921799bb30c6abd1cb2c97fb"},
    {file = "pydantic_core-2.46.4-cp313-cp313-win_amd64.whl", hash = "sha256:6b3ace8194b0e5204818c92802dcdca7fc6d88aabbb799d7c795540d9cd6d292"},
    {file = "pydantic_core-2.46.4-cp313-cp313-win_arm64.whl", hash = "sha256:184c081504d17f1c1066e430e117142b2c77d9448a97f7b65c6ac9fd9aee238d"},
    {file = "pydantic_core-2.46.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:428e04521a40150c85216fc8b85e8d39fece235a9cf5e383761238c7fa9b96fb"},
    {file = "pydantic_core-2.46.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:23ace664830ee0bfe014a0c7bc248b1f7f25ed7ad103852c317624a1083af462"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce5c1d2a8b27468f433ca974829c44060b8097eedc39933e3c206a90ee49c4a9"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7283d57845ecf5a163403eb0702dfc220cc4fbdd18919cb5ccea4f95ee1cdab4"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8daafc69c93ee8a0204506a3b6b30f586ef54028f52aeeeb5c4cfc5184fd5914"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd2213145bcc2ba85884d0ac63d222fece9209678f77b9b4d76f054c561adb28"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7a5f930472650a82629163023e630d160863fce524c616f4e5186e5de9d9a49b"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:c1b3f518abeca3aa13c712fd202306e145abf59a18b094a6bafb2d2bbf59192c"},
    {file = "pydantic_core-2.46.4-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1a7dd0b3ee80d90150e3495a3a13ac34dbcbfd4f012996a6a1d8900e91b5c0fb"},
    {file = "pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:3fb702cd90b0446a3a1c5e470bfa0dd23c0233b676a9099ddcc964fa6ca13898"},
    {file = "pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:b8458003118a712e66286df6a707db01c52c0f52f7db8e4a38f0da1d3b94fc4e"},
    {file = "pydantic_core-2.46.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:372429a130e469c9cd698925ce5fc50940b7a1336b0d82038e63d5bbc4edc519"},
    {file = "pydantic_core-2.46.4-cp314-cp314-win32.whl", hash = "sha256:85bb3611ff1802f3ee7fdd7dbff26b56f343fb432d57a4728fdd49b6ef35e2f4"},
    {file = "pydantic_core-2.46.4-cp314-cp314-win_amd64.whl", hash = "sha256:811ff8e9c313ab425368bcbb36e5c4ebd7108c2bbf4e4089cfbb0b01eff63fac"},
    {file = "pydantic_core-2.46.4-cp314-cp314-win_arm64.whl", hash = "sha256:bfec22eab3c8cc2ceec0248aec886624116dc079afa027ecc8ad4a7e62010f8a"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:af8244b2bef6aaad6d92cda81372de7f8c8d36c9f0c3ea36e827c60e7d9467a0"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5a4330cdbc57162e4b3aa303f588ba752257694c9c9be3e7ebb11b4aca659b5d"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:29c61fc04a3d840155ff08e475a04809278972fe6aef51e2720554e96367e34b"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c50f2528cf200c5eed56faf3f4e22fcd5f38c157a8b78576e6ba3168ec35f000"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0cbe8b01f948de4286c74cdd6c667aceb38f5c1e26f0693b3983d9d74887c65e"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:617d7e2ca7dcb8c5cf6bcb8c59b8832c94b36196bbf1cbd1bfb56ed341905edd"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7027560ee92211647d0d34e3f7cd6f50da56399d26a9c8ad0da286d3869a53f3"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:f99626688942fb746e545232e7726926f3be91b5975f8b55327665fafda991c7"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fc3e9034a63de20e15e8ade85358bc6efc614008cab72898b4b4952bea0509ff"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:97e7cf2be5c77b7d1a9713a05605d49460d02c6078d38d8bef3cbe323c548424"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:3bf92c5d0e00fefaab325a4d27828fe6b6e2a21848686b5b60d2d9eeb09d76c6"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:3ecbc122d18468d06ca279dc26a8c2e2d5acb10943bb35e36ae92096dc3b5565"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-win32.whl", hash = "sha256:e846ae7835bf0703ae43f534ab79a867146dadd59dc9ca5c8b53d5c8f7c9ef02"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-win_amd64.whl", hash = "sha256:2108ba5c1c1eca18030634489dc544844144ee36357f2f9f780b93e7ddbb44b5"},
    {file = "pydantic_core-2.46.4-cp314-cp314t-win_arm64.whl", hash = "sha256:4fcbe087dbc2068af7eda3aa87634eba216dbda64d1ae73c8684b621d33f6596"},
    {file = "pydantic_core-2.46.4-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:fd8b3d9fd264be37976686c7f65cd52a83f5e84f4bfd2adf9c1d469676bbb6ae"},
    {file = "pydantic_core-2.46.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:9f444c499b3eefd3a92e348059471ea0c3a6e303d9c1cec09fa748fd9f895201"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3447661d99f75a3683a4cf5c87da72f2161964611864dbbeac7fbb118bb4bfc0"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8b9bab013d1c7a79d3501ff86d0bc9c31bf587db4551677b96bec07df78c6b15"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d995260fdf4e1db774581b4900e0f832abe3c7c84996726bbc161b19c8f29e76"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f13a646d65d09fbf1bc6b3a9635d30095c8e7e5cc419ff35ecc563c5fd04cd49"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:432c179df7874eeb73307aad2df0755e1ae0efa61ff0ea89b93e194411ae3928"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_31_riscv64.whl", hash = "sha256:e68b7a074f65a2fd746c52a7ce6142ab7006074ac269ace0c25cd8ba171f8066"},
    {file = "pydantic_core-2.46.4-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4a05d69cba51d852c5c3e92758653245a50c0b646ced0cf05bd793ed592839d6"},
    {file = "pydantic_core-2.46.4-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:228ee9bae8bef5b1e97ec58302f80357c37199e0d0a99174e138d28e6957b9d9"},
    {file = "pydantic_core-2.46.4-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:10e17cbb10a330363733efc4d7c4d0dd827ac0909b8f6a6542298fed1ea62f29"},
    {file = "pydantic_core-2.46.4-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:91a06d2e259ecfbd8c901d70c3c507900458498142b3026a296b7de4d1322cc9"},
    {file = "pydantic_core-2.46.4-cp39-cp39-win32.whl", hash = "sha256:d80ee3d731373b24cebbc10d689ca4ee1875caf0d5703a245db18efd4dd37fc1"},
    {file = "pydantic_core-2.46.4-cp39-cp39-win_amd64.whl", hash = "sha256:3be77f45df024d789a672ae34f8b06fb346c4f9f46ea714956660ea4862e89ac"},
    {file = "pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:14d4edf427bdcf950a8a02d7cb44a08614388dd6e1bdcbf4f67504fa7887da9c"},
    {file = "pydantic_core-2.46.4-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:0ce40cd7b21210e99342afafbd4d0f76d784eb5b1d60f3bdc566be4983c6c73b"},
    {file = "pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:90884113d8b48f760e9587002789ddd741e76ab9f89518cd1e43b1f1a52ec44b"},
    {file = "pydantic_core-2.46.4-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:66ce7632c22d837c95301830e111ad0128a32b8207533b60896a96c4915192ea"},
    {file = "pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:1d8ba486450b14f3b1d63bc521d410ec7565e52f887b9fb671791886436a42f7"},
    {file = "pydantic_core-2.46.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:3009f12e4e90b7f88b4f9adb1b0c4a3d58fe7820f3238c190047209d148026df"},
    {file = "pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ad785e92e6dc634c21555edc8bd6b64957ab844541bcb96a1366c202951ae526"},
    {file = "pydantic_core-2.46.4-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00c603d540afdd6b80eb39f078f33ebd46211f02f33e34a32d9f053bba711de0"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:0c563b08bca408dc7f65f700633d8442fffb2421fc47b8101377e9fd65051ff0"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:db06ffe51636ffe9ca531fe9023dd64bdd794be8754cb5df57c5498ae5b518a7"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:133878133d271ade3d41d1bfb2a45ec38dbdbda40bc065921c6b04e4630127e2"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9bc519fbf2b7578398853d815009ae5e4d4603d12f4e3f91da8c06852d3da3e9"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:c7a7bd4e39e8e4c12c39cd480356842b6a8a06e41b23a55a5e3e191718838ddf"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:d396ec2b979760aaf3218e76c24e65bd0aca24983298653b3a9d7a45f9e47b30"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:86e1a4418c6cd97d60c95c71164158eaf7324fae7b0923264016baa993eba6fc"},
    {file = "pydantic_core-2.46.4-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:d51026d73fcfd93610abc7b27789c26b313920fcfb20e27462d74a7f8b06e983"},
    {file = "pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1"},
]

[package.dependencies]
typing-extensions = ">=4.14.1"

[[package]]
name = "pygments"
version = "2.20.0"
description = "Pygments is a syntax highlighting package written in Python."
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
    {file = "pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176"},
    {file = "pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f"},
]

[package.extras]
windows-terminal = ["colorama (>=0.4.6)"]

[[package]]
name = "pytest"
version = "8.4.2"
description = "pytest: simple powerful testing with Python"
optional = false
python-versions = ">=3.9"
groups = ["dev"]
files = [
    {file = "pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79"},
    {file = "pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01"},
]

[package.dependencies]
colorama = {version = ">=0.4", markers = "sys_platform == \"win32\""}
iniconfig = ">=1"
packaging = ">=20"
pluggy = ">=1.5,<2"
pygments = ">=2.7.2"

[package.extras]
dev = ["argcomplete", "attrs (>=19.2)", "hypothesis (>=3.56)", "mock", "requests", "setuptools", "xmlschema"]

[[package]]
name = "python-dotenv"
version = "1.2.2"
description = "Read key-value pairs from a .env file and set them as environment variables"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a"},
    {file = "python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3"},
]

[package.extras]
cli = ["click (>=5.0)"]

[[package]]
name = "pyyaml"
version = "6.0.3"
description = "YAML parser and emitter for Python"
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "PyYAML-6.0.3-cp38-cp38-macosx_10_13_x86_64.whl", hash = "sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f"},
    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4"},
    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3"},
    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6"},
    {file = "PyYAML-6.0.3-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369"},
    {file = "PyYAML-6.0.3-cp38-cp38-win32.whl", hash = "sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295"},
    {file = "PyYAML-6.0.3-cp38-cp38-win_amd64.whl", hash = "sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b"},
    {file = "pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b"},
    {file = "pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956"},
    {file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8"},
    {file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198"},
    {file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b"},
    {file = "pyyaml-6.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0"},
    {file = "pyyaml-6.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69"},
    {file = "pyyaml-6.0.3-cp310-cp310-win32.whl", hash = "sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e"},
    {file = "pyyaml-6.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c"},
    {file = "pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e"},
    {file = "pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824"},
    {file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c"},
    {file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00"},
    {file = "pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d"},
    {file = "pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a"},
    {file = "pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4"},
    {file = "pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b"},
    {file = "pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf"},
    {file = "pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196"},
    {file = "pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0"},
    {file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28"},
    {file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c"},
    {file = "pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc"},
    {file = "pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e"},
    {file = "pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea"},
    {file = "pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5"},
    {file = "pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b"},
    {file = "pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd"},
    {file = "pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8"},
    {file = "pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1"},
    {file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c"},
    {file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5"},
    {file = "pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6"},
    {file = "pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6"},
    {file = "pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be"},
    {file = "pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26"},
    {file = "pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c"},
    {file = "pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb"},
    {file = "pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac"},
    {file = "pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310"},
    {file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7"},
    {file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788"},
    {file = "pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5"},
    {file = "pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764"},
    {file = "pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35"},
    {file = "pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac"},
    {file = "pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3"},
    {file = "pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3"},
    {file = "pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba"},
    {file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c"},
    {file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702"},
    {file = "pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c"},
    {file = "pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065"},
    {file = "pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65"},
    {file = "pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9"},
    {file = "pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b"},
    {file = "pyyaml-6.0.3-cp39-cp39-macosx_10_13_x86_64.whl", hash = "sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da"},
    {file = "pyyaml-6.0.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917"},
    {file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9"},
    {file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5"},
    {file = "pyyaml-6.0.3-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a"},
    {file = "pyyaml-6.0.3-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926"},
    {file = "pyyaml-6.0.3-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7"},
    {file = "pyyaml-6.0.3-cp39-cp39-win32.whl", hash = "sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0"},
    {file = "pyyaml-6.0.3-cp39-cp39-win_amd64.whl", hash = "sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007"},
    {file = "pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f"},
]

[[package]]
name = "redis"
version = "8.0.1"
description = "Python client for Redis database and key-value store"
optional = false
python-versions = ">=3.10"
groups = ["main", "dev"]
files = [
    {file = "redis-8.0.1-py3-none-any.whl", hash = "sha256:47daa35a058c23468d6437f17a8c76882cb316b838ef763036af99b96cedd743"},
    {file = "redis-8.0.1.tar.gz", hash = "sha256:afc5a7a2f5a084f5b1880dec548dd45be17db7e43c82a30d84f952aefb05cfb0"},
]

[package.extras]
circuit-breaker = ["pybreaker (>=1.4.0)"]
hiredis = ["hiredis (>=3.2.0)"]
jwt = ["pyjwt (>=2.13.0)"]
ocsp = ["cryptography (>=36.0.1)", "pyopenssl (>=20.0.1)", "requests (>=2.31.0)"]
otel = ["opentelemetry-api (>=1.39.1)", "opentelemetry-exporter-otlp-proto-http (>=1.39.1)", "opentelemetry-sdk (>=1.39.1)"]
xxhash = ["xxhash (>=3.6.0,<3.7.0)"]

[[package]]
name = "regex"
version = "2026.7.19"
description = "Alternative regular expression module, to replace re."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "regex-2026.7.19-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:555497390743af1a65045fa4527782d10ff5b88970359412baa4a1e628fe393b"},
    {file = "regex-2026.7.19-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:343a4504e3fb688c47cad451221ca5d4814f42b1e16c0065bde9cbf7f473bd52"},
    {file = "regex-2026.7.19-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5ebee1ee89c39c953baac6924fcde08c5bb427c4057510862f9d7c7bdb3d8665"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:062f8cb7a9739c4835d22bd96f370c59aba89f257adcfa53be3cc209e08d3ae0"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1123ef4211d763ee771d47916a1596e2f4915794f7aabdc1adcb20e4249a6951"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6e44c0e7c5664be20aee92085153150c0a7967310a73a43c0f832b7cd35d0dd3"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:98c6ac18480fcdb33f35439183f1d2e79760ab41930309c6d951cb1f8e46694c"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4458124d71339f505bf1fb94f69fd1bb8fa9d2481eebfef27c10ef4f2b9e12f6"},
    {file = "regex-2026.7.19-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fbf300e2070bb35038660b3be1be4b91b0024edb41517e6996320b49b92b4175"},
    {file = "regex-2026.7.19-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b2b506b1788df5fecd270a10d5e70a95fe77b87ea2b370a318043f6f5f817ee6"},
    {file = "regex-2026.7.19-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:52579c60a6078be70a0e49c81d6e56d677f34cd439af281a0083b8c7bc75c095"},
    {file = "regex-2026.7.19-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:2955907b7157a6660f27079edf7e0229e9c9c5325c77a2ef6a890cba91efa6f0"},
    {file = "regex-2026.7.19-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:89dfee3319f5ae3f75ebd5c2445a809bb320252ba5529ffdafea4ef25d79cf1a"},
    {file = "regex-2026.7.19-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:3d3143f159261b1ce5b24c261c590e5913370c3200c5e9ebbb92b5aa5e111902"},
    {file = "regex-2026.7.19-cp310-cp310-win32.whl", hash = "sha256:64729333167c2dcaaa56a331d40ee097bd9c5617ffd51dabb09eaddafb1b532e"},
    {file = "regex-2026.7.19-cp310-cp310-win_amd64.whl", hash = "sha256:1c398716054621aa300b3d411f467dda903806c5da0df6945ab73982b8d115db"},
    {file = "regex-2026.7.19-cp310-cp310-win_arm64.whl", hash = "sha256:064f1760a5a4ade65c5419be23e782f29147528e8a66e0c42dd4cedb8d4e9fc6"},
    {file = "regex-2026.7.19-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ac777001cdfc28b72477d93c8564bb7583081ea8fb45cdca3d568e0a4f87183c"},
    {file = "regex-2026.7.19-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:59787bd5f8c70aa339084e961d2996b53fbdeab4d5393bba5c1fe1fc32e02bae"},
    {file = "regex-2026.7.19-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:90c633e7e8d6bf4e992b8b36ce69e018f834b641dd6de8cea6d78c06ffa119c5"},
    {file = "regex-2026.7.19-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:87ccab0db8d5f4fbb0272642113c1adb2ffc698c16d3a0944580222331fa7a20"},
    {file = "regex-2026.7.19-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9e50d748a32da622f256e8d505867f5d3c43a837c6a9f0efb149655fadd1042a"},
    {file = "regex-2026.7.19-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bf1516fe58fc104f39b2d1dbe2d5e27d0cd45c4be2e42ba6ee0cc763701ec3c7"},
    {file = "regex-2026.7.19-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:09f3e5287f94f17b709dc9a9e70865855feee835c861613be144218ce4ca82cc"},
    {file = "regex-2026.7.19-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:6383cd2ed53a646c659ba1fe65727db76437fdaa069e697a0b44a51d5843d864"},
    {file = "regex-2026.7.19-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:09d3007fc76249a83cdd33de160d50e6cb77f54e09d8fa9e7148e10607ce24af"},
    {file = "regex-2026.7.19-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:6f8c6e7a1cfa3dc9d0ee2de0e65e834537fa29992cc3976ffec914afc35c5dd5"},
    {file = "regex-2026.7.19-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:b2ea4a3e8357be8849e833beeae757ac3c7a6b3fc055c03c808a53c91ad30d82"},
    {file = "regex-2026.7.19-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:80115dd39481fd3a4b4080220799dbcacb921a844de4b827264ececacbe17c78"},
    {file = "regex-2026.7.19-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d6ce43a0269d68cee79a7d1ade7def53c20f8f2a047b92d7b5d5bcc73ae88327"},
    {file = "regex-2026.7.19-cp311-cp311-win32.whl", hash = "sha256:9be2a6647740dd3cca6acb24e87f03d7632cd280dbce9bbe40c26353a215a45d"},
    {file = "regex-2026.7.19-cp311-cp311-win_amd64.whl", hash = "sha256:8d3469c91dd92ee41b7c95280edbd975ef1ba9195086686623a1c6e8935ce965"},
    {file = "regex-2026.7.19-cp311-cp311-win_arm64.whl", hash = "sha256:36aacfb15faaff3ced55afbf35ec72f50d4aee22082c4f7fe0573a33e2fca92e"},
    {file = "regex-2026.7.19-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:2cc3460cedf7579948486eab03bc9ad7089df4d7281c0f47f4afe03e8d13f02d"},
    {file = "regex-2026.7.19-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:0e9554c8785eac5cffe6300f69a91f58ba72bc88a5f8d661235ad7c6aa5b8ccd"},
    {file = "regex-2026.7.19-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:d7da47a0f248977f08e2cb659ff3c17ddc13a4d39b3a7baa0a81bf5b415430f6"},
    {file = "regex-2026.7.19-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:93db40c8de0815baab96a06e08a984bac71f989d13bab789e382158c5d426797"},
    {file = "regex-2026.7.19-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:66bd62c59a5427746e8c44becae1d9b99d22fb13f30f492083dfb9ad7c45cc18"},
    {file = "regex-2026.7.19-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1649eb39fcc9ea80c4d2f110fde2b8ab2aef3877b98f02ab9b14e961f418c511"},
    {file = "regex-2026.7.19-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9dce8ec9695f531a1b8a6f314fd4b393adcccf2ea861db480cdf97a301d01a68"},
    {file = "regex-2026.7.19-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3080a7fd38ef049bd489e01c970c97dd84ff446a885b0f1f6b26d9b1ad13ce11"},
    {file = "regex-2026.7.19-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1d793a7988e04fcb1e2e135567443d82173225d657419ec09414a9b5a145b986"},
    {file = "regex-2026.7.19-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:e8b0abe7d870f53ca5143895fef7d1041a0c831a140d3dc2c760dd7ba25d4a8b"},
    {file = "regex-2026.7.19-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:4e5413bd5f13d3a4e3539ca98f70f75e7fca92518dd7f117f030ebedd10b60cb"},
    {file = "regex-2026.7.19-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:73b133a9e6fb512858e7f065e96f1180aa46646bc74a83aea62f1d314f3dd035"},
    {file = "regex-2026.7.19-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:dbe6493fbd27321b1d1f2dd4f5c7e5bd4d8b1d7cab7f32fd67db3d0b2ed8248a"},
    {file = "regex-2026.7.19-cp312-cp312-win32.whl", hash = "sha256:ddd67571c10869f65a5d7dde536d1e066e306cc90de57d7de4d5f34802428bb5"},
    {file = "regex-2026.7.19-cp312-cp312-win_amd64.whl", hash = "sha256:e30d40268a28d54ce0437031750497004c22602b8e3ab891f759b795a003b312"},
    {file = "regex-2026.7.19-cp312-cp312-win_arm64.whl", hash = "sha256:de9208bb427130c82a5dbfd104f92c8876fc9559278c880b3002755bbbe9c83d"},
    {file = "regex-2026.7.19-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:f035d9dc1d25eff9d361456572231c7d27b5ccd473ca7dc0adfce732bd006d40"},
    {file = "regex-2026.7.19-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c42572142ed0b9d5d261ba727157c426510da78e20828b66bbb855098b8a4e38"},
    {file = "regex-2026.7.19-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:40b34dd88658e4fedd2fddbf0275ac970d00614b731357f425722a3ed1983d11"},
    {file = "regex-2026.7.19-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0c41c63992bf1874cebb6e7f56fd7d3c007924659a604ae3d90e427d40d4fd13"},
    {file = "regex-2026.7.19-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1d3372064506b94dd2c67c845f2db8062e9e9ba84d04e33cb96d7d33c11fe1ae"},
    {file = "regex-2026.7.19-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:fce7760bf283405b2c7999cab3da4e72f7deca6396013115e3f7a955db9760da"},
    {file = "regex-2026.7.19-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c0d702548d89d572b2929879bc883bb7a4c4709efafe4512cadee56c55c9bd15"},
    {file = "regex-2026.7.19-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d446c6ac40bb6e05025ccee55b84d80fe9bf8e93010ffc4bb9484f13d498835f"},
    {file = "regex-2026.7.19-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4c3501bfa814ab07b5580741f9bf78dfdfe146a04057f82df9e2402d2a975939"},
    {file = "regex-2026.7.19-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:c4585c3e64b4f9e583b4d2683f18f5d5d872b3d71dcf24594b74ecc23602fa96"},
    {file = "regex-2026.7.19-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:571fde9741eb0ccde23dd4e0c1d50fbae910e901fa7e629faf39b2dda740d220"},
    {file = "regex-2026.7.19-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:15b364b9b98d6d2fe1a85034c23a3180ff913f46caddc3895f6fd65186255ccc"},
    {file = "regex-2026.7.19-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ffd8893ccc1c2fce6e0d6ca402d716fe1b29db70c7132609a05955e31b2aa8f2"},
    {file = "regex-2026.7.19-cp313-cp313-win32.whl", hash = "sha256:f0fa4fa9c3632d708742baf2282f2055c11d888a790362670a403cbf48a2c404"},
    {file = "regex-2026.7.19-cp313-cp313-win_amd64.whl", hash = "sha256:d51ffd3427640fa2da6ade574ceba932f210ad095f65fcc450a2b0a0d454868e"},
    {file = "regex-2026.7.19-cp313-cp313-win_arm64.whl", hash = "sha256:c670fe7be5b6020b76bc6e8d2196074657e1327595bca93a389e1a76ab130ad8"},
    {file = "regex-2026.7.19-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:db47b561c9afd884baa1f96f797c9ca369872c4b65912bc691cfa99e68340af2"},
    {file = "regex-2026.7.19-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:65dcd28d3eba2ab7c2fd906485cc301392b47cc2234790d27d4e4814e02cdfda"},
    {file = "regex-2026.7.19-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:f2e7f8e2ab6c2922be02c7ec45185aa5bd771e2e57b95455ee343a44d8130dff"},
    {file = "regex-2026.7.19-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fe31f28c94402043161876a258a9c6f757cb485905c7614ce8d6cd40e6b7bdc1"},
    {file = "regex-2026.7.19-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f8f6fa298bb4f7f58a33334406218ba74716e68feddf5e4e54cd5d8082705abf"},
    {file = "regex-2026.7.19-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:cc1b2440423a851fad781309dd87843868f4f66a6bcd1ddb9225cf4ec2c84732"},
    {file = "regex-2026.7.19-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8ac59a0900474a52b7c04af8196affc22bd9842acb0950df12f7b813e983609a"},
    {file = "regex-2026.7.19-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4896db1f4ce0576765b8272aa922df324e0f5b9bb2c3d03044ff32a7234a9aba"},
    {file = "regex-2026.7.19-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:4e6883a021db30511d9fb8cfb0f222ce1f2c369f7d4d8b0448f449a93ba0bdfc"},
    {file = "regex-2026.7.19-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:09523a592938aa9f587fb74467c63ff0cf88fc3df14c82ab0f0517dcf76aaa62"},
    {file = "regex-2026.7.19-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:1ebac3474b8589fce2f9b225b650afd61448f7c73a5d0255a10cc6366471aed1"},
    {file = "regex-2026.7.19-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:4a0530bb1b8c1c985e7e2122e2b4d3aedd8a3c21c6bfddae6767c4405668b56e"},
    {file = "regex-2026.7.19-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:2ef7eeb108c47ce7bcc9513e51bcb1bf57e8f483d52fce68a8642e3527141ae0"},
    {file = "regex-2026.7.19-cp313-cp313t-win32.whl", hash = "sha256:64b6ca7391a1395c2638dd5c7456d67bea44fc6c5e8e92c5dc8aa6a8f23292b4"},
    {file = "regex-2026.7.19-cp313-cp313t-win_amd64.whl", hash = "sha256:f04b9f56b0e0614c0126be12c2c2d9f8850c1e57af302bd0a63bed379d4af974"},
    {file = "regex-2026.7.19-cp313-cp313t-win_arm64.whl", hash = "sha256:fcee38cd8e5089d6d4f048ba1233b3ad76e5954f545382180889112ff5cb712d"},
    {file = "regex-2026.7.19-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:a81758ed242b861b72e778ba34d41366441a2e10b16b472784c88da2dea7e2dd"},
    {file = "regex-2026.7.19-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:4aa5435cdb3eb6f55fe98a171b05e3fbcd95fadaa4aa32acf62afd9b0cfdbcac"},
    {file = "regex-2026.7.19-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:60be8693a1dadc210bbcbc0db3e26da5f7d01d1d5a3da594e99b4fa42df404f5"},
    {file = "regex-2026.7.19-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d19662dbedbe783d323196312d38f5ba53cf56296378252171985da6899887d3"},
    {file = "regex-2026.7.19-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d15df07081d91b76ff20d43f94592ee110330152d617b730fdbe5ef9fb680053"},
    {file = "regex-2026.7.19-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:56ad4d9f77df871a99e25c37091052a02528ec0eb059de928ee33956b854b45b"},
    {file = "regex-2026.7.19-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7322ec6cc9fba9d49ab888bb82d67ac5625627aa168f0165139b17018df3fb8a"},
    {file = "regex-2026.7.19-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9c7472192ebfad53a6be7c4a8bfb2d64b81c0e93a1fc8c57e1dd0b638297b5d1"},
    {file = "regex-2026.7.19-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c10b82c2634df08dfb13b1f04e38fe310d086ee092f4f69c0c8da234251e556e"},
    {file = "regex-2026.7.19-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:17ed5692f6acc4183e98331101a5f9e4f64d72fe58b753da4d444a2c77d05b12"},
    {file = "regex-2026.7.19-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:22a992de9a0d91bda927bf02b94351d737a0302905432c88a53de7c4b9ce62e2"},
    {file = "regex-2026.7.19-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:618a0aed532be87294c4477b0481f3aa0f1520f4014a4374dd4cf789b4cd2c97"},
    {file = "regex-2026.7.19-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2ce9e679f776649746729b6c86382da519ef649c8e34cc41df0d2e5e0f6c36d4"},
    {file = "regex-2026.7.19-cp314-cp314-win32.whl", hash = "sha256:73f272fba87b8ccfe70a137d02a54af386f6d27aa509fbffdd978f5947aae1aa"},
    {file = "regex-2026.7.19-cp314-cp314-win_amd64.whl", hash = "sha256:d721e53758b2cca74990185eb0671dd466d7a388a1a45d0c6f4c13cef41a68ac"},
    {file = "regex-2026.7.19-cp314-cp314-win_arm64.whl", hash = "sha256:65fa6cb38ed5e9c3637e68e544f598b39c3b86b808ed0627a67b68320384b459"},
    {file = "regex-2026.7.19-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:5a2721c8720e2cb3c209925dfb9200199b4b07361c9e01d321719404b21458b3"},
    {file = "regex-2026.7.19-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:199535629f25caf89698039af3d1ad5fcae7f933e2112c73f1cdf49165c99518"},
    {file = "regex-2026.7.19-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:9b60d7814174f059e5de4ab98271cc5ba9259cfea55273a81544dceea32dc8d9"},
    {file = "regex-2026.7.19-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dbece16025afda5e3031af0c4059207e61dcf73ef13af844964f57f387d1c435"},
    {file = "regex-2026.7.19-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d24ecb4f5e009ea0bd275ee37ad9953b32005e2e5e60f8bbae16da0dbbf0d3a0"},
    {file = "regex-2026.7.19-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8cae6fd77a5b72dae505084b1a2ee0360139faf72fedbab667cd7cc65aae7a6a"},
    {file = "regex-2026.7.19-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9724e6cb5e478cd7d8cabf027826178739cb18cf0e117d0e32814d479fa02276"},
    {file = "regex-2026.7.19-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:572fc57b0009c735ee56c175ea021b637a15551a312f56734277f923d6fd0f6c"},
    {file = "regex-2026.7.19-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:20568e182eb82d39a6bf7cff3fd58566f14c75c6f74b2c8c96537eecf9010e3a"},
    {file = "regex-2026.7.19-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:1d58561843f0ff7dc78b4c28b5e2dc388f3eff94ebc8a232a3adba961fc00009"},
    {file = "regex-2026.7.19-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:61bb1bd45520aacd56dd80943bd34991fb5350afdd1f36f2282230fd5154a218"},
    {file = "regex-2026.7.19-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:cd3584591ea4429026cdb931b054342c2bcf189b44ff367f8d5c15bc092a2966"},
    {file = "regex-2026.7.19-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5cc26a66e212fa5d6c6170c3a40d99d888db3020c6fdab1523250d4341382e44"},
    {file = "regex-2026.7.19-cp314-cp314t-win32.whl", hash = "sha256:2c4e61e2e1be56f63ec3cc618aa9e0de81ef6f43d177205451840022e24f5b78"},
    {file = "regex-2026.7.19-cp314-cp314t-win_amd64.whl", hash = "sha256:c639ea314df70a7b2811e8020448c75af8c9445f5a60f8a4ced81c306a9380c2"},
    {file = "regex-2026.7.19-cp314-cp314t-win_arm64.whl", hash = "sha256:9a15e785f244f3e07847b984ce8773fc3da10a9f3c131cc49a4c5b4d672b4547"},
    {file = "regex-2026.7.19.tar.gz", hash = "sha256:7e77b324909c1617cbb4c668677e2c6ae13f44d7c1de0d4f15f2e3c10f3315b5"},
]

[[package]]
name = "requests"
version = "2.34.2"
description = "Python HTTP for Humans."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "requests-2.34.2-py3-none-any.whl", hash = "sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0"},
    {file = "requests-2.34.2.tar.gz", hash = "sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed"},
]

[package.dependencies]
certifi = ">=2023.5.7"
charset_normalizer = ">=2,<4"
idna = ">=2.5,<4"
urllib3 = ">=1.26,<3"

[package.extras]
socks = ["PySocks (>=1.5.6,!=1.5.7)"]
use-chardet-on-py3 = ["chardet (>=3.0.2,<8)"]

[[package]]
name = "requests-toolbelt"
version = "1.0.0"
description = "A utility belt for advanced users of python-requests"
optional = false
python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
groups = ["main"]
files = [
    {file = "requests-toolbelt-1.0.0.tar.gz", hash = "sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6"},
    {file = "requests_toolbelt-1.0.0-py2.py3-none-any.whl", hash = "sha256:cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06"},
]

[package.dependencies]
requests = ">=2.0.1,<3.0.0"

[[package]]
name = "rlp"
version = "4.1.0"
description = "rlp: A package for Recursive Length Prefix encoding and decoding"
optional = false
python-versions = "<4,>=3.8"
groups = ["main"]
files = [
    {file = "rlp-4.1.0-py3-none-any.whl", hash = "sha256:8eca394c579bad34ee0b937aecb96a57052ff3716e19c7a578883e767bc5da6f"},
    {file = "rlp-4.1.0.tar.gz", hash = "sha256:be07564270a96f3e225e2c107db263de96b5bc1f27722d2855bd3459a08e95a9"},
]

[package.dependencies]
eth-utils = ">=2"

[package.extras]
dev = ["build (>=0.9.0)", "bump_my_version (>=0.19.0)", "hypothesis (>=6.22.0,<6.108.7)", "ipython", "pre-commit (>=3.4.0)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)", "sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)", "tox (>=4.0.0)", "twine", "wheel"]
docs = ["sphinx (>=6.0.0)", "sphinx-autobuild (>=2021.3.14)", "sphinx_rtd_theme (>=1.0.0)", "towncrier (>=24,<25)"]
rust-backend = ["rusty-rlp (>=0.2.1)"]
test = ["hypothesis (>=6.22.0,<6.108.7)", "pytest (>=7.0.0)", "pytest-xdist (>=2.4.0)"]

[[package]]
name = "sniffio"
version = "1.3.1"
description = "Sniff out which async library your code is running under"
optional = false
python-versions = ">=3.7"
groups = ["main"]
files = [
    {file = "sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2"},
    {file = "sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"},
]

[[package]]
name = "sortedcontainers"
version = "2.4.0"
description = "Sorted Containers -- Sorted List, Sorted Dict, Sorted Set"
optional = false
python-versions = "*"
groups = ["dev"]
files = [
    {file = "sortedcontainers-2.4.0-py2.py3-none-any.whl", hash = "sha256:a163dcaede0f1c021485e957a39245190e74249897e2ae4b2aa38595db237ee0"},
    {file = "sortedcontainers-2.4.0.tar.gz", hash = "sha256:25caa5a06cc30b6b83d11423433f65d1f9d76c4c6a0c90e3379eaa43b9bfdb88"},
]

[[package]]
name = "starlette"
version = "1.3.1"
description = "The little ASGI library that shines."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "starlette-1.3.1-py3-none-any.whl", hash = "sha256:c7372aae11c3c3f26a42df7bd626cec2f47d03483d261d369516a615a53714c6"},
    {file = "starlette-1.3.1.tar.gz", hash = "sha256:05d0213193f2fbaae60e2ecb593b4add4262ad4e46536b54abe36f11a71724e0"},
]

[package.dependencies]
anyio = ">=3.6.2,<5"
typing-extensions = {version = ">=4.10.0", markers = "python_version < \"3.13\""}

[package.extras]
full = ["httpx (>=0.27.0,<0.29.0)", "httpx2 (>=2.0.0)", "itsdangerous", "jinja2", "python-multipart (>=0.0.18)", "pyyaml"]

[[package]]
name = "tenacity"
version = "9.1.4"
description = "Retry code until it succeeds"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "tenacity-9.1.4-py3-none-any.whl", hash = "sha256:6095a360c919085f28c6527de529e76a06ad89b23659fa881ae0649b867a9d55"},
    {file = "tenacity-9.1.4.tar.gz", hash = "sha256:adb31d4c263f2bd041081ab33b498309a57c77f9acf2db65aadf0898179cf93a"},
]

[package.extras]
doc = ["reno", "sphinx"]
test = ["pytest", "tornado (>=4.5)", "typeguard"]

[[package]]
name = "toolz"
version = "1.1.0"
description = "List processing tools and functional utilities"
optional = false
python-versions = ">=3.9"
groups = ["main"]
markers = "implementation_name == \"pypy\" or implementation_name == \"cpython\""
files = [
    {file = "toolz-1.1.0-py3-none-any.whl", hash = "sha256:15ccc861ac51c53696de0a5d6d4607f99c210739caf987b5d2054f3efed429d8"},
    {file = "toolz-1.1.0.tar.gz", hash = "sha256:27a5c770d068c110d9ed9323f24f1543e83b2f300a687b7891c1a6d56b697b5b"},
]

[[package]]
name = "typing-extensions"
version = "4.16.0"
description = "Backported and Experimental Type Hints for Python 3.9+"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8"},
    {file = "typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5"},
]

[[package]]
name = "typing-inspection"
version = "0.4.2"
description = "Runtime typing introspection tools"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7"},
    {file = "typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464"},
]

[package.dependencies]
typing-extensions = ">=4.12.0"

[[package]]
name = "urllib3"
version = "2.7.0"
description = "HTTP library with thread-safe connection pooling, file post, and more."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "urllib3-2.7.0-py3-none-any.whl", hash = "sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897"},
    {file = "urllib3-2.7.0.tar.gz", hash = "sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c"},
]

[package.extras]
brotli = ["brotli (>=1.2.0) ; platform_python_implementation == \"CPython\"", "brotlicffi (>=1.2.0.0) ; platform_python_implementation != \"CPython\""]
h2 = ["h2 (>=4,<5)"]
socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""]

[[package]]
name = "uuid-utils"
version = "0.17.0"
description = "Fast, drop-in replacement for Python's uuid module, powered by Rust."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "uuid_utils-0.17.0-cp310-cp310-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:d2d9a63a9e6f2416ace8c109043a9280d6b34f34bb2e5421903e149403db40a6"},
    {file = "uuid_utils-0.17.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:b776c7fc8755c7de06dd5a22b47c40ae84f67d13277ebb233cc84933ba4dcbcd"},
    {file = "uuid_utils-0.17.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1edf2f8732e4ed95bd7b65f2658f4aa072efaaff321144f4e0d4bf6a22709263"},
    {file = "uuid_utils-0.17.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:84ed3a2d5cd3ae6db87af20bfed3331116195ba4757ad7177fc8f12c1bbce2a9"},
    {file = "uuid_utils-0.17.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4bf4d9cd1e80e73922073b9b27c143bedeb109d65f94cd12712e2c87118f2b7d"},
    {file = "uuid_utils-0.17.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:52db0e471d3d2632d35445af352591f40a8f32959a412981d9f51e068bb9514b"},
    {file = "uuid_utils-0.17.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:344f7c755e280ea0ba6aeb08022190d867a80000b1715cacded54fc4b5633607"},
    {file = "uuid_utils-0.17.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:589d9da7de8fa7f739bb970ac4632c9a268213117d634e1c4a58c1c1e821ca05"},
    {file = "uuid_utils-0.17.0-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:cee808b405e9095506f4e4e89924bec7ea77eac3129b6fe36eda04364b3b343b"},
    {file = "uuid_utils-0.17.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:53ce348ef4c6e98c02c19c522af01334fe94476ce9af0db8c4482f9f142ae9c1"},
    {file = "uuid_utils-0.17.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:9e753e81457241e2200c56a898e268e8fa25796271af0489c608f24d8e631eed"},
    {file = "uuid_utils-0.17.0-cp310-cp310-win32.whl", hash = "sha256:c589f5023d471ce75dd2cce61acb25ed6347e562041588a1a366808f22d7176c"},
    {file = "uuid_utils-0.17.0-cp310-cp310-win_amd64.whl", hash = "sha256:981cc10163988defea96e8d6c507df151eab8f483e7df9ae543d5a41a4be073b"},
    {file = "uuid_utils-0.17.0-cp311-cp311-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:f9b093cb3b6c9d6233ef45a05cab064d2aa0a8cb3c5777084c9e20fcb77c2371"},
    {file = "uuid_utils-0.17.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:0bc4c431ccd59c764080ceb43b126043325fe17861b87759d026a0cdd8423bb2"},
    {file = "uuid_utils-0.17.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c00d182e31034250690f417b9068b78eab423c10d76766664e82d9860c340479"},
    {file = "uuid_utils-0.17.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:570db214f6d8507587a8faa968a3fe65e957daeb7bc48b27dc7f69bc3ecdd6f1"},
    {file = "uuid_utils-0.17.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:351462debd866f1f25e4d4f5c7fac89525b52151f0102a1bdfe94a999b046f5f"},
    {file = "uuid_utils-0.17.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:622cdde768300591ac79bfcd7bb3468e4b191b1105d5dbfe8d87c39d8f63dd46"},
    {file = "uuid_utils-0.17.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:75d7411e8eb9259764dd60310738540649057cda4509b4af14b36b7f663bfeb0"},
    {file = "uuid_utils-0.17.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1019476b6bdc047216ef7414be5babe0fa5ccfde977c0cac4fd6c75ddec66ff7"},
    {file = "uuid_utils-0.17.0-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:04452640d8b6920c480c16e5afe91ff896d236e0c972830f9247e0898d38c803"},
    {file = "uuid_utils-0.17.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:793229621e1ad6cac55f015cfa9f4eff102accbc3da25d607b91c6b0bec167fb"},
    {file = "uuid_utils-0.17.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:03815cea572c8a693cab5475b9d750cc161470961c7defa27e9286cad62f38f5"},
    {file = "uuid_utils-0.17.0-cp311-cp311-win32.whl", hash = "sha256:c4f845166b09acc65c5213a35551a7f81c17fa010ab467229b5813f79d17fe13"},
    {file = "uuid_utils-0.17.0-cp311-cp311-win_amd64.whl", hash = "sha256:14dc2f46abb1091260c0d203fcbdf4e045042cc07e49183fd3b255904b95eb70"},
    {file = "uuid_utils-0.17.0-cp311-cp311-win_arm64.whl", hash = "sha256:29179ffb7b317239b6d6afb100d14c439c728770460718280b9c0a42d2561ec2"},
    {file = "uuid_utils-0.17.0-cp312-cp312-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:9205068badf453d2f0821fd5d340389b4679992d7ff79d4f3e5608996dd1b287"},
    {file = "uuid_utils-0.17.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:0fcca4e838af9ac9243b3358d7c14afa4dca286a87781124c272d6c4cad9c968"},
    {file = "uuid_utils-0.17.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0f3729e839209f3457d0d8b6a35a376fdf65577a5aecaf4cc3587d3305759ba6"},
    {file = "uuid_utils-0.17.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3dac0ad0cd9a2818d1775215365a4e8c2f8ada215529dd26f3f8cceeb67a6988"},
    {file = "uuid_utils-0.17.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e671b2322ef09106ecb1ca0f4c398b134d5e2c1f80d7a4f3336847a3072c0e94"},
    {file = "uuid_utils-0.17.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8eb3e5caca8d3a6f72ea4cce024583f989f6f2e9186f98800213fff0176e8bcc"},
    {file = "uuid_utils-0.17.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8b72c2002202038666bf647f9a790906214c7c11cd0d6efef77b7d07bef3034a"},
    {file = "uuid_utils-0.17.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:4e2ac1c0b56f2c91b6f158e29ed96b1503223fe8aa6e79b1be1dc55bd8a5131c"},
    {file = "uuid_utils-0.17.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:6c142bd0cb4dba31c10babe00d59f7ef6460f0ef55eaa9c1a9da270684af996a"},
    {file = "uuid_utils-0.17.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:e252db239eb41c32248e096e0d170bce5896a4fd3405556362bc3dd83d912206"},
    {file = "uuid_utils-0.17.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:237722b6581bb5b4eb4cefbcbe5c6e2980a440aabe781fbe50ebf1cb71eee4cc"},
    {file = "uuid_utils-0.17.0-cp312-cp312-win32.whl", hash = "sha256:46a73cacdf512f473a81f65dbf84186e08cfe6e9118fa582b6c6b33a8288a30d"},
    {file = "uuid_utils-0.17.0-cp312-cp312-win_amd64.whl", hash = "sha256:e59b60a0a4cb7541480e02090d37dc2df3b72df4c2e776fff64ce3a4e3dd4637"},
    {file = "uuid_utils-0.17.0-cp312-cp312-win_arm64.whl", hash = "sha256:d561a4c5747a1e6c7fa7c49a0292e78b4e8c456332caa084fc7abad8de828652"},
    {file = "uuid_utils-0.17.0-cp313-cp313-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:d11a7bc1e02da8984d32e6de9e0826c6edac00eac17de270f372bf32f9a0af63"},
    {file = "uuid_utils-0.17.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:7a49f47ac26df3e431c56b825c1bae8e6d3d591fdbb7438c227cc9845a7e3d73"},
    {file = "uuid_utils-0.17.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:32df1944808877702ceea398c103881c09a679bb672a215e01c2a84231266bf9"},
    {file = "uuid_utils-0.17.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:98c88d3edd08e7245562e9815996dbc6f0bd4745e1c76462f24af5ae4e187dd1"},
    {file = "uuid_utils-0.17.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5a4370089c8b2e42f1db51d76408c7fa8eaa2934bf854d17983d16179c07c098"},
    {file = "uuid_utils-0.17.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:09a55b7a5ae764985cb46467496a1787678d0a1400356157a080ad95b1a36869"},
    {file = "uuid_utils-0.17.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:56aa6488b931246fae11924e4bd0e2b32677e63945eecb71c29e3c2ca0dc3131"},
    {file = "uuid_utils-0.17.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:309a35f12d99dde19032bc2259cda6431c85eeac0879134dc777cc3087d7e1cb"},
    {file = "uuid_utils-0.17.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:21c79b61ff750abcf057163dd764ccb6196cde7a26cda1b31b45cd97769e03b3"},
    {file = "uuid_utils-0.17.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:4134353bfe3026ddab8e886002dc52bc5a0ab04611aabb0eaae23c32e6e57f64"},
    {file = "uuid_utils-0.17.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:7c89359affecebe2e39e6a116d069b363c936511a9572b308402489a26957d89"},
    {file = "uuid_utils-0.17.0-cp313-cp313-pyemscripten_2025_0_wasm32.whl", hash = "sha256:6a019a31bc4db89a0903a3e4f6b218571f3a6ff0ad4b3d3fe1c8f91a05ff6e3e"},
    {file = "uuid_utils-0.17.0-cp313-cp313-win32.whl", hash = "sha256:b3131a82d0c7611f0aa480a6d36929e001a3f54ba0fc029a8118a5863cce513c"},
    {file = "uuid_utils-0.17.0-cp313-cp313-win_amd64.whl", hash = "sha256:9e311f908d2f842fca4c7dcebc4f10306b8089b204ef04cf6704b4332c9ff6ff"},
    {file = "uuid_utils-0.17.0-cp313-cp313-win_arm64.whl", hash = "sha256:c351737e2e65497c7200ab4ffb8af97e9f48be6488309abdd265fe08d66ee92f"},
    {file = "uuid_utils-0.17.0-cp314-cp314-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:673d89cc434cc9b97a0b4cf61272f6fca70a81f64eb0afbface2a0d9f77f06cd"},
    {file = "uuid_utils-0.17.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:387cf7437c94ddec08651a0f1081381299c7075bc48a6251d8922bf39973378a"},
    {file = "uuid_utils-0.17.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:220b52746d99e11964badac3c0869016e0c24bafb70a7dd5c2c072a6be3da9cc"},
    {file = "uuid_utils-0.17.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0ab4a66e7a035ad6625cfc1fbdb34f5c2d25a80ae1ef4bfee458ea2036333c6d"},
    {file = "uuid_utils-0.17.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5641071337eb11d61a001ea08793bf72216f3241f0a433ed2764804b2a3e3cc7"},
    {file = "uuid_utils-0.17.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9082e709014946b1f6e96ae6ecd93652efca2d2a6a3ab67dbe151c8b4bf193a4"},
    {file = "uuid_utils-0.17.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1fd6f0e8a162dc0e9255b6aebe3cd175e76c33202f1bf39da9e6294b93db0099"},
    {file = "uuid_utils-0.17.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:d63010803d7c368963bbe6f7ec379593e76dd581d7db0f29118d88713c9e0354"},
    {file = "uuid_utils-0.17.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:a46bedc273b6f58f11dee816ff74999625ef8d007890f411b7a4975bf1c89330"},
    {file = "uuid_utils-0.17.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:405233a5f625b3d995648f4647fa6befa4567cf3f74e1f6b9837e16f7310f0e0"},
    {file = "uuid_utils-0.17.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b6c5d2d71e1f17329150ad9427d27f4a3f29a01792e7ecdc64a98ac5368fc4d5"},
    {file = "uuid_utils-0.17.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:f7e9b8728ba07a3cb2f29d5aa1a266c2664eb8ef0fd43afa34627c92f7fac8f0"},
    {file = "uuid_utils-0.17.0-cp314-cp314-win32.whl", hash = "sha256:58838921e377791ef22c64cc92141bfae030f43651ff9272f0f28a208a9e6a5a"},
    {file = "uuid_utils-0.17.0-cp314-cp314-win_amd64.whl", hash = "sha256:42275ebd0e8e74e32cdbfb8bd88fc99576567d51d54a508020611fd8f4f463a0"},
    {file = "uuid_utils-0.17.0-cp314-cp314-win_arm64.whl", hash = "sha256:b5d11cccba076a32321ef1380dea956821f0b51794ef59df64e58fb1cd543aae"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:fae8b282f0cb22a5de222999f7723f4e5ec04f6fcdf4aaef879b5b36625ae2b0"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:967955620df45e6cffe2e9950cb9903cb455649396f896b26b04363a91a5054b"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:375cde148430d60a4a07c03abaa0774c4fddfdd90de99b4ba02f24088bc9d750"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:975c17da26c5b9d46c336b03c52a057ac28378d6f9d98b58d32a038589bb3912"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3150d836290c88f1d26eb59c4db280d87417dd3bfaadd2889c77416c8f0ff6fa"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9472a8de37faf8bd216c628e0e68c8f6bef730d3ba0a5060f3b0fa460c992ac2"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d27c531edb8d1f38ca2eddaa1fa24913a460aeb721f2efd4ef42a124ce94e354"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5670c52a438e21483ce715776144914a4e2a2a5c62d9dee15f8a3e90cf128ae6"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:6f29689a76fe7a49cbd629a794d0ec1eab48814e323a00a146a741b0195bde68"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:4441600447d340ae103a353f01dbcd22ff680e5ee1a22988efe8d7b791d8fdb3"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:e7b04935a79c03c41ad08d0a5f390aac968bfb561f1268897bc5b0f077971efd"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-win32.whl", hash = "sha256:239d8a281fe10bae33205b5d43185834d556b18434e0a113b5dc1dfb2fd97e91"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-win_amd64.whl", hash = "sha256:e288a06cbbbcd01b44386e767985c9e21d2ad9bf59829aa7058d9a2a494804ab"},
    {file = "uuid_utils-0.17.0-cp314-cp314t-win_arm64.whl", hash = "sha256:1776a80d16369999b21627028cc5dbce819be83e1e079fdd7a51b587d2916db9"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:7b9044ce4acbf392d4b3a503fe377641f4deff82e6c341c36ef27af0dea76cdf"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:9a91c4814c7150a4d798da691b7804eacd78c4b84fb392a60fa0de21341861eb"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2dd4a21baaac9a88486f0dd166c5793feb101a0bb9f006f2c401657fff5a1343"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:32abaafc8e91928b3d9f4d82e42d2094041e38ad6bb964066faadff28e4162f1"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dd741c73440b328f937dc53b344ecadc46bc4f0cec0333a8f42b55f3468ce7ec"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:89a0980d49683c00539c59cd9f46b1908c538e6b5b0a48ad12187bb856d0f391"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:de1064663aa7c839286488a319d2b3b478ca5ab5b2091ade888ed0eeca11a98a"},
    {file = "uuid_utils-0.17.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:2db386941cfdecdd0b5a8ceeed5cf7479c83d1730dcf64a48d43cfa018cc3310"},
    {file = "uuid_utils-0.17.0.tar.gz", hash = "sha256:abb5667a36119019b3fa320c4d10c21ebccfcc87c8a739e6a0056cee7f48dde2"},
]

[[package]]
name = "uvicorn"
version = "0.51.0"
description = "The lightning-fast ASGI server."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "uvicorn-0.51.0-py3-none-any.whl", hash = "sha256:5d38af6cd620f2ae3849fb44fd4879e0890aa1febe8d47eb355fb45d93fe6a5b"},
    {file = "uvicorn-0.51.0.tar.gz", hash = "sha256:f6f4b69b657c312f516dd2d268ab9ae6f254b11e4bac504f37b2ab58b24dd0b0"},
]

[package.dependencies]
click = ">=7.0"
h11 = ">=0.8"
httptools = {version = ">=0.8.0", optional = true, markers = "extra == \"standard\""}
python-dotenv = {version = ">=0.13", optional = true, markers = "extra == \"standard\""}
pyyaml = {version = ">=5.1", optional = true, markers = "extra == \"standard\""}
uvloop = {version = ">=0.15.1", optional = true, markers = "sys_platform != \"win32\" and sys_platform != \"cygwin\" and platform_python_implementation != \"PyPy\" and extra == \"standard\""}
watchfiles = {version = ">=0.20", optional = true, markers = "extra == \"standard\""}
websockets = {version = ">=13.0", optional = true, markers = "extra == \"standard\""}

[package.extras]
standard = ["httptools (>=0.8.0)", "python-dotenv (>=0.13)", "pyyaml (>=5.1)", "uvloop (>=0.15.1) ; sys_platform != \"win32\" and sys_platform != \"cygwin\" and platform_python_implementation != \"PyPy\"", "watchfiles (>=0.20)", "websockets (>=13.0)"]

[[package]]
name = "uvloop"
version = "0.22.1"
description = "Fast implementation of asyncio event loop on top of libuv"
optional = false
python-versions = ">=3.8.1"
groups = ["main"]
markers = "sys_platform != \"win32\" and sys_platform != \"cygwin\" and platform_python_implementation != \"PyPy\""
files = [
    {file = "uvloop-0.22.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ef6f0d4cc8a9fa1f6a910230cd53545d9a14479311e87e3cb225495952eb672c"},
    {file = "uvloop-0.22.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:7cd375a12b71d33d46af85a3343b35d98e8116134ba404bd657b3b1d15988792"},
    {file = "uvloop-0.22.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac33ed96229b7790eb729702751c0e93ac5bc3bcf52ae9eccbff30da09194b86"},
    {file = "uvloop-0.22.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:481c990a7abe2c6f4fc3d98781cc9426ebd7f03a9aaa7eb03d3bfc68ac2a46bd"},
    {file = "uvloop-0.22.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a592b043a47ad17911add5fbd087c76716d7c9ccc1d64ec9249ceafd735f03c2"},
    {file = "uvloop-0.22.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:1489cf791aa7b6e8c8be1c5a080bae3a672791fcb4e9e12249b05862a2ca9cec"},
    {file = "uvloop-0.22.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:c60ebcd36f7b240b30788554b6f0782454826a0ed765d8430652621b5de674b9"},
    {file = "uvloop-0.22.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3b7f102bf3cb1995cfeaee9321105e8f5da76fdb104cdad8986f85461a1b7b77"},
    {file = "uvloop-0.22.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:53c85520781d84a4b8b230e24a5af5b0778efdb39142b424990ff1ef7c48ba21"},
    {file = "uvloop-0.22.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:56a2d1fae65fd82197cb8c53c367310b3eabe1bbb9fb5a04d28e3e3520e4f702"},
    {file = "uvloop-0.22.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:40631b049d5972c6755b06d0bfe8233b1bd9a8a6392d9d1c45c10b6f9e9b2733"},
    {file = "uvloop-0.22.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:535cc37b3a04f6cd2c1ef65fa1d370c9a35b6695df735fcff5427323f2cd5473"},
    {file = "uvloop-0.22.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:fe94b4564e865d968414598eea1a6de60adba0c040ba4ed05ac1300de402cd42"},
    {file = "uvloop-0.22.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:51eb9bd88391483410daad430813d982010f9c9c89512321f5b60e2cddbdddd6"},
    {file = "uvloop-0.22.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:700e674a166ca5778255e0e1dc4e9d79ab2acc57b9171b79e65feba7184b3370"},
    {file = "uvloop-0.22.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7b5b1ac819a3f946d3b2ee07f09149578ae76066d70b44df3fa990add49a82e4"},
    {file = "uvloop-0.22.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e047cc068570bac9866237739607d1313b9253c3051ad84738cbb095be0537b2"},
    {file = "uvloop-0.22.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:512fec6815e2dd45161054592441ef76c830eddaad55c8aa30952e6fe1ed07c0"},
    {file = "uvloop-0.22.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:561577354eb94200d75aca23fbde86ee11be36b00e52a4eaf8f50fb0c86b7705"},
    {file = "uvloop-0.22.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cdf5192ab3e674ca26da2eada35b288d2fa49fdd0f357a19f0e7c4e7d5077c8"},
    {file = "uvloop-0.22.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e2ea3d6190a2968f4a14a23019d3b16870dd2190cd69c8180f7c632d21de68d"},
    {file = "uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8000ea63704fa8260f4cf728e"},
    {file = "uvloop-0.22.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bc5ef13bbc10b5335792360623cc378d52d7e62c2de64660616478c32cd0598e"},
    {file = "uvloop-0.22.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f38ec5e3f18c8a10ded09742f7fb8de0108796eb673f30ce7762ce1b8550cad"},
    {file = "uvloop-0.22.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3879b88423ec7e97cd4eba2a443aa26ed4e59b45e6b76aabf13fe2f27023a142"},
    {file = "uvloop-0.22.1-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:4baa86acedf1d62115c1dc6ad1e17134476688f08c6efd8a2ab076e815665c74"},
    {file = "uvloop-0.22.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:297c27d8003520596236bdb2335e6b3f649480bd09e00d1e3a99144b691d2a35"},
    {file = "uvloop-0.22.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1955d5a1dd43198244d47664a5858082a3239766a839b2102a269aaff7a4e25"},
    {file = "uvloop-0.22.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b31dc2fccbd42adc73bc4e7cdbae4fc5086cf378979e53ca5d0301838c5682c6"},
    {file = "uvloop-0.22.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:93f617675b2d03af4e72a5333ef89450dfaa5321303ede6e67ba9c9d26878079"},
    {file = "uvloop-0.22.1-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:37554f70528f60cad66945b885eb01f1bb514f132d92b6eeed1c90fd54ed6289"},
    {file = "uvloop-0.22.1-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:b76324e2dc033a0b2f435f33eb88ff9913c156ef78e153fb210e03c13da746b3"},
    {file = "uvloop-0.22.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:badb4d8e58ee08dad957002027830d5c3b06aea446a6a3744483c2b3b745345c"},
    {file = "uvloop-0.22.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b91328c72635f6f9e0282e4a57da7470c7350ab1c9f48546c0f2866205349d21"},
    {file = "uvloop-0.22.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:daf620c2995d193449393d6c62131b3fbd40a63bf7b307a1527856ace637fe88"},
    {file = "uvloop-0.22.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6cde23eeda1a25c75b2e07d39970f3374105d5eafbaab2a4482be82f272d5a5e"},
    {file = "uvloop-0.22.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:80eee091fe128e425177fbd82f8635769e2f32ec9daf6468286ec57ec0313efa"},
    {file = "uvloop-0.22.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:017bd46f9e7b78e81606329d07141d3da446f8798c6baeec124260e22c262772"},
    {file = "uvloop-0.22.1-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c3e5c6727a57cb6558592a95019e504f605d1c54eb86463ee9f7a2dbd411c820"},
    {file = "uvloop-0.22.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:57df59d8b48feb0e613d9b1f5e57b7532e97cbaf0d61f7aa9aa32221e84bc4b6"},
    {file = "uvloop-0.22.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:55502bc2c653ed2e9692e8c55cb95b397d33f9f2911e929dc97c4d6b26d04242"},
    {file = "uvloop-0.22.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:4a968a72422a097b09042d5fa2c5c590251ad484acf910a651b4b620acd7f193"},
    {file = "uvloop-0.22.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:b45649628d816c030dba3c80f8e2689bab1c89518ed10d426036cdc47874dfc4"},
    {file = "uvloop-0.22.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:ea721dd3203b809039fcc2983f14608dae82b212288b346e0bfe46ec2fab0b7c"},
    {file = "uvloop-0.22.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ae676de143db2b2f60a9696d7eca5bb9d0dd6cc3ac3dad59a8ae7e95f9e1b54"},
    {file = "uvloop-0.22.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17d4e97258b0172dfa107b89aa1eeba3016f4b1974ce85ca3ef6a66b35cbf659"},
    {file = "uvloop-0.22.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:05e4b5f86e621cf3927631789999e697e58f0d2d32675b67d9ca9eb0bca55743"},
    {file = "uvloop-0.22.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:286322a90bea1f9422a470d5d2ad82d38080be0a29c4dd9b3e6384320a4d11e7"},
    {file = "uvloop-0.22.1.tar.gz", hash = "sha256:6c84bae345b9147082b17371e3dd5d42775bddce91f885499017f4607fdaf39f"},
]

[package.extras]
dev = ["Cython (>=3.0,<4.0)", "setuptools (>=60)"]
docs = ["Sphinx (>=4.1.2,<4.2.0)", "sphinx_rtd_theme (>=0.5.2,<0.6.0)", "sphinxcontrib-asyncio (>=0.3.0,<0.4.0)"]
test = ["aiohttp (>=3.10.5)", "flake8 (>=6.1,<7.0)", "mypy (>=0.800)", "psutil", "pyOpenSSL (>=25.3.0,<25.4.0)", "pycodestyle (>=2.11.0,<2.12.0)"]

[[package]]
name = "watchfiles"
version = "1.2.0"
description = "Simple, modern and high performance file watching and code reload in python."
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "watchfiles-1.2.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:bb68bf4df85abebe5efddc53cf2075520f243a59868d9b3973278b23e76962a9"},
    {file = "watchfiles-1.2.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c16cb06dd17d43b9d185094268459eac92c9538356f050e55b54e82cf700e1d4"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a0feab9af4c021c581f695258c642b3d10c5fd4c676e33a0d8606425d82631"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a16ffe19bf5cf9f5edaa1ad1dd830c5a816e8feec430c522302ab55483a4b994"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:204f299afcbd65918ab78dbc52626b0ae45e9d8cef403fdbf33ecf9e40eac66e"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:11743adfa510bfffebe97659fb280182b5c9b238708f667e866f308c3430dc19"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eb72919d93e3a16fc451d3aa3d4b1698423daca1b382d3d959c9ac51297c12a8"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b62f042afde2dde21ec1d2c1a74361e804673df86f51e418a999c9acfe671b07"},
    {file = "watchfiles-1.2.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:027ae72bfdfd254862065d8b3e2a815c6ab9b1853ce41e6648ece84afd34a551"},
    {file = "watchfiles-1.2.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e1cfd51e97e13ff3bd047c140764d277fc9b95b7cb5da59e46a47d167adab310"},
    {file = "watchfiles-1.2.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:24b2405c0a46738dd9e1cf7135aa5dbdb9d42d024628651b3b13d5117e99f8df"},
    {file = "watchfiles-1.2.0-cp310-cp310-win32.whl", hash = "sha256:8c520725602756229f045b032a1ff33d7ef0f7404189d62f6c2438cb6d8ef6a1"},
    {file = "watchfiles-1.2.0-cp310-cp310-win_amd64.whl", hash = "sha256:03b14855c6f35539e2d95c442ae9530a75762f1e26567152b9ed05f96534a74d"},
    {file = "watchfiles-1.2.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:704fd259e332e01f9b9c178f4bce9e49027e5587cc2600eeeaf8e76e1c846201"},
    {file = "watchfiles-1.2.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:6543cf55d170003296d185c0af981f3e1311564907e1f4e08671fc7693a890a5"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:89d8c2394a065ca86f5d2910ff263ae67c127e1376ccc4f9fc35c71db879f80a"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:772b80df316480d894a0e3165fdd19cf77f5d17f9a787f94029465ad0e3529d1"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d158cd89df6053823533e06fb1d73c549133bff5f0396170c0e53d9559340717"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d516b3283a758e087841aedb8031549fb41ced08f3db10aa6d2bf32dc042525b"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:53b2290c92e0506d102cd448fbc610d87079553f86caa39d67440856a8b8bba5"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a711b51aec4370d0dcda5b6c09463206f133a5759341d7744b953a7b62e1100e"},
    {file = "watchfiles-1.2.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:e2ca07fa7d89195ec0865d3d285666286740bfa83d83e5cee204043a31ecc165"},
    {file = "watchfiles-1.2.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:e0618518f282c4ebff60f5e5b1247b6d91bb8b9f4476947563a1e74acc66f3c6"},
    {file = "watchfiles-1.2.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:0d191c054d0715c3c95c99df9b8dbf6fd096d8c1e021e8f212e1bd8bc444ccb5"},
    {file = "watchfiles-1.2.0-cp311-cp311-win32.whl", hash = "sha256:9342472aff9b093c5acd4f6d8f70ae0937964ab56542502bcf5579782da69ae8"},
    {file = "watchfiles-1.2.0-cp311-cp311-win_amd64.whl", hash = "sha256:dbd6c97045dad81227c8d040173da044c1de08de64a5ea8b555da4aee1d5fa22"},
    {file = "watchfiles-1.2.0-cp311-cp311-win_arm64.whl", hash = "sha256:57a2d9fa4fb4c2ecae57b13dfff2c7ab53e21a2ba674fe9f05506680fcdcc0d7"},
    {file = "watchfiles-1.2.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:bc13eb17538be00c874699dc0abe4ee2bc8d50bb1166a6b9e175ef3fd7eb8f26"},
    {file = "watchfiles-1.2.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:2d95ddc1eb6914154253d239089900813f6a767e174b8e6a50e7fdacb7e4236c"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f70d8b291ef6e88d19b1f297a6905ddb978888d9272b0d05e6f53309856bcfc"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:56d8641cf834c2836922899105bd3ce3d0dfc69291d52edf0b4d0436829b34c0"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2581a94056e55d7d0a31a823ea92bf73749c489ca2285bfdc0fbe6b2bb49d50c"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:41bc1199f7523b3f82843c88cbb979180c949caef0342cf90968f178e5d49b01"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7571e4464cb6e434958f867f7f730b8ab0b75e3f8e5eac0499168486ab3c33a8"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e53a384f76b631c3ae5334ce6a52f0baa3a911eb94a4eac7f160079868b716d5"},
    {file = "watchfiles-1.2.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:d20029a60a71a052a24c4db7673bc4de39ab89adbaccbfb5d67987c5d73f424d"},
    {file = "watchfiles-1.2.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:2cb93af48550faf1cea04c303107c8b75833de7013e57ce27d3b8d21d8d0f58c"},
    {file = "watchfiles-1.2.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:2995c176de7692b86a2e4c58d9ec718f753150a979cb4a754e2b4ffa38e70906"},
    {file = "watchfiles-1.2.0-cp312-cp312-win32.whl", hash = "sha256:7a2cffd17d27d2ecbb310c2b1d8174f222a5495b1a721894afa88ec11e25b898"},
    {file = "watchfiles-1.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:f155b3a1b2a5fc89cdc70d47ee5d54e3b75e88efa34982028a35daef9ba00379"},
    {file = "watchfiles-1.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:8fa585ede612ee9f9e91b18bebf9ba11b9ae29a4e3a0d0cf6fca3e382133f0d5"},
    {file = "watchfiles-1.2.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:01ea8d66f0693b9b60a6541c8d10263091ca9a9060d242f3c1f3143f9aad2c98"},
    {file = "watchfiles-1.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7ba0480b9a74af058f43b337e937a451e109295c420916d68ad24e3dc02f5e44"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4f34e26a19f91f710c08e0183429f0d1d15df734e6bc78c31e77b9ea9c433658"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b4e77f6a55f858504069abd35d336a637555c09bca453dde1ee1e5ada8a6a1fb"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0cb4d80e212f116474a545c21c912b445f16bb0cef9e6a73a498164223e14e2f"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b974946a10af379d425e2eef5b62f5c6ebeaccf91d45eaad6f5b27ecd4f91aa0"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:86bc13c25a8d1fcd70b51d0ce7c9b65e90de5666fcbfd3e34957cc73ee19aeb5"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ca148d73dea36c9763aaa351e4d7a51780ec1584217c45276f4fe8239c768b71"},
    {file = "watchfiles-1.2.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:c525543d91961c6955b2636b308569e84a1d1c5f5f2932041ab9ef46422f43e3"},
    {file = "watchfiles-1.2.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:a204794696ffb8f9b10fba6f7cb5216d42f3b2b71860ccac6b6e42f5f10973b0"},
    {file = "watchfiles-1.2.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:10d86db20695afe7997ac9e1717637d6714a8d0220458c33f3d2061f54cec427"},
    {file = "watchfiles-1.2.0-cp313-cp313-win32.whl", hash = "sha256:eb283ee99e21ad6443c8cdb06ac5b34b1308c329cbdf03fa02b445363714c799"},
    {file = "watchfiles-1.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:a0f27f01bee51861392bb6b7c4fdb290b27d1eb194e9e28788d68102a0e898d9"},
    {file = "watchfiles-1.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:3651aa7058595e9cfb75d35dd5ada2bf9f48a5b8a0f3562821d3e210c507e077"},
    {file = "watchfiles-1.2.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:faea288b6f0ab1902ef08f4ca6de005dccf856c4e0c4f21b8c5fce02d90a1b08"},
    {file = "watchfiles-1.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:01859b11fd9fbca670f4d5da00fbac282cfea9bd67a2125d8b2833a3b5617ea9"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fff610d7bb2256a317bb1e96f0d7862c7aa8076733ee5df0fd41bbe76a24a4f4"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b141a4891c995a039cd89e9a49e62df1dc8a559a5d1a6e4c7106d16c12777a55"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f22943b7770483f6ea0721c6b11d022947a98eb0acae14694de034f4d0d38925"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1bc6195825b7dcd217968bb1f801a60fd4c16e8eeab5bedc7fe917d7d5995ab4"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d4a4b147f5dca2a5d325a06a832fb43f345751adfbc63204aec30e0d9ca965a2"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4543579a9bdb0c9560039b4ffddbdb39545707659fbc430ce4c10f3f68d557f9"},
    {file = "watchfiles-1.2.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:20aa0e708b920bde876a4aa82dc7dd6ebea228a63a67cda6632c2fc87b787efa"},
    {file = "watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:d413349d565dab74297f2a63e84a097936be69bf8f3b3801f27f380e32040f44"},
    {file = "watchfiles-1.2.0-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f28b2725eb8cce327b9b3ab02415c853011dc55c95832fe90de6bc56f5315f72"},
    {file = "watchfiles-1.2.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:b8c8358484d5fa12ef34f05b7f4168eaf1932f408725ff6d023c33ec17bd79d4"},
    {file = "watchfiles-1.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:9f04b092229ad2c50126dd3c922c8822e51e605993764a33058d4a791ab42281"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7a7ce236284f002a156f70add88efe5c70879cccbb658be0822c54b1306fc09d"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b9909cc2b48468b575eefa944919e1fe8a36c5849d5c7c168f80a8c1db69398e"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a37faaed405c67e28e6be45a1fa4f206ef5a2860f27c237db9fa30704c38242"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9649193aa27bd9ff2e80ff29bfaa93085496c7a3a377592823cc58b77ee88add"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e4ff8e37f99cf1da89e255e07c9c4b37c214038c4283707bdec308cb1b0ea1f"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:054dc20fd2e3132b4c3883b4a00d72fd6e1f56fdaf89fccd12e8057d74cd74d7"},
    {file = "watchfiles-1.2.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:e140ed30ebde76796b686e67c182cff10ea2fbab186fafd1560f74bb5a473a6e"},
    {file = "watchfiles-1.2.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:bb7e52ecf68ba46d22df23467b87cffeb2146908aa523ebfe803019618cfda06"},
    {file = "watchfiles-1.2.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:23282a321c8baf9b3a3c4afff673f9fe65eb7fdc2338d765ccad9d3d1916a5ba"},
    {file = "watchfiles-1.2.0-cp314-cp314-win32.whl", hash = "sha256:c0db965c5f79aa49fe672d297cf1febc5ad149b658594944f49a54a2b96270a7"},
    {file = "watchfiles-1.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:71283b39fd17e5408eb123bd37aeecfd9d54c81fc184421943208aadb879d103"},
    {file = "watchfiles-1.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:c5c19526f4e54a00f2666a6c0e9e40d582c09e865055ea7378bf0009aab857b3"},
    {file = "watchfiles-1.2.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:d73a585accffa5ae39c17264c36ec3166d2fad7000c780f5ef83b2722afb9dd2"},
    {file = "watchfiles-1.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ae99b14c5f21e026e0e9d96f40e07d8570ebee6cafd9d8fc318354606daa7a28"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4429f3b105524a10b72c3a819b091c495d2811d419c1e1e8df773a5a5974f831"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:43d818978d06062d9b22c4fab2ebe44cf5213d42dc8e62bda8c2760cfa2eeb33"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b9f732dc58b2dbe69e464ccf8fff7a03b0dd0be439da4c0720d3558527d3d6b4"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8f200104103feb097de4cab8fe4f5dd18a2026934c7dea98c55a2f5fd6d5a33b"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:63ac26eefbf4af1741247d6fb68b11c49a25b2f7413fbd318a83a12aaa9cf666"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c4997d4e4a55f0d02b6cde327322daf3a0400e5df6c6b15948994bf72497925"},
    {file = "watchfiles-1.2.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:4c887eba18b7945ac73067a8b4a66f21cd46c2539b2bc68588f7be6c7eb6d26b"},
    {file = "watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:3416ff151bb6b5a8d8d11664974fbef4d9305b9b2957839ab5a270468fd8df30"},
    {file = "watchfiles-1.2.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:0e831a271c035d89789cffc386b6aa1375f39f1cd25eb7ca0997e4970d152fc5"},
    {file = "watchfiles-1.2.0-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:37a6721cdf3f65dbb13aa9503510ccb4451603ac837e44d265d7992a597e1374"},
    {file = "watchfiles-1.2.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2b37d10b5a63bd4d87e18472d80fa525bd670586fae62e5dd580452764879b65"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a105bc2283f67e8fbec74253ec2d94925de92ed72c0393f1206bf326b7b7b69"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5327989a465505f05cfe06f04fa9d0c2fd5432bb243e10e6f012b1bdca3c8579"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ecb47f183a8025b2aa18b546725c3657e542112ae9c0613a2af79b4fa8d04ad7"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8520a4ab0e37f770afc34459c4f8f7019e153f9124dc101c15538365875d1ab2"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:71cd71740ed2c15211ebb237ced4e39a1cdf6f80566e5fe95428da1626f4fde6"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f88af53d6ddaf72179ef613ddc905e6f4785f712b49b80b3bef9f3525e6194b4"},
    {file = "watchfiles-1.2.0-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:cee9d5efd929efdac5f7e58f72b3376f676b64050a91c5b99a7094c5b2317488"},
    {file = "watchfiles-1.2.0-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:b718bf356bbc15e559bd8ef41782b573b8ae0e3f177ab244b440568d7ea02cfb"},
    {file = "watchfiles-1.2.0-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:922c0e019fe68b3ae392965a766b02a71ba1168c932cebc3733cd52c5fe5b377"},
    {file = "watchfiles-1.2.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:4674d49eb94706dfe666c069fc0a1b646ffcf920473492e209f6d5f60d3f0cc2"},
    {file = "watchfiles-1.2.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:094b9b70103d4e963499bdea001ee3c2697b144cd9ae6218a62c0f89ec9e31db"},
    {file = "watchfiles-1.2.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b0ef001f8c25ad0fa9529f914c1600647ecd0f542d11c19b7894768c67b6acb7"},
    {file = "watchfiles-1.2.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a88fc94e647bc4eec523f1caa540258eb71d14278b9daf72fa1e2658a98df0f0"},
    {file = "watchfiles-1.2.0.tar.gz", hash = "sha256:c995fba777f1ea992f090f9236e9284cf7a5d1a0130dd5a3d82c598cacd76838"},
]

[package.dependencies]
anyio = ">=3.0.0"

[[package]]
name = "websockets"
version = "16.1.1"
description = "An implementation of the WebSocket Protocol (RFC 6455 & 7692)"
optional = false
python-versions = ">=3.10"
groups = ["main"]
files = [
    {file = "websockets-16.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:49ae99bdfcae803a885c926bf14f886196e84925395bb3f568fef5c0f0979d7d"},
    {file = "websockets-16.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:5bfd1ac19b1b9986a9c95a82d5e23a391ebb09e12c34d7be6094b86efcc35731"},
    {file = "websockets-16.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9246a0d063cfcbcc85f2359dd6876d681213f4790832272aa16641b4ed5d64d4"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:1214e673c404684b9bf7154f5cf43b45025b1a6160fac3a9e438e9c1a97e22cb"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:90001d893bc368e302ef168d82130b4e4fdd27b85fa094682df9b667c2d48838"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:130937b167a52af203c8d58e78d67705874e82759862e3b9671a452fec4abc87"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9c9f23004a3d40e89c01a7955d186a6cc83418d93b749701944ce2de3e95a1f3"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f55f0b01956a094c8587146d9558c91937e78789c333860ffaf35931a6e5dbc4"},
    {file = "websockets-16.1.1-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:6aaface73b9c71974c6497366d8b9628357f6c9749e09c4ea3610176c63f2ae3"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:dc0fad4933f427acd5b1cec210f3ea6dce7089e1724e4b9ec6ef47c6c04d1b3b"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f2769a0344a09e9ccf5b3cce538bc75a51b53eff3275d3896310c8552049195d"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:f70541f3104339f59f830522d94ebadb1bf47426287381623443d8bb1cdbf33d"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:dc385593a42e31cd6fb60c19f0ecb015b386603818fc2c6c274fb42bd2bb4165"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:387e8e4aa5df2f90b198fa3cad3478822a89cf905b6a6d6c97dc3664689640cc"},
    {file = "websockets-16.1.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:fd46fff7eb62c24804d234f0051c7a8ea81285ad63e0337d3dcf33ca82aee58a"},
    {file = "websockets-16.1.1-cp310-cp310-win32.whl", hash = "sha256:7883388947767080f094950b342b30d35a2a06b849cd967c422fa0db72b40ea9"},
    {file = "websockets-16.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:d57685547e0060cc6fd90ee6a28405d6bd395e525545f13c8d7cd99c78afd79f"},
    {file = "websockets-16.1.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:d0fcf657e9f13ff4b177960ab2200237b12994232dfb6df16f1cfe1d4339f93c"},
    {file = "websockets-16.1.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:b852788aa51764e2d8e4cf5493d559326bcae5e38d16ba25ffa322b034df272a"},
    {file = "websockets-16.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1427fb4cf0d72f66333e2cacc3ff5f575bf2d7008166ce991a4a470b21d51a22"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:da4ca1a9d72f9030b3146b8d7022719a9f3d478f61efe6f7dd51d243f61c51b2"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:86d7f0f8bdb25d2c632b72527325e4776430fd5bc61b9118de4e2b8ddb5f5b01"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7dfcad78ea1492ee3a9ec765cb7f51bbc17d477107aaf6b22abf7b2558d1c5a0"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:fb9a0a6dc3d1b3986cb88091b6899f0396651e0f74e2c9766ab8d6ffc3842e29"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:29dfa8114c4a620c69591c5973860f768eac29d3fd6904f37f34266cb219c512"},
    {file = "websockets-16.1.1-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:6ff9417c0ada4d0f7d212f928303e5579bdf3ace4c802fa4afabb30995da58c3"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8fe0b50da2d84535fb4f7b4bfa951280f97ce3d558a0443b541166d609e67b57"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:34420aaa64440ebd51ac72ca8a45ef4626429438c9b02e633ae412ed43f925d3"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:a6a61aff018180c9c50b7b0da33bfd29d378af3497429c95006c589a23a11648"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:04fd29a0e2fe9414a95b00e92c67ae51bf900c50c0f8a4b2dafdad621f49ea1d"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:5c31aa7e39ee3e8a358573257f1c0bb5c52430d1b637030dd9c8cc2c282926be"},
    {file = "websockets-16.1.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d14bfb217eb4701e850f1525c9d29d79c44794cdf1c299ead25f39f8c78dea81"},
    {file = "websockets-16.1.1-cp311-cp311-win32.whl", hash = "sha256:2e28e602bb13da44fbe518c1781a88e3b9d4c3d48d02c9bad83e546164336f57"},
    {file = "websockets-16.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:7421fad442de870a8cbf2287d1cad7e706ece0dbfeba5e911df132cbdc1cb56a"},
    {file = "websockets-16.1.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:cc97814dfb786a83b6e2dc2e79351e1b83e6d715647d6887fcabd83026417a00"},
    {file = "websockets-16.1.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:e047dc87ef7ca50f4d309bf775ad4a71711c58556d75d7bd0604b2317f43e94b"},
    {file = "websockets-16.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:01fbdcbac298efe19360b94bc0039c8f746f0220ba570f327577bfee81059175"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:0f62863e8a00a6d33c3d6566ec0b89f23787b747ffe0c3bc71ec0e76b82c94b1"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8087e82f842609734c9b5a1330464f8e94e346ba0e18c832c08bafa4b0d63c15"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2bb5d041a8307d2e18782e7ce777f6fdb1e8c2f5d09291484b18c294b789d9aa"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1db4de4a0e95673f7545d393c49eeb0c2f18ac1ef93073218c79d5cdb2ee75ab"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f17dbe07eb3ea7f99e4df9b7e0efefe80fbf30d37a8cc4d561a0aed310bc8847"},
    {file = "websockets-16.1.1-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4b57693728576d84ede0a77987ab16881b783d2cd9f1dc180a8fbbc3f79c4428"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2a636ff1e7a5c4edf71ef0e79adae7f25dba93b4fcbe3dc958733477ffeb0eaf"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:d6bec75c290fe484a8ba4cacdf838501e17c06ecfbbf31eede81a9e431bd7751"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:54509b8e92fee4453e152b7558ddef37ce9705a044922f2095a6105e3f80c96f"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:f0aa4aad3b1b69ad3fd85a0fd0952ec64331c762bd77ec51cc814170873890b2"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:42290eb6db4ccaca7012656738214f8514082fb6fa40cdeb61bb9a471b52e383"},
    {file = "websockets-16.1.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:53260c8930da5771cec89439bff99c20c8cb03ddb9588b980697355a83cd4bd3"},
    {file = "websockets-16.1.1-cp312-cp312-win32.whl", hash = "sha256:1d27fa8462ad6a1cb36206a3d0640b2333340def181fae11ed7f9adeaa5c0747"},
    {file = "websockets-16.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:b436f6ec4fc3a6b4237c84d3f83170ed2b40bb584222f0ac47a0c8a5921980c7"},
    {file = "websockets-16.1.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:ab59169ace05dcb49a1d4118f0bde139557adf45091bd85747e36bf5de984dd1"},
    {file = "websockets-16.1.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5e3b7d601f6f84156b08cc4a5e541c2b50ad7b36cfc302b657a12477c904a5df"},
    {file = "websockets-16.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:cd2ca96a082a36964aca83e992f72abeb61b7306c1a6cba4c7d06a7b93750cac"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f5d497865f05bb222cab7016c6034542e84e5f29f49c6fd3f4939cda7197b5b8"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:bae954c382e013d5ea5b190d2830526bfa45ad121c326da0049b8c769f185db6"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e09f753a169951eb4f28c2c774f71069304f66e7277e0f5a2892423599cfa854"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:024193f8551a2b0eafbdd160911012c4e6c228c28430c84433253299a9e42d6a"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:aabe464bfd13bd25f4821faf111da6fefdc389f870265a53105580e45b0a2e49"},
    {file = "websockets-16.1.1-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a28fcbc9b6baf54a2e23f8655f308e4ccc6afdd7266f8fe7954f320dcda0f785"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:79eace538c6a97e96d0d03d4f9d314f9677f5ed85a8a984992ffd90b13cb8a56"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:496af849a472b531f758dbd4d61338f5000538cb1a7b3d20d9d32a264517f509"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:5283810d2646741a0d8da2aa733d6aefa0545809afccb2a5d105a26bc45125f1"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:4e3b680b1e0a27457e727a0d572fd81dffa87b6dbf8b228ab57da64f7d85aead"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:69159730a823dde3ea8d08783e8d47ef135a6d7e8d44eb127e32b321c9db8e3e"},
    {file = "websockets-16.1.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ed5bb271084b46530ee2ddc0410537a9961152c5ccba2fc98c5276d992ccba87"},
    {file = "websockets-16.1.1-cp313-cp313-win32.whl", hash = "sha256:cfb70b4eb56cac4da0a83588f3ad50d46beb0690391082f3d4e2d488c70b68ea"},
    {file = "websockets-16.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:d9531d9cbeac99af6f038fb1bc351403531f7d634a2c2e10e2f7c854c6ed5b68"},
    {file = "websockets-16.1.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:443aefe96b7fdb132e2a70806cca1f2af49bb3f28e47abcd7c2e9dcf4d8fa1b8"},
    {file = "websockets-16.1.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:6456ff333092d509127d75a638cb411afae8ff17f092635015d1902efec8a293"},
    {file = "websockets-16.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fce6c48559c86d1ac3632ccb1bebc7d5442fbe79bd9bb0e40379ee54be2a4051"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:92b820d345f7a3fc7b8163949ee92df910f290c3fc517b3d5301c78065adafe1"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2a606d9c24035242a3e256e9d5b77ed9cd6bccfcb7cf993e5ca3c0f6f68fb6a7"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:414e596c75f74e0994084694189d7dc9229fb278e33064d6784b73ffbba3ca31"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:536676848fc5961aca9d20389951f59169508f765637a172403dc5434d722fa0"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:97fd3a0e8b53efa41970ac1dff3d8cf0d2884cadeb4caaf95db7ad1526926ee3"},
    {file = "websockets-16.1.1-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:7b1b19636af86a3c7995d4d028dbe376f39b4bf31541146f9c123582a6c94562"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:41c8e77f17294c0ac18008a7309b99b34ee72247ef10b6dff4c3f8b5ac29896b"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:9f63bcef7f4b02b06b35fc01c93b96c43b5e88e1e8868676caacf493d5a31f3a"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:dab9eb87869da2d6ed3af3f3adf28414baae6ec9d4df355ffc18889132f3436c"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:43e3a9fdd7cbf7ba6040c31fae0faf84ca1474fef777c4e37912f1540f854499"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:056ae37939ed7e9974f364f5864e76e49182622d8f9751ac1903c0d09b013985"},
    {file = "websockets-16.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a0eadbbf2c30f01efa58e1f110eb6fa293261f6b0b1aa38f7f48707107690af9"},
    {file = "websockets-16.1.1-cp314-cp314-win32.whl", hash = "sha256:195c978b065fa40910582464f99d6b15c8b314c68e0546549a55ed83f4735328"},
    {file = "websockets-16.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:4e8d01cc3bcae7bbf8167f944aeafefed590fae5693552bba9794a9df68371cc"},
    {file = "websockets-16.1.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:0ffd3031ea8bda8d61762e84220186105ba3b748b3c8da2ae4f7816fac03e573"},
    {file = "websockets-16.1.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:84a2cef8deffbd9ab8ee0ea546a2a6a7030c28f44e6cdd4547dbfeb489eb8999"},
    {file = "websockets-16.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:3df13f73af9b3b38ab1195eb299ecb67a4330c911c97ae04043ff74085728abe"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:23253dd5bcae3f9aaee0a1d30967a8dbd52e5d3cff93a2e5b84df57b77d4750d"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9c1c5705e314449e3308872fe084b8571ce078ee4fc55a98a769bdefe5917392"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:69e52d175a0a7d1e13b4b67ad41c560b7d98e8c6f6126eb0bda496c784faf8c7"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1f79c89b5eb034d1722938a891916582f8f7f503f58ca22518a63c3f2cd18499"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:39f2a024af5c345ffe8fcf1ee18c049c024c94df393bb09b044a6917c77bde43"},
    {file = "websockets-16.1.1-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:952303a7318d4cbe1011400839bb2051c9f84fa0a35923267f5daba34b15d458"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:249116b4a76063d930a46391ad56e135c286e4562a18309029fc2c73f4ed4c62"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:61922544a0587a13fd3f53e4c0e5e606510c7b0d9d22c8444e5fae22a06b38cb"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:46dcaa042cd1de6c59e7d9269fa63ff7572b6df40510600b678f0826b3c7af51"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:38565aca3e01ea8734e578fb2118dade0ecb0250533f29e22b8d1a7a196cf4d0"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:42f599f4d48c7e1a3338fdaac3acd075be3b3cf02d4b274f3bf2767aedd3d217"},
    {file = "websockets-16.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dcc04fedf83effaeb9cce98abc9469bb1b42ef85f03e01c8c1f4438ef7555737"},
    {file = "websockets-16.1.1-cp314-cp314t-win32.whl", hash = "sha256:8483c2096363120eea8b07c06ae7304d520f686665fffd4811fad423930a65d7"},
    {file = "websockets-16.1.1-cp314-cp314t-win_amd64.whl", hash = "sha256:bcce07e23e5769375158f5efdcdafa8d5cd014b93c6683865b840ed65b96f231"},
    {file = "websockets-16.1.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:820fb8450edddae3812fd58cbc08e2bf22812cb248ecb5f06dbb82119a56e869"},
    {file = "websockets-16.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:125f22dbefaf1554fea66fc83851490edb284ce4f501d37ffed2752f418332d9"},
    {file = "websockets-16.1.1-pp311-pypy311_pp73-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:30bbe120437b5648a77d3519b7024ea09530e0b5b18d3698c5a0ae536fe0cc2e"},
    {file = "websockets-16.1.1-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b6b9dadbef0cccd9f4c4ee96b08898afa73e26803bbe0f6aeb5bb12b0074206d"},
    {file = "websockets-16.1.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56cd5fc4f10a9ea8aa0804bddb7b42506cf9e136046f3b4c27de8fec9e2ecba5"},
    {file = "websockets-16.1.1-py3-none-any.whl", hash = "sha256:6abbd3e82c731c8e531714466acd5d87b5e88ac3243465337ba71d68e23ae7e3"},
    {file = "websockets-16.1.1.tar.gz", hash = "sha256:db234eda965dcce15df96bb9709f587cd87d4d52aaf0e80e2f34ec04c7670c57"},
]

[[package]]
name = "xxhash"
version = "3.8.1"
description = "Python binding for xxHash"
optional = false
python-versions = ">=3.8"
groups = ["main"]
files = [
    {file = "xxhash-3.8.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:27a9e475157f7315826118e3f3127909a0fe25f1b43d3d3be9c584f9d265f937"},
    {file = "xxhash-3.8.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9b2ce44bf8f4a1d01f418b3110ff8dff32fd3f3e836c0e06333c3725f243fa6c"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:942bc86e9be6fdd6e1175048f5fe8f8fdaaf2309dd1323ef1e155a69cd346780"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0204701e6d01f64254e0e5ff4255812b1febe027ddd7dda63372e27f98b5e91f"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7dc4bdf008f77c88d544849c48c1a40faf25a5eff6cc466de2e8edc37c191fce"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5c566b123dce7e4867ca518434cdfb9f84e5023771235b2e3107a26c9a41cbd8"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:9f23083e1bd9d901f844af7a126727c486e7eada9a1a6791c8f7e73f94fac656"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:64af54dd1c3a45a27c04942f9a1a4683322bdd127f4745cca4e02549c1d2d2bb"},
    {file = "xxhash-3.8.1-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:8ea8a141eeced4f6262ab6dd71c681ac546a558c30bb586abe087d814b5f85ea"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a98b2f95cab589e0f5e92c48431afb4d56238b8bf6668edcc66166180e9b509b"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:1b86ae798a976ccbc1d02af6ccb98f5b4d24756b1f65e995f11d10fe071f486f"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:81f4ed9ca9644bc95cd976bfe10f7a4cafab8ffdc3aed52877d4600e445be7ef"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:cb3fe820c27593f170770d6c8d791936cf6275d9269405fbb7b30a55363c10c8"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:7345007c12780985de4fd740148776d1eee18c0d41407c6fa1e48c5450304fe5"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:12eaeaa9ab8b9e6033a1fa5f6b338aaf55ff4df4bee11b59fd6ee03b19186ee4"},
    {file = "xxhash-3.8.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:e2a845687219ba3214126f14a8a5861f97c9e065a7d0b8252adb6df13eea86fb"},
    {file = "xxhash-3.8.1-cp310-cp310-win32.whl", hash = "sha256:656256c9f9303e47f07d5cb8ae4468285370adfafd7ba48aea33a458e7697626"},
    {file = "xxhash-3.8.1-cp310-cp310-win_amd64.whl", hash = "sha256:27cfc2f1ed76f956f36dfe0c56e5f5a3e94cd91eb78b893f63e2ef2ae404fcdf"},
    {file = "xxhash-3.8.1-cp310-cp310-win_arm64.whl", hash = "sha256:c85949d02c85adf6d786eb94858e124989a632a4e65739835b2fc5761827fac3"},
    {file = "xxhash-3.8.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:602efcad4a42c184e81d43a2b7e6e4f524d619878f2b6ee2ba469011f47c8147"},
    {file = "xxhash-3.8.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:131324f719957b988861714de7d6ddf57b47abec3b0cc691302ffeaba0e05e10"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:db77278a6eddadbf44ce5aae2fee5ebb4d061f026b1ce2130d058cd4d7a7b670"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1c332dd48b8cb050da2bb2a3c96d72b1664168650a250ef9718e423df7989e05"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a5cd96f6dcdf4fa657b2d95668d71d58455248f98712ecffaa9c528edf40ccae"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c959f88160b13b4e730b0d75b459b7929fc0d2225c284c9683ac95d6feeeac6a"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:027dee4355f3fcc41481650d846cf6cfc895c85a1ab7acd063063821a0df5b4c"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ad52a0e4bcc0ba956a953a169d1feec2734a64981d689e4fc8f490f7bf91af60"},
    {file = "xxhash-3.8.1-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:5d3dfb1f0ff146da7952867a9414f0c7a29762f8825a84879592612fd6139342"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:4482380b462ca9e59994d072a877ecadd1cf51102daeeab2db696f96ab763723"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:950ac754d16daea42038f38e7465eb84cda4d08d7343c1c915771b29470f065a"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:0418ec8b2331b9d4d575fc9284427e8e69449d7172e99e1a86fcdd1f51a0a937"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:32a94ad2763e0263d9102037d349002c3d3c401e42770542c3eeb4801f311661"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:89b11a5cdd441aa463f6d34ca0241602bc09b001a76994b6059828494108c673"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:09a204dd4bb0823daf938cdd0dc8057d5f1e14fe3cbde929424255f23f9de872"},
    {file = "xxhash-3.8.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:e710ad822c493fb80a4fbc1e3d0a807b1422cb90adbe64378f98291b7fa48fef"},
    {file = "xxhash-3.8.1-cp311-cp311-win32.whl", hash = "sha256:5013be3bea7612852c62a7437f3302c1cfb91ca7e703b194459db0b2b2e0d792"},
    {file = "xxhash-3.8.1-cp311-cp311-win_amd64.whl", hash = "sha256:f377012b86c0a23a1df0cf5a1b05aa7187649e472f71c7892e5f2c2815bbe74f"},
    {file = "xxhash-3.8.1-cp311-cp311-win_arm64.whl", hash = "sha256:836f11d4474d3228e9909d97216faa4f7505df41cfaf3927eb29809de785a78d"},
    {file = "xxhash-3.8.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:e6e49370822c1f4d8d90e678b06dbcb08b51a026a7c4b55479e7d467f2e813bc"},
    {file = "xxhash-3.8.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:220d68130f83f7cc86d6edfdeab176adc73d7200bf3a8ec10c629e8cf605c215"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:4d365ee1892c1fa803536f8c6ce21d24b29c9718ec75eb856095c07830f8c478"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:852bfe059720632e2f16a6a4745e41d20937b2bf2a42a401e2412046bb6971cc"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2f8c25a7061d952de589bd0ea0eaadee32378ff83dd6a677b267f9cd86f401f8"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:868a8dcaff1a84ba78038e1cef14fc88ccf84d9b4d12ea604696e0693296aa56"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6536d8677d2fff7e64cd0b98b976df9de7aee0e69590044c2af5f51b76b7a170"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:82c0cedd280eab2e8291270e6c04894dbc096f8159a39dcf1807429f026ca3cc"},
    {file = "xxhash-3.8.1-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:daa86e4b68221d38e669bb236ba112d0335353829fb627c82e5909e4bbe8694c"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2bc7113e6f2b6b3922dd61796ca9f36af09da3773898e7003038dc992fc83b8d"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5eed32dad81d6ba8e62dc7b9ffa0500199385d7810a8dd9d4eafaceb8c6e20bb"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:83697b0ea1f10e7f5d8b26a4906fa851393c61546c63839643a2b7fe2d868061"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:36fc69160465ae75c6ec4ac9f781bb2aa16ae7ff869e73c26fee85fbb11b9887"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:445e0f5a31f2f3546ae0895d4811e159518cdc9d824c11419898d40cfadb677e"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:dfe0580fbfd5e4af87d0cc52d2044f155d55ebd8c8a93568758a2ea7d8e15975"},
    {file = "xxhash-3.8.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:095e1323fa108be1292c54c86da3ef3c7a7dc015b105a52133973bc07a6ad11a"},
    {file = "xxhash-3.8.1-cp312-cp312-win32.whl", hash = "sha256:bf28f55e427e0483acb1f666bd0d869b6d5e5a716680c216ad7befe3d4cfba2e"},
    {file = "xxhash-3.8.1-cp312-cp312-win_amd64.whl", hash = "sha256:2256e80e4960ee282f63428adb349cb7f8bd8efe4db770d88eb815f4b9860724"},
    {file = "xxhash-3.8.1-cp312-cp312-win_arm64.whl", hash = "sha256:9df56e6df96a60590935e22373041cccc91fd55858763dcffb55bf63b3a2b396"},
    {file = "xxhash-3.8.1-cp313-cp313-android_21_arm64_v8a.whl", hash = "sha256:3c682fcd96eb4bf64be32a4d95f96107e1588005831bd8a741b324fdda01b913"},
    {file = "xxhash-3.8.1-cp313-cp313-android_21_x86_64.whl", hash = "sha256:036a024d8b9c01f70782e09ed98d532e76fd23f950ae7154bd950fe94e90ebec"},
    {file = "xxhash-3.8.1-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:d6a5c0bce213b23b0166fe0d35bcbbe23ce4b968f257cc7eb6fd57cb8e1e6297"},
    {file = "xxhash-3.8.1-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:5177aa44eddaa97c6ef0cc00c6d540edb64d51781d2f8fb941612ec61a92c9ed"},
    {file = "xxhash-3.8.1-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:7801b7223db017b9c0c9ccf37e44524edb35a1544a1c032add22c061c6af0276"},
    {file = "xxhash-3.8.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:9e80238259655bf69d7bcd08226a970d7f42605f3157786bfa76dd13472d7fa0"},
    {file = "xxhash-3.8.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bcab50a389cc04d87f90092af78a6adba2ab3deca63175a3344ca83514045315"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:a2489d3a776fa380cb8e71f54c7fda268a9baf3de9b1395093fd280f95735907"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:32ab1e5432690276e71192be7401b55f96db2d0eedea5d44eb1f164505669cc0"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b30e01a0b97a4bc3f519a4d7a82da3dc53251fb0de5eeea8660dcd4ff094c0c2"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1f44275ddb0978b67a58a951501903f04d49335a91f7681c9ce122ecb8ccb329"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e3b87cbd974512c0c5fc7b469c36b2cdc9ee6d76e4ec78bccb2c7184611c49b0"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:98ee81b4b7f3023c9cb04a78cc67610baffcb5812d92f2096cb5a5efc6f19437"},
    {file = "xxhash-3.8.1-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:2666f059a1588a99267e33605365ed89cea92f424b3522806a9f4bd8ad2e3d62"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:b0093cf7eeb91b84776e8742113afa4bdf47533d36cf719179aaaf1f56f6f8bf"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:3a800912a2e5e975d4128969d645c4a2a80aa886ccd6c9b1c6f44529e327e8cf"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:0fe37f72a207223d22a4eddc3149d4298993385aa9daef25c039246ca5a309f3"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:5db43f249b4be9f99ef4b967863f37094fb40e67effafb78ba4f0356b6396104"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c4ed42965c2cd9081f011be22f69d0e65d3b6165fe7734072fd0c232840bbd4e"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:3557bec8fcb11738a8920eeb68974bc76b75262f6947998d3147954ce0a4b893"},
    {file = "xxhash-3.8.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:00de40f3b42240db23a82a5c682b55d7263d84a26a953240c1aee463409660e3"},
    {file = "xxhash-3.8.1-cp313-cp313-win32.whl", hash = "sha256:b5196cc2574cfec572a5f3fb7cfa5ade27305ae3d06516a082132441aff4c83a"},
    {file = "xxhash-3.8.1-cp313-cp313-win_amd64.whl", hash = "sha256:538f5f865df6cd8c32dd63158a0e5b4f5dd08d732a7da8b7228a5a0776c8ce55"},
    {file = "xxhash-3.8.1-cp313-cp313-win_arm64.whl", hash = "sha256:a6617f30641ba0d8baa1635fbefb1dffc5165ec36d26921bd5cee13497cd937a"},
    {file = "xxhash-3.8.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:bfcd82852c62a60e314670a9602de354c4460f8adad916e2e42a20860c7870bc"},
    {file = "xxhash-3.8.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:08ea2081f5e88615fec8622a9f87fbe21b8ea58d88cfc02163ca11026ee62a92"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:2e32855b6f9e5b18f449e59d45e3d5778bdeb660632ef2693cca267a11246c75"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a6e088bd7870775624256a0d84c2a6714afd223b2eeb56b0ca58398e52a32fda"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:72eb5ae575cc7ae2b23f6f8064a8b10f638c7149819ae9cc6d20ebd4d37a1629"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d0b48cdf690a64cedf7258c3dc9506cc41fc86edd7739c40e3098952265dc068"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:fb9e256a357dfcede7818c6d34e70db2d6b664394803d1de4b6984d2de76c0f1"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51f71a6e2ad071e70c937e41fcb6c19f82c3f9f49831eba850ed4a106ffbb647"},
    {file = "xxhash-3.8.1-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e4a6443968c4e8dc69967e12776776a5952c119cc1bd94168ad1c5ad667c2be1"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:714503083a1f2065c9ad15340dd49ac8a8e948a505a705ffa1750cb951519113"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:77f74e45a1e5574bbbf80181c8027b3a4c65c2248fffbd557bd596fff13102f9"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:4e0e1b0fb0259c1b75d1251ac0bb4d7ab675d36f7a6bf4ba6aa630dae94f9ffa"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:10e4393ec33633c2f05ad01869e546ad080b1a18f2650503731f153774608b31"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:b3ba794c3d885803db6c3116686923f1ec13bc86e621e169a375282b63ea1cc6"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:57189a69c0891e4818853feaa521c972d22c880a001453addea015f48e3c3398"},
    {file = "xxhash-3.8.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:d59e71153fe9ff85648d00e18649b07e9b22c797291abb7e27274fa06df8b838"},
    {file = "xxhash-3.8.1-cp313-cp313t-win32.whl", hash = "sha256:5b96f0024e9840f449bd91b2d005c921a4b666055a0d1b6492463799f32aae22"},
    {file = "xxhash-3.8.1-cp313-cp313t-win_amd64.whl", hash = "sha256:37d5a56c36dcc0b9a87b814cd992598d33863ff683749de6c86081f278d5e629"},
    {file = "xxhash-3.8.1-cp313-cp313t-win_arm64.whl", hash = "sha256:6696c8752aded28ff3b16f33ef28ce28fb5d209b80c206746f943199fcf5fd65"},
    {file = "xxhash-3.8.1-cp314-cp314-android_24_arm64_v8a.whl", hash = "sha256:9db455cb649dcfe4504d6d68a6d83a7315a99a3ca59871dc3ff840671f99adba"},
    {file = "xxhash-3.8.1-cp314-cp314-android_24_x86_64.whl", hash = "sha256:affb37f152e55b5e4494bb9d0107f7bb08515c6704fbed82d9f61214d74adc17"},
    {file = "xxhash-3.8.1-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:460261045936975193bfd20549a0de1cd52a33b405cbb972f0d80940c42266cd"},
    {file = "xxhash-3.8.1-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:38c887aedb696ef8bca19983206d270848558cfae4a91afa6a2fb05dde58ffc5"},
    {file = "xxhash-3.8.1-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:594131ce1aad18db3689781f806db1b065cdaa04f4df36b4c038d2013aefd0bf"},
    {file = "xxhash-3.8.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:78c794b643d214f1522e7a288bcf5a2de120d26cd170516749a4009dc92722c9"},
    {file = "xxhash-3.8.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:af0c9fedc4a2c24e8664953882fe8185f3790b8338c9c700f76f5ad660817711"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:115772daeb71b2f3b9381177017f53e6cf3f3439c840737fdabd21aba6e54920"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:000435984a0469b0f822fe76f35bddea0f96a4d6521b3339a60a6428cdee1edc"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2f1c68394818e0595569c2ff3cbc1e6d5a36a434e796f5c526b987b80c8a8c62"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:46b39976d008e2a845758650f0ff7136bca004f40da0c8798bd37ac37860154f"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d5006c65ec507a333479e76e00e2c368781f16c24ededa764763956b32a0e93e"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c31a2649bcf1fe97cf11c79848d761df33ac46b3896942d31b640557b486ff6b"},
    {file = "xxhash-3.8.1-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:8f759eed402448c2bdbb492e4fba1f20668ffe29688605ea61f0f67f9e4e386d"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7b5f97ecfede10d5b2870383620e2d25c8561e217c7bf9081073802b54248d2b"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:1da930bbcac3e8fbe2191850e2abb57977a99348c12c4b385e1058ac1b0a9ecc"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:747476436f6891b9773374ce8d48edcc8b12cb5b61b67c6fb6289633747d088f"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:4ef09bbc2519a93cd0f95f2ceb5f7b85919dffea643278e02362bf40e3c4bed1"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:a5eed9d41995a83f3332b4e3396abb7f433cac584222bd7e305b606d8353861e"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:53f3ed9118397074ff63a79b66b7fec1c84c782eecde35c5bc94e420a971c231"},
    {file = "xxhash-3.8.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:d247b34bf433c92b41689318fd25d246313cab2275a6a47e2efac178b80d6efe"},
    {file = "xxhash-3.8.1-cp314-cp314-win32.whl", hash = "sha256:d58ce8b6cfa9c4d2f230557f69caf7c06369e318015d0b19485095bc2c5963ab"},
    {file = "xxhash-3.8.1-cp314-cp314-win_amd64.whl", hash = "sha256:6cee733fe4ccb1737e0997135283c82341e5cfa9cf214b165f9087fb663aaf4f"},
    {file = "xxhash-3.8.1-cp314-cp314-win_arm64.whl", hash = "sha256:58346024d47e84f7d8b3e7f5d6faa1d58acbbe49a8771497872059f58c1d8ea5"},
    {file = "xxhash-3.8.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:01cab782f8a0a05ecad2c63d7ef10f7ab475f660e0d6419d069418c14d88de7c"},
    {file = "xxhash-3.8.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:717b12fdc51819833704e85e6926d76981ffa3f780ef92e33ebb8b26d46bb230"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:ec55d80e9b8a519d742669e0b49e8ce9e6747be42bf3c138158b6543a9c8e489"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:98d8ac1129b4dd39098cffed94d1284aceb61c3aa396757ccc736ac392e4cee5"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3bc0fa90830df1e1277f33cc6e55de9990b83c0319fd8c7412866cfde38b025e"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c73b6f652f0745425aa6378319c331293b5341756262e9408ed3d45f183375e6"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f6114692261eff4266386cdec0f7d87eee24e317ab397c218b7ae6a76b4c6339"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4df57c0b161ec1b3ed0526a67b0db0914b557e86ee8aae51887aec941b261542"},
    {file = "xxhash-3.8.1-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9043877a917be88ccf230aa5667c1bd059bce80f4c2727e4defa1b29b7f48b08"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:559e3cabe522231909f9de98ef06929edbd53782046bd21aae0c72db6f2a0775"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:264710bd335016f303763ce1275c6486df30bb57c2245c91b224c983d7ac39b8"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:e14800b9b10bb39d7a60ad4a310e403164d7b8988a27ae933d4e40618a44088e"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:ea6a3e734b0fd41b82784a400be946821900daebe610c050a5e0760838a34f99"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:cf399fac542a1c7a4734a435b93df2c55e858c7d31abf6c1bdf46f9ae67fbfd0"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:44c89d915a75c11d2547eaee9098fcd80398987c4bff2974a0497a925bf92c07"},
    {file = "xxhash-3.8.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:358650d5bda9c635da699c53adf4e8134af492ecc79c960f917eebf088bb6799"},
    {file = "xxhash-3.8.1-cp314-cp314t-win32.whl", hash = "sha256:c240939e963653054fc7e4a17c382829cda4aa88a7daf0af841715dbded1b497"},
    {file = "xxhash-3.8.1-cp314-cp314t-win_amd64.whl", hash = "sha256:7258ee276e8772599bc19e14b36f6260306e21b637190cd7cb489a2449d48684"},
    {file = "xxhash-3.8.1-cp314-cp314t-win_arm64.whl", hash = "sha256:8f454166c2ffed45636c8d501741e649851ba2f346c4eb73a64c07ac00428f20"},
    {file = "xxhash-3.8.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:f93e408255ddce525189bf11feaa1be7ee35e55f486c299c97d9caa68d724a5b"},
    {file = "xxhash-3.8.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:0dfdf19b0d5433a75d61f19dc85737af0f0b95e445c1ad69c855115d05efed45"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:947a585bcaa235702b7c59433b485489397f9a163b3f56058b9463a46fd9b74c"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:848182a391fffdc25605443e832f5b443f25498edeccf9a64343fd84421ca04b"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:498017fbf2d13a768b3110d084bde39f2bd8664c1de0b8084f8ccc84425b7c88"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b3e1107fe5ca030f946dfa59fdbb66b5df121c8432f14b0bdd282d17b297f4eb"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1ffcc98d8878e449e86dec008cea6f44cfd3a954d2ef24ae7d1cc9f725beec7d"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ed8bcdab6692fd4ad0dd6241807a24a640a376764460023b8d462d745e6b7b27"},
    {file = "xxhash-3.8.1-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:83d879362ddd0fedd3f2ab8ce7cce3da2049a6d51d16da8af73011c6edf4752f"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:afe6380a0e9653a87aa1e6e88fb47718113e5563c7a1cb2bcc23c1d8e17e3961"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:15790b686f8723b845fec6f612a343beb815a25c83117a7fa408d7c8ee5aa8fd"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:c919f38cd3f0b5e8d30b81fd6cac688cf9221560340f0c35cbbb8b2bd77ad6ac"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:12a3cf79dadbab9631230ebc4c51c7c60f1e9cdfb890c15fb733eaafe2e7713c"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:1731407102b9332cd3c9dadee07db498bc3d437b95d752b5b1a5f7eb730a3738"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:89df64c10adfe340fb00330042537cdd6bf0d8d78bad73f29cfe5427eed7b084"},
    {file = "xxhash-3.8.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:3c0d84c5f2e086b120bae4e7f551cbda804c1deb10d958478bed4f89ba286dfe"},
    {file = "xxhash-3.8.1-cp38-cp38-win32.whl", hash = "sha256:4d6e88ddb3c741fbf29e1e7faf429880f8cd1d7aff4303247435a549726b4fb1"},
    {file = "xxhash-3.8.1-cp38-cp38-win_amd64.whl", hash = "sha256:bbcdf9c92d21c65bc75426eecea724c8fa0d35a6e201fdf1630011d4cc3aa685"},
    {file = "xxhash-3.8.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:314d05fbc55719ae2438eaaba77bf2508ca4f030b26fa4c9c8c380e81c48fa33"},
    {file = "xxhash-3.8.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e605e0b8abca9457abd5bee737e086ab145a20c25083ef1113013612268872ff"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:f8ed8940435834141061da26d27c4dd0d18fb69777bf431f5c6cc46b43349113"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6c7574528bc922f8757f34dd78ed60ab52b1c7973b630f5eae7ba33ec133ce71"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:d48acabb1e5cb0071009f80d71d7f01b6ba2c1d4b869b1352bb5df3f11bf7dfd"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:614bca2c7cfa87ec95b703e691c3c5eb6c448b6dabbe9776ac53883152951729"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1153265daa10750a9bf8e9b01753d7618024a300925591efaf16b1b7fa536699"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d45eee3a95a8b61e5b568580caac91f1502ddb731aaf8f4aa448a98660b2fb4"},
    {file = "xxhash-3.8.1-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:632a34590c090d1285ed5efa5a02be919f3f9a56a64bd25f693fe1e2d27a27fb"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:6cf633fe83b1d4e6519d7259b33afe40fbba5d3f438730156971dd0cf7730610"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:b6fa3116e40e14e7782fb1a9f872f94b5997de21127c95545ce40196ac1351c5"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:454d78e786602278a2a4383d08048482052f4f0c61fa677ca590af08914d9bca"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:23e710118a5778a45db740b431943a3f2a82a571a052c2768cce6544d9c8c62e"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:5da703225374e3a4c8d4fd90e26fe7213a52004ec77f88b42b42e9e86d8c6d57"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:f8044cf4c77f37968b8c4cbcbf7a0f355d8a437877ae18eba23e3aad953a6cc7"},
    {file = "xxhash-3.8.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:4bec8b2c909bcfae9a0dc702346007e02a8c9ba5bbde83ffb224aa194f4f9efc"},
    {file = "xxhash-3.8.1-cp39-cp39-win32.whl", hash = "sha256:57f80a898544db78ec6b0be6183bd1bc008933193d4199f5cde36b0e6bd5e062"},
    {file = "xxhash-3.8.1-cp39-cp39-win_amd64.whl", hash = "sha256:bb70573d2995d23932e2871120f78d798ebc3572e54c09e694a18ced95c5f8d9"},
    {file = "xxhash-3.8.1-cp39-cp39-win_arm64.whl", hash = "sha256:402db908ea70eaf9800d9182a66596fc86f36655df8f63fdecf7c11da741d86f"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:39c9d5b61508b0bb68f29e54546de0ed2a74943c6a18585535a7e37356f1dd12"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:83b9130b80b216d56fdf9e87131946b353c9627930c061955a101ea82b09fed9"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:8304be0982130954b7fd3aad18e2c6f8ee40254bc3d2e635991c16d77c91e2bd"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4b512261801b1e5fde7b6ebf2fef7977339c620cbbca88a0040ad9ad134f4d02"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:49aa8692507835dcc1e8ad8021f20c74c2dc13d83b5112e87877faa2a0035b20"},
    {file = "xxhash-3.8.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:345b07b78e2bf583d71682aa34ae5b5fab575f7a1cb31e10263ebbc6f89f8c42"},
    {file = "xxhash-3.8.1.tar.gz", hash = "sha256:b0de4bf3aa66363552d52c6a89003c479911f12098cd48a53d44a0f7a25f7c46"},
]

[[package]]
name = "zstandard"
version = "0.25.0"
description = "Zstandard bindings for Python"
optional = false
python-versions = ">=3.9"
groups = ["main"]
files = [
    {file = "zstandard-0.25.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:e59fdc271772f6686e01e1b3b74537259800f57e24280be3f29c8a0deb1904dd"},
    {file = "zstandard-0.25.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4d441506e9b372386a5271c64125f72d5df6d2a8e8a2a45a0ae09b03cb781ef7"},
    {file = "zstandard-0.25.0-cp310-cp310-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:ab85470ab54c2cb96e176f40342d9ed41e58ca5733be6a893b730e7af9c40550"},
    {file = "zstandard-0.25.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:e05ab82ea7753354bb054b92e2f288afb750e6b439ff6ca78af52939ebbc476d"},
    {file = "zstandard-0.25.0-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:78228d8a6a1c177a96b94f7e2e8d012c55f9c760761980da16ae7546a15a8e9b"},
    {file = "zstandard-0.25.0-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:2b6bd67528ee8b5c5f10255735abc21aa106931f0dbaf297c7be0c886353c3d0"},
    {file = "zstandard-0.25.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4b6d83057e713ff235a12e73916b6d356e3084fd3d14ced499d84240f3eecee0"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:9174f4ed06f790a6869b41cba05b43eeb9a35f8993c4422ab853b705e8112bbd"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:25f8f3cd45087d089aef5ba3848cd9efe3ad41163d3400862fb42f81a3a46701"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:3756b3e9da9b83da1796f8809dd57cb024f838b9eeafde28f3cb472012797ac1"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:81dad8d145d8fd981b2962b686b2241d3a1ea07733e76a2f15435dfb7fb60150"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:a5a419712cf88862a45a23def0ae063686db3d324cec7edbe40509d1a79a0aab"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:e7360eae90809efd19b886e59a09dad07da4ca9ba096752e61a2e03c8aca188e"},
    {file = "zstandard-0.25.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:75ffc32a569fb049499e63ce68c743155477610532da1eb38e7f24bf7cd29e74"},
    {file = "zstandard-0.25.0-cp310-cp310-win32.whl", hash = "sha256:106281ae350e494f4ac8a80470e66d1fe27e497052c8d9c3b95dc4cf1ade81aa"},
    {file = "zstandard-0.25.0-cp310-cp310-win_amd64.whl", hash = "sha256:ea9d54cc3d8064260114a0bbf3479fc4a98b21dffc89b3459edd506b69262f6e"},
    {file = "zstandard-0.25.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:933b65d7680ea337180733cf9e87293cc5500cc0eb3fc8769f4d3c88d724ec5c"},
    {file = "zstandard-0.25.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a3f79487c687b1fc69f19e487cd949bf3aae653d181dfb5fde3bf6d18894706f"},
    {file = "zstandard-0.25.0-cp311-cp311-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:0bbc9a0c65ce0eea3c34a691e3c4b6889f5f3909ba4822ab385fab9057099431"},
    {file = "zstandard-0.25.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:01582723b3ccd6939ab7b3a78622c573799d5d8737b534b86d0e06ac18dbde4a"},
    {file = "zstandard-0.25.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:5f1ad7bf88535edcf30038f6919abe087f606f62c00a87d7e33e7fc57cb69fcc"},
    {file = "zstandard-0.25.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:06acb75eebeedb77b69048031282737717a63e71e4ae3f77cc0c3b9508320df6"},
    {file = "zstandard-0.25.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9300d02ea7c6506f00e627e287e0492a5eb0371ec1670ae852fefffa6164b072"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:bfd06b1c5584b657a2892a6014c2f4c20e0db0208c159148fa78c65f7e0b0277"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:f373da2c1757bb7f1acaf09369cdc1d51d84131e50d5fa9863982fd626466313"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:6c0e5a65158a7946e7a7affa6418878ef97ab66636f13353b8502d7ea03c8097"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:c8e167d5adf59476fa3e37bee730890e389410c354771a62e3c076c86f9f7778"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:98750a309eb2f020da61e727de7d7ba3c57c97cf6213f6f6277bb7fb42a8e065"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:22a086cff1b6ceca18a8dd6096ec631e430e93a8e70a9ca5efa7561a00f826fa"},
    {file = "zstandard-0.25.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:72d35d7aa0bba323965da807a462b0966c91608ef3a48ba761678cb20ce5d8b7"},
    {file = "zstandard-0.25.0-cp311-cp311-win32.whl", hash = "sha256:f5aeea11ded7320a84dcdd62a3d95b5186834224a9e55b92ccae35d21a8b63d4"},
    {file = "zstandard-0.25.0-cp311-cp311-win_amd64.whl", hash = "sha256:daab68faadb847063d0c56f361a289c4f268706b598afbf9ad113cbe5c38b6b2"},
    {file = "zstandard-0.25.0-cp311-cp311-win_arm64.whl", hash = "sha256:22a06c5df3751bb7dc67406f5374734ccee8ed37fc5981bf1ad7041831fa1137"},
    {file = "zstandard-0.25.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7b3c3a3ab9daa3eed242d6ecceead93aebbb8f5f84318d82cee643e019c4b73b"},
    {file = "zstandard-0.25.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:913cbd31a400febff93b564a23e17c3ed2d56c064006f54efec210d586171c00"},
    {file = "zstandard-0.25.0-cp312-cp312-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:011d388c76b11a0c165374ce660ce2c8efa8e5d87f34996aa80f9c0816698b64"},
    {file = "zstandard-0.25.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6dffecc361d079bb48d7caef5d673c88c8988d3d33fb74ab95b7ee6da42652ea"},
    {file = "zstandard-0.25.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:7149623bba7fdf7e7f24312953bcf73cae103db8cae49f8154dd1eadc8a29ecb"},
    {file = "zstandard-0.25.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:6a573a35693e03cf1d67799fd01b50ff578515a8aeadd4595d2a7fa9f3ec002a"},
    {file = "zstandard-0.25.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5a56ba0db2d244117ed744dfa8f6f5b366e14148e00de44723413b2f3938a902"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:10ef2a79ab8e2974e2075fb984e5b9806c64134810fac21576f0668e7ea19f8f"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aaf21ba8fb76d102b696781bddaa0954b782536446083ae3fdaa6f16b25a1c4b"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1869da9571d5e94a85a5e8d57e4e8807b175c9e4a6294e3b66fa4efb074d90f6"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:809c5bcb2c67cd0ed81e9229d227d4ca28f82d0f778fc5fea624a9def3963f91"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:f27662e4f7dbf9f9c12391cb37b4c4c3cb90ffbd3b1fb9284dadbbb8935fa708"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:99c0c846e6e61718715a3c9437ccc625de26593fea60189567f0118dc9db7512"},
    {file = "zstandard-0.25.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:474d2596a2dbc241a556e965fb76002c1ce655445e4e3bf38e5477d413165ffa"},
    {file = "zstandard-0.25.0-cp312-cp312-win32.whl", hash = "sha256:23ebc8f17a03133b4426bcc04aabd68f8236eb78c3760f12783385171b0fd8bd"},
    {file = "zstandard-0.25.0-cp312-cp312-win_amd64.whl", hash = "sha256:ffef5a74088f1e09947aecf91011136665152e0b4b359c42be3373897fb39b01"},
    {file = "zstandard-0.25.0-cp312-cp312-win_arm64.whl", hash = "sha256:181eb40e0b6a29b3cd2849f825e0fa34397f649170673d385f3598ae17cca2e9"},
    {file = "zstandard-0.25.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ec996f12524f88e151c339688c3897194821d7f03081ab35d31d1e12ec975e94"},
    {file = "zstandard-0.25.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a1a4ae2dec3993a32247995bdfe367fc3266da832d82f8438c8570f989753de1"},
    {file = "zstandard-0.25.0-cp313-cp313-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:e96594a5537722fdfb79951672a2a63aec5ebfb823e7560586f7484819f2a08f"},
    {file = "zstandard-0.25.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:bfc4e20784722098822e3eee42b8e576b379ed72cca4a7cb856ae733e62192ea"},
    {file = "zstandard-0.25.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:457ed498fc58cdc12fc48f7950e02740d4f7ae9493dd4ab2168a47c93c31298e"},
    {file = "zstandard-0.25.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:fd7a5004eb1980d3cefe26b2685bcb0b17989901a70a1040d1ac86f1d898c551"},
    {file = "zstandard-0.25.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8e735494da3db08694d26480f1493ad2cf86e99bdd53e8e9771b2752a5c0246a"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:3a39c94ad7866160a4a46d772e43311a743c316942037671beb264e395bdd611"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:172de1f06947577d3a3005416977cce6168f2261284c02080e7ad0185faeced3"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:3c83b0188c852a47cd13ef3bf9209fb0a77fa5374958b8c53aaa699398c6bd7b"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:1673b7199bbe763365b81a4f3252b8e80f44c9e323fc42940dc8843bfeaf9851"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:0be7622c37c183406f3dbf0cba104118eb16a4ea7359eeb5752f0794882fc250"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:5f5e4c2a23ca271c218ac025bd7d635597048b366d6f31f420aaeb715239fc98"},
    {file = "zstandard-0.25.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4f187a0bb61b35119d1926aee039524d1f93aaf38a9916b8c4b78ac8514a0aaf"},
    {file = "zstandard-0.25.0-cp313-cp313-win32.whl", hash = "sha256:7030defa83eef3e51ff26f0b7bfb229f0204b66fe18e04359ce3474ac33cbc09"},
    {file = "zstandard-0.25.0-cp313-cp313-win_amd64.whl", hash = "sha256:1f830a0dac88719af0ae43b8b2d6aef487d437036468ef3c2ea59c51f9d55fd5"},
    {file = "zstandard-0.25.0-cp313-cp313-win_arm64.whl", hash = "sha256:85304a43f4d513f5464ceb938aa02c1e78c2943b29f44a750b48b25ac999a049"},
    {file = "zstandard-0.25.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:e29f0cf06974c899b2c188ef7f783607dbef36da4c242eb6c82dcd8b512855e3"},
    {file = "zstandard-0.25.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:05df5136bc5a011f33cd25bc9f506e7426c0c9b3f9954f056831ce68f3b6689f"},
    {file = "zstandard-0.25.0-cp314-cp314-manylinux2010_i686.manylinux_2_12_i686.manylinux_2_28_i686.whl", hash = "sha256:f604efd28f239cc21b3adb53eb061e2a205dc164be408e553b41ba2ffe0ca15c"},
    {file = "zstandard-0.25.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:223415140608d0f0da010499eaa8ccdb9af210a543fac54bce15babbcfc78439"},
    {file = "zstandard-0.25.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2e54296a283f3ab5a26fc9b8b5d4978ea0532f37b231644f367aa588930aa043"},
    {file = "zstandard-0.25.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:ca54090275939dc8ec5dea2d2afb400e0f83444b2fc24e07df7fdef677110859"},
    {file = "zstandard-0.25.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e09bb6252b6476d8d56100e8147b803befa9a12cea144bbe629dd508800d1ad0"},
    {file = "zstandard-0.25.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:a9ec8c642d1ec73287ae3e726792dd86c96f5681eb8df274a757bf62b750eae7"},
    {file = "zstandard-0.25.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a4089a10e598eae6393756b036e0f419e8c1d60f44a831520f9af41c14216cf2"},
    {file = "zstandard-0.25.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:f67e8f1a324a900e75b5e28ffb152bcac9fbed1cc7b43f99cd90f395c4375344"},
    {file = "zstandard-0.25.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:9654dbc012d8b06fc3d19cc825af3f7bf8ae242226df5f83936cb39f5fdc846c"},
    {file = "zstandard-0.25.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:4203ce3b31aec23012d3a4cf4a2ed64d12fea5269c49aed5e4c3611b938e4088"},
    {file = "zstandard-0.25.0-cp314-cp314-win32.whl", hash = "sha256:da469dc041701583e34de852d8634703550348d5822e66a0c827d39b05365b12"},
    {file = "zstandard-0.25.0-cp314-cp314-win_amd64.whl", hash = "sha256:c19bcdd826e95671065f8692b5a4aa95c52dc7a02a4c5a0cac46deb879a017a2"},
    {file = "zstandard-0.25.0-cp314-cp314-win_arm64.whl", hash = "sha256:d7541afd73985c630bafcd6338d2518ae96060075f9463d7dc14cfb33514383d"},
    {file = "zstandard-0.25.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b9af1fe743828123e12b41dd8091eca1074d0c1569cc42e6e1eee98027f2bbd0"},
    {file = "zstandard-0.25.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:4b14abacf83dfb5c25eb4e4a79520de9e7e205f72c9ee7702f91233ae57d33a2"},
    {file = "zstandard-0.25.0-cp39-cp39-manylinux2010_i686.manylinux2014_i686.manylinux_2_12_i686.manylinux_2_17_i686.whl", hash = "sha256:a51ff14f8017338e2f2e5dab738ce1ec3b5a851f23b18c1ae1359b1eecbee6df"},
    {file = "zstandard-0.25.0-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:3b870ce5a02d4b22286cf4944c628e0f0881b11b3f14667c1d62185a99e04f53"},
    {file = "zstandard-0.25.0-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:05353cef599a7b0b98baca9b068dd36810c3ef0f42bf282583f438caf6ddcee3"},
    {file = "zstandard-0.25.0-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:19796b39075201d51d5f5f790bf849221e58b48a39a5fc74837675d8bafc7362"},
    {file = "zstandard-0.25.0-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:53e08b2445a6bc241261fea89d065536f00a581f02535f8122eba42db9375530"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:1f3689581a72eaba9131b1d9bdbfe520ccd169999219b41000ede2fca5c1bfdb"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d8c56bb4e6c795fc77d74d8e8b80846e1fb8292fc0b5060cd8131d522974b751"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:53f94448fe5b10ee75d246497168e5825135d54325458c4bfffbaafabcc0a577"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:c2ba942c94e0691467ab901fc51b6f2085ff48f2eea77b1a48240f011e8247c7"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:07b527a69c1e1c8b5ab1ab14e2afe0675614a09182213f21a0717b62027b5936"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:51526324f1b23229001eb3735bc8c94f9c578b1bd9e867a0a646a3b17109f388"},
    {file = "zstandard-0.25.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:89c4b48479a43f820b749df49cd7ba2dbc2b1b78560ecb5ab52985574fd40b27"},
    {file = "zstandard-0.25.0-cp39-cp39-win32.whl", hash = "sha256:1cd5da4d8e8ee0e88be976c294db744773459d51bb32f707a0f166e5ad5c8649"},
    {file = "zstandard-0.25.0-cp39-cp39-win_amd64.whl", hash = "sha256:37daddd452c0ffb65da00620afb8e17abd4adaae6ce6310702841760c2c26860"},
    {file = "zstandard-0.25.0.tar.gz", hash = "sha256:7713e1179d162cf5c7906da876ec2ccb9c3a9dcbdffef0cc7f70c3667a205f0b"},
]

[package.extras]
cffi = ["cffi (>=1.17,<2.0) ; platform_python_implementation != \"PyPy\" and python_version < \"3.14\"", "cffi (>=2.0.0b0) ; platform_python_implementation != \"PyPy\" and python_version >= \"3.14\""]

[metadata]
lock-version = "2.1"
python-versions = ">=3.12,<4.0"
content-hash = "09b6e34fa1850339a51f389fb4b78860ef82c87e992314841ba4b0dc924f639d"

pyproject.toml

1[project]
2name = "app-generation-microservice"
3version = "0.1.0"
4description = "M2M agentic build system: JSON PRD in, compiled Flutter app out."
5requires-python = ">=3.12,<4.0"
6dependencies = [
7    "langgraph (>=0.6,<1.0)",
8    "anthropic (>=0.69,<1.0)",
9    "pydantic (>=2.9,<3.0)",
10    "python-dotenv (>=1.0,<2.0)",
11    "pyyaml (>=6.0.3,<7.0.0)",
12    "fastapi (>=0.140.13,<0.141.0)",
13    "uvicorn[standard] (>=0.51.0,<0.52.0)",
14    "eth-account (>=0.13.7,<0.14.0)",
15    "redis (>=8.0.1,<9.0.0)",
16    "httpx (>=0.28.1,<0.29.0)",
17]
18
19[tool.poetry]
20packages = [{ include = "src" }]
21
22[tool.poetry.group.dev.dependencies]
23pytest = "^8.3"
24fakeredis = "^2.37.0"
25
26[tool.pytest.ini_options]
27testpaths = ["tests"]
28pythonpath = ["."]
29
30[build-system]
31requires = ["poetry-core>=2.0"]
32build-backend = "poetry.core.masonry.api"

.actor/actor.json

{
  "actorSpecification": 1,
  "name": "prd-to-flutter-apk",
  "title": "PRD to Flutter APK",
  "description": "Turn a JSON product spec into a compiling Flutter app: widget tree, Riverpod state, static analysis with an automatic repair loop, then a packaged Android APK.",
  "version": "0.1",
  "meta": {
    "templateId": "python-empty"
  },
  "dockerfile": "../Dockerfile.actor",
  "input": "./input_schema.json",
  "readme": "./README.md",
  "storages": {
    "dataset": {
      "actorSpecification": 1,
      "title": "Generated files",
      "description": "One record per generated source file, plus a final record summarising the run.",
      "views": {
        "overview": {
          "title": "Generated files",
          "transformation": {
            "fields": ["path", "bytes", "kind"]
          },
          "display": {
            "component": "table",
            "properties": {
              "path": { "label": "File", "format": "text" },
              "bytes": { "label": "Size", "format": "number" },
              "kind": { "label": "Kind", "format": "text" }
            }
          }
        }
      }
    }
  }
}

.actor/input_schema.json

{
  "title": "PRD to Flutter APK",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "prd": {
      "title": "Product requirements document",
      "type": "object",
      "description": "The app to build, as JSON. Requires app_name, package_name (reverse-DNS) and screens; models, theme and auth are optional. The full JSON Schema is served at /schema/prd.json by the hosted service.",
      "editor": "json",
      "prefill": {
        "app_name": "Field Notes",
        "package_name": "com.example.fieldnotes",
        "description": "A small field-research capture app.",
        "theme": "material",
        "auth": true,
        "models": [
          {
            "name": "Observation",
            "collection": "observations",
            "fields": [
              { "name": "title", "label": "Title", "type": "text" },
              { "name": "count", "label": "Specimen count", "type": "number" },
              { "name": "verified", "label": "Verified", "type": "bool" }
            ]
          }
        ],
        "screens": [
          {
            "id": "observations",
            "title": "Observations",
            "kind": "list",
            "model": "Observation",
            "actions": [{ "name": "openCapture", "kind": "navigate", "target": "capture" }]
          },
          {
            "id": "capture",
            "title": "New observation",
            "kind": "form",
            "model": "Observation",
            "actions": [{ "name": "saveObservation", "kind": "create", "target": "Observation" }]
          }
        ]
      }
    },
    "anthropicApiKey": {
      "title": "Anthropic API key",
      "type": "string",
      "description": "Your own key, used only for this run and never stored. Leave empty to use the template generator, which needs no key and produces a deterministic app rather than a designed one.",
      "editor": "textfield",
      "isSecret": true
    },
    "model": {
      "title": "Model",
      "type": "string",
      "description": "Ignored unless an Anthropic key is supplied.",
      "editor": "select",
      "default": "claude-sonnet-5",
      "enum": ["claude-sonnet-5", "claude-opus-5", "claude-haiku-4-5"],
      "enumTitles": [
        "Sonnet 5 — the default this service runs on",
        "Opus 5 — stronger, several times the cost",
        "Haiku 4.5 — cheapest, has produced type errors here"
      ]
    },
    "packageApk": {
      "title": "Package an APK",
      "type": "boolean",
      "description": "Off: generate and analyse the source only, which is free and takes about half the time. On: also run Gradle and produce an installable APK, which is the paid step.",
      "default": false
    },
    "maxRepairs": {
      "title": "Repair passes",
      "type": "integer",
      "description": "How many times the loop may feed diagnostics back to the agent that owns them before giving up.",
      "default": 3,
      "minimum": 0,
      "maximum": 5
    }
  },
  "required": ["prd"]
}

.actor/README.md

1# PRD to Flutter APK
2
3Give it a JSON description of an app. Get back Flutter source that compiles —
4and, if you want it, an installable Android APK.
5
6**Generating and reading the source is free.** You only pay for the packaged
7APK. That way you can see exactly what it writes for *your* spec before deciding
8whether it's worth anything to you.
9
10## What it actually does
11
12Four stages, each one handing off to the next:
13
141. **Plan** — turns your spec into a design and a `pubspec.yaml`
152. **UI** — writes the widget tree
163. **State** — wires Riverpod providers, models and Firestore access into it
174. **QA** — runs `flutter analyze` and the generated widget tests
18
19When the analyser finds something, the diagnostic goes back to whichever stage
20owns that file — a broken widget to the UI stage, a missing provider to the
21state stage — and that stage gets another pass. Up to three rounds, then it
22stops and hands you the diagnostics rather than pretending it worked.
23
24That loop is the whole point. "The model wrote Dart" and "the Dart compiles"
25are different claims, and only the second one is worth paying for.
26
27## Input
28
29```json
30{
31  "app_name": "Field Notes",
32  "package_name": "com.example.fieldnotes",
33  "theme": "material",
34  "auth": true,
35  "models": [
36    {
37      "name": "Observation",
38      "collection": "observations",
39      "fields": [
40        { "name": "title", "label": "Title", "type": "text" },
41        { "name": "count", "label": "Specimen count", "type": "number" }
42      ]
43    }
44  ],
45  "screens": [
46    {
47      "id": "observations",
48      "title": "Observations",
49      "kind": "list",
50      "model": "Observation",
51      "actions": [{ "name": "openCapture", "kind": "navigate", "target": "capture" }]
52    },
53    {
54      "id": "capture",
55      "title": "New observation",
56      "kind": "form",
57      "model": "Observation",
58      "actions": [{ "name": "saveObservation", "kind": "create", "target": "Observation" }]
59    }
60  ]
61}
62```
63
64`app_name`, `package_name` (reverse-DNS) and `screens` are required. Screens can
65be `list`, `form`, `detail`, `auth` or `settings`. Actions can navigate, create,
66update, delete, or sign in and out.
67
68## Output
69
70Every generated file lands in the dataset — one record per file, with its full
71contents — so you can read the code directly in the console.
72
73`OUTPUT` in the key-value store summarises the run:
74
75```json
76{
77  "app_name": "Field Notes",
78  "files_generated": 20,
79  "diagnostics": [],
80  "clean": true,
81  "packaged": true,
82  "apk": "https://api.apify.com/v2/key-value-stores/.../app.apk?signature=..."
83}
84```
85
86`clean: true` means `flutter analyze` had nothing to say. If it isn't clean, the
87diagnostics are listed — a build that failed tells you why rather than failing
88silently.
89
90With **Package an APK** enabled you also get `app.apk` in the key-value store,
91built by Gradle. A recent run produced a 151 MB debug APK.
92
93## The model
94
95Leave **Anthropic API key** empty and it uses a built-in template generator: the
96output compiles and the structure is real, but it isn't model-designed.
97
98Supply your own key and the four stages are driven by Claude, which is what the
99example above came from — it produced a shared widget for loading and error
100states, a Firestore query scoped to the signed-in user, friendly messages mapped
101from Firestore error codes, and a derived provider totalling a numeric field that
102the input spec never asked for.
103
104Your key is used for that run and not stored.
105
106## What you don't get
107
108- **No `firebase_options.dart`.** It holds project credentials, so it is never
109  generated. The app reads its Firebase config from `--dart-define` values at
110  build time and degrades rather than crashing when none are supplied.
111- **No signed release build.** The APK is a debug artifact. Signing needs your
112  keystore, which is yours.
113- **Not a replacement for writing the app.** It is a scaffold that compiles and
114  a starting point that isn't a blank page.
115
116## Source
117
118MIT licensed: [github.com/carlosge492/app-generation-microservice](https://github.com/carlosge492/app-generation-microservice)
119
120A complete, unmodified example of the output — 23 generated files from a
12145-line spec, plus a short note describing the run — is checked into
122[`examples/generated-field-notes/`](https://github.com/carlosge492/app-generation-microservice/tree/master/examples/generated-field-notes)
123if you'd rather read the code than take any of this on trust.

examples/todo_app.prd.json

{
  "app_name": "Field Notes",
  "package_name": "com.example.fieldnotes",
  "description": "A small field-research capture app: log observations offline, sync to Firestore.",
  "theme": "material",
  "auth": true,
  "x402_payment_verified": false,
  "models": [
    {
      "name": "Observation",
      "collection": "observations",
      "fields": [
        { "name": "title", "label": "Title", "type": "text" },
        { "name": "notes", "label": "Notes", "type": "text" },
        { "name": "count", "label": "Specimen count", "type": "number" },
        { "name": "verified", "label": "Verified", "type": "bool" },
        { "name": "recordedAt", "label": "Recorded at", "type": "date" }
      ]
    }
  ],
  "screens": [
    {
      "id": "observations",
      "title": "Observations",
      "kind": "list",
      "model": "Observation",
      "actions": [
        { "name": "openCapture", "kind": "navigate", "target": "capture" }
      ]
    },
    {
      "id": "capture",
      "title": "New observation",
      "kind": "form",
      "model": "Observation",
      "actions": [{ "name": "saveObservation", "kind": "create", "target": "Observation" }]
    },
    {
      "id": "settings",
      "title": "Settings",
      "kind": "settings",
      "actions": [{ "name": "signOut", "kind": "signOut" }]
    }
  ]
}

src/supervisor.py

1"""Orchestrator entry point.
2
3    poetry run python src/supervisor.py examples/todo_app.prd.json
4
5Defaults are offline: the template generator and the stub analyzer, so the whole
6loop runs with no credentials and no Flutter SDK. Swap in the real ones with
7`--generator claude` / `--analyzer dart`.
8"""
9
10from __future__ import annotations
11
12import argparse
13import os
14import shutil
15import sys
16from pathlib import Path
17
18# Allow both `python src/supervisor.py` (the documented command) and
19# `python -m src.supervisor`.
20if __package__ in (None, ""):
21    sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
22
23from dotenv import load_dotenv  # noqa: E402
24
25from src.graph.builder import build_graph  # noqa: E402
26from src.graph.state import initial_state  # noqa: E402
27from src.ports.analyzer import get_analyzer  # noqa: E402
28from src.ports.generator import get_generator
29from src.ports.runtime import FlutterTestRunner  # noqa: E402
30from src.prd.schema import load_prd  # noqa: E402
31
32DEFAULT_BUILD_DIR = Path("generated_apps") / "current_build"
33
34
35def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
36    parser = argparse.ArgumentParser(prog="supervisor", description=__doc__)
37    parser.add_argument("prd", nargs="?", default="examples/todo_app.prd.json",
38                        help="path to the JSON PRD")
39    parser.add_argument("--generator", choices=["template", "fixture", "claude"], default="template",
40                        help="template = offline; claude = real model calls")
41    parser.add_argument("--analyzer", choices=["stub", "dart"], default="stub",
42                        help="stub = no SDK needed; dart = real `dart analyze`")
43    parser.add_argument("--build-dir", default=str(DEFAULT_BUILD_DIR))
44    parser.add_argument("--flutter-root", default=os.getenv("FLUTTER_ROOT"),
45                        help="Flutter SDK root; falls back to $FLUTTER_ROOT, then PATH")
46    parser.add_argument("--max-repairs", type=int, default=3)
47    parser.add_argument("--run-tests", action="store_true",
48                        help="also run the generated widget smoke tests "
49                             "(requires the Flutter SDK)")
50    parser.add_argument("--sdk-root",
51                        default=os.getenv("ANDROID_SDK_ROOT") or os.getenv("ANDROID_HOME"),
52                        help="Android SDK root; release builds need its apksigner to "
53                             "prove the artifact is unsigned, and refuse to ship without it")
54    parser.add_argument("--build-mode", choices=["debug", "release"], default="debug",
55                        help="release strips the template's debug signing config and "
56                             "emits an unsigned APK for you to sign yourself")
57    parser.add_argument("--execute", action="store_true",
58                        help="actually run the packaging step "
59                             "(requires x402_payment_verified)")
60    parser.add_argument("--clean", action="store_true",
61                        help="wipe the build directory first")
62    return parser.parse_args(argv)
63
64
65def main(argv: list[str] | None = None) -> int:
66    # Windows consoles default to cp1252 and mangle the log output.
67    for stream in (sys.stdout, sys.stderr):
68        if hasattr(stream, "reconfigure"):
69            stream.reconfigure(encoding="utf-8", errors="replace")
70
71    load_dotenv()
72    args = parse_args(argv)
73
74    try:
75        prd = load_prd(args.prd)
76    except FileNotFoundError:
77        print(f"error: PRD not found: {args.prd}", file=sys.stderr)
78        return 2
79    except Exception as exc:
80        print(f"error: PRD failed validation:\n{exc}", file=sys.stderr)
81        return 2
82
83    build_dir = Path(args.build_dir)
84    if args.clean and build_dir.exists():
85        shutil.rmtree(build_dir)
86    build_dir.mkdir(parents=True, exist_ok=True)
87
88    try:
89        generator = get_generator(args.generator)
90    except Exception as exc:  # missing credentials, bad model id, ...
91        print(f"error: could not construct the {args.generator!r} generator: {exc}",
92              file=sys.stderr)
93        if args.generator == "claude":
94            print("hint: set ANTHROPIC_API_KEY, or rerun with --generator template.",
95                  file=sys.stderr)
96        return 2
97
98    app = build_graph(
99        generator,
100        get_analyzer(args.analyzer, args.flutter_root),
101        max_repairs=args.max_repairs,
102        test_runner=FlutterTestRunner(args.flutter_root) if args.run_tests else None,
103        dry_run=not args.execute,
104        flutter_root=args.flutter_root,
105        build_mode=args.build_mode,
106        sdk_root=args.sdk_root,
107    )
108
109    print(f"PRD      : {args.prd}  ({prd.app_name})")
110    print(f"generator: {args.generator}    analyzer: {args.analyzer}"
111          + (f"    flutter: {args.flutter_root}" if args.flutter_root else ""))
112    print(f"build dir: {build_dir}")
113    print("-" * 68)
114
115    final = app.invoke(initial_state(prd.model_dump(mode="json"), str(build_dir)))
116
117    for line in final.get("log", []):
118        print(f"  {line}")
119    print("-" * 68)
120
121    diagnostics = final.get("diagnostics", [])
122    if final.get("phase") == "failed":
123        print(f"FAILED: {final.get('failure', 'unknown error')}", file=sys.stderr)
124        return 1
125    if diagnostics:
126        print(f"FAILED: {len(diagnostics)} unresolved diagnostic(s) after "
127              f"{final.get('repair_attempts', 0)} repair pass(es):", file=sys.stderr)
128        for d in diagnostics:
129            print(f"  {d.render()}", file=sys.stderr)
130        return 1
131
132    print(f"OK: zero-error build in {build_dir}")
133    if not prd.x402_payment_verified:
134        print("note: x402_payment_verified is false — APK packaging was gated off.")
135    return 0
136
137
138if __name__ == "__main__":
139    raise SystemExit(main())

src/init.py

src/actor/main.py

1"""Apify Actor entry point: the same pipeline, a different front door.
2
3Nothing about how an app gets built lives here. This reads Apify's input,
4hands it to `build_graph` exactly as `src/supervisor.py` does, and writes what
5comes back into Apify's storages. Every decision that matters — how the four
6subagents divide the work, how diagnostics route back to whichever agent owns
7them, what counts as clean — is unchanged and shared.
8
9The one thing that is genuinely different is how payment is proven. On the
10hosted service an x402 authorization settles on-chain before packaging; here
11Apify is the payment rail, so the Actor charges a pay-per-event and only then
12sets `x402_payment_verified`. CLAUDE.md's rule is that packaging never runs
13without that flag being earned, and it is earned here by a charge that
14succeeded, not by being hardcoded true. A charge that fails leaves the flag
15False, which the packaging node itself refuses on — the same refusal the hosted
16service relies on.
17"""
18
19from __future__ import annotations
20
21import asyncio
22import logging
23import os
24import shutil
25from pathlib import Path
26from typing import Any
27
28from apify import Actor
29
30from src.build.pipeline import BuildResult  # noqa: F401  (imported for typing parity)
31from src.graph.builder import build_graph
32from src.graph.state import all_files, initial_state
33from src.ports.analyzer import get_analyzer
34from src.ports.generator import get_generator
35from src.prd.schema import PRD
36
37log = logging.getLogger(__name__)
38
39BUILD_DIR = Path("/tmp/actor-build")
40# Charged only when an APK is actually requested. Generation is deliberately
41# free: someone deciding whether this is worth paying for should be able to read
42# the code it writes for their own spec first.
43APK_EVENT = "apk-build"
44
45
46def _source_records(files: dict[str, str]) -> list[dict[str, Any]]:
47    """One dataset record per generated file, biggest first.
48
49    Ordered so the dataset preview shows the widget tree and providers rather
50    than starting with analysis_options.yaml.
51    """
52    def kind_of(path: str) -> str:
53        if path.startswith("lib/ui/"):
54            return "ui"
55        if path.startswith("lib/"):
56            return "state"
57        if path.startswith(("test/", "integration_test/", "test_driver/")):
58            return "test"
59        return "project"
60
61    records = [
62        {"path": path, "kind": kind_of(path), "bytes": len(content), "content": content}
63        for path, content in files.items()
64    ]
65    records.sort(key=lambda record: (record["kind"], -record["bytes"]))
66    return records
67
68
69async def main() -> None:
70    async with Actor:
71        raw = await Actor.get_input() or {}
72
73        try:
74            prd = PRD.model_validate(raw.get("prd") or {})
75        except Exception as exc:
76            await Actor.fail(
77                status_message=f"The PRD did not validate, so nothing was built: {exc}"
78            )
79            return
80
81        api_key = (raw.get("anthropicApiKey") or "").strip()
82        want_apk = bool(raw.get("packageApk"))
83
84        # A key means the real generator; without one the template generator
85        # still produces a compiling app, which is a more useful default than
86        # failing on a missing credential.
87        if api_key:
88            os.environ["ANTHROPIC_API_KEY"] = api_key
89            generator_kind = "claude"
90            generator_kwargs = {"model": raw.get("model") or "claude-sonnet-5"}
91        else:
92            generator_kind = "template"
93            generator_kwargs = {}
94            Actor.log.info(
95                "No Anthropic key supplied — using the template generator. "
96                "The output compiles but is not model-designed."
97            )
98
99        # --- payment, before packaging and not after --------------------------
100        paid = False
101        if want_apk:
102            try:
103                await Actor.charge(event_name=APK_EVENT)
104                paid = True
105            except Exception as exc:  # noqa: BLE001
106                # Refuse the APK rather than the whole run: the generated source
107                # is still worth returning, and it costs nothing to hand over.
108                Actor.log.warning(
109                    f"Could not charge for the APK ({exc}); generating source only."
110                )
111                paid = False
112
113        payload = prd.model_dump(mode="json")
114        # Set from the charge, never from the caller. A run that arrived with
115        # this true in its own PRD would otherwise package an APK unpaid.
116        payload["x402_payment_verified"] = paid
117
118        if BUILD_DIR.exists():
119            shutil.rmtree(BUILD_DIR)
120        BUILD_DIR.mkdir(parents=True, exist_ok=True)
121
122        generator = get_generator(generator_kind, **generator_kwargs)
123        graph = build_graph(
124            generator,
125            get_analyzer("dart", os.getenv("FLUTTER_ROOT")),
126            max_repairs=int(raw.get("maxRepairs", 3)),
127            dry_run=not paid,
128            flutter_root=os.getenv("FLUTTER_ROOT"),
129            build_mode="debug",
130            sdk_root=os.getenv("ANDROID_SDK_ROOT"),
131        )
132
133        Actor.log.info(f"Building {prd.app_name} ({generator_kind} generator)...")
134        final = await asyncio.to_thread(
135            graph.invoke, initial_state(payload, str(BUILD_DIR))
136        )
137
138        for line in final.get("log", []):
139            Actor.log.info(line)
140
141        diagnostics = [d.render() for d in final.get("diagnostics", [])]
142        files = all_files(final)
143        await Actor.push_data(_source_records(files))
144
145        # The APK, if one was earned and produced.
146        apk_url = None
147        apk_path = final.get("apk_path")
148        if paid and apk_path and Path(apk_path).is_file():
149            store = await Actor.open_key_value_store()
150            await store.set_value(
151                "app.apk",
152                Path(apk_path).read_bytes(),
153                content_type="application/vnd.android.package-archive",
154            )
155            # Awaited: this is a coroutine, and forgetting so put the string
156            # "<coroutine object ...>" in OUTPUT where the download link goes —
157            # a buyer who paid would have had the APK sitting in storage and no
158            # way to reach it.
159            apk_url = await store.get_public_url("app.apk")
160        elif want_apk and paid:
161            Actor.log.warning("Packaging was paid for but produced no APK.")
162
163        usage = getattr(generator, "usage", None)
164        await Actor.set_value(
165            "OUTPUT",
166            {
167                "app_name": prd.app_name,
168                "generator": generator_kind,
169                "files_generated": len(files),
170                "diagnostics": diagnostics,
171                "clean": not diagnostics and final.get("phase") != "failed",
172                "apk": apk_url,
173                "packaged": bool(apk_url),
174                "usage": usage.public() if usage is not None else {},
175            },
176        )
177
178        if final.get("phase") == "failed" or diagnostics:
179            # Not Actor.fail(): the source is in the dataset and is worth having
180            # even when the analyser rejected it. The diagnostics say why.
181            await Actor.set_status_message(
182                f"Generated with {len(diagnostics)} unresolved diagnostic(s) — "
183                f"see OUTPUT. The source is in the dataset."
184            )
185        else:
186            await Actor.set_status_message(
187                f"{len(files)} files, analyser clean"
188                + (", APK in the key-value store" if apk_url else "")
189            )
190
191
192if __name__ == "__main__":
193    # Without this the module defines `main` and exits, `python -m` returns 0,
194    # and Apify reports the run SUCCEEDED having built nothing at all — an empty
195    # dataset behind a green tick, which is the worst way for this to fail.
196    asyncio.run(main())

src/actor/init.py

1"""Apify Actor front door onto the same build pipeline the service runs."""

src/graph/builder.py

1"""LangGraph wiring for the build loop.
2
3    plan -> genui -> logic -> qa -+-> package -> END
4             ^        ^           |
5             +--------+--repair---+   (bounded by --max-repairs)
6
7The repair edge routes by *diagnostic ownership*, not blindly to Logic: an error
8anchored in `lib/ui/` can only be fixed by GenUI, which may write there. See
9`src/ports/ownership.py` for the mapping and why it refines CLAUDE.md §4.
10Planning output (pubspec.yaml, DESIGN.md) is frozen once GenUI starts, so
11diagnostics against it fail the build rather than looping — changes flow
12downstream, never upstream.
13"""
14
15from __future__ import annotations
16
17from langgraph.graph import END, START, StateGraph
18
19from src.graph.nodes import (
20    make_genui_node,
21    make_logic_node,
22    make_packaging_node,
23    make_planning_node,
24    make_qa_node,
25    make_router,
26    route_after_agent,
27)
28from src.graph.state import BuildState
29from src.ports.analyzer import DartAnalyzer
30from src.ports.generator import CodeGenerator
31
32
33def build_graph(
34    generator: CodeGenerator,
35    analyzer: DartAnalyzer,
36    *,
37    max_repairs: int = 3,
38    dry_run: bool = True,
39    test_runner=None,
40    flutter_root: str | None = None,
41    build_mode: str = "debug",
42    sdk_root: str | None = None,
43):
44    graph = StateGraph(BuildState)
45
46    graph.add_node("plan", make_planning_node(generator))
47    graph.add_node("genui", make_genui_node(generator))
48    graph.add_node("logic", make_logic_node(generator))
49    graph.add_node("qa", make_qa_node(analyzer, test_runner))
50    graph.add_node(
51        "package", make_packaging_node(dry_run, flutter_root, build_mode, sdk_root)
52    )
53
54    graph.add_edge(START, "plan")
55    graph.add_edge("plan", "genui")
56
57    # A subagent that writes outside its lane fails the build immediately.
58    graph.add_conditional_edges(
59        "genui", route_after_agent, {"continue": "logic", "fail": END}
60    )
61    graph.add_conditional_edges(
62        "logic", route_after_agent, {"continue": "qa", "fail": END}
63    )
64    graph.add_conditional_edges(
65        "qa",
66        make_router(max_repairs),
67        {
68            "package": "package",
69            "repair_ui": "genui",     # UI-owned diagnostics; flows on to logic
70            "repair_logic": "logic",  # state-owned diagnostics
71            "fail": END,
72        },
73    )
74    graph.add_edge("package", END)
75
76    return graph.compile()

src/graph/nodes.py

1"""The four subagents from CLAUDE.md §1, plus the packaging gate.
2
3Each node is a pure-ish function of state -> partial state update. Dependencies
4(generator, analyzer) are injected so the graph can be exercised offline.
5"""
6
7from __future__ import annotations
8
9from pathlib import Path
10from typing import Any, Callable
11
12from src.build.pipeline import run_build
13from src.graph.state import BuildState, all_files
14from src.payments.x402 import PaymentNotVerified
15from src.ports.analyzer import (
16    HALLUCINATION_WARNINGS,
17    DartAnalyzer,
18    Diagnostic,
19    ToolchainUnavailable,
20    is_fatal,
21)
22from src.ports.conformance import check_conformance
23from src.ports.generator import CodeGenerator
24from src.ports.ownership import owner_of, route_for
25from src.ports.runtime import TestRunner
26from src.ports.navigation import build_navigation_test
27from src.ports.pubspec import ensure_test_dependencies
28from src.ports.roundtrip import build_roundtrip_tests
29from src.ports.smoke import build_smoke_tests
30from src.ports.templates import (
31    ensure_lint_dependency,
32    repair_pubspec_description,
33    repair_stray_prose_line,
34)
35from src.prd.schema import PRD
36
37Node = Callable[[BuildState], dict[str, Any]]
38
39
40def _prd(state: BuildState) -> PRD:
41    return PRD.model_validate(state["prd"])
42
43
44def make_planning_node(generator: CodeGenerator) -> Node:
45    def planning(state: BuildState) -> dict[str, Any]:
46        prd = _prd(state)
47        plan = generator.plan(prd)
48        return {
49            "design_md": plan.design_md,
50            # Infrastructure we own, like analysis_options.yaml itself.
51            # Both repairs are no-ops on a manifest that already parses, and
52            # each keeps its change only if it produces valid YAML. They run
53            # here because the manifest is frozen once GenUI starts: an
54            # unparseable pubspec is routed `fatal`, so a buyer who hits one has
55            # already paid for a build that will never get a repair pass.
56            "pubspec": ensure_lint_dependency(
57                repair_stray_prose_line(repair_pubspec_description(plan.pubspec))
58            ),
59            "analysis_options": plan.analysis_options,
60            "phase": "genui",
61            "log": [f"planning: DESIGN.md ({len(plan.design_md)} chars) + pubspec.yaml drafted"],
62        }
63
64    return planning
65
66
67def make_genui_node(generator: CodeGenerator) -> Node:
68    def genui(state: BuildState) -> dict[str, Any]:
69        prd = _prd(state)
70        # Only the diagnostics this agent can actually act on.
71        diags = state.get("diagnostics", [])
72        # On a stalled round this agent is the escalation target, so it takes
73        # the whole batch rather than only what it nominally owns.
74        mine = diags if state.get("stalled") else [d for d in diags if owner_of(d) == "genui"]
75        repairing = bool(mine)
76
77        files = generator.build_ui(prd, state["design_md"], mine)
78
79        # Out-of-lane files are dropped, never written — but the agent is told,
80        # so the loop can repair it. Failing the build outright wasted every
81        # remaining repair pass on a mistake the offender could simply undo,
82        # and dropping them silently (as `_bundle` once did) hid the problem
83        # entirely. Drop *and* report.
84        kept = {p: c for p, c in files.items() if p.startswith("lib/ui/")}
85        violations = [
86            Diagnostic(
87                "error", path, 0, "genui_lane_violation",
88                f"GenUI wrote {path!r}, which is outside lib/ui/. Everything else "
89                f"under lib/ belongs to the Logic subagent; emit widgets only.",
90            )
91            for path in sorted(set(files) - set(kept))
92        ]
93
94        merged = {**state.get("ui_files", {}), **kept} if repairing else kept
95        note = (
96            f"genui: repair pass against {len(mine)} UI diagnostic(s)"
97            if repairing
98            else f"genui: {len(kept)} widget file(s) written"
99        )
100        if violations:
101            note += f" ({len(violations)} out-of-lane file(s) dropped)"
102        return {
103            "ui_files": merged,
104            "genui_violations": violations,
105            "phase": "logic",
106            "log": [note],
107        }
108
109    return genui
110
111
112def make_logic_node(generator: CodeGenerator) -> Node:
113    def logic(state: BuildState) -> dict[str, Any]:
114        prd = _prd(state)
115        # Only the diagnostics this agent can actually act on.
116        _all = state.get("diagnostics", [])
117        diagnostics = _all if state.get("stalled") else [d for d in _all if owner_of(d) == "logic"]
118        repairing = bool(diagnostics)
119
120        files = generator.wire_logic(prd, state["design_md"], state["ui_files"], diagnostics)
121        # Logic owns everything under lib/ except the widget tree. Enumerating
122        # allowed directories instead assumed TemplateGenerator's layout, where
123        # models live inside provider files; a generator following ordinary
124        # Flutter convention writes lib/models/, lib/services/ and the
125        # flutterfire-generated lib/firebase_options.dart, none of which are UI.
126        # The invariant that matters is that UI and state never mix.
127        kept = {
128            p: c for p, c in files.items()
129            if p.startswith("lib/") and not p.startswith("lib/ui/")
130        }
131        violations = [
132            Diagnostic(
133                "error", path, 0, "logic_lane_violation",
134                f"Logic wrote {path!r}. The widget tree under lib/ui/ belongs to "
135                f"the GenUI subagent and has already been written; own state, "
136                f"models and the composition root instead.",
137            )
138            for path in sorted(set(files) - set(kept))
139        ]
140
141        merged = {**state.get("provider_files", {}), **kept} if repairing else kept
142        note = (
143            f"logic: repair pass against {len(diagnostics)} state diagnostic(s)"
144            if repairing
145            else f"logic: {len(kept)} state file(s) written"
146        )
147        if violations:
148            note += f" ({len(violations)} out-of-lane file(s) dropped)"
149        return {
150            "provider_files": merged,
151            "logic_violations": violations,
152            "phase": "qa",
153            "log": [note],
154        }
155
156    return logic
157
158
159def make_qa_node(analyzer: DartAnalyzer, runner: TestRunner | None = None) -> Node:
160    def qa(state: BuildState) -> dict[str, Any]:
161        build_dir = Path(state["build_dir"])
162        files = all_files(state)
163
164        # Smoke tests are derived from the generated sources, so they are built
165        # here rather than by a subagent, and they ship with the app.
166        smoke = build_smoke_tests(_prd(state), files)
167        files.update(smoke)
168
169        # Round-trip tests ship with the app but are not run here: they need a
170        # Firestore emulator and a browser, which the analysis loop deliberately
171        # does not depend on. Generating them anyway means the app carries the
172        # one check that catches wire-type bugs, for whoever can run it.
173        roundtrip = build_roundtrip_tests(_prd(state), files)
174        files.update(roundtrip)
175        navigation = build_navigation_test(_prd(state), files)
176        files.update(navigation)
177
178        # Those tests import `package:integration_test/...`, which resolves only
179        # if the pubspec declares it. TemplateGenerator's template happens to;
180        # nothing ever told any other generator to, because the requirement
181        # comes from files written here rather than from the PRD. Without this
182        # the harness's own output fails analysis, and the resulting diagnostics
183        # are charged to the generated app — spending repair attempts on code
184        # that was never wrong.
185        if (roundtrip or navigation) and files.get("pubspec.yaml"):
186            files["pubspec.yaml"] = ensure_test_dependencies(files["pubspec.yaml"])
187
188        # Remove anything we wrote on a previous pass that is no longer part of
189        # the app. A repair pass that renames a screen used to leave the old
190        # file — and its now-dangling smoke test — on disk, which then failed
191        # analysis for a file the generator had correctly deleted.
192        for stale in sorted(state.get("written_files", [])):
193            if stale not in files:
194                (build_dir / stale).unlink(missing_ok=True)
195
196        # Materialise the project, then analyse it the way the real pipeline would.
197        for rel, content in files.items():
198            target = build_dir / rel
199            target.parent.mkdir(parents=True, exist_ok=True)
200            target.write_text(content, encoding="utf-8")
201
202        # Conformance first: it is toolchain-free and catches an unparseable
203        # pubspec, which makes `flutter analyze` abort with a YAML stack trace
204        # instead of a diagnostic. Running the analyzer on a project we already
205        # know is malformed only buries the real cause.
206        conformance = check_conformance(_prd(state), files)
207        pubspec_broken = any(d.code == "unparseable_pubspec" for d in conformance)
208
209        diagnostics: list[Diagnostic] = []
210        if not pubspec_broken:
211            try:
212                diagnostics = analyzer.analyze(build_dir)
213            except ToolchainUnavailable as exc:
214                return {
215                    "phase": "failed",
216                    "failure": str(exc),
217                    "log": [f"qa: {exc}"],
218                }
219
220        # Static analysis grades syntax; conformance grades whether the app is
221        # the one the PRD asked for; lane violations were recorded by the agents
222        # themselves. None subsumes the others.
223        diagnostics = (
224            diagnostics
225            + conformance
226            + state.get("genui_violations", [])
227            + state.get("logic_violations", [])
228        )
229
230        # Static analysis proves it compiles; the widget tests prove it runs.
231        if runner is not None:
232            try:
233                diagnostics = diagnostics + runner.run(build_dir)
234            except ToolchainUnavailable as exc:
235                return {"phase": "failed", "failure": str(exc), "log": [f"qa: {exc}"]}
236
237        errors = [d for d in diagnostics if is_fatal(d)]
238        escalated = sum(
239            1 for d in errors
240            if d.severity != "error" and d.code in HALLUCINATION_WARNINGS
241        )
242        # The repair counter lives here so it ticks once per failed analysis,
243        # regardless of how many agents the router then involves.
244        attempts = state.get("repair_attempts", 0) + (1 if errors else 0)
245
246        # Identical diagnostics two rounds running means the last repair pass
247        # accomplished nothing.
248        signature = sorted(f"{d.code}:{d.file}:{d.line}" for d in errors)
249        stalled = bool(errors) and signature == state.get("diagnostic_signature")
250        note = (
251            f"qa: {len(files)} file(s) analysed "
252            f"({len(smoke)} smoke test(s), "
253            f"{sum(1 for p in roundtrip if p.endswith('_roundtrip_test.dart'))} "
254            f"round-trip test(s), "
255            f"{sum(1 for p in navigation if p.endswith('navigation_test.dart'))} "
256            f"navigation test(s)), "
257            f"{len(errors)} error(s), "
258            f"{len(diagnostics) - len(errors)} non-fatal"
259        )
260        if escalated:
261            note += f" ({escalated} escalated as unwired/dead code)"
262        if stalled:
263            note += " [stalled — escalating to the other agent]"
264        return {
265            "diagnostics": errors,
266            "written_files": sorted(files),
267            "diagnostic_signature": signature,
268            "stalled": stalled,
269            "test_files": smoke,
270            "repair_attempts": attempts,
271            "phase": "packaging" if not errors else "qa",
272            "log": [note],
273        }
274
275    return qa
276
277
278def make_packaging_node(
279    dry_run: bool,
280    flutter_root: str | None = None,
281    build_mode: str = "debug",
282    sdk_root: str | None = None,
283) -> Node:
284    def packaging(state: BuildState) -> dict[str, Any]:
285        try:
286            result = run_build(
287                Path(state["build_dir"]),
288                payment_verified=state.get("x402_payment_verified", False),
289                prd=_prd(state),
290                flutter_root=flutter_root,
291                dry_run=dry_run,
292                build_mode=build_mode,
293                sdk_root=sdk_root,
294            )
295        except PaymentNotVerified as exc:
296            # Not a build failure: the code is green, it just isn't paid for.
297            return {
298                "phase": "done",
299                "log": [f"packaging: gate closed — {exc}"],
300            }
301        return {
302            "phase": "failed" if result.status == "failed" else "done",
303            "failure": result.detail if result.status == "failed" else "",
304            "apk_path": result.apk_path or "",
305            "log": [f"packaging: {result.status} — {result.detail}"],
306        }
307
308    return packaging
309
310
311def make_router(max_repairs: int) -> Callable[[BuildState], str]:
312    def route_after_qa(state: BuildState) -> str:
313        if state.get("phase") == "failed":
314            return "fail"
315        diagnostics = state.get("diagnostics", [])
316        if not diagnostics:
317            return "package"
318        if state.get("repair_attempts", 0) > max_repairs:
319            return "fail"
320        # Send the batch to whichever agent owns it; upstream-owned diagnostics
321        # (frozen pubspec/DESIGN.md) are unfixable and fail fast.
322        target = route_for(diagnostics)
323        if state.get("stalled") and target in ("repair_ui", "repair_logic"):
324            # The owner had its turn and changed nothing. Rather than spend the
325            # rest of the budget re-running it, give the other agent the problem:
326            # a provider the PRD does not justify is fixed by the UI dropping the
327            # reference, not by Logic inventing something to satisfy it.
328            return "repair_logic" if target == "repair_ui" else "repair_ui"
329        return target
330
331    return route_after_qa
332
333
334def route_after_agent(state: BuildState) -> str:
335    """Short-circuit the graph when a subagent violated its lane."""
336    return "fail" if state.get("phase") == "failed" else "continue"

src/graph/state.py

1"""Shared state for the build loop.
2
3The state doubles as the enforcement point for CLAUDE.md's separation of concerns:
4`ui_files` is writable only by the GenUI subagent, `provider_files` only by the
5Logic subagent. Nothing merges them into one bucket.
6"""
7
8from __future__ import annotations
9
10import operator
11from typing import Annotated, Any, Literal, TypedDict
12
13from src.ports.analyzer import Diagnostic
14
15Phase = Literal["planning", "genui", "logic", "qa", "packaging", "done", "failed"]
16
17
18class BuildState(TypedDict, total=False):
19    # --- inputs, never mutated after the planning phase ---
20    prd: dict[str, Any]
21    build_dir: str
22
23    # --- planning subagent output ---
24    design_md: str
25    pubspec: str
26    analysis_options: str
27
28    # --- genui subagent output: lib/ui/** only ---
29    ui_files: dict[str, str]
30
31    # --- logic subagent output: lib/providers/** and lib/main.dart ---
32    provider_files: dict[str, str]
33
34    # --- qa subagent output ---
35    test_files: dict[str, str]
36    written_files: list[str]
37    # Out-of-lane writes, recorded by the offending agent so the
38    # loop can repair them instead of failing outright.
39    genui_violations: list[Diagnostic]
40    logic_violations: list[Diagnostic]
41    diagnostics: list[Diagnostic]
42    repair_attempts: int
43    # Signature of the previous round's diagnostics, and whether this round is
44    # identical to it. A stalled round means the owning agent had its turn and
45    # changed nothing, so the router hands the problem to the other agent.
46    diagnostic_signature: list[str]
47    stalled: bool
48
49    # --- packaging gate ---
50    x402_payment_verified: bool
51    apk_path: str
52
53    phase: Phase
54    failure: str
55    log: Annotated[list[str], operator.add]
56
57
58def initial_state(prd: dict[str, Any], build_dir: str) -> BuildState:
59    return BuildState(
60        prd=prd,
61        build_dir=build_dir,
62        ui_files={},
63        provider_files={},
64        diagnostics=[],
65        repair_attempts=0,
66        x402_payment_verified=bool(prd.get("x402_payment_verified", False)),
67        phase="planning",
68        log=[],
69    )
70
71
72def all_files(state: BuildState) -> dict[str, str]:
73    """The full project tree as path -> content, ready to write to disk."""
74    files: dict[str, str] = {}
75    if state.get("pubspec"):
76        files["pubspec.yaml"] = state["pubspec"]
77    if state.get("analysis_options"):
78        files["analysis_options.yaml"] = state["analysis_options"]
79    if state.get("design_md"):
80        files["DESIGN.md"] = state["design_md"]
81    files.update(state.get("ui_files", {}))
82    files.update(state.get("provider_files", {}))
83    return files

src/graph/init.py

src/payments/eip3009.py

1"""EIP-712 / EIP-3009 payment authorization verification.
2
3An x402 `exact` payment on an EVM chain is an EIP-3009
4`TransferWithAuthorization` message: the payer signs, off-chain, an
5authorization for the token contract to move a fixed amount to a fixed
6recipient. Anyone holding that signature can submit it on-chain.
7
8What this module establishes, cryptographically:
9
10  * the signature recovers to the address claiming to authorise the transfer
11  * the money is going to *our* address, in the expected asset, on the expected
12    chain, for at least the price we asked
13  * the authorization is inside its validity window
14  * the nonce has never been accepted by us before
15
16What it does NOT establish, and what no amount of local verification can:
17
18  * that the payer holds the balance
19  * that the transfer has actually been executed on-chain
20
21Those require submitting the authorization through a facilitator or RPC. A
22verified-but-unsettled authorization is a *promise* backed by a signature, not
23money received — see `Facilitator` in x402.py. Conflating the two would be the
24most expensive mistake available here, so the two steps are kept apart and named
25differently throughout.
26"""
27
28from __future__ import annotations
29
30import base64
31import binascii
32import json
33import time
34from dataclasses import dataclass
35from typing import Any
36
37from eth_account import Account
38from eth_account.messages import encode_typed_data
39from eth_utils import to_checksum_address
40
41X402_VERSION = 1
42SCHEME_EXACT = "exact"
43
44EIP712_DOMAIN_FIELDS = [
45    {"name": "name", "type": "string"},
46    {"name": "version", "type": "string"},
47    {"name": "chainId", "type": "uint256"},
48    {"name": "verifyingContract", "type": "address"},
49]
50
51TRANSFER_WITH_AUTHORIZATION_FIELDS = [
52    {"name": "from", "type": "address"},
53    {"name": "to", "type": "address"},
54    {"name": "value", "type": "uint256"},
55    {"name": "validAfter", "type": "uint256"},
56    {"name": "validBefore", "type": "uint256"},
57    {"name": "nonce", "type": "bytes32"},
58]
59
60
61class PaymentInvalid(Exception):
62    """The payment payload is malformed, mis-addressed, expired or unsigned."""
63
64
65@dataclass(frozen=True)
66class TokenConfig:
67    """Everything needed to reconstruct the payer's EIP-712 domain.
68
69    The domain must match the token contract exactly — `name` and `version` are
70    read from the deployed contract, not chosen by us. USDC on most chains is
71    ("USDC", "2"), but native-vs-bridged deployments differ, and a mismatch
72    silently makes every signature fail to recover to the right address.
73    """
74
75    chain_id: int
76    verifying_contract: str
77    domain_name: str = "USDC"
78    domain_version: str = "2"
79    network: str = "base-sepolia"
80    asset_decimals: int = 6
81
82    def domain(self) -> dict[str, Any]:
83        return {
84            "name": self.domain_name,
85            "version": self.domain_version,
86            "chainId": self.chain_id,
87            "verifyingContract": to_checksum_address(self.verifying_contract),
88        }
89
90
91@dataclass(frozen=True)
92class Authorization:
93    sender: str
94    recipient: str
95    value: int
96    valid_after: int
97    valid_before: int
98    nonce: bytes
99
100    def replay_key(self, token: TokenConfig) -> str:
101        """Identity for replay purposes.
102
103        EIP-3009 nonces are unique per (token contract, authoriser) — the same
104        random 32 bytes from a different payer, or for a different token, is a
105        different authorization. Keying on the nonce alone would let one payer's
106        spent nonce block another payer's valid one.
107        """
108        return ":".join((
109            str(token.chain_id),
110            to_checksum_address(token.verifying_contract),
111            to_checksum_address(self.sender),
112            "0x" + self.nonce.hex(),
113        ))
114
115
116@dataclass(frozen=True)
117class VerifiedPayment:
118    authorization: Authorization
119    token: TokenConfig
120    raw_header: str
121    payload: dict[str, Any]
122
123
124def _decode_header(header_value: str) -> dict[str, Any]:
125    """x402 sends the payload base64-encoded; tolerate raw JSON as well."""
126    text = header_value.strip()
127    if not text:
128        raise PaymentInvalid("empty payment header")
129    if not text.startswith("{"):
130        try:
131            text = base64.b64decode(text, validate=True).decode("utf-8")
132        except (binascii.Error, UnicodeDecodeError, ValueError) as exc:
133            raise PaymentInvalid(f"payment header is not valid base64: {exc}") from exc
134    try:
135        decoded = json.loads(text)
136    except json.JSONDecodeError as exc:
137        raise PaymentInvalid(f"payment header is not valid JSON: {exc}") from exc
138    if not isinstance(decoded, dict):
139        raise PaymentInvalid("payment payload must be a JSON object")
140    return decoded
141
142
143def _as_int(value: Any, field: str) -> int:
144    """Amounts and timestamps arrive as JSON strings to survive uint256."""
145    try:
146        return int(str(value), 0) if str(value).startswith("0x") else int(str(value))
147    except (TypeError, ValueError) as exc:
148        raise PaymentInvalid(f"{field} is not an integer: {value!r}") from exc
149
150
151def _as_nonce(value: Any) -> bytes:
152    try:
153        raw = bytes.fromhex(str(value).removeprefix("0x"))
154    except ValueError as exc:
155        raise PaymentInvalid(f"nonce is not hex: {value!r}") from exc
156    if len(raw) != 32:
157        raise PaymentInvalid(f"nonce must be 32 bytes, got {len(raw)}")
158    return raw
159
160
161def parse_authorization(payload: dict[str, Any]) -> Authorization:
162    if payload.get("x402Version") != X402_VERSION:
163        raise PaymentInvalid(f"unsupported x402Version: {payload.get('x402Version')!r}")
164    if payload.get("scheme") != SCHEME_EXACT:
165        raise PaymentInvalid(f"unsupported scheme: {payload.get('scheme')!r}")
166
167    inner = payload.get("payload")
168    if not isinstance(inner, dict):
169        raise PaymentInvalid("payload.payload missing")
170    auth = inner.get("authorization")
171    if not isinstance(auth, dict):
172        raise PaymentInvalid("payload.authorization missing")
173
174    try:
175        sender = to_checksum_address(auth["from"])
176        recipient = to_checksum_address(auth["to"])
177    except (KeyError, ValueError) as exc:
178        raise PaymentInvalid(f"authorization addresses invalid: {exc}") from exc
179
180    return Authorization(
181        sender=sender,
182        recipient=recipient,
183        value=_as_int(auth.get("value"), "value"),
184        valid_after=_as_int(auth.get("validAfter", 0), "validAfter"),
185        valid_before=_as_int(auth.get("validBefore"), "validBefore"),
186        nonce=_as_nonce(auth.get("nonce")),
187    )
188
189
190def typed_data(auth: Authorization, token: TokenConfig) -> dict[str, Any]:
191    return {
192        "types": {
193            "EIP712Domain": EIP712_DOMAIN_FIELDS,
194            "TransferWithAuthorization": TRANSFER_WITH_AUTHORIZATION_FIELDS,
195        },
196        "primaryType": "TransferWithAuthorization",
197        "domain": token.domain(),
198        "message": {
199            "from": auth.sender,
200            "to": auth.recipient,
201            "value": auth.value,
202            "validAfter": auth.valid_after,
203            "validBefore": auth.valid_before,
204            "nonce": auth.nonce,
205        },
206    }
207
208
209def recover_signer(auth: Authorization, token: TokenConfig, signature: str) -> str:
210    signable = encode_typed_data(full_message=typed_data(auth, token))
211    try:
212        return to_checksum_address(
213            Account.recover_message(signable, signature=signature)
214        )
215    except Exception as exc:  # bad length, bad v, non-hex, ...
216        raise PaymentInvalid(f"signature could not be recovered: {exc}") from exc
217
218
219def verify_payment(
220    header_value: str,
221    *,
222    token: TokenConfig,
223    pay_to: str,
224    min_value: int,
225    now: int | None = None,
226    clock_skew: int = 0,
227) -> VerifiedPayment:
228    """Cryptographically verify an x402 payment authorization.
229
230    Raises `PaymentInvalid` for anything wrong. Does not consume the nonce —
231    replay protection is a separate, atomic step, so that verification stays a
232    pure function and the claim can be made at exactly the moment service is
233    granted.
234    """
235    payload = _decode_header(header_value)
236
237    network = payload.get("network")
238    if network is not None and network != token.network:
239        raise PaymentInvalid(
240            f"payment is for network {network!r}, this service accepts {token.network!r}"
241        )
242
243    auth = parse_authorization(payload)
244
245    expected = to_checksum_address(pay_to)
246    if auth.recipient != expected:
247        # The signature may be perfectly valid — for somebody else.
248        raise PaymentInvalid(
249            f"payment is addressed to {auth.recipient}, not {expected}"
250        )
251
252    if auth.value < min_value:
253        raise PaymentInvalid(
254            f"payment authorises {auth.value}, price is {min_value}"
255        )
256
257    moment = int(time.time()) if now is None else now
258    if auth.valid_before <= moment - clock_skew:
259        raise PaymentInvalid("authorization has expired")
260    if auth.valid_after > moment + clock_skew:
261        raise PaymentInvalid("authorization is not valid yet")
262
263    inner = payload["payload"]
264    signature = inner.get("signature")
265    if not isinstance(signature, str) or not signature:
266        raise PaymentInvalid("payload.signature missing")
267
268    signer = recover_signer(auth, token, signature)
269    if signer != auth.sender:
270        # Somebody signed an authorization claiming to be a different payer.
271        raise PaymentInvalid(
272            f"signature recovers to {signer}, which is not the declared payer {auth.sender}"
273        )
274
275    return VerifiedPayment(
276        authorization=auth, token=token, raw_header=header_value, payload=payload
277    )

src/payments/facilitator.py

1"""Facilitator client — turns a verified authorization into money.
2
3Verification proves the payer signed an authorization. Settlement submits it to
4the token contract so the transfer actually executes. Only the second one is
5payment, and this module is the difference between the two.
6
7The service blocks the `202 Accepted` on settlement completing: a build is
8expensive, and starting one on the strength of a signature alone means an
9unfunded wallet gets free work. That costs the buyer a few seconds of latency
10and costs us nothing we were not already spending.
11
12Three properties are deliberate rather than incidental:
13
14**Retrying is safe, timing out is not.** An EIP-3009 nonce is consumed on-chain,
15so submitting the same authorization twice reverts rather than charging twice —
16retrying a *connection* failure is therefore sound. A timeout is different: the
17facilitator may have broadcast successfully and simply not answered in time, so
18the outcome is genuinely unknown. That case fails closed and says so, because
19the alternative is granting a build we may never be paid for.
20
21**Ambiguity is reported, not smoothed over.** `SettlementResult` distinguishes
22settled, refused and unknown. Collapsing unknown into failure would be a lie
23about whether the buyer was charged.
24
25**No retry after a definite refusal.** If the facilitator says the payer has
26insufficient funds, asking again produces the same answer and only delays the
27402.
28"""
29
30from __future__ import annotations
31
32import logging
33from dataclasses import dataclass
34from typing import Any
35
36import httpx
37
38from src.payments.eip3009 import TokenConfig, VerifiedPayment
39
40log = logging.getLogger(__name__)
41
42
43@dataclass(frozen=True)
44class SettlementResult:
45    """Outcome of submitting an authorization.
46
47    `unknown` is the important one: the request did not complete, the
48    authorization may or may not have executed on-chain, and no amount of local
49    reasoning can decide which. It is treated as a failure for the purpose of
50    granting service, and recorded distinctly for the purpose of reconciliation.
51    """
52
53    settled: bool
54    unknown: bool = False
55    transaction: str | None = None
56    reason: str | None = None
57
58    @property
59    def ok(self) -> bool:
60        return self.settled and not self.unknown
61
62
63@dataclass(frozen=True)
64class PrecheckResult:
65    """Whether the facilitator believes this authorization would settle.
66
67    Advisory. A balance can change between the check and the settlement, so a
68    positive answer is not a guarantee — it only means nothing is obviously
69    wrong, which is enough to justify spending the nonce.
70    """
71
72    valid: bool
73    unknown: bool = False
74    reason: str | None = None
75
76
77def payment_requirements(
78    token: TokenConfig,
79    pay_to: str,
80    price_atomic: int,
81    resource: str = "/builds",
82    output_schema: dict[str, Any] | None = None,
83) -> dict[str, Any]:
84    """The requirements object a facilitator checks the payload against.
85
86    Sent alongside the payload so the facilitator can confirm the authorization
87    matches what we actually asked for, rather than taking our word for it.
88
89    It is also the service's listing. A facilitator catalogs an endpoint the
90    first time it settles a payment for it, reading the description and schemas
91    out of exactly this object — there is no separate registration step. So a
92    `resource` of "/builds" would enter the public index as a path no agent can
93    resolve, and a listing with no `outputSchema` is one an agent cannot tell
94    apart from the thousands of others without a human reading prose.
95    """
96    from src.payments.x402 import challenge
97
98    # Built from the same call that produces the 402, so what is advertised, what
99    # is charged, and what is published cannot describe three different things.
100    terms = dict(challenge(
101        token=token, pay_to=pay_to, max_amount_required=price_atomic,
102        resource=resource, output_schema=output_schema,
103    )["accepts"][0])
104    return terms
105
106
107class HttpFacilitator:
108    """POSTs a verified payload to an x402 facilitator for on-chain execution.
109
110    The wire format follows the x402 facilitator convention (`/settle` taking
111    `paymentPayload` + `paymentRequirements`, answering with `success` and a
112    transaction hash). Facilitators differ in details, so the response reader is
113    tolerant about field names and strict about the one thing that matters:
114    nothing counts as settled unless the response says so explicitly.
115    """
116
117    def __init__(
118        self,
119        base_url: str,
120        token: TokenConfig,
121        pay_to: str,
122        price_atomic: int,
123        api_key: str | None = None,
124        timeout: float = 60.0,
125        retries: int = 2,
126        client: httpx.Client | None = None,
127        resource: str = "/builds",
128        output_schema: dict[str, Any] | None = None,
129    ) -> None:
130        self.base_url = base_url.rstrip("/")
131        self.token = token
132        self.pay_to = pay_to
133        self.price_atomic = price_atomic
134        # What the public catalog will say about this service. The facilitator
135        # indexes an endpoint on its first successful settlement, so these are
136        # not merely descriptive — they are the listing.
137        self.resource = resource
138        self.output_schema = output_schema
139        self.timeout = timeout
140        self.retries = retries
141        self._headers = {"Content-Type": "application/json"}
142        if api_key:
143            self._headers["Authorization"] = f"Bearer {api_key}"
144        self._client = client or httpx.Client(timeout=timeout)
145
146    # -- protocol ----------------------------------------------------------- #
147
148    def precheck(self, payment: VerifiedPayment) -> PrecheckResult:
149        """Ask the facilitator whether this would settle, without settling it.
150
151        Run before the nonce is claimed, and that ordering is the entire point.
152        Insufficient funds is a recoverable condition — the payer tops up and
153        presents the same authorization again — but claiming the nonce first
154        would burn it permanently for a payment that never happened. The local
155        checks cannot see a balance; only the facilitator can.
156
157        A negative answer here is advisory, not authoritative: the balance can
158        change between this call and settlement. It exists to avoid destroying
159        an authorization needlessly, not to replace the settle result.
160        """
161        try:
162            response = self._client.post(
163                f"{self.base_url}/verify",
164                json=self._body(payment),
165                headers=self._headers,
166            )
167        except httpx.HTTPError as exc:
168            return PrecheckResult(False, unknown=True, reason=f"transport: {exc}")
169
170        if response.status_code >= 400:
171            return PrecheckResult(
172                False, unknown=True, reason=f"facilitator {response.status_code}"
173            )
174        try:
175            body = response.json()
176        except ValueError:
177            return PrecheckResult(False, unknown=True, reason="unreadable response")
178        if not isinstance(body, dict):
179            return PrecheckResult(False, unknown=True, reason="response was not an object")
180
181        if body.get("isValid") is True:
182            return PrecheckResult(True)
183        if body.get("isValid") is False:
184            return PrecheckResult(
185                False, reason=str(body.get("invalidReason") or "facilitator refused")
186            )
187        return PrecheckResult(False, unknown=True, reason="response did not state validity")
188
189    def _body(self, payment: VerifiedPayment) -> dict[str, Any]:
190        return {
191            "x402Version": 1,
192            "paymentPayload": payment.payload,
193            "paymentRequirements": payment_requirements(
194                self.token, self.pay_to, self.price_atomic,
195                self.resource, self.output_schema,
196            ),
197        }
198
199    def settle(self, payment: VerifiedPayment) -> SettlementResult:
200        body = self._body(payment)
201        last: SettlementResult | None = None
202        for attempt in range(self.retries + 1):
203            try:
204                response = self._client.post(
205                    f"{self.base_url}/settle", json=body, headers=self._headers
206                )
207            except httpx.TimeoutException as exc:
208                # The facilitator may have broadcast and not answered. Retrying
209                # is still safe -- a duplicate submission reverts on the spent
210                # nonce -- but if every attempt times out the outcome stands
211                # unknown rather than refused.
212                last = SettlementResult(False, unknown=True, reason=f"timeout: {exc}")
213                log.warning("x402 settle attempt %s timed out", attempt + 1)
214                continue
215            except httpx.HTTPError as exc:
216                last = SettlementResult(False, unknown=True, reason=f"transport: {exc}")
217                log.warning("x402 settle attempt %s failed: %s", attempt + 1, exc)
218                continue
219
220            result = self._read(response)
221            if result.ok or not result.unknown:
222                # Settled, or definitively refused. Asking again would only
223                # repeat the same answer.
224                return result
225            last = result
226
227        return last or SettlementResult(False, unknown=True, reason="no attempt completed")
228
229    # -- response handling -------------------------------------------------- #
230
231    def _read(self, response: httpx.Response) -> SettlementResult:
232        if response.status_code >= 500:
233            # The facilitator broke, not the payment. Worth another attempt.
234            return SettlementResult(
235                False, unknown=True, reason=f"facilitator {response.status_code}"
236            )
237
238        try:
239            body = response.json()
240        except ValueError:
241            return SettlementResult(
242                False, unknown=True,
243                reason=f"unreadable response ({response.status_code})",
244            )
245        if not isinstance(body, dict):
246            return SettlementResult(False, unknown=True, reason="response was not an object")
247
248        if response.status_code >= 400:
249            return SettlementResult(
250                False,
251                reason=str(body.get("errorReason") or body.get("error")
252                           or f"facilitator {response.status_code}"),
253            )
254
255        # Settlement is affirmative-only: an ambiguous body is not a payment.
256        success = body.get("success")
257        transaction = body.get("transaction") or body.get("txHash")
258        if success is True:
259            return SettlementResult(True, transaction=transaction)
260        if success is False:
261            return SettlementResult(
262                False, reason=str(body.get("errorReason") or "facilitator refused")
263            )
264        return SettlementResult(
265            False, unknown=True, reason="response did not state success either way"
266        )

src/payments/replay.py

1"""Replay protection for payment authorizations.
2
3An EIP-3009 authorization is a bearer instrument: the signature is valid until
4the nonce is consumed on-chain, and anyone holding it can present it. Between
5our accepting one and its settling on-chain there is a window in which the same
6signature can be submitted again — so the service must refuse a nonce it has
7already honoured, without waiting for the chain to say so.
8
9Two properties matter more than they look:
10
11**The claim is atomic.** Checking "have I seen this?" and then recording it is a
12time-of-check/time-of-use race: two concurrent requests bearing the same
13signature both pass the check, and both get a build. `claim` does both under one
14lock and returns whether *this* caller was the first, so exactly one wins.
15
16**A claim is never released.** If the build subsequently fails, the nonce stays
17spent. Releasing it would mean a failed build hands back a reusable
18authorization, and "make the build fail" is not a difficult thing for a
19determined caller to arrange. Refunds are a business decision, not a
20concurrency-control one.
21"""
22
23from __future__ import annotations
24
25import logging
26import threading
27import time
28from typing import Any, Protocol
29
30log = logging.getLogger(__name__)
31
32
33class NonceStore(Protocol):
34    def claim(self, key: str, expires_at: int) -> bool: ...
35    def seen(self, key: str) -> bool: ...
36
37
38class InMemoryNonceStore:
39    """Single-process replay protection.
40
41    Correct for one process and explicitly not for more: two workers behind a
42    load balancer each keep their own set and would each honour the same nonce
43    once. A deployment with more than one process needs a shared store with an
44    atomic insert — `SETNX`, or a unique index and a caught integrity error.
45    That is a deployment decision, so this stays honest about its scope rather
46    than hiding behind the Protocol.
47    """
48
49    def __init__(self) -> None:
50        self._claimed: dict[str, int] = {}
51        self._lock = threading.Lock()
52
53    def claim(self, key: str, expires_at: int) -> bool:
54        """Record `key` as spent. True only for the first caller."""
55        with self._lock:
56            self._evict_expired()
57            if key in self._claimed:
58                return False
59            self._claimed[key] = expires_at
60            return True
61
62    def seen(self, key: str) -> bool:
63        with self._lock:
64            return key in self._claimed
65
66    def _evict_expired(self, now: int | None = None) -> None:
67        """Drop entries whose authorization can no longer be used anyway.
68
69        Safe precisely because expiry is enforced independently during
70        verification: once `validBefore` has passed, the authorization is
71        rejected on its own merits, so forgetting the nonce cannot enable a
72        replay. Without this the map grows without bound.
73        """
74        moment = int(time.time()) if now is None else now
75        if not self._claimed:
76            return
77        expired = [k for k, exp in self._claimed.items() if exp <= moment]
78        for key in expired:
79            del self._claimed[key]
80
81    def __len__(self) -> int:
82        with self._lock:
83            return len(self._claimed)
84
85
86class RedisNonceStore:
87    """Replay protection shared across processes.
88
89    `SET key value NX EX ttl` is a single round trip that Redis executes
90    atomically, and it returns whether *this* caller created the key. That is
91    exactly the property the in-memory lock provided, now holding across
92    uvicorn workers and hosts rather than within one interpreter — a
93    check-then-set pair of commands would reintroduce the race the lock existed
94    to close.
95
96    The TTL is the authorization's own `validBefore`. Expiring earlier would
97    reopen the replay window; expiring later would only waste memory, since a
98    lapsed authorization is refused on its own merits during verification.
99
100    A Redis outage refuses payment. Returning True when the store is unreachable
101    would turn an infrastructure blip into an unbounded replay window, which is
102    a far worse failure than rejecting some honest requests.
103    """
104
105    def __init__(self, client: Any, prefix: str = "x402:nonce:", grace: int = 60) -> None:
106        self._redis = client
107        self._prefix = prefix
108        # A little past expiry, so clock skew between us and the chain cannot
109        # let a still-valid authorization outlive its own claim.
110        self._grace = grace
111
112    def _key(self, key: str) -> str:
113        return f"{self._prefix}{key}"
114
115    def claim(self, key: str, expires_at: int) -> bool:
116        # Expiry is judged before the grace period is added, or a lapsed
117        # authorization would be claimable for another `grace` seconds. The
118        # grace exists to make a live claim outlive its authorization, not to
119        # extend the authorization itself.
120        remaining = int(expires_at - time.time())
121        if remaining <= 0:
122            # Verification should already have rejected this. Refuse anyway.
123            return False
124        ttl = remaining + self._grace
125        try:
126            created = self._redis.set(
127                self._key(key), str(int(time.time())), nx=True, ex=ttl
128            )
129        except Exception:  # noqa: BLE001 - any client error must fail closed
130            log.exception("nonce store unavailable; refusing payment")
131            return False
132        return bool(created)
133
134    def seen(self, key: str) -> bool:
135        try:
136            return bool(self._redis.exists(self._key(key)))
137        except Exception:  # noqa: BLE001
138            log.exception("nonce store unavailable")
139            # Unknown is reported as seen: the caller uses this for diagnostics,
140            # and claiming ignorance of a nonce we cannot check is the unsafe
141            # direction to guess in.
142            return True

src/payments/x402.py

1"""x402 payment gate.
2
3CLAUDE.md §4: the fastlane build command must never run unless
4`x402_payment_verified` is True in the supervisor payload. This module is the
5only place that decision is made, so it can be audited in one file.
6"""
7
8from __future__ import annotations
9
10import secrets
11from decimal import Decimal
12from typing import Any, Protocol
13
14from src.payments.facilitator import PrecheckResult, SettlementResult
15from src.payments.eip3009 import (
16    PaymentInvalid,
17    TokenConfig,
18    VerifiedPayment,
19    verify_payment,
20)
21from src.payments.replay import InMemoryNonceStore, NonceStore
22
23
24class PaymentNotVerified(RuntimeError):
25    """Raised when a packaging step is attempted without a verified payment."""
26
27
28def is_verified(payload: Any) -> bool:
29    """True only for a literal boolean True.
30
31    Truthy strings like "false" or "0" must not open the gate, so this is
32    deliberately stricter than `bool(...)`.
33    """
34    if isinstance(payload, dict):
35        payload = payload.get("x402_payment_verified", False)
36    return payload is True
37
38
39def require_verified(payload: Any) -> None:
40    if not is_verified(payload):
41        raise PaymentNotVerified(
42            "x402_payment_verified is not True — refusing to run the build pipeline"
43        )
44
45
46# --------------------------------------------------------------------------- #
47# Settling payment for an HTTP request
48# --------------------------------------------------------------------------- #
49
50PAYMENT_HEADER = "X-Payment"
51
52
53class PaymentRequired(Exception):
54    """No acceptable payment accompanied the request; answer 402."""
55
56    def __init__(self, challenge: dict[str, Any]) -> None:
57        super().__init__("payment required")
58        self.challenge = challenge
59
60
61class PaymentVerifier(Protocol):
62    def settle(self, header_value: str | None) -> bool: ...
63
64
65class Facilitator(Protocol):
66    """Submits a verified authorization on-chain and reports what happened.
67
68    Returns a `SettlementResult` rather than a bool deliberately. A bool has
69    room for "settled" and "did not settle" and nowhere to put the transaction
70    hash — which is the buyer's only proof of payment — or the difference
71    between a definite refusal and an unknown outcome. An earlier version did
72    return a bool, and the receipt was silently lost all the way to the API.
73    """
74
75    def settle(self, payment: VerifiedPayment) -> SettlementResult: ...
76
77    def precheck(self, payment: VerifiedPayment) -> PrecheckResult: ...
78
79
80class UnsettledFacilitator:
81    """Records authorizations without submitting them.
82
83    Verification proves the payer *signed* an authorization; only submitting it
84    proves the money moved. With no facilitator configured the service is
85    accepting signed promises, which is a deliberate deployment choice for a
86    testnet or a trusted counterparty and a bad one otherwise. It is therefore
87    reported by /healthz rather than left to be inferred, and the result carries
88    no transaction hash because there is no transaction.
89    """
90
91    def __init__(self) -> None:
92        self.pending: list[VerifiedPayment] = []
93
94    def settle(self, payment: VerifiedPayment) -> SettlementResult:
95        self.pending.append(payment)
96        return SettlementResult(
97            settled=True, reason="verification-only: not submitted on-chain"
98        )
99
100    def precheck(self, payment: VerifiedPayment) -> PrecheckResult:
101        # Nothing to ask; there is no chain in this mode.
102        return PrecheckResult(True)
103
104
105class X402Verifier:
106    """Real x402: EIP-712 signature recovery plus single-use nonces.
107
108    Order matters. The signature is checked first, so a garbage header costs
109    nothing and never touches the nonce store. The nonce is then claimed
110    atomically — that claim is the moment the payment is spent, and it happens
111    before any build is queued. Settlement runs last, because a facilitator
112    rejection must not silently un-spend a nonce that a concurrent request has
113    already been refused.
114    """
115
116    def __init__(
117        self,
118        token: TokenConfig,
119        pay_to: str,
120        min_value: int,
121        nonces: NonceStore | None = None,
122        facilitator: Facilitator | None = None,
123        clock_skew: int = 0,
124    ) -> None:
125        self.token = token
126        self.pay_to = pay_to
127        self.min_value = min_value
128        self.nonces = nonces if nonces is not None else InMemoryNonceStore()
129        self.facilitator = facilitator or UnsettledFacilitator()
130        self.clock_skew = clock_skew
131        self.last_error: str | None = None
132        # The buyer's receipt. Populated on success so the API can hand back
133        # proof of payment rather than an unverifiable "trust me".
134        self.last_transaction: str | None = None
135        self.last_settlement: SettlementResult | None = None
136
137    def settle(self, header_value: str | None) -> bool:
138        self.last_error = None
139        self.last_transaction = None
140        self.last_settlement = None
141        if not header_value:
142            self.last_error = "no payment header"
143            return False
144
145        try:
146            payment = verify_payment(
147                header_value,
148                token=self.token,
149                pay_to=self.pay_to,
150                min_value=self.min_value,
151                clock_skew=self.clock_skew,
152            )
153        except PaymentInvalid as exc:
154            self.last_error = str(exc)
155            return False
156
157        # Ask the facilitator before spending the nonce. Insufficient funds is
158        # recoverable — the payer tops up and re-presents the same signature —
159        # so burning their authorization for it would be needlessly destructive.
160        precheck = getattr(self.facilitator, "precheck", None)
161        if precheck is not None:
162            advice = precheck(payment)
163            if not advice.valid:
164                self.last_error = (
165                    f"payment could not be confirmed: {advice.reason}"
166                    if not advice.unknown
167                    else f"could not reach the facilitator ({advice.reason})"
168                )
169                return False
170
171        auth = payment.authorization
172        if not self.nonces.claim(auth.replay_key(self.token), auth.valid_before):
173            # Valid signature, already spent. This is the replay case, and it is
174            # worth distinguishing from a bad signature when reporting.
175            self.last_error = "authorization has already been used"
176            return False
177
178        result = self.facilitator.settle(payment)
179        self.last_settlement = result
180        if not result.ok:
181            # The nonce stays claimed on purpose: see replay.py.
182            self.last_error = (
183                # An unknown outcome is not a refusal, and saying so matters:
184                # the buyer may have been charged for a build they did not get.
185                f"settlement outcome unknown ({result.reason}) — "
186                "the payment may have executed on-chain"
187                if result.unknown
188                else f"payment was not settled: {result.reason}"
189            )
190            return False
191
192        self.last_transaction = result.transaction
193        return True
194
195
196class DevPaymentVerifier:
197    """Shared-secret stand-in, for local development only.
198
199    Retained so the service can be exercised without keys or a chain, and it
200    fails closed with no secret configured. Never use it where money matters:
201    it proves possession of a static string, which is replayable by anyone who
202    ever sees one request.
203    """
204
205    def __init__(self, secret: str | None) -> None:
206        self._secret = secret or ""
207        self.last_error: str | None = None
208
209    def settle(self, header_value: str | None) -> bool:
210        if not self._secret or not header_value:
211            self.last_error = "no payment header or no secret configured"
212            return False
213        ok = secrets.compare_digest(header_value, self._secret)
214        self.last_error = None if ok else "shared secret mismatch"
215        return ok
216
217
218def human_amount(atomic: int, decimals: int) -> str:
219    """The atomic price as a decimal string, for the human-readable field.
220
221    Derived rather than configured. When the displayed price was its own
222    parameter it kept the default it shipped with while the enforced price moved
223    to $3.00 — the 402 advertised fifty cents and the signature it accepted was
224    for six times that.
225    """
226    units = Decimal(atomic) / (Decimal(10) ** decimals)
227    text = f"{units:.{decimals}f}"
228    if "." not in text:
229        return text
230    # Drop trailing zeros so 3000000 reads as "3.00" not "3.000000", but keep at
231    # least two places so a round price still looks like a price. Stripping is
232    # confined to the fractional part: on a 0-decimal token "30" is thirty.
233    whole, _, frac = text.partition(".")
234    return f"{whole}.{frac.rstrip('0').ljust(2, '0')}"
235
236
237DEFAULT_PAYMENT_TIMEOUT_SECONDS = 300
238
239
240def challenge(
241    *,
242    token: TokenConfig | None = None,
243    pay_to: str | None = None,
244    max_amount_required: int | None = None,
245    resource: str = "/builds",
246    error: str | None = None,
247    output_schema: dict[str, Any] | None = None,
248) -> dict[str, Any]:
249    """The body accompanying a 402, telling the buyer exactly how to pay.
250
251    This is x402 version 1, matching `specs/x402-specification-v1.md`, because
252    v1 is what the facilitator settles — its `/supported` lists no other version.
253
254    Every field name here is the spec's, not one that reads naturally. The first
255    version of this function was written against our own client and the two
256    agreed with each other rather than with the standard: `asset` carried the
257    symbol "USDC" where the spec requires the token contract address, the
258    required `maxTimeoutSeconds` was missing, `resource` was a path rather than a
259    URL, and a human-readable `amount` of "3.00" sat where v2 defines `amount` as
260    *atomic units* — a client reading it as specified would have signed for three
261    millionths of a dollar. No third-party client could have paid this service.
262    """
263    accepts: dict[str, Any] = {"scheme": "exact"}
264
265    if token is not None:
266        accepts["network"] = token.network
267    if max_amount_required is not None:
268        accepts["maxAmountRequired"] = str(max_amount_required)
269    if token is not None:
270        # The contract address, per the spec — the buyer needs it to sign, and
271        # this is the field they are told to read it from.
272        accepts["asset"] = token.verifying_contract
273    if pay_to is not None:
274        accepts["payTo"] = pay_to
275
276    accepts["resource"] = resource
277    accepts["description"] = "One PRD compiled to a Flutter APK"
278    if max_amount_required is not None and token is not None:
279        # The price in dollars belongs in prose. It is not a protocol field: the
280        # only spec field it could plausibly occupy is `amount`, which means
281        # atomic units, and putting "3.00" there misreads as $0.000003.
282        price = human_amount(max_amount_required, token.asset_decimals)
283        accepts["description"] += f" (${price} USDC)"
284    accepts["mimeType"] = "application/json"
285    accepts["outputSchema"] = output_schema
286    accepts["maxTimeoutSeconds"] = DEFAULT_PAYMENT_TIMEOUT_SECONDS
287    if token is not None:
288        # Scheme-specific: for `exact` on EVM this is the EIP-712 domain the
289        # token signs under, which differs between mainnet and testnet USDC.
290        accepts["extra"] = {"name": token.domain_name, "version": token.domain_version}
291
292    body: dict[str, Any] = {
293        "x402Version": 1,
294        "accepts": [accepts],
295        "hint": f"retry with the {PAYMENT_HEADER} header",
296    }
297    if error:
298        # Why this particular attempt was refused. Distinguishing "expired" from
299        # "already used" from "wrong recipient" is the difference between a
300        # client that can retry correctly and one that cannot.
301        body["error"] = error
302    return body

src/payments/init.py

src/build/pipeline.py

1"""Packaging step — turns the analysed project into an installable APK.
2
3Gated on x402: `require_verified` is the first statement, so no code path
4reaches a build without a verified payment.
5
6This calls `flutter build apk` rather than the `fastlane android build_m2m_apk`
7lane CLAUDE.md originally specified. fastlane is a Ruby tool and every lane it
8would run here is a wrapper around this command; dropping it removes a whole
9language runtime from the build environment and from CI. Reinstate it when there
10are signing or Play-upload steps that actually justify it.
11
12`build_mode="release"` additionally strips the debug signing config the Flutter
13template wires into release builds, and then refuses to return an artifact it
14cannot show to be unsigned. The reasoning for emitting unsigned releases at all
15is in `signing.py`; the short version is that the service must not hold buyers'
16release keys.
17"""
18
19from __future__ import annotations
20
21import shutil
22import subprocess
23from dataclasses import dataclass
24from pathlib import Path
25
26from src.build.scaffold import ensure_android_scaffold
27from src.build.signing import inspect_signature, unsign_release
28from src.ports.toolchain import sdk_executable
29from src.payments.x402 import require_verified
30from src.prd.schema import PRD
31
32
33BUILD_MODES = ("debug", "release")
34
35
36@dataclass(frozen=True)
37class BuildResult:
38    status: str  # "built" | "skipped" | "failed"
39    detail: str
40    apk_path: str | None = None
41    # Only meaningful for release builds, where "who signed this?" is the
42    # difference between a shippable artifact and one Play will reject.
43    signature: str | None = None
44
45
46def _flutter(flutter_root: str | Path | None) -> str:
47    if flutter_root:
48        tool = sdk_executable(Path(flutter_root) / "bin", "flutter")
49        if tool is not None:
50            return tool
51    found = shutil.which("flutter")
52    if found is None:
53        raise RuntimeError(
54            "flutter is not on PATH and no --flutter-root was given; cannot package"
55        )
56    return found
57
58
59def _artifact(project_dir: Path, build_mode: str) -> Path | None:
60    """The APK this build produced — not merely the first one lying around.
61
62    `build/` accumulates: a debug run leaves `app-debug.apk` behind, and it sorts
63    ahead of `apk/release/app-release-unsigned.apk`. Taking the first match would
64    hand a buyer a debug artifact labelled as their release build. The signature
65    gate would catch that one, having been signed with the debug key, but as a
66    baffling failure rather than the bug it is.
67
68    Gradle also names the output `-unsigned` when no signing config exists at
69    all, and puts it under `apk/release/` rather than the `flutter-apk/` path
70    Flutter copies signed builds to — so matching on mode rather than filename
71    is what keeps this working in both cases.
72
73    Matched against the path *below* the project, never the absolute one: a
74    build directory that happens to be called `release_check` would otherwise
75    make every debug artifact in it look like a release build.
76    """
77    build_root = project_dir / "build"
78    for apk in sorted(build_root.rglob("*.apk")):
79        if build_mode in apk.relative_to(build_root).as_posix().lower():
80            return apk
81    return None
82
83
84def run_build(
85    project_dir: Path,
86    *,
87    payment_verified: bool,
88    prd: PRD | None = None,
89    flutter_root: str | Path | None = None,
90    dry_run: bool = False,
91    build_mode: str = "debug",
92    sdk_root: str | Path | None = None,
93) -> BuildResult:
94    # Payment gate first: nothing below is reachable without it.
95    require_verified(payment_verified)
96
97    if dry_run:
98        return BuildResult("skipped", "dry-run: no APK built")
99    if prd is None:
100        return BuildResult("skipped", "no PRD supplied; cannot scaffold the Android project")
101
102    try:
103        flutter = _flutter(flutter_root)
104    except RuntimeError as exc:
105        return BuildResult("skipped", str(exc))
106
107    if build_mode not in BUILD_MODES:
108        return BuildResult("failed", f"unknown build mode {build_mode!r}; expected one of {BUILD_MODES}")
109
110    try:
111        created = ensure_android_scaffold(project_dir, prd, flutter)
112    except RuntimeError as exc:
113        return BuildResult("failed", str(exc))
114
115    notes: list[str] = []
116    if build_mode == "release":
117        # Before the build, or Gradle signs with the debug key and the artifact
118        # has to be thrown away rather than corrected.
119        notes.append(unsign_release(project_dir))
120
121    proc = subprocess.run(
122        [flutter, "build", "apk", f"--{build_mode}"],
123        cwd=project_dir, capture_output=True, text=True, check=False,
124        encoding="utf-8", errors="replace",  # see analyzer.py
125    )
126    if proc.returncode != 0:
127        tail = ((proc.stdout or "") + (proc.stderr or "")).strip()[-800:]
128        return BuildResult("failed", f"`flutter build apk` exited {proc.returncode}: {tail}")
129
130    apk = _artifact(project_dir, build_mode)
131    if apk is None:
132        return BuildResult("failed", "flutter reported success but no .apk was produced")
133
134    size_mb = apk.stat().st_size / 1_048_576
135    scaffold_note = "scaffolded android/, " if created else ""
136    summary = f"{scaffold_note}{build_mode} APK {size_mb:.1f} MB"
137
138    if build_mode != "release":
139        return BuildResult("built", summary, str(apk))
140
141    # The artifact decides, not the patch. A release APK that is signed — or
142    # that cannot be shown to be unsigned — is worse than no artifact: the buyer
143    # would discover it at upload, having already paid.
144    signature = inspect_signature(apk, sdk_root)
145    if not signature.is_unsigned:
146        signer = f" (signer: {signature.signer})" if signature.signer else ""
147        return BuildResult(
148            "failed",
149            f"release APK is not verifiably unsigned — {signature.state}: "
150            f"{signature.detail}{signer}. Refusing to hand over a release build "
151            "that may carry the debug key.",
152            None,
153            signature.state,
154        )
155
156    return BuildResult(
157        "built",
158        f"{summary}, unsigned ({'; '.join(n for n in notes if n)})",
159        str(apk),
160        signature.state,
161    )

src/build/scaffold.py

1"""Android platform scaffolding.
2
3The loop generates `lib/`, `pubspec.yaml` and `test/` — everything needed to
4analyse and unit-test. Producing an APK additionally needs the Gradle project
5under `android/`, which only `flutter create` can lay down.
6
7It is generated into a temporary directory and only `android/` is copied across,
8rather than running `flutter create` over the build directory. `flutter create`
9writes its own `lib/main.dart` and `test/widget_test.dart` referencing a counter
10app; run in place it would either clobber generated code or leave a stale test
11that fails the analysis gate.
12"""
13
14from __future__ import annotations
15
16import shutil
17import subprocess
18import tempfile
19from pathlib import Path
20
21from src.prd.schema import PRD
22
23
24def _split_application_id(package_name: str) -> tuple[str, str]:
25    """`com.example.fieldnotes` -> (`com.example`, `fieldnotes`).
26
27    `flutter create` builds the applicationId as <org>.<project-name>, so
28    splitting this way reproduces the PRD's package_name exactly rather than
29    letting it drift to <org>.<dart_package_name>.
30    """
31    org, _, name = package_name.rpartition(".")
32    return org, name
33
34
35def ensure_android_scaffold(
36    project_dir: Path, prd: PRD, flutter: str, *, force: bool = False
37) -> bool:
38    """Add `android/` to the build directory. Returns True if it was created."""
39    target = project_dir / "android"
40    if target.exists() and not force:
41        return False
42
43    org, name = _split_application_id(prd.package_name)
44    with tempfile.TemporaryDirectory() as tmp:
45        staging = Path(tmp) / "scaffold"
46        proc = subprocess.run(
47            [
48                flutter, "create",
49                "--platforms=android",
50                "--org", org,
51                "--project-name", name,
52                str(staging),
53            ],
54            capture_output=True, text=True, check=False,
55            encoding="utf-8", errors="replace",  # see analyzer.py
56        )
57        if proc.returncode != 0:
58            raise RuntimeError(
59                f"`flutter create` failed ({proc.returncode}):\n"
60                f"{proc.stdout[-1500:]}\n{proc.stderr[-1500:]}"
61            )
62        if target.exists():
63            shutil.rmtree(target)
64        shutil.copytree(staging / "android", target)
65    return True

src/build/signing.py

1"""Release signing — what this service does, and deliberately what it does not.
2
3`flutter create` scaffolds a release build type that signs with the **debug**
4key:
5
6    buildTypes {
7        release {
8            // TODO: Add your own signing config for the release build.
9            // Signing with the debug keys for now, so `flutter run --release` works.
10            signingConfig = signingConfigs.getByName("debug")
11        }
12    }
13
14That TODO is the whole problem. Left alone, `flutter build apk --release`
15succeeds, produces a plausible `app-release.apk`, installs on a device, and is
16not shippable: the Android debug key is a well-known development credential, and
17Play rejects anything signed with it. A buyer paying for a build would receive
18an artifact that looks finished and cannot be published — a failure that only
19surfaces at upload, long after the money moved.
20
21**The service does not sign.** A release key is the credential that decides who
22can ship updates to an app's installed base; holding buyers' keys would mean
23holding that power over every app this service ever generated, and one breach
24would compromise all of them at once. So the release artifact is emitted
25*unsigned*, and the buyer signs it with a key the service never sees. This is
26less impressive than handing over an installable APK and strictly more correct.
27
28Two things make that safe rather than merely stated:
29
30**The Gradle edit is best-effort; the artifact is the gate.** Patching generated
31Gradle by pattern-matching a template that changes between Flutter versions is
32not something to stake a security property on. So `unsign_release` does its best
33and reports what it did, and `inspect_signature` then examines the APK that
34actually came out. The build fails if a release artifact turns out to be signed,
35whatever the patch believed.
36
37**Unknown is not clean.** If the signature state cannot be established — no
38`apksigner`, an unreadable file — the answer is `unknown`, and the caller treats
39that as "do not claim this is unsigned". Guessing in the reassuring direction is
40how a debug-signed APK reaches a buyer labelled as a release build.
41"""
42
43from __future__ import annotations
44
45import logging
46import os
47import re
48import shutil
49import subprocess
50import zipfile
51from dataclasses import dataclass
52from pathlib import Path
53
54from src.ports.toolchain import sdk_executable
55
56log = logging.getLogger(__name__)
57
58# Both dialects: Kotlin DSL (`signingConfig = signingConfigs.getByName("debug")`)
59# and the older Groovy one (`signingConfig signingConfigs.debug`).
60_SIGNING_CONFIG_LINE = re.compile(
61    r"^[ \t]*signingConfig[ \t]*(?:=[ \t]*)?signingConfigs[ \t]*[.(].*$",
62    re.MULTILINE,
63)
64
65_REPLACEMENT = (
66    "            // Intentionally unsigned. The generating service never holds a\n"
67    "            // buyer's release key; sign this artifact yourself. The stock\n"
68    "            // Flutter template signs release with the debug key here, which\n"
69    "            // builds green and cannot be published."
70)
71
72# Signature files as they appear inside the archive. v1 (JAR) signing only —
73# v2/v3 live in the APK Signing Block, which is not a zip entry, so this list is
74# a fallback and never the authority. Note that a release APK legitimately
75# carries many other `META-INF/*` entries (library version markers, service
76# descriptors); matching on the directory alone would call every APK signed.
77_V1_SIGNATURE_ENTRIES = re.compile(
78    r"^META-INF/(?:MANIFEST\.MF|[^/]+\.(?:RSA|DSA|EC|SF))$", re.IGNORECASE
79)
80
81SIGNED = "signed"
82UNSIGNED = "unsigned"
83UNKNOWN = "unknown"
84
85
86class ReleaseSigningError(RuntimeError):
87    """A release artifact could not be shown to be unsigned."""
88
89
90@dataclass(frozen=True)
91class Signature:
92    """What an APK's signature state is, and how confidently we know it."""
93
94    state: str  # SIGNED | UNSIGNED | UNKNOWN
95    detail: str
96    signer: str | None = None
97
98    @property
99    def is_unsigned(self) -> bool:
100        """True only for a positive finding. `unknown` is not `unsigned`."""
101        return self.state == UNSIGNED
102
103
104def unsign_release(project_dir: Path) -> str:
105    """Strip the debug signing config from the generated release build type.
106
107    Returns a human-readable note on what happened. Finding nothing to patch is
108    not an error: a template that never wired a signing config produces an
109    unsigned release already, and `inspect_signature` is what decides whether
110    the outcome was actually achieved.
111    """
112    gradle = _app_gradle(project_dir)
113    if gradle is None:
114        return "no android/app/build.gradle(.kts) to patch"
115
116    source = gradle.read_text(encoding="utf-8")
117    patched, count = _SIGNING_CONFIG_LINE.subn(_REPLACEMENT, source)
118    if count == 0:
119        return f"{gradle.name}: no signingConfig assignment found; left as generated"
120
121    gradle.write_text(patched, encoding="utf-8")
122    return f"{gradle.name}: removed {count} signingConfig assignment(s) from the release build"
123
124
125def _app_gradle(project_dir: Path) -> Path | None:
126    for name in ("build.gradle.kts", "build.gradle"):
127        candidate = project_dir / "android" / "app" / name
128        if candidate.exists():
129            return candidate
130    return None
131
132
133def find_apksigner(sdk_root: str | Path | None = None) -> str | None:
134    """Locate `apksigner`, preferring the newest build-tools available.
135
136    Checked in the order an operator would expect to win: an explicit argument,
137    then the standard Android SDK environment variables, then PATH.
138    """
139    roots = [
140        sdk_root,
141        os.getenv("ANDROID_SDK_ROOT"),
142        os.getenv("ANDROID_HOME"),
143    ]
144    for root in roots:
145        if not root:
146            continue
147        build_tools = Path(root) / "build-tools"
148        if not build_tools.is_dir():
149            continue
150        for version in sorted(build_tools.iterdir(), reverse=True):
151            candidate = sdk_executable(version, "apksigner")
152            if candidate is not None:
153                return candidate
154    return shutil.which("apksigner")
155
156
157def inspect_signature(apk: Path, sdk_root: str | Path | None = None) -> Signature:
158    """Report whether `apk` carries a signature.
159
160    `apksigner` is the authority because it reads the APK Signing Block, where
161    v2 and v3 signatures live; those are invisible to a zip listing, so the
162    fallback below can only ever prove the v1 case. An APK the fallback calls
163    unsigned may still carry a v2 signature, which is why a missing `apksigner`
164    yields `unknown` rather than `unsigned`.
165    """
166    if not apk.exists():
167        return Signature(UNKNOWN, f"no such file: {apk}")
168
169    apksigner = find_apksigner(sdk_root)
170    if apksigner is not None:
171        return _inspect_with_apksigner(apksigner, apk)
172
173    found = _v1_signature_entries(apk)
174    if found:
175        return Signature(SIGNED, f"v1 signature files present: {', '.join(found)}")
176    return Signature(
177        UNKNOWN,
178        "apksigner was not found, and a zip listing cannot see v2/v3 signatures; "
179        "install Android build-tools or set ANDROID_SDK_ROOT to decide this",
180    )
181
182
183def _inspect_with_apksigner(apksigner: str, apk: Path) -> Signature:
184    proc = subprocess.run(
185        [apksigner, "verify", "--print-certs", str(apk)],
186        capture_output=True, text=True, check=False,
187        encoding="utf-8", errors="replace",  # see analyzer.py
188    )
189    output = ((proc.stdout or "") + (proc.stderr or "")).strip()
190    if proc.returncode == 0:
191        return Signature(SIGNED, "apksigner verified a signature", _signer(output))
192
193    # A missing manifest is apksigner's way of saying "nothing signed this".
194    # Any other non-zero exit is a broken or unreadable APK, which is not the
195    # same finding and must not be reported as a clean unsigned artifact.
196    if "Missing META-INF/MANIFEST.MF" in output or "DOES NOT VERIFY" in output:
197        if _v1_signature_entries(apk):
198            return Signature(
199                SIGNED, f"signature files present but apksigner rejected them: {output[:200]}"
200            )
201        return Signature(UNSIGNED, "apksigner reports no signature")
202    return Signature(UNKNOWN, f"apksigner exited {proc.returncode}: {output[:200]}")
203
204
205def _signer(output: str) -> str | None:
206    for line in output.splitlines():
207        if "certificate DN:" in line:
208            return line.split("certificate DN:", 1)[1].strip()
209    return None
210
211
212def _v1_signature_entries(apk: Path) -> list[str]:
213    try:
214        with zipfile.ZipFile(apk) as archive:
215            return [n for n in archive.namelist() if _V1_SIGNATURE_ENTRIES.match(n)]
216    except (zipfile.BadZipFile, OSError):
217        log.exception("could not read %s as a zip", apk)
218        return []

src/build/init.py

src/ports/analyzer.py

1"""QA/compiler port.
2
3`DartAnalyzer` is the seam between the agent loop and the Flutter toolchain.
4`StubAnalyzer` runs today with no SDK installed; `DartSdkAnalyzer` shells out to
5the real `dart analyze` once Flutter is on PATH. Swapping one for the other must
6not require touching any node.
7"""
8
9from __future__ import annotations
10
11import json
12import re
13import shutil
14import subprocess
15from dataclasses import dataclass
16from pathlib import Path
17from typing import Protocol
18
19from src.ports.toolchain import sdk_executable
20
21import yaml
22
23
24class ToolchainUnavailable(RuntimeError):
25    """Raised when a real toolchain is requested but not installed."""
26
27
28@dataclass(frozen=True)
29class Diagnostic:
30    severity: str  # "error" | "warning" | "info"
31    file: str
32    line: int
33    code: str
34    message: str
35
36    def render(self) -> str:
37        return f"{self.severity.upper()} {self.file}:{self.line} [{self.code}] {self.message}"
38
39
40class DartAnalyzer(Protocol):
41    def analyze(self, project_dir: Path) -> list[Diagnostic]: ...
42
43
44# Warnings the QA subagent promotes to build-breaking errors.
45#
46# In a hand-written codebase an orphaned declaration is untidiness. In a
47# generated one it is evidence of a hallucination: the model decided it needed a
48# helper, wrote it, and never wired it to anything. The unreferenced code is the
49# visible half of the mistake — the missing call site is the half that matters,
50# and it is exactly the kind of silent incompleteness a buyer would discover at
51# runtime. Fail the build and make the agent finish the job.
52#
53# Escalated here rather than only in analysis_options.yaml so the policy holds
54# even when the analyzer config is missing, overridden, or written by a model.
55HALLUCINATION_WARNINGS = frozenset({
56    "unused_element",         # private declaration nothing references
57    "unused_field",           # field written but never read
58    "unused_local_variable",  # computed, then dropped
59    "dead_code",              # unreachable branch
60})
61
62
63# Warnings that mean the analysis itself is not trustworthy.
64#
65# `include_file_not_found` fires when analysis_options.yaml includes a lint
66# package the pubspec never declared. The analyser then runs with default rules
67# only, so every guarantee built on the lint set — unused code, dead code — is
68# silently void while the build still reports green. A check that has quietly
69# stopped running is worse than one that never existed, so this is fatal.
70ANALYSIS_INTEGRITY_WARNINGS = frozenset({
71    "include_file_not_found",
72    "analysis_option_unsupported_option",
73})
74
75
76def is_fatal(diagnostic: Diagnostic) -> bool:
77    return (
78        diagnostic.severity == "error"
79        or diagnostic.code in HALLUCINATION_WARNINGS
80        or diagnostic.code in ANALYSIS_INTEGRITY_WARNINGS
81    )
82
83
84# --------------------------------------------------------------------------- #
85# Stub implementation
86# --------------------------------------------------------------------------- #
87
88_SETSTATE = re.compile(r"\bsetState\s*\(")
89_ANIMATION_EXEMPT = re.compile(r"//\s*localized animation toggle")
90_FORBIDDEN_IN_UI = re.compile(r"import\s+'package:(firebase_\w+|cloud_firestore)/")
91_WIDGET_BUILD = re.compile(r"\bWidget\s+build\s*\(")
92# Trailing `[.)]` so `ref.read(fooProvider.notifier)` is checked too, not just
93# the bare `ref.watch(fooProvider)` form.
94_PROVIDER_REF = re.compile(r"\bref\.(?:watch|read)\(\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*[.)]")
95_PROVIDER_DECL = re.compile(r"^final\s+([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*\w*Provider", re.M)
96
97
98class StubAnalyzer:
99    """Toolchain-free static analysis.
100
101    Deliberately not a no-op: it enforces the conventions in CLAUDE.md §3 and
102    catches the provider-desync class of bug described in §4, so the repair loop
103    is exercised end to end before Flutter is ever installed.
104    """
105
106    def analyze(self, project_dir: Path) -> list[Diagnostic]:
107        out: list[Diagnostic] = []
108        out += self._check_pubspec(project_dir)
109
110        ui = sorted((project_dir / "lib" / "ui").rglob("*.dart"))
111        providers = sorted((project_dir / "lib" / "providers").rglob("*.dart"))
112
113        declared = self._declared_providers(providers)
114        for path in ui:
115            out += self._check_ui_file(project_dir, path, declared)
116        for path in providers:
117            out += self._check_provider_file(project_dir, path)
118
119        for path in [*ui, *providers, *sorted((project_dir / "lib").glob("*.dart"))]:
120            out += self._check_braces(project_dir, path)
121
122        return out
123
124    # -- individual rules -------------------------------------------------- #
125
126    def _check_pubspec(self, root: Path) -> list[Diagnostic]:
127        pubspec = root / "pubspec.yaml"
128        if not pubspec.exists():
129            return [Diagnostic("error", "pubspec.yaml", 0, "missing_pubspec",
130                               "pubspec.yaml was never written by the planning subagent")]
131        text = pubspec.read_text(encoding="utf-8")
132
133        # Parse, don't just grep. An unquoted colon in a PRD-supplied description
134        # yields a file that contains every required key and still crashes the
135        # flutter tool before analysis begins.
136        try:
137            parsed = yaml.safe_load(text)
138        except yaml.YAMLError as exc:
139            detail = " ".join(str(exc).split())
140            return [Diagnostic("error", "pubspec.yaml", 0, "unparseable_pubspec",
141                               f"pubspec.yaml is not valid YAML: {detail}")]
142        if not isinstance(parsed, dict):
143            return [Diagnostic("error", "pubspec.yaml", 0, "unparseable_pubspec",
144                               "pubspec.yaml did not parse to a YAML mapping")]
145
146        return [
147            Diagnostic("error", "pubspec.yaml", 0, "incomplete_pubspec",
148                       f"pubspec.yaml is missing required key {key!r}")
149            for key in ("name", "environment", "dependencies")
150            if key not in parsed
151        ]
152
153    def _declared_providers(self, provider_files: list[Path]) -> set[str]:
154        declared: set[str] = set()
155        for path in provider_files:
156            declared |= set(_PROVIDER_DECL.findall(path.read_text(encoding="utf-8")))
157        return declared
158
159    def _check_ui_file(self, root: Path, path: Path, declared: set[str]) -> list[Diagnostic]:
160        rel = path.relative_to(root).as_posix()
161        out: list[Diagnostic] = []
162        lines = path.read_text(encoding="utf-8").splitlines()
163
164        for n, line in enumerate(lines, start=1):
165            if _SETSTATE.search(line) and not _ANIMATION_EXEMPT.search(line):
166                out.append(Diagnostic(
167                    "error", rel, n, "setstate_in_ui",
168                    "setState is banned outside a localized animation toggle; use Riverpod "
169                    "(mark the exempt line with `// localized animation toggle`)",
170                ))
171            if _FORBIDDEN_IN_UI.search(line):
172                out.append(Diagnostic(
173                    "error", rel, n, "logic_in_ui",
174                    "UI files must not import Firebase; that belongs in lib/providers/",
175                ))
176
177        # The provider-desync check: a widget watching a provider the Logic
178        # subagent never declared is exactly the "Method not found" failure.
179        body = "\n".join(lines)
180        for name in sorted(set(_PROVIDER_REF.findall(body))):
181            if name not in declared:
182                line_no = next(
183                    (n for n, ln in enumerate(lines, 1) if f"({name})" in ln), 1
184                )
185                out.append(Diagnostic(
186                    "error", rel, line_no, "undefined_provider",
187                    f"provider {name!r} is watched here but never declared in lib/providers/",
188                ))
189        return out
190
191    def _check_provider_file(self, root: Path, path: Path) -> list[Diagnostic]:
192        rel = path.relative_to(root).as_posix()
193        out: list[Diagnostic] = []
194        for n, line in enumerate(path.read_text(encoding="utf-8").splitlines(), start=1):
195            if _WIDGET_BUILD.search(line):
196                out.append(Diagnostic(
197                    "error", rel, n, "ui_in_logic",
198                    "state files must not build widgets; that belongs in lib/ui/",
199                ))
200        return out
201
202    def _check_braces(self, root: Path, path: Path) -> list[Diagnostic]:
203        text = path.read_text(encoding="utf-8")
204        depth = text.count("{") - text.count("}")
205        if depth == 0:
206            return []
207        return [Diagnostic(
208            "error", path.relative_to(root).as_posix(), 0, "unbalanced_braces",
209            f"unbalanced braces ({depth:+d}); file is not parseable Dart",
210        )]
211
212
213# --------------------------------------------------------------------------- #
214# Real implementation
215# --------------------------------------------------------------------------- #
216
217class FlutterAnalyzer:
218    """The real QA subagent: `flutter analyze`.
219
220    Neither `dart analyze` nor `flutter analyze` offers machine-readable output
221    on Flutter 3.44 (`--machine` is gone, `--format=json` never existed on the
222    Flutter wrapper), so we parse the text format:
223
224        error - <message> - <file>:<line>:<col> - <code>
225
226    `flutter analyze` runs `pub get` itself, which is the step that actually
227    gates analysis: without a `.dart_tool/package_config.json` every
228    `package:flutter/...` import is an unresolved-URI error and the real
229    diagnostics are buried. Platform folders (android/, ios/) are NOT needed to
230    analyse — they are a packaging concern.
231    """
232
233    # Trailing ` - ` separated fields, parsed right-to-left so a message
234    # containing " - " does not corrupt the split.
235    _SUMMARY = re.compile(r"^\d+ issue|^No issues|^Analyzing ")
236
237    def __init__(self, flutter_root: str | Path | None = None) -> None:
238        self.flutter_root = Path(flutter_root) if flutter_root else None
239
240    def _tool(self, name: str) -> str:
241        if self.flutter_root:
242            tool = sdk_executable(self.flutter_root / "bin", name)
243            if tool is not None:
244                return tool
245            raise ToolchainUnavailable(
246                f"{name!r} not found under {self.flutter_root / 'bin'}"
247            )
248        found = shutil.which(name)
249        if found is None:
250            raise ToolchainUnavailable(
251                f"{name!r} is not on PATH and no --flutter-root was given. Install the "
252                f"Flutter SDK, or run with --analyzer stub."
253            )
254        return found
255
256    def analyze(self, project_dir: Path) -> list[Diagnostic]:
257        proc = subprocess.run(
258            [self._tool("flutter"), "analyze", "--no-congratulate"],
259            cwd=project_dir, capture_output=True, text=True, check=False,
260            # Flutter emits UTF-8; Windows would otherwise decode with cp1252,
261            # and a single undecodable byte kills subprocess's reader thread,
262            # leaving stdout as None. That surfaced as
263            # "TypeError: unsupported operand type(s) for +: 'NoneType' and
264            # 'str'" five PRDs into a sweep, nowhere near the real cause.
265            encoding="utf-8", errors="replace",
266        )
267        # 0 = clean, 1 = issues found. Anything else is the tool itself failing
268        # (unresolvable dependencies, an unparseable pubspec, no network).
269        if proc.returncode not in (0, 1):
270            raise ToolchainUnavailable(
271                f"`flutter analyze` failed ({proc.returncode}) in {project_dir}:\n"
272                f"{proc.stdout[-2000:]}\n{proc.stderr[-2000:]}"
273            )
274
275        out: list[Diagnostic] = []
276        for line in (proc.stdout or "").splitlines():
277            parsed = self._parse_line(line, project_dir)
278            if parsed is not None:
279                out.append(parsed)
280        return out
281
282    @classmethod
283    def _parse_line(cls, line: str, project_dir: Path) -> Diagnostic | None:
284        stripped = line.strip()
285        if not stripped or cls._SUMMARY.match(stripped):
286            return None
287        # severity - message - file:line:col - code
288        parts = stripped.rsplit(" - ", 2)
289        if len(parts) != 3:
290            return None
291        head, location, code = parts
292        severity, _, message = head.partition(" - ")
293        severity = severity.strip().lower()
294        if severity not in {"error", "warning", "info"}:
295            return None
296
297        file_part, _, line_col = location.rpartition(":")
298        file_part, _, line_no = file_part.rpartition(":")
299        if not file_part:
300            file_part, line_no = location, "0"
301
302        try:
303            # Ownership routing keys off repo-relative POSIX paths.
304            rel = Path(file_part).resolve().relative_to(project_dir.resolve()).as_posix()
305        except (ValueError, OSError):
306            rel = file_part.replace("\\", "/")
307
308        return Diagnostic(
309            severity=severity,
310            file=rel,
311            line=int(line_no) if line_no.isdigit() else 0,
312            code=code.strip(),
313            message=message.strip(),
314        )
315
316
317def get_analyzer(kind: str, flutter_root: str | Path | None = None) -> DartAnalyzer:
318    if kind == "stub":
319        return StubAnalyzer()
320    if kind == "dart":
321        return FlutterAnalyzer(flutter_root)
322    raise ValueError(f"unknown analyzer {kind!r}; expected 'stub' or 'dart'")

src/ports/conformance.py

1"""Does the generated app match the PRD that was paid for?
2
3`flutter analyze` grades syntax and types. It is completely silent on whether the
4code implements the spec: a PRD asking for a Cupertino app with four screens can
5compile perfectly as a Material app with one. That gap is invisible to every
6check we had before this module.
7
8These assertions are deliberately naming-agnostic. They search the generated
9sources for evidence of each PRD requirement rather than demanding exact file
10paths, so they validate the *substance* and stay honest when a model names things
11differently from `TemplateGenerator`.
12"""
13
14from __future__ import annotations
15
16import re
17
18import yaml
19
20from src.ports.analyzer import Diagnostic
21from src.ports.templates import camel, pascal, snake
22from src.prd.schema import PRD
23
24APP_WIDGET = {"material": "MaterialApp", "cupertino": "CupertinoApp"}
25
26# A route entry in any form: '/foo', "/foo", or a named-route constant.
27def _route_present(body: str, screen_id: str) -> bool:
28    slug = snake(screen_id)
29    return bool(re.search(rf"""['"]/?{re.escape(slug)}['"]""", body))
30
31
32def _ui_blob(files: dict[str, str]) -> str:
33    return "\n".join(v for k, v in files.items() if k.startswith("lib/ui/"))
34
35
36def _logic_blob(files: dict[str, str]) -> str:
37    """Everything under lib/ that is not the widget tree.
38
39    Models and Firestore access legitimately live in lib/models/ or
40    lib/services/ rather than lib/providers/, so restricting this to
41    lib/providers/ made `missing_provider` and `wrong_collection` fire against
42    perfectly correct code.
43    """
44    return "\n".join(
45        v for k, v in files.items()
46        if k.startswith("lib/") and not k.startswith("lib/ui/")
47    )
48
49
50def check_conformance(prd: PRD, files: dict[str, str]) -> list[Diagnostic]:
51    """Assert the generated tree implements the PRD. Offline; no toolchain."""
52    out: list[Diagnostic] = []
53    ui = _ui_blob(files)
54    logic = _logic_blob(files)
55
56    out += _check_theme(prd, ui)
57    out += _check_screens(prd, ui, files)
58    out += _check_models(prd, logic)
59    out += _check_form_fields(prd, files)
60    out += _check_navigation_reachable(prd, files)
61    out += _check_unwired_declarations(files)
62    out += _check_pubspec_parses(files)
63    out += _check_lint_package_installed(files)
64    out += _check_single_entrypoint(files)
65    out += _check_duplicate_declarations(files)
66    out += _check_consumer_state_build_signature(files)
67    return out
68
69
70# A file that merely *declares* where screens live, in any of the dialects a
71# generator might reach for. These are excluded from counting as evidence that
72# something navigates, because the whole bug being checked for is a screen that
73# appears in the route declarations and nowhere else.
74#
75# Only `routes:` was recognised until Opus 5 wrote `onGenerateRoute` instead.
76# Its routes.dart then counted as "something navigates here", and the check went
77# silent — verified against the real Opus app with every navigation call deleted,
78# where it reported nothing at all. A check that cannot fail is not a check, and
79# this one had been vacuous for the generator the service ships with by default.
80_DECLARES_ROUTES = re.compile(
81    r"\broutes\s*:"            # MaterialApp(routes: {...})
82    r"|\bonGenerateRoute\b"    # MaterialApp(onGenerateRoute:) and the factory
83    r"|\bRouteSettings\b"      # a factory switching on settings.name
84    r"|\bGoRoute\s*\("         # go_router, which Haiku reached for
85)
86
87# `//` that is not the tail of a `://` scheme, so a URL in a string survives.
88_LINE_COMMENT = re.compile(r"(?<!:)//.*$", re.M)
89
90
91def _code_only(body: str) -> str:
92    """Dart with its line comments removed.
93
94    Every pattern in this module asks "does the code do X", and a comment
95    *saying* X is not the code doing it. Both directions bite: a comment
96    mentioning a screen would satisfy the reachability search, and a comment
97    containing the text `routes:` made a file classify as a route table and drop
98    out of the search entirely. The second is not hypothetical — a comment
99    written in this repo, explaining this very check, did exactly that.
100    """
101    return _LINE_COMMENT.sub("", body)
102
103
104def _check_navigation_reachable(prd: PRD, files: dict[str, str]) -> list[Diagnostic]:
105    """A declared `navigate` action must actually be able to go somewhere.
106
107    The template generator listed every screen in the routes table and never
108    pushed one, so `/capture` and `/settings` existed and nothing could reach
109    them. Nothing caught it: each screen built in isolation, the routes table
110    was valid Dart, and neither the analyzer nor the smoke tests have an opinion
111    about whether a route is ever navigated to. The app was a form nobody could
112    open.
113
114    The check is deliberately loose about *how*. `Navigator.pushNamed(context,
115    '/capture')`, a `MaterialPageRoute` building `CaptureScreen`, or a router's
116    `go('/capture')` are all fine — what it will not accept is the target
117    appearing only in the routes table that declares it, which is the shape the
118    bug had.
119    """
120    out: list[Diagnostic] = []
121    code = {
122        path: _code_only(body) for path, body in files.items()
123        if path.startswith("lib/ui/")
124    }
125    routes_table = {
126        path for path, body in code.items() if _DECLARES_ROUTES.search(body)
127    }
128
129    for screen in prd.screens:
130        for action in screen.actions:
131            if action.kind != "navigate" or not action.target:
132                continue
133            slug = snake(action.target)
134            widget = f"{pascal(action.target)}Screen"
135
136            # Somewhere *else* has to do the navigating. Excluded: the routes
137            # table, which only declares the destination, and the destination's
138            # own file — whose `class CaptureScreen` and `const CaptureScreen(`
139            # otherwise match and make every unreachable screen look reachable.
140            declares_target = re.compile(rf"\bclass\s+{re.escape(widget)}\b")
141            reachable_from = "\n".join(
142                body for path, body in code.items()
143                if path not in routes_table
144                and not declares_target.search(body)
145            )
146
147            if re.search(rf"""['"]/?{re.escape(slug)}['"]""", reachable_from):
148                continue
149            if re.search(rf"\b{re.escape(widget)}\s*\(", reachable_from):
150                continue
151            # A named constant for the route, e.g. `Routes.today`. Opus 5 routes
152            # entirely through these — `Navigator.pushNamed(context, route)` with
153            # the path arriving as a constant — so a search for the literal
154            # '/today' or for `TodayScreen(` finds neither, and a working app
155            # with a navigation drawer gets reported unreachable. Matching the
156            # member name keeps the check as loose about *how* as it claims.
157            if re.search(rf"\.\s*{re.escape(camel(action.target))}\b", reachable_from):
158                continue
159            out.append(Diagnostic(
160                "error", f"lib/ui/{snake(screen.id)}_screen.dart", 0,
161                "unreachable_screen",
162                f"screen '{screen.id}' declares a navigate action "
163                f"'{action.name}' to '{action.target}', but nothing outside the "
164                f"routes table navigates there — the target is unreachable",
165            ))
166    return out
167
168
169def _check_pubspec_parses(files: dict[str, str]) -> list[Diagnostic]:
170    """pubspec.yaml must be valid YAML before anything else is worth checking.
171
172    `StubAnalyzer` already does this, but it is skipped under `--analyzer dart`,
173    and the real toolchain does not degrade gracefully: a malformed pubspec makes
174    `flutter analyze` abort with a YAML scanner stack trace and exit 255, which
175    surfaces as a toolchain failure rather than the model's mistake. Duplicating
176    the check here keeps it analyzer-independent.
177    """
178    text = files.get("pubspec.yaml")
179    if text is None:
180        return [Diagnostic("error", "pubspec.yaml", 0, "missing_pubspec",
181                           "no pubspec.yaml was produced")]
182    try:
183        parsed = yaml.safe_load(text)
184    except yaml.YAMLError as exc:
185        return [Diagnostic("error", "pubspec.yaml", 0, "unparseable_pubspec",
186                           f"pubspec.yaml is not valid YAML: {' '.join(str(exc).split())}")]
187    if not isinstance(parsed, dict):
188        return [Diagnostic("error", "pubspec.yaml", 0, "unparseable_pubspec",
189                           "pubspec.yaml did not parse to a YAML mapping")]
190    return []
191
192
193def _check_lint_package_installed(files: dict[str, str]) -> list[Diagnostic]:
194    """analysis_options.yaml is inert unless the pubspec installs the lint package.
195
196    Found on the first live model run: the generated pubspec omitted
197    flutter_lints, so the include failed, the analyser fell back to default
198    rules, and every lint-based guarantee quietly stopped applying while the
199    build still went green.
200    """
201    options = files.get("analysis_options.yaml", "")
202    pubspec = files.get("pubspec.yaml", "")
203    if "flutter_lints" not in options or "flutter_lints" in pubspec:
204        return []
205    return [Diagnostic(
206        "error", "pubspec.yaml", 0, "lints_not_installed",
207        "analysis_options.yaml includes package:flutter_lints but pubspec.yaml "
208        "never declares it, so every lint rule is silently disabled",
209    )]
210
211
212def _check_single_entrypoint(files: dict[str, str]) -> list[Diagnostic]:
213    """`main()` belongs in lib/main.dart and nowhere else.
214
215    A second `main()` under lib/ui/ is a lane violation our path-based check
216    cannot see — the file is in GenUI's lane, but bootstrapping the app is
217    Logic's job. Dart compiles it happily; the app just has two shells.
218    """
219    out: list[Diagnostic] = []
220    for path, body in sorted(files.items()):
221        if not path.startswith("lib/") or path == "lib/main.dart":
222            continue
223        if re.search(r"^(?:Future<void>\s+|void\s+)main\s*\(", body, re.M):
224            out.append(Diagnostic(
225                "error", path, 0, "misplaced_entrypoint",
226                "main() is declared here as well as in lib/main.dart; the "
227                "composition root belongs solely to lib/main.dart",
228            ))
229    return out
230
231
232# A `build` taking both a context and a ref. Correct in a ConsumerWidget, a
233# compile error in a State class — so the class it sits in decides, not the
234# signature. `[\s\S]*?` rather than `.*?` because a build method spans lines.
235_STATE_CLASS = re.compile(
236    r"class\s+(\w+)\s+extends\s+(?:ConsumerState|State)\b[\s\S]*?(?=\nclass\s|\Z)"
237)
238_BUILD_WITH_REF = re.compile(
239    r"\bWidget\s+build\s*\(\s*BuildContext\s+\w+\s*,\s*WidgetRef\s+\w+\s*\)"
240)
241
242
243def _check_consumer_state_build_signature(files: dict[str, str]) -> list[Diagnostic]:
244    """`build(context, ref)` inside a State class.
245
246    The two Riverpod base classes take different signatures: a `ConsumerWidget`
247    receives `(BuildContext, WidgetRef)`, while a `ConsumerState` receives only
248    the context and reads `ref` as an instance member. Writing the first inside
249    the second is a compile error — "more required arguments than those of
250    overridden method 'State.build'" — and it reads as a complaint about
251    overriding rather than about Riverpod, which is why it survives repair.
252
253    It cost a real paid build: three repair passes escalating between the GenUI
254    and Logic agents, $0.41 of tokens, and a buyer who had already been charged.
255    Caught here it is one deterministic diagnostic naming the fix, produced
256    before the toolchain runs at all.
257    """
258    out: list[Diagnostic] = []
259    for path, body in sorted(files.items()):
260        if not path.endswith(".dart"):
261            continue
262        code = _code_only(body)
263        for match in _STATE_CLASS.finditer(code):
264            if not _BUILD_WITH_REF.search(match.group(0)):
265                continue
266            out.append(Diagnostic(
267                "error", path, 0, "consumer_state_build_signature",
268                f"{match.group(1)}.build takes (BuildContext, WidgetRef), but a "
269                f"State class overrides build(BuildContext) only. Drop the "
270                f"WidgetRef parameter and use the inherited `ref` member; the "
271                f"class must extend ConsumerState and its widget "
272                f"ConsumerStatefulWidget. The (context, ref) signature belongs "
273                f"to ConsumerWidget, which is stateless.",
274            ))
275    return out
276
277
278def _check_duplicate_declarations(files: dict[str, str]) -> list[Diagnostic]:
279    """The same top-level name declared in two files.
280
281    Two subagents each writing their own `MinimalApp` is not a compile error —
282    they are separate libraries — but the app ends up with two divergent copies
283    of its own shell, and only one of them is reachable.
284    """
285    seen: dict[str, str] = {}
286    out: list[Diagnostic] = []
287    for path, body in sorted(files.items()):
288        if not path.startswith("lib/"):
289            continue
290        for name in sorted(_top_level_names(body)):
291            if name in _EXEMPT:
292                continue
293            if name in seen:
294                out.append(Diagnostic(
295                    "error", path, 0, "duplicate_declaration",
296                    f"{name!r} is also declared in {seen[name]}; two copies of the "
297                    f"same declaration means one of them is dead",
298                ))
299            else:
300                seen[name] = path
301    return out
302
303
304# Top-level declarations only. Matched per line rather than with a multiline
305# regex: `\s` inside a character class silently consumes indentation, which made
306# an earlier version flag every class *method* as top-level.
307_CLASS_LINE = re.compile(r"(?:class|mixin|enum|extension)\s+([A-Za-z]\w*)")
308# Requires the opening brace but not end-of-line, so a single-line body
309# (`String f(String s) { return s; }`) is matched as well as a multi-line one.
310_FUNC_LINE = re.compile(r"[\w<>,?\[\]]+\s+([a-z]\w*)\s*\([^)]*\)\s*(?:async\s*)?\{")
311_VAR_LINE = re.compile(r"(?:final|const)\s+(?:[\w<>,?\[\]]+\s+)?([a-z]\w*)\s*=")
312
313# `main` is called by the Flutter engine, never from Dart source.
314_ENTRYPOINTS = {"main"}
315
316# Serialization and value-semantics boilerplate on a data class.
317#
318# These are architectural contracts, not dead code. `toMap` exists so the model
319# *can* be written to Firestore, whether or not this particular PRD happens to
320# include a form screen that writes one; `fromSnapshot` is the read half of the
321# same contract. Judging them by reference count measures the current PRD's
322# feature set, not whether the data layer is correctly formed.
323#
324# Currently belt-and-braces: the matcher only scans column 0, so class methods
325# never reach this filter. It is written down because the obvious extension of
326# this check is to methods, and that is precisely when omitting it would start
327# deleting the data layer.
328_MODEL_BOILERPLATE = {
329    "toMap", "fromMap", "toJson", "fromJson", "fromSnapshot",
330    "copyWith", "toString", "hashCode",
331}
332
333_EXEMPT = _ENTRYPOINTS | _MODEL_BOILERPLATE
334
335
336def _top_level_names(body: str) -> set[str]:
337    """Names declared at column 0. A leading space means it is nested."""
338    names: set[str] = set()
339    for line in body.splitlines():
340        if not line or line[0].isspace() or line.lstrip().startswith(("//", "import", "@")):
341            continue
342        for pattern in (_CLASS_LINE, _FUNC_LINE, _VAR_LINE):
343            found = pattern.match(line)
344            if found:
345                names.add(found.group(1))
346                break
347    return names
348
349
350def _check_unwired_declarations(files: dict[str, str]) -> list[Diagnostic]:
351    """Public top-level declarations that nothing references.
352
353    `dart analyze` reports `unused_element` for *private* declarations only — it
354    cannot know whether an external package imports a public one. A generated
355    single-app tree has no external importers, so that reasoning does not apply
356    and the blind spot is real: a model that writes `String formatSubtitle(...)`
357    and never calls it produces a completely clean analysis.
358
359    That is the more likely hallucination shape, too, since nothing pushes a
360    model towards the `_` prefix that would have made the analyzer care.
361    """
362    lib = {k: v for k, v in files.items() if k.startswith("lib/")}
363    blob = "\n".join(lib.values())
364    out: list[Diagnostic] = []
365
366    for path, body in sorted(lib.items()):
367        for name in sorted(_top_level_names(body)):
368            if name in _EXEMPT or name.startswith("_"):
369                continue
370            # The declaration itself is one occurrence; a wired declaration has
371            # at least one more.
372            if len(re.findall(rf"\b{re.escape(name)}\b", blob)) < 2:
373                line = next(
374                    (n for n, ln in enumerate(body.splitlines(), 1) if name in ln), 0
375                )
376                out.append(Diagnostic(
377                    "error", path, line, "unwired_declaration",
378                    f"{name!r} is declared but never referenced anywhere in lib/; "
379                    f"either wire it up or do not generate it",
380                ))
381    return out
382
383
384def _check_theme(prd: PRD, ui: str) -> list[Diagnostic]:
385    expected = APP_WIDGET[prd.theme]
386    if expected in ui:
387        return []
388    wrong = next((w for w in APP_WIDGET.values() if w != expected and w in ui), None)
389    detail = f"found {wrong} instead" if wrong else "found no root app widget at all"
390    return [Diagnostic(
391        "error", "lib/ui/app.dart", 0, "theme_mismatch",
392        f"PRD requests the {prd.theme!r} theme, so the root widget must be "
393        f"{expected}; {detail}",
394    )]
395
396
397def _check_screens(prd: PRD, ui: str, files: dict[str, str]) -> list[Diagnostic]:
398    """Every PRD screen must exist as a widget and be wired into the app.
399
400    Reachability is judged by whether the widget class is referenced from
401    somewhere other than the file declaring it — not by looking for a route
402    string. A single-screen app reached via `home: const ArticlesScreen()` is
403    perfectly reachable, and so is one using `onGenerateRoute`, a router
404    package, or route-name constants. Demanding a literal `'/articles'` flagged
405    all of those as broken.
406    """
407    ui_files = {k: v for k, v in files.items() if k.startswith("lib/ui/")}
408    out: list[Diagnostic] = []
409
410    for screen in prd.screens:
411        pattern = rf"\bclass\s+(\w*{pascal(screen.id)}\w*)\b"
412        declaring = next(
413            ((path, re.search(pattern, body).group(1))
414             for path, body in sorted(ui_files.items()) if re.search(pattern, body)),
415            None,
416        )
417        if declaring is None:
418            out.append(Diagnostic(
419                "error", "lib/ui/", 0, "missing_screen",
420                f"PRD declares screen {screen.id!r} ({screen.title!r}) but no "
421                f"matching widget class was generated",
422            ))
423            continue
424
425        path, cls = declaring
426        referenced_elsewhere = any(
427            other != path and re.search(rf"\b{re.escape(cls)}\b", body)
428            for other, body in ui_files.items()
429        )
430        if not referenced_elsewhere:
431            out.append(Diagnostic(
432                "error", "lib/ui/app.dart", 0, "unreachable_screen",
433                f"screen {screen.id!r} is declared as {cls!r} in {path} but nothing "
434                f"else references it, so the app can never show it",
435            ))
436    return out
437
438
439def _check_models(prd: PRD, logic: str) -> list[Diagnostic]:
440    out: list[Diagnostic] = []
441    for model in prd.models:
442        if not re.search(rf"\b{camel(model.name)}\w*Provider\b", logic):
443            out.append(Diagnostic(
444                "error", "lib/providers/", 0, "missing_provider",
445                f"PRD declares model {model.name!r} but no provider for it was "
446                f"generated in lib/providers/",
447            ))
448            continue
449        # The collection name is the contract with Firestore; a typo here is
450        # silent at compile time and catastrophic at runtime.
451        if f"'{model.collection}'" not in logic and f'"{model.collection}"' not in logic:
452            out.append(Diagnostic(
453                "error", "lib/providers/", 0, "wrong_collection",
454                f"model {model.name!r} must read the Firestore collection "
455                f"{model.collection!r}, which appears nowhere in lib/providers/",
456            ))
457    return out
458
459
460def _check_form_fields(prd: PRD, files: dict[str, str]) -> list[Diagnostic]:
461    """A form that silently drops a field still compiles and still analyses clean."""
462    out: list[Diagnostic] = []
463    models = {m.name: m for m in prd.models}
464
465    for screen in prd.screens:
466        if screen.kind != "form" or not screen.model:
467            continue
468        model = models.get(screen.model)
469        if model is None:
470            continue
471        expected = screen.fields or model.fields
472        # Search the whole UI: the screen may legitimately be split across files.
473        body = _ui_blob(files)
474        for field in expected:
475            # A field counts as captured if its name appears as part of an
476            # identifier, or its label appears as a string. Requiring the
477            # literal `'name'` assumed TemplateGenerator's
478            # `controller.update('name', value)` idiom; an ordinary Flutter form
479            # uses `TextEditingController _nameController` and
480            # `labelText: 'Name'`, and never quotes the field name at all.
481            by_identifier = re.search(
482                rf"\b_*{re.escape(field.name)}\w*\b", body, re.IGNORECASE
483            )
484            by_label = (
485                f"'{field.label}'" in body or f'"{field.label}"' in body
486            )
487            if not (by_identifier or by_label):
488                out.append(Diagnostic(
489                    "error", "lib/ui/", 0, "missing_form_field",
490                    f"form screen {screen.id!r} must capture field "
491                    f"{field.name!r} ({field.label!r}), which no input references",
492                ))
493    return out

src/ports/generator.py

1"""Code-generation port.
2
3One Protocol, three methods — one per productive subagent in CLAUDE.md §1. The
4QA subagent is not here; it consumes `DartAnalyzer` instead.
5
6Two implementations exist: `TemplateGenerator` (deterministic, offline, no
7credentials) and `AnthropicGenerator` (real Claude calls). The graph never knows
8which it has.
9"""
10
11from __future__ import annotations
12
13from dataclasses import dataclass
14from typing import Protocol
15
16from src.ports.analyzer import Diagnostic
17from src.prd.schema import PRD
18
19
20@dataclass(frozen=True)
21class Plan:
22    design_md: str
23    pubspec: str
24    analysis_options: str = ""
25
26
27class CodeGenerator(Protocol):
28    def plan(self, prd: PRD) -> Plan:
29        """Planning subagent: draft DESIGN.md and pubspec.yaml."""
30        ...
31
32    def build_ui(
33        self, prd: PRD, design_md: str, diagnostics: list[Diagnostic]
34    ) -> dict[str, str]:
35        """GenUI subagent: the widget tree only. Returns lib/ui/** paths.
36
37        `diagnostics` is non-empty on a repair pass and contains only the
38        UI-owned subset — patch what they name, don't regenerate blindly.
39        """
40        ...
41
42    def wire_logic(
43        self,
44        prd: PRD,
45        design_md: str,
46        ui_files: dict[str, str],
47        diagnostics: list[Diagnostic],
48    ) -> dict[str, str]:
49        """Logic subagent: Riverpod + Firebase. Returns lib/providers/** and main.dart.
50
51        When `diagnostics` is non-empty this is a repair pass — patch the specific
52        callbacks named in the diagnostics rather than regenerating everything
53        (CLAUDE.md §4, Dart MCP Desync).
54        """
55        ...
56
57
58def get_generator(kind: str, **kwargs) -> CodeGenerator:
59    if kind == "template":
60        from src.ports.templates import TemplateGenerator
61
62        return TemplateGenerator(**kwargs)
63    if kind == "fixture":
64        # Test double: model-style code that agrees with no TemplateGenerator
65        # convention. Exists to prove the grading harness is not just grading
66        # its own output. See evals/fixture_generator.py.
67        import sys
68        from pathlib import Path as _P
69        sys.path.insert(0, str(_P(__file__).resolve().parents[2] / "evals"))
70        from fixture_generator import FixtureGenerator
71
72        return FixtureGenerator(**kwargs)
73    if kind == "claude":
74        from src.ports.llm import AnthropicGenerator
75
76        return AnthropicGenerator(**kwargs)
77    raise ValueError(
78        f"unknown generator {kind!r}; expected 'template', 'fixture' or 'claude'"
79    )

src/ports/llm.py

1"""Claude-backed implementation of `CodeGenerator`.
2
3    STATUS: exercised against the live API on Haiku 4.5. Structured output
4    parses, the request shape is accepted, and a generated app has passed real
5    `flutter analyze` plus its widget smoke tests. Not yet run on Opus, and not
6    yet green across the whole eval sweep — treat the pass rate, not this
7    docstring, as the measure.
8
9    What the first live sweeps taught, all encoded elsewhere in the pipeline:
10    `effort` is rejected outright by models that lack it (hence
11    OPTIONAL_FEATURES); models write lib/models/ and lib/firebase_options.dart
12    because that is ordinary Flutter, so lane rules must accommodate it; and a
13    lane violation is worth reporting as a repairable diagnostic rather than
14    failing the build outright.
15
16    `TemplateGenerator` remains the deterministic reference path and is
17    validated end to end. Compare against it with
18    `evals/run.py --generator claude --analyzer dart --run-tests`.
19
20Design intent (as written, not as proven):
21
22Each subagent is a separate, single-shot structured-output call with its own
23cached system prompt. Progressive disclosure is enforced here: the GenUI agent is
24never shown Firebase/Riverpod guidance, and the Logic agent is never asked to
25emit widgets. Lane enforcement is left to the graph nodes rather than done here —
26see `_bundle` for why filtering in this module was actively harmful.
27"""
28
29from __future__ import annotations
30
31import json
32import os
33from typing import Any
34
35import anthropic
36
37from src.ports.analyzer import Diagnostic
38from src.ports.generator import Plan
39from src.ports.usage import Usage
40from src.prd.schema import PRD
41
42DEFAULT_MODEL = "claude-opus-5"
43MAX_TOKENS = 64_000
44
45# Server-side refusal fallback. Cheap insurance, but not every org has the beta
46# enabled — `_call` downgrades once on a 400 rather than failing the build.
47FALLBACK_BETA = "server-side-fallback-2026-07-01"
48
49# Request features we prefer but can live without. If the server rejects one
50# by name, it is dropped and the call retried. Order matters only for the
51# retry budget in `_call`.
52OPTIONAL_FEATURES = ("effort", "fallbacks")
53
54
55class GenerationRefused(RuntimeError):
56    """The model declined the request (stop_reason == 'refusal')."""
57
58
59class GenerationMalformed(RuntimeError):
60    """The model returned no parseable structured output."""
61
62
63FILE_BUNDLE_SCHEMA: dict[str, Any] = {
64    "type": "object",
65    "properties": {
66        "files": {
67            "type": "array",
68            "items": {
69                "type": "object",
70                "properties": {
71                    "path": {"type": "string"},
72                    "content": {"type": "string"},
73                },
74                "required": ["path", "content"],
75                "additionalProperties": False,
76            },
77        }
78    },
79    "required": ["files"],
80    "additionalProperties": False,
81}
82
83PLAN_SCHEMA: dict[str, Any] = {
84    "type": "object",
85    "properties": {
86        "design_md": {"type": "string"},
87        "pubspec": {"type": "string"},
88    },
89    "required": ["design_md", "pubspec"],
90    "additionalProperties": False,
91}
92
93PLANNING_SYSTEM = """\
94You are the Planning subagent of an M2M Flutter app-generation pipeline.
95
96Given a JSON PRD, produce exactly two artifacts:
971. DESIGN.md — the frozen specification every downstream agent reads. Cover the
98   package name, data models, screens, and the ownership boundary between
99   lib/ui/ (GenUI subagent) and lib/providers/ (Logic subagent).
1002. pubspec.yaml — must declare name, description, environment, and dependencies
101   on flutter, flutter_riverpod, firebase_core and cloud_firestore.
102
103Constraints: standard Material/Cupertino widgets only. Riverpod for all state.
104No custom painting, no complex animations — the CI pipeline must not fail.
105DESIGN.md is frozen the moment you emit it; downstream agents may not revise it.
106"""
107
108GENUI_SYSTEM = """\
109You are the GenUI subagent. You write the Flutter widget tree and nothing else.
110
111Hard rules:
112- Emit files under lib/ui/ ONLY. Everything else under lib/ belongs to the Logic
113  subagent: lib/main.dart, lib/providers/, lib/models/, lib/services/ and
114  lib/firebase_options.dart. Do not write them even if the app obviously needs
115  them — emitting one fails the build.
116- Do NOT declare `main()` or the root App widget. Logic owns the composition
117  root; a second copy in lib/ui/ leaves the app with two shells.
118- No business logic: no Firebase imports, no network calls, no persistence.
119- No `setState`, except a strictly localized animation toggle, which must carry
120  the trailing comment `// localized animation toggle`.
121- Screens are `ConsumerWidget`. Read state via `ref.watch(<name>Provider)` and
122  invoke behaviour via `ref.read(<name>Provider.notifier)`. You do NOT define
123  those providers — the Logic subagent does. Use exactly the provider names
124  given to you; inventing a name causes a build failure.
125- If a screen needs a controller or focus node, it becomes a
126  `ConsumerStatefulWidget` with a `ConsumerState` — and then `build` takes
127  `(BuildContext context)` ONLY, reading `ref` as an inherited member. The
128  `build(BuildContext, WidgetRef)` signature belongs to `ConsumerWidget` alone;
129  writing it in a State class fails to compile with a message about overriding
130  `State.build` that says nothing about Riverpod.
131- Standard Material widgets only. Every file must be complete, parseable Dart
132  with balanced braces.
133- Always emit lib/ui/app.dart declaring the root MaterialApp and its routes.
134"""
135
136LOGIC_SYSTEM = """\
137You are the Logic subagent. You own state and data access, never the widget tree.
138
139Hard rules:
140- You own everything under lib/ EXCEPT lib/ui/. Put state in lib/providers/,
141  data classes in lib/models/, Firestore access in lib/services/ if you want a
142  service layer, and the composition root in lib/main.dart. Use the ordinary
143  Flutter layout; you are not restricted to one directory.
144- NEVER write anything under lib/ui/ — that is the GenUI subagent's, and it has
145  already written the widget tree you are being shown.
146- Never declare a `Widget build(...)` method — you do not build UI.
147- Declare the root App widget and `main()` exactly once, in lib/main.dart.
148- Riverpod only. Declare every provider referenced by the UI you are shown,
149  spelled exactly as the UI spells it.
150- Declare NO provider the UI does not reference. A derived "convenience"
151  provider that no screen watches is dead code and fails the build, however
152  reasonable it looks — if a screen needs a count, let that screen derive it.
153- Inside a Notifier/AsyncNotifier/StateNotifier subclass, never name a method
154  after one the Riverpod base class already declares: `update`, `build`,
155  `state`, `ref`, `future`, `stream`, `mounted`, `listenSelf`, `onDispose`.
156  `update` is the trap — the base class signature is
157  `update(FutureOr<State> Function(State), {onError})`, so a domain method
158  `update(String id, {...})` is an invalid override and will not compile. Use a
159  domain-specific name: `updateRecord`, `saveDraft`, `renameItem`.
160- Firestore has no date type. A `DateTime` is stored as a `Timestamp` and comes
161  back as a `Timestamp`, so `data['x'] as DateTime?` throws
162  `type 'Timestamp' is not a subtype of type 'DateTime?'` the first time the app
163  reads back a document it wrote. Deserialise with
164  `(data['x'] as Timestamp?)?.toDate()`. This is the trap that type-checks:
165  `flutter analyze` is clean and the widget tests pass, because catching it
166  needs a live Firestore. Whatever you choose, read it back the way you wrote
167  it: storing an ISO string and parsing it back is fine, and so is a Timestamp,
168  but `DateTime.tryParse('${data['x']}')` against a field you wrote as a
169  Timestamp parses the *stringified* Timestamp, fails, and silently yields your
170  fallback rather than throwing.
171- Firebase access goes through cloud_firestore inside providers/controllers.
172- lib/main.dart is the composition root: ensureInitialized, Firebase.initializeApp,
173  then runApp inside a ProviderScope. A bare `Firebase.initializeApp()` throws
174  wherever there is no native config file — on web it fails an assertion inside
175  firebase_core_web — so the app never starts. Take the identifiers from
176  `String.fromEnvironment` (`FIREBASE_PROJECT_ID`, `FIREBASE_API_KEY`,
177  `FIREBASE_APP_ID`, `FIREBASE_MESSAGING_SENDER_ID`), pass a `FirebaseOptions`
178  built from them when the project id is non-empty, and pass `null` when it is
179  empty so a platform carrying google-services.json still works. Never bake a
180  real project's identifiers into the source.
181- Every file must be complete, parseable Dart with balanced braces.
182
183When you are given QA diagnostics, this is a REPAIR pass. Patch the specific
184callbacks and providers named in the diagnostics. Do not rewrite unrelated files.
185"""
186
187
188class AnthropicGenerator:
189    def __init__(
190        self,
191        model: str = DEFAULT_MODEL,
192        effort: str = "high",
193        client: Any | None = None,
194    ) -> None:
195        # `or` rather than a getenv default: an unset variable and one set to
196        # the empty string have to mean the same thing here. Compose writes
197        # `SUPERVISOR_MODEL: ${SUPERVISOR_MODEL:-}`, which puts an empty string
198        # in the container when the deployment does not pin a model — and
199        # `os.getenv(name, default)` falls back only on absence, so the empty
200        # string would have been passed to the API as the model name.
201        self.model = os.getenv("SUPERVISOR_MODEL") or model
202        # Accumulated across every call this generator makes — planning, GenUI,
203        # Logic and each repair pass — so the total is what one app cost, not
204        # what one request cost.
205        self.usage = Usage()
206        self.effort = effort
207        # `client` exists so the request shape can be exercised without
208        # credentials; anthropic.Anthropic() raises at construction without them.
209        # `overloaded_error` (529) is transient and cost one PRD of a sweep
210        # to a single unlucky moment. The SDK retries 5xx already; this just
211        # buys more headroom than the default of 2.
212        self._client = (
213            client if client is not None else anthropic.Anthropic(max_retries=6)
214        )
215        # Populated at runtime from the server's own 400s.
216        self._unsupported: set[str] = set()
217
218    # -- transport ---------------------------------------------------------- #
219
220    def _build_kwargs(self, system: str, prompt: str, schema: dict[str, Any]) -> dict[str, Any]:
221        output_config: dict[str, Any] = {
222            "format": {"type": "json_schema", "schema": schema},
223        }
224        if "effort" not in self._unsupported:
225            output_config["effort"] = self.effort
226
227        kwargs: dict[str, Any] = dict(
228            model=self.model,
229            max_tokens=MAX_TOKENS,
230            system=[{
231                "type": "text",
232                "text": system,
233                "cache_control": {"type": "ephemeral"},
234            }],
235            messages=[{"role": "user", "content": prompt}],
236            output_config=output_config,
237        )
238        if "fallbacks" not in self._unsupported:
239            kwargs["betas"] = [FALLBACK_BETA]
240            kwargs["fallbacks"] = "default"
241        return kwargs
242
243    @staticmethod
244    def _rejected_feature(error: str) -> str | None:
245        """Which optional request feature did the server refuse, if any."""
246        lowered = error.lower()
247        for feature in OPTIONAL_FEATURES:
248            if feature in lowered:
249                return feature
250        return None
251
252    def _call(self, system: str, prompt: str, schema: dict[str, Any]) -> dict[str, Any]:
253        # `effort` and the refusal-fallback beta are quality features, not
254        # requirements: `effort` is rejected outright by models that lack it
255        # (Haiku 4.5 returns "This model does not support the effort parameter")
256        # and the beta is not enabled for every org. Losing a whole build to
257        # either would be absurd, so drop whichever the server names and retry.
258        # Each is remembered, so the probe costs one rejected request per
259        # generator, not one per call.
260        for _ in range(len(OPTIONAL_FEATURES) + 1):
261            kwargs = self._build_kwargs(system, prompt, schema)
262            try:
263                message = self._stream(kwargs)
264                break
265            except anthropic.BadRequestError as exc:
266                feature = self._rejected_feature(str(exc))
267                if feature is None or feature in self._unsupported:
268                    raise  # a real problem, not a capability mismatch
269                self._unsupported.add(feature)
270        else:  # pragma: no cover - exhausted every downgrade
271            raise GenerationMalformed("could not construct an acceptable request")
272
273        # Before the outcome checks below, so a refused or truncated response
274        # still counts: those tokens are billed, and a cost record that only
275        # captured successes would understate exactly the builds that went
276        # wrong most expensively.
277        if getattr(message, "usage", None) is not None:
278            self.usage.add(message.usage, self.model)
279
280        if message.stop_reason == "refusal":
281            detail = getattr(message, "stop_details", None)
282            raise GenerationRefused(
283                f"model declined the request (category="
284                f"{getattr(detail, 'category', None)!r})"
285            )
286        if message.stop_reason == "max_tokens":
287            raise GenerationMalformed(
288                f"output hit max_tokens ({MAX_TOKENS}); the PRD is too large for one pass"
289            )
290
291        text = next((b.text for b in message.content if b.type == "text"), None)
292        if not text:
293            raise GenerationMalformed("response contained no text block")
294        try:
295            return json.loads(text)
296        except json.JSONDecodeError as exc:
297            raise GenerationMalformed(f"structured output was not valid JSON: {exc}") from exc
298
299    def _stream(self, kwargs: dict[str, Any]):
300        # Streaming is required at this max_tokens; the helper accumulates for us.
301        surface = self._client.beta.messages if "betas" in kwargs else self._client.messages
302        with surface.stream(**kwargs) as stream:
303            return stream.get_final_message()
304
305    @staticmethod
306    def _bundle(payload: dict[str, Any]) -> dict[str, str]:
307        """Normalise paths. Deliberately does NOT filter by lane.
308
309        An earlier version dropped out-of-lane files here. That silently
310        defeated the enforcement in `make_genui_node` / `make_logic_node`: by the
311        time the node looked for stray paths there were none left, so a model
312        writing into the wrong lane produced a green build with its output
313        quietly discarded — the failure mode hardest to notice and worst to ship.
314
315        Returning everything lets the node fail the build and name the offending
316        paths, which is what it was written to do.
317        """
318        return {
319            entry["path"].lstrip("./").replace("\\", "/"): entry["content"]
320            for entry in payload.get("files", [])
321        }
322
323    # -- subagents ---------------------------------------------------------- #
324
325    def plan(self, prd: PRD) -> Plan:
326        payload = self._call(
327            PLANNING_SYSTEM,
328            "PRD:\n```json\n" + prd.model_dump_json(indent=2) + "\n```",
329            PLAN_SCHEMA,
330        )
331        # analysis_options.yaml is fixed boilerplate, not a creative artifact —
332        # asking the model for it only invites drift.
333        from src.ports.templates import ANALYSIS_OPTIONS
334
335        return Plan(
336            design_md=payload["design_md"],
337            pubspec=payload["pubspec"],
338            analysis_options=ANALYSIS_OPTIONS,
339        )
340
341    def build_ui(
342        self, prd: PRD, design_md: str, diagnostics: list[Diagnostic] | None = None
343    ) -> dict[str, str]:
344        prompt = (
345            "DESIGN.md (frozen):\n```markdown\n" + design_md + "\n```\n\n"
346            "PRD:\n```json\n" + prd.model_dump_json(indent=2) + "\n```\n\n"
347            "Emit every screen plus lib/ui/app.dart."
348        )
349        if diagnostics:
350            prompt += (
351                "\n\n## REPAIR PASS — QA reported these diagnostics against your files\n\n"
352                + "\n".join(f"- {d.render()}" for d in diagnostics)
353                + "\n\nRe-emit only the files these diagnostics name, fixed."
354            )
355        payload = self._call(GENUI_SYSTEM, prompt, FILE_BUNDLE_SCHEMA)
356        return self._bundle(payload)
357
358    def wire_logic(
359        self,
360        prd: PRD,
361        design_md: str,
362        ui_files: dict[str, str],
363        diagnostics: list[Diagnostic],
364    ) -> dict[str, str]:
365        ui_dump = "\n\n".join(
366            f"### {path}\n```dart\n{content}\n```" for path, content in sorted(ui_files.items())
367        )
368        prompt = (
369            "DESIGN.md (frozen):\n```markdown\n" + design_md + "\n```\n\n"
370            "PRD:\n```json\n" + prd.model_dump_json(indent=2) + "\n```\n\n"
371            "Widget tree written by the GenUI subagent:\n\n" + ui_dump
372        )
373        if diagnostics:
374            prompt += (
375                "\n\n## REPAIR PASS — QA reported these diagnostics\n\n"
376                + "\n".join(f"- {d.render()}" for d in diagnostics)
377                + "\n\nPatch only what these diagnostics name."
378            )
379        payload = self._call(LOGIC_SYSTEM, prompt, FILE_BUNDLE_SCHEMA)
380        return self._bundle(payload)

src/ports/navigation.py

1"""Generated tests that walk the app's declared navigation at runtime.
2
3`conformance.py` proves *something* navigates to every screen the PRD says is a
4target. That is a static claim about text in a file. It does not prove the
5destination renders, and it cannot: the route table entry
6`'/capture': (context) => const CaptureScreen()` satisfies the static check
7whether or not `CaptureScreen` survives being built for real.
8
9This closes the other half, in two claims per declared navigate action:
10
111. **The destination renders.** Boot the app through its own `main()` — the real
12   composition root, the real `ProviderScope`, the real Firebase initialisation
13   — drive the app's own `Navigator` to the target and check the destination is
14   on screen. Two things that were separately broken get exercised in passing:
15   an app whose `main()` could not start, and screens that had only ever been
16   built in isolation by the smoke tests.
172. **A user can get there by tapping.** Go to the source screen and tap its
18   affordances, one per attempt, looking for one that arrives at the target.
19
20**Why the destination is identified by its title.** Screen titles come from the
21PRD, so they are the one label guaranteed to be the same whatever a generator
22names its classes, files or routes. Matching a widget class would be matching
23`TemplateGenerator`'s `<Id>Screen` convention, and Claude does not always use it.
24
25**Why the route name is not taken from the generator either.** The route is
26`'/<screen id>'`, derived from the PRD, and both generators independently chose
27that shape. Where a generator does something else the test fails loudly rather
28than silently passing, which is the right direction for a check whose whole
29purpose is catching unreachable screens.
30
31**On hunting for the button.** The first version of this module refused to,
32because "tap whatever looks tappable" sounds like the kind of check that depends
33on widget choices and goes flaky. Three things make it honest rather than lucky:
34
35* *What counts as tappable is not a list of buttons.* `InkResponse` is
36  underneath `TextButton`, `ElevatedButton`, `IconButton`, `FloatingActionButton`
37  and `ListTile`; `CupertinoButton` and a hand-rolled `GestureDetector` cover
38  the rest. Enumerating button classes would have encoded one generator's taste;
39  enumerating the two or three primitives they are all built from does not.
40  It also finds affordances with no text at all — the template generator's own
41  list screens navigate from a `FloatingActionButton` whose only child is an
42  icon, so any text-based search would have missed the one case that ships most.
43* *Every attempt starts from a freshly pushed source screen*, so a tap that
44  opens a dialog, mutates state or navigates somewhere else cannot change what
45  the next attempt hits. That is what turns "tap things until something happens"
46  from a stateful sequence into N independent one-tap experiments.
47* *Arrival is route name first, title second.* `'/target'` on top of the
48  navigator is unambiguous; the title is the fallback for a generator that
49  pushes an unnamed `MaterialPageRoute`. The title alone would not do — a button
50  labelled with the destination's title is good UI and would make the test pass
51  before it tapped anything, so the title only counts if it was *not* already on
52  screen.
53
54What it still cannot prove is that a *multi-step* flow arrives: a sign-in form
55that navigates only after valid credentials needs one tap and some typing, and
56the PRD says nothing about what to type. Those fail here, honestly, rather than
57being quietly excluded.
58"""
59
60from __future__ import annotations
61
62import re
63
64from src.ports.templates import snake
65from src.prd.schema import PRD, Action, Screen
66
67_PUBSPEC_NAME = re.compile(r"^name:\s*([A-Za-z_][A-Za-z0-9_]*)", re.M)
68
69# How many affordances a single tap case tries before giving up; the reasoning
70# is in the doc comment it is emitted with.
71_TAP_BUDGET = 40
72
73
74def _package_name(prd: PRD, files: dict[str, str]) -> str:
75    match = _PUBSPEC_NAME.search(files.get("pubspec.yaml", ""))
76    return match.group(1) if match else snake(prd.app_name)
77
78
79def _dart_literal(text: str) -> str:
80    """A single-quoted Dart string. Titles are free text from the PRD."""
81    escaped = (
82        text.replace("\\", "\\\\")
83        .replace("'", "\\'")
84        .replace("$", "\\$")
85        .replace("\r", "")
86        .replace("\n", "\\n")
87    )
88    return f"'{escaped}'"
89
90
91# Shared by every case in the file. Kept as one block rather than interpolated
92# per case so the generated test reads like something a person would write.
93_HELPERS = """
94/// How many affordances a tap case tries before giving up. A list screen backed
95/// by an emulator can render dozens of rows, and each attempt costs a push and
96/// a settle; the failure message reports the budget so a genuine overrun cannot
97/// be mistaken for "nothing here reaches the target".
98const int _tapBudget = %(budget)d;
99
100/// The app's own root [Navigator] — not one this test installed.
101widgets.NavigatorState _navigator(WidgetTester tester) =>
102    tester.state<widgets.NavigatorState>(find.byType(widgets.Navigator).first);
103
104/// The name of the route currently on top, or null if it has none.
105///
106/// `popUntil` calls its predicate with the topmost route first and pops nothing
107/// when it immediately returns true, which is the only way to read the current
108/// route without owning the `MaterialApp` that created the navigator.
109String? _currentRoute(WidgetTester tester) {
110  String? name;
111  _navigator(tester).popUntil((route) {
112    name = route.settings.name;
113    return true;
114  });
115  return name;
116}
117
118/// `pumpAndSettle`, bounded, and tolerant of a screen that never settles.
119///
120/// An indeterminate progress indicator animates forever, so a screen waiting on
121/// data never settles and the default ten-minute timeout would be spent on
122/// every attempt. A few frames is enough to see where a tap landed.
123Future<void> _settle(WidgetTester tester) async {
124  try {
125    await tester.pumpAndSettle(
126      const Duration(milliseconds: 100),
127      EnginePhase.sendSemanticsUpdate,
128      const Duration(seconds: 5),
129    );
130  } catch (_) {
131    await tester.pump(const Duration(milliseconds: 600));
132  }
133}
134
135/// Everything on screen that a user could plausibly tap.
136///
137/// Deliberately the low-level affordances rather than a list of button classes:
138/// `InkResponse` is underneath `TextButton`, `ElevatedButton`, `IconButton`,
139/// `FloatingActionButton` and `ListTile`, and a generator that hand-rolls a
140/// button still ends up with a `GestureDetector`. Naming the buttons would be
141/// encoding one generator's taste in widgets.
142Finder _tappables() => find.byWidgetPredicate(
143      (widget) =>
144          widget is material.InkResponse ||
145          widget is cupertino.CupertinoButton ||
146          widget is widgets.GestureDetector,
147      description: 'tappable widget',
148    );
149
150/// Show the screen [title] belongs to, and say whether it worked.
151///
152/// The route is assumed to be `'/<screen id>'`, which is what the PRD implies.
153/// The **home** screen is the exception: `'/'` is the conventional name for it
154/// in Flutter, and an app that files it there answers a push of `'/<id>'` with
155/// whatever its `onGenerateRoute` returns for an unknown name — frequently a
156/// placeholder rather than an error. Opus generated exactly that, a "Route not
157/// found" Scaffold, so this walked onto an empty page and reported the target
158/// unreachable when the app was perfectly navigable.
159///
160/// Popping to the first route is therefore tried first, and the named push only
161/// if the wanted screen is not already the one showing.
162Future<bool> _open(WidgetTester tester, String route, Finder title) async {
163  _navigator(tester).popUntil((existing) => existing.isFirst);
164  await _settle(tester);
165  if (title.evaluate().isNotEmpty) {
166    return true; // it is the home screen; there is no route to push
167  }
168  _navigator(tester).pushNamed(route);
169  await _settle(tester);
170  return title.evaluate().isNotEmpty;
171}
172
173/// Tap the affordances on [source] one at a time, looking for one that arrives
174/// at [target]. Returns the empty string on success, or why it failed.
175///
176/// Each attempt re-opens [source] first, so every tap is an independent
177/// experiment on the same starting state rather than a step in a sequence.
178Future<String> _tapReaches(
179  WidgetTester tester,
180  String source,
181  String sourceTitle,
182  String target,
183  Finder title,
184) async {
185  final sourceFinder = find.text(sourceTitle);
186  if (!await _open(tester, source, sourceFinder)) {
187    return 'could not get to $source to start from: neither the first route nor '
188        'a push of $source shows "$sourceTitle", so this says nothing about '
189        'whether $target is reachable';
190  }
191  final total = _tappables().evaluate().length;
192  if (total == 0) {
193    return 'nothing on $source is tappable, so the target cannot be reached '
194        'by a user at all';
195  }
196  // A button labelled with the destination's title is good UI, and would make
197  // this pass before it tapped anything if arrival meant "the title is on
198  // screen". It only counts as arrival if it was not already there.
199  final titleWasVisible = title.evaluate().isNotEmpty;
200
201  final budget = total < _tapBudget ? total : _tapBudget;
202  for (var i = 0; i < budget; i++) {
203    await _open(tester, source, sourceFinder);
204    final candidates = _tappables();
205    if (i >= candidates.evaluate().length) {
206      break;
207    }
208    try {
209      await tester.tap(candidates.at(i), warnIfMissed: false);
210    } catch (_) {
211      continue; // off screen or covered: not an affordance a user could use
212    }
213    await _settle(tester);
214    if (_currentRoute(tester) == target) {
215      return '';
216    }
217    if (!titleWasVisible && title.evaluate().isNotEmpty) {
218      return '';
219    }
220  }
221  return 'tapped $budget of $total affordance(s) on $source and none of them '
222      'reached $target';
223}
224"""
225
226
227def _push_case(screen: Screen, action: Action, destination: str) -> str:
228    """The destination renders when the app's own navigator is driven to it."""
229    return f"""
230  testWidgets('{action.name}: {screen.id} -> {action.target} renders',
231      (tester) async {{
232    // Called without `await` on purpose. A Flutter entry point is idiomatically
233    // declared either `void main()` or `Future<void> main()` — both are
234    // ordinary, and awaiting the first is a compile error
235    // (`use_of_void_result`), which fails the whole build rather than the test.
236    // The settle below gives an async main time to finish initialising before
237    // anything touches the widget tree.
238    app.main();
239    await _settle(tester);
240
241    final destination = find.text({_dart_literal(destination)});
242    // `_open` rather than a bare push, because the home screen is
243    // conventionally filed at '/' and pushing '/<id>' for it lands on whatever
244    // the app returns for an unknown route.
245    await _open(tester, '/{action.target}', destination);
246
247    expect(
248      destination,
249      findsWidgets,
250      reason: 'neither the first route nor a push of /{action.target} showed the '
251          '{action.target} screen; it is declared but does not render',
252    );
253  }});"""
254
255
256def _tap_case(
257    screen: Screen, action: Action, destination: str, source_title: str
258) -> str:
259    """A user on the source screen can get to the target by tapping."""
260    return f"""
261  testWidgets('{action.name}: a tap on {screen.id} reaches {action.target}',
262      (tester) async {{
263    // Called without `await` on purpose. A Flutter entry point is idiomatically
264    // declared either `void main()` or `Future<void> main()` — both are
265    // ordinary, and awaiting the first is a compile error
266    // (`use_of_void_result`), which fails the whole build rather than the test.
267    // The settle below gives an async main time to finish initialising before
268    // anything touches the widget tree.
269    app.main();
270    await _settle(tester);
271
272    final failure = await _tapReaches(
273      tester,
274      '/{screen.id}',
275      {_dart_literal(source_title)},
276      '/{action.target}',
277      find.text({_dart_literal(destination)}),
278    );
279
280    expect(
281      failure,
282      isEmpty,
283      reason: "the PRD declares '{action.name}' on {screen.id}, so a user must "
284          'be able to reach {action.target} from it: $failure',
285    );
286  }});"""
287
288
289def build_navigation_test(prd: PRD, files: dict[str, str]) -> dict[str, str]:
290    """Return `integration_test/navigation_test.dart`, or nothing to test."""
291    titles = {screen.id: screen.title for screen in prd.screens}
292    cases: list[str] = []
293
294    for screen in prd.screens:
295        for action in screen.actions:
296            if action.kind != "navigate" or not action.target:
297                continue
298            destination = titles.get(action.target)
299            if destination is None:
300                # The schema rejects unknown targets, so this is unreachable;
301                # skipping beats emitting a test that cannot compile.
302                continue
303            cases.append(_push_case(screen, action, destination))
304            cases.append(_tap_case(screen, action, destination, screen.title))
305
306    if not cases:
307        return {}
308
309    package = _package_name(prd, files)
310    body = "\n".join(cases)
311    helpers = _HELPERS % {"budget": _TAP_BUDGET}
312    return {
313        # Identical to the one `roundtrip.py` writes, and emitted here too so a
314        # PRD with navigation but no data model still ships a runnable driver.
315        "test_driver/integration_test.dart": (
316            "// Generated. Entry point for `flutter drive`.\n"
317            "import 'package:integration_test/integration_test_driver.dart';\n"
318            "\n"
319            "Future<void> main() => integrationDriver();\n"
320        ),
321        "integration_test/navigation_test.dart": f"""// Generated. Boots the app through its own main() and, for every screen the
322// PRD declares as a navigate target, checks two things the routes table alone
323// never proved: that the destination renders when navigated to, and that some
324// affordance on the source screen actually gets a user there.
325import 'package:flutter/cupertino.dart' as cupertino;
326import 'package:flutter/material.dart' as material;
327import 'package:flutter/widgets.dart' as widgets;
328import 'package:flutter_test/flutter_test.dart';
329import 'package:integration_test/integration_test.dart';
330
331import 'package:{package}/main.dart' as app;
332{helpers}
333void main() {{
334  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
335{body}
336}}
337"""
338    }

src/ports/ownership.py

1"""Which subagent can actually fix a given diagnostic.
2
3CLAUDE.md §4 says to feed a failing stack trace back to the Logic subagent. That
4is right for the desync case it describes, but it is not a universal rule: a
5diagnostic anchored in `lib/ui/` is unfixable by an agent that may only write
6`lib/providers/`. Routing every diagnostic to Logic burns the repair budget and
7fails the build.
8
9So: explicit per-code ownership where we know better than the file path, and a
10path-based default for the long tail of real `dart analyze` codes.
11"""
12
13from __future__ import annotations
14
15from typing import Literal
16
17from src.ports.analyzer import Diagnostic
18
19Owner = Literal["genui", "logic", "fatal"]
20
21# Codes whose owner is not implied by the file they are anchored in.
22_EXPLICIT: dict[str, Owner] = {
23    # Anchored in lib/ui/, but the UI is correct and the Logic subagent is the
24    # one that must declare the provider. This is CLAUDE.md §4's desync case.
25    "undefined_provider": "logic",
26    # Anchored in lib/ui/ and genuinely the UI's fault.
27    "setstate_in_ui": "genui",
28    "logic_in_ui": "genui",
29    # Anchored in lib/providers/ and genuinely the Logic agent's fault.
30    "ui_in_logic": "logic",
31    # Conformance: the app compiles but is not the app that was specified.
32    "theme_mismatch": "genui",
33    "missing_screen": "genui",
34    "unreachable_screen": "genui",
35    "missing_form_field": "genui",
36    # A widget that throws on build is overwhelmingly a UI construction
37    # problem. A broken provider can also surface here; routing it to
38    # GenUI first still gives Logic a turn, since genui -> logic -> qa.
39    "smoke_failure": "genui",
40    # GenUI put the composition root in its own lane; it must drop it.
41    "misplaced_entrypoint": "genui",
42    # Routed by culprit, not by path: Logic writing lib/ui/ must be fixed
43    # by Logic, even though the path says GenUI owns that directory.
44    "genui_lane_violation": "genui",
45    "logic_lane_violation": "logic",
46    # Either agent may have written the second copy; GenUI goes first and the
47    # graph gives Logic a turn immediately after.
48    "duplicate_declaration": "genui",
49    "missing_provider": "logic",
50    "wrong_collection": "logic",
51    # Planning-phase output is frozen once GenUI starts; nothing downstream can
52    # repair it. Changes flow downstream, never upstream.
53    "missing_pubspec": "fatal",
54    "incomplete_pubspec": "fatal",
55    "unparseable_pubspec": "fatal",
56    "lints_not_installed": "fatal",
57}
58
59
60def owner_of(diagnostic: Diagnostic) -> Owner:
61    if diagnostic.code in _EXPLICIT:
62        return _EXPLICIT[diagnostic.code]
63
64    path = diagnostic.file.replace("\\", "/").lstrip("./")
65    if path.startswith("lib/ui/"):
66        return "genui"
67    if path.startswith("lib/providers/") or path == "lib/main.dart":
68        return "logic"
69    # pubspec.yaml, DESIGN.md, generated platform folders, unknown locations.
70    return "fatal"
71
72
73def route_for(diagnostics: list[Diagnostic]) -> str:
74    """Pick the next node for a batch of diagnostics.
75
76    GenUI wins a mixed batch: the graph flows genui -> logic -> qa anyway, so one
77    pass through GenUI gives both agents a turn before the next analysis.
78    """
79    owners = {owner_of(d) for d in diagnostics}
80    if "fatal" in owners:
81        return "fail"
82    if "genui" in owners:
83        return "repair_ui"
84    return "repair_logic"
85
86
87def unfixable(diagnostics: list[Diagnostic]) -> list[Diagnostic]:
88    return [d for d in diagnostics if owner_of(d) == "fatal"]

src/ports/pubspec.py

1"""Declaring the dependencies the *harness* needs, rather than hoping for them.
2
3The QA phase emits `integration_test/<model>_roundtrip_test.dart`,
4`integration_test/navigation_test.dart` and `test_driver/integration_test.dart`
5into every generated app. All three import `package:integration_test/...`, which
6resolves only if the pubspec declares it as a dev dependency.
7
8`TemplateGenerator`'s pubspec template happens to declare it. Nothing ever told
9any other generator to, because the requirement does not come from the PRD — it
10comes from files this repo writes after the generator has finished. The first
11Claude-generated app therefore analysed with:
12
13    error - Target of URI doesn't exist:
14    'package:integration_test/integration_test_driver.dart'
15
16which is the harness failing its own output. Worse than the error itself is
17where it lands: those diagnostics are attributed to the generated app, so they
18consume the repair budget and send a subagent off to fix code that was never
19wrong.
20
21A dependency the harness introduces is the harness's to declare.
22"""
23
24from __future__ import annotations
25
26import re
27
28# `integration_test` ships with the Flutter SDK, so it is `sdk: flutter` rather
29# than a version constraint — a pinned version would fail to resolve.
30_SDK_DEV_DEPENDENCIES = ("integration_test",)
31
32_DEV_DEPENDENCIES = re.compile(r"^dev_dependencies:\s*$", re.M)
33_TOP_LEVEL_KEY = re.compile(r"^[A-Za-z_][\w-]*:", re.M)
34
35
36def _already_declared(pubspec: str, name: str) -> bool:
37    """True if `name` is a dependency key anywhere in the file.
38
39    Matched as an indented key rather than a bare substring: `integration_test`
40    also appears in this project as a *directory* name, and a comment mentioning
41    it is not a declaration.
42    """
43    return re.search(rf"^\s+{re.escape(name)}:\s*$", pubspec, re.M) is not None
44
45
46def ensure_test_dependencies(pubspec: str) -> str:
47    """Add the SDK dev dependencies the generated tests import, if missing.
48
49    Text manipulation rather than a YAML round trip on purpose: parsing and
50    re-emitting would strip every comment and reflow the generator's formatting,
51    turning a two-line addition into a whole-file rewrite that no reviewer of
52    the generated app could scan.
53    """
54    missing = [n for n in _SDK_DEV_DEPENDENCIES if not _already_declared(pubspec, n)]
55    if not missing:
56        return pubspec
57
58    block = "".join(f"  {name}:\n    sdk: flutter\n" for name in missing)
59
60    match = _DEV_DEPENDENCIES.search(pubspec)
61    if match:
62        # Insert at the top of the existing block, where it reads as part of the
63        # list rather than as an afterthought appended past the last entry.
64        at = match.end() + 1
65        return pubspec[:at] + block + pubspec[at:]
66
67    # No dev_dependencies at all. Put one before the `flutter:` section if there
68    # is one, since trailing it after the asset/font declarations would read as
69    # though it belonged to them.
70    flutter_section = re.search(r"^flutter:\s*$", pubspec, re.M)
71    insertion = f"dev_dependencies:\n{block}"
72    if flutter_section:
73        at = flutter_section.start()
74        return pubspec[:at] + insertion + "\n" + pubspec[at:]
75
76    separator = "" if pubspec.endswith("\n\n") else ("\n" if pubspec.endswith("\n") else "\n\n")
77    return pubspec + separator + insertion

src/ports/roundtrip.py

1"""Generated tests that prove a model survives a trip through Firestore.
2
3Everything else the pipeline checks is static, and static analysis is blind to
4the failure that actually shipped: a generated model that casts a Firestore
5`Timestamp` straight to `DateTime`. That type-checks, passes the widget smoke
6tests, and throws the first time the app reads back a document it wrote.
7
8So this generates, per model, a test that writes through the app's **own**
9serializer and reads back through the app's **own** deserializer, then checks
10the fields came back unchanged.
11
12**Why that formulation and not a nicer-looking one.** The obvious test — write a
13document by hand, read it with the generated mapper — is wrong, and wrong in the
14way this codebase keeps getting wrong. `TemplateGenerator` stores a date as a
15`Timestamp`; the fixture generator stores it as an ISO-8601 string. Both are
16correct, because each reads back what it wrote. A hand-written document has to
17pick one convention, and would fail the other generator for having different
18taste rather than a bug. Round-tripping through the pair is the only check that
19holds a generator to its *own* contract, and it is exactly the property the
20shipped bug violated.
21
22For the same reason nothing here is hard-coded. The serializer pair is
23discovered: `TemplateGenerator` writes `fromSnapshot`/`toMap` into
24`lib/providers/`, the fixture generator writes `fromDoc`/`toJson` into
25`lib/models/`, and a test written against either set of names would silently
26stop testing the other. Over-fitting checks to one generator's conventions is
27the single most repeated mistake in this repo's history — 20 of 22 eval failures
28at one point — so the names are read out of the generated code.
29
30When the pair cannot be found, no test is emitted for that model. A missing test
31is a visible gap; a test that fails because the generator named things
32differently is a false alarm that trains everyone to ignore this file.
33"""
34
35from __future__ import annotations
36
37import re
38
39from src.ports.templates import pascal, snake
40from src.prd.schema import PRD
41
42# `factory Observation.fromSnapshot(DocumentSnapshot<Map<String, dynamic>> doc)`
43# and `factory Observation.fromDoc(DocumentSnapshot<...> doc)`.
44_FACTORY = re.compile(r"factory\s+(\w+)\s*\.\s*(\w+)\s*\(([^)]*)\)", re.M)
45
46# The deserialiser does not have to take a DocumentSnapshot. Opus writes
47# `fromMap(String id, Map<String, dynamic> map)`, which is arguably the better
48# design — it keeps the model free of Firestore types — and a discovery that
49# insisted on a snapshot silently emitted no test for it at all.
50SNAPSHOT = "snapshot"
51MAP_WITH_ID = "map_with_id"
52MAP_ONLY = "map_only"
53
54# `Map<String, dynamic> toMap() {` and `Map<String, dynamic> toJson() =>`.
55# The empty parens matter: they keep this from matching the `DocumentSnapshot<
56# Map<String, dynamic>> doc` in the factory signature above.
57_TO_MAP = re.compile(r"Map<\s*String\s*,\s*dynamic\s*>\s+(\w+)\s*\(\s*\)")
58
59# Every constructor parameter, required or not. Matching only `required this.x`
60# was itself over-fitted: `TemplateGenerator` marks every field required, but a
61# model is free to make fields optional with defaults — Claude does — and a
62# discovery that only sees required ones finds nothing to assert and silently
63# emits no test at all.
64_CTOR_PARAM = re.compile(r"(required\s+)?this\.(\w+)")
65_FIELD_DECL = re.compile(r"final\s+([\w<>?]+)\s+(\w+)\s*;")
66_PUBSPEC_NAME = re.compile(r"^name:\s*([A-Za-z_][A-Za-z0-9_]*)", re.M)
67
68
69class ModelApi:
70    """The serialiser pair for one model, as found in the generated code."""
71
72    def __init__(
73        self,
74        cls: str,
75        path: str,
76        from_snapshot: str,
77        from_style: str,
78        to_map: str,
79        params: list[tuple[str, bool]],
80        types: dict[str, str],
81    ) -> None:
82        self.cls = cls
83        self.path = path
84        self.from_snapshot = from_snapshot
85        # SNAPSHOT | MAP_WITH_ID | MAP_ONLY — how it wants to be called.
86        self.from_style = from_style
87        self.to_map = to_map
88        # (name, is_required) for every constructor parameter, in order.
89        self.params = params
90        self.types = types
91
92
93def _deserialiser_style(params: str) -> str | None:
94    """Classify a factory's parameter list, or None if it is not a deserialiser."""
95    flat = re.sub(r"\s+", " ", params)
96    if "DocumentSnapshot" in flat:
97        return SNAPSHOT
98    if re.search(r"Map<\s*String\s*,\s*dynamic\s*>", flat):
99        # `(String id, Map<...> map)` needs the document id passed separately;
100        # `(Map<...> map)` does not. Getting this wrong is an arity error, so it
101        # is read off the signature rather than assumed.
102        before = flat.split("Map<")[0]
103        return MAP_WITH_ID if "String" in before else MAP_ONLY
104    return None
105
106
107def _restore_call(api: ModelApi) -> str:
108    """The Dart that rebuilds the model from what Firestore handed back."""
109    if api.from_style == SNAPSHOT:
110        return f"{api.cls}.{api.from_snapshot}(snapshot)"
111    if api.from_style == MAP_WITH_ID:
112        return f"{api.cls}.{api.from_snapshot}(snapshot.id, snapshot.data()!)"
113    return f"{api.cls}.{api.from_snapshot}(snapshot.data()!)"
114
115
116def _ctor_params(body: str, cls: str) -> list[tuple[str, bool]]:
117    """Constructor parameters for `cls`, as (name, is_required).
118
119    The declaration is told apart from every `Cls(...)` call site by the fact
120    that only the declaration binds `this.` fields — matching the first
121    occurrence would otherwise pick up the `return Cls(...)` inside the
122    deserialiser and find nothing.
123    """
124    for match in re.finditer(rf"\b{re.escape(cls)}\s*\(([^)]*)\)", body):
125        params = match.group(1)
126        if "this." not in params:
127            continue
128        return [
129            (name, bool(required))
130            for required, name in _CTOR_PARAM.findall(params)
131        ]
132    return []
133
134
135def _package_name(prd: PRD, files: dict[str, str]) -> str:
136    """The Dart package name, from the manifest rather than from the PRD.
137
138    Same reasoning as `smoke.py`: deriving it from `app_name` assumes one
139    generator's naming and breaks every `package:` import for any other.
140    """
141    match = _PUBSPEC_NAME.search(files.get("pubspec.yaml", ""))
142    return match.group(1) if match else snake(prd.app_name)
143
144
145def _find_model_api(files: dict[str, str], model_name: str) -> ModelApi | None:
146    """Locate the class that serialises `model_name`, whatever it is called."""
147    expected = pascal(model_name)
148    candidates: list[ModelApi] = []
149
150    for path, body in sorted(files.items()):
151        if not path.startswith("lib/"):
152            continue
153        for cls, from_snapshot, params in _FACTORY.findall(body):
154            style = _deserialiser_style(params)
155            if style is None:
156                continue
157            to_map = _TO_MAP.search(body)
158            if to_map is None:
159                # It can read documents but not write them; a round trip needs
160                # both halves, and inventing the missing one is guesswork.
161                continue
162            candidates.append(
163                ModelApi(
164                    cls=cls,
165                    path=path,
166                    from_snapshot=from_snapshot,
167                    from_style=style,
168                    to_map=to_map.group(1),
169                    params=_ctor_params(body, cls),
170                    types=dict(
171                        (name, dart_type)
172                        for dart_type, name in _FIELD_DECL.findall(body)
173                    ),
174                )
175            )
176
177    for candidate in candidates:
178        if candidate.cls == expected:
179            return candidate
180    # Exactly one serialisable class in the whole app is unambiguous even if it
181    # is spelled differently. More than one, and picking would be a guess.
182    return candidates[0] if len(candidates) == 1 else None
183
184
185def _sample_literal(field_type: str) -> str:
186    """A Dart literal for a PRD field type, used as the value written."""
187    return {
188        "text": "'round trip'",
189        "number": "7",
190        "bool": "true",
191        "date": "stamp",
192    }[field_type]
193
194
195def _placeholder(dart_type: str) -> str:
196    """A value for a constructor parameter the PRD does not describe.
197
198    `id` is the usual one: generated models carry `doc.id`, which Firestore
199    assigns on write, so whatever goes in here is discarded. It only has to
200    compile — and it is never asserted on.
201    """
202    base = dart_type.rstrip("?")
203    return {
204        "String": "'placeholder'",
205        "num": "0",
206        "int": "0",
207        "double": "0",
208        "bool": "false",
209        "DateTime": "stamp",
210    }.get(base, "null")
211
212
213def build_roundtrip_tests(prd: PRD, files: dict[str, str]) -> dict[str, str]:
214    """Return `integration_test/*_roundtrip_test.dart` for every model we can test."""
215    package = _package_name(prd, files)
216    tests: dict[str, str] = {}
217
218    for model in prd.models:
219        api = _find_model_api(files, model.name)
220        if api is None:
221            continue
222
223        fields = {f.name: f.type for f in model.fields}
224        arguments = []
225        for name, required in api.params:
226            if name in fields:
227                # Always supplied, required or not: a PRD field left to its
228                # default would round-trip a default and prove nothing.
229                arguments.append(f"      {name}: {_sample_literal(fields[name])},")
230            elif required:
231                arguments.append(f"      {name}: {_placeholder(api.types.get(name, ''))},")
232            # Optional parameters the PRD says nothing about — a generator's own
233            # `createdAt` or `userId` — are left to their defaults. Inventing
234            # values for them would be guessing at someone else's semantics.
235
236        # Only PRD fields are asserted. `id` is reassigned by Firestore, and any
237        # other constructor parameter is the generator's business, not ours.
238        checks = "\n".join(
239            f"    expect(restored.{name}, original.{name},\n"
240            f"        reason: '{name} did not survive the round trip');"
241            for name, _ in api.params
242            if name in fields
243        )
244        if not checks:
245            continue
246
247        # Only declare the clock if something actually uses it. A model with no
248        # date field would otherwise get `unused_local_variable`, which the
249        # analyzer treats as an error and which fails the whole build.
250        uses_stamp = any("stamp" in argument for argument in arguments)
251        stamp_decl = (
252            """    // Whole seconds. Firestore keeps sub-millisecond precision and a
253    // generator storing dates as ISO strings keeps microseconds, so comparing
254    // finer than this would make the test about rounding, not correctness.
255    final stamp = DateTime.fromMillisecondsSinceEpoch(
256      (DateTime.now().millisecondsSinceEpoch ~/ 1000) * 1000,
257    );
258
259"""
260            if uses_stamp
261            else ""
262        )
263
264        import_path = api.path[len("lib/") :]
265        tests[f"integration_test/{snake(model.name)}_roundtrip_test.dart"] = f"""// Generated. Proves {api.cls} survives Firestore, using the app's own
266// serialiser pair ({api.to_map} / {api.from_snapshot}) rather than a
267// hand-written document, so a generator is held to its own convention.
268// The framework imports are prefixed and the app's is not, so the model name
269// always wins. A PRD is free to call a model `Order`, `Query` or `Source`, and
270// cloud_firestore exports all three — an unprefixed import makes that an
271// ambiguous_import error, which is a build failure caused purely by the buyer's
272// choice of noun.
273import 'package:cloud_firestore/cloud_firestore.dart' as fs;
274import 'package:firebase_core/firebase_core.dart' as core;
275import 'package:flutter/widgets.dart' as widgets;
276import 'package:flutter_test/flutter_test.dart';
277import 'package:integration_test/integration_test.dart';
278
279import 'package:{package}/{import_path}';
280
281const _emulator = String.fromEnvironment('FIRESTORE_EMULATOR');
282
283void main() {{
284  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
285
286  setUpAll(() async {{
287    await core.Firebase.initializeApp(
288      options: const core.FirebaseOptions(
289        apiKey: 'demo-key',
290        appId: '1:1:web:demo',
291        projectId: 'demo-roundtrip',
292        messagingSenderId: '1',
293      ),
294    );
295    final separator = _emulator.lastIndexOf(':');
296    fs.FirebaseFirestore.instance.useFirestoreEmulator(
297      _emulator.substring(0, separator),
298      int.parse(_emulator.substring(separator + 1)),
299    );
300  }});
301
302  testWidgets('{api.cls} survives a Firestore round trip', (tester) async {{
303    // Gives the binding a view. Without one the gesture layer throws
304    // "Bad state: No element" on every pointer packet the browser delivers.
305    await tester.pumpWidget(const widgets.SizedBox.shrink());
306
307{stamp_decl}    final original = {api.cls}(
308{chr(10).join(arguments)}
309    );
310
311    final reference = await fs.FirebaseFirestore.instance
312        .collection('{model.collection}')
313        .add(original.{api.to_map}());
314    final snapshot = await reference.get();
315    final restored = {_restore_call(api)};
316
317{checks}
318  }});
319}}
320"""
321
322    if tests:
323        # `flutter drive` needs a driver entry point, and an app that ships
324        # integration tests it cannot run is only half a deliverable. Emitted
325        # only alongside a test, so an app with nothing to round-trip does not
326        # carry a driver for tests that do not exist.
327        tests["test_driver/integration_test.dart"] = (
328            "// Generated. Entry point for `flutter drive`.\n"
329            "import 'package:integration_test/integration_test_driver.dart';\n"
330            "\n"
331            "Future<void> main() => integrationDriver();\n"
332        )
333    return tests

src/ports/runtime.py

1"""Run the generated widget tests as a second QA gate.
2
3`flutter analyze` proves the code compiles; this proves it runs. The two catch
4disjoint failure classes — a Material widget inside a CupertinoApp analyses
5perfectly and throws on first build.
6"""
7
8from __future__ import annotations
9
10import re
11import shutil
12import subprocess
13from pathlib import Path
14from typing import Protocol
15
16from src.ports.analyzer import Diagnostic, ToolchainUnavailable
17from src.ports.toolchain import sdk_executable
18
19# `  D:/path/to/test/foo_test.dart: SomeScreen builds without throwing`
20_FAILING = re.compile(r"^\s*(\S+?\.dart):\s*(.+?)\s*$")
21
22
23class TestRunner(Protocol):
24    def run(self, project_dir: Path) -> list[Diagnostic]: ...
25
26
27class FlutterTestRunner:
28    def __init__(self, flutter_root: str | Path | None = None) -> None:
29        self.flutter_root = Path(flutter_root) if flutter_root else None
30
31    def _tool(self) -> str:
32        if self.flutter_root:
33            tool = sdk_executable(self.flutter_root / "bin", "flutter")
34            if tool is not None:
35                return tool
36            raise ToolchainUnavailable(f"flutter not found under {self.flutter_root / 'bin'}")
37        found = shutil.which("flutter")
38        if found is None:
39            raise ToolchainUnavailable(
40                "flutter is not on PATH and no --flutter-root was given"
41            )
42        return found
43
44    def run(self, project_dir: Path) -> list[Diagnostic]:
45        if not (project_dir / "test").exists():
46            return []
47
48        proc = subprocess.run(
49            [self._tool(), "test", "--reporter", "compact"],
50            cwd=project_dir, capture_output=True, text=True, check=False,
51            # Flutter emits UTF-8; Windows would otherwise decode with cp1252,
52            # and a single undecodable byte kills subprocess's reader thread,
53            # leaving stdout as None. That surfaced as
54            # "TypeError: unsupported operand type(s) for +: 'NoneType' and
55            # 'str'" five PRDs into a sweep, nowhere near the real cause.
56            encoding="utf-8", errors="replace",
57        )
58        if proc.returncode == 0:
59            return []
60        combined = (proc.stdout or "") + "\n" + (proc.stderr or "")
61        return _parse_runner_output(combined, project_dir)
62
63
64def _parse_runner_output(output: str, project_dir: Path) -> list[Diagnostic]:
65    """Split out from `run` so the parsing is testable with no SDK present."""
66    _, _, tail = output.partition("Failing tests:")
67    out: list[Diagnostic] = []
68
69    for line in tail.splitlines():
70        match = _FAILING.match(line)
71        if not match:
72            continue
73        raw_path, test_name = match.groups()
74        try:
75            rel = Path(raw_path).resolve().relative_to(project_dir.resolve()).as_posix()
76        except (ValueError, OSError):
77            rel = raw_path.replace("\\", "/")
78        out.append(Diagnostic(
79            "error", rel, 0, "smoke_failure",
80            f"widget test failed: {test_name} — the screen compiles but does not "
81            f"build at runtime",
82        ))
83
84    if not out:
85        # Tests failed but the summary was not parseable. Never report green on
86        # a non-zero exit: a silently-swallowed failure is worse than a noisy one.
87        out.append(Diagnostic(
88            "error", "test/", 0, "smoke_failure",
89            f"`flutter test` failed: {output.strip()[-400:]}",
90        ))
91    return out

src/ports/smoke.py

1"""Generate widget smoke tests for the produced app.
2
3Everything else in this pipeline grades source code without executing it. A
4screen can analyse clean, satisfy every conformance check, and still throw the
5instant it is built — a missing ProviderScope, a provider that hits Firestore at
6construction, or a Material widget inside a CupertinoApp (no MaterialLocalizations)
7are all invisible to static analysis.
8
9These tests are derived from the generated sources, not from the PRD: class
10names, file names and provider names are *discovered* by scanning the output. A
11generator that names things differently from `TemplateGenerator` still gets
12valid tests, which matters because the point is eventually to grade the model.
13
14Only the StreamProviders a screen actually watches are overridden, and only the
15files it actually needs are imported — `unused_import` is escalated to an error,
16and `flutter analyze` reads test/ too, so a sloppy test file would fail the build
17it is meant to validate.
18"""
19
20from __future__ import annotations
21
22import re
23
24from src.ports.templates import snake
25from src.prd.schema import PRD
26
27# `class ObservationsScreen extends ConsumerWidget {`
28_WIDGET_CLASS = re.compile(
29    r"^class\s+([A-Za-z]\w*)\s+extends\s+"
30    r"(?:ConsumerWidget|StatelessWidget|ConsumerStatefulWidget|StatefulWidget)\b",
31    re.M,
32)
33# `final observationListProvider = StreamProvider<List<Observation>>((ref) {`
34# and the qualified forms a generator may equally well pick:
35#   StreamProvider.autoDispose<List<T>>   FutureProvider<List<T>>
36#
37# The qualifier chain is not cosmetic. An unmatched declaration means no
38# override is emitted, the screen reaches real Firestore, and the generated
39# `.when(error: ...)` handler renders an error widget instead of throwing — so
40# the smoke test passes while asserting nothing. A test that cannot fail is
41# worse than no test, because it reports as coverage.
42_ASYNC_PROVIDER = re.compile(
43    r"^final\s+(\w+)\s*=\s*(Stream|Future)Provider(?:\.\w+)*\s*<\s*List<\s*(\w+)\s*>\s*>",
44    re.M,
45)
46_PROVIDER_REF = re.compile(r"\bref\.(?:watch|read)\(\s*([a-zA-Z_]\w*)\s*[.)]")
47
48TEST_HEADER = "// GENERATED — asserts the screen builds without throwing.\n"
49
50
51_PUBSPEC_NAME = re.compile(r"^name:\s*['\"]?([a-z_][a-z0-9_]*)['\"]?\s*$", re.M)
52
53
54def _package_name(prd: PRD, files: dict[str, str]) -> str:
55    """The Dart package name, read from the manifest that will actually be used.
56
57    Deriving it from the PRD assumed TemplateGenerator's convention, where the
58    pubspec is named `snake(app_name)`. A generator that picks any other name
59    makes every `package:<pkg>/...` import in these tests point at a package
60    that does not exist, and the whole test file fails to resolve — which reads
61    as broken generated code rather than a broken test generator.
62    """
63    match = _PUBSPEC_NAME.search(files.get("pubspec.yaml", ""))
64    return match.group(1) if match else snake(prd.app_name)
65
66
67def _declaring_file(files: dict[str, str], type_name: str) -> str | None:
68    """Which lib/ file declares `class <type_name>`, if any."""
69    pattern = re.compile(rf"^class\s+{re.escape(type_name)}\b", re.M)
70    for path, body in sorted(files.items()):
71        if path.startswith("lib/") and pattern.search(body):
72            return path
73    return None
74
75
76def _needs_arguments(body: str, cls: str) -> bool:
77    """Does constructing `cls` require passing anything in?"""
78    match = re.search(rf"(?:const\s+)?{re.escape(cls)}\s*\(([^)]*)\)", body)
79    if match is None:
80        return False
81    params = match.group(1)
82    if "required" in params:
83        return True
84    # Anything left once the optional named block `{...}` is removed is a
85    # required positional parameter.
86    positional = re.sub(r"\{[^}]*\}", "", params).strip().strip(",").strip()
87    return bool(positional)
88
89
90def _discover_async_providers(files: dict[str, str]) -> dict[str, tuple[str, str, str]]:
91    """provider name -> (kind, element type, declaring file)."""
92    found: dict[str, tuple[str, str, str]] = {}
93    for path, body in files.items():
94        if not path.startswith("lib/providers/"):
95            continue
96        for name, kind, element in _ASYNC_PROVIDER.findall(body):
97            found[name] = (kind, element, path)
98    return found
99
100
101def build_smoke_tests(prd: PRD, files: dict[str, str]) -> dict[str, str]:
102    """Return test/**_smoke_test.dart for every generated screen widget."""
103    pkg = _package_name(prd, files)
104    cupertino = prd.theme == "cupertino"
105    framework = "cupertino" if cupertino else "material"
106    app_widget = "CupertinoApp" if cupertino else "MaterialApp"
107
108    # `MaterialApp(home: ...)` does not itself provide a Material ancestor —
109    # only Scaffold does. A widget designed to be shown inside
110    # `showModalBottomSheet` or a dialog is a bare Column of TextFields, and
111    # pumping it directly throws "No Material widget found" against code that is
112    # perfectly correct in the place it is actually used. Hosting every widget
113    # in a scaffold matches how the app really renders it; nesting one inside
114    # another is legal, so full screens are unaffected.
115    host_open, host_close = (
116        ("CupertinoPageScaffold(child: ", ")") if cupertino
117        else ("Scaffold(body: ", ")")
118    )
119    streams = _discover_async_providers(files)
120
121    tests: dict[str, str] = {}
122    for path, body in sorted(files.items()):
123        if not path.startswith("lib/ui/") or path.endswith("/app.dart"):
124            continue
125        classes = _WIDGET_CLASS.findall(body)
126        if not classes:
127            continue
128        widget = classes[0]
129
130        # Only widgets that can stand alone. A well-factored generator extracts
131        # reusable components — `ArticleTile({required this.article})`,
132        # `ErrorView({required this.message})` — and pumping those with no
133        # arguments produces `missing_required_argument` against code that is
134        # perfectly correct. A screen is something the app can show by itself;
135        # if it needs data passed in, it is a component and not ours to smoke.
136        if _needs_arguments(body, widget):
137            continue
138
139        # Only the providers this screen touches, so no import is unused.
140        watched = [n for n in dict.fromkeys(_PROVIDER_REF.findall(body)) if n in streams]
141        provider_files = sorted({streams[n][2] for n in watched})
142
143        # The overrides name the model type (`Stream<List<Entry>>`), so the file
144        # declaring it has to be imported too. Assuming it lived beside the
145        # provider was another TemplateGenerator-ism: a model that keeps data
146        # classes in lib/models/ left every element type unresolved, and the
147        # test failed with `non_type_as_type_argument` against correct code.
148        needed = set(provider_files)
149        for name in watched:
150            declaring = _declaring_file(files, streams[name][1])
151            if declaring is not None:
152                needed.add(declaring)
153        needed.discard(path)  # the screen itself is imported separately
154
155        imports = [
156            f"import 'package:flutter/{framework}.dart';",
157            "import 'package:flutter_riverpod/flutter_riverpod.dart';",
158            "import 'package:flutter_test/flutter_test.dart';",
159            "",
160            f"import 'package:{pkg}/{path[len('lib/'):]}';",
161        ]
162        imports += [f"import 'package:{pkg}/{p[len('lib/'):]}';" for p in sorted(needed)]
163
164        if watched:
165            overrides = "\n".join(
166                # [0] is the kind (Stream/Future), [1] the element type.
167                f"        {name}.overrideWith(\n"
168                f"          (ref) => {streams[name][0]}<List<{streams[name][1]}>>"
169                f".value(<{streams[name][1]}>[]),\n"
170                f"        ),"
171                for name in watched
172            )
173        else:
174            overrides = "        // no data providers on this screen"
175
176        # Asserting only `takeException() == null` is too weak: the generated
177        # screens handle provider failures with `.when(error: ...)`, which
178        # renders an error widget and swallows the exception, so a screen whose
179        # data layer is entirely broken still passes. Reading the provider's
180        # future asserts the data actually resolves.
181        resolves = "\n".join(
182            f"    await expectLater(container.read({name}.future), completes);"
183            for name in watched
184        )
185
186        tests[f"test/{snake(widget)}_smoke_test.dart"] = TEST_HEADER + "\n".join(imports) + f"""
187
188void main() {{
189  testWidgets('{widget} builds without throwing', (WidgetTester tester) async {{
190    final container = ProviderContainer(
191      overrides: [
192{overrides}
193      ],
194    );
195    addTearDown(container.dispose);
196
197    await tester.pumpWidget(
198      UncontrolledProviderScope(
199        container: container,
200        child: const {app_widget}(home: {host_open}{widget}(){host_close}),
201      ),
202    );
203    await tester.pump();
204
205    final Object? error = tester.takeException();
206    if (error != null) {{
207      // A provider reaching Firestore during build is correct behaviour — the
208      // real app calls Firebase.initializeApp() in main(), a widget test does
209      // not. Stubbing Firestore would need a fake backend, so this one class of
210      // exception is tolerated and everything else still fails the build.
211      expect(
212        error.toString(),
213        contains('core/no-app'),
214        reason: 'unexpected exception while building {widget}',
215      );
216    }}
217    expect(find.byType({widget}), findsOneWidget);
218{resolves}
219  }});
220}}
221"""
222    return tests

src/ports/templates.py

1"""Deterministic, offline implementation of `CodeGenerator`.
2
3Emits the pre-approved Flutter templates described in CLAUDE.md §3 ("strict over
4clever"). No credentials, no network, no model calls — so the whole loop is
5runnable and testable today. `AnthropicGenerator` produces the same file shapes
6with a real model behind it.
7
8Templates use `string.Template` with UPPERCASE keys so Dart's own `$name` /
9`${expr}` interpolation passes through `safe_substitute` untouched.
10"""
11
12from __future__ import annotations
13
14import re
15from string import Template
16
17import yaml
18
19from src.ports.analyzer import Diagnostic
20from src.ports.generator import Plan
21from src.prd.schema import PRD, DataModel, Screen
22
23# --------------------------------------------------------------------------- #
24# Naming helpers
25# --------------------------------------------------------------------------- #
26
27
28def snake(text: str) -> str:
29    text = re.sub(r"[^0-9a-zA-Z]+", "_", text)
30    text = re.sub(r"([a-z0-9])([A-Z])", r"\1_\2", text)
31    return re.sub(r"_+", "_", text).strip("_").lower() or "app"
32
33
34def pascal(text: str) -> str:
35    return "".join(part[:1].upper() + part[1:] for part in snake(text).split("_"))
36
37
38def camel(text: str) -> str:
39    out = pascal(text)
40    return out[:1].lower() + out[1:]
41
42
43def yaml_scalar(value: str) -> str:
44    """Always-quote a YAML scalar.
45
46    PRD text is arbitrary: a description like "capture app: log offline" has an
47    unquoted colon that makes pubspec.yaml unparseable, and `flutter analyze`
48    dies before it reaches any Dart. Single-quoted style escapes only `'`.
49    """
50    collapsed = " ".join(value.split())
51    return "'" + collapsed.replace("'", "''") + "'"
52
53
54def repair_pubspec_description(pubspec: str) -> str:
55    """Quote an unquoted `description:` if that is what makes the manifest invalid.
56
57    Our own templates learned this in Phase 1 (`yaml_scalar`), but a model
58    writing the manifest rediscovers it: "Auth-first app: sign in, browse" has a
59    colon, so the YAML is unparseable and `flutter analyze` aborts with a scanner
60    stack trace. The manifest is planning output and therefore frozen, so nothing
61    downstream can repair it — but this is punctuation, not design, and it is the
62    single most common way a generated pubspec breaks.
63
64    Deliberately narrow: if quoting the description does not make it parse, the
65    original is returned unchanged and conformance reports `unparseable_pubspec`.
66    """
67    try:
68        yaml.safe_load(pubspec)
69        return pubspec
70    except yaml.YAMLError:
71        pass
72
73    lines = pubspec.splitlines()
74    for i, line in enumerate(lines):
75        if line.startswith("description:"):
76            value = line[len("description:"):].strip()
77            if value and value[0] not in "'\"":
78                lines[i] = "description: " + yaml_scalar(value)
79    repaired = "\n".join(lines) + "\n"
80
81    try:
82        yaml.safe_load(repaired)
83    except yaml.YAMLError:
84        return pubspec  # broken some other way; let conformance report it
85    return repaired
86
87
88# The pubspec top-level keys pub.dev recognises, plus a handful of common
89# plugin-added ones. Not exhaustive by intent: this only decides which flush-left
90# lines are *left alone*, and leaving an unrecognised-but-legitimate key alone
91# is the safe direction — the repair below only ever activates on a file that is
92# already failing to parse, and only keeps a change that makes it parse.
93_KNOWN_TOP_LEVEL_KEYS = {
94    "name", "description", "publish_to", "version", "homepage", "repository",
95    "issue_tracker", "documentation", "environment", "dependencies",
96    "dev_dependencies", "dependency_overrides", "flutter", "flutter_intl",
97    "msix_config", "flutter_native_splash", "flutter_launcher_icons",
98}
99
100
101def repair_stray_prose_line(pubspec: str) -> str:
102    """Comment out a flush-left sentence the model forgot to prefix with `#`.
103
104    A model sometimes explains itself directly in the manifest — e.g. writes
105    "Firestore collection: `observations`" as a bare line rather than a
106    comment. At column 1 with a colon in it, YAML reads that as a new top-level
107    mapping key appearing mid-document, and aborts with "expected <document
108    start>, but found <block mapping start>" — a message that names the
109    symptom, not the cause. It cost a real buyer a paid, failed build: this
110    manifest is frozen once planning ends, so nothing downstream could have
111    repaired it, and no repair pass was even attempted — that class of
112    diagnostic fails fast by design. Prefixing the line with `#` is the same
113    fix a human would make, and it cannot touch a file that already parses.
114    """
115    try:
116        yaml.safe_load(pubspec)
117        return pubspec
118    except yaml.YAMLError:
119        pass
120
121    lines = pubspec.splitlines()
122    changed = False
123    for i, line in enumerate(lines):
124        if not line or line[0] in " \t#-":
125            continue  # indented, blank, a comment, or a list item: not this shape
126        key = line.split(":", 1)[0].strip()
127        if ":" in line and key not in _KNOWN_TOP_LEVEL_KEYS:
128            lines[i] = "# " + line
129            changed = True
130    if not changed:
131        return pubspec
132
133    repaired = "\n".join(lines) + "\n"
134    try:
135        yaml.safe_load(repaired)
136    except yaml.YAMLError:
137        return pubspec
138    return repaired
139
140
141def ensure_lint_dependency(pubspec: str, version: str = "^4.0.0") -> str:
142    """Guarantee pubspec declares the lint package our analysis_options needs.
143
144    We inject analysis_options.yaml ourselves, so depending on a generator to
145    remember the matching dev_dependency makes our own lint guarantees hostage
146    to someone else's memory. The first live model run forgot it, the include
147    silently failed, and every lint-based check stopped applying.
148    """
149    if "flutter_lints" in pubspec:
150        return pubspec
151
152    block = f"  flutter_lints: {version}"
153    lines = pubspec.splitlines()
154    for i, line in enumerate(lines):
155        if line.strip() == "dev_dependencies:":
156            lines.insert(i + 1, block)
157            break
158    else:
159        # No dev_dependencies section at all: append one as a new top-level key.
160        lines += ["", "dev_dependencies:", block]
161
162    return "\n".join(lines) + "\n"
163
164
165def dart_string(value: str) -> str:
166    """Escape a PRD string for a single-quoted Dart literal.
167
168    Sibling of `yaml_scalar`, and the same class of bug one layer down: a screen
169    titled "Ana's Café" emits `Text('Ana's Café')`, where the apostrophe closes
170    the literal and everything after it is parsed as code. A `$` is worse — it
171    silently becomes Dart string interpolation rather than a syntax error.
172    Backslash must be escaped first or it double-escapes the others.
173    """
174    return (
175        value.replace("\\", "\\\\")
176        .replace("'", "\\'")
177        .replace("$", "\\$")
178        .replace("\r", "")
179        .replace("\n", "\\n")
180    )
181
182
183def dart_type(field_type: str) -> str:
184    return {"text": "String", "number": "num", "bool": "bool", "date": "DateTime"}[field_type]
185
186
187def dart_default(field_type: str) -> str:
188    return {"text": "''", "number": "0", "bool": "false", "date": "DateTime.now()"}[field_type]
189
190
191def wire_read(name: str, field_type: str) -> str:
192    """How a field comes back *out* of Firestore, which is not always its Dart type.
193
194    Firestore has no date type of its own: a `DateTime` is stored as a
195    `Timestamp` and handed back as a `Timestamp`, so `data['x'] as DateTime?`
196    throws `type 'Timestamp' is not a subtype of type 'DateTime?'` the first
197    time a document written by this app is read back by it.
198
199    Nothing static catches that. It type-checks, `flutter analyze` is clean, and
200    the generated widget tests pass because they never put a real document
201    through this function — the failure needs a live Firestore, which is why it
202    survived until the emulator round-trip test went in.
203    """
204    if field_type == "date":
205        return f"(data['{name}'] as Timestamp?)?.toDate() ?? {dart_default(field_type)}"
206    return f"(data['{name}'] as {dart_type(field_type)}?) ?? {dart_default(field_type)}"
207
208
209def wire_write(name: str, field_type: str) -> str:
210    """How a field goes *in*. Explicit for dates, to mirror `wire_read`.
211
212    The SDK would convert a bare `DateTime` on write, so this is not fixing a
213    bug — it is refusing to rely on an implicit conversion in one direction
214    while doing the inverse by hand in the other.
215    """
216    if field_type == "date":
217        return f"Timestamp.fromDate({name})"
218    return name
219
220
221def _fab_navigation(screen: Screen) -> str:
222    """The `Navigator` call for a screen's first `navigate` action, if it has one.
223
224    Without this the generated app declared a route for every screen and never
225    pushed one: `/capture` and `/settings` existed in the routes table and no
226    widget could reach them. Every check passed — each screen built in isolation,
227    the routes were valid Dart, and the analyzer has no opinion about whether a
228    route is ever used — so an app whose only way in to the form was unreachable
229    looked completely healthy.
230    """
231    for action in screen.actions:
232        if action.kind == "navigate" and action.target:
233            return (
234                f"\n          Navigator.pushNamed"
235                f"(context, '/{action.target}');"
236            )
237    return ""
238
239
240def _plain_body(screen: Screen, cupertino: bool) -> str:
241    """The body of a screen with no list or form: a title, plus any nav buttons.
242
243    Built here rather than in the template because the const-ness depends on the
244    content. With no navigate actions the whole subtree is constant and
245    `prefer_const_constructors` rightly complains if it is not marked so; with
246    buttons it cannot be. Emitting the non-const shape unconditionally traded a
247    real bug for four lint infos on every settings screen.
248    """
249    title = f"Text('{dart_string(screen.title)}')"
250    buttons = _navigation_buttons(screen, cupertino)
251    pad = " " * (6 if cupertino else 6)
252
253    if not buttons:
254        centre = (
255            f"Center(\n"
256            f"{pad}  child: Padding(\n"
257            f"{pad}    padding: EdgeInsets.all(24),\n"
258            f"{pad}    child: {title},\n"
259            f"{pad}  ),\n"
260            f"{pad})"
261        )
262        if cupertino:
263            return f"const SafeArea(\n{pad}child: {centre},\n{pad[:-2]})"
264        return f"const {centre}"
265
266    centre = (
267        f"Center(\n"
268        f"{pad}  child: Padding(\n"
269        f"{pad}    padding: const EdgeInsets.all(24),\n"
270        f"{pad}    child: Column(\n"
271        f"{pad}      mainAxisSize: MainAxisSize.min,\n"
272        f"{pad}      children: <Widget>[\n"
273        f"{pad}        const {title},\n"
274        f"{buttons}\n"
275        f"{pad}      ],\n"
276        f"{pad}    ),\n"
277        f"{pad}  ),\n"
278        f"{pad})"
279    )
280    if cupertino:
281        return f"SafeArea(\n{pad}child: {centre},\n{pad[:-2]})"
282    return centre
283
284
285def _navigation_buttons(screen: Screen, cupertino: bool = False) -> str:
286    """One button per `navigate` action, for screens with no other affordance.
287
288    A list screen has a floating action button to hang navigation off. An auth,
289    settings or detail screen has nothing, so its navigate actions were dropped
290    on the floor — `auth_flow` declared `goToFeed` and `many_screens` declared
291    `backToInbox`, and in both the destination existed in the routes table with
292    no way to reach it.
293
294    The label is the action's own name from the PRD, which the schema has
295    already validated as a Dart identifier, so it needs no escaping.
296    """
297    # `TextButton` is Material-only; a CupertinoApp tree has to use
298    # `CupertinoButton` or the widget is simply not in scope.
299    widget = "CupertinoButton" if cupertino else "TextButton"
300    pad = " " * (16 if cupertino else 14)
301    buttons = [
302        f"{pad}{widget}(\n"
303        f"{pad}  onPressed: () => Navigator.pushNamed(context, '/{a.target}'),\n"
304        f"{pad}  child: const Text('{a.name}'),\n"
305        f"{pad}),"
306        for a in screen.actions
307        if a.kind == "navigate" and a.target
308    ]
309    return "\n".join(buttons)
310
311
312def screen_class(screen: Screen) -> str:
313    return f"{pascal(screen.id)}Screen"
314
315
316def screen_file(screen: Screen) -> str:
317    return f"lib/ui/{snake(screen.id)}_screen.dart"
318
319
320def provider_file(model: DataModel) -> str:
321    return f"lib/providers/{snake(model.name)}_providers.dart"
322
323
324def list_provider(model: DataModel) -> str:
325    return f"{camel(model.name)}ListProvider"
326
327
328def controller_provider(model: DataModel) -> str:
329    return f"{camel(model.name)}ControllerProvider"
330
331
332# --------------------------------------------------------------------------- #
333# Templates
334# --------------------------------------------------------------------------- #
335
336PUBSPEC = Template("""name: $PKG
337description: $DESCRIPTION
338publish_to: 'none'
339version: 0.1.0+1
340
341environment:
342  sdk: '>=3.5.0 <4.0.0'
343
344dependencies:
345  flutter:
346    sdk: flutter
347  flutter_riverpod: ^2.5.1
348  firebase_core: ^3.6.0
349  cloud_firestore: ^5.4.0
350$EXTRA_DEPS
351dev_dependencies:
352  flutter_test:
353    sdk: flutter
354  integration_test:
355    sdk: flutter
356  flutter_lints: ^4.0.0
357
358flutter:
359  uses-material-design: true
360""")
361
362# Without this file `flutter_lints` sits in dev_dependencies and does nothing —
363# the analyzer runs with default rules only, so a green analysis says far less
364# than it appears to. CI is stricter than the default rule set.
365ANALYSIS_OPTIONS = """include: package:flutter_lints/flutter.yaml
366
367analyzer:
368  errors:
369    # The generated tree is machine-written; treat sloppiness as fatal so the
370    # QA subagent sees it rather than a human reviewer.
371    unused_import: error
372    unused_local_variable: error
373    unused_element: error
374    unused_field: error
375    dead_code: error
376"""
377
378DESIGN = Template("""# DESIGN.md — $APP_NAME
379
380> Frozen once the GenUI phase begins. Changes flow downstream only.
381
382$DESCRIPTION
383
384## Package
385
386- Flutter package: `$PKG`
387- Application id: `$PACKAGE_NAME`
388- Theme: $THEME (Material 3, standard widgets only)
389- Auth required: $AUTH
390
391## Data models
392
393$MODELS
394
395## Screens
396
397$SCREENS
398
399## Ownership boundaries
400
401| Path | Owner |
402| --- | --- |
403| `lib/ui/**` | GenUI subagent — widget tree only, no business logic |
404| `lib/providers/**` | Logic subagent — Riverpod state + Firebase |
405| `lib/main.dart` | Logic subagent — composition root |
406| `pubspec.yaml` | Planning subagent |
407
408State is Riverpod throughout. `setState` is permitted only for a strictly
409localized animation toggle, marked `// localized animation toggle`.
410""")
411
412APP_DART = Template("""import 'package:flutter/material.dart';
413
414$IMPORTS
415
416class $APP_CLASS extends StatelessWidget {
417  const $APP_CLASS({super.key});
418
419  @override
420  Widget build(BuildContext context) {
421    return MaterialApp(
422      title: '$TITLE',
423      debugShowCheckedModeBanner: false,
424      theme: ThemeData(
425        useMaterial3: true,
426        colorSchemeSeed: Colors.indigo,
427      ),
428      initialRoute: '$INITIAL_ROUTE',
429      routes: {
430$ROUTES
431      },
432    );
433  }
434}
435""")
436
437# --- Cupertino variants ---------------------------------------------------- #
438# A CupertinoApp does not provide MaterialLocalizations, so Material widgets
439# (Scaffold, AppBar, ListTile) throw at runtime inside one. The Cupertino family
440# is therefore a full parallel set, not a swap of the root widget alone.
441
442CUPERTINO_APP = Template("""import 'package:flutter/cupertino.dart';
443
444$IMPORTS
445
446class $APP_CLASS extends StatelessWidget {
447  const $APP_CLASS({super.key});
448
449  @override
450  Widget build(BuildContext context) {
451    return CupertinoApp(
452      title: '$TITLE',
453      debugShowCheckedModeBanner: false,
454      theme: const CupertinoThemeData(
455        primaryColor: CupertinoColors.activeBlue,
456      ),
457      initialRoute: '$INITIAL_ROUTE',
458      routes: {
459$ROUTES
460      },
461    );
462  }
463}
464""")
465
466CUPERTINO_LIST_SCREEN = Template("""import 'package:flutter/cupertino.dart';
467import 'package:flutter_riverpod/flutter_riverpod.dart';
468
469import '../providers/$PROVIDER_MODULE.dart';
470
471class $CLASS extends ConsumerWidget {
472  const $CLASS({super.key});
473
474  @override
475  Widget build(BuildContext context, WidgetRef ref) {
476    final rows = ref.watch($LIST_PROVIDER);
477    return CupertinoPageScaffold(
478      navigationBar: CupertinoNavigationBar(
479        middle: const Text('$TITLE'),
480        trailing: CupertinoButton(
481          padding: EdgeInsets.zero,
482          onPressed: () {
483            ref.read($CONTROLLER_PROVIDER.notifier).createDraft();$FAB_NAVIGATE
484          },
485          child: const Icon(CupertinoIcons.add),
486        ),
487      ),
488      child: SafeArea(
489        child: rows.when(
490          data: (items) => ListView.builder(
491            itemCount: items.length,
492            itemBuilder: (context, index) {
493              final item = items[index];
494              return CupertinoListTile(
495                title: Text(item.$PRIMARY_FIELD.toString()),
496                subtitle: Text(item.id),
497              );
498            },
499          ),
500          loading: () => const Center(child: CupertinoActivityIndicator()),
501          error: (error, stackTrace) => Center(child: Text('Failed to load: $error')),
502        ),
503      ),
504    );
505  }
506}
507""")
508
509CUPERTINO_FORM_SCREEN = Template("""import 'package:flutter/cupertino.dart';
510import 'package:flutter_riverpod/flutter_riverpod.dart';
511
512import '../providers/$PROVIDER_MODULE.dart';
513
514class $CLASS extends ConsumerWidget {
515  const $CLASS({super.key});
516
517  @override
518  Widget build(BuildContext context, WidgetRef ref) {
519    final controller = ref.read($CONTROLLER_PROVIDER.notifier);
520    return CupertinoPageScaffold(
521      navigationBar: CupertinoNavigationBar(middle: const Text('$TITLE')),
522      child: SafeArea(
523        child: ListView(
524          padding: const EdgeInsets.all(16),
525          children: [
526$FIELDS
527            const SizedBox(height: 24),
528            CupertinoButton.filled(
529              onPressed: controller.submit,
530              child: const Text('Save'),
531            ),
532          ],
533        ),
534      ),
535    );
536  }
537}
538""")
539
540CUPERTINO_PLAIN_SCREEN = Template("""import 'package:flutter/cupertino.dart';
541import 'package:flutter_riverpod/flutter_riverpod.dart';
542
543class $CLASS extends ConsumerWidget {
544  const $CLASS({super.key});
545
546  @override
547  Widget build(BuildContext context, WidgetRef ref) {
548    return CupertinoPageScaffold(
549      navigationBar: CupertinoNavigationBar(middle: const Text('$TITLE')),
550      child: $BODY,
551    );
552  }
553}
554""")
555
556MAIN_DART = Template("""import 'package:cloud_firestore/cloud_firestore.dart';
557import 'package:firebase_core/firebase_core.dart';
558import 'package:flutter/$FRAMEWORK.dart';
559import 'package:flutter_riverpod/flutter_riverpod.dart';
560
561import 'ui/app.dart';
562
563// Supplied at build time with --dart-define, so no buyer's project identifiers
564// are baked into generated source:
565//
566//   flutter run --dart-define=FIREBASE_PROJECT_ID=... --dart-define=FIREBASE_API_KEY=...
567//
568// Leave them unset on a platform that carries a native config file
569// (google-services.json, GoogleService-Info.plist) and Firebase reads that.
570const _apiKey = String.fromEnvironment('FIREBASE_API_KEY');
571const _appId = String.fromEnvironment('FIREBASE_APP_ID');
572const _projectId = String.fromEnvironment('FIREBASE_PROJECT_ID');
573const _senderId = String.fromEnvironment('FIREBASE_MESSAGING_SENDER_ID');
574
575// host:port of a Firestore emulator. Empty in every real build, which leaves the
576// call below unreached; set it to run the app against a local emulator instead
577// of a project. This is what makes the generated integration tests runnable.
578const _emulator = String.fromEnvironment('FIRESTORE_EMULATOR');
579
580Future<void> main() async {
581  WidgetsFlutterBinding.ensureInitialized();
582  // A bare `Firebase.initializeApp()` throws on any platform without a native
583  // config file — on web it fails an assertion inside firebase_core_web rather
584  // than returning an error — so the app could not start at all.
585  await Firebase.initializeApp(
586    options: _projectId.isEmpty
587        ? null
588        : const FirebaseOptions(
589            apiKey: _apiKey,
590            appId: _appId,
591            projectId: _projectId,
592            messagingSenderId: _senderId,
593          ),
594  );
595  if (_emulator.isNotEmpty) {
596    final separator = _emulator.lastIndexOf(':');
597    FirebaseFirestore.instance.useFirestoreEmulator(
598      _emulator.substring(0, separator),
599      int.parse(_emulator.substring(separator + 1)),
600    );
601  }
602  runApp(const ProviderScope(child: $APP_CLASS()));
603}
604""")
605
606LIST_SCREEN = Template("""import 'package:flutter/material.dart';
607import 'package:flutter_riverpod/flutter_riverpod.dart';
608
609import '../providers/$PROVIDER_MODULE.dart';
610
611class $CLASS extends ConsumerWidget {
612  const $CLASS({super.key});
613
614  @override
615  Widget build(BuildContext context, WidgetRef ref) {
616    final rows = ref.watch($LIST_PROVIDER);
617    return Scaffold(
618      appBar: AppBar(title: const Text('$TITLE')),
619      body: rows.when(
620        data: (items) => ListView.separated(
621          itemCount: items.length,
622          separatorBuilder: (context, index) => const Divider(height: 1),
623          itemBuilder: (context, index) {
624            final item = items[index];
625            return ListTile(
626              title: Text(item.$PRIMARY_FIELD.toString()),
627              subtitle: Text(item.id),
628              onTap: () {},
629            );
630          },
631        ),
632        loading: () => const Center(child: CircularProgressIndicator()),
633        error: (error, stackTrace) => Center(child: Text('Failed to load: $error')),
634      ),
635      floatingActionButton: FloatingActionButton(
636        onPressed: () {
637          ref.read($CONTROLLER_PROVIDER.notifier).createDraft();$FAB_NAVIGATE
638        },
639        child: const Icon(Icons.add),
640      ),
641    );
642  }
643}
644""")
645
646FORM_SCREEN = Template("""import 'package:flutter/material.dart';
647import 'package:flutter_riverpod/flutter_riverpod.dart';
648
649import '../providers/$PROVIDER_MODULE.dart';
650
651class $CLASS extends ConsumerWidget {
652  const $CLASS({super.key});
653
654  @override
655  Widget build(BuildContext context, WidgetRef ref) {
656    final controller = ref.read($CONTROLLER_PROVIDER.notifier);
657    return Scaffold(
658      appBar: AppBar(title: const Text('$TITLE')),
659      body: ListView(
660        padding: const EdgeInsets.all(16),
661        children: [
662$FIELDS
663          const SizedBox(height: 24),
664          FilledButton(
665            onPressed: controller.submit,
666            child: const Text('Save'),
667          ),
668        ],
669      ),
670    );
671  }
672}
673""")
674
675PLAIN_SCREEN = Template("""import 'package:flutter/material.dart';
676import 'package:flutter_riverpod/flutter_riverpod.dart';
677
678class $CLASS extends ConsumerWidget {
679  const $CLASS({super.key});
680
681  @override
682  Widget build(BuildContext context, WidgetRef ref) {
683    return Scaffold(
684      appBar: AppBar(title: const Text('$TITLE')),
685      body: $BODY,
686    );
687  }
688}
689""")
690
691PROVIDERS = Template("""import 'package:cloud_firestore/cloud_firestore.dart';
692import 'package:flutter_riverpod/flutter_riverpod.dart';
693
694class $CLASS {
695  const $CLASS({
696    required this.id,
697$CTOR_PARAMS
698  });
699
700  final String id;
701$FIELD_DECLS
702
703  factory $CLASS.fromSnapshot(DocumentSnapshot<Map<String, dynamic>> doc) {
704    final data = doc.data() ?? <String, dynamic>{};
705    return $CLASS(
706      id: doc.id,
707$FROM_MAP
708    );
709  }
710
711  Map<String, dynamic> toMap() {
712    return <String, dynamic>{
713$TO_MAP
714    };
715  }
716}
717
718final ${VAR}CollectionProvider =
719    Provider<CollectionReference<Map<String, dynamic>>>((ref) {
720  return FirebaseFirestore.instance.collection('$COLLECTION');
721});
722
723final $LIST_PROVIDER = StreamProvider<List<$CLASS>>((ref) {
724  final collection = ref.watch(${VAR}CollectionProvider);
725  return collection.snapshots().map(
726        (snapshot) => snapshot.docs.map($CLASS.fromSnapshot).toList(),
727      );
728});
729
730final $CONTROLLER_PROVIDER =
731    StateNotifierProvider<$CONTROLLER_CLASS, AsyncValue<void>>((ref) {
732  return $CONTROLLER_CLASS(ref);
733});
734
735class $CONTROLLER_CLASS extends StateNotifier<AsyncValue<void>> {
736  $CONTROLLER_CLASS(this._ref) : super(const AsyncValue.data(null));
737
738  final Ref _ref;
739  final Map<String, dynamic> _draft = <String, dynamic>{};
740
741  void createDraft() {
742    _draft.clear();
743  }
744
745  void update(String field, dynamic value) {
746    _draft[field] = value;
747  }
748
749  Future<void> submit() async {
750    state = const AsyncValue.loading();
751    try {
752      await _ref.read(${VAR}CollectionProvider).add(Map<String, dynamic>.from(_draft));
753      _draft.clear();
754      state = const AsyncValue.data(null);
755    } catch (error, stackTrace) {
756      state = AsyncValue.error(error, stackTrace);
757    }
758  }
759
760  Future<void> delete(String id) async {
761    await _ref.read(${VAR}CollectionProvider).doc(id).delete();
762  }
763}
764""")
765
766
767# --------------------------------------------------------------------------- #
768# Generator
769# --------------------------------------------------------------------------- #
770
771
772class TemplateGenerator:
773    """Offline `CodeGenerator`.
774
775    `fault` deliberately breaks the first GenUI pass so the QA -> Logic repair
776    loop can be exercised without a live model. Used by the tests.
777    """
778
779    def __init__(self, fault: str | None = None) -> None:
780        self.fault = fault
781
782    # -- planning subagent -------------------------------------------------- #
783
784    def plan(self, prd: PRD) -> Plan:
785        pkg = snake(prd.app_name)
786        models_md = "\n".join(
787            f"- **{m.name}** -> `{m.collection}` "
788            f"({', '.join(f'{f.name}: {dart_type(f.type)}' for f in m.fields) or 'no fields'})"
789            for m in prd.models
790        ) or "_none_"
791        screens_md = "\n".join(
792            f"- `{s.id}` ({s.kind}) — {s.title}"
793            + (f", backed by `{s.model}`" if s.model else "")
794            for s in prd.screens
795        )
796        design = DESIGN.safe_substitute(
797            APP_NAME=prd.app_name,
798            DESCRIPTION=prd.description or "_No description supplied._",
799            PKG=pkg,
800            PACKAGE_NAME=prd.package_name,
801            THEME=prd.theme,
802            AUTH="yes" if prd.auth else "no",
803            MODELS=models_md,
804            SCREENS=screens_md,
805        )
806        pubspec = PUBSPEC.safe_substitute(
807            PKG=pkg,
808            DESCRIPTION=yaml_scalar(prd.description or prd.app_name),
809            # CupertinoIcons resolves at compile time but renders nothing
810            # without the font package.
811            EXTRA_DEPS="  cupertino_icons: ^1.0.8\n" if prd.theme == "cupertino" else "",
812        )
813        return Plan(design_md=design, pubspec=pubspec, analysis_options=ANALYSIS_OPTIONS)
814
815    # -- genui subagent ----------------------------------------------------- #
816
817    def build_ui(
818        self, prd: PRD, design_md: str, diagnostics: list[Diagnostic] | None = None
819    ) -> dict[str, str]:
820        diagnostics = diagnostics or []
821        models = {m.name: m for m in prd.models}
822        files: dict[str, str] = {}
823
824        for screen in prd.screens:
825            model = models.get(screen.model) if screen.model else None
826            files[screen_file(screen)] = self._render_screen(screen, model, prd.theme)
827
828        app_class = f"{pascal(prd.app_name)}App"
829        imports = "\n".join(
830            f"import '{snake(s.id)}_screen.dart';" for s in prd.screens
831        )
832        routes = "\n".join(
833            f"        '/{snake(s.id)}': (context) => const {screen_class(s)}(),"
834            for s in prd.screens
835        )
836        app_template = CUPERTINO_APP if prd.theme == "cupertino" else APP_DART
837        files["lib/ui/app.dart"] = app_template.safe_substitute(
838            IMPORTS=imports,
839            APP_CLASS=app_class,
840            TITLE=dart_string(prd.app_name),
841            INITIAL_ROUTE=f"/{snake(prd.screens[0].id)}",
842            ROUTES=routes,
843        )
844
845        # Faults are injected on the first pass only. A repair pass regenerates
846        # cleanly, which is what a real GenUI repair converges on.
847        if not diagnostics:
848            target = screen_file(prd.screens[0])
849            if self.fault == "undefined_provider":
850                # GenUI/Logic desync: watch a provider nobody declares. Owned by
851                # the Logic subagent, per CLAUDE.md §4.
852                files[target] = files[target].replace(
853                    "    return Scaffold(",
854                    "    ref.watch(unsyncedDraftProvider);\n    return Scaffold(",
855                    1,
856                )
857            elif self.fault == "setstate":
858                # A UI-owned violation: only GenUI can write lib/ui/ to fix it.
859                files[target] = files[target].replace(
860                    "    return Scaffold(",
861                    "    setState(() {});\n    return Scaffold(",
862                    1,
863                )
864        return files
865
866    def _render_screen(
867        self, screen: Screen, model: DataModel | None, theme: str = "material"
868    ) -> str:
869        cupertino = theme == "cupertino"
870        cls = screen_class(screen)
871        if model is None:
872            plain = CUPERTINO_PLAIN_SCREEN if cupertino else PLAIN_SCREEN
873            return plain.safe_substitute(
874                CLASS=cls,
875                TITLE=dart_string(screen.title),
876                BODY=_plain_body(screen, cupertino),
877            )
878
879        module = snake(model.name) + "_providers"
880        if screen.kind == "form":
881            if cupertino:
882                fields = "\n".join(
883                    "            CupertinoTextField(\n"
884                    f"              placeholder: '{dart_string(f.label)}',\n"
885                    "              onChanged: (value) => "
886                    f"controller.update('{f.name}', value),\n"
887                    "            ),"
888                    for f in (screen.fields or model.fields)
889                )
890            else:
891                fields = "\n".join(
892                    "          TextFormField(\n"
893                    "            decoration: const InputDecoration("
894                    f"labelText: '{dart_string(f.label)}'),\n"
895                    f"            onChanged: (value) => controller.update('{f.name}', value),\n"
896                    "          ),"
897                    for f in (screen.fields or model.fields)
898                )
899            form = CUPERTINO_FORM_SCREEN if cupertino else FORM_SCREEN
900            return form.safe_substitute(
901                CLASS=cls,
902                TITLE=dart_string(screen.title),
903                PROVIDER_MODULE=module,
904                CONTROLLER_PROVIDER=controller_provider(model),
905                FIELDS=fields,
906            )
907
908        primary = model.fields[0].name if model.fields else "id"
909        listing = CUPERTINO_LIST_SCREEN if cupertino else LIST_SCREEN
910        return listing.safe_substitute(
911            CLASS=cls,
912            TITLE=dart_string(screen.title),
913            PROVIDER_MODULE=module,
914            LIST_PROVIDER=list_provider(model),
915            CONTROLLER_PROVIDER=controller_provider(model),
916            PRIMARY_FIELD=primary,
917            FAB_NAVIGATE=_fab_navigation(screen),
918        )
919
920    # -- logic subagent ----------------------------------------------------- #
921
922    def wire_logic(
923        self,
924        prd: PRD,
925        design_md: str,
926        ui_files: dict[str, str],
927        diagnostics: list[Diagnostic],
928    ) -> dict[str, str]:
929        files: dict[str, str] = {}
930        for model in prd.models:
931            files[provider_file(model)] = self._render_providers(model)
932
933        files["lib/main.dart"] = MAIN_DART.safe_substitute(
934            APP_CLASS=f"{pascal(prd.app_name)}App",
935            FRAMEWORK="cupertino" if prd.theme == "cupertino" else "material",
936        )
937
938        # No fabricated providers here, deliberately.
939        #
940        # An earlier version answered `undefined_provider` by declaring a
941        # throwaway `StateProvider<Map<String, dynamic>>` named after whatever
942        # the UI referenced. That silenced the diagnostic without making the app
943        # any more correct: a green build backed by a provider that reads
944        # nothing and means nothing. It made the repair loop look like it worked
945        # while measuring only its own output.
946        #
947        # The Logic subagent's honest answer is the providers the PRD implies,
948        # which is exactly what it generates above. If the UI references
949        # something with no basis in the PRD, Logic genuinely cannot fix it, the
950        # diagnostic survives, and the router escalates to GenUI to stop
951        # referencing it. See `make_router`.
952        return files
953
954    def _render_providers(self, model: DataModel) -> str:
955        cls = pascal(model.name)
956        var = camel(model.name)
957        ctor_params = "\n".join(
958            f"    required this.{f.name}," for f in model.fields
959        )
960        field_decls = "\n".join(
961            f"  final {dart_type(f.type)} {f.name};" for f in model.fields
962        )
963        from_map = "\n".join(
964            f"      {f.name}: {wire_read(f.name, f.type)}," for f in model.fields
965        )
966        to_map = "\n".join(
967            f"      '{f.name}': {wire_write(f.name, f.type)}," for f in model.fields
968        )
969        return PROVIDERS.safe_substitute(
970            CLASS=cls,
971            VAR=var,
972            COLLECTION=dart_string(model.collection),
973            LIST_PROVIDER=list_provider(model),
974            CONTROLLER_PROVIDER=controller_provider(model),
975            CONTROLLER_CLASS=f"{cls}Controller",
976            CTOR_PARAMS=ctor_params,
977            FIELD_DECLS=field_decls,
978            FROM_MAP=from_map,
979            TO_MAP=to_map,
980        )

src/ports/toolchain.py

1"""Finding an SDK's executables, on the platform actually being run on.
2
3The Flutter SDK ships **both** `flutter` and `flutter.bat` in `bin/`, on every
4platform — the batch file is not omitted from the Linux tarball. Four call sites
5independently resolved the tool by taking the first candidate that *existed*,
6with the Windows spelling first, which is correct on Windows and picks an
7unrunnable batch file everywhere else:
8
9    PermissionError: [Errno 13] Permission denied: '/opt/flutter/bin/flutter.bat'
10
11That is what the first Linux deployment did, after settling a payment on-chain.
12Every check the project had ran on Windows, where the bug is invisible, so it
13survived a full verification suite and an eval sweep and was found by a buyer
14paying for a build. The lesson is not "test on Linux" but that `exists()` is the
15wrong question for an executable; `windows=` is a parameter here rather than a
16module constant precisely so the other platform's branch is reachable from a
17test on either.
18"""
19
20from __future__ import annotations
21
22import os
23import sys
24from pathlib import Path
25
26
27def sdk_executable(
28    directory: str | Path, name: str, *, windows: bool | None = None
29) -> str | None:
30    """The runnable `name` inside `directory`, or None if there is not one.
31
32    On Windows the launcher is `name.bat` (or `.exe`) and the extensionless file
33    is a shell script that cannot run. On POSIX the reverse holds, and a `.bat`
34    is never a candidate — it exists in the SDK, it is simply not a program.
35    """
36    if windows is None:
37        windows = sys.platform == "win32"
38
39    directory = Path(directory)
40    candidates = (f"{name}.bat", f"{name}.exe", name) if windows else (name,)
41
42    for candidate in candidates:
43        path = directory / candidate
44        if not path.is_file():
45            continue
46        # The executable bit is the whole point on POSIX. Windows does not carry
47        # one, and os.access(X_OK) there answers about extensions rather than
48        # permissions, so asking would only introduce a different wrong answer.
49        if windows or os.access(path, os.X_OK):
50            return str(path)
51    return None

src/ports/usage.py

1"""What a build costs, in tokens and in money.
2
3`X402_PRICE_ATOMIC` was inherited from a test configuration and nobody could say
4whether $0.50 covered a build, because nothing recorded what a build consumed.
5This does: every model response carries a `usage` block, and the generator
6accumulates it across the planning, GenUI, Logic and repair calls that make up
7one app.
8
9**Tokens are the fact; money is an estimate.** Token counts come from the API
10and are exact. The dollar figure is derived from a rate table that lives in this
11repo, and published prices change — treat it as an order-of-magnitude guide for
12pricing decisions, not as an invoice. The per-model rates are checked against
13Anthropic's published pricing rather than recalled, and the table says when.
14
15**Cached tokens are not billed like fresh ones**, and conflating them overstates
16cost by roughly an order of magnitude on a cache-heavy workload: a cache *read*
17bills at about a tenth of the input rate, while a cache *write* costs about 1.25x
18input for the default five-minute TTL. The repair loop re-sends a large, stable
19prompt prefix, so those two lines dominate a multi-repair build and have to be
20counted separately.
21"""
22
23from __future__ import annotations
24
25from dataclasses import dataclass, field
26
27# Published rates in US dollars per million tokens, read from Anthropic's
28# pricing on 2026-07-31. `intro_until` records a promotional rate that expires:
29# Sonnet 5 lists $3.00/$15.00 with an introductory $2.00/$10.00 through
30# 2026-08-31, so a cost basis measured today understates what the same build
31# costs in September by half again.
32#
33# A model missing from this table still gets exact token counts — only the
34# dollar estimate is withheld, which is the honest failure rather than silently
35# pricing an unknown model at some neighbour's rate.
36PRICES: dict[str, dict[str, object]] = {
37    "claude-opus-5": {"input": 5.00, "output": 25.00},
38    "claude-opus-4-8": {"input": 5.00, "output": 25.00},
39    "claude-sonnet-5": {
40        "input": 3.00,
41        "output": 15.00,
42        "intro_input": 2.00,
43        "intro_output": 10.00,
44        "intro_until": "2026-08-31",
45    },
46    "claude-haiku-4-5": {"input": 1.00, "output": 5.00},
47}
48
49# Multipliers on the model's input rate. Cache reads are the reason this module
50# tracks four counters instead of two.
51CACHE_READ_MULTIPLIER = 0.1
52CACHE_WRITE_MULTIPLIER = 1.25  # five-minute TTL; a one-hour TTL is 2x
53
54
55@dataclass
56class Usage:
57    """Token counts for one build, accumulated across every model call."""
58
59    model: str = ""
60    calls: int = 0
61    input_tokens: int = 0
62    output_tokens: int = 0
63    cache_read_tokens: int = 0
64    cache_write_tokens: int = 0
65
66    def add(self, usage: object, model: str = "") -> None:
67        """Fold in one response's `usage` block.
68
69        Reads defensively: `usage` is an SDK object whose field set grows over
70        time, and a build must not fail because accounting met a field it did
71        not recognise. Missing counters are zero, which understates rather than
72        invents.
73        """
74        if model:
75            self.model = model
76        self.calls += 1
77        self.input_tokens += getattr(usage, "input_tokens", 0) or 0
78        self.output_tokens += getattr(usage, "output_tokens", 0) or 0
79        self.cache_read_tokens += getattr(usage, "cache_read_input_tokens", 0) or 0
80        self.cache_write_tokens += getattr(usage, "cache_creation_input_tokens", 0) or 0
81
82    @property
83    def total_tokens(self) -> int:
84        return (
85            self.input_tokens
86            + self.output_tokens
87            + self.cache_read_tokens
88            + self.cache_write_tokens
89        )
90
91    def cost_usd(self, on_date: str = "") -> float | None:
92        """Estimated dollars, or None when the model's rate is unknown.
93
94        `on_date` (ISO `YYYY-MM-DD`) selects introductory versus standard rates.
95        It is a parameter rather than "today" so that pricing a build for a date
96        after a promotion ends is a question this can answer, and so the test
97        for it does not depend on when the test runs.
98        """
99        rates = PRICES.get(self.model)
100        if rates is None:
101            return None
102
103        intro_until = rates.get("intro_until")
104        use_intro = bool(intro_until) and (not on_date or on_date <= str(intro_until))
105        input_rate = float(
106            rates["intro_input"] if use_intro and "intro_input" in rates
107            else rates["input"]
108        )
109        output_rate = float(
110            rates["intro_output"] if use_intro and "intro_output" in rates
111            else rates["output"]
112        )
113
114        per_million = (
115            self.input_tokens * input_rate
116            + self.output_tokens * output_rate
117            + self.cache_read_tokens * input_rate * CACHE_READ_MULTIPLIER
118            + self.cache_write_tokens * input_rate * CACHE_WRITE_MULTIPLIER
119        )
120        return per_million / 1_000_000
121
122    def public(self, on_date: str = "") -> dict[str, object]:
123        """What a buyer and an operator both get to see.
124
125        The token counts are reported whatever the model, so an unpriced model
126        still yields a usable record — `estimated_cost_usd` is null rather than
127        the whole block being absent.
128        """
129        return {
130            "model": self.model or None,
131            "calls": self.calls,
132            "input_tokens": self.input_tokens,
133            "output_tokens": self.output_tokens,
134            "cache_read_tokens": self.cache_read_tokens,
135            "cache_write_tokens": self.cache_write_tokens,
136            "total_tokens": self.total_tokens,
137            "estimated_cost_usd": self.cost_usd(on_date),
138        }

src/ports/init.py

src/prd/schema.py

1"""The PRD is the microservice's only input. It is a hard contract: if it does not
2validate here, nothing downstream runs. Every subagent reads the PRD; none may
3mutate it."""
4
5from __future__ import annotations
6
7import json
8import re
9from pathlib import Path
10from typing import Literal
11
12from pydantic import BaseModel, ConfigDict, field_validator, model_validator
13
14DART_IDENTIFIER = re.compile(r"^[a-z][a-zA-Z0-9]*$")
15PACKAGE_NAME = re.compile(r"^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$")
16
17FieldType = Literal["text", "number", "bool", "date"]
18
19
20class Strict(BaseModel):
21    model_config = ConfigDict(extra="forbid", frozen=True)
22
23
24class Field_(Strict):
25    """A single data field. Named `Field_` to avoid colliding with pydantic.Field."""
26
27    name: str
28    label: str
29    type: FieldType = "text"
30
31    @field_validator("name")
32    @classmethod
33    def _dart_safe(cls, v: str) -> str:
34        if not DART_IDENTIFIER.match(v):
35            raise ValueError(f"{v!r} is not a lowerCamelCase Dart identifier")
36        return v
37
38
39class Action(Strict):
40    name: str
41    kind: Literal["create", "update", "delete", "navigate", "signIn", "signOut"]
42    target: str | None = None
43
44    @field_validator("name")
45    @classmethod
46    def _dart_safe(cls, v: str) -> str:
47        if not DART_IDENTIFIER.match(v):
48            raise ValueError(f"{v!r} is not a lowerCamelCase Dart identifier")
49        return v
50
51
52class Screen(Strict):
53    id: str
54    title: str
55    kind: Literal["list", "form", "detail", "auth", "settings"]
56    model: str | None = None
57    fields: list[Field_] = []
58    actions: list[Action] = []
59
60    @field_validator("id")
61    @classmethod
62    def _dart_safe(cls, v: str) -> str:
63        if not DART_IDENTIFIER.match(v):
64            raise ValueError(f"{v!r} is not a lowerCamelCase Dart identifier")
65        return v
66
67
68class DataModel(Strict):
69    name: str
70    collection: str
71    fields: list[Field_]
72
73    @field_validator("name")
74    @classmethod
75    def _pascal(cls, v: str) -> str:
76        if not re.match(r"^[A-Z][a-zA-Z0-9]*$", v):
77            raise ValueError(f"model name {v!r} must be PascalCase")
78        return v
79
80
81class PRD(Strict):
82    app_name: str
83    package_name: str
84    description: str = ""
85    theme: Literal["material", "cupertino"] = "material"
86    auth: bool = False
87    models: list[DataModel] = []
88    screens: list[Screen]
89
90    # Set by the buyer-facing payment layer, not by the PRD author. The build
91    # pipeline refuses to package an APK unless this is True.
92    x402_payment_verified: bool = False
93
94    @field_validator("package_name")
95    @classmethod
96    def _reverse_dns(cls, v: str) -> str:
97        if not PACKAGE_NAME.match(v):
98            raise ValueError(f"{v!r} must be reverse-DNS, e.g. com.example.todo")
99        return v
100
101    @model_validator(mode="after")
102    def _referential_integrity(self) -> PRD:
103        if not self.screens:
104            raise ValueError("PRD must declare at least one screen")
105
106        ids = [s.id for s in self.screens]
107        if len(ids) != len(set(ids)):
108            raise ValueError("screen ids must be unique")
109
110        known_models = {m.name for m in self.models}
111        for screen in self.screens:
112            if screen.model is not None and screen.model not in known_models:
113                raise ValueError(
114                    f"screen {screen.id!r} references unknown model {screen.model!r}"
115                )
116
117        nav_targets = {a.target for s in self.screens for a in s.actions if a.kind == "navigate"}
118        unknown = nav_targets - set(ids) - {None}
119        if unknown:
120            raise ValueError(f"navigate actions target unknown screens: {sorted(unknown)}")
121
122        return self
123
124
125def load_prd(path: str | Path) -> PRD:
126    """Parse and validate a PRD file. Raises on any contract violation."""
127    raw = json.loads(Path(path).read_text(encoding="utf-8"))
128    return PRD.model_validate(raw)

src/prd/init.py

1from src.prd.schema import PRD, DataModel, Field_, Screen, load_prd
2
3__all__ = ["PRD", "DataModel", "Field_", "Screen", "load_prd"]

src/service/app.py

1"""HTTP surface for the app-generation microservice.
2
3    poetry run uvicorn src.service.app:app --port 8000
4
5CLAUDE.md describes an M2M microservice for machine buyers, but everything until
6now was a CLI. This is the part a buyer can actually call:
7
8    POST /builds            PRD in, 202 + job id out (402 without payment)
9    GET  /builds/{id}       status, log, diagnostics
10    GET  /builds/{id}/apk   the artifact
11    GET  /healthz
12
13The security decision worth stating plainly: `x402_payment_verified` is a field
14on the PRD, and the PRD is supplied by the buyer. That is harmless for a CLI
15where the operator writes both, and unacceptable here — a buyer could simply
16assert their own payment. The submitted value is therefore discarded and
17replaced with whatever the server's verifier concluded from the request. See
18`_verified_prd`.
19"""
20
21from __future__ import annotations
22
23import json
24import logging
25import os
26from datetime import datetime, timezone
27from pathlib import Path
28from typing import Any
29
30from fastapi import FastAPI, Header, HTTPException, Request, Response
31from fastapi.responses import (
32    FileResponse,
33    HTMLResponse,
34    JSONResponse,
35    PlainTextResponse,
36)
37
38from src.graph.builder import build_graph
39from src.graph.state import initial_state
40from src.payments.eip3009 import TokenConfig
41from src.payments.x402 import (
42    PAYMENT_HEADER,
43    DevPaymentVerifier,
44    PaymentVerifier,
45    X402Verifier,
46    challenge,
47    human_amount,
48)
49from src.ports.analyzer import get_analyzer
50from src.ports.generator import get_generator
51from src.ports.runtime import FlutterTestRunner
52from src.prd.schema import PRD
53from src.payments.facilitator import HttpFacilitator
54from src.payments.replay import InMemoryNonceStore, RedisNonceStore
55from src.service.jobs import (
56    BuildJob,
57    BuildStatus,
58    InMemoryJobStore,
59    JobStore,
60    RedisJobStore,
61    reap_stale,
62)
63from src.service.queue import (
64    DEFAULT_LEASE_SECONDS,
65    BuildQueue,
66    InMemoryBuildQueue,
67    RedisBuildQueue,
68)
69from src.service.mcp import Tool, handle_payload
70from src.service.ratelimit import RateLimiter, client_identity
71from src.service.artifacts import (
72    DEFAULT_RETENTION_SECONDS,
73    keep_only_the_artifact,
74    sweep_expired,
75)
76from src.service.worker import (
77    DEFAULT_HEARTBEAT_SECONDS,
78    DEFAULT_MAX_ATTEMPTS,
79    BuildWorker,
80)
81
82log = logging.getLogger(__name__)
83
84BUILD_ROOT = Path(os.getenv("BUILD_ROOT", "generated_apps/service"))
85
86# A finished build is ~2.0 GB of which the buyer wants ~150 MB. Pruning is on by
87# default because the alternative is a disk that fills after a few dozen sales
88# and fails a build somebody has already paid for; `BUILD_PRUNE=0` keeps the
89# whole tree for anyone debugging a deployment.
90_PRUNE_BUILDS = os.getenv("BUILD_PRUNE", "1") != "0"
91# Matched to RedisJobStore's TTL: once the record expires the download endpoint
92# answers 404, so an APK outliving it is unreachable weight.
93_RETENTION_SECONDS = int(os.getenv("BUILD_RETENTION_SECONDS", DEFAULT_RETENTION_SECONDS))
94
95
96def _settings() -> dict[str, Any]:
97    return {
98        "generator": os.getenv("SUPERVISOR_GENERATOR", "claude"),
99        "analyzer": os.getenv("SUPERVISOR_ANALYZER", "dart"),
100        "flutter_root": os.getenv("FLUTTER_ROOT"),
101        "max_repairs": int(os.getenv("SUPERVISOR_MAX_REPAIRS", "3")),
102        "run_tests": os.getenv("SUPERVISOR_RUN_TESTS", "1") != "0",
103        # Release emits an unsigned APK the buyer signs themselves; see
104        # src/build/signing.py for why the service holds no keys.
105        "build_mode": os.getenv("SUPERVISOR_BUILD_MODE", "debug"),
106        "sdk_root": os.getenv("ANDROID_SDK_ROOT") or os.getenv("ANDROID_HOME"),
107    }
108
109
110def _generator_unusable() -> str | None:
111    """Why this deployment cannot build anything, or None if it can.
112
113    The `claude` generator needs an API key. Without one every build fails on
114    the first request to Anthropic — *after* the payment has settled, because
115    settlement happens before the job is queued. A deployment in that state
116    reports itself healthy, accepts money and delivers nothing, which is the
117    worst failure this service has and the one it is least able to notice.
118
119    It happened: `ANTHROPIC_API_KEY=` with a single stray space in .env.deploy
120    read as "set" to everything that looked, and a paid build died on
121    "Could not resolve authentication method".
122    """
123    settings = _settings()
124    if settings["generator"] != "claude":
125        return None
126    if not (os.getenv("ANTHROPIC_API_KEY") or "").strip():
127        return (
128            "the claude generator is selected but ANTHROPIC_API_KEY is empty, so "
129            "every build would fail after taking payment"
130        )
131    return None
132
133
134class RefusingVerifier:
135    """Used when nothing is configured. Refuses everything.
136
137    A service that cannot verify payment must not accept it. Defaulting to the
138    dev shared-secret here would mean a deployment that forgot to configure
139    x402 quietly sells builds to anyone who guesses a string.
140    """
141
142    last_error = "no payment method configured on this deployment"
143
144    def settle(self, header_value: str | None) -> bool:
145        return False
146
147
148def _redis():
149    """A Redis client, or None. Never a silent fallback for the nonce store.
150
151    Falling back to in-memory replay protection when Redis is missing would
152    quietly reintroduce the cross-process hole this exists to close, so the
153    caller decides what a missing client means — and for nonces it means refuse.
154    """
155    url = os.getenv("REDIS_URL")
156    if not url:
157        return None
158    import redis  # imported lazily so the CLI never needs it
159
160    return redis.Redis.from_url(url, decode_responses=True)
161
162
163def _env(name: str, default: str = "") -> str:
164    """Read an environment variable, treating empty as unset.
165
166    Compose passes an optional variable as `${NAME:-}`, which puts an *empty
167    string* in the container rather than leaving it out. `os.getenv(name,
168    default)` falls back only on absence, so the empty string wins and the
169    default never applies — `int("")` raises at startup, and an empty EIP-712
170    domain name silently rejects every buyer signature. Both are worse than the
171    unset case they were meant to cover.
172    """
173    return os.getenv(name) or default
174
175
176SERVICE_VERSION = "0.1.0"
177
178# What a buyer receives, advertised in the challenge so an agent can tell whether
179# this service is worth paying before it pays. `outputSchema` is an optional v1
180# field and the discovery listings that carry one are the ones an agent can use
181# without a human first reading prose.
182BUILD_OUTPUT_SCHEMA: dict[str, object] = {
183    "type": "object",
184    "properties": {
185        "id": {"type": "string", "description": "poll GET /builds/{id}"},
186        "status": {"enum": ["queued", "running", "succeeded", "failed"]},
187        "apk_available": {
188            "type": "boolean",
189            "description": "when true, GET /builds/{id}/apk returns the APK",
190        },
191        "settlement_tx": {"type": "string", "description": "on-chain settlement hash"},
192        "log": {"type": "array", "items": {"type": "string"}},
193        "diagnostics": {"type": "array", "items": {"type": "string"}},
194    },
195    "required": ["id", "status"],
196}
197
198
199_LANDING_PAGE = """<!doctype html>
200<meta charset="utf-8">
201<meta name="viewport" content="width=device-width,initial-scale=1">
202<title>PRD to Flutter APK — {price} USDC</title>
203<style>
204  :root {{ color-scheme: light dark; }}
205  body {{ max-width: 44rem; margin: 3rem auto; padding: 0 1.25rem;
206         font: 16px/1.6 system-ui, sans-serif; }}
207  code, pre {{ font-family: ui-monospace, Menlo, Consolas, monospace; font-size: .9em; }}
208  pre {{ padding: .9rem 1rem; overflow-x: auto; border-radius: 6px;
209        background: rgba(127,127,127,.12); }}
210  h1 {{ font-size: 1.6rem; margin-bottom: .2rem; }}
211  .sub {{ opacity: .7; margin-top: 0; }}
212  table {{ border-collapse: collapse; width: 100%; }}
213  td {{ padding: .35rem .6rem .35rem 0; vertical-align: top; }}
214  td:first-child {{ opacity: .7; white-space: nowrap; }}
215</style>
216<h1>PRD to Flutter APK</h1>
217<p class="sub">Turn a JSON spec into a working Android app. Add it as a tool in
218Claude or Cursor — no subscription, <strong>{price} USDC</strong> per build.</p>
219
220<p><strong>Nothing to install.</strong> Add this as an HTTP MCP server:</p>
221<pre>{base}/mcp</pre>
222<p><strong>Try your own spec first, free.</strong> <code>preview_build</code>
223generates a real app from your document and hands back the source — same
224generator, same repair loop, same static analysis as a paid build. It just is
225not packaged into an APK. That is what the {price} buys.</p>
226<p><code>validate_prd</code>, <code>prd_schema</code> and
227<code>payment_terms</code> are free too. <code>start_build</code> buys the
228build: call it once to get quoted, sign, call again.</p>
229
230<p>No account, no API key, nothing recurring — pay only for the app you actually
231generate, settled on-chain via <a href="https://x402.gitbook.io/x402/">x402</a>
232before the build starts. A build that fails still tells you why — see
233<code>diagnostics</code> on the job.</p>
234
235<p>Prefer curl? Same service, plain HTTP:</p>
236<pre>curl -X POST {base}/builds \\
237     -H 'Content-Type: application/json' \\
238     -d @my-app.prd.json          # 402 with payment terms
239# sign, then repeat with:  -H 'X-Payment: &lt;authorization&gt;'</pre>
240
241<p>What happens: the document is planned into a design, a Flutter widget tree is
242generated, Riverpod state is wired into it, the result is statically analysed and
243repaired until clean, then packaged. Typically 5&ndash;8 minutes.</p>
244
245<table>
246  <tr><td>MCP server</td><td><code>{base}/mcp</code></td></tr>
247  <tr><td>Free preview</td><td><code>POST {base}/preview</code></td></tr>
248  <tr><td>Free check</td><td><code>POST {base}/validate</code></td></tr>
249  <tr><td>Payment terms</td><td><a href="{base}/.well-known/x402">/.well-known/x402</a></td></tr>
250  <tr><td>Document schema</td><td><a href="{base}/schema/prd.json">/schema/prd.json</a></td></tr>
251  <tr><td>API reference</td><td><a href="{base}/docs">/docs</a></td></tr>
252  <tr><td>Service status</td><td><a href="{base}/healthz">/healthz</a></td></tr>
253</table>
254"""
255
256
257def _canonical_resource_url() -> str:
258    """The service's own public URL for /builds, from configuration.
259
260    Needed because the facilitator is constructed at startup, with no request to
261    read a Host header from — and what it sends at settlement becomes this
262    service's entry in the public catalog. `PUBLIC_HOSTNAME` is the same value
263    the TLS proxy already gets its certificate for, so there is one hostname in
264    the deployment rather than two that can disagree.
265    """
266    host = _env("PUBLIC_HOSTNAME")
267    return f"https://{host}/builds" if host else "/builds"
268
269
270def _public_resource_url(request: Request) -> str:
271    """The URL a buyer used, not the one this process sees.
272
273    Behind the TLS proxy the service's own view of itself is `http://api:8000`
274    on the compose network, which is unreachable for everyone else — a challenge
275    naming it would be unactionable, and `resource` is a field buyers are
276    expected to be able to fetch.
277    """
278    forwarded_proto = request.headers.get("x-forwarded-proto", "").split(",")[0].strip()
279    forwarded_host = request.headers.get("x-forwarded-host", "").split(",")[0].strip()
280    scheme = forwarded_proto or request.url.scheme
281    host = forwarded_host or request.headers.get("host") or request.url.netloc
282    return f"{scheme}://{host}{request.url.path}"
283
284
285def _token_from_env() -> TokenConfig | None:
286    contract = _env("X402_TOKEN_CONTRACT")
287    chain_id = _env("X402_CHAIN_ID")
288    if not contract or not chain_id:
289        return None
290    return TokenConfig(
291        chain_id=int(chain_id),
292        verifying_contract=contract,
293        domain_name=_env("X402_DOMAIN_NAME", "USDC"),
294        domain_version=_env("X402_DOMAIN_VERSION", "2"),
295        network=_env("X402_NETWORK", "base-sepolia"),
296    )
297
298
299def _verifier_from_env() -> tuple[PaymentVerifier, str, TokenConfig | None]:
300    """Pick a verifier, and say plainly which one, for /healthz.
301
302    Order is deliberate: real x402 wins, the dev stand-in is only reachable when
303    explicitly configured and no real token is, and the fallback refuses.
304    """
305    token = _token_from_env()
306    pay_to = _env("X402_PAY_TO")
307    if token is not None and pay_to:
308        price = int(_env("X402_PRICE_ATOMIC", "500000"))
309        client = _redis()
310        facilitator_url = _env("X402_FACILITATOR_URL")
311        return (
312            X402Verifier(
313                token=token,
314                pay_to=pay_to,
315                min_value=price,
316                clock_skew=int(_env("X402_CLOCK_SKEW", "0")),
317                nonces=(
318                    RedisNonceStore(client) if client is not None
319                    else InMemoryNonceStore()
320                ),
321                facilitator=(
322                    HttpFacilitator(
323                        facilitator_url, token, pay_to, price,
324                        api_key=_env("X402_FACILITATOR_KEY") or None,
325                        timeout=float(_env("X402_SETTLE_TIMEOUT", "60")),
326                        resource=_canonical_resource_url(),
327                        output_schema=BUILD_OUTPUT_SCHEMA,
328                    ) if facilitator_url else None
329                ),
330            ),
331            "x402-eip3009",
332            token,
333        )
334    if os.getenv("X402_SHARED_SECRET"):
335        return DevPaymentVerifier(os.getenv("X402_SHARED_SECRET")), "dev-shared-secret", None
336    return RefusingVerifier(), "none", None
337
338
339def create_app(
340    verifier: PaymentVerifier | None = None,
341    store: JobStore | None = None,
342    queue: BuildQueue | None = None,
343    run_worker: bool | None = None,
344) -> FastAPI:
345    app = FastAPI(
346        title="App-Generation Microservice",
347        summary="POST a Product Requirements Document, receive a compiled Flutter APK.",
348        version=SERVICE_VERSION,
349    )
350    chosen, mode, token = _verifier_from_env()
351    app.state.verifier = verifier if verifier is not None else chosen
352    app.state.payment_mode = "injected" if verifier is not None else mode
353    app.state.token = token
354    app.state.pay_to = os.getenv("X402_PAY_TO")
355    app.state.price_atomic = int(os.getenv("X402_PRICE_ATOMIC", "500000"))
356
357    # Shares the Redis client below when there is one, so the limit holds across
358    # processes rather than per-worker.
359    app.state.rate_limiter = RateLimiter(
360        limit=int(os.getenv("BUILDS_RATE_LIMIT", "20")),
361        window_seconds=int(os.getenv("BUILDS_RATE_WINDOW_SECONDS", "60")),
362    )
363
364    # A free preview spends real model tokens — roughly a quarter of the sale
365    # price per run — so these two limits are the whole cost control, not a
366    # politeness measure. The global one is what bounds the bill: without it a
367    # single caller rotating addresses could run the API budget to nothing in an
368    # afternoon. Set PREVIEW_DAILY_LIMIT=0 to switch previews off entirely.
369    app.state.preview_limiter = RateLimiter(
370        limit=int(os.getenv("PREVIEW_PER_IP_DAILY", "1")),
371        window_seconds=86_400,
372        name="preview-ip",
373    )
374    app.state.preview_budget = RateLimiter(
375        limit=int(os.getenv("PREVIEW_DAILY_LIMIT", "5")),
376        window_seconds=86_400,
377        name="preview-global",
378    )
379
380    client = _redis() if (store is None or queue is None) else None
381    if store is not None:
382        app.state.store = store
383        app.state.store_backend = "injected"
384    else:
385        app.state.store = RedisJobStore(client) if client else InMemoryJobStore()
386        app.state.store_backend = "redis" if client else "in-memory"
387
388    if queue is not None:
389        app.state.queue = queue
390    else:
391        app.state.queue = RedisBuildQueue(client) if client else InMemoryBuildQueue()
392
393    if client is not None:
394        app.state.rate_limiter.redis = client
395        # Shared deliberately: a per-process preview budget is not a budget at
396        # all once there is more than one worker.
397        app.state.preview_limiter.redis = client
398        app.state.preview_budget.redis = client
399
400    # An API process builds as well as accepts by default, so a single-container
401    # deployment keeps working with no extra moving parts. Set
402    # BUILD_WORKER_EMBEDDED=0 on the API and run `python -m src.service.worker`
403    # separately once builds and requests want scaling apart.
404    embedded = (
405        os.getenv("BUILD_WORKER_EMBEDDED", "1") != "0"
406        if run_worker is None else run_worker
407    )
408    app.state.worker = (
409        BuildWorker(
410            app.state.store, app.state.queue, build_work, **_worker_settings()
411        ) if embedded else None
412    )
413    if app.state.worker is not None:
414        app.state.worker.start()
415
416    @app.get("/llms.txt", include_in_schema=False)
417    def llms_txt(request: Request) -> PlainTextResponse:
418        """The service explained to a language model, in the llms.txt convention.
419
420        A crawler reading `/` gets marketing prose and a crawler reading
421        `/openapi.json` gets 4 KB of schema; neither answers "what is this, what
422        does it cost, and how do I call it" in the order an agent needs. Several
423        listed x402 services publish one, and directories index it.
424        """
425        base = _public_resource_url(request).replace("/llms.txt", "")
426        price = human_amount(app.state.price_atomic, 6) if app.state.token else "?"
427        network = app.state.token.network if app.state.token else "unconfigured"
428        return PlainTextResponse(f"""\
429# PRD to Flutter APK
430
431> Turns a JSON product requirements document into an installable Android APK.
432> Plans a design, generates the Flutter widget tree, wires Riverpod state into
433> it, runs static analysis with an automatic repair loop, then packages the
434> build. Typically 5-8 minutes. Callable as an MCP tool from Claude or Cursor,
435> or directly over HTTP.
436
437Base URL: {base}
438Price: {price} USDC per build, on {network}, via x402 (EIP-3009). No
439subscription, no account, no API key — pay per build, settled on-chain before
440the build starts.
441
442## MCP — nothing to install
443
444Add {base}/mcp as an HTTP MCP server in Claude or Cursor. Tools:
445
446- preview_build — generate a real app from your own spec, free, and read the
447  source. Same generator and repair loop as a paid build; it is simply not
448  packaged into an APK.
449- build_files — the generated source for a preview or a build
450- validate_prd, prd_schema, payment_terms — free
451- start_build — quotes on the first call, builds on the second once signed
452- build_status — poll a build already paid for
453
454## Free
455
456- POST /preview — generate the app from your own spec and read the code, free.
457  Rate limited: each run spends real model tokens. Returns a job id; the source
458  is at GET /builds/{{id}}/files once it finishes.
459- POST /validate — is this document well-formed, and what would it build?
460  Same validator the paid path uses, so anything passing here is accepted there.
461- GET /.well-known/x402 — payment terms, machine-readable
462- GET /schema/prd.json — JSON Schema for the request body
463- GET /builds — answers 402 with the price; costs nothing to ask
464
465## Paid
466
467- POST /builds — body is a PRD (see /schema/prd.json), header X-Payment carries
468  a signed EIP-3009 authorization. Returns 202 with a job id.
469- GET /builds/{{id}} — status, log, diagnostics, settlement_tx, usage
470- GET /builds/{{id}}/apk — the artifact, once apk_available is true
471
472## Notes for agents
473
474A build that fails still returns its diagnostics; payment settles before the
475build, so a failure is visible in the job record rather than silent. Poll the
476job rather than holding the connection open. The 402 challenge carries the
477token contract in `asset` and the EIP-712 domain in `extra`, which is everything
478needed to sign without reading this page.
479""")
480
481    @app.get("/robots.txt", include_in_schema=False)
482    def robots() -> PlainTextResponse:
483        """Crawlable on purpose. Being found is the point, and the only thing
484        worth keeping bots out of is the per-job endpoints, which are unguessable
485        ids that cost money to create."""
486        return PlainTextResponse(
487            "User-agent: *\nAllow: /\nDisallow: /builds/\n"
488            f"Sitemap: {_canonical_resource_url().replace('/builds', '/.well-known/x402')}\n"
489        )
490
491    @app.get("/", include_in_schema=False)
492    def index(request: Request):
493        """One page for both audiences.
494
495        A browser gets something readable; anything else gets JSON pointing at
496        the manifest. Until now the root answered `{"detail":"Not Found"}` to
497        everyone, which is what a human, a crawler and an agent all saw first.
498        """
499        price = human_amount(app.state.price_atomic, 6) if app.state.token else "?"
500        network = app.state.token.network if app.state.token else "unconfigured"
501        base = _public_resource_url(request).rstrip("/")
502
503        if "text/html" not in request.headers.get("accept", ""):
504            return {
505                "name": "PRD to Flutter APK",
506                "price_usdc": price,
507                "network": network,
508                "manifest": f"{base}/.well-known/x402",
509                "schema": f"{base}/schema/prd.json",
510                "openapi": f"{base}/openapi.json",
511                "payment": "x402 (EIP-3009); POST /builds returns 402 with terms",
512                "mcp": f"{base}/mcp",
513                "free": [f"{base}/validate", f"{base}/llms.txt", f"{base}/schema/prd.json"],
514            }
515
516        return HTMLResponse(_LANDING_PAGE.format(price=price, network=network, base=base))
517
518    @app.get("/.well-known/x402")
519    def x402_manifest(request: Request) -> dict[str, Any]:
520        """What this service sells and what it costs, without buying anything.
521
522        An agent that has to POST a real PRD just to read the price learns the
523        terms from a 402 it provoked. The same `accepts` entry is served here,
524        in the shape the facilitator's discovery listings use, so a crawler or a
525        buyer can decide before it commits to anything.
526        """
527        resource = _public_resource_url(request).replace("/.well-known/x402", "/builds")
528        terms = challenge(
529            token=app.state.token,
530            pay_to=app.state.pay_to,
531            max_amount_required=app.state.price_atomic,
532            resource=resource,
533            output_schema=BUILD_OUTPUT_SCHEMA,
534        )
535        return {
536            "x402Version": terms["x402Version"],
537            "resource": resource,
538            "type": "http",
539            "method": "POST",
540            "accepts": terms["accepts"],
541            "name": "PRD to Flutter APK",
542            "description": (
543                "Compiles a JSON product requirements document into an Android "
544                "APK: Flutter widget tree, Riverpod state, static analysis and a "
545                "packaged build. Payment settles on-chain before the build starts."
546            ),
547            "inputSchema": {
548                "type": "http",
549                "method": "POST",
550                "bodySchema": {"$ref": f"{resource.rsplit('/', 1)[0]}/schema/prd.json"},
551            },
552            "outputSchema": {"type": "json", "schema": BUILD_OUTPUT_SCHEMA},
553            "documentation": f"{resource.rsplit('/', 1)[0]}/docs",
554        }
555
556    @app.get("/schema/prd.json")
557    def prd_schema() -> dict[str, Any]:
558        """The PRD contract, as a JSON Schema an agent can generate against.
559
560        Without this an agent has to infer the document shape from 422 errors,
561        one missing field at a time — which is how it looked from the outside
562        before this existed.
563        """
564        return PRD.model_json_schema()
565
566    @app.get("/healthz")
567    def healthz() -> dict[str, Any]:
568        settings = _settings()
569        return {
570            "ok": True,
571            "generator": settings["generator"],
572            "analyzer": settings["analyzer"],
573            # A buyer should be able to tell whether they are getting a debug
574            # artifact or an unsigned release one before they pay for it.
575            "build_mode": settings["build_mode"],
576            # Surfaced because a deployment with no secret refuses every
577            # payment, and that should be diagnosable without reading logs.
578            "payment_configured": app.state.payment_mode not in {"none"},
579            "payment_mode": app.state.payment_mode,
580            # Verification proves a signature; settlement proves the money
581            # moved. A deployment accepting signed-but-unsettled promises
582            # should be able to discover that without reading the source.
583            "settlement": (
584                "on-chain" if os.getenv("X402_FACILITATOR_URL")
585                else "verification-only"
586            ),
587            "network": app.state.token.network if app.state.token else None,
588            # The EIP-712 domain the service verifies signatures against. On
589            # the wire this is the difference between accepting a buyer's
590            # payment and rejecting every one of them: Base Sepolia's test USDC
591            # signs under the name "USDC", Base mainnet's under "USD Coin", and
592            # a mismatch fails every signature while looking like a broken
593            # deployment rather than a one-word config error.
594            "token": (
595                {
596                    "contract": app.state.token.verifying_contract,
597                    "domain_name": app.state.token.domain_name,
598                    "domain_version": app.state.token.domain_version,
599                    "chain_id": app.state.token.chain_id,
600                }
601                if app.state.token else None
602            ),
603            "job_store": app.state.store_backend,
604            # In-memory anything is single-process. Saying so here is cheaper
605            # than someone discovering it from a duplicated build.
606            "multi_process_safe": (
607                app.state.store_backend == "redis" and bool(os.getenv("REDIS_URL"))
608            ),
609            # Whether a paid build survives this process dying. Both halves have
610            # to be durable: a shared queue over an in-memory job store loses the
611            # record the build would be resumed from, which is a misconfiguration
612            # worth seeing in one line rather than deducing after an incident.
613            "durable_execution": (
614                app.state.queue.durable and app.state.store_backend == "redis"
615            ),
616            # None rather than a 500: an unreadable queue is exactly when an
617            # operator is reading /healthz, and losing the other fields to a
618            # traceback is the least useful moment to do it.
619            "queue_depth": _queue_depth(app.state.queue),
620            "embedded_worker": app.state.worker is not None,
621            # Whether this deployment can actually build. A service that takes
622            # payment it cannot fulfil should say so somewhere an operator
623            # looks, rather than only in the logs of a build a buyer paid for.
624            "generator_ready": _generator_unusable() is None,
625            # Surfaced for the same reason as the rest of this payload: an
626            # operator should be able to see that the accepting endpoint is
627            # bounded without reading the source or the environment.
628            "builds_rate_limit": (
629                f"{app.state.rate_limiter.limit}/"
630                f"{app.state.rate_limiter.window_seconds}s"
631                if app.state.rate_limiter.enabled else "unlimited"
632            ),
633        }
634
635    def _json_of(response: JSONResponse) -> dict[str, Any]:
636        """The body of a route's JSONResponse, for tools that reuse the route."""
637        return json.loads(bytes(response.body).decode("utf-8"))
638
639    def _start_build_for_agent(
640        prd_body: dict[str, Any], x_payment: str | None, request: Request
641    ) -> dict[str, Any]:
642        """Buy a build over MCP, by the same route an HTTP buyer takes.
643
644        Delegates to `create_build` rather than reimplementing it: the rate
645        limit, the generator-readiness gate, PRD validation and — above all —
646        the payment check are one implementation. A second copy here is how an
647        MCP path ends up giving builds away that the HTTP path charges for.
648
649        Payment stays the caller's job. An agent holds the wallet and this
650        service never sees a key; an unpaid call is answered with the terms to
651        sign rather than an error, so a paying agent needs exactly two calls
652        and no documentation.
653        """
654        try:
655            answer = create_build(prd_body, request, x_payment)
656        except HTTPException as exc:
657            # A malformed PRD. Raising through the MCP layer would surface as a
658            # bare tool error; the agent can act on the field list.
659            return {
660                "paid": False,
661                "error": "the PRD was rejected before any payment was taken",
662                "detail": exc.detail,
663                "next": "fix the document and retry; prd_schema has the contract",
664            }
665        body = json.loads(bytes(answer.body).decode("utf-8"))
666
667        if answer.status_code == 402:
668            return {
669                "paid": False,
670                "next": (
671                    "sign an EIP-3009 authorization over accepts[0] and call "
672                    "start_build again with it as x_payment"
673                ),
674                **body,
675            }
676        if answer.status_code >= 400:
677            return {"paid": False, "error": body}
678
679        job_id = body.get("id")
680        return {
681            "paid": True,
682            **body,
683            "poll": f"build_status(job_id='{job_id}')",
684            "apk_url": f"{_public_resource_url(request).rsplit('/', 1)[0]}/builds/{job_id}/apk",
685        }
686
687    @app.post("/mcp")
688    async def mcp_endpoint(request: Request):
689        """Remote MCP: paste this URL into Claude or Cursor and the tools appear.
690
691        Every tool below calls the same function the matching HTTP route calls,
692        so the MCP surface cannot describe a service the API does not provide.
693        """
694        payload = await request.json()
695        tools = {
696            tool.name: tool for tool in (
697                Tool(
698                    "validate_prd",
699                    "Check a product requirements document and report exactly what "
700                    "would be built — screens, models, navigation, auth — without "
701                    "building it. Free, no payment required. Uses the same validator "
702                    "as the paid build, so anything accepted here will not be "
703                    "rejected after payment.",
704                    {
705                        "type": "object",
706                        "properties": {"prd": {
707                            "type": "object",
708                            "description": "the PRD; see the prd_schema tool",
709                        }},
710                        "required": ["prd"],
711                    },
712                    lambda prd: validate(prd),
713                ),
714                Tool(
715                    "prd_schema",
716                    "The JSON Schema a product requirements document must satisfy. "
717                    "Generate against this rather than guessing field names.",
718                    {"type": "object", "properties": {}},
719                    lambda: PRD.model_json_schema(),
720                ),
721                Tool(
722                    "payment_terms",
723                    "What a build costs and how to pay: price, token contract, "
724                    "chain and the EIP-712 domain, as an x402 challenge. Free.",
725                    {"type": "object", "properties": {}},
726                    lambda: challenge(
727                        token=app.state.token, pay_to=app.state.pay_to,
728                        max_amount_required=app.state.price_atomic,
729                        resource=_canonical_resource_url(),
730                        output_schema=BUILD_OUTPUT_SCHEMA,
731                    ),
732                ),
733                Tool(
734                    "build_status",
735                    "Status, log, diagnostics, settlement transaction and token "
736                    "usage for a build already paid for.",
737                    {
738                        "type": "object",
739                        "properties": {"job_id": {"type": "string"}},
740                        "required": ["job_id"],
741                    },
742                    lambda job_id: get_build(job_id, request),
743                ),
744                Tool(
745                    "preview_build",
746                    "Generate a real app from a PRD for FREE and read the source "
747                    "it produces — same generator, same repair loop, same static "
748                    "analysis as a paid build. It is not packaged into an APK; "
749                    "that is what payment buys. Returns a job id: poll it with "
750                    "build_status, then read the code with build_files. Takes "
751                    "about 5 minutes. Heavily rate limited, because each run "
752                    "costs the operator real model tokens.",
753                    {
754                        "type": "object",
755                        "properties": {"prd": {
756                            "type": "object",
757                            "description": "the PRD; see the prd_schema tool",
758                        }},
759                        "required": ["prd"],
760                    },
761                    lambda prd: _json_of(create_preview(prd, request)),
762                ),
763                Tool(
764                    "build_files",
765                    "The generated source for a build or preview, as a map of "
766                    "path to file contents.",
767                    {
768                        "type": "object",
769                        "properties": {"job_id": {"type": "string"}},
770                        "required": ["job_id"],
771                    },
772                    lambda job_id: build_files(job_id, request),
773                ),
774                Tool(
775                    "start_build",
776                    "Buy a build. Call once without `x_payment` to get the x402 "
777                    "payment requirements, sign an EIP-3009 authorization over "
778                    "them, then call again passing the signed authorization as "
779                    "`x_payment`. Returns a job id; poll it with build_status "
780                    "until apk_available is true, then download the APK from "
781                    "apk_url. A build takes about 5-8 minutes, so poll rather "
782                    "than blocking. Payment settles on-chain before the build "
783                    "starts, and a failed build still returns its diagnostics.",
784                    {
785                        "type": "object",
786                        "properties": {
787                            "prd": {
788                                "type": "object",
789                                "description": "the PRD; see the prd_schema tool",
790                            },
791                            "x_payment": {
792                                "type": "string",
793                                "description": (
794                                    "signed x402 payment authorization (the value "
795                                    "of the X-Payment header). Omit to be quoted."
796                                ),
797                            },
798                        },
799                        "required": ["prd"],
800                    },
801                    lambda prd, x_payment=None: _start_build_for_agent(prd, x_payment, request),
802                ),
803            )
804        }
805
806        answer = handle_payload(payload, tools, "prd-to-flutter-apk", SERVICE_VERSION)
807        if answer is None:
808            # A notification: acknowledged, deliberately with no body.
809            return Response(status_code=202)
810        return JSONResponse(answer)
811
812    @app.post("/preview", status_code=202)
813    def create_preview(prd_body: dict[str, Any], request: Request) -> JSONResponse:
814        """Generate a real app from the caller's own spec, free, but never package it.
815
816        The gap this closes: every competitor in this category lets you generate
817        your own idea and only charges to take the artifact away. Here the only
818        thing anyone could see without paying was one committed example, so a
819        buyer had to spend $3 on faith that their spec would fare as well.
820
821        This runs the identical pipeline — same generator, same repair loop,
822        same static analysis — and stops before packaging. Payment still buys
823        exactly what it bought before: the compiled APK.
824
825        It costs real tokens, which is why it is capped globally rather than
826        only per caller.
827        """
828        unusable = _generator_unusable()
829        if unusable is not None:
830            return JSONResponse(
831                status_code=503,
832                content={"error": "this deployment cannot build", "detail": unusable},
833            )
834
835        identity = client_identity(
836            request.headers.get("x-forwarded-for"),
837            request.client.host if request.client else None,
838        )
839        for limiter, scope, explain in (
840            (request.app.state.preview_limiter, identity,
841             "one free preview per address per day"),
842            (request.app.state.preview_budget, "all",
843             "the daily free-preview budget for this deployment is spent"),
844        ):
845            retry_after = limiter.check(scope)
846            if retry_after is not None:
847                return JSONResponse(
848                    status_code=429,
849                    content={
850                        "error": "free previews are rate limited",
851                        "detail": explain,
852                        "retry_after": retry_after,
853                        # Refusing a free preview must never read as "the
854                        # service is down"; the paid path is unaffected.
855                        "paid_builds_unaffected": "POST /builds still works",
856                    },
857                    headers={"Retry-After": str(retry_after)},
858                )
859
860        try:
861            prd = PRD.model_validate(prd_body)
862        except Exception as exc:
863            raise HTTPException(status_code=422, detail=str(exc)) from exc
864
865        store: JobStore = request.app.state.store
866        job = store.create(prd.app_name, prd=prd.model_dump(mode="json"))
867        job.build_dir = str(BUILD_ROOT / job.id)
868        job.preview = True
869        job.paid = False
870        store.save(job)
871        request.app.state.queue.push(job.id)
872
873        return JSONResponse(
874            status_code=202,
875            content={
876                **job.public(),
877                "note": (
878                    "free preview: the app is generated and analysed but not "
879                    "packaged. Poll this id, then read the source from "
880                    f"{_public_resource_url(request).rsplit('/', 1)[0]}"
881                    f"/builds/{job.id}/files"
882                ),
883                "to_get_an_apk": "POST the same document to /builds with payment",
884            },
885        )
886
887    @app.get("/builds/{job_id}/files")
888    def build_files(job_id: str, request: Request) -> dict[str, Any]:
889        """The generated source. The deliverable of a preview, and readable for
890        a paid build too — someone who bought the APK has more right to the code
891        inside it than a stranger running a preview does."""
892        store: JobStore = request.app.state.store
893        job = store.get(job_id)
894        if job is None:
895            raise HTTPException(status_code=404, detail="no such build")
896        if not job.build_dir or not Path(job.build_dir).is_dir():
897            raise HTTPException(status_code=404, detail="this build has no source on disk")
898
899        root = Path(job.build_dir)
900        files: dict[str, str] = {}
901        for path in sorted(root.rglob("*")):
902            if not path.is_file() or path.suffix not in {".dart", ".yaml", ".md"}:
903                continue
904            relative = path.relative_to(root).as_posix()
905            # Everything Flutter generates under these lives in the build tree,
906            # not the source the generator wrote.
907            if relative.startswith((".dart_tool/", "build/", "android/", "ios/")):
908                continue
909            try:
910                files[relative] = path.read_text(encoding="utf-8")
911            except (OSError, UnicodeDecodeError):
912                continue
913
914        return {
915            "id": job.id,
916            "status": job.status.value,
917            "preview": job.preview,
918            "file_count": len(files),
919            "files": files,
920        }
921
922    @app.post("/validate")
923    def validate(prd_body: dict[str, Any]) -> dict[str, Any]:
924        """Free: would this document build, and what would come out?
925
926        Every other route costs $3, which means nobody can evaluate the service
927        without first trusting it. This answers the question a buyer actually has
928        before paying — is my document well-formed, and is it describing the app
929        I think it is — using the same validator the paid path uses, so a
930        document that passes here cannot be rejected there.
931
932        Costs nothing to serve: pure schema validation, no model call.
933        """
934        try:
935            prd = PRD.model_validate(prd_body)
936        except Exception as exc:
937            return {
938                "valid": False,
939                # The 422 a buyer would otherwise discover one field at a time,
940                # after paying.
941                "errors": str(exc).splitlines(),
942                "schema": "/schema/prd.json",
943            }
944
945        navigations = [
946            action.target
947            for screen in prd.screens for action in screen.actions
948            if action.kind == "navigate" and action.target
949        ]
950        return {
951            "valid": True,
952            "app_name": prd.app_name,
953            "package_name": prd.package_name,
954            "theme": prd.theme,
955            "would_build": {
956                "screens": [
957                    {"id": s.id, "title": s.title, "kind": s.kind,
958                     "fields": len(s.fields), "actions": len(s.actions)}
959                    for s in prd.screens
960                ],
961                "models": [
962                    {"name": m.name, "collection": m.collection, "fields": len(m.fields)}
963                    for m in prd.models
964                ],
965                "firebase_auth": prd.auth,
966                "navigation_targets": sorted(set(navigations)),
967            },
968            "price": {
969                "amount": human_amount(app.state.price_atomic, 6),
970                "currency": "USDC",
971                "network": app.state.token.network if app.state.token else None,
972                "buy": "POST the same document to /builds",
973            },
974        }
975
976    @app.get("/builds")
977    def builds_terms(request: Request) -> JSONResponse:
978        """An unpaid GET answers 402 with the terms, not 405.
979
980        Building requires a POST with a PRD, so GET has nothing to do — but
981        x402 clients, crawlers and directory probers all reach for GET first to
982        ask "what does this cost?", and a 405 reads as a broken or non-x402
983        endpoint. A discovery directory rejected verification for exactly this,
984        which would have left the listing ranked last indefinitely.
985        """
986        return JSONResponse(
987            status_code=402,
988            content=challenge(
989                token=request.app.state.token,
990                pay_to=request.app.state.pay_to,
991                max_amount_required=request.app.state.price_atomic,
992                resource=_public_resource_url(request),
993                output_schema=BUILD_OUTPUT_SCHEMA,
994                error="POST a PRD with this header to build; GET only quotes the price",
995            ),
996        )
997
998    @app.post("/builds", status_code=202)
999    def create_build(
1000        prd_body: dict[str, Any],
1001        request: Request,
1002        x_payment: str | None = Header(default=None, alias=PAYMENT_HEADER),
1003    ) -> JSONResponse:
1004        # Before anything expensive. Verifying a payment means two network round
1005        # trips to the facilitator from a synchronous endpoint, so a flood of
1006        # junk authorizations exhausts the thread pool and takes the service
1007        # down for the buyers who did pay.
1008        limiter = request.app.state.rate_limiter
1009        retry_after = limiter.check(
1010            client_identity(
1011                request.headers.get("x-forwarded-for"),
1012                request.client.host if request.client else None,
1013            )
1014        )
1015        if retry_after is not None:
1016            return JSONResponse(
1017                status_code=429,
1018                content={
1019                    "error": "too many requests",
1020                    "detail": (
1021                        f"at most {limiter.limit} build requests per "
1022                        f"{limiter.window_seconds}s from one address"
1023                    ),
1024                    "retry_after": retry_after,
1025                },
1026                headers={"Retry-After": str(retry_after)},
1027            )
1028
1029        # Same principle as validating the PRD below, applied to ourselves: if
1030        # this deployment cannot build, taking payment for a build is theft
1031        # whoever's fault the misconfiguration is. 503 rather than 402, because
1032        # the buyer has done nothing wrong and paying would not help.
1033        unusable = _generator_unusable()
1034        if unusable is not None:
1035            log.error("refusing builds: %s", unusable)
1036            return JSONResponse(
1037                status_code=503,
1038                content={"error": "this deployment cannot build", "detail": unusable},
1039            )
1040
1041        # Validate before charging: a malformed PRD is the buyer's mistake to
1042        # fix, and taking payment for work that cannot start would be theft.
1043        try:
1044            prd = PRD.model_validate(prd_body)
1045        except Exception as exc:
1046            raise HTTPException(status_code=422, detail=str(exc)) from exc
1047
1048        verifier = request.app.state.verifier
1049        if not verifier.settle(x_payment):
1050            return JSONResponse(
1051                status_code=402,
1052                content=challenge(
1053                    token=request.app.state.token,
1054                    pay_to=request.app.state.pay_to,
1055                    max_amount_required=request.app.state.price_atomic,
1056                    error=getattr(verifier, "last_error", None),
1057                    # The spec asks for the URL of the protected resource, not
1058                    # its path. Taken from the request so it is right behind the
1059                    # TLS proxy, where the service's own view is http://api:8000.
1060                    resource=_public_resource_url(request),
1061                    output_schema=BUILD_OUTPUT_SCHEMA,
1062                ),
1063            )
1064
1065        store: JobStore = request.app.state.store
1066        # The PRD is stored on the job rather than captured in a closure, so a
1067        # worker that never saw this request can still build it. The buyer's own
1068        # `x402_payment_verified` is stored as sent and overridden at build time
1069        # by `_verified_prd`, keeping one place that decides it.
1070        job = store.create(prd.app_name, prd=prd.model_dump(mode="json"))
1071        job.build_dir = str(BUILD_ROOT / job.id)
1072        # Reaching here means the verifier settled. Recording that on the job is
1073        # what lets the worker check it instead of inferring payment from the
1074        # mere fact that something was queued.
1075        job.paid = True
1076        # Explicit, not getattr-with-a-default: the buyer's proof of payment
1077        # went missing for a while behind exactly that kind of silent fallback.
1078        verifier = request.app.state.verifier
1079        job.settlement_tx = (
1080            verifier.last_transaction
1081            if isinstance(verifier, X402Verifier) else None
1082        )
1083        store.save(job)
1084        # Saved before queued, never the other way round: a worker can reserve
1085        # the id the instant it is pushed, and would find no record to build.
1086        request.app.state.queue.push(job.id)
1087        return JSONResponse(
1088            status_code=202,
1089            content={"id": job.id, "status": job.status.value},
1090            headers={"Location": f"/builds/{job.id}"},
1091        )
1092
1093    @app.get("/builds/{job_id}")
1094    def get_build(job_id: str, request: Request) -> dict[str, Any]:
1095        job = request.app.state.store.get(job_id)
1096        if job is None:
1097            raise HTTPException(status_code=404, detail="no such build")
1098        # A job whose worker died would otherwise report `running` for ever.
1099        return reap_stale(request.app.state.store, job).public()
1100
1101    @app.get("/builds/{job_id}/apk")
1102    def get_apk(job_id: str, request: Request) -> FileResponse:
1103        job = request.app.state.store.get(job_id)
1104        if job is None:
1105            raise HTTPException(status_code=404, detail="no such build")
1106        if job.status is not BuildStatus.SUCCEEDED:
1107            # 409, not 404: the build exists, it is simply not finished.
1108            raise HTTPException(
1109                status_code=409,
1110                detail=f"build is {job.status.value}; no artifact yet",
1111            )
1112        if not job.apk_path or not Path(job.apk_path).exists():
1113            raise HTTPException(
1114                status_code=404,
1115                detail="build succeeded but produced no APK "
1116                       "(packaging is skipped unless the toolchain is present)",
1117            )
1118        return FileResponse(
1119            job.apk_path,
1120            media_type="application/vnd.android.package-archive",
1121            filename=f"{job.app_name.replace(' ', '_').lower()}.apk",
1122        )
1123
1124    return app
1125
1126
1127def _verified_prd(prd: PRD) -> dict[str, Any]:
1128    """The PRD the pipeline runs, with payment decided by the server.
1129
1130    The buyer's own `x402_payment_verified` is discarded rather than trusted.
1131    Reaching this function at all means the verifier already settled, so it is
1132    set to True here and nowhere else.
1133    """
1134    payload = prd.model_dump(mode="json")
1135    payload["x402_payment_verified"] = True
1136    return payload
1137
1138
1139def _preview_prd(prd: PRD) -> dict[str, Any]:
1140    """The PRD a free preview runs, with payment explicitly not asserted.
1141
1142    The counterpart to `_verified_prd`, and deliberately its mirror image: the
1143    buyer's own flag is discarded here too, set to False rather than trusted.
1144    A preview that arrived claiming `x402_payment_verified: true` would
1145    otherwise package an APK for nothing.
1146    """
1147    payload = prd.model_dump(mode="json")
1148    payload["x402_payment_verified"] = False
1149    return payload
1150
1151
1152def build_work(job: BuildJob):
1153    """What building this job actually means, for a worker that only has the record.
1154
1155    Handed to `BuildWorker` so that module stays free of LangGraph, PRDs and
1156    Flutter, and the queue mechanics can be tested without any of them.
1157
1158    Both checks here are refusals, not assertions: an unpaid or unreadable job
1159    should fail with a reason the buyer can act on, and the worker turns a raised
1160    exception into exactly that.
1161    """
1162    if not job.paid and not job.preview:
1163        raise PermissionError(
1164            "refusing to build a job that no payment path marked as paid"
1165        )
1166    if job.paid and job.preview:
1167        # Nothing constructs this, and if something ever did it would be a job
1168        # whose intent is ambiguous at exactly the point where the answer
1169        # decides whether an APK gets built for free.
1170        raise ValueError("a job cannot be both paid and a free preview")
1171    if not job.prd:
1172        raise ValueError("job has no PRD stored; nothing to build")
1173
1174    prd = PRD.model_validate(job.prd)
1175    settings = _settings()
1176
1177    def run(job: BuildJob) -> None:
1178        # Held rather than passed inline: the generator accumulates token usage
1179        # across every call it makes for this build, and reading it afterwards
1180        # is the only way to know what the build cost.
1181        generator = get_generator(settings["generator"])
1182        app_graph = build_graph(
1183            generator,
1184            get_analyzer(settings["analyzer"], settings["flutter_root"]),
1185            max_repairs=settings["max_repairs"],
1186            test_runner=(
1187                FlutterTestRunner(settings["flutter_root"])
1188                if settings["run_tests"] else None
1189            ),
1190            dry_run=False,
1191            flutter_root=settings["flutter_root"],
1192            build_mode=settings["build_mode"],
1193            sdk_root=settings["sdk_root"],
1194        )
1195        build_dir = Path(job.build_dir)
1196        build_dir.mkdir(parents=True, exist_ok=True)
1197
1198        # A preview runs the identical pipeline with payment *not* asserted, so
1199        # the packaging node refuses on its own terms. The gate is therefore not
1200        # bypassed for previews — it is exercised, and observed to close.
1201        payload = _preview_prd(prd) if job.preview else _verified_prd(prd)
1202
1203        final = app_graph.invoke(initial_state(payload, str(build_dir)))
1204
1205        # Appended, not assigned: a requeued build already carries the note
1206        # saying its first attempt was abandoned, and overwriting that would
1207        # hide the retry from the only person watching the log.
1208        job.log = [*job.log, *final.get("log", [])]
1209        job.diagnostics = [d.render() for d in final.get("diagnostics", [])]
1210
1211        if final.get("phase") == "failed":
1212            job.status = BuildStatus.FAILED
1213            job.failure = final.get("failure") or "build failed"
1214        elif job.diagnostics:
1215            job.status = BuildStatus.FAILED
1216            job.failure = f"{len(job.diagnostics)} unresolved diagnostic(s)"
1217        else:
1218            job.status = BuildStatus.SUCCEEDED
1219            job.apk_path = final.get("apk_path") or None
1220
1221        if job.preview and job.apk_path:
1222            # Unreachable unless the packaging gate has been broken. Refusing
1223            # here as well means a regression in the gate shows up as a failed
1224            # preview rather than as free APKs.
1225            job.apk_path = None
1226            job.status = BuildStatus.FAILED
1227            job.failure = "a preview produced an APK; packaging gate did not hold"
1228
1229        # Recorded whatever the outcome — a failed build still spent tokens,
1230        # and those are the builds whose cost most needs explaining. Offline
1231        # generators have no usage to report, hence the getattr.
1232        usage = getattr(generator, "usage", None)
1233        if usage is not None:
1234            job.usage = usage.public()
1235
1236        # Set here, not left to `_execute` after this closure returns.
1237        # `InMemoryJobStore` hands out the live `BuildJob` object rather than a
1238        # copy, so the instant `job.status` above becomes terminal, a concurrent
1239        # `GET /builds/{id}` can already see it — and pruning below is real
1240        # filesystem I/O, wide enough for that poll to land in the gap and
1241        # observe a "succeeded" build with `finished_at` still null. Setting
1242        # both together, with nothing but attribute assignment between them,
1243        # closes it. `_execute` only fills this in for the paths that never
1244        # reach here: an exception, or a build that exits without setting a
1245        # terminal status at all.
1246        job.finished_at = datetime.now(timezone.utc)
1247
1248        # The buyer wants the APK; the other ~2 GB is a Gradle output tree that
1249        # nothing will ever read again. Pruning here rather than on a timer
1250        # means the disk is reclaimed while the worker still holds the lease,
1251        # so no other worker can be reading the directory as it goes.
1252        if _PRUNE_BUILDS:
1253            # A preview's whole deliverable is the source, so pruning to "just
1254            # the APK" would delete the only thing it produced. Expired
1255            # directories are still swept, which is what actually bounds disk.
1256            if not job.preview:
1257                job.apk_path = keep_only_the_artifact(job.build_dir, job.apk_path)
1258            sweep_expired(BUILD_ROOT, _RETENTION_SECONDS)
1259
1260    return run
1261
1262
1263def _queue_depth(queue: BuildQueue) -> int | None:
1264    try:
1265        return queue.depth()
1266    except Exception:  # noqa: BLE001 - /healthz must answer even when Redis is down
1267        log.exception("could not read the queue depth")
1268        return None
1269
1270
1271def _worker_settings() -> dict[str, Any]:
1272    """Lease timings, which are a deployment decision rather than a constant.
1273
1274    The lease has to outlast the slowest thing a build does between heartbeats,
1275    and the heartbeat has to be short enough that a dead worker's build is
1276    retried while the buyer is still waiting. A deployment generating large apps
1277    against a cold Gradle cache sits at a different point on that trade than one
1278    running the template generator, and neither should have to edit the source.
1279    """
1280    return {
1281        "lease_seconds": int(os.getenv("BUILD_LEASE_SECONDS", DEFAULT_LEASE_SECONDS)),
1282        "heartbeat_seconds": int(
1283            os.getenv("BUILD_HEARTBEAT_SECONDS", DEFAULT_HEARTBEAT_SECONDS)
1284        ),
1285        "max_attempts": int(os.getenv("BUILD_MAX_ATTEMPTS", DEFAULT_MAX_ATTEMPTS)),
1286    }
1287
1288
1289def build_worker_for_environment() -> BuildWorker:
1290    """The wiring a standalone worker needs, from the same environment the API reads.
1291
1292    `python -m src.service.worker` calls this. It shares `_redis` and the store
1293    and queue choices with `create_app` deliberately: a worker that assembled its
1294    own would eventually disagree with the service about where the work is.
1295    """
1296    client = _redis()
1297    store = RedisJobStore(client) if client else InMemoryJobStore()
1298    queue = RedisBuildQueue(client) if client else InMemoryBuildQueue()
1299    return BuildWorker(store, queue, build_work, **_worker_settings())
1300
1301
1302app = create_app()

src/service/artifacts.py

1"""Reclaiming the disk a finished build leaves behind.
2
3A completed build is about 2.0 GB — a Flutter project, its `.dart_tool`, an
4`android/` scaffold and a Gradle output tree — of which the buyer wants roughly
5150 MB: the APK. On the first deployment that meant a 150 GB box had room for
6about 58 sales.
7
8Nothing reclaimed it. Job *records* expire from Redis after seven days, which is
9the wrong half: the record is a few kilobytes and the directory it points at is
10gigabytes. Left alone the disk fills, and the failure lands on a build that has
11already been paid for, which is the worst failure this service has.
12
13Two mechanisms, deliberately separate:
14
15* `keep_only_the_artifact` runs the moment a build finishes. The APK is moved to
16  the top of the job's directory and everything else goes. This is where the
17  2.0 GB actually is.
18* `sweep_expired` removes whole job directories past their retention. It matches
19  `RedisJobStore`'s TTL, because once the record is gone the download endpoint
20  answers 404 and the APK on disk is unreachable weight.
21
22Both are conservative about what they will delete: only inside `BUILD_ROOT`, only
23directories that look like the job directories this service created, and never
24the artifact a buyer has paid for and might still be collecting.
25"""
26
27from __future__ import annotations
28
29import logging
30import os
31import shutil
32import time
33from pathlib import Path
34
35log = logging.getLogger(__name__)
36
37DEFAULT_RETENTION_SECONDS = 7 * 24 * 3600
38
39
40def _tree_size(path: Path) -> int:
41    total = 0
42    for root, _dirs, files in os.walk(path, onerror=lambda _e: None):
43        for name in files:
44            try:
45                total += (Path(root) / name).stat().st_size
46            except OSError:
47                pass
48    return total
49
50
51def keep_only_the_artifact(build_dir: str | Path, apk_path: str | None) -> str | None:
52    """Delete the project tree, keeping the APK. Returns its new path.
53
54    The APK is produced deep inside the build — Gradle puts it at
55    `build/app/outputs/apk/<mode>/app-<mode>.apk` — so it has to be moved out
56    before the tree can go. The returned path is what the job record should
57    point at; callers that ignore the return value would leave the record
58    referring to a file that has just been deleted.
59
60    A build with no artifact (a failure) has its tree removed too: the log and
61    diagnostics live on the job record, which is what anyone debugging reads,
62    and a failed build is retried from the stored PRD rather than from whatever
63    is left on disk.
64    """
65    build_dir = Path(build_dir)
66    if not build_dir.is_dir():
67        return apk_path
68
69    freed_from = _tree_size(build_dir)
70    kept: Path | None = None
71
72    if apk_path:
73        source = Path(apk_path)
74        # Only relocate an artifact that is actually inside this job's tree.
75        # An apk_path pointing elsewhere is not ours to move, and moving it
76        # would be the kind of surprise that is discovered much later.
77        if source.is_file() and source.resolve().is_relative_to(build_dir.resolve()):
78            kept = build_dir / source.name
79            if kept.resolve() != source.resolve():
80                # Delete-then-replace rather than overwrite: a stale artifact of
81                # the same name from an earlier attempt must not survive.
82                if kept.exists():
83                    kept.unlink()
84                shutil.move(str(source), str(kept))
85        elif source.is_file():
86            kept = source
87
88    for entry in build_dir.iterdir():
89        if kept is not None and entry.resolve() == kept.resolve():
90            continue
91        try:
92            if entry.is_dir() and not entry.is_symlink():
93                shutil.rmtree(entry, ignore_errors=True)
94            else:
95                entry.unlink(missing_ok=True)
96        except OSError:
97            log.warning("could not remove %s while pruning %s", entry, build_dir)
98
99    freed = freed_from - _tree_size(build_dir)
100    log.info(
101        "pruned %s, freeing %.1f GB; kept %s",
102        build_dir, freed / 1e9, kept.name if kept else "nothing",
103    )
104    return str(kept) if kept else None
105
106
107def sweep_expired(
108    build_root: str | Path, retention_seconds: int = DEFAULT_RETENTION_SECONDS
109) -> int:
110    """Remove job directories older than the retention. Returns bytes freed.
111
112    Age is taken from the directory's own mtime, which the build updates as it
113    writes — so a job that was retried days after it was created is measured
114    from the retry, not from the payment.
115    """
116    build_root = Path(build_root)
117    if not build_root.is_dir():
118        return 0
119
120    cutoff = time.time() - retention_seconds
121    freed = 0
122    for entry in build_root.iterdir():
123        if not entry.is_dir() or entry.is_symlink():
124            continue
125        try:
126            if entry.stat().st_mtime >= cutoff:
127                continue
128            size = _tree_size(entry)
129            shutil.rmtree(entry, ignore_errors=True)
130            if not entry.exists():
131                freed += size
132                log.info("swept expired build %s (%.2f GB)", entry.name, size / 1e9)
133        except OSError:
134            log.warning("could not sweep %s", entry)
135    return freed

src/service/jobs.py

1"""Build jobs: the record of one paid build.
2
3A build runs the graph, calls a model several times and shells out to Gradle, so
4it takes minutes — far too long to hold an HTTP connection open. `POST /builds`
5accepts the work and returns an id.
6
7Storage and execution are separate concerns and are separated here: this module
8owns what a job *is* and where it is kept, `queue.py` owns who gets to run it,
9and `worker.py` owns running it. The job record is the handover point, which is
10why it carries the PRD. Holding the PRD in a closure — as this did while
11execution lived in the accepting process — meant the work existed only in the
12memory of one process, so no other worker could pick up a build even in
13principle. Durable execution starts with writing down what was bought.
14"""
15
16from __future__ import annotations
17
18import json
19import logging
20import threading
21import uuid
22from dataclasses import asdict, dataclass, field
23from datetime import datetime, timedelta, timezone
24from enum import Enum
25from pathlib import Path
26from typing import Any, Protocol
27
28log = logging.getLogger(__name__)
29
30
31class BuildStatus(str, Enum):
32    QUEUED = "queued"
33    RUNNING = "running"
34    SUCCEEDED = "succeeded"
35    FAILED = "failed"
36
37
38@dataclass
39class BuildJob:
40    id: str
41    app_name: str
42    status: BuildStatus = BuildStatus.QUEUED
43    created_at: datetime = field(default_factory=lambda: datetime.now(timezone.utc))
44    finished_at: datetime | None = None
45    log: list[str] = field(default_factory=list)
46    diagnostics: list[str] = field(default_factory=list)
47    failure: str | None = None
48    apk_path: str | None = None
49    build_dir: str | None = None
50    heartbeat_at: datetime | None = None
51    settlement_tx: str | None = None
52    # Token counts and an estimated cost for this build, or empty for the
53    # offline generators, which spend nothing. This is the only record of what
54    # a sale cost to fulfil — without it the price is a guess.
55    usage: dict[str, Any] = field(default_factory=dict)
56    # The work itself, stored rather than closed over, so a worker that did not
57    # accept this build can still run it. See the module docstring.
58    prd: dict[str, Any] | None = None
59    # Set only by the path that settled a payment. The worker checks it before
60    # building, so "it was in the queue" is never by itself the authorization —
61    # the same reason the buyer's own `x402_payment_verified` is discarded.
62    paid: bool = False
63    # A free preview: the pipeline generates and analyses the app but is never
64    # allowed to package it. `paid` stays False for these, which is why the
65    # worker's refusal has to distinguish the two rather than checking `paid`
66    # alone. Packaging is refused twice over — here, and by the graph node
67    # itself, which reads `x402_payment_verified` off the PRD.
68    preview: bool = False
69    # How many times a worker has picked this up. Bounded in `worker.py`: a
70    # build that kills its worker would otherwise be retried for ever.
71    attempts: int = 0
72
73    def public(self) -> dict[str, Any]:
74        """What the buyer sees. `prd` is deliberately absent — they sent it, and
75        echoing it back on every poll of a minutes-long build is pure weight."""
76        return {
77            "id": self.id,
78            "app_name": self.app_name,
79            "status": self.status.value,
80            "created_at": self.created_at.isoformat(),
81            "finished_at": self.finished_at.isoformat() if self.finished_at else None,
82            "log": self.log,
83            "diagnostics": self.diagnostics,
84            "failure": self.failure,
85            "settlement_tx": self.settlement_tx,
86            # A buyer polling a build that quietly restarted deserves to see
87            # that it did, rather than wondering why the log went backwards.
88            "attempts": self.attempts,
89            "apk_available": bool(self.apk_path and Path(self.apk_path).exists()),
90            # Says plainly which kind of job this is, so a caller polling one
91            # never waits for an APK that was never going to be built.
92            "preview": self.preview,
93            # What this build cost to produce. Shown to the buyer as well as
94            # the operator: an M2M buyer deciding whether the price is fair has
95            # the same interest in it that the seller does.
96            "usage": self.usage,
97        }
98
99    # -- serialisation for a shared store ----------------------------------- #
100
101    def to_json(self) -> str:
102        raw = asdict(self)
103        raw["status"] = self.status.value
104        for stamp in ("created_at", "finished_at", "heartbeat_at"):
105            value = getattr(self, stamp)
106            raw[stamp] = value.isoformat() if value else None
107        return json.dumps(raw)
108
109    @classmethod
110    def from_json(cls, blob: str | bytes) -> BuildJob:
111        raw = json.loads(blob)
112        raw["status"] = BuildStatus(raw["status"])
113        for stamp in ("created_at", "finished_at", "heartbeat_at"):
114            raw[stamp] = datetime.fromisoformat(raw[stamp]) if raw.get(stamp) else None
115        return cls(**raw)
116
117
118class JobStore(Protocol):
119    def create(self, app_name: str, prd: dict[str, Any] | None = ...) -> BuildJob: ...
120    def get(self, job_id: str) -> BuildJob | None: ...
121    def save(self, job: BuildJob) -> None: ...
122
123
124class InMemoryJobStore:
125    """Single-process job state. Fine for a CLI-shaped deployment.
126
127    Note what this cannot do however durable the queue is: the records live in
128    one process, so a restart loses them even if the queue kept the ids. Pairing
129    a durable queue with this store is a misconfiguration, and `/healthz`
130    reports durability from both.
131    """
132
133    def __init__(self) -> None:
134        self._jobs: dict[str, BuildJob] = {}
135        self._lock = threading.Lock()
136
137    def create(self, app_name: str, prd: dict[str, Any] | None = None) -> BuildJob:
138        job = BuildJob(id=uuid.uuid4().hex, app_name=app_name, prd=prd)
139        with self._lock:
140            self._jobs[job.id] = job
141        return job
142
143    def get(self, job_id: str) -> BuildJob | None:
144        with self._lock:
145            return self._jobs.get(job_id)
146
147    def save(self, job: BuildJob) -> None:
148        with self._lock:
149            self._jobs[job.id] = job
150
151
152class RedisJobStore:
153    """Job state shared across workers.
154
155    Unlike the nonce store, this one does not need compare-and-set: a job is
156    created once by the worker that accepted it and, at any moment, written only
157    by whichever worker holds its lease, so last-write-wins is correct here. The
158    nonce store's `SETNX` matters because two callers race for the same key; the
159    queue's leases keep anything from racing for a job id.
160
161    Jobs expire, because a build log is not a permanent record and an unbounded
162    key space is an outage waiting to happen. The queue uses the same retention,
163    so a job record and its place in the queue disappear together.
164    """
165
166    def __init__(self, client: Any, prefix: str = "build:job:", ttl: int = 7 * 24 * 3600):
167        self._redis = client
168        self._prefix = prefix
169        self._ttl = ttl
170
171    def _key(self, job_id: str) -> str:
172        return f"{self._prefix}{job_id}"
173
174    def create(self, app_name: str, prd: dict[str, Any] | None = None) -> BuildJob:
175        job = BuildJob(id=uuid.uuid4().hex, app_name=app_name, prd=prd)
176        self.save(job)
177        return job
178
179    def get(self, job_id: str) -> BuildJob | None:
180        blob = self._redis.get(self._key(job_id))
181        if blob is None:
182            return None
183        try:
184            return BuildJob.from_json(blob)
185        except (ValueError, TypeError, KeyError):
186            log.exception("job %s is unreadable", job_id)
187            return None
188
189    def save(self, job: BuildJob) -> None:
190        self._redis.set(self._key(job.id), job.to_json(), ex=self._ttl)
191
192
193STALE_AFTER = timedelta(minutes=30)
194
195
196def reap_stale(store: JobStore, job: BuildJob, now: datetime | None = None) -> BuildJob:
197    """Fail a job that no worker is going to finish.
198
199    The queue's leases recover a build whose worker died: it goes back to
200    `pending` and somebody picks it up. That recovery needs the queue to have
201    outlived the worker, which is true of the Redis queue and false of the
202    in-memory one — kill that process and its pending list dies with it, while
203    the job records in a shared store live on, describing builds that will never
204    run again.
205
206    This is the backstop for exactly that case, and for a job whose id was lost
207    from the queue by any other means. A status that will never change is worse
208    than a failure, because a caller polls it indefinitely.
209
210    The threshold is measured from the last heartbeat, and a requeue refreshes
211    it, so a build waiting its turn behind a long queue is not mistaken for an
212    abandoned one.
213    """
214    if job.status not in {BuildStatus.RUNNING, BuildStatus.QUEUED}:
215        return job
216    moment = now or datetime.now(timezone.utc)
217    last_seen = job.heartbeat_at or job.created_at
218    if moment - last_seen <= STALE_AFTER:
219        return job
220
221    job.status = BuildStatus.FAILED
222    job.failure = (
223        "build was abandoned — no worker has reported on it for "
224        f"{int(STALE_AFTER.total_seconds() // 60)} minutes, and none is "
225        "expected to. A durable queue (REDIS_URL) lets an abandoned build be "
226        "retried by another worker instead."
227    )
228    job.finished_at = moment
229    store.save(job)
230    return job

src/service/mcp.py

1"""A remote MCP server, so an agent can use this service without integrating it.
2
3Deliberately an HTTP endpoint rather than a published package. A package has to
4be found, installed, and kept up to date; a URL is pasted once into Claude or
5Cursor and the tools appear. It also means the tool list is generated from the
6running service, so it cannot drift from what the API actually does.
7
8The transport is JSON-RPC 2.0 over a single POST, which is the streamable-HTTP
9transport's simple case: a request gets one JSON response, a notification gets
10none. No SSE, no sessions — nothing here is long-running or stateful, and a
11server that claims capabilities it does not implement is worse than a plain one.
12"""
13
14from __future__ import annotations
15
16import json
17from typing import Any, Callable
18
19# Echoed back to whatever the client asks for when we recognise it. The tool
20# half of the protocol has been stable across these, and refusing an unfamiliar
21# version is how a working server becomes unusable to a newer client.
22SUPPORTED_PROTOCOLS = ("2025-06-18", "2025-03-26", "2024-11-05")
23DEFAULT_PROTOCOL = SUPPORTED_PROTOCOLS[0]
24
25METHOD_NOT_FOUND = -32601
26INVALID_PARAMS = -32602
27INTERNAL_ERROR = -32603
28
29
30class Tool:
31    """One callable exposed to an agent, with the schema it is described by."""
32
33    def __init__(self, name: str, description: str, schema: dict, run: Callable[..., Any]):
34        self.name = name
35        self.description = description
36        self.schema = schema
37        self.run = run
38
39    def definition(self) -> dict:
40        return {
41            "name": self.name,
42            "description": self.description,
43            "inputSchema": self.schema,
44        }
45
46
47def _result(request_id: Any, result: dict) -> dict:
48    return {"jsonrpc": "2.0", "id": request_id, "result": result}
49
50
51def _error(request_id: Any, code: int, message: str) -> dict:
52    return {"jsonrpc": "2.0", "id": request_id, "error": {"code": code, "message": message}}
53
54
55def handle(message: dict, tools: dict[str, Tool], server_name: str, version: str) -> dict | None:
56    """Answer one JSON-RPC message, or None when it is a notification.
57
58    A notification has no `id` and must not be answered — replying to one is a
59    protocol violation that some clients treat as a hard failure rather than
60    ignoring, which shows up as a server that never finishes initialising.
61    """
62    method = message.get("method")
63    request_id = message.get("id")
64    params = message.get("params") or {}
65
66    if request_id is None:
67        return None
68
69    if method == "initialize":
70        asked = params.get("protocolVersion")
71        return _result(request_id, {
72            "protocolVersion": asked if asked in SUPPORTED_PROTOCOLS else DEFAULT_PROTOCOL,
73            # Only what is actually implemented. Advertising `resources` or
74            # `prompts` here would have clients call methods that do not exist.
75            "capabilities": {"tools": {"listChanged": False}},
76            "serverInfo": {"name": server_name, "version": version},
77        })
78
79    if method == "ping":
80        return _result(request_id, {})
81
82    if method == "tools/list":
83        return _result(request_id, {"tools": [tool.definition() for tool in tools.values()]})
84
85    if method == "tools/call":
86        name = params.get("name")
87        tool = tools.get(name)
88        if tool is None:
89            return _error(request_id, INVALID_PARAMS, f"no such tool: {name}")
90        try:
91            output = tool.run(**(params.get("arguments") or {}))
92        except TypeError as exc:
93            return _error(request_id, INVALID_PARAMS, f"bad arguments for {name}: {exc}")
94        except Exception as exc:  # noqa: BLE001
95            # Reported as a tool error, not a protocol error: the call was
96            # well-formed and the agent should see what went wrong and be able
97            # to retry, rather than have the whole session look broken.
98            return _result(request_id, {
99                "content": [{"type": "text", "text": f"{type(exc).__name__}: {exc}"}],
100                "isError": True,
101            })
102        return _result(request_id, {
103            "content": [{"type": "text", "text": json.dumps(output, indent=2, default=str)}],
104            "isError": False,
105        })
106
107    return _error(request_id, METHOD_NOT_FOUND, f"unsupported method: {method}")
108
109
110def handle_payload(payload: Any, tools: dict[str, Tool], server_name: str, version: str):
111    """Dispatch one message or a batch, preserving JSON-RPC batch semantics."""
112    if isinstance(payload, list):
113        answers = [
114            answer for answer in
115            (handle(message, tools, server_name, version) for message in payload)
116            if answer is not None
117        ]
118        return answers or None
119    return handle(payload, tools, server_name, version)

src/service/queue.py

1"""The queue that lets a paid build outlive the worker that accepted it.
2
3Until now `POST /builds` settled the payment and then ran the build on a thread
4pool inside the accepting process. Job *state* was shared, so any worker could
5report status, but the work itself was not: restart that one process and the
6build was gone, with the buyer's money already on-chain. `reap_stale` turned the
7loss into an honest failure rather than a job reporting `running` for ever,
8which is the least bad thing to do with a build nobody can finish — but it is
9still a build nobody can finish.
10
11This is the reliable-queue pattern. A job id is moved from `pending` to
12`inflight` in one atomic step, and the worker holding it keeps a lease key alive
13while it builds. Two properties follow:
14
15**Nothing is lost between the two lists.** `LMOVE` is a single command, so there
16is no moment where an id has left `pending` and not yet reached `inflight`. A
17`RPOP` followed by an `LPUSH` would have exactly that gap, and a worker dying
18inside it takes the build with it — the failure this module exists to prevent.
19
20**A dead worker is discovered by silence.** The lease expires on its own, so
21recovery needs no cooperation from the process that died; that process is, by
22assumption, in no position to cooperate. `requeue_expired` moves any inflight
23job whose lease has lapsed back to `pending`, and `LREM`'s return value settles
24which reaper won — two workers can both notice the same corpse, and exactly one
25gets a non-zero reply and does the requeue.
26
27**What a lease does not do.** It bounds duplicate work; it does not make it
28impossible. A worker partitioned from Redis for longer than its lease is
29indistinguishable from a dead one, so its job is legitimately handed to somebody
30else while it is still building. `renew` returns False once that has happened,
31which is how the stalled worker learns to stand down, but the two overlap for as
32long as the partition lasted. That costs compute and not money: the payment
33settled before the job was ever queued, so a build running twice charges once.
34Pretending otherwise would need fencing tokens all the way down into Gradle.
35"""
36
37from __future__ import annotations
38
39import logging
40import threading
41import time
42import uuid
43from collections import deque
44from typing import Any, Protocol
45
46log = logging.getLogger(__name__)
47
48# Long enough that an ordinary slow step — a model call, a Gradle download —
49# never looks like death, short enough that a genuinely dead worker's build is
50# picked up while the buyer is still waiting. The worker renews far more often
51# than this, so only a real stall gets anywhere near it.
52DEFAULT_LEASE_SECONDS = 300
53
54
55def new_owner_id() -> str:
56    """An identity for one worker process, unique per start.
57
58    Deliberately not the hostname or pid: a restarted worker must not inherit
59    the leases of its previous life, or it would renew a lease on a build that
60    died with the process before it.
61    """
62    return uuid.uuid4().hex
63
64
65class BuildQueue(Protocol):
66    durable: bool
67
68    def push(self, job_id: str) -> None: ...
69    def reserve(self, owner: str, lease_seconds: int = ...) -> str | None: ...
70    def renew(self, job_id: str, owner: str, lease_seconds: int = ...) -> bool: ...
71    def ack(self, job_id: str) -> None: ...
72    def requeue_expired(self, now: float | None = ...) -> list[str]: ...
73    def depth(self) -> int: ...
74
75
76class InMemoryBuildQueue:
77    """A queue for a single-process deployment.
78
79    Durability is not on offer and the attribute says so: the queue dies with
80    the process that holds it, so a restart loses whatever was pending. It
81    implements the same leases anyway, because a build thread can die without
82    its process dying, and because one code path through the worker is worth
83    more than the few lines this saves.
84    """
85
86    durable = False
87
88    def __init__(self) -> None:
89        self._pending: deque[str] = deque()
90        self._leases: dict[str, tuple[str, float]] = {}
91        self._lock = threading.Lock()
92
93    def push(self, job_id: str) -> None:
94        with self._lock:
95            self._pending.append(job_id)
96
97    def reserve(self, owner: str, lease_seconds: int = DEFAULT_LEASE_SECONDS) -> str | None:
98        with self._lock:
99            if not self._pending:
100                return None
101            job_id = self._pending.popleft()
102            self._leases[job_id] = (owner, time.time() + lease_seconds)
103            return job_id
104
105    def renew(
106        self, job_id: str, owner: str, lease_seconds: int = DEFAULT_LEASE_SECONDS
107    ) -> bool:
108        with self._lock:
109            held = self._leases.get(job_id)
110            if held is None or held[0] != owner:
111                return False
112            self._leases[job_id] = (owner, time.time() + lease_seconds)
113            return True
114
115    def ack(self, job_id: str) -> None:
116        with self._lock:
117            self._leases.pop(job_id, None)
118
119    def requeue_expired(self, now: float | None = None) -> list[str]:
120        moment = time.time() if now is None else now
121        with self._lock:
122            lapsed = [j for j, (_, exp) in self._leases.items() if exp <= moment]
123            for job_id in lapsed:
124                del self._leases[job_id]
125                self._pending.append(job_id)
126            return lapsed
127
128    def depth(self) -> int:
129        with self._lock:
130            return len(self._pending)
131
132
133class RedisBuildQueue:
134    """A queue shared by workers that do not share a process.
135
136    The three keys are a pending list, an inflight list, and one lease key per
137    reserved job. Nothing here needs compare-and-set on the job itself: the
138    inflight list records *that* a job was taken and the lease records *who* has
139    it and *until when*, which is the whole of what recovery needs to know.
140    """
141
142    durable = True
143
144    def __init__(
145        self,
146        client: Any,
147        prefix: str = "build:queue:",
148        job_ttl: int = 7 * 24 * 3600,
149    ) -> None:
150        self._redis = client
151        self._pending = f"{prefix}pending"
152        self._inflight = f"{prefix}inflight"
153        self._lease_prefix = f"{prefix}lease:"
154        # Matches the job store's retention. A lease key outliving every trace
155        # of its job would pin an id in `inflight` that can never be requeued.
156        self._job_ttl = job_ttl
157
158    def _lease_key(self, job_id: str) -> str:
159        return f"{self._lease_prefix}{job_id}"
160
161    def push(self, job_id: str) -> None:
162        self._redis.lpush(self._pending, job_id)
163
164    def reserve(self, owner: str, lease_seconds: int = DEFAULT_LEASE_SECONDS) -> str | None:
165        # RIGHT/LEFT with LPUSH above makes this FIFO: the oldest paid build is
166        # the one waiting longest, and it should not be starved by newer ones.
167        job_id = self._redis.lmove(self._pending, self._inflight, "RIGHT", "LEFT")
168        if job_id is None:
169            return None
170        # A crash between the move and this write leaves an inflight job with no
171        # lease, which `requeue_expired` reads as expired and puts back. The
172        # unsafe ordering would be the reverse — lease first, then move — where
173        # the same crash strands the id in `pending` with a live lease on it.
174        self._redis.set(self._lease_key(job_id), owner, ex=lease_seconds)
175        return job_id
176
177    def renew(
178        self, job_id: str, owner: str, lease_seconds: int = DEFAULT_LEASE_SECONDS
179    ) -> bool:
180        """Extend our lease, and report whether it was still ours to extend.
181
182        Read-then-write rather than one atomic compare-and-expire, because the
183        atomic form is a Lua script and this store is proved against `fakeredis`,
184        which has no Lua. The check that matters — has somebody else taken this
185        job? — is exact: a takeover writes a different owner and the read sees
186        it. The residual race is our EXPIRE landing microseconds after the lease
187        we just read lapsed and was re-taken, which extends the *new* holder's
188        lease rather than resurrecting ours. Harmless, and strictly rarer than
189        the partition case this exists to catch.
190        """
191        try:
192            held = self._redis.get(self._lease_key(job_id))
193        except Exception:  # noqa: BLE001 - an unreachable store is a lost lease
194            log.exception("could not read lease for %s", job_id)
195            return False
196        if held != owner:
197            return False
198        return bool(self._redis.expire(self._lease_key(job_id), lease_seconds))
199
200    def ack(self, job_id: str) -> None:
201        """Finished with this job — drop it from inflight and release the lease."""
202        self._redis.lrem(self._inflight, 0, job_id)
203        self._redis.delete(self._lease_key(job_id))
204
205    def requeue_expired(self, now: float | None = None) -> list[str]:
206        """Return abandoned jobs to `pending`. Safe to run from every worker.
207
208        `LREM` reports how many entries it removed, and that is what decides the
209        race: several workers may see the same expired lease, but only the one
210        whose LREM returns non-zero pushes the id back. Without that check the
211        job would be requeued once per reaper and built that many times.
212        """
213        requeued: list[str] = []
214        for job_id in self._redis.lrange(self._inflight, 0, -1):
215            if self._redis.exists(self._lease_key(job_id)):
216                continue
217            if self._redis.lrem(self._inflight, 1, job_id):
218                self._redis.lpush(self._pending, job_id)
219                requeued.append(job_id)
220        return requeued
221
222    def depth(self) -> int:
223        return int(self._redis.llen(self._pending))

src/service/ratelimit.py

1"""Bounding how often one caller can ask for a build.
2
3The x402 gate stops anyone getting a *free* build, so the thing worth protecting
4against is not theft. It is the cost of refusing: `POST /builds` with a payment
5header makes the service call the facilitator's `/verify` and then `/settle`,
6network round trips with a 60-second timeout, from a synchronous endpoint. A few
7hundred concurrent requests carrying junk authorizations exhaust the thread pool
8and the service stops answering anyone — including the buyers who did pay.
9
10So the limit is on the accepting endpoint only. Polling a running build and
11downloading an APK are cheap and legitimately frequent: a buyer waiting on a
12minutes-long build polls every few seconds, and rate-limiting that would punish
13exactly the correct behaviour.
14
15**Identifying the caller is the part that goes wrong quietly.** Behind the TLS
16proxy every request arrives from Caddy's address on the compose network, so
17keying on the socket peer would put every buyer in the world into one bucket —
18the limiter would look like it was working while either blocking everyone or
19nobody. The client is the *rightmost* entry in `X-Forwarded-For`, because Caddy
20appends the peer it actually saw to whatever the client sent. Reading the
21leftmost, which is the more common convention, would let a caller send their own
22header and mint a fresh identity per request.
23
24Redis-backed when `REDIS_URL` is set, so the limit holds across processes; in
25memory otherwise. Unlike the nonce store this *does* fall back rather than
26refuse, because a rate limit is a mitigation and not a correctness invariant —
27losing it degrades a defence, while losing replay protection would let a
28signature buy two builds.
29"""
30
31from __future__ import annotations
32
33import logging
34import threading
35import time
36from dataclasses import dataclass, field
37
38log = logging.getLogger(__name__)
39
40
41def client_identity(forwarded_for: str | None, peer: str | None) -> str:
42    """Who to charge this request to.
43
44    The rightmost `X-Forwarded-For` entry is the address our own proxy observed;
45    everything to its left was supplied by the caller and is therefore a claim
46    rather than a fact.
47    """
48    if forwarded_for:
49        hops = [hop.strip() for hop in forwarded_for.split(",") if hop.strip()]
50        if hops:
51            return hops[-1]
52    return peer or "unknown"
53
54
55@dataclass
56class _Window:
57    count: int = 0
58    resets_at: float = 0.0
59
60
61@dataclass
62class RateLimiter:
63    """A fixed window per caller. Returns seconds to wait, or None to allow.
64
65    A fixed window rather than a sliding one on purpose: it is one INCR against
66    Redis, it needs no stored history per caller, and its worst case — twice the
67    limit across a window boundary — is irrelevant at the magnitudes that matter
68    here, where the point is stopping hundreds of requests a second.
69    """
70
71    limit: int
72    window_seconds: int = 60
73    redis: object | None = None
74    # Namespaces the Redis key. Two limiters guarding different things — paid
75    # builds and free previews — must not share a bucket, or the cheap one
76    # exhausts the expensive one's allowance.
77    name: str = "builds"
78    _local: dict[str, _Window] = field(default_factory=dict)
79    _lock: threading.Lock = field(default_factory=threading.Lock)
80
81    @property
82    def enabled(self) -> bool:
83        return self.limit > 0
84
85    def check(self, identity: str, now: float | None = None) -> int | None:
86        """None if the request may proceed, else seconds until it could."""
87        if not self.enabled:
88            return None
89        now = time.time() if now is None else now
90        if self.redis is not None:
91            try:
92                return self._check_redis(identity, now)
93            except Exception:  # noqa: BLE001
94                # A Redis outage must not take the API down with it. Payment
95                # verification already refuses when Redis is unreachable, which
96                # is the failure that matters; degrading to a per-process limit
97                # here keeps the service answering.
98                log.warning("rate limiter falling back to in-memory", exc_info=True)
99        return self._check_local(identity, now)
100
101    def _check_redis(self, identity: str, now: float) -> int | None:
102        bucket = int(now // self.window_seconds)
103        key = f"ratelimit:{self.name}:{identity}:{bucket}"
104        pipe = self.redis.pipeline()
105        pipe.incr(key)
106        # Set on every request rather than only the first: an INCR that raced
107        # with an expiry would otherwise leave a key with no TTL, and that
108        # caller would be blocked until the key was evicted.
109        pipe.expire(key, self.window_seconds + 1)
110        count = pipe.execute()[0]
111        if count > self.limit:
112            return max(1, int((bucket + 1) * self.window_seconds - now))
113        return None
114
115    def _check_local(self, identity: str, now: float) -> int | None:
116        with self._lock:
117            window = self._local.get(identity)
118            if window is None or now >= window.resets_at:
119                window = _Window(count=0, resets_at=now + self.window_seconds)
120                self._local[identity] = window
121            window.count += 1
122            if window.count > self.limit:
123                return max(1, int(window.resets_at - now))
124
125            # Opportunistic sweep. Without it the dict is an unbounded map of
126            # every address that has ever called, which is a slow memory leak
127            # on a public endpoint.
128            if len(self._local) > 10_000:
129                for key in [k for k, v in self._local.items() if now >= v.resets_at]:
130                    del self._local[key]
131        return None

src/service/worker.py

1"""Pull-based build workers.
2
3    poetry run python -m src.service.worker
4
5A worker reserves a job from the queue, runs it, and keeps its lease alive
6throughout so the rest of the fleet can tell it is still there. Kill it and its
7lease lapses; another worker requeues the build and runs it from the PRD stored
8on the job record. That is the whole of durable execution, and it is why the PRD
9had to stop living in a closure inside the accepting process.
10
11This module knows nothing about PRDs, LangGraph or Gradle. It is handed a
12`work_factory` that turns a job into the callable that builds it, which keeps
13the interesting part — leases, retries, what happens when a build dies halfway —
14testable without a Flutter toolchain or a model key. `app.py` supplies what a
15build actually is.
16
17Three things a first version gets wrong, so they are stated rather than left to
18be rediscovered:
19
20**A build must never be retried for ever.** Requeueing an abandoned job is the
21point of all this, but a build that kills its worker — OOM, a Gradle segfault, a
22PRD that finds a pathological path through the graph — gets requeued, kills the
23next worker, and takes the fleet down one process at a time. `attempts` is
24counted on the job, so it survives the worker that incremented it, and a job
25past `max_attempts` is failed rather than handed to another victim.
26
27**Losing the lease means standing down, not finishing.** A worker stalled longer
28than its lease has already had its job given away. It cannot un-give it, and
29writing its results would clobber whatever the new holder is doing, so it
30discards them. The build it ran is wasted work; the alternative is two workers
31disagreeing about what the buyer bought.
32
33**The heartbeat runs while the build does.** The lease is renewed from a loop
34that outlives no single step of the build, because the steps are the slow part:
35a model call and a Gradle download can each take minutes, and a lease that only
36gets renewed between them would lapse mid-build and hand a perfectly healthy
37job to somebody else.
38"""
39
40from __future__ import annotations
41
42import logging
43import os
44import signal
45import threading
46import time
47from datetime import datetime, timezone
48from typing import Callable
49
50from src.service.jobs import BuildJob, BuildStatus, JobStore
51from src.service.queue import (
52    DEFAULT_LEASE_SECONDS,
53    BuildQueue,
54    new_owner_id,
55)
56
57log = logging.getLogger(__name__)
58
59# Renewed well inside the lease, so one missed round trip is not a lost job.
60DEFAULT_HEARTBEAT_SECONDS = 30
61
62# Two retries after the first attempt. Enough to survive a deploy restarting a
63# worker mid-build, few enough that a build which reliably kills workers stops
64# being everybody's problem quickly.
65DEFAULT_MAX_ATTEMPTS = 3
66
67WorkFactory = Callable[[BuildJob], Callable[[BuildJob], None]]
68
69
70class BuildWorker:
71    """Reserves one job at a time and runs it to a terminal state."""
72
73    def __init__(
74        self,
75        store: JobStore,
76        queue: BuildQueue,
77        work_factory: WorkFactory,
78        *,
79        owner: str | None = None,
80        lease_seconds: int = DEFAULT_LEASE_SECONDS,
81        heartbeat_seconds: int = DEFAULT_HEARTBEAT_SECONDS,
82        max_attempts: int = DEFAULT_MAX_ATTEMPTS,
83        poll_seconds: float = 0.25,
84        recover_every: float = 5.0,
85    ) -> None:
86        self.store = store
87        self.queue = queue
88        self.work_factory = work_factory
89        self.owner = owner or new_owner_id()
90        self.lease_seconds = lease_seconds
91        self.heartbeat_seconds = heartbeat_seconds
92        self.max_attempts = max_attempts
93        self.poll_seconds = poll_seconds
94        # An idle worker polls several times a second; scanning for corpses that
95        # often is pure Redis traffic, since a lease takes minutes to lapse.
96        self.recover_every = recover_every
97        self._recovered_at = 0.0
98        self._stop = threading.Event()
99
100    # -- one turn of the loop ------------------------------------------------ #
101
102    def run_once(self) -> bool:
103        """Recover abandoned jobs, then run at most one. True if it ran one."""
104        now = time.monotonic()
105        if now - self._recovered_at >= self.recover_every:
106            self._recovered_at = now
107            self.recover_abandoned()
108        job_id = self.queue.reserve(self.owner, self.lease_seconds)
109        if job_id is None:
110            return False
111
112        job = self.store.get(job_id)
113        if job is None:
114            # The record expired or was never written. Nothing to build and
115            # nothing to report — drop the id rather than requeue it for ever.
116            log.warning("queued job %s has no record; dropping it", job_id)
117            self.queue.ack(job_id)
118            return True
119
120        if job.status in {BuildStatus.SUCCEEDED, BuildStatus.FAILED}:
121            # Already finished — a duplicate queue entry, or a job reaped while
122            # it sat in the queue. Re-running it would overwrite a result the
123            # buyer may already have downloaded.
124            self.queue.ack(job_id)
125            return True
126
127        job.attempts += 1
128        if job.attempts > self.max_attempts:
129            self._give_up(job)
130            self.queue.ack(job_id)
131            return True
132
133        job.status = BuildStatus.RUNNING
134        job.heartbeat_at = datetime.now(timezone.utc)
135        self.store.save(job)
136
137        if self._execute(job):
138            self.queue.ack(job_id)
139        return True
140
141    def recover_abandoned(self) -> list[str]:
142        """Requeue jobs whose worker stopped renewing, and say so on the record.
143
144        The queue moves the ids; the job records have to be told, or a requeued
145        build would sit at `running` with a stale heartbeat and be failed by
146        `reap_stale` while it waits its turn.
147        """
148        requeued = self.queue.requeue_expired()
149        for job_id in requeued:
150            job = self.store.get(job_id)
151            if job is None:
152                continue
153            job.status = BuildStatus.QUEUED
154            job.heartbeat_at = datetime.now(timezone.utc)
155            job.log.append(
156                f"attempt {job.attempts} was abandoned by its worker; requeued"
157            )
158            self.store.save(job)
159            log.warning("requeued abandoned build %s", job_id)
160        return requeued
161
162    # -- running one build --------------------------------------------------- #
163
164    def _execute(self, job: BuildJob) -> bool:
165        """Run the build, heartbeating throughout. False if the lease was lost.
166
167        The build runs on its own thread so this one can renew the lease while
168        it works. It cannot be cancelled — it is shelling out to Gradle — so
169        losing the lease means abandoning the *result*, not the process.
170        """
171        def run() -> None:
172            try:
173                # Built inside the thread so that a job the factory refuses —
174                # an unreadable PRD, an unpaid record — fails with that reason
175                # rather than escaping the loop and being retried three times.
176                self.work_factory(job)(job)
177                if job.status is BuildStatus.RUNNING:
178                    job.status = BuildStatus.FAILED
179                    job.failure = "build finished without reporting an outcome"
180            except Exception as exc:  # never leave a job wedged in RUNNING
181                log.exception("build %s failed", job.id)
182                job.status = BuildStatus.FAILED
183                job.failure = f"{type(exc).__name__}: {exc}"
184
185        thread = threading.Thread(target=run, name=f"build-{job.id}", daemon=True)
186        thread.start()
187
188        while True:
189            thread.join(self.heartbeat_seconds)
190            if not thread.is_alive():
191                break
192            if not self.queue.renew(job.id, self.owner, self.lease_seconds):
193                log.error(
194                    "lost the lease on build %s while running it; another worker "
195                    "has taken it. Discarding this attempt's result.", job.id
196                )
197                return False
198            job.heartbeat_at = datetime.now(timezone.utc)
199            self.store.save(job)
200
201        # Check once more before writing: the build may have finished during a
202        # stall long enough for the job to have been handed to someone else.
203        if not self.queue.renew(job.id, self.owner, self.lease_seconds):
204            log.error("build %s finished but its lease was gone; result discarded", job.id)
205            return False
206
207        # Usually already set: the closure that decides success or failure sets
208        # it itself, in the same breath as the terminal status, so that the two
209        # become visible together to anyone reading the job mid-flight. This is
210        # the backstop for the paths that never reach that closure's own
211        # assignment — an exception raised out of it, or a build that returns
212        # without setting a terminal status at all.
213        if job.finished_at is None:
214            job.finished_at = datetime.now(timezone.utc)
215        job.heartbeat_at = job.finished_at
216        self.store.save(job)
217        return True
218
219    def _give_up(self, job: BuildJob) -> None:
220        """Fail a build that has exhausted its attempts, permanently."""
221        job.status = BuildStatus.FAILED
222        job.failure = (
223            f"build was abandoned {job.attempts - 1} times and has exhausted its "
224            f"{self.max_attempts} attempts. A build that repeatedly kills its "
225            "worker is not retried further."
226        )
227        job.finished_at = datetime.now(timezone.utc)
228        job.heartbeat_at = job.finished_at
229        self.store.save(job)
230        log.error("giving up on build %s after %d attempts", job.id, job.attempts - 1)
231
232    # -- lifecycle ----------------------------------------------------------- #
233
234    def run_forever(self) -> None:
235        while not self._stop.is_set():
236            try:
237                did_work = self.run_once()
238            except Exception:  # noqa: BLE001 - a bad job must not kill the loop
239                log.exception("worker loop raised; continuing")
240                did_work = False
241            if not did_work:
242                self._stop.wait(self.poll_seconds)
243
244    def start(self) -> threading.Thread:
245        """Run the loop on a background thread, for an API process that also builds."""
246        thread = threading.Thread(target=self.run_forever, name="build-worker", daemon=True)
247        thread.start()
248        return thread
249
250    def stop(self) -> None:
251        self._stop.set()
252
253
254def main() -> None:
255    """A standalone worker: no HTTP surface, just builds.
256
257    Imports `app` here rather than at module scope so the API process can import
258    this module without importing itself. The wiring is deliberately the same
259    one the API uses — a worker that assembled its own generator or analyzer
260    would drift from the service it is supposed to be doing the work for.
261    """
262    # Importing that module runs `app = create_app()`, which starts an embedded
263    # worker unless told otherwise. Without this a standalone worker process
264    # would quietly run two of them, at twice the intended concurrency, and
265    # BUILD_WORKER_EMBEDDED would control the API process but not this one.
266    os.environ["BUILD_WORKER_EMBEDDED"] = "0"
267
268    from src.service.app import build_worker_for_environment
269
270    logging.basicConfig(
271        level=os.getenv("LOG_LEVEL", "INFO"),
272        format="%(asctime)s %(levelname)s %(name)s %(message)s",
273    )
274    worker = build_worker_for_environment()
275    if not worker.queue.durable:
276        log.warning(
277            "REDIS_URL is not set, so this worker has its own private in-memory "
278            "queue and will never see a job the API process accepted."
279        )
280
281    # A deploy sends SIGTERM. Finishing the current build would be better still,
282    # but the lease already covers the abrupt case: stop taking new work, and
283    # let whatever is in flight be requeued if we are killed before it lands.
284    signal.signal(signal.SIGTERM, lambda *_: worker.stop())
285    log.info("worker %s waiting for builds", worker.owner)
286    try:
287        worker.run_forever()
288    except KeyboardInterrupt:
289        worker.stop()
290
291
292if __name__ == "__main__":
293    main()