refactor: OpenAPI codegen with utoipa and Orval

Cargo.lock

@@ -216,28 +216,6 @@ dependencies = [
  "stable_deref_trait",
 ]
 
-[[package]]
-name = "async-stream"
-version = "0.3.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b5a71a6f37880a80d1d7f19efd781e4b5de42c88f0722cc13bcb6cc2cfe8476"
-dependencies = [
- "async-stream-impl",
- "futures-core",
- "pin-project-lite",
-]
-
-[[package]]
-name = "async-stream-impl"
-version = "0.3.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7c24de15d275a1ecfd47a380fb4d5ec9bfe0933f309ed5e705b775596a3574d"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.117",
-]
-
 [[package]]
 name = "async-trait"
 version = "0.1.89"
@@ -3996,7 +3974,7 @@ dependencies = [
  "serde_json",
  "strum",
  "tokio",
- "ts-rs",
+ "utoipa",
  "uuid",
 ]
 
@@ -4114,10 +4092,8 @@ name = "koharu-rpc"
 version = "0.41.4"
 dependencies = [
  "anyhow",
- "async-stream",
  "axum",
  "base64 0.22.1",
- "futures",
  "image",
  "imageproc",
  "koharu-app",
@@ -4128,10 +4104,13 @@ dependencies = [
  "rmp-serde",
  "rmpv",
  "serde",
+ "serde_bytes",
  "serde_json",
  "tokio",
  "tower-http",
  "tracing",
+ "utoipa",
+ "utoipa-axum",
 ]
 
 [[package]]
@@ -7828,15 +7807,6 @@ dependencies = [
  "utf-8",
 ]
 
-[[package]]
-name = "termcolor"
-version = "1.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
-dependencies = [
- "winapi-util",
-]
-
 [[package]]
 name = "thiserror"
 version = "1.0.69"
@@ -8376,29 +8346,6 @@ version = "0.2.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
 
-[[package]]
-name = "ts-rs"
-version = "12.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "756050066659291d47a554a9f558125db17428b073c5ffce1daf5dcb0f7231d8"
-dependencies = [
- "serde_json",
- "thiserror 2.0.18",
- "ts-rs-macros",
-]
-
-[[package]]
-name = "ts-rs-macros"
-version = "12.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "38d90eea51bc7988ef9e674bf80a85ba6804739e535e9cab48e4bb34a8b652aa"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.117",
- "termcolor",
-]
-
 [[package]]
 name = "ttf-parser"
 version = "0.21.1"
@@ -8678,6 +8625,43 @@ version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
 
+[[package]]
+name = "utoipa"
+version = "5.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fcc29c80c21c31608227e0912b2d7fddba57ad76b606890627ba8ee7964e993"
+dependencies = [
+ "indexmap 2.13.0",
+ "serde",
+ "serde_json",
+ "utoipa-gen",
+]
+
+[[package]]
+name = "utoipa-axum"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c25bae5bccc842449ec0c5ddc5cbb6a3a1eaeac4503895dc105a1138f8234a0"
+dependencies = [
+ "axum",
+ "paste",
+ "tower-layer",
+ "tower-service",
+ "utoipa",
+]
+
+[[package]]
+name = "utoipa-gen"
+version = "5.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d79d08d92ab8af4c5e8a6da20c47ae3f61a0f1dabc1997cdf2d082b757ca08b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "regex",
+ "syn 2.0.117",
+]
+
 [[package]]
 name = "uuid"
 version = "1.23.0"

Cargo.toml

@@ -126,7 +126,8 @@ rmcp = { version = "0.16", features = [
     "transport-streamable-http-server",
 ] }
 schemars = "1.2"
-ts-rs = { version = "12.0", features = ["serde-json-impl"] }
+utoipa = { version = "5", features = ["axum_extras"] }
+utoipa-axum = "0.2"
 uuid = { version = "1.18", features = ["v4", "serde"] }
 base64 = "0.22"
 tower-http = { version = "0.6", features = ["cors"] }

bun.lock

@@ -29,23 +29,22 @@
         "@radix-ui/react-switch": "^1.2.6",
         "@radix-ui/react-tabs": "^1.1.13",
         "@radix-ui/react-tooltip": "^1.2.8",
-        "@tanstack/query-sync-storage-persister": "^5.96.1",
         "@tanstack/react-query": "^5.96.1",
-        "@tanstack/react-query-persist-client": "^5.96.1",
         "@tanstack/react-virtual": "^3.13.23",
         "@tauri-apps/api": "^2.10.1",
         "@use-gesture/react": "^10.3.1",
+        "@xstate/react": "^6.1.0",
         "browser-fs-access": "^0.38.0",
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
         "i18next": "^25.10.10",
         "i18next-browser-languagedetector": "^8.2.1",
         "i18next-localstorage-backend": "^4.3.1",
+        "immer": "^11.1.4",
         "lucide-react": "^0.577.0",
         "motion": "^12.38.0",
         "next": "^16.2.2",
         "next-themes": "^0.4.6",
-        "p-queue": "^9.1.1",
         "react": "^19.2.4",
         "react-colorful": "^5.6.1",
         "react-dom": "^19.2.4",
@@ -57,6 +56,7 @@
         "react-rnd": "^10.5.3",
         "remark-gfm": "^4.0.1",
         "tailwind-merge": "^3.5.0",
+        "xstate": "^5.30.0",
         "zod": "^4.3.6",
         "zustand": "^5.0.12",
       },
@@ -66,6 +66,7 @@
         "@types/react": "^19.2.14",
         "@types/react-dom": "^19.2.3",
         "babel-plugin-react-compiler": "^1.0.0",
+        "orval": "^8.6.2",
         "tailwindcss": "^4.2.2",
         "tw-animate-css": "^1.4.0",
         "typescript": "^6.0.2",
@@ -83,8 +84,62 @@
 
     "@babel/types": ["@babel/types@7.28.5", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA=="],
 
+    "@commander-js/extra-typings": ["@commander-js/extra-typings@14.0.0", "", { "peerDependencies": { "commander": "~14.0.0" } }, "sha512-hIn0ncNaJRLkZrxBIp5AsW/eXEHNKYQBh0aPdoUqNgD+Io3NIykQqpKFyKcuasZhicGaEZJX/JBSIkZ4e5x8Dg=="],
+
     "@emnapi/runtime": ["@emnapi/runtime@1.8.1", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg=="],
 
+    "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.27.5", "", { "os": "aix", "cpu": "ppc64" }, "sha512-nGsF/4C7uzUj+Nj/4J+Zt0bYQ6bz33Phz8Lb2N80Mti1HjGclTJdXZ+9APC4kLvONbjxN1zfvYNd8FEcbBK/MQ=="],
+
+    "@esbuild/android-arm": ["@esbuild/android-arm@0.27.5", "", { "os": "android", "cpu": "arm" }, "sha512-Cv781jd0Rfj/paoNrul1/r4G0HLvuFKYh7C9uHZ2Pl8YXstzvCyyeWENTFR9qFnRzNMCjXmsulZuvosDg10Mog=="],
+
+    "@esbuild/android-arm64": ["@esbuild/android-arm64@0.27.5", "", { "os": "android", "cpu": "arm64" }, "sha512-Oeghq+XFgh1pUGd1YKs4DDoxzxkoUkvko+T/IVKwlghKLvvjbGFB3ek8VEDBmNvqhwuL0CQS3cExdzpmUyIrgA=="],
+
+    "@esbuild/android-x64": ["@esbuild/android-x64@0.27.5", "", { "os": "android", "cpu": "x64" }, "sha512-nQD7lspbzerlmtNOxYMFAGmhxgzn8Z7m9jgFkh6kpkjsAhZee1w8tJW3ZlW+N9iRePz0oPUDrYrXidCPSImD0Q=="],
+
+    "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.27.5", "", { "os": "darwin", "cpu": "arm64" }, "sha512-I+Ya/MgC6rr8oRWGRDF3BXDfP8K1BVUggHqN6VI2lUZLdDi1IM1v2cy0e3lCPbP+pVcK3Tv8cgUhHse1kaNZZw=="],
+
+    "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.27.5", "", { "os": "darwin", "cpu": "x64" }, "sha512-MCjQUtC8wWJn/pIPM7vQaO69BFgwPD1jriEdqwTCKzWjGgkMbcg+M5HzrOhPhuYe1AJjXlHmD142KQf+jnYj8A=="],
+
+    "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.27.5", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-X6xVS+goSH0UelYXnuf4GHLwpOdc8rgK/zai+dKzBMnncw7BTQIwquOodE7EKvY2UVUetSqyAfyZC1D+oqLQtg=="],
+
+    "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.27.5", "", { "os": "freebsd", "cpu": "x64" }, "sha512-233X1FGo3a8x1ekLB6XT69LfZ83vqz+9z3TSEQCTYfMNY880A97nr81KbPcAMl9rmOFp11wO0dP+eB18KU/Ucg=="],
+
+    "@esbuild/linux-arm": ["@esbuild/linux-arm@0.27.5", "", { "os": "linux", "cpu": "arm" }, "sha512-0wkVrYHG4sdCCN/bcwQ7yYMXACkaHc3UFeaEOwSVW6e5RycMageYAFv+JS2bKLwHyeKVUvtoVH+5/RHq0fgeFw=="],
+
+    "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.27.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-euKkilsNOv7x/M1NKsx5znyprbpsRFIzTV6lWziqJch7yWYayfLtZzDxDTl+LSQDJYAjd9TVb/Kt5UKIrj2e4A=="],
+
+    "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.27.5", "", { "os": "linux", "cpu": "ia32" }, "sha512-hVRQX4+P3MS36NxOy24v/Cdsimy/5HYePw+tmPqnNN1fxV0bPrFWR6TMqwXPwoTM2VzbkA+4lbHWUKDd5ZDA/w=="],
+
+    "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.27.5", "", { "os": "linux", "cpu": "none" }, "sha512-mKqqRuOPALI8nDzhOBmIS0INvZOOFGGg5n1osGIXAx8oersceEbKd4t1ACNTHM3sJBXGFAlEgqM+svzjPot+ZQ=="],
+
+    "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.27.5", "", { "os": "linux", "cpu": "none" }, "sha512-EE/QXH9IyaAj1qeuIV5+/GZkBTipgGO782Ff7Um3vPS9cvLhJJeATy4Ggxikz2inZ46KByamMn6GqtqyVjhenA=="],
+
+    "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.27.5", "", { "os": "linux", "cpu": "ppc64" }, "sha512-0V2iF1RGxBf1b7/BjurA5jfkl7PtySjom1r6xOK2q9KWw/XCpAdtB6KNMO+9xx69yYfSCRR9FE0TyKfHA2eQMw=="],
+
+    "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.27.5", "", { "os": "linux", "cpu": "none" }, "sha512-rYxThBx6G9HN6tFNuvB/vykeLi4VDsm5hE5pVwzqbAjZEARQrWu3noZSfbEnPZ/CRXP3271GyFk/49up2W190g=="],
+
+    "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.27.5", "", { "os": "linux", "cpu": "s390x" }, "sha512-uEP2q/4qgd8goEUc4QIdU/1P2NmEtZ/zX5u3OpLlCGhJIuBIv0s0wr7TB2nBrd3/A5XIdEkkS5ZLF0ULuvaaYQ=="],
+
+    "@esbuild/linux-x64": ["@esbuild/linux-x64@0.27.5", "", { "os": "linux", "cpu": "x64" }, "sha512-+Gq47Wqq6PLOOZuBzVSII2//9yyHNKZLuwfzCemqexqOQCSz0zy0O26kIzyp9EMNMK+nZ0tFHBZrCeVUuMs/ew=="],
+
+    "@esbuild/netbsd-arm64": ["@esbuild/netbsd-arm64@0.27.5", "", { "os": "none", "cpu": "arm64" }, "sha512-3F/5EG8VHfN/I+W5cO1/SV2H9Q/5r7vcHabMnBqhHK2lTWOh3F8vixNzo8lqxrlmBtZVFpW8pmITHnq54+Tq4g=="],
+
+    "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.27.5", "", { "os": "none", "cpu": "x64" }, "sha512-28t+Sj3CPN8vkMOlZotOmDgilQwVvxWZl7b8rxpn73Tt/gCnvrHxQUMng4uu3itdFvrtba/1nHejvxqz8xgEMA=="],
+
+    "@esbuild/openbsd-arm64": ["@esbuild/openbsd-arm64@0.27.5", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-Doz/hKtiuVAi9hMsBMpwBANhIZc8l238U2Onko3t2xUp8xtM0ZKdDYHMnm/qPFVthY8KtxkXaocwmMh6VolzMA=="],
+
+    "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.27.5", "", { "os": "openbsd", "cpu": "x64" }, "sha512-WfGVaa1oz5A7+ZFPkERIbIhKT4olvGl1tyzTRaB5yoZRLqC0KwaO95FeZtOdQj/oKkjW57KcVF944m62/0GYtA=="],
+
+    "@esbuild/openharmony-arm64": ["@esbuild/openharmony-arm64@0.27.5", "", { "os": "none", "cpu": "arm64" }, "sha512-Xh+VRuh6OMh3uJ0JkCjI57l+DVe7VRGBYymen8rFPnTVgATBwA6nmToxM2OwTlSvrnWpPKkrQUj93+K9huYC6A=="],
+
+    "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.27.5", "", { "os": "sunos", "cpu": "x64" }, "sha512-aC1gpJkkaUADHuAdQfuVTnqVUTLqqUNhAvEwHwVWcnVVZvNlDPGA0UveZsfXJJ9T6k9Po4eHi3c02gbdwO3g6w=="],
+
+    "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.27.5", "", { "os": "win32", "cpu": "arm64" }, "sha512-0UNx2aavV0fk6UpZcwXFLztA2r/k9jTUa7OW7SAea1VYUhkug99MW1uZeXEnPn5+cHOd0n8myQay6TlFnBR07w=="],
+
+    "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.27.5", "", { "os": "win32", "cpu": "ia32" }, "sha512-5nlJ3AeJWCTSzR7AEqVjT/faWyqKU86kCi1lLmxVqmNR+j4HrYdns+eTGjS/vmrzCIe8inGQckUadvS0+JkKdQ=="],
+
+    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.27.5", "", { "os": "win32", "cpu": "x64" }, "sha512-PWypQR+d4FLfkhBIV+/kHsUELAnMpx1bRvvsn3p+/sAERbnCzFrtDRG2Xw5n+2zPxBK2+iaP+vetsRl4Ti7WgA=="],
+
     "@floating-ui/core": ["@floating-ui/core@1.7.3", "", { "dependencies": { "@floating-ui/utils": "^0.2.10" } }, "sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w=="],
 
     "@floating-ui/dom": ["@floating-ui/dom@1.7.4", "", { "dependencies": { "@floating-ui/core": "^1.7.3", "@floating-ui/utils": "^0.2.10" } }, "sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA=="],
@@ -93,6 +148,8 @@
 
     "@floating-ui/utils": ["@floating-ui/utils@0.2.10", "", {}, "sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ=="],
 
+    "@gerrit0/mini-shiki": ["@gerrit0/mini-shiki@3.23.0", "", { "dependencies": { "@shikijs/engine-oniguruma": "^3.23.0", "@shikijs/langs": "^3.23.0", "@shikijs/themes": "^3.23.0", "@shikijs/types": "^3.23.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-bEMORlG0cqdjVyCEuU0cDQbORWX+kYCeo0kV1lbxF5bt4r7SID2l9bqsxJEM0zndaxpOUT7riCyIVEuqq/Ynxg=="],
+
     "@img/colour": ["@img/colour@1.0.0", "", {}, "sha512-A5P/LfWGFSl6nsckYtjw9da+19jB8hkJ6ACTGcDfEJ0aE+l2n2El7dsVM7UVHZQ9s2lmYMWlrS21YLy2IR1LUw=="],
 
     "@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.34.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.2.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w=="],
@@ -173,6 +230,34 @@
 
     "@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@16.2.2", "", { "os": "win32", "cpu": "x64" }, "sha512-aHaKceJgdySReT7qeck5oShucxWRiiEuwCGK8HHALe6yZga8uyFpLkPgaRw3kkF04U7ROogL/suYCNt/+CuXGA=="],
 
+    "@nodelib/fs.scandir": ["@nodelib/fs.scandir@2.1.5", "", { "dependencies": { "@nodelib/fs.stat": "2.0.5", "run-parallel": "^1.1.9" } }, "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g=="],
+
+    "@nodelib/fs.stat": ["@nodelib/fs.stat@2.0.5", "", {}, "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A=="],
+
+    "@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg=="],
+
+    "@orval/angular": ["@orval/angular@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2" } }, "sha512-XNTYgfbsjnyGWG12jKkC5URFILTRUASOizypqDLKJWxA3ZEJ6/Dwnuz4wgdiTxb8Ltv1IyuJABkkxk2OM8eCMg=="],
+
+    "@orval/axios": ["@orval/axios@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2" } }, "sha512-76xSbiwqbYNbM1pasbPv2fSo2Dmwe879HnAWi406GSHAmwlDu5qCN+E53vsvceidUWWuMjh/JuEWgptx/tPGBQ=="],
+
+    "@orval/core": ["@orval/core@8.6.2", "", { "dependencies": { "@scalar/openapi-types": "0.5.3", "acorn": "^8.15.0", "compare-versions": "^6.1.1", "debug": "^4.4.3", "esbuild": "^0.27.3", "esutils": "2.0.3", "fs-extra": "^11.3.2", "globby": "16.1.0", "jiti": "^2.6.1", "remeda": "^2.33.6", "typedoc": "^0.28.17" }, "peerDependencies": { "@faker-js/faker": ">=10" }, "optionalPeers": ["@faker-js/faker"] }, "sha512-spwJFnqyEm96R7pt+DXgpqmOA2g1iJVN8R/xhub8z6uZVvxEsRMWxZs93Idk0fpZOFkfmq+d6LuZCd5/lbIzCg=="],
+
+    "@orval/fetch": ["@orval/fetch@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@scalar/openapi-types": "0.5.3" } }, "sha512-MBQ88xSQmx+5hAirCBiHSYL/rtDy6T3e7eAXaCGZ8trjeWryGpW9hF+dJukFw0QmWL8ql6ez0O9VnRkEDeVYhQ=="],
+
+    "@orval/hono": ["@orval/hono@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@orval/zod": "8.6.2", "fs-extra": "^11.3.2", "remeda": "^2.33.6" } }, "sha512-zv3ZomWvGuVqSoWIUujA6Z0rpxGo9g0dA58+tcPCRaxBIq6ld1YYhLea9QVE96xvb3RfFrOYhGgS840/yVpwyQ=="],
+
+    "@orval/mcp": ["@orval/mcp@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@orval/fetch": "8.6.2", "@orval/zod": "8.6.2" } }, "sha512-iw4opul8nI97y4bpoTzQS611HefBEQUPfnLS4RCilQyi23mCH0/Ee60USHf7aUeBqdp5yboyWOZxNRLr2T/fuQ=="],
+
+    "@orval/mock": ["@orval/mock@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "remeda": "^2.33.6" } }, "sha512-5/21u5RdROmXyzpuBzj1+sbMwP+YgLuzR2YDxx7I9nNZd/IB77o5mZyzaPXxmZ5AG4ONQJ/07gBsapxmhQrT8A=="],
+
+    "@orval/query": ["@orval/query@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@orval/fetch": "8.6.2", "remeda": "^2.33.6" } }, "sha512-cyIqk25w6R8VehCGZT2KunOpen3V1qKVqJy1Jn+oDkPDDr9aGAU5f1ohBqNQuL4/bowYmzay0VApD73PqIjbgA=="],
+
+    "@orval/solid-start": ["@orval/solid-start@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@scalar/openapi-types": "0.5.3" } }, "sha512-FAskL7OhN0/oV2S5sEA4gz6J8Cp+9GpqTfwQTeZAJ7Iq1wH6xzQBSkjhuJ0pveSrONGTDLj6PEO3g0NqP/AakQ=="],
+
+    "@orval/swr": ["@orval/swr@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "@orval/fetch": "8.6.2" } }, "sha512-vQmE3AwQE45PxMXYyuHLIXd7NjDKmJNlCg4VSeO0hznAAwPhubussCrFDeq/x6QbnBp/IOUBZh2SSf85W/AsPQ=="],
+
+    "@orval/zod": ["@orval/zod@8.6.2", "", { "dependencies": { "@orval/core": "8.6.2", "remeda": "^2.33.6" } }, "sha512-bVEXzO7W8kXtRNzTDoN+Pq8NVJnYGS+P4PbqpO5k56rWiTqEsYKzQU0vR2jHOeao2RGoIF3OiX3qMrhfak5GfA=="],
+
     "@playwright/test": ["@playwright/test@1.59.1", "", { "dependencies": { "playwright": "1.59.1" }, "bin": { "playwright": "cli.js" } }, "sha512-PG6q63nQg5c9rIi4/Z5lR5IVF7yU5MqmKaPOe0HSc0O2cX1fPi96sUQu5j7eo4gKCkB2AnNGoWt7y4/Xx3Kcqg=="],
 
     "@radix-ui/number": ["@radix-ui/number@1.1.1", "", {}, "sha512-MkKCwxlXTgz6CFoJx3pCwn07GKp36+aZyu/u2Ln2VrA5DcdyCZkASEDBTd8x5whTQQL5CiYf4prXKLcgQdv29g=="],
@@ -257,8 +342,28 @@
 
     "@radix-ui/rect": ["@radix-ui/rect@1.1.1", "", {}, "sha512-HPwpGIzkl28mWyZqG52jiqDJ12waP11Pa1lGoiyUkIEuMLBP0oeK/C89esbXrxsky5we7dfd8U58nm0SgAWpVw=="],
 
+    "@scalar/helpers": ["@scalar/helpers@0.2.18", "", {}, "sha512-w1d4tpNEVZ293oB2BAgLrS0kVPUtG3eByNmOCJA5eK9vcT4D3cmsGtWjUaaqit0BQCsBFHK51rasGvSWnApYTw=="],
+
+    "@scalar/json-magic": ["@scalar/json-magic@0.11.7", "", { "dependencies": { "@scalar/helpers": "0.2.18", "pathe": "^2.0.3", "yaml": "^2.8.0" } }, "sha512-GVz9E0vXu+ecypkdn0biK1gbQVkK4QTTX1Hq3eMgxlLQC91wwiqWfCqwfhuX0LRu+Z5OmYhLhufDJEEh56rVgA=="],
+
+    "@scalar/openapi-parser": ["@scalar/openapi-parser@0.24.17", "", { "dependencies": { "@scalar/helpers": "0.2.18", "@scalar/json-magic": "0.11.7", "@scalar/openapi-types": "0.5.4", "@scalar/openapi-upgrader": "0.1.11", "ajv": "^8.17.1", "ajv-draft-04": "^1.0.0", "ajv-formats": "^3.0.1", "jsonpointer": "^5.0.1", "leven": "^4.0.0", "yaml": "^2.8.0" } }, "sha512-aM9UVrzlMreC3X/sZbyj+7XDZmat3ecGC3RpU8dqEO/HIH+CEX0xMLuP+41DhePCYg5+9TtDomSfWuMq4x1Z1A=="],
+
+    "@scalar/openapi-types": ["@scalar/openapi-types@0.5.3", "", { "dependencies": { "zod": "^4.1.11" } }, "sha512-m4n/Su3K01d15dmdWO1LlqecdSPKuNjuokrJLdiQ485kW/hRHbXW1QP6tJL75myhw/XhX5YhYAR+jrwnGjXiMw=="],
+
+    "@scalar/openapi-upgrader": ["@scalar/openapi-upgrader@0.1.11", "", { "dependencies": { "@scalar/openapi-types": "0.5.4" } }, "sha512-ngJcHGoCHmpWgYtNy08vmzFfLdQEkMpvaCQqNPPMNKq0QEXOv89e/rn+TZJZgPnRlY7fDIoIhn9lNgr+azBW+w=="],
+
     "@sec-ant/readable-stream": ["@sec-ant/readable-stream@0.4.1", "", {}, "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg=="],
 
+    "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.23.0", "", { "dependencies": { "@shikijs/types": "3.23.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-1nWINwKXxKKLqPibT5f4pAFLej9oZzQTsby8942OTlsJzOBZ0MWKiwzMsd+jhzu8YPCHAswGnnN1YtQfirL35g=="],
+
+    "@shikijs/langs": ["@shikijs/langs@3.23.0", "", { "dependencies": { "@shikijs/types": "3.23.0" } }, "sha512-2Ep4W3Re5aB1/62RSYQInK9mM3HsLeB91cHqznAJMuylqjzNVAVCMnNWRHFtcNHXsoNRayP9z1qj4Sq3nMqYXg=="],
+
+    "@shikijs/themes": ["@shikijs/themes@3.23.0", "", { "dependencies": { "@shikijs/types": "3.23.0" } }, "sha512-5qySYa1ZgAT18HR/ypENL9cUSGOeI2x+4IvYJu4JgVJdizn6kG4ia5Q1jDEOi7gTbN4RbuYtmHh0W3eccOrjMA=="],
+
+    "@shikijs/types": ["@shikijs/types@3.23.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-3JZ5HXOZfYjsYSk0yPwBrkupyYSLpAE26Qc0HLghhZNGTZg/SKxXIIgoxOpmmeQP0RRSDJTk1/vPfw9tbw+jSQ=="],
+
+    "@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="],
+
     "@sindresorhus/merge-streams": ["@sindresorhus/merge-streams@4.0.0", "", {}, "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ=="],
 
     "@swc/helpers": ["@swc/helpers@0.5.15", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g=="],
@@ -295,14 +400,8 @@
 
     "@tanstack/query-core": ["@tanstack/query-core@5.96.1", "", {}, "sha512-u1yBgtavSy+N8wgtW3PiER6UpxcplMje65yXnnVgiHTqiMwLlxiw4WvQDrXyn+UD6lnn8kHaxmerJUzQcV/MMg=="],
 
-    "@tanstack/query-persist-client-core": ["@tanstack/query-persist-client-core@5.96.1", "", { "dependencies": { "@tanstack/query-core": "5.96.1" } }, "sha512-61jJdGjhBaAJiQ6TRt4uFI8EoAPyf7bJjbtc59AxZwMyid9kV9FlUEtNs2TkEzYHPTYvDZzz0qOvvkn1YD/VEg=="],
-
-    "@tanstack/query-sync-storage-persister": ["@tanstack/query-sync-storage-persister@5.96.1", "", { "dependencies": { "@tanstack/query-core": "5.96.1", "@tanstack/query-persist-client-core": "5.96.1" } }, "sha512-DpeEVOA8AmUlt+D+X7zZCgfb+xwXj9aJBhALlaFE9uWm0btHT5Xc+GGMnDdtwkxWZLNyEuVarudLArIBsT8N+Q=="],
-
     "@tanstack/react-query": ["@tanstack/react-query@5.96.1", "", { "dependencies": { "@tanstack/query-core": "5.96.1" }, "peerDependencies": { "react": "^18 || ^19" } }, "sha512-2X7KYK5KKWUKGeWCVcqxXAkYefJtrKB7tSKWgeG++b0H6BRHxQaLSSi8AxcgjmUnnosHuh9WsFZqvE16P1WCzA=="],
 
-    "@tanstack/react-query-persist-client": ["@tanstack/react-query-persist-client@5.96.1", "", { "dependencies": { "@tanstack/query-persist-client-core": "5.96.1" }, "peerDependencies": { "@tanstack/react-query": "^5.96.1", "react": "^18 || ^19" } }, "sha512-HkYAI7T2uc12gvVR8P1D7dHgA/AdGDhqDN1HeaNP561OFa0H425qk61ykWtpF8Vnv82ElX6ao0nuNr1oPh89Uw=="],
-
     "@tanstack/react-virtual": ["@tanstack/react-virtual@3.13.23", "", { "dependencies": { "@tanstack/virtual-core": "3.13.23" }, "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-XnMRnHQ23piOVj2bzJqHrRrLg4r+F86fuBcwteKfbIjJrtGxb4z7tIvPVAe4B+4UVwo9G4Giuz5fmapcrnZ0OQ=="],
 
     "@tanstack/virtual-core": ["@tanstack/virtual-core@3.13.23", "", {}, "sha512-zSz2Z2HNyLjCplANTDyl3BcdQJc2k1+yyFoKhNRmCr7V7dY8o8q5m8uFTI1/Pg1kL+Hgrz6u3Xo6eFUB7l66cg=="],
@@ -359,14 +458,36 @@
 
     "@use-gesture/react": ["@use-gesture/react@10.3.1", "", { "dependencies": { "@use-gesture/core": "10.3.1" }, "peerDependencies": { "react": ">= 16.8.0" } }, "sha512-Yy19y6O2GJq8f7CHf7L0nxL8bf4PZCPaVOCgJrusOeFHY1LvHgYXnmnXg6N5iwAnbgbZCDjo60SiM6IPJi9C5g=="],
 
+    "@xstate/react": ["@xstate/react@6.1.0", "", { "dependencies": { "use-isomorphic-layout-effect": "^1.1.2", "use-sync-external-store": "^1.2.0" }, "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", "xstate": "^5.28.0" }, "optionalPeers": ["xstate"] }, "sha512-ep9F0jGTI63B/jE8GHdMpUqtuz7yRebNaKv8EMUaiSi29NOglywc2X2YSOV/ygbIK+LtmgZ0q9anoEA2iBSEOw=="],
+
+    "acorn": ["acorn@8.16.0", "", { "bin": { "acorn": "bin/acorn" } }, "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw=="],
+
+    "ajv": ["ajv@8.18.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A=="],
+
+    "ajv-draft-04": ["ajv-draft-04@1.0.0", "", { "peerDependencies": { "ajv": "^8.5.0" }, "optionalPeers": ["ajv"] }, "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw=="],
+
+    "ajv-formats": ["ajv-formats@3.0.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="],
+
+    "ansi-colors": ["ansi-colors@4.1.3", "", {}, "sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw=="],
+
+    "ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
+
+    "argparse": ["argparse@2.0.1", "", {}, "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q=="],
+
     "aria-hidden": ["aria-hidden@1.2.6", "", { "dependencies": { "tslib": "^2.0.0" } }, "sha512-ik3ZgC9dY/lYVVM++OISsaYDeg1tb0VtP5uL3ouh1koGOaUMDPpbFIei4JkFimWUFPn90sbMNMXQAIVOlnYKJA=="],
 
     "babel-plugin-react-compiler": ["babel-plugin-react-compiler@1.0.0", "", { "dependencies": { "@babel/types": "^7.26.0" } }, "sha512-Ixm8tFfoKKIPYdCCKYTsqv+Fd4IJ0DQqMyEimo+pxUOMUR9cVPlwTrFt9Avu+3cb6Zp3mAzl+t1MrG2fxxKsxw=="],
 
     "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],
 
+    "balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="],
+
     "baseline-browser-mapping": ["baseline-browser-mapping@2.10.8", "", { "bin": { "baseline-browser-mapping": "dist/cli.cjs" } }, "sha512-PCLz/LXGBsNTErbtB6i5u4eLpHeMfi93aUv5duMmj6caNu6IphS4q6UevDnL36sZQv9lrP11dbPKGMaXPwMKfQ=="],
 
+    "brace-expansion": ["brace-expansion@5.0.5", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ=="],
+
+    "braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA=="],
+
     "browser-fs-access": ["browser-fs-access@0.38.0", "", {}, "sha512-JveqW2w6pEZqFEEfMgCszXzYpE89dG+nPsmOdcs741mFFAROeL+iqjGEpR07RI+s0YY0EFr+4KnOoACprJTpOw=="],
 
     "caniuse-lite": ["caniuse-lite@1.0.30001752", "", {}, "sha512-vKUk7beoukxE47P5gcVNKkDRzXdVofotshHwfR9vmpeFKxmI5PBpgOMC18LUJUA/DvJ70Y7RveasIBraqsyO/g=="],
@@ -381,6 +502,8 @@
 
     "character-reference-invalid": ["character-reference-invalid@2.0.1", "", {}, "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw=="],
 
+    "chokidar": ["chokidar@5.0.0", "", { "dependencies": { "readdirp": "^5.0.0" } }, "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw=="],
+
     "class-variance-authority": ["class-variance-authority@0.7.1", "", { "dependencies": { "clsx": "^2.1.1" } }, "sha512-Ka+9Trutv7G8M6WT6SeiRWz792K5qEqIGEGzXKhAE6xOWAY6pPH8U+9IY3oCMv6kqTmLsv7Xh/2w2RigkePMsg=="],
 
     "client-only": ["client-only@0.0.1", "", {}, "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA=="],
@@ -389,6 +512,10 @@
 
     "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
 
+    "commander": ["commander@14.0.3", "", {}, "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw=="],
+
+    "compare-versions": ["compare-versions@6.1.1", "", {}, "sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg=="],
+
     "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
 
     "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
@@ -407,20 +534,40 @@
 
     "enhanced-resolve": ["enhanced-resolve@5.19.0", "", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.3.0" } }, "sha512-phv3E1Xl4tQOShqSte26C7Fl84EwUdZsyOuSSk9qtAGyyQs2s3jJzComh+Abf4g187lUUAvH+H26omrqia2aGg=="],
 
+    "enquirer": ["enquirer@2.4.1", "", { "dependencies": { "ansi-colors": "^4.1.1", "strip-ansi": "^6.0.1" } }, "sha512-rRqJg/6gd538VHvR3PSrdRBb/1Vy2YfzHqzvbhGIQpDRKIa4FgV/54b5Q1xYSxOOwKvjXweS26E0Q+nAMwp2pQ=="],
+
+    "entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
+
+    "esbuild": ["esbuild@0.27.5", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.27.5", "@esbuild/android-arm": "0.27.5", "@esbuild/android-arm64": "0.27.5", "@esbuild/android-x64": "0.27.5", "@esbuild/darwin-arm64": "0.27.5", "@esbuild/darwin-x64": "0.27.5", "@esbuild/freebsd-arm64": "0.27.5", "@esbuild/freebsd-x64": "0.27.5", "@esbuild/linux-arm": "0.27.5", "@esbuild/linux-arm64": "0.27.5", "@esbuild/linux-ia32": "0.27.5", "@esbuild/linux-loong64": "0.27.5", "@esbuild/linux-mips64el": "0.27.5", "@esbuild/linux-ppc64": "0.27.5", "@esbuild/linux-riscv64": "0.27.5", "@esbuild/linux-s390x": "0.27.5", "@esbuild/linux-x64": "0.27.5", "@esbuild/netbsd-arm64": "0.27.5", "@esbuild/netbsd-x64": "0.27.5", "@esbuild/openbsd-arm64": "0.27.5", "@esbuild/openbsd-x64": "0.27.5", "@esbuild/openharmony-arm64": "0.27.5", "@esbuild/sunos-x64": "0.27.5", "@esbuild/win32-arm64": "0.27.5", "@esbuild/win32-ia32": "0.27.5", "@esbuild/win32-x64": "0.27.5" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-zdQoHBjuDqKsvV5OPaWansOwfSQ0Js+Uj9J85TBvj3bFW1JjWTSULMRwdQAc8qMeIScbClxeMK0jlrtB9linhA=="],
+
     "escape-string-regexp": ["escape-string-regexp@5.0.0", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="],
 
     "estree-util-is-identifier-name": ["estree-util-is-identifier-name@3.0.0", "", {}, "sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg=="],
 
-    "eventemitter3": ["eventemitter3@5.0.4", "", {}, "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw=="],
+    "esutils": ["esutils@2.0.3", "", {}, "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g=="],
 
     "execa": ["execa@9.6.1", "", { "dependencies": { "@sindresorhus/merge-streams": "^4.0.0", "cross-spawn": "^7.0.6", "figures": "^6.1.0", "get-stream": "^9.0.0", "human-signals": "^8.0.1", "is-plain-obj": "^4.1.0", "is-stream": "^4.0.1", "npm-run-path": "^6.0.0", "pretty-ms": "^9.2.0", "signal-exit": "^4.1.0", "strip-final-newline": "^4.0.0", "yoctocolors": "^2.1.1" } }, "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA=="],
 
     "extend": ["extend@3.0.2", "", {}, "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="],
 
+    "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
+
+    "fast-glob": ["fast-glob@3.3.3", "", { "dependencies": { "@nodelib/fs.stat": "^2.0.2", "@nodelib/fs.walk": "^1.2.3", "glob-parent": "^5.1.2", "merge2": "^1.3.0", "micromatch": "^4.0.8" } }, "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg=="],
+
+    "fast-uri": ["fast-uri@3.1.0", "", {}, "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA=="],
+
+    "fastq": ["fastq@1.20.1", "", { "dependencies": { "reusify": "^1.0.4" } }, "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw=="],
+
     "figures": ["figures@6.1.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0" } }, "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg=="],
 
+    "fill-range": ["fill-range@7.1.1", "", { "dependencies": { "to-regex-range": "^5.0.1" } }, "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg=="],
+
+    "find-up": ["find-up@8.0.0", "", { "dependencies": { "locate-path": "^8.0.0", "unicorn-magic": "^0.3.0" } }, "sha512-JGG8pvDi2C+JxidYdIwQDyS/CgcrIdh18cvgxcBge3wSHRQOrooMD3GlFBcmMJAN9M42SAZjDp5zv1dglJjwww=="],
+
     "framer-motion": ["framer-motion@12.38.0", "", { "dependencies": { "motion-dom": "^12.38.0", "motion-utils": "^12.36.0", "tslib": "^2.4.0" }, "peerDependencies": { "@emotion/is-prop-valid": "*", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0" }, "optionalPeers": ["@emotion/is-prop-valid", "react", "react-dom"] }, "sha512-rFYkY/pigbcswl1XQSb7q424kSTQ8q6eAC+YUsSKooHQYuLdzdHjrt6uxUC+PRAO++q5IS7+TamgIw1AphxR+g=="],
 
+    "fs-extra": ["fs-extra@11.3.4", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-CTXd6rk/M3/ULNQj8FBqBWHYBVYybQ3VPBw0xGKFe3tuH7ytT6ACnvzpIQ3UZtB8yvUKC2cXn1a+x+5EVQLovA=="],
+
     "fsevents": ["fsevents@2.3.2", "", { "os": "darwin" }, "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA=="],
 
     "get-nonce": ["get-nonce@1.0.1", "", {}, "sha512-FJhYRoDaiatfEkUK8HKlicmu/3SGFD51q3itKDGoSTysQJBnfOcxU5GxnhE1E6soB76MbT0MBtnKJuXyAx+96Q=="],
@@ -441,6 +588,10 @@
 
     "git-cliff-windows-x64": ["git-cliff-windows-x64@2.12.0", "", { "os": "win32", "cpu": "x64" }, "sha512-jskb3nyVGr4dekHSCDM/J6iho45t37wnmMGkPNq42kOoUp04JS96yMBrNRdXfXV9ViZsaZq3NaNu1e3QkhFlyA=="],
 
+    "glob-parent": ["glob-parent@5.1.2", "", { "dependencies": { "is-glob": "^4.0.1" } }, "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow=="],
+
+    "globby": ["globby@16.1.0", "", { "dependencies": { "@sindresorhus/merge-streams": "^4.0.0", "fast-glob": "^3.3.3", "ignore": "^7.0.5", "is-path-inside": "^4.0.0", "slash": "^5.1.0", "unicorn-magic": "^0.4.0" } }, "sha512-+A4Hq7m7Ze592k9gZRy4gJ27DrXRNnC1vPjxTt1qQxEY8RxagBkBxivkCwg7FxSTG0iLLEMaUx13oOr0R2/qcQ=="],
+
     "graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
 
     "hast-util-to-jsx-runtime": ["hast-util-to-jsx-runtime@2.3.6", "", { "dependencies": { "@types/estree": "^1.0.0", "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "comma-separated-tokens": "^2.0.0", "devlop": "^1.0.0", "estree-util-is-identifier-name": "^3.0.0", "hast-util-whitespace": "^3.0.0", "mdast-util-mdx-expression": "^2.0.0", "mdast-util-mdx-jsx": "^3.0.0", "mdast-util-mdxjs-esm": "^2.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "style-to-js": "^1.0.0", "unist-util-position": "^5.0.0", "vfile-message": "^4.0.0" } }, "sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg=="],
@@ -459,6 +610,10 @@
 
     "i18next-localstorage-backend": ["i18next-localstorage-backend@4.3.1", "", { "dependencies": { "@babel/runtime": "^7.28.4" } }, "sha512-ry8WNBanUs55rsRZs9+xaZWRxCoTEMMOf+2vNSfzzJqDPbHaf0eMFMrtYp/2ocxU6Xrxfwz17Fdz0rSs3Kw39Q=="],
 
+    "ignore": ["ignore@7.0.5", "", {}, "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg=="],
+
+    "immer": ["immer@11.1.4", "", {}, "sha512-XREFCPo6ksxVzP4E0ekD5aMdf8WMwmdNaz6vuvxgI40UaEiu6q3p8X52aU6GdyvLY3XXX/8R7JOTXStz/nBbRw=="],
+
     "inline-style-parser": ["inline-style-parser@0.2.7", "", {}, "sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA=="],
 
     "is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="],
@@ -467,8 +622,16 @@
 
     "is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="],
 
+    "is-extglob": ["is-extglob@2.1.1", "", {}, "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ=="],
+
+    "is-glob": ["is-glob@4.0.3", "", { "dependencies": { "is-extglob": "^2.1.1" } }, "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg=="],
+
     "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="],
 
+    "is-number": ["is-number@7.0.0", "", {}, "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng=="],
+
+    "is-path-inside": ["is-path-inside@4.0.0", "", {}, "sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA=="],
+
     "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="],
 
     "is-stream": ["is-stream@4.0.1", "", {}, "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A=="],
@@ -481,6 +644,16 @@
 
     "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],
 
+    "js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA=="],
+
+    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+
+    "jsonfile": ["jsonfile@6.2.0", "", { "dependencies": { "universalify": "^2.0.0" }, "optionalDependencies": { "graceful-fs": "^4.1.6" } }, "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg=="],
+
+    "jsonpointer": ["jsonpointer@5.0.1", "", {}, "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ=="],
+
+    "leven": ["leven@4.1.0", "", {}, "sha512-KZ9W9nWDT7rF7Dazg8xyLHGLrmpgq2nVNFUckhqdW3szVP6YhCpp/RAnpmVExA9JvrMynjwSLVrEj3AepHR6ew=="],
+
     "lightningcss": ["lightningcss@1.32.0", "", { "dependencies": { "detect-libc": "^2.0.3" }, "optionalDependencies": { "lightningcss-android-arm64": "1.32.0", "lightningcss-darwin-arm64": "1.32.0", "lightningcss-darwin-x64": "1.32.0", "lightningcss-freebsd-x64": "1.32.0", "lightningcss-linux-arm-gnueabihf": "1.32.0", "lightningcss-linux-arm64-gnu": "1.32.0", "lightningcss-linux-arm64-musl": "1.32.0", "lightningcss-linux-x64-gnu": "1.32.0", "lightningcss-linux-x64-musl": "1.32.0", "lightningcss-win32-arm64-msvc": "1.32.0", "lightningcss-win32-x64-msvc": "1.32.0" } }, "sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ=="],
 
     "lightningcss-android-arm64": ["lightningcss-android-arm64@1.32.0", "", { "os": "android", "cpu": "arm64" }, "sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg=="],
@@ -505,14 +678,22 @@
 
     "lightningcss-win32-x64-msvc": ["lightningcss-win32-x64-msvc@1.32.0", "", { "os": "win32", "cpu": "x64" }, "sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q=="],
 
+    "linkify-it": ["linkify-it@5.0.0", "", { "dependencies": { "uc.micro": "^2.0.0" } }, "sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ=="],
+
+    "locate-path": ["locate-path@8.0.0", "", { "dependencies": { "p-locate": "^6.0.0" } }, "sha512-XT9ewWAC43tiAV7xDAPflMkG0qOPn2QjHqlgX8FOqmWa/rxnyYDulF9T0F7tRy1u+TVTmK/M//6VIOye+2zDXg=="],
+
     "longest-streak": ["longest-streak@3.1.0", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="],
 
     "loose-envify": ["loose-envify@1.4.0", "", { "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, "bin": { "loose-envify": "cli.js" } }, "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q=="],
 
     "lucide-react": ["lucide-react@0.577.0", "", { "peerDependencies": { "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-4LjoFv2eEPwYDPg/CUdBJQSDfPyzXCRrVW1X7jrx/trgxnxkHFjnVZINbzvzxjN70dxychOfg+FTYwBiS3pQ5A=="],
 
+    "lunr": ["lunr@2.3.9", "", {}, "sha512-zTU3DaZaF3Rt9rhN3uBMGQD3dD2/vFQqnvZCDv4dl5iOzq2IZQqTxu90r4E5J+nP70J3ilqVCrbho2eWaeW8Ow=="],
+
     "magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
 
+    "markdown-it": ["markdown-it@14.1.1", "", { "dependencies": { "argparse": "^2.0.1", "entities": "^4.4.0", "linkify-it": "^5.0.0", "mdurl": "^2.0.0", "punycode.js": "^2.3.1", "uc.micro": "^2.1.0" }, "bin": { "markdown-it": "bin/markdown-it.mjs" } }, "sha512-BuU2qnTti9YKgK5N+IeMubp14ZUKUUw7yeJbkjtosvHiP0AZ5c8IAgEMk79D0eC8F23r4Ac/q8cAIFdm2FtyoA=="],
+
     "markdown-table": ["markdown-table@3.0.4", "", {}, "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw=="],
 
     "mdast-util-find-and-replace": ["mdast-util-find-and-replace@3.0.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "escape-string-regexp": "^5.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg=="],
@@ -545,6 +726,10 @@
 
     "mdast-util-to-string": ["mdast-util-to-string@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0" } }, "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg=="],
 
+    "mdurl": ["mdurl@2.0.0", "", {}, "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w=="],
+
+    "merge2": ["merge2@1.4.1", "", {}, "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg=="],
+
     "micromark": ["micromark@4.0.2", "", { "dependencies": { "@types/debug": "^4.0.0", "debug": "^4.0.0", "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-core-commonmark": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-combine-extensions": "^2.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-sanitize-uri": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA=="],
 
     "micromark-core-commonmark": ["micromark-core-commonmark@2.0.3", "", { "dependencies": { "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-factory-destination": "^2.0.0", "micromark-factory-label": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-factory-title": "^2.0.0", "micromark-factory-whitespace": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-html-tag-name": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg=="],
@@ -601,6 +786,10 @@
 
     "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="],
 
+    "micromatch": ["micromatch@4.0.8", "", { "dependencies": { "braces": "^3.0.3", "picomatch": "^2.3.1" } }, "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA=="],
+
+    "minimatch": ["minimatch@10.2.5", "", { "dependencies": { "brace-expansion": "^5.0.5" } }, "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg=="],
+
     "motion": ["motion@12.38.0", "", { "dependencies": { "framer-motion": "^12.38.0", "tslib": "^2.4.0" }, "peerDependencies": { "@emotion/is-prop-valid": "*", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0" }, "optionalPeers": ["@emotion/is-prop-valid", "react", "react-dom"] }, "sha512-uYfXzeHlgThchzwz5Te47dlv5JOUC7OB4rjJ/7XTUgtBZD8CchMN8qEJ4ZVsUmTyYA44zjV0fBwsiktRuFnn+w=="],
 
     "motion-dom": ["motion-dom@12.38.0", "", { "dependencies": { "motion-utils": "^12.36.0" } }, "sha512-pdkHLD8QYRp8VfiNLb8xIBJis1byQ9gPT3Jnh2jqfFtAsWUA3dEepDlsWe/xMpO8McV+VdpKVcp+E+TGJEtOoA=="],
@@ -619,9 +808,11 @@
 
     "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
 
-    "p-queue": ["p-queue@9.1.1", "", { "dependencies": { "eventemitter3": "^5.0.1", "p-timeout": "^7.0.0" } }, "sha512-yQS1vV2V7Q14MQrgD8jMNY5owPuGgVHVdSK8NqmKpOVajnjbaeMa6uLOzTALPtvJ7Vo4bw0BGsw7qfUT8z24Ig=="],
+    "orval": ["orval@8.6.2", "", { "dependencies": { "@commander-js/extra-typings": "^14.0.0", "@orval/angular": "8.6.2", "@orval/axios": "8.6.2", "@orval/core": "8.6.2", "@orval/fetch": "8.6.2", "@orval/hono": "8.6.2", "@orval/mcp": "8.6.2", "@orval/mock": "8.6.2", "@orval/query": "8.6.2", "@orval/solid-start": "8.6.2", "@orval/swr": "8.6.2", "@orval/zod": "8.6.2", "@scalar/json-magic": "^0.11.5", "@scalar/openapi-parser": "^0.24.13", "@scalar/openapi-types": "0.5.3", "chokidar": "^5.0.0", "commander": "^14.0.2", "enquirer": "^2.4.1", "execa": "^9.6.1", "find-up": "8.0.0", "fs-extra": "^11.3.2", "jiti": "^2.6.1", "js-yaml": "4.1.1", "remeda": "^2.33.6", "string-argv": "^0.3.2", "tsconfck": "^3.1.6", "typedoc": "^0.28.17", "typedoc-plugin-coverage": "^4.0.2", "typedoc-plugin-markdown": "^4.10.0" }, "peerDependencies": { "prettier": ">=3.0.0" }, "optionalPeers": ["prettier"], "bin": { "orval": "dist/bin/orval.mjs" } }, "sha512-hnWdF7jrdgZFhRy4ZVMpLMYpkmfLDkO1wTh881Ll0w18XOmvJauYvrsTmTby3gf4qEChtWxNULI3HlY173NqvA=="],
 
-    "p-timeout": ["p-timeout@7.0.1", "", {}, "sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg=="],
+    "p-limit": ["p-limit@4.0.0", "", { "dependencies": { "yocto-queue": "^1.0.0" } }, "sha512-5b0R4txpzjPWVw/cXXUResoD4hb6U/x9BH08L7nw+GN1sezDzPdxeRvpc9c433fZhBan/wusjbCsqwqm4EIBIQ=="],
+
+    "p-locate": ["p-locate@6.0.0", "", { "dependencies": { "p-limit": "^4.0.0" } }, "sha512-wPrq66Llhl7/4AGC6I+cqxT07LhXvWL08LNXz1fENOw0Ap4sRZZ/gZpTTJ5jpurzzzfS2W/Ge9BY3LgLjCShcw=="],
 
     "parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="],
 
@@ -629,8 +820,12 @@
 
     "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
 
+    "pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
+
     "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
 
+    "picomatch": ["picomatch@2.3.2", "", {}, "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA=="],
+
     "playwright": ["playwright@1.59.1", "", { "dependencies": { "playwright-core": "1.59.1" }, "optionalDependencies": { "fsevents": "2.3.2" }, "bin": { "playwright": "cli.js" } }, "sha512-C8oWjPR3F81yljW9o5OxcWzfh6avkVwDD2VYdwIGqTkl+OGFISgypqzfu7dOe4QNLL2aqcWBmI3PMtLIK233lw=="],
 
     "playwright-core": ["playwright-core@1.59.1", "", { "bin": { "playwright-core": "cli.js" } }, "sha512-HBV/RJg81z5BiiZ9yPzIiClYV/QMsDCKUyogwH9p3MCP6IYjUFu/MActgYAvK0oWyV9NlwM3GLBjADyWgydVyg=="],
@@ -647,6 +842,10 @@
 
     "property-information": ["property-information@7.1.0", "", {}, "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ=="],
 
+    "punycode.js": ["punycode.js@2.3.1", "", {}, "sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA=="],
+
+    "queue-microtask": ["queue-microtask@1.2.3", "", {}, "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A=="],
+
     "re-resizable": ["re-resizable@6.11.2", "", { "peerDependencies": { "react": "^16.13.1 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^16.13.1 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-2xI2P3OHs5qw7K0Ud1aLILK6MQxW50TcO+DetD9eIV58j84TqYeHoZcL9H4GXFXXIh7afhH8mv5iUCXII7OW7A=="],
 
     "react": ["react@19.2.4", "", {}, "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ=="],
@@ -677,6 +876,8 @@
 
     "react-style-singleton": ["react-style-singleton@2.2.3", "", { "dependencies": { "get-nonce": "^1.0.0", "tslib": "^2.0.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-b6jSvxvVnyptAiLjbkWLE/lOnR4lfTtDAl+eUC7RZy+QQWc6wRzIV2CE6xBuMmDxc2qIihtDCZD5NPOFl7fRBQ=="],
 
+    "readdirp": ["readdirp@5.0.0", "", {}, "sha512-9u/XQ1pvrQtYyMpZe7DXKv2p5CNvyVwzUB6uhLAnQwHMSgKMBR62lc7AHljaeteeHXn11XTAaLLUVZYVZyuRBQ=="],
+
     "remark-gfm": ["remark-gfm@4.0.1", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-gfm": "^3.0.0", "micromark-extension-gfm": "^3.0.0", "remark-parse": "^11.0.0", "remark-stringify": "^11.0.0", "unified": "^11.0.0" } }, "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg=="],
 
     "remark-parse": ["remark-parse@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-from-markdown": "^2.0.0", "micromark-util-types": "^2.0.0", "unified": "^11.0.0" } }, "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA=="],
@@ -685,6 +886,14 @@
 
     "remark-stringify": ["remark-stringify@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-to-markdown": "^2.0.0", "unified": "^11.0.0" } }, "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw=="],
 
+    "remeda": ["remeda@2.33.7", "", {}, "sha512-cXlyjevWx5AcslOUEETG4o8XYi9UkoCXcJmj7XhPFVbla+ITuOBxv6ijBrmbeg+ZhzmDThkNdO+iXKUfrJep1w=="],
+
+    "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
+
+    "reusify": ["reusify@1.1.0", "", {}, "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw=="],
+
+    "run-parallel": ["run-parallel@1.2.0", "", { "dependencies": { "queue-microtask": "^1.2.2" } }, "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA=="],
+
     "scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
 
     "semver": ["semver@7.7.3", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q=="],
@@ -697,12 +906,18 @@
 
     "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
 
+    "slash": ["slash@5.1.0", "", {}, "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg=="],
+
     "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
 
     "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
 
+    "string-argv": ["string-argv@0.3.2", "", {}, "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q=="],
+
     "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
 
+    "strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
+
     "strip-final-newline": ["strip-final-newline@4.0.0", "", {}, "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw=="],
 
     "style-to-js": ["style-to-js@1.1.21", "", { "dependencies": { "style-to-object": "1.0.14" } }, "sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ=="],
@@ -717,16 +932,28 @@
 
     "tapable": ["tapable@2.3.0", "", {}, "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg=="],
 
+    "to-regex-range": ["to-regex-range@5.0.1", "", { "dependencies": { "is-number": "^7.0.0" } }, "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ=="],
+
     "trim-lines": ["trim-lines@3.0.1", "", {}, "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg=="],
 
     "trough": ["trough@2.2.0", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="],
 
+    "tsconfck": ["tsconfck@3.1.6", "", { "peerDependencies": { "typescript": "^5.0.0" }, "optionalPeers": ["typescript"], "bin": { "tsconfck": "bin/tsconfck.js" } }, "sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w=="],
+
     "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
 
     "tw-animate-css": ["tw-animate-css@1.4.0", "", {}, "sha512-7bziOlRqH0hJx80h/3mbicLW7o8qLsH5+RaLR2t+OHM3D0JlWGODQKQ4cxbK7WlvmUxpcj6Kgu6EKqjrGFe3QQ=="],
 
+    "typedoc": ["typedoc@0.28.18", "", { "dependencies": { "@gerrit0/mini-shiki": "^3.23.0", "lunr": "^2.3.9", "markdown-it": "^14.1.1", "minimatch": "^10.2.4", "yaml": "^2.8.2" }, "peerDependencies": { "typescript": "5.0.x || 5.1.x || 5.2.x || 5.3.x || 5.4.x || 5.5.x || 5.6.x || 5.7.x || 5.8.x || 5.9.x || 6.0.x" }, "bin": { "typedoc": "bin/typedoc" } }, "sha512-NTWTUOFRQ9+SGKKTuWKUioUkjxNwtS3JDRPVKZAXGHZy2wCA8bdv2iJiyeePn0xkmK+TCCqZFT0X7+2+FLjngA=="],
+
+    "typedoc-plugin-coverage": ["typedoc-plugin-coverage@4.0.2", "", { "peerDependencies": { "typedoc": "0.28.x" } }, "sha512-mfn0e7NCqB8x2PfvhXrtmd7KWlsNf1+B2N9y8gR/jexXBLrXl/0e+b2HdG5HaTXGi7i0t2pyQY2VRmq7gtdEHQ=="],
+
+    "typedoc-plugin-markdown": ["typedoc-plugin-markdown@4.11.0", "", { "peerDependencies": { "typedoc": "0.28.x" } }, "sha512-2iunh2ALyfyh204OF7h2u0kuQ84xB3jFZtFyUr01nThJkLvR8oGGSSDlyt2gyO4kXhvUxDcVbO0y43+qX+wFbw=="],
+
     "typescript": ["typescript@6.0.2", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-bGdAIrZ0wiGDo5l8c++HWtbaNCWTS4UTv7RaTH/ThVIgjkveJt83m74bBHMJkuCbslY8ixgLBVZJIOiQlQTjfQ=="],
 
+    "uc.micro": ["uc.micro@2.1.0", "", {}, "sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A=="],
+
     "ui": ["ui@workspace:ui"],
 
     "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
@@ -745,8 +972,12 @@
 
     "unist-util-visit-parents": ["unist-util-visit-parents@6.0.2", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ=="],
 
+    "universalify": ["universalify@2.0.1", "", {}, "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw=="],
+
     "use-callback-ref": ["use-callback-ref@1.3.3", "", { "dependencies": { "tslib": "^2.0.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-jQL3lRnocaFtu3V00JToYz/4QkNWswxijDaCVNZRiRTO3HQDLsdu1ZtmIUvV4yPp+rvWm5j0y0TG/S61cuijTg=="],
 
+    "use-isomorphic-layout-effect": ["use-isomorphic-layout-effect@1.2.1", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-tpZZ+EX0gaghDAiFR37hj5MgY6ZN55kLiPkJsKxBMZ6GZdOSPJXiOzPM984oPYZ5AnehYx5WQp1+ME8I/P/pRA=="],
+
     "use-sidecar": ["use-sidecar@1.1.3", "", { "dependencies": { "detect-node-es": "^1.1.0", "tslib": "^2.0.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-Fedw0aZvkhynoPYlA5WXrMCAMm+nSWdZt6lzJQ7Ok8S6Q+VsHmHpRWndVRJ8Be0ZbkfPc5LRYH+5XrzXcEeLRQ=="],
 
     "use-sync-external-store": ["use-sync-external-store@1.6.0", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w=="],
@@ -759,6 +990,12 @@
 
     "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
 
+    "xstate": ["xstate@5.30.0", "", {}, "sha512-mIzIuMjtYVkqXq9dUzYQoag7b/dF1CBS/yhliuPLfR0FwKPC18HiUivb/crcqY2gknhR8gJEhnppLg6ubQ0gGw=="],
+
+    "yaml": ["yaml@2.8.3", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg=="],
+
+    "yocto-queue": ["yocto-queue@1.2.2", "", {}, "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ=="],
+
     "yoctocolors": ["yoctocolors@2.1.2", "", {}, "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug=="],
 
     "zod": ["zod@4.3.6", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
@@ -783,6 +1020,10 @@
 
     "@radix-ui/react-tooltip/@radix-ui/react-slot": ["@radix-ui/react-slot@1.2.3", "", { "dependencies": { "@radix-ui/react-compose-refs": "1.1.2" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A=="],
 
+    "@scalar/openapi-parser/@scalar/openapi-types": ["@scalar/openapi-types@0.5.4", "", { "dependencies": { "zod": "^4.3.5" } }, "sha512-2pEbhprh8lLGDfUI6mNm9EV104pjb3+aJsXrFaqfgOSre7r6NlgM5HcSbsLjzDAnTikjJhJ3IMal1Rz8WVwiOw=="],
+
+    "@scalar/openapi-upgrader/@scalar/openapi-types": ["@scalar/openapi-types@0.5.4", "", { "dependencies": { "zod": "^4.3.5" } }, "sha512-2pEbhprh8lLGDfUI6mNm9EV104pjb3+aJsXrFaqfgOSre7r6NlgM5HcSbsLjzDAnTikjJhJ3IMal1Rz8WVwiOw=="],
+
     "@tailwindcss/oxide-wasm32-wasi/@emnapi/core": ["@emnapi/core@1.8.1", "", { "dependencies": { "@emnapi/wasi-threads": "1.1.0", "tslib": "^2.4.0" }, "bundled": true }, "sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg=="],
 
     "@tailwindcss/oxide-wasm32-wasi/@emnapi/runtime": ["@emnapi/runtime@1.8.1", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg=="],
@@ -795,6 +1036,8 @@
 
     "@tailwindcss/oxide-wasm32-wasi/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
 
+    "globby/unicorn-magic": ["unicorn-magic@0.4.0", "", {}, "sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw=="],
+
     "i18next-browser-languagedetector/@babel/runtime": ["@babel/runtime@7.28.4", "", {}, "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ=="],
 
     "i18next-localstorage-backend/@babel/runtime": ["@babel/runtime@7.28.4", "", {}, "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ=="],

koharu-core/Cargo.toml

@@ -20,7 +20,7 @@ serde = { workspace = true }
 serde_bytes = { workspace = true }
 strum = { workspace = true }
 tokio = { workspace = true }
-ts-rs = { workspace = true }
+utoipa = { workspace = true }
 uuid = { workspace = true }
 
 [dev-dependencies]

koharu-core/src/effect.rs

@@ -3,7 +3,7 @@ use serde::{Deserialize, Deserializer, Serialize};
 use std::fmt;
 use std::str::FromStr;
 use strum::IntoEnumIterator;
-use ts_rs::TS;
+use utoipa::ToSchema;
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq, strum::Display, strum::EnumIter, strum::EnumString)]
 #[strum(serialize_all = "lowercase")]
@@ -12,9 +12,8 @@ enum TextShaderEffectFlag {
     Bold,
 }
 
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Default, TS, JsonSchema)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Default, ToSchema, JsonSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TextShaderEffect {
     #[serde(default)]
     pub italic: bool,

koharu-core/src/font.rs

@@ -1,16 +1,14 @@
 use schemars::JsonSchema;
 use serde::{Deserialize, Serialize};
-use ts_rs::TS;
+use utoipa::ToSchema;
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, TS, JsonSchema)]
-#[ts(export)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, ToSchema, JsonSchema)]
 pub enum TextDirection {
     Horizontal,
     Vertical,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, TS, JsonSchema)]
-#[ts(export)]
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, JsonSchema)]
 pub struct NamedFontPrediction {
     pub index: usize,
     pub name: String,
@@ -19,8 +17,7 @@ pub struct NamedFontPrediction {
     pub serif: bool,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, TS, JsonSchema)]
-#[ts(export)]
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, JsonSchema)]
 pub struct FontPrediction {
     pub top_fonts: Vec<(usize, f32)>,
     pub named_fonts: Vec<NamedFontPrediction>,

koharu-core/src/lib.rs

@@ -21,7 +21,7 @@ use ::image::GenericImageView;
 use schemars::JsonSchema;
 use serde::{Deserialize, Serialize};
 use tokio::sync::RwLock;
-use ts_rs::TS;
+use utoipa::ToSchema;
 use uuid::Uuid;
 
 fn new_text_block_id() -> String {
@@ -96,9 +96,8 @@ impl TextBlock {
     }
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, TS, JsonSchema)]
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, JsonSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TextStrokeStyle {
     #[serde(default = "default_true")]
     pub enabled: bool,
@@ -126,9 +125,8 @@ const fn default_stroke_color() -> [u8; 4] {
     [255, 255, 255, 255]
 }
 
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default, TS, JsonSchema)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default, ToSchema, JsonSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub enum TextAlign {
     #[default]
     Left,
@@ -136,9 +134,8 @@ pub enum TextAlign {
     Right,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, TS, JsonSchema)]
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, JsonSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TextStyle {
     pub font_families: Vec<String>,
     pub font_size: Option<f32>,

koharu-core/src/protocol.rs

@@ -1,51 +1,45 @@
 use schemars::JsonSchema;
 use serde::{Deserialize, Serialize};
-use ts_rs::TS;
+use utoipa::ToSchema;
 
 use crate::{Document, FontPrediction, TextBlock, TextShaderEffect, TextStrokeStyle, TextStyle};
 
-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct FontFaceInfo {
     pub family_name: String,
     pub post_script_name: String,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct MetaInfo {
     pub version: String,
     pub ml_device: String,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct BootstrapConfig {
     pub runtime: BootstrapPathConfig,
     pub models: BootstrapPathConfig,
     pub http: BootstrapHttpConfig,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct BootstrapPathConfig {
     pub path: String,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct BootstrapHttpConfig {
     pub proxy: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct DocumentSummary {
     pub id: String,
     pub name: String,
@@ -76,9 +70,8 @@ impl From<&Document> for DocumentSummary {
     }
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TextBlockDetail {
     pub id: String,
     pub x: f32,
@@ -123,9 +116,8 @@ impl From<&TextBlock> for TextBlockDetail {
     }
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct DocumentDetail {
     pub id: String,
     pub path: String,
@@ -134,29 +126,38 @@ pub struct DocumentDetail {
     pub height: u32,
     pub revision: u64,
     pub text_blocks: Vec<TextBlockDetail>,
+    #[schema(value_type = Vec<u8>)]
+    pub image: serde_bytes::ByteBuf,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[schema(value_type = Option<Vec<u8>>)]
+    pub segment: Option<serde_bytes::ByteBuf>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[schema(value_type = Option<Vec<u8>>)]
+    pub inpainted: Option<serde_bytes::ByteBuf>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[schema(value_type = Option<Vec<u8>>)]
+    pub brush_layer: Option<serde_bytes::ByteBuf>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    #[schema(value_type = Option<Vec<u8>>)]
+    pub rendered: Option<serde_bytes::ByteBuf>,
+}
+
+
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct TextBlockInput {
+    pub id: Option<String>,
+    pub x: f32,
+    pub y: f32,
+    pub width: f32,
+    pub height: f32,
+    pub text: Option<String>,
+    pub translation: Option<String>,
+    pub style: Option<TextStyle>,
 }
 
-impl From<&Document> for DocumentDetail {
-    fn from(document: &Document) -> Self {
-        Self {
-            id: document.id.clone(),
-            path: document.path.to_string_lossy().to_string(),
-            name: document.name.clone(),
-            width: document.width,
-            height: document.height,
-            revision: document.revision,
-            text_blocks: document
-                .text_blocks
-                .iter()
-                .map(TextBlockDetail::from)
-                .collect(),
-        }
-    }
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TextBlockPatch {
     pub text: Option<String>,
     pub translation: Option<String>,
@@ -167,9 +168,8 @@ pub struct TextBlockPatch {
     pub style: Option<TextStyle>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct CreateTextBlock {
     pub x: f32,
     pub y: f32,
@@ -177,49 +177,43 @@ pub struct CreateTextBlock {
     pub height: f32,
 }
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "snake_case")]
-#[ts(export)]
 pub enum ImportMode {
     Replace,
     Append,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct ImportResult {
     pub total_count: usize,
     pub documents: Vec<DocumentSummary>,
 }
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "snake_case")]
-#[ts(export)]
 pub enum ExportLayer {
     Rendered,
     Inpainted,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct ExportResult {
     pub count: usize,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct LlmModelInfo {
     pub id: String,
     pub languages: Vec<String>,
     pub source: String,
 }
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "snake_case")]
-#[ts(export)]
 pub enum LlmStateStatus {
     Empty,
     Loading,
@@ -227,9 +221,8 @@ pub enum LlmStateStatus {
     Failed,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct LlmState {
     pub status: LlmStateStatus,
     pub model_id: Option<String>,
@@ -237,9 +230,8 @@ pub struct LlmState {
     pub error: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct LlmLoadRequest {
     pub id: String,
     pub api_key: Option<String>,
@@ -249,17 +241,15 @@ pub struct LlmLoadRequest {
     pub custom_system_prompt: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct LlmPingRequest {
     pub base_url: String,
     pub api_key: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct LlmPingResponse {
     pub ok: bool,
     pub models: Vec<String>,
@@ -267,9 +257,8 @@ pub struct LlmPingResponse {
     pub error: Option<String>,
 }
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "snake_case")]
-#[ts(export)]
 pub enum JobStatus {
     Running,
     Completed,
@@ -277,9 +266,8 @@ pub enum JobStatus {
     Failed,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct JobState {
     pub id: String,
     pub kind: String,
@@ -293,9 +281,8 @@ pub struct JobState {
     pub error: Option<String>,
 }
 
-#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "snake_case")]
-#[ts(export)]
 pub enum TransferStatus {
     Started,
     Downloading,
@@ -303,9 +290,8 @@ pub enum TransferStatus {
     Failed,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct DownloadState {
     pub id: String,
     pub filename: String,
@@ -315,9 +301,8 @@ pub struct DownloadState {
     pub error: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct SnapshotEvent {
     pub documents: Vec<DocumentSummary>,
     pub llm: LlmState,
@@ -325,39 +310,34 @@ pub struct SnapshotEvent {
     pub downloads: Vec<DownloadState>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct DocumentsChangedEvent {
     pub documents: Vec<DocumentSummary>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct DocumentChangedEvent {
     pub document_id: String,
     pub revision: u64,
     pub changed: Vec<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct ApiKeyValue {
     pub api_key: String,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct ApiKeyResponse {
     pub api_key: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct RenderRequest {
     pub text_block_id: Option<String>,
     pub shader_effect: Option<TextShaderEffect>,
@@ -365,17 +345,15 @@ pub struct RenderRequest {
     pub font_family: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct TranslateRequest {
     pub text_block_id: Option<String>,
     pub language: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct PipelineJobRequest {
     pub document_id: Option<String>,
     pub llm_model_id: Option<String>,
@@ -390,9 +368,8 @@ pub struct PipelineJobRequest {
     pub font_family: Option<String>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct Region {
     pub x: u32,
     pub y: u32,
@@ -400,25 +377,22 @@ pub struct Region {
     pub height: u32,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct MaskRegionRequest {
     pub data: Vec<u8>,
     pub region: Option<Region>,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct BrushRegionRequest {
     pub data: Vec<u8>,
     pub region: Region,
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ToSchema)]
 #[serde(rename_all = "camelCase")]
-#[ts(export)]
 pub struct InpaintRegionRequest {
     pub region: Region,
 }

koharu-rpc/Cargo.toml

@@ -17,17 +17,22 @@ koharu-core = { workspace = true }
 koharu-psd = { workspace = true }
 koharu-runtime = { workspace = true }
 anyhow = { workspace = true }
-async-stream = { workspace = true }
 axum = { workspace = true }
 base64 = { workspace = true }
-futures = { workspace = true }
 image = { workspace = true }
 imageproc = { workspace = true }
 rmcp = { workspace = true }
 rmp-serde = { workspace = true }
 rmpv = { workspace = true }
 serde = { workspace = true }
+serde_bytes = { workspace = true }
 serde_json = { workspace = true }
 tokio = { workspace = true }
 tower-http = { workspace = true }
+utoipa = { workspace = true }
+utoipa-axum = { workspace = true }
 tracing = { workspace = true }
+
+[[bin]]
+name = "openapi"
+path = "src/bin/openapi.rs"

koharu-rpc/src/api.rs

@@ -1,20 +1,15 @@
-use std::{convert::Infallible, io::Cursor, time::Duration};
+use std::io::Cursor;
 
 use anyhow::Context;
-use async_stream::stream;
 use axum::{
-    Json, Router,
+    Json,
     body::Body,
     extract::{DefaultBodyLimit, Multipart, Path, Query, State},
     http::{
         HeaderValue, StatusCode,
         header::{CONTENT_DISPOSITION, CONTENT_TYPE},
     },
-    response::{
-        IntoResponse, Response,
-        sse::{Event, KeepAlive, Sse},
-    },
-    routing::{delete, get, patch, post, put},
+    response::{IntoResponse, Response},
 };
 use image::ImageFormat;
 use koharu_app::{
@@ -22,20 +17,20 @@ use koharu_app::{
     state_tx::{self, ChangedField},
 };
 use koharu_core::{
-    ApiKeyGetPayload, ApiKeyResponse, ApiKeySetPayload, ApiKeyValue, BootstrapConfig,
-    CreateTextBlock, Document, DocumentDetail, DocumentSummary, ExportLayer, ExportResult,
-    FileEntry, FontFaceInfo, IndexPayload, InpaintPartialPayload, InpaintRegion, JobState,
-    JobStatus, LlmLoadPayload, LlmLoadRequest, LlmModelInfo, LlmPingRequest, LlmPingResponse,
-    MaskRegionRequest, MetaInfo, OpenDocumentsPayload, PipelineJobRequest, Region, RenderPayload,
-    RenderRequest, SerializableDynamicImage, TextBlock, TextBlockDetail, TextBlockPatch,
-    TranslateRequest, UpdateBrushLayerPayload, UpdateInpaintMaskPayload,
+    ApiKeyResponse, ApiKeyValue, BootstrapConfig, CreateTextBlock, Document, DocumentDetail,
+    DocumentSummary, DownloadState, ExportLayer, ExportResult, FontFaceInfo, InpaintRegion,
+    JobState, JobStatus, LlmLoadRequest, LlmModelInfo, LlmPingRequest, LlmPingResponse,
+    MaskRegionRequest, MetaInfo, PipelineJobRequest, Region, RenderRequest, TextBlock,
+    TextBlockDetail, TextBlockInput, TextBlockPatch, TranslateRequest,
 };
 use koharu_psd::{PsdExportOptions, TextLayerMode};
-use serde::Deserialize;
+use serde::{Deserialize, Serialize};
+use utoipa::IntoParams;
+use utoipa_axum::{router::OpenApiRouter, routes};
 
 use crate::{
-    events::{ApiEvent, EventHub},
     shared::{SharedState, get_resources},
+    tracker::Tracker,
 };
 
 const MAX_BODY_SIZE: usize = 1024 * 1024 * 1024;
@@ -43,7 +38,7 @@ const MAX_BODY_SIZE: usize = 1024 * 1024 * 1024;
 #[derive(Clone)]
 pub struct ApiState {
     pub resources: SharedState,
-    pub events: EventHub,
+    pub tracker: Tracker,
 }
 
 impl ApiState {
@@ -52,84 +47,58 @@ impl ApiState {
     }
 }
 
-pub fn router(resources: SharedState, events: EventHub) -> Router {
-    let state = ApiState { resources, events };
-
-    Router::new()
-        .route("/config", get(get_config).put(put_config))
-        .route("/initialize", post(initialize_app))
-        .route("/meta", get(get_meta))
-        .route("/fonts", get(get_fonts))
-        .route("/documents", get(list_documents))
-        .route("/documents/import", post(import_documents))
-        .route("/documents/{document_id}", get(get_document))
-        .route("/documents/{document_id}/thumbnail", get(get_thumbnail))
-        .route(
-            "/documents/{document_id}/layers/{layer}",
-            get(get_document_layer),
-        )
-        .route("/documents/{document_id}/detect", post(detect_document))
-        .route("/documents/{document_id}/ocr", post(ocr_document))
-        .route("/documents/{document_id}/inpaint", post(inpaint_document))
-        .route("/documents/{document_id}/render", post(render_document))
-        .route(
-            "/documents/{document_id}/translate",
-            post(translate_document),
-        )
-        .route(
-            "/documents/{document_id}/mask-region",
-            put(update_mask_region),
-        )
-        .route(
-            "/documents/{document_id}/brush-region",
-            put(update_brush_region),
-        )
-        .route(
-            "/documents/{document_id}/inpaint-region",
-            post(inpaint_region),
-        )
-        .route(
-            "/documents/{document_id}/text-blocks",
-            post(create_text_block),
-        )
-        .route(
-            "/documents/{document_id}/text-blocks/{text_block_id}",
-            patch(patch_text_block).delete(delete_text_block),
-        )
-        .route("/documents/{document_id}/export", get(export_document))
-        .route(
-            "/documents/{document_id}/export/psd",
-            get(export_document_psd),
-        )
-        .route("/llm/models", get(list_llm_models))
-        .route("/llm/state", get(get_llm_state))
-        .route("/llm/load", post(load_llm))
-        .route("/llm/offload", post(offload_llm))
-        .route("/llm/ping", post(ping_llm))
-        .route(
-            "/providers/{provider}/api-key",
-            get(get_api_key).put(set_api_key),
-        )
-        .route("/jobs/pipeline", post(start_pipeline_job))
-        .route("/jobs/{job_id}", delete(cancel_pipeline_job))
-        .route("/exports", post(export_all))
-        .route("/events", get(events_stream))
+pub fn api() -> (axum::Router<ApiState>, utoipa::openapi::OpenApi) {
+    OpenApiRouter::default()
+        .routes(routes!(list_documents, import_documents))
+        .routes(routes!(get_document))
+        .routes(routes!(get_document_thumbnail))
+        .routes(routes!(detect_document))
+        .routes(routes!(recognize_document))
+        .routes(routes!(inpaint_document))
+        .routes(routes!(render_document))
+        .routes(routes!(translate_document))
+        .routes(routes!(update_mask))
+        .routes(routes!(update_brush_layer))
+        .routes(routes!(inpaint_region))
+        .routes(routes!(create_text_block, put_text_blocks))
+        .routes(routes!(patch_text_block, delete_text_block))
+        .routes(routes!(export_document))
+        .routes(routes!(batch_export))
+        .routes(routes!(get_llm, load_llm, unload_llm))
+        .routes(routes!(list_llm_models))
+        .routes(routes!(check_llm_health))
+        .routes(routes!(get_api_key, set_api_key))
+        .routes(routes!(start_pipeline))
+        .routes(routes!(list_jobs))
+        .routes(routes!(get_job, cancel_job))
+        .routes(routes!(list_downloads))
+        .routes(routes!(get_meta))
+        .routes(routes!(list_fonts))
+        .routes(routes!(get_config, update_config))
+        .routes(routes!(initialize))
+        .split_for_parts()
+}
+
+pub fn router(resources: SharedState, tracker: Tracker) -> axum::Router {
+    let state = ApiState { resources, tracker };
+    let (router, _) = api();
+    router
         .layer(DefaultBodyLimit::max(MAX_BODY_SIZE))
         .with_state(state)
 }
 
 type ApiResult<T> = Result<T, ApiError>;
 
-#[derive(Debug)]
+#[derive(Debug, Serialize, utoipa::ToSchema)]
 pub struct ApiError {
-    status: StatusCode,
-    message: String,
+    pub status: u16,
+    pub message: String,
 }
 
 impl ApiError {
     fn new(status: StatusCode, message: impl Into<String>) -> Self {
         Self {
-            status,
+            status: status.as_u16(),
             message: message.into(),
         }
     }
@@ -168,35 +137,75 @@ impl From<anyhow::Error> for ApiError {
 
 impl IntoResponse for ApiError {
     fn into_response(self) -> Response {
-        (self.status, self.message).into_response()
+        let status =
+            StatusCode::from_u16(self.status).unwrap_or(StatusCode::INTERNAL_SERVER_ERROR);
+        (status, Json(self)).into_response()
     }
 }
 
-#[derive(Debug, Deserialize)]
+#[derive(Debug, utoipa::ToSchema)]
+#[allow(dead_code)]
+struct MultipartUpload {
+    #[schema(value_type = Vec<String>, format = Binary)]
+    files: Vec<Vec<u8>>,
+}
+
+#[derive(Debug, Deserialize, IntoParams)]
 #[serde(rename_all = "camelCase")]
 struct ImportQuery {
     mode: Option<koharu_core::ImportMode>,
 }
 
-#[derive(Debug, Deserialize)]
+#[derive(Debug, Deserialize, IntoParams)]
+#[serde(rename_all = "camelCase")]
+struct LlmModelsQuery {
+    language: Option<String>,
+    openai_compatible_base_url: Option<String>,
+}
+
+#[derive(Debug, Deserialize, IntoParams)]
 #[serde(rename_all = "camelCase")]
-struct LayerQuery {
+struct ExportQuery {
     layer: Option<ExportLayer>,
 }
 
-#[derive(Debug, Deserialize)]
+#[derive(Debug, Deserialize, utoipa::ToSchema)]
 #[serde(rename_all = "camelCase")]
-struct LlmModelsQuery {
-    language: Option<String>,
-    openai_compatible_base_url: Option<String>,
+struct ExportBatchRequest {
+    layer: Option<ExportLayer>,
 }
 
+// ---------------------------------------------------------------------------
+// System
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/config",
+    operation_id = "getConfig",
+    tag = "system",
+    responses(
+        (status = 200, body = BootstrapConfig),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn get_config(State(state): State<ApiState>) -> ApiResult<Json<BootstrapConfig>> {
     let config = state.resources.get_config().map_err(ApiError::internal)?;
     Ok(Json(config))
 }
 
-async fn put_config(
+#[utoipa::path(
+    put,
+    path = "/config",
+    operation_id = "updateConfig",
+    tag = "system",
+    request_body = BootstrapConfig,
+    responses(
+        (status = 200, body = BootstrapConfig),
+        (status = 400, body = ApiError),
+    ),
+)]
+async fn update_config(
     State(state): State<ApiState>,
     Json(config): Json<BootstrapConfig>,
 ) -> ApiResult<Json<BootstrapConfig>> {
@@ -204,7 +213,18 @@ async fn put_config(
     Ok(Json(saved))
 }
 
-async fn initialize_app(State(state): State<ApiState>) -> ApiResult<StatusCode> {
+#[utoipa::path(
+    post,
+    path = "/initialize",
+    operation_id = "initialize",
+    tag = "system",
+    responses(
+        (status = 204),
+        (status = 409, body = ApiError),
+        (status = 500, body = ApiError),
+    ),
+)]
+async fn initialize(State(state): State<ApiState>) -> ApiResult<StatusCode> {
     match state.resources.initialize().await {
         Ok(()) => Ok(StatusCode::NO_CONTENT),
         Err(error) => {
@@ -218,6 +238,16 @@ async fn initialize_app(State(state): State<ApiState>) -> ApiResult<StatusCode>
     }
 }
 
+#[utoipa::path(
+    get,
+    path = "/meta",
+    operation_id = "getMeta",
+    tag = "system",
+    responses(
+        (status = 200, body = MetaInfo),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn get_meta(State(state): State<ApiState>) -> ApiResult<Json<MetaInfo>> {
     let resources = state.resources()?;
     let device = operations::device(resources.clone()).await?;
@@ -227,7 +257,17 @@ async fn get_meta(State(state): State<ApiState>) -> ApiResult<Json<MetaInfo>> {
     }))
 }
 
-async fn get_fonts(State(state): State<ApiState>) -> ApiResult<Json<Vec<FontFaceInfo>>> {
+#[utoipa::path(
+    get,
+    path = "/fonts",
+    operation_id = "listFonts",
+    tag = "system",
+    responses(
+        (status = 200, body = Vec<FontFaceInfo>),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn list_fonts(State(state): State<ApiState>) -> ApiResult<Json<Vec<FontFaceInfo>>> {
     let resources = state.resources()?;
     let fonts = operations::list_font_families(resources)
         .await
@@ -235,6 +275,20 @@ async fn get_fonts(State(state): State<ApiState>) -> ApiResult<Json<Vec<FontFace
     Ok(Json(fonts))
 }
 
+// ---------------------------------------------------------------------------
+// Documents
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/documents",
+    operation_id = "listDocuments",
+    tag = "documents",
+    responses(
+        (status = 200, body = Vec<DocumentSummary>),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn list_documents(State(state): State<ApiState>) -> ApiResult<Json<Vec<DocumentSummary>>> {
     let resources = state.resources()?;
     let guard = resources.state.read().await;
@@ -242,6 +296,18 @@ async fn list_documents(State(state): State<ApiState>) -> ApiResult<Json<Vec<Doc
     Ok(Json(documents))
 }
 
+#[utoipa::path(
+    get,
+    path = "/documents/{document_id}",
+    operation_id = "getDocument",
+    tag = "documents",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 200, body = DocumentDetail),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn get_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
@@ -253,13 +319,58 @@ async fn get_document(
         .iter()
         .find(|d| d.id == document_id)
         .ok_or_else(|| ApiError::not_found("Document not found"))?;
-    Ok(Json(DocumentDetail::from(doc)))
+
+    let image = serde_bytes::ByteBuf::from(encode_webp(&doc.image)?);
+    let segment = doc.segment.as_ref().map(|s| encode_webp(s).map(serde_bytes::ByteBuf::from)).transpose()?;
+    let inpainted = doc.inpainted.as_ref().map(|s| encode_webp(s).map(serde_bytes::ByteBuf::from)).transpose()?;
+    let brush_layer = doc.brush_layer.as_ref().map(|s| encode_webp(s).map(serde_bytes::ByteBuf::from)).transpose()?;
+    let rendered = doc.rendered.as_ref().map(|s| encode_webp(s).map(serde_bytes::ByteBuf::from)).transpose()?;
+
+    let text_blocks = doc.text_blocks.iter().map(koharu_core::TextBlockDetail::from).collect();
+
+    let detail = DocumentDetail {
+        id: doc.id.clone(),
+        path: doc.path.to_string_lossy().to_string(),
+        name: doc.name.clone(),
+        width: doc.width,
+        height: doc.height,
+        revision: doc.revision,
+        text_blocks,
+        image,
+        segment,
+        inpainted,
+        brush_layer,
+        rendered,
+    };
+
+    drop(guard);
+    Ok(Json(detail))
 }
 
-async fn get_thumbnail(
+#[derive(Debug, Deserialize, IntoParams)]
+#[serde(rename_all = "camelCase")]
+struct ThumbnailQuery {
+    size: Option<u32>,
+}
+
+#[utoipa::path(
+    get,
+    path = "/documents/{document_id}/thumbnail",
+    operation_id = "getDocumentThumbnail",
+    tag = "documents",
+    params(("document_id" = String, Path,), ThumbnailQuery),
+    responses(
+        (status = 200, content_type = "image/webp", body = inline(String)),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn get_document_thumbnail(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
+    Query(query): Query<ThumbnailQuery>,
 ) -> ApiResult<Response> {
+    let size = query.size.unwrap_or(200).min(800);
     let resources = state.resources()?;
     let guard = resources.state.read().await;
     let doc = guard
@@ -268,29 +379,25 @@ async fn get_thumbnail(
         .find(|d| d.id == document_id)
         .ok_or_else(|| ApiError::not_found("Document not found"))?;
     let source = doc.rendered.as_ref().unwrap_or(&doc.image);
-    let thumbnail = source.thumbnail(200, 200);
+    let thumbnail = source.thumbnail(size, size);
     let bytes = encode_webp(&thumbnail.into())?;
     drop(guard);
     Ok(binary_response(bytes, "image/webp", None))
 }
 
-async fn get_document_layer(
-    State(state): State<ApiState>,
-    Path((document_id, layer)): Path<(String, String)>,
-) -> ApiResult<Response> {
-    let resources = state.resources()?;
-    let guard = resources.state.read().await;
-    let doc = guard
-        .documents
-        .iter()
-        .find(|d| d.id == document_id)
-        .ok_or_else(|| ApiError::not_found("Document not found"))?;
-    let image = document_layer(doc, &layer)?;
-    let bytes = encode_webp(image)?;
-    drop(guard);
-    Ok(binary_response(bytes, "image/webp", None))
-}
-
+#[utoipa::path(
+    post,
+    path = "/documents",
+    operation_id = "importDocuments",
+    tag = "documents",
+    params(ImportQuery),
+    request_body(content_type = "multipart/form-data", content = inline(MultipartUpload)),
+    responses(
+        (status = 200, body = koharu_core::ImportResult),
+        (status = 400, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn import_documents(
     State(state): State<ApiState>,
     Query(query): Query<ImportQuery>,
@@ -312,7 +419,7 @@ async fn import_documents(
             .bytes()
             .await
             .map_err(|error| ApiError::bad_request(error.to_string()))?;
-        files.push(FileEntry {
+        files.push(koharu_core::FileEntry {
             name: filename,
             data: data.to_vec(),
         });
@@ -322,7 +429,7 @@ async fn import_documents(
         return Err(ApiError::bad_request("No files uploaded"));
     }
 
-    let payload = OpenDocumentsPayload { files };
+    let payload = koharu_core::OpenDocumentsPayload { files };
     match query.mode.unwrap_or(koharu_core::ImportMode::Replace) {
         koharu_core::ImportMode::Replace => {
             operations::open_documents(resources.clone(), payload).await?;
@@ -344,36 +451,89 @@ async fn import_documents(
     }))
 }
 
+// ---------------------------------------------------------------------------
+// Processing
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/detect",
+    operation_id = "detectDocument",
+    tag = "processing",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn detect_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
 ) -> ApiResult<StatusCode> {
     let resources = state.resources()?;
     let (index, _) = find_document(&resources, &document_id).await?;
-    operations::detect(resources, IndexPayload { index }).await?;
+    operations::detect(resources, koharu_core::IndexPayload { index }).await?;
     Ok(StatusCode::NO_CONTENT)
 }
 
-async fn ocr_document(
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/recognize",
+    operation_id = "recognizeDocument",
+    tag = "processing",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn recognize_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
 ) -> ApiResult<StatusCode> {
     let resources = state.resources()?;
     let (index, _) = find_document(&resources, &document_id).await?;
-    operations::ocr(resources, IndexPayload { index }).await?;
+    operations::ocr(resources, koharu_core::IndexPayload { index }).await?;
     Ok(StatusCode::NO_CONTENT)
 }
 
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/inpaint",
+    operation_id = "inpaintDocument",
+    tag = "processing",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn inpaint_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
 ) -> ApiResult<StatusCode> {
     let resources = state.resources()?;
     let (index, _) = find_document(&resources, &document_id).await?;
-    operations::inpaint(resources, IndexPayload { index }).await?;
+    operations::inpaint(resources, koharu_core::IndexPayload { index }).await?;
     Ok(StatusCode::NO_CONTENT)
 }
 
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/render",
+    operation_id = "renderDocument",
+    tag = "processing",
+    params(("document_id" = String, Path,)),
+    request_body = RenderRequest,
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn render_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
@@ -389,7 +549,7 @@ async fn render_document(
 
     operations::render(
         resources,
-        RenderPayload {
+        koharu_core::RenderPayload {
             index,
             text_block_index,
             shader_effect: request.shader_effect,
@@ -402,6 +562,19 @@ async fn render_document(
     Ok(StatusCode::NO_CONTENT)
 }
 
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/translate",
+    operation_id = "translateDocument",
+    tag = "processing",
+    params(("document_id" = String, Path,)),
+    request_body = TranslateRequest,
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn translate_document(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
@@ -428,7 +601,24 @@ async fn translate_document(
     Ok(StatusCode::NO_CONTENT)
 }
 
-async fn update_mask_region(
+// ---------------------------------------------------------------------------
+// Regions
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    put,
+    path = "/documents/{document_id}/mask",
+    operation_id = "updateMask",
+    tag = "regions",
+    params(("document_id" = String, Path,)),
+    request_body = MaskRegionRequest,
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn update_mask(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
     Json(request): Json<MaskRegionRequest>,
@@ -437,7 +627,7 @@ async fn update_mask_region(
     let (index, _) = find_document(&resources, &document_id).await?;
     operations::update_inpaint_mask(
         resources,
-        UpdateInpaintMaskPayload {
+        koharu_core::UpdateInpaintMaskPayload {
             index,
             mask: request.data,
             region: request.region.map(to_inpaint_region),
@@ -447,7 +637,19 @@ async fn update_mask_region(
     Ok(StatusCode::NO_CONTENT)
 }
 
-async fn update_brush_region(
+#[utoipa::path(
+    put,
+    path = "/documents/{document_id}/brush-layer",
+    operation_id = "updateBrushLayer",
+    tag = "regions",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn update_brush_layer(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
     Json(request): Json<koharu_core::BrushRegionRequest>,
@@ -456,7 +658,7 @@ async fn update_brush_region(
     let (index, _) = find_document(&resources, &document_id).await?;
     operations::update_brush_layer(
         resources,
-        UpdateBrushLayerPayload {
+        koharu_core::UpdateBrushLayerPayload {
             index,
             patch: request.data,
             region: to_inpaint_region(request.region),
@@ -466,6 +668,18 @@ async fn update_brush_region(
     Ok(StatusCode::NO_CONTENT)
 }
 
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/inpaint-region",
+    operation_id = "inpaintRegion",
+    tag = "regions",
+    params(("document_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn inpaint_region(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
@@ -475,7 +689,7 @@ async fn inpaint_region(
     let (index, _) = find_document(&resources, &document_id).await?;
     operations::inpaint_partial(
         resources,
-        InpaintPartialPayload {
+        koharu_core::InpaintPartialPayload {
             index,
             region: to_inpaint_region(request.region),
         },
@@ -484,6 +698,23 @@ async fn inpaint_region(
     Ok(StatusCode::NO_CONTENT)
 }
 
+// ---------------------------------------------------------------------------
+// Text Blocks
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    post,
+    path = "/documents/{document_id}/text-blocks",
+    operation_id = "createTextBlock",
+    tag = "text-blocks",
+    params(("document_id" = String, Path,)),
+    request_body = CreateTextBlock,
+    responses(
+        (status = 200, body = TextBlockDetail),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn create_text_block(
     State(state): State<ApiState>,
     Path(document_id): Path<String>,
@@ -519,6 +750,131 @@ async fn create_text_block(
     Ok(Json(detail))
 }
 
+#[utoipa::path(
+    put,
+    path = "/documents/{document_id}/text-blocks",
+    operation_id = "putTextBlocks",
+    tag = "text-blocks",
+    params(("document_id" = String, Path,)),
+    request_body = Vec<TextBlockInput>,
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn put_text_blocks(
+    State(state): State<ApiState>,
+    Path(document_id): Path<String>,
+    Json(inputs): Json<Vec<TextBlockInput>>,
+) -> ApiResult<StatusCode> {
+    let resources = state.resources()?;
+    let (index, _) = find_document(&resources, &document_id).await?;
+
+    let any_content_changed = state_tx::mutate_doc(
+        &resources.state,
+        index,
+        &[ChangedField::TextBlocks],
+        |document| {
+            let mut any_changed = false;
+
+            // Build a set of incoming IDs for deletion detection
+            let incoming_ids: std::collections::HashSet<&str> = inputs
+                .iter()
+                .filter_map(|input| input.id.as_deref())
+                .collect();
+
+            // Delete blocks not present in the incoming array
+            let before_len = document.text_blocks.len();
+            document
+                .text_blocks
+                .retain(|block| incoming_ids.contains(block.id.as_str()));
+            if document.text_blocks.len() != before_len {
+                any_changed = true;
+            }
+
+            for input in &inputs {
+                if let Some(ref id) = input.id {
+                    // Update existing block
+                    if let Some(block) = document
+                        .text_blocks
+                        .iter_mut()
+                        .find(|b| &b.id == id)
+                    {
+                        let patch = TextBlockPatch {
+                            text: input.text.clone(),
+                            translation: input.translation.clone(),
+                            x: Some(input.x),
+                            y: Some(input.y),
+                            width: Some(input.width),
+                            height: Some(input.height),
+                            style: input.style.clone(),
+                        };
+                        let had_render = block.rendered.is_some();
+                        apply_text_block_patch(block, patch);
+                        // Content changed if the render was invalidated
+                        if had_render && block.rendered.is_none() {
+                            any_changed = true;
+                        }
+                    }
+                } else {
+                    // Create new block
+                    let mut block = TextBlock {
+                        x: input.x,
+                        y: input.y,
+                        width: input.width,
+                        height: input.height,
+                        text: input.text.clone(),
+                        translation: input.translation.clone(),
+                        style: input.style.clone(),
+                        confidence: 1.0,
+                        ..Default::default()
+                    };
+                    block.set_layout_seed(block.x, block.y, block.width, block.height);
+                    document.text_blocks.push(block);
+                    any_changed = true;
+                }
+            }
+
+            Ok(any_changed)
+        },
+    )
+    .await?;
+
+    // Auto-render if any block content/geometry changed
+    if any_content_changed {
+        let _ = operations::render(
+            resources,
+            koharu_core::RenderPayload {
+                index,
+                text_block_index: None,
+                shader_effect: None,
+                shader_stroke: None,
+                font_family: None,
+            },
+        )
+        .await;
+    }
+
+    Ok(StatusCode::NO_CONTENT)
+}
+
+#[utoipa::path(
+    patch,
+    path = "/documents/{document_id}/text-blocks/{text_block_id}",
+    operation_id = "patchTextBlock",
+    tag = "text-blocks",
+    params(
+        ("document_id" = String, Path,),
+        ("text_block_id" = String, Path,),
+    ),
+    request_body = TextBlockPatch,
+    responses(
+        (status = 200, body = TextBlockDetail),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn patch_text_block(
     State(state): State<ApiState>,
     Path((document_id, text_block_id)): Path<(String, String)>,
@@ -546,6 +902,21 @@ async fn patch_text_block(
     Ok(Json(detail))
 }
 
+#[utoipa::path(
+    delete,
+    path = "/documents/{document_id}/text-blocks/{text_block_id}",
+    operation_id = "deleteTextBlock",
+    tag = "text-blocks",
+    params(
+        ("document_id" = String, Path,),
+        ("text_block_id" = String, Path,),
+    ),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn delete_text_block(
     State(state): State<ApiState>,
     Path((document_id, text_block_id)): Path<(String, String)>,
@@ -572,6 +943,21 @@ async fn delete_text_block(
     Ok(StatusCode::NO_CONTENT)
 }
 
+// ---------------------------------------------------------------------------
+// LLM
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/llm/models",
+    operation_id = "listLlmModels",
+    tag = "llm",
+    params(LlmModelsQuery),
+    responses(
+        (status = 200, body = Vec<LlmModelInfo>),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn list_llm_models(
     State(state): State<ApiState>,
     Query(query): Query<LlmModelsQuery>,
@@ -595,11 +981,33 @@ async fn list_llm_models(
     Ok(Json(models))
 }
 
-async fn get_llm_state(State(state): State<ApiState>) -> ApiResult<Json<koharu_core::LlmState>> {
+#[utoipa::path(
+    get,
+    path = "/llm",
+    operation_id = "getLlm",
+    tag = "llm",
+    responses(
+        (status = 200, body = koharu_core::LlmState),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn get_llm(State(state): State<ApiState>) -> ApiResult<Json<koharu_core::LlmState>> {
     let resources = state.resources()?;
     Ok(Json(resources.llm.snapshot().await))
 }
 
+#[utoipa::path(
+    put,
+    path = "/llm",
+    operation_id = "loadLlm",
+    tag = "llm",
+    request_body = LlmLoadRequest,
+    responses(
+        (status = 200, body = koharu_core::LlmState),
+        (status = 400, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn load_llm(
     State(state): State<ApiState>,
     Json(request): Json<LlmLoadRequest>,
@@ -607,7 +1015,7 @@ async fn load_llm(
     let resources = state.resources()?;
     operations::llm_load(
         resources.clone(),
-        LlmLoadPayload {
+        koharu_core::LlmLoadPayload {
             id: request.id,
             api_key: request.api_key,
             base_url: request.base_url,
@@ -620,13 +1028,33 @@ async fn load_llm(
     Ok(Json(resources.llm.snapshot().await))
 }
 
-async fn offload_llm(State(state): State<ApiState>) -> ApiResult<Json<koharu_core::LlmState>> {
+#[utoipa::path(
+    delete,
+    path = "/llm",
+    operation_id = "unloadLlm",
+    tag = "llm",
+    responses(
+        (status = 200, body = koharu_core::LlmState),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn unload_llm(State(state): State<ApiState>) -> ApiResult<Json<koharu_core::LlmState>> {
     let resources = state.resources()?;
     operations::llm_offload(resources.clone()).await?;
     Ok(Json(resources.llm.snapshot().await))
 }
 
-async fn ping_llm(
+#[utoipa::path(
+    post,
+    path = "/llm/health",
+    operation_id = "checkLlmHealth",
+    tag = "llm",
+    request_body = LlmPingRequest,
+    responses(
+        (status = 200, body = LlmPingResponse),
+    ),
+)]
+async fn check_llm_health(
     State(state): State<ApiState>,
     Json(request): Json<LlmPingRequest>,
 ) -> ApiResult<Json<LlmPingResponse>> {
@@ -652,17 +1080,45 @@ async fn ping_llm(
     }
 }
 
+// ---------------------------------------------------------------------------
+// Providers
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/providers/{provider}/api-key",
+    operation_id = "getApiKey",
+    tag = "providers",
+    params(("provider" = String, Path,)),
+    responses(
+        (status = 200, body = ApiKeyResponse),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn get_api_key(
     State(state): State<ApiState>,
     Path(provider): Path<String>,
 ) -> ApiResult<Json<ApiKeyResponse>> {
     let resources = state.resources()?;
-    let result = operations::get_api_key(resources, ApiKeyGetPayload { provider }).await?;
+    let result =
+        operations::get_api_key(resources, koharu_core::ApiKeyGetPayload { provider }).await?;
     Ok(Json(ApiKeyResponse {
         api_key: result.api_key,
     }))
 }
 
+#[utoipa::path(
+    put,
+    path = "/providers/{provider}/api-key",
+    operation_id = "setApiKey",
+    tag = "providers",
+    params(("provider" = String, Path,)),
+    request_body = ApiKeyValue,
+    responses(
+        (status = 204),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn set_api_key(
     State(state): State<ApiState>,
     Path(provider): Path<String>,
@@ -671,7 +1127,7 @@ async fn set_api_key(
     let resources = state.resources()?;
     operations::set_api_key(
         resources,
-        ApiKeySetPayload {
+        koharu_core::ApiKeySetPayload {
             provider,
             api_key: request.api_key,
         },
@@ -680,7 +1136,22 @@ async fn set_api_key(
     Ok(StatusCode::NO_CONTENT)
 }
 
-async fn start_pipeline_job(
+// ---------------------------------------------------------------------------
+// Jobs
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    post,
+    path = "/jobs/pipeline",
+    operation_id = "startPipeline",
+    tag = "jobs",
+    request_body = PipelineJobRequest,
+    responses(
+        (status = 200, body = JobState),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn start_pipeline(
     State(state): State<ApiState>,
     Json(request): Json<PipelineJobRequest>,
 ) -> ApiResult<Json<JobState>> {
@@ -725,12 +1196,60 @@ async fn start_pipeline_job(
         overall_percent: 0,
         error: None,
     };
-    state.events.publish_job(job.clone()).await;
+    state.tracker.publish_job(job.clone()).await;
 
     Ok(Json(job))
 }
 
-async fn cancel_pipeline_job(
+#[utoipa::path(
+    get,
+    path = "/jobs",
+    operation_id = "listJobs",
+    tag = "jobs",
+    responses(
+        (status = 200, body = Vec<JobState>),
+    ),
+)]
+async fn list_jobs(State(state): State<ApiState>) -> Json<Vec<JobState>> {
+    Json(state.tracker.list_jobs().await)
+}
+
+#[utoipa::path(
+    get,
+    path = "/jobs/{job_id}",
+    operation_id = "getJob",
+    tag = "jobs",
+    params(("job_id" = String, Path,)),
+    responses(
+        (status = 200, body = JobState),
+        (status = 404, body = ApiError),
+    ),
+)]
+async fn get_job(
+    State(state): State<ApiState>,
+    Path(job_id): Path<String>,
+) -> ApiResult<Json<JobState>> {
+    state
+        .tracker
+        .get_job(&job_id)
+        .await
+        .map(Json)
+        .ok_or_else(|| ApiError::not_found(format!("Job not found: {job_id}")))
+}
+
+#[utoipa::path(
+    delete,
+    path = "/jobs/{job_id}",
+    operation_id = "cancelJob",
+    tag = "jobs",
+    params(("job_id" = String, Path,)),
+    responses(
+        (status = 204),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn cancel_job(
     State(state): State<ApiState>,
     Path(job_id): Path<String>,
 ) -> ApiResult<StatusCode> {
@@ -750,13 +1269,61 @@ async fn cancel_pipeline_job(
     Ok(StatusCode::NO_CONTENT)
 }
 
+// ---------------------------------------------------------------------------
+// Downloads
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/downloads",
+    operation_id = "listDownloads",
+    tag = "downloads",
+    responses(
+        (status = 200, body = Vec<DownloadState>),
+    ),
+)]
+async fn list_downloads(State(state): State<ApiState>) -> Json<Vec<DownloadState>> {
+    Json(state.tracker.list_downloads().await)
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+#[utoipa::path(
+    get,
+    path = "/documents/{document_id}/export/{format}",
+    operation_id = "exportDocument",
+    tag = "exports",
+    params(
+        ("document_id" = String, Path,),
+        ("format" = String, Path,),
+        ExportQuery,
+    ),
+    responses(
+        (status = 200, content_type = "application/octet-stream", body = inline(String)),
+        (status = 404, body = ApiError),
+        (status = 503, body = ApiError),
+    ),
+)]
 async fn export_document(
     State(state): State<ApiState>,
-    Path(document_id): Path<String>,
-    Query(query): Query<LayerQuery>,
+    Path((document_id, format)): Path<(String, String)>,
+    Query(query): Query<ExportQuery>,
 ) -> ApiResult<Response> {
     let resources = state.resources()?;
     let (_, document) = find_document(&resources, &document_id).await?;
+
+    if format == "psd" {
+        let data = koharu_psd::export_document(&document, &app_psd_export_options())
+            .map_err(|error| ApiError::bad_request(error.to_string()))?;
+        return Ok(binary_response(
+            data,
+            "image/vnd.adobe.photoshop",
+            Some(psd_export_filename(&document)),
+        ));
+    }
+
     let layer = query.layer.unwrap_or(ExportLayer::Rendered);
     let (image, filename) = export_target(&document, layer)?;
     let ext = document
@@ -770,83 +1337,29 @@ async fn export_document(
     Ok(binary_response(data, content_type, Some(filename)))
 }
 
-async fn export_document_psd(
+#[utoipa::path(
+    post,
+    path = "/exports",
+    operation_id = "batchExport",
+    tag = "exports",
+    request_body = ExportBatchRequest,
+    responses(
+        (status = 200, body = ExportResult),
+        (status = 503, body = ApiError),
+    ),
+)]
+async fn batch_export(
     State(state): State<ApiState>,
-    Path(document_id): Path<String>,
-) -> ApiResult<Response> {
-    let resources = state.resources()?;
-    let (_, document) = find_document(&resources, &document_id).await?;
-    let data = koharu_psd::export_document(&document, &app_psd_export_options())
-        .map_err(|error| ApiError::bad_request(error.to_string()))?;
-    Ok(binary_response(
-        data,
-        "image/vnd.adobe.photoshop",
-        Some(psd_export_filename(&document)),
-    ))
-}
-
-async fn export_all(
-    State(state): State<ApiState>,
-    Query(query): Query<LayerQuery>,
+    Json(request): Json<ExportBatchRequest>,
 ) -> ApiResult<Json<ExportResult>> {
     let resources = state.resources()?;
-    let count = match query.layer.unwrap_or(ExportLayer::Rendered) {
+    let count = match request.layer.unwrap_or(ExportLayer::Rendered) {
         ExportLayer::Rendered => operations::export_all_rendered(resources).await?,
         ExportLayer::Inpainted => operations::export_all_inpainted(resources).await?,
     };
     Ok(Json(ExportResult { count }))
 }
 
-async fn events_stream(
-    State(state): State<ApiState>,
-) -> ApiResult<Sse<impl futures::Stream<Item = Result<Event, Infallible>>>> {
-    let events = state.events.clone();
-    let snapshot = events.snapshot().await?;
-    let mut rx = events.subscribe();
-
-    let stream = stream! {
-        yield Ok(sse_event("snapshot", &snapshot));
-        loop {
-            match rx.recv().await {
-                Ok(event) => {
-                    if let Some(event) = api_event_to_sse(event) {
-                        yield Ok(event);
-                    }
-                }
-                Err(tokio::sync::broadcast::error::RecvError::Lagged(n)) => {
-                    tracing::warn!("SSE client lagged behind by {n} events, re-sending snapshot");
-                    match events.snapshot().await {
-                        Ok(snap) => yield Ok(sse_event("snapshot", &snap)),
-                        Err(e) => tracing::warn!("Failed to build resync snapshot: {e}"),
-                    }
-                }
-                Err(tokio::sync::broadcast::error::RecvError::Closed) => break,
-            }
-        }
-    };
-
-    Ok(Sse::new(stream).keep_alive(
-        KeepAlive::new()
-            .interval(Duration::from_secs(15))
-            .text("keep-alive"),
-    ))
-}
-
-fn api_event_to_sse(event: ApiEvent) -> Option<Event> {
-    match event {
-        ApiEvent::DocumentsChanged(payload) => Some(sse_event("documents.changed", &payload)),
-        ApiEvent::DocumentChanged(payload) => Some(sse_event("document.changed", &payload)),
-        ApiEvent::JobChanged(payload) => Some(sse_event("job.changed", &payload)),
-        ApiEvent::DownloadChanged(payload) => Some(sse_event("download.changed", &payload)),
-        ApiEvent::LlmChanged(payload) => Some(sse_event("llm.changed", &payload)),
-    }
-}
-
-fn sse_event<T: serde::Serialize>(name: &str, payload: &T) -> Event {
-    let data = serde_json::to_string(payload).unwrap_or_else(|_| "{}".to_string());
-    Event::default().event(name).data(data)
-}
-
 async fn find_document(
     resources: &AppResources,
     document_id: &str,
@@ -868,37 +1381,11 @@ fn find_text_block_index(document: &Document, text_block_id: &str) -> ApiResult<
         .ok_or_else(|| ApiError::not_found(format!("Text block not found: {text_block_id}")))
 }
 
-fn document_layer<'a>(
-    document: &'a Document,
-    layer: &str,
-) -> ApiResult<&'a SerializableDynamicImage> {
-    match layer {
-        "original" => Ok(&document.image),
-        "segment" => document
-            .segment
-            .as_ref()
-            .ok_or_else(|| ApiError::not_found("No segment layer available")),
-        "inpainted" => document
-            .inpainted
-            .as_ref()
-            .ok_or_else(|| ApiError::not_found("No inpainted layer available")),
-        "rendered" => document
-            .rendered
-            .as_ref()
-            .ok_or_else(|| ApiError::not_found("No rendered layer available")),
-        "brush" => document
-            .brush_layer
-            .as_ref()
-            .ok_or_else(|| ApiError::not_found("No brush layer available")),
-        other => Err(ApiError::bad_request(format!("Unknown layer: {other}"))),
-    }
-}
-
-fn encode_webp(image: &SerializableDynamicImage) -> ApiResult<Vec<u8>> {
+fn encode_webp(image: &koharu_core::SerializableDynamicImage) -> ApiResult<Vec<u8>> {
     encode_image(image, "webp")
 }
 
-fn encode_image(image: &SerializableDynamicImage, ext: &str) -> ApiResult<Vec<u8>> {
+fn encode_image(image: &koharu_core::SerializableDynamicImage, ext: &str) -> ApiResult<Vec<u8>> {
     let format = ImageFormat::from_extension(ext).unwrap_or(ImageFormat::Jpeg);
     let mut cursor = Cursor::new(Vec::new());
     image
@@ -934,7 +1421,7 @@ fn mime_from_ext(ext: &str) -> &'static str {
 fn export_target(
     document: &Document,
     layer: ExportLayer,
-) -> ApiResult<(&SerializableDynamicImage, String)> {
+) -> ApiResult<(&koharu_core::SerializableDynamicImage, String)> {
     let ext = document
         .path
         .extension()

koharu-rpc/src/bin/openapi.rs

@@ -0,0 +1,16 @@
+fn main() {
+    let (_, mut spec) = koharu_rpc::api::api();
+
+    // Register schemas that are referenced via IntoParams but not auto-collected
+    let extras = utoipa::openapi::OpenApiBuilder::new()
+        .components(Some(
+            utoipa::openapi::ComponentsBuilder::new()
+                .schema_from::<koharu_core::ImportMode>()
+                .schema_from::<koharu_core::ExportLayer>()
+                .build(),
+        ))
+        .build();
+    spec.merge(extras);
+
+    println!("{}", spec.to_pretty_json().unwrap());
+}

koharu-rpc/src/lib.rs

@@ -1,7 +1,7 @@
 pub mod api;
-pub mod events;
 mod mcp;
 pub mod server;
 pub mod shared;
+pub mod tracker;
 
 pub use shared::{BootstrapHooks, SharedState};

koharu-rpc/src/server.rs

@@ -14,9 +14,9 @@ use tokio::net::TcpListener;
 use tower_http::cors::CorsLayer;
 
 use crate::api;
-use crate::events::EventHub;
 use crate::mcp::KoharuMcp;
 use crate::shared::SharedState;
+use crate::tracker::Tracker;
 
 /// An asset returned by the resolver: raw bytes + MIME type.
 pub struct Asset {
@@ -36,7 +36,7 @@ where
 }
 
 fn build_router(shared: SharedState, resolver: SharedAssetResolver) -> Router {
-    let events = EventHub::new(shared.clone());
+    let tracker = Tracker::new(&shared);
     let cors = CorsLayer::very_permissive();
 
     let mcp_service = StreamableHttpService::new(
@@ -52,7 +52,7 @@ fn build_router(shared: SharedState, resolver: SharedAssetResolver) -> Router {
     );
 
     Router::new()
-        .nest("/api/v1", api::router(shared.clone(), events))
+        .nest("/api/v1", api::router(shared.clone(), tracker))
         .nest_service("/mcp", mcp_service)
         .layer(cors)
         .fallback(move |uri: Uri| {

koharu-rpc/src/{events.rs → tracker.rs}

@@ -1,158 +1,57 @@
-use std::{collections::HashMap, sync::Arc, time::Duration};
+use std::{collections::HashMap, sync::Arc};
 
-use koharu_app::{pipeline, state_tx};
+use koharu_app::pipeline;
 use koharu_core::{
-    DocumentChangedEvent, DocumentSummary, DocumentsChangedEvent, DownloadState, DownloadStatus,
-    JobState, JobStatus, LlmState, PipelineProgress, PipelineStatus, PipelineStep, SnapshotEvent,
-    TransferStatus,
+    DownloadProgress, DownloadState, DownloadStatus, JobState, JobStatus, PipelineProgress,
+    PipelineStatus, PipelineStep, TransferStatus,
 };
-use tokio::sync::{RwLock, broadcast};
+use tokio::sync::RwLock;
 
-use crate::shared::{SharedState, get_resources};
-
-#[derive(Debug, Clone)]
-pub enum ApiEvent {
-    DocumentsChanged(DocumentsChangedEvent),
-    DocumentChanged(DocumentChangedEvent),
-    JobChanged(JobState),
-    DownloadChanged(DownloadState),
-    LlmChanged(LlmState),
-}
+use crate::shared::SharedState;
 
+/// Tracks active jobs and downloads for polling endpoints.
 #[derive(Clone)]
-pub struct EventHub {
+pub struct Tracker {
     inner: Arc<Inner>,
 }
 
 struct Inner {
-    shared: SharedState,
-    tx: broadcast::Sender<ApiEvent>,
     jobs: RwLock<HashMap<String, JobState>>,
     downloads: RwLock<HashMap<String, DownloadState>>,
 }
 
-impl EventHub {
-    pub fn new(shared: SharedState) -> Self {
+impl Tracker {
+    pub fn new(shared: &SharedState) -> Self {
         let inner = Arc::new(Inner {
-            shared,
-            tx: broadcast::channel(256).0,
             jobs: RwLock::new(HashMap::new()),
             downloads: RwLock::new(HashMap::new()),
         });
 
-        spawn_state_listener(inner.clone());
         spawn_pipeline_listener(inner.clone());
-        spawn_download_listener(inner.clone());
-        spawn_llm_listener(inner.clone());
+        spawn_download_listener(inner.clone(), shared.clone());
 
         Self { inner }
     }
 
-    pub fn subscribe(&self) -> broadcast::Receiver<ApiEvent> {
-        self.inner.tx.subscribe()
+    pub async fn list_jobs(&self) -> Vec<JobState> {
+        let mut jobs: Vec<_> = self.inner.jobs.read().await.values().cloned().collect();
+        jobs.sort_by(|a, b| a.id.cmp(&b.id));
+        jobs
     }
 
-    pub async fn snapshot(&self) -> anyhow::Result<SnapshotEvent> {
-        let (documents, llm) = if let Ok(resources) = get_resources(&self.inner.shared) {
-            let guard = resources.state.read().await;
-            let documents = guard.documents.iter().map(DocumentSummary::from).collect();
-            drop(guard);
-            (documents, resources.llm.snapshot().await)
-        } else {
-            (
-                Vec::new(),
-                LlmState {
-                    status: koharu_core::LlmStateStatus::Empty,
-                    model_id: None,
-                    source: None,
-                    error: None,
-                },
-            )
-        };
-
-        let mut jobs = self
-            .inner
-            .jobs
-            .read()
-            .await
-            .values()
-            .cloned()
-            .collect::<Vec<_>>();
-        jobs.sort_by(|left, right| left.id.cmp(&right.id));
-
-        let mut downloads = self
-            .inner
-            .downloads
-            .read()
-            .await
-            .values()
-            .cloned()
-            .collect::<Vec<_>>();
-        downloads.sort_by(|left, right| left.filename.cmp(&right.filename));
-
-        Ok(SnapshotEvent {
-            documents,
-            llm,
-            jobs,
-            downloads,
-        })
+    pub async fn get_job(&self, job_id: &str) -> Option<JobState> {
+        self.inner.jobs.read().await.get(job_id).cloned()
     }
 
     pub async fn publish_job(&self, job: JobState) {
         update_job_state(&self.inner, job).await;
     }
-}
 
-fn spawn_state_listener(inner: Arc<Inner>) {
-    let mut rx = state_tx::subscribe();
-    tokio::spawn(async move {
-        loop {
-            match rx.recv().await {
-                Ok(state_tx::StateEvent::DocumentsChanged) => {
-                    let Ok(resources) = get_resources(&inner.shared) else {
-                        continue;
-                    };
-                    let guard = resources.state.read().await;
-                    let documents = guard.documents.iter().map(DocumentSummary::from).collect();
-                    drop(guard);
-                    emit(
-                        &inner,
-                        ApiEvent::DocumentsChanged(DocumentsChangedEvent { documents }),
-                    );
-                }
-                Ok(state_tx::StateEvent::DocumentChanged {
-                    document_id,
-                    revision,
-                    changed,
-                }) => {
-                    emit(
-                        &inner,
-                        ApiEvent::DocumentChanged(DocumentChangedEvent {
-                            document_id,
-                            revision,
-                            changed,
-                        }),
-                    );
-                }
-                Err(broadcast::error::RecvError::Lagged(n)) => {
-                    tracing::warn!(
-                        "State event listener lagged by {n} events, re-emitting documents"
-                    );
-                    let Ok(resources) = get_resources(&inner.shared) else {
-                        continue;
-                    };
-                    let guard = resources.state.read().await;
-                    let documents = guard.documents.iter().map(DocumentSummary::from).collect();
-                    drop(guard);
-                    emit(
-                        &inner,
-                        ApiEvent::DocumentsChanged(DocumentsChangedEvent { documents }),
-                    );
-                }
-                Err(broadcast::error::RecvError::Closed) => break,
-            }
-        }
-    });
+    pub async fn list_downloads(&self) -> Vec<DownloadState> {
+        let mut downloads: Vec<_> = self.inner.downloads.read().await.values().cloned().collect();
+        downloads.sort_by(|a, b| a.filename.cmp(&b.filename));
+        downloads
+    }
 }
 
 fn spawn_pipeline_listener(inner: Arc<Inner>) {
@@ -163,16 +62,16 @@ fn spawn_pipeline_listener(inner: Arc<Inner>) {
                 Ok(progress) => {
                     update_job_state(&inner, pipeline_job_state(progress)).await;
                 }
-                Err(broadcast::error::RecvError::Lagged(_)) => continue,
-                Err(broadcast::error::RecvError::Closed) => break,
+                Err(tokio::sync::broadcast::error::RecvError::Lagged(_)) => continue,
+                Err(tokio::sync::broadcast::error::RecvError::Closed) => break,
             }
         }
     });
 }
 
-fn spawn_download_listener(inner: Arc<Inner>) {
+fn spawn_download_listener(inner: Arc<Inner>, shared: SharedState) {
     tokio::spawn(async move {
-        let mut runtime_rx = inner.shared.subscribe_runtime();
+        let mut runtime_rx = shared.subscribe_runtime();
         let mut download_rx = runtime_rx.borrow().clone().subscribe_downloads();
 
         loop {
@@ -188,8 +87,8 @@ fn spawn_download_listener(inner: Arc<Inner>) {
                     Ok(progress) => {
                         update_download_state(&inner, download_state(progress)).await;
                     }
-                    Err(broadcast::error::RecvError::Lagged(_)) => continue,
-                    Err(broadcast::error::RecvError::Closed) => {
+                    Err(tokio::sync::broadcast::error::RecvError::Lagged(_)) => continue,
+                    Err(tokio::sync::broadcast::error::RecvError::Closed) => {
                         download_rx = runtime_rx.borrow().clone().subscribe_downloads();
                     }
                 }
@@ -198,41 +97,14 @@ fn spawn_download_listener(inner: Arc<Inner>) {
     });
 }
 
-fn spawn_llm_listener(inner: Arc<Inner>) {
-    tokio::spawn(async move {
-        let resources = loop {
-            if let Ok(resources) = get_resources(&inner.shared) {
-                break resources;
-            }
-            tokio::time::sleep(Duration::from_millis(100)).await;
-        };
-
-        let mut rx = resources.llm.subscribe();
-        loop {
-            match rx.recv().await {
-                Ok(state) => emit(&inner, ApiEvent::LlmChanged(state)),
-                Err(broadcast::error::RecvError::Lagged(_)) => continue,
-                Err(broadcast::error::RecvError::Closed) => break,
-            }
-        }
-    });
-}
-
-fn emit(inner: &Arc<Inner>, event: ApiEvent) {
-    let _ = inner.tx.send(event);
-}
-
 async fn update_job_state(inner: &Arc<Inner>, job: JobState) {
     let terminal = !matches!(job.status, JobStatus::Running);
-    {
-        let mut jobs = inner.jobs.write().await;
-        if terminal {
-            jobs.remove(&job.id);
-        } else {
-            jobs.insert(job.id.clone(), job.clone());
-        }
+    let mut jobs = inner.jobs.write().await;
+    if terminal {
+        jobs.remove(&job.id);
+    } else {
+        jobs.insert(job.id.clone(), job);
     }
-    emit(inner, ApiEvent::JobChanged(job));
 }
 
 async fn update_download_state(inner: &Arc<Inner>, download: DownloadState) {
@@ -240,15 +112,12 @@ async fn update_download_state(inner: &Arc<Inner>, download: DownloadState) {
         download.status,
         TransferStatus::Started | TransferStatus::Downloading
     );
-    {
-        let mut downloads = inner.downloads.write().await;
-        if terminal {
-            downloads.remove(&download.id);
-        } else {
-            downloads.insert(download.id.clone(), download.clone());
-        }
+    let mut downloads = inner.downloads.write().await;
+    if terminal {
+        downloads.remove(&download.id);
+    } else {
+        downloads.insert(download.id.clone(), download);
     }
-    emit(inner, ApiEvent::DownloadChanged(download));
 }
 
 fn pipeline_job_state(progress: PipelineProgress) -> JobState {
@@ -295,8 +164,6 @@ fn download_state(progress: DownloadProgress) -> DownloadState {
     }
 }
 
-use koharu_core::DownloadProgress;
-
 #[cfg(test)]
 mod tests {
     use koharu_core::{PipelineStatus, PipelineStep};

ui/app/(app)/about/page.tsx

@@ -11,8 +11,7 @@ import {
 } from 'lucide-react'
 import { ScrollArea } from '@/components/ui/scroll-area'
 import { isTauri } from '@/lib/backend'
-import { api } from '@/lib/api'
-import { useDocumentMutations } from '@/lib/query/mutations'
+import { getMeta } from '@/lib/api/system/system'
 import Image from 'next/image'
 
 const GITHUB_REPO = 'mayocream/koharu'
@@ -21,7 +20,9 @@ type VersionStatus = 'loading' | 'latest' | 'outdated' | 'error'
 
 export default function AboutPage() {
   const { t } = useTranslation()
-  const { openExternal } = useDocumentMutations()
+  const openExternal = (url: string) => {
+    window.open(url, '_blank', 'noopener,noreferrer')
+  }
 
   const [appVersion, setAppVersion] = useState<string>()
   const [latestVersion, setLatestVersion] = useState<string>()
@@ -31,7 +32,8 @@ export default function AboutPage() {
     const checkVersion = async () => {
       try {
         if (isTauri()) {
-          const version = await api.appVersion()
+          const meta = await getMeta()
+          const version = meta.version
           setAppVersion(version)
 
           const res = await fetch(

ui/app/(app)/settings/page.tsx

@@ -10,12 +10,8 @@ import {
   MonitorIcon,
   ChevronLeftIcon,
   ChevronRightIcon,
-  ChevronDownIcon,
   EyeIcon,
   EyeOffIcon,
-  CheckCircleIcon,
-  XCircleIcon,
-  LoaderIcon,
 } from 'lucide-react'
 import { ScrollArea } from '@/components/ui/scroll-area'
 import {
@@ -26,14 +22,11 @@ import {
   SelectValue,
 } from '@/components/ui/select'
 import { isTauri } from '@/lib/backend'
-import { api } from '@/lib/api'
-import {
-  usePreferencesStore,
-  getActivePresetConfig,
-  type LocalLlmPreset,
-} from '@/lib/stores/preferencesStore'
+import { getMeta, getConfig, updateConfig } from '@/lib/api/system/system'
+import { setApiKey as setApiKeyApi } from '@/lib/api/providers/providers'
+import { usePreferencesStore } from '@/lib/stores/preferencesStore'
 import { supportedLanguages } from '@/lib/i18n'
-import type { BootstrapConfig } from '@/lib/protocol'
+import type { BootstrapConfig } from '@/lib/api/schemas'
 
 const THEME_OPTIONS = [
   { value: 'light', icon: SunIcon, labelKey: 'settings.themeLight' },
@@ -54,16 +47,6 @@ const API_PROVIDERS: ApiProvider[] = [
   { id: 'deepseek', name: 'DeepSeek', free_tier: false },
 ]
 
-const PRESET_BUTTONS: { value: LocalLlmPreset; labelKey: string }[] = [
-  { value: 'ollama', labelKey: 'settings.localLlmPresetOllama' },
-  { value: 'lmstudio', labelKey: 'settings.localLlmPresetLmStudio' },
-  { value: 'preset1', labelKey: 'settings.localLlmPresetPreset1' },
-  { value: 'preset2', labelKey: 'settings.localLlmPresetPreset2' },
-]
-
-const DEFAULT_SYSTEM_PROMPT =
-  'You are a professional manga translator. Translate Japanese manga dialogue into natural {target_language} that fits inside speech bubbles. Preserve character voice, emotional tone, relationship nuance, emphasis, and sound effects naturally. Keep the wording concise. Do not add notes, explanations, or romanization. If the input contains <block id="N">...</block>, translate only the text inside each block. Keep every block tag exactly unchanged, including ids, order, and block count. Do not merge blocks, split blocks, or add any text outside the blocks.'
-
 const inputClass =
   'border-border bg-card text-foreground placeholder:text-muted-foreground focus:ring-primary w-full rounded-md border px-3 py-1.5 text-sm focus:ring-1 focus:outline-none'
 
@@ -74,9 +57,6 @@ export default function SettingsPage() {
   const [deviceInfo, setDeviceInfo] = useState<{ mlDevice: string }>()
   const apiKeys = usePreferencesStore((state) => state.apiKeys)
   const setApiKey = usePreferencesStore((state) => state.setApiKey)
-  const localLlm = usePreferencesStore((state) => state.localLlm)
-  const setLocalLlm = usePreferencesStore((state) => state.setLocalLlm)
-  const setActivePreset = usePreferencesStore((state) => state.setActivePreset)
   const [visibleKeys, setVisibleKeys] = useState<Record<string, boolean>>({})
   const saveTimersRef = useRef<Record<string, ReturnType<typeof setTimeout>>>(
     {},
@@ -85,23 +65,16 @@ export default function SettingsPage() {
   const proxySaveTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null)
   const pendingBootstrapConfigRef = useRef<BootstrapConfig | null>(null)
 
-  const [showAdvanced, setShowAdvanced] = useState(false)
-  const [pingState, setPingState] = useState<{
-    loading: boolean
-    result?: { ok: boolean; count: number; latency: number; error?: string }
-  }>({ loading: false })
   const [bootstrapConfig, setBootstrapConfig] =
     useState<BootstrapConfig | null>(null)
 
-  const activeConfig = getActivePresetConfig(localLlm)
-
   useEffect(() => {
     if (!isTauri()) return
 
     const loadDeviceInfo = async () => {
       try {
-        const info = await api.deviceInfo()
-        setDeviceInfo(info)
+        const meta = await getMeta()
+        setDeviceInfo({ mlDevice: meta.mlDevice })
       } catch (error) {
         console.error('Failed to load device info', error)
       }
@@ -113,7 +86,7 @@ export default function SettingsPage() {
   useEffect(() => {
     const loadBootstrapConfig = async () => {
       try {
-        const config = await api.getBootstrapConfig()
+        const config = await getConfig()
         setBootstrapConfig(config)
       } catch (error) {
         console.error('Failed to load bootstrap config', error)
@@ -125,7 +98,7 @@ export default function SettingsPage() {
 
   const persistApiKey = async (provider: string, value: string) => {
     try {
-      await api.setApiKey(provider, value)
+      await setApiKeyApi(provider, { apiKey: value })
     } catch (error) {
       console.error(`Failed to save API key for ${provider}`, error)
     }
@@ -133,7 +106,7 @@ export default function SettingsPage() {
 
   const persistBootstrapConfig = async (nextConfig: BootstrapConfig) => {
     try {
-      const saved = await api.saveBootstrapConfig(nextConfig)
+      const saved = await updateConfig(nextConfig)
       setBootstrapConfig(saved)
     } catch (error) {
       console.error('Failed to save bootstrap config', error)
@@ -219,40 +192,6 @@ export default function SettingsPage() {
     }, 300)
   }
 
-  const handleTestConnection = async () => {
-    setPingState({ loading: true })
-    try {
-      const result = await api.llmPing(
-        activeConfig.baseUrl,
-        activeConfig.apiKey || undefined,
-      )
-      setPingState({
-        loading: false,
-        result: {
-          ok: result.ok,
-          count: result.models.length,
-          latency: result.latencyMs ?? 0,
-          error: result.error,
-        },
-      })
-    } catch (error) {
-      setPingState({
-        loading: false,
-        result: {
-          ok: false,
-          count: 0,
-          latency: 0,
-          error: String(error),
-        },
-      })
-    }
-  }
-
-  const handlePresetChange = (preset: LocalLlmPreset) => {
-    setActivePreset(preset)
-    setPingState({ loading: false })
-  }
-
   return (
     <div className='bg-muted flex min-h-0 flex-1 flex-col overflow-hidden'>
       <ScrollArea className='min-h-0 flex-1' viewportClassName='h-full'>
@@ -427,247 +366,6 @@ export default function SettingsPage() {
               </div>
             </section>
 
-            {/* Local LLM & OpenAI Compatible Providers Section */}
-            <section className='mb-8'>
-              <h2 className='text-foreground mb-1 text-sm font-bold'>
-                {t('settings.localLlmTitle')}
-              </h2>
-              <p className='text-muted-foreground mb-4 text-sm'>
-                {t('settings.localLlmDescription')}
-              </p>
-
-              <div className='space-y-3'>
-                {/* Provider Preset */}
-                <div className='space-y-1'>
-                  <label className='text-foreground text-sm'>
-                    {t('settings.localLlmPreset')}
-                  </label>
-                  <div className='grid grid-cols-4 gap-2'>
-                    {PRESET_BUTTONS.map(({ value, labelKey }) => (
-                      <button
-                        key={value}
-                        onClick={() => handlePresetChange(value)}
-                        data-active={localLlm.activePreset === value}
-                        className='border-border bg-card text-muted-foreground hover:border-foreground/30 data-[active=true]:border-primary data-[active=true]:text-foreground rounded-lg border px-3 py-2 text-sm font-medium transition'
-                      >
-                        {t(labelKey)}
-                      </button>
-                    ))}
-                  </div>
-                </div>
-
-                {/* Base URL */}
-                <div className='space-y-1'>
-                  <label className='text-foreground text-sm'>
-                    {t('settings.localLlmBaseUrl')}
-                  </label>
-                  <input
-                    type='url'
-                    value={activeConfig.baseUrl}
-                    onChange={(e) => setLocalLlm({ baseUrl: e.target.value })}
-                    placeholder='http://127.0.0.1:1234/v1'
-                    className={inputClass}
-                  />
-                </div>
-
-                {/* API Key */}
-                <div className='space-y-1'>
-                  <label className='text-foreground text-sm'>
-                    {t('settings.localLlmApiKey')}
-                  </label>
-                  <div className='relative'>
-                    <input
-                      type={
-                        visibleKeys[`llm-${localLlm.activePreset}`]
-                          ? 'text'
-                          : 'password'
-                      }
-                      value={activeConfig.apiKey}
-                      onChange={(e) => setLocalLlm({ apiKey: e.target.value })}
-                      placeholder='API key'
-                      className={`${inputClass} pr-9`}
-                    />
-                    <button
-                      type='button'
-                      onClick={() =>
-                        setVisibleKeys((v) => ({
-                          ...v,
-                          [`llm-${localLlm.activePreset}`]:
-                            !v[`llm-${localLlm.activePreset}`],
-                        }))
-                      }
-                      className='text-muted-foreground hover:text-foreground absolute top-1/2 right-2.5 -translate-y-1/2 transition'
-                    >
-                      {visibleKeys[`llm-${localLlm.activePreset}`] ? (
-                        <EyeOffIcon className='size-4' />
-                      ) : (
-                        <EyeIcon className='size-4' />
-                      )}
-                    </button>
-                  </div>
-                </div>
-
-                {/* Model Name */}
-                <div className='space-y-1'>
-                  <label className='text-foreground text-sm'>
-                    {t('settings.localLlmModelName')}
-                  </label>
-                  <input
-                    type='text'
-                    value={activeConfig.modelName}
-                    onChange={(e) => setLocalLlm({ modelName: e.target.value })}
-                    placeholder={t('settings.localLlmModelNamePlaceholder')}
-                    className={inputClass}
-                  />
-                </div>
-
-                {/* Advanced Section Toggle */}
-                <button
-                  type='button'
-                  onClick={() => setShowAdvanced((v) => !v)}
-                  className='text-muted-foreground hover:text-foreground flex items-center gap-1 text-sm transition'
-                >
-                  <ChevronDownIcon
-                    className={`size-4 transition-transform ${showAdvanced ? 'rotate-180' : ''}`}
-                  />
-                  {t('settings.localLlmAdvanced')}
-                </button>
-
-                {showAdvanced && (
-                  <div className='space-y-3 pl-1'>
-                    {/* Temperature */}
-                    <div className='space-y-1'>
-                      <label className='text-foreground text-sm'>
-                        {t('settings.localLlmTemperature')}
-                      </label>
-                      <input
-                        type='number'
-                        value={activeConfig.temperature ?? ''}
-                        onChange={(e) =>
-                          setLocalLlm({
-                            temperature:
-                              e.target.value === ''
-                                ? null
-                                : parseFloat(e.target.value),
-                          })
-                        }
-                        placeholder={t(
-                          'settings.localLlmTemperaturePlaceholder',
-                        )}
-                        step={0.1}
-                        min={0}
-                        max={2}
-                        className={inputClass}
-                      />
-                    </div>
-
-                    {/* Max Tokens */}
-                    <div className='space-y-1'>
-                      <label className='text-foreground text-sm'>
-                        {t('settings.localLlmMaxTokens')}
-                      </label>
-                      <input
-                        type='number'
-                        value={activeConfig.maxTokens ?? ''}
-                        onChange={(e) =>
-                          setLocalLlm({
-                            maxTokens:
-                              e.target.value === ''
-                                ? null
-                                : parseInt(e.target.value, 10),
-                          })
-                        }
-                        placeholder={t('settings.localLlmMaxTokensPlaceholder')}
-                        step={100}
-                        min={1}
-                        className={inputClass}
-                      />
-                    </div>
-
-                    {/* Custom System Prompt */}
-                    <div className='space-y-1'>
-                      <div className='flex items-center justify-between'>
-                        <label className='text-foreground text-sm'>
-                          {t('settings.localLlmSystemPrompt')}
-                        </label>
-                        {activeConfig.customSystemPrompt && (
-                          <button
-                            type='button'
-                            onClick={() =>
-                              setLocalLlm({ customSystemPrompt: '' })
-                            }
-                            className='text-primary text-xs hover:underline'
-                          >
-                            {t('settings.localLlmSystemPromptReset')}
-                          </button>
-                        )}
-                      </div>
-                      <textarea
-                        value={activeConfig.customSystemPrompt}
-                        onChange={(e) =>
-                          setLocalLlm({
-                            customSystemPrompt: e.target.value,
-                          })
-                        }
-                        placeholder={DEFAULT_SYSTEM_PROMPT}
-                        rows={4}
-                        className={`${inputClass} resize-y`}
-                      />
-                      <span className='text-muted-foreground text-xs'>
-                        {t('settings.localLlmSystemPromptPlaceholder')}
-                      </span>
-                    </div>
-                  </div>
-                )}
-
-                {/* Test Connection */}
-                <div className='space-y-2'>
-                  <button
-                    type='button'
-                    onClick={handleTestConnection}
-                    disabled={pingState.loading || !activeConfig.baseUrl.trim()}
-                    className='border-border bg-card text-foreground hover:bg-accent disabled:text-muted-foreground inline-flex items-center gap-2 rounded-md border px-4 py-1.5 text-sm font-medium transition disabled:opacity-50'
-                  >
-                    {pingState.loading ? (
-                      <>
-                        <LoaderIcon className='size-4 animate-spin' />
-                        {t('settings.localLlmTesting')}
-                      </>
-                    ) : (
-                      t('settings.localLlmTestConnection')
-                    )}
-                  </button>
-
-                  {pingState.result && !pingState.loading && (
-                    <div
-                      className={`flex items-start gap-2 text-sm ${pingState.result.ok ? 'text-green-500' : 'text-red-500'}`}
-                    >
-                      {pingState.result.ok ? (
-                        <>
-                          <CheckCircleIcon className='mt-0.5 size-4 shrink-0' />
-                          <span>
-                            {t('settings.localLlmTestSuccess', {
-                              count: pingState.result.count,
-                              latency: pingState.result.latency,
-                            })}
-                          </span>
-                        </>
-                      ) : (
-                        <>
-                          <XCircleIcon className='mt-0.5 size-4 shrink-0' />
-                          <span>
-                            {t('settings.localLlmTestFailed', {
-                              error: pingState.result.error,
-                            })}
-                          </span>
-                        </>
-                      )}
-                    </div>
-                  )}
-                </div>
-              </div>
-            </section>
-
             {/* Divider */}
             <div className='border-border mb-8 border-t' />
 

ui/app/bootstrap/page.tsx

@@ -18,10 +18,11 @@ import {
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select'
-import { api } from '@/lib/api'
-import { subscribeDownloadChanged, subscribeSnapshot } from '@/lib/backend'
+import { getConfig, updateConfig, initialize } from '@/lib/api/system/system'
+import { listDownloads } from '@/lib/api/downloads/downloads'
+import type { DownloadState } from '@/lib/api/schemas'
+import type { BootstrapConfig } from '@/lib/api/schemas'
 import i18n, { supportedLanguages } from '@/lib/i18n'
-import type { BootstrapConfig, DownloadState } from '@/lib/protocol'
 
 const DEFAULT_CONFIG: BootstrapConfig = {
   runtime: { path: '' },
@@ -77,9 +78,9 @@ export default function BootstrapPage() {
     setError(null)
 
     try {
-      const saved = await api.saveBootstrapConfig(nextConfig)
+      const saved = await updateConfig(nextConfig)
       setConfig(saved)
-      await api.initializeBootstrap()
+      await initialize()
     } catch (cause) {
       setInitializing(false)
       setFailed(true)
@@ -90,7 +91,7 @@ export default function BootstrapPage() {
   useEffect(() => {
     void (async () => {
       try {
-        const saved = await api.getBootstrapConfig()
+        const saved = await getConfig()
         setConfig(saved)
       } catch (cause) {
         const message =
@@ -105,39 +106,33 @@ export default function BootstrapPage() {
   }, [])
 
   useEffect(() => {
-    const updateDownload = (progress: DownloadState) => {
-      setDownload({
-        filename: progress.filename,
-        percent: computePercent(progress),
-        failed: progress.status === 'failed',
-      })
-    }
-
-    const unsubscribeSnapshot = subscribeSnapshot((snapshot) => {
-      const active =
-        snapshot.downloads.find(
-          (entry) =>
-            entry.status === 'started' || entry.status === 'downloading',
-        ) ??
-        snapshot.downloads
-          .slice()
-          .sort((left, right) => left.filename.localeCompare(right.filename))
-          .at(-1) ??
-        null
-
-      if (active) {
-        updateDownload(active)
+    const interval = setInterval(async () => {
+      try {
+        const downloads = await listDownloads()
+        const active =
+          downloads.find(
+            (entry) =>
+              entry.status === 'started' || entry.status === 'downloading',
+          ) ??
+          downloads
+            .slice()
+            .sort((left, right) => left.filename.localeCompare(right.filename))
+            .at(-1) ??
+          null
+
+        if (active) {
+          setDownload({
+            filename: active.filename,
+            percent: computePercent(active),
+            failed: active.status === 'failed',
+          })
+        }
+      } catch {
+        // Backend may not be ready yet during bootstrap
       }
-    })
+    }, 1500)
 
-    const unsubscribeDownload = subscribeDownloadChanged((progress) => {
-      updateDownload(progress)
-    })
-
-    return () => {
-      unsubscribeSnapshot()
-      unsubscribeDownload()
-    }
+    return () => clearInterval(interval)
   }, [])
 
   const goNext = async () => {

ui/app/providers.tsx

@@ -1,309 +1,74 @@
 'use client'
 
-import { useEffect, useRef, type ReactNode } from 'react'
+import { useEffect, type ReactNode } from 'react'
 import { I18nextProvider } from 'react-i18next'
 import { ThemeProvider } from 'next-themes'
-import { QueryClientProvider, useQueryClient } from '@tanstack/react-query'
-import { usePathname } from 'next/navigation'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import ClientOnly from '@/components/ClientOnly'
 import { TooltipProvider } from '@/components/ui/tooltip'
-import {
-  ProgressBarStatus,
-  getCurrentWindow,
-  listen,
-  subscribeDocumentChanged,
-  subscribeDocumentsChanged,
-  subscribeJobChanged,
-  subscribeLlmChanged,
-  subscribeSnapshot,
-} from '@/lib/backend'
+import { isTauri } from '@/lib/backend'
+import { useGetApiKey } from '@/lib/api/providers/providers'
 import i18n from '@/lib/i18n'
-import { getQueryClient } from '@/lib/query/client'
-import { queryKeys } from '@/lib/query/keys'
-import { useApiKeyQuery, useDocumentsCountQuery } from '@/lib/query/hooks'
-import { useDownloadStore } from '@/lib/downloads'
-import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useLlmUiStore } from '@/lib/stores/llmUiStore'
-import { useOperationStore } from '@/lib/stores/operationStore'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
-import { isTauri } from '@/lib/backend'
-import { useRpcConnection } from '@/hooks/useRpcConnection'
-import type {
-  DocumentSummary,
-  JobState,
-  LlmState,
-  SnapshotEvent,
-} from '@/lib/protocol'
-
-function ProvidersBootstrap({ children }: { children: ReactNode }) {
-  const queryClient = useQueryClient()
-  const pathname = usePathname()
-  const isStartupRoute =
-    pathname === '/bootstrap' || pathname === '/splashscreen'
-  const hasConnectedRef = useRef(false)
-  const setTotalPages = useEditorUiStore((state) => state.setTotalPages)
-  const setApiKey = usePreferencesStore((state) => state.setApiKey)
-  const rpcConnected = useRpcConnection()
-  const shouldQueryApiKeys = rpcConnected && !isStartupRoute && isTauri()
-  const { data: documentsCount } = useDocumentsCountQuery(
-    rpcConnected && !isStartupRoute,
-  )
-  const openAiApiKeyQuery = useApiKeyQuery('openai', shouldQueryApiKeys)
-  const openAiCompatibleApiKeyQuery = useApiKeyQuery(
-    'openai-compatible',
-    shouldQueryApiKeys,
-  )
-  const geminiApiKeyQuery = useApiKeyQuery('gemini', shouldQueryApiKeys)
-  const claudeApiKeyQuery = useApiKeyQuery('claude', shouldQueryApiKeys)
-  const deepSeekApiKeyQuery = useApiKeyQuery('deepseek', shouldQueryApiKeys)
-
-  const applyDocumentsSnapshot = (documents: DocumentSummary[]) => {
-    const count = documents.length
-    useEditorUiStore.setState((state) => ({
-      totalPages: count,
-      currentDocumentIndex:
-        count === 0 ? 0 : Math.min(state.currentDocumentIndex, count - 1),
-      selectedBlockIndex: count === 0 ? undefined : state.selectedBlockIndex,
-      documentsVersion: state.documentsVersion + 1,
-    }))
-    queryClient.setQueryData(queryKeys.documents.count, count)
-    queryClient.invalidateQueries({
-      queryKey: queryKeys.documents.currentRoot,
-    })
-    queryClient.invalidateQueries({
-      queryKey: queryKeys.documents.thumbnailRoot,
-    })
-  }
-
-  const applyLlmSnapshot = (llm: LlmState) => {
-    const selectedModel = useLlmUiStore.getState().selectedModel
-    const isReady =
-      llm.status === 'ready' &&
-      (!selectedModel || !llm.modelId || llm.modelId === selectedModel)
-    queryClient.setQueryData(queryKeys.llm.ready(selectedModel), isReady)
-    useLlmUiStore.getState().setLoading(llm.status === 'loading')
-
-    if (llm.status !== 'loading') {
-      const operation = useOperationStore.getState().operation
-      if (operation?.type === 'llm-load') {
-        useOperationStore.getState().finishOperation()
-        getCurrentWindow()
-          .setProgressBar({
-            status: ProgressBarStatus.None,
-            progress: 0,
-          })
-          .catch(() => {})
-      }
-    }
-  }
-
-  const updatePipelineUi = (job: JobState | null) => {
-    const operationStore = useOperationStore.getState()
-
-    if (!job) {
-      return
-    }
-
-    if (job.status === 'running') {
-      const isSingleDoc = job.totalDocuments <= 1
-      operationStore.updateOperation({
-        step: job.step ?? undefined,
-        current: isSingleDoc
-          ? job.currentStepIndex
-          : job.currentDocument +
-            (job.totalSteps > 0 ? job.currentStepIndex / job.totalSteps : 0),
-        total: isSingleDoc ? job.totalSteps : job.totalDocuments,
-      })
-
-      getCurrentWindow()
-        .setProgressBar({
-          status: ProgressBarStatus.Normal,
-          progress: job.overallPercent,
-        })
-        .catch(() => {})
-      return
-    }
-
-    operationStore.updateOperation({
-      current: operationStore.operation?.total,
-      total: operationStore.operation?.total,
-    })
-
-    getCurrentWindow()
-      .setProgressBar({ status: ProgressBarStatus.Normal, progress: 100 })
-      .catch(() => {})
-
-    queryClient.invalidateQueries({
-      queryKey: queryKeys.documents.currentRoot,
-    })
-    queryClient.invalidateQueries({
-      queryKey: queryKeys.documents.thumbnailRoot,
-    })
-
-    setTimeout(() => {
-      useOperationStore.getState().finishOperation()
-      getCurrentWindow()
-        .setProgressBar({
-          status: ProgressBarStatus.None,
-          progress: 0,
-        })
-        .catch(() => {})
-    }, 1000)
-  }
-
-  useEffect(() => {
-    if (!rpcConnected) return
-
-    if (hasConnectedRef.current) {
-      queryClient.invalidateQueries({ type: 'active' })
-      return
-    }
-
-    hasConnectedRef.current = true
-  }, [queryClient, rpcConnected])
-
-  useEffect(() => {
-    if (typeof documentsCount === 'number') {
-      setTotalPages(documentsCount)
-    }
-  }, [documentsCount, setTotalPages])
+import { ProcessingProvider } from '@/lib/machines'
 
-  useEffect(() => {
-    if (openAiApiKeyQuery.status === 'success') {
-      setApiKey('openai', openAiApiKeyQuery.data ?? '')
-    }
-  }, [openAiApiKeyQuery.data, openAiApiKeyQuery.status, setApiKey])
+const queryClient = new QueryClient()
 
-  useEffect(() => {
-    if (openAiCompatibleApiKeyQuery.status === 'success') {
-      setApiKey('openai-compatible', openAiCompatibleApiKeyQuery.data ?? '')
-    }
-  }, [
-    openAiCompatibleApiKeyQuery.data,
-    openAiCompatibleApiKeyQuery.status,
-    setApiKey,
-  ])
+const API_KEY_PROVIDERS = ['openai', 'openai-compatible', 'gemini', 'claude', 'deepseek'] as const
 
-  useEffect(() => {
-    if (geminiApiKeyQuery.status === 'success') {
-      setApiKey('gemini', geminiApiKeyQuery.data ?? '')
-    }
-  }, [geminiApiKeyQuery.data, geminiApiKeyQuery.status, setApiKey])
+function ApiKeySyncer() {
+  const setApiKey = usePreferencesStore((state) => state.setApiKey)
 
-  useEffect(() => {
-    if (claudeApiKeyQuery.status === 'success') {
-      setApiKey('claude', claudeApiKeyQuery.data ?? '')
-    }
-  }, [claudeApiKeyQuery.data, claudeApiKeyQuery.status, setApiKey])
+  return (
+    <>
+      {API_KEY_PROVIDERS.map((provider) => (
+        <ApiKeySync key={provider} provider={provider} setApiKey={setApiKey} />
+      ))}
+    </>
+  )
+}
 
-  useEffect(() => {
-    if (deepSeekApiKeyQuery.status === 'success') {
-      setApiKey('deepseek', deepSeekApiKeyQuery.data ?? '')
-    }
-  }, [deepSeekApiKeyQuery.data, deepSeekApiKeyQuery.status, setApiKey])
+function ApiKeySync({
+  provider,
+  setApiKey,
+}: {
+  provider: string
+  setApiKey: (provider: string, key: string) => void
+}) {
+  const { data, status } = useGetApiKey(provider, {
+    query: {
+      enabled: isTauri(),
+      select: (res: { apiKey?: string | null }) => res?.apiKey ?? '',
+    },
+  })
 
   useEffect(() => {
-    if (isStartupRoute) return
-
-    let unlisten: (() => void) | undefined
-    ;(async () => {
-      try {
-        unlisten = await listen<number>('documents:opened', (event) => {
-          const count = event.payload ?? 0
-          setTotalPages(count)
-          queryClient.setQueryData(queryKeys.documents.count, count)
-          queryClient.invalidateQueries({
-            queryKey: queryKeys.documents.currentRoot,
-          })
-          queryClient.invalidateQueries({
-            queryKey: queryKeys.documents.thumbnailRoot,
-          })
-        })
-      } catch (_) {}
-    })()
+    if (status === 'success') setApiKey(provider, data ?? '')
+  }, [data, status, provider, setApiKey])
 
-    const unsubscribeSnapshot = subscribeSnapshot((payload: SnapshotEvent) => {
-      applyDocumentsSnapshot(payload.documents)
-      applyLlmSnapshot(payload.llm)
-      const pipelineJob =
-        payload.jobs.find((job) => job.kind === 'pipeline') ?? null
-      updatePipelineUi(pipelineJob)
-    })
-
-    const unsubscribeDocuments = subscribeDocumentsChanged((payload) => {
-      applyDocumentsSnapshot(payload.documents)
-    })
-
-    const unsubscribeDocument = subscribeDocumentChanged(() => {
-      queryClient.invalidateQueries({
-        queryKey: queryKeys.documents.currentRoot,
-      })
-      queryClient.invalidateQueries({
-        queryKey: queryKeys.documents.thumbnailRoot,
-      })
-    })
-
-    const unsubscribeJobs = subscribeJobChanged((job) => {
-      if (job.kind !== 'pipeline') return
-      updatePipelineUi(job)
-      queryClient.invalidateQueries({
-        queryKey: queryKeys.documents.currentRoot,
-      })
-      queryClient.invalidateQueries({
-        queryKey: queryKeys.documents.thumbnailRoot,
-      })
-    })
-
-    const unsubscribeLlm = subscribeLlmChanged((llm) => {
-      applyLlmSnapshot(llm)
-    })
-
-    return () => {
-      unlisten?.()
-      unsubscribeSnapshot()
-      unsubscribeDocuments()
-      unsubscribeDocument()
-      unsubscribeJobs()
-      unsubscribeLlm()
-    }
-  }, [isStartupRoute, queryClient, setTotalPages])
-
-  return children
+  return null
 }
 
 export function Providers({ children }: { children: ReactNode }) {
-  const queryClient = getQueryClient()
-  const ensureDownloadSubscribed = useDownloadStore(
-    (state) => state.ensureSubscribed,
-  )
-
   useEffect(() => {
-    ensureDownloadSubscribed()
-  }, [ensureDownloadSubscribed])
-
-  useEffect(() => {
-    const handleLanguageChange = (lng: string) => {
-      document.documentElement.lang = lng
-    }
-
-    handleLanguageChange(i18n.language)
-    i18n.on('languageChanged', handleLanguageChange)
-    return () => {
-      i18n.off('languageChanged', handleLanguageChange)
-    }
+    const onLang = (lng: string) => { document.documentElement.lang = lng }
+    onLang(i18n.language)
+    i18n.on('languageChanged', onLang)
+    return () => { i18n.off('languageChanged', onLang) }
   }, [])
 
   return (
     <QueryClientProvider client={queryClient}>
-      <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
-        <ClientOnly>
-          <ProvidersBootstrap>
+      <ProcessingProvider>
+        <ThemeProvider attribute='class' defaultTheme='system' enableSystem>
+          <ClientOnly>
+            <ApiKeySyncer />
             <I18nextProvider i18n={i18n}>
               <TooltipProvider delayDuration={0}>{children}</TooltipProvider>
             </I18nextProvider>
-          </ProvidersBootstrap>
-        </ClientOnly>
-      </ThemeProvider>
+          </ClientOnly>
+        </ThemeProvider>
+      </ProcessingProvider>
     </QueryClientProvider>
   )
 }

ui/app/splashscreen/page.tsx

@@ -1,9 +1,8 @@
 'use client'
 
-import { useEffect, useRef, useState } from 'react'
+import { useEffect, useState } from 'react'
 import { useTranslation } from 'react-i18next'
-import { subscribeDownloadChanged } from '@/lib/backend'
-import type { DownloadState } from '@/lib/protocol'
+import { listDownloads } from '@/lib/api/downloads/downloads'
 
 type AggregateProgress = {
   filename: string
@@ -13,65 +12,43 @@ type AggregateProgress = {
 export default function SplashScreen() {
   const { t } = useTranslation()
   const [progress, setProgress] = useState<AggregateProgress | null>(null)
-  const filesRef = useRef<Map<string, { downloaded: number; total: number }>>(
-    new Map(),
-  )
 
   useEffect(() => {
-    const unsub = subscribeDownloadChanged((msg: DownloadState) => {
-      const files = filesRef.current
-
-      if (msg.status === 'started') {
-        files.set(msg.filename, { downloaded: 0, total: msg.total ?? 0 })
-      } else if (msg.status === 'downloading') {
-        const entry = files.get(msg.filename)
-        if (entry) {
-          entry.downloaded = msg.downloaded
-          if (msg.total) entry.total = msg.total
-        } else {
-          files.set(msg.filename, {
-            downloaded: msg.downloaded,
-            total: msg.total ?? 0,
-          })
-        }
-      } else {
-        // Completed or Failed — lock this file at 100%
-        const entry = files.get(msg.filename)
-        if (entry) {
-          entry.downloaded = entry.total
-        }
-      }
+    const interval = setInterval(async () => {
+      try {
+        const downloads = await listDownloads()
+        if (downloads.length === 0) return
 
-      // Compute aggregate
-      let totalBytes = 0
-      let downloadedBytes = 0
-      for (const entry of files.values()) {
-        totalBytes += entry.total
-        downloadedBytes += entry.downloaded
-      }
+        let totalBytes = 0
+        let downloadedBytes = 0
+        let activeFilename: string | null = null
 
-      // Find current active file (last non-completed)
-      const activeFilename =
-        msg.status === 'started' || msg.status === 'downloading'
-          ? msg.filename
-          : null
+        for (const d of downloads) {
+          totalBytes += d.total ?? 0
+          downloadedBytes += d.downloaded
+          if (d.status === 'started' || d.status === 'downloading') {
+            activeFilename = d.filename
+          }
+        }
 
-      const percent =
-        totalBytes > 0
-          ? Math.min(100, Math.round((downloadedBytes / totalBytes) * 100))
-          : undefined
+        const percent =
+          totalBytes > 0
+            ? Math.min(100, Math.round((downloadedBytes / totalBytes) * 100))
+            : undefined
 
-      if (activeFilename) {
-        setProgress({ filename: activeFilename, percent })
-      } else {
-        // All done — keep showing 100% briefly
-        setProgress((prev) =>
-          prev ? { ...prev, percent: percent ?? 100 } : null,
-        )
+        if (activeFilename) {
+          setProgress({ filename: activeFilename, percent })
+        } else {
+          setProgress((prev) =>
+            prev ? { ...prev, percent: percent ?? 100 } : null,
+          )
+        }
+      } catch {
+        // Backend may not be ready yet
       }
-    })
+    }, 1500)
 
-    return () => unsub()
+    return () => clearInterval(interval)
   }, [])
 
   return (

ui/components/ActivityBubble.tsx

@@ -1,14 +1,13 @@
 'use client'
 
-import { type ReactNode, useEffect } from 'react'
+import { type ReactNode } from 'react'
 import { useTranslation } from 'react-i18next'
 import { CircleXIcon } from 'lucide-react'
-import { useDownloadStore } from '@/lib/downloads'
+import { useListDownloads } from '@/lib/api/downloads/downloads'
+import type { DownloadState } from '@/lib/api/schemas'
 import { Button } from '@/components/ui/button'
-import { type OperationState } from '@/lib/operations'
-import { useOperationStore } from '@/lib/stores/operationStore'
-import { useUiErrorStore } from '@/lib/stores/uiErrorStore'
-import { useDocumentMutations } from '@/lib/query/mutations'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import { useProcessing } from '@/lib/machines'
 
 type TranslateFunc = ReturnType<typeof useTranslation>['t']
 
@@ -115,40 +114,43 @@ function ErrorCard({
   )
 }
 
+/** Map machine state name to an operation type label key */
+function getOperationTitle(
+  state: ReturnType<typeof useProcessing>['state'],
+  t: TranslateFunc,
+): string {
+  if (state.matches('importing')) return t('operations.loadKhr')
+  if (state.matches('loadingLlm')) return t('operations.loadModel')
+  if (state.matches('pipeline')) {
+    const docId = state.context.documentId
+    return docId ? t('operations.processCurrent') : t('operations.processAll')
+  }
+  return t('operations.processCurrent')
+}
+
 function OperationCard({
-  operation,
+  machineState,
   onCancel,
+  canCancel,
   t,
 }: {
-  operation: OperationState
+  machineState: ReturnType<typeof useProcessing>['state']
   onCancel: () => void
+  canCancel: boolean
   t: TranslateFunc
 }) {
-  const isProcessAll = operation.type === 'process-all'
-  const hasProgressNumbers =
-    typeof operation.current === 'number' &&
-    typeof operation.total === 'number' &&
-    operation.total > 0
-  const currentValue = hasProgressNumbers ? operation.current : undefined
-  const total = hasProgressNumbers ? operation.total : undefined
+  const ctx = machineState.context
+  const hasProgressNumbers = ctx.total > 0
   const progress = clampProgress(
-    total && typeof currentValue === 'number'
-      ? (currentValue / total) * 100
-      : undefined,
+    hasProgressNumbers ? (ctx.current / ctx.total) * 100 : undefined,
   )
-  const displayCurrent =
-    total && typeof currentValue === 'number'
-      ? Math.min(
-          total,
-          Math.floor(currentValue) + (currentValue >= total ? 0 : 1),
-        )
-      : undefined
-  const titles: Record<OperationState['type'], string> = {
-    'load-khr': t('operations.loadKhr'),
-    'process-current': t('operations.processCurrent'),
-    'process-all': t('operations.processAll'),
-    'llm-load': t('operations.loadModel'),
-  }
+  const displayCurrent = hasProgressNumbers
+    ? Math.min(ctx.total, Math.floor(ctx.current) + (ctx.current >= ctx.total ? 0 : 1))
+    : undefined
+  const total = hasProgressNumbers ? ctx.total : undefined
+
+  const isPipelineAll = machineState.matches('pipeline') && !ctx.documentId
+
   const stepLabels: Record<string, string> = {
     detect: t('processing.detect'),
     ocr: t('processing.ocr'),
@@ -157,8 +159,8 @@ function OperationCard({
     render: t('processing.render'),
   }
 
-  const stepLabel = operation.step
-    ? (stepLabels[operation.step] ?? operation.step)
+  const stepLabel = ctx.step
+    ? (stepLabels[ctx.step] ?? ctx.step)
     : undefined
   const stepText =
     stepLabel && total && typeof displayCurrent === 'number'
@@ -170,34 +172,25 @@ function OperationCard({
       : undefined
 
   const imageText =
-    operation.type === 'process-all' &&
-    total &&
-    typeof displayCurrent === 'number'
+    isPipelineAll && total && typeof displayCurrent === 'number'
       ? t('operations.imageProgress', {
           current: displayCurrent,
           total,
         })
       : undefined
 
-  const subtitleParts =
-    operation.type === 'process-all'
-      ? [stepLabel]
-      : [imageText, stepText ?? stepLabel].filter(Boolean)
+  const subtitleParts = isPipelineAll
+    ? [stepLabel]
+    : [imageText, stepText ?? stepLabel].filter(Boolean)
   const subtitle =
     subtitleParts.filter(Boolean).join(' \u00b7 ') || t('operations.inProgress')
 
+  const title = getOperationTitle(machineState, t)
+
   return (
     <BubbleCard>
       <div
         data-testid='operation-card'
-        data-operation-type={operation.type}
-        data-cancel-requested={operation.cancelRequested ? 'true' : 'false'}
-        data-current={
-          typeof operation.current === 'number' ? String(operation.current) : ''
-        }
-        data-total={
-          typeof operation.total === 'number' ? String(operation.total) : ''
-        }
         className='flex items-start gap-3'
       >
         <div className='bg-primary mt-1 h-2.5 w-2.5 rounded-full shadow-[0_0_0_6px_hsl(var(--primary)/0.16)]' />
@@ -205,13 +198,13 @@ function OperationCard({
           <div className='flex items-start justify-between gap-2'>
             <div className='flex flex-col gap-1'>
               <div className='text-foreground text-sm font-semibold'>
-                {titles[operation.type] ?? t('operations.title')}
+                {title}
               </div>
               <div className='text-muted-foreground text-xs'>
                 {subtitle || t('operations.inProgress')}
               </div>
             </div>
-            {isProcessAll && total && typeof displayCurrent === 'number' ? (
+            {isPipelineAll && total && typeof displayCurrent === 'number' ? (
               <span className='bg-muted text-muted-foreground rounded-full px-2 py-0.5 text-[11px] font-medium'>
                 {t('operations.imageProgress', {
                   current: displayCurrent,
@@ -221,19 +214,16 @@ function OperationCard({
             ) : null}
           </div>
           <ProgressBar percent={progress} />
-          {operation.cancellable && (
+          {canCancel && (
             <div className='mt-3 flex justify-end'>
               <Button
                 data-testid='operation-cancel'
                 variant='outline'
                 size='sm'
                 onClick={onCancel}
-                disabled={operation.cancelRequested}
                 className='text-xs font-semibold'
               >
-                {operation.cancelRequested
-                  ? t('operations.cancelling')
-                  : t('operations.cancel')}
+                {t('operations.cancel')}
               </Button>
             </div>
           )}
@@ -245,30 +235,46 @@ function OperationCard({
 
 export function ActivityBubble() {
   const { t } = useTranslation()
-  const operation = useOperationStore((state) => state.operation)
-  const error = useUiErrorStore((state) => state.error)
-  const clearError = useUiErrorStore((state) => state.clearError)
-  const { cancelOperation } = useDocumentMutations()
-  const downloads = useDownloadStore((s) => s.downloads)
-  const ensureSubscribed = useDownloadStore((s) => s.ensureSubscribed)
+  const { isProcessing, state: machineState, send, canCancel, error: machineError } = useProcessing()
+  const uiError = useEditorUiStore((state) => state.error)
+  const clearUiError = useEditorUiStore((state) => state.clearError)
 
-  useEffect(() => {
-    ensureSubscribed()
-  }, [ensureSubscribed])
+  const handleCancel = () => {
+    send({ type: 'CANCEL' })
+  }
 
-  const activeDownloads = Array.from(downloads.values()).filter(
-    (d) => d.status === 'started' || d.status === 'downloading',
-  )
+  const { data: allDownloads = [] } = useListDownloads({
+    query: { refetchInterval: 2000 },
+  })
 
-  if (!error && !operation && activeDownloads.length === 0) return null
+  const activeDownloads = allDownloads
+    .filter((d) => d.status === 'started' || d.status === 'downloading')
+    .map((d) => ({
+      ...d,
+      percent:
+        d.total && d.total > 0
+          ? Math.round((d.downloaded / d.total) * 100)
+          : undefined,
+    }))
+
+  // Show machine errors as well as UI errors
+  const errorMessage = machineError ?? uiError?.message
+  const clearError = machineError ? () => { /* machine clears on next operation */ } : clearUiError
+
+  if (!errorMessage && !isProcessing && activeDownloads.length === 0) return null
 
   return (
     <div className='pointer-events-auto fixed right-6 bottom-6 z-100 flex w-80 max-w-[calc(100%-1.5rem)] flex-col gap-3'>
-      {error && (
-        <ErrorCard message={error.message} onDismiss={clearError} t={t} />
+      {errorMessage && (
+        <ErrorCard message={errorMessage} onDismiss={clearError} t={t} />
       )}
-      {operation && (
-        <OperationCard operation={operation} onCancel={cancelOperation} t={t} />
+      {isProcessing && (
+        <OperationCard
+          machineState={machineState}
+          onCancel={handleCancel}
+          canCancel={canCancel}
+          t={t}
+        />
       )}
       {activeDownloads.map((d) => (
         <DownloadCard

ui/components/AppErrorBoundary.tsx

@@ -1,14 +1,13 @@
 'use client'
 
 import { type ReactNode } from 'react'
+import { useQueryClient } from '@tanstack/react-query'
 import { ErrorBoundary, type FallbackProps } from 'react-error-boundary'
 import { Button } from '@/components/ui/button'
-import { getQueryClient } from '@/lib/query/client'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useLlmUiStore } from '@/lib/stores/llmUiStore'
-import { useOperationStore } from '@/lib/stores/operationStore'
 
 function ErrorFallback({ error, resetErrorBoundary }: FallbackProps) {
+  const queryClient = useQueryClient()
   const errorMessage =
     error instanceof Error ? error.message : 'Unexpected error'
 
@@ -27,8 +26,6 @@ function ErrorFallback({ error, resetErrorBoundary }: FallbackProps) {
           variant='outline'
           onClick={() => {
             useEditorUiStore.getState().resetUiState()
-            useLlmUiStore.getState().resetLlmUiState()
-            useOperationStore.getState().resetOperationState()
             resetErrorBoundary()
           }}
         >
@@ -38,7 +35,7 @@ function ErrorFallback({ error, resetErrorBoundary }: FallbackProps) {
           size='sm'
           variant='outline'
           onClick={() => {
-            getQueryClient().clear()
+            queryClient.clear()
             resetErrorBoundary()
           }}
         >

ui/components/MenuBar.tsx

@@ -3,8 +3,31 @@
 import { useCallback, useEffect, useState } from 'react'
 import Link from 'next/link'
 import { MinusIcon, SquareIcon, XIcon, CopyIcon } from 'lucide-react'
-import { isTauri, isMacOS, windowControls } from '@/lib/backend'
+import { isTauri } from '@/lib/backend'
 import { useTranslation } from 'react-i18next'
+
+const isMacOS = () =>
+  typeof navigator !== 'undefined' &&
+  /Mac|iPhone|iPad|iPod/.test(navigator.userAgent)
+
+const windowControls = {
+  async close() {
+    const { getCurrentWindow } = await import('@tauri-apps/api/window')
+    return getCurrentWindow().close()
+  },
+  async minimize() {
+    const { getCurrentWindow } = await import('@tauri-apps/api/window')
+    return getCurrentWindow().minimize()
+  },
+  async toggleMaximize() {
+    const { getCurrentWindow } = await import('@tauri-apps/api/window')
+    return getCurrentWindow().toggleMaximize()
+  },
+  async isMaximized() {
+    const { getCurrentWindow } = await import('@tauri-apps/api/window')
+    return getCurrentWindow().isMaximized()
+  },
+}
 import { fitCanvasToViewport, resetCanvasScale } from '@/components/Canvas'
 import Image from 'next/image'
 import {
@@ -15,7 +38,10 @@ import {
   MenubarSeparator,
   MenubarTrigger,
 } from '@/components/ui/menubar'
-import { useDocumentMutations } from '@/lib/query/mutations'
+import { useProcessing } from '@/lib/machines'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import { usePreferencesStore } from '@/lib/stores/preferencesStore'
+import type { PipelineJobRequest } from '@/lib/api/schemas'
 
 type MenuItem = {
   label: string
@@ -30,62 +56,74 @@ type MenuSection = {
   triggerTestId?: string
 }
 
+const openExternal = (url: string) => {
+  window.open(url, '_blank', 'noopener,noreferrer')
+}
+
 export function MenuBar() {
   const { t } = useTranslation()
-  const {
-    addDocuments,
-    openDocuments,
-    openFolder,
-    addFolder,
-    openExternal,
-    processImage,
-    inpaintAndRenderImage,
-    processAllImages,
-    exportDocument,
-    exportPsdDocument,
-    exportAllInpainted,
-    exportAllRendered,
-  } = useDocumentMutations()
+  const { send } = useProcessing()
+
+  const buildPipelineRequest = (documentId?: string): PipelineJobRequest => {
+    const { selectedModel, selectedLanguage, renderEffect, renderStroke } =
+      useEditorUiStore.getState()
+    const { fontFamily, apiKeys } = usePreferencesStore.getState()
+    return {
+      documentId,
+      llmModelId: selectedModel,
+      llmApiKey: selectedModel ? apiKeys[selectedModel.split(':')[0]] : undefined,
+      language: selectedLanguage,
+      shaderEffect: renderEffect,
+      shaderStroke: renderStroke,
+      fontFamily,
+    }
+  }
+
+  const requireDocumentId = () => {
+    const id = useEditorUiStore.getState().currentDocumentId
+    if (!id) throw new Error('No current document selected')
+    return id
+  }
 
   const fileMenuItems: MenuItem[] = [
     {
       label: t('menu.openFile'),
-      onSelect: openDocuments,
+      onSelect: () => send({ type: 'START_IMPORT', mode: 'replace', source: 'files' }),
       testId: 'menu-file-open',
     },
     {
       label: t('menu.addFile'),
-      onSelect: addDocuments,
+      onSelect: () => send({ type: 'START_IMPORT', mode: 'append', source: 'files' }),
       testId: 'menu-file-add',
     },
     {
       label: t('menu.openFolder'),
-      onSelect: openFolder,
+      onSelect: () => send({ type: 'START_IMPORT', mode: 'replace', source: 'folder' }),
       testId: 'menu-file-open-folder',
     },
     {
       label: t('menu.addFolder'),
-      onSelect: addFolder,
+      onSelect: () => send({ type: 'START_IMPORT', mode: 'append', source: 'folder' }),
       testId: 'menu-file-add-folder',
     },
     {
       label: t('menu.export'),
-      onSelect: exportDocument,
+      onSelect: () => send({ type: 'START_EXPORT', documentId: requireDocumentId(), format: 'webp', params: { layer: 'rendered' } }),
       testId: 'menu-file-export',
     },
     {
       label: t('menu.exportPsd'),
-      onSelect: exportPsdDocument,
+      onSelect: () => send({ type: 'START_EXPORT', documentId: requireDocumentId(), format: 'psd' }),
       testId: 'menu-file-export-psd',
     },
     {
       label: t('menu.exportAllInpainted'),
-      onSelect: exportAllInpainted,
+      onSelect: () => send({ type: 'START_BATCH_EXPORT', layer: 'inpainted' }),
       testId: 'menu-file-export-all-inpainted',
     },
     {
       label: t('menu.exportAllRendered'),
-      onSelect: exportAllRendered,
+      onSelect: () => send({ type: 'START_BATCH_EXPORT', layer: 'rendered' }),
       testId: 'menu-file-export-all-rendered',
     },
   ]
@@ -104,17 +142,23 @@ export function MenuBar() {
       items: [
         {
           label: t('menu.processCurrent'),
-          onSelect: processImage,
+          onSelect: () => {
+            const documentId = requireDocumentId()
+            send({ type: 'START_PIPELINE', request: buildPipelineRequest(documentId) })
+          },
           testId: 'menu-process-current',
         },
         {
           label: t('menu.redoInpaintRender'),
-          onSelect: inpaintAndRenderImage,
+          onSelect: () => {
+            const documentId = requireDocumentId()
+            send({ type: 'START_INPAINT', documentId })
+          },
           testId: 'menu-process-rerender',
         },
         {
           label: t('menu.processAll'),
-          onSelect: processAllImages,
+          onSelect: () => send({ type: 'START_PIPELINE', request: buildPipelineRequest() }),
           testId: 'menu-process-all',
         },
       ],

ui/components/Navigator.tsx

@@ -1,43 +1,43 @@
 'use client'
 
-import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react'
+import { useRef } from 'react'
 import { useVirtualizer } from '@tanstack/react-virtual'
 import { useTranslation } from 'react-i18next'
-import { useDocumentsCountQuery, useThumbnailQuery } from '@/lib/query/hooks'
+import {
+  useListDocuments,
+  getGetDocumentThumbnailUrl,
+} from '@/lib/api/documents/documents'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
 import { Button } from '@/components/ui/button'
 import { ScrollArea } from '@/components/ui/scroll-area'
-import { flushTextBlockSync } from '@/lib/services/syncQueues'
-import { cancelObjectUrlRevoke, revokeObjectUrlLater } from '@/lib/util'
+
+const THUMBNAIL_DPR = typeof window !== 'undefined'
+  ? Math.min(Math.ceil(window.devicePixelRatio || 1), 3)
+  : 2
+
+// Fixed row height: thumbnail (aspect 3:4 in ~150px width ≈ 200px) + page number + padding
+const ROW_HEIGHT = 230
+const OVERSCAN = 5
 
 export function Navigator() {
-  const { data: totalPagesData = 0 } = useDocumentsCountQuery()
-  const totalPages = totalPagesData ?? 0
-  const documentsVersion = useEditorUiStore((state) => state.documentsVersion)
-  const currentDocumentIndex = useEditorUiStore(
-    (state) => state.currentDocumentIndex,
-  )
-  const setCurrentDocumentIndex = useEditorUiStore(
-    (state) => state.setCurrentDocumentIndex,
+  const { data: documents = [] } = useListDocuments()
+  const totalPages = documents.length
+  const currentDocumentId = useEditorUiStore(
+    (state) => state.currentDocumentId,
   )
-  const listRef = useRef<HTMLDivElement | null>(null)
-  const indices = useMemo(
-    () => Array.from({ length: totalPages }, (_, idx) => idx),
-    [totalPages],
+  const setCurrentDocumentId = useEditorUiStore(
+    (state) => state.setCurrentDocumentId,
   )
-  const rowVirtualizer = useVirtualizer({
-    count: indices.length,
-    getScrollElement: () => listRef.current,
-    getItemKey: (index) => indices[index] ?? index,
-    estimateSize: () => 320,
-    overscan: 8,
-    measureElement: (element) => element.getBoundingClientRect().height,
-  })
+  const currentDocumentIndex = documents.findIndex((d) => d.id === currentDocumentId)
+  const viewportRef = useRef<HTMLDivElement | null>(null)
   const { t } = useTranslation()
 
-  useEffect(() => {
-    rowVirtualizer.measure()
-  }, [rowVirtualizer, totalPages, documentsVersion])
+  const virtualizer = useVirtualizer({
+    count: totalPages,
+    getScrollElement: () => viewportRef.current,
+    estimateSize: () => ROW_HEIGHT,
+    overscan: OVERSCAN,
+  })
 
   return (
     <div
@@ -66,47 +66,34 @@ export function Navigator() {
         )}
       </div>
 
-      <ScrollArea className='min-h-0 flex-1' viewportRef={listRef}>
-        <div className='p-2'>
-          <div
-            style={{
-              height: `${rowVirtualizer.getTotalSize()}px`,
-              width: '100%',
-              position: 'relative',
-            }}
-          >
-            {rowVirtualizer.getVirtualItems().map((virtualRow) => {
-              const idx = indices[virtualRow.index]
-              return (
-                <div
-                  key={virtualRow.key}
-                  data-index={virtualRow.index}
-                  ref={rowVirtualizer.measureElement}
-                  style={{
-                    position: 'absolute',
-                    top: 0,
-                    left: 0,
-                    width: '100%',
-                    transform: `translateY(${virtualRow.start}px)`,
-                    paddingBottom: '6px',
-                  }}
-                >
-                  <PagePreview
-                    index={idx}
-                    documentsVersion={documentsVersion}
-                    selected={idx === currentDocumentIndex}
-                    onSelect={() => {
-                      void flushTextBlockSync()
-                        .catch(() => {})
-                        .finally(() => {
-                          setCurrentDocumentIndex(idx)
-                        })
-                    }}
-                  />
-                </div>
-              )
-            })}
-          </div>
+      <ScrollArea className='min-h-0 flex-1' viewportRef={viewportRef}>
+        <div
+          className='relative w-full'
+          style={{ height: virtualizer.getTotalSize() }}
+        >
+          {virtualizer.getVirtualItems().map((virtualRow) => {
+            const doc = documents[virtualRow.index]
+            return (
+              <div
+                key={doc?.id ?? virtualRow.index}
+                className='absolute left-0 w-full px-1.5 pb-1'
+                style={{
+                  height: ROW_HEIGHT,
+                  top: 0,
+                  transform: `translateY(${virtualRow.start}px)`,
+                }}
+              >
+                <PagePreview
+                  index={virtualRow.index}
+                  documentId={doc?.id}
+                  selected={doc?.id === currentDocumentId}
+                  onSelect={() =>
+                    doc && setCurrentDocumentId(doc.id)
+                  }
+                />
+              </div>
+            )
+          })}
         </div>
       </ScrollArea>
     </div>
@@ -115,36 +102,20 @@ export function Navigator() {
 
 type PagePreviewProps = {
   index: number
-  documentsVersion: number
+  documentId?: string
   selected: boolean
   onSelect: () => void
 }
 
 function PagePreview({
   index,
-  documentsVersion,
+  documentId,
   selected,
   onSelect,
 }: PagePreviewProps) {
-  const [preview, setPreview] = useState<string>()
-  const {
-    data: thumbnailBlob,
-    isPending: loading,
-    isError: error,
-  } = useThumbnailQuery(index, documentsVersion)
-
-  useLayoutEffect(() => {
-    if (!thumbnailBlob) {
-      setPreview(undefined)
-      return
-    }
-    const url = URL.createObjectURL(thumbnailBlob)
-    cancelObjectUrlRevoke(url)
-    setPreview(url)
-    return () => {
-      revokeObjectUrlLater(url)
-    }
-  }, [thumbnailBlob])
+  const src = documentId
+    ? getGetDocumentThumbnailUrl(documentId, { size: 200 * THUMBNAIL_DPR })
+    : undefined
 
   return (
     <Button
@@ -153,26 +124,22 @@ function PagePreview({
       data-testid={`navigator-page-${index}`}
       data-page-index={index}
       data-selected={selected}
-      className='bg-card data-[selected=true]:border-primary flex h-auto flex-col gap-0.5 rounded border border-transparent p-1.5 text-left shadow-sm'
+      className='bg-card data-[selected=true]:border-primary flex h-full w-full flex-col gap-0.5 rounded border border-transparent p-1.5 text-left shadow-sm'
     >
-      {loading ? (
-        <div className='bg-muted aspect-3/4 w-full animate-pulse rounded' />
-      ) : error ? (
-        <div className='bg-muted flex aspect-3/4 w-full items-center justify-center rounded'>
-          <span className='text-muted-foreground text-[10px]'>?</span>
-        </div>
-      ) : preview ? (
-        <img
-          src={preview}
-          alt={`Page ${index + 1}`}
-          style={{ objectFit: 'contain' }}
-          className='aspect-3/4 w-full rounded object-cover'
-        />
-      ) : (
-        <div className='bg-muted aspect-3/4 w-full rounded' />
-      )}
-      <div className='text-muted-foreground flex flex-1 items-center text-xs'>
-        <div className='text-foreground mx-auto flex text-center font-semibold'>
+      <div className='flex min-h-0 flex-1 items-center justify-center overflow-hidden rounded'>
+        {src ? (
+          <img
+            src={src}
+            alt={`Page ${index + 1}`}
+            loading='lazy'
+            className='max-h-full max-w-full rounded object-contain'
+          />
+        ) : (
+          <div className='bg-muted h-full w-full rounded' />
+        )}
+      </div>
+      <div className='text-muted-foreground flex shrink-0 items-center text-xs'>
+        <div className='text-foreground mx-auto font-semibold'>
           {index + 1}
         </div>
       </div>

ui/components/canvas/CanvasToolbar.tsx

@@ -1,7 +1,8 @@
 'use client'
 
-import { useEffect, useMemo, useState } from 'react'
+import { useCallback, useEffect, useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
 import { motion } from 'motion/react'
 import {
   ScanIcon,
@@ -25,17 +26,46 @@ import {
   PopoverContent,
   PopoverTrigger,
 } from '@/components/ui/popover'
-import { useLlmUiStore } from '@/lib/stores/llmUiStore'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
 import {
-  useLlmModelsQuery,
-  useLlmReadyQuery,
-  LOCAL_LLM_PRESET_LABELS,
-  parsePresetFromModelId,
-} from '@/lib/query/hooks'
-import { useDocumentMutations, useLlmMutations } from '@/lib/query/mutations'
-import { useOperationStore } from '@/lib/stores/operationStore'
+  useGetLlm,
+  getListLlmModelsQueryKey,
+  listLlmModels,
+  unloadLlm,
+} from '@/lib/api/llm/llm'
+import {
+  translateDocument,
+} from '@/lib/api/processing/processing'
+import {
+  getGetDocumentQueryKey,
+  getListDocumentsQueryKey,
+} from '@/lib/api/documents/documents'
+import type { LlmModelInfo } from '@/lib/api/schemas'
+import { useProcessing } from '@/lib/machines'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
 import { getProviderDisplayName } from '@/lib/providers'
+import i18n from '@/lib/i18n'
+
+function useLlmModelsQuery() {
+  const [language, setLanguage] = useState(i18n.language)
+  useEffect(() => {
+    const handleLanguageChange = (nextLanguage: string) => {
+      setLanguage(nextLanguage)
+    }
+    i18n.on('languageChanged', handleLanguageChange)
+    return () => {
+      i18n.off('languageChanged', handleLanguageChange)
+    }
+  }, [])
+
+  return useQuery<LlmModelInfo[]>({
+    queryKey: getListLlmModelsQueryKey({ language: language ?? 'default' }),
+    queryFn: async () => {
+      return listLlmModels({ language })
+    },
+    staleTime: 5 * 60 * 1000,
+  })
+}
 
 export function CanvasToolbar() {
   return (
@@ -48,26 +78,34 @@ export function CanvasToolbar() {
 }
 
 function WorkflowButtons() {
-  const { inpaint, detect, ocr, render } = useDocumentMutations()
-  const { llmGenerate } = useLlmMutations()
-  const { data: llmReady = false } = useLlmReadyQuery()
+  const queryClient = useQueryClient()
+  const { send, isProcessing, state } = useProcessing()
+  const { data: llmState } = useGetLlm()
+  const llmReady = llmState?.status === 'ready'
   const [generating, setGenerating] = useState(false)
   const { t } = useTranslation()
-  const operation = useOperationStore((state) => state.operation)
 
-  const isDetecting =
-    operation?.type === 'process-current' && operation?.step === 'detect'
-  const isOcr =
-    operation?.type === 'process-current' && operation?.step === 'ocr'
-  const isInpainting =
-    operation?.type === 'process-current' && operation?.step === 'inpaint'
-  const isRendering =
-    operation?.type === 'process-current' && operation?.step === 'render'
+  const isDetecting = state.matches('detecting')
+  const isOcr = state.matches('recognizing')
+  const isInpainting = state.matches('inpainting')
+  const isRendering = state.matches('rendering')
+
+  const requireDocumentId = () => {
+    const id = useEditorUiStore.getState().currentDocumentId
+    if (!id) throw new Error('No current document selected')
+    return id
+  }
 
   const handleTranslate = async () => {
+    const documentId = useEditorUiStore.getState().currentDocumentId
+    if (!documentId) return
+    const selectedLanguage = useEditorUiStore.getState().selectedLanguage
     setGenerating(true)
     try {
-      await llmGenerate(null)
+      await translateDocument(documentId, { language: selectedLanguage })
+      await queryClient.invalidateQueries({ queryKey: getGetDocumentQueryKey(documentId) })
+      await queryClient.invalidateQueries({ queryKey: getListDocumentsQueryKey() })
+      useEditorUiStore.getState().setShowTextBlocksOverlay(true)
     } catch (error) {
       console.error(error)
     } finally {
@@ -80,9 +118,9 @@ function WorkflowButtons() {
       <Button
         variant='ghost'
         size='xs'
-        onClick={detect}
+        onClick={() => send({ type: 'START_DETECT', documentId: requireDocumentId() })}
         data-testid='toolbar-detect'
-        disabled={isDetecting}
+        disabled={isDetecting || isProcessing}
       >
         {isDetecting ? (
           <LoaderCircleIcon className='size-4 animate-spin' />
@@ -97,9 +135,9 @@ function WorkflowButtons() {
       <Button
         variant='ghost'
         size='xs'
-        onClick={ocr}
+        onClick={() => send({ type: 'START_RECOGNIZE', documentId: requireDocumentId() })}
         data-testid='toolbar-ocr'
-        disabled={isOcr}
+        disabled={isOcr || isProcessing}
       >
         {isOcr ? (
           <LoaderCircleIcon className='size-4 animate-spin' />
@@ -131,9 +169,9 @@ function WorkflowButtons() {
       <Button
         variant='ghost'
         size='xs'
-        onClick={inpaint}
+        onClick={() => send({ type: 'START_INPAINT', documentId: requireDocumentId() })}
         data-testid='toolbar-inpaint'
-        disabled={isInpainting}
+        disabled={isInpainting || isProcessing}
       >
         {isInpainting ? (
           <LoaderCircleIcon className='size-4 animate-spin' />
@@ -148,9 +186,14 @@ function WorkflowButtons() {
       <Button
         variant='ghost'
         size='xs'
-        onClick={render}
+        onClick={() => {
+          const documentId = requireDocumentId()
+          const { renderEffect, renderStroke } = useEditorUiStore.getState()
+          const { fontFamily } = usePreferencesStore.getState()
+          send({ type: 'START_RENDER', documentId, options: { shaderEffect: renderEffect, shaderStroke: renderStroke, fontFamily } })
+        }}
         data-testid='toolbar-render'
-        disabled={isRendering}
+        disabled={isRendering || isProcessing}
       >
         {isRendering ? (
           <LoaderCircleIcon className='size-4 animate-spin' />
@@ -165,15 +208,14 @@ function WorkflowButtons() {
 
 function LlmStatusPopover() {
   const { data: llmModels = [] } = useLlmModelsQuery()
-  const llmSelectedModel = useLlmUiStore((state) => state.selectedModel)
-  const llmSelectedLanguage = useLlmUiStore((state) => state.selectedLanguage)
-  const llmLoading = useLlmUiStore((state) => state.loading)
-  const { data: llmReady = false } = useLlmReadyQuery()
-  const { llmSetSelectedModel, llmSetSelectedLanguage, llmToggleLoadUnload } =
-    useLlmMutations()
+  const llmSelectedModel = useEditorUiStore((state) => state.selectedModel)
+  const llmSelectedLanguage = useEditorUiStore((state) => state.selectedLanguage)
+  const { data: llmState } = useGetLlm()
+  const llmReady = llmState?.status === 'ready'
+  const llmLoading = llmState?.status === 'loading'
+  const { send } = useProcessing()
   const { t } = useTranslation()
   const apiKeys = usePreferencesStore((state) => state.apiKeys)
-  const localLlm = usePreferencesStore((state) => state.localLlm)
 
   const selectedModelInfo = useMemo(
     () => llmModels.find((m) => m.id === llmSelectedModel),
@@ -192,6 +234,56 @@ function LlmStatusPopover() {
     [selectedModelInfo],
   )
 
+  const handleSetSelectedModel = useCallback(
+    async (id: string) => {
+      await unloadLlm()
+      const models = llmModels
+      const languages = models.find((m) => m.id === id)?.languages ?? []
+      const nextLanguage =
+        llmSelectedLanguage && languages.includes(llmSelectedLanguage)
+          ? llmSelectedLanguage
+          : languages[0]
+      useEditorUiStore.setState({
+        selectedModel: id,
+        selectedLanguage: nextLanguage,
+      })
+    },
+    [llmModels, llmSelectedLanguage],
+  )
+
+  const handleSetSelectedLanguage = useCallback(
+    (language: string) => {
+      const languages = selectedModelInfo?.languages ?? []
+      if (!languages.includes(language)) return
+      useEditorUiStore.setState({ selectedLanguage: language })
+    },
+    [selectedModelInfo],
+  )
+
+  const handleToggleLoadUnload = useCallback(async () => {
+    const selectedModel = useEditorUiStore.getState().selectedModel
+    if (!selectedModel) return
+
+    if (llmReady) {
+      await unloadLlm()
+      return
+    }
+
+    const modelInfo = llmModels.find((m) => m.id === selectedModel)
+    const apiKey =
+      modelInfo && modelInfo.source !== 'local'
+        ? apiKeys[modelInfo.source]
+        : undefined
+
+    send({
+      type: 'START_LLM_LOAD',
+      request: {
+        id: selectedModel,
+        apiKey,
+      },
+    })
+  }, [llmReady, llmModels, apiKeys, send])
+
   useEffect(() => {
     if (llmModels.length === 0) return
     const hasCurrent = llmModels.some((model) => model.id === llmSelectedModel)
@@ -203,18 +295,17 @@ function LlmStatusPopover() {
       llmSelectedLanguage && languages.includes(llmSelectedLanguage)
         ? llmSelectedLanguage
         : languages[0]
-    const currentState = useLlmUiStore.getState()
+    const currentState = useEditorUiStore.getState()
     if (
       currentState.selectedModel === nextModel &&
       currentState.selectedLanguage === nextLanguage
     ) {
       return
     }
-    useLlmUiStore.setState((state) => ({
+    useEditorUiStore.setState({
       selectedModel: nextModel,
       selectedLanguage: nextLanguage,
-      loading: state.loading,
-    }))
+    })
   }, [llmModels, llmSelectedLanguage, llmSelectedModel])
 
   return (
@@ -242,11 +333,6 @@ function LlmStatusPopover() {
             }
           />
           LLM
-          {llmReady && selectedModelInfo?.source === 'openai-compatible' && (
-            <span className='max-w-[80px] truncate text-[10px] opacity-80'>
-              {selectedModelInfo.id.split(':')[1] ?? selectedModelInfo.id}
-            </span>
-          )}
         </button>
       </PopoverTrigger>
       <PopoverContent align='end' className='w-72' data-testid='llm-popover'>
@@ -255,7 +341,7 @@ function LlmStatusPopover() {
             {t('panels.llm')}
           </p>
 
-          <Select value={llmSelectedModel} onValueChange={llmSetSelectedModel}>
+          <Select value={llmSelectedModel} onValueChange={handleSetSelectedModel}>
             <SelectTrigger data-testid='llm-model-select' className='w-full'>
               <SelectValue placeholder={t('llm.selectPlaceholder')} />
             </SelectTrigger>
@@ -267,37 +353,14 @@ function LlmStatusPopover() {
                   data-testid={`llm-model-option-${index}`}
                 >
                   <span className='flex items-center gap-2'>
-                    {model.source === 'openai-compatible' ? (
-                      (() => {
-                        const preset = parsePresetFromModelId(model.id)
-                        const isTeal =
-                          preset === 'preset1' || preset === 'preset2'
-                        return (
-                          <span
-                            className={`rounded px-1 py-0.5 text-[10px] leading-none font-semibold uppercase ${
-                              isTeal
-                                ? 'bg-teal-500/10 text-teal-600 dark:text-teal-400'
-                                : 'bg-emerald-500/10 text-emerald-600 dark:text-emerald-400'
-                            }`}
-                          >
-                            {preset
-                              ? (LOCAL_LLM_PRESET_LABELS[preset] ?? preset)
-                              : 'OpenAI-like'}
-                          </span>
-                        )
-                      })()
-                    ) : model.source !== 'local' ? (
+                    {model.source !== 'local' ? (
                       <span className='bg-primary/10 text-primary rounded px-1 py-0.5 text-[10px] leading-none font-semibold uppercase'>
                         {getProviderDisplayName(model.source)}
                       </span>
                     ) : null}
-                    {/* Display model name: strip "openai-compatible:preset:" prefix */}
-                    {model.source === 'openai-compatible' &&
-                    model.id.split(':').length >= 3
-                      ? model.id.split(':').slice(2).join(':')
-                      : model.id.includes(':')
-                        ? model.id.split(':')[1]
-                        : model.id}
+                    {model.id.includes(':')
+                      ? model.id.split(':')[1]
+                      : model.id}
                   </span>
                 </SelectItem>
               ))}
@@ -313,65 +376,10 @@ function LlmStatusPopover() {
             </p>
           )}
 
-          {/* Loaded model info card */}
-          {llmReady &&
-            selectedModelInfo?.source === 'openai-compatible' &&
-            (() => {
-              const infoPreset = parsePresetFromModelId(selectedModelInfo.id)
-              const isTeal =
-                infoPreset === 'preset1' || infoPreset === 'preset2'
-              const presetLabel = infoPreset
-                ? (LOCAL_LLM_PRESET_LABELS[infoPreset] ?? infoPreset)
-                : 'OpenAI-like'
-              const presetCfg = infoPreset
-                ? localLlm.presets[infoPreset]
-                : undefined
-              const modelName =
-                selectedModelInfo.id.split(':').length >= 3
-                  ? selectedModelInfo.id.split(':').slice(2).join(':')
-                  : (selectedModelInfo.id.split(':')[1] ?? selectedModelInfo.id)
-              return (
-                <div
-                  className={`rounded-md px-2.5 py-2 text-xs ${
-                    isTeal
-                      ? 'border border-teal-500/20 bg-teal-500/5'
-                      : 'border border-emerald-500/20 bg-emerald-500/5'
-                  }`}
-                >
-                  <div className='flex items-center gap-1.5'>
-                    <span
-                      className={`size-1.5 rounded-full ${
-                        isTeal ? 'bg-teal-500' : 'bg-emerald-500'
-                      }`}
-                    />
-                    <span
-                      className={`font-medium ${
-                        isTeal
-                          ? 'text-teal-700 dark:text-teal-400'
-                          : 'text-emerald-700 dark:text-emerald-400'
-                      }`}
-                    >
-                      {t('llm.localModelActive')}
-                    </span>
-                  </div>
-                  <p className='text-muted-foreground mt-1'>
-                    {t('llm.localModelName', { name: modelName })}
-                  </p>
-                  <p className='text-muted-foreground mt-0.5'>
-                    {presetLabel}
-                    {presetCfg?.temperature != null &&
-                      ` · temp ${presetCfg.temperature}`}
-                    {presetCfg?.maxTokens != null &&
-                      ` · ${presetCfg.maxTokens} tokens`}
-                  </p>
-                </div>
-              )
-            })()}
-
           {activeLanguages.length > 0 && (
             <Select
               value={llmSelectedLanguage ?? activeLanguages[0]}
-              onValueChange={llmSetSelectedLanguage}
+              onValueChange={handleSetSelectedLanguage}
             >
               <SelectTrigger
                 data-testid='llm-language-select'
@@ -399,7 +407,7 @@ function LlmStatusPopover() {
             data-llm-loading={llmLoading ? 'true' : 'false'}
             variant='outline'
             size='sm'
-            onClick={llmToggleLoadUnload}
+            onClick={handleToggleLoadUnload}
             disabled={!llmSelectedModel || llmLoading}
             className='w-full gap-1.5 text-xs'
           >

ui/components/canvas/Workspace.tsx

@@ -15,6 +15,7 @@ import { listen } from '@/lib/backend'
 import { Image } from '@/components/Image'
 import {
   setCanvasViewport,
+  setCanvasDocumentSize,
   fitCanvasToViewport,
 } from '@/components/canvas/canvasViewport'
 import { ToolRail } from '@/components/canvas/ToolRail'
@@ -61,6 +62,13 @@ export function Workspace() {
     appendBlock,
     removeBlock,
   } = useTextBlocks()
+
+  useEffect(() => {
+    if (currentDocument) {
+      setCanvasDocumentSize(currentDocument.width, currentDocument.height)
+    }
+  }, [currentDocument?.width, currentDocument?.height])
+
   const viewportRef = useRef<HTMLDivElement | null>(null)
   const { setScale: applyScale } = useCanvasZoom()
   const scaleRatio = scale / 100

ui/components/canvas/canvasViewport.ts

@@ -1,35 +1,31 @@
 'use client'
 
-import { queryKeys } from '@/lib/query/keys'
-import { getQueryClient } from '@/lib/query/client'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import type { Document } from '@/types'
 
 const canvasViewportRef: { current: HTMLDivElement | null } = { current: null }
+let docSize: { width: number; height: number } | null = null
 
 export function setCanvasViewport(element: HTMLDivElement | null) {
   canvasViewportRef.current = element
 }
 
+export function setCanvasDocumentSize(width: number, height: number) {
+  docSize = { width, height }
+}
+
 export function fitCanvasToViewport() {
-  const { setScale, setAutoFitEnabled, currentDocumentIndex } =
-    useEditorUiStore.getState()
-  const doc = getQueryClient().getQueryData<Document>(
-    queryKeys.documents.current(currentDocumentIndex),
-  )
   const viewport = canvasViewportRef.current
-  if (!doc || !viewport) return
+  if (!docSize || !viewport) return
   const rect = viewport.getBoundingClientRect()
-  if (!rect.width || !rect.height || !doc.width || !doc.height) return
-  const scaleW = ((rect.width - 10) / doc.width) * 100 // leave 10px for margin
-  const scaleH = ((rect.height - 10) / doc.height) * 100 // leave 10px for margin
+  if (!rect.width || !rect.height || !docSize.width || !docSize.height) return
+  const scaleW = ((rect.width - 10) / docSize.width) * 100
+  const scaleH = ((rect.height - 10) / docSize.height) * 100
   const fit = Math.max(10, Math.min(100, Math.min(scaleW, scaleH)))
-  setAutoFitEnabled(true)
-  setScale(fit)
+  useEditorUiStore.getState().setAutoFitEnabled(true)
+  useEditorUiStore.getState().setScale(fit)
 }
 
 export function resetCanvasScale() {
-  const { setScale, setAutoFitEnabled } = useEditorUiStore.getState()
-  setAutoFitEnabled(false)
-  setScale(100)
+  useEditorUiStore.getState().setAutoFitEnabled(false)
+  useEditorUiStore.getState().setScale(100)
 }

ui/components/panels/LayersPanel.tsx

@@ -14,7 +14,7 @@ import {
 import { cn } from '@/lib/utils'
 import { Button } from '@/components/ui/button'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useCurrentDocumentState } from '@/lib/query/hooks'
+import { useCurrentDocument } from '@/hooks/useTextBlocks'
 
 type Layer = {
   id: string
@@ -27,7 +27,7 @@ type Layer = {
 }
 
 export function LayersPanel() {
-  const { currentDocument } = useCurrentDocumentState()
+  const currentDocument = useCurrentDocument()
   const showInpaintedImage = useEditorUiStore(
     (state) => state.showInpaintedImage,
   )

ui/components/panels/RenderControlsPanel.tsx

@@ -20,7 +20,7 @@ import {
   TextAlign,
   TextStyle,
 } from '@/types'
-import type { FontFaceInfo } from '@/lib/protocol'
+import type { FontFaceInfo } from '@/lib/api/schemas'
 import { Button } from '@/components/ui/button'
 import { ColorPicker } from '@/components/ui/color-picker'
 import { Input } from '@/components/ui/input'
@@ -38,8 +38,7 @@ import {
 } from '@/components/ui/select'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
-import { useFontsQuery } from '@/lib/query/hooks'
-import { useTextBlockMutations } from '@/lib/query/mutations'
+import { useListFonts } from '@/lib/api/system/system'
 import { cn } from '@/lib/utils'
 
 const DEFAULT_COLOR: RgbaColor = [0, 0, 0, 255]
@@ -183,11 +182,10 @@ export function RenderControlsPanel() {
   const renderStroke = useEditorUiStore((state) => state.renderStroke)
   const setRenderEffect = useEditorUiStore((state) => state.setRenderEffect)
   const setRenderStroke = useEditorUiStore((state) => state.setRenderStroke)
-  const { updateTextBlocks } = useTextBlockMutations()
-  const { data: availableFonts = [] } = useFontsQuery()
+  const { data: availableFonts = [] } = useListFonts()
   const fontFamily = usePreferencesStore((state) => state.fontFamily)
   const setFontFamily = usePreferencesStore((state) => state.setFontFamily)
-  const { textBlocks, selectedBlockIndex, replaceBlock } = useTextBlocks()
+  const { textBlocks, selectedBlockIndex, replaceBlock, updateTextBlocks } = useTextBlocks()
   const { t } = useTranslation()
   const selectedBlock =
     selectedBlockIndex !== undefined

ui/components/panels/TextBlocksPanel.tsx

@@ -2,12 +2,20 @@
 
 import { useState } from 'react'
 import { useTranslation } from 'react-i18next'
+import { useQueryClient } from '@tanstack/react-query'
 import { motion } from 'motion/react'
 import { TextBlock } from '@/types'
 import { Languages, LoaderCircleIcon, Trash2Icon } from 'lucide-react'
 import { useTextBlocks } from '@/hooks/useTextBlocks'
-import { useLlmReadyQuery } from '@/lib/query/hooks'
-import { useLlmMutations } from '@/lib/query/mutations'
+import { useGetLlm } from '@/lib/api/llm/llm'
+import { translateDocument } from '@/lib/api/processing/processing'
+import { renderDocument } from '@/lib/api/processing/processing'
+import {
+  getGetDocumentQueryKey,
+  getListDocumentsQueryKey,
+} from '@/lib/api/documents/documents'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import { usePreferencesStore } from '@/lib/stores/preferencesStore'
 import {
   Accordion,
   AccordionContent,
@@ -24,6 +32,7 @@ import { DraftTextarea } from '@/components/ui/draft-textarea'
 import { ScrollArea } from '@/components/ui/scroll-area'
 
 export function TextBlocksPanel() {
+  const queryClient = useQueryClient()
   const {
     document,
     textBlocks,
@@ -33,8 +42,8 @@ export function TextBlocksPanel() {
     removeBlock,
   } = useTextBlocks()
   const { t } = useTranslation()
-  const { llmGenerate } = useLlmMutations()
-  const { data: llmReady = false } = useLlmReadyQuery()
+  const { data: llm } = useGetLlm()
+  const llmReady = llm?.status === 'ready'
   const [generatingIndex, setGeneratingIndex] = useState<number | null>(null)
   const generating = generatingIndex !== null
 
@@ -49,10 +58,30 @@ export function TextBlocksPanel() {
   const accordionValue =
     selectedBlockIndex !== undefined ? selectedBlockIndex.toString() : ''
 
+  const invalidateDocument = async (documentId: string) => {
+    await queryClient.invalidateQueries({ queryKey: getGetDocumentQueryKey(documentId) })
+    await queryClient.invalidateQueries({ queryKey: getListDocumentsQueryKey() })
+  }
+
   const handleGenerate = async (blockIndex: number) => {
+    const documentId = useEditorUiStore.getState().currentDocumentId
+    if (!documentId) return
+    const selectedLanguage = useEditorUiStore.getState().selectedLanguage
+    const textBlockId = document.textBlocks[blockIndex]?.id
     setGeneratingIndex(blockIndex)
     try {
-      await llmGenerate(undefined, undefined, blockIndex)
+      await translateDocument(documentId, { textBlockId, language: selectedLanguage })
+      await invalidateDocument(documentId)
+      useEditorUiStore.getState().setShowTextBlocksOverlay(true)
+      // Re-render the block's sprite
+      const { renderEffect, renderStroke } = useEditorUiStore.getState()
+      const { fontFamily } = usePreferencesStore.getState()
+      await renderDocument(documentId, {
+        shaderEffect: renderEffect,
+        shaderStroke: renderStroke,
+        fontFamily,
+      })
+      await invalidateDocument(documentId)
     } catch (error) {
       console.error(error)
     } finally {

ui/hooks/useBlockContextMenu.ts

@@ -2,11 +2,11 @@
 
 import { useState } from 'react'
 import type React from 'react'
-import { Document } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
 import type { PointerToDocumentFn } from '@/hooks/usePointerToDocument'
 
 type BlockContextMenuOptions = {
-  currentDocument: Document | null
+  currentDocument: MappedDocument | null
   pointerToDocument: PointerToDocumentFn
   selectBlock: (index?: number) => void
   removeBlock: (index: number) => void

ui/hooks/useBlockDrafting.ts

@@ -2,7 +2,8 @@
 
 import { useRef, useState } from 'react'
 import { useDrag } from '@use-gesture/react'
-import { Document, TextBlock, ToolMode } from '@/types'
+import { TextBlock, ToolMode } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
 import type {
   PointerToDocumentFn,
   DocumentPointer,
@@ -10,7 +11,7 @@ import type {
 
 type BlockDraftingOptions = {
   mode: ToolMode
-  currentDocument: Document | null
+  currentDocument: MappedDocument | null
   pointerToDocument: PointerToDocumentFn
   clearSelection: () => void
   onCreateBlock: (block: TextBlock) => void

ui/hooks/useBrushLayerDisplay.ts

@@ -2,10 +2,10 @@
 
 import { useEffect, useRef } from 'react'
 import { convertToImageBitmap } from '@/lib/util'
-import { Document } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
 
 type BrushLayerDisplayOptions = {
-  currentDocument: Document | null
+  currentDocument: MappedDocument | null
   visible: boolean
 }
 

ui/hooks/useCanvasDrawing.ts

@@ -0,0 +1,285 @@
+'use client'
+
+import { useEffect, useRef, type RefObject } from 'react'
+import { useDrag } from '@use-gesture/react'
+import { blobToUint8Array } from '@/lib/util'
+import type { InpaintRegion } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
+import {
+  type PointerToDocumentFn,
+  type DocumentPointer,
+} from '@/hooks/usePointerToDocument'
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+type Bounds = {
+  minX: number
+  minY: number
+  maxX: number
+  maxY: number
+}
+
+export type CanvasDrawingConfig = {
+  getColor: () => string
+  blendMode: GlobalCompositeOperation
+  getBrushSize: () => number
+  onFinalize: (patch: Uint8Array, region: InpaintRegion) => Promise<void>
+  /** Called after finalize with the full-canvas PNG and the patch region. */
+  onFinalizeFullCanvas?: (
+    fullPng: Uint8Array,
+    patchRegion: InpaintRegion,
+  ) => Promise<void>
+  enabled: boolean
+  /** Optional second canvas to mirror strokes to. */
+  targetCanvasRef?: RefObject<HTMLCanvasElement | null>
+  /** When true, clear the drawing canvas after each stroke finalize. */
+  clearAfterStroke?: boolean
+  /** Called to set up the canvas content when the document changes (e.g. draw existing mask). */
+  onCanvasInit?: (ctx: CanvasRenderingContext2D, doc: MappedDocument) => void | Promise<void>
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+const clampToDocument = (
+  point: DocumentPointer,
+  doc?: MappedDocument,
+): DocumentPointer => {
+  if (!doc) return point
+  return {
+    x: Math.max(0, Math.min(doc.width, point.x)),
+    y: Math.max(0, Math.min(doc.height, point.y)),
+  }
+}
+
+const expandBounds = (
+  bounds: Bounds,
+  point: DocumentPointer,
+  radius: number,
+): Bounds => ({
+  minX: Math.min(bounds.minX, point.x - radius),
+  minY: Math.min(bounds.minY, point.y - radius),
+  maxX: Math.max(bounds.maxX, point.x + radius),
+  maxY: Math.max(bounds.maxY, point.y + radius),
+})
+
+const boundsToRegion = (bounds: Bounds, doc: MappedDocument): InpaintRegion => {
+  const x0 = Math.max(0, Math.floor(bounds.minX))
+  const y0 = Math.max(0, Math.floor(bounds.minY))
+  const x1 = Math.min(doc.width, Math.ceil(bounds.maxX))
+  const y1 = Math.min(doc.height, Math.ceil(bounds.maxY))
+  return { x: x0, y: y0, width: Math.max(1, x1 - x0), height: Math.max(1, y1 - y0) }
+}
+
+const exportCanvasRegion = async (
+  canvas: HTMLCanvasElement,
+  region: InpaintRegion,
+): Promise<Uint8Array | null> => {
+  if (region.width <= 0 || region.height <= 0) return null
+  const tmp = document.createElement('canvas')
+  tmp.width = region.width
+  tmp.height = region.height
+  const ctx = tmp.getContext('2d')
+  if (!ctx) return null
+  ctx.drawImage(canvas, region.x, region.y, region.width, region.height, 0, 0, region.width, region.height)
+  const blob = await new Promise<Blob | null>((r) => tmp.toBlob(r, 'image/png'))
+  return blob ? blobToUint8Array(blob) : null
+}
+
+const exportFullCanvas = async (
+  canvas: HTMLCanvasElement,
+): Promise<Uint8Array | null> => {
+  const blob = await new Promise<Blob | null>((r) => canvas.toBlob(r, 'image/png'))
+  return blob ? blobToUint8Array(blob) : null
+}
+
+const initBounds = (point: DocumentPointer, radius: number): Bounds => ({
+  minX: point.x - radius,
+  minY: point.y - radius,
+  maxX: point.x + radius,
+  maxY: point.y + radius,
+})
+
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+
+export function useCanvasDrawing(
+  currentDocument: MappedDocument | null,
+  pointerToDocument: PointerToDocumentFn,
+  config: CanvasDrawingConfig,
+) {
+  const canvasRef = useRef<HTMLCanvasElement | null>(null)
+  const ctxRef = useRef<CanvasRenderingContext2D | null>(null)
+  const drawingRef = useRef(false)
+  const lastPointRef = useRef<DocumentPointer | null>(null)
+  const boundsRef = useRef<Bounds | null>(null)
+
+  // Reset drawing state when disabled
+  useEffect(() => {
+    if (config.enabled) return
+    drawingRef.current = false
+    lastPointRef.current = null
+    boundsRef.current = null
+  }, [config.enabled])
+
+  // Canvas setup and resize
+  useEffect(() => {
+    const canvas = canvasRef.current
+    if (!canvas) return
+    const ctx = canvas.getContext('2d')
+    ctxRef.current = ctx
+
+    if (!currentDocument || !config.enabled) {
+      canvas.width = 0
+      canvas.height = 0
+      ctx?.clearRect(0, 0, canvas.width, canvas.height)
+      return () => {
+        drawingRef.current = false
+        lastPointRef.current = null
+        boundsRef.current = null
+      }
+    }
+
+    const needsResize =
+      canvas.width !== currentDocument.width ||
+      canvas.height !== currentDocument.height
+
+    if (needsResize) {
+      canvas.width = currentDocument.width
+      canvas.height = currentDocument.height
+    }
+    ctx?.clearRect(0, 0, canvas.width, canvas.height)
+
+    let cancelled = false
+    if (config.onCanvasInit && ctx) {
+      const result = config.onCanvasInit(ctx, currentDocument)
+      if (result && typeof (result as any).then === 'function') {
+        void (result as Promise<void>).catch(console.error)
+      }
+    }
+
+    return () => {
+      cancelled = true
+      drawingRef.current = false
+      lastPointRef.current = null
+      boundsRef.current = null
+    }
+  }, [
+    currentDocument?.id,
+    currentDocument?.width,
+    currentDocument?.height,
+    config.enabled,
+  ])
+
+  const drawStroke = (from: DocumentPointer, to: DocumentPointer) => {
+    const color = config.getColor()
+    const brushSize = config.getBrushSize()
+
+    const stroke = (ctx: CanvasRenderingContext2D) => {
+      ctx.save()
+      ctx.lineCap = 'round'
+      ctx.lineJoin = 'round'
+      ctx.lineWidth = brushSize
+      ctx.strokeStyle = color
+      ctx.fillStyle = color
+      ctx.globalCompositeOperation = config.blendMode
+      ctx.beginPath()
+      ctx.moveTo(from.x, from.y)
+      ctx.lineTo(to.x, to.y)
+      ctx.stroke()
+      ctx.restore()
+    }
+
+    const ctx = ctxRef.current
+    if (ctx) stroke(ctx)
+
+    const targetCtx = config.targetCanvasRef?.current?.getContext('2d')
+    if (targetCtx) stroke(targetCtx)
+  }
+
+  const finalizeStroke = () => {
+    if (!config.enabled) return
+    const strokeBounds = boundsRef.current
+    if (!currentDocument || !strokeBounds) return
+    const patchRegion = boundsToRegion(strokeBounds, currentDocument)
+    boundsRef.current = null
+    drawingRef.current = false
+    lastPointRef.current = null
+
+    void (async () => {
+      const sourceCanvas = config.targetCanvasRef?.current ?? canvasRef.current
+      if (!sourceCanvas) return
+      const patchBytes = await exportCanvasRegion(sourceCanvas, patchRegion)
+
+      if (config.onFinalizeFullCanvas) {
+        const fullBytes = await exportFullCanvas(canvasRef.current!)
+        if (fullBytes) {
+          try {
+            await config.onFinalizeFullCanvas(fullBytes, patchRegion)
+          } catch (e) {
+            console.error(e)
+          }
+        }
+      }
+
+      if (patchBytes) {
+        try {
+          await config.onFinalize(patchBytes, patchRegion)
+        } catch (e) {
+          console.error(e)
+        }
+      }
+
+      if (config.clearAfterStroke) {
+        const ctx = ctxRef.current
+        const canvas = canvasRef.current
+        if (ctx && canvas) ctx.clearRect(0, 0, canvas.width, canvas.height)
+      }
+    })()
+  }
+
+  const bind = useDrag(
+    ({ first, last, event, active }) => {
+      if (!config.enabled || !currentDocument) return
+      const sourceEvent = event as MouseEvent
+      const point = pointerToDocument(sourceEvent)
+      if (!point) {
+        if ((last || !active) && drawingRef.current) finalizeStroke()
+        return
+      }
+      const clamped = clampToDocument(point, currentDocument)
+      const brushSize = config.getBrushSize()
+      const radius = brushSize / 2
+
+      if (first) {
+        drawingRef.current = true
+        lastPointRef.current = clamped
+        boundsRef.current = initBounds(clamped, radius)
+        drawStroke(clamped, clamped)
+        return
+      }
+
+      if (!drawingRef.current) return
+      const lastPoint = lastPointRef.current ?? clamped
+      drawStroke(lastPoint, clamped)
+      lastPointRef.current = clamped
+      boundsRef.current = boundsRef.current
+        ? expandBounds(boundsRef.current, clamped, radius)
+        : initBounds(clamped, radius)
+
+      if (last || !active) finalizeStroke()
+    },
+    {
+      pointer: { buttons: 1, touch: true },
+      preventDefault: true,
+      filterTaps: true,
+      eventOptions: { passive: false },
+    },
+  )
+
+  return { canvasRef, visible: config.enabled, bind }
+}

ui/hooks/useCanvasZoom.ts

@@ -1,16 +1,19 @@
 'use client'
 
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useCurrentDocumentState } from '@/lib/query/hooks'
+import { useGetDocument } from '@/lib/api/documents/documents'
 
 export function useCanvasZoom() {
   const scale = useEditorUiStore((state) => state.scale)
   const setScaleRaw = useEditorUiStore((state) => state.setScale)
   const setAutoFitEnabled = useEditorUiStore((state) => state.setAutoFitEnabled)
-  const { currentDocument } = useCurrentDocumentState()
+  const documentId = useEditorUiStore((s) => s.currentDocumentId)
+  const { data: document } = useGetDocument(documentId ?? '', {
+    query: { enabled: !!documentId },
+  })
 
-  const summary = currentDocument
-    ? `${currentDocument.width} x ${currentDocument.height}`
+  const summary = document
+    ? `${document.width} x ${document.height}`
     : '--'
 
   const applyScale = (value: number) => {

ui/hooks/useMaskDrawing.ts

@@ -1,87 +1,31 @@
 'use client'
 
-import { useEffect, useRef } from 'react'
-import { useDrag } from '@use-gesture/react'
+import { useCallback, useRef } from 'react'
+import { useQueryClient } from '@tanstack/react-query'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
-import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useMaskMutations } from '@/lib/query/mutations'
-import { blobToUint8Array, convertToImageBitmap } from '@/lib/util'
-import { Document, InpaintRegion, ToolMode } from '@/types'
 import {
-  PointerToDocumentFn,
-  type DocumentPointer,
-} from '@/hooks/usePointerToDocument'
+  updateMask as updateMaskApi,
+  inpaintRegion as inpaintRegionApi,
+} from '@/lib/api/regions/regions'
+import {
+  getGetDocumentQueryKey,
+  getListDocumentsQueryKey,
+} from '@/lib/api/documents/documents'
+import { convertToImageBitmap } from '@/lib/util'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import type { ToolMode } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
+import type { PointerToDocumentFn } from '@/hooks/usePointerToDocument'
+import { useCanvasDrawing } from '@/hooks/useCanvasDrawing'
 
 type MaskDrawingOptions = {
   mode: ToolMode
-  currentDocument: Document | null
+  currentDocument: MappedDocument | null
   pointerToDocument: PointerToDocumentFn
   showMask: boolean
   enabled: boolean
 }
 
-type Bounds = {
-  minX: number
-  minY: number
-  maxX: number
-  maxY: number
-}
-
-const clampToDocument = (
-  point: DocumentPointer,
-  doc?: Document,
-): DocumentPointer => {
-  if (!doc) return point
-  return {
-    x: Math.max(0, Math.min(doc.width, point.x)),
-    y: Math.max(0, Math.min(doc.height, point.y)),
-  }
-}
-
-const expandBounds = (bounds: Bounds, point: DocumentPointer, radius: number) =>
-  ({
-    minX: Math.min(bounds.minX, point.x - radius),
-    minY: Math.min(bounds.minY, point.y - radius),
-    maxX: Math.max(bounds.maxX, point.x + radius),
-    maxY: Math.max(bounds.maxY, point.y + radius),
-  }) satisfies Bounds
-
-const withMargin = (
-  bounds: Bounds,
-  brushSize: number,
-  doc: Document,
-): InpaintRegion => {
-  const width = Math.max(brushSize, bounds.maxX - bounds.minX)
-  const height = Math.max(brushSize, bounds.maxY - bounds.minY)
-  const margin = Math.min(width * 0.2, 32)
-
-  const x0 = Math.max(0, Math.floor(bounds.minX - margin))
-  const y0 = Math.max(0, Math.floor(bounds.minY - margin))
-  const x1 = Math.min(doc.width, Math.ceil(bounds.maxX + margin))
-  const y1 = Math.min(doc.height, Math.ceil(bounds.maxY + margin))
-
-  return {
-    x: x0,
-    y: y0,
-    width: Math.max(1, x1 - x0),
-    height: Math.max(1, y1 - y0),
-  }
-}
-
-const boundsToRegion = (bounds: Bounds, doc: Document): InpaintRegion => {
-  const x0 = Math.max(0, Math.floor(bounds.minX))
-  const y0 = Math.max(0, Math.floor(bounds.minY))
-  const x1 = Math.min(doc.width, Math.ceil(bounds.maxX))
-  const y1 = Math.min(doc.height, Math.ceil(bounds.maxY))
-
-  return {
-    x: x0,
-    y: y0,
-    width: Math.max(1, x1 - x0),
-    height: Math.max(1, y1 - y0),
-  }
-}
-
 export function useMaskDrawing({
   mode,
   currentDocument,
@@ -89,254 +33,86 @@ export function useMaskDrawing({
   showMask,
   enabled,
 }: MaskDrawingOptions) {
-  const {
-    brushConfig: { size: brushSize },
-  } = usePreferencesStore()
-  const { updateMask, inpaintPartial } = useMaskMutations()
-  const currentDocumentIndex = useEditorUiStore(
-    (state) => state.currentDocumentIndex,
-  )
-  const canvasRef = useRef<HTMLCanvasElement | null>(null)
-  const ctxRef = useRef<CanvasRenderingContext2D | null>(null)
-  const drawingRef = useRef(false)
-  const lastPointRef = useRef<DocumentPointer | null>(null)
-  const boundsRef = useRef<Bounds | null>(null)
+  const queryClient = useQueryClient()
   const inpaintQueueRef = useRef<Promise<void>>(Promise.resolve())
-  const isRepairMode = mode === 'repairBrush'
   const isEraseMode = mode === 'eraser'
-  const isActive = enabled && (isRepairMode || isEraseMode)
-
-  // Reset drawing state when interaction is disabled so stale strokes don't carry over.
-  useEffect(() => {
-    if (enabled) return
-    drawingRef.current = false
-    lastPointRef.current = null
-    boundsRef.current = null
-    inpaintQueueRef.current = Promise.resolve()
-  }, [enabled, mode])
-
-  useEffect(() => {
-    const canvas = canvasRef.current
-    if (!canvas) return
-    const ctx = canvas.getContext('2d')
-    ctxRef.current = ctx
+  const isActive = enabled && (mode === 'repairBrush' || isEraseMode)
 
-    if (!currentDocument) {
-      canvas.width = 0
-      canvas.height = 0
-      ctx?.clearRect(0, 0, canvas.width, canvas.height)
-      return
-    }
-
-    const needsResize =
-      canvas.width !== currentDocument.width ||
-      canvas.height !== currentDocument.height
-
-    if (needsResize) {
-      canvas.width = currentDocument.width
-      canvas.height = currentDocument.height
-      ctx?.clearRect(0, 0, canvas.width, canvas.height)
-      ctx?.save()
-      ctx && (ctx.fillStyle = '#000')
-      ctx?.fillRect(0, 0, canvas.width, canvas.height)
-      ctx?.restore()
-    }
+  const invalidateDocument = useCallback(
+    async (documentId: string) => {
+      await queryClient.invalidateQueries({ queryKey: getGetDocumentQueryKey(documentId) })
+      await queryClient.invalidateQueries({ queryKey: getListDocumentsQueryKey() })
+    },
+    [queryClient],
+  )
 
-    let cancelled = false
-    if (currentDocument.segment) {
-      void (async () => {
-        try {
-          const bitmap = await convertToImageBitmap(currentDocument.segment!)
-          if (cancelled) {
+  const { canvasRef, bind } = useCanvasDrawing(currentDocument, pointerToDocument, {
+    getColor: () => (isEraseMode ? '#000000' : '#ffffff'),
+    blendMode: 'source-over',
+    getBrushSize: () => usePreferencesStore.getState().brushConfig.size,
+    enabled: isActive,
+    onCanvasInit: (ctx, doc) => {
+      // Fill black then draw existing segment mask on top
+      ctx.fillStyle = '#000'
+      ctx.fillRect(0, 0, doc.width, doc.height)
+      if (doc.segment) {
+        void (async () => {
+          try {
+            const bitmap = await convertToImageBitmap(doc.segment!)
+            ctx.save()
+            ctx.clearRect(0, 0, doc.width, doc.height)
+            ctx.drawImage(bitmap, 0, 0, doc.width, doc.height)
+            ctx.restore()
             bitmap.close()
-            return
+          } catch (e) {
+            console.error(e)
           }
-          // Redraw atomically once the new bitmap is ready so the previous
-          // mask stays visible until swap, avoiding a flicker.
-          ctx?.save()
-          ctx?.clearRect(0, 0, canvas.width, canvas.height)
-          ctx?.drawImage(
-            bitmap,
-            0,
-            0,
-            currentDocument.width,
-            currentDocument.height,
-          )
-          ctx?.restore()
-          bitmap.close()
-        } catch (error) {
-          console.error(error)
-        }
-      })()
-    }
-
-    return () => {
-      cancelled = true
-      drawingRef.current = false
-      lastPointRef.current = null
-      boundsRef.current = null
-      inpaintQueueRef.current = Promise.resolve()
-    }
-  }, [
-    currentDocument?.id,
-    currentDocument?.width,
-    currentDocument?.height,
-    currentDocument?.segment,
-  ])
-
-  const drawStroke = (from: DocumentPointer, to: DocumentPointer) => {
-    const ctx = ctxRef.current
-    if (!ctx) return
-    ctx.save()
-    ctx.lineCap = 'round'
-    ctx.lineJoin = 'round'
-    ctx.lineWidth = brushSize
-    ctx.strokeStyle = isEraseMode ? '#000000' : '#ffffff'
-    ctx.fillStyle = ctx.strokeStyle
-    ctx.globalCompositeOperation = 'source-over'
-
-    ctx.beginPath()
-    ctx.moveTo(from.x, from.y)
-    ctx.lineTo(to.x, to.y)
-    ctx.stroke()
-    ctx.restore()
-  }
-
-  const exportMaskBytes = async (): Promise<Uint8Array | null> => {
-    const canvas = canvasRef.current
-    if (!canvas) return null
-    const blob = await new Promise<Blob | null>((resolve) => {
-      canvas.toBlob((result) => resolve(result), 'image/png')
-    })
-    if (!blob) return null
-    return blobToUint8Array(blob)
-  }
-
-  const exportMaskPatch = async (
-    region: InpaintRegion,
-  ): Promise<Uint8Array | null> => {
-    const canvas = canvasRef.current
-    if (!canvas || region.width <= 0 || region.height <= 0) return null
-
-    const tempCanvas = document.createElement('canvas')
-    tempCanvas.width = region.width
-    tempCanvas.height = region.height
-    const tempCtx = tempCanvas.getContext('2d')
-    if (!tempCtx) return null
-
-    tempCtx.drawImage(
-      canvas,
-      region.x,
-      region.y,
-      region.width,
-      region.height,
-      0,
-      0,
-      region.width,
-      region.height,
-    )
-
-    const blob = await new Promise<Blob | null>((resolve) => {
-      tempCanvas.toBlob((result) => resolve(result), 'image/png')
-    })
-    if (!blob) return null
-    return blobToUint8Array(blob)
-  }
-
-  const queueInpaint = (task: () => Promise<void>) => {
-    inpaintQueueRef.current = inpaintQueueRef.current.catch(() => {}).then(task)
-  }
-
-  const finalizeStroke = () => {
-    if (!isActive) return
-    const strokeBounds = boundsRef.current
-    if (!currentDocument || !strokeBounds) return
-    const patchRegion = boundsToRegion(strokeBounds, currentDocument)
-    const region = withMargin(strokeBounds, brushSize, currentDocument)
-    boundsRef.current = null
-    drawingRef.current = false
-    lastPointRef.current = null
-
-    void (async () => {
-      const [maskBytes, patchBytes] = await Promise.all([
-        exportMaskBytes(),
-        exportMaskPatch(patchRegion),
-      ])
-      if (!maskBytes) return
+        })()
+      }
+    },
+    onFinalizeFullCanvas: async (fullPng) => {
+      const documentId = useEditorUiStore.getState().currentDocumentId
+      if (!documentId) return
       try {
-        await updateMask(maskBytes, {
-          patchRegion: patchBytes ? patchRegion : undefined,
-          patch: patchBytes ?? undefined,
+        await updateMaskApi(documentId, {
+          data: Array.from(fullPng),
         })
-      } catch (error) {
-        console.error(error)
-      }
-      queueInpaint(async () => {
-        try {
-          await inpaintPartial(region, {
-            index: currentDocumentIndex,
-          })
-        } catch (error) {
-          console.error(error)
-        }
-      })
-    })()
-  }
-
-  const bind = useDrag(
-    ({ first, last, event, active }) => {
-      if (!isActive || !currentDocument) return
-      const sourceEvent = event as MouseEvent
-      const point = pointerToDocument(sourceEvent)
-      if (!point) {
-        if ((last || !active) && drawingRef.current) {
-          finalizeStroke()
-        }
-        return
+      } catch (e) {
+        console.error(e)
       }
-      const clamped = clampToDocument(point, currentDocument)
-
-      if (first) {
-        drawingRef.current = true
-        lastPointRef.current = clamped
-        boundsRef.current = {
-          minX: clamped.x - brushSize / 2,
-          minY: clamped.y - brushSize / 2,
-          maxX: clamped.x + brushSize / 2,
-          maxY: clamped.y + brushSize / 2,
-        }
-        drawStroke(clamped, clamped)
-        return
+    },
+    onFinalize: async (_patch, region) => {
+      const documentId = useEditorUiStore.getState().currentDocumentId
+      if (!documentId) return
+      // Compute the inpaint region with margin
+      const brushSize = usePreferencesStore.getState().brushConfig.size
+      const width = Math.max(brushSize, region.width)
+      const height = Math.max(brushSize, region.height)
+      const margin = Math.min(width * 0.2, 32)
+      const doc = currentDocument!
+      const x0 = Math.max(0, Math.floor(region.x - margin))
+      const y0 = Math.max(0, Math.floor(region.y - margin))
+      const x1 = Math.min(doc.width, Math.ceil(region.x + region.width + margin))
+      const y1 = Math.min(doc.height, Math.ceil(region.y + region.height + margin))
+      const inpaintRegion = {
+        x: x0,
+        y: y0,
+        width: Math.max(1, x1 - x0),
+        height: Math.max(1, y1 - y0),
       }
-
-      if (!drawingRef.current) return
-      const lastPoint = lastPointRef.current ?? clamped
-      drawStroke(lastPoint, clamped)
-      lastPointRef.current = clamped
-      boundsRef.current = boundsRef.current
-        ? expandBounds(boundsRef.current, clamped, brushSize / 2)
-        : {
-            minX: clamped.x - brushSize / 2,
-            minY: clamped.y - brushSize / 2,
-            maxX: clamped.x + brushSize / 2,
-            maxY: clamped.y + brushSize / 2,
+      inpaintQueueRef.current = inpaintQueueRef.current
+        .catch(() => {})
+        .then(async () => {
+          try {
+            await inpaintRegionApi(documentId, { region: inpaintRegion })
+            await invalidateDocument(documentId)
+            useEditorUiStore.getState().setShowInpaintedImage(true)
+          } catch (e) {
+            console.error(e)
           }
-
-      if (last || !active) {
-        finalizeStroke()
-      }
-    },
-    {
-      pointer: { buttons: 1, touch: true },
-      preventDefault: true,
-      filterTaps: true,
-      eventOptions: { passive: false },
+        })
     },
-  )
+  })
 
-  return {
-    canvasRef,
-    visible: showMask,
-    bind,
-  }
+  return { canvasRef, visible: showMask, bind }
 }

ui/hooks/useRenderBrushDrawing.ts

@@ -1,274 +1,56 @@
 'use client'
 
-import { useEffect, useRef, type RefObject } from 'react'
-import { useDrag } from '@use-gesture/react'
+import type { RefObject } from 'react'
+import { useQueryClient } from '@tanstack/react-query'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
-import { useEditorUiStore } from '@/lib/stores/editorUiStore'
-import { useMaskMutations } from '@/lib/query/mutations'
-import { Document, InpaintRegion, ToolMode } from '@/types'
-import { blobToUint8Array } from '@/lib/util'
+import { updateBrushLayer } from '@/lib/api/regions/regions'
 import {
-  PointerToDocumentFn,
-  type DocumentPointer,
-} from '@/hooks/usePointerToDocument'
+  getGetDocumentQueryKey,
+  getListDocumentsQueryKey,
+} from '@/lib/api/documents/documents'
+import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import type { ToolMode } from '@/types'
+import type { MappedDocument } from '@/hooks/useTextBlocks'
+import type { PointerToDocumentFn } from '@/hooks/usePointerToDocument'
+import { useCanvasDrawing } from '@/hooks/useCanvasDrawing'
 
 type RenderBrushOptions = {
   mode: ToolMode
-  currentDocument: Document | null
+  currentDocument: MappedDocument | null
   pointerToDocument: PointerToDocumentFn
   enabled: boolean
   action: 'paint' | 'erase'
   targetCanvasRef?: RefObject<HTMLCanvasElement | null>
 }
 
-type Bounds = {
-  minX: number
-  minY: number
-  maxX: number
-  maxY: number
-}
-
-const clampToDocument = (
-  point: DocumentPointer,
-  doc?: Document,
-): DocumentPointer => {
-  if (!doc) return point
-  return {
-    x: Math.max(0, Math.min(doc.width, point.x)),
-    y: Math.max(0, Math.min(doc.height, point.y)),
-  }
-}
-
-const expandBounds = (bounds: Bounds, point: DocumentPointer, radius: number) =>
-  ({
-    minX: Math.min(bounds.minX, point.x - radius),
-    minY: Math.min(bounds.minY, point.y - radius),
-    maxX: Math.max(bounds.maxX, point.x + radius),
-    maxY: Math.max(bounds.maxY, point.y + radius),
-  }) satisfies Bounds
-
-const boundsToRegion = (bounds: Bounds, doc: Document): InpaintRegion => {
-  const x0 = Math.max(0, Math.floor(bounds.minX))
-  const y0 = Math.max(0, Math.floor(bounds.minY))
-  const x1 = Math.min(doc.width, Math.ceil(bounds.maxX))
-  const y1 = Math.min(doc.height, Math.ceil(bounds.maxY))
-
-  return {
-    x: x0,
-    y: y0,
-    width: Math.max(1, x1 - x0),
-    height: Math.max(1, y1 - y0),
-  }
-}
-
 export function useRenderBrushDrawing({
-  mode,
   currentDocument,
   pointerToDocument,
   enabled,
   action,
   targetCanvasRef,
 }: RenderBrushOptions) {
-  const {
-    brushConfig: { size: brushSize, color: brushColor },
-  } = usePreferencesStore()
-  const { paintRendered } = useMaskMutations()
-  const currentDocumentIndex = useEditorUiStore(
-    (state) => state.currentDocumentIndex,
-  )
-  const canvasRef = useRef<HTMLCanvasElement | null>(null)
-  const ctxRef = useRef<CanvasRenderingContext2D | null>(null)
-  const drawingRef = useRef(false)
-  const lastPointRef = useRef<DocumentPointer | null>(null)
-  const boundsRef = useRef<Bounds | null>(null)
-
-  useEffect(() => {
-    const canvas = canvasRef.current
-    if (!canvas) return
-    const ctx = canvas.getContext('2d')
-    ctxRef.current = ctx
-
-    if (!currentDocument || !enabled) {
-      canvas.width = 0
-      canvas.height = 0
-      ctx?.clearRect(0, 0, canvas.width, canvas.height)
-      return () => {
-        drawingRef.current = false
-        lastPointRef.current = null
-        boundsRef.current = null
-      }
-    }
-
-    const needsResize =
-      canvas.width !== currentDocument.width ||
-      canvas.height !== currentDocument.height
-
-    if (needsResize) {
-      canvas.width = currentDocument.width
-      canvas.height = currentDocument.height
-    }
-    ctx?.clearRect(0, 0, canvas.width, canvas.height)
-
-    return () => {
-      drawingRef.current = false
-      lastPointRef.current = null
-      boundsRef.current = null
-    }
-  }, [
-    currentDocument?.id,
-    currentDocument?.width,
-    currentDocument?.height,
-    mode,
+  const queryClient = useQueryClient()
+  const isErasing = action === 'erase'
+
+  return useCanvasDrawing(currentDocument, pointerToDocument, {
+    getColor: () =>
+      isErasing ? '#000000' : usePreferencesStore.getState().brushConfig.color,
+    blendMode: isErasing ? 'destination-out' : 'source-over',
+    getBrushSize: () => usePreferencesStore.getState().brushConfig.size,
     enabled,
-  ])
-
-  const drawStroke = (from: DocumentPointer, to: DocumentPointer) => {
-    if (!enabled) return
-    const isErasing = action === 'erase'
-    const stroke = (ctx: CanvasRenderingContext2D) => {
-      ctx.save()
-      ctx.lineCap = 'round'
-      ctx.lineJoin = 'round'
-      ctx.lineWidth = brushSize
-      ctx.strokeStyle = isErasing ? '#000000' : brushColor
-      ctx.fillStyle = ctx.strokeStyle
-      ctx.globalCompositeOperation = isErasing
-        ? 'destination-out'
-        : 'source-over'
-      ctx.beginPath()
-      ctx.moveTo(from.x, from.y)
-      ctx.lineTo(to.x, to.y)
-      ctx.stroke()
-      ctx.restore()
-    }
-
-    const ctx = ctxRef.current
-    if (ctx) stroke(ctx)
-
-    const targetCanvas = targetCanvasRef?.current
-    const targetCtx = targetCanvas?.getContext('2d')
-    if (targetCtx) stroke(targetCtx)
-  }
-
-  const exportPatch = async (
-    region: InpaintRegion,
-  ): Promise<Uint8Array | null> => {
-    const canvas = targetCanvasRef?.current ?? canvasRef.current
-    if (!canvas || region.width <= 0 || region.height <= 0) return null
-
-    const tempCanvas = document.createElement('canvas')
-    tempCanvas.width = region.width
-    tempCanvas.height = region.height
-    const tempCtx = tempCanvas.getContext('2d')
-    if (!tempCtx) return null
-
-    tempCtx.drawImage(
-      canvas,
-      region.x,
-      region.y,
-      region.width,
-      region.height,
-      0,
-      0,
-      region.width,
-      region.height,
-    )
-
-    const blob = await new Promise<Blob | null>((resolve) => {
-      tempCanvas.toBlob((result) => resolve(result), 'image/png')
-    })
-    if (!blob) return null
-    return blobToUint8Array(blob)
-  }
-
-  const finalizeStroke = () => {
-    if (!enabled) return
-    const strokeBounds = boundsRef.current
-    if (!currentDocument || !strokeBounds) return
-    const patchRegion = boundsToRegion(strokeBounds, currentDocument)
-    boundsRef.current = null
-    drawingRef.current = false
-    lastPointRef.current = null
-
-    void (async () => {
-      const patchBytes = await exportPatch(patchRegion)
-      if (!patchBytes) {
-        const canvas = canvasRef.current
-        const ctx = ctxRef.current
-        if (canvas && ctx) {
-          ctx.clearRect(0, 0, canvas.width, canvas.height)
-        }
-        return
-      }
-      try {
-        await paintRendered(patchBytes, patchRegion, {
-          index: currentDocumentIndex,
-        })
-      } catch (error) {
-        console.error(error)
-      }
-      const canvas = canvasRef.current
-      const ctx = ctxRef.current
-      if (canvas && ctx) {
-        ctx.clearRect(0, 0, canvas.width, canvas.height)
-      }
-    })()
-  }
-
-  const bind = useDrag(
-    ({ first, last, event, active }) => {
-      if (!enabled || !currentDocument) return
-      const sourceEvent = event as MouseEvent
-      const point = pointerToDocument(sourceEvent)
-      if (!point) {
-        if ((last || !active) && drawingRef.current) {
-          finalizeStroke()
-        }
-        return
-      }
-      const clamped = clampToDocument(point, currentDocument)
-
-      if (first) {
-        drawingRef.current = true
-        lastPointRef.current = clamped
-        boundsRef.current = {
-          minX: clamped.x - brushSize / 2,
-          minY: clamped.y - brushSize / 2,
-          maxX: clamped.x + brushSize / 2,
-          maxY: clamped.y + brushSize / 2,
-        }
-        drawStroke(clamped, clamped)
-        return
-      }
-
-      if (!drawingRef.current) return
-      const lastPoint = lastPointRef.current ?? clamped
-      drawStroke(lastPoint, clamped)
-      lastPointRef.current = clamped
-      boundsRef.current = boundsRef.current
-        ? expandBounds(boundsRef.current, clamped, brushSize / 2)
-        : {
-            minX: clamped.x - brushSize / 2,
-            minY: clamped.y - brushSize / 2,
-            maxX: clamped.x + brushSize / 2,
-            maxY: clamped.y + brushSize / 2,
-          }
-
-      if (last || !active) {
-        finalizeStroke()
-      }
-    },
-    {
-      pointer: { buttons: 1, touch: true },
-      preventDefault: true,
-      filterTaps: true,
-      eventOptions: { passive: false },
+    targetCanvasRef,
+    clearAfterStroke: true,
+    onFinalize: async (patch, region) => {
+      const documentId = useEditorUiStore.getState().currentDocumentId
+      if (!documentId) return
+      await updateBrushLayer(documentId, {
+        data: Array.from(patch),
+        region,
+      })
+      await queryClient.invalidateQueries({ queryKey: getGetDocumentQueryKey(documentId) })
+      await queryClient.invalidateQueries({ queryKey: getListDocumentsQueryKey() })
+      useEditorUiStore.getState().setShowBrushLayer(true)
     },
-  )
-
-  return {
-    canvasRef,
-    visible: enabled,
-    bind,
-  }
+  })
 }

ui/hooks/useRpcConnection.ts

@@ -1,12 +0,0 @@
-'use client'
-
-import { useEffect, useState } from 'react'
-import { subscribeRpcConnection } from '@/lib/backend'
-
-export const useRpcConnection = () => {
-  const [connected, setConnected] = useState(false)
-
-  useEffect(() => subscribeRpcConnection(setConnected), [])
-
-  return connected
-}

ui/hooks/useTextBlocks.ts

@@ -1,11 +1,21 @@
 'use client'
 
-import { useEffect, useRef } from 'react'
-import { useCurrentDocumentState } from '@/lib/query/hooks'
-import { useTextBlockMutations } from '@/lib/query/mutations'
-import { createTempTextBlockId } from '@/lib/api'
+import { useCallback, useEffect, useRef } from 'react'
+import { useQueryClient } from '@tanstack/react-query'
+import {
+  useGetDocument,
+  getGetDocumentQueryKey,
+  getListDocumentsQueryKey,
+} from '@/lib/api/documents/documents'
+import { putTextBlocks } from '@/lib/api/text-blocks/text-blocks'
+import { renderDocument } from '@/lib/api/processing/processing'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
+import { usePreferencesStore } from '@/lib/stores/preferencesStore'
 import { TextBlock } from '@/types'
+import type { DocumentDetail, TextBlockInput } from '@/lib/api/schemas'
+
+const createTempTextBlockId = () =>
+  `temp:${globalThis.crypto?.randomUUID?.() ?? Math.random().toString(36).slice(2)}`
 
 const TEXT_BLOCK_RENDER_DEBOUNCE_MS = 250
 
@@ -25,9 +35,86 @@ const hasGeometryChange = (updates: Partial<TextBlock>) =>
   Object.prototype.hasOwnProperty.call(updates, 'width') ||
   Object.prototype.hasOwnProperty.call(updates, 'height')
 
+const toUint8Array = (data: number[] | null | undefined): Uint8Array | undefined =>
+  data ? new Uint8Array(data) : undefined
+
+const mapTextBlock = (
+  block: DocumentDetail['textBlocks'][number],
+): TextBlock => ({
+  id: block.id,
+  x: block.x,
+  y: block.y,
+  width: block.width,
+  height: block.height,
+  confidence: block.confidence,
+  linePolygons: block.linePolygons as TextBlock['linePolygons'],
+  sourceDirection: block.sourceDirection ?? undefined,
+  renderedDirection: block.renderedDirection ?? undefined,
+  sourceLanguage: block.sourceLanguage ?? undefined,
+  rotationDeg: block.rotationDeg ?? undefined,
+  detectedFontSizePx: block.detectedFontSizePx ?? undefined,
+  detector: block.detector ?? undefined,
+  text: block.text ?? undefined,
+  translation: block.translation ?? undefined,
+  style: block.style as TextBlock['style'],
+  fontPrediction: block.fontPrediction as TextBlock['fontPrediction'],
+  rendered: undefined,
+})
+
+export type MappedDocument = {
+  id: string
+  path: string
+  name: string
+  width: number
+  height: number
+  revision: number
+  textBlocks: TextBlock[]
+  image: Uint8Array
+  segment?: Uint8Array
+  inpainted?: Uint8Array
+  brushLayer?: Uint8Array
+  rendered?: Uint8Array
+}
+
+const mapDocumentDetail = (detail: DocumentDetail): MappedDocument => ({
+  id: detail.id,
+  path: detail.path,
+  name: detail.name,
+  width: detail.width,
+  height: detail.height,
+  revision: detail.revision,
+  textBlocks: detail.textBlocks.map(mapTextBlock),
+  image: new Uint8Array(detail.image),
+  segment: toUint8Array(detail.segment),
+  inpainted: toUint8Array(detail.inpainted),
+  brushLayer: toUint8Array(detail.brushLayer),
+  rendered: toUint8Array(detail.rendered),
+})
+
+const toTextBlockInput = (block: TextBlock): TextBlockInput => ({
+  id: block.id ?? null,
+  x: block.x,
+  y: block.y,
+  width: block.width,
+  height: block.height,
+  text: block.text ?? null,
+  translation: block.translation ?? null,
+  style: (block.style as any) ?? null,
+})
+
+export function useCurrentDocument(): MappedDocument | null {
+  const documentId = useEditorUiStore((s) => s.currentDocumentId)
+  const { data: detail } = useGetDocument(documentId ?? '', {
+    query: { enabled: !!documentId, structuralSharing: false },
+  })
+  if (!detail) return null
+  return mapDocumentDetail(detail)
+}
+
 export function useTextBlocks() {
-  const { currentDocument: document, currentDocumentIndex } =
-    useCurrentDocumentState()
+  const queryClient = useQueryClient()
+  const document = useCurrentDocument()
+  const documentId = useEditorUiStore((s) => s.currentDocumentId)
   const textBlocks = document?.textBlocks ?? []
   const selectedBlockIndex = useEditorUiStore(
     (state) => state.selectedBlockIndex,
@@ -35,11 +122,43 @@ export function useTextBlocks() {
   const setSelectedBlockIndex = useEditorUiStore(
     (state) => state.setSelectedBlockIndex,
   )
-  const { updateTextBlocks, renderTextBlock } = useTextBlockMutations()
   const renderTimersRef = useRef<Map<number, ReturnType<typeof setTimeout>>>(
     new Map(),
   )
 
+  const invalidateDocument = useCallback(
+    async (docId: string) => {
+      await queryClient.invalidateQueries({ queryKey: getGetDocumentQueryKey(docId) })
+      await queryClient.invalidateQueries({ queryKey: getListDocumentsQueryKey() })
+    },
+    [queryClient],
+  )
+
+  const updateTextBlocks = useCallback(
+    async (blocks: TextBlock[]) => {
+      const docId = useEditorUiStore.getState().currentDocumentId
+      if (!docId) return
+      await putTextBlocks(docId, blocks.map(toTextBlockInput))
+      await invalidateDocument(docId)
+    },
+    [invalidateDocument],
+  )
+
+  const renderTextBlock = useCallback(
+    async (docId: string, textBlockIndex: number) => {
+      if (typeof textBlockIndex !== 'number') return
+      const { renderEffect, renderStroke } = useEditorUiStore.getState()
+      const { fontFamily } = usePreferencesStore.getState()
+      await renderDocument(docId, {
+        shaderEffect: renderEffect,
+        shaderStroke: renderStroke,
+        fontFamily,
+      })
+      await invalidateDocument(docId)
+    },
+    [invalidateDocument],
+  )
+
   useEffect(() => {
     const timers = renderTimersRef.current
     return () => {
@@ -59,7 +178,7 @@ export function useTextBlocks() {
     clearScheduledRender(index)
     const timer = setTimeout(() => {
       renderTimersRef.current.delete(index)
-      void renderTextBlock(undefined, currentDocumentIndex, index)
+      void renderTextBlock(documentId!, index)
     }, TEXT_BLOCK_RENDER_DEBOUNCE_MS)
     renderTimersRef.current.set(index, timer)
   }
@@ -77,12 +196,10 @@ export function useTextBlocks() {
       ui.setShowTextBlocksOverlay(true)
     }
 
-    const doc = document
-
     if (shouldRenderSprite(updates)) {
       if (shouldRenderSpriteImmediately(updates)) {
         clearScheduledRender(index)
-        void renderTextBlock(undefined, currentDocumentIndex, index)
+        void renderTextBlock(documentId!, index)
       } else {
         scheduleRender(index)
       }
@@ -123,5 +240,6 @@ export function useTextBlocks() {
     replaceBlock,
     appendBlock,
     removeBlock,
+    updateTextBlocks,
   }
 }

ui/lib/api.ts

@@ -1,822 +0,0 @@
-'use client'
-
-import { directoryOpen, fileOpen, fileSave } from 'browser-fs-access'
-import {
-  fetchBinary,
-  fetchJson,
-  getActivePipelineJobId,
-  setActivePipelineJobId,
-} from '@/lib/backend'
-import { reportRpcError } from '@/lib/errors'
-import type {
-  ApiKeyResponse,
-  BootstrapConfig,
-  DocumentDetail,
-  DocumentSummary,
-  ExportResult,
-  FontFaceInfo,
-  JobState,
-  LlmModelInfo,
-  LlmState,
-  MetaInfo,
-  TextBlockPatch,
-} from '@/lib/protocol'
-import {
-  Document,
-  InpaintRegion,
-  RenderEffect,
-  RenderStroke,
-  TextBlock,
-  TextStyle,
-} from '@/types'
-import { toArrayBuffer } from '@/lib/util'
-
-const documentDetailCache = new Map<string, DocumentDetail>()
-const textBlockIdAliases = new Map<string, string>()
-
-const isTempTextBlockId = (id?: string) => !!id && id.startsWith('temp:')
-
-const textBlockAliasKey = (documentId: string, textBlockId: string) =>
-  `${documentId}:${textBlockId}`
-
-const resolveTextBlockIdAlias = (documentId: string, textBlockId?: string) => {
-  if (!textBlockId) return undefined
-  return (
-    textBlockIdAliases.get(textBlockAliasKey(documentId, textBlockId)) ??
-    textBlockId
-  )
-}
-
-const rememberTextBlockAlias = (
-  documentId: string,
-  tempId: string | undefined,
-  realId: string,
-) => {
-  if (!tempId || !isTempTextBlockId(tempId)) return
-  textBlockIdAliases.set(textBlockAliasKey(documentId, tempId), realId)
-}
-
-const sameJson = (left: unknown, right: unknown) =>
-  JSON.stringify(left ?? null) === JSON.stringify(right ?? null)
-
-const withRpcError = async <T>(
-  method: string,
-  fn: () => Promise<T>,
-): Promise<T> => {
-  try {
-    return await fn()
-  } catch (error) {
-    reportRpcError(method, error)
-    throw error
-  }
-}
-
-const toBinaryArray = (value: Uint8Array) => Array.from(value)
-
-const getDocuments = async (): Promise<DocumentSummary[]> => {
-  const documents = await fetchJson<DocumentSummary[]>('/documents')
-  const prunedIds = new Set(documents.map((document) => document.id))
-  for (const documentId of documentDetailCache.keys()) {
-    if (!prunedIds.has(documentId)) {
-      documentDetailCache.delete(documentId)
-    }
-  }
-  return documents
-}
-
-const getDocumentSummaryAtIndex = async (index: number) => {
-  const documents = await getDocuments()
-  const summary = documents[index]
-  if (!summary) {
-    throw new Error(`Document not found at index ${index}`)
-  }
-  return summary
-}
-
-const getDocumentDetail = async (
-  documentId: string,
-): Promise<DocumentDetail> => {
-  const detail = await fetchJson<DocumentDetail>(`/documents/${documentId}`)
-  documentDetailCache.set(documentId, detail)
-  return detail
-}
-
-const getCachedOrFetchDocumentDetail = async (documentId: string) =>
-  documentDetailCache.get(documentId) ?? (await getDocumentDetail(documentId))
-
-const fetchLayer = async (documentId: string, layer: string) => {
-  const binary = await fetchBinary(`/documents/${documentId}/layers/${layer}`)
-  return binary.data
-}
-
-const mapTextStyle = (style?: TextStyle) =>
-  style
-    ? {
-        fontFamilies: style.fontFamilies,
-        fontSize: style.fontSize,
-        color: style.color,
-        effect: style.effect,
-        stroke: style.stroke,
-        textAlign: style.textAlign,
-      }
-    : undefined
-
-const mapTextBlock = (
-  block: DocumentDetail['textBlocks'][number],
-): TextBlock => ({
-  id: block.id,
-  x: block.x,
-  y: block.y,
-  width: block.width,
-  height: block.height,
-  confidence: block.confidence,
-  linePolygons: block.linePolygons ?? undefined,
-  sourceDirection: block.sourceDirection ?? undefined,
-  renderedDirection: block.renderedDirection ?? undefined,
-  sourceLanguage: block.sourceLanguage ?? undefined,
-  rotationDeg: block.rotationDeg ?? undefined,
-  detectedFontSizePx: block.detectedFontSizePx ?? undefined,
-  detector: block.detector ?? undefined,
-  text: block.text ?? undefined,
-  translation: block.translation ?? undefined,
-  style: block.style ?? undefined,
-  fontPrediction: block.fontPrediction ?? undefined,
-  rendered: undefined,
-})
-
-const toDocumentDetailBlock = (
-  block: TextBlock,
-  id: string,
-): DocumentDetail['textBlocks'][number] => ({
-  id,
-  x: block.x,
-  y: block.y,
-  width: block.width,
-  height: block.height,
-  confidence: block.confidence,
-  linePolygons: block.linePolygons ?? null,
-  sourceDirection: block.sourceDirection ?? null,
-  renderedDirection: block.renderedDirection ?? null,
-  sourceLanguage: block.sourceLanguage ?? null,
-  rotationDeg: block.rotationDeg ?? null,
-  detectedFontSizePx: block.detectedFontSizePx ?? null,
-  detector: block.detector ?? null,
-  text: block.text ?? null,
-  translation: block.translation ?? null,
-  style: block.style ?? null,
-  fontPrediction: block.fontPrediction ?? null,
-})
-
-const buildTextBlockPatch = (
-  next: TextBlock,
-  previous: DocumentDetail['textBlocks'][number],
-): TextBlockPatch | null => {
-  const patch: TextBlockPatch = {
-    text: undefined,
-    translation: undefined,
-    x: undefined,
-    y: undefined,
-    width: undefined,
-    height: undefined,
-    style: undefined,
-  }
-
-  if ((next.text ?? null) !== previous.text) {
-    patch.text = next.text ?? ''
-  }
-  if ((next.translation ?? null) !== previous.translation) {
-    patch.translation = next.translation ?? ''
-  }
-  if (next.x !== previous.x) {
-    patch.x = next.x
-  }
-  if (next.y !== previous.y) {
-    patch.y = next.y
-  }
-  if (next.width !== previous.width) {
-    patch.width = next.width
-  }
-  if (next.height !== previous.height) {
-    patch.height = next.height
-  }
-  if (!sameJson(mapTextStyle(next.style), previous.style)) {
-    patch.style = mapTextStyle(next.style)
-  }
-
-  return Object.values(patch).some((value) => value !== undefined)
-    ? patch
-    : null
-}
-
-const createTextBlockRemotely = async (
-  documentId: string,
-  block: TextBlock,
-) => {
-  const created = await fetchJson<DocumentDetail['textBlocks'][number]>(
-    `/documents/${documentId}/text-blocks`,
-    {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({
-        x: block.x,
-        y: block.y,
-        width: block.width,
-        height: block.height,
-      }),
-    },
-  )
-
-  const patch = buildTextBlockPatch(block, created)
-  if (patch) {
-    const updated = await fetchJson<DocumentDetail['textBlocks'][number]>(
-      `/documents/${documentId}/text-blocks/${created.id}`,
-      {
-        method: 'PATCH',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(patch),
-      },
-    )
-    return updated
-  }
-
-  return created
-}
-
-const getTextBlockIdByIndex = async (
-  index: number,
-  textBlockIndex?: number,
-) => {
-  if (typeof textBlockIndex !== 'number') return undefined
-  const summary = await getDocumentSummaryAtIndex(index)
-  const detail = await getCachedOrFetchDocumentDetail(summary.id)
-  return detail.textBlocks[textBlockIndex]?.id
-}
-
-export const createTempTextBlockId = () =>
-  `temp:${globalThis.crypto?.randomUUID?.() ?? Math.random().toString(36).slice(2)}`
-
-export const api = {
-  async getBootstrapConfig(): Promise<BootstrapConfig> {
-    return fetchJson<BootstrapConfig>('/config')
-  },
-
-  async saveBootstrapConfig(config: BootstrapConfig): Promise<BootstrapConfig> {
-    return fetchJson<BootstrapConfig>('/config', {
-      method: 'PUT',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify(config),
-    })
-  },
-
-  async initializeBootstrap(): Promise<void> {
-    await fetchJson<void>('/initialize', {
-      method: 'POST',
-    })
-  },
-
-  async appVersion(): Promise<string> {
-    const meta = await fetchJson<MetaInfo>('/meta')
-    return meta.version
-  },
-
-  async deviceInfo(): Promise<{ mlDevice: string }> {
-    const meta = await fetchJson<MetaInfo>('/meta')
-    return { mlDevice: meta.mlDevice }
-  },
-
-  async openExternal(url: string): Promise<void> {
-    if (typeof window !== 'undefined') {
-      window.open(url, '_blank', 'noopener,noreferrer')
-    }
-  },
-
-  async getDocumentsCount(): Promise<number> {
-    const documents = await getDocuments()
-    return documents.length
-  },
-
-  async getDocument(index: number): Promise<Document> {
-    return withRpcError('get_document', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const detail = await getDocumentDetail(summary.id)
-      const [image, segment, inpainted, brushLayer, rendered] =
-        await Promise.all([
-          fetchLayer(summary.id, 'original'),
-          summary.hasSegment
-            ? fetchLayer(summary.id, 'segment')
-            : Promise.resolve(undefined),
-          summary.hasInpainted
-            ? fetchLayer(summary.id, 'inpainted')
-            : Promise.resolve(undefined),
-          summary.hasBrushLayer
-            ? fetchLayer(summary.id, 'brush')
-            : Promise.resolve(undefined),
-          summary.hasRendered
-            ? fetchLayer(summary.id, 'rendered')
-            : Promise.resolve(undefined),
-        ])
-
-      return {
-        id: detail.id,
-        path: detail.path,
-        name: detail.name,
-        image,
-        width: detail.width,
-        height: detail.height,
-        revision: detail.revision,
-        textBlocks: detail.textBlocks.map(mapTextBlock),
-        segment,
-        inpainted,
-        brushLayer,
-        rendered,
-      }
-    })
-  },
-
-  async getThumbnail(index: number): Promise<Blob> {
-    return withRpcError('get_thumbnail', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const binary = await fetchBinary(`/documents/${summary.id}/thumbnail`)
-      return new Blob([toArrayBuffer(binary.data)], {
-        type: binary.contentType,
-      })
-    })
-  },
-
-  async addDocuments(): Promise<number> {
-    return withRpcError('add_documents', async () => {
-      const files = await pickDocuments()
-      if (!files?.length) return 0
-      const formData = new FormData()
-      files.forEach((file) => formData.append('files', file, file.name))
-      const result = await fetchJson<{ totalCount: number }>(
-        '/documents/import?mode=append',
-        {
-          method: 'POST',
-          body: formData,
-        },
-      )
-      documentDetailCache.clear()
-      return result.totalCount
-    })
-  },
-
-  async openDocuments(): Promise<number> {
-    return withRpcError('open_documents', async () => {
-      const files = await pickDocuments()
-      if (!files?.length) return 0
-      const formData = new FormData()
-      files.forEach((file) => formData.append('files', file, file.name))
-      const result = await fetchJson<{ totalCount: number }>(
-        '/documents/import?mode=replace',
-        {
-          method: 'POST',
-          body: formData,
-        },
-      )
-      documentDetailCache.clear()
-      return result.totalCount
-    })
-  },
-
-  async openFolder(): Promise<number> {
-    return withRpcError('open_documents', async () => {
-      const files = await pickFolder()
-      if (!files?.length) return 0
-      const formData = new FormData()
-      files.forEach((file) => formData.append('files', file, file.name))
-      const result = await fetchJson<{ totalCount: number }>(
-        '/documents/import?mode=replace',
-        {
-          method: 'POST',
-          body: formData,
-        },
-      )
-      documentDetailCache.clear()
-      return result.totalCount
-    })
-  },
-
-  async addFolder(): Promise<number> {
-    return withRpcError('add_documents', async () => {
-      const files = await pickFolder()
-      if (!files?.length) return 0
-      const formData = new FormData()
-      files.forEach((file) => formData.append('files', file, file.name))
-      const result = await fetchJson<{ totalCount: number }>(
-        '/documents/import?mode=append',
-        {
-          method: 'POST',
-          body: formData,
-        },
-      )
-      documentDetailCache.clear()
-      return result.totalCount
-    })
-  },
-
-  async exportDocument(index: number): Promise<void> {
-    return withRpcError('export_document', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const file = await fetchBinary(
-        `/documents/${summary.id}/export?layer=rendered`,
-      )
-      const blob = new Blob([toArrayBuffer(file.data)], {
-        type: file.contentType,
-      })
-      try {
-        await fileSave(blob, {
-          fileName: file.filename ?? `${summary.name}_koharu.webp`,
-        })
-      } catch {}
-    })
-  },
-
-  async exportPsdDocument(index: number): Promise<void> {
-    return withRpcError('export_psd_document', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const file = await fetchBinary(`/documents/${summary.id}/export/psd`)
-      const blob = new Blob([toArrayBuffer(file.data)], {
-        type: file.contentType,
-      })
-      try {
-        await fileSave(blob, {
-          fileName: file.filename ?? `${summary.name}_koharu.psd`,
-        })
-      } catch {}
-    })
-  },
-
-  async exportAllInpainted(): Promise<number> {
-    return withRpcError('export_all_inpainted', async () => {
-      const result = await fetchJson<ExportResult>('/exports?layer=inpainted', {
-        method: 'POST',
-      })
-      return result.count
-    })
-  },
-
-  async exportAllRendered(): Promise<number> {
-    return withRpcError('export_all_rendered', async () => {
-      const result = await fetchJson<ExportResult>('/exports?layer=rendered', {
-        method: 'POST',
-      })
-      return result.count
-    })
-  },
-
-  async detect(index: number): Promise<void> {
-    return withRpcError('detect', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/detect`, {
-        method: 'POST',
-      })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async ocr(index: number): Promise<void> {
-    return withRpcError('ocr', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/ocr`, { method: 'POST' })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async inpaint(index: number): Promise<void> {
-    return withRpcError('inpaint', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/inpaint`, {
-        method: 'POST',
-      })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async updateInpaintMask(
-    index: number,
-    mask: Uint8Array,
-    region?: InpaintRegion,
-  ): Promise<void> {
-    return withRpcError('update_inpaint_mask', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/mask-region`, {
-        method: 'PUT',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          data: toBinaryArray(mask),
-          region,
-        }),
-      })
-    })
-  },
-
-  async updateBrushLayer(
-    index: number,
-    patch: Uint8Array,
-    region: InpaintRegion,
-  ): Promise<void> {
-    return withRpcError('update_brush_layer', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/brush-region`, {
-        method: 'PUT',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          data: toBinaryArray(patch),
-          region,
-        }),
-      })
-    })
-  },
-
-  async inpaintPartial(index: number, region: InpaintRegion): Promise<void> {
-    return withRpcError('inpaint_partial', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      await fetchJson<void>(`/documents/${summary.id}/inpaint-region`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ region }),
-      })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async render(
-    index: number,
-    options?: {
-      textBlockIndex?: number
-      shaderEffect?: RenderEffect
-      shaderStroke?: RenderStroke
-      fontFamily?: string
-    },
-  ): Promise<void> {
-    return withRpcError('render', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const textBlockId = await getTextBlockIdByIndex(
-        index,
-        options?.textBlockIndex,
-      )
-      await fetchJson<void>(`/documents/${summary.id}/render`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          textBlockId,
-          shaderEffect: options?.shaderEffect,
-          shaderStroke: options?.shaderStroke,
-          fontFamily: options?.fontFamily,
-        }),
-      })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async updateTextBlocks(
-    index: number,
-    textBlocks: TextBlock[],
-  ): Promise<void> {
-    return withRpcError('update_text_blocks', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const previous = await getCachedOrFetchDocumentDetail(summary.id)
-      const previousMap = new Map(
-        previous.textBlocks.map((block) => [block.id, block]),
-      )
-
-      const normalizedBlocks = textBlocks.map((block) => ({
-        ...block,
-        id: resolveTextBlockIdAlias(summary.id, block.id),
-      }))
-
-      const retainedIds = new Set(
-        normalizedBlocks
-          .map((block) => block.id)
-          .filter((id): id is string => !!id && !isTempTextBlockId(id)),
-      )
-
-      for (const previousBlock of previous.textBlocks) {
-        if (!retainedIds.has(previousBlock.id)) {
-          await fetchJson<void>(
-            `/documents/${summary.id}/text-blocks/${previousBlock.id}`,
-            {
-              method: 'DELETE',
-            },
-          )
-        }
-      }
-
-      const synchronizedBlocks: DocumentDetail['textBlocks'] = []
-
-      for (const block of normalizedBlocks) {
-        const existingId =
-          block.id && !isTempTextBlockId(block.id) ? block.id : undefined
-
-        if (!existingId || !previousMap.has(existingId)) {
-          const created = await createTextBlockRemotely(summary.id, block)
-          rememberTextBlockAlias(summary.id, block.id, created.id)
-          synchronizedBlocks.push(
-            toDocumentDetailBlock({ ...block, id: created.id }, created.id),
-          )
-          continue
-        }
-
-        const previousBlock = previousMap.get(existingId)!
-        const patch = buildTextBlockPatch(block, previousBlock)
-        if (patch) {
-          await fetchJson<DocumentDetail['textBlocks'][number]>(
-            `/documents/${summary.id}/text-blocks/${existingId}`,
-            {
-              method: 'PATCH',
-              headers: { 'content-type': 'application/json' },
-              body: JSON.stringify(patch),
-            },
-          )
-        }
-
-        synchronizedBlocks.push(toDocumentDetailBlock(block, existingId))
-      }
-
-      documentDetailCache.set(summary.id, {
-        ...previous,
-        textBlocks: synchronizedBlocks,
-      })
-    })
-  },
-
-  async listFonts(): Promise<FontFaceInfo[]> {
-    return fetchJson<FontFaceInfo[]>('/fonts')
-  },
-
-  async getApiKey(provider: string): Promise<string | null> {
-    const response = await fetchJson<ApiKeyResponse>(
-      `/providers/${provider}/api-key`,
-    )
-    return response.apiKey ?? null
-  },
-
-  async setApiKey(provider: string, apiKey: string): Promise<void> {
-    await fetchJson<void>(`/providers/${provider}/api-key`, {
-      method: 'PUT',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ apiKey }),
-    })
-  },
-
-  async llmList(
-    language?: string,
-    openAiCompatibleBaseUrl?: string,
-  ): Promise<LlmModelInfo[]> {
-    const params = new URLSearchParams()
-    if (language) {
-      params.set('language', language)
-    }
-    if (openAiCompatibleBaseUrl) {
-      params.set('openaiCompatibleBaseUrl', openAiCompatibleBaseUrl)
-    }
-    const queryString = params.toString()
-    const query = queryString ? `?${queryString}` : ''
-    return fetchJson<LlmModelInfo[]>(`/llm/models${query}`)
-  },
-
-  async llmLoad(
-    id: string,
-    apiKey?: string,
-    baseUrl?: string,
-    temperature?: number | null,
-    maxTokens?: number | null,
-    customSystemPrompt?: string,
-  ): Promise<void> {
-    await fetchJson<LlmState>('/llm/load', {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({
-        id,
-        apiKey,
-        baseUrl,
-        temperature: temperature ?? undefined,
-        maxTokens: maxTokens ?? undefined,
-        customSystemPrompt: customSystemPrompt || undefined,
-      }),
-    })
-  },
-
-  async llmPing(
-    baseUrl: string,
-    apiKey?: string,
-  ): Promise<{
-    ok: boolean
-    models: string[]
-    latencyMs?: number
-    error?: string
-  }> {
-    return fetchJson('/llm/ping', {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ baseUrl, apiKey: apiKey || undefined }),
-    })
-  },
-
-  async llmOffload(): Promise<void> {
-    await fetchJson<LlmState>('/llm/offload', {
-      method: 'POST',
-    })
-  },
-
-  async llmReady(selectedModel?: string): Promise<boolean> {
-    const state = await fetchJson<LlmState>('/llm/state')
-    return (
-      state.status === 'ready' &&
-      (!selectedModel || !state.modelId || state.modelId === selectedModel)
-    )
-  },
-
-  async llmGenerate(
-    index: number,
-    textBlockIndex?: number,
-    language?: string,
-  ): Promise<void> {
-    return withRpcError('llm_generate', async () => {
-      const summary = await getDocumentSummaryAtIndex(index)
-      const textBlockId = await getTextBlockIdByIndex(index, textBlockIndex)
-      await fetchJson<void>(`/documents/${summary.id}/translate`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          textBlockId,
-          language,
-        }),
-      })
-      documentDetailCache.delete(summary.id)
-    })
-  },
-
-  async process(options: {
-    index?: number
-    llmModelId?: string
-    llmApiKey?: string
-    llmBaseUrl?: string
-    llmTemperature?: number | null
-    llmMaxTokens?: number | null
-    llmCustomSystemPrompt?: string
-    language?: string
-    shaderEffect?: RenderEffect
-    shaderStroke?: RenderStroke
-    fontFamily?: string
-  }): Promise<void> {
-    return withRpcError('process', async () => {
-      const documentId =
-        typeof options.index === 'number'
-          ? (await getDocumentSummaryAtIndex(options.index)).id
-          : undefined
-
-      const job = await fetchJson<JobState>('/jobs/pipeline', {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          documentId,
-          llmModelId: options.llmModelId,
-          llmApiKey: options.llmApiKey,
-          llmBaseUrl: options.llmBaseUrl,
-          llmTemperature: options.llmTemperature ?? undefined,
-          llmMaxTokens: options.llmMaxTokens ?? undefined,
-          llmCustomSystemPrompt: options.llmCustomSystemPrompt || undefined,
-          language: options.language,
-          shaderEffect: options.shaderEffect,
-          shaderStroke: options.shaderStroke,
-          fontFamily: options.fontFamily,
-        }),
-      })
-      setActivePipelineJobId(job.id)
-    })
-  },
-
-  async processCancel(): Promise<void> {
-    const jobId = getActivePipelineJobId()
-    if (!jobId) return
-    await fetchJson<void>(`/jobs/${jobId}`, { method: 'DELETE' })
-  },
-}
-
-const IMAGE_EXTENSIONS = ['.png', '.jpg', '.jpeg', '.webp']
-
-const pickDocuments = async (): Promise<File[] | null> => {
-  try {
-    return await fileOpen({
-      description: 'Documents',
-      mimeTypes: ['image/*'],
-      extensions: IMAGE_EXTENSIONS,
-      multiple: true,
-    })
-  } catch {
-    return null
-  }
-}
-
-const pickFolder = async (): Promise<File[] | null> => {
-  try {
-    const files = await directoryOpen({ recursive: true })
-    return files.filter((file) =>
-      IMAGE_EXTENSIONS.some((ext) => file.name.toLowerCase().endsWith(ext)),
-    )
-  } catch {
-    return null
-  }
-}

ui/lib/api/documents/documents.ts

@@ -0,0 +1,406 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  MutationFunction,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  DocumentDetail,
+  DocumentSummary,
+  GetDocumentThumbnailParams,
+  ImportDocumentsBody,
+  ImportDocumentsParams,
+  ImportResult
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getListDocumentsUrl = () => {
+
+
+
+
+  return `/api/v1/documents`
+}
+
+export const listDocuments = async ( options?: RequestInit): Promise<DocumentSummary[]> => {
+
+  return fetchApi<DocumentSummary[]>(getListDocumentsUrl(),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getListDocumentsQueryKey = () => {
+    return [
+    `/api/v1/documents`
+    ] as const;
+    }
+
+
+export const getListDocumentsQueryOptions = <TData = Awaited<ReturnType<typeof listDocuments>>, TError = ApiError>( options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getListDocumentsQueryKey();
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof listDocuments>>> = ({ signal }) => listDocuments({ signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn,   gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type ListDocumentsQueryResult = NonNullable<Awaited<ReturnType<typeof listDocuments>>>
+export type ListDocumentsQueryError = ApiError
+
+
+export function useListDocuments<TData = Awaited<ReturnType<typeof listDocuments>>, TError = ApiError>(
+  options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listDocuments>>,
+          TError,
+          Awaited<ReturnType<typeof listDocuments>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListDocuments<TData = Awaited<ReturnType<typeof listDocuments>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listDocuments>>,
+          TError,
+          Awaited<ReturnType<typeof listDocuments>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListDocuments<TData = Awaited<ReturnType<typeof listDocuments>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useListDocuments<TData = Awaited<ReturnType<typeof listDocuments>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDocuments>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getListDocumentsQueryOptions(options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getImportDocumentsUrl = (params?: ImportDocumentsParams,) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString())
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/api/v1/documents?${stringifiedParams}` : `/api/v1/documents`
+}
+
+export const importDocuments = async (importDocumentsBody: ImportDocumentsBody,
+    params?: ImportDocumentsParams, options?: RequestInit): Promise<ImportResult> => {
+    const formData = new FormData();
+importDocumentsBody.files.forEach(value => formData.append(`files`, value));
+
+  return fetchApi<ImportResult>(getImportDocumentsUrl(params),
+  {
+    ...options,
+    method: 'POST'
+    ,
+    body:
+      formData,
+  }
+);}
+
+
+
+
+export const getImportDocumentsMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof importDocuments>>, TError,{data: ImportDocumentsBody;params?: ImportDocumentsParams}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof importDocuments>>, TError,{data: ImportDocumentsBody;params?: ImportDocumentsParams}, TContext> => {
+
+const mutationKey = ['importDocuments'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof importDocuments>>, {data: ImportDocumentsBody;params?: ImportDocumentsParams}> = (props) => {
+          const {data,params} = props ?? {};
+
+          return  importDocuments(data,params,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type ImportDocumentsMutationResult = NonNullable<Awaited<ReturnType<typeof importDocuments>>>
+    export type ImportDocumentsMutationBody = ImportDocumentsBody
+    export type ImportDocumentsMutationError = ApiError
+
+    export const useImportDocuments = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof importDocuments>>, TError,{data: ImportDocumentsBody;params?: ImportDocumentsParams}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof importDocuments>>,
+        TError,
+        {data: ImportDocumentsBody;params?: ImportDocumentsParams},
+        TContext
+      > => {
+      return useMutation(getImportDocumentsMutationOptions(options), queryClient);
+    }
+    export const getGetDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}`
+}
+
+export const getDocument = async (documentId: string, options?: RequestInit): Promise<DocumentDetail> => {
+
+  return fetchApi<DocumentDetail>(getGetDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getGetDocumentQueryKey = (documentId: string,) => {
+    return [
+    `/api/v1/documents/${documentId}`
+    ] as const;
+    }
+
+
+export const getGetDocumentQueryOptions = <TData = Awaited<ReturnType<typeof getDocument>>, TError = ApiError>(documentId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetDocumentQueryKey(documentId);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getDocument>>> = ({ signal }) => getDocument(documentId, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: !!(documentId),  gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type GetDocumentQueryResult = NonNullable<Awaited<ReturnType<typeof getDocument>>>
+export type GetDocumentQueryError = ApiError
+
+
+export function useGetDocument<TData = Awaited<ReturnType<typeof getDocument>>, TError = ApiError>(
+ documentId: string, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getDocument>>,
+          TError,
+          Awaited<ReturnType<typeof getDocument>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetDocument<TData = Awaited<ReturnType<typeof getDocument>>, TError = ApiError>(
+ documentId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getDocument>>,
+          TError,
+          Awaited<ReturnType<typeof getDocument>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetDocument<TData = Awaited<ReturnType<typeof getDocument>>, TError = ApiError>(
+ documentId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useGetDocument<TData = Awaited<ReturnType<typeof getDocument>>, TError = ApiError>(
+ documentId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getGetDocumentQueryOptions(documentId,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getGetDocumentThumbnailUrl = (documentId: string,
+    params?: GetDocumentThumbnailParams,) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString())
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/api/v1/documents/${documentId}/thumbnail?${stringifiedParams}` : `/api/v1/documents/${documentId}/thumbnail`
+}
+
+export const getDocumentThumbnail = async (documentId: string,
+    params?: GetDocumentThumbnailParams, options?: RequestInit): Promise<Blob> => {
+
+  return fetchApi<Blob>(getGetDocumentThumbnailUrl(documentId,params),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getGetDocumentThumbnailQueryKey = (documentId: string,
+    params?: GetDocumentThumbnailParams,) => {
+    return [
+    `/api/v1/documents/${documentId}/thumbnail`, ...(params ? [params] : [])
+    ] as const;
+    }
+
+
+export const getGetDocumentThumbnailQueryOptions = <TData = Awaited<ReturnType<typeof getDocumentThumbnail>>, TError = ApiError>(documentId: string,
+    params?: GetDocumentThumbnailParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetDocumentThumbnailQueryKey(documentId,params);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getDocumentThumbnail>>> = ({ signal }) => getDocumentThumbnail(documentId,params, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: !!(documentId),  gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type GetDocumentThumbnailQueryResult = NonNullable<Awaited<ReturnType<typeof getDocumentThumbnail>>>
+export type GetDocumentThumbnailQueryError = ApiError
+
+
+export function useGetDocumentThumbnail<TData = Awaited<ReturnType<typeof getDocumentThumbnail>>, TError = ApiError>(
+ documentId: string,
+    params: undefined |  GetDocumentThumbnailParams, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getDocumentThumbnail>>,
+          TError,
+          Awaited<ReturnType<typeof getDocumentThumbnail>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetDocumentThumbnail<TData = Awaited<ReturnType<typeof getDocumentThumbnail>>, TError = ApiError>(
+ documentId: string,
+    params?: GetDocumentThumbnailParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getDocumentThumbnail>>,
+          TError,
+          Awaited<ReturnType<typeof getDocumentThumbnail>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetDocumentThumbnail<TData = Awaited<ReturnType<typeof getDocumentThumbnail>>, TError = ApiError>(
+ documentId: string,
+    params?: GetDocumentThumbnailParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useGetDocumentThumbnail<TData = Awaited<ReturnType<typeof getDocumentThumbnail>>, TError = ApiError>(
+ documentId: string,
+    params?: GetDocumentThumbnailParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getDocumentThumbnail>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getGetDocumentThumbnailQueryOptions(documentId,params,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+

ui/lib/api/downloads/downloads.ts

@@ -0,0 +1,123 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  DownloadState
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getListDownloadsUrl = () => {
+
+
+
+
+  return `/api/v1/downloads`
+}
+
+export const listDownloads = async ( options?: RequestInit): Promise<DownloadState[]> => {
+
+  return fetchApi<DownloadState[]>(getListDownloadsUrl(),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getListDownloadsQueryKey = () => {
+    return [
+    `/api/v1/downloads`
+    ] as const;
+    }
+
+
+export const getListDownloadsQueryOptions = <TData = Awaited<ReturnType<typeof listDownloads>>, TError = unknown>( options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getListDownloadsQueryKey();
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof listDownloads>>> = ({ signal }) => listDownloads({ signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn,   gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type ListDownloadsQueryResult = NonNullable<Awaited<ReturnType<typeof listDownloads>>>
+export type ListDownloadsQueryError = unknown
+
+
+export function useListDownloads<TData = Awaited<ReturnType<typeof listDownloads>>, TError = unknown>(
+  options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listDownloads>>,
+          TError,
+          Awaited<ReturnType<typeof listDownloads>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListDownloads<TData = Awaited<ReturnType<typeof listDownloads>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listDownloads>>,
+          TError,
+          Awaited<ReturnType<typeof listDownloads>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListDownloads<TData = Awaited<ReturnType<typeof listDownloads>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useListDownloads<TData = Awaited<ReturnType<typeof listDownloads>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listDownloads>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getListDownloadsQueryOptions(options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+

ui/lib/api/exports/exports.ts

@@ -0,0 +1,217 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  MutationFunction,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  ExportBatchRequest,
+  ExportDocumentParams,
+  ExportResult
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getExportDocumentUrl = (documentId: string,
+    format: string,
+    params?: ExportDocumentParams,) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString())
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/api/v1/documents/${documentId}/export/${format}?${stringifiedParams}` : `/api/v1/documents/${documentId}/export/${format}`
+}
+
+export const exportDocument = async (documentId: string,
+    format: string,
+    params?: ExportDocumentParams, options?: RequestInit): Promise<Blob> => {
+
+  return fetchApi<Blob>(getExportDocumentUrl(documentId,format,params),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getExportDocumentQueryKey = (documentId: string,
+    format: string,
+    params?: ExportDocumentParams,) => {
+    return [
+    `/api/v1/documents/${documentId}/export/${format}`, ...(params ? [params] : [])
+    ] as const;
+    }
+
+
+export const getExportDocumentQueryOptions = <TData = Awaited<ReturnType<typeof exportDocument>>, TError = ApiError>(documentId: string,
+    format: string,
+    params?: ExportDocumentParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getExportDocumentQueryKey(documentId,format,params);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof exportDocument>>> = ({ signal }) => exportDocument(documentId,format,params, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: !!(documentId && format),  gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type ExportDocumentQueryResult = NonNullable<Awaited<ReturnType<typeof exportDocument>>>
+export type ExportDocumentQueryError = ApiError
+
+
+export function useExportDocument<TData = Awaited<ReturnType<typeof exportDocument>>, TError = ApiError>(
+ documentId: string,
+    format: string,
+    params: undefined |  ExportDocumentParams, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof exportDocument>>,
+          TError,
+          Awaited<ReturnType<typeof exportDocument>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useExportDocument<TData = Awaited<ReturnType<typeof exportDocument>>, TError = ApiError>(
+ documentId: string,
+    format: string,
+    params?: ExportDocumentParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof exportDocument>>,
+          TError,
+          Awaited<ReturnType<typeof exportDocument>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useExportDocument<TData = Awaited<ReturnType<typeof exportDocument>>, TError = ApiError>(
+ documentId: string,
+    format: string,
+    params?: ExportDocumentParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useExportDocument<TData = Awaited<ReturnType<typeof exportDocument>>, TError = ApiError>(
+ documentId: string,
+    format: string,
+    params?: ExportDocumentParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof exportDocument>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getExportDocumentQueryOptions(documentId,format,params,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getBatchExportUrl = () => {
+
+
+
+
+  return `/api/v1/exports`
+}
+
+export const batchExport = async (exportBatchRequest: ExportBatchRequest, options?: RequestInit): Promise<ExportResult> => {
+
+  return fetchApi<ExportResult>(getBatchExportUrl(),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      exportBatchRequest,)
+  }
+);}
+
+
+
+
+export const getBatchExportMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof batchExport>>, TError,{data: ExportBatchRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof batchExport>>, TError,{data: ExportBatchRequest}, TContext> => {
+
+const mutationKey = ['batchExport'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof batchExport>>, {data: ExportBatchRequest}> = (props) => {
+          const {data} = props ?? {};
+
+          return  batchExport(data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type BatchExportMutationResult = NonNullable<Awaited<ReturnType<typeof batchExport>>>
+    export type BatchExportMutationBody = ExportBatchRequest
+    export type BatchExportMutationError = ApiError
+
+    export const useBatchExport = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof batchExport>>, TError,{data: ExportBatchRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof batchExport>>,
+        TError,
+        {data: ExportBatchRequest},
+        TContext
+      > => {
+      return useMutation(getBatchExportMutationOptions(options), queryClient);
+    }

ui/lib/api/fetch.ts

@@ -0,0 +1,14 @@
+export const fetchApi = async <T>(url: string, options?: RequestInit): Promise<T> => {
+  const res = await fetch(url, options)
+  if (!res.ok) {
+    throw await res.json().catch(() => ({ status: res.status, message: res.statusText }))
+  }
+  if ([204, 205, 304].includes(res.status)) {
+    return undefined as T
+  }
+  const contentType = res.headers.get('content-type') ?? ''
+  if (!contentType.includes('json')) {
+    return (await res.blob()) as T
+  }
+  return res.json()
+}

ui/lib/api/jobs/jobs.ts

@@ -0,0 +1,348 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  MutationFunction,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  JobState,
+  PipelineJobRequest
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getListJobsUrl = () => {
+
+
+
+
+  return `/api/v1/jobs`
+}
+
+export const listJobs = async ( options?: RequestInit): Promise<JobState[]> => {
+
+  return fetchApi<JobState[]>(getListJobsUrl(),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getListJobsQueryKey = () => {
+    return [
+    `/api/v1/jobs`
+    ] as const;
+    }
+
+
+export const getListJobsQueryOptions = <TData = Awaited<ReturnType<typeof listJobs>>, TError = unknown>( options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getListJobsQueryKey();
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof listJobs>>> = ({ signal }) => listJobs({ signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn,   gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type ListJobsQueryResult = NonNullable<Awaited<ReturnType<typeof listJobs>>>
+export type ListJobsQueryError = unknown
+
+
+export function useListJobs<TData = Awaited<ReturnType<typeof listJobs>>, TError = unknown>(
+  options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listJobs>>,
+          TError,
+          Awaited<ReturnType<typeof listJobs>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListJobs<TData = Awaited<ReturnType<typeof listJobs>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listJobs>>,
+          TError,
+          Awaited<ReturnType<typeof listJobs>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListJobs<TData = Awaited<ReturnType<typeof listJobs>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useListJobs<TData = Awaited<ReturnType<typeof listJobs>>, TError = unknown>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listJobs>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getListJobsQueryOptions(options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getStartPipelineUrl = () => {
+
+
+
+
+  return `/api/v1/jobs/pipeline`
+}
+
+export const startPipeline = async (pipelineJobRequest: PipelineJobRequest, options?: RequestInit): Promise<JobState> => {
+
+  return fetchApi<JobState>(getStartPipelineUrl(),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      pipelineJobRequest,)
+  }
+);}
+
+
+
+
+export const getStartPipelineMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof startPipeline>>, TError,{data: PipelineJobRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof startPipeline>>, TError,{data: PipelineJobRequest}, TContext> => {
+
+const mutationKey = ['startPipeline'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof startPipeline>>, {data: PipelineJobRequest}> = (props) => {
+          const {data} = props ?? {};
+
+          return  startPipeline(data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type StartPipelineMutationResult = NonNullable<Awaited<ReturnType<typeof startPipeline>>>
+    export type StartPipelineMutationBody = PipelineJobRequest
+    export type StartPipelineMutationError = ApiError
+
+    export const useStartPipeline = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof startPipeline>>, TError,{data: PipelineJobRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof startPipeline>>,
+        TError,
+        {data: PipelineJobRequest},
+        TContext
+      > => {
+      return useMutation(getStartPipelineMutationOptions(options), queryClient);
+    }
+    export const getGetJobUrl = (jobId: string,) => {
+
+
+
+
+  return `/api/v1/jobs/${jobId}`
+}
+
+export const getJob = async (jobId: string, options?: RequestInit): Promise<JobState> => {
+
+  return fetchApi<JobState>(getGetJobUrl(jobId),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getGetJobQueryKey = (jobId: string,) => {
+    return [
+    `/api/v1/jobs/${jobId}`
+    ] as const;
+    }
+
+
+export const getGetJobQueryOptions = <TData = Awaited<ReturnType<typeof getJob>>, TError = ApiError>(jobId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetJobQueryKey(jobId);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getJob>>> = ({ signal }) => getJob(jobId, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: !!(jobId),  gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type GetJobQueryResult = NonNullable<Awaited<ReturnType<typeof getJob>>>
+export type GetJobQueryError = ApiError
+
+
+export function useGetJob<TData = Awaited<ReturnType<typeof getJob>>, TError = ApiError>(
+ jobId: string, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getJob>>,
+          TError,
+          Awaited<ReturnType<typeof getJob>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetJob<TData = Awaited<ReturnType<typeof getJob>>, TError = ApiError>(
+ jobId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getJob>>,
+          TError,
+          Awaited<ReturnType<typeof getJob>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetJob<TData = Awaited<ReturnType<typeof getJob>>, TError = ApiError>(
+ jobId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useGetJob<TData = Awaited<ReturnType<typeof getJob>>, TError = ApiError>(
+ jobId: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getJob>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getGetJobQueryOptions(jobId,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getCancelJobUrl = (jobId: string,) => {
+
+
+
+
+  return `/api/v1/jobs/${jobId}`
+}
+
+export const cancelJob = async (jobId: string, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getCancelJobUrl(jobId),
+  {
+    ...options,
+    method: 'DELETE'
+
+
+  }
+);}
+
+
+
+
+export const getCancelJobMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof cancelJob>>, TError,{jobId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof cancelJob>>, TError,{jobId: string}, TContext> => {
+
+const mutationKey = ['cancelJob'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof cancelJob>>, {jobId: string}> = (props) => {
+          const {jobId} = props ?? {};
+
+          return  cancelJob(jobId,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type CancelJobMutationResult = NonNullable<Awaited<ReturnType<typeof cancelJob>>>
+
+    export type CancelJobMutationError = ApiError
+
+    export const useCancelJob = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof cancelJob>>, TError,{jobId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof cancelJob>>,
+        TError,
+        {jobId: string},
+        TContext
+      > => {
+      return useMutation(getCancelJobMutationOptions(options), queryClient);
+    }

ui/lib/api/llm/llm.ts

@@ -0,0 +1,423 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  MutationFunction,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  ListLlmModelsParams,
+  LlmLoadRequest,
+  LlmModelInfo,
+  LlmPingRequest,
+  LlmPingResponse,
+  LlmState
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getGetLlmUrl = () => {
+
+
+
+
+  return `/api/v1/llm`
+}
+
+export const getLlm = async ( options?: RequestInit): Promise<LlmState> => {
+
+  return fetchApi<LlmState>(getGetLlmUrl(),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getGetLlmQueryKey = () => {
+    return [
+    `/api/v1/llm`
+    ] as const;
+    }
+
+
+export const getGetLlmQueryOptions = <TData = Awaited<ReturnType<typeof getLlm>>, TError = ApiError>( options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetLlmQueryKey();
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getLlm>>> = ({ signal }) => getLlm({ signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn,   gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type GetLlmQueryResult = NonNullable<Awaited<ReturnType<typeof getLlm>>>
+export type GetLlmQueryError = ApiError
+
+
+export function useGetLlm<TData = Awaited<ReturnType<typeof getLlm>>, TError = ApiError>(
+  options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getLlm>>,
+          TError,
+          Awaited<ReturnType<typeof getLlm>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetLlm<TData = Awaited<ReturnType<typeof getLlm>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getLlm>>,
+          TError,
+          Awaited<ReturnType<typeof getLlm>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetLlm<TData = Awaited<ReturnType<typeof getLlm>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useGetLlm<TData = Awaited<ReturnType<typeof getLlm>>, TError = ApiError>(
+  options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getLlm>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getGetLlmQueryOptions(options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getLoadLlmUrl = () => {
+
+
+
+
+  return `/api/v1/llm`
+}
+
+export const loadLlm = async (llmLoadRequest: LlmLoadRequest, options?: RequestInit): Promise<LlmState> => {
+
+  return fetchApi<LlmState>(getLoadLlmUrl(),
+  {
+    ...options,
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      llmLoadRequest,)
+  }
+);}
+
+
+
+
+export const getLoadLlmMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof loadLlm>>, TError,{data: LlmLoadRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof loadLlm>>, TError,{data: LlmLoadRequest}, TContext> => {
+
+const mutationKey = ['loadLlm'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof loadLlm>>, {data: LlmLoadRequest}> = (props) => {
+          const {data} = props ?? {};
+
+          return  loadLlm(data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type LoadLlmMutationResult = NonNullable<Awaited<ReturnType<typeof loadLlm>>>
+    export type LoadLlmMutationBody = LlmLoadRequest
+    export type LoadLlmMutationError = ApiError
+
+    export const useLoadLlm = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof loadLlm>>, TError,{data: LlmLoadRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof loadLlm>>,
+        TError,
+        {data: LlmLoadRequest},
+        TContext
+      > => {
+      return useMutation(getLoadLlmMutationOptions(options), queryClient);
+    }
+    export const getUnloadLlmUrl = () => {
+
+
+
+
+  return `/api/v1/llm`
+}
+
+export const unloadLlm = async ( options?: RequestInit): Promise<LlmState> => {
+
+  return fetchApi<LlmState>(getUnloadLlmUrl(),
+  {
+    ...options,
+    method: 'DELETE'
+
+
+  }
+);}
+
+
+
+
+export const getUnloadLlmMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof unloadLlm>>, TError,void, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof unloadLlm>>, TError,void, TContext> => {
+
+const mutationKey = ['unloadLlm'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof unloadLlm>>, void> = () => {
+
+
+          return  unloadLlm(requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type UnloadLlmMutationResult = NonNullable<Awaited<ReturnType<typeof unloadLlm>>>
+
+    export type UnloadLlmMutationError = ApiError
+
+    export const useUnloadLlm = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof unloadLlm>>, TError,void, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof unloadLlm>>,
+        TError,
+        void,
+        TContext
+      > => {
+      return useMutation(getUnloadLlmMutationOptions(options), queryClient);
+    }
+    export const getCheckLlmHealthUrl = () => {
+
+
+
+
+  return `/api/v1/llm/health`
+}
+
+export const checkLlmHealth = async (llmPingRequest: LlmPingRequest, options?: RequestInit): Promise<LlmPingResponse> => {
+
+  return fetchApi<LlmPingResponse>(getCheckLlmHealthUrl(),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      llmPingRequest,)
+  }
+);}
+
+
+
+
+export const getCheckLlmHealthMutationOptions = <TError = unknown,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof checkLlmHealth>>, TError,{data: LlmPingRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof checkLlmHealth>>, TError,{data: LlmPingRequest}, TContext> => {
+
+const mutationKey = ['checkLlmHealth'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof checkLlmHealth>>, {data: LlmPingRequest}> = (props) => {
+          const {data} = props ?? {};
+
+          return  checkLlmHealth(data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type CheckLlmHealthMutationResult = NonNullable<Awaited<ReturnType<typeof checkLlmHealth>>>
+    export type CheckLlmHealthMutationBody = LlmPingRequest
+    export type CheckLlmHealthMutationError = unknown
+
+    export const useCheckLlmHealth = <TError = unknown,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof checkLlmHealth>>, TError,{data: LlmPingRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof checkLlmHealth>>,
+        TError,
+        {data: LlmPingRequest},
+        TContext
+      > => {
+      return useMutation(getCheckLlmHealthMutationOptions(options), queryClient);
+    }
+    export const getListLlmModelsUrl = (params?: ListLlmModelsParams,) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString())
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0 ? `/api/v1/llm/models?${stringifiedParams}` : `/api/v1/llm/models`
+}
+
+export const listLlmModels = async (params?: ListLlmModelsParams, options?: RequestInit): Promise<LlmModelInfo[]> => {
+
+  return fetchApi<LlmModelInfo[]>(getListLlmModelsUrl(params),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getListLlmModelsQueryKey = (params?: ListLlmModelsParams,) => {
+    return [
+    `/api/v1/llm/models`, ...(params ? [params] : [])
+    ] as const;
+    }
+
+
+export const getListLlmModelsQueryOptions = <TData = Awaited<ReturnType<typeof listLlmModels>>, TError = ApiError>(params?: ListLlmModelsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getListLlmModelsQueryKey(params);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof listLlmModels>>> = ({ signal }) => listLlmModels(params, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn,   gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type ListLlmModelsQueryResult = NonNullable<Awaited<ReturnType<typeof listLlmModels>>>
+export type ListLlmModelsQueryError = ApiError
+
+
+export function useListLlmModels<TData = Awaited<ReturnType<typeof listLlmModels>>, TError = ApiError>(
+ params: undefined |  ListLlmModelsParams, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listLlmModels>>,
+          TError,
+          Awaited<ReturnType<typeof listLlmModels>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListLlmModels<TData = Awaited<ReturnType<typeof listLlmModels>>, TError = ApiError>(
+ params?: ListLlmModelsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof listLlmModels>>,
+          TError,
+          Awaited<ReturnType<typeof listLlmModels>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useListLlmModels<TData = Awaited<ReturnType<typeof listLlmModels>>, TError = ApiError>(
+ params?: ListLlmModelsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useListLlmModels<TData = Awaited<ReturnType<typeof listLlmModels>>, TError = ApiError>(
+ params?: ListLlmModelsParams, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof listLlmModels>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getListLlmModelsQueryOptions(params,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+

ui/lib/api/processing/processing.ts

@@ -0,0 +1,347 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation
+} from '@tanstack/react-query';
+import type {
+  MutationFunction,
+  QueryClient,
+  UseMutationOptions,
+  UseMutationResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  RenderRequest,
+  TranslateRequest
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getDetectDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/detect`
+}
+
+export const detectDocument = async (documentId: string, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getDetectDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'POST'
+
+
+  }
+);}
+
+
+
+
+export const getDetectDocumentMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof detectDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof detectDocument>>, TError,{documentId: string}, TContext> => {
+
+const mutationKey = ['detectDocument'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof detectDocument>>, {documentId: string}> = (props) => {
+          const {documentId} = props ?? {};
+
+          return  detectDocument(documentId,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type DetectDocumentMutationResult = NonNullable<Awaited<ReturnType<typeof detectDocument>>>
+
+    export type DetectDocumentMutationError = ApiError
+
+    export const useDetectDocument = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof detectDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof detectDocument>>,
+        TError,
+        {documentId: string},
+        TContext
+      > => {
+      return useMutation(getDetectDocumentMutationOptions(options), queryClient);
+    }
+    export const getInpaintDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/inpaint`
+}
+
+export const inpaintDocument = async (documentId: string, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getInpaintDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'POST'
+
+
+  }
+);}
+
+
+
+
+export const getInpaintDocumentMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof inpaintDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof inpaintDocument>>, TError,{documentId: string}, TContext> => {
+
+const mutationKey = ['inpaintDocument'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof inpaintDocument>>, {documentId: string}> = (props) => {
+          const {documentId} = props ?? {};
+
+          return  inpaintDocument(documentId,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type InpaintDocumentMutationResult = NonNullable<Awaited<ReturnType<typeof inpaintDocument>>>
+
+    export type InpaintDocumentMutationError = ApiError
+
+    export const useInpaintDocument = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof inpaintDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof inpaintDocument>>,
+        TError,
+        {documentId: string},
+        TContext
+      > => {
+      return useMutation(getInpaintDocumentMutationOptions(options), queryClient);
+    }
+    export const getRecognizeDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/recognize`
+}
+
+export const recognizeDocument = async (documentId: string, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getRecognizeDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'POST'
+
+
+  }
+);}
+
+
+
+
+export const getRecognizeDocumentMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof recognizeDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof recognizeDocument>>, TError,{documentId: string}, TContext> => {
+
+const mutationKey = ['recognizeDocument'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof recognizeDocument>>, {documentId: string}> = (props) => {
+          const {documentId} = props ?? {};
+
+          return  recognizeDocument(documentId,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type RecognizeDocumentMutationResult = NonNullable<Awaited<ReturnType<typeof recognizeDocument>>>
+
+    export type RecognizeDocumentMutationError = ApiError
+
+    export const useRecognizeDocument = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof recognizeDocument>>, TError,{documentId: string}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof recognizeDocument>>,
+        TError,
+        {documentId: string},
+        TContext
+      > => {
+      return useMutation(getRecognizeDocumentMutationOptions(options), queryClient);
+    }
+    export const getRenderDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/render`
+}
+
+export const renderDocument = async (documentId: string,
+    renderRequest: RenderRequest, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getRenderDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      renderRequest,)
+  }
+);}
+
+
+
+
+export const getRenderDocumentMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof renderDocument>>, TError,{documentId: string;data: RenderRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof renderDocument>>, TError,{documentId: string;data: RenderRequest}, TContext> => {
+
+const mutationKey = ['renderDocument'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof renderDocument>>, {documentId: string;data: RenderRequest}> = (props) => {
+          const {documentId,data} = props ?? {};
+
+          return  renderDocument(documentId,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type RenderDocumentMutationResult = NonNullable<Awaited<ReturnType<typeof renderDocument>>>
+    export type RenderDocumentMutationBody = RenderRequest
+    export type RenderDocumentMutationError = ApiError
+
+    export const useRenderDocument = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof renderDocument>>, TError,{documentId: string;data: RenderRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof renderDocument>>,
+        TError,
+        {documentId: string;data: RenderRequest},
+        TContext
+      > => {
+      return useMutation(getRenderDocumentMutationOptions(options), queryClient);
+    }
+    export const getTranslateDocumentUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/translate`
+}
+
+export const translateDocument = async (documentId: string,
+    translateRequest: TranslateRequest, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getTranslateDocumentUrl(documentId),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      translateRequest,)
+  }
+);}
+
+
+
+
+export const getTranslateDocumentMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof translateDocument>>, TError,{documentId: string;data: TranslateRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof translateDocument>>, TError,{documentId: string;data: TranslateRequest}, TContext> => {
+
+const mutationKey = ['translateDocument'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof translateDocument>>, {documentId: string;data: TranslateRequest}> = (props) => {
+          const {documentId,data} = props ?? {};
+
+          return  translateDocument(documentId,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type TranslateDocumentMutationResult = NonNullable<Awaited<ReturnType<typeof translateDocument>>>
+    export type TranslateDocumentMutationBody = TranslateRequest
+    export type TranslateDocumentMutationError = ApiError
+
+    export const useTranslateDocument = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof translateDocument>>, TError,{documentId: string;data: TranslateRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof translateDocument>>,
+        TError,
+        {documentId: string;data: TranslateRequest},
+        TContext
+      > => {
+      return useMutation(getTranslateDocumentMutationOptions(options), queryClient);
+    }

ui/lib/api/providers/providers.ts

@@ -0,0 +1,194 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation,
+  useQuery
+} from '@tanstack/react-query';
+import type {
+  DataTag,
+  DefinedInitialDataOptions,
+  DefinedUseQueryResult,
+  MutationFunction,
+  QueryClient,
+  QueryFunction,
+  QueryKey,
+  UndefinedInitialDataOptions,
+  UseMutationOptions,
+  UseMutationResult,
+  UseQueryOptions,
+  UseQueryResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  ApiKeyResponse,
+  ApiKeyValue
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getGetApiKeyUrl = (provider: string,) => {
+
+
+
+
+  return `/api/v1/providers/${provider}/api-key`
+}
+
+export const getApiKey = async (provider: string, options?: RequestInit): Promise<ApiKeyResponse> => {
+
+  return fetchApi<ApiKeyResponse>(getGetApiKeyUrl(provider),
+  {
+    ...options,
+    method: 'GET'
+
+
+  }
+);}
+
+
+
+
+
+export const getGetApiKeyQueryKey = (provider: string,) => {
+    return [
+    `/api/v1/providers/${provider}/api-key`
+    ] as const;
+    }
+
+
+export const getGetApiKeyQueryOptions = <TData = Awaited<ReturnType<typeof getApiKey>>, TError = ApiError>(provider: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+) => {
+
+const {query: queryOptions, request: requestOptions} = options ?? {};
+
+  const queryKey =  queryOptions?.queryKey ?? getGetApiKeyQueryKey(provider);
+
+
+
+    const queryFn: QueryFunction<Awaited<ReturnType<typeof getApiKey>>> = ({ signal }) => getApiKey(provider, { signal, ...requestOptions });
+
+
+
+
+
+   return  { queryKey, queryFn, enabled: !!(provider),  gcTime: 300000, retry: 1,  ...queryOptions} as UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData> & { queryKey: DataTag<QueryKey, TData, TError> }
+}
+
+export type GetApiKeyQueryResult = NonNullable<Awaited<ReturnType<typeof getApiKey>>>
+export type GetApiKeyQueryError = ApiError
+
+
+export function useGetApiKey<TData = Awaited<ReturnType<typeof getApiKey>>, TError = ApiError>(
+ provider: string, options: { query:Partial<UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData>> & Pick<
+        DefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getApiKey>>,
+          TError,
+          Awaited<ReturnType<typeof getApiKey>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  DefinedUseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetApiKey<TData = Awaited<ReturnType<typeof getApiKey>>, TError = ApiError>(
+ provider: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData>> & Pick<
+        UndefinedInitialDataOptions<
+          Awaited<ReturnType<typeof getApiKey>>,
+          TError,
+          Awaited<ReturnType<typeof getApiKey>>
+        > , 'initialData'
+      >, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+export function useGetApiKey<TData = Awaited<ReturnType<typeof getApiKey>>, TError = ApiError>(
+ provider: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+  ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> }
+
+export function useGetApiKey<TData = Awaited<ReturnType<typeof getApiKey>>, TError = ApiError>(
+ provider: string, options?: { query?:Partial<UseQueryOptions<Awaited<ReturnType<typeof getApiKey>>, TError, TData>>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient
+ ):  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> } {
+
+  const queryOptions = getGetApiKeyQueryOptions(provider,options)
+
+  const query = useQuery(queryOptions, queryClient) as  UseQueryResult<TData, TError> & { queryKey: DataTag<QueryKey, TData, TError> };
+
+  return { ...query, queryKey: queryOptions.queryKey };
+}
+
+
+
+
+export const getSetApiKeyUrl = (provider: string,) => {
+
+
+
+
+  return `/api/v1/providers/${provider}/api-key`
+}
+
+export const setApiKey = async (provider: string,
+    apiKeyValue: ApiKeyValue, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getSetApiKeyUrl(provider),
+  {
+    ...options,
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      apiKeyValue,)
+  }
+);}
+
+
+
+
+export const getSetApiKeyMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof setApiKey>>, TError,{provider: string;data: ApiKeyValue}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof setApiKey>>, TError,{provider: string;data: ApiKeyValue}, TContext> => {
+
+const mutationKey = ['setApiKey'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof setApiKey>>, {provider: string;data: ApiKeyValue}> = (props) => {
+          const {provider,data} = props ?? {};
+
+          return  setApiKey(provider,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type SetApiKeyMutationResult = NonNullable<Awaited<ReturnType<typeof setApiKey>>>
+    export type SetApiKeyMutationBody = ApiKeyValue
+    export type SetApiKeyMutationError = ApiError
+
+    export const useSetApiKey = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof setApiKey>>, TError,{provider: string;data: ApiKeyValue}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof setApiKey>>,
+        TError,
+        {provider: string;data: ApiKeyValue},
+        TContext
+      > => {
+      return useMutation(getSetApiKeyMutationOptions(options), queryClient);
+    }

ui/lib/api/regions/regions.ts

@@ -0,0 +1,224 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+import {
+  useMutation
+} from '@tanstack/react-query';
+import type {
+  MutationFunction,
+  QueryClient,
+  UseMutationOptions,
+  UseMutationResult
+} from '@tanstack/react-query';
+
+import type {
+  ApiError,
+  BrushRegionRequest,
+  InpaintRegionRequest,
+  MaskRegionRequest
+} from '../schemas';
+
+import { fetchApi } from '.././fetch';
+
+
+type SecondParameter<T extends (...args: never) => unknown> = Parameters<T>[1];
+
+
+
+export const getUpdateBrushLayerUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/brush-layer`
+}
+
+export const updateBrushLayer = async (documentId: string,
+    brushRegionRequest: BrushRegionRequest, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getUpdateBrushLayerUrl(documentId),
+  {
+    ...options,
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      brushRegionRequest,)
+  }
+);}
+
+
+
+
+export const getUpdateBrushLayerMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof updateBrushLayer>>, TError,{documentId: string;data: BrushRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof updateBrushLayer>>, TError,{documentId: string;data: BrushRegionRequest}, TContext> => {
+
+const mutationKey = ['updateBrushLayer'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof updateBrushLayer>>, {documentId: string;data: BrushRegionRequest}> = (props) => {
+          const {documentId,data} = props ?? {};
+
+          return  updateBrushLayer(documentId,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type UpdateBrushLayerMutationResult = NonNullable<Awaited<ReturnType<typeof updateBrushLayer>>>
+    export type UpdateBrushLayerMutationBody = BrushRegionRequest
+    export type UpdateBrushLayerMutationError = ApiError
+
+    export const useUpdateBrushLayer = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof updateBrushLayer>>, TError,{documentId: string;data: BrushRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof updateBrushLayer>>,
+        TError,
+        {documentId: string;data: BrushRegionRequest},
+        TContext
+      > => {
+      return useMutation(getUpdateBrushLayerMutationOptions(options), queryClient);
+    }
+    export const getInpaintRegionUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/inpaint-region`
+}
+
+export const inpaintRegion = async (documentId: string,
+    inpaintRegionRequest: InpaintRegionRequest, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getInpaintRegionUrl(documentId),
+  {
+    ...options,
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      inpaintRegionRequest,)
+  }
+);}
+
+
+
+
+export const getInpaintRegionMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof inpaintRegion>>, TError,{documentId: string;data: InpaintRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof inpaintRegion>>, TError,{documentId: string;data: InpaintRegionRequest}, TContext> => {
+
+const mutationKey = ['inpaintRegion'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof inpaintRegion>>, {documentId: string;data: InpaintRegionRequest}> = (props) => {
+          const {documentId,data} = props ?? {};
+
+          return  inpaintRegion(documentId,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type InpaintRegionMutationResult = NonNullable<Awaited<ReturnType<typeof inpaintRegion>>>
+    export type InpaintRegionMutationBody = InpaintRegionRequest
+    export type InpaintRegionMutationError = ApiError
+
+    export const useInpaintRegion = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof inpaintRegion>>, TError,{documentId: string;data: InpaintRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof inpaintRegion>>,
+        TError,
+        {documentId: string;data: InpaintRegionRequest},
+        TContext
+      > => {
+      return useMutation(getInpaintRegionMutationOptions(options), queryClient);
+    }
+    export const getUpdateMaskUrl = (documentId: string,) => {
+
+
+
+
+  return `/api/v1/documents/${documentId}/mask`
+}
+
+export const updateMask = async (documentId: string,
+    maskRegionRequest: MaskRegionRequest, options?: RequestInit): Promise<void> => {
+
+  return fetchApi<void>(getUpdateMaskUrl(documentId),
+  {
+    ...options,
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json', ...options?.headers },
+    body: JSON.stringify(
+      maskRegionRequest,)
+  }
+);}
+
+
+
+
+export const getUpdateMaskMutationOptions = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof updateMask>>, TError,{documentId: string;data: MaskRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+): UseMutationOptions<Awaited<ReturnType<typeof updateMask>>, TError,{documentId: string;data: MaskRegionRequest}, TContext> => {
+
+const mutationKey = ['updateMask'];
+const {mutation: mutationOptions, request: requestOptions} = options ?
+      options.mutation && 'mutationKey' in options.mutation && options.mutation.mutationKey ?
+      options
+      : {...options, mutation: {...options.mutation, mutationKey}}
+      : {mutation: { mutationKey, }, request: undefined};
+
+
+
+
+      const mutationFn: MutationFunction<Awaited<ReturnType<typeof updateMask>>, {documentId: string;data: MaskRegionRequest}> = (props) => {
+          const {documentId,data} = props ?? {};
+
+          return  updateMask(documentId,data,requestOptions)
+        }
+
+
+
+
+
+
+  return  { mutationFn, ...mutationOptions }}
+
+    export type UpdateMaskMutationResult = NonNullable<Awaited<ReturnType<typeof updateMask>>>
+    export type UpdateMaskMutationBody = MaskRegionRequest
+    export type UpdateMaskMutationError = ApiError
+
+    export const useUpdateMask = <TError = ApiError,
+    TContext = unknown>(options?: { mutation?:UseMutationOptions<Awaited<ReturnType<typeof updateMask>>, TError,{documentId: string;data: MaskRegionRequest}, TContext>, request?: SecondParameter<typeof fetchApi>}
+ , queryClient?: QueryClient): UseMutationResult<
+        Awaited<ReturnType<typeof updateMask>>,
+        TError,
+        {documentId: string;data: MaskRegionRequest},
+        TContext
+      > => {
+      return useMutation(getUpdateMaskMutationOptions(options), queryClient);
+    }

ui/lib/api/schemas/apiError.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+
+export interface ApiError {
+  message: string;
+  /** @minimum 0 */
+  status: number;
+}

ui/lib/api/schemas/apiKeyResponse.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * OpenAPI spec version: 0.0.1
+ */
+
+export interface ApiKeyResponse {
+  /** @nullable */
+  apiKey?: string | null;
+}