Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+trackio/assets/badge.png filter=lfs diff=lfs merge=lfs -text
+trackio/assets/trackio_logo_old.png filter=lfs diff=lfs merge=lfs -text

trackio/CHANGELOG.md

@@ -0,0 +1,517 @@
+# trackio
+
+## 0.41.0
+
+### Features
+
+- [#703](https://github.com/gradio-app/trackio/pull/703) [`6bdb2d1`](https://github.com/gradio-app/trackio/commit/6bdb2d1f857473c191e76ef011ecc0c14fa01926) - Add `trackio bump` to upgrade a Space to the local Trackio version.  Thanks @abidlabs!
+
+## 0.40.0
+
+### Features
+
+- [#700](https://github.com/gradio-app/trackio/pull/700) [`9f8215d`](https://github.com/gradio-app/trackio/commit/9f8215dcebf3544338c58265d768d113c70f10b2) - Invalidate the Spaces logs cache on every committed write.  Thanks @abidlabs!
+
+## 0.39.0
+
+### Features
+
+- [#697](https://github.com/gradio-app/trackio/pull/697) [`89c9b1b`](https://github.com/gradio-app/trackio/commit/89c9b1b8e644a4ee8e5ae3e86a77d54e8a09360b) - Let an embedding page ask the dashboard for its current view.  Thanks @abidlabs!
+- [#693](https://github.com/gradio-app/trackio/pull/693) [`3db5e38`](https://github.com/gradio-app/trackio/commit/3db5e38a9fd731959b96793c7aebba6c3481615e) - Add overwrite option to log_artifact.  Thanks @abidlabs!
+- [#696](https://github.com/gradio-app/trackio/pull/696) [`81ae55f`](https://github.com/gradio-app/trackio/commit/81ae55fe1fe94e3c4205f9bd892a85cfc73b0ee2) - Hide empty dashboard tabs on narrow viewports.  Thanks @abidlabs!
+
+## 0.38.1
+
+### Features
+
+- [#692](https://github.com/gradio-app/trackio/pull/692) [`217a949`](https://github.com/gradio-app/trackio/commit/217a94957cce97a3822a908560f49c435b5b5117) - Fix CommitOperationAdd import with huggingface_hub 1.32.  Thanks @abidlabs!
+
+## 0.38.0
+
+### Features
+
+- [#684](https://github.com/gradio-app/trackio/pull/684) [`10011b0`](https://github.com/gradio-app/trackio/commit/10011b0590e2a7ebd552837b16f253a665c2128d) - Reduce dashboard canvas GPU memory and render churn.  Thanks @abidlabs!
+- [#688](https://github.com/gradio-app/trackio/pull/688) [`e332a26`](https://github.com/gradio-app/trackio/commit/e332a262a45facc371443d7f16e4f7d39e5869a3) - Show Trackio version beneath dashboard logo.  Thanks @abidlabs!
+
+## 0.37.1
+
+### Features
+
+- [#678](https://github.com/gradio-app/trackio/pull/678) [`df9168e`](https://github.com/gradio-app/trackio/commit/df9168e2d0de2b284413a7e81915e7c1f76e49ae) - Fix dotted metric names in line plots.  Thanks @abidlabs!
+- [#685](https://github.com/gradio-app/trackio/pull/685) [`b7b349b`](https://github.com/gradio-app/trackio/commit/b7b349b838dcba093e15bc329717ccbb2e3e8f92) - Fix OAuth token authorization for Space logging.  Thanks @abidlabs!
+- [#686](https://github.com/gradio-app/trackio/pull/686) [`ddcd855`](https://github.com/gradio-app/trackio/commit/ddcd8557f6b55a7569700a083bd5ab2253f65e61) - Responsive auto layout for charts, sidebar, and tabs.  Thanks @pngwn!
+
+### Fixes
+
+- [#680](https://github.com/gradio-app/trackio/pull/680) [`c81e537`](https://github.com/gradio-app/trackio/commit/c81e53765ea3e58bc36e3016f98b74d265926196) - decode UTF-8 blobs in `trackio query` output instead of hex-encoding them, so JSON columns like `config` and `metrics` are readable.  Thanks @B1aZer!
+
+## 0.37.0
+
+### Features
+
+- [#672](https://github.com/gradio-app/trackio/pull/672) [`784819b`](https://github.com/gradio-app/trackio/commit/784819b610bbd872bf39ed9ef5d62ece2a5966b5) - Add hierarchical execution spans and a trace inspector with per-operation latency, status, token usage, cost, and input/output details.  Thanks @abidlabs!
+
+## 0.36.0
+
+### Features
+
+- [#674](https://github.com/gradio-app/trackio/pull/674) [`ac5f06c`](https://github.com/gradio-app/trackio/commit/ac5f06c551a051ac435913f3210472d6971b1ed5) - fix: make 3D object cards behave like image cards and fix Reset camera.  Thanks @abidlabs!
+
+## 0.35.0
+
+### Features
+
+- [#645](https://github.com/gradio-app/trackio/pull/645) [`8fe869f`](https://github.com/gradio-app/trackio/commit/8fe869f956515344fef68ee69230b2e192ea7707) - artifact registry storage and publishing API — link artifact versions into typed, cross-project collections with `Run.link_artifact` or `Artifact.link` (and remove links with `Artifact.unlink`), and manage them via `trackio.Registry`.  Thanks @adrien-grl!
+- [#651](https://github.com/gradio-app/trackio/pull/651) [`ae43b85`](https://github.com/gradio-app/trackio/commit/ae43b85ca625a056280278148bab6e34a5c520fa) - add artifact lineage graph.  Thanks @Saba9!
+- [#667](https://github.com/gradio-app/trackio/pull/667) [`e029b80`](https://github.com/gradio-app/trackio/commit/e029b8068b43dea4cd97647d86642abb0b587a1f) - add CLI commands to create, inspect, publish to, promote, and unlink from artifact registries.  Thanks @abidlabs!
+- [#668](https://github.com/gradio-app/trackio/pull/668) [`ac9073f`](https://github.com/gradio-app/trackio/commit/ac9073f283e5d28975246f91879b1e5ed4dbf590) - Add standalone read-only registry dashboard.  Thanks @abidlabs!
+- [#606](https://github.com/gradio-app/trackio/pull/606) [`1dc2dd9`](https://github.com/gradio-app/trackio/commit/1dc2dd9cab0e1603522c43935ebbec6b1f5efb67) - feat(UI): Run comparer - compare (potentially nested) run configs side by side.  Thanks @adrien-grl!
+
+## 0.34.1
+
+### Features
+
+- [#658](https://github.com/gradio-app/trackio/pull/658) [`ad4373c`](https://github.com/gradio-app/trackio/commit/ad4373c521a84092f8bf7b12d87d6d9c65bc3078) - Fix remote media upload filenames.  Thanks @MiloDavis!
+- [#659](https://github.com/gradio-app/trackio/pull/659) [`e9b6e06`](https://github.com/gradio-app/trackio/commit/e9b6e0601ed41d51d9cffc143d21d282d25ca73a) - Fix unstable metric sampling in charts that happens in `trl>=1.7.0`.  Thanks @abidlabs!
+
+## 0.34.0
+
+### Features
+
+- [#656](https://github.com/gradio-app/trackio/pull/656) [`bb888ca`](https://github.com/gradio-app/trackio/commit/bb888ca79dcb1e99572ffb62bdd3b0020d77dc07) - Remove beta status from logbooks.  Thanks @abidlabs!
+- [#652](https://github.com/gradio-app/trackio/pull/652) [`b1e0731`](https://github.com/gradio-app/trackio/commit/b1e07316962fefce71856cafcee7b38e1f477a52) - Log arbitrary HTML and Plotly/Matplotlib figures via `trackio.Html`.  Thanks @greysonlalonde!
+
+## 0.33.0
+
+### Features
+
+- [#647](https://github.com/gradio-app/trackio/pull/647) [`1d25383`](https://github.com/gradio-app/trackio/commit/1d253830e302d4bcd67f3aae5458e6c70c5f5144) - Increase smoothing upper bound to 100.  Thanks @abidlabs!
+- [#648](https://github.com/gradio-app/trackio/pull/648) [`6a1063f`](https://github.com/gradio-app/trackio/commit/6a1063f7c834f850390866b80608ca17c8563199) - Deprecate persisting data to HF Datasets in favor of Buckets.  Thanks @abidlabs!
+
+### Fixes
+
+- [#649](https://github.com/gradio-app/trackio/pull/649) [`8506189`](https://github.com/gradio-app/trackio/commit/8506189b69f6c0361e6420ef545abaad4a773cb3) - render logged histograms in the dashboard's Metrics tab.  Thanks @abidlabs!
+
+## 0.32.2
+
+### Features
+
+- [#641](https://github.com/gradio-app/trackio/pull/641) [`2d1c01a`](https://github.com/gradio-app/trackio/commit/2d1c01a5ce0307ec5c81660c512bf6f25dd3120a) - Improve logbook layout and public repository views.  Thanks @abidlabs!
+- [#643](https://github.com/gradio-app/trackio/pull/643) [`e8292c5`](https://github.com/gradio-app/trackio/commit/e8292c5c26baa0e7e806144fa1bbf5ecfb492f3d) - docs: document the artifact tables in the storage schema page.  Thanks @adrien-grl!
+
+## 0.32.1
+
+### Features
+
+- [#639](https://github.com/gradio-app/trackio/pull/639) [`73971e6`](https://github.com/gradio-app/trackio/commit/73971e66a4f1daf5c42341727349e6f82ab4e887) - Fix logbook code overflow, CLI command truncation, Hub link contrast, resource ID validation, and live visibility detection for referenced trace datasets and Buckets.  Thanks @abidlabs!
+
+## 0.32.0
+
+### Features
+
+- [#635](https://github.com/gradio-app/trackio/pull/635) [`b4587b0`](https://github.com/gradio-app/trackio/commit/b4587b0ebce18756a0f38e3721ed2880a7307137) - Add Code & Markdown, Traces, and Workspace logbook views with live local refresh, guided empty states, and privacy-aware manual publishing to Agent Traces Datasets and HF Buckets.  Thanks @NielsRogge!
+
+## 0.31.5
+
+### Features
+
+- [#630](https://github.com/gradio-app/trackio/pull/630) [`bed508c`](https://github.com/gradio-app/trackio/commit/bed508c04c487686dea3dea70c67b058dd895f96) - Fix automatic dashboard cells to use the active logbook page instead of creating a page named after the Trackio project.  Thanks @abidlabs!
+
+## 0.31.4
+
+### Features
+
+- [#628](https://github.com/gradio-app/trackio/pull/628) [`3eeaa99`](https://github.com/gradio-app/trackio/commit/3eeaa99bd05bef69053b9a1b5c7af3abf56c360c) - let `logbook cell figure` embed image files directly.  Thanks @abidlabs!/n  `trackio logbook cell figure` now accepts an image path via a new `--image`/n  flag, and `--html <file>` transparently embeds the file when it points at an/n  image. Previously the only way to add a PNG/JPG figure was to hand-encode it/n  into an `<img>` data-URI, and passing an image path to `--html` crashed with a/n  `UnicodeDecodeError` (the binary file was read as UTF-8 text). Images are/n  embedded as responsive base64 data URIs. The Python API `add_figure_cell` gains/n  a matching `image=` parameter.
+
+## 0.31.3
+
+### Features
+
+- [#626](https://github.com/gradio-app/trackio/pull/626) [`174aecf`](https://github.com/gradio-app/trackio/commit/174aecff33e6d1cc8d71965a73538c0510abed46) - Fix logbook Markdown escaping and figure hotspot navigation.  Thanks @abidlabs!
+
+## 0.31.2
+
+### Features
+
+- [#624](https://github.com/gradio-app/trackio/pull/624) [`a0918ed`](https://github.com/gradio-app/trackio/commit/a0918edc7594bb211f9e6871546b9d36939f0658) - Fix poster hotspot navigation after iframe load.  Thanks @abidlabs!
+
+## 0.31.1
+
+### Features
+
+- [#621](https://github.com/gradio-app/trackio/pull/621) [`a40f1a4`](https://github.com/gradio-app/trackio/commit/a40f1a464c51652ecdeab04d999659d71b76047e) - add native fullscreen mode for logbook figures.  Thanks @abidlabs!
+- [#623](https://github.com/gradio-app/trackio/pull/623) [`31fd4d7`](https://github.com/gradio-app/trackio/commit/31fd4d7b4004f0c511484f089e6a550da1b4d71e) - let interactive logbook figures navigate to logbook pages.  Thanks @abidlabs!
+
+## 0.31.0
+
+### Features
+
+- [#601](https://github.com/gradio-app/trackio/pull/601) [`8c49140`](https://github.com/gradio-app/trackio/commit/8c491406c54685369d43f3a9c4d4a0e99108bc49) - browse artifacts from the UI.  Thanks @Saba9!
+- [#602](https://github.com/gradio-app/trackio/pull/602) [`1ae1558`](https://github.com/gradio-app/trackio/commit/1ae155803b5450b181a47767255421499074c70b) - feat: add Artifact.add_reference to reference external objects without copy.  Thanks @adrien-grl!
+
+## 0.30.4
+
+### Features
+
+- [#618](https://github.com/gradio-app/trackio/pull/618) [`64c18f6`](https://github.com/gradio-app/trackio/commit/64c18f65bf98d6f54040395a1ca0473347ba6a2b) - Logbook: share button on figures + `logbook pin` CLI.  Thanks @abidlabs!
+
+## 0.30.3
+
+### Features
+
+- [#616](https://github.com/gradio-app/trackio/pull/616) [`645498b`](https://github.com/gradio-app/trackio/commit/645498be37bafab28f884a36e80c5bc0eab06cd9) - Logbook single page.  Thanks @abidlabs!
+
+## 0.30.2
+
+### Features
+
+- [#614](https://github.com/gradio-app/trackio/pull/614) [`eba80c7`](https://github.com/gradio-app/trackio/commit/eba80c7464af250519a90b8ac3179ff6652b651a) - Render logbooks as single-page documents with section navigation and contextual resources.  Thanks @abidlabs!
+- [#612](https://github.com/gradio-app/trackio/pull/612) [`2c1b943`](https://github.com/gradio-app/trackio/commit/2c1b9436b093e9f9335c99c10fe4b6afa622e314) - Warn that logbook open is experimental.  Thanks @abidlabs!
+- [#611](https://github.com/gradio-app/trackio/pull/611) [`96b1d94`](https://github.com/gradio-app/trackio/commit/96b1d94def7596aa1302864cbfc57942dd63822b) - Logbook: auto-capture output artifacts and live-embedded dashboard cells.  Thanks @abidlabs!
+
+## 0.30.1
+
+### Features
+
+- [#609](https://github.com/gradio-app/trackio/pull/609) [`2ed1295`](https://github.com/gradio-app/trackio/commit/2ed12959c73aa9c04ca1096cf7a8315ce2886ed1) - Serve live logbook preview from open.  Thanks @abidlabs!
+
+## 0.30.0
+
+### Features
+
+- [#603](https://github.com/gradio-app/trackio/pull/603) [`a793fd8`](https://github.com/gradio-app/trackio/commit/a793fd88827482134bce295c6228e117de64566a) - Move default artifact downloads under `./.trackio/artifact-downloads/` so materialized files stay out of the project root.  Thanks @abidlabs!
+- [#604](https://github.com/gradio-app/trackio/pull/604) [`dd3b8ee`](https://github.com/gradio-app/trackio/commit/dd3b8eeef4e0da8bf0df6238617e20ae81f3e564) - docs: clarify artifact types.  Thanks @abidlabs!
+- [#586](https://github.com/gradio-app/trackio/pull/586) [`7db4c3b`](https://github.com/gradio-app/trackio/commit/7db4c3b6de6ff4903daf7dabed8842f212c8b7fd) - artifact tracking API — `log_artifact`, `use_artifact`, and an `Artifact` class for versioned, named file collections with aliases, content-addressed deduplication, and producer/consumer run lineage; works offline and syncs blobs to Hugging Face Spaces/Datasets.  Thanks @Saba9!
+- [#597](https://github.com/gradio-app/trackio/pull/597) [`5ba561e`](https://github.com/gradio-app/trackio/commit/5ba561e1b4023abdf63624f4fb396367ed6e9e76) - Add experiment logbooks: shareable static-Space lab notebooks.  Thanks @abidlabs!
+
+## 0.29.0
+
+### Features
+
+- [#593](https://github.com/gradio-app/trackio/pull/593) [`ca4722c`](https://github.com/gradio-app/trackio/commit/ca4722c19d2219a3a78b5977149873b9dff73f34) - Add CLI command to list Trackio Spaces.  Thanks @abidlabs!
+
+## 0.28.1
+
+### Features
+
+- [#589](https://github.com/gradio-app/trackio/pull/589) [`5e9905d`](https://github.com/gradio-app/trackio/commit/5e9905d7815bb063f2d9bb38aa76177405c5e2b4) - Reduce Metrics page log payloads by requesting scalar-only metrics and add URL x-axis initialization/fallback handling.  Thanks @evalstate!
+- [#590](https://github.com/gradio-app/trackio/pull/590) [`56493a6`](https://github.com/gradio-app/trackio/commit/56493a6e9a0114b8655ab44b8c3dec7bae2a5df5) - Use TRACKIO_WRITE_TOKEN for server write token.  Thanks @abidlabs!
+
+## 0.28.0
+
+### Features
+
+- [#582](https://github.com/gradio-app/trackio/pull/582) [`d9dabb5`](https://github.com/gradio-app/trackio/commit/d9dabb5bda8147ad7c9203646358bd0880fa6521) - Add JSONL inbox fragments: durable logging when the Space is unreachable and on network filesystems.  Thanks @abidlabs!
+
+## 0.27.0
+
+### Features
+
+- [#567](https://github.com/gradio-app/trackio/pull/567) [`8c0ce21`](https://github.com/gradio-app/trackio/commit/8c0ce21ff9746d7c6a250684b1b5f0f3f04e0520) - Add CPU, RAM, disk, network and sensor metrics monitoring for non-Apple devices.  Thanks @yannsadowski!
+- [#571](https://github.com/gradio-app/trackio/pull/571) [`57bc7df`](https://github.com/gradio-app/trackio/commit/57bc7df27ecd7b3ff543dbd2bff5c94182bfb69e) - Fix IndexError when importing CSV with no numeric metric columns.  Thanks @Ckal!
+- [#577](https://github.com/gradio-app/trackio/pull/577) [`db0e730`](https://github.com/gradio-app/trackio/commit/db0e730463103142688c1c0efef9ff68a52e281d) - Sort and paginate media items.  Thanks @abidlabs!
+- [#576](https://github.com/gradio-app/trackio/pull/576) [`6f635e2`](https://github.com/gradio-app/trackio/commit/6f635e22553ce2deaece6a0d6289475ab8683040) - Render plot/metric titles as searchable DOM text.  Thanks @abidlabs!
+- [#579](https://github.com/gradio-app/trackio/pull/579) [`cf7759e`](https://github.com/gradio-app/trackio/commit/cf7759efaab73ce1e98a8a2355dc1f65d54bc775) - Merge image viewer with current media page, credit to @catwell.  Thanks @abidlabs!
+
+## 0.26.0
+
+### Features
+
+- [#553](https://github.com/gradio-app/trackio/pull/553) [`06011ac`](https://github.com/gradio-app/trackio/commit/06011acc9c73341fd234f9cd8eaf96d5a34ad8ce) - fix: serve static-Space assets at /static/trackio.  Thanks @abidlabs!
+- [#563](https://github.com/gradio-app/trackio/pull/563) [`551569c`](https://github.com/gradio-app/trackio/commit/551569c16fb56ec63249ebdc28348d326ccf7126) - Fix Traces UI a bit.  Thanks @abidlabs!
+- [#550](https://github.com/gradio-app/trackio/pull/550) [`5690acd`](https://github.com/gradio-app/trackio/commit/5690acda5da303c63ad332451afeab3e9750fd1a) - fix: keep sparse metrics sparse through smoothing.  Thanks @abidlabs!
+- [#551](https://github.com/gradio-app/trackio/pull/551) [`0ef7266`](https://github.com/gradio-app/trackio/commit/0ef72660695cf932f3906ddbf33d41d087280a22) - add "group by" dropdown to sidebar.  Thanks @Saba9!
+- [#538](https://github.com/gradio-app/trackio/pull/538) [`a15c1a8`](https://github.com/gradio-app/trackio/commit/a15c1a8877c07514e0596630bb7c7299299994a9) - Subdue empty dashboard tabs.  Thanks @abidlabs!
+- [#559](https://github.com/gradio-app/trackio/pull/559) [`0b53a41`](https://github.com/gradio-app/trackio/commit/0b53a413909598f92138b6b6395a91c2d5034faf) - Store traces separately from metrics.  Thanks @abidlabs!
+- [#556](https://github.com/gradio-app/trackio/pull/556) [`d110001`](https://github.com/gradio-app/trackio/commit/d110001dbd9f6b262dfe41f2b702e3a71aa0cfc9) - fix: keep selected x-axis option in dropdown and dismiss dropdown on re-click.  Thanks @Saba9!
+- [#560](https://github.com/gradio-app/trackio/pull/560) [`aee2923`](https://github.com/gradio-app/trackio/commit/aee2923d3ada4f74d62d065c16f1f6a56a295e48) - Paginate Traces tab with step filter.  Thanks @abidlabs!
+
+### Fixes
+
+- [#540](https://github.com/gradio-app/trackio/pull/540) [`0b674ac`](https://github.com/gradio-app/trackio/commit/0b674ac6438738de89bc5b3fb700ccfd8a39368c) - raise default metrics sampling cap from 1500 to 3000 so client-side smoothing on the Metrics tab runs over higher-resolution data.  Thanks @edbeeching!
+
+## 0.25.1
+
+### Features
+
+- [#535](https://github.com/gradio-app/trackio/pull/535) [`d7f1b27`](https://github.com/gradio-app/trackio/commit/d7f1b27a98f185d2d97ef54975d5865e0b5243c9) - Avoid HF token leaks in static snapshots.  Thanks @abidlabs!
+
+## 0.25.0
+
+### Features
+
+- [#533](https://github.com/gradio-app/trackio/pull/533) [`08bc5eb`](https://github.com/gradio-app/trackio/commit/08bc5eb090525d3ff5f7fa4233c30c42162aa74c) - Fix Windows-only emoji mojibake when uploading Space README.  Thanks @tomaarsen!
+- [#518](https://github.com/gradio-app/trackio/pull/518) [`e7ed176`](https://github.com/gradio-app/trackio/commit/e7ed176da53d8b49290fddd890b3d18c0b9b958f) - Traces in Trackio.  Thanks @abidlabs!
+- [#531](https://github.com/gradio-app/trackio/pull/531) [`27a50a3`](https://github.com/gradio-app/trackio/commit/27a50a37362020304b774344b4c774ff548985b6) - Add configurable custom frontends for Trackio.  Thanks @abidlabs!
+
+## 0.24.2
+
+### Features
+
+- [#527](https://github.com/gradio-app/trackio/pull/527) [`7d1c0b9`](https://github.com/gradio-app/trackio/commit/7d1c0b9c37ce9a9845e6bbe6c083da9d36084caf) - Fix dashboard UX issues: smoothing in share URL, run selection, and run filtering.  Thanks @abidlabs!
+- [#526](https://github.com/gradio-app/trackio/pull/526) [`643878a`](https://github.com/gradio-app/trackio/commit/643878a82985fab9e6675f769ff0107cb46e042a) - Add emoji to README and deploy README content.  Thanks @qgallouedec!
+- [#529](https://github.com/gradio-app/trackio/pull/529) [`a77972b`](https://github.com/gradio-app/trackio/commit/a77972b68541ebe9e056824e69c9bbca3979ece4) - Remove pydub dependency.  Thanks @abidlabs!
+
+## 0.24.1
+
+### Features
+
+- [#524](https://github.com/gradio-app/trackio/pull/524) [`65a6897`](https://github.com/gradio-app/trackio/commit/65a6897561b465fc8f05550562f8da1ba3c99060) - Fix `trackio skills add`.  Thanks @abidlabs!
+- [#522](https://github.com/gradio-app/trackio/pull/522) [`05aaca7`](https://github.com/gradio-app/trackio/commit/05aaca7f166bf7667b60b40656d677532a4bdd6e) - relax `starlette` dependency and fix import style.  Thanks @abidlabs!
+- [#525](https://github.com/gradio-app/trackio/pull/525) [`32c05c5`](https://github.com/gradio-app/trackio/commit/32c05c5d5e3aa84ca7099a6fa08a9093ccd4b95f) - Restore sidebar share and embed snippets, and fix query parameter regression.  Thanks @abidlabs!
+
+## 0.24.0
+
+### Features
+
+- [#502](https://github.com/gradio-app/trackio/pull/502) [`3b397df`](https://github.com/gradio-app/trackio/commit/3b397dfbaff9de137b088f3cad528117e14faab1) - Add docs on SQL & Parquet schema / format, as well as a new CLI command: `trackio query project --project PROJECT --sql SQL_QUERY`.  Thanks @abidlabs!
+- [#506](https://github.com/gradio-app/trackio/pull/506) [`498bbc4`](https://github.com/gradio-app/trackio/commit/498bbc47f66cc90cc5776f363d001a5571941c00) - Scope bucket sync to trackio/ subtree to avoid walking the HF cache.  Thanks @abidlabs!
+- [#505](https://github.com/gradio-app/trackio/pull/505) [`8e26ab9`](https://github.com/gradio-app/trackio/commit/8e26ab93b5d9caa2f81334f6fff42fb9cefbb232) - Add an `id` field to `Run` which is used internally, allowing users to have multiple runs with the same run name.  Thanks @abidlabs!
+- [#517](https://github.com/gradio-app/trackio/pull/517) [`29e1034`](https://github.com/gradio-app/trackio/commit/29e1034b795567ec5ed6d19c5a946915a6498e2a) - Fix static exports, Space bucket handling, and other misc issues.  Thanks @abidlabs!
+- [#489](https://github.com/gradio-app/trackio/pull/489) [`1b96db3`](https://github.com/gradio-app/trackio/commit/1b96db39c8fd4326e621ee2336b0fca4f263a18a) - Remove `gradio` dependency in `trackio` -- only `gradio_client` is needed locally anymore. Also lazily import `pandas` and remove it as a dependency.  Thanks @abidlabs!
+- [#513](https://github.com/gradio-app/trackio/pull/513) [`d54d290`](https://github.com/gradio-app/trackio/commit/d54d290fcb1bb08358b558a43a962f78abe990ea) - Reduce HF Spaces 429s: polling tuning and batched metric logs API.  Thanks @abidlabs!
+- [#516](https://github.com/gradio-app/trackio/pull/516) [`afe2959`](https://github.com/gradio-app/trackio/commit/afe295988928a3ea3ded38bdb5bb05cca85d3c74) - Fix run list order and legend overflow.  Thanks @abidlabs!
+- [#515](https://github.com/gradio-app/trackio/pull/515) [`0a242b8`](https://github.com/gradio-app/trackio/commit/0a242b85127b02f532b24c7fd2bb046580cc7641) - Add Gradio-compatible /gradio_api routes on Spaces.  Thanks @abidlabs!
+- [#510](https://github.com/gradio-app/trackio/pull/510) [`60bbc86`](https://github.com/gradio-app/trackio/commit/60bbc86b4e7f880de72075e5bf31b093709bb5a4) - Add server_url and TRACKIO_SERVER_URL for self-hosted servers; space_id and TRACKIO_SPACE_ID take precedence when both are set.  Thanks @abidlabs!
+- [#509](https://github.com/gradio-app/trackio/pull/509) [`21c099a`](https://github.com/gradio-app/trackio/commit/21c099aa830a278973fab4c7c58a0139f417caa4) - Fix: Open browser with write_token so trackio show allows mutations.  Thanks @abidlabs!
+
+## 0.23.0
+
+### Features
+
+- [#494](https://github.com/gradio-app/trackio/pull/494) [`e8a897d`](https://github.com/gradio-app/trackio/commit/e8a897d2266d9b2558f72d768b0b21f4d0a8781b) - Add a settings/CLI page to Trackio.  Thanks @abidlabs!
+- [#481](https://github.com/gradio-app/trackio/pull/481) [`882647e`](https://github.com/gradio-app/trackio/commit/882647ec1599cf04500d03b5ca75ddc2733682e2) - Add multi-GPU system metrics support.  Thanks @Saba9!
+- [#485](https://github.com/gradio-app/trackio/pull/485) [`46a3cc3`](https://github.com/gradio-app/trackio/commit/46a3cc3758719e171417612efee102a487e71ebd) - Fix/remove flaky E2E space tests.  Thanks @abidlabs!
+- [#501](https://github.com/gradio-app/trackio/pull/501) [`06ea885`](https://github.com/gradio-app/trackio/commit/06ea8852f5e40ab3f1cf629a0a01af5c17f847a1) - Fix SQLite corruption on bucket-mounted Spaces.  Thanks @abidlabs!
+- [#496](https://github.com/gradio-app/trackio/pull/496) [`af23d74`](https://github.com/gradio-app/trackio/commit/af23d74438b146c4a3512ace15ea984656e943ed) - Prevent trackio errors from crashing the user's training loop.  Thanks @abidlabs!
+
+## 0.22.0
+
+### Features
+
+- [#484](https://github.com/gradio-app/trackio/pull/484) [`cc05ada`](https://github.com/gradio-app/trackio/commit/cc05ada8e89773f3a894af99b801ef680f64418f) - Fix duplicate columns in parquet export.  Thanks @abidlabs!
+- [#487](https://github.com/gradio-app/trackio/pull/487) [`853f764`](https://github.com/gradio-app/trackio/commit/853f7646a70d12633afaa4f69db86425aa665413) - Relax `PIL` dependency and remove `plotly` as it's no longer used.  Thanks @abidlabs!
+
+## 0.21.2
+
+### Features
+
+- [#482](https://github.com/gradio-app/trackio/pull/482) [`f62180a`](https://github.com/gradio-app/trackio/commit/f62180a0218bc99a259d5ca110a0384a6cae11c8) - Use server-side bucket copy when freezing Spaces.  Thanks @abidlabs!
+
+## 0.21.1
+
+### Features
+
+- [#475](https://github.com/gradio-app/trackio/pull/475) [`fcb476c`](https://github.com/gradio-app/trackio/commit/fcb476cd37a40923e9679aaf966f41d582a878a8) - Tweaks.  Thanks @abidlabs!
+- [#477](https://github.com/gradio-app/trackio/pull/477) [`7d52dfd`](https://github.com/gradio-app/trackio/commit/7d52dfdce5b6eff6a34501a6d5a620220663cf09) - Fix `.sync()` and add `.freeze()` as a separate methods.  Thanks @abidlabs!
+
+## 0.21.0
+
+### Features
+
+- [#467](https://github.com/gradio-app/trackio/pull/467) [`f357deb`](https://github.com/gradio-app/trackio/commit/f357debf78957e4c1f2b901bee4f77cf397298b4) - Allow logged metrics as x-axis choices.  Thanks @abidlabs!
+- [#474](https://github.com/gradio-app/trackio/pull/474) [`655673d`](https://github.com/gradio-app/trackio/commit/655673d4c6b7c8b7ee8f87f2589f2dbbc3d2ef91) - Fix file descriptor leak from `sqlite3.connect`.  Thanks @abidlabs!
+- [#470](https://github.com/gradio-app/trackio/pull/470) [`bea8c9d`](https://github.com/gradio-app/trackio/commit/bea8c9dcae0b59d071b6c779c97ee525c9bbf6e7) - Restores tooltips to line plots and fixes the call to uses TTL instead of OAuth.  Thanks @abidlabs!
+- [#471](https://github.com/gradio-app/trackio/pull/471) [`246fce0`](https://github.com/gradio-app/trackio/commit/246fce0a01619e1c2c538c67b3e460883334d500) - Deprecate dataset backend in favor of buckets.  Thanks @abidlabs!
+- [#465](https://github.com/gradio-app/trackio/pull/465) [`3e11174`](https://github.com/gradio-app/trackio/commit/3e1117438bb8168b802245a33059affa558ae519) - Use HF buckets as backend.  Thanks @abidlabs!
+- [#469](https://github.com/gradio-app/trackio/pull/469) [`915d170`](https://github.com/gradio-app/trackio/commit/915d17045133172b59195acfdcc70709229668aa) - Make static Spaces work with Buckets and also allow conversion from Gradio SDK to Static Spaces.  Thanks @abidlabs!
+
+## 0.20.2
+
+### Features
+
+- [#464](https://github.com/gradio-app/trackio/pull/464) [`c89ebb3`](https://github.com/gradio-app/trackio/commit/c89ebb3b50f695bc7f16cbc6f46dce86f79a01e9) - Improve rendering of curves.  Thanks @abidlabs!
+- [#462](https://github.com/gradio-app/trackio/pull/462) [`9160b78`](https://github.com/gradio-app/trackio/commit/9160b78ff6f258f0b87a4f34a24e7d0b5dfbf2fb) - Refactor plot title to display only the metric name without the path.  Thanks @qgallouedec!
+
+## 0.20.1
+
+### Features
+
+- [#454](https://github.com/gradio-app/trackio/pull/454) [`22881db`](https://github.com/gradio-app/trackio/commit/22881dbbbb6b81197a00a19853771007093d61e4) - Bar chart single point.  Thanks @abidlabs!
+- [#455](https://github.com/gradio-app/trackio/pull/455) [`f8db51a`](https://github.com/gradio-app/trackio/commit/f8db51a20ca61ef703f3f2c2ee1ebd9c4f239cf2) - Adds a static Trackio mode via `trackio.sync(sdk="static")` and support for the `TRACKIO_SPACE_ID` environment variable.  Thanks @abidlabs!
+
+## 0.20.0
+
+### Features
+
+- [#450](https://github.com/gradio-app/trackio/pull/450) [`b0571ef`](https://github.com/gradio-app/trackio/commit/b0571ef6207a1ce346696f858ad2b7b584dd194f) - Use Svelte source for Gradio components directly in Trackio dashboard.  Thanks @abidlabs!
+
+## 0.19.0
+
+### Features
+
+- [#445](https://github.com/gradio-app/trackio/pull/445) [`cef4a58`](https://github.com/gradio-app/trackio/commit/cef4a583cb76f4091fc6c0e5783124ee84f8e243) - Add remote HF Space support to CLI.  Thanks @abidlabs!
+- [#444](https://github.com/gradio-app/trackio/pull/444) [`358f2a9`](https://github.com/gradio-app/trackio/commit/358f2a9ca238ee8b90b5a8c96220da287e0698fb) - Fix alerts placeholder flashing on reports page.  Thanks @abidlabs!
+
+## 0.18.0
+
+### Features
+
+- [#435](https://github.com/gradio-app/trackio/pull/435) [`4a47112`](https://github.com/gradio-app/trackio/commit/4a471128e18a39e45fad48a67fd711c5ae9e4aed) - feat: allow hiding section header accordions.  Thanks @Saba9!
+- [#439](https://github.com/gradio-app/trackio/pull/439) [`18e9650`](https://github.com/gradio-app/trackio/commit/18e96503d5a3a7cf926e92782d457e23c19942bd) - Add alerts with webhooks, CLI, and documentation.  Thanks @abidlabs!
+- [#438](https://github.com/gradio-app/trackio/pull/438) [`0875ccd`](https://github.com/gradio-app/trackio/commit/0875ccd3d8a41b1376f64030f21cfe8cdcc73b05) - Add "share this view" functionality.  Thanks @qgallouedec!
+- [#409](https://github.com/gradio-app/trackio/pull/409) [`9282403`](https://github.com/gradio-app/trackio/commit/9282403d8896d48679b0f888208a7ba5bdd4271a) - Add Apple Silicon GPU and system monitoring support.  Thanks @znation!
+- [#434](https://github.com/gradio-app/trackio/pull/434) [`4193223`](https://github.com/gradio-app/trackio/commit/41932230a3a2e1c16405dba08ecba5a42f11d1a8) - fix: table slider crash.  Thanks @Saba9!
+
+### Fixes
+
+- [#441](https://github.com/gradio-app/trackio/pull/441) [`3a2d11d`](https://github.com/gradio-app/trackio/commit/3a2d11dab0b4b37c925abc30ef84b0e2910321ee) - preserve x-axis step when toggling run checkboxes.  Thanks @Saba9!
+
+## 0.17.0
+
+### Features
+
+- [#428](https://github.com/gradio-app/trackio/pull/428) [`f7dd1ce`](https://github.com/gradio-app/trackio/commit/f7dd1ce2dc8a1936f9983467fcbcf93bfef01e09) - feat: add ability to rename runs.  Thanks @Saba9!
+- [#437](https://github.com/gradio-app/trackio/pull/437) [`2727c0b`](https://github.com/gradio-app/trackio/commit/2727c0b0755f48f7f186162ea45185c98f6b5516) - Add markdown reports across Trackio.  Thanks @abidlabs!
+- [#427](https://github.com/gradio-app/trackio/pull/427) [`5aeb9ed`](https://github.com/gradio-app/trackio/commit/5aeb9edcfd2068d309d9d64f172dcbcc327be1ab) - Make Trackio logging much more robust.  Thanks @abidlabs!
+
+## 0.16.1
+
+### Features
+
+- [#431](https://github.com/gradio-app/trackio/pull/431) [`c7ce55b`](https://github.com/gradio-app/trackio/commit/c7ce55b14dd5eb0c2165fb15df17dd60721c9325) - Lazy load the UI when trackio is imported.  Thanks @abidlabs!
+
+## 0.16.0
+
+### Features
+
+- [#426](https://github.com/gradio-app/trackio/pull/426) [`ead4dc8`](https://github.com/gradio-app/trackio/commit/ead4dc8e74ee2d8e47d61bca0a7668456acf49be) - Fix redundant double rendering of group checkboxes.  Thanks @abidlabs!
+- [#413](https://github.com/gradio-app/trackio/pull/413) [`39c4750`](https://github.com/gradio-app/trackio/commit/39c4750951d554ba6eb4d58847c6bb444b2891a8) - Check `dist-packages` when checking for source installation.  Thanks @sergiopaniego!
+- [#423](https://github.com/gradio-app/trackio/pull/423) [`2e52ab3`](https://github.com/gradio-app/trackio/commit/2e52ab303e3041718a6a56fbf84d0848aca9ad67) - Fix legend outline visibility issue.  Thanks @Raghunath-Balaji!
+- [#407](https://github.com/gradio-app/trackio/pull/407) [`c8a384d`](https://github.com/gradio-app/trackio/commit/c8a384ddfe5a295cecf862a26178d40e48acb424) - Fix pytests that were failling locally on MacOS.  Thanks @abidlabs!
+- [#405](https://github.com/gradio-app/trackio/pull/405) [`35aae4e`](https://github.com/gradio-app/trackio/commit/35aae4e3aa3e2b2888887528478b9dc6a9808bda) - Add conditional padding for HF Space dashboard when not in iframe.  Thanks @znation!
+
+## 0.15.0
+
+### Features
+
+- [#397](https://github.com/gradio-app/trackio/pull/397) [`6b38ad0`](https://github.com/gradio-app/trackio/commit/6b38ad02e5d73a0df49c4eede7e91331282ece04) - Adds `--host` cli option support.  Thanks @abidlabs!
+- [#396](https://github.com/gradio-app/trackio/pull/396) [`4a4d1ab`](https://github.com/gradio-app/trackio/commit/4a4d1ab85e63d923132a3fa7afa5d90e16431bec) - Fix run selection issue.  Thanks @abidlabs!
+- [#394](https://github.com/gradio-app/trackio/pull/394) [`c47a3a3`](https://github.com/gradio-app/trackio/commit/c47a3a31f8c4b83bce1aa7fc22eeba3d9021ad3d) - Add wandb-compatible API for trackio.  Thanks @abidlabs!
+- [#378](https://github.com/gradio-app/trackio/pull/378) [`b02046a`](https://github.com/gradio-app/trackio/commit/b02046a5b0dad7c9854e099a87f884afba4aecb2) - Add JSON export button for line plots and upgrade gradio dependency.  Thanks @JamshedAli18!
+
+## 0.14.2
+
+### Features
+
+- [#386](https://github.com/gradio-app/trackio/pull/386) [`f9452cd`](https://github.com/gradio-app/trackio/commit/f9452cdb8f0819368f3610f7ac0ed08957305275) - Fixing some issues related to deployed Trackio Spaces.  Thanks @abidlabs!
+
+## 0.14.1
+
+### Features
+
+- [#382](https://github.com/gradio-app/trackio/pull/382) [`44fe9bb`](https://github.com/gradio-app/trackio/commit/44fe9bb264fb2aafb0ec302ff15227c045819a2c) - Fix app file path when Trackio is not installed from source.  Thanks @abidlabs!
+- [#380](https://github.com/gradio-app/trackio/pull/380) [`c3f4cff`](https://github.com/gradio-app/trackio/commit/c3f4cff74bc5676e812773d8571454894fcdc7cc) - Add CLI commands for querying projects, runs, and metrics.  Thanks @abidlabs!
+
+## 0.14.0
+
+### Features
+
+- [#377](https://github.com/gradio-app/trackio/pull/377) [`5c5015b`](https://github.com/gradio-app/trackio/commit/5c5015b68c85c5de51111dad983f735c27b9a05f) - fixed wrapping issue in Runs table.  Thanks @gaganchapa!
+- [#374](https://github.com/gradio-app/trackio/pull/374) [`388e26b`](https://github.com/gradio-app/trackio/commit/388e26b9e9f24cd7ad203affe9b709be885b3d24) - Save Optimized Parquet files.  Thanks @lhoestq!
+- [#371](https://github.com/gradio-app/trackio/pull/371) [`fbace9c`](https://github.com/gradio-app/trackio/commit/fbace9cd7732c166f34d268f54b05bb06846cc5d) - Add GPU metrics logging.  Thanks @kashif!
+- [#367](https://github.com/gradio-app/trackio/pull/367) [`862840c`](https://github.com/gradio-app/trackio/commit/862840c13e30fc960cbee5b9eac4d3c25beba9de) - Add option to only show latest run, and fix the double logo issue.  Thanks @abidlabs!
+
+## 0.13.1
+
+### Features
+
+- [#369](https://github.com/gradio-app/trackio/pull/369) [`767e9fe`](https://github.com/gradio-app/trackio/commit/767e9fe095d7c6ed102016caf927c1517fb8618c) - tiny pr removing unnecessary code.  Thanks @abidlabs!
+
+## 0.13.0
+
+### Features
+
+- [#358](https://github.com/gradio-app/trackio/pull/358) [`073715d`](https://github.com/gradio-app/trackio/commit/073715d1caf8282f68890117f09c3ac301205312) - Improvements to `trackio.sync()`.  Thanks @abidlabs!
+
+## 0.12.0
+
+### Features
+
+- [#357](https://github.com/gradio-app/trackio/pull/357) [`02ba815`](https://github.com/gradio-app/trackio/commit/02ba815358060f1966052de051a5bdb09702920e) - Redesign media and tables to show up on separate page.  Thanks @abidlabs!
+- [#359](https://github.com/gradio-app/trackio/pull/359) [`08fe9c9`](https://github.com/gradio-app/trackio/commit/08fe9c9ddd7fe99ee811555fdfb62df9ab88e939) - docs: Improve docstrings.  Thanks @qgallouedec!
+
+## 0.11.0
+
+### Features
+
+- [#355](https://github.com/gradio-app/trackio/pull/355) [`ea51f49`](https://github.com/gradio-app/trackio/commit/ea51f4954922f21be76ef828700420fe9a912c4b) - Color code run checkboxes and match with plot lines.  Thanks @abidlabs!
+- [#353](https://github.com/gradio-app/trackio/pull/353) [`8abe691`](https://github.com/gradio-app/trackio/commit/8abe6919aeefe21fc7a23af814883efbb037c21f) - Remove show_api from demo.launch.  Thanks @sergiopaniego!
+- [#351](https://github.com/gradio-app/trackio/pull/351) [`8a8957e`](https://github.com/gradio-app/trackio/commit/8a8957e530dd7908d1fef7f2df030303f808101f) - Add `trackio.save()`.  Thanks @abidlabs!
+
+## 0.10.0
+
+### Features
+
+- [#305](https://github.com/gradio-app/trackio/pull/305) [`e64883a`](https://github.com/gradio-app/trackio/commit/e64883a51f7b8b93f7d48b8afe55acdb62238b71) - bump to gradio 6.0, make `trackio` compatible, and fix related issues.  Thanks @abidlabs!
+
+## 0.9.1
+
+### Features
+
+- [#344](https://github.com/gradio-app/trackio/pull/344) [`7e01024`](https://github.com/gradio-app/trackio/commit/7e010241d9a34794e0ce0dc19c1a6f0cf94ba856) - Avoid redundant calls to /whoami-v2.  Thanks @Wauplin!
+
+## 0.9.0
+
+### Features
+
+- [#343](https://github.com/gradio-app/trackio/pull/343) [`51bea30`](https://github.com/gradio-app/trackio/commit/51bea30f2877adff8e6497466d3a799400a0a049) - Sync offline projects to Hugging Face spaces.  Thanks @candemircan!
+- [#341](https://github.com/gradio-app/trackio/pull/341) [`4fd841f`](https://github.com/gradio-app/trackio/commit/4fd841fa190e15071b02f6fba7683ef4f393a654) - Adds a basic UI test to `trackio`.  Thanks @abidlabs!
+- [#339](https://github.com/gradio-app/trackio/pull/339) [`011d91b`](https://github.com/gradio-app/trackio/commit/011d91bb6ae266516fd250a349285670a8049d05) - Allow customzing the trackio color palette.  Thanks @abidlabs!
+
+## 0.8.1
+
+### Features
+
+- [#336](https://github.com/gradio-app/trackio/pull/336) [`5f9f51d`](https://github.com/gradio-app/trackio/commit/5f9f51dac8677f240d7c42c3e3b2660a22aee138) - Support a list of `Trackio.Image` in a `trackio.Table` cell.  Thanks @abidlabs!
+
+## 0.8.0
+
+### Features
+
+- [#331](https://github.com/gradio-app/trackio/pull/331) [`2c02d0f`](https://github.com/gradio-app/trackio/commit/2c02d0fd0a5824160528782402bb0dd4083396d5) - Truncate table string values that are greater than 250 characters (configuirable via env variable).  Thanks @abidlabs!
+- [#324](https://github.com/gradio-app/trackio/pull/324) [`50b2122`](https://github.com/gradio-app/trackio/commit/50b2122e7965ac82a72e6cb3b7d048bc10a2a6b1) - Add log y-axis functionality to UI.  Thanks @abidlabs!
+- [#326](https://github.com/gradio-app/trackio/pull/326) [`61dc1f4`](https://github.com/gradio-app/trackio/commit/61dc1f40af2f545f8e70395ddf0dbb8aee6b60d5) - Fix: improve table rendering for metrics in Trackio Dashboard.  Thanks @vigneshwaran!
+- [#328](https://github.com/gradio-app/trackio/pull/328) [`6857cbb`](https://github.com/gradio-app/trackio/commit/6857cbbe557a59a4642f210ec42566d108294e63) - Support trackio.Table with trackio.Image columns.  Thanks @abidlabs!
+- [#323](https://github.com/gradio-app/trackio/pull/323) [`6857cbb`](https://github.com/gradio-app/trackio/commit/6857cbbe557a59a4642f210ec42566d108294e63) - add Trackio client implementations in Go, Rust, and JS.  Thanks @vaibhav-research!
+
+## 0.7.0
+
+### Features
+
+- [#277](https://github.com/gradio-app/trackio/pull/277) [`db35601`](https://github.com/gradio-app/trackio/commit/db35601b9c023423c4654c9909b8ab73e58737de) - fix: make grouped runs view reflect live updates.  Thanks @Saba9!
+- [#320](https://github.com/gradio-app/trackio/pull/320) [`24ae739`](https://github.com/gradio-app/trackio/commit/24ae73969b09fb3126acd2f91647cdfbf8cf72a1) - Add additional query parms for xmin, xmax, and smoothing.  Thanks @abidlabs!
+- [#270](https://github.com/gradio-app/trackio/pull/270) [`cd1dfc3`](https://github.com/gradio-app/trackio/commit/cd1dfc3dc641b4499ac6d4a1b066fa8e2b52c57b) - feature: add support for logging audio.  Thanks @Saba9!
+
+## 0.6.0
+
+### Features
+
+- [#309](https://github.com/gradio-app/trackio/pull/309) [`1df2353`](https://github.com/gradio-app/trackio/commit/1df23534d6c01938c8db9c0f584ffa23e8d6021d) - Add histogram support with wandb-compatible API.  Thanks @abidlabs!
+- [#315](https://github.com/gradio-app/trackio/pull/315) [`76ba060`](https://github.com/gradio-app/trackio/commit/76ba06055dc43ca8f03b79f3e72d761949bd19a8) - Add guards to avoid silent fails.  Thanks @Xmaster6y!
+- [#313](https://github.com/gradio-app/trackio/pull/313) [`a606b3e`](https://github.com/gradio-app/trackio/commit/a606b3e1c5edf3d4cf9f31bd50605226a5a1c5d0) - No longer prevent certain keys from being used. Instead, dunderify them to prevent collisions with internal usage.  Thanks @abidlabs!
+- [#317](https://github.com/gradio-app/trackio/pull/317) [`27370a5`](https://github.com/gradio-app/trackio/commit/27370a595d0dbdf7eebbe7159d2ba778f039da44) - quick fixes for trackio.histogram.  Thanks @abidlabs!
+- [#312](https://github.com/gradio-app/trackio/pull/312) [`aa0f3bf`](https://github.com/gradio-app/trackio/commit/aa0f3bf372e7a0dd592a38af699c998363830eeb) - Fix video logging by adding TRACKIO_DIR to allowed_paths.  Thanks @abidlabs!
+
+## 0.5.3
+
+### Features
+
+- [#300](https://github.com/gradio-app/trackio/pull/300) [`5e4cacf`](https://github.com/gradio-app/trackio/commit/5e4cacf2e7ce527b4ce60de3a5bc05d2c02c77fb) - Adds more environment variables to allow customization of Trackio dashboard.  Thanks @abidlabs!
+
+## 0.5.2
+
+### Features
+
+- [#293](https://github.com/gradio-app/trackio/pull/293) [`64afc28`](https://github.com/gradio-app/trackio/commit/64afc28d3ea1dfd821472dc6bf0b8ed35a9b74be) - Ensures that the TRACKIO_DIR environment variable is respected.  Thanks @abidlabs!
+- [#287](https://github.com/gradio-app/trackio/pull/287) [`cd3e929`](https://github.com/gradio-app/trackio/commit/cd3e9294320949e6b8b829239069a43d5d7ff4c1) - fix(sqlite): unify .sqlite extension, allow export when DBs exist, clean WAL sidecars on import.  Thanks @vaibhav-research!
+
+### Fixes
+
+- [#291](https://github.com/gradio-app/trackio/pull/291) [`3b5adc3`](https://github.com/gradio-app/trackio/commit/3b5adc3d1f452dbab7a714d235f4974782f93730) - Fix the wheel build.  Thanks @pngwn!
+
+## 0.5.1
+
+### Fixes
+
+- [#278](https://github.com/gradio-app/trackio/pull/278) [`314c054`](https://github.com/gradio-app/trackio/commit/314c05438007ddfea3383e06fd19143e27468e2d) - Fix row orientation of metrics plots.  Thanks @abidlabs!

trackio/__init__.py

@@ -0,0 +1,1280 @@
+import atexit
+import glob
+import json
+import logging
+import os
+import shutil
+import warnings
+import webbrowser
+from pathlib import Path
+from typing import Any
+
+import huggingface_hub
+from gradio_client import handle_file
+from huggingface_hub import SpaceStorage
+from huggingface_hub.errors import LocalTokenNotFoundError
+
+from trackio import context_vars, deploy, utils
+from trackio._unsupported import (
+    ArtifactTTL,
+    Classes,
+    Config,
+    EvalTable,
+    Graph,
+    JoinedTable,
+    Molecule,
+    Plotly,
+    Settings,
+)
+from trackio.alerts import AlertLevel
+from trackio.api import Api
+from trackio.apple_gpu import apple_gpu_available
+from trackio.apple_gpu import log_apple_gpu as _log_apple_gpu
+from trackio.artifact import Artifact
+from trackio.cpu import cpu_available
+from trackio.cpu import log_cpu as _log_cpu
+from trackio.deploy import freeze, sync
+from trackio.frontend_config import resolve_frontend_dir
+from trackio.gpu import gpu_available
+from trackio.gpu import log_gpu as _log_nvidia_gpu
+from trackio.histogram import Histogram
+from trackio.imports import import_csv, import_tf_events
+from trackio.launch import launch_trackio_dashboard
+from trackio.markdown import Markdown
+from trackio.media import (
+    TrackioAudio,
+    TrackioHtml,
+    TrackioImage,
+    TrackioObject3D,
+    TrackioVideo,
+    get_project_media_path,
+)
+from trackio.references import (
+    ReferenceHandler,
+    ResolvedReference,
+    register_reference_handler,
+)
+from trackio.registry import Collection as Collection
+from trackio.registry import Registry as Registry
+from trackio.remote_client import RemoteClient
+from trackio.run import Run
+from trackio.server import TrackioDashboardApp, build_starlette_app_only
+from trackio.sqlite_storage import SQLiteStorage
+from trackio.table import Table
+from trackio.trace import Trace
+from trackio.typehints import UploadEntry
+from trackio.utils import TRACKIO_DIR, TRACKIO_LOGO_DIR, _emit_nonfatal_warning
+
+logging.getLogger("httpx").setLevel(logging.WARNING)
+
+__version__ = json.loads(Path(__file__).parent.joinpath("package.json").read_text())[
+    "version"
+]
+
+
+class _TupleNoPrint(tuple):
+    def __repr__(self) -> str:
+        return ""
+
+
+__all__ = [
+    "init",
+    "log",
+    "log_system",
+    "log_gpu",
+    "log_artifact",
+    "use_artifact",
+    "log_cpu",
+    "finish",
+    "alert",
+    "AlertLevel",
+    "show",
+    "sync",
+    "freeze",
+    "delete_project",
+    "import_csv",
+    "import_tf_events",
+    "save",
+    "Artifact",
+    "ArtifactTTL",
+    "Classes",
+    "Config",
+    "EvalTable",
+    "Graph",
+    "JoinedTable",
+    "Molecule",
+    "Plotly",
+    "Settings",
+    "ReferenceHandler",
+    "ResolvedReference",
+    "register_reference_handler",
+    "Image",
+    "Video",
+    "Audio",
+    "Html",
+    "Object3D",
+    "Table",
+    "Trace",
+    "Histogram",
+    "Markdown",
+    "Api",
+    "TRACKIO_LOGO_DIR",
+]
+
+Audio = TrackioAudio
+Image = TrackioImage
+Video = TrackioVideo
+Html = TrackioHtml
+Object3D = TrackioObject3D
+
+
+config = {}
+
+_atexit_registered = False
+_spaces_created_this_session: set[str] = set()
+_projects_notified_auto_log_hw: set[str] = set()
+
+
+def _cleanup_current_run():
+    run = context_vars.current_run.get()
+    if run is not None:
+        try:
+            run.finish()
+        except Exception:
+            pass
+
+
+def _safe_get_runs_for_init(
+    project: str,
+    space_id: str | None,
+    server_base_url: str | None,
+    write_token: str | None,
+    resume: str,
+    remote_client: RemoteClient | None = None,
+    check_existing_for_never: bool = False,
+) -> list[str]:
+    if space_id is not None or server_base_url is not None:
+        if resume == "never" and not check_existing_for_never:
+            return []
+        if remote_client is not None:
+            source = space_id or server_base_url
+            try:
+                runs = remote_client.predict(
+                    project=project, api_name="/get_runs_for_project"
+                )
+                return runs if isinstance(runs, list) else []
+            except Exception as e:
+                _emit_nonfatal_warning(
+                    f"trackio.init() could not inspect existing runs for project '{project}' on '{source}': {e}. Continuing without resume metadata."
+                )
+                return []
+    try:
+        return SQLiteStorage.get_runs(project)
+    except Exception as e:
+        _emit_nonfatal_warning(
+            f"trackio.init() could not inspect existing runs for project '{project}': {e}. Continuing without resume metadata."
+        )
+        return []
+
+
+def _migrate_local_project_for_init(project: str) -> None:
+    if utils.get_storage_mode() == "jsonl":
+        return
+    if not SQLiteStorage.get_project_db_path(project).exists():
+        return
+    try:
+        SQLiteStorage.init_db(project)
+    except Exception as e:
+        _emit_nonfatal_warning(
+            f"trackio.init() could not migrate the local database for project '{project}': {e}."
+        )
+
+
+def _safe_get_latest_run_for_init(
+    project: str,
+    name: str,
+    space_id: str | None = None,
+    server_base_url: str | None = None,
+    write_token: str | None = None,
+    remote_client: RemoteClient | None = None,
+) -> dict | None:
+    if (
+        space_id is not None or server_base_url is not None
+    ) and remote_client is not None:
+        source = space_id or server_base_url
+        try:
+            runs = remote_client.predict(
+                project=project, api_name="/get_runs_for_project"
+            )
+            if not isinstance(runs, list):
+                return None
+            matches = [r for r in runs if isinstance(r, dict) and r.get("name") == name]
+            if not matches:
+                return None
+            matches.sort(key=lambda r: r.get("created_at") or "", reverse=True)
+            return matches[0]
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not inspect existing runs for project '{project}' on '{source}': {e}. Continuing without resume metadata."
+            )
+            return None
+    try:
+        return SQLiteStorage.get_latest_run_record_by_name(project, name)
+    except Exception as e:
+        _emit_nonfatal_warning(
+            f"trackio.init() could not inspect existing runs for project '{project}': {e}. Continuing without resume metadata."
+        )
+        return None
+
+
+def _safe_get_last_step_for_init(
+    project: str,
+    run_name: str,
+    space_id: str | None,
+    server_base_url: str | None,
+    write_token: str | None,
+    resumed: bool,
+    run_id: str | None = None,
+    remote_client: RemoteClient | None = None,
+) -> int | None:
+    if not resumed:
+        return None
+    if (
+        space_id is not None or server_base_url is not None
+    ) and remote_client is not None:
+        source = space_id or server_base_url
+        try:
+            summary_kwargs: dict[str, Any] = {
+                "project": project,
+                "api_name": "/get_run_summary",
+            }
+            if run_id is not None:
+                summary_kwargs["run_id"] = run_id
+            else:
+                summary_kwargs["run"] = run_name
+            summary = remote_client.predict(**summary_kwargs)
+            if isinstance(summary, dict):
+                last_step = summary.get("last_step")
+                return last_step if isinstance(last_step, int) else None
+            return None
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not recover the previous step for run '{run_name}' on '{source}': {e}. Continuing from step 0."
+            )
+            return None
+    try:
+        return SQLiteStorage.get_max_step_for_run(project, run_name, run_id=run_id)
+    except Exception as e:
+        _emit_nonfatal_warning(
+            f"trackio.init() could not recover the previous step for run '{run_name}': {e}. Continuing from step 0."
+        )
+        return None
+
+
+def init(
+    project: str,
+    name: str | None = None,
+    group: str | None = None,
+    space_id: str | None = None,
+    server_url: str | None = None,
+    space_storage: SpaceStorage | None = None,
+    dataset_id: str | None = None,
+    bucket_id: str | None = None,
+    config: dict | None = None,
+    resume: str = "never",
+    settings: Any = None,
+    private: bool | None = None,
+    embed: bool = True,
+    auto_log_gpu: bool | None = None,
+    gpu_log_interval: float = 10.0,
+    auto_log_cpu: bool | None = None,
+    cpu_log_interval: float = 10.0,
+    webhook_url: str | None = None,
+    webhook_min_level: AlertLevel | str | None = None,
+) -> Run:
+    """
+    Creates a new Trackio project and returns a [`Run`] object.
+
+    Args:
+        project (`str`):
+            The name of the project (can be an existing project to continue tracking or
+            a new project to start tracking from scratch).
+        name (`str`, *optional*):
+            The name of the run (if not provided, a default name will be generated).
+        group (`str`, *optional*):
+            The name of the group which this run belongs to in order to help organize
+            related runs together. You can toggle the entire group's visibility in the
+            dashboard.
+        space_id (`str`, *optional*):
+            If provided, the project will be logged to a Hugging Face Space instead of
+            a local directory. Should be a complete Space name like
+            `"username/reponame"` or `"orgname/reponame"`, or just `"reponame"` in which
+            case the Space will be created in the currently-logged-in Hugging Face
+            user's namespace. If the Space does not exist, it will be created. If the
+            Space already exists, the project will be logged to it. Can also be set
+            via the `TRACKIO_SPACE_ID` environment variable. You cannot log to a
+            Space that has been **frozen** (converted to the static SDK); use
+            ``trackio.sync(..., sdk="static")`` only after you are done logging.
+            Takes precedence over `server_url` and `TRACKIO_SERVER_URL` when more than
+            one is set.
+        server_url (`str`, *optional*):
+            Base URL of a self-hosted Trackio server (``http://`` or ``https://``), or the
+            write-access URL from ``trackio.show()`` which may include a ``write_token`` query
+            parameter. The client sends that token on each request (``X-Trackio-Write-Token``);
+            you can also set ``TRACKIO_WRITE_TOKEN`` instead of embedding the token in the URL.
+            When set, metrics are sent to that server over HTTP instead of creating or syncing
+            to a Hugging Face Space. Can also be set via the ``TRACKIO_SERVER_URL`` environment
+            variable. Ignored when ``space_id`` or ``TRACKIO_SPACE_ID`` is set.
+        space_storage ([`~huggingface_hub.SpaceStorage`], *optional*):
+            Choice of persistent storage tier.
+        dataset_id (`str`, *optional*):
+            Deprecated: persisting trackio data to a Hugging Face Dataset will be
+            removed in a future version of trackio. Use `bucket_id` (a Hugging
+            Face Bucket) instead.
+        bucket_id (`str`, *optional*):
+            The ID of the Hugging Face Bucket to use for metric persistence. By default,
+            when a `space_id` is provided and `bucket_id` is not explicitly set, a
+            bucket is auto-generated from the space_id. Buckets provide
+            S3-like storage without git overhead - the SQLite database is stored directly
+            via `hf-mount` in the Space. Specify a Bucket with name like
+            `"username/bucketname"` or just `"bucketname"`.
+        config (`dict`, *optional*):
+            A dictionary of configuration options. Provided for compatibility with
+            `wandb.init()`.
+        resume (`str`, *optional*, defaults to `"never"`):
+            Controls how to handle resuming a run. Can be one of:
+
+            - `"must"`: Must resume the run with the given name, raises error if run
+              doesn't exist
+            - `"allow"`: Resume the run if it exists, otherwise create a new run
+            - `"never"`: Never resume a run, always create a new one
+        private (`bool`, *optional*):
+            Whether to make the Space private. If None (default), the repo will be
+            public unless the organization's default is private. This value is ignored
+            if the repo already exists.
+        settings (`Any`, *optional*):
+            Not used. Provided for compatibility with `wandb.init()`.
+        embed (`bool`, *optional*, defaults to `True`):
+            If running inside a Jupyter/Colab notebook, whether the dashboard should
+            automatically be embedded in the cell when trackio.init() is called. For
+            local runs, this launches a local Trackio dashboard and embeds it. For Space runs,
+            this embeds the Space URL. In Colab, the local dashboard will be accessible
+            via a public share URL when `share=True`.
+        auto_log_gpu (`bool` or `None`, *optional*, defaults to `None`):
+            Controls automatic GPU metrics logging. If `None` (default), GPU logging
+            is automatically enabled when `nvidia-ml-py` is installed and an NVIDIA
+            GPU or Apple M series is detected. Set to `True` to force enable or
+            `False` to disable.
+        gpu_log_interval (`float`, *optional*, defaults to `10.0`):
+            The interval in seconds between automatic GPU metric logs.
+            Only used when `auto_log_gpu=True`.
+        auto_log_cpu (`bool` or `None`, *optional*, defaults to `None`):
+            Controls automatic CPU and RAM metrics logging (utilization, memory,
+            disk I/O, network I/O, and sensors). If `None` (default), CPU logging
+            is automatically enabled when `psutil` is installed. Set to `True` to
+            force enable or `False` to disable.
+        cpu_log_interval (`float`, *optional*, defaults to `10.0`):
+            The interval in seconds between automatic CPU metric logs.
+            Only used when CPU auto-logging is enabled.
+        webhook_url (`str`, *optional*):
+            A webhook URL to POST alert payloads to when `trackio.alert()` is
+            called. Supports Slack and Discord webhook URLs natively (payloads
+            are formatted automatically). Can also be set via the
+            `TRACKIO_WEBHOOK_URL` environment variable. Individual alerts can
+            override this URL by passing `webhook_url` to `trackio.alert()`.
+        webhook_min_level (`AlertLevel` or `str`, *optional*):
+            Minimum alert level that should trigger webhook delivery.
+            For example, `AlertLevel.WARN` sends only `WARN` and `ERROR`
+            alerts to the webhook destination. Can also be set via
+            `TRACKIO_WEBHOOK_MIN_LEVEL`.
+    Returns:
+        `Run`: A [`Run`] object that can be used to log metrics and finish the run.
+    """
+    SQLiteStorage.validate_project_name(project)
+
+    if settings is not None:
+        _emit_nonfatal_warning(
+            "* Warning: settings is not used. Provided for compatibility with wandb.init(). Please create an issue at: https://github.com/gradio-app/trackio/issues if you need a specific feature implemented."
+        )
+
+    previous_run = context_vars.current_run.get()
+    if previous_run is not None:
+        try:
+            previous_run.finish()
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not finish the previous run '{previous_run.name}': {e}. Continuing with new run."
+            )
+        context_vars.current_run.set(None)
+
+    bucket_id_was_explicit = bucket_id is not None
+    space_id, server_url = utils.resolve_space_id_and_server_url(space_id, server_url)
+    if bucket_id is None and utils.on_spaces():
+        bucket_id = os.environ.get("TRACKIO_BUCKET_ID")
+    if server_url is not None and not server_url.startswith(("http://", "https://")):
+        raise ValueError(
+            f"`server_url` must be a full URL starting with http:// or https://, got: {server_url!r}"
+        )
+    server_base_url: str | None = None
+    write_token_resolved: str | None = None
+    if server_url is not None:
+        server_base_url, tok = utils.parse_trackio_server_url(server_url)
+        write_token_resolved = tok or os.environ.get("TRACKIO_WRITE_TOKEN")
+        if not write_token_resolved:
+            raise ValueError(
+                "Self-hosted logging requires a write token: add write_token to the server URL, "
+                "or set the TRACKIO_WRITE_TOKEN environment variable."
+            )
+    if server_url is not None and (dataset_id is not None or bucket_id is not None):
+        raise ValueError(
+            "`dataset_id` and `bucket_id` are Hugging Face Spaces concepts and are not "
+            "compatible with `server_url`. Configure storage on the self-hosted server."
+        )
+    if space_id is None and dataset_id is not None:
+        raise ValueError("Must provide a `space_id` when `dataset_id` is provided.")
+    if dataset_id is not None and bucket_id is not None:
+        raise ValueError("Cannot provide both `dataset_id` and `bucket_id`.")
+    try:
+        space_id, dataset_id, bucket_id = utils.preprocess_space_and_dataset_ids(
+            space_id, dataset_id, bucket_id
+        )
+        if (
+            space_id is not None
+            and dataset_id is None
+            and bucket_id is not None
+            and not bucket_id_was_explicit
+            and not utils.on_spaces()
+        ):
+            bucket_id = deploy.resolve_auto_bucket_id(space_id, bucket_id)
+    except LocalTokenNotFoundError as e:
+        raise LocalTokenNotFoundError(
+            f"You must be logged in to Hugging Face locally when `space_id` is provided to deploy to a Space. {e}"
+        ) from e
+
+    if space_id is None and bucket_id is not None:
+        _emit_nonfatal_warning(
+            "trackio.init() has `bucket_id` set but `space_id` is None: metrics will be logged "
+            "locally only. Pass `space_id` to create or use a Hugging Face Space, which will be "
+            "attached to the Hugging Face Bucket.",
+            UserWarning,
+            stacklevel=2,
+        )
+
+    if space_id is not None:
+        deploy.raise_if_space_is_frozen_for_logging(space_id)
+
+    remote_source = space_id or server_base_url
+
+    if remote_source is not None:
+        url = remote_source
+        context_vars.current_server.set(url)
+        if space_id is not None:
+            context_vars.current_space_id.set(space_id)
+            context_vars.current_server_write_token.set(None)
+        else:
+            context_vars.current_space_id.set(None)
+            context_vars.current_server_write_token.set(write_token_resolved)
+    else:
+        url = None
+        context_vars.current_server.set(None)
+        context_vars.current_space_id.set(None)
+        context_vars.current_server_write_token.set(None)
+
+    _should_embed_local = False
+
+    newly_created_space = False
+    if space_id is not None and space_id in _spaces_created_this_session:
+        if deploy.space_is_running(space_id):
+            _spaces_created_this_session.discard(space_id)
+        else:
+            newly_created_space = True
+
+    if (
+        context_vars.current_project.get() is None
+        or context_vars.current_project.get() != project
+    ):
+        print(f"* Trackio project initialized: {project}")
+
+        if bucket_id is not None:
+            if utils.on_spaces():
+                os.environ["TRACKIO_BUCKET_ID"] = bucket_id
+            bucket_url = f"https://huggingface.co/buckets/{bucket_id}"
+            print(
+                f"* Trackio metrics will be synced to Hugging Face Bucket: {bucket_url}"
+            )
+        elif dataset_id is not None:
+            if utils.on_spaces():
+                os.environ["TRACKIO_DATASET_ID"] = dataset_id
+            print(
+                f"* Trackio metrics will be synced to Hugging Face Dataset: {dataset_id}"
+            )
+        if remote_source is None:
+            print(f"* Trackio metrics logged to: {TRACKIO_DIR}")
+            _should_embed_local = embed and utils.is_in_notebook()
+            if not _should_embed_local:
+                utils.print_dashboard_instructions(project)
+        elif server_base_url is not None:
+            print(
+                f"* Trackio metrics will be sent to self-hosted server: {server_base_url}"
+            )
+            if utils.is_in_notebook() and embed:
+                utils.embed_url_in_notebook(server_base_url)
+        else:
+            try:
+                if deploy.create_space_if_not_exists(
+                    space_id,
+                    space_storage,
+                    dataset_id,
+                    bucket_id,
+                    private,
+                ):
+                    _spaces_created_this_session.add(space_id)
+                    newly_created_space = True
+                user_name, space_name = space_id.split("/")
+                space_url = deploy.SPACE_HOST_URL.format(
+                    user_name=user_name, space_name=space_name
+                )
+                if utils.is_in_notebook() and embed:
+                    utils.embed_url_in_notebook(space_url)
+            except Exception as e:
+                _emit_nonfatal_warning(
+                    f"trackio.init() could not prepare Space '{space_id}': {e}. Logging will continue in local fallback mode until the Space is reachable."
+                )
+    context_vars.current_project.set(project)
+
+    remote_client = None
+    if space_id is not None and not newly_created_space:
+        try:
+            remote_client = RemoteClient(
+                space_id,
+                hf_token=huggingface_hub.utils.get_token(),
+                verbose=False,
+            )
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not create a remote client for Space '{space_id}': {e}. Continuing with local fallback metadata lookups."
+            )
+    elif server_base_url is not None:
+        try:
+            remote_client = RemoteClient(
+                server_base_url,
+                hf_token=None,
+                write_token=write_token_resolved,
+                verbose=False,
+            )
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not create a remote client for '{server_base_url}': {e}. Continuing with local fallback metadata lookups."
+            )
+
+    _migrate_local_project_for_init(project)
+    existing_run_records = _safe_get_runs_for_init(
+        project,
+        space_id,
+        server_base_url,
+        write_token_resolved,
+        resume,
+        remote_client=remote_client,
+        check_existing_for_never=name is not None,
+    )
+    existing_runs = [
+        r["name"] if isinstance(r, dict) else r for r in existing_run_records
+    ]
+
+    existing_run = (
+        _safe_get_latest_run_for_init(
+            project,
+            name,
+            space_id=space_id,
+            server_base_url=server_base_url,
+            write_token=write_token_resolved,
+            remote_client=remote_client,
+        )
+        if name is not None
+        else None
+    )
+    resolved_run_id = None
+
+    if resume == "must":
+        if name is None:
+            raise ValueError("Must provide a run name when resume='must'")
+        if existing_run is None:
+            raise ValueError(f"Run '{name}' does not exist in project '{project}'")
+        resumed = True
+        resolved_run_id = existing_run["id"]
+    elif resume == "allow":
+        resumed = existing_run is not None
+        if resumed:
+            resolved_run_id = existing_run["id"]
+    elif resume == "never":
+        resumed = False
+    else:
+        raise ValueError("resume must be one of: 'must', 'allow', or 'never'")
+
+    initial_last_step = (
+        _safe_get_last_step_for_init(
+            project,
+            name,
+            space_id,
+            server_base_url,
+            write_token_resolved,
+            resumed,
+            run_id=resolved_run_id,
+            remote_client=remote_client,
+        )
+        if name is not None
+        else None
+    )
+
+    auto_log_cpu_detected = False
+    if auto_log_cpu is None:
+        auto_log_cpu_detected = cpu_available()
+        auto_log_cpu = auto_log_cpu_detected
+
+    auto_log_gpu_detected = False
+    nvidia_available = False
+    apple_available = False
+    if auto_log_gpu is None:
+        nvidia_available = gpu_available()
+        apple_available = apple_gpu_available()
+        auto_log_gpu_detected = nvidia_available or apple_available
+        auto_log_gpu = auto_log_gpu_detected
+
+    if project not in _projects_notified_auto_log_hw:
+        if nvidia_available:
+            print("* NVIDIA GPU detected, enabling automatic GPU metrics logging")
+        elif apple_available:
+            print(
+                "* Apple Silicon detected, enabling automatic GPU/system metrics logging"
+            )
+        if auto_log_cpu_detected:
+            print("* psutil detected, enabling automatic CPU/system metrics logging")
+        if auto_log_gpu_detected or auto_log_cpu_detected:
+            _projects_notified_auto_log_hw.add(project)
+
+    run = Run(
+        url=url,
+        project=project,
+        client=None,
+        name=name,
+        run_id=resolved_run_id,
+        group=group,
+        config=config,
+        space_id=space_id,
+        bucket_id=bucket_id,
+        server_base_url=server_base_url,
+        write_token=write_token_resolved,
+        existing_runs=existing_runs,
+        initial_last_step=initial_last_step,
+        auto_log_gpu=auto_log_gpu,
+        gpu_log_interval=gpu_log_interval,
+        auto_log_cpu=auto_log_cpu,
+        cpu_log_interval=cpu_log_interval,
+        webhook_url=webhook_url,
+        webhook_min_level=webhook_min_level,
+    )
+
+    if space_id is not None:
+        try:
+            SQLiteStorage.set_project_metadata(project, "space_id", space_id)
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not persist Space metadata for project '{project}': {e}. Logging will continue."
+            )
+        try:
+            if SQLiteStorage.has_pending_data(project):
+                run._has_local_buffer = True
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not inspect pending buffered data for project '{project}': {e}. Logging will continue."
+            )
+
+    global _atexit_registered
+    if not _atexit_registered:
+        atexit.register(_cleanup_current_run)
+        _atexit_registered = True
+
+    if resumed:
+        print(f"* Resumed existing run: {run.name}")
+    else:
+        print(f"* Created new run: {run.name}")
+
+    context_vars.current_run.set(run)
+    globals()["config"] = run.config
+
+    # NOTE: trackio.init() deliberately does NOT mutate any logbook that happens
+    # to live in the current directory. Auto-noting a dashboard cell here used to
+    # corrupt curated logbooks (e.g. injecting a stray cell / page). Cells are
+    # added explicitly via the `trackio logbook` CLI instead.
+
+    if _should_embed_local:
+        try:
+            show(project=project, open_browser=False, block_thread=False)
+        except Exception as e:
+            _emit_nonfatal_warning(
+                f"trackio.init() could not auto-launch the dashboard: {e}. Logging will continue."
+            )
+
+    return run
+
+
+def log(metrics: dict, step: int | None = None) -> None:
+    """
+    Logs metrics to the current run.
+
+    Args:
+        metrics (`dict`):
+            A dictionary of metrics to log.
+        step (`int`, *optional*):
+            The step number. If not provided, the step will be incremented
+            automatically.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.log().")
+    run.log(
+        metrics=metrics,
+        step=step,
+    )
+
+
+def log_system(metrics: dict) -> None:
+    """
+    Logs system metrics (GPU, etc.) to the current run using timestamps instead of steps.
+
+    Args:
+        metrics (`dict`):
+            A dictionary of system metrics to log.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.log_system().")
+    run.log_system(metrics=metrics)
+
+
+def log_artifact(
+    artifact_or_path: Artifact | str | Path,
+    name: str | None = None,
+    type: str | None = None,
+    aliases: list[str] | None = None,
+    overwrite: bool = False,
+) -> Artifact:
+    """
+    Logs an artifact as an output of the current run.
+
+    Args:
+        artifact_or_path (`Artifact`, `str`, or `Path`):
+            The artifact to log (must have at least one file added via
+            `add_file` or `add_dir`), or a path to a file or directory to
+            log as a new artifact.
+        name (`str`, *optional*):
+            Artifact name when logging a path. Defaults to
+            `run-<run_id>-<basename>`. Must not be passed with an `Artifact`.
+        type (`str`, *optional*):
+            Artifact type when logging a path (e.g. `"model"`, `"dataset"`).
+            Defaults to `"unspecified"`. Must not be passed with an
+            `Artifact`.
+        aliases (`list[str]`, *optional*):
+            Aliases to rotate onto the resulting version, alongside `latest`
+            (assigned automatically whenever a new version is created). Your
+            aliases rotate onto the version even when identical content is
+            de-duplicated.
+        overwrite (`bool`, *optional*):
+            If `True`, removes every other version of this artifact after the
+            new content is logged. Blobs still used by other artifacts are
+            preserved, and version numbers continue increasing. Defaults to
+            `False`.
+
+    Returns:
+        The logged `Artifact` instance, hydrated with `version`, `aliases`,
+        `size`, `manifest`, and `project` set.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.log_artifact().")
+    return run.log_artifact(
+        artifact_or_path,
+        name=name,
+        type=type,
+        aliases=aliases,
+        overwrite=overwrite,
+    )
+
+
+def use_artifact(
+    artifact_or_name: Artifact | str,
+    type: str | None = None,
+) -> Artifact:
+    """
+    Fetches an artifact and records it as an input to the current run.
+
+    Args:
+        artifact_or_name (`Artifact` or `str`):
+            An already-logged `Artifact`, or an artifact name. A bare name
+            (`"my-model"`) resolves to `:latest`; you can also pin a version
+            (`"my-model:v3"`) or resolve an alias (`"my-model:prod"`).
+        type (`str`, *optional*):
+            If given, checked against the stored artifact type, raising if it
+            does not match.
+
+    Returns:
+        The fetched `Artifact`, hydrated and ready to `download()`.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.use_artifact().")
+    return run.use_artifact(artifact_or_name, type=type)
+
+
+def log_gpu(run: Run | None = None, device: int | None = None) -> dict:
+    """
+    Log GPU metrics to the current or specified run as system metrics.
+    Automatically detects whether an NVIDIA or Apple GPU is available and calls
+    the appropriate logging method.
+
+    Args:
+        run: Optional Run instance. If None, uses current run from context.
+        device: CUDA device index to collect metrics from (NVIDIA GPUs only).
+                If None, collects from all GPUs visible to this process.
+                This parameter is ignored for Apple GPUs.
+
+    Returns:
+        dict: The GPU metrics that were logged.
+
+    Example:
+        ```python
+        import trackio
+
+        run = trackio.init(project="my-project")
+        trackio.log({"loss": 0.5})
+        trackio.log_gpu()
+        trackio.log_gpu(device=0)
+        ```
+    """
+    if run is None:
+        run = context_vars.current_run.get()
+        if run is None:
+            raise RuntimeError("Call trackio.init() before trackio.log_gpu().")
+
+    if gpu_available():
+        return _log_nvidia_gpu(run=run, device=device)
+    elif apple_gpu_available():
+        return _log_apple_gpu(run=run)
+    else:
+        _emit_nonfatal_warning(
+            "No GPU detected. Install nvidia-ml-py for NVIDIA GPU support "
+            "or psutil for Apple Silicon support."
+        )
+        return {}
+
+
+def log_cpu(run: Run | None = None) -> dict:
+    """
+    Log CPU, RAM, disk, network, and sensor metrics to the current or specified run
+    as system metrics.
+
+    Args:
+        run: Optional Run instance. If None, uses current run from context.
+
+    Returns:
+        dict: The CPU and system metrics that were logged.
+
+    Example:
+        ```python
+        import trackio
+
+        run = trackio.init(project="my-project")
+        trackio.log({"loss": 0.5})
+        trackio.log_cpu()
+        ```
+    """
+    if run is None:
+        run = context_vars.current_run.get()
+        if run is None:
+            raise RuntimeError("Call trackio.init() before trackio.log_cpu().")
+
+    return _log_cpu(run=run)
+
+
+def finish():
+    """
+    Finishes the current run.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.finish().")
+    try:
+        run.finish()
+    finally:
+        context_vars.current_run.set(None)
+
+
+def alert(
+    title: str,
+    text: str | None = None,
+    level: AlertLevel = AlertLevel.WARN,
+    webhook_url: str | None = None,
+) -> None:
+    """
+    Fires an alert immediately on the current run. The alert is printed to the
+    terminal, stored in the database, and displayed in the dashboard. If a
+    webhook URL is configured (via `trackio.init()`, the `TRACKIO_WEBHOOK_URL`
+    environment variable, or the `webhook_url` parameter here), the alert is
+    also POSTed to that URL.
+
+    Args:
+        title (`str`):
+            A short title for the alert.
+        text (`str`, *optional*):
+            A longer description with details about the alert.
+        level (`AlertLevel`, *optional*, defaults to `AlertLevel.WARN`):
+            The severity level. One of `AlertLevel.INFO`, `AlertLevel.WARN`,
+            or `AlertLevel.ERROR`.
+        webhook_url (`str`, *optional*):
+            A webhook URL to send this specific alert to. Overrides any
+            URL set in `trackio.init()` or the `TRACKIO_WEBHOOK_URL`
+            environment variable. Supports Slack and Discord webhook
+            URLs natively.
+    """
+    run = context_vars.current_run.get()
+    if run is None:
+        raise RuntimeError("Call trackio.init() before trackio.alert().")
+    run.alert(title=title, text=text, level=level, webhook_url=webhook_url)
+
+
+def delete_project(project: str, force: bool = False) -> bool:
+    """
+    Deletes a project by removing its local SQLite database.
+
+    Args:
+        project (`str`):
+            The name of the project to delete.
+        force (`bool`, *optional*, defaults to `False`):
+            If `True`, deletes the project without prompting for confirmation.
+            If `False`, prompts the user to confirm before deleting.
+
+    Returns:
+        `bool`: `True` if the project was deleted, `False` otherwise.
+    """
+    db_path = SQLiteStorage.get_project_db_path(project)
+
+    if not db_path.exists():
+        print(f"* Project '{project}' does not exist.")
+        return False
+
+    if not force:
+        response = input(
+            f"Are you sure you want to delete project '{project}'? "
+            f"This will permanently delete all runs and metrics. (y/N): "
+        )
+        if response.lower() not in ["y", "yes"]:
+            print("* Deletion cancelled.")
+            return False
+
+    try:
+        db_path.unlink()
+
+        for suffix in ("-wal", "-shm"):
+            sidecar = Path(str(db_path) + suffix)
+            if sidecar.exists():
+                sidecar.unlink()
+
+        for parquet_path in SQLiteStorage._project_parquet_paths(db_path):
+            if parquet_path.exists():
+                parquet_path.unlink()
+
+        for asset_dir in (
+            utils.project_artifacts_dir(project),
+            utils.project_media_dir(project),
+        ):
+            if asset_dir.exists():
+                shutil.rmtree(asset_dir, ignore_errors=True)
+
+        print(f"* Project '{project}' has been deleted.")
+        return True
+    except Exception as e:
+        print(f"* Error deleting project '{project}': {e}")
+        return False
+
+
+def save(
+    glob_str: str | Path,
+    project: str | None = None,
+) -> str:
+    """
+    Saves files to a project (not linked to a specific run). If Trackio is running
+    locally, the file(s) will be copied to the project's files directory. If Trackio is
+    running in a Space, the file(s) will be uploaded to the Space's files directory.
+
+    Args:
+        glob_str (`str` or `Path`):
+            The file path or glob pattern to save. Can be a single file or a pattern
+            matching multiple files (e.g., `"*.py"`, `"models/**/*.pth"`).
+        project (`str`, *optional*):
+            The name of the project to save files to. If not provided, uses the current
+            project from `trackio.init()`. If no project is initialized, raises an
+            error.
+
+    Returns:
+        `str`: The path where the file(s) were saved (project's files directory).
+
+    Example:
+        ```python
+        import trackio
+
+        trackio.init(project="my-project")
+        trackio.save("config.yaml")
+        trackio.save("models/*.pth")
+        ```
+    """
+    if project is None:
+        project = context_vars.current_project.get()
+        if project is None:
+            raise RuntimeError(
+                "No project specified. Either call trackio.init() first or provide a "
+                "project parameter to trackio.save()."
+            )
+
+    glob_str = Path(glob_str)
+    base_path = Path.cwd().resolve()
+
+    matched_files = []
+    if glob_str.is_file():
+        matched_files = [glob_str.resolve()]
+    else:
+        pattern = str(glob_str)
+        if not glob_str.is_absolute():
+            pattern = str((Path.cwd() / glob_str).resolve())
+        matched_files = [
+            Path(f).resolve()
+            for f in glob.glob(pattern, recursive=True)
+            if Path(f).is_file()
+        ]
+
+    if not matched_files:
+        raise ValueError(f"No files found matching pattern: {glob_str}")
+
+    current_run = context_vars.current_run.get()
+    is_local = (
+        current_run._is_local
+        if current_run is not None
+        else (
+            context_vars.current_space_id.get() is None
+            and context_vars.current_server.get() is None
+        )
+    )
+
+    if is_local:
+        for file_path in matched_files:
+            try:
+                relative_to_base = file_path.relative_to(base_path)
+            except ValueError:
+                relative_to_base = Path(file_path.name)
+
+            if current_run is not None:
+                current_run._queue_upload(
+                    file_path,
+                    step=None,
+                    relative_path=str(relative_to_base.parent),
+                    use_run_name=False,
+                )
+            else:
+                media_path = get_project_media_path(
+                    project=project,
+                    run=None,
+                    step=None,
+                    relative_path=str(relative_to_base),
+                )
+                shutil.copy(str(file_path), str(media_path))
+    else:
+        url = context_vars.current_server.get()
+
+        upload_entries = []
+        for file_path in matched_files:
+            try:
+                relative_to_base = file_path.relative_to(base_path)
+            except ValueError:
+                relative_to_base = Path(file_path.name)
+
+            if current_run is not None:
+                current_run._queue_upload(
+                    file_path,
+                    step=None,
+                    relative_path=str(relative_to_base.parent),
+                    use_run_name=False,
+                )
+            else:
+                upload_entry: UploadEntry = {
+                    "project": project,
+                    "run": None,
+                    "step": None,
+                    "relative_path": str(relative_to_base),
+                    "uploaded_file": handle_file(file_path),
+                }
+                upload_entries.append(upload_entry)
+
+        if upload_entries:
+            if url is None:
+                raise RuntimeError(
+                    "No server available. Call trackio.init() before trackio.save() to start the server."
+                )
+
+            try:
+                wt = context_vars.current_server_write_token.get()
+                if wt is not None:
+                    client = RemoteClient(
+                        url,
+                        hf_token=None,
+                        write_token=wt,
+                        httpx_kwargs={"timeout": 90},
+                    )
+                else:
+                    client = RemoteClient(
+                        url,
+                        hf_token=huggingface_hub.utils.get_token(),
+                        httpx_kwargs={"timeout": 90},
+                    )
+                client.predict(
+                    api_name="/bulk_upload_media",
+                    uploads=upload_entries,
+                    hf_token=huggingface_hub.utils.get_token() if wt is None else None,
+                )
+            except Exception as e:
+                _emit_nonfatal_warning(
+                    f"Failed to upload files: {e}. "
+                    "Files may not be available in the dashboard."
+                )
+
+    return str(utils.project_media_dir(project) / "files")
+
+
+def show(
+    project: str | None = None,
+    *,
+    dashboard: str | None = None,
+    theme: Any = None,
+    mcp_server: bool | None = None,
+    footer: bool = True,
+    color_palette: list[str] | None = None,
+    open_browser: bool = True,
+    block_thread: bool | None = None,
+    host: str | None = None,
+    share: bool | None = None,
+    server_port: int | None = None,
+    frontend_dir: str | Path | None = None,
+):
+    """
+    Launches the Trackio dashboard.
+
+    Args:
+        project (`str`, *optional*):
+            The name of the project whose runs to show. If not provided, all projects
+            will be shown and the user can select one.
+        dashboard (`str`, *optional*):
+            Set to `"registry"` to show the standalone registry dashboard. The
+            default is the project dashboard.
+        theme (`Any`, *optional*):
+            Ignored. Kept for backward compatibility; Trackio no longer uses Gradio themes.
+        mcp_server (`bool`, *optional*):
+            If `True`, the dashboard exposes an MCP server at `/mcp` when the optional
+            `trackio[mcp]` dependency is installed. If `None` (default), the
+            `GRADIO_MCP_SERVER` environment variable is used (e.g. on Spaces).
+        footer (`bool`, *optional*, defaults to `True`):
+            Whether to include `footer=false` in the write-token URL when `False`.
+            This can also be controlled via the `footer` query parameter in the URL.
+        color_palette (`list[str]`, *optional*):
+            A list of hex color codes to use for plot lines. If not provided, the
+            `TRACKIO_COLOR_PALETTE` environment variable will be used (comma-separated
+            hex codes), or if that is not set, the default color palette will be used.
+            Example: `['#FF0000', '#00FF00', '#0000FF']`
+        open_browser (`bool`, *optional*, defaults to `True`):
+            If `True` and not in a notebook, a new browser tab will be opened with the
+            dashboard. If `False`, the browser will not be opened.
+        block_thread (`bool`, *optional*):
+            If `True`, the main thread will be blocked until the dashboard is closed.
+            If `None` (default behavior), then the main thread will not be blocked if the
+            dashboard is launched in a notebook, otherwise the main thread will be blocked.
+        host (`str`, *optional*):
+            The host to bind the server to. If not provided, defaults to `'127.0.0.1'`
+            (localhost only). Set to `'0.0.0.0'` to allow remote access.
+        share (`bool`, *optional*):
+            If `True`, creates a temporary public URL (Gradio-compatible tunnel). On Colab
+            or hosted notebooks, defaults to `True` unless overridden.
+        server_port (`int`, *optional*):
+            Port to bind. If not set, scans from `GRADIO_SERVER_PORT` (default 7860).
+        frontend_dir (`str | Path`, *optional*):
+            Directory containing a custom static frontend. Must contain `index.html`.
+            If not provided, Trackio checks `TRACKIO_FRONTEND_DIR`, then the persistent
+            Trackio config, then the bundled frontend. If an explicit `frontend_dir`
+            points to a missing or empty directory, Trackio copies in the starter
+            template and serves that directory.
+
+        Returns:
+            `app`: The dashboard handle (`.close()` stops the server).
+            `url`: The local URL of the dashboard.
+            `share_url`: The public share URL, if any.
+            `full_url`: The full URL including the write token (share URL when sharing, else local).
+    """
+    if dashboard not in (None, "registry"):
+        raise ValueError("dashboard must be None or 'registry'.")
+    if dashboard == "registry" and project is not None:
+        raise ValueError("The registry dashboard does not accept a project.")
+
+    if theme is not None and theme != "default":
+        warnings.warn(
+            "The theme argument is ignored; Trackio no longer depends on Gradio themes.",
+            UserWarning,
+            stacklevel=2,
+        )
+
+    if color_palette is not None:
+        os.environ["TRACKIO_COLOR_PALETTE"] = ",".join(color_palette)
+
+    _mcp_server = (
+        mcp_server
+        if mcp_server is not None
+        else os.environ.get("GRADIO_MCP_SERVER", "False") == "True"
+    )
+
+    resolved_frontend = resolve_frontend_dir(frontend_dir, announce=True)
+    starlette_app, wt = build_starlette_app_only(
+        mcp_server=_mcp_server,
+        frontend_dir=str(resolved_frontend.path),
+    )
+    local_url, share_url, _local_api_url, uv_server = launch_trackio_dashboard(
+        starlette_app,
+        server_name=host,
+        server_port=server_port,
+        share=share,
+        mcp_server=_mcp_server,
+        quiet=True,
+    )
+    server = TrackioDashboardApp(starlette_app, uv_server, wt)
+
+    base_root = (share_url or local_url).rstrip("/")
+    base_url = base_root + "/"
+    dashboard_url = base_url if dashboard is None else f"{base_root}/registry"
+    if dashboard is None and project:
+        dashboard_url += f"?project={project}"
+    full_url_base = base_root if dashboard is None else f"{base_root}/registry"
+    full_url = utils.get_full_url(
+        full_url_base,
+        project=project,
+        write_token=wt,
+        footer=footer,
+    )
+
+    if not utils.is_in_notebook():
+        label = "Trackio registry UI" if dashboard == "registry" else "Trackio UI"
+        print(f"\033[1m\033[38;5;208m* {label} launched at: {dashboard_url}\033[0m")
+        utils.print_write_token_instructions(full_url)
+        if open_browser:
+            webbrowser.open(full_url)
+        block_thread = block_thread if block_thread is not None else True
+    else:
+        utils.embed_url_in_notebook(full_url)
+        block_thread = block_thread if block_thread is not None else False
+
+    if block_thread:
+        utils.block_main_thread_until_keyboard_interrupt()
+    return _TupleNoPrint((server, local_url, share_url, full_url))

trackio/_unsupported.py

@@ -0,0 +1,48 @@
+"""Placeholders for W&B feature classes that Trackio does not yet implement."""
+
+from typing import Any
+
+
+class _UnsupportedFeature:
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        raise NotImplementedError(
+            f"trackio.{type(self).__name__} is not implemented yet. "
+            "If you need this feature, please open a GitHub issue in the Trackio "
+            "repository: https://github.com/gradio-app/trackio/issues/new"
+        )
+
+
+class ArtifactTTL(_UnsupportedFeature):
+    """Placeholder for artifact time-to-live policies."""
+
+
+class Classes(_UnsupportedFeature):
+    """Placeholder for class labels used in media annotations."""
+
+
+class Config(_UnsupportedFeature):
+    """Placeholder for the W&B configuration container."""
+
+
+class EvalTable(_UnsupportedFeature):
+    """Placeholder for evaluation tables."""
+
+
+class Graph(_UnsupportedFeature):
+    """Placeholder for model graphs."""
+
+
+class JoinedTable(_UnsupportedFeature):
+    """Placeholder for joining tables by a shared key."""
+
+
+class Molecule(_UnsupportedFeature):
+    """Placeholder for molecular structure visualizations."""
+
+
+class Plotly(_UnsupportedFeature):
+    """Placeholder for Plotly visualizations."""
+
+
+class Settings(_UnsupportedFeature):
+    """Placeholder for W&B SDK settings."""

trackio/_vendor/gradio_exceptions.py

@@ -0,0 +1,6 @@
+class ChecksumMismatchError(Exception):
+    pass
+
+
+class ShareCertificateWriteError(Exception):
+    pass

trackio/_vendor/networking.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import os
+import time
+import warnings
+from pathlib import Path
+from urllib.parse import urlparse, urlunparse
+
+import httpx
+
+from trackio._vendor.gradio_exceptions import ShareCertificateWriteError
+from trackio._vendor.tunneling import CERTIFICATE_PATH, Tunnel
+
+GRADIO_API_SERVER = "https://api.gradio.app/v3/tunnel-request"
+GRADIO_SHARE_SERVER_ADDRESS = os.getenv("GRADIO_SHARE_SERVER_ADDRESS")
+
+
+def setup_tunnel(
+    local_host: str,
+    local_port: int,
+    share_token: str,
+    share_server_address: str | None,
+    share_server_tls_certificate: str | None,
+) -> str:
+    share_server_address = (
+        GRADIO_SHARE_SERVER_ADDRESS
+        if share_server_address is None
+        else share_server_address
+    )
+    if share_server_address is None:
+        try:
+            response = httpx.get(GRADIO_API_SERVER, timeout=30)
+            payload = response.json()[0]
+            remote_host, remote_port = payload["host"], int(payload["port"])
+            certificate = payload["root_ca"]
+        except Exception as e:
+            raise RuntimeError(
+                "Could not get share link from Gradio API Server."
+            ) from e
+        try:
+            Path(CERTIFICATE_PATH).parent.mkdir(parents=True, exist_ok=True)
+            with open(CERTIFICATE_PATH, "w") as f:
+                f.write(certificate)
+        except Exception as e:
+            raise ShareCertificateWriteError(
+                f"{e}. This can happen if the current working directory is read-only."
+            ) from e
+        share_server_tls_certificate = CERTIFICATE_PATH
+
+    else:
+        remote_host, remote_port = share_server_address.split(":")
+        remote_port = int(remote_port)
+    tunnel = Tunnel(
+        remote_host,
+        remote_port,
+        local_host,
+        local_port,
+        share_token,
+        share_server_tls_certificate,
+    )
+    address = tunnel.start_tunnel()
+    return address
+
+
+def url_ok(url: str) -> bool:
+    try:
+        for _ in range(5):
+            with warnings.catch_warnings():
+                warnings.filterwarnings("ignore")
+                r = httpx.head(url, timeout=3, verify=False)
+            if r.status_code in (200, 401, 302, 303, 307):
+                return True
+            time.sleep(0.500)
+    except (ConnectionError, httpx.ConnectError, httpx.TimeoutException):
+        return False
+    return False
+
+
+def normalize_share_url(share_url: str, share_server_protocol: str) -> str:
+    parsed_url = urlparse(share_url)
+    return urlunparse((share_server_protocol,) + parsed_url[1:])

trackio/_vendor/tunneling.py

@@ -0,0 +1,191 @@
+import atexit
+import hashlib
+import os
+import platform
+import re
+import stat
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+import httpx
+from huggingface_hub.constants import HF_HOME
+
+from trackio._vendor.gradio_exceptions import ChecksumMismatchError
+
+VERSION = "0.3"
+CURRENT_TUNNELS: list["Tunnel"] = []
+
+machine = platform.machine()
+if machine == "x86_64":
+    machine = "amd64"
+elif machine == "aarch64":
+    machine = "arm64"
+
+BINARY_REMOTE_NAME = f"frpc_{platform.system().lower()}_{machine.lower()}"
+EXTENSION = ".exe" if os.name == "nt" else ""
+BINARY_URL = f"https://cdn-media.huggingface.co/frpc-gradio-{VERSION}/{BINARY_REMOTE_NAME}{EXTENSION}"
+
+CHECKSUMS = {
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_windows_amd64.exe": "14bc0ea470be5d67d79a07412bd21de8a0a179c6ac1116d7764f68e942dc9ceb",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_amd64": "c791d1f047b41ff5885772fc4bf20b797c6059bbd82abb9e31de15e55d6a57c4",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_arm64": "823ced25104de6dc3c9f4798dbb43f20e681207279e6ab89c40e2176ccbf70cd",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_darwin_amd64": "930f8face3365810ce16689da81b7d1941fda4466225a7bbcbced9a2916a6e15",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_darwin_arm64": "dfac50c690aca459ed5158fad8bfbe99f9282baf4166cf7c410a6673fbc1f327",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_arm": "4b563beb2e36c448cc688174e20b53af38dc1ff2b5e362d4ddd1401f2affbfb7",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_freebsd_386": "cb0a56c764ecf96dd54ed601d240c564f060ee4e58202d65ffca17c1a51ce19c",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_freebsd_amd64": "516d9e6903513869a011ddcd1ec206167ad1eb5dd6640d21057acc258edecbbb",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_386": "4c2f2a48cd71571498c0ac8a4d42a055f22cb7f14b4b5a2b0d584220fd60a283",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_mips": "b309ecd594d4f0f7f33e556a80d4b67aef9319c00a8334648a618e56b23cb9e0",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_mips64": "0372ef5505baa6f3b64c6295a86541b24b7b0dbe4ef28b344992e21f47624b7b",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_riscv64": "1658eed7e8c14ea76e1d95749d58441ce24147c3d559381832c725c29cfc3df3",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_mipsle": "a2aaba16961d3372b79bd7a28976fcd0f0bbaebc2b50d5a7a71af2240747960f",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_windows_386.exe": "721b90550195a83e15f2176d8f85a48d5a25822757cb872e9723d4bccc4e5bb6",
+    "https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_linux_mips64le": "796481edd609f31962b45cc0ab4c9798d040205ae3bf354ed1b72fb432d796b8",
+}
+
+CHUNK_SIZE = 128
+
+BINARY_FILENAME = f"{BINARY_REMOTE_NAME}_v{VERSION}"
+BINARY_FOLDER = Path(HF_HOME) / "trackio" / "frpc"
+BINARY_PATH = str(BINARY_FOLDER / BINARY_FILENAME)
+
+TUNNEL_TIMEOUT_SECONDS = 30
+TUNNEL_ERROR_MESSAGE = (
+    "Could not create share URL. "
+    "Please check the appended log from frpc for more information:"
+)
+
+CERTIFICATE_PATH = ".trackio/certificate.pem"
+
+
+class Tunnel:
+    def __init__(
+        self,
+        remote_host: str,
+        remote_port: int,
+        local_host: str,
+        local_port: int,
+        share_token: str,
+        share_server_tls_certificate: str | None,
+    ):
+        self.proc = None
+        self.url = None
+        self.remote_host = remote_host
+        self.remote_port = remote_port
+        self.local_host = local_host
+        self.local_port = local_port
+        self.share_token = share_token
+        self.share_server_tls_certificate = share_server_tls_certificate
+
+    @staticmethod
+    def download_binary():
+        if not Path(BINARY_PATH).exists():
+            Path(BINARY_FOLDER).mkdir(parents=True, exist_ok=True)
+            resp = httpx.get(BINARY_URL, timeout=30)
+
+            if resp.status_code == 403:
+                raise OSError(
+                    f"Cannot set up a share link as this platform is incompatible. Please "
+                    f"create a GitHub issue with information about your platform: {platform.uname()}"
+                )
+
+            resp.raise_for_status()
+
+            with open(BINARY_PATH, "wb") as file:
+                file.write(resp.content)
+            st = os.stat(BINARY_PATH)
+            os.chmod(BINARY_PATH, st.st_mode | stat.S_IEXEC)
+
+            if BINARY_URL in CHECKSUMS:
+                sha = hashlib.sha256()
+                with open(BINARY_PATH, "rb") as f:
+                    for chunk in iter(lambda: f.read(CHUNK_SIZE * sha.block_size), b""):
+                        sha.update(chunk)
+                calculated_hash = sha.hexdigest()
+
+                if calculated_hash != CHECKSUMS[BINARY_URL]:
+                    raise ChecksumMismatchError()
+
+    def start_tunnel(self) -> str:
+        self.download_binary()
+        self.url = self._start_tunnel(BINARY_PATH)
+        return self.url
+
+    def kill(self):
+        if self.proc is not None:
+            print(f"Killing tunnel {self.local_host}:{self.local_port} <> {self.url}")
+            self.proc.terminate()
+            self.proc = None
+
+    def _start_tunnel(self, binary: str) -> str:
+        CURRENT_TUNNELS.append(self)
+        command = [
+            binary,
+            "http",
+            "-n",
+            self.share_token,
+            "-l",
+            str(self.local_port),
+            "-i",
+            self.local_host,
+            "--uc",
+            "--sd",
+            "random",
+            "--ue",
+            "--server_addr",
+            f"{self.remote_host}:{self.remote_port}",
+            "--disable_log_color",
+        ]
+        if self.share_server_tls_certificate is not None:
+            command.extend(
+                [
+                    "--tls_enable",
+                    "--tls_trusted_ca_file",
+                    self.share_server_tls_certificate,
+                ]
+            )
+        self.proc = subprocess.Popen(
+            command, stdout=subprocess.PIPE, stderr=subprocess.PIPE
+        )
+        atexit.register(self.kill)
+        return self._read_url_from_tunnel_stream()
+
+    def _read_url_from_tunnel_stream(self) -> str:
+        start_timestamp = time.time()
+
+        log = []
+        url = ""
+
+        def _raise_tunnel_error():
+            log_text = "\n".join(log)
+            print(log_text, file=sys.stderr)
+            raise ValueError(f"{TUNNEL_ERROR_MESSAGE}\n{log_text}")
+
+        while url == "":
+            if time.time() - start_timestamp >= TUNNEL_TIMEOUT_SECONDS:
+                _raise_tunnel_error()
+
+            assert self.proc is not None  # noqa: S101
+            if self.proc.stdout is None:
+                continue
+
+            line = self.proc.stdout.readline()
+            line = line.decode("utf-8")
+
+            if line == "":
+                continue
+
+            log.append(line.strip())
+
+            if "start proxy success" in line:
+                result = re.search("start proxy success: (.+)\n", line)
+                if result is None:
+                    _raise_tunnel_error()
+                else:
+                    url = result.group(1)
+            elif "login to server failed" in line:
+                _raise_tunnel_error()
+
+        return url

trackio/agent_sessions.py

@@ -0,0 +1,533 @@
+"""Agent session serialization for the Hugging Face Hub's trace viewer.
+
+The Hub renders `.jsonl` agent sessions in a dedicated trace viewer, for both
+Datasets and Storage Buckets. This module is the single place Trackio produces
+that format: the logbook's attached agent sessions and the `traces` table both
+serialize through it.
+
+Trackio emits **Pi's session format** (version 3), which the Hub supports
+natively. The Hub also documents a Session Trace Simple Format (STS), but as of
+this writing files written to that spec are not rendered by the viewer — a
+controlled test (same bucket, same folder, one variable) showed a Codex-native
+and a Pi-format session rendering while a spec-compliant STS session displayed
+as raw JSONL, and none of the public datasets tagged `format:agent-traces` use
+STS. Pi's format is also the better fit: `id`/`parentId`, token `usage`, `cost`,
+and `isError` all have native homes, where STS had none.
+
+A session file is a header line followed by one entry per line:
+
+    {"type":"session","version":3,"id":"...","timestamp":"...","cwd":"..."}
+    {"type":"message","id":"...","parentId":null,"timestamp":"...",
+     "message":{"role":"user","content":[{"type":"text","text":"..."}]}}
+
+Entries chain through `parentId`. Message content is a list of typed blocks
+(`text`, `thinking`, `toolCall`); tool results are their own message with
+`role: "toolResult"`, a `toolCallId`, a `toolName`, and an optional `isError`.
+
+Format reference:
+https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/session-format.md
+"""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import uuid
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+HARNESS = "trackio"
+SESSION_VERSION = 3
+SESSION_NAME_MAX_CHARS = 120
+
+# Formats the Hub renders without conversion.
+HUB_NATIVE_PROVIDERS = {"Codex", "Claude Code", "Pi"}
+
+# Pi roles. Trackio's OpenAI-style `system` maps onto `developer`, which is what
+# the sessions that render in the viewer use.
+ROLE_BY_OPENAI_ROLE = {
+    "system": "developer",
+    "developer": "developer",
+    "user": "user",
+    "assistant": "assistant",
+}
+
+_NUMERIC_RE = re.compile(r"\d+(?:\.\d+)?")
+_UNSAFE_ID_RE = re.compile(r"[^a-zA-Z0-9._-]+")
+
+
+def parse_time(value: str | int | float | None) -> datetime | None:
+    """Parse an ISO-8601 string or an epoch number (seconds or milliseconds)."""
+    if value in (None, ""):
+        return None
+    if isinstance(value, (int, float)) or (
+        isinstance(value, str) and _NUMERIC_RE.fullmatch(value)
+    ):
+        numeric = float(value)
+        if numeric > 10_000_000_000:
+            numeric /= 1000
+        try:
+            return datetime.fromtimestamp(numeric, tz=timezone.utc)
+        except (OverflowError, OSError, ValueError):
+            return None
+    try:
+        return datetime.fromisoformat(str(value).replace("Z", "+00:00"))
+    except ValueError:
+        return None
+
+
+def iso_z(value: str | int | float | None) -> str | None:
+    """An ISO-8601 UTC timestamp with the `Z` suffix Pi sessions use."""
+    parsed = parse_time(value)
+    if parsed is None:
+        return None
+    if parsed.tzinfo is None:
+        parsed = parsed.replace(tzinfo=timezone.utc)
+    return (
+        parsed.astimezone(timezone.utc)
+        .isoformat(timespec="milliseconds")
+        .replace("+00:00", "Z")
+    )
+
+
+def entry_id(*parts: Any) -> str:
+    """A stable 8-character entry id, matching the width Pi sessions use."""
+    seed = ":".join(str(part) for part in parts)
+    return hashlib.sha1(seed.encode("utf-8")).hexdigest()[:8]
+
+
+def safe_id(value: str) -> str:
+    """A filesystem- and bucket-safe form of an identifier."""
+    cleaned = _UNSAFE_ID_RE.sub("-", str(value)).strip("-.")
+    return cleaned[:100] or f"session-{uuid.uuid4().hex[:12]}"
+
+
+def is_hub_native_jsonl(path: Path, provider: str | None = None) -> bool:
+    """Whether the Hub's trace viewer renders this file without conversion.
+
+    Only the harness-native formats qualify. A session header carrying a
+    `harness` but no `version` is STS, which the viewer does not render, so it
+    still needs converting.
+    """
+    if path.suffix.lower() != ".jsonl":
+        return False
+    if provider in HUB_NATIVE_PROVIDERS:
+        return True
+    try:
+        with path.open(encoding="utf-8") as handle:
+            first_line = next((line for line in handle if line.strip()), "")
+        header = json.loads(first_line)
+    except (OSError, json.JSONDecodeError):
+        return False
+    if not isinstance(header, dict):
+        return False
+    if header.get("type") == "session" and header.get("version") is not None:
+        return True
+    # Codex sessions open with a `session_meta` envelope rather than `session`.
+    return header.get("type") == "session_meta" and isinstance(
+        header.get("payload"), dict
+    )
+
+
+def session_header(
+    session_id: str,
+    timestamp: str | None = None,
+    name: str | None = None,
+    cwd: str | None = None,
+    **extra: Any,
+) -> dict[str, Any]:
+    header: dict[str, Any] = {
+        "type": "session",
+        "version": SESSION_VERSION,
+        "id": str(session_id),
+        "timestamp": iso_z(timestamp) or iso_z(datetime.now(timezone.utc)),
+        "cwd": cwd or "/",
+        "harness": HARNESS,
+    }
+    if name:
+        header["name"] = name
+    header.update({key: value for key, value in extra.items() if value is not None})
+    return header
+
+
+def dumps(records: list[dict[str, Any]]) -> str:
+    return (
+        "\n".join(json.dumps(record, ensure_ascii=False) for record in records) + "\n"
+    )
+
+
+def write_session(path: Path, records: list[dict[str, Any]]) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(dumps(records), encoding="utf-8")
+
+
+def content_text(value: Any) -> str:
+    """Flatten an OpenAI-style `content` value to text.
+
+    Content may be a plain string, a list of typed blocks, or a serialized
+    Trackio media object. Non-text blocks keep a readable placeholder rather
+    than being dropped, so the viewer shows that something was there.
+    """
+    if value is None:
+        return ""
+    if isinstance(value, str):
+        return value
+    if isinstance(value, list):
+        parts = [content_text(item) for item in value]
+        return "\n".join(part for part in parts if part)
+    if isinstance(value, dict):
+        media_type = value.get("_type")
+        if isinstance(media_type, str) and media_type.startswith("trackio."):
+            label = media_type.split(".", 1)[1]
+            caption = value.get("caption") or value.get("file_path") or ""
+            return f"[{label}{': ' + str(caption) if caption else ''}]"
+        for key in ("text", "content", "output", "value"):
+            if isinstance(value.get(key), str):
+                return value[key]
+        return json.dumps(value, ensure_ascii=False)
+    return str(value)
+
+
+def text_block(text: str) -> dict[str, Any]:
+    return {"type": "text", "text": text}
+
+
+def thinking_block(text: str) -> dict[str, Any]:
+    return {"type": "thinking", "thinking": text}
+
+
+def tool_call_block(call_id: str, name: str, arguments: Any) -> dict[str, Any]:
+    """A `toolCall` block. Unlike STS, `arguments` stays a real object."""
+    if isinstance(arguments, str):
+        try:
+            arguments = json.loads(arguments)
+        except json.JSONDecodeError:
+            arguments = {"input": arguments}
+    if not isinstance(arguments, dict):
+        arguments = {} if arguments is None else {"input": arguments}
+    return {
+        "type": "toolCall",
+        "id": str(call_id),
+        "name": str(name or "tool"),
+        "arguments": arguments,
+    }
+
+
+class _Chain:
+    """Accumulates entries, chaining each to the one before via `parentId`."""
+
+    def __init__(self, session_id: str, default_timestamp: str | None):
+        self.session_id = session_id
+        self.default_timestamp = default_timestamp
+        self.records: list[dict[str, Any]] = []
+        self._parent: str | None = None
+
+    def add(self, entry: dict[str, Any], timestamp: str | None = None) -> str:
+        entry["parentId"] = self._parent
+        entry["timestamp"] = iso_z(timestamp) or self.default_timestamp
+        self._parent = entry["id"]
+        self.records.append(entry)
+        return entry["id"]
+
+    def message(
+        self, index: Any, message: dict[str, Any], timestamp: str | None = None
+    ) -> str:
+        return self.add(
+            {
+                "type": "message",
+                "id": entry_id(self.session_id, "msg", index),
+                "message": message,
+            },
+            timestamp,
+        )
+
+
+def span_usage(span: dict[str, Any]) -> dict[str, Any] | None:
+    """Pi's `usage` block from a Trackio span's `usage` and `cost_usd`."""
+    usage = span.get("usage") or {}
+    raw_input = usage.get("input_tokens", usage.get("prompt_tokens"))
+    raw_output = usage.get("output_tokens", usage.get("completion_tokens"))
+    cost = span.get("cost_usd")
+    if raw_input is None and raw_output is None and cost is None:
+        return None
+    try:
+        input_tokens = int(raw_input or 0)
+        output_tokens = int(raw_output or 0)
+    except (TypeError, ValueError):
+        input_tokens = output_tokens = 0
+    total = usage.get("total_tokens") or (input_tokens + output_tokens)
+    block: dict[str, Any] = {
+        "input": input_tokens,
+        "output": output_tokens,
+        "cacheRead": int(usage.get("cache_read_input_tokens") or 0),
+        "cacheWrite": int(usage.get("cache_creation_input_tokens") or 0),
+        "totalTokens": total,
+    }
+    if cost is not None:
+        try:
+            block["cost"] = {
+                "input": 0,
+                "output": 0,
+                "cacheRead": 0,
+                "cacheWrite": 0,
+                "total": float(cost),
+            }
+        except (TypeError, ValueError):
+            pass
+    return block
+
+
+def _span_is_error(span: dict[str, Any]) -> bool:
+    status = str(span.get("status") or "").lower()
+    return status in {"error", "failed"} or bool(span.get("error"))
+
+
+def _message_is_error(message: dict[str, Any]) -> bool:
+    if message.get("is_error") is True or message.get("isError") is True:
+        return True
+    if message.get("error"):
+        return True
+    return str(message.get("status") or "").lower() in {"error", "failed"}
+
+
+def _generation_output_text(span: dict[str, Any]) -> str:
+    output = span.get("output")
+    if isinstance(output, dict):
+        for key in ("text", "content", "message", "output"):
+            if output.get(key) is not None:
+                return content_text(output[key])
+    return content_text(output)
+
+
+def _span_sort_key(indexed_span: tuple[int, dict[str, Any]]) -> tuple[float, int]:
+    index, span = indexed_span
+    started = parse_time(span.get("start_time") or span.get("startTime"))
+    return (started.timestamp() if started else float("inf"), index)
+
+
+def _ordered_spans(spans: list[dict[str, Any]], kind: str) -> list[dict[str, Any]]:
+    indexed = [
+        (index, span)
+        for index, span in enumerate(spans)
+        if str(span.get("kind") or "").lower() == kind
+    ]
+    return [span for _, span in sorted(indexed, key=_span_sort_key)]
+
+
+def _session_name(records: list[dict[str, Any]], fallback: str) -> str:
+    """Title for the session: the request, when there is one."""
+    for wanted_role in ("user", None):
+        for record in records:
+            message = record.get("message") or {}
+            role = str(message.get("role") or "")
+            if wanted_role is not None and role != wanted_role:
+                continue
+            text = " ".join(content_text(message.get("content")).split())
+            if text:
+                return text[:SESSION_NAME_MAX_CHARS]
+    return fallback
+
+
+def _messages_to_entries(
+    chain: _Chain,
+    messages: list[dict[str, Any]],
+    generations: list[dict[str, Any]],
+    tool_spans: list[dict[str, Any]],
+) -> None:
+    """Emit message entries, enriched with what the spans know.
+
+    Spans supply what the message layer cannot: token usage and cost on the
+    generation that produced each assistant turn, and failure status on a tool
+    result. Tool call ids and span ids come from different namespaces, so a
+    result is matched to its span by call id first and by order second.
+    """
+    tool_names: dict[str, str] = {}
+    tool_span_by_id = {str(span.get("id")): span for span in tool_spans}
+    remaining_tool_spans = list(tool_spans)
+    generation_index = 0
+
+    for index, message in enumerate(messages):
+        role = str(message.get("role") or "assistant").lower()
+        timestamp = message.get("timestamp") or message.get("created_at")
+
+        if role == "tool":
+            call_id = str(
+                message.get("tool_call_id")
+                or message.get("toolCallId")
+                or f"call-{index}"
+            )
+            span = tool_span_by_id.get(call_id)
+            if span is None and remaining_tool_spans:
+                span = remaining_tool_spans[0]
+            if span is not None and span in remaining_tool_spans:
+                remaining_tool_spans.remove(span)
+            result: dict[str, Any] = {
+                "role": "toolResult",
+                "toolCallId": call_id,
+                "toolName": tool_names.get(call_id)
+                or str((span or {}).get("name") or "tool"),
+                "content": [text_block(content_text(message.get("content")))],
+            }
+            if _message_is_error(message) or (
+                span is not None and _span_is_error(span)
+            ):
+                result["isError"] = True
+            chain.message(index, result, timestamp)
+            continue
+
+        blocks: list[dict[str, Any]] = []
+        reasoning = (
+            message.get("reasoning_content")
+            or message.get("reasoningContent")
+            or message.get("reasoning")
+        )
+        if reasoning:
+            blocks.append(thinking_block(content_text(reasoning)))
+        text = content_text(message.get("content"))
+        if text:
+            blocks.append(text_block(text))
+
+        calls = list(message.get("tool_calls") or message.get("toolCalls") or [])
+        if message.get("function_call"):
+            calls.append({"function": message["function_call"]})
+        for call_index, call in enumerate(calls):
+            if not isinstance(call, dict):
+                continue
+            function = (
+                call.get("function") if isinstance(call.get("function"), dict) else call
+            )
+            call_id = str(call.get("id") or f"call-{index}-{call_index}")
+            name = str(function.get("name") or "tool")
+            tool_names[call_id] = name
+            blocks.append(tool_call_block(call_id, name, function.get("arguments")))
+
+        entry_message: dict[str, Any] = {
+            "role": ROLE_BY_OPENAI_ROLE.get(role, "assistant"),
+            "content": blocks,
+        }
+        if entry_message["role"] == "assistant":
+            # Pair the Nth assistant turn with the Nth generation span rather
+            # than repeating one span's totals on every turn, which would make
+            # the viewer double-count tokens and cost.
+            if generation_index < len(generations):
+                usage = span_usage(generations[generation_index])
+                if usage:
+                    entry_message["usage"] = usage
+                generation_index += 1
+        chain.message(index, entry_message, timestamp)
+
+
+def _spans_to_entries(
+    chain: _Chain, spans: list[dict[str, Any]], generations: list[dict[str, Any]]
+) -> None:
+    """Emit entries for a trace that carries spans but no messages."""
+    ordered = sorted(
+        ((index, span) for index, span in enumerate(spans) if isinstance(span, dict)),
+        key=_span_sort_key,
+    )
+    for index, span in ordered:
+        kind = str(span.get("kind") or "span").lower()
+        timestamp = span.get("start_time") or span.get("startTime")
+        if kind == "generation":
+            message: dict[str, Any] = {
+                "role": "assistant",
+                "content": [text_block(_generation_output_text(span))],
+            }
+            usage = span_usage(span)
+            if usage:
+                message["usage"] = usage
+            chain.message(f"span-{index}", message, timestamp)
+        elif kind == "tool":
+            call_id = str(span.get("id") or f"span-tool-{index}")
+            name = str(span.get("name") or "tool")
+            chain.message(
+                f"span-{index}-call",
+                {
+                    "role": "assistant",
+                    "content": [tool_call_block(call_id, name, span.get("input"))],
+                },
+                timestamp,
+            )
+            result: dict[str, Any] = {
+                "role": "toolResult",
+                "toolCallId": call_id,
+                "toolName": name,
+                "content": [
+                    text_block(content_text(span.get("error") or span.get("output")))
+                ],
+            }
+            if _span_is_error(span):
+                result["isError"] = True
+            chain.message(f"span-{index}-result", result, timestamp)
+        else:
+            chain.message(
+                f"span-{index}",
+                {
+                    "role": "developer",
+                    "content": [text_block(str(span.get("name") or kind))],
+                },
+                timestamp,
+            )
+
+
+def trace_to_records(
+    trace: dict[str, Any], project: str | None = None
+) -> list[dict[str, Any]]:
+    """Serialize one Trackio trace row into a Pi-format agent session.
+
+    The entries form the linear conversation the viewer renders, enriched from
+    the spans with model, token usage, cost, and failure status. The full span
+    tree — hierarchy, `duration_ms`, per-span `metadata`, and the `kind` of
+    non-tool spans — stays in SQLite, which remains authoritative for every
+    Trackio reader.
+    """
+    messages = [m for m in (trace.get("messages") or []) if isinstance(m, dict)]
+    spans = [s for s in (trace.get("spans") or []) if isinstance(s, dict)]
+    generations = _ordered_spans(spans, "generation")
+    tool_spans = _ordered_spans(spans, "tool")
+
+    trace_id = str(trace.get("id") or uuid.uuid4().hex)
+    timestamp = iso_z(trace.get("timestamp"))
+    chain = _Chain(trace_id, timestamp)
+
+    model = next(
+        (str(span["model"]) for span in generations if span.get("model")),
+        None,
+    )
+    if model:
+        chain.add(
+            {
+                "type": "model_change",
+                "id": entry_id(trace_id, "model"),
+                "modelId": model,
+            },
+            trace.get("timestamp"),
+        )
+
+    if messages:
+        _messages_to_entries(chain, messages, generations, tool_spans)
+    else:
+        _spans_to_entries(chain, spans, generations)
+
+    header = session_header(
+        trace_id,
+        timestamp=trace.get("timestamp"),
+        name=_session_name(chain.records, trace_id),
+        cwd=f"/{project}" if project else "/",
+        trackio={
+            "project": project,
+            "run_id": trace.get("run_id"),
+            "run_name": trace.get("run_name"),
+            "step": trace.get("step"),
+            "key": trace.get("key"),
+            "trace_index": trace.get("trace_index"),
+            "metadata": trace.get("metadata") or {},
+        },
+    )
+    return [header, *chain.records]
+
+
+def trace_session_filename(trace_id: Any) -> str:
+    return f"{safe_id(str(trace_id))}.jsonl"

trackio/alerts.py

@@ -0,0 +1,184 @@
+import json
+import logging
+import ssl
+import urllib.request
+from enum import Enum
+
+try:
+    import certifi
+
+    _SSL_CONTEXT = ssl.create_default_context(cafile=certifi.where())
+except ImportError:
+    _SSL_CONTEXT = None
+
+logger = logging.getLogger(__name__)
+
+
+class AlertLevel(str, Enum):
+    INFO = "info"
+    WARN = "warn"
+    ERROR = "error"
+
+
+ALERT_LEVEL_ORDER = {
+    AlertLevel.INFO: 0,
+    AlertLevel.WARN: 1,
+    AlertLevel.ERROR: 2,
+}
+
+ALERT_COLORS = {
+    AlertLevel.INFO: "\033[94m",
+    AlertLevel.WARN: "\033[93m",
+    AlertLevel.ERROR: "\033[91m",
+}
+RESET_COLOR = "\033[0m"
+
+LEVEL_EMOJI = {
+    AlertLevel.INFO: "ℹ️",
+    AlertLevel.WARN: "⚠️",
+    AlertLevel.ERROR: "🚨",
+}
+
+
+def format_alert_terminal(
+    level: AlertLevel, title: str, text: str | None, step: int | None
+) -> str:
+    color = ALERT_COLORS.get(level, "")
+    step_str = f" (step {step})" if step is not None else ""
+    if text:
+        return f"{color}[TRACKIO {level.value.upper()}]{RESET_COLOR} {title}: {text}{step_str}"
+    return f"{color}[TRACKIO {level.value.upper()}]{RESET_COLOR} {title}{step_str}"
+
+
+def _is_slack_url(url: str) -> bool:
+    return "hooks.slack.com" in url
+
+
+def _is_discord_url(url: str) -> bool:
+    return "discord.com/api/webhooks" in url or "discordapp.com/api/webhooks" in url
+
+
+def _build_slack_payload(
+    level: AlertLevel,
+    title: str,
+    text: str | None,
+    project: str,
+    run: str,
+    step: int | None,
+) -> dict:
+    emoji = LEVEL_EMOJI.get(level, "")
+    step_str = f"  •  Step {step}" if step is not None else ""
+    header = f"{emoji} *[{level.value.upper()}] {title}*"
+    context = f"Project: {project}  •  Run: {run}{step_str}"
+    blocks = [
+        {"type": "section", "text": {"type": "mrkdwn", "text": header}},
+    ]
+    if text:
+        blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": text}})
+    blocks.append(
+        {"type": "context", "elements": [{"type": "mrkdwn", "text": context}]}
+    )
+    return {"blocks": blocks}
+
+
+def _build_discord_payload(
+    level: AlertLevel,
+    title: str,
+    text: str | None,
+    project: str,
+    run: str,
+    step: int | None,
+) -> dict:
+    color_map = {
+        AlertLevel.INFO: 3447003,
+        AlertLevel.WARN: 16776960,
+        AlertLevel.ERROR: 15158332,
+    }
+    emoji = LEVEL_EMOJI.get(level, "")
+    step_str = f"  •  Step {step}" if step is not None else ""
+    embed = {
+        "title": f"{emoji} [{level.value.upper()}] {title}",
+        "color": color_map.get(level, 0),
+        "footer": {"text": f"Project: {project}  •  Run: {run}{step_str}"},
+    }
+    if text:
+        embed["description"] = text
+    return {"embeds": [embed]}
+
+
+def _build_generic_payload(
+    level: AlertLevel,
+    title: str,
+    text: str | None,
+    project: str,
+    run: str,
+    step: int | None,
+    timestamp: str | None,
+) -> dict:
+    return {
+        "level": level.value,
+        "title": title,
+        "text": text,
+        "project": project,
+        "run": run,
+        "step": step,
+        "timestamp": timestamp,
+    }
+
+
+def parse_alert_level(level: AlertLevel | str) -> AlertLevel:
+    if isinstance(level, AlertLevel):
+        return level
+    normalized = level.lower().strip()
+    try:
+        return AlertLevel(normalized)
+    except ValueError as e:
+        allowed = ", ".join(lvl.value for lvl in AlertLevel)
+        raise ValueError(
+            f"Invalid alert level '{level}'. Expected one of: {allowed}."
+        ) from e
+
+
+def resolve_webhook_min_level(
+    webhook_min_level: AlertLevel | str | None,
+) -> AlertLevel | None:
+    if webhook_min_level is None:
+        return None
+    return parse_alert_level(webhook_min_level)
+
+
+def should_send_webhook(
+    level: AlertLevel, webhook_min_level: AlertLevel | None
+) -> bool:
+    if webhook_min_level is None:
+        return True
+    return ALERT_LEVEL_ORDER[level] >= ALERT_LEVEL_ORDER[webhook_min_level]
+
+
+def send_webhook(
+    url: str,
+    level: AlertLevel,
+    title: str,
+    text: str | None,
+    project: str,
+    run: str,
+    step: int | None,
+    timestamp: str | None = None,
+) -> None:
+    if _is_slack_url(url):
+        payload = _build_slack_payload(level, title, text, project, run, step)
+    elif _is_discord_url(url):
+        payload = _build_discord_payload(level, title, text, project, run, step)
+    else:
+        payload = _build_generic_payload(
+            level, title, text, project, run, step, timestamp
+        )
+
+    data = json.dumps(payload).encode("utf-8")
+    req = urllib.request.Request(
+        url, data=data, headers={"Content-Type": "application/json"}
+    )
+    try:
+        urllib.request.urlopen(req, timeout=10, context=_SSL_CONTEXT)
+    except Exception as e:
+        logger.warning(f"Failed to send webhook to {url}: {e}")

trackio/api.py

@@ -0,0 +1,149 @@
+from typing import Iterator
+
+from trackio.registry import Registry
+from trackio.sqlite_storage import SQLiteStorage
+
+
+class Run:
+    def __init__(self, project: str, name: str, run_id: str | None = None):
+        self.project = project
+        self.name = name
+        self._id = run_id or name
+        self._config = None
+
+    @property
+    def id(self) -> str:
+        return self._id
+
+    @property
+    def config(self) -> dict | None:
+        if self._config is None:
+            self._config = SQLiteStorage.get_run_config(
+                self.project, self.name, run_id=self.id
+            )
+        return self._config
+
+    def alerts(self, level: str | None = None, since: str | None = None) -> list[dict]:
+        return SQLiteStorage.get_alerts(
+            self.project, run_name=self.name, run_id=self.id, level=level, since=since
+        )
+
+    def delete(self) -> bool:
+        return SQLiteStorage.delete_run(self.project, self.name, run_id=self.id)
+
+    def move(self, new_project: str) -> bool:
+        success = SQLiteStorage.move_run(
+            self.project, self.name, new_project, run_id=self.id
+        )
+        if success:
+            self.project = new_project
+        return success
+
+    def rename(self, new_name: str) -> "Run":
+        SQLiteStorage.rename_run(self.project, self.name, new_name, run_id=self.id)
+        self.name = new_name
+        return self
+
+    def __repr__(self) -> str:
+        return f"<Run {self.name} in project {self.project}>"
+
+
+class Runs:
+    def __init__(self, project: str):
+        self.project = project
+        self._runs = None
+
+    def _load_runs(self):
+        if self._runs is None:
+            records = SQLiteStorage.get_run_records(self.project)
+            self._runs = [
+                Run(
+                    self.project,
+                    str(record["name"]),
+                    run_id=str(record["id"]) if record["id"] is not None else None,
+                )
+                for record in records
+            ]
+
+    def __iter__(self) -> Iterator[Run]:
+        self._load_runs()
+        return iter(self._runs)
+
+    def __getitem__(self, index: int) -> Run:
+        self._load_runs()
+        return self._runs[index]
+
+    def __len__(self) -> int:
+        self._load_runs()
+        return len(self._runs)
+
+    def __repr__(self) -> str:
+        self._load_runs()
+        return f"<Runs project={self.project} count={len(self._runs)}>"
+
+
+class Api:
+    def runs(self, project: str) -> Runs:
+        if not SQLiteStorage.get_project_db_path(project).exists():
+            raise ValueError(f"Project '{project}' does not exist")
+        return Runs(project)
+
+    def alerts(
+        self,
+        project: str,
+        run: str | None = None,
+        level: str | None = None,
+        since: str | None = None,
+    ) -> list[dict]:
+        if not SQLiteStorage.get_project_db_path(project).exists():
+            raise ValueError(f"Project '{project}' does not exist")
+        return SQLiteStorage.get_alerts(project, run_name=run, level=level, since=since)
+
+    def create_registry(
+        self,
+        name: str,
+        description: str | None = None,
+        bucket_id: str | None = None,
+    ) -> Registry:
+        """Create a new registry and return a handle on it.
+
+        Raises `ValueError` if a registry with this name already exists.
+        Registries are never created implicitly: linking into a registry
+        that does not exist raises an error.
+
+        Args:
+            name (`str`):
+                Registry name, e.g. `"models"`. Must match
+                `^[A-Za-z0-9_-]+$`.
+            description (`str`, *optional*):
+                Human-readable description of the registry.
+            bucket_id (`str`, *optional*):
+                Hugging Face bucket to hold the registry, e.g.
+                `"my-org/models-registry"`. The bucket is created (private) if
+                it does not exist. A bucket-backed registry is reachable from
+                any machine with access to it, including runs that log to a
+                Space. Omit for a local registry; defaults to
+                `TRACKIO_REGISTRY_BUCKET_ID` when that is set.
+
+        Returns:
+            A [`Registry`] handle on the new registry.
+        """
+        registry = Registry(name, bucket_id=bucket_id)
+        registry._storage.create_registry(name, description=description)
+        return registry
+
+    def registry(self, name: str, bucket_id: str | None = None) -> Registry:
+        """Fetch a handle on an existing registry.
+
+        Pass `bucket_id` (or set `TRACKIO_REGISTRY_BUCKET_ID`) for a
+        bucket-backed registry. Raises `ValueError` if no registry with this
+        name exists."""
+        registry = Registry(name, bucket_id=bucket_id)
+        if not registry._storage.registry_exists(name):
+            where = (
+                ""
+                if registry.bucket_id is None
+                else f" in bucket '{registry.bucket_id}'"
+            )
+            raise ValueError(f"Registry '{name}' does not exist{where}")
+        return registry

trackio/apple_gpu.py

@@ -0,0 +1,206 @@
+import platform
+import subprocess
+import sys
+import threading
+import warnings
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from trackio.run import Run
+
+psutil: Any = None
+PSUTIL_AVAILABLE = False
+_monitor_lock = threading.Lock()
+
+
+def _ensure_psutil():
+    global PSUTIL_AVAILABLE, psutil
+    if PSUTIL_AVAILABLE:
+        return psutil
+    try:
+        import psutil as _psutil
+
+        psutil = _psutil
+        PSUTIL_AVAILABLE = True
+        return psutil
+    except ImportError:
+        raise ImportError(
+            "psutil is required for Apple Silicon monitoring. "
+            "Install it with: pip install psutil"
+        )
+
+
+def is_apple_silicon() -> bool:
+    """Check if running on Apple Silicon (M1/M2/M3/M4)."""
+    if platform.system() != "Darwin":
+        return False
+
+    try:
+        result = subprocess.run(
+            ["sysctl", "-n", "machdep.cpu.brand_string"],
+            capture_output=True,
+            text=True,
+            timeout=1,
+        )
+        cpu_brand = result.stdout.strip()
+        return "Apple" in cpu_brand
+    except Exception:
+        return False
+
+
+def get_gpu_info() -> dict[str, Any]:
+    """Get Apple GPU information using ioreg."""
+    try:
+        result = subprocess.run(
+            ["ioreg", "-r", "-d", "1", "-w", "0", "-c", "IOAccelerator"],
+            capture_output=True,
+            text=True,
+            timeout=2,
+        )
+
+        if result.returncode == 0 and result.stdout:
+            lines = result.stdout.strip().split("\n")
+            for line in lines:
+                if "IOAccelerator" in line and "class" in line:
+                    return {"detected": True, "type": "Apple GPU"}
+        else:
+            print("Error collecting Apple GPU info. ioreg stdout was:", file=sys.stderr)
+            print(result.stdout, file=sys.stderr)
+            print("ioreg stderr was:", file=sys.stderr)
+            print(result.stderr, file=sys.stderr)
+
+        result = subprocess.run(
+            ["system_profiler", "SPDisplaysDataType"],
+            capture_output=True,
+            text=True,
+            timeout=3,
+        )
+
+        if result.returncode == 0 and "Apple" in result.stdout:
+            for line in result.stdout.split("\n"):
+                if "Chipset Model:" in line:
+                    model = line.split(":")[-1].strip()
+                    return {"detected": True, "type": model}
+
+    except Exception:
+        pass
+
+    return {"detected": False}
+
+
+def apple_gpu_available() -> bool:
+    """
+    Check if Apple GPU monitoring is available.
+
+    Returns True if running on Apple Silicon (M-series chips) and psutil is installed.
+    """
+    try:
+        _ensure_psutil()
+        return is_apple_silicon()
+    except ImportError:
+        return False
+    except Exception:
+        return False
+
+
+def collect_apple_metrics(include_cpu_metrics: bool = True) -> dict:
+    """
+    Collect system metrics for Apple Silicon.
+
+    Returns:
+        Dictionary of system metrics including CPU, memory, and GPU info.
+    """
+    metrics = {}
+
+    if include_cpu_metrics:
+        from trackio.cpu import collect_cpu_metrics
+
+        metrics.update(collect_cpu_metrics(include_static=True))
+
+    gpu_info = get_gpu_info()
+    if gpu_info.get("detected"):
+        metrics["gpu/detected"] = 1
+
+    return metrics
+
+
+class AppleGpuMonitor:
+    def __init__(
+        self, run: "Run", interval: float = 10.0, include_cpu_metrics: bool = True
+    ):
+        self._run = run
+        self._interval = interval
+        self._include_cpu_metrics = include_cpu_metrics
+        self._stop_flag = threading.Event()
+        self._thread: "threading.Thread | None" = None
+
+    def start(self):
+        if not is_apple_silicon():
+            warnings.warn(
+                "auto_log_gpu=True but not running on Apple Silicon. "
+                "Apple GPU logging disabled."
+            )
+            return
+
+        if not PSUTIL_AVAILABLE:
+            try:
+                _ensure_psutil()
+            except ImportError:
+                warnings.warn(
+                    "auto_log_gpu=True but psutil not installed. "
+                    "Install with: pip install psutil"
+                )
+                return
+
+        self._thread = threading.Thread(target=self._monitor_loop, daemon=True)
+        self._thread.start()
+
+    def stop(self):
+        self._stop_flag.set()
+        if self._thread is not None:
+            self._thread.join(timeout=2.0)
+
+    def _monitor_loop(self):
+        while not self._stop_flag.is_set():
+            try:
+                metrics = collect_apple_metrics(
+                    include_cpu_metrics=self._include_cpu_metrics
+                )
+                if metrics:
+                    self._run.log_system(metrics)
+            except Exception:
+                pass
+
+            self._stop_flag.wait(timeout=self._interval)
+
+
+def log_apple_gpu(run: "Run | None" = None) -> dict:
+    """
+    Log Apple Silicon system metrics to the current or specified run.
+
+    Args:
+        run: Optional Run instance. If None, uses current run from context.
+
+    Returns:
+        dict: The system metrics that were logged.
+
+    Example:
+        ```python
+        import trackio
+
+        run = trackio.init(project="my-project")
+        trackio.log({"loss": 0.5})
+        trackio.log_apple_gpu()
+        ```
+    """
+    from trackio import context_vars
+
+    if run is None:
+        run = context_vars.current_run.get()
+        if run is None:
+            raise RuntimeError("Call trackio.init() before trackio.log_apple_gpu().")
+
+    metrics = collect_apple_metrics()
+    if metrics:
+        run.log_system(metrics)
+    return metrics

trackio/artifact.py

@@ -0,0 +1,774 @@
+import os
+import shutil
+from pathlib import Path
+
+import httpx
+from huggingface_hub.utils import get_token
+
+from trackio import cas, references, utils
+from trackio.registry import registry_backend
+from trackio.registry_storage import (
+    parse_collection_target,
+    registry_project_name,
+)
+from trackio.remote_client import _merge_client_headers, _resolve_src_url
+from trackio.typehints import ETag, Manifest, ManifestEntry, Sha256Digest, URIStr
+
+
+def _materialize(blob: Path, dst: Path, size: int) -> None:
+    """Copy `blob` to `dst` unless `dst` already matches the blob's size and
+    mtime.
+    """
+    dst.parent.mkdir(parents=True, exist_ok=True)
+    blob_stat = blob.stat()
+    if dst.is_file():
+        dst_stat = dst.stat()
+        if dst_stat.st_size == size and dst_stat.st_mtime_ns == blob_stat.st_mtime_ns:
+            return
+    partial = dst.parent / cas.partial_blob_name(dst.name)
+    try:
+        shutil.copyfile(blob, partial)
+        os.utime(partial, ns=(blob_stat.st_atime_ns, blob_stat.st_mtime_ns))
+        os.replace(partial, dst)
+    except Exception:
+        partial.unlink(missing_ok=True)
+        raise
+
+
+def _fetch_blob_from_remote(
+    remote_source: dict,
+    project: str,
+    digest: Sha256Digest,
+    target_path: Path,
+) -> None:
+    space_id = remote_source.get("space_id")
+    src = space_id or remote_source.get("server_base_url")
+    if not src:
+        raise RuntimeError(
+            "Artifact has _remote_source set but neither space_id nor "
+            "server_base_url is populated."
+        )
+    base_url = _resolve_src_url(src).rstrip("/")
+    url = f"{base_url}/artifact_blob/{utils.canonical_project_name(project)}/{digest}"
+    headers = _merge_client_headers(
+        get_token() if space_id else None,
+        remote_source.get("write_token"),
+    )
+    with httpx.stream(
+        "GET",
+        url,
+        headers=headers,
+        timeout=httpx.Timeout(connect=10.0, read=300.0, write=10.0, pool=10.0),
+    ) as response:
+        if response.status_code == 404:
+            raise FileNotFoundError(
+                f"Artifact blob {digest} not available on remote at {url}"
+            )
+        response.raise_for_status()
+        cas.stage_blob_from_chunks(
+            response.iter_bytes(),
+            claimed_digest=digest,
+            target_path=target_path,
+        )
+
+
+def _materialize_reference(
+    uri: str, scheme: str, dest: Path, digest: Sha256Digest | ETag | URIStr
+) -> None:
+    """Fetch the object at `uri` into `dest`, idempotently and atomically.
+
+    If `dest` already exists it is left untouched and nothing is fetched:
+    reference digests are opaque, so a file already present is assumed current
+    (mirroring the size/mtime idempotence of `_materialize`), letting a repeated
+    `download()` skip references already on disk.
+
+    Otherwise, when a real checksum was recorded, the source is re-probed and
+    compared. When the digest doesn't exist, or when it cannot be re-probed,
+    the comparison is skipped and the artifact is still materialized.
+    """
+    if dest.is_file():
+        return
+    if len(digest) > 0 and digest != uri:
+        try:
+            resolved = references.resolve_reference(
+                uri, scheme, checksum=True, max_objects=1
+            )[0]
+        except Exception:
+            resolved = None
+        current_digest = resolved.digest if resolved is not None else None
+        if current_digest is not None and current_digest != digest:
+            utils._emit_nonfatal_warning(
+                f"Reference {uri!r} may have changed since it was logged "
+                f"(recorded digest {digest}, current {current_digest})."
+            )
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    partial = dest.parent / cas.partial_blob_name(dest.name)
+    try:
+        references.fetch_reference(uri, scheme, partial)
+        os.replace(partial, dest)
+    except Exception:
+        partial.unlink(missing_ok=True)
+        raise
+
+
+class Artifact:
+    """
+    A versioned, named bundle of files and references attached to a project.
+
+    Construct an `Artifact`, add files to it with `add_file` / `add_dir`
+    (bytes staged into content-addressed storage) or `add_reference` (an
+    external URI recorded without copying any bytes), then persist it with
+    `trackio.log_artifact`. Logging freezes the artifact and populates its
+    read-only `version`, `aliases`, `size`, and `manifest`.
+
+    Args:
+        name (`str`):
+            Artifact name, unique within the project. Must match
+            `^[A-Za-z0-9._-]+$` (letters, digits, dot, underscore, hyphen).
+        type (`str`):
+            Free-form category such as `"model"` or `"dataset"`, used to group
+            artifacts.
+        description (`str`, *optional*):
+            Human-readable description of the artifact.
+        metadata (`dict`, *optional*):
+            Arbitrary JSON-serializable metadata stored alongside the version.
+    """
+
+    def __init__(
+        self,
+        name: str,
+        type: str,
+        description: str | None = None,
+        metadata: dict | None = None,
+    ):
+        cas.validate_artifact_name(name)
+        self._name = name
+        self._type = type
+        self._description = description
+        self._metadata: dict = dict(metadata) if metadata else {}
+        self._pending_files: list[tuple[Path, str]] = []
+        self._pending_references: list[
+            tuple[str, str, Sha256Digest | ETag | URIStr, int]
+        ] = []
+        self._logged = False
+        self._version: int | None = None
+        self._aliases: tuple[str, ...] = ()
+        self._size: int | None = None
+        self._manifest: Manifest | None = None
+        self._manifest_digest: Sha256Digest | None = None
+        self._project: str | None = None
+        self._remote_source: dict | None = None
+        self._registry: str | None = None
+        self._registry_bucket_id: str | None = None
+        self._source_project: str | None = None
+        self._source_artifact: str | None = None
+        self._source_version: int | None = None
+
+    @property
+    def name(self) -> str:
+        """Artifact name, unique within its project."""
+        return self._name
+
+    @property
+    def type(self) -> str:
+        """Free-form category such as `"model"` or `"dataset"`."""
+        return self._type
+
+    @property
+    def description(self) -> str | None:
+        """Human-readable description, or None if unset."""
+        return self._description
+
+    @description.setter
+    def description(self, value: str | None) -> None:
+        self._description = value
+
+    @property
+    def metadata(self) -> dict:
+        """Live, mutable metadata dict; assignments like `art.metadata["k"] = v`
+        made before logging are preserved."""
+        return self._metadata
+
+    @metadata.setter
+    def metadata(self, value: dict | None) -> None:
+        self._metadata = dict(value) if value else {}
+
+    @property
+    def version(self) -> str | None:
+        """Version string in `"v<N>"` form (e.g. `"v3"`), or None if the
+        artifact has not been logged or fetched yet."""
+        return None if self._version is None else f"v{self._version}"
+
+    @property
+    def aliases(self) -> tuple[str, ...]:
+        """Aliases pointing at this version, e.g. `("latest", "prod")`."""
+        return self._aliases
+
+    @property
+    def size(self) -> int | None:
+        """Total size in bytes of the artifact's files plus any referenced data
+        whose size is known, or None if not yet logged."""
+        return self._size
+
+    @property
+    def manifest(self) -> Manifest | None:
+        """List of manifest entries describing the artifact's contents, or None
+        if not yet logged or fetched. File entries carry `path`, `digest`, and
+        `size`; reference entries carry `path`, `ref` (a URI), `size`, and a
+        `digest` — a sha256 for local/LFS references, the provider's opaque ETag
+        for HTTP or object-store references, or the URI itself when no checksum
+        is available. Returns a fresh copy on each access."""
+        return None if self._manifest is None else [dict(e) for e in self._manifest]
+
+    @property
+    def manifest_digest(self) -> Sha256Digest | None:
+        """Digest over the manifest (file paths plus their content), used to
+        de-duplicate re-logged content; None until logged or fetched."""
+        return self._manifest_digest
+
+    @property
+    def digest(self) -> Sha256Digest | None:
+        """Alias of `manifest_digest`."""
+        return self._manifest_digest
+
+    @property
+    def qualified_name(self) -> str:
+        """`"<project>/<name>:v<N>"` for a logged or fetched artifact."""
+        if self._project is None or self._version is None:
+            raise RuntimeError(
+                "Artifact has no qualified name until it is logged or fetched."
+            )
+        return f"{self._project}/{self._name}:v{self._version}"
+
+    @property
+    def project(self) -> str | None:
+        """Project the artifact belongs to, or None until logged or fetched."""
+        return self._project
+
+    @property
+    def is_link(self) -> bool:
+        """True if this artifact is a registry link, i.e. the pointer
+        returned by `Run.link_artifact`, rather than a source artifact
+        version."""
+        return self._registry is not None
+
+    @property
+    def source_name(self) -> str | None:
+        """Name of the source artifact version this artifact's content comes
+        from. Equal to `name` unless this artifact is a registry link."""
+        return self._source_artifact if self.is_link else self._name
+
+    @property
+    def source_version(self) -> str | None:
+        """Version string (`"v<N>"`) of the source artifact version. Equal to
+        `version` unless this artifact is a registry link."""
+        if self.is_link:
+            return f"v{self._source_version}"
+        return self.version
+
+    @property
+    def source_project(self) -> str | None:
+        """Project the source artifact version was logged in. Equal to
+        `project` unless this artifact is a registry link."""
+        return self._source_project if self.is_link else self._project
+
+    @property
+    def source_qualified_name(self) -> str:
+        """`"<project>/<name>:v<N>"` of the source artifact version. Equal to
+        `qualified_name` unless this artifact is a registry link."""
+        if self.is_link:
+            return (
+                f"{self._source_project}/{self._source_artifact}"
+                f":v{self._source_version}"
+            )
+        return self.qualified_name
+
+    def wait(self, timeout: int | None = None) -> "Artifact":
+        """No-op: trackio logs artifacts synchronously, so the artifact is
+        already committed by the time `log_artifact` returns."""
+        if not self._logged:
+            raise RuntimeError(
+                "Cannot wait on an Artifact that has not been logged; "
+                "call log_artifact first."
+            )
+        return self
+
+    def add_file(self, local_path: str | Path, name: str | None = None) -> None:
+        """Stage a single file for inclusion in the artifact.
+
+        Args:
+            local_path (`str` or `Path`):
+                Path to an existing regular file to add.
+            name (`str`, *optional*):
+                Logical path the file is stored under inside the artifact.
+                Defaults to the file's basename.
+        """
+        if self._logged:
+            raise RuntimeError(
+                "Cannot add files to an Artifact that has already been logged or fetched."
+            )
+        src = Path(local_path).resolve()
+        if not src.is_file():
+            raise ValueError(f"Not a regular file: {local_path}")
+        logical = cas.validate_logical_path(name if name is not None else src.name)
+        self._pending_files.append((src, logical))
+
+    def add_dir(self, local_dir: str | Path, name: str | None = None) -> None:
+        """Stage every regular file under a directory, recursively.
+
+        Symlinks are skipped.
+
+        Args:
+            local_dir (`str` or `Path`):
+                Path to an existing directory whose files are added.
+            name (`str`, *optional*):
+                Logical path prefix for the added files. Defaults to no prefix,
+                so files keep their paths relative to `local_dir`.
+        """
+        if self._logged:
+            raise RuntimeError(
+                "Cannot add files to an Artifact that has already been logged or fetched."
+            )
+        root = Path(local_dir).resolve()
+        if not root.is_dir():
+            raise ValueError(f"Not a directory: {local_dir}")
+        prefix = cas.validate_logical_path(name.rstrip("/")) + "/" if name else ""
+        for dirpath, dirnames, filenames in os.walk(root, followlinks=False):
+            dirnames.sort()
+            for filename in sorted(filenames):
+                entry = Path(dirpath) / filename
+                if entry.is_symlink() or not entry.is_file():
+                    continue
+                rel = entry.relative_to(root).as_posix()
+                logical = cas.validate_logical_path(prefix + rel)
+                self._pending_files.append((entry, logical))
+
+    def add_reference(
+        self,
+        uri: str,
+        name: str | None = None,
+        checksum: bool = True,
+        max_objects: int | None = None,
+    ) -> None:
+        """Stage a reference to external data, without copying any bytes.
+
+        Unlike `add_file`/`add_dir`, a reference records the data's URI (plus,
+        when available, a size and checksum) *without staging the bytes into
+        the content-addressed store*. This is how you version and track
+        lineage over large or already-durably-stored datasets that must not be
+        duplicated.
+
+        A URI that denotes a directory (`file://`, `hf://`, or a prefix
+        expanded by a custom handler) is expanded into one entry per object,
+        capped by `max_objects`. Reference bytes are never uploaded to a Space
+        or bucket.
+
+        The URI is stored verbatim in the artifact manifest, and manifests may
+        be synced to a shared Hugging Face Dataset — so a signed URI triggers a
+        warning for security reasons; please prefer the object's canonical
+        unsigned URI (e.g. `s3://bucket/key`).
+
+        Args:
+            uri (`str`):
+                Location of the referenced data, percent-encoded (build local
+                URIs with `pathlib.Path.as_uri()`). `file://`, `http(s)://`,
+                and `hf://` are resolved and fetched natively; any other scheme
+                (`s3://`, `gs://`, Azure blob URLs, ...) requires a custom
+                `ReferenceHandler` registered via
+                `trackio.register_reference_handler` — see the artifacts
+                documentation for complete examples — and raises otherwise.
+            name (`str`, *optional*):
+                Logical path the reference is stored under. Defaults to the last
+                segment of `uri`; for an expanded prefix (ending with /) it is the
+                prefix under which each object's relative path is nested.
+            checksum (`bool`, *optional*, defaults to `True`):
+                When `True`, probes the source to derive its size and a
+                checksum (and to expand a directory/prefix): `file://` is
+                stream-hashed to a sha256, `hf://` uses its LFS sha256 or git
+                blob id, and `http(s)://` uses the server `ETag`. This may read
+                the filesystem or make network requests. When no checksum can
+                be obtained for a *remote* source (e.g. no ETag), the URI
+                itself is used as the `digest` and a warning is emitted. A
+                local `file://` path that does not exist instead raises. Pass
+                `checksum=False` to skip remote probing entirely.
+            max_objects (`int`, *optional*):
+                Cap on how many objects a directory/prefix expands into (default
+                10,000); exceeding it raises.
+        """
+        if self._logged:
+            raise RuntimeError(
+                "Cannot add references to an Artifact that has already been "
+                "logged or fetched."
+            )
+        scheme, normalized = references.validate_reference_uri(uri)
+        if references.looks_signed(normalized):
+            utils._emit_nonfatal_warning(
+                f"Reference {uri!r} looks like a signed URL, and the full URI "
+                "(embedded credential included) is stored in the artifact "
+                "manifest, which may be synced to a shared HF Dataset. Prefer "
+                "the object's canonical unsigned URI (e.g. s3://bucket/key or "
+                "the URL without its signed query string)."
+            )
+        cap = references.DEFAULT_MAX_OBJECTS if max_objects is None else max_objects
+        resolved = references.resolve_reference(normalized, scheme, checksum, cap)
+        if not resolved:
+            raise ValueError(f"Reference URI {uri!r} matched no objects.")
+        used_uri_fallback = False
+        name_prefix = f"{name.rstrip('/')}/" if name is not None else ""
+        for entry in resolved:
+            if entry.relkey is None:
+                logical = self._reference_logical_name(name, entry.uri, uri)
+            else:
+                logical = cas.validate_logical_path(name_prefix + entry.relkey)
+            ref_digest: Sha256Digest | ETag | URIStr | None = entry.digest
+            if ref_digest is None:
+                ref_digest = URIStr(entry.uri)
+                used_uri_fallback = True
+            ref_size = 0 if entry.size is None else entry.size
+            self._pending_references.append((logical, entry.uri, ref_digest, ref_size))
+        if checksum and used_uri_fallback:
+            utils._emit_nonfatal_warning(
+                f"Reference {uri!r} was recorded without a content checksum, so its "
+                "version identity is its URI; re-logging changed content at the same "
+                "location will reuse the existing version instead of creating a new "
+                f"one. {references.checksum_hint(scheme, normalized)}"
+            )
+
+    @staticmethod
+    def _reference_logical_name(name: str | None, resolved_uri: str, uri: str) -> str:
+        if name is not None:
+            return cas.validate_logical_path(name)
+        derived = references.default_reference_name(resolved_uri)
+        if not derived:
+            raise ValueError(
+                f"Could not derive a name from URI {uri!r}; pass name= explicitly."
+            )
+        return cas.validate_logical_path(derived)
+
+    def _build_manifest(self, project: str) -> Manifest:
+        if not self._pending_files and not self._pending_references:
+            raise ValueError(
+                f"Artifact {self._name!r} has no files or references; "
+                "call add_file/add_dir/add_reference first."
+            )
+        cas.assert_manifest_paths_compatible(
+            [logical for _, logical in self._pending_files]
+            + [logical for logical, *_ in self._pending_references]
+        )
+
+        entries: Manifest = []
+        for src, logical in self._pending_files:
+            digest, size = cas.stage_blob_into_project(src, project)
+            entries.append({"path": logical, "digest": digest, "size": size})
+        for logical, uri, ref_digest, ref_size in self._pending_references:
+            entry: ManifestEntry = {
+                "path": logical,
+                "ref": uri,
+                "digest": ref_digest,
+                "size": ref_size,
+            }
+            entries.append(entry)
+        return entries
+
+    def _hydrate_from_db(
+        self,
+        *,
+        project: str,
+        version: int,
+        aliases: list[str],
+        manifest: Manifest,
+        manifest_digest: Sha256Digest,
+        size_bytes: int,
+        description: str | None = None,
+        metadata: dict | None = None,
+    ) -> None:
+        if description is not None:
+            self._description = description
+        if metadata is not None:
+            self._metadata = dict(metadata)
+        self._project = project
+        self._version = version
+        self._aliases = tuple(aliases)
+        self._manifest = [dict(e) for e in manifest]
+        self._manifest_digest = manifest_digest
+        self._size = size_bytes
+        self._logged = True
+
+    def download(self, root: str | Path | None = None) -> str:
+        """Materialize the artifact's files into a local directory.
+
+        Files are copied from Trackio's content-addressed cache (and fetched
+        from the remote when missing locally), so repeated calls are cheap and
+        idempotent.
+
+        Reference entries added via `add_reference` are fetched here too: the
+        object at each reference URI is downloaded into the directory (via the
+        bundled `httpx` for `http(s)://`, `huggingface_hub` for `hf://`, and
+        the registered custom `ReferenceHandler` for any other scheme). Each
+        object is written atomically and calls are idempotent. Because reference digests
+        are opaque (a provider ETag or the URI itself), a present file is assumed
+        current and is not re-verified against the source, and a source whose
+        re-probed checksum no longer matches the recorded one is downloaded
+        anyway with a warning. Downloading can transfer a large amount of data;
+        to work with the URIs without downloading, read them from the `references`
+        property or `get_entry_uri` instead. A missing source, an unreachable
+        server, or a scheme with no registered handler raises.
+
+        Args:
+            root (`str` or `Path`, *optional*):
+                Directory to write the files into. Defaults to
+                `./.trackio/artifact-downloads/<project>/<name>_v<version>/`,
+                keyed by project so same-named artifacts from different projects
+                never collide, and by the resolved version so a moving alias
+                like `latest` never leaves behind stale files from a previous
+                version.
+
+        Returns:
+            The absolute path to the download directory, as a string.
+        """
+        if not self._logged:
+            raise RuntimeError(
+                "Cannot download an Artifact that has not been logged or fetched."
+            )
+        if self._manifest is None or self._project is None or self._version is None:
+            raise RuntimeError("Artifact is missing manifest, project, or version.")
+        blob_project = self.source_project or self._project
+
+        if root is None:
+            project = utils.canonical_project_name(self._project)
+            root_path = (
+                Path.cwd()
+                / ".trackio"
+                / "artifact-downloads"
+                / project
+                / f"{self._name}_v{self._version}"
+            )
+        else:
+            root_path = Path(root)
+        root_path.mkdir(parents=True, exist_ok=True)
+
+        for entry in self._manifest:
+            logical = cas.validate_logical_path(entry["path"])
+            if references.is_reference_entry(entry):
+                scheme, uri = references.validate_reference_uri(entry["ref"])
+                _materialize_reference(
+                    uri, scheme, root_path / logical, entry["digest"]
+                )
+                continue
+            digest = cas.validate_digest(entry["digest"])
+            blob = cas.blob_path(blob_project, digest)
+            if not blob.is_file():
+                if self._remote_source is None:
+                    raise FileNotFoundError(
+                        f"Artifact blob {digest} not available locally or "
+                        "remotely. The producer machine may not have shipped "
+                        "this blob yet."
+                    )
+                _fetch_blob_from_remote(self._remote_source, blob_project, digest, blob)
+            _materialize(blob, root_path / logical, entry["size"])
+
+        return str(root_path)
+
+    def link(
+        self,
+        target_path: str,
+        aliases: list[str] | None = None,
+        bucket_id: str | None = None,
+    ) -> "Artifact":
+        """Link this artifact version into a registry collection.
+
+        A link is a pointer to this version: no files are copied. See
+        `Run.link_artifact` for the full semantics (collection versioning,
+        aliases, and the returned linked artifact).
+
+        The artifact must already be logged or fetched; unlike
+        `Run.link_artifact`, this does not log a draft artifact for you, and
+        the link records no publishing run. An artifact fetched from a Space or
+        a self-hosted server can only be linked into a bucket-backed registry,
+        since a local registry is not reachable from where its bytes live.
+
+        Args:
+            target_path (`str`):
+                The collection to link into, as
+                `"registry-<registry>/<collection>"`. The registry must
+                already exist.
+            aliases (`list[str]`, *optional*):
+                Aliases to place on the linked version. `latest` is managed
+                automatically; passing it is a no-op.
+            bucket_id (`str`, *optional*):
+                Bucket holding the registry, e.g. `"my-org/models-registry"`.
+                Omit for a local registry; defaults to
+                `TRACKIO_REGISTRY_BUCKET_ID` when that is set.
+
+        Returns:
+            The linked artifact at its registry location.
+        """
+        if not self._logged:
+            raise RuntimeError(
+                "Cannot link an Artifact that has not been logged or fetched. "
+                "Log it first with log_artifact, or fetch a version with "
+                "use_artifact, then link the result."
+            )
+        registry, collection = parse_collection_target(target_path)
+        return self._link_version(
+            registry, collection, aliases, None, None, bucket_id=bucket_id
+        )
+
+    def unlink(self) -> None:
+        """Remove this registry link.
+
+        Call this on the linked artifact returned by `link` or
+        `Run.link_artifact`, not on a source artifact version. The source
+        artifact and its files are untouched; only the collection membership
+        is removed. Aliases pointing at the link go with it, and the
+        collection version number is never reused. If the version held
+        `latest`, that alias moves to the highest remaining version.
+        """
+        if not self.is_link:
+            raise ValueError(
+                "unlink() removes a registry link; call it on the linked "
+                "artifact returned by link() or Run.link_artifact, not on a "
+                "source artifact version."
+            )
+        registry_backend(self._registry_bucket_id).unlink(
+            self._registry, self._name, self._version
+        )
+
+    def _resolve_link_source(self) -> tuple[str, str, int]:
+        """Coordinates ``(project, artifact, version)`` a link operation
+        records for this artifact. A registry-linked artifact links its
+        source version directly, so links never chain."""
+        if self.is_link:
+            return self._source_project, self._source_artifact, self._source_version
+        return self._project, self._name, self._version
+
+    def _link_version(
+        self,
+        registry: str,
+        collection: str,
+        aliases: list[str] | None,
+        run_name: str | None,
+        run_id: str | None,
+        bucket_id: str | None = None,
+    ) -> "Artifact":
+        """Link this logged artifact version into `registry`/`collection` and
+        return the linked artifact hydrated at its registry location.
+
+        A bucket-backed registry accepts a version whose bytes live on a Space
+        or a self-hosted server, because the link records where the source is
+        and every reader of the bucket can follow it. A local registry cannot:
+        it is reachable only from this machine, so linking remote bytes into it
+        would produce a pointer nobody else can resolve.
+        """
+        source_project, source_artifact, source_version = self._resolve_link_source()
+        if self.is_link:
+            utils._emit_nonfatal_warning(
+                f"Linking a linked artifact links its source version "
+                f"({self.source_qualified_name}) directly; registry links "
+                "never chain."
+            )
+        bucket_id = utils.resolve_registry_bucket_id(bucket_id)
+        if self._remote_source is not None and bucket_id is None:
+            raise NotImplementedError(
+                "Linking an artifact fetched from a Space or a self-hosted "
+                "server into a local registry is not supported. Pass "
+                "bucket_id= (or set TRACKIO_REGISTRY_BUCKET_ID) to publish "
+                "into a bucket-backed registry both sides can reach."
+            )
+        manifest = self._manifest or []
+        remote_source = self._remote_source or {}
+        link = registry_backend(bucket_id).link_artifact_version(
+            registry=registry,
+            collection=collection,
+            type=self._type,
+            source_project=source_project,
+            source_artifact=source_artifact,
+            source_version=source_version,
+            aliases=aliases,
+            run_name=run_name,
+            run_id=run_id,
+            source_space_id=remote_source.get("space_id"),
+            source_bucket_id=remote_source.get("bucket_id"),
+            source_server_base_url=remote_source.get("server_base_url"),
+        )
+        linked = Artifact._from_registry_link(
+            registry,
+            collection,
+            {
+                **link,
+                "source": {
+                    "type": self._type,
+                    "description": self._description,
+                    "metadata": self._metadata,
+                    "manifest": manifest,
+                    "manifest_digest": self._manifest_digest,
+                    "size_bytes": self._size or 0,
+                },
+            },
+            bucket_id=bucket_id,
+        )
+        if self._remote_source is not None:
+            linked._remote_source = dict(self._remote_source)
+        return linked
+
+    @classmethod
+    def _from_registry_link(
+        cls,
+        registry: str,
+        collection: str,
+        link: dict,
+        bucket_id: str | None = None,
+    ) -> "Artifact":
+        """Build the linked artifact at its registry location from a link
+        record. `bucket_id` is remembered so `unlink()` goes back to the same
+        registry the link was written to."""
+        source = link["source"]
+        linked = cls(
+            name=collection,
+            type=source["type"],
+            description=source.get("description"),
+            metadata=source.get("metadata"),
+        )
+        linked._hydrate_from_db(
+            project=registry_project_name(registry),
+            version=int(link["collection_version"]),
+            aliases=link["aliases"],
+            manifest=source["manifest"],
+            manifest_digest=source["manifest_digest"],
+            size_bytes=int(source["size_bytes"]),
+        )
+        linked._registry = registry
+        linked._registry_bucket_id = bucket_id
+        linked._source_project = link["source_project"]
+        linked._source_artifact = link["source_artifact"]
+        linked._source_version = int(link["source_version"])
+        return linked
+
+    @property
+    def references(self) -> list[dict]:
+        """Reference entries (each with `path`, `ref`, `size`, and a `digest`)
+        recorded via `add_reference`. These point at external data not stored in
+        Trackio; read them to work with the URIs without downloading (unlike
+        `download()`, which fetches them). Returns a fresh copy on each access;
+        empty if the artifact has no references or has not been logged yet."""
+        if self._manifest is None:
+            return []
+        return [dict(e) for e in self._manifest if references.is_reference_entry(e)]
+
+    def get_entry_uri(self, name: str) -> str | None:
+        """Return the URI recorded for the reference entry at logical path
+        `name`, or None if there is no reference entry with that name."""
+        if self._manifest is None:
+            return None
+        for entry in self._manifest:
+            if entry.get("path") == name and references.is_reference_entry(entry):
+                return entry["ref"]
+        return None
+
+    def __repr__(self) -> str:
+        parts: list[str] = [f"name={self._name!r}", f"type={self._type!r}"]
+        if self._version is not None:
+            parts.append(f"version=v{self._version}")
+        if self._aliases:
+            parts.append(f"aliases={list(self._aliases)!r}")
+        return f"Artifact({', '.join(parts)})"

trackio/asgi_app.py

@@ -0,0 +1,538 @@
+from __future__ import annotations
+
+import inspect
+import json
+import logging
+import math
+import secrets
+import tempfile
+import threading
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any, get_args, get_origin
+from urllib.parse import unquote
+
+from starlette.applications import Starlette
+from starlette.requests import Request
+from starlette.responses import FileResponse, JSONResponse, Response, StreamingResponse
+from starlette.routing import Route
+
+from trackio import utils
+from trackio.exceptions import TrackioAPIError
+from trackio.remote_client import HTTP_API_VERSION
+
+logger = logging.getLogger("trackio.asgi_app")
+
+_PACKAGE_JSON_PATH = Path(__file__).parent / "package.json"
+_TRACKIO_PACKAGE_VERSION = json.loads(_PACKAGE_JSON_PATH.read_text())["version"]
+
+
+def _normalize_allowed_file_roots(
+    allowed_file_roots: list[str | Path] | None,
+) -> tuple[Path, ...]:
+    roots = []
+    for root in allowed_file_roots or []:
+        roots.append(Path(root).resolve())
+    return tuple(roots)
+
+
+def _is_allowed_file_path(path: Path, allowed_roots: tuple[Path, ...]) -> bool:
+    resolved_path = path.resolve(strict=False)
+    for root in allowed_roots:
+        try:
+            resolved_path.relative_to(root)
+            return True
+        except ValueError:
+            continue
+    return False
+
+
+def _json_safe(data: Any) -> Any:
+    if data is None or isinstance(data, (str, bool, int)):
+        return data
+    if isinstance(data, float):
+        return data if math.isfinite(data) else None
+    if isinstance(data, dict):
+        return {k: _json_safe(v) for k, v in data.items()}
+    if isinstance(data, (list, tuple)):
+        return [_json_safe(v) for v in data]
+    if hasattr(data, "item"):
+        try:
+            return _json_safe(data.item())
+        except Exception:
+            pass
+    return str(data)
+
+
+def register_uploaded_temp_file(request: Request, file_path: str | Path) -> None:
+    resolved_path = Path(file_path).resolve(strict=False)
+    with request.app.state.uploaded_temp_files_lock:
+        request.app.state.uploaded_temp_files.add(resolved_path)
+
+
+def consume_uploaded_temp_file(request: Request, file_data: Any) -> Path:
+    file_path = file_data.get("path") if isinstance(file_data, dict) else None
+    if not isinstance(file_path, str) or not file_path:
+        raise TrackioAPIError("Expected uploaded file metadata with a valid path.")
+
+    resolved_path = Path(file_path).resolve(strict=False)
+    with request.app.state.uploaded_temp_files_lock:
+        if resolved_path not in request.app.state.uploaded_temp_files:
+            raise TrackioAPIError(
+                "Uploaded file was not created by this Trackio server."
+            )
+        request.app.state.uploaded_temp_files.remove(resolved_path)
+
+    if not resolved_path.is_file():
+        raise TrackioAPIError("Uploaded file is missing.")
+
+    return resolved_path
+
+
+def cleanup_uploaded_temp_file(file_path: str | Path) -> None:
+    try:
+        Path(file_path).unlink(missing_ok=True)
+    except Exception:
+        pass
+
+
+def _invoke_handler(
+    fn: Any,
+    request: Request,
+    args: list[Any] | None = None,
+    kwargs: dict[str, Any] | None = None,
+) -> Any:
+    sig = inspect.signature(fn)
+    params = list(sig.parameters.values())
+    positional_args: list[Any] = []
+    keyword_args: dict[str, Any] = {}
+    args = list(args or [])
+    kwargs = dict(kwargs or {})
+    data_index = 0
+
+    for param in params:
+        if param.name == "request":
+            keyword_args["request"] = request
+        elif param.kind == inspect.Parameter.VAR_POSITIONAL:
+            positional_args.extend(args[data_index:])
+            data_index = len(args)
+        elif param.kind == inspect.Parameter.VAR_KEYWORD:
+            keyword_args.update(kwargs)
+            kwargs.clear()
+        elif param.name in kwargs:
+            keyword_args[param.name] = kwargs.pop(param.name)
+        elif param.kind in (
+            inspect.Parameter.POSITIONAL_ONLY,
+            inspect.Parameter.POSITIONAL_OR_KEYWORD,
+        ) and data_index < len(args):
+            positional_args.append(args[data_index])
+            data_index += 1
+        elif param.default is inspect.Signature.empty and param.kind not in (
+            inspect.Parameter.VAR_POSITIONAL,
+            inspect.Parameter.VAR_KEYWORD,
+        ):
+            raise TrackioAPIError(f"Missing required parameter: {param.name}")
+
+    return fn(*positional_args, **keyword_args)
+
+
+async def version_handler(request: Request) -> Response:
+    mcp_enabled = bool(getattr(request.app.state, "mcp_enabled", False))
+    return JSONResponse(
+        {
+            "version": _TRACKIO_PACKAGE_VERSION,
+            "api_version": HTTP_API_VERSION,
+            "writes_paused": utils.writes_paused(),
+            "api_transport": "http",
+            "mcp_enabled": mcp_enabled,
+            "mcp_path": "/mcp" if mcp_enabled else None,
+        }
+    )
+
+
+def _json_schema_and_python_type(annotation: Any) -> tuple[dict[str, Any], str]:
+    if annotation is inspect.Parameter.empty:
+        return {"type": "object"}, "Any"
+    origin = get_origin(annotation)
+    args = get_args(annotation)
+    if origin is not None and args:
+        non_none = tuple(a for a in args if a is not type(None))
+        if len(non_none) == 1 and len(args) > 1:
+            return _json_schema_and_python_type(non_none[0])
+        if origin is list:
+            inner, py_inner = _json_schema_and_python_type(
+                args[0] if args else inspect.Parameter.empty
+            )
+            return {"type": "array", "items": inner}, f"list[{py_inner}]"
+        if origin is dict:
+            return {"type": "object"}, "dict"
+    if annotation in (str, bytes):
+        return {"type": "string"}, "str"
+    if annotation is int:
+        return {"type": "integer"}, "int"
+    if annotation is float:
+        return {"type": "number"}, "float"
+    if annotation is bool:
+        return {"type": "boolean"}, "bool"
+    name = getattr(annotation, "__name__", None)
+    if name:
+        return {"type": "object"}, name
+    return {"type": "object"}, "Any"
+
+
+def build_gradio_api_info(api_registry: dict[str, Any]) -> dict[str, Any]:
+    named_endpoints: dict[str, Any] = {}
+    for name in sorted(api_registry.keys()):
+        fn = api_registry[name]
+        if not callable(fn):
+            continue
+        sig = inspect.signature(fn)
+        parameters: list[dict[str, Any]] = []
+        for pname, param in sig.parameters.items():
+            if pname == "request":
+                continue
+            jtype, pytype = _json_schema_and_python_type(param.annotation)
+            has_default = param.default is not inspect.Parameter.empty
+            parameters.append(
+                {
+                    "label": pname,
+                    "parameter_name": pname,
+                    "parameter_has_default": has_default,
+                    "parameter_default": None if not has_default else param.default,
+                    "type": jtype,
+                    "python_type": {"type": pytype, "description": ""},
+                    "component": "Api",
+                    "example_input": None,
+                }
+            )
+        ret_ann = sig.return_annotation
+        if ret_ann is inspect.Signature.empty:
+            ret_ann = Any
+        rjtype, rpytype = _json_schema_and_python_type(ret_ann)
+        returns = [
+            {
+                "label": "result",
+                "type": rjtype,
+                "python_type": {"type": rpytype, "description": ""},
+                "component": "Api",
+            }
+        ]
+        named_endpoints[f"/{name}"] = {
+            "parameters": parameters,
+            "returns": returns,
+            "api_visibility": "public",
+        }
+    return {"named_endpoints": named_endpoints, "unnamed_endpoints": {}}
+
+
+_MAX_GRADIO_CALL_EVENTS = 256
+
+
+def _hf_token_value_is_unset(value: Any) -> bool:
+    if value is None:
+        return True
+    if isinstance(value, str) and value.strip() == "":
+        return True
+    return False
+
+
+def _authorization_bearer_token(request: Request) -> str | None:
+    auth = request.headers.get("authorization") or request.headers.get("Authorization")
+    if not auth:
+        return None
+    parts = auth.split()
+    if len(parts) != 2 or parts[0].lower() != "bearer":
+        return None
+    tok = parts[1].strip()
+    return tok or None
+
+
+def _maybe_apply_hf_token_from_authorization(
+    request: Request, fn: Any, args: list[Any], kwargs: dict[str, Any]
+) -> None:
+    if not utils.on_spaces():
+        return
+    token = _authorization_bearer_token(request)
+    if not token:
+        return
+    sig = inspect.signature(fn)
+    if "hf_token" not in sig.parameters:
+        return
+    params = [p for p in sig.parameters.values() if p.name != "request"]
+    names = [p.name for p in params]
+    if "hf_token" not in names:
+        return
+    idx = names.index("hf_token")
+    if "hf_token" in kwargs:
+        if _hf_token_value_is_unset(kwargs["hf_token"]):
+            kwargs["hf_token"] = token
+        return
+    if idx < len(args):
+        if _hf_token_value_is_unset(args[idx]):
+            args[idx] = token
+        return
+    kwargs["hf_token"] = token
+
+
+def _store_gradio_call_result(
+    request: Request, event_id: str, api_name: str, data: Any
+) -> None:
+    with request.app.state.gradio_call_events_lock:
+        d = request.app.state.gradio_call_events
+        while len(d) >= _MAX_GRADIO_CALL_EVENTS:
+            d.pop(next(iter(d)))
+        d[event_id] = {"api_name": api_name, "data": data}
+
+
+async def run_api_request(request: Request, api_name: str) -> Response:
+    api_registry = request.app.state.api_registry
+    fn = api_registry.get(api_name)
+    if fn is None:
+        return JSONResponse({"error": f"Unknown API: {api_name}"}, status_code=404)
+    if api_name in request.app.state.write_apis and utils.writes_paused():
+        return JSONResponse({"error": utils.WRITES_PAUSED_MESSAGE}, status_code=503)
+
+    try:
+        body = await request.json()
+    except Exception:
+        body = {}
+
+    args: list[Any] = []
+    kwargs: dict[str, Any] = {}
+    if isinstance(body, dict):
+        if "args" in body or "kwargs" in body:
+            args = body.get("args") or []
+            kwargs = body.get("kwargs") or {}
+        elif "data" in body and isinstance(body["data"], list):
+            args = body["data"]
+        else:
+            kwargs = body
+    elif isinstance(body, list):
+        args = body
+    elif body is not None:
+        args = [body]
+
+    if not isinstance(args, list):
+        args = [args]
+    if not isinstance(kwargs, dict):
+        kwargs = {}
+
+    _maybe_apply_hf_token_from_authorization(request, fn, args, kwargs)
+
+    try:
+        result = _invoke_handler(fn, request, args=args, kwargs=kwargs)
+        if inspect.isawaitable(result):
+            result = await result
+        return JSONResponse({"data": _json_safe(result)})
+    except TrackioAPIError as e:
+        return JSONResponse({"error": str(e)}, status_code=400)
+    except Exception as e:
+        return JSONResponse({"error": str(e)}, status_code=500)
+
+
+async def api_handler(request: Request) -> Response:
+    return await run_api_request(request, request.path_params["api_name"])
+
+
+async def gradio_api_info_handler(request: Request) -> Response:
+    return JSONResponse(
+        build_gradio_api_info(request.app.state.api_registry),
+        headers={"Cache-Control": "no-store"},
+    )
+
+
+async def gradio_call_post_handler(request: Request) -> Response:
+    api_name = request.path_params["api_name"]
+    resp = await run_api_request(request, api_name)
+    if resp.status_code != 200:
+        return resp
+    body = json.loads(bytes(resp.body).decode())
+    event_id = secrets.token_urlsafe(16)
+    _store_gradio_call_result(request, event_id, api_name, body["data"])
+    return JSONResponse({"event_id": event_id})
+
+
+async def gradio_call_poll_handler(request: Request) -> Response:
+    api_name = request.path_params["api_name"]
+    event_id = request.path_params["event_id"]
+    with request.app.state.gradio_call_events_lock:
+        event = request.app.state.gradio_call_events.pop(event_id, None)
+    if event is None:
+        logger.info("gradio_api poll: unknown or expired event_id")
+        return JSONResponse({"error": "Unknown or expired event_id"}, status_code=404)
+    if event.get("api_name") != api_name:
+        logger.info(
+            "gradio_api poll: api_name mismatch (path=%r, stored=%r)",
+            api_name,
+            event.get("api_name"),
+        )
+        with request.app.state.gradio_call_events_lock:
+            d = request.app.state.gradio_call_events
+            while len(d) >= _MAX_GRADIO_CALL_EVENTS:
+                d.pop(next(iter(d)))
+            d[event_id] = event
+        return JSONResponse({"error": "Unknown or expired event_id"}, status_code=404)
+
+    data = event["data"]
+    payload = json.dumps(_json_safe([data]))
+
+    async def sse() -> Any:
+        yield f"event: complete\ndata: {payload}\n\n"
+
+    return StreamingResponse(
+        sse(),
+        media_type="text/event-stream",
+        headers={
+            "Cache-Control": "no-store",
+            "X-Accel-Buffering": "no",
+        },
+    )
+
+
+async def upload_handler(request: Request) -> Response:
+    upload_authorizer = getattr(request.app.state, "upload_authorizer", None)
+    if callable(upload_authorizer):
+        try:
+            upload_authorizer(request)
+        except TrackioAPIError as e:
+            return JSONResponse({"error": str(e)}, status_code=400)
+
+    form = await request.form()
+    uploads = form.getlist("files")
+    saved_paths = []
+    for upload in uploads:
+        suffix = Path(getattr(upload, "filename", "") or "").suffix
+        with tempfile.NamedTemporaryFile(
+            delete=False,
+            prefix="trackio-upload-",
+            suffix=suffix,
+        ) as tmp:
+            tmp.write(await upload.read())
+            register_uploaded_temp_file(request, tmp.name)
+            saved_paths.append(tmp.name)
+    return JSONResponse({"paths": saved_paths})
+
+
+async def gradio_upload_alias_handler(request: Request) -> Response:
+    return await upload_handler(request)
+
+
+_DISALLOWED_FILE_SUFFIXES = frozenset(
+    {".db", ".db-journal", ".db-wal", ".db-shm", ".sqlite", ".sqlite3"}
+)
+
+
+async def file_handler(request: Request) -> Response:
+    fs_path = request.query_params.get("path")
+    if fs_path is None:
+        return Response("Missing path", status_code=400)
+    fp = Path(unquote(fs_path)).resolve(strict=False)
+    if fp.suffix.lower() in _DISALLOWED_FILE_SUFFIXES:
+        return Response("Not found", status_code=404)
+    if _is_allowed_file_path(fp, (utils.ARTIFACTS_DIR.resolve(),)):
+        return Response("Not found", status_code=404)
+    allowed_roots = getattr(request.app.state, "allowed_file_roots", ())
+    if fp.is_file() and _is_allowed_file_path(fp, allowed_roots):
+        return FileResponse(str(fp))
+    return Response("Not found", status_code=404)
+
+
+async def artifact_blob_handler(request: Request) -> Response:
+    from trackio import cas  # noqa: PLC0415
+    from trackio import server as _server  # noqa: PLC0415
+
+    project = request.path_params.get("project")
+    digest = request.path_params.get("digest")
+    try:
+        project = _server._validate_project_name(project)
+        digest = _server._validate_sha256_digest(digest)
+    except TrackioAPIError:
+        return Response("Not found", status_code=404)
+    blob = cas.blob_path(project, digest)
+    if not blob.is_file():
+        return Response("Not found", status_code=404)
+    return FileResponse(str(blob))
+
+
+def create_trackio_starlette_app(
+    oauth_routes: list[Route],
+    api_registry: dict[str, Any],
+    extra_routes: list[Any] | None = None,
+    write_apis: frozenset[str] = frozenset(),
+    mcp_lifespan: Any = None,
+    mcp_enabled: bool = False,
+    allowed_file_roots: list[str | Path] | None = None,
+    upload_authorizer: Callable[[Request], None] | None = None,
+) -> Starlette:
+    routes: list[Any] = list(oauth_routes)
+    routes.extend(
+        [
+            Route("/version", endpoint=version_handler, methods=["GET"]),
+            Route("/api/upload", endpoint=upload_handler, methods=["POST"]),
+            Route("/api/{api_name:str}", endpoint=api_handler, methods=["POST"]),
+            Route("/file", endpoint=file_handler, methods=["GET"]),
+            Route(
+                "/artifact_blob/{project:str}/{digest:str}",
+                endpoint=artifact_blob_handler,
+                methods=["GET"],
+            ),
+        ]
+    )
+    if utils.on_spaces():
+        routes.extend(
+            [
+                Route(
+                    "/gradio_api/info",
+                    endpoint=gradio_api_info_handler,
+                    methods=["GET"],
+                ),
+                Route(
+                    "/gradio_api/info/",
+                    endpoint=gradio_api_info_handler,
+                    methods=["GET"],
+                ),
+                Route(
+                    "/gradio_api/upload",
+                    endpoint=gradio_upload_alias_handler,
+                    methods=["POST"],
+                ),
+                Route(
+                    "/gradio_api/upload/",
+                    endpoint=gradio_upload_alias_handler,
+                    methods=["POST"],
+                ),
+                Route(
+                    "/gradio_api/call/{api_name:str}",
+                    endpoint=gradio_call_post_handler,
+                    methods=["POST"],
+                ),
+                Route(
+                    "/gradio_api/call/{api_name:str}/",
+                    endpoint=gradio_call_post_handler,
+                    methods=["POST"],
+                ),
+                Route(
+                    "/gradio_api/call/{api_name:str}/{event_id:str}",
+                    endpoint=gradio_call_poll_handler,
+                    methods=["GET"],
+                ),
+                Route(
+                    "/gradio_api/call/{api_name:str}/{event_id:str}/",
+                    endpoint=gradio_call_poll_handler,
+                    methods=["GET"],
+                ),
+            ]
+        )
+    routes.extend(extra_routes or [])
+    app = Starlette(routes=routes, lifespan=mcp_lifespan)
+    app.state.api_registry = api_registry
+    app.state.write_apis = write_apis
+    app.state.mcp_enabled = mcp_enabled
+    app.state.allowed_file_roots = _normalize_allowed_file_roots(allowed_file_roots)
+    app.state.upload_authorizer = upload_authorizer
+    app.state.uploaded_temp_files = set()
+    app.state.uploaded_temp_files_lock = threading.Lock()
+    if utils.on_spaces():
+        app.state.gradio_call_events = {}
+        app.state.gradio_call_events_lock = threading.Lock()
+    return app

trackio/bucket_storage.py

@@ -0,0 +1,214 @@
+import tempfile
+from pathlib import Path
+
+import huggingface_hub
+
+from trackio.cas import is_partial_blob
+from trackio.sqlite_storage import SQLiteStorage
+from trackio.utils import (
+    TRACKIO_DIR,
+    canonical_project_name,
+    project_artifacts_dir,
+    project_media_dir,
+)
+
+
+def create_bucket_if_not_exists(bucket_id: str, private: bool | None = None) -> None:
+    huggingface_hub.create_bucket(bucket_id, private=private, exist_ok=True)
+
+
+LOGBOOK_FILES_BUCKET_PREFIX = "logbook-files"
+
+
+def upload_logbook_path_artifacts_to_bucket(
+    bucket_id: str, entries: list[dict]
+) -> list[str]:
+    """Uploads local files referenced by path-artifact cells, preserving their
+    relative path under a stable bucket prefix. Returns the relative paths that
+    were actually uploaded (missing files are skipped)."""
+    additions: list[tuple[str, str]] = []
+    uploaded: list[str] = []
+    for entry in entries:
+        local_path = Path(entry["abs_path"])
+        if not local_path.is_file():
+            continue
+        remote_path = f"{LOGBOOK_FILES_BUCKET_PREFIX}/{entry['path']}"
+        additions.append((str(local_path), remote_path))
+        uploaded.append(entry["path"])
+    if additions:
+        huggingface_hub.batch_bucket_files(
+            bucket_id, add=additions, token=huggingface_hub.utils.get_token()
+        )
+    return uploaded
+
+
+def _list_bucket_file_paths(
+    bucket_id: str,
+    prefix: str | None = None,
+    token: str | bool | None = None,
+) -> list[str]:
+    items = huggingface_hub.list_bucket_tree(
+        bucket_id, prefix=prefix, recursive=True, token=token
+    )
+    return [
+        item.path
+        for item in items
+        if getattr(item, "type", None) == "file" and getattr(item, "path", None)
+    ]
+
+
+def download_bucket_to_trackio_dir(bucket_id: str) -> None:
+    TRACKIO_DIR.mkdir(parents=True, exist_ok=True)
+    huggingface_hub.sync_bucket(
+        source=f"hf://buckets/{bucket_id}/trackio",
+        dest=str(TRACKIO_DIR),
+        quiet=True,
+    )
+
+
+def upload_project_to_bucket(project: str, bucket_id: str) -> None:
+    db_path = SQLiteStorage.get_project_db_path(project)
+    if not db_path.exists():
+        raise FileNotFoundError(f"No database found for project '{project}'")
+
+    with SQLiteStorage._get_connection(
+        db_path, configure_pragmas=False, row_factory=None
+    ) as conn:
+        conn.execute("PRAGMA wal_checkpoint(TRUNCATE)")
+
+    files_to_add = [(str(db_path), f"trackio/{db_path.name}")]
+
+    media_dir = project_media_dir(project)
+    if media_dir.exists():
+        for media_file in media_dir.rglob("*"):
+            if media_file.is_file():
+                rel = media_file.relative_to(TRACKIO_DIR)
+                files_to_add.append((str(media_file), f"trackio/{rel.as_posix()}"))
+
+    artifacts_dir = project_artifacts_dir(project)
+    if artifacts_dir.exists():
+        for blob_file in artifacts_dir.rglob("*"):
+            if not blob_file.is_file():
+                continue
+            if is_partial_blob(blob_file.name):
+                continue
+            rel = blob_file.relative_to(TRACKIO_DIR)
+            files_to_add.append((str(blob_file), f"trackio/{rel.as_posix()}"))
+
+    huggingface_hub.batch_bucket_files(bucket_id, add=files_to_add)
+
+
+def _download_db_from_bucket(
+    project: str, bucket_id: str, dest_path: Path | None = None
+) -> bool:
+    db_filename = SQLiteStorage.get_project_db_filename(project)
+    remote_path = f"trackio/{db_filename}"
+    local_path = dest_path or SQLiteStorage.get_project_db_path(project)
+    local_path.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        huggingface_hub.download_bucket_files(
+            bucket_id,
+            files=[(remote_path, str(local_path))],
+            token=huggingface_hub.utils.get_token(),
+        )
+        return local_path.exists()
+    except Exception:
+        return False
+
+
+def _local_db_has_data(project: str) -> bool:
+    db_path = SQLiteStorage.get_project_db_path(project)
+    if not db_path.exists() or db_path.stat().st_size == 0:
+        return False
+    try:
+        with SQLiteStorage._get_connection(
+            db_path, configure_pragmas=False, row_factory=None
+        ) as conn:
+            count = conn.execute("SELECT COUNT(*) FROM metrics").fetchone()[0]
+            return count > 0
+    except Exception:
+        return False
+
+
+def _export_and_upload_static(
+    project: str,
+    dest_bucket_id: str,
+    db_path: Path,
+    media_dir: Path | None = None,
+    artifacts_dir: Path | None = None,
+) -> None:
+    with tempfile.TemporaryDirectory() as tmp_dir:
+        output_dir = Path(tmp_dir)
+        SQLiteStorage.export_for_static_space(
+            project, output_dir, db_path_override=db_path
+        )
+
+        files_to_add = []
+        for f in output_dir.rglob("*"):
+            if f.is_file():
+                rel = f.relative_to(output_dir)
+                files_to_add.append((str(f), rel.as_posix()))
+
+        if media_dir and media_dir.exists():
+            for f in media_dir.rglob("*"):
+                if f.is_file():
+                    rel = f.relative_to(media_dir)
+                    files_to_add.append((str(f), f"media/{rel.as_posix()}"))
+
+        if artifacts_dir and artifacts_dir.exists():
+            for f in artifacts_dir.rglob("*"):
+                if f.is_file() and not is_partial_blob(f.name):
+                    rel = f.relative_to(artifacts_dir)
+                    files_to_add.append((str(f), f"artifacts/{rel.as_posix()}"))
+
+        huggingface_hub.batch_bucket_files(dest_bucket_id, add=files_to_add)
+
+
+def _copy_project_prefix_between_buckets(
+    source_bucket_id: str, dest_bucket_id: str, project: str, kind: str
+) -> None:
+    source_prefix = f"trackio/{kind}/{canonical_project_name(project)}/"
+    files_to_copy = _list_bucket_file_paths(source_bucket_id, prefix=source_prefix)
+    if not files_to_copy:
+        return
+
+    huggingface_hub.copy_files(
+        f"hf://buckets/{source_bucket_id}/{source_prefix}",
+        f"hf://buckets/{dest_bucket_id}/{kind}/",
+    )
+
+
+def upload_project_to_bucket_for_static(project: str, bucket_id: str) -> None:
+    if not _local_db_has_data(project):
+        _download_db_from_bucket(project, bucket_id)
+
+    db_path = SQLiteStorage.get_project_db_path(project)
+    _export_and_upload_static(
+        project,
+        bucket_id,
+        db_path,
+        project_media_dir(project),
+        project_artifacts_dir(project),
+    )
+
+
+def export_from_bucket_for_static(
+    source_bucket_id: str,
+    dest_bucket_id: str,
+    project: str,
+) -> None:
+    with tempfile.TemporaryDirectory() as work_dir:
+        work_path = Path(work_dir)
+        db_path = work_path / SQLiteStorage.get_project_db_filename(project)
+
+        if not _download_db_from_bucket(project, source_bucket_id, dest_path=db_path):
+            raise FileNotFoundError(
+                f"Could not download database for project '{project}' "
+                f"from bucket '{source_bucket_id}'."
+            )
+
+        _export_and_upload_static(project, dest_bucket_id, db_path)
+        for kind in ("media", "artifacts"):
+            _copy_project_prefix_between_buckets(
+                source_bucket_id, dest_bucket_id, project, kind
+            )

trackio/bump.py

@@ -0,0 +1,614 @@
+"""Upgrade an existing Trackio Space to the locally installed Trackio version.
+
+`bump()` either upgrades a Space in place or duplicates it (and its bucket) into
+a new Space running the local version. The Space's SQLite databases live in the
+Hugging Face Bucket mounted at `/data`; the new Trackio server migrates them when
+it opens them on boot. While an in-place bump is in progress the Space is paused,
+so training clients write their logs to the bucket inbox as JSONL fragments,
+which the upgraded Space imports once it is running again.
+"""
+
+import io
+import json
+import re
+import sqlite3
+import tempfile
+import time
+from datetime import datetime, timezone
+from pathlib import Path
+
+import httpx
+import huggingface_hub
+from huggingface_hub.errors import (
+    BucketNotFoundError,
+    HfHubHTTPError,
+    RepositoryNotFoundError,
+)
+
+import trackio
+from trackio import deploy
+from trackio.bucket_storage import _list_bucket_file_paths, create_bucket_if_not_exists
+from trackio.remote_client import RemoteClient, _space_id_to_url
+from trackio.sqlite_storage import DB_EXT, SCHEMA_VERSION, SQLiteStorage
+from trackio.utils import PAUSE_WRITES_VARIABLE, preprocess_space_and_dataset_ids
+
+MIN_BUMPABLE_VERSION = "0.21.0"
+BACKUP_PREFIX = "trackio-backups"
+DB_PREFIX = "trackio/"
+_JOURNAL_SUFFIX = "-journal"
+_REQUIREMENT_PATTERN = re.compile(
+    r"^\s*trackio(?:\[[^\]]*\])?\s*==\s*([0-9][0-9A-Za-z.+\-]*)\s*$"
+)
+_VERSION_PATTERN = re.compile(r"^(\d+)\.(\d+)\.(\d+)$")
+_MANAGED_VARIABLES = frozenset({"TRACKIO_DIR", "TRACKIO_BUCKET_ID"})
+_RUN_COUNT_PAGE_SIZE = 5000
+_FAILURE_STAGES = frozenset(
+    ("NO_APP_FILE", "CONFIG_ERROR", "BUILD_ERROR", "RUNTIME_ERROR")
+)
+
+
+class BumpError(RuntimeError):
+    pass
+
+
+def _version_tuple(version: str) -> tuple[int, int, int] | None:
+    match = _VERSION_PATTERN.match(version)
+    if match is None:
+        return None
+    return tuple(int(part) for part in match.groups())
+
+
+def get_space_trackio_version(
+    space_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> str | None:
+    """
+    Returns the Trackio version a Space is configured to run, read from its
+    `requirements.txt` pin, or from `trackio/package.json` for Spaces deployed from
+    a source install. Returns `None` when the version cannot be determined.
+    """
+    hf_api = hf_api or huggingface_hub.HfApi()
+    try:
+        path = hf_api.hf_hub_download(space_id, "requirements.txt", repo_type="space")
+        for line in Path(path).read_text(encoding="utf-8").splitlines():
+            if match := _REQUIREMENT_PATTERN.match(line):
+                return match.group(1)
+    except (HfHubHTTPError, OSError):
+        pass
+    try:
+        path = hf_api.hf_hub_download(
+            space_id, "trackio/package.json", repo_type="space"
+        )
+        return json.loads(Path(path).read_text(encoding="utf-8")).get("version")
+    except (HfHubHTTPError, OSError, ValueError):
+        return None
+
+
+def _check_bumpable(space_id: str, space_version: str | None) -> str:
+    local = _version_tuple(trackio.__version__)
+    if local is None:
+        raise BumpError(
+            f"The local Trackio version {trackio.__version__!r} is not a final "
+            "release, so it cannot be compared safely with the Space's version."
+        )
+    if space_version is None:
+        raise BumpError(
+            f"Could not determine which Trackio version Space '{space_id}' runs. "
+            "`trackio bump` only supports Spaces deployed by Trackio."
+        )
+    remote = _version_tuple(space_version)
+    if remote is None:
+        raise BumpError(
+            f"Space '{space_id}' pins Trackio {space_version!r}, which is not a final "
+            "release that `trackio bump` can compare safely."
+        )
+    if remote < _version_tuple(MIN_BUMPABLE_VERSION):
+        raise BumpError(
+            f"Space '{space_id}' runs Trackio {space_version}, which is older than "
+            f"{MIN_BUMPABLE_VERSION}, the oldest version `trackio bump` supports."
+        )
+    if remote > local:
+        raise BumpError(
+            f"Space '{space_id}' runs Trackio {space_version}, which is newer than the "
+            f"local Trackio {trackio.__version__}. Upgrade Trackio locally instead of downgrading the Space."
+        )
+    return space_version
+
+
+def _bucket_db_paths(bucket_id: str, prefix: str = DB_PREFIX) -> list[str]:
+    return sorted(
+        path
+        for path in _list_bucket_file_paths(bucket_id, prefix=prefix)
+        if "/" not in path[len(prefix) :]
+        and (path.endswith(DB_EXT) or path.endswith(DB_EXT + _JOURNAL_SUFFIX))
+    )
+
+
+def _db_inventory(db_path: Path) -> dict:
+    conn = sqlite3.connect(f"file:{db_path}?mode=ro&immutable=1", uri=True)
+    try:
+        tables = [
+            row[0]
+            for row in conn.execute(
+                "SELECT name FROM sqlite_master "
+                "WHERE type = 'table' AND name NOT LIKE 'sqlite_%'"
+            )
+        ]
+        counts = {
+            table: conn.execute(f'SELECT COUNT(*) FROM "{table}"').fetchone()[0]
+            for table in tables
+        }
+        runs = {}
+        if "metrics" in tables:
+            runs = dict(
+                conn.execute("SELECT run_name, COUNT(*) FROM metrics GROUP BY run_name")
+            )
+        return {"tables": counts, "metric_rows_per_run": runs}
+    finally:
+        conn.close()
+
+
+def bucket_inventory(bucket_id: str, prefix: str = DB_PREFIX) -> dict[str, dict]:
+    """
+    Downloads every project database under `prefix` in a bucket and returns, per
+    database filename, the row count of each table and the metric rows per run.
+    """
+    db_paths = [p for p in _bucket_db_paths(bucket_id, prefix) if p.endswith(DB_EXT)]
+    inventory = {}
+    with tempfile.TemporaryDirectory() as work_dir:
+        for remote_path in db_paths:
+            filename = remote_path.rsplit("/", 1)[-1]
+            local_path = Path(work_dir) / filename
+            huggingface_hub.download_bucket_files(
+                bucket_id,
+                files=[(remote_path, str(local_path))],
+                token=huggingface_hub.utils.get_token(),
+            )
+            inventory[filename] = _db_inventory(local_path)
+    return inventory
+
+
+def _served_version_info(space_id: str) -> dict:
+    headers = {}
+    if token := huggingface_hub.utils.get_token():
+        headers["Authorization"] = f"Bearer {token}"
+    try:
+        response = httpx.get(
+            _space_id_to_url(space_id) + "version", headers=headers, timeout=30
+        )
+        response.raise_for_status()
+        return response.json()
+    except (httpx.HTTPError, ValueError):
+        return {}
+
+
+def _wait_for_version_info(space_id: str, expected: dict, timeout: int = 300) -> None:
+    deadline = time.time() + timeout
+    info = {}
+    while time.time() < deadline:
+        info = _served_version_info(space_id)
+        if all(info.get(key) == value for key, value in expected.items()):
+            return
+        time.sleep(5)
+    raise BumpError(
+        f"Space '{space_id}' reports {info or 'nothing'}, expected {expected}."
+    )
+
+
+def _metric_rows_per_run(client: RemoteClient, project: str) -> dict[str, int]:
+    counts = {}
+    offset = 0
+    while True:
+        rows = client.predict(
+            project,
+            "SELECT run_name, COUNT(*) AS n FROM metrics GROUP BY run_name "
+            f"ORDER BY run_name LIMIT {_RUN_COUNT_PAGE_SIZE} OFFSET {offset}",
+            api_name="/query_project",
+        )["rows"]
+        counts.update((row["run_name"], row["n"]) for row in rows)
+        if len(rows) < _RUN_COUNT_PAGE_SIZE:
+            return counts
+        offset += _RUN_COUNT_PAGE_SIZE
+
+
+def verify_space_serves_inventory(space_id: str, inventory: dict[str, dict]) -> None:
+    """
+    Checks that a running Space serves the local Trackio version, that every
+    project database reached the local `SCHEMA_VERSION`, and that every table
+    still holds at least the rows recorded in `inventory`. Rows can only grow,
+    since the Space may import inbox fragments.
+    """
+    _wait_for_version_info(space_id, {"version": trackio.__version__})
+    client = RemoteClient(
+        space_id, hf_token=huggingface_hub.utils.get_token(), verbose=False
+    )
+    projects = client.predict(api_name="/get_all_projects")
+    by_filename = {SQLiteStorage.get_project_db_filename(p): p for p in projects}
+    for filename, expected in inventory.items():
+        project = by_filename.get(filename)
+        if project is None:
+            raise BumpError(
+                f"Space '{space_id}' no longer lists the project stored in {filename}."
+            )
+        result = client.predict(
+            project, "PRAGMA user_version", api_name="/query_project"
+        )
+        schema_version = result["rows"][0]["user_version"]
+        if schema_version != SCHEMA_VERSION:
+            raise BumpError(
+                f"Project '{project}' is at schema version {schema_version} after the "
+                f"bump, expected {SCHEMA_VERSION}."
+            )
+        for table, count in expected["tables"].items():
+            result = client.predict(
+                project,
+                f'SELECT COUNT(*) AS n FROM "{table}"',
+                api_name="/query_project",
+            )
+            actual = result["rows"][0]["n"]
+            if actual < count:
+                raise BumpError(
+                    f"Project '{project}' table '{table}' has {actual} rows after the "
+                    f"bump, expected at least {count}."
+                )
+        actual_runs = _metric_rows_per_run(client, project)
+        for run, count in expected["metric_rows_per_run"].items():
+            if actual_runs.get(run, 0) < count:
+                raise BumpError(
+                    f"Run '{run}' in project '{project}' has {actual_runs.get(run, 0)} "
+                    f"metric rows after the bump, expected at least {count}."
+                )
+
+
+def _wait_for_stage(
+    space_id: str,
+    targets: frozenset[str],
+    timeout: int,
+    hf_api: huggingface_hub.HfApi,
+) -> None:
+    deadline = time.time() + timeout
+    stage = None
+    while time.time() < deadline:
+        try:
+            runtime = hf_api.get_space_runtime(space_id)
+            stage = str(runtime.stage)
+        except (HfHubHTTPError, httpx.RequestError):
+            stage = None
+        if stage in targets:
+            return
+        if stage in _FAILURE_STAGES and not targets & _FAILURE_STAGES:
+            raise BumpError(
+                f"Space '{space_id}' entered {stage}. Check its logs on the Hub."
+            )
+        time.sleep(5)
+    raise BumpError(
+        f"Space '{space_id}' did not reach {'/'.join(sorted(targets))} within "
+        f"{timeout}s (last stage: {stage})."
+    )
+
+
+def _runtime_operations(
+    space_id: str, hf_api: huggingface_hub.HfApi, revision: str
+) -> list[huggingface_hub.CommitOperationAdd]:
+    repo_files = set(
+        hf_api.list_repo_files(space_id, repo_type="space", revision=revision)
+    )
+    has_custom_frontend = any(
+        f.startswith(deploy._CUSTOM_SPACE_FRONTEND_DIR + "/") for f in repo_files
+    )
+    if deploy._is_trackio_installed_from_source():
+        requirements = deploy._get_source_install_dependencies()
+    else:
+        requirements = deploy._get_space_install_requirement()
+    app_py = deploy._space_app_py(
+        deploy._CUSTOM_SPACE_FRONTEND_DIR if has_custom_frontend else None
+    )
+    operations = [
+        huggingface_hub.CommitOperationAdd(
+            "requirements.txt", io.BytesIO(requirements.encode("utf-8"))
+        ),
+        huggingface_hub.CommitOperationAdd(
+            "app.py", io.BytesIO(app_py.encode("utf-8"))
+        ),
+    ]
+    if (
+        "trackio/__init__.py" in repo_files
+        and not deploy._is_trackio_installed_from_source()
+    ):
+        operations.append(
+            huggingface_hub.CommitOperationDelete("trackio/", is_folder=True)
+        )
+    return operations
+
+
+def _copy_bucket_paths(bucket_id: str, pairs: list[tuple[str, str]]) -> None:
+    for source, destination in pairs:
+        huggingface_hub.copy_files(
+            f"hf://buckets/{bucket_id}/{source}",
+            f"hf://buckets/{bucket_id}/{destination}",
+        )
+
+
+def _bump_in_place(
+    space_id: str,
+    bucket_id: str,
+    space_version: str,
+    hf_api: huggingface_hub.HfApi,
+    timeout: int,
+) -> str:
+    local_version = trackio.__version__
+    stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+    backup_prefix = f"{BACKUP_PREFIX}/{space_version}-to-{local_version}-{stamp}/"
+
+    base_commit = hf_api.repo_info(space_id, repo_type="space").sha
+    with tempfile.TemporaryDirectory() as snapshot_dir:
+        hf_api.snapshot_download(
+            space_id,
+            repo_type="space",
+            revision=base_commit,
+            local_dir=snapshot_dir,
+            max_workers=4,
+        )
+        print(f"* Pausing {space_id}; new logs will queue in the bucket inbox")
+        hf_api.pause_space(space_id)
+        _wait_for_stage(space_id, frozenset({"PAUSED"}), 300, hf_api)
+
+        try:
+            db_paths = _bucket_db_paths(bucket_id)
+            backups = [
+                (path, backup_prefix + path[len(DB_PREFIX) :]) for path in db_paths
+            ]
+            _copy_bucket_paths(bucket_id, backups)
+            print(
+                f"* Backed up {len(db_paths)} database files to "
+                f"hf://buckets/{bucket_id}/{backup_prefix}"
+            )
+            inventory = bucket_inventory(bucket_id, prefix=backup_prefix)
+        except Exception as e:
+            hf_api.restart_space(space_id)
+            raise BumpError(
+                f"Backing up '{space_id}' failed before anything was changed, so the "
+                f"Space was restarted on Trackio {space_version}: {e}"
+            ) from e
+
+        bump_commit = None
+        try:
+            print(
+                f"* Updating {space_id} from Trackio {space_version} to {local_version}"
+            )
+            bump_commit = hf_api.create_commit(
+                space_id,
+                operations=_runtime_operations(space_id, hf_api, base_commit),
+                commit_message=f"Bump Trackio to {local_version}",
+                repo_type="space",
+                parent_commit=base_commit,
+            ).oid
+            if deploy._is_trackio_installed_from_source():
+                bump_commit = deploy._upload_source_tree(
+                    hf_api, space_id, parent_commit=bump_commit
+                ).oid
+            hf_api.add_space_variable(space_id, PAUSE_WRITES_VARIABLE, "1")
+            hf_api.restart_space(space_id)
+            print("* Waiting for the Space to rebuild and migrate its data")
+            _wait_for_stage(space_id, frozenset({"RUNNING"}), timeout, hf_api)
+            _wait_for_version_info(space_id, {"writes_paused": True})
+            verify_space_serves_inventory(space_id, inventory)
+        except Exception as e:
+            print(f"* Bump failed ({e}); restoring Trackio {space_version}")
+            _rollback(
+                space_id,
+                bucket_id,
+                backups,
+                Path(snapshot_dir),
+                bump_commit,
+                hf_api,
+                timeout,
+            )
+            raise BumpError(
+                f"Bumping '{space_id}' failed and was rolled back to Trackio "
+                f"{space_version}: {e}"
+            ) from e
+
+    print("* Verified; resuming writes and importing the queued inbox")
+    hf_api.delete_space_variable(space_id, PAUSE_WRITES_VARIABLE)
+    try:
+        _wait_for_stage(space_id, frozenset({"RUNNING"}), timeout, hf_api)
+        _wait_for_version_info(
+            space_id, {"version": local_version, "writes_paused": False}, timeout
+        )
+    except BumpError as e:
+        raise BumpError(
+            f"{space_id} was upgraded to Trackio {local_version} and verified, but "
+            f"did not resume writes: {e} Restart the Space once it is healthy."
+        ) from e
+    print(
+        f"* {space_id} now runs Trackio {local_version}: "
+        f"{deploy.SPACE_URL.format(space_id=space_id)}"
+    )
+    return space_id
+
+
+def _rollback(
+    space_id: str,
+    bucket_id: str,
+    backups: list[tuple[str, str]],
+    snapshot_dir: Path,
+    bump_commit: str | None,
+    hf_api: huggingface_hub.HfApi,
+    timeout: int,
+) -> None:
+    hf_api.pause_space(space_id)
+    _wait_for_stage(space_id, frozenset({"PAUSED"}), 300, hf_api)
+    _copy_bucket_paths(bucket_id, [(backup, path) for path, backup in backups])
+    try:
+        _delete_space_variable(space_id, PAUSE_WRITES_VARIABLE, hf_api)
+        if bump_commit is not None:
+            hf_api.upload_folder(
+                repo_id=space_id,
+                repo_type="space",
+                folder_path=snapshot_dir,
+                ignore_patterns=[".cache/**"],
+                delete_patterns=["*", "**/*"],
+                commit_message="Roll back failed Trackio bump",
+                parent_commit=bump_commit,
+            )
+    finally:
+        hf_api.restart_space(space_id)
+    _wait_for_stage(space_id, frozenset({"RUNNING"}) | _FAILURE_STAGES, timeout, hf_api)
+
+
+def _delete_space_variable(
+    space_id: str, key: str, hf_api: huggingface_hub.HfApi
+) -> None:
+    if key in hf_api.get_space_variables(space_id):
+        hf_api.delete_space_variable(space_id, key)
+
+
+def _bump_into_new_space(
+    space_id: str,
+    bucket_id: str,
+    new_space_id: str,
+    new_bucket_id: str,
+    private: bool,
+    hf_api: huggingface_hub.HfApi,
+    timeout: int,
+) -> str:
+    try:
+        hf_api.space_info(new_space_id)
+        raise BumpError(f"Space '{new_space_id}' already exists.")
+    except RepositoryNotFoundError:
+        pass
+    try:
+        if _list_bucket_file_paths(new_bucket_id):
+            raise BumpError(
+                f"Bucket '{new_bucket_id}' already exists and is not empty."
+            )
+    except BucketNotFoundError:
+        pass
+
+    created_bucket = not deploy._bucket_exists(new_bucket_id, hf_api)
+    try:
+        create_bucket_if_not_exists(
+            new_bucket_id, private=bool(hf_api.bucket_info(bucket_id).private)
+        )
+        if _list_bucket_file_paths(bucket_id):
+            print(f"* Copying hf://buckets/{bucket_id} to hf://buckets/{new_bucket_id}")
+            huggingface_hub.copy_files(
+                f"hf://buckets/{bucket_id}/",
+                f"hf://buckets/{new_bucket_id}/",
+            )
+        inventory = bucket_inventory(new_bucket_id)
+
+        print(f"* Creating {new_space_id} with Trackio {trackio.__version__}")
+        deploy.deploy_as_space(new_space_id, bucket_id=new_bucket_id, private=private)
+        for key, variable in hf_api.get_space_variables(space_id).items():
+            if key not in _MANAGED_VARIABLES:
+                hf_api.add_space_variable(new_space_id, key, variable.value)
+        _wait_for_stage(new_space_id, frozenset({"RUNNING"}), timeout, hf_api)
+        verify_space_serves_inventory(new_space_id, inventory)
+    except Exception as e:
+        print(f"* Bump failed ({e}); removing {new_space_id} and its copied data")
+        try:
+            _remove_new_space(new_space_id, new_bucket_id, created_bucket, hf_api)
+        except Exception as cleanup_error:
+            print(f"* Could not remove {new_space_id}: {cleanup_error}")
+        raise BumpError(
+            f"Copying '{space_id}' into '{new_space_id}' failed and the new Space "
+            f"was removed; '{space_id}' was not modified: {e}"
+        ) from e
+    print(
+        f"* {new_space_id} runs Trackio {trackio.__version__} with a copy of "
+        f"{space_id}'s data: {deploy.SPACE_URL.format(space_id=new_space_id)}"
+    )
+    return new_space_id
+
+
+def _remove_new_space(
+    new_space_id: str,
+    new_bucket_id: str,
+    created_bucket: bool,
+    hf_api: huggingface_hub.HfApi,
+) -> None:
+    hf_api.delete_repo(new_space_id, repo_type="space", missing_ok=True)
+    if created_bucket:
+        hf_api.delete_bucket(new_bucket_id, missing_ok=True)
+        return
+    copied = _list_bucket_file_paths(new_bucket_id)
+    if copied:
+        huggingface_hub.batch_bucket_files(new_bucket_id, delete=copied)
+
+
+def bump(
+    space_id: str,
+    new_space_id: str | None = None,
+    new_bucket_id: str | None = None,
+    timeout: int = 1800,
+) -> str:
+    """
+    Upgrades a Trackio Space to the locally installed Trackio version.
+
+    Without `new_space_id`, the Space is upgraded in place: it is paused (clients
+    keep logging to the bucket inbox), its databases are backed up inside its
+    bucket, its Trackio pin is updated and it is restarted so the new server
+    migrates the data. If the Space fails to come back or loses data, the backup
+    and the previous Space files are restored.
+
+    With `new_space_id`, the source Space is left untouched and its bucket data is
+    copied into `new_bucket_id`, which backs a new Space running the local version.
+
+    Args:
+        space_id (`str`):
+            The Trackio Space to upgrade. Must run Trackio 0.21.0 or newer with a
+            bucket mounted at `/data`.
+        new_space_id (`str`, *optional*):
+            Create this Space from a copy of `space_id` instead of upgrading in place.
+        new_bucket_id (`str`, *optional*):
+            The bucket for `new_space_id`. Defaults to `{new_space_id}-bucket`.
+        timeout (`int`, *optional*, defaults to `1800`):
+            Seconds to wait for the upgraded Space to build and start.
+
+    Returns:
+        `str`: The ID of the Space now running the local Trackio version.
+    """
+    if new_bucket_id is not None and new_space_id is None:
+        raise BumpError("new_bucket_id requires new_space_id.")
+    space_id, _, _ = preprocess_space_and_dataset_ids(space_id, None, None)
+    hf_api = huggingface_hub.HfApi()
+    try:
+        info = hf_api.space_info(space_id)
+    except RepositoryNotFoundError:
+        raise BumpError(f"Space '{space_id}' not found.")
+    if info.sdk != "gradio":
+        raise BumpError(
+            f"Space '{space_id}' is not a Trackio Gradio Space (sdk={info.sdk!r})."
+        )
+    bucket_id = deploy._get_existing_space_bucket(space_id, hf_api=hf_api)
+    if bucket_id is None:
+        raise BumpError(
+            f"Space '{space_id}' has no bucket mounted at '/data'. "
+            "`trackio bump` requires bucket storage."
+        )
+    space_version = _check_bumpable(
+        space_id, get_space_trackio_version(space_id, hf_api)
+    )
+
+    if new_space_id is not None:
+        new_space_id, _, auto_bucket_id = preprocess_space_and_dataset_ids(
+            new_space_id, None, new_bucket_id
+        )
+        return _bump_into_new_space(
+            space_id,
+            bucket_id,
+            new_space_id,
+            auto_bucket_id,
+            bool(info.private),
+            hf_api,
+            timeout,
+        )
+
+    if (
+        space_version == trackio.__version__
+        and not deploy._is_trackio_installed_from_source()
+    ):
+        print(f"* {space_id} already runs Trackio {space_version}")
+        return space_id
+    return _bump_in_place(space_id, bucket_id, space_version, hf_api, timeout)

trackio/cas.py

@@ -0,0 +1,214 @@
+"""Content-addressed storage (CAS) helpers shared by the artifact client,
+server, and storage layers.
+"""
+
+import hashlib
+import os
+import re
+import uuid
+from collections.abc import Iterable, Iterator
+from pathlib import Path
+
+from trackio import utils
+from trackio.typehints import Sha256Digest
+
+SHA256_DIGEST_RE = re.compile(r"^[0-9a-f]{64}$")
+ARTIFACT_VERSION_SPEC_RE = re.compile(r"^v(\d+)$")
+ARTIFACT_NAME_RE = re.compile(r"^[A-Za-z0-9._-]+\Z")
+HASH_CHUNK_SIZE = 1024 * 1024
+PARTIAL_BLOB_MARKER = ".partial."
+PARTIAL_BLOB_GLOB = f"*{PARTIAL_BLOB_MARKER}*"
+
+
+def partial_blob_name(base: str = "") -> str:
+    """Temp filename for an in-flight blob write, excluded from sync/export."""
+    return f"{base}{PARTIAL_BLOB_MARKER}{uuid.uuid4().hex}"
+
+
+def is_partial_blob(filename: str) -> bool:
+    return PARTIAL_BLOB_MARKER in filename
+
+
+def validate_artifact_name(name: str) -> str:
+    if not isinstance(name, str) or not ARTIFACT_NAME_RE.match(name):
+        raise ValueError(
+            f"Artifact name {name!r} must match ^[A-Za-z0-9._-]+$ "
+            "(letters, digits, dot, underscore, hyphen)."
+        )
+    return name
+
+
+def validate_aliases(aliases: list[str] | None) -> list[str]:
+    if aliases is None:
+        return []
+    if isinstance(aliases, str) or not isinstance(aliases, (list, tuple)):
+        raise ValueError(
+            f"aliases must be a list of strings, got {type(aliases).__name__}."
+        )
+    validated: list[str] = []
+    for alias in aliases:
+        if not isinstance(alias, str) or not alias:
+            raise ValueError(f"Alias {alias!r} must be a non-empty string.")
+        if not ARTIFACT_NAME_RE.match(alias):
+            raise ValueError(
+                f"Alias {alias!r} must match ^[A-Za-z0-9._-]+$ "
+                "(letters, digits, dot, underscore, hyphen)."
+            )
+        if ARTIFACT_VERSION_SPEC_RE.match(alias):
+            raise ValueError(
+                f"Alias {alias!r} is reserved for version pointers (vN); "
+                "choose another."
+            )
+        validated.append(alias)
+    return validated
+
+
+def _project_blobs_root(project: str) -> Path:
+    return utils.project_artifacts_dir(project) / "blobs" / "sha256"
+
+
+def blob_path(project: str, digest: Sha256Digest) -> Path:
+    return _project_blobs_root(project) / digest[:2] / digest
+
+
+def hash_file(path: Path) -> tuple[Sha256Digest, int]:
+    size = path.stat().st_size
+    file_digest = getattr(hashlib, "file_digest", None)
+    if file_digest is not None:
+        with path.open("rb") as f:
+            sha = file_digest(f, "sha256")
+    else:
+        sha = hashlib.sha256()
+        with path.open("rb") as f:
+            while chunk := f.read(HASH_CHUNK_SIZE):
+                sha.update(chunk)
+    return Sha256Digest(sha.hexdigest()), size
+
+
+def validate_logical_path(logical: str) -> str:
+    """Validate a manifest logical path: relative, no `.`/`..` segments, no
+    backslashes, no drive letters, non-empty. Returns the path unchanged.
+    """
+    if not isinstance(logical, str) or not logical:
+        raise ValueError(f"Invalid artifact path: {logical!r} (must be non-empty)")
+    if "\\" in logical or "\x00" in logical:
+        raise ValueError(
+            f"Invalid artifact path {logical!r}: backslashes and NUL are not allowed"
+        )
+    if logical.startswith("/") or re.match(r"^[A-Za-z]:", logical):
+        raise ValueError(f"Invalid artifact path {logical!r}: must be relative")
+    parts = logical.split("/")
+    if any(part in ("", ".", "..") for part in parts):
+        raise ValueError(
+            f"Invalid artifact path {logical!r}: "
+            "'.', '..', and empty segments are not allowed"
+        )
+    return logical
+
+
+def assert_manifest_paths_compatible(paths: Iterable[str]) -> None:
+    """Validate a manifest's logical paths as a set: reject exact duplicates and
+    file/directory prefix collisions. A path cannot be both a file and a
+    directory, so `sub` and `sub/x` (or `a/b` and `a/b/c`) cannot coexist;
+    siblings like `a/b` and `a/c` are fine.
+    """
+    seen: set[str] = set()
+    for p in paths:
+        if p in seen:
+            raise ValueError(f"Duplicate logical path in manifest: {p!r}")
+        seen.add(p)
+    for p in seen:
+        parts = p.split("/")
+        for i in range(1, len(parts)):
+            ancestor = "/".join(parts[:i])
+            if ancestor in seen:
+                raise ValueError(
+                    f"Artifact path {p!r} collides with {ancestor!r}: a path "
+                    "cannot be both a file and a directory in the same artifact."
+                )
+
+
+def validate_digest(digest: str) -> Sha256Digest:
+    """Validate that `digest` is a 64-char lowercase sha256 hex string and
+    return it unchanged.
+    """
+    if not isinstance(digest, str) or not SHA256_DIGEST_RE.match(digest):
+        raise ValueError(f"Invalid artifact blob digest: {digest!r}")
+    return Sha256Digest(digest)
+
+
+def stage_blob_from_chunks(
+    chunks: Iterable[bytes],
+    claimed_digest: Sha256Digest,
+    target_path: Path,
+) -> None:
+    """Stream `chunks` to `target_path`, verifying they hash to `claimed_digest`.
+    No-op if `target_path` already exists (the chunks are not consumed).
+    """
+    if target_path.is_file():
+        return
+    target_path.parent.mkdir(parents=True, exist_ok=True)
+    partial = target_path.parent / partial_blob_name(target_path.name)
+    sha = hashlib.sha256()
+    try:
+        with partial.open("wb") as dst:
+            for chunk in chunks:
+                if not chunk:
+                    continue
+                sha.update(chunk)
+                dst.write(chunk)
+        actual = sha.hexdigest()
+        if actual != claimed_digest:
+            raise ValueError(
+                f"Digest mismatch: claimed {claimed_digest}, computed {actual}"
+            )
+        os.replace(partial, target_path)
+    except Exception:
+        partial.unlink(missing_ok=True)
+        raise
+
+
+def stage_blob_from_file(
+    src_path: Path,
+    claimed_digest: Sha256Digest,
+    target_path: Path,
+) -> None:
+    """Copy `src_path` to `target_path`, verifying it hashes to `claimed_digest`."""
+    if target_path.is_file():
+        return
+
+    def _file_chunks() -> Iterator[bytes]:
+        with src_path.open("rb") as src:
+            while chunk := src.read(HASH_CHUNK_SIZE):
+                yield chunk
+
+    stage_blob_from_chunks(_file_chunks(), claimed_digest, target_path)
+
+
+def stage_blob_into_project(src_path: Path, project: str) -> tuple[Sha256Digest, int]:
+    """Copy `src_path` into the project's CAS in a single pass, computing its
+    sha256 and size while writing. Returns `(digest, size)`. If the blob is
+    already present, the copy is discarded.
+    """
+    blobs_root = _project_blobs_root(project)
+    blobs_root.mkdir(parents=True, exist_ok=True)
+    partial = blobs_root / partial_blob_name()
+    sha = hashlib.sha256()
+    size = 0
+    try:
+        with src_path.open("rb") as src, partial.open("wb") as dst:
+            while chunk := src.read(HASH_CHUNK_SIZE):
+                sha.update(chunk)
+                dst.write(chunk)
+                size += len(chunk)
+        digest = Sha256Digest(sha.hexdigest())
+        target = blob_path(project, digest)
+        if target.is_file():
+            partial.unlink(missing_ok=True)
+            return digest, size
+        target.parent.mkdir(parents=True, exist_ok=True)
+        os.replace(partial, target)
+        return digest, size
+    except Exception:
+        partial.unlink(missing_ok=True)
+        raise

trackio/cli_helpers.py

@@ -0,0 +1,673 @@
+import json
+import re
+import sys
+from datetime import datetime, timezone
+from typing import Any
+
+from trackio import references
+
+
+def format_json(data: Any) -> str:
+    """Format data as JSON."""
+    return json.dumps(data, indent=2)
+
+
+def format_list(items: list[str], title: str | None = None) -> str:
+    """Format a list of items in human-readable format."""
+    if not items:
+        return f"No {title.lower() if title else 'items'} found."
+
+    output = []
+    if title:
+        output.append(f"{title}:")
+
+    for item in items:
+        output.append(f"  - {item}")
+
+    return "\n".join(output)
+
+
+def format_artifacts(artifacts: list[dict], project: str | None = None) -> str:
+    """Format a project's artifacts in human-readable format."""
+    if not artifacts:
+        return "No artifacts found."
+
+    title = f"Artifacts in '{project}'" if project else "Artifacts"
+    output = [f"{title}:"]
+    for art in artifacts:
+        latest = art.get("latest_version")
+        version = f"v{latest}" if latest is not None else "(no versions)"
+        aliases = art.get("aliases") or []
+        alias_str = f" [{', '.join(aliases)}]" if aliases else ""
+        output.append(
+            f"  - {art['name']} ({art.get('type', '?')}) "
+            f"latest={version}{alias_str} "
+            f"versions={art.get('num_versions', 0)}"
+        )
+        if art.get("description"):
+            output.append(f"      {art['description']}")
+    return "\n".join(output)
+
+
+def format_artifact(record: dict) -> str:
+    """Format a single resolved artifact version in human-readable format."""
+    lines = [
+        f"Artifact: {record['name']} (v{record['version']})",
+        f"  type:        {record.get('type')}",
+    ]
+    if record.get("description"):
+        lines.append(f"  description: {record['description']}")
+    aliases = record.get("aliases") or []
+    if aliases:
+        lines.append(f"  aliases:     {', '.join(aliases)}")
+    if record.get("metadata"):
+        lines.append(f"  metadata:    {record['metadata']}")
+    lines.append(f"  size:        {record.get('size_bytes')} bytes")
+    lines.append(f"  digest:      {record.get('manifest_digest')}")
+    manifest = record.get("manifest") or []
+    lines.append(f"  files ({len(manifest)}):")
+    for entry in manifest:
+        if references.is_reference_entry(entry):
+            lines.append(f"    - {entry['path']} -> {entry['ref']} (reference)")
+        else:
+            lines.append(f"    - {entry['path']} ({entry['size']} bytes)")
+    return "\n".join(lines)
+
+
+def format_registry_collections(registry: str, collections: list[dict]) -> str:
+    """Format the collections in an artifact registry."""
+    if not collections:
+        return f"No collections found in registry '{registry}'."
+
+    output = [f"Collections in registry '{registry}':"]
+    for collection in collections:
+        latest = collection.get("latest_version")
+        latest_display = f"v{latest}" if latest is not None else "(empty)"
+        output.append(
+            f"  - {collection['name']} ({collection['type']}) "
+            f"latest={latest_display} versions={collection['num_links']}"
+        )
+        if collection.get("description"):
+            output.append(f"      {collection['description']}")
+    return "\n".join(output)
+
+
+def format_registry_collection(registry: str, collection: dict) -> str:
+    """Format one registry collection and its linked versions."""
+    output = [
+        f"Collection: {registry}/{collection['name']}",
+        f"  type:        {collection['type']}",
+        f"  versions:    {collection['num_links']}",
+    ]
+    if collection.get("description"):
+        output.append(f"  description: {collection['description']}")
+    if not collection["links"]:
+        output.append("  No linked versions.")
+        return "\n".join(output)
+
+    output.append("  Linked versions:")
+    for link in collection["links"]:
+        aliases = link.get("aliases") or []
+        alias_display = f" [{', '.join(aliases)}]" if aliases else ""
+        output.append(
+            f"    - v{link['collection_version']} -> "
+            f"{link['source_project']}/{link['source_artifact']}"
+            f":v{link['source_version']}{alias_display}"
+        )
+    return "\n".join(output)
+
+
+def format_registry_events(events: list[dict]) -> str:
+    """Format a registry audit log."""
+    if not events:
+        return "No registry events found."
+    return "\n".join(
+        f"{event['ts']} | {event['kind']} | "
+        f"{json.dumps(event['payload'], sort_keys=True)}"
+        for event in events
+    )
+
+
+def format_spaces(spaces: list[dict]) -> str:
+    """Format HF Spaces in human-readable format."""
+    if not spaces:
+        return "No Trackio Spaces found."
+
+    output = ["Trackio Spaces:"]
+    for space in spaces:
+        visibility = "private" if space.get("private") else "public"
+        output.append(f"  - {space['id']} ({visibility})")
+        if space.get("url"):
+            output.append(f"    {space['url']}")
+
+    return "\n".join(output)
+
+
+def format_project_summary(summary: dict) -> str:
+    """Format project summary in human-readable format."""
+    output = [f"Project: {summary['project']}"]
+    output.append(f"Number of runs: {summary['num_runs']}")
+
+    if summary["runs"]:
+        output.append("\nRuns:")
+        for run in summary["runs"]:
+            output.append(f"  - {run}")
+    else:
+        output.append("\nNo runs found.")
+
+    if summary.get("last_activity"):
+        output.append(f"\nLast activity (max step): {summary['last_activity']}")
+
+    return "\n".join(output)
+
+
+def format_run_summary(summary: dict) -> str:
+    """Format run summary in human-readable format."""
+    output = [f"Project: {summary['project']}"]
+    output.append(f"Run: {summary['run']}")
+    output.append(f"Number of logs: {summary['num_logs']}")
+
+    if summary.get("last_step") is not None:
+        output.append(f"Last step: {summary['last_step']}")
+
+    if summary.get("metrics"):
+        output.append("\nMetrics:")
+        for metric in summary["metrics"]:
+            output.append(f"  - {metric}")
+    else:
+        output.append("\nNo metrics found.")
+
+    config = summary.get("config")
+    if config:
+        output.append("\nConfig:")
+        config_display = {k: v for k, v in config.items() if not k.startswith("_")}
+        if config_display:
+            for key, value in config_display.items():
+                output.append(f"  {key}: {value}")
+        else:
+            output.append("  (no config)")
+    else:
+        output.append("\nConfig: (no config)")
+
+    return "\n".join(output)
+
+
+def format_metric_values(values: list[dict]) -> str:
+    """Format metric values in human-readable format."""
+    if not values:
+        return "No metric values found."
+
+    output = [f"Found {len(values)} value(s):\n"]
+    output.append("Step | Timestamp | Value")
+    output.append("-" * 50)
+
+    for value in values:
+        step = value.get("step", "N/A")
+        timestamp = value.get("timestamp", "N/A")
+        val = value.get("value", "N/A")
+        output.append(f"{step} | {timestamp} | {val}")
+
+    return "\n".join(output)
+
+
+def format_system_metrics(metrics: list[dict]) -> str:
+    """Format system metrics in human-readable format."""
+    if not metrics:
+        return "No system metrics found."
+
+    output = [f"Found {len(metrics)} system metric entry/entries:\n"]
+
+    for i, entry in enumerate(metrics):
+        timestamp = entry.get("timestamp", "N/A")
+        output.append(f"\nEntry {i + 1} (Timestamp: {timestamp}):")
+        for key, value in entry.items():
+            if key != "timestamp":
+                output.append(f"  {key}: {value}")
+
+    return "\n".join(output)
+
+
+def format_system_metric_names(names: list[str]) -> str:
+    """Format system metric names in human-readable format."""
+    return format_list(names, "System Metrics")
+
+
+def format_snapshot(snapshot: dict[str, list[dict]]) -> str:
+    """Format a metrics snapshot in human-readable format."""
+    if not snapshot:
+        return "No metrics found in the specified range."
+
+    output = []
+    for metric_name, values in sorted(snapshot.items()):
+        output.append(f"\n{metric_name}:")
+        output.append("  Step | Timestamp | Value")
+        output.append("  " + "-" * 48)
+        for v in values:
+            step = v.get("step", "N/A")
+            ts = v.get("timestamp", "N/A")
+            val = v.get("value", "N/A")
+            output.append(f"  {step} | {ts} | {val}")
+
+    return "\n".join(output)
+
+
+def format_alerts(alerts: list[dict]) -> str:
+    """Format alerts in human-readable format."""
+    if not alerts:
+        return "No alerts found."
+
+    output = [f"Found {len(alerts)} alert(s):\n"]
+    output.append("Timestamp | Run | Level | Title | Text | Step")
+    output.append("-" * 80)
+
+    for a in alerts:
+        ts = a.get("timestamp", "N/A")
+        run = a.get("run", "N/A")
+        level = a.get("level", "N/A").upper()
+        title = a.get("title", "")
+        text = a.get("text", "") or ""
+        step = a.get("step", "N/A")
+        output.append(f"{ts} | {run} | {level} | {title} | {text} | {step}")
+
+    return "\n".join(output)
+
+
+def format_query_result(result: dict[str, Any]) -> str:
+    """Format SQL query results in human-readable format."""
+    columns = result.get("columns", [])
+    rows = result.get("rows", [])
+    row_count = result.get("row_count", 0)
+
+    if not columns:
+        return f"Query returned {row_count} row(s)."
+
+    rendered_rows = []
+    for row in rows:
+        rendered_rows.append(
+            [
+                "" if row.get(column) is None else str(row.get(column))
+                for column in columns
+            ]
+        )
+
+    widths = []
+    for idx, column in enumerate(columns):
+        cell_width = max(
+            (len(rendered_row[idx]) for rendered_row in rendered_rows), default=0
+        )
+        widths.append(max(len(column), cell_width))
+
+    header = " | ".join(
+        column.ljust(width) for column, width in zip(columns, widths, strict=False)
+    )
+    separator = "-+-".join("-" * width for width in widths)
+    output = [f"Query returned {row_count} row(s).", header, separator]
+
+    if not rendered_rows:
+        output.append("(no rows)")
+        return "\n".join(output)
+
+    for rendered_row in rendered_rows:
+        output.append(
+            " | ".join(
+                value.ljust(width)
+                for value, width in zip(rendered_row, widths, strict=False)
+            )
+        )
+
+    return "\n".join(output)
+
+
+def error_exit(message: str, code: int = 1) -> None:
+    """Print error message and exit."""
+    print(f"Error: {message}", file=sys.stderr)
+    sys.exit(code)
+
+
+def format_duration_ms(value: Any) -> str:
+    """Render a millisecond duration the way the trace dashboard does."""
+    if value is None or value == "":
+        return "-"
+    try:
+        ms = float(value)
+    except (TypeError, ValueError):
+        return "-"
+    if ms < 1000:
+        return f"{round(ms)}ms"
+    if ms < 60_000:
+        return f"{ms / 1000:.2f}s" if ms < 10_000 else f"{ms / 1000:.1f}s"
+    minutes = int(ms // 60_000)
+    seconds = round((ms % 60_000) / 1000)
+    return f"{minutes}m {seconds}s"
+
+
+def format_cost_usd(value: Any) -> str:
+    if value is None or value == "":
+        return "-"
+    try:
+        cost = float(value)
+    except (TypeError, ValueError):
+        return "-"
+    if cost == 0:
+        return "$0"
+    if cost < 0.0001:
+        return "<$0.0001"
+    if cost < 0.01:
+        return f"${cost:.4f}"
+    return f"${cost:.2f}"
+
+
+_ISO_FRACTION_RE = re.compile(r"\.(\d+)")
+
+
+def parse_span_timestamp(value: Any) -> datetime | None:
+    """Parse a span timestamp, tolerating any number of fractional digits.
+
+    `datetime.fromisoformat` accepts only 3 or 6 fractional digits before
+    Python 3.11, and instrumentation commonly emits fewer (or a `Z` suffix),
+    so those are normalized first. Naive timestamps are assumed to be UTC so
+    that spans from mixed sources stay comparable.
+    """
+    if not value:
+        return None
+    text = str(value).strip()
+    if text.endswith(("Z", "z")):
+        text = text[:-1] + "+00:00"
+    text = _ISO_FRACTION_RE.sub(
+        lambda match: "." + (match.group(1) + "000000")[:6], text, count=1
+    )
+    try:
+        parsed = datetime.fromisoformat(text)
+    except ValueError:
+        return None
+    return parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)
+
+
+def _span_duration_ms(span: dict) -> float | None:
+    explicit = span.get("duration_ms")
+    if explicit is not None:
+        try:
+            return max(0.0, float(explicit))
+        except (TypeError, ValueError):
+            pass
+    started = parse_span_timestamp(span.get("start_time"))
+    ended = parse_span_timestamp(span.get("end_time"))
+    if started is None or ended is None:
+        return None
+    return max(0.0, (ended - started).total_seconds() * 1000)
+
+
+def _span_is_error(span: dict) -> bool:
+    status = str(span.get("status") or "").lower()
+    return status in {"error", "failed"} or bool(span.get("error"))
+
+
+def trace_rollup(trace: dict) -> dict:
+    """Latency, cost, token, and status totals for one trace."""
+    spans = trace.get("spans") or []
+    starts, ends, durations = [], [], []
+    cost = 0.0
+    has_cost = False
+    input_tokens = output_tokens = 0
+    has_usage = has_error = False
+
+    for span in spans:
+        if not isinstance(span, dict):
+            continue
+        for field, sink in (("start_time", starts), ("end_time", ends)):
+            parsed = parse_span_timestamp(span.get(field))
+            if parsed is not None:
+                sink.append(parsed)
+        duration = _span_duration_ms(span)
+        if duration is not None:
+            durations.append(duration)
+        span_cost = span.get("cost_usd")
+        if span_cost is not None:
+            try:
+                cost += float(span_cost)
+                has_cost = True
+            except (TypeError, ValueError):
+                pass
+        usage = span.get("usage") or {}
+        for key, add in (("input_tokens", "in"), ("output_tokens", "out")):
+            value = usage.get(key)
+            if value is None:
+                continue
+            try:
+                if add == "in":
+                    input_tokens += int(value)
+                else:
+                    output_tokens += int(value)
+                has_usage = True
+            except (TypeError, ValueError):
+                pass
+        if _span_is_error(span):
+            has_error = True
+
+    metadata = trace.get("metadata") or {}
+    if starts and ends:
+        duration_ms = max(0.0, (max(ends) - min(starts)).total_seconds() * 1000)
+    elif durations:
+        duration_ms = max(durations)
+    else:
+        duration_ms = metadata.get("duration_ms") or metadata.get("latency_ms")
+
+    all_success = bool(spans) and all(
+        str(span.get("status") or "").lower() == "success"
+        for span in spans
+        if isinstance(span, dict)
+    )
+    metadata_status = metadata.get("status")
+    status = (
+        "error"
+        if has_error
+        else (
+            metadata_status
+            if isinstance(metadata_status, str) and metadata_status
+            else ("success" if all_success else None)
+        )
+    )
+    return {
+        "duration_ms": duration_ms,
+        "cost_usd": cost if has_cost else metadata.get("cost_usd"),
+        "input_tokens": input_tokens if has_usage else None,
+        "output_tokens": output_tokens if has_usage else None,
+        "status": status,
+        "span_count": len(spans),
+    }
+
+
+def short_trace_id(trace_id: Any) -> str:
+    """Shorten a stored trace id for display, as the dashboard does.
+
+    Stored ids are `run_id:log_id:key[:index]`; the `log_id` (plus the list
+    index, when the key held several traces) identifies the trace on its own.
+    """
+    text = str(trace_id or "")
+    parts = text.split(":")
+    if len(parts) < 3:
+        return text
+    short = parts[1]
+    last = parts[-1]
+    if len(parts) >= 4 and last.lstrip("-").isdigit():
+        return f"{short}:{last}"
+    return short
+
+
+def trace_id_matches(trace: dict, wanted: str) -> bool:
+    stored = str(trace.get("id") or "")
+    return wanted in (stored, short_trace_id(stored))
+
+
+def _first_message_text(trace: dict, role: str) -> str:
+    for message in trace.get("messages") or []:
+        if not isinstance(message, dict) or message.get("role") != role:
+            continue
+        content = message.get("content")
+        if isinstance(content, str):
+            return content
+        if isinstance(content, list):
+            for part in content:
+                if isinstance(part, dict) and isinstance(part.get("text"), str):
+                    return part["text"]
+    return ""
+
+
+def format_traces(traces: list[dict]) -> str:
+    """Format a trace index in human-readable format."""
+    if not traces:
+        return "No traces found."
+
+    output = [f"Found {len(traces)} trace(s):\n"]
+    output.append("ID | Run | Step | Status | Latency | Cost | Ops | Request")
+    output.append("-" * 100)
+    for trace in traces:
+        rollup = trace_rollup(trace)
+        request = _first_message_text(trace, "user").replace("\n", " ")
+        if len(request) > 48:
+            request = request[:45] + "..."
+        output.append(
+            " | ".join(
+                [
+                    short_trace_id(trace.get("id")) or "-",
+                    str(trace.get("run", "-")),
+                    str(trace.get("step", "-")),
+                    rollup["status"] or "-",
+                    format_duration_ms(rollup["duration_ms"]),
+                    format_cost_usd(rollup["cost_usd"]),
+                    str(rollup["span_count"]),
+                    request or "-",
+                ]
+            )
+        )
+    return "\n".join(output)
+
+
+def _ordered_span_tree(spans: list[dict]) -> list[tuple[int, dict]]:
+    """Depth-annotated spans, parents before children, siblings by start time."""
+    normalized = [span for span in spans if isinstance(span, dict)]
+    by_id: dict[str, dict] = {}
+    for index, span in enumerate(normalized):
+        span_id = str(span.get("id") or f"span-{index + 1}")
+        by_id.setdefault(span_id, span)
+
+    children: dict[int, list[dict]] = {}
+    roots: list[dict] = []
+    for span in normalized:
+        parent_id = span.get("parent_id")
+        parent = by_id.get(str(parent_id)) if parent_id else None
+        if parent is None or parent is span:
+            roots.append(span)
+        else:
+            children.setdefault(id(parent), []).append(span)
+
+    def sort_key(span: dict) -> tuple:
+        started = parse_span_timestamp(span.get("start_time"))
+        return (
+            0 if started else 1,
+            started.timestamp() if started else 0.0,
+            normalized.index(span),
+        )
+
+    rows: list[tuple[int, dict]] = []
+    seen: set[int] = set()
+
+    def walk(span: dict, depth: int) -> None:
+        if id(span) in seen:
+            return
+        seen.add(id(span))
+        rows.append((depth, span))
+        for child in sorted(children.get(id(span), []), key=sort_key):
+            walk(child, depth + 1)
+
+    for root in sorted(roots, key=sort_key):
+        walk(root, 0)
+    for span in normalized:
+        walk(span, 0)
+    return rows
+
+
+def format_trace(trace: dict) -> str:
+    """Format a single trace, including its span tree, in human-readable format."""
+    rollup = trace_rollup(trace)
+    output = [f"Trace {short_trace_id(trace.get('id')) or '-'}"]
+    output.append(f"  Full id:  {trace.get('id', '-')}")
+    output.append(f"  Run:      {trace.get('run', '-')}")
+    output.append(f"  Step:     {trace.get('step', '-')}")
+    output.append(
+        f"  Logged:   {trace.get('timestamp', '-')} (key: {trace.get('key', '-')})"
+    )
+    output.append(
+        f"  Totals:   {rollup['status'] or 'no status'} | "
+        f"{format_duration_ms(rollup['duration_ms'])} | "
+        f"{format_cost_usd(rollup['cost_usd'])} | "
+        f"{rollup['input_tokens'] if rollup['input_tokens'] is not None else '-'} in / "
+        f"{rollup['output_tokens'] if rollup['output_tokens'] is not None else '-'} out tokens | "
+        f"{rollup['span_count']} operation(s)"
+    )
+    metadata = trace.get("metadata") or {}
+    if metadata:
+        rendered = ", ".join(
+            f"{key}={value}"
+            for key, value in metadata.items()
+            if not isinstance(value, (dict, list))
+        )
+        if rendered:
+            output.append(f"  Metadata: {rendered}")
+
+    spans = trace.get("spans") or []
+    if spans:
+        output.append("\nExecution:")
+        for depth, span in _ordered_span_tree(spans):
+            indent = "  " * (depth + 1)
+            bits = [format_duration_ms(_span_duration_ms(span))]
+            if span.get("model"):
+                bits.append(str(span["model"]))
+            usage = span.get("usage") or {}
+            if (
+                usage.get("input_tokens") is not None
+                or usage.get("output_tokens") is not None
+            ):
+                bits.append(
+                    f"{usage.get('input_tokens', 0)}->{usage.get('output_tokens', 0)} tok"
+                )
+            if span.get("cost_usd") is not None:
+                bits.append(format_cost_usd(span.get("cost_usd")))
+            marker = "ERROR " if _span_is_error(span) else ""
+            output.append(
+                f"{indent}{marker}{span.get('name', span.get('kind', 'span'))} "
+                f"[{span.get('kind', 'span')}]  {'  '.join(bits)}"
+            )
+            error = span.get("error")
+            if error:
+                detail = error if isinstance(error, str) else json.dumps(error)
+                output.append(f"{indent}  -> {detail[:160]}")
+    else:
+        output.append("\nExecution: no spans logged for this trace.")
+
+    messages = trace.get("messages") or []
+    if messages:
+        output.append("\nConversation:")
+        for message in messages:
+            if not isinstance(message, dict):
+                continue
+            role = message.get("role", "message")
+            content = message.get("content")
+            if not isinstance(content, str):
+                content = json.dumps(content) if content is not None else ""
+            content = content.replace("\n", " ")
+            if len(content) > 160:
+                content = content[:157] + "..."
+            output.append(f"  {role}: {content}")
+    return "\n".join(output)
+
+
+def format_trace_summary(result: dict[str, Any]) -> str:
+    """Format the per-operation trace rollup in human-readable format."""
+    rows = result.get("rows") or []
+    if not rows:
+        return "No trace spans found."
+    columns = result.get("columns") or []
+    return format_query_result(
+        {"columns": columns, "rows": rows, "row_count": len(rows)}
+    )

trackio/commit_scheduler.py

@@ -0,0 +1,306 @@
+# Originally copied from https://github.com/huggingface/huggingface_hub/blob/d0a948fc2a32ed6e557042a95ef3e4af97ec4a7c/src/huggingface_hub/_commit_scheduler.py
+
+import atexit
+import logging
+import time
+from concurrent.futures import Future
+from dataclasses import dataclass
+from pathlib import Path
+from threading import Lock, Thread
+from typing import Callable, Dict, List, Union
+
+from huggingface_hub import CommitOperationAdd
+from huggingface_hub.hf_api import DEFAULT_IGNORE_PATTERNS, CommitInfo, HfApi
+from huggingface_hub.utils import filter_repo_objects
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class _FileToUpload:
+    """Temporary dataclass to store info about files to upload. Not meant to be used directly."""
+
+    local_path: Path
+    path_in_repo: str
+    size_limit: int
+    last_modified: float
+
+
+class CommitScheduler:
+    """
+    Scheduler to upload a local folder to the Hub at regular intervals (e.g. push to hub every 5 minutes).
+
+    The recommended way to use the scheduler is to use it as a context manager. This ensures that the scheduler is
+    properly stopped and the last commit is triggered when the script ends. The scheduler can also be stopped manually
+    with the `stop` method. Checkout the [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads)
+    to learn more about how to use it.
+
+    Args:
+        repo_id (`str`):
+            The id of the repo to commit to.
+        folder_path (`str` or `Path`):
+            Path to the local folder to upload regularly.
+        every (`int` or `float`, *optional*):
+            The number of minutes between each commit. Defaults to 5 minutes.
+        path_in_repo (`str`, *optional*):
+            Relative path of the directory in the repo, for example: `"checkpoints/"`. Defaults to the root folder
+            of the repository.
+        repo_type (`str`, *optional*):
+            The type of the repo to commit to. Defaults to `model`.
+        revision (`str`, *optional*):
+            The revision of the repo to commit to. Defaults to `main`.
+        private (`bool`, *optional*):
+            Whether to make the repo private. If `None` (default), the repo will be public unless the organization's default is private. This value is ignored if the repo already exists.
+        token (`str`, *optional*):
+            The token to use to commit to the repo. Defaults to the token saved on the machine.
+        allow_patterns (`List[str]` or `str`, *optional*):
+            If provided, only files matching at least one pattern are uploaded.
+        ignore_patterns (`List[str]` or `str`, *optional*):
+            If provided, files matching any of the patterns are not uploaded.
+        squash_history (`bool`, *optional*):
+            Whether to squash the history of the repo after each commit. Defaults to `False`. Squashing commits is
+            useful to avoid degraded performances on the repo when it grows too large.
+        hf_api (`HfApi`, *optional*):
+            The [`HfApi`] client to use to commit to the Hub. Can be set with custom settings (user agent, token,...).
+        on_before_commit (`Callable[[], None]`, *optional*):
+            If specified, a function that will be called before the CommitScheduler lists files to create a commit.
+
+    Example:
+    ```py
+    >>> from pathlib import Path
+    >>> from huggingface_hub import CommitScheduler
+
+    # Scheduler uploads every 10 minutes
+    >>> csv_path = Path("watched_folder/data.csv")
+    >>> CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path=csv_path.parent, every=10)
+
+    >>> with csv_path.open("a") as f:
+    ...     f.write("first line")
+
+    # Some time later (...)
+    >>> with csv_path.open("a") as f:
+    ...     f.write("second line")
+    ```
+
+    Example using a context manager:
+    ```py
+    >>> from pathlib import Path
+    >>> from huggingface_hub import CommitScheduler
+
+    >>> with CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path="watched_folder", every=10) as scheduler:
+    ...     csv_path = Path("watched_folder/data.csv")
+    ...     with csv_path.open("a") as f:
+    ...         f.write("first line")
+    ...     (...)
+    ...     with csv_path.open("a") as f:
+    ...         f.write("second line")
+
+    # Scheduler is now stopped and last commit have been triggered
+    ```
+    """
+
+    def __init__(
+        self,
+        *,
+        repo_id: str,
+        folder_path: Union[str, Path],
+        every: Union[int, float] = 5,
+        path_in_repo: str | None = None,
+        repo_type: str | None = None,
+        revision: str | None = None,
+        private: bool | None = None,
+        token: str | None = None,
+        allow_patterns: list[str] | str | None = None,
+        ignore_patterns: list[str] | str | None = None,
+        squash_history: bool = False,
+        hf_api: HfApi | None = None,
+        on_before_commit: Callable[[], None] | None = None,
+    ) -> None:
+        self.api = hf_api or HfApi(token=token)
+        self.on_before_commit = on_before_commit
+
+        # Folder
+        self.folder_path = Path(folder_path).expanduser().resolve()
+        self.path_in_repo = path_in_repo or ""
+        self.allow_patterns = allow_patterns
+
+        if ignore_patterns is None:
+            ignore_patterns = []
+        elif isinstance(ignore_patterns, str):
+            ignore_patterns = [ignore_patterns]
+        self.ignore_patterns = ignore_patterns + DEFAULT_IGNORE_PATTERNS
+
+        if self.folder_path.is_file():
+            raise ValueError(
+                f"'folder_path' must be a directory, not a file: '{self.folder_path}'."
+            )
+        self.folder_path.mkdir(parents=True, exist_ok=True)
+
+        # Repository
+        repo_url = self.api.create_repo(
+            repo_id=repo_id, private=private, repo_type=repo_type, exist_ok=True
+        )
+        self.repo_id = repo_url.repo_id
+        self.repo_type = repo_type
+        self.revision = revision
+        self.token = token
+
+        self.last_uploaded: Dict[Path, float] = {}
+        self.last_push_time: float | None = None
+
+        if not every > 0:
+            raise ValueError(f"'every' must be a positive integer, not '{every}'.")
+        self.lock = Lock()
+        self.every = every
+        self.squash_history = squash_history
+
+        logger.info(
+            f"Scheduled job to push '{self.folder_path}' to '{self.repo_id}' every {self.every} minutes."
+        )
+        self._scheduler_thread = Thread(target=self._run_scheduler, daemon=True)
+        self._scheduler_thread.start()
+        atexit.register(self._push_to_hub)
+
+        self.__stopped = False
+
+    def stop(self) -> None:
+        """Stop the scheduler.
+
+        A stopped scheduler cannot be restarted. Mostly for tests purposes.
+        """
+        self.__stopped = True
+
+    def __enter__(self) -> "CommitScheduler":
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback) -> None:
+        # Upload last changes before exiting
+        self.trigger().result()
+        self.stop()
+        return
+
+    def _run_scheduler(self) -> None:
+        """Dumb thread waiting between each scheduled push to Hub."""
+        while True:
+            self.last_future = self.trigger()
+            time.sleep(self.every * 60)
+            if self.__stopped:
+                break
+
+    def trigger(self) -> Future:
+        """Trigger a `push_to_hub` and return a future.
+
+        This method is automatically called every `every` minutes. You can also call it manually to trigger a commit
+        immediately, without waiting for the next scheduled commit.
+        """
+        return self.api.run_as_future(self._push_to_hub)
+
+    def _push_to_hub(self) -> CommitInfo | None:
+        if self.__stopped:  # If stopped, already scheduled commits are ignored
+            return None
+
+        logger.info("(Background) scheduled commit triggered.")
+        try:
+            value = self.push_to_hub()
+            if self.squash_history:
+                logger.info("(Background) squashing repo history.")
+                self.api.super_squash_history(
+                    repo_id=self.repo_id, repo_type=self.repo_type, branch=self.revision
+                )
+            return value
+        except Exception as e:
+            logger.error(
+                f"Error while pushing to Hub: {e}"
+            )  # Depending on the setup, error might be silenced
+            raise
+
+    def push_to_hub(self) -> CommitInfo | None:
+        """
+        Push folder to the Hub and return the commit info.
+
+        <Tip warning={true}>
+
+        This method is not meant to be called directly. It is run in the background by the scheduler, respecting a
+        queue mechanism to avoid concurrent commits. Making a direct call to the method might lead to concurrency
+        issues.
+
+        </Tip>
+
+        The default behavior of `push_to_hub` is to assume an append-only folder. It lists all files in the folder and
+        uploads only changed files. If no changes are found, the method returns without committing anything. If you want
+        to change this behavior, you can inherit from [`CommitScheduler`] and override this method. This can be useful
+        for example to compress data together in a single file before committing. For more details and examples, check
+        out our [integration guide](https://huggingface.co/docs/huggingface_hub/main/en/guides/upload#scheduled-uploads).
+        """
+        # Check files to upload (with lock)
+        with self.lock:
+            if self.on_before_commit is not None:
+                self.on_before_commit()
+
+            logger.debug("Listing files to upload for scheduled commit.")
+
+            # List files from folder (taken from `_prepare_upload_folder_additions`)
+            relpath_to_abspath = {
+                path.relative_to(self.folder_path).as_posix(): path
+                for path in sorted(
+                    self.folder_path.glob("**/*")
+                )  # sorted to be deterministic
+                if path.is_file()
+            }
+            prefix = f"{self.path_in_repo.strip('/')}/" if self.path_in_repo else ""
+
+            # Filter with pattern + filter out unchanged files + retrieve current file size
+            files_to_upload: List[_FileToUpload] = []
+            for relpath in filter_repo_objects(
+                relpath_to_abspath.keys(),
+                allow_patterns=self.allow_patterns,
+                ignore_patterns=self.ignore_patterns,
+            ):
+                local_path = relpath_to_abspath[relpath]
+                stat = local_path.stat()
+                if (
+                    self.last_uploaded.get(local_path) is None
+                    or self.last_uploaded[local_path] != stat.st_mtime
+                ):
+                    files_to_upload.append(
+                        _FileToUpload(
+                            local_path=local_path,
+                            path_in_repo=prefix + relpath,
+                            size_limit=stat.st_size,
+                            last_modified=stat.st_mtime,
+                        )
+                    )
+
+        # Return if nothing to upload
+        if len(files_to_upload) == 0:
+            logger.debug("Dropping schedule commit: no changed file to upload.")
+            return None
+
+        # Convert `_FileToUpload` as `CommitOperationAdd` (=> compute file shas + limit to file size)
+        logger.debug("Removing unchanged files since previous scheduled commit.")
+        add_operations = [
+            CommitOperationAdd(
+                # TODO: Cap the file to its current size, even if the user append data to it while a scheduled commit is happening
+                # (requires an upstream fix for XET-535: `hf_xet` should support `BinaryIO` for upload)
+                path_or_fileobj=file_to_upload.local_path,
+                path_in_repo=file_to_upload.path_in_repo,
+            )
+            for file_to_upload in files_to_upload
+        ]
+
+        # Upload files (append mode expected - no need for lock)
+        logger.debug("Uploading files for scheduled commit.")
+        commit_info = self.api.create_commit(
+            repo_id=self.repo_id,
+            repo_type=self.repo_type,
+            operations=add_operations,
+            commit_message="Scheduled Commit",
+            revision=self.revision,
+        )
+
+        for file in files_to_upload:
+            self.last_uploaded[file.local_path] = file.last_modified
+
+        self.last_push_time = time.time()
+
+        return commit_info

trackio/compression.py

@@ -0,0 +1,169 @@
+from __future__ import annotations
+
+import gzip
+import io
+from typing import NoReturn
+
+from starlette.datastructures import Headers, MutableHeaders
+from starlette.types import ASGIApp, Message, Receive, Scope, Send
+
+try:
+    import brotli
+
+    HAS_BROTLI = True
+except ImportError:
+    brotli = None
+    HAS_BROTLI = False
+
+COMPRESSIBLE_CONTENT_TYPES = (
+    "application/json",
+    "application/javascript",
+    "application/manifest+json",
+    "application/xml",
+    "application/xhtml+xml",
+    "image/svg+xml",
+    "text/",
+)
+
+
+class CompressionMiddleware:
+    """Negotiates Brotli, then gzip, then identity based on Accept-Encoding.
+
+    Only text-like content types are compressed, so already-compressed media
+    (images, audio, video) and zero-copy file sends pass through untouched.
+    """
+
+    def __init__(
+        self,
+        app: ASGIApp,
+        minimum_size: int = 512,
+        gzip_level: int = 6,
+        brotli_quality: int = 5,
+    ) -> None:
+        self.app = app
+        self.minimum_size = minimum_size
+        self.gzip_level = gzip_level
+        self.brotli_quality = brotli_quality
+
+    async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
+        if scope["type"] != "http":
+            await self.app(scope, receive, send)
+            return
+
+        accept_encoding = Headers(scope=scope).get("Accept-Encoding", "")
+        responder: _CompressionResponder
+        if HAS_BROTLI and "br" in accept_encoding:
+            responder = _BrotliResponder(
+                self.app, self.minimum_size, self.brotli_quality
+            )
+        elif "gzip" in accept_encoding:
+            responder = _GZipResponder(self.app, self.minimum_size, self.gzip_level)
+        else:
+            responder = _CompressionResponder(self.app, self.minimum_size)
+
+        await responder(scope, receive, send)
+
+
+class _CompressionResponder:
+    content_encoding: str = ""
+
+    def __init__(self, app: ASGIApp, minimum_size: int) -> None:
+        self.app = app
+        self.minimum_size = minimum_size
+        self.send: Send = _unattached_send
+        self.initial_message: Message = {}
+        self.started = False
+        self.passthrough = True
+
+    async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
+        self.send = send
+        await self.app(scope, receive, self.send_with_compression)
+
+    async def send_with_compression(self, message: Message) -> None:
+        message_type = message["type"]
+        if message_type == "http.response.start":
+            self.initial_message = message
+            headers = Headers(raw=message["headers"])
+            content_type = headers.get("content-type", "")
+            already_encoded = "content-encoding" in headers
+            self.passthrough = already_encoded or not content_type.startswith(
+                COMPRESSIBLE_CONTENT_TYPES
+            )
+        elif message_type == "http.response.body" and self.passthrough:
+            if not self.started:
+                self.started = True
+                await self.send(self.initial_message)
+            await self.send(message)
+        elif message_type == "http.response.body" and not self.started:
+            self.started = True
+            body = message.get("body", b"")
+            more_body = message.get("more_body", False)
+            if len(body) < self.minimum_size and not more_body:
+                await self.send(self.initial_message)
+                await self.send(message)
+            else:
+                compressed = self.apply_compression(body, more_body=more_body)
+                headers = MutableHeaders(raw=self.initial_message["headers"])
+                headers.add_vary_header("Accept-Encoding")
+                if compressed != body:
+                    headers["Content-Encoding"] = self.content_encoding
+                    if more_body:
+                        del headers["Content-Length"]
+                    else:
+                        headers["Content-Length"] = str(len(compressed))
+                    message["body"] = compressed
+                await self.send(self.initial_message)
+                await self.send(message)
+        elif message_type == "http.response.body":
+            body = message.get("body", b"")
+            more_body = message.get("more_body", False)
+            message["body"] = self.apply_compression(body, more_body=more_body)
+            await self.send(message)
+        elif message_type == "http.response.pathsend":
+            await self.send(self.initial_message)
+            await self.send(message)
+
+    def apply_compression(self, body: bytes, *, more_body: bool) -> bytes:
+        return body
+
+
+class _GZipResponder(_CompressionResponder):
+    content_encoding = "gzip"
+
+    def __init__(self, app: ASGIApp, minimum_size: int, compresslevel: int) -> None:
+        super().__init__(app, minimum_size)
+        self.buffer = io.BytesIO()
+        self.file = gzip.GzipFile(
+            mode="wb", fileobj=self.buffer, compresslevel=compresslevel
+        )
+
+    async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
+        with self.buffer, self.file:
+            await super().__call__(scope, receive, send)
+
+    def apply_compression(self, body: bytes, *, more_body: bool) -> bytes:
+        self.file.write(body)
+        if not more_body:
+            self.file.close()
+        data = self.buffer.getvalue()
+        self.buffer.seek(0)
+        self.buffer.truncate()
+        return data
+
+
+class _BrotliResponder(_CompressionResponder):
+    content_encoding = "br"
+
+    def __init__(self, app: ASGIApp, minimum_size: int, quality: int) -> None:
+        super().__init__(app, minimum_size)
+        self.compressor = brotli.Compressor(quality=quality)
+
+    def apply_compression(self, body: bytes, *, more_body: bool) -> bytes:
+        data = self.compressor.process(body)
+        if not more_body:
+            data += self.compressor.finish()
+        return data
+
+
+async def _unattached_send(message: Message) -> NoReturn:
+    raise RuntimeError("send awaitable not set")

trackio/context_vars.py

@@ -0,0 +1,21 @@
+import contextvars
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from trackio.run import Run
+
+current_run: contextvars.ContextVar["Run | None"] = contextvars.ContextVar(
+    "current_run", default=None
+)
+current_project: contextvars.ContextVar[str | None] = contextvars.ContextVar(
+    "current_project", default=None
+)
+current_server: contextvars.ContextVar[str | None] = contextvars.ContextVar(
+    "current_server", default=None
+)
+current_space_id: contextvars.ContextVar[str | None] = contextvars.ContextVar(
+    "current_space_id", default=None
+)
+current_server_write_token: contextvars.ContextVar[str | None] = contextvars.ContextVar(
+    "current_server_write_token", default=None
+)

trackio/cpu.py

@@ -0,0 +1,303 @@
+import importlib
+import threading
+import time
+import warnings
+from typing import TYPE_CHECKING, Any
+
+from trackio import context_vars
+
+if TYPE_CHECKING:
+    from trackio.run import Run
+
+psutil: Any = None
+PSUTIL_AVAILABLE = False
+_psutil_lock = threading.Lock()
+
+
+def _ensure_psutil():
+    global PSUTIL_AVAILABLE, psutil
+    if PSUTIL_AVAILABLE:
+        return psutil
+    with _psutil_lock:
+        if PSUTIL_AVAILABLE:
+            return psutil
+        try:
+            psutil = importlib.import_module("psutil")
+            PSUTIL_AVAILABLE = True
+            return psutil
+        except ImportError:
+            raise ImportError(
+                "psutil is required for CPU and RAM monitoring. "
+                "Install it with: pip install psutil"
+            )
+
+
+def cpu_available() -> bool:
+    """
+    Check if CPU and RAM monitoring is available.
+
+    Returns True if psutil is installed.
+    """
+    try:
+        _ensure_psutil()
+        return True
+    except ImportError:
+        return False
+    except Exception:
+        return False
+
+
+def collect_cpu_metrics(
+    prev_disk_counters: Any = None,
+    prev_net_counters: Any = None,
+    elapsed: float | None = None,
+    include_static: bool = True,
+) -> dict:
+    """
+    Collect CPU, RAM, disk, network, and sensor metrics using psutil.
+
+    Args:
+        prev_disk_counters: Previous disk I/O counters for computing read/write rates.
+            If None, only cumulative values are reported.
+        prev_net_counters: Previous network I/O counters for computing send/recv rates.
+            If None, only cumulative values are reported.
+        elapsed: Seconds since prev_disk_counters and prev_net_counters were captured.
+            If None or non-positive, cumulative values are reported instead of rates.
+        include_static: Whether to include mostly static metrics such as CPU
+            frequency and core counts.
+
+    Returns:
+        Dictionary of system metrics.
+    """
+    if not PSUTIL_AVAILABLE:
+        try:
+            _ensure_psutil()
+        except ImportError:
+            return {}
+
+    metrics = {}
+
+    try:
+        per_core = psutil.cpu_percent(interval=0.1, percpu=True)
+        for i, pct in enumerate(per_core):
+            metrics[f"cpu/{i}/utilization"] = pct
+        if per_core:
+            metrics["cpu/utilization"] = sum(per_core) / len(per_core)
+    except Exception:
+        pass
+
+    if include_static:
+        try:
+            cpu_freq = psutil.cpu_freq()
+            if cpu_freq:
+                metrics["cpu/frequency"] = cpu_freq.current
+                if cpu_freq.max > 0:
+                    metrics["cpu/frequency_max"] = cpu_freq.max
+        except Exception:
+            pass
+
+        try:
+            cpu_count_logical = psutil.cpu_count(logical=True)
+            if cpu_count_logical is not None:
+                metrics["cpu/count_logical"] = cpu_count_logical
+            cpu_count_physical = psutil.cpu_count(logical=False)
+            if cpu_count_physical is not None:
+                metrics["cpu/count_physical"] = cpu_count_physical
+        except Exception:
+            pass
+
+    try:
+        mem = psutil.virtual_memory()
+        metrics["memory/used"] = mem.used / (1024**3)
+        metrics["memory/total"] = mem.total / (1024**3)
+        metrics["memory/available"] = mem.available / (1024**3)
+        metrics["memory/percent"] = mem.percent
+    except Exception:
+        pass
+
+    try:
+        swap = psutil.swap_memory()
+        metrics["swap/used"] = swap.used / (1024**3)
+        metrics["swap/total"] = swap.total / (1024**3)
+        metrics["swap/percent"] = swap.percent
+    except Exception:
+        pass
+
+    try:
+        disk = psutil.disk_io_counters()
+        if disk is not None:
+            if prev_disk_counters is not None and elapsed and elapsed > 0:
+                metrics["disk/read_mb_per_sec"] = (
+                    (disk.read_bytes - prev_disk_counters.read_bytes)
+                    / elapsed
+                    / (1024**2)
+                )
+                metrics["disk/write_mb_per_sec"] = (
+                    (disk.write_bytes - prev_disk_counters.write_bytes)
+                    / elapsed
+                    / (1024**2)
+                )
+                metrics["disk/read_iops"] = (
+                    disk.read_count - prev_disk_counters.read_count
+                ) / elapsed
+                metrics["disk/write_iops"] = (
+                    disk.write_count - prev_disk_counters.write_count
+                ) / elapsed
+            else:
+                metrics["disk/read_bytes"] = disk.read_bytes
+                metrics["disk/write_bytes"] = disk.write_bytes
+    except Exception:
+        pass
+
+    try:
+        net = psutil.net_io_counters()
+        if net is not None:
+            if prev_net_counters is not None and elapsed and elapsed > 0:
+                metrics["network/sent_mb_per_sec"] = (
+                    (net.bytes_sent - prev_net_counters.bytes_sent)
+                    / elapsed
+                    / (1024**2)
+                )
+                metrics["network/recv_mb_per_sec"] = (
+                    (net.bytes_recv - prev_net_counters.bytes_recv)
+                    / elapsed
+                    / (1024**2)
+                )
+            else:
+                metrics["network/sent_bytes"] = net.bytes_sent
+                metrics["network/recv_bytes"] = net.bytes_recv
+    except Exception:
+        pass
+
+    try:
+        sensors = psutil.sensors_temperatures()
+        if sensors:
+            for chip_name, entries in sensors.items():
+                for i, entry in enumerate(entries):
+                    label = (
+                        entry.label.strip()
+                        if entry.label and entry.label.strip()
+                        else f"{chip_name}_{i}"
+                    )
+                    metrics[f"temp/{label}"] = entry.current
+    except Exception:
+        pass
+
+    try:
+        battery = psutil.sensors_battery()
+        if battery is not None:
+            metrics["battery/percent"] = battery.percent
+            metrics["battery/power_plugged"] = int(battery.power_plugged)
+    except Exception:
+        pass
+
+    return metrics
+
+
+class CpuMonitor:
+    def __init__(self, run: "Run", interval: float = 10.0):
+        self._run = run
+        self._interval = interval
+        self._stop_flag = threading.Event()
+        self._thread: "threading.Thread | None" = None
+        self._last_disk_counters: Any = None
+        self._last_net_counters: Any = None
+        self._last_time: float | None = None
+        self._include_static_next = True
+
+    def start(self):
+        if not PSUTIL_AVAILABLE:
+            try:
+                _ensure_psutil()
+            except ImportError:
+                warnings.warn(
+                    "auto_log_cpu=True but psutil is not installed. "
+                    "CPU and RAM logging disabled. Install with: pip install psutil"
+                )
+                return
+
+        self._thread = threading.Thread(target=self._monitor_loop, daemon=True)
+        self._thread.start()
+
+    def stop(self):
+        self._stop_flag.set()
+        if self._thread is not None:
+            self._thread.join(timeout=2.0)
+
+    def _monitor_loop(self):
+        try:
+            self._last_disk_counters = psutil.disk_io_counters()
+        except Exception:
+            pass
+        try:
+            self._last_net_counters = psutil.net_io_counters()
+        except Exception:
+            pass
+        self._last_time = time.monotonic()
+
+        while not self._stop_flag.is_set():
+            self._stop_flag.wait(timeout=self._interval)
+            if self._stop_flag.is_set():
+                break
+            try:
+                now = time.monotonic()
+                elapsed = now - self._last_time if self._last_time is not None else None
+                metrics = collect_cpu_metrics(
+                    prev_disk_counters=self._last_disk_counters,
+                    prev_net_counters=self._last_net_counters,
+                    elapsed=elapsed,
+                    include_static=self._include_static_next,
+                )
+                self._include_static_next = False
+                try:
+                    self._last_disk_counters = psutil.disk_io_counters()
+                except Exception:
+                    self._last_disk_counters = None
+                try:
+                    self._last_net_counters = psutil.net_io_counters()
+                except Exception:
+                    self._last_net_counters = None
+                self._last_time = now
+                if metrics:
+                    self._run.log_system(metrics)
+            except Exception:
+                pass
+
+
+def log_cpu(run: "Run | None" = None) -> dict:
+    """
+    Log CPU, RAM, disk, network, and sensor metrics to the current or specified run
+    as system metrics.
+
+    Args:
+        run: Optional Run instance. If None, uses current run from context.
+
+    Returns:
+        dict: The system metrics that were logged.
+
+    Example:
+        ```python
+        import trackio
+
+        run = trackio.init(project="my-project")
+        trackio.log({"loss": 0.5})
+        trackio.log_cpu()
+        ```
+    """
+    if run is None:
+        run = context_vars.current_run.get()
+        if run is None:
+            raise RuntimeError("Call trackio.init() before trackio.log_cpu().")
+
+    try:
+        _ensure_psutil()
+    except ImportError:
+        warnings.warn(
+            "trackio.log_cpu() requires psutil. Install it with: pip install trackio[cpu]"
+        )
+        return {}
+
+    metrics = collect_cpu_metrics()
+    if metrics:
+        run.log_system(metrics)
+    return metrics

trackio/deploy.py

@@ -0,0 +1,1332 @@
+import importlib.metadata
+import io
+import json as json_mod
+import os
+import tempfile
+import threading
+import time
+import warnings
+from collections import Counter
+from importlib.resources import files
+from pathlib import Path
+
+import httpx
+import huggingface_hub
+from gradio_client import handle_file
+from httpx import ReadTimeout
+from huggingface_hub import Volume
+from huggingface_hub.errors import (
+    BucketNotFoundError,
+    HfHubHTTPError,
+    RepositoryNotFoundError,
+)
+
+import trackio
+from trackio.bucket_storage import (
+    create_bucket_if_not_exists,
+    export_from_bucket_for_static,
+    upload_project_to_bucket,
+    upload_project_to_bucket_for_static,
+)
+from trackio.cas import PARTIAL_BLOB_GLOB
+from trackio.frontend_config import resolve_frontend_dir
+from trackio.pending_uploads import replay_pending_uploads
+from trackio.remote_client import RemoteClient
+from trackio.sqlite_storage import SQLiteStorage
+from trackio.utils import (
+    get_or_create_project_hash,
+    on_spaces,
+    preprocess_space_and_dataset_ids,
+    project_artifacts_dir,
+    project_media_dir,
+    warn_dataset_persistence_deprecated,
+)
+
+SPACE_HOST_URL = "https://{user_name}-{space_name}.hf.space/"
+SPACE_URL = "https://huggingface.co/spaces/{space_id}"
+_BOLD_ORANGE = "\033[1m\033[38;5;208m"
+_RESET = "\033[0m"
+
+
+def raise_if_space_is_frozen_for_logging(space_id: str) -> None:
+    try:
+        info = huggingface_hub.HfApi().space_info(space_id)
+    except RepositoryNotFoundError:
+        return
+    if getattr(info, "sdk", None) == "static":
+        raise RuntimeError(
+            f"Cannot log to Hugging Face Space '{space_id}' because it has been frozen "
+            f"(it uses the static SDK: a read-only dashboard with no live Trackio server).\n\n"
+            f"Use a different space_id for training, or create a new Gradio Trackio Space. "
+            f"Freezing converts a live Gradio Space to static after a run; a frozen Space "
+            f'cannot accept new logs. See trackio.sync(..., sdk="static") in the Trackio docs.'
+        )
+
+
+def _readme_linked_hub_yaml(dataset_id: str | None) -> str:
+    if dataset_id is not None:
+        return f"datasets:\n - {dataset_id}\n"
+    return ""
+
+
+_CUSTOM_SPACE_FRONTEND_DIR = "trackio_custom_frontend"
+
+
+def _space_app_py(frontend_dir: str | None = None) -> str:
+    if frontend_dir is None:
+        return "import trackio\ntrackio.show()\n"
+    return f'import trackio\ntrackio.show(frontend_dir="{frontend_dir}")\n'
+
+
+def _upload_frontend_folder(
+    hf_api: huggingface_hub.HfApi,
+    *,
+    repo_id: str,
+    repo_type: str,
+    folder_path: str | Path,
+    path_in_repo: str | None = None,
+) -> None:
+    kwargs = {
+        "repo_id": repo_id,
+        "repo_type": repo_type,
+        "folder_path": str(folder_path),
+    }
+    if path_in_repo is not None:
+        kwargs["path_in_repo"] = path_in_repo
+    hf_api.upload_folder(**kwargs)
+
+
+def _retry_hf_write(op_name: str, fn, retries: int = 4, initial_delay: float = 1.5):
+    delay = initial_delay
+    for attempt in range(1, retries + 1):
+        try:
+            return fn()
+        except ReadTimeout:
+            if attempt == retries:
+                raise
+            print(
+                f"* {op_name} timed out (attempt {attempt}/{retries}). Retrying in {delay:.1f}s..."
+            )
+            time.sleep(delay)
+            delay = min(delay * 2, 12)
+        except HfHubHTTPError as e:
+            status = e.response.status_code if e.response is not None else None
+            if status is None or status < 500 or attempt == retries:
+                raise
+            print(
+                f"* {op_name} failed with HTTP {status} (attempt {attempt}/{retries}). Retrying in {delay:.1f}s..."
+            )
+            time.sleep(delay)
+            delay = min(delay * 2, 12)
+
+
+def _get_space_volumes(
+    space_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> list[Volume]:
+    """
+    Return mounted volumes for a Space.
+
+    `HfApi.get_space_runtime()` does not always populate `volumes`, even when the
+    mount exists. Fall back to `space_info().runtime.volumes`, which currently
+    carries the volume metadata for running Spaces.
+    """
+    hf_api = hf_api or huggingface_hub.HfApi()
+    runtime = hf_api.get_space_runtime(space_id)
+    if runtime.volumes:
+        return list(runtime.volumes)
+
+    info = hf_api.space_info(space_id)
+    if info.runtime and info.runtime.volumes:
+        return list(info.runtime.volumes)
+
+    return []
+
+
+def _get_space_bucket_at_data_mount(
+    space_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> str | None:
+    for volume in _get_space_volumes(space_id, hf_api=hf_api):
+        if volume.type == "bucket" and volume.mount_path == "/data":
+            return volume.source
+    return None
+
+
+def _get_existing_space_bucket(
+    space_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> str | None:
+    """Return the Trackio bucket for a Space, preferring the canonical /data mount."""
+    bucket_at_data = _get_space_bucket_at_data_mount(space_id, hf_api=hf_api)
+    if bucket_at_data is not None:
+        return bucket_at_data
+
+    for volume in _get_space_volumes(space_id, hf_api=hf_api):
+        if volume.type == "bucket":
+            return volume.source
+    return None
+
+
+def _get_existing_static_space_bucket(
+    space_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> str | None:
+    hf_api = hf_api or huggingface_hub.HfApi()
+    try:
+        config_path = hf_api.hf_hub_download(
+            repo_id=space_id,
+            repo_type="space",
+            filename="config.json",
+        )
+    except (FileNotFoundError, HfHubHTTPError, OSError, ValueError):
+        return None
+
+    try:
+        with open(config_path, encoding="utf-8") as config_file:
+            config = json_mod.load(config_file)
+    except (OSError, ValueError, TypeError):
+        return None
+
+    bucket_id = config.get("bucket_id")
+    if isinstance(bucket_id, str) and bucket_id:
+        return bucket_id
+    return None
+
+
+def _ensure_bucket_mounted_at_data(
+    space_id: str,
+    bucket_id: str,
+    hf_api: huggingface_hub.HfApi | None = None,
+) -> None:
+    hf_api = hf_api or huggingface_hub.HfApi()
+    existing = _get_space_volumes(space_id, hf_api=hf_api)
+    already_mounted = any(
+        v.type == "bucket" and v.source == bucket_id and v.mount_path == "/data"
+        for v in existing
+    )
+    if not already_mounted:
+        preserved = [
+            v
+            for v in existing
+            if not (
+                v.type == "bucket"
+                and (v.source == bucket_id or v.mount_path == "/data")
+            )
+        ]
+        hf_api.set_space_volumes(
+            space_id,
+            preserved + [Volume(type="bucket", source=bucket_id, mount_path="/data")],
+        )
+        print(f"* Attached bucket {bucket_id} at '/data'")
+
+    existing_variables = hf_api.get_space_variables(space_id)
+    current_trackio_dir = getattr(existing_variables.get("TRACKIO_DIR"), "value", None)
+    if current_trackio_dir != "/data/trackio":
+        huggingface_hub.add_space_variable(space_id, "TRACKIO_DIR", "/data/trackio")
+    current_bucket_id = getattr(
+        existing_variables.get("TRACKIO_BUCKET_ID"), "value", None
+    )
+    if current_bucket_id != bucket_id:
+        huggingface_hub.add_space_variable(space_id, "TRACKIO_BUCKET_ID", bucket_id)
+
+
+def _bucket_exists(bucket_id: str, hf_api: huggingface_hub.HfApi | None = None) -> bool:
+    hf_api = hf_api or huggingface_hub.HfApi()
+    try:
+        hf_api.bucket_info(bucket_id)
+        return True
+    except BucketNotFoundError:
+        return False
+
+
+def _find_available_bucket_id(
+    preferred_bucket_id: str, hf_api: huggingface_hub.HfApi | None = None
+) -> str:
+    hf_api = hf_api or huggingface_hub.HfApi()
+    if not _bucket_exists(preferred_bucket_id, hf_api):
+        return preferred_bucket_id
+
+    suffix = 2
+    while True:
+        candidate = f"{preferred_bucket_id}-{suffix}"
+        if not _bucket_exists(candidate, hf_api):
+            return candidate
+        suffix += 1
+
+
+def resolve_auto_bucket_id(
+    space_id: str,
+    preferred_bucket_id: str,
+    hf_api: huggingface_hub.HfApi | None = None,
+) -> str:
+    """
+    Resolve the bucket to use for an auto-generated bucket ID.
+
+    Rules:
+    - Existing Space with a bucket mounted at /data -> reuse that bucket.
+    - Existing static Space with a bucket_id in config.json -> reuse that bucket.
+    - Otherwise -> use the preferred auto bucket ID if free, or a suffixed variant.
+    """
+    hf_api = hf_api or huggingface_hub.HfApi()
+    try:
+        info = hf_api.space_info(space_id)
+    except RepositoryNotFoundError:
+        pass
+    else:
+        existing_bucket_id = _get_existing_space_bucket(space_id, hf_api=hf_api)
+        if existing_bucket_id is None and getattr(info, "sdk", None) == "static":
+            existing_bucket_id = _get_existing_static_space_bucket(
+                space_id, hf_api=hf_api
+            )
+        if existing_bucket_id is not None:
+            return existing_bucket_id
+
+    bucket_id = _find_available_bucket_id(preferred_bucket_id, hf_api)
+    if bucket_id != preferred_bucket_id:
+        print(
+            f"* Auto-generated bucket {preferred_bucket_id} already exists; "
+            f"using {bucket_id} instead"
+        )
+    return bucket_id
+
+
+def _get_source_install_dependencies() -> str:
+    """Get trackio dependencies from pyproject.toml for source installs."""
+    try:
+        import tomllib  # noqa: PLC0415
+    except ModuleNotFoundError:
+        import tomli as tomllib  # noqa: PLC0415
+
+    trackio_path = files("trackio")
+    pyproject_path = Path(trackio_path).parent / "pyproject.toml"
+    with open(pyproject_path, "rb") as f:
+        pyproject = tomllib.load(f)
+    deps = pyproject["project"]["dependencies"]
+    spaces_deps = (
+        pyproject["project"].get("optional-dependencies", {}).get("spaces", [])
+    )
+    mcp_deps = pyproject["project"].get("optional-dependencies", {}).get("mcp", [])
+    return "\n".join(deps + spaces_deps + mcp_deps)
+
+
+def _get_space_install_requirement() -> str:
+    return f"trackio[spaces,mcp]=={trackio.__version__}"
+
+
+def _is_trackio_installed_from_source() -> bool:
+    """Check if trackio is installed from source/editable install vs PyPI."""
+    try:
+        trackio_file = trackio.__file__
+        if "site-packages" not in trackio_file and "dist-packages" not in trackio_file:
+            return True
+
+        dist = importlib.metadata.distribution("trackio")
+        if dist.files:
+            files = list(dist.files)
+            has_pth = any(".pth" in str(f) for f in files)
+            if has_pth:
+                return True
+
+        return False
+    except (
+        AttributeError,
+        importlib.metadata.PackageNotFoundError,
+        importlib.metadata.MetadataError,
+        ValueError,
+        TypeError,
+    ):
+        return True
+
+
+def _upload_source_tree(
+    hf_api: huggingface_hub.HfApi, space_id: str, parent_commit: str | None = None
+) -> huggingface_hub.CommitInfo:
+    return hf_api.upload_folder(
+        repo_id=space_id,
+        repo_type="space",
+        folder_path=files("trackio"),
+        path_in_repo="trackio",
+        parent_commit=parent_commit,
+        ignore_patterns=[
+            "README.md",
+            "frontend/node_modules/**",
+            "frontend/src/**",
+            "frontend/.gitignore",
+            "frontend/package.json",
+            "frontend/package-lock.json",
+            "frontend/vite.config.js",
+            "frontend/svelte.config.js",
+            "**/__pycache__/**",
+            "*.pyc",
+        ],
+    )
+
+
+def deploy_as_space(
+    space_id: str,
+    space_storage: huggingface_hub.SpaceStorage | None = None,
+    dataset_id: str | None = None,
+    bucket_id: str | None = None,
+    private: bool | None = None,
+    frontend_dir: str | Path | None = None,
+):
+    if on_spaces():  # in case a repo with this function is uploaded to spaces
+        return
+
+    if dataset_id is not None and bucket_id is not None:
+        raise ValueError(
+            "Cannot use bucket volume options together with dataset_id; use one persistence mode."
+        )
+    if dataset_id is not None:
+        warn_dataset_persistence_deprecated()
+
+    trackio_path = files("trackio")
+
+    hf_api = huggingface_hub.HfApi()
+
+    try:
+        huggingface_hub.create_repo(
+            space_id,
+            private=private,
+            space_sdk="gradio",
+            space_storage=space_storage,
+            repo_type="space",
+            exist_ok=True,
+        )
+    except HfHubHTTPError as e:
+        if e.response.status_code in [401, 403]:  # unauthorized or forbidden
+            print("Need 'write' access token to create a Spaces repo.")
+            huggingface_hub.login(add_to_git_credential=False)
+            huggingface_hub.create_repo(
+                space_id,
+                private=private,
+                space_sdk="gradio",
+                space_storage=space_storage,
+                repo_type="space",
+                exist_ok=True,
+            )
+        else:
+            raise ValueError(f"Failed to create Space: {e}")
+
+    # We can assume huggingface-hub is available; requirements.txt pins trackio.
+    # Make sure necessary dependencies are installed by creating a requirements.txt.
+    is_source_install = _is_trackio_installed_from_source()
+    resolved_frontend = resolve_frontend_dir(frontend_dir, announce=True)
+
+    if bucket_id is not None:
+        create_bucket_if_not_exists(bucket_id, private=private)
+
+    with open(Path(trackio_path, "README.md"), "r", encoding="utf-8") as f:
+        readme_content = f.read()
+        readme_content = readme_content.replace("sdk_version: {GRADIO_VERSION}\n", "")
+        readme_content = readme_content.replace("{APP_FILE}", "app.py")
+        readme_content = readme_content.replace(
+            "{LINKED_HUB_METADATA}", _readme_linked_hub_yaml(dataset_id)
+        )
+        readme_buffer = io.BytesIO(readme_content.encode("utf-8"))
+        hf_api.upload_file(
+            path_or_fileobj=readme_buffer,
+            path_in_repo="README.md",
+            repo_id=space_id,
+            repo_type="space",
+        )
+
+    if is_source_install:
+        requirements_content = _get_source_install_dependencies()
+    else:
+        requirements_content = _get_space_install_requirement()
+
+    requirements_buffer = io.BytesIO(requirements_content.encode("utf-8"))
+    hf_api.upload_file(
+        path_or_fileobj=requirements_buffer,
+        path_in_repo="requirements.txt",
+        repo_id=space_id,
+        repo_type="space",
+    )
+
+    huggingface_hub.utils.disable_progress_bars()
+
+    if is_source_install:
+        dist_index = (
+            Path(trackio.__file__).resolve().parent / "frontend" / "dist" / "index.html"
+        )
+        if not dist_index.is_file() and not resolved_frontend.is_custom:
+            raise ValueError(
+                "The Trackio frontend build is missing. From the repository root run "
+                "`cd trackio/frontend && npm ci && npm run build`, then deploy again."
+            )
+        _upload_source_tree(hf_api, space_id)
+
+    if resolved_frontend.is_custom:
+        _upload_frontend_folder(
+            hf_api,
+            repo_id=space_id,
+            repo_type="space",
+            folder_path=resolved_frontend.path,
+            path_in_repo=_CUSTOM_SPACE_FRONTEND_DIR,
+        )
+
+    app_file_content = _space_app_py(
+        _CUSTOM_SPACE_FRONTEND_DIR if resolved_frontend.is_custom else None
+    )
+    app_file_buffer = io.BytesIO(app_file_content.encode("utf-8"))
+    hf_api.upload_file(
+        path_or_fileobj=app_file_buffer,
+        path_in_repo="app.py",
+        repo_id=space_id,
+        repo_type="space",
+    )
+
+    if hf_token := huggingface_hub.utils.get_token():
+        huggingface_hub.add_space_secret(space_id, "HF_TOKEN", hf_token)
+    if bucket_id is not None:
+        _ensure_bucket_mounted_at_data(space_id, bucket_id, hf_api)
+    elif dataset_id is not None:
+        huggingface_hub.add_space_variable(space_id, "TRACKIO_DATASET_ID", dataset_id)
+    if logo_light_url := os.environ.get("TRACKIO_LOGO_LIGHT_URL"):
+        huggingface_hub.add_space_variable(
+            space_id, "TRACKIO_LOGO_LIGHT_URL", logo_light_url
+        )
+    if logo_dark_url := os.environ.get("TRACKIO_LOGO_DARK_URL"):
+        huggingface_hub.add_space_variable(
+            space_id, "TRACKIO_LOGO_DARK_URL", logo_dark_url
+        )
+    if plot_order := os.environ.get("TRACKIO_PLOT_ORDER"):
+        huggingface_hub.add_space_variable(space_id, "TRACKIO_PLOT_ORDER", plot_order)
+    if theme := os.environ.get("TRACKIO_THEME"):
+        huggingface_hub.add_space_variable(space_id, "TRACKIO_THEME", theme)
+    huggingface_hub.add_space_variable(space_id, "GRADIO_MCP_SERVER", "True")
+
+
+def create_space_if_not_exists(
+    space_id: str,
+    space_storage: huggingface_hub.SpaceStorage | None = None,
+    dataset_id: str | None = None,
+    bucket_id: str | None = None,
+    private: bool | None = None,
+    frontend_dir: str | Path | None = None,
+) -> bool:
+    """
+    Creates a new Hugging Face Space if it does not exist. Returns True if a
+    new Space was created, False if an existing Space was found.
+
+    Args:
+        space_id (`str`):
+            The ID of the Space to create.
+        space_storage ([`~huggingface_hub.SpaceStorage`], *optional*):
+            Choice of persistent storage tier for the Space.
+        dataset_id (`str`, *optional*):
+            Deprecated: persisting trackio data to a Hugging Face Dataset will be
+            removed in a future version of trackio. Use `bucket_id` (a Hugging
+            Face Bucket) instead.
+        bucket_id (`str`, *optional*):
+            Full Hub bucket id (`namespace/name`) to attach via the Hub volumes API (platform mount).
+            Sets `TRACKIO_DIR` to the mount path.
+        private (`bool`, *optional*):
+            Whether to make the Space private. If `None` (default), the repo will be
+            public unless the organization's default is private. This value is ignored
+            if the repo already exists.
+    """
+    if "/" not in space_id:
+        raise ValueError(
+            f"Invalid space ID: {space_id}. Must be in the format: username/reponame or orgname/reponame."
+        )
+    if dataset_id is not None and "/" not in dataset_id:
+        raise ValueError(
+            f"Invalid dataset ID: {dataset_id}. Must be in the format: username/datasetname or orgname/datasetname."
+        )
+    if bucket_id is not None and "/" not in bucket_id:
+        raise ValueError(
+            f"Invalid bucket ID: {bucket_id}. Must be in the format: username/bucketname or orgname/bucketname."
+        )
+    if dataset_id is not None:
+        warn_dataset_persistence_deprecated()
+    try:
+        huggingface_hub.repo_info(space_id, repo_type="space")
+        print(
+            f"* Found existing space: {_BOLD_ORANGE}{SPACE_URL.format(space_id=space_id)}{_RESET}"
+        )
+        if bucket_id is not None:
+            create_bucket_if_not_exists(bucket_id, private=private)
+            _ensure_bucket_mounted_at_data(space_id, bucket_id)
+        elif dataset_id is not None:
+            huggingface_hub.add_space_variable(
+                space_id, "TRACKIO_DATASET_ID", dataset_id
+            )
+        resolved_frontend = resolve_frontend_dir(frontend_dir, announce=False)
+        if resolved_frontend.is_custom:
+            deploy_as_space(
+                space_id,
+                space_storage,
+                dataset_id,
+                bucket_id,
+                private,
+                frontend_dir=frontend_dir,
+            )
+        return False
+    except RepositoryNotFoundError:
+        pass
+    except HfHubHTTPError as e:
+        if e.response.status_code in [401, 403]:  # unauthorized or forbidden
+            print("Need 'write' access token to create a Spaces repo.")
+            huggingface_hub.login(add_to_git_credential=False)
+        else:
+            raise ValueError(f"Failed to create Space: {e}")
+
+    print(
+        f"* Creating new space: {_BOLD_ORANGE}{SPACE_URL.format(space_id=space_id)}{_RESET}"
+    )
+    deploy_as_space(
+        space_id,
+        space_storage,
+        dataset_id,
+        bucket_id,
+        private,
+        frontend_dir=frontend_dir,
+    )
+    threading.Thread(
+        target=_warn_if_space_build_fails, args=(space_id,), daemon=True
+    ).start()
+    return True
+
+
+def space_is_running(space_id: str) -> bool:
+    try:
+        info = huggingface_hub.HfApi().space_info(space_id, timeout=30)
+        return bool(info.runtime) and str(info.runtime.stage) == "RUNNING"
+    except Exception:
+        return False
+
+
+def _warn_if_space_build_fails(space_id: str, timeout: int = 600) -> None:
+    hf_api = huggingface_hub.HfApi()
+    failure_stages = frozenset(
+        ("NO_APP_FILE", "CONFIG_ERROR", "BUILD_ERROR", "RUNTIME_ERROR")
+    )
+    start = time.time()
+    while time.time() - start < timeout:
+        try:
+            info = hf_api.space_info(space_id, timeout=30)
+            if info.runtime:
+                stage = str(info.runtime.stage)
+                if stage in failure_stages:
+                    print(
+                        f"\n* WARNING: Space {space_id} failed to build (stage: {stage}). "
+                        f"Logs are being saved to the Bucket and will appear once the Space "
+                        f"is fixed; see the build logs at {SPACE_URL.format(space_id=space_id)}"
+                    )
+                    return
+                if stage == "RUNNING":
+                    return
+        except Exception:
+            pass
+        time.sleep(10)
+
+
+def _wait_until_space_running(space_id: str, timeout: int = 300) -> None:
+    hf_api = huggingface_hub.HfApi()
+    start = time.time()
+    delay = 2
+    request_timeout = 45.0
+    failure_stages = frozenset(
+        ("NO_APP_FILE", "CONFIG_ERROR", "BUILD_ERROR", "RUNTIME_ERROR")
+    )
+    while time.time() - start < timeout:
+        try:
+            info = hf_api.space_info(space_id, timeout=request_timeout)
+            if info.runtime:
+                stage = str(info.runtime.stage)
+                if stage in failure_stages:
+                    raise RuntimeError(
+                        f"Space {space_id} entered terminal stage {stage}. "
+                        "Fix README.md or app files; see build logs on the Hub."
+                    )
+                if stage == "RUNNING":
+                    return
+        except RuntimeError:
+            raise
+        except (huggingface_hub.utils.HfHubHTTPError, httpx.RequestError):
+            pass
+        time.sleep(delay)
+        delay = min(delay * 1.5, 15)
+    raise TimeoutError(
+        f"Space {space_id} did not reach RUNNING within {timeout}s. "
+        "Check status and build logs on the Hub."
+    )
+
+
+def wait_until_space_exists(
+    space_id: str,
+) -> None:
+    """
+    Blocks the current thread until the Space exists.
+
+    Args:
+        space_id (`str`):
+            The ID of the Space to wait for.
+
+    Raises:
+        `TimeoutError`: If waiting for the Space takes longer than expected.
+    """
+    hf_api = huggingface_hub.HfApi()
+    delay = 1
+    for _ in range(30):
+        try:
+            hf_api.space_info(space_id)
+            return
+        except (huggingface_hub.utils.HfHubHTTPError, httpx.RequestError):
+            time.sleep(delay)
+            delay = min(delay * 2, 60)
+    raise TimeoutError("Waiting for space to exist took longer than expected")
+
+
+def upload_db_to_space(project: str, space_id: str, force: bool = False) -> None:
+    """
+    Uploads the database of a local Trackio project to a Hugging Face Space.
+
+    This uses the Trackio remote client so newer Trackio Spaces can speak the direct
+    HTTP API while older Gradio-based Spaces still work through `gradio_client`.
+
+    Args:
+        project (`str`):
+            The name of the project to upload.
+        space_id (`str`):
+            The ID of the Space to upload to.
+        force (`bool`, *optional*, defaults to `False`):
+            If `True`, overwrites the existing database without prompting. If `False`,
+            prompts for confirmation.
+    """
+    db_path = SQLiteStorage.get_project_db_path(project)
+    client = RemoteClient(
+        space_id,
+        hf_token=huggingface_hub.utils.get_token(),
+        httpx_kwargs={"timeout": 90},
+    )
+
+    if not force:
+        try:
+            existing_projects = client.predict(api_name="/get_all_projects")
+            if project in existing_projects:
+                response = input(
+                    f"Database for project '{project}' already exists on Space '{space_id}'. "
+                    f"Overwrite it? (y/N): "
+                )
+                if response.lower() not in ["y", "yes"]:
+                    print("* Upload cancelled.")
+                    return
+        except Exception as e:
+            print(f"* Warning: Could not check if project exists on Space: {e}")
+            print("* Proceeding with upload...")
+
+    client.predict(
+        api_name="/upload_db_to_space",
+        project=project,
+        uploaded_db=handle_file(db_path),
+        hf_token=huggingface_hub.utils.get_token(),
+    )
+
+
+SYNC_BATCH_SIZE = 500
+
+
+def _replay_pending_uploads(
+    project: str,
+    client: "RemoteClient",
+    hf_token: str | None,
+) -> None:
+    """Replay queued `pending_uploads` rows for `project` via `client` — the
+    out-of-Run sync path (`trackio sync`); see `replay_pending_uploads` for the
+    per-kind routing and clearing semantics.
+    """
+    pending_uploads = SQLiteStorage.get_pending_uploads(project)
+    if not pending_uploads:
+        return
+
+    def _warn_missing(count: int, sample: str) -> None:
+        print(
+            f"  Warning: dropping {count} pending upload(s) whose local files "
+            f"no longer exist (e.g. {sample!r})."
+        )
+
+    replay_pending_uploads(
+        pending_uploads,
+        project,
+        predict=client.predict,
+        hf_token=hf_token,
+        warn_missing=_warn_missing,
+        verbose=True,
+    )
+
+
+def sync_incremental(
+    project: str,
+    space_id: str,
+    private: bool | None = None,
+    pending_only: bool = False,
+    frontend_dir: str | Path | None = None,
+) -> None:
+    """
+    Syncs a local Trackio project to a Space via the bulk_log API endpoints
+    instead of uploading the entire DB file. Supports incremental sync.
+
+    Args:
+        project: The name of the project to sync.
+        space_id: The HF Space ID to sync to.
+        private: Whether to make the Space private if creating.
+        pending_only: If True, only sync rows tagged with space_id (pending data).
+    """
+    print(
+        f"* Syncing project '{project}' to: {SPACE_URL.format(space_id=space_id)} (please wait...)"
+    )
+    create_space_if_not_exists(space_id, private=private, frontend_dir=frontend_dir)
+    wait_until_space_exists(space_id)
+    hf_token = huggingface_hub.utils.get_token()
+    expected_run_counts: Counter[str] = Counter()
+
+    client = RemoteClient(
+        space_id,
+        hf_token=hf_token,
+        httpx_kwargs={"timeout": 90},
+    )
+
+    if pending_only:
+        pending_logs = SQLiteStorage.get_pending_logs(project)
+        if pending_logs:
+            logs = pending_logs["logs"]
+            expected_run_counts.update(log["run"] for log in logs)
+            for i in range(0, len(logs), SYNC_BATCH_SIZE):
+                batch = logs[i : i + SYNC_BATCH_SIZE]
+                print(
+                    f"  Syncing metrics: {min(i + SYNC_BATCH_SIZE, len(logs))}/{len(logs)}..."
+                )
+                client.predict(api_name="/bulk_log", logs=batch, hf_token=hf_token)
+            SQLiteStorage.clear_pending_logs(project, pending_logs["ids"])
+
+        pending_sys = SQLiteStorage.get_pending_system_logs(project)
+        if pending_sys:
+            logs = pending_sys["logs"]
+            for i in range(0, len(logs), SYNC_BATCH_SIZE):
+                batch = logs[i : i + SYNC_BATCH_SIZE]
+                print(
+                    f"  Syncing system metrics: {min(i + SYNC_BATCH_SIZE, len(logs))}/{len(logs)}..."
+                )
+                client.predict(
+                    api_name="/bulk_log_system", logs=batch, hf_token=hf_token
+                )
+            SQLiteStorage.clear_pending_system_logs(project, pending_sys["ids"])
+
+        _replay_pending_uploads(project, client, hf_token)
+    else:
+        all_logs = SQLiteStorage.get_all_logs_for_sync(project)
+        if all_logs:
+            expected_run_counts.update(log["run"] for log in all_logs)
+            for i in range(0, len(all_logs), SYNC_BATCH_SIZE):
+                batch = all_logs[i : i + SYNC_BATCH_SIZE]
+                print(
+                    f"  Syncing metrics: {min(i + SYNC_BATCH_SIZE, len(all_logs))}/{len(all_logs)}..."
+                )
+                client.predict(api_name="/bulk_log", logs=batch, hf_token=hf_token)
+
+        all_sys_logs = SQLiteStorage.get_all_system_logs_for_sync(project)
+        if all_sys_logs:
+            for i in range(0, len(all_sys_logs), SYNC_BATCH_SIZE):
+                batch = all_sys_logs[i : i + SYNC_BATCH_SIZE]
+                print(
+                    f"  Syncing system metrics: {min(i + SYNC_BATCH_SIZE, len(all_sys_logs))}/{len(all_sys_logs)}..."
+                )
+                client.predict(
+                    api_name="/bulk_log_system", logs=batch, hf_token=hf_token
+                )
+
+    _wait_for_remote_sync(client, project, expected_run_counts)
+    SQLiteStorage.set_project_metadata(project, "space_id", space_id)
+    print(
+        f"* Synced successfully to space: {_BOLD_ORANGE}{SPACE_URL.format(space_id=space_id)}{_RESET}"
+    )
+
+
+def _build_remote_client_with_retry(
+    space_id: str,
+    timeout: int = 360,
+    verbose: bool = False,
+) -> RemoteClient:
+    deadline = time.time() + timeout
+    delay = 2
+    last_error: Exception | None = None
+    while time.time() < deadline:
+        try:
+            return RemoteClient(
+                space_id,
+                hf_token=huggingface_hub.utils.get_token(),
+                verbose=verbose,
+                httpx_kwargs={"timeout": 90},
+            )
+        except (ValueError, ConnectionError) as e:
+            last_error = e
+            time.sleep(delay)
+            delay = min(delay * 1.5, 15)
+    raise ConnectionError(
+        f"Could not connect to Space '{space_id}' within {timeout}s: {last_error}"
+    )
+
+
+def _wait_for_remote_sync(
+    client: RemoteClient,
+    project: str,
+    expected_run_counts: Counter[str],
+    timeout: int = 180,
+) -> None:
+    if not expected_run_counts:
+        return
+
+    deadline = time.time() + timeout
+    delay = 2
+    last_error: Exception | None = None
+    pending = dict(expected_run_counts)
+
+    while time.time() < deadline and pending:
+        completed = []
+        for run_name, expected_num_logs in pending.items():
+            try:
+                summary = client.predict(
+                    project=project, run=run_name, api_name="/get_run_summary"
+                )
+                if summary.get("num_logs") == expected_num_logs:
+                    completed.append(run_name)
+            except Exception as e:
+                last_error = e
+        for run_name in completed:
+            pending.pop(run_name, None)
+        if pending:
+            time.sleep(delay)
+            delay = min(delay * 1.5, 15)
+
+    if pending:
+        raise TimeoutError(
+            f"Remote sync for project '{project}' did not become visible for runs "
+            f"{sorted(pending.items())} within {timeout}s. "
+            f"Last error: {last_error!r}"
+        )
+
+
+def upload_dataset_for_static(
+    project: str,
+    dataset_id: str,
+    private: bool | None = None,
+) -> None:
+    hf_api = huggingface_hub.HfApi()
+
+    try:
+        huggingface_hub.create_repo(
+            dataset_id,
+            private=private,
+            repo_type="dataset",
+            exist_ok=True,
+        )
+    except HfHubHTTPError as e:
+        if e.response.status_code in [401, 403]:
+            print("Need 'write' access token to create a Dataset repo.")
+            huggingface_hub.login(add_to_git_credential=False)
+            huggingface_hub.create_repo(
+                dataset_id,
+                private=private,
+                repo_type="dataset",
+                exist_ok=True,
+            )
+        else:
+            raise ValueError(f"Failed to create Dataset: {e}")
+
+    def _upload_folder(folder: Path, path_in_repo: str, ignore_patterns=None) -> None:
+        if not folder.exists():
+            return
+        _retry_hf_write(
+            f"Dataset {path_in_repo} upload",
+            lambda: hf_api.upload_folder(
+                repo_id=dataset_id,
+                repo_type="dataset",
+                folder_path=str(folder),
+                path_in_repo=path_in_repo,
+                ignore_patterns=ignore_patterns,
+            ),
+        )
+
+    with tempfile.TemporaryDirectory() as tmp_dir:
+        output_dir = Path(tmp_dir)
+        SQLiteStorage.export_for_static_space(project, output_dir)
+
+        _upload_folder(project_media_dir(project), "media")
+        _upload_folder(project_artifacts_dir(project), "artifacts", [PARTIAL_BLOB_GLOB])
+
+        _retry_hf_write(
+            "Dataset upload",
+            lambda: hf_api.upload_folder(
+                repo_id=dataset_id,
+                repo_type="dataset",
+                folder_path=str(output_dir),
+            ),
+        )
+
+    print(f"* Dataset uploaded: https://huggingface.co/datasets/{dataset_id}")
+
+
+def deploy_as_static_space(
+    space_id: str,
+    dataset_id: str | None,
+    project: str,
+    bucket_id: str | None = None,
+    private: bool | None = None,
+    hf_token: str | None = None,
+    frontend_dir: str | Path | None = None,
+) -> None:
+    if on_spaces():
+        return
+
+    if private is True:
+        raise ValueError(
+            "private=True is not supported for static Trackio Spaces. Static Spaces "
+            "run entirely in the browser, so their snapshot data must be public. "
+            "Use sdk='gradio' for a private dashboard."
+        )
+    if dataset_id is not None:
+        warn_dataset_persistence_deprecated()
+    hf_api = huggingface_hub.HfApi()
+
+    try:
+        huggingface_hub.create_repo(
+            space_id,
+            private=False,
+            space_sdk="static",
+            repo_type="space",
+            exist_ok=True,
+        )
+    except HfHubHTTPError as e:
+        if e.response.status_code in [401, 403]:
+            print("Need 'write' access token to create a Spaces repo.")
+            huggingface_hub.login(add_to_git_credential=False)
+            huggingface_hub.create_repo(
+                space_id,
+                private=False,
+                space_sdk="static",
+                repo_type="space",
+                exist_ok=True,
+            )
+        else:
+            raise ValueError(f"Failed to create Space: {e}")
+
+    linked = _readme_linked_hub_yaml(dataset_id)
+    readme_content = (
+        f"---\nemoji: 🎯\nsdk: static\npinned: false\ntags:\n - trackio\n{linked}---\n"
+    )
+    _retry_hf_write(
+        "Static Space README upload",
+        lambda: hf_api.upload_file(
+            path_or_fileobj=io.BytesIO(readme_content.encode("utf-8")),
+            path_in_repo="README.md",
+            repo_id=space_id,
+            repo_type="space",
+        ),
+    )
+
+    resolved_frontend = resolve_frontend_dir(frontend_dir, announce=True)
+
+    _retry_hf_write(
+        "Static Space frontend upload",
+        lambda: hf_api.upload_folder(
+            repo_id=space_id,
+            repo_type="space",
+            folder_path=str(resolved_frontend.path),
+        ),
+    )
+
+    config = {
+        "mode": "static",
+        "project": project,
+        "private": bool(private),
+        "version": trackio.__version__,
+    }
+    if bucket_id is not None:
+        config["bucket_id"] = bucket_id
+    if dataset_id is not None:
+        config["dataset_id"] = dataset_id
+    if hf_token is not None:
+        warnings.warn(
+            "`hf_token` is ignored by deploy_as_static_space() for static Space "
+            "deployment and will be removed in a future release.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+    _retry_hf_write(
+        "Static Space config upload",
+        lambda: hf_api.upload_file(
+            path_or_fileobj=io.BytesIO(json_mod.dumps(config).encode("utf-8")),
+            path_in_repo="config.json",
+            repo_id=space_id,
+            repo_type="space",
+        ),
+    )
+
+    assets_dir = Path(trackio.__file__).resolve().parent / "assets"
+    if assets_dir.is_dir():
+        _retry_hf_write(
+            "Static Space assets upload",
+            lambda: hf_api.upload_folder(
+                repo_id=space_id,
+                repo_type="space",
+                folder_path=str(assets_dir),
+                path_in_repo="static/trackio",
+            ),
+        )
+
+    print(
+        f"* Static Space deployed: {_BOLD_ORANGE}{SPACE_URL.format(space_id=space_id)}{_RESET}"
+    )
+
+
+def sync(
+    project: str,
+    space_id: str | None = None,
+    private: bool | None = None,
+    force: bool = False,
+    run_in_background: bool = False,
+    sdk: str = "gradio",
+    dataset_id: str | None = None,
+    bucket_id: str | None = None,
+    frontend_dir: str | Path | None = None,
+) -> str:
+    """
+    Syncs a local Trackio project's database to a Hugging Face Space.
+    If the Space does not exist, it will be created. Local data is never deleted.
+
+    **Freezing:** Passing ``sdk="static"`` deploys a static Space backed by an HF Bucket
+    (read-only dashboard, no Gradio server). You can sync the same project again later to
+    refresh that static Space. If you want a one-time snapshot of an existing Gradio Space,
+    use ``freeze()`` instead.
+
+    Args:
+        project (`str`): The name of the project to upload.
+        space_id (`str`, *optional*): The ID of the Space to upload to (e.g., `"username/space_id"`).
+            If not provided, checks project metadata first, then generates a random space_id.
+        private (`bool`, *optional*):
+            Whether to make the Space private. If None (default), the repo will be
+            public unless the organization's default is private. This value is ignored
+            if the repo already exists. Not supported with ``sdk="static"`` because
+            static Trackio dashboards read snapshot data directly from the browser.
+        force (`bool`, *optional*, defaults to `False`):
+            If `True`, overwrite the existing database without prompting for confirmation.
+            If `False`, prompt the user before overwriting an existing database.
+        run_in_background (`bool`, *optional*, defaults to `False`):
+            If `True`, the Space creation and database upload will be run in a background thread.
+            If `False`, all the steps will be run synchronously.
+        sdk (`str`, *optional*, defaults to `"gradio"`):
+            The type of Space to deploy. `"gradio"` deploys a Gradio Space with a live
+            server. `"static"` freezes the Space: deploys a static Space that reads from an HF Bucket
+            (no server needed).
+        dataset_id (`str`, *optional*):
+            Deprecated: persisting trackio data to a Hugging Face Dataset will be
+            removed in a future version of trackio. Use `bucket_id` (a Hugging
+            Face Bucket) instead.
+        bucket_id (`str`, *optional*):
+            The ID of the HF Bucket to sync to. By default, a bucket is auto-generated
+            from the space_id.
+    Returns:
+        `str`: The Space ID of the synced project.
+    """
+    if sdk not in ("gradio", "static"):
+        raise ValueError(f"sdk must be 'gradio' or 'static', got '{sdk}'")
+    if sdk == "static" and private is True:
+        raise ValueError(
+            "private=True is not supported for static Trackio Spaces. Static Spaces "
+            "run entirely in the browser, so their snapshot data must be public. "
+            "Use sdk='gradio' for a private dashboard."
+        )
+    bucket_id_was_explicit = bucket_id is not None
+
+    if space_id is None:
+        space_id = SQLiteStorage.get_space_id(project)
+    if space_id is None:
+        space_id = f"{project}-{get_or_create_project_hash(project)}"
+    space_id, dataset_id, bucket_id = preprocess_space_and_dataset_ids(
+        space_id, dataset_id, bucket_id
+    )
+    if dataset_id is None and bucket_id is not None and not bucket_id_was_explicit:
+        bucket_id = resolve_auto_bucket_id(space_id, bucket_id)
+
+    def _do_sync():
+        try:
+            info = huggingface_hub.HfApi().space_info(space_id)
+            existing_sdk = info.sdk
+            if existing_sdk and existing_sdk != sdk:
+                raise ValueError(
+                    f"Space '{space_id}' is a '{existing_sdk}' Space but sdk='{sdk}' was requested. "
+                    f"The sdk must match the existing Space type."
+                )
+        except RepositoryNotFoundError:
+            pass
+
+        if sdk == "static":
+            if dataset_id is not None:
+                upload_dataset_for_static(project, dataset_id, private=False)
+                deploy_as_static_space(
+                    space_id,
+                    dataset_id,
+                    project,
+                    private=False,
+                    frontend_dir=frontend_dir,
+                )
+            elif bucket_id is not None:
+                create_bucket_if_not_exists(bucket_id, private=False)
+                upload_project_to_bucket_for_static(project, bucket_id)
+                print(
+                    f"* Project data uploaded to bucket: https://huggingface.co/buckets/{bucket_id}"
+                )
+                deploy_as_static_space(
+                    space_id,
+                    None,
+                    project,
+                    bucket_id=bucket_id,
+                    private=False,
+                    frontend_dir=frontend_dir,
+                )
+        else:
+            if bucket_id is not None:
+                create_bucket_if_not_exists(bucket_id, private=private)
+                upload_project_to_bucket(project, bucket_id)
+                print(
+                    f"* Project data uploaded to bucket: https://huggingface.co/buckets/{bucket_id}"
+                )
+                create_space_if_not_exists(
+                    space_id,
+                    bucket_id=bucket_id,
+                    private=private,
+                    frontend_dir=frontend_dir,
+                )
+                _wait_until_space_running(space_id)
+                _wait_for_remote_sync(
+                    _build_remote_client_with_retry(space_id),
+                    project,
+                    Counter(
+                        log["run"]
+                        for log in SQLiteStorage.get_all_logs_for_sync(project)
+                    ),
+                )
+            else:
+                sync_incremental(
+                    project,
+                    space_id,
+                    private=private,
+                    pending_only=False,
+                    frontend_dir=frontend_dir,
+                )
+        SQLiteStorage.set_project_metadata(project, "space_id", space_id)
+
+    if run_in_background:
+        threading.Thread(target=_do_sync).start()
+    else:
+        _do_sync()
+    return space_id
+
+
+def _get_source_bucket(space_id: str) -> str:
+    bucket_id = _get_existing_space_bucket(space_id)
+    if bucket_id is not None:
+        _ensure_bucket_mounted_at_data(space_id, bucket_id)
+        return bucket_id
+    raise ValueError(
+        f"Space '{space_id}' has no bucket mounted at '/data'. "
+        f"freeze() requires the source Space to use bucket storage."
+    )
+
+
+def freeze(
+    space_id: str,
+    project: str,
+    new_space_id: str | None = None,
+    private: bool | None = None,
+    bucket_id: str | None = None,
+    frontend_dir: str | Path | None = None,
+) -> str:
+    """
+    Creates a new static Hugging Face Space containing a read-only snapshot of
+    the data for the specified project from the source Gradio Space. The data is
+    read from the bucket attached to the source Space at freeze time. The original
+    Space is not modified, and the new static Space does not automatically reflect
+    metrics uploaded to the original Gradio Space after the freeze completes.
+
+    Args:
+        space_id (`str`):
+            The ID of the source Gradio Space (e.g., `"username/my-space"` or a
+            short repo name with the logged-in namespace inferred, like `init()`).
+            Must be a Gradio Space with a bucket mounted at `/data`.
+        project (`str`):
+            The name of the project whose data to include in the frozen Space.
+        new_space_id (`str`, *optional*):
+            The ID for the new static Space. If not provided, defaults to
+            `"{space_id}_static"`.
+        private (`bool`, *optional*):
+            Not supported. Frozen static dashboards read snapshot data directly
+            from the browser, so the destination snapshot must be public.
+        bucket_id (`str`, *optional*):
+            The ID of the HF Bucket for the new static Space's data storage.
+            If not provided, one is auto-generated from the new Space ID.
+
+    Returns:
+        `str`: The Space ID of the newly created static Space.
+    """
+    if private is True:
+        raise ValueError(
+            "private=True is not supported for frozen static Trackio Spaces. Static "
+            "Spaces run entirely in the browser, so their snapshot data must be "
+            "public. Use a Gradio Space if the frozen dashboard must stay private."
+        )
+    space_id, _, _ = preprocess_space_and_dataset_ids(space_id, None, None)
+
+    try:
+        info = huggingface_hub.HfApi().space_info(space_id)
+        if info.sdk != "gradio":
+            raise ValueError(
+                f"Space '{space_id}' is not a Gradio Space (sdk='{info.sdk}'). "
+                f"freeze() requires a Gradio Space as the source."
+            )
+    except RepositoryNotFoundError:
+        raise ValueError(
+            f"Space '{space_id}' not found. Provide an existing Gradio Space ID."
+        )
+
+    source_bucket_id = _get_source_bucket(space_id)
+    print(f"* Reading project data from bucket: {source_bucket_id}")
+
+    bucket_id_was_explicit = bucket_id is not None
+
+    if new_space_id is None:
+        new_space_id = f"{space_id}_static"
+    new_space_id, _dataset_id, bucket_id = preprocess_space_and_dataset_ids(
+        new_space_id, None, bucket_id
+    )
+    if bucket_id is not None and not bucket_id_was_explicit:
+        bucket_id = resolve_auto_bucket_id(new_space_id, bucket_id)
+
+    hf_api = huggingface_hub.HfApi()
+    try:
+        dest_info = hf_api.space_info(new_space_id)
+        tags = dest_info.tags or []
+        if dest_info.sdk != "static" or "trackio" not in tags:
+            raise ValueError(
+                f"Space '{new_space_id}' already exists and is not a Trackio static Space "
+                f"(sdk='{dest_info.sdk}', tags={tags}). Choose a different new_space_id "
+                f"or delete the existing Space first."
+            )
+    except RepositoryNotFoundError:
+        pass
+
+    create_bucket_if_not_exists(bucket_id, private=False)
+    export_from_bucket_for_static(source_bucket_id, bucket_id, project)
+    print(
+        f"* Project data uploaded to bucket: https://huggingface.co/buckets/{bucket_id}"
+    )
+    deploy_as_static_space(
+        new_space_id,
+        None,
+        project,
+        bucket_id=bucket_id,
+        private=False,
+        frontend_dir=frontend_dir,
+    )
+    return new_space_id

trackio/dummy_commit_scheduler.py

@@ -0,0 +1,19 @@
+from concurrent.futures import Future
+
+
+class DummyCommitSchedulerLock:
+    def __enter__(self):
+        return None
+
+    def __exit__(self, exception_type, exception_value, exception_traceback):
+        pass
+
+
+class DummyCommitScheduler:
+    def __init__(self):
+        self.lock = DummyCommitSchedulerLock()
+
+    def trigger(self) -> Future:
+        fut: Future = Future()
+        fut.set_result(None)
+        return fut

trackio/exceptions.py

@@ -0,0 +1,2 @@
+class TrackioAPIError(Exception):
+    pass

trackio/fragments.py

@@ -0,0 +1,389 @@
+"""Append-only JSONL fragments used as a durable fallback for metric logging.
+
+Fragments are immutable JSONL files, one writer (process) per subdirectory, so
+concurrent training processes never contend on a shared file. They are written
+either to a Hugging Face Bucket inbox (when a Space is unreachable) or to a
+local inbox directory (when SQLite is unsafe, e.g. on network filesystems), and
+are later imported into the project SQLite database by the process that owns it
+(the Space or the dashboard server). Records carry the same ``log_id``/
+``alert_id`` UUIDs as the HTTP logging endpoints, and imports use
+``INSERT OR IGNORE``, so importing a fragment is idempotent: fragments are
+deleted only after a successful import, and re-importing after a crash is
+harmless.
+"""
+
+import tempfile
+import threading
+import uuid
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any
+
+import huggingface_hub
+import orjson
+
+from trackio import utils
+from trackio.typehints import AlertEntry, LogEntry, SystemLogEntry
+
+FRAGMENT_VERSION = 1
+INBOX_DIR_NAME = "inbox"
+BUCKET_INBOX_PREFIX = "trackio/inbox"
+BUCKET_MEDIA_PREFIX = "trackio/media"
+
+METRIC_KIND = "metric"
+SYSTEM_METRIC_KIND = "system_metric"
+ALERT_KIND = "alert"
+KINDS = {METRIC_KIND, SYSTEM_METRIC_KIND, ALERT_KIND}
+
+
+def local_inbox_dir() -> Path:
+    return utils.TRACKIO_DIR / INBOX_DIR_NAME
+
+
+def metric_record(entry: LogEntry | dict) -> dict:
+    return {
+        "v": FRAGMENT_VERSION,
+        "kind": METRIC_KIND,
+        "project": entry["project"],
+        "run": entry["run"],
+        "run_id": entry.get("run_id"),
+        "metrics": utils.serialize_values(entry.get("metrics") or {}),
+        "step": entry.get("step"),
+        "timestamp": entry.get("timestamp"),
+        "config": utils.serialize_values(entry.get("config"))
+        if entry.get("config")
+        else None,
+        "log_id": entry.get("log_id"),
+    }
+
+
+def system_metric_record(entry: SystemLogEntry | dict) -> dict:
+    return {
+        "v": FRAGMENT_VERSION,
+        "kind": SYSTEM_METRIC_KIND,
+        "project": entry["project"],
+        "run": entry["run"],
+        "run_id": entry.get("run_id"),
+        "metrics": utils.serialize_values(entry.get("metrics") or {}),
+        "timestamp": entry.get("timestamp"),
+        "log_id": entry.get("log_id"),
+    }
+
+
+def alert_record(entry: AlertEntry | dict) -> dict:
+    return {
+        "v": FRAGMENT_VERSION,
+        "kind": ALERT_KIND,
+        "project": entry["project"],
+        "run": entry["run"],
+        "run_id": entry.get("run_id"),
+        "title": entry["title"],
+        "text": entry.get("text"),
+        "level": entry.get("level"),
+        "step": entry.get("step"),
+        "timestamp": entry.get("timestamp"),
+        "alert_id": entry.get("alert_id"),
+    }
+
+
+def bucket_media_path(
+    project: str,
+    run: str | None,
+    step: int | None,
+    relative_path: str | None,
+    filename: str,
+) -> str:
+    parts = [BUCKET_MEDIA_PREFIX, utils.canonical_project_name(project)]
+    if run:
+        parts.append(run)
+        if step is not None:
+            parts.append(str(step))
+    else:
+        parts.append("files")
+        if relative_path:
+            parts.append(str(relative_path))
+    parts.append(filename)
+    return "/".join(parts)
+
+
+class FragmentWriter:
+    """Writes immutable JSONL fragments for a single writer (process)."""
+
+    def __init__(self, writer_id: str | None = None):
+        self.writer_id = writer_id or uuid.uuid4().hex[:16]
+        self._seq = 0
+        self._lock = threading.Lock()
+
+    def _next_fragment_name(self) -> str:
+        with self._lock:
+            name = f"{self._seq:08d}.jsonl"
+            self._seq += 1
+        return name
+
+    @staticmethod
+    def serialize_records(records: list[dict]) -> bytes:
+        return b"".join(orjson.dumps(record) + b"\n" for record in records)
+
+    def write_local(
+        self, records: list[dict], inbox_dir: Path | None = None
+    ) -> Path | None:
+        if not records:
+            return None
+        inbox = inbox_dir or local_inbox_dir()
+        writer_dir = inbox / self.writer_id
+        fragment_path = writer_dir / self._next_fragment_name()
+        data = self.serialize_records(records)
+        for attempt in range(3):
+            writer_dir.mkdir(parents=True, exist_ok=True)
+            try:
+                with tempfile.NamedTemporaryFile(
+                    mode="wb", dir=writer_dir, suffix=".tmp", delete=False
+                ) as tmp:
+                    tmp.write(data)
+                    tmp_path = Path(tmp.name)
+                tmp_path.replace(fragment_path)
+                return fragment_path
+            except FileNotFoundError:
+                if attempt == 2 or writer_dir.exists():
+                    raise
+
+    def write_to_bucket(self, records: list[dict], bucket_id: str) -> str | None:
+        if not records:
+            return None
+        remote_path = (
+            f"{BUCKET_INBOX_PREFIX}/{self.writer_id}/{self._next_fragment_name()}"
+        )
+        huggingface_hub.batch_bucket_files(
+            bucket_id,
+            add=[(self.serialize_records(records), remote_path)],
+            token=huggingface_hub.utils.get_token(),
+        )
+        return remote_path
+
+
+def parse_fragment_bytes(data: bytes) -> list[dict]:
+    records = []
+    for line in data.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            record = orjson.loads(line)
+        except orjson.JSONDecodeError:
+            continue
+        if isinstance(record, dict) and record.get("kind") in KINDS:
+            records.append(record)
+    return records
+
+
+def _group_by_run(records: list[dict]) -> dict[tuple, list[dict]]:
+    grouped: dict[tuple, list[dict]] = {}
+    for record in records:
+        key = (record.get("project"), record.get("run"), record.get("run_id"))
+        grouped.setdefault(key, []).append(record)
+    return grouped
+
+
+def import_records(records: list[dict]) -> int:
+    from trackio.sqlite_storage import SQLiteStorage  # noqa: PLC0415
+
+    metric_records = [r for r in records if r.get("kind") == METRIC_KIND]
+    system_records = [r for r in records if r.get("kind") == SYSTEM_METRIC_KIND]
+    alert_records = [r for r in records if r.get("kind") == ALERT_KIND]
+    imported = 0
+
+    for (project, run, run_id), group in _group_by_run(metric_records).items():
+        if not project or not run:
+            continue
+        config = next((r["config"] for r in reversed(group) if r.get("config")), None)
+        has_timestamps = all(r.get("timestamp") for r in group)
+        SQLiteStorage.bulk_log(
+            project=project,
+            run=run,
+            run_id=run_id,
+            metrics_list=[r.get("metrics") or {} for r in group],
+            steps=[r.get("step") for r in group],
+            timestamps=[r["timestamp"] for r in group] if has_timestamps else None,
+            config=config,
+            log_ids=[r.get("log_id") for r in group],
+        )
+        imported += len(group)
+
+    for (project, run, run_id), group in _group_by_run(system_records).items():
+        if not project or not run:
+            continue
+        has_timestamps = all(r.get("timestamp") for r in group)
+        SQLiteStorage.bulk_log_system(
+            project=project,
+            run=run,
+            run_id=run_id,
+            metrics_list=[r.get("metrics") or {} for r in group],
+            timestamps=[r["timestamp"] for r in group] if has_timestamps else None,
+            log_ids=[r.get("log_id") for r in group],
+        )
+        imported += len(group)
+
+    for (project, run, run_id), group in _group_by_run(alert_records).items():
+        if not project or not run:
+            continue
+        has_timestamps = all(r.get("timestamp") for r in group)
+        SQLiteStorage.bulk_alert(
+            project=project,
+            run=run,
+            run_id=run_id,
+            titles=[r.get("title") or "" for r in group],
+            texts=[r.get("text") for r in group],
+            levels=[r.get("level") or "WARN" for r in group],
+            steps=[r.get("step") for r in group],
+            timestamps=[r["timestamp"] for r in group] if has_timestamps else None,
+            alert_ids=[r.get("alert_id") for r in group],
+        )
+        imported += len(group)
+
+    return imported
+
+
+def import_inbox_dir(inbox_dir: Path | None = None, batch_size: int = 100) -> int:
+    inbox = inbox_dir or local_inbox_dir()
+    if not inbox.exists():
+        return 0
+    imported = 0
+    batch_records: list[dict] = []
+    batch_paths: list[Path] = []
+
+    def _flush_batch() -> int:
+        nonlocal batch_records, batch_paths
+        if not batch_paths:
+            return 0
+        count = 0
+        if batch_records:
+            count = import_records(batch_records)
+        for p in batch_paths:
+            try:
+                p.unlink()
+            except OSError:
+                pass
+        batch_records = []
+        batch_paths = []
+        return count
+
+    for fragment_path in sorted(inbox.rglob("*.jsonl")):
+        try:
+            data = fragment_path.read_bytes()
+        except OSError:
+            continue
+        records = parse_fragment_bytes(data)
+        if records:
+            batch_records.extend(records)
+        batch_paths.append(fragment_path)
+
+        if len(batch_paths) >= batch_size:
+            imported += _flush_batch()
+
+    imported += _flush_batch()
+    for writer_dir in inbox.glob("*"):
+        if writer_dir.is_dir():
+            try:
+                writer_dir.rmdir()
+            except OSError:
+                pass
+    return imported
+
+
+def list_bucket_inbox_paths(bucket_id: str) -> list[str]:
+    try:
+        items = huggingface_hub.list_bucket_tree(
+            bucket_id,
+            prefix=BUCKET_INBOX_PREFIX,
+            recursive=True,
+            token=huggingface_hub.utils.get_token(),
+        )
+    except Exception:
+        return []
+    return sorted(
+        item.path
+        for item in items
+        if getattr(item, "type", None) == "file"
+        and getattr(item, "path", "").endswith(".jsonl")
+    )
+
+
+def import_inbox_from_bucket(bucket_id: str) -> int:
+    paths = list_bucket_inbox_paths(bucket_id)
+    if not paths:
+        return 0
+    imported = 0
+    consumed: list[str] = []
+    with tempfile.TemporaryDirectory() as tmp_dir:
+        for i, remote_path in enumerate(paths):
+            local_path = Path(tmp_dir) / f"{i}.jsonl"
+            try:
+                huggingface_hub.download_bucket_files(
+                    bucket_id,
+                    files=[(remote_path, str(local_path))],
+                    token=huggingface_hub.utils.get_token(),
+                )
+                records = parse_fragment_bytes(local_path.read_bytes())
+            except Exception:
+                continue
+            if records:
+                imported += import_records(records)
+            consumed.append(remote_path)
+    if consumed:
+        try:
+            huggingface_hub.batch_bucket_files(
+                bucket_id,
+                delete=consumed,
+                token=huggingface_hub.utils.get_token(),
+            )
+        except Exception:
+            pass
+    return imported
+
+
+def _add_files_to_bucket(bucket_id: str, additions: list[tuple[str, str]]) -> None:
+    if additions:
+        huggingface_hub.batch_bucket_files(
+            bucket_id,
+            add=additions,
+            token=huggingface_hub.utils.get_token(),
+        )
+
+
+def _upload_files_to_bucket(
+    bucket_id: str,
+    uploads: list[dict[str, Any]],
+    remote_path: Callable[[dict[str, Any], Path], str],
+) -> None:
+    _add_files_to_bucket(
+        bucket_id,
+        [
+            (str(p), remote_path(upload, p))
+            for upload in uploads
+            if (p := Path(upload["file_path"])).exists()
+        ],
+    )
+
+
+def upload_media_files_to_bucket(bucket_id: str, uploads: list[dict[str, Any]]) -> None:
+    _upload_files_to_bucket(
+        bucket_id,
+        uploads,
+        lambda upload, p: bucket_media_path(
+            project=upload["project"],
+            run=upload.get("run"),
+            step=upload.get("step"),
+            relative_path=upload.get("relative_path"),
+            filename=p.name,
+        ),
+    )
+
+
+def upload_artifact_blobs_to_bucket(
+    bucket_id: str, uploads: list[dict[str, Any]]
+) -> None:
+    _upload_files_to_bucket(
+        bucket_id,
+        uploads,
+        lambda upload, p: f"trackio/{p.relative_to(utils.TRACKIO_DIR).as_posix()}",
+    )

trackio/frontend/dist/assets/EXT_lights_area-DpkQYXlQ.js

@@ -0,0 +1 @@
+import{V as a,Q as R}from"./math.vector-C1xyPDEl.js";import{Color3 as L}from"./math.color-CzLaKyb6.js";import{L as c}from"./light-DT53MGnW.js";import{L as D,_ as b,s as w}from"./bufferUtils-DTRdUD8L.js";import{N as S}from"./node-C-Iu0ALa.js";import{R as M}from"./math.scalar.functions-DkeaWAWz.js";import{R as y}from"./rawTexture-Cp8_XuDs.js";import{T as d}from"./texture-BEqhDl5Y.js";import{T as A}from"./tools-D01N7ptR.js";import{T as B}from"./mesh-Fj-9677A.js";import{A as E,G as C}from"./glTFLoader-BPeiodqB.js";import{u as U,r as z}from"./dynamic-BUKysMyT.js";import"./lightConstants-B1TSTh-k.js";import"./decorators.serialization-C7d7ykGG.js";import"./baseTexture-CgAggsey.js";import"./math.plane-Ce_75-g5.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./index-Bx1QoKVU.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./objectModelMapping-DWcnlpHl.js";async function F(){const i=new Uint16Array(16384),t=new Uint16Array(4096*4),r=await A.LoadFileAsync(A.GetAssetUrl("https://assets.babylonjs.com/core/areaLights/areaLightsLTC.bin")),e=new Uint16Array(r),n=e.length/8;for(let s=0;s<n;s++)i[s*4]=e[s*8],i[s*4+1]=e[s*8+1],i[s*4+2]=e[s*8+2],i[s*4+3]=e[s*8+3],t[s*4]=e[s*8+4],t[s*4+1]=e[s*8+5],t[s*4+2]=e[s*8+6],t[s*4+3]=e[s*8+7];return[i,t]}function P(i){const t=i.useDelayedTextureLoading;i.useDelayedTextureLoading=!1;const r=i._blockEntityCollection;i._blockEntityCollection=!1,i._ltcTextures={LTC1:y.CreateRGBATexture(null,64,64,i.getEngine(),!1,!1,2,2,0,!1,!0),LTC2:y.CreateRGBATexture(null,64,64,i.getEngine(),!1,!1,2,2,0,!1,!0)},i._blockEntityCollection=r,i._ltcTextures.LTC1.wrapU=d.CLAMP_ADDRESSMODE,i._ltcTextures.LTC1.wrapV=d.CLAMP_ADDRESSMODE,i._ltcTextures.LTC2.wrapU=d.CLAMP_ADDRESSMODE,i._ltcTextures.LTC2.wrapV=d.CLAMP_ADDRESSMODE,i.useDelayedTextureLoading=t,F().then(e=>{var n,s;i._ltcTextures&&(((n=i._ltcTextures)==null?void 0:n.LTC1).update(e[0]),((s=i._ltcTextures)==null?void 0:s.LTC2).update(e[1]),i.onDisposeObservable.addOnce(()=>{var o,l;(o=i._ltcTextures)==null||o.LTC1.dispose(),(l=i._ltcTextures)==null||l.LTC2.dispose()}))}).catch(e=>{D.Error(`Area Light fail to get LTC textures data. Error: ${e}`)})}class O extends c{constructor(t,r,e,n){super(t,e,n),this.position=r,this._scene._ltcTextures||P(this._scene)}transferTexturesToEffect(t,r){return this._scene._ltcTextures&&(t.setTexture("areaLightsLTC1Sampler",this._scene._ltcTextures.LTC1),t.setTexture("areaLightsLTC2Sampler",this._scene._ltcTextures.LTC2)),this}prepareLightSpecificDefines(t,r){t["AREALIGHT"+r]=!0,t.AREALIGHTUSED=!0}_isReady(){return this._scene._ltcTextures?this._scene._ltcTextures.LTC1.isReady()&&this._scene._ltcTextures.LTC2.isReady():!1}}S.AddNodeConstructor("Light_Type_4",(i,t)=>()=>new u(i,a.Zero(),1,1,t));class u extends O{get emissionTexture(){return this._emissionTextureTexture}set emissionTexture(t){this._emissionTextureTexture!==t&&(this._emissionTextureTexture=t,this._emissionTextureTexture&&(this._emissionTextureTexture.wrapU=0,this._emissionTextureTexture.wrapV=0),this._emissionTextureTexture&&u._IsTexture(this._emissionTextureTexture)&&this._emissionTextureTexture.onLoadObservable.addOnce(()=>{this._markMeshesAsLightDirty()}))}get width(){return this._width.x}set width(t){this._width.x=t}get height(){return this._height.y}set height(t){this._height.y=t}constructor(t,r,e,n,s,f){super(t,r,s,f),this._emissionTextureTexture=null,this._width=new a(e,0,0),this._height=new a(0,n,0),this._pointTransformedPosition=a.Zero(),this._pointTransformedWidth=a.Zero(),this._pointTransformedHeight=a.Zero()}getClassName(){return"RectAreaLight"}getTypeID(){return c.LIGHTTYPEID_RECT_AREALIGHT}_buildUniformLayout(){this._uniformBuffer.addUniform("vLightData",4),this._uniformBuffer.addUniform("vLightDiffuse",4),this._uniformBuffer.addUniform("vLightSpecular",4),this._uniformBuffer.addUniform("vLightWidth",4),this._uniformBuffer.addUniform("vLightHeight",4),this._uniformBuffer.addUniform("shadowsInfo",3),this._uniformBuffer.addUniform("depthValues",2),this._uniformBuffer.create()}_computeTransformedInformation(){return this.parent&&this.parent.getWorldMatrix?(a.TransformCoordinatesToRef(this.position,this.parent.getWorldMatrix(),this._pointTransformedPosition),a.TransformNormalToRef(this._width,this.parent.getWorldMatrix(),this._pointTransformedWidth),a.TransformNormalToRef(this._height,this.parent.getWorldMatrix(),this._pointTransformedHeight),!0):!1}static _IsTexture(t){return t.onLoadObservable!==void 0}transferToEffect(t,r){const e=this._scene.floatingOriginOffset;return this._computeTransformedInformation()?(this._uniformBuffer.updateFloat4("vLightData",this._pointTransformedPosition.x-e.x,this._pointTransformedPosition.y-e.y,this._pointTransformedPosition.z-e.z,0,r),this._uniformBuffer.updateFloat4("vLightWidth",this._pointTransformedWidth.x/2,this._pointTransformedWidth.y/2,this._pointTransformedWidth.z/2,0,r),this._uniformBuffer.updateFloat4("vLightHeight",this._pointTransformedHeight.x/2,this._pointTransformedHeight.y/2,this._pointTransformedHeight.z/2,0,r)):(this._uniformBuffer.updateFloat4("vLightData",this.position.x-e.x,this.position.y-e.y,this.position.z-e.z,0,r),this._uniformBuffer.updateFloat4("vLightWidth",this._width.x/2,this._width.y/2,this._width.z/2,0,r),this._uniformBuffer.updateFloat4("vLightHeight",this._height.x/2,this._height.y/2,this._height.z/2,0,r)),this}transferTexturesToEffect(t,r){return super.transferTexturesToEffect(t,r),this._emissionTextureTexture&&this._emissionTextureTexture.isReady()&&t.setTexture("rectAreaLightEmissionTexture"+r,this._emissionTextureTexture),this}transferToNodeMaterialEffect(t,r){const e=this._scene.floatingOriginOffset;return this._computeTransformedInformation()?t.setFloat3(r,this._pointTransformedPosition.x-e.x,this._pointTransformedPosition.y-e.y,this._pointTransformedPosition.z-e.z):t.setFloat3(r,this.position.x-e.x,this.position.y-e.y,this.position.z-e.z),this}prepareLightSpecificDefines(t,r){super.prepareLightSpecificDefines(t,r),t["RECTAREALIGHTEMISSIONTEXTURE"+r]=!!(this._emissionTextureTexture&&this._emissionTextureTexture.isReady())}}b([w()],u.prototype,"width",null);b([w()],u.prototype,"height",null);M("BABYLON.RectAreaLight",u);const m="EXT_lights_area";class v{constructor(t){this.name=m,this._loader=t,this.enabled=this._loader.isExtensionUsed(m)}dispose(){this._loader=null,delete this._lights}onLoading(){const t=this._loader.gltf.extensions;if(t&&t[this.name]){const r=t[this.name];this._lights=r.lights,E.Assign(this._lights)}}loadNodeAsync(t,r,e){return C.LoadExtensionAsync(t,r,this.name,async(n,s)=>(this._loader._allMaterialsDirtyRequired=!0,await this._loader.loadNodeAsync(t,r,f=>{var x;let h;const o=E.Get(n,this._lights,s.light),l=o.name||f.name;this._loader.babylonScene._blockEntityCollection=!!this._loader._assetContainer;const T=o.size!==void 0?o.size:1;switch(o.type){case"rect":{const _=((x=o.rect)==null?void 0:x.aspect)!==void 0?o.rect.aspect*T:T,g=T;h=new u(l,a.Zero(),_,g,this._loader.babylonScene);break}case"disk":{const _=Math.sqrt(T*T*.25*Math.PI);h=new u(l,a.Zero(),_,_,this._loader.babylonScene);break}default:throw this._loader.babylonScene._blockEntityCollection=!1,new Error(`${n}: Invalid area light type (${o.type})`)}h._parentContainer=this._loader._assetContainer,this._loader.babylonScene._blockEntityCollection=!1,o._babylonLight=h,h.falloffType=c.FALLOFF_GLTF,h.diffuse=o.color?L.FromArray(o.color):L.White(),h.intensity=o.intensity==null?1:o.intensity;const p=new B(`${l}_orientation`,this._loader.babylonScene);p.rotationQuaternion=R.RotationAxis(a.Up(),Math.PI),p.parent=f,h.parent=p,this._loader._babylonLights.push(h),C.AddPointerMetadata(h,n),e(f)})))}}U(m);z(m,!0,i=>new v(i));export{v as EXT_lights_area};

trackio/frontend/dist/assets/EXT_lights_ies-Qe4ehPsC.js

@@ -0,0 +1 @@
+import{V as d}from"./math.vector-C1xyPDEl.js";import{Color3 as f}from"./math.color-CzLaKyb6.js";import{c as g}from"./objectModelMapping-DWcnlpHl.js";import{L as b}from"./light-DT53MGnW.js";import{A as l,G as h}from"./glTFLoader-BPeiodqB.js";import{u as y,r as L}from"./dynamic-BUKysMyT.js";import{T as A}from"./texture-BEqhDl5Y.js";import"./math.scalar.functions-DkeaWAWz.js";import"./bufferUtils-DTRdUD8L.js";import"./node-C-Iu0ALa.js";import"./decorators.serialization-C7d7ykGG.js";import"./math.axis-Ck7JfPPj.js";import"./lightConstants-B1TSTh-k.js";import"./tools-D01N7ptR.js";import"./index-Bx1QoKVU.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./material-CrEsrP1R.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./baseTexture-CgAggsey.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";const a="EXT_lights_ies";class w{constructor(t){this.name=a,this._loader=t,this.enabled=this._loader.isExtensionUsed(a)}dispose(){this._loader=null,delete this._lights}onLoading(){const t=this._loader.gltf.extensions;if(t&&t[this.name]){const o=t[this.name];this._lights=o.lights,l.Assign(this._lights)}}loadNodeAsync(t,o,_){return h.LoadExtensionAsync(t,o,this.name,async(p,s)=>{this._loader._allMaterialsDirtyRequired=!0;let i,e;const u=await this._loader.loadNodeAsync(t,o,r=>{e=l.Get(p,this._lights,s.light);const c=e.name||r.name;this._loader.babylonScene._blockEntityCollection=!!this._loader._assetContainer,i=new g(c,d.Zero(),d.Backward(),0,1,this._loader.babylonScene),i.angle=Math.PI/2,i.innerAngle=0,i._parentContainer=this._loader._assetContainer,this._loader.babylonScene._blockEntityCollection=!1,e._babylonLight=i,i.falloffType=b.FALLOFF_GLTF,i.diffuse=s.color?f.FromArray(s.color):f.White(),i.intensity=s.multiplier||1,i.range=Number.MAX_VALUE,i.parent=r,this._loader._babylonLights.push(i),h.AddPointerMetadata(i,p),_(r)});let n;if(e.uri)n=await this._loader.loadUriAsync(t,e,e.uri);else{const r=l.Get(`${t}/bufferView`,this._loader.gltf.bufferViews,e.bufferView);n=await this._loader.loadBufferViewAsync(`/bufferViews/${r.index}`,r)}return i.iesProfileTexture=new A(name+"_iesProfile",this._loader.babylonScene,!0,!1,void 0,null,null,n,!0,void 0,void 0,void 0,void 0,".ies"),u})}}y(a);L(a,!0,m=>new w(m));export{w as EXT_lights_ies};

trackio/frontend/dist/assets/EXT_lights_image_based-CEXtWEZ3.js

@@ -0,0 +1 @@
+import{a as G,S as z}from"./engine-DaBDhQ20.js";import{M as c,O as D,V as S,T as M,Q as w}from"./math.vector-C1xyPDEl.js";import{S as A}from"./decorators.serialization-C7d7ykGG.js";import{_ as F}from"./environmentTextureTools-CDrTJ7w-.js";import{_ as h,s as _,a as E,v as P}from"./bufferUtils-DTRdUD8L.js";import{T as Y}from"./tools-D01N7ptR.js";import{B as $}from"./baseTexture-CgAggsey.js";import{T as B}from"./texture-BEqhDl5Y.js";import{G as V,R as H}from"./math.scalar.functions-DkeaWAWz.js";import"./abstractEngine.cubeTexture-C895Ky-E.js";import{G as j,A as C}from"./glTFLoader-BPeiodqB.js";import{u as q,r as O}from"./dynamic-BUKysMyT.js";import"./thinEngine-D5ynu8Dd.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./dataBuffer-CgoqiUzT.js";import"./index-Bx1QoKVU.js";import"./math.axis-Ck7JfPPj.js";import"./math.color-CzLaKyb6.js";import"./math.plane-Ce_75-g5.js";import"./math.path-DFucxaHn.js";import"./perfCounter-DusmGz8t.js";import"./scene-gn_hoGMy.js";import"./smartArray-CO6iJ0u5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneComponent-Dflhczui.js";import"./buffer-DqKlo1ts.js";import"./renderingManager-CiY2OUrf.js";import"./deviceInputEvents-BTza-zoR.js";import"./passPostProcess-kvX6RZRb.js";import"./effectRenderer-CSz5fi0n.js";import"./math.viewport-CgkTt1RS.js";import"./drawWrapper-CZVk0xN-.js";import"./renderTargetTexture-B0kOC1Jy.js";import"./dumpTools-phHCiahG.js";import"./baseTexture.polynomial-BRyqQovE.js";import"./cubemapToSphericalPolynomial-BhsWOHWR.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./subMesh-UWDo5wjI.js";import"./node-C-Iu0ALa.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./material-CrEsrP1R.js";import"./cameraInputsManager-WrTH9PVf.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const I=.8;class l extends ${set boundingBoxSize(e){if(this._boundingBoxSize&&this._boundingBoxSize.equals(e))return;this._boundingBoxSize=e;const t=this.getScene();t&&t.markAllMaterialsAsDirty(1)}get boundingBoxSize(){return this._boundingBoxSize}set rotationY(e){this._rotationY=e,this.setReflectionTextureMatrix(c.RotationY(this._rotationY))}get rotationY(){return this._rotationY}get noMipmap(){return this._noMipmap}get forcedExtension(){return this._forcedExtension}static CreateFromImages(e,t,i){let r="";for(const s of e)r+=s;return new l(r,t,null,i,e)}static CreateFromPrefilteredData(e,t,i=null,r=!0){const s=t.useDelayedTextureLoading;t.useDelayedTextureLoading=!1;const o=new l(e,t,null,!1,null,null,null,void 0,!0,i,r);return t.useDelayedTextureLoading=s,o}constructor(e,t,i=null,r=!1,s=null,o=null,n=null,a=5,u=!1,d=null,f=!1,x=I,p=0,y,m){var v;super(t),this.onLoadObservable=new D,this.boundingBoxPosition=S.Zero(),this._rotationY=0,this._files=null,this._forcedExtension=null,this._extensions=null,this._textureMatrixRefraction=new c,this._buffer=null,this.name=e,this.url=e,this._noMipmap=r,this.hasAlpha=!1,this.isCube=!0,this._textureMatrix=c.Identity(),this.coordinatesMode=B.CUBIC_MODE;let b,T=null;i!==null&&!Array.isArray(i)?(b=i.extensions??null,this._noMipmap=i.noMipmap??!1,s=i.files??null,T=i.buffer??null,this._format=i.format??5,u=i.prefiltered??!1,d=i.forcedExtension??null,this._createPolynomials=i.createPolynomials??!1,this._lodScale=i.lodScale??I,this._lodOffset=i.lodOffset??0,this._loaderOptions=i.loaderOptions,this._useSRGBBuffer=i.useSRGBBuffer,o=i.onLoad??null,n=i.onError??null):(this._noMipmap=r,this._format=a,this._createPolynomials=f,b=i,this._loaderOptions=y,this._useSRGBBuffer=m,this._lodScale=x,this._lodOffset=p),!(!e&&!s)&&this.updateURL(e,d,o,u,n,b,(v=this.getScene())==null?void 0:v.useDelayedTextureLoading,s,T)}getClassName(){return"CubeTexture"}updateURL(e,t=null,i=null,r=!1,s=null,o=null,n=!1,a=null,u=null){(!this.name||this.name.startsWith("data:"))&&(this.name=e),this.url=e,t&&(this._forcedExtension=t);const d=e.lastIndexOf("."),f=t||(d>-1?e.substring(d).toLowerCase():""),x=f.indexOf(".dds")===0,p=f.indexOf(".env")===0,y=f.indexOf(".basis")===0;if(p?(this.gammaSpace=!1,this._prefiltered=!1,this.anisotropicFilteringLevel=1):(this._prefiltered=r,r&&(this.gammaSpace=!1,this.anisotropicFilteringLevel=1)),a)this._files=a;else if(!y&&!p&&!x&&!o&&(o=["_px.jpg","_py.jpg","_pz.jpg","_nx.jpg","_ny.jpg","_nz.jpg"]),this._files=this._files||[],this._files.length=0,o){for(let m=0;m<o.length;m++)this._files.push(e+o[m]);this._extensions=o}this._buffer=u,n?(this.delayLoadState=4,this._delayedOnLoad=i,this._delayedOnError=s):this._loadTexture(i,s)}delayLoad(e){this.delayLoadState===4&&(e&&(this._forcedExtension=e),this.delayLoadState=1,this._loadTexture(this._delayedOnLoad,this._delayedOnError))}getReflectionTextureMatrix(){return this._textureMatrix}setReflectionTextureMatrix(e){var s,o;if(e.updateFlag===this._textureMatrix.updateFlag||(e.isIdentity()!==this._textureMatrix.isIdentity()&&((s=this.getScene())==null||s.markAllMaterialsAsDirty(1,n=>n.getActiveTextures().indexOf(this)!==-1)),this._textureMatrix=e,!((o=this.getScene())!=null&&o.useRightHandedSystem)))return;const t=M.Vector3[0],i=M.Quaternion[0],r=M.Vector3[1];this._textureMatrix.decompose(t,i,r),i.z*=-1,i.w*=-1,c.ComposeToRef(t,i,r,this._textureMatrixRefraction)}getRefractionTextureMatrix(){var e;return(e=this.getScene())!=null&&e.useRightHandedSystem?this._textureMatrixRefraction:this._textureMatrix}_loadTexture(e=null,t=null){var n;const i=this.getScene(),r=this._texture;this._texture=this._getFromCache(this.url,this._noMipmap,void 0,void 0,this._useSRGBBuffer,this.isCube);const s=()=>{var a;this.onLoadObservable.notifyObservers(this),r&&(r.dispose(),(a=this.getScene())==null||a.markAllMaterialsAsDirty(1)),e&&e()},o=(a,u)=>{this._loadingError=!0,this._errorObject={message:a,exception:u},t&&t(a,u),B.OnTextureLoadErrorObservable.notifyObservers(this)};this._texture?this._texture.isReady?Y.SetImmediate(()=>s()):this._texture.onLoadedObservable.add(()=>s()):(this._prefiltered?this._texture=this._getEngine().createPrefilteredCubeTexture(this.url,i,this._lodScale,this._lodOffset,e,o,this._format,this._forcedExtension,this._createPolynomials):this._texture=this._getEngine().createCubeTexture(this.url,i,this._files,this._noMipmap,e,o,this._format,this._forcedExtension,!1,this._lodScale,this._lodOffset,null,this._loaderOptions,!!this._useSRGBBuffer,this._buffer),(n=this._texture)==null||n.onLoadedObservable.add(()=>this.onLoadObservable.notifyObservers(this)))}static Parse(e,t,i){const r=A.Parse(()=>{let s=!1;return e.prefiltered&&(s=e.prefiltered),new l(i+(e.url??e.name),t,e.extensions,!1,e.files||null,null,null,void 0,s,e.forcedExtension)},e,t);if(e.boundingBoxPosition&&(r.boundingBoxPosition=S.FromArray(e.boundingBoxPosition)),e.boundingBoxSize&&(r.boundingBoxSize=S.FromArray(e.boundingBoxSize)),e.animations)for(let s=0;s<e.animations.length;s++){const o=e.animations[s],n=V("BABYLON.Animation");n&&r.animations.push(n.Parse(o))}return r}clone(){let e=0;const t=A.Clone(()=>{const i=new l(this.url,this.getScene()||this._getEngine(),this._extensions,this._noMipmap,this._files);return e=i.uniqueId,i},this);return t.uniqueId=e,t}}h([_()],l.prototype,"url",void 0);h([E()],l.prototype,"boundingBoxPosition",void 0);h([E()],l.prototype,"boundingBoxSize",null);h([_("rotationY")],l.prototype,"rotationY",null);h([_("files")],l.prototype,"_files",void 0);h([_("forcedExtension")],l.prototype,"_forcedExtension",void 0);h([_("extensions")],l.prototype,"_extensions",void 0);h([P("textureMatrix")],l.prototype,"_textureMatrix",void 0);h([P("textureMatrixRefraction")],l.prototype,"_textureMatrixRefraction",void 0);B._CubeTextureParser=l.Parse;H("BABYLON.CubeTexture",l);class R extends l{constructor(e,t,i,r=5,s=0,o=!1,n=!1,a=3,u=null){super("",e),this._texture=e.getEngine().createRawCubeTexture(t,i,r,s,o,n,a,u)}update(e,t,i,r,s=null){this._texture.getEngine().updateRawCubeTexture(this._texture,e,t,i,r,s)}updateRGBDAsync(e,t=null,i=.8,r=0){return F(this._texture,e,t,i,r).then(()=>{})}clone(){return A.Clone(()=>{const e=this.getScene(),t=this._texture,i=new R(e,t._bufferViewArray,t.width,t.format,t.type,t.generateMipMaps,t.invertY,t.samplingMode,t._compression);return t.source===13&&i.updateRGBDAsync(t._bufferViewArrayArray,t._sphericalPolynomial,t._lodGenerationScale,t._lodGenerationOffset),i},this)}}const g="EXT_lights_image_based";class N{constructor(e){this.name=g,this._loader=e,this.enabled=this._loader.isExtensionUsed(g)}dispose(){this._loader=null,delete this._lights}onLoading(){const e=this._loader.gltf.extensions;if(e&&e[this.name]){const t=e[this.name];this._lights=t.lights}}loadSceneAsync(e,t){return j.LoadExtensionAsync(e,t,this.name,async(i,r)=>{this._loader._allMaterialsDirtyRequired=!0;const s=new Array;s.push(this._loader.loadSceneAsync(e,t)),this._loader.logOpen(`${i}`);const o=C.Get(`${i}/light`,this._lights,r.light);return s.push(this._loadLightAsync(`/extensions/${this.name}/lights/${r.light}`,o).then(n=>{this._loader.babylonScene.environmentTexture=n})),this._loader.logClose(),await Promise.all(s).then(()=>{})})}_loadLightAsync(e,t){if(!t._loaded){const i=new Array;this._loader.logOpen(`${e}`);const r=new Array(t.specularImages.length);for(let s=0;s<t.specularImages.length;s++){const o=t.specularImages[s];r[s]=new Array(o.length);for(let n=0;n<o.length;n++){const a=`${e}/specularImages/${s}/${n}`;this._loader.logOpen(`${a}`);const u=o[n],d=C.Get(a,this._loader.gltf.images,u);i.push(this._loader.loadImageAsync(`/images/${u}`,d).then(f=>{r[s][n]=f})),this._loader.logClose()}}this._loader.logClose(),t._loaded=Promise.all(i).then(async()=>{const s=new R(this._loader.babylonScene,null,t.specularImageSize);if(s.name=t.name||"environment",t._babylonTexture=s,t.intensity!=null&&(s.level=t.intensity),t.rotation){let u=w.FromArray(t.rotation);this._loader.babylonScene.useRightHandedSystem||(u=w.Inverse(u)),c.FromQuaternionToRef(u,s.getReflectionTextureMatrix())}if(!t.irradianceCoefficients)throw new Error(`${e}: Irradiance coefficients are missing`);const o=G.FromArray(t.irradianceCoefficients);o.scaleInPlace(t.intensity),o.convertIrradianceToLambertianRadiance();const n=z.FromHarmonics(o),a=(r.length-1)/Math.log2(t.specularImageSize);return await s.updateRGBDAsync(r,n,a)})}return t._loaded.then(()=>t._babylonTexture)}}q(g);O(g,!0,L=>new N(L));export{N as EXT_lights_image_based};

trackio/frontend/dist/assets/EXT_mesh_gpu_instancing-B3VxVLJg.js

@@ -0,0 +1 @@
+import{T as t,V as A,Q as F,M as b}from"./math.vector-C1xyPDEl.js";import{L as g}from"./bufferUtils-DTRdUD8L.js";import{G as L,A as M}from"./glTFLoader-BPeiodqB.js";import{u as V,r as w}from"./dynamic-BUKysMyT.js";import"./thinInstanceMesh-CYnaUZKe.js";import"./math.scalar.functions-DkeaWAWz.js";import"./index-Bx1QoKVU.js";import"./math.color-CzLaKyb6.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const m="EXT_mesh_gpu_instancing";class B{constructor(p){this.name=m,this._loader=p,this.enabled=this._loader.isExtensionUsed(m)}dispose(){this._loader=null}loadNodeAsync(p,i,T){return L.LoadExtensionAsync(p,i,this.name,async(f,u)=>{this._loader._disableInstancedMesh++;const h=this._loader.loadNodeAsync(`/nodes/${i.index}`,i,T);if(this._loader._disableInstancedMesh--,!i._primitiveBabylonMeshes)return await h;const c=new Array;let o=0;const n=s=>{if(u.attributes[s]==null){c.push(Promise.resolve(null));return}const e=M.Get(`${f}/attributes/${s}`,this._loader.gltf.accessors,u.attributes[s]);if(c.push(this._loader._loadFloatAccessorAsync(`/accessors/${e.bufferView}`,e)),o===0)o=e.count;else if(o!==e.count)throw new Error(`${f}/attributes: Instance buffer accessors do not have the same count.`)};return n("TRANSLATION"),n("ROTATION"),n("SCALE"),n("_COLOR_0"),await h.then(async s=>{const[e,d,_,a]=await Promise.all(c),y=new Float32Array(o*16);t.Vector3[0].copyFromFloats(0,0,0),t.Quaternion[0].copyFromFloats(0,0,0,1),t.Vector3[1].copyFromFloats(1,1,1);for(let r=0;r<o;++r)e&&A.FromArrayToRef(e,r*3,t.Vector3[0]),d&&F.FromArrayToRef(d,r*4,t.Quaternion[0]),_&&A.FromArrayToRef(_,r*3,t.Vector3[1]),b.ComposeToRef(t.Vector3[1],t.Quaternion[0],t.Vector3[0],t.Matrix[0]),t.Matrix[0].copyToArray(y,r*16);for(const r of i._primitiveBabylonMeshes)r.thinInstanceSetBuffer("matrix",y,16,!0),a&&(a.length===o*3?r.thinInstanceSetBuffer("color",a,3,!0):a.length===o*4?r.thinInstanceSetBuffer("color",a,4,!0):g.Warn("Unexpected size of _COLOR_0 attribute for mesh "+r.name));return s})})}}V(m);w(m,!0,l=>new B(l));export{B as EXT_mesh_gpu_instancing};

trackio/frontend/dist/assets/EXT_meshopt_compression-Pa499AYZ.js

@@ -0,0 +1 @@
+import{G as n,A as c}from"./glTFLoader-BPeiodqB.js";import{T as f}from"./tools-D01N7ptR.js";import{u as h,r as y}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./math.color-CzLaKyb6.js";import"./mesh-Fj-9677A.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";let p=0,m=null;class e{static get Default(){return e._Default||(e._Default=new e),e._Default}constructor(){const t=e.Configuration.decoder;this._decoderModulePromise=f.LoadBabylonScriptAsync(t.url).then(()=>MeshoptDecoder.ready)}dispose(){delete this._decoderModulePromise}async decodeGltfBufferAsync(t,i,d,r,o){await this._decoderModulePromise,p===0&&(MeshoptDecoder.useWorkers(1),p=1);const s=await MeshoptDecoder.decodeGltfBufferAsync(i,d,t,r,o);return m!==null&&clearTimeout(m),m=setTimeout(()=>{MeshoptDecoder.useWorkers(0),p=0,m=null},1e3),s}}e.Configuration={decoder:{url:`${f._DefaultCdnUrl}/meshopt_decoder.js`}};e._Default=null;const a="EXT_meshopt_compression";class _{constructor(t){this.name=a,this.enabled=t.isExtensionUsed(a),this._loader=t}dispose(){this._loader=null}loadBufferViewAsync(t,i){return n.LoadExtensionAsync(t,i,this.name,async(d,r)=>{const o=i;if(o._meshOptData)return await o._meshOptData;const s=c.Get(`${t}/buffer`,this._loader.gltf.buffers,r.buffer);return o._meshOptData=this._loader.loadBufferAsync(`/buffers/${s.index}`,s,r.byteOffset||0,r.byteLength).then(async l=>await e.Default.decodeGltfBufferAsync(l,r.count,r.byteStride,r.mode,r.filter)),await o._meshOptData})}}h(a);y(a,!0,u=>new _(u));export{_ as EXT_meshopt_compression};

trackio/frontend/dist/assets/EXT_texture_avif-Nv7VBjPQ.js

@@ -0,0 +1 @@
+import{G as m,A as p}from"./glTFLoader-BPeiodqB.js";import{u,r as _}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./math.color-CzLaKyb6.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const o="EXT_texture_avif";class c{constructor(r){this.name=o,this._loader=r,this.enabled=r.isExtensionUsed(o)}dispose(){this._loader=null}_loadTextureAsync(r,t,e){return m.LoadExtensionAsync(r,t,this.name,async(s,a)=>{const n=t.sampler==null?m.DefaultSampler:p.Get(`${r}/sampler`,this._loader.gltf.samplers,t.sampler),l=p.Get(`${s}/source`,this._loader.gltf.images,a.source);return await this._loader._createTextureAsync(r,n,l,d=>{e(d)},void 0,!t._textureInfo.nonColorData)})}}u(o);_(o,!0,i=>new c(i));export{c as EXT_texture_avif};

trackio/frontend/dist/assets/EXT_texture_webp-BDYrjNRo.js

@@ -0,0 +1 @@
+import{G as m,A as p}from"./glTFLoader-BPeiodqB.js";import{u,r as _}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./math.color-CzLaKyb6.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const o="EXT_texture_webp";class c{constructor(r){this.name=o,this._loader=r,this.enabled=r.isExtensionUsed(o)}dispose(){this._loader=null}_loadTextureAsync(r,t,e){return m.LoadExtensionAsync(r,t,this.name,async(s,a)=>{const n=t.sampler==null?m.DefaultSampler:p.Get(`${r}/sampler`,this._loader.gltf.samplers,t.sampler),l=p.Get(`${s}/source`,this._loader.gltf.images,a.source);return await this._loader._createTextureAsync(r,n,l,d=>{e(d)},void 0,!t._textureInfo.nonColorData)})}}u(o);_(o,!0,i=>new c(i));export{c as EXT_texture_webp};

trackio/frontend/dist/assets/ExtrasAsMetadata-Cp9P1Lmx.js

@@ -0,0 +1 @@
+import{u as o,r as n}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./sceneLoader-CutT-qCn.js";import"./tools-D01N7ptR.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./math.color-CzLaKyb6.js";import"./scene-gn_hoGMy.js";import"./smartArray-CO6iJ0u5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./renderingManager-CiY2OUrf.js";import"./deviceInputEvents-BTza-zoR.js";import"./perfCounter-DusmGz8t.js";import"./sceneLoaderFlags-wywyb9ml.js";const i="ExtrasAsMetadata";class m{_assignExtras(r,t){if(t.extras&&Object.keys(t.extras).length>0){const s=r.metadata=r.metadata||{},a=s.gltf=s.gltf||{};a.extras=t.extras}}constructor(r){this.name=i,this.enabled=!0,this._loader=r}dispose(){this._loader=null}loadNodeAsync(r,t,s){return this._loader.loadNodeAsync(r,t,a=>{this._assignExtras(a,t),s(a)})}loadCameraAsync(r,t,s){return this._loader.loadCameraAsync(r,t,a=>{this._assignExtras(a,t),s(a)})}createMaterial(r,t,s){const a=this._loader.createMaterial(r,t,s);return this._assignExtras(a,t),a}loadAnimationAsync(r,t){return this._loader.loadAnimationAsync(r,t).then(s=>(this._assignExtras(s,t),s))}}o(i);n(i,!1,e=>new m(e));export{m as ExtrasAsMetadata};

trackio/frontend/dist/assets/KHR_animation_pointer-DbEjDTwi.js

@@ -0,0 +1 @@
+import{L as K}from"./bufferUtils-DTRdUD8L.js";import{u as B,r as Z}from"./dynamic-BUKysMyT.js";import{S as e,a as G}from"./objectModelMapping-DWcnlpHl.js";import{A as t}from"./animation-IftAdLIx.js";import{AnimationPropertyInfo as p}from"./glTFLoaderAnimation-QPpM8WOy.js";import{Color3 as V}from"./math.color-CzLaKyb6.js";import"./index-Bx1QoKVU.js";import"./sceneLoader-CutT-qCn.js";import"./tools-D01N7ptR.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./decorators.serialization-C7d7ykGG.js";import"./scene-gn_hoGMy.js";import"./smartArray-CO6iJ0u5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./renderingManager-CiY2OUrf.js";import"./deviceInputEvents-BTza-zoR.js";import"./perfCounter-DusmGz8t.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./node-C-Iu0ALa.js";import"./light-DT53MGnW.js";import"./math.axis-Ck7JfPPj.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";function u(l,r,a,i){return V.FromArray(r,a).scale(i)}function W(l,r,a,i){return r[a+3]*i}function s(l,r,a,i){return r[a]*i}function O(l,r,a,i){return-r[a]*i}function A(l,r,a,i){return r[a+1]*i}function z(l,r,a,i){return r[a]*i*2}function o(l){return{scale:[new n(t.ANIMATIONTYPE_FLOAT,`${l}.uScale`,s,()=>2),new n(t.ANIMATIONTYPE_FLOAT,`${l}.vScale`,A,()=>2)],offset:[new n(t.ANIMATIONTYPE_FLOAT,`${l}.uOffset`,s,()=>2),new n(t.ANIMATIONTYPE_FLOAT,`${l}.vOffset`,A,()=>2)],rotation:[new n(t.ANIMATIONTYPE_FLOAT,`${l}.wAng`,O,()=>1)]}}class c extends p{buildAnimations(r,a,i,m){return[{babylonAnimatable:r._babylonCamera,babylonAnimation:this._buildAnimation(a,i,m)}]}}class n extends p{buildAnimations(r,a,i,m){const x=[];for(const T in r._data)x.push({babylonAnimatable:r._data[T].babylonMaterial,babylonAnimation:this._buildAnimation(a,i,m)});return x}}class _ extends p{buildAnimations(r,a,i,m){return[{babylonAnimatable:r._babylonLight,babylonAnimation:this._buildAnimation(a,i,m)}]}}class D extends p{buildAnimations(r,a,i,m){return r._primitiveBabylonMeshes?r._primitiveBabylonMeshes.map(x=>({babylonAnimatable:x,babylonAnimation:this._buildAnimation(a,i,m)})):[]}}e("/cameras/{}/orthographic/xmag",[new c(t.ANIMATIONTYPE_FLOAT,"orthoLeft",O,()=>1),new c(t.ANIMATIONTYPE_FLOAT,"orthoRight",A,()=>1)]);e("/cameras/{}/orthographic/ymag",[new c(t.ANIMATIONTYPE_FLOAT,"orthoBottom",O,()=>1),new c(t.ANIMATIONTYPE_FLOAT,"orthoTop",A,()=>1)]);e("/cameras/{}/orthographic/zfar",[new c(t.ANIMATIONTYPE_FLOAT,"maxZ",s,()=>1)]);e("/cameras/{}/orthographic/znear",[new c(t.ANIMATIONTYPE_FLOAT,"minZ",s,()=>1)]);e("/cameras/{}/perspective/yfov",[new c(t.ANIMATIONTYPE_FLOAT,"fov",s,()=>1)]);e("/cameras/{}/perspective/zfar",[new c(t.ANIMATIONTYPE_FLOAT,"maxZ",s,()=>1)]);e("/cameras/{}/perspective/znear",[new c(t.ANIMATIONTYPE_FLOAT,"minZ",s,()=>1)]);e("/materials/{}/pbrMetallicRoughness/baseColorFactor",[new n(t.ANIMATIONTYPE_COLOR3,"albedoColor",u,()=>4),new n(t.ANIMATIONTYPE_FLOAT,"alpha",W,()=>4)]);e("/materials/{}/pbrMetallicRoughness/metallicFactor",[new n(t.ANIMATIONTYPE_FLOAT,"metallic",s,()=>1)]);e("/materials/{}/pbrMetallicRoughness/metallicFactor",[new n(t.ANIMATIONTYPE_FLOAT,"roughness",s,()=>1)]);const H=o("albedoTexture");e("/materials/{}/pbrMetallicRoughness/baseColorTexture/extensions/KHR_texture_transform/scale",H.scale);e("/materials/{}/pbrMetallicRoughness/baseColorTexture/extensions/KHR_texture_transform/offset",H.offset);e("/materials/{}/pbrMetallicRoughness/baseColorTexture/extensions/KHR_texture_transform/rotation",H.rotation);const N=o("metallicTexture");e("//materials/{}/pbrMetallicRoughness/metallicRoughnessTexture/scale",N.scale);e("//materials/{}/pbrMetallicRoughness/metallicRoughnessTexture/offset",N.offset);e("//materials/{}/pbrMetallicRoughness/metallicRoughnessTexture/rotation",N.rotation);e("/materials/{}/emissiveFactor",[new n(t.ANIMATIONTYPE_COLOR3,"emissiveColor",u,()=>3)]);const g=o("bumpTexture");e("/materials/{}/normalTexture/scale",[new n(t.ANIMATIONTYPE_FLOAT,"bumpTexture.level",s,()=>1)]);e("/materials/{}/normalTexture/extensions/KHR_texture_transform/scale",g.scale);e("/materials/{}/normalTexture/extensions/KHR_texture_transform/offset",g.offset);e("/materials/{}/normalTexture/extensions/KHR_texture_transform/rotation",g.rotation);e("/materials/{}/occlusionTexture/strength",[new n(t.ANIMATIONTYPE_FLOAT,"ambientTextureStrength",s,()=>1)]);const d=o("ambientTexture");e("/materials/{}/occlusionTexture/extensions/KHR_texture_transform/scale",d.scale);e("/materials/{}/occlusionTexture/extensions/KHR_texture_transform/offset",d.offset);e("/materials/{}/occlusionTexture/extensions/KHR_texture_transform/rotation",d.rotation);const b=o("emissiveTexture");e("/materials/{}/emissiveTexture/extensions/KHR_texture_transform/scale",b.scale);e("/materials/{}/emissiveTexture/extensions/KHR_texture_transform/offset",b.offset);e("/materials/{}/emissiveTexture/extensions/KHR_texture_transform/rotation",b.rotation);e("/materials/{}/extensions/KHR_materials_anisotropy/anisotropyStrength",[new n(t.ANIMATIONTYPE_FLOAT,"anisotropy.intensity",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_anisotropy/anisotropyRotation",[new n(t.ANIMATIONTYPE_FLOAT,"anisotropy.angle",s,()=>1)]);const M=o("anisotropy.texture");e("/materials/{}/extensions/KHR_materials_anisotropy/anisotropyTexture/extensions/KHR_texture_transform/scale",M.scale);e("/materials/{}/extensions/KHR_materials_anisotropy/anisotropyTexture/extensions/KHR_texture_transform/offset",M.offset);e("/materials/{}/extensions/KHR_materials_anisotropy/anisotropyTexture/extensions/KHR_texture_transform/rotation",M.rotation);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatFactor",[new n(t.ANIMATIONTYPE_FLOAT,"clearCoat.intensity",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatRoughnessFactor",[new n(t.ANIMATIONTYPE_FLOAT,"clearCoat.roughness",s,()=>1)]);const F=o("clearCoat.texture");e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatTexture/extensions/KHR_texture_transform/scale",F.scale);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatTexture/extensions/KHR_texture_transform/offset",F.offset);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatTexture/extensions/KHR_texture_transform/rotation",F.rotation);const E=o("clearCoat.bumpTexture");e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatNormalTexture/scale",[new n(t.ANIMATIONTYPE_FLOAT,"clearCoat.bumpTexture.level",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatNormalTexture/extensions/KHR_texture_transform/scale",E.scale);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatNormalTexture/extensions/KHR_texture_transform/offset",E.offset);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatNormalTexture/extensions/KHR_texture_transform/rotation",E.rotation);const w=o("clearCoat.textureRoughness");e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatRoughnessTexture/extensions/KHR_texture_transform/scale",w.scale);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatRoughnessTexture/extensions/KHR_texture_transform/offset",w.offset);e("/materials/{}/extensions/KHR_materials_clearcoat/clearcoatRoughnessTexture/extensions/KHR_texture_transform/rotation",w.rotation);e("/materials/{}/extensions/KHR_materials_dispersion/dispersionFactor",[new n(t.ANIMATIONTYPE_FLOAT,"subSurface.dispersion",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_emissive_strength/emissiveStrength",[new n(t.ANIMATIONTYPE_FLOAT,"emissiveIntensity",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_ior/ior",[new n(t.ANIMATIONTYPE_FLOAT,"indexOfRefraction",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceFactor",[new n(t.ANIMATIONTYPE_FLOAT,"iridescence.intensity",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceIor",[new n(t.ANIMATIONTYPE_FLOAT,"iridescence.indexOfRefraction",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceThicknessMinimum",[new n(t.ANIMATIONTYPE_FLOAT,"iridescence.minimumThickness",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceThicknessMaximum",[new n(t.ANIMATIONTYPE_FLOAT,"iridescence.maximumThickness",s,()=>1)]);const L=o("iridescence.texture");e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceTexture/extensions/KHR_texture_transform/scale",L.scale);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceTexture/extensions/KHR_texture_transform/offset",L.offset);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceTexture/extensions/KHR_texture_transform/rotation",L.rotation);const P=o("iridescence.thicknessTexture");e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceThicknessTexture/extensions/KHR_texture_transform/scale",P.scale);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceThicknessTexture/extensions/KHR_texture_transform/offset",P.offset);e("/materials/{}/extensions/KHR_materials_iridescence/iridescenceThicknessTexture/extensions/KHR_texture_transform/rotation",P.rotation);e("/materials/{}/extensions/KHR_materials_sheen/sheenColorFactor",[new n(t.ANIMATIONTYPE_COLOR3,"sheen.color",u,()=>3)]);e("/materials/{}/extensions/KHR_materials_sheen/sheenRoughnessFactor",[new n(t.ANIMATIONTYPE_FLOAT,"sheen.roughness",s,()=>1)]);const y=o("sheen.texture");e("/materials/{}/extensions/KHR_materials_sheen/sheenColorTexture/extensions/KHR_texture_transform/scale",y.scale);e("/materials/{}/extensions/KHR_materials_sheen/sheenColorTexture/extensions/KHR_texture_transform/offset",y.offset);e("/materials/{}/extensions/KHR_materials_sheen/sheenColorTexture/extensions/KHR_texture_transform/rotation",y.rotation);const C=o("sheen.textureRoughness");e("/materials/{}/extensions/KHR_materials_sheen/sheenRoughnessTexture/extensions/KHR_texture_transform/scale",C.scale);e("/materials/{}/extensions/KHR_materials_sheen/sheenRoughnessTexture/extensions/KHR_texture_transform/offset",C.offset);e("/materials/{}/extensions/KHR_materials_sheen/sheenRoughnessTexture/extensions/KHR_texture_transform/rotation",C.rotation);e("/materials/{}/extensions/KHR_materials_specular/specularFactor",[new n(t.ANIMATIONTYPE_FLOAT,"metallicF0Factor",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_specular/specularColorFactor",[new n(t.ANIMATIONTYPE_COLOR3,"metallicReflectanceColor",u,()=>3)]);const Y=o("metallicReflectanceTexture");e("/materials/{}/extensions/KHR_materials_specular/specularTexture/extensions/KHR_texture_transform/scale",Y.scale);e("/materials/{}/extensions/KHR_materials_specular/specularTexture/extensions/KHR_texture_transform/offset",Y.offset);e("/materials/{}/extensions/KHR_materials_specular/specularTexture/extensions/KHR_texture_transform/rotation",Y.rotation);const v=o("reflectanceTexture");e("/materials/{}/extensions/KHR_materials_specular/specularColorTexture/extensions/KHR_texture_transform/scale",v.scale);e("/materials/{}/extensions/KHR_materials_specular/specularColorTexture/extensions/KHR_texture_transform/offset",v.offset);e("/materials/{}/extensions/KHR_materials_specular/specularColorTexture/extensions/KHR_texture_transform/rotation",v.rotation);e("/materials/{}/extensions/KHR_materials_transmission/transmissionFactor",[new n(t.ANIMATIONTYPE_FLOAT,"subSurface.refractionIntensity",s,()=>1)]);const S=o("subSurface.refractionIntensityTexture");e("/materials/{}/extensions/KHR_materials_transmission/transmissionTexture/extensions/KHR_texture_transform/scale",S.scale);e("/materials/{}/extensions/KHR_materials_transmission/transmissionTexture/extensions/KHR_texture_transform/offset",S.offset);e("/materials/{}/extensions/KHR_materials_transmission/transmissionTexture/extensions/KHR_texture_transform/rotation",S.rotation);e("/materials/{}/extensions/KHR_materials_volume/attenuationColor",[new n(t.ANIMATIONTYPE_COLOR3,"subSurface.tintColor",u,()=>3)]);e("/materials/{}/extensions/KHR_materials_volume/attenuationDistance",[new n(t.ANIMATIONTYPE_FLOAT,"subSurface.tintColorAtDistance",s,()=>1)]);e("/materials/{}/extensions/KHR_materials_volume/thicknessFactor",[new n(t.ANIMATIONTYPE_FLOAT,"subSurface.maximumThickness",s,()=>1)]);const $=o("subSurface.thicknessTexture");e("/materials/{}/extensions/KHR_materials_volume/thicknessTexture/extensions/KHR_texture_transform/scale",$.scale);e("/materials/{}/extensions/KHR_materials_volume/thicknessTexture/extensions/KHR_texture_transform/offset",$.offset);e("/materials/{}/extensions/KHR_materials_volume/thicknessTexture/extensions/KHR_texture_transform/rotation",$.rotation);e("/materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionFactor",[new n(t.ANIMATIONTYPE_FLOAT,"subSurface.translucencyIntensity",s,()=>1)]);const k=o("subSurface.translucencyIntensityTexture");e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionTexture/extensions/KHR_texture_transform/scale",k.scale);e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionTexture/extensions/KHR_texture_transform/offset",k.offset);e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionTexture/extensions/KHR_texture_transform/rotation",k.rotation);e("/materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionColorFactor",[new n(t.ANIMATIONTYPE_COLOR3,"subSurface.translucencyColor",u,()=>3)]);const j=o("subSurface.translucencyColorTexture");e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionColorTexture/extensions/KHR_texture_transform/scale",j.scale);e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionColorTexture/extensions/KHR_texture_transform/offset",j.offset);e("materials/{}/extensions/KHR_materials_diffuse_transmission/diffuseTransmissionColorTexture/extensions/KHR_texture_transform/rotation",j.rotation);e("/extensions/KHR_lights_punctual/lights/{}/color",[new _(t.ANIMATIONTYPE_COLOR3,"diffuse",u,()=>3)]);e("/extensions/KHR_lights_punctual/lights/{}/intensity",[new _(t.ANIMATIONTYPE_FLOAT,"intensity",s,()=>1)]);e("/extensions/KHR_lights_punctual/lights/{}/range",[new _(t.ANIMATIONTYPE_FLOAT,"range",s,()=>1)]);e("/extensions/KHR_lights_punctual/lights/{}/spot/innerConeAngle",[new _(t.ANIMATIONTYPE_FLOAT,"innerAngle",z,()=>1)]);e("/extensions/KHR_lights_punctual/lights/{}/spot/outerConeAngle",[new _(t.ANIMATIONTYPE_FLOAT,"angle",z,()=>1)]);e("/extensions/EXT_lights_area/lights/{}/color",[new _(t.ANIMATIONTYPE_COLOR3,"diffuse",u,()=>3)]);e("/extensions/EXT_lights_area/lights/{}/intensity",[new _(t.ANIMATIONTYPE_FLOAT,"intensity",s,()=>1)]);e("/extensions/EXT_lights_area/lights/{}/size",[new _(t.ANIMATIONTYPE_FLOAT,"radius",s,()=>1)]);e("/extensions/EXT_lights_area/lights/{}/rect/aspect",[new _(t.ANIMATIONTYPE_FLOAT,"radius",s,()=>1)]);e("/nodes/{}/extensions/EXT_lights_ies/color",[new _(t.ANIMATIONTYPE_COLOR3,"diffuse",u,()=>3)]);e("/nodes/{}/extensions/EXT_lights_ies/multiplier",[new _(t.ANIMATIONTYPE_FLOAT,"intensity",s,()=>1)]);e("/nodes/{}/extensions/KHR_node_visibility/visible",[new D(t.ANIMATIONTYPE_FLOAT,"isVisible",s,()=>1)]);const R="KHR_animation_pointer";class U{constructor(r){this.name=R,this._loader=r,this._pathToObjectConverter=G(this._loader.gltf)}get enabled(){return this._loader.isExtensionUsed(R)}dispose(){this._loader=null,delete this._pathToObjectConverter}_loadAnimationChannelAsync(r,a,i,m,x){var X;const T=(X=m.target.extensions)==null?void 0:X.KHR_animation_pointer;if(!T||!this._pathToObjectConverter)return null;m.target.path!=="pointer"&&K.Warn(`${r}/target/path: Value (${m.target.path}) must be (pointer) when using the ${this.name} extension`),m.target.node!=null&&K.Warn(`${r}/target/node: Value (${m.target.node}) must not be present when using the ${this.name} extension`);const I=`${r}/extensions/${this.name}`,h=T.pointer;if(!h)throw new Error(`${I}: Pointer is missing`);try{const f=this._pathToObjectConverter.convert(h);if(!f.info.interpolation)throw new Error(`${I}/pointer: Interpolation is missing`);return this._loader._loadAnimationChannelFromTargetInfoAsync(r,a,i,m,{object:f.object,info:f.info.interpolation},x)}catch{return K.Warn(`${I}/pointer: Invalid pointer (${h}) skipped`),null}}}B(R);Z(R,!0,l=>new U(l));export{U as KHR_animation_pointer};

trackio/frontend/dist/assets/KHR_draco_mesh_compression-BEx33bus.js

@@ -0,0 +1 @@
+import{T as A}from"./tools-D01N7ptR.js";import{A as v}from"./workerPool-CfMXSLnf.js";import{G as C}from"./mesh-Fj-9677A.js";import{V as _}from"./buffer-DqKlo1ts.js";import{L as V}from"./bufferUtils-DTRdUD8L.js";import{G as k,A as g,L as R}from"./glTFLoader-BPeiodqB.js";import{u as F,r as N}from"./dynamic-BUKysMyT.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./decorators.serialization-C7d7ykGG.js";import"./math.color-CzLaKyb6.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./index-Bx1QoKVU.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./dataBuffer-CgoqiUzT.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";function U(c,t,n,a,m){const e=c;let r=null,o=null,s=null;try{r=new e.Decoder,o=new e.DecoderBuffer,o.Init(t,t.byteLength);let i;const l=r.GetEncodedGeometryType(o);switch(l){case e.TRIANGULAR_MESH:{const d=new e.Mesh;if(i=r.DecodeBufferToMesh(o,d),!i.ok()||d.ptr===0)throw new Error(i.error_msg());const y=d.num_faces()*3,p=y*4,u=e._malloc(p);try{r.GetTrianglesUInt32Array(d,p,u);const P=new Uint32Array(y);P.set(new Uint32Array(e.HEAPF32.buffer,u,y)),a(P)}finally{e._free(u)}s=d;break}case e.POINT_CLOUD:{const d=new e.PointCloud;if(i=r.DecodeBufferToPointCloud(o,d),!i.ok()||!d.ptr)throw new Error(i.error_msg());s=d;break}default:throw new Error(`Draco: Cannot decode invalid geometry type ${l}`)}const h=s.num_points(),b=(d,f,y,p)=>{const u=p.data_type(),P=p.num_components(),M=p.normalized(),B=p.byte_stride(),O=p.byte_offset(),T={[e.DT_FLOAT32]:{typedArrayConstructor:Float32Array,heap:e.HEAPF32},[e.DT_INT8]:{typedArrayConstructor:Int8Array,heap:e.HEAP8},[e.DT_INT16]:{typedArrayConstructor:Int16Array,heap:e.HEAP16},[e.DT_INT32]:{typedArrayConstructor:Int32Array,heap:e.HEAP32},[e.DT_UINT8]:{typedArrayConstructor:Uint8Array,heap:e.HEAPU8},[e.DT_UINT16]:{typedArrayConstructor:Uint16Array,heap:e.HEAPU16},[e.DT_UINT32]:{typedArrayConstructor:Uint32Array,heap:e.HEAPU32}}[u];if(!T)throw new Error(`Draco: Cannot decode invalid data type ${u}`);const I=h*P,L=I*T.typedArrayConstructor.BYTES_PER_ELEMENT,D=e._malloc(L);try{d.GetAttributeDataArrayForAllPoints(f,p,u,L,D);const G=new T.typedArrayConstructor(T.heap.buffer,D,I);m(y,G.slice(),P,O,B,M)}finally{e._free(D)}};if(n)for(const d in n){const f=n[d],y=r.GetAttributeByUniqueId(s,f);b(r,s,d,y)}else{const d={position:e.POSITION,normal:e.NORMAL,color:e.COLOR,uv:e.TEX_COORD};for(const f in d){const y=r.GetAttributeId(s,d[f]);if(y!==-1){const p=r.GetAttribute(s,y);b(r,s,f,p)}}}return h}finally{s&&e.destroy(s),o&&e.destroy(o),r&&e.destroy(r)}}function S(){let c;onmessage=t=>{const n=t.data;switch(n.id){case"init":{n.url&&importScripts(n.url);const a=n.wasmBinary?{wasmBinary:n.wasmBinary}:{};c=DracoDecoderModule(a),postMessage({id:"initDone"});break}case"decodeMesh":{if(!c)throw new Error("Draco: Decoder module is not available");c.then(a=>{const m=U(a,n.dataView,n.attributes,e=>{postMessage({id:"indices",data:e},[e.buffer])},(e,r,o,s,i,l)=>{postMessage({id:"attribute",kind:e,data:r,size:o,byteOffset:s,byteStride:i,normalized:l},[r.buffer])});postMessage({id:"decodeMeshDone",totalVertices:m})});break}}}}async function W(c,t,n){return await new Promise((a,m)=>{const e=o=>{c.removeEventListener("error",e),c.removeEventListener("message",r),m(o)},r=o=>{o.data.id==="initDone"&&(c.removeEventListener("error",e),c.removeEventListener("message",r),a(c))};if(c.addEventListener("error",e),c.addEventListener("message",r),!t)c.postMessage({id:"init",url:n});else{const o=t.slice(0);c.postMessage({id:"init",url:n,wasmBinary:o},[o])}})}function K(){return typeof navigator!="object"||!navigator.hardwareConcurrency?1:Math.min(Math.floor(navigator.hardwareConcurrency*.5),4)}function $(c){return!!(c.wasmUrl&&(c.wasmBinary||c.wasmBinaryUrl)&&typeof WebAssembly=="object"||c.fallbackUrl)}class z{constructor(t){if(t.workerPool){this._workerPoolPromise=Promise.resolve(t.workerPool);return}const n=t.wasmBinary,a=t.numWorkers??K(),m=a&&typeof Worker=="function"&&typeof URL=="function",e=m||!t.jsModule,r=t.wasmUrl&&t.wasmBinaryUrl&&typeof WebAssembly=="object"?{url:e?A.GetBabylonScriptURL(t.wasmUrl,!0):"",wasmBinaryPromise:n?Promise.resolve(n):A.LoadFileAsync(A.GetBabylonScriptURL(t.wasmBinaryUrl,!0))}:{url:e?A.GetBabylonScriptURL(t.fallbackUrl):"",wasmBinaryPromise:Promise.resolve(void 0)};m?this._workerPoolPromise=r.wasmBinaryPromise.then(o=>{const s=this._getWorkerContent(),i=URL.createObjectURL(new Blob([s],{type:"application/javascript"}));return new v(a,()=>{const l=new Worker(i);return W(l,o,r.url)})}):this._modulePromise=r.wasmBinaryPromise.then(async o=>{if(!this._isModuleAvailable()&&!t.jsModule){if(!r.url)throw new Error("Draco codec module is not available");await A.LoadBabylonScriptAsync(r.url)}return await this._createModuleAsync(o,t.jsModule)})}async whenReadyAsync(){if(this._workerPoolPromise){await this._workerPoolPromise;return}if(this._modulePromise){await this._modulePromise;return}}dispose(){this._workerPoolPromise&&this._workerPoolPromise.then(t=>{t.dispose()}),delete this._workerPoolPromise,delete this._modulePromise}}class w extends z{static get DefaultAvailable(){return $(w.DefaultConfiguration)}static get Default(){return w._Default??(w._Default=new w),w._Default}static ResetDefault(t){w._Default&&(t||w._Default.dispose(),w._Default=null)}_isModuleAvailable(){return typeof DracoDecoderModule<"u"}async _createModuleAsync(t,n){return{module:await(n||DracoDecoderModule)({wasmBinary:t})}}_getWorkerContent(){return`${U}(${S})()`}constructor(t=w.DefaultConfiguration){super(t)}decodeMeshToMeshDataAsync(t,n,a){const m=t instanceof ArrayBuffer?new Int8Array(t):new Int8Array(t.buffer,t.byteOffset,t.byteLength),e=(r,o)=>a&&a[r]!==void 0?(o!==a[r]&&V.Warn(`Normalized flag from Draco data (${o}) does not match normalized flag from glTF accessor (${a[r]}). Using flag from glTF accessor.`),a[r]):o;if(this._workerPoolPromise)return this._workerPoolPromise.then(async r=>await new Promise((o,s)=>{r.push((i,l)=>{let h=null;const b=[],d=p=>{i.removeEventListener("error",d),i.removeEventListener("message",f),s(p),l()},f=p=>{const u=p.data;switch(u.id){case"indices":{h=u.data;break}case"attribute":{b.push({kind:u.kind,data:u.data,size:u.size,byteOffset:u.byteOffset,byteStride:u.byteStride,normalized:e(u.kind,u.normalized)});break}case"decodeMeshDone":{i.removeEventListener("error",d),i.removeEventListener("message",f),o({indices:h,attributes:b,totalVertices:u.totalVertices}),l();break}}};i.addEventListener("error",d),i.addEventListener("message",f);const y=m.slice();i.postMessage({id:"decodeMesh",dataView:y,attributes:n},[y.buffer])})}));if(this._modulePromise)return this._modulePromise.then(r=>{let o=null;const s=[],i=U(r.module,m,n,l=>{o=l},(l,h,b,d,f,y)=>{s.push({kind:l,data:h,size:b,byteOffset:d,byteStride:f,normalized:y})});return{indices:o,attributes:s,totalVertices:i}});throw new Error("Draco: Decoder module is not available")}async decodeMeshToGeometryAsync(t,n,a,m){const e=await this.decodeMeshToMeshDataAsync(a,m),r=new C(t,n);e.indices&&r.setIndices(e.indices);for(const o of e.attributes)r.setVerticesBuffer(new _(n.getEngine(),o.data,o.kind,!1,void 0,o.byteStride,void 0,o.byteOffset,o.size,void 0,o.normalized,!0),e.totalVertices);return r}async _decodeMeshToGeometryForGltfAsync(t,n,a,m,e,r){const o=await this.decodeMeshToMeshDataAsync(a,m,e),s=new C(t,n);r&&(s._boundingInfo=r,s.useBoundingInfoFromGeometry=!0),o.indices&&s.setIndices(o.indices);for(const i of o.attributes)s.setVerticesBuffer(new _(n.getEngine(),i.data,i.kind,!1,void 0,i.byteStride,void 0,i.byteOffset,i.size,void 0,i.normalized,!0),o.totalVertices);return s}}w.DefaultConfiguration={wasmUrl:`${A._DefaultCdnUrl}/draco_wasm_wrapper_gltf.js`,wasmBinaryUrl:`${A._DefaultCdnUrl}/draco_decoder_gltf.wasm`,fallbackUrl:`${A._DefaultCdnUrl}/draco_decoder_gltf.js`};w._Default=null;const E="KHR_draco_mesh_compression";class H{constructor(t){this.name=E,this.useNormalizedFlagFromAccessor=!0,this._loader=t,this.enabled=w.DefaultAvailable&&this._loader.isExtensionUsed(E)}dispose(){delete this.dracoDecoder,this._loader=null}_loadVertexDataAsync(t,n,a){return k.LoadExtensionAsync(t,n,this.name,async(m,e)=>{if(n.mode!=null&&n.mode!==4&&n.mode!==5)throw new Error(`${t}: Unsupported mode ${n.mode}`);const r={},o={},s=(l,h)=>{const b=e.attributes[l];if(b!=null&&(a._delayInfo=a._delayInfo||[],a._delayInfo.indexOf(h)===-1&&a._delayInfo.push(h),r[h]=b,this.useNormalizedFlagFromAccessor)){const d=g.TryGet(this._loader.gltf.accessors,n.attributes[l]);d&&(o[h]=d.normalized||!1)}};s("POSITION",_.PositionKind),s("NORMAL",_.NormalKind),s("TANGENT",_.TangentKind),s("TEXCOORD_0",_.UVKind),s("TEXCOORD_1",_.UV2Kind),s("TEXCOORD_2",_.UV3Kind),s("TEXCOORD_3",_.UV4Kind),s("TEXCOORD_4",_.UV5Kind),s("TEXCOORD_5",_.UV6Kind),s("JOINTS_0",_.MatricesIndicesKind),s("WEIGHTS_0",_.MatricesWeightsKind),s("COLOR_0",_.ColorKind);const i=g.Get(m,this._loader.gltf.bufferViews,e.bufferView);return i._dracoBabylonGeometry||(i._dracoBabylonGeometry=this._loader.loadBufferViewAsync(`/bufferViews/${i.index}`,i).then(async l=>{const h=this.dracoDecoder||w.Default,b=g.TryGet(this._loader.gltf.accessors,n.attributes.POSITION),d=!this._loader.parent.alwaysComputeBoundingBox&&!a.skeleton&&b?R(b):null;return await h._decodeMeshToGeometryForGltfAsync(a.name,this._loader.babylonScene,l,r,o,d).catch(f=>{throw new Error(`${t}: ${f.message}`)})})),await i._dracoBabylonGeometry})}}F(E);N(E,!0,c=>new H(c));export{H as KHR_draco_mesh_compression};

trackio/frontend/dist/assets/KHR_interactivity-K8Kioa6L.js

@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/flowGraphPlayAnimationBlock-B9FP0RfS.js","assets/declarationMapper-oEUQrCmY.js","assets/bufferUtils-DTRdUD8L.js","assets/math.vector-C1xyPDEl.js","assets/math.scalar.functions-DkeaWAWz.js","assets/math.color-CzLaKyb6.js","assets/animationGroup-BP7VB8mY.js","assets/animation-IftAdLIx.js","assets/node-C-Iu0ALa.js","assets/decorators.serialization-C7d7ykGG.js","assets/baseTexture-CgAggsey.js","assets/bone-B35odufe.js","assets/scene-gn_hoGMy.js","assets/tools-D01N7ptR.js","assets/smartArray-CO6iJ0u5.js","assets/lightConstants-B1TSTh-k.js","assets/sceneComponent-Dflhczui.js","assets/math.plane-Ce_75-g5.js","assets/buffer-DqKlo1ts.js","assets/dataBuffer-CgoqiUzT.js","assets/renderingManager-CiY2OUrf.js","assets/deviceInputEvents-BTza-zoR.js","assets/perfCounter-DusmGz8t.js","assets/index-Bx1QoKVU.js","assets/index-BfQ3YfM4.css","assets/dynamic-BUKysMyT.js","assets/sceneLoader-CutT-qCn.js","assets/sceneLoaderFlags-wywyb9ml.js","assets/objectModelMapping-DWcnlpHl.js","assets/light-DT53MGnW.js","assets/math.axis-Ck7JfPPj.js","assets/texture-BEqhDl5Y.js","assets/flowGraphStopAnimationBlock-ChXcK4cb.js","assets/flowGraphPauseAnimationBlock-DAoY0eJc.js","assets/flowGraphInterpolationBlock-CYcMKCGO.js","assets/flowGraphSceneReadyEventBlock-Crn-rAIL.js","assets/flowGraphSceneTickEventBlock-gf3YDJRe.js","assets/flowGraphSendCustomEventBlock-Ba8XUM8G.js","assets/flowGraphReceiveCustomEventBlock-CId8KX4K.js","assets/flowGraphMeshPickEventBlock-WsLHiXtY.js","assets/flowGraphMathBlocks-HeZhspxf.js","assets/flowGraphBinaryOperationBlock-CNTF2Ejc.js","assets/flowGraphCachedOperationBlock-cxKp5Gdq.js","assets/flowGraphUnaryOperationBlock-CI7NJ04I.js","assets/flowGraphVectorMathBlocks-BGV5dKz9.js","assets/flowGraphMatrixMathBlocks-Dg7VLPFP.js","assets/flowGraphBranchBlock-CPQ1Lj8X.js","assets/flowGraphSetDelayBlock-BA13Fleb.js","assets/flowGraphCancelDelayBlock-CiPuCgGz.js","assets/flowGraphCounterBlock-OjaFZjW5.js","assets/flowGraphDebounceBlock-fxe8WoxT.js","assets/flowGraphThrottleBlock-B-yO7rgE.js","assets/flowGraphDoNBlock-C4vVyovK.js","assets/flowGraphFlipFlopBlock-BSjrwcqq.js","assets/flowGraphForLoopBlock-jI9z_K5X.js","assets/flowGraphMultiGateBlock-Cy-tdSZ3.js","assets/flowGraphSequenceBlock-Bcye5mDB.js","assets/flowGraphSwitchBlock-CfuObCnO.js","assets/flowGraphWaitAllBlock-VXxeVnO_.js","assets/flowGraphWhileLoopBlock-BYmEfSWz.js","assets/flowGraphConsoleLogBlock-Cz7IRQyV.js","assets/flowGraphConditionalDataBlock-Btzamqcx.js","assets/flowGraphConstantBlock-BV1ij11S.js","assets/flowGraphTransformCoordinatesSystemBlock-D3zEJ4A-.js","assets/flowGraphGetAssetBlock-BeMIiO3t.js","assets/flowGraphGetPropertyBlock-CAOmAIk8.js","assets/flowGraphSetPropertyBlock-DxJBj-a9.js","assets/flowGraphGetVariableBlock-BaRkHNJ_.js","assets/flowGraphSetVariableBlock-BG0Kfa6g.js","assets/flowGraphJsonPointerParserBlock-CZ93bSRG.js","assets/flowGraphMathCombineExtractBlocks-Dg02KNQM.js","assets/flowGraphTypeToTypeBlocks-DdLy9OXZ.js","assets/flowGraphEasingBlock-C_-3ZhLh.js","assets/easing-Wc0jPSIm.js","assets/math.path-DFucxaHn.js","assets/flowGraphBezierCurveEasingBlock--1XIKCm2.js","assets/flowGraphPointerOverEventBlock-wKWlgMPO.js","assets/flowGraphPointerOutEventBlock-BpW1yJKn.js","assets/flowGraphContextBlock-DeEwvFEY.js","assets/flowGraphArrayIndexBlock-3XRt4h8L.js","assets/flowGraphCodeExecutionBlock-BpjYYwgf.js","assets/flowGraphIndexOfBlock-D1XW4kc4.js","assets/flowGraphFunctionReferenceBlock-CLhl7P_Q.js","assets/flowGraphDataSwitchBlock-BUqG5JEg.js","assets/flowGraphGLTFDataProvider-By82y__G.js"])))=>i.map(i=>d[i]);
+import{_ as r}from"./index-Bx1QoKVU.js";import{M as kt,a as Gt,V as ut,b as Bt,Q as X,O as U}from"./math.vector-C1xyPDEl.js";import{L as w,_ as Ft,s as Et}from"./bufferUtils-DTRdUD8L.js";import{R as D}from"./decorators.serialization-C7d7ykGG.js";import{Color3 as vt,Color4 as It}from"./math.color-CzLaKyb6.js";import{F as Tt,a as Vt,b as Ct,g as Pt,c as bt,d as at}from"./declarationMapper-oEUQrCmY.js";import{R as ht}from"./math.scalar.functions-DkeaWAWz.js";import{P as rt}from"./deviceInputEvents-BTza-zoR.js";import{u as Ot,r as xt}from"./dynamic-BUKysMyT.js";import{a as Dt,A as O}from"./objectModelMapping-DWcnlpHl.js";function At(a){return a==="Mesh"||a==="AbstractMesh"||a==="GroundMesh"||a==="InstanceMesh"||a==="LinesMesh"||a==="GoldbergMesh"||a==="GreasedLineMesh"||a==="TrailMesh"}function pt(a){return a==="Vector2"||a==="Vector3"||a==="Vector4"||a==="Quaternion"||a==="Color3"||a==="Color4"}function Rt(a){return a==="Matrix"||a==="Matrix2D"||a==="Matrix3D"}function Lt(a){return a==="AnimationGroup"}function St(a,t,e=!1){if(a==="Vector2")return Gt.FromArray(t);if(a==="Vector3")return e&&(t[2]*=-1),ut.FromArray(t);if(a==="Vector4")return Bt.FromArray(t);if(a==="Quaternion")return e&&(t[2]*=-1,t[3]*=-1),X.FromArray(t);if(a==="Color3")return new vt(t[0],t[1],t[2]);if(a==="Color4")return new It(t[0],t[1],t[2],t[3]);throw new Error(`Unknown vector class name ${a}`)}function tt(a,t,e){var n;const o=((n=t==null?void 0:t.getClassName)==null?void 0:n.call(t))??"";if(pt(o)||Rt(o))e[a]={value:t.asArray(),className:o};else if(o==="FlowGraphInteger")e[a]={value:t.value,className:o};else if(o&&(t.id||t.name))e[a]={id:t.id,name:t.name,className:o};else if(typeof t!="object")e[a]=t;else throw new Error(`Could not serialize value ${t}`)}function H(a,t,e,o){const n=t[a];let s;const i=(n==null?void 0:n.type)??(n==null?void 0:n.className);if(At(i)){let c=o.meshes.filter(l=>n.id?l.id===n.id:l.name===n.name);c.length===0&&(c=o.transformNodes.filter(l=>n.id?l.id===n.id:l.name===n.name)),s=n.uniqueId?c.find(l=>l.uniqueId===n.uniqueId):c[0]}else if(pt(i))s=St(i,n.value);else if(Lt(i)){const c=o.animationGroups.filter(l=>l.name===n.name);s=c.length===1?c[0]:c.find(l=>l.uniqueId===n.uniqueId)}else i==="Matrix"?s=kt.FromArray(n.value):i==="Matrix2D"?s=new Tt(n.value):i==="Matrix3D"?s=new Vt(n.value):i==="FlowGraphInteger"?s=Ct.FromValue(n.value):i==="number"||i==="string"||i==="boolean"?s=n.value[0]:n&&n.value!==void 0?s=n.value:Array.isArray(n)?s=n.reduce((c,l)=>(l.eventData&&(c[l.id]={type:Pt(l.type)},typeof l.value<"u"&&(c[l.id].value=H("value",l,e,o))),c),{}):s=n;return s}function Nt(a){return a==="FlowGraphJsonPointerParserBlock"}var st;(function(a){a.Animation="Animation",a.AnimationGroup="AnimationGroup",a.Mesh="Mesh",a.Material="Material",a.Camera="Camera",a.Light="Light"})(st||(st={}));function Mt(a,t,e,o){switch(t){case"Animation":return o?a.animations.find(n=>n.uniqueId===e)??null:a.animations[e]??null;case"AnimationGroup":return o?a.animationGroups.find(n=>n.uniqueId===e)??null:a.animationGroups[e]??null;case"Mesh":return o?a.meshes.find(n=>n.uniqueId===e)??null:a.meshes[e]??null;case"Material":return o?a.materials.find(n=>n.uniqueId===e)??null:a.materials[e]??null;case"Camera":return o?a.cameras.find(n=>n.uniqueId===e)??null:a.cameras[e]??null;case"Light":return o?a.lights.find(n=>n.uniqueId===e)??null:a.lights[e]??null;default:return null}}var it;(function(a){a.ExecuteBlock="ExecuteBlock",a.ExecuteEvent="ExecuteEvent",a.TriggerConnection="TriggerConnection",a.ContextVariableSet="ContextVariableSet",a.GlobalVariableSet="GlobalVariableSet",a.GlobalVariableDelete="GlobalVariableDelete",a.GlobalVariableGet="GlobalVariableGet",a.AddConnection="AddConnection",a.GetConnectionValue="GetConnectionValue",a.SetConnectionValue="SetConnectionValue",a.ActivateSignal="ActivateSignal",a.ContextVariableGet="ContextVariableGet"})(it||(it={}));class qt{constructor(){this.logToConsole=!1,this.log=[]}addLogItem(t){var e;if(t.time||(t.time=Date.now()),this.log.push(t),this.logToConsole){const o=(e=t.payload)==null?void 0:e.value;typeof o=="object"&&o.getClassName?w.Log(`[FGLog] ${t.className}:${t.uniqueId.split("-")[0]} ${t.action} - ${JSON.stringify(o.getClassName())}: ${o.toString()}`):w.Log(`[FGLog] ${t.className}:${t.uniqueId.split("-")[0]} ${t.action} - ${JSON.stringify(t.payload)}`)}}getItemsOfType(t){return this.log.filter(e=>e.action===t)}}class _t{get enableLogging(){return this._enableLogging}set enableLogging(t){this._enableLogging!==t&&(this._enableLogging=t,this._enableLogging?(this.logger=new qt,this.logger.logToConsole=!0):this.logger=null)}constructor(t){this.uniqueId=D(),this._userVariables={},this._executionVariables={},this._globalContextVariables={},this._connectionValues={},this._pendingBlocks=[],this._executionId=0,this.onNodeExecutedObservable=new U,this.treatDataAsRightHanded=!1,this._enableLogging=!1,this._configuration=t,this.assetsContext=t.assetsContext??t.scene}hasVariable(t){return t in this._userVariables}setVariable(t,e){var o;this._userVariables[t]=e,(o=this.logger)==null||o.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"ContextVariableSet",payload:{name:t,value:e}})}getAsset(t,e){return Mt(this.assetsContext,t,e)}getVariable(t){var e;return(e=this.logger)==null||e.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"ContextVariableGet",payload:{name:t,value:this._userVariables[t]}}),this._userVariables[t]}get userVariables(){return this._userVariables}getScene(){return this._configuration.scene}_getUniqueIdPrefixedName(t,e){return`${t.uniqueId}_${e}`}_getGlobalContextVariable(t,e){var o;return(o=this.logger)==null||o.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"GlobalVariableGet",payload:{name:t,defaultValue:e,possibleValue:this._globalContextVariables[t]}}),this._hasGlobalContextVariable(t)?this._globalContextVariables[t]:e}_setGlobalContextVariable(t,e){var o;(o=this.logger)==null||o.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"GlobalVariableSet",payload:{name:t,value:e}}),this._globalContextVariables[t]=e}_deleteGlobalContextVariable(t){var e;(e=this.logger)==null||e.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"GlobalVariableDelete",payload:{name:t}}),delete this._globalContextVariables[t]}_hasGlobalContextVariable(t){return t in this._globalContextVariables}_setExecutionVariable(t,e,o){this._executionVariables[this._getUniqueIdPrefixedName(t,e)]=o}_getExecutionVariable(t,e,o){return this._hasExecutionVariable(t,e)?this._executionVariables[this._getUniqueIdPrefixedName(t,e)]:o}_deleteExecutionVariable(t,e){delete this._executionVariables[this._getUniqueIdPrefixedName(t,e)]}_hasExecutionVariable(t,e){return this._getUniqueIdPrefixedName(t,e)in this._executionVariables}_hasConnectionValue(t){return t.uniqueId in this._connectionValues}_setConnectionValue(t,e){var o;this._connectionValues[t.uniqueId]=e,(o=this.logger)==null||o.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"SetConnectionValue",payload:{connectionPointId:t.uniqueId,value:e}})}_setConnectionValueByKey(t,e){this._connectionValues[t]=e}_getConnectionValue(t){var e;return(e=this.logger)==null||e.addLogItem({time:Date.now(),className:this.getClassName(),uniqueId:this.uniqueId,action:"GetConnectionValue",payload:{connectionPointId:t.uniqueId,value:this._connectionValues[t.uniqueId]}}),this._connectionValues[t.uniqueId]}get configuration(){return this._configuration}get hasPendingBlocks(){return this._pendingBlocks.length>0}_addPendingBlock(t){this._pendingBlocks.includes(t)||(this._pendingBlocks.push(t),this._pendingBlocks.sort((e,o)=>e.priority-o.priority))}_removePendingBlock(t){const e=this._pendingBlocks.indexOf(t);e!==-1&&this._pendingBlocks.splice(e,1)}_clearPendingBlocks(){for(const t of this._pendingBlocks)t._cancelPendingTasks(this);this._pendingBlocks.length=0}_notifyExecuteNode(t){var e;this.onNodeExecutedObservable.notifyObservers(t),(e=this.logger)==null||e.addLogItem({time:Date.now(),className:t.getClassName(),uniqueId:t.uniqueId,action:"ExecuteBlock"})}_notifyOnTick(t){var e;this._setGlobalContextVariable("timeSinceStart",t.timeSinceStart),this._setGlobalContextVariable("deltaTime",t.deltaTime);for(const o of this._pendingBlocks)(e=o._executeOnTick)==null||e.call(o,this)}_increaseExecutionId(){this._executionId++}get executionId(){return this._executionId}serialize(t={},e=tt){var o;t.uniqueId=this.uniqueId,t._userVariables={};for(const n in this._userVariables)e(n,this._userVariables[n],t._userVariables);t._connectionValues={};for(const n in this._connectionValues)e(n,this._connectionValues[n],t._connectionValues);this.assetsContext!==this.getScene()&&(t._assetsContext={meshes:this.assetsContext.meshes.map(n=>n.id),materials:this.assetsContext.materials.map(n=>n.id),textures:this.assetsContext.textures.map(n=>n.name),animations:this.assetsContext.animations.map(n=>n.name),lights:this.assetsContext.lights.map(n=>n.id),cameras:this.assetsContext.cameras.map(n=>n.id),sounds:(o=this.assetsContext.sounds)==null?void 0:o.map(n=>n.name),skeletons:this.assetsContext.skeletons.map(n=>n.id),particleSystems:this.assetsContext.particleSystems.map(n=>n.name),geometries:this.assetsContext.geometries.map(n=>n.id),multiMaterials:this.assetsContext.multiMaterials.map(n=>n.id),transformNodes:this.assetsContext.transformNodes.map(n=>n.id)})}getClassName(){return"FlowGraphContext"}}Ft([Et()],_t.prototype,"uniqueId",void 0);var ct;(function(a){a[a.Input=0]="Input",a[a.Output=1]="Output"})(ct||(ct={}));class wt{constructor(t,e,o){this._ownerBlock=o,this._connectedPoint=[],this.uniqueId=D(),this.connectedPointIds=[],this.name=t,this._connectionType=e}get connectionType(){return this._connectionType}_isSingularConnection(){return!0}isConnected(){return this._connectedPoint.length>0}connectTo(t){if(this._connectionType===t._connectionType)throw new Error(`Cannot connect two points of type ${this.connectionType}`);if(this._isSingularConnection()&&this._connectedPoint.length>0||t._isSingularConnection()&&t._connectedPoint.length>0)throw new Error("Max number of connections for point reached");this._connectedPoint.push(t),t._connectedPoint.push(this)}disconnectFrom(t,e=!0){const o=this._connectedPoint.indexOf(t),n=t._connectedPoint.indexOf(this);o===-1||n===-1||(e&&this._connectedPoint.splice(o,1),t._connectedPoint.splice(n,1))}disconnectFromAll(){for(const t of this._connectedPoint)this.disconnectFrom(t,!1);this._connectedPoint.length=0}dispose(){for(const t of this._connectedPoint)this.disconnectFrom(t)}serialize(t={}){t.uniqueId=this.uniqueId,t.name=this.name,t._connectionType=this._connectionType,t.connectedPointIds=[],t.className=this.getClassName();for(const e of this._connectedPoint)t.connectedPointIds.push(e.uniqueId)}getClassName(){return"FGConnection"}deserialize(t){this.uniqueId=t.uniqueId,this.name=t.name,this._connectionType=t._connectionType,this.connectedPointIds=t.connectedPointIds}}class Y extends wt{constructor(t,e,o,n,s=n.defaultValue,i=!1){super(t,e,o),this.richType=n,this._defaultValue=s,this._optional=i,this._isDisabled=!1,this._lastValue=null,this.dataTransformer=null,this.onValueChangedObservable=new U}get optional(){return this._optional}get isDisabled(){return this._isDisabled}set isDisabled(t){this._isDisabled!==t&&(this._isDisabled=t,this._isDisabled&&this.disconnectFromAll())}_isSingularConnection(){return this.connectionType===0}setValue(t,e){e._getConnectionValue(this)!==t&&(e._setConnectionValue(this,t),this.onValueChangedObservable.notifyObservers(t))}resetToDefaultValue(t){t._setConnectionValue(this,this._defaultValue)}connectTo(t){this._isDisabled||super.connectTo(t)}_getValueOrDefault(t){const e=t._getConnectionValue(this)??this._defaultValue;return this.dataTransformer?this.dataTransformer(e):e}getValue(t){if(this.connectionType===1){t._notifyExecuteNode(this._ownerBlock),this._ownerBlock._updateOutputs(t);const o=this._getValueOrDefault(t);return this._lastValue=o,this.richType.typeTransformer?this.richType.typeTransformer(o):o}const e=this.isConnected()?this._connectedPoint[0].getValue(t):this._getValueOrDefault(t);return this._lastValue=e,this.richType.typeTransformer?this.richType.typeTransformer(e):e}_getLastValue(){return this._lastValue}getClassName(){return"FlowGraphDataConnection"}serialize(t={}){super.serialize(t),t.richType={},this.richType.serialize(t.richType),t.optional=this._optional,tt("defaultValue",this._defaultValue,t)}}ht("FlowGraphDataConnection",Y);class $t{constructor(t){var e;this.config=t,this.uniqueId=D(),this.name=((e=this.config)==null?void 0:e.name)??this.getClassName(),this.dataInputs=[],this.dataOutputs=[]}_updateOutputs(t){}registerDataInput(t,e,o){const n=new Y(t,0,this,e,o);return this.dataInputs.push(n),n}registerDataOutput(t,e,o){const n=new Y(t,1,this,e,o);return this.dataOutputs.push(n),n}getDataInput(t){return this.dataInputs.find(e=>e.name===t)}getDataOutput(t){return this.dataOutputs.find(e=>e.name===t)}serialize(t={},e=tt){if(t.uniqueId=this.uniqueId,t.config={},this.config){const o=this.config,n=Object.keys(o);for(const s of n)e(s,o[s],t.config)}t.dataInputs=[],t.dataOutputs=[],t.className=this.getClassName();for(const o of this.dataInputs){const n={};o.serialize(n),t.dataInputs.push(n)}for(const o of this.dataOutputs){const n={};o.serialize(n),t.dataOutputs.push(n)}}deserialize(t){}_log(t,e,o){var n;(n=t.logger)==null||n.addLogItem({action:e,payload:o,className:this.getClassName(),uniqueId:this.uniqueId})}getClassName(){return"FlowGraphBlock"}}class z extends wt{constructor(){super(...arguments),this.priority=0}_isSingularConnection(){return!1}connectTo(t){super.connectTo(t),this._connectedPoint.sort((e,o)=>o.priority-e.priority)}_activateSignal(t){var e;if((e=t.logger)==null||e.addLogItem({action:"ActivateSignal",className:this._ownerBlock.getClassName(),uniqueId:this._ownerBlock.uniqueId,payload:{connectionType:this.connectionType,name:this.name}}),this.connectionType===0)t._notifyExecuteNode(this._ownerBlock),this._ownerBlock._execute(t,this),t._increaseExecutionId();else for(const o of this._connectedPoint)o._activateSignal(t)}}ht("FlowGraphSignalConnection",z);class J extends $t{constructor(t){super(t),this.priority=0,this.signalInputs=[],this.signalOutputs=[],this.in=this._registerSignalInput("in"),this.error=this._registerSignalOutput("error")}_registerSignalInput(t){const e=new z(t,0,this);return this.signalInputs.push(e),e}_registerSignalOutput(t){const e=new z(t,1,this);return this.signalOutputs.push(e),e}_unregisterSignalInput(t){const e=this.signalInputs.findIndex(o=>o.name===t);e!==-1&&(this.signalInputs[e].dispose(),this.signalInputs.splice(e,1))}_unregisterSignalOutput(t){const e=this.signalOutputs.findIndex(o=>o.name===t);e!==-1&&(this.signalOutputs[e].dispose(),this.signalOutputs.splice(e,1))}_reportError(t,e){this.error.payload=typeof e=="string"?new Error(e):e,this.error._activateSignal(t)}getSignalInput(t){return this.signalInputs.find(e=>e.name===t)}getSignalOutput(t){return this.signalOutputs.find(e=>e.name===t)}serialize(t={}){super.serialize(t),t.signalInputs=[],t.signalOutputs=[];for(const e of this.signalInputs){const o={};e.serialize(o),t.signalInputs.push(o)}for(const e of this.signalOutputs){const o={};e.serialize(o),t.signalOutputs.push(o)}}deserialize(t){for(let e=0;e<t.signalInputs.length;e++){const o=this.getSignalInput(t.signalInputs[e].name);if(o)o.deserialize(t.signalInputs[e]);else throw new Error("Could not find signal input with name "+t.signalInputs[e].name+" in block "+t.className)}for(let e=0;e<t.signalOutputs.length;e++){const o=this.getSignalOutput(t.signalOutputs[e].name);if(o)o.deserialize(t.signalOutputs[e]);else throw new Error("Could not find signal output with name "+t.signalOutputs[e].name+" in block "+t.className)}}getClassName(){return"FlowGraphExecutionBlock"}}class Kt{constructor(t){this.onEventTriggeredObservable=new U,this.sceneReadyTriggered=!1,this._pointerUnderMeshState={},this._startingTime=0,this._scene=t,this._initialize()}_initialize(){this._sceneReadyObserver=this._scene.onReadyObservable.add(()=>{this.sceneReadyTriggered||(this.onEventTriggeredObservable.notifyObservers({type:"SceneReady"}),this.sceneReadyTriggered=!0)}),this._sceneDisposeObserver=this._scene.onDisposeObservable.add(()=>{this.onEventTriggeredObservable.notifyObservers({type:"SceneDispose"})}),this._sceneOnBeforeRenderObserver=this._scene.onBeforeRenderObservable.add(()=>{const t=this._scene.getEngine().getDeltaTime()/1e3;this.onEventTriggeredObservable.notifyObservers({type:"SceneBeforeRender",payload:{timeSinceStart:this._startingTime,deltaTime:t}}),this._startingTime+=t}),this._meshPickedObserver=this._scene.onPointerObservable.add(t=>{this.onEventTriggeredObservable.notifyObservers({type:"MeshPick",payload:t})},rt.POINTERPICK),this._meshUnderPointerObserver=this._scene.onMeshUnderPointerUpdatedObservable.add(t=>{const e=t.pointerId,o=t.mesh,n=this._pointerUnderMeshState[e];!n&&o?this.onEventTriggeredObservable.notifyObservers({type:"PointerOver",payload:{pointerId:e,mesh:o}}):n&&!o?this.onEventTriggeredObservable.notifyObservers({type:"PointerOut",payload:{pointerId:e,mesh:n}}):n&&o&&n!==o&&(this.onEventTriggeredObservable.notifyObservers({type:"PointerOut",payload:{pointerId:e,mesh:n,over:o}}),this.onEventTriggeredObservable.notifyObservers({type:"PointerOver",payload:{pointerId:e,mesh:o,out:n}})),this._pointerUnderMeshState[e]=o},rt.POINTERMOVE)}dispose(){var t,e,o,n,s;(t=this._sceneDisposeObserver)==null||t.remove(),(e=this._sceneReadyObserver)==null||e.remove(),(o=this._sceneOnBeforeRenderObserver)==null||o.remove(),(n=this._meshPickedObserver)==null||n.remove(),(s=this._meshUnderPointerObserver)==null||s.remove(),this.onEventTriggeredObservable.clear()}}function dt(a,t){return!!(a.parent&&(a.parent===t||dt(a.parent,t)))}function de(a){if(a.getClassName)return a.getClassName()}function fe(a,t){return a===t&&(a==="Vector2"||a==="Vector3"||a==="Vector4"||a==="Quaternion")}function ye(a,t){return a===t&&(a==="Matrix"||a==="Matrix2D"||a==="Matrix3D")}function ge(a,t){return a==="FlowGraphInteger"&&t==="FlowGraphInteger"}function me(a,t){const e=typeof a=="number"||typeof(a==null?void 0:a.value)=="number";return e&&!t?!isNaN(Wt(a)):e}function Wt(a){return typeof a=="number"?a:a.value}var lt;(function(a){a[a.Stopped=0]="Stopped",a[a.Started=1]="Started"})(lt||(lt={}));class Ut{get state(){return this._state}set state(t){this._state=t,this.onStateChangedObservable.notifyObservers(t)}constructor(t){this.onStateChangedObservable=new U,this._eventBlocks={SceneReady:[],SceneDispose:[],SceneBeforeRender:[],MeshPick:[],PointerDown:[],PointerUp:[],PointerMove:[],PointerOver:[],PointerOut:[],SceneAfterRender:[],NoTrigger:[]},this._executionContexts=[],this._state=0,this._scene=t.scene,this._sceneEventCoordinator=new Kt(this._scene),this._coordinator=t.coordinator,this._eventObserver=this._sceneEventCoordinator.onEventTriggeredObservable.add(e=>{for(const o of this._executionContexts){const n=this._getContextualOrder(e.type,o);for(const s of n)if(!s._executeEvent(o,e.payload))break}switch(e.type){case"SceneReady":this._sceneEventCoordinator.sceneReadyTriggered=!0;break;case"SceneBeforeRender":for(const o of this._executionContexts)o._notifyOnTick(e.payload);break;case"SceneDispose":this.dispose();break}})}createContext(){const t=new _t({scene:this._scene,coordinator:this._coordinator});return this._executionContexts.push(t),t}getContext(t){return this._executionContexts[t]}addEventBlock(t){if((t.type==="PointerOver"||t.type==="PointerOut")&&(this._scene.constantlyUpdateMeshUnderPointer=!0),t.type!=="NoTrigger"&&this._eventBlocks[t.type].push(t),this.state===1)for(const e of this._executionContexts)t._startPendingTasks(e);else this.onStateChangedObservable.addOnce(e=>{if(e===1)for(const o of this._executionContexts)t._startPendingTasks(o)})}start(){this.state!==1&&(this._executionContexts.length===0&&this.createContext(),this.onStateChangedObservable.add(t=>{t===1&&(this._startPendingEvents(),this._scene.isReady(!0)&&this._sceneEventCoordinator.onEventTriggeredObservable.notifyObservers({type:"SceneReady"}))}),this.state=1)}_startPendingEvents(){for(const t of this._executionContexts)for(const e in this._eventBlocks){const o=this._getContextualOrder(e,t);for(const n of o)n._startPendingTasks(t)}}_getContextualOrder(t,e){const o=this._eventBlocks[t].sort((n,s)=>s.initPriority-n.initPriority);if(t==="MeshPick"){const n=[];for(const s of o){const i=s.asset.getValue(e);let c=0;for(;c<o.length;c++){const u=o[c].asset.getValue(e);if(i&&u&&dt(i,u))break}n.splice(c,0,s)}return n}return o}dispose(){var t;if(this.state!==0){this.state=0;for(const e of this._executionContexts)e._clearPendingBlocks();this._executionContexts.length=0;for(const e in this._eventBlocks)this._eventBlocks[e].length=0;(t=this._eventObserver)==null||t.remove(),this._sceneEventCoordinator.dispose()}}visitAllBlocks(t){const e=[],o=new Set;for(const n in this._eventBlocks)for(const s of this._eventBlocks[n])e.push(s),o.add(s.uniqueId);for(;e.length>0;){const n=e.pop();t(n);for(const s of n.dataInputs)for(const i of s._connectedPoint)o.has(i._ownerBlock.uniqueId)||(e.push(i._ownerBlock),o.add(i._ownerBlock.uniqueId));if(n instanceof J)for(const s of n.signalOutputs)for(const i of s._connectedPoint)o.has(i._ownerBlock.uniqueId)||(e.push(i._ownerBlock),o.add(i._ownerBlock.uniqueId))}}serialize(t={},e){t.allBlocks=[],this.visitAllBlocks(o=>{const n={};o.serialize(n),t.allBlocks.push(n)}),t.executionContexts=[];for(const o of this._executionContexts){const n={};o.serialize(n,e),t.executionContexts.push(n)}}}class E{constructor(t){this.config=t,this.dispatchEventsSynchronously=!0,this._flowGraphs=[],this._customEventsMap=new Map,this._eventExecutionCounter=new Map,this._executeOnNextFrame=[],this._eventUniqueId=0,this._disposeObserver=this.config.scene.onDisposeObservable.add(()=>{this.dispose()}),this._onBeforeRenderObserver=this.config.scene.onBeforeRenderObservable.add(()=>{this._eventExecutionCounter.clear();const o=this._executeOnNextFrame.slice(0);if(o.length)for(const n of o){this.notifyCustomEvent(n.id,n.data,!1);const s=this._executeOnNextFrame.findIndex(i=>i.uniqueId===n.uniqueId);s!==-1&&this._executeOnNextFrame.splice(s,1)}});let e=E.SceneCoordinators.get(this.config.scene);e||(e=[],E.SceneCoordinators.set(this.config.scene,e)),e.push(this)}createGraph(){const t=new Ut({scene:this.config.scene,coordinator:this});return this._flowGraphs.push(t),t}removeGraph(t){const e=this._flowGraphs.indexOf(t);e!==-1&&(t.dispose(),this._flowGraphs.splice(e,1))}start(){for(const t of this._flowGraphs)t.start()}dispose(){var o,n;for(const s of this._flowGraphs)s.dispose();this._flowGraphs.length=0,(o=this._disposeObserver)==null||o.remove(),(n=this._onBeforeRenderObserver)==null||n.remove();const t=E.SceneCoordinators.get(this.config.scene)??[],e=t.indexOf(this);e!==-1&&t.splice(e,1)}serialize(t,e){t._flowGraphs=[];for(const o of this._flowGraphs){const n={};o.serialize(n,e),t._flowGraphs.push(n)}t.dispatchEventsSynchronously=this.dispatchEventsSynchronously}get flowGraphs(){return this._flowGraphs}getCustomEventObservable(t){let e=this._customEventsMap.get(t);return e||(e=new U,this._customEventsMap.set(t,e)),e}notifyCustomEvent(t,e,o=!this.dispatchEventsSynchronously){if(o){this._executeOnNextFrame.push({id:t,data:e,uniqueId:this._eventUniqueId++});return}if(this._eventExecutionCounter.has(t)){const s=this._eventExecutionCounter.get(t);if(this._eventExecutionCounter.set(t,s+1),s>=E.MaxEventTypeExecutionPerFrame){s===E.MaxEventTypeExecutionPerFrame&&w.Warn(`FlowGraphCoordinator: Too many executions of event "${t}".`);return}}else this._eventExecutionCounter.set(t,1);const n=this._customEventsMap.get(t);n&&n.notifyObservers(e)}}E.MaxEventsPerType=30;E.MaxEventTypeExecutionPerFrame=30;E.SceneCoordinators=new Map;const j={};function Qt(a,t,e){j[`${a}/${t}`]=e}function Ht(a){switch(a){case"FlowGraphPlayAnimationBlock":return async()=>(await r(async()=>{const{FlowGraphPlayAnimationBlock:t}=await import("./flowGraphPlayAnimationBlock-B9FP0RfS.js");return{FlowGraphPlayAnimationBlock:t}},__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31]))).FlowGraphPlayAnimationBlock;case"FlowGraphStopAnimationBlock":return async()=>(await r(async()=>{const{FlowGraphStopAnimationBlock:t}=await import("./flowGraphStopAnimationBlock-ChXcK4cb.js");return{FlowGraphStopAnimationBlock:t}},__vite__mapDeps([32,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphStopAnimationBlock;case"FlowGraphPauseAnimationBlock":return async()=>(await r(async()=>{const{FlowGraphPauseAnimationBlock:t}=await import("./flowGraphPauseAnimationBlock-DAoY0eJc.js");return{FlowGraphPauseAnimationBlock:t}},__vite__mapDeps([33,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphPauseAnimationBlock;case"FlowGraphInterpolationBlock":return async()=>(await r(async()=>{const{FlowGraphInterpolationBlock:t}=await import("./flowGraphInterpolationBlock-CYcMKCGO.js");return{FlowGraphInterpolationBlock:t}},__vite__mapDeps([34,1,2,3,4,5,7,8,9,10,23,24,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,29,30,31]))).FlowGraphInterpolationBlock;case"FlowGraphSceneReadyEventBlock":return async()=>(await r(async()=>{const{FlowGraphSceneReadyEventBlock:t}=await import("./flowGraphSceneReadyEventBlock-Crn-rAIL.js");return{FlowGraphSceneReadyEventBlock:t}},__vite__mapDeps([35,4,23,24,3,2,9,5,1,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSceneReadyEventBlock;case"FlowGraphSceneTickEventBlock":return async()=>(await r(async()=>{const{FlowGraphSceneTickEventBlock:t}=await import("./flowGraphSceneTickEventBlock-gf3YDJRe.js");return{FlowGraphSceneTickEventBlock:t}},__vite__mapDeps([36,4,1,2,3,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSceneTickEventBlock;case"FlowGraphSendCustomEventBlock":return async()=>(await r(async()=>{const{FlowGraphSendCustomEventBlock:t}=await import("./flowGraphSendCustomEventBlock-Ba8XUM8G.js");return{FlowGraphSendCustomEventBlock:t}},__vite__mapDeps([37,4,23,24,3,2,9,5,1,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSendCustomEventBlock;case"FlowGraphReceiveCustomEventBlock":return async()=>(await r(async()=>{const{FlowGraphReceiveCustomEventBlock:t}=await import("./flowGraphReceiveCustomEventBlock-CId8KX4K.js");return{FlowGraphReceiveCustomEventBlock:t}},__vite__mapDeps([38,13,3,4,9,2,5,23,24,1,21,25,26,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphReceiveCustomEventBlock;case"FlowGraphMeshPickEventBlock":return async()=>(await r(async()=>{const{FlowGraphMeshPickEventBlock:t}=await import("./flowGraphMeshPickEventBlock-WsLHiXtY.js");return{FlowGraphMeshPickEventBlock:t}},__vite__mapDeps([39,21,3,4,1,2,5,23,24,9,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMeshPickEventBlock;case"FlowGraphEBlock":return async()=>(await r(async()=>{const{FlowGraphEBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphEBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphEBlock;case"FlowGraphPIBlock":return async()=>(await r(async()=>{const{FlowGraphPiBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphPiBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphPiBlock;case"FlowGraphInfBlock":return async()=>(await r(async()=>{const{FlowGraphInfBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphInfBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphInfBlock;case"FlowGraphNaNBlock":return async()=>(await r(async()=>{const{FlowGraphNaNBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphNaNBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphNaNBlock;case"FlowGraphRandomBlock":return async()=>(await r(async()=>{const{FlowGraphRandomBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphRandomBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphRandomBlock;case"FlowGraphAddBlock":return async()=>(await r(async()=>{const{FlowGraphAddBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAddBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAddBlock;case"FlowGraphSubtractBlock":return async()=>(await r(async()=>{const{FlowGraphSubtractBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSubtractBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSubtractBlock;case"FlowGraphMultiplyBlock":return async()=>(await r(async()=>{const{FlowGraphMultiplyBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphMultiplyBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMultiplyBlock;case"FlowGraphDivideBlock":return async()=>(await r(async()=>{const{FlowGraphDivideBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphDivideBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDivideBlock;case"FlowGraphAbsBlock":return async()=>(await r(async()=>{const{FlowGraphAbsBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAbsBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAbsBlock;case"FlowGraphSignBlock":return async()=>(await r(async()=>{const{FlowGraphSignBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSignBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSignBlock;case"FlowGraphTruncBlock":return async()=>(await r(async()=>{const{FlowGraphTruncBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphTruncBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTruncBlock;case"FlowGraphFloorBlock":return async()=>(await r(async()=>{const{FlowGraphFloorBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphFloorBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFloorBlock;case"FlowGraphCeilBlock":return async()=>(await r(async()=>{const{FlowGraphCeilBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphCeilBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCeilBlock;case"FlowGraphRoundBlock":return async()=>(await r(async()=>{const{FlowGraphRoundBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphRoundBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphRoundBlock;case"FlowGraphFractBlock":return async()=>(await r(async()=>{const{FlowGraphFractionBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphFractionBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFractionBlock;case"FlowGraphNegationBlock":return async()=>(await r(async()=>{const{FlowGraphNegationBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphNegationBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphNegationBlock;case"FlowGraphModuloBlock":return async()=>(await r(async()=>{const{FlowGraphModuloBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphModuloBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphModuloBlock;case"FlowGraphMinBlock":return async()=>(await r(async()=>{const{FlowGraphMinBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphMinBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMinBlock;case"FlowGraphMaxBlock":return async()=>(await r(async()=>{const{FlowGraphMaxBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphMaxBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMaxBlock;case"FlowGraphClampBlock":return async()=>(await r(async()=>{const{FlowGraphClampBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphClampBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphClampBlock;case"FlowGraphSaturateBlock":return async()=>(await r(async()=>{const{FlowGraphSaturateBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSaturateBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSaturateBlock;case"FlowGraphMathInterpolationBlock":return async()=>(await r(async()=>{const{FlowGraphMathInterpolationBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphMathInterpolationBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMathInterpolationBlock;case"FlowGraphEqualityBlock":return async()=>(await r(async()=>{const{FlowGraphEqualityBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphEqualityBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphEqualityBlock;case"FlowGraphLessThanBlock":return async()=>(await r(async()=>{const{FlowGraphLessThanBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLessThanBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLessThanBlock;case"FlowGraphLessThanOrEqualBlock":return async()=>(await r(async()=>{const{FlowGraphLessThanOrEqualBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLessThanOrEqualBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLessThanOrEqualBlock;case"FlowGraphGreaterThanBlock":return async()=>(await r(async()=>{const{FlowGraphGreaterThanBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphGreaterThanBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGreaterThanBlock;case"FlowGraphGreaterThanOrEqualBlock":return async()=>(await r(async()=>{const{FlowGraphGreaterThanOrEqualBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphGreaterThanOrEqualBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGreaterThanOrEqualBlock;case"FlowGraphIsNaNBlock":return async()=>(await r(async()=>{const{FlowGraphIsNanBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphIsNanBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphIsNanBlock;case"FlowGraphIsInfBlock":return async()=>(await r(async()=>{const{FlowGraphIsInfinityBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphIsInfinityBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphIsInfinityBlock;case"FlowGraphDegToRadBlock":return async()=>(await r(async()=>{const{FlowGraphDegToRadBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphDegToRadBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDegToRadBlock;case"FlowGraphRadToDegBlock":return async()=>(await r(async()=>{const{FlowGraphRadToDegBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphRadToDegBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphRadToDegBlock;case"FlowGraphSinBlock":return async()=>(await r(async()=>{const{FlowGraphSinBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSinBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSinBlock;case"FlowGraphCosBlock":return async()=>(await r(async()=>{const{FlowGraphCosBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphCosBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCosBlock;case"FlowGraphTanBlock":return async()=>(await r(async()=>{const{FlowGraphTanBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphTanBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTanBlock;case"FlowGraphASinBlock":return async()=>(await r(async()=>{const{FlowGraphAsinBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAsinBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAsinBlock;case"FlowGraphACosBlock":return async()=>(await r(async()=>{const{FlowGraphAcosBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAcosBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAcosBlock;case"FlowGraphATanBlock":return async()=>(await r(async()=>{const{FlowGraphAtanBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAtanBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAtanBlock;case"FlowGraphATan2Block":return async()=>(await r(async()=>{const{FlowGraphAtan2Block:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAtan2Block:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAtan2Block;case"FlowGraphSinhBlock":return async()=>(await r(async()=>{const{FlowGraphSinhBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSinhBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSinhBlock;case"FlowGraphCoshBlock":return async()=>(await r(async()=>{const{FlowGraphCoshBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphCoshBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCoshBlock;case"FlowGraphTanhBlock":return async()=>(await r(async()=>{const{FlowGraphTanhBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphTanhBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTanhBlock;case"FlowGraphASinhBlock":return async()=>(await r(async()=>{const{FlowGraphAsinhBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAsinhBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAsinhBlock;case"FlowGraphACoshBlock":return async()=>(await r(async()=>{const{FlowGraphAcoshBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAcoshBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAcoshBlock;case"FlowGraphATanhBlock":return async()=>(await r(async()=>{const{FlowGraphAtanhBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphAtanhBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAtanhBlock;case"FlowGraphExponentialBlock":return async()=>(await r(async()=>{const{FlowGraphExpBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphExpBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphExpBlock;case"FlowGraphLogBlock":return async()=>(await r(async()=>{const{FlowGraphLogBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLogBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLogBlock;case"FlowGraphLog2Block":return async()=>(await r(async()=>{const{FlowGraphLog2Block:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLog2Block:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLog2Block;case"FlowGraphLog10Block":return async()=>(await r(async()=>{const{FlowGraphLog10Block:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLog10Block:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLog10Block;case"FlowGraphSquareRootBlock":return async()=>(await r(async()=>{const{FlowGraphSquareRootBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphSquareRootBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSquareRootBlock;case"FlowGraphPowerBlock":return async()=>(await r(async()=>{const{FlowGraphPowerBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphPowerBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphPowerBlock;case"FlowGraphCubeRootBlock":return async()=>(await r(async()=>{const{FlowGraphCubeRootBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphCubeRootBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCubeRootBlock;case"FlowGraphBitwiseAndBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseAndBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseAndBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseAndBlock;case"FlowGraphBitwiseOrBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseOrBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseOrBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseOrBlock;case"FlowGraphBitwiseNotBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseNotBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseNotBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseNotBlock;case"FlowGraphBitwiseXorBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseXorBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseXorBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseXorBlock;case"FlowGraphBitwiseLeftShiftBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseLeftShiftBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseLeftShiftBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseLeftShiftBlock;case"FlowGraphBitwiseRightShiftBlock":return async()=>(await r(async()=>{const{FlowGraphBitwiseRightShiftBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphBitwiseRightShiftBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBitwiseRightShiftBlock;case"FlowGraphLengthBlock":return async()=>(await r(async()=>{const{FlowGraphLengthBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphLengthBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLengthBlock;case"FlowGraphNormalizeBlock":return async()=>(await r(async()=>{const{FlowGraphNormalizeBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphNormalizeBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphNormalizeBlock;case"FlowGraphDotBlock":return async()=>(await r(async()=>{const{FlowGraphDotBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphDotBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDotBlock;case"FlowGraphCrossBlock":return async()=>(await r(async()=>{const{FlowGraphCrossBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphCrossBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCrossBlock;case"FlowGraphRotate2DBlock":return async()=>(await r(async()=>{const{FlowGraphRotate2DBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphRotate2DBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphRotate2DBlock;case"FlowGraphRotate3DBlock":return async()=>(await r(async()=>{const{FlowGraphRotate3DBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphRotate3DBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphRotate3DBlock;case"FlowGraphTransposeBlock":return async()=>(await r(async()=>{const{FlowGraphTransposeBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphTransposeBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTransposeBlock;case"FlowGraphDeterminantBlock":return async()=>(await r(async()=>{const{FlowGraphDeterminantBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphDeterminantBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDeterminantBlock;case"FlowGraphInvertMatrixBlock":return async()=>(await r(async()=>{const{FlowGraphInvertMatrixBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphInvertMatrixBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphInvertMatrixBlock;case"FlowGraphMatrixMultiplicationBlock":return async()=>(await r(async()=>{const{FlowGraphMatrixMultiplicationBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphMatrixMultiplicationBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMatrixMultiplicationBlock;case"FlowGraphBranchBlock":return async()=>(await r(async()=>{const{FlowGraphBranchBlock:t}=await import("./flowGraphBranchBlock-CPQ1Lj8X.js");return{FlowGraphBranchBlock:t}},__vite__mapDeps([46,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBranchBlock;case"FlowGraphSetDelayBlock":return async()=>(await r(async()=>{const{FlowGraphSetDelayBlock:t}=await import("./flowGraphSetDelayBlock-BA13Fleb.js");return{FlowGraphSetDelayBlock:t}},__vite__mapDeps([47,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSetDelayBlock;case"FlowGraphCancelDelayBlock":return async()=>(await r(async()=>{const{FlowGraphCancelDelayBlock:t}=await import("./flowGraphCancelDelayBlock-CiPuCgGz.js");return{FlowGraphCancelDelayBlock:t}},__vite__mapDeps([48,4,1,2,3,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCancelDelayBlock;case"FlowGraphCallCounterBlock":return async()=>(await r(async()=>{const{FlowGraphCallCounterBlock:t}=await import("./flowGraphCounterBlock-OjaFZjW5.js");return{FlowGraphCallCounterBlock:t}},__vite__mapDeps([49,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCallCounterBlock;case"FlowGraphDebounceBlock":return async()=>(await r(async()=>{const{FlowGraphDebounceBlock:t}=await import("./flowGraphDebounceBlock-fxe8WoxT.js");return{FlowGraphDebounceBlock:t}},__vite__mapDeps([50,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDebounceBlock;case"FlowGraphThrottleBlock":return async()=>(await r(async()=>{const{FlowGraphThrottleBlock:t}=await import("./flowGraphThrottleBlock-B-yO7rgE.js");return{FlowGraphThrottleBlock:t}},__vite__mapDeps([51,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphThrottleBlock;case"FlowGraphDoNBlock":return async()=>(await r(async()=>{const{FlowGraphDoNBlock:t}=await import("./flowGraphDoNBlock-C4vVyovK.js");return{FlowGraphDoNBlock:t}},__vite__mapDeps([52,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDoNBlock;case"FlowGraphFlipFlopBlock":return async()=>(await r(async()=>{const{FlowGraphFlipFlopBlock:t}=await import("./flowGraphFlipFlopBlock-BSjrwcqq.js");return{FlowGraphFlipFlopBlock:t}},__vite__mapDeps([53,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFlipFlopBlock;case"FlowGraphForLoopBlock":return async()=>(await r(async()=>{const{FlowGraphForLoopBlock:t}=await import("./flowGraphForLoopBlock-jI9z_K5X.js");return{FlowGraphForLoopBlock:t}},__vite__mapDeps([54,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphForLoopBlock;case"FlowGraphMultiGateBlock":return async()=>(await r(async()=>{const{FlowGraphMultiGateBlock:t}=await import("./flowGraphMultiGateBlock-Cy-tdSZ3.js");return{FlowGraphMultiGateBlock:t}},__vite__mapDeps([55,4,1,2,3,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMultiGateBlock;case"FlowGraphSequenceBlock":return async()=>(await r(async()=>{const{FlowGraphSequenceBlock:t}=await import("./flowGraphSequenceBlock-Bcye5mDB.js");return{FlowGraphSequenceBlock:t}},__vite__mapDeps([56,4,23,24,3,2,9,5,1,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSequenceBlock;case"FlowGraphSwitchBlock":return async()=>(await r(async()=>{const{FlowGraphSwitchBlock:t}=await import("./flowGraphSwitchBlock-CfuObCnO.js");return{FlowGraphSwitchBlock:t}},__vite__mapDeps([57,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSwitchBlock;case"FlowGraphWaitAllBlock":return async()=>(await r(async()=>{const{FlowGraphWaitAllBlock:t}=await import("./flowGraphWaitAllBlock-VXxeVnO_.js");return{FlowGraphWaitAllBlock:t}},__vite__mapDeps([58,4,1,2,3,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphWaitAllBlock;case"FlowGraphWhileLoopBlock":return async()=>(await r(async()=>{const{FlowGraphWhileLoopBlock:t}=await import("./flowGraphWhileLoopBlock-BYmEfSWz.js");return{FlowGraphWhileLoopBlock:t}},__vite__mapDeps([59,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphWhileLoopBlock;case"FlowGraphConsoleLogBlock":return async()=>(await r(async()=>{const{FlowGraphConsoleLogBlock:t}=await import("./flowGraphConsoleLogBlock-Cz7IRQyV.js");return{FlowGraphConsoleLogBlock:t}},__vite__mapDeps([60,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphConsoleLogBlock;case"FlowGraphConditionalBlock":return async()=>(await r(async()=>{const{FlowGraphConditionalDataBlock:t}=await import("./flowGraphConditionalDataBlock-Btzamqcx.js");return{FlowGraphConditionalDataBlock:t}},__vite__mapDeps([61,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphConditionalDataBlock;case"FlowGraphConstantBlock":return async()=>(await r(async()=>{const{FlowGraphConstantBlock:t}=await import("./flowGraphConstantBlock-BV1ij11S.js");return{FlowGraphConstantBlock:t}},__vite__mapDeps([62,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphConstantBlock;case"FlowGraphTransformCoordinatesSystemBlock":return async()=>(await r(async()=>{const{FlowGraphTransformCoordinatesSystemBlock:t}=await import("./flowGraphTransformCoordinatesSystemBlock-D3zEJ4A-.js");return{FlowGraphTransformCoordinatesSystemBlock:t}},__vite__mapDeps([63,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTransformCoordinatesSystemBlock;case"FlowGraphGetAssetBlock":return async()=>(await r(async()=>{const{FlowGraphGetAssetBlock:t}=await import("./flowGraphGetAssetBlock-BeMIiO3t.js");return{FlowGraphGetAssetBlock:t}},__vite__mapDeps([64,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGetAssetBlock;case"FlowGraphGetPropertyBlock":return async()=>(await r(async()=>{const{FlowGraphGetPropertyBlock:t}=await import("./flowGraphGetPropertyBlock-CAOmAIk8.js");return{FlowGraphGetPropertyBlock:t}},__vite__mapDeps([65,1,2,3,4,5,42,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGetPropertyBlock;case"FlowGraphSetPropertyBlock":return async()=>(await r(async()=>{const{FlowGraphSetPropertyBlock:t}=await import("./flowGraphSetPropertyBlock-DxJBj-a9.js");return{FlowGraphSetPropertyBlock:t}},__vite__mapDeps([66,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSetPropertyBlock;case"FlowGraphGetVariableBlock":return async()=>(await r(async()=>{const{FlowGraphGetVariableBlock:t}=await import("./flowGraphGetVariableBlock-BaRkHNJ_.js");return{FlowGraphGetVariableBlock:t}},__vite__mapDeps([67,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGetVariableBlock;case"FlowGraphSetVariableBlock":return async()=>(await r(async()=>{const{FlowGraphSetVariableBlock:t}=await import("./flowGraphSetVariableBlock-BG0Kfa6g.js");return{FlowGraphSetVariableBlock:t}},__vite__mapDeps([68,4,1,2,3,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphSetVariableBlock;case"FlowGraphJsonPointerParserBlock":return async()=>(await r(async()=>{const{FlowGraphJsonPointerParserBlock:t}=await import("./flowGraphJsonPointerParserBlock-CZ93bSRG.js");return{FlowGraphJsonPointerParserBlock:t}},__vite__mapDeps([69,1,2,3,4,5,42,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphJsonPointerParserBlock;case"FlowGraphLeadingZerosBlock":return async()=>(await r(async()=>{const{FlowGraphLeadingZerosBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphLeadingZerosBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphLeadingZerosBlock;case"FlowGraphTrailingZerosBlock":return async()=>(await r(async()=>{const{FlowGraphTrailingZerosBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphTrailingZerosBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTrailingZerosBlock;case"FlowGraphOneBitsCounterBlock":return async()=>(await r(async()=>{const{FlowGraphOneBitsCounterBlock:t}=await import("./flowGraphMathBlocks-HeZhspxf.js");return{FlowGraphOneBitsCounterBlock:t}},__vite__mapDeps([40,4,1,2,3,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphOneBitsCounterBlock;case"FlowGraphCombineVector2Block":return async()=>(await r(async()=>{const{FlowGraphCombineVector2Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphCombineVector2Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCombineVector2Block;case"FlowGraphCombineVector3Block":return async()=>(await r(async()=>{const{FlowGraphCombineVector3Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphCombineVector3Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCombineVector3Block;case"FlowGraphCombineVector4Block":return async()=>(await r(async()=>{const{FlowGraphCombineVector4Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphCombineVector4Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCombineVector4Block;case"FlowGraphCombineMatrixBlock":return async()=>(await r(async()=>{const{FlowGraphCombineMatrixBlock:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphCombineMatrixBlock:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCombineMatrixBlock;case"FlowGraphExtractVector2Block":return async()=>(await r(async()=>{const{FlowGraphExtractVector2Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphExtractVector2Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphExtractVector2Block;case"FlowGraphExtractVector3Block":return async()=>(await r(async()=>{const{FlowGraphExtractVector3Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphExtractVector3Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphExtractVector3Block;case"FlowGraphExtractVector4Block":return async()=>(await r(async()=>{const{FlowGraphExtractVector4Block:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphExtractVector4Block:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphExtractVector4Block;case"FlowGraphExtractMatrixBlock":return async()=>(await r(async()=>{const{FlowGraphExtractMatrixBlock:t}=await import("./flowGraphMathCombineExtractBlocks-Dg02KNQM.js");return{FlowGraphExtractMatrixBlock:t}},__vite__mapDeps([70,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphExtractMatrixBlock;case"FlowGraphTransformVectorBlock":return async()=>(await r(async()=>{const{FlowGraphTransformBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphTransformBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTransformBlock;case"FlowGraphTransformCoordinatesBlock":return async()=>(await r(async()=>{const{FlowGraphTransformCoordinatesBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphTransformCoordinatesBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphTransformCoordinatesBlock;case"FlowGraphConjugateBlock":return async()=>(await r(async()=>{const{FlowGraphConjugateBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphConjugateBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphConjugateBlock;case"FlowGraphAngleBetweenBlock":return async()=>(await r(async()=>{const{FlowGraphAngleBetweenBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphAngleBetweenBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAngleBetweenBlock;case"FlowGraphQuaternionFromAxisAngleBlock":return async()=>(await r(async()=>{const{FlowGraphQuaternionFromAxisAngleBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphQuaternionFromAxisAngleBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphQuaternionFromAxisAngleBlock;case"FlowGraphAxisAngleFromQuaternionBlock":return async()=>(await r(async()=>{const{FlowGraphAxisAngleFromQuaternionBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphAxisAngleFromQuaternionBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphAxisAngleFromQuaternionBlock;case"FlowGraphQuaternionFromDirectionsBlock":return async()=>(await r(async()=>{const{FlowGraphQuaternionFromDirectionsBlock:t}=await import("./flowGraphVectorMathBlocks-BGV5dKz9.js");return{FlowGraphQuaternionFromDirectionsBlock:t}},__vite__mapDeps([44,1,2,3,4,5,41,42,43,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphQuaternionFromDirectionsBlock;case"FlowGraphMatrixDecompose":return async()=>(await r(async()=>{const{FlowGraphMatrixDecomposeBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphMatrixDecomposeBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMatrixDecomposeBlock;case"FlowGraphMatrixCompose":return async()=>(await r(async()=>{const{FlowGraphMatrixComposeBlock:t}=await import("./flowGraphMatrixMathBlocks-Dg7VLPFP.js");return{FlowGraphMatrixComposeBlock:t}},__vite__mapDeps([45,1,2,3,4,5,43,42,41,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphMatrixComposeBlock;case"FlowGraphBooleanToFloat":return async()=>(await r(async()=>{const{FlowGraphBooleanToFloat:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphBooleanToFloat:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBooleanToFloat;case"FlowGraphBooleanToInt":return async()=>(await r(async()=>{const{FlowGraphBooleanToInt:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphBooleanToInt:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBooleanToInt;case"FlowGraphFloatToBoolean":return async()=>(await r(async()=>{const{FlowGraphFloatToBoolean:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphFloatToBoolean:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFloatToBoolean;case"FlowGraphIntToBoolean":return async()=>(await r(async()=>{const{FlowGraphIntToBoolean:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphIntToBoolean:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphIntToBoolean;case"FlowGraphIntToFloat":return async()=>(await r(async()=>{const{FlowGraphIntToFloat:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphIntToFloat:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphIntToFloat;case"FlowGraphFloatToInt":return async()=>(await r(async()=>{const{FlowGraphFloatToInt:t}=await import("./flowGraphTypeToTypeBlocks-DdLy9OXZ.js");return{FlowGraphFloatToInt:t}},__vite__mapDeps([71,43,42,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFloatToInt;case"FlowGraphEasingBlock":return async()=>(await r(async()=>{const{FlowGraphEasingBlock:t}=await import("./flowGraphEasingBlock-C_-3ZhLh.js");return{FlowGraphEasingBlock:t}},__vite__mapDeps([72,73,74,4,3,1,2,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphEasingBlock;case"FlowGraphBezierCurveEasing":return async()=>(await r(async()=>{const{FlowGraphBezierCurveEasingBlock:t}=await import("./flowGraphBezierCurveEasingBlock--1XIKCm2.js");return{FlowGraphBezierCurveEasingBlock:t}},__vite__mapDeps([75,73,74,4,3,1,2,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphBezierCurveEasingBlock;case"FlowGraphPointerOverEventBlock":return async()=>(await r(async()=>{const{FlowGraphPointerOverEventBlock:t}=await import("./flowGraphPointerOverEventBlock-wKWlgMPO.js");return{FlowGraphPointerOverEventBlock:t}},__vite__mapDeps([76,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphPointerOverEventBlock;case"FlowGraphPointerOutEventBlock":return async()=>(await r(async()=>{const{FlowGraphPointerOutEventBlock:t}=await import("./flowGraphPointerOutEventBlock-BpW1yJKn.js");return{FlowGraphPointerOutEventBlock:t}},__vite__mapDeps([77,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphPointerOutEventBlock;case"FlowGraphContextBlock":return async()=>(await r(async()=>{const{FlowGraphContextBlock:t}=await import("./flowGraphContextBlock-DeEwvFEY.js");return{FlowGraphContextBlock:t}},__vite__mapDeps([78,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphContextBlock;case"FlowGraphArrayIndexBlock":return async()=>(await r(async()=>{const{FlowGraphArrayIndexBlock:t}=await import("./flowGraphArrayIndexBlock-3XRt4h8L.js");return{FlowGraphArrayIndexBlock:t}},__vite__mapDeps([79,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphArrayIndexBlock;case"FlowGraphCodeExecutionBlock":return async()=>(await r(async()=>{const{FlowGraphCodeExecutionBlock:t}=await import("./flowGraphCodeExecutionBlock-BpjYYwgf.js");return{FlowGraphCodeExecutionBlock:t}},__vite__mapDeps([80,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphCodeExecutionBlock;case"FlowGraphIndexOfBlock":return async()=>(await r(async()=>{const{FlowGraphIndexOfBlock:t}=await import("./flowGraphIndexOfBlock-D1XW4kc4.js");return{FlowGraphIndexOfBlock:t}},__vite__mapDeps([81,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphIndexOfBlock;case"FlowGraphFunctionReference":return async()=>(await r(async()=>{const{FlowGraphFunctionReferenceBlock:t}=await import("./flowGraphFunctionReferenceBlock-CLhl7P_Q.js");return{FlowGraphFunctionReferenceBlock:t}},__vite__mapDeps([82,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphFunctionReferenceBlock;case"FlowGraphDataSwitchBlock":return async()=>(await r(async()=>{const{FlowGraphDataSwitchBlock:t}=await import("./flowGraphDataSwitchBlock-BUqG5JEg.js");return{FlowGraphDataSwitchBlock:t}},__vite__mapDeps([83,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphDataSwitchBlock;default:if(j[a])return j[a];throw new Error(`Unknown block name ${a}`)}}class Jt extends J{constructor(t){super(t),this.out=this._registerSignalOutput("out")}}class Zt extends Jt{constructor(t,e){if(super(t),this._eventsSignalOutputs={},this.done=this._registerSignalOutput("done"),e)for(const o of e)this._eventsSignalOutputs[o]=this._registerSignalOutput(o+"Event")}_executeOnTick(t){}_startPendingTasks(t){t._getExecutionVariable(this,"_initialized",!1)&&(this._cancelPendingTasks(t),this._resetAfterCanceled(t)),this._preparePendingTasks(t),t._addPendingBlock(this),this.out._activateSignal(t),t._setExecutionVariable(this,"_initialized",!0)}_resetAfterCanceled(t){t._deleteExecutionVariable(this,"_initialized"),t._removePendingBlock(this)}}class Xt extends Zt{constructor(){super(...arguments),this.initPriority=0,this.type="NoTrigger"}_execute(t){t._notifyExecuteNode(this),this.done._activateSignal(t)}}function Yt(a,t){for(const e of a)for(const o of e.dataOutputs)if(o.uniqueId===t)return o;throw new Error("Could not find data out connection with unique id "+t)}function zt(a,t){for(const e of a)if(e instanceof J){for(const o of e.signalInputs)if(o.uniqueId===t)return o}throw new Error("Could not find signal in connection with unique id "+t)}async function jt(a,t){const e=await Promise.all(a.allBlocks.map(async o=>await Ht(o.className)()));return te(a,t,e)}function te(a,t,e){const o=t.coordinator.createGraph(),n=[],s=t.valueParseFunction??H;for(let i=0;i<a.allBlocks.length;i++){const c=a.allBlocks[i],l=oe(c,{scene:t.coordinator.config.scene,pathConverter:t.pathConverter,assetsContainer:t.coordinator.config.scene,valueParseFunction:s},e[i]);n.push(l),l instanceof Xt&&o.addEventBlock(l)}for(const i of n){for(const c of i.dataInputs)for(const l of c.connectedPointIds){const u=Yt(n,l);c.connectTo(u)}if(i instanceof J)for(const c of i.signalOutputs)for(const l of c.connectedPointIds){const u=zt(n,l);c.connectTo(u)}}for(const i of a.executionContexts)ee(i,{graph:o,valueParseFunction:s},a.rightHanded);return o}function ee(a,t,e){var i,c,l,u,m,f,A,R,L,S;const o=t.graph.createContext();a.enableLogging&&(o.enableLogging=!0),o.treatDataAsRightHanded=e||!1;const n=t.valueParseFunction??H;o.uniqueId=a.uniqueId;const s=o.getScene();if(a._assetsContext){const p=a._assetsContext,v={meshes:(i=p.meshes)==null?void 0:i.map(h=>s.getMeshById(h)),lights:(c=p.lights)==null?void 0:c.map(h=>s.getLightByName(h)),cameras:(l=p.cameras)==null?void 0:l.map(h=>s.getCameraByName(h)),materials:(u=p.materials)==null?void 0:u.map(h=>s.getMaterialById(h)),textures:(m=p.textures)==null?void 0:m.map(h=>s.getTextureByName(h)),animations:(f=p.animations)==null?void 0:f.map(h=>s.animations.find(Q=>Q.name===h)),skeletons:(A=p.skeletons)==null?void 0:A.map(h=>s.getSkeletonByName(h)),particleSystems:(R=p.particleSystems)==null?void 0:R.map(h=>s.getParticleSystemById(h)),animationGroups:(L=p.animationGroups)==null?void 0:L.map(h=>s.getAnimationGroupByName(h)),transformNodes:(S=p.transformNodes)==null?void 0:S.map(h=>s.getTransformNodeById(h)),rootNodes:[],multiMaterials:[],morphTargetManagers:[],geometries:[],actionManagers:[],environmentTexture:null,postProcesses:[],sounds:null,effectLayers:[],layers:[],reflectionProbes:[],lensFlareSystems:[],proceduralTextures:[],getNodes:function(){throw new Error("Function not implemented.")}};o.assetsContext=v}for(const p in a._userVariables){const v=n(p,a._userVariables,o.assetsContext,s);o.userVariables[p]=v}for(const p in a._connectionValues){const v=n(p,a._connectionValues,o.assetsContext,s);o._setConnectionValueByKey(p,v)}return o}function oe(a,t,e){const o={},n=t.valueParseFunction??H;if(a.config)for(const i in a.config)o[i]=n(i,a.config,t.assetsContainer||t.scene,t.scene);if(Nt(a.className)){if(!t.pathConverter)throw new Error("Path converter is required for this block");o.pathConverter=t.pathConverter}const s=new e(o);s.uniqueId=a.uniqueId;for(let i=0;i<a.dataInputs.length;i++){const c=s.getDataInput(a.dataInputs[i].name);if(c)c.deserialize(a.dataInputs[i]);else throw new Error("Could not find data input with name "+a.dataInputs[i].name+" in block "+a.className)}for(let i=0;i<a.dataOutputs.length;i++){const c=s.getDataOutput(a.dataOutputs[i].name);if(c)c.deserialize(a.dataOutputs[i]);else throw new Error("Could not find data output with name "+a.dataOutputs[i].name+" in block "+a.className)}return s.metadata=a.metadata,s.deserialize&&s.deserialize(a),s}const ne={float:{length:1,flowGraphType:"number",elementType:"number"},bool:{length:1,flowGraphType:"boolean",elementType:"boolean"},float2:{length:2,flowGraphType:"Vector2",elementType:"number"},float3:{length:3,flowGraphType:"Vector3",elementType:"number"},float4:{length:4,flowGraphType:"Vector4",elementType:"number"},float4x4:{length:16,flowGraphType:"Matrix",elementType:"number"},float2x2:{length:4,flowGraphType:"Matrix2D",elementType:"number"},float3x3:{length:9,flowGraphType:"Matrix3D",elementType:"number"},int:{length:1,flowGraphType:"FlowGraphInteger",elementType:"number"}};class ae{constructor(t,e,o=60){this._interactivityGraph=t,this._gltf=e,this._animationTargetFps=o,this._types=[],this._mappings=[],this._staticVariables=[],this._events=[],this._internalEventsCounter=0,this._nodes=[],this._parseTypes(),this._parseDeclarations(),this._parseVariables(),this._parseEvents(),this._parseNodes()}get arrays(){return{types:this._types,mappings:this._mappings,staticVariables:this._staticVariables,events:this._events,nodes:this._nodes}}_parseTypes(){if(this._interactivityGraph.types)for(const t of this._interactivityGraph.types)this._types.push(ne[t.signature])}_parseDeclarations(){if(this._interactivityGraph.declarations)for(const t of this._interactivityGraph.declarations){const e=bt(t);if(!e)throw w.Error(["No mapping found for declaration",t]),new Error("Error parsing declarations");this._mappings.push({flowGraphMapping:e,fullOperationName:t.extension?t.op+":"+t.extension:t.op})}}_parseVariables(){if(this._interactivityGraph.variables)for(const t of this._interactivityGraph.variables){const e=this._parseVariable(t);this._staticVariables.push(e)}}_parseVariable(t,e){const o=this._types[t.type];if(!o)throw w.Error(["No type found for variable",t]),new Error("Error parsing variables");if(t.value&&t.value.length!==o.length)throw w.Error(["Invalid value length for variable",t,o]),new Error("Error parsing variables");const n=t.value||[];if(!n.length)switch(o.flowGraphType){case"boolean":n.push(!1);break;case"FlowGraphInteger":n.push(0);break;case"number":n.push(NaN);break;case"Vector2":n.push(NaN,NaN);break;case"Vector3":n.push(NaN,NaN,NaN);break;case"Vector4":case"Matrix2D":case"Quaternion":n.fill(NaN,0,4);break;case"Matrix":n.fill(NaN,0,16);break;case"Matrix3D":n.fill(NaN,0,9);break}return o.elementType==="number"&&typeof n[0]=="string"&&(n[0]=parseFloat(n[0])),{type:o.flowGraphType,value:e?e(n,this):n}}_parseEvents(){if(this._interactivityGraph.events)for(const t of this._interactivityGraph.events){const e={eventId:t.id||"internalEvent_"+this._internalEventsCounter++};t.values&&(e.eventData=Object.keys(t.values).map(o=>{var c;const n=(c=t.values)==null?void 0:c[o];if(!n)throw w.Error(["No value found for event key",o]),new Error("Error parsing events");const s=this._types[n.type];if(!s)throw w.Error(["No type found for event value",n]),new Error("Error parsing events");const i=typeof n.value<"u"?this._parseVariable(n):void 0;return{id:o,type:s.flowGraphType,eventData:!0,value:i}})),this._events.push(e)}}_parseNodes(){var t;if(this._interactivityGraph.nodes)for(const e of this._interactivityGraph.nodes){if(typeof e.declaration!="number")throw w.Error(["No declaration found for node",e]),new Error("Error parsing nodes");const o=this._mappings[e.declaration];if(!o)throw w.Error(["No mapping found for node",e]),new Error("Error parsing nodes");if(o.flowGraphMapping.validation){const s=o.flowGraphMapping.validation(e,this._interactivityGraph,this._gltf);if(!s.valid)throw new Error(`Error validating interactivity node ${(t=this._interactivityGraph.declarations)==null?void 0:t[e.declaration].op} - ${s.error}`)}const n=[];for(const s of o.flowGraphMapping.blocks){const i=this._getEmptyBlock(s,o.fullOperationName);this._parseNodeConfiguration(e,i,o.flowGraphMapping,s),n.push(i)}this._nodes.push({blocks:n,fullOperationName:o.fullOperationName})}}_getEmptyBlock(t,e){return{uniqueId:D(),className:t,dataInputs:[],dataOutputs:[],signalInputs:[],signalOutputs:[],config:{},type:e,metadata:{}}}_parseNodeConfiguration(t,e,o,n){var i;const s=t.configuration;if(s)for(const c in s){const l=s[c];if(!l)throw new Error("Error parsing node configuration");const u=(i=o.configuration)==null?void 0:i[c];if(u&&u.toBlock?u.toBlock===n:o.blocks.indexOf(n)===0){let f=u==null?void 0:u.defaultValue;l!=null&&l.value&&(f=l.value),u!=null&&u.isArray||(f.length!==1&&w.Warn(`Invalid non-array value length: ${f.length}`),f=f[0]),u!=null&&u.dataTransformer&&(f=u.dataTransformer(f,this)),f!==void 0&&(e.config[(u==null?void 0:u.name)||c]={value:f})}}}_parseNodeConnections(t){var e,o,n,s,i,c,l,u,m,f,A,R,L,S,p,v,h,Q,et;for(let N=0;N<this._nodes.length;N++){const I=(e=this._interactivityGraph.nodes)==null?void 0:e[N];if(!I)throw w.Error(["No node found for interactivity node",this._nodes[N]]),new Error("Error parsing node connections");const T=this._nodes[N],F=this._mappings[I.declaration];if(!F)throw w.Error(["No mapping found for node",I]),new Error("Error parsing node connections");const ot=I.flows||{},gt=Object.keys(ot).sort();for(const d of gt){const y=ot[d],_=(n=(o=F.flowGraphMapping.outputs)==null?void 0:o.flows)==null?void 0:n[d],x=(_==null?void 0:_.name)||d,M=this._createNewSocketConnection(x,!0);(_&&_.toBlock&&T.blocks.find(B=>B.className===_.toBlock)||T.blocks[0]).signalOutputs.push(M);const Z=y.node,g=this._nodes[Z];if(!g)throw w.Error(["No node found for input node id",Z]),new Error("Error parsing node connections");const V=at(g.fullOperationName);if(!V)throw w.Error(["No mapping found for input node",g]),new Error("Error parsing node connections");let k=(i=(s=V.inputs)==null?void 0:s.flows)==null?void 0:i[y.socket||"in"],P=!1;if(!k)for(const B in(c=V.inputs)==null?void 0:c.flows)B.startsWith("[")&&B.endsWith("]")&&(P=!0,k=(u=(l=V.inputs)==null?void 0:l.flows)==null?void 0:u[B]);const G=k?P?k.name.replace("$1",y.socket||""):k.name:y.socket||"in",$=k&&k.toBlock&&g.blocks.find(B=>B.className===k.toBlock)||g.blocks[0];let C=$.signalInputs.find(B=>B.name===G);C||(C=this._createNewSocketConnection(G),$.signalInputs.push(C)),C.connectedPointIds.push(M.uniqueId),M.connectedPointIds.push(C.uniqueId)}const nt=I.values||{},mt=Object.keys(nt);for(const d of mt){const y=nt[d];let _=(f=(m=F.flowGraphMapping.inputs)==null?void 0:m.values)==null?void 0:f[d],x=!1;if(!_)for(const g in(A=F.flowGraphMapping.inputs)==null?void 0:A.values)g.startsWith("[")&&g.endsWith("]")&&(x=!0,_=(L=(R=F.flowGraphMapping.inputs)==null?void 0:R.values)==null?void 0:L[g]);const M=_?x?_.name.replace("$1",d):_.name:d,q=this._createNewSocketConnection(M);if((_&&_.toBlock&&T.blocks.find(g=>g.className===_.toBlock)||T.blocks[0]).dataInputs.push(q),y.value!==void 0){const g=this._parseVariable(y,_&&_.dataTransformer);t._connectionValues[q.uniqueId]=g}else if(typeof y.node<"u"){const g=y.node,V=y.socket||"value",k=this._nodes[g];if(!k)throw w.Error(["No node found for output socket reference",y]),new Error("Error parsing node connections");const P=at(k.fullOperationName);if(!P)throw w.Error(["No mapping found for output socket reference",y]),new Error("Error parsing node connections");let G=(p=(S=P.outputs)==null?void 0:S.values)==null?void 0:p[V],$=!1;if(!G)for(const b in(v=P.outputs)==null?void 0:v.values)b.startsWith("[")&&b.endsWith("]")&&($=!0,G=(Q=(h=P.outputs)==null?void 0:h.values)==null?void 0:Q[b]);const C=G?$?G.name.replace("$1",V):G==null?void 0:G.name:V,B=G&&G.toBlock&&k.blocks.find(b=>b.className===G.toBlock)||k.blocks[0];let K=B.dataOutputs.find(b=>b.name===C);K||(K=this._createNewSocketConnection(C,!0),B.dataOutputs.push(K)),q.connectedPointIds.push(K.uniqueId),K.connectedPointIds.push(q.uniqueId)}else throw w.Error(["Invalid value for value connection",y]),new Error("Error parsing node connections")}if(F.flowGraphMapping.interBlockConnectors)for(const d of F.flowGraphMapping.interBlockConnectors){const y=d.input,_=d.output,x=d.isVariable;this._connectFlowGraphNodes(y,_,T.blocks[d.inputBlockIndex],T.blocks[d.outputBlockIndex],x)}if(F.flowGraphMapping.extraProcessor){const d=(et=this._interactivityGraph.declarations)==null?void 0:et[I.declaration];if(!d)throw w.Error(["No declaration found for extra processor",I]),new Error("Error parsing node connections");T.blocks=F.flowGraphMapping.extraProcessor(I,d,F.flowGraphMapping,this,T.blocks,t,this._gltf)}}}_createNewSocketConnection(t,e){return{uniqueId:D(),name:t,_connectionType:e?1:0,connectedPointIds:[]}}_connectFlowGraphNodes(t,e,o,n,s){const i=s?o.dataInputs:o.signalInputs,c=s?n.dataOutputs:n.signalOutputs,l=i.find(m=>m.name===t)||this._createNewSocketConnection(t),u=c.find(m=>m.name===e)||this._createNewSocketConnection(e,!0);i.find(m=>m.name===t)||i.push(l),c.find(m=>m.name===e)||c.push(u),l.connectedPointIds.push(u.uniqueId),u.connectedPointIds.push(l.uniqueId)}getVariableName(t){return"staticVariable_"+t}serializeToFlowGraph(){const t={uniqueId:D(),_userVariables:{},_connectionValues:{}};this._parseNodeConnections(t);for(let o=0;o<this._staticVariables.length;o++){const n=this._staticVariables[o];t._userVariables[this.getVariableName(o)]=n}return{rightHanded:!0,allBlocks:this._nodes.reduce((o,n)=>o.concat(n.blocks),[]),executionContexts:[t]}}}const W="KHR_interactivity";class ft{constructor(t){this._loader=t,this.name=W,this.enabled=this._loader.isExtensionUsed(W),this._pathConverter=Dt(this._loader.gltf),t._skipStartAnimationStep=!0;const e=t.babylonScene;e&&yt(e)}dispose(){this._loader=null,delete this._pathConverter}async onReady(){var s;if(!this._loader.babylonScene||!this._pathConverter)return;const t=this._loader.babylonScene,e=(s=this._loader.gltf.extensions)==null?void 0:s.KHR_interactivity;if(!e)return;const o=new E({scene:t});o.dispatchEventsSynchronously=!1;const n=e.graphs.map(i=>new ae(i,this._loader.gltf,this._loader.parent.targetFps).serializeToFlowGraph());await Promise.all(n.map(async i=>await jt(i,{coordinator:o,pathConverter:this._pathConverter}))),o.start()}}function yt(a){O("/extensions/KHR_interactivity/?/activeCamera/rotation",{get:()=>{if(!a.activeCamera)return new X(NaN,NaN,NaN,NaN);const t=X.FromRotationMatrix(a.activeCamera.getWorldMatrix()).normalize();return a.useRightHandedSystem||(t.w*=-1,t.x*=-1),t},type:"Quaternion",getTarget:()=>a.activeCamera}),O("/extensions/KHR_interactivity/?/activeCamera/position",{get:()=>{if(!a.activeCamera)return new ut(NaN,NaN,NaN);const t=a.activeCamera.getWorldMatrix().getTranslation();return a.useRightHandedSystem||(t.x*=-1),t},type:"Vector3",getTarget:()=>a.activeCamera}),O("/animations/{}/extensions/KHR_interactivity/isPlaying",{get:t=>{var e;return((e=t._babylonAnimationGroup)==null?void 0:e.isPlaying)??!1},type:"boolean",getTarget:t=>t._babylonAnimationGroup}),O("/animations/{}/extensions/KHR_interactivity/minTime",{get:t=>{var e;return(((e=t._babylonAnimationGroup)==null?void 0:e.from)??0)/60},type:"number",getTarget:t=>t._babylonAnimationGroup}),O("/animations/{}/extensions/KHR_interactivity/maxTime",{get:t=>{var e;return(((e=t._babylonAnimationGroup)==null?void 0:e.to)??0)/60},type:"number",getTarget:t=>t._babylonAnimationGroup}),O("/animations/{}/extensions/KHR_interactivity/playhead",{get:t=>{var e;return(((e=t._babylonAnimationGroup)==null?void 0:e.getCurrentFrame())??0)/60},type:"number",getTarget:t=>t._babylonAnimationGroup}),O("/animations/{}/extensions/KHR_interactivity/virtualPlayhead",{get:t=>{var e;return(((e=t._babylonAnimationGroup)==null?void 0:e.getCurrentFrame())??0)/60},type:"number",getTarget:t=>t._babylonAnimationGroup})}Qt(W,"FlowGraphGLTFDataProvider",async()=>(await r(async()=>{const{FlowGraphGLTFDataProvider:a}=await import("./flowGraphGLTFDataProvider-By82y__G.js");return{FlowGraphGLTFDataProvider:a}},__vite__mapDeps([84,1,2,3,4,5,23,24,9,21,25,26,13,12,14,15,16,17,18,19,20,22,27,28,8,29,30,31,10]))).FlowGraphGLTFDataProvider);Ot(W);xt(W,!0,a=>new ft(a));const ke=Object.freeze(Object.defineProperty({__proto__:null,KHR_interactivity:ft,_AddInteractivityObjectModel:yt},Symbol.toStringTag,{value:"Module"}));export{$t as F,Mt as G,ke as K,dt as _,Zt as a,Jt as b,Xt as c,E as d,de as e,fe as f,Wt as g,ye as h,me as i,ge as j,J as k,tt as l};

trackio/frontend/dist/assets/KHR_lights_punctual-CCzRzwty.js

@@ -0,0 +1 @@
+import{M as x,V as h}from"./math.vector-C1xyPDEl.js";import{Color3 as b}from"./math.color-CzLaKyb6.js";import{_ as d,s as u}from"./bufferUtils-DTRdUD8L.js";import{N as T}from"./node-C-Iu0ALa.js";import{L as S}from"./light-DT53MGnW.js";import{b as E,c as v}from"./objectModelMapping-DWcnlpHl.js";import{R as Z}from"./math.scalar.functions-DkeaWAWz.js";import{A as D,G as M}from"./glTFLoader-BPeiodqB.js";import{u as C,r as R}from"./dynamic-BUKysMyT.js";import"./decorators.serialization-C7d7ykGG.js";import"./lightConstants-B1TSTh-k.js";import"./tools-D01N7ptR.js";import"./math.axis-Ck7JfPPj.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./math.plane-Ce_75-g5.js";import"./index-Bx1QoKVU.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./material-CrEsrP1R.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";T.AddNodeConstructor("Light_Type_1",(m,t)=>()=>new a(m,h.Zero(),t));class a extends E{get shadowFrustumSize(){return this._shadowFrustumSize}set shadowFrustumSize(t){this._shadowFrustumSize=t,this.forceProjectionMatrixCompute()}get shadowOrthoScale(){return this._shadowOrthoScale}set shadowOrthoScale(t){this._shadowOrthoScale=t,this.forceProjectionMatrixCompute()}get orthoLeft(){return this._orthoLeft}set orthoLeft(t){this._orthoLeft=t}get orthoRight(){return this._orthoRight}set orthoRight(t){this._orthoRight=t}get orthoTop(){return this._orthoTop}set orthoTop(t){this._orthoTop=t}get orthoBottom(){return this._orthoBottom}set orthoBottom(t){this._orthoBottom=t}constructor(t,o,e,i){super(t,e,i),this._shadowFrustumSize=0,this._shadowOrthoScale=.1,this.autoUpdateExtends=!0,this.autoCalcShadowZBounds=!1,this._orthoLeft=Number.MAX_VALUE,this._orthoRight=Number.MIN_VALUE,this._orthoTop=Number.MIN_VALUE,this._orthoBottom=Number.MAX_VALUE,this.position=o.scale(-1),this.direction=o}getClassName(){return"DirectionalLight"}getTypeID(){return S.LIGHTTYPEID_DIRECTIONALLIGHT}_setDefaultShadowProjectionMatrix(t,o,e){this.shadowFrustumSize>0?this._setDefaultFixedFrustumShadowProjectionMatrix(t):this._setDefaultAutoExtendShadowProjectionMatrix(t,o,e)}_setDefaultFixedFrustumShadowProjectionMatrix(t){const o=this.getScene().activeCamera;x.OrthoLHToRef(this.shadowFrustumSize,this.shadowFrustumSize,this.shadowMinZ!==void 0?this.shadowMinZ:o?o.minZ:0,this.shadowMaxZ!==void 0?this.shadowMaxZ:o?o.maxZ:1e4,t,this.getScene().getEngine().isNDCHalfZRange)}_setDefaultAutoExtendShadowProjectionMatrix(t,o,e){const i=this.getScene().activeCamera;if(this.autoUpdateExtends||this._orthoLeft===Number.MAX_VALUE){const r=h.Zero();this._orthoLeft=Number.MAX_VALUE,this._orthoRight=-Number.MAX_VALUE,this._orthoTop=-Number.MAX_VALUE,this._orthoBottom=Number.MAX_VALUE;let g=Number.MAX_VALUE,L=-Number.MAX_VALUE;for(let w=0;w<e.length;w++){const A=e[w];if(!A)continue;const B=A.getBoundingInfo().boundingBox;for(let y=0;y<B.vectorsWorld.length;y++)h.TransformCoordinatesToRef(B.vectorsWorld[y],o,r),r.x<this._orthoLeft&&(this._orthoLeft=r.x),r.y<this._orthoBottom&&(this._orthoBottom=r.y),r.x>this._orthoRight&&(this._orthoRight=r.x),r.y>this._orthoTop&&(this._orthoTop=r.y),this.autoCalcShadowZBounds&&(r.z<g&&(g=r.z),r.z>L&&(L=r.z))}this.autoCalcShadowZBounds&&(this._shadowMinZ=g,this._shadowMaxZ=L)}const c=this._orthoRight-this._orthoLeft,f=this._orthoTop-this._orthoBottom,s=this.shadowMinZ!==void 0?this.shadowMinZ:(i==null?void 0:i.minZ)||0,n=this.shadowMaxZ!==void 0?this.shadowMaxZ:(i==null?void 0:i.maxZ)||1e4,l=this.getScene().getEngine().useReverseDepthBuffer;x.OrthoOffCenterLHToRef(this._orthoLeft-c*this.shadowOrthoScale,this._orthoRight+c*this.shadowOrthoScale,this._orthoBottom-f*this.shadowOrthoScale,this._orthoTop+f*this.shadowOrthoScale,l?n:s,l?s:n,t,this.getScene().getEngine().isNDCHalfZRange)}_buildUniformLayout(){this._uniformBuffer.addUniform("vLightData",4),this._uniformBuffer.addUniform("vLightDiffuse",4),this._uniformBuffer.addUniform("vLightSpecular",4),this._uniformBuffer.addUniform("shadowsInfo",3),this._uniformBuffer.addUniform("depthValues",2),this._uniformBuffer.create()}transferToEffect(t,o){return this.computeTransformedInformation()?(this._uniformBuffer.updateFloat4("vLightData",this.transformedDirection.x,this.transformedDirection.y,this.transformedDirection.z,1,o),this):(this._uniformBuffer.updateFloat4("vLightData",this.direction.x,this.direction.y,this.direction.z,1,o),this)}transferToNodeMaterialEffect(t,o){return this.computeTransformedInformation()?(t.setFloat3(o,this.transformedDirection.x,this.transformedDirection.y,this.transformedDirection.z),this):(t.setFloat3(o,this.direction.x,this.direction.y,this.direction.z),this)}getDepthMinZ(t){const o=this._scene.getEngine();return!o.useReverseDepthBuffer&&o.isNDCHalfZRange?0:1}getDepthMaxZ(t){const o=this._scene.getEngine();return o.useReverseDepthBuffer&&o.isNDCHalfZRange?0:1}prepareLightSpecificDefines(t,o){t["DIRLIGHT"+o]=!0}}d([u()],a.prototype,"shadowFrustumSize",null);d([u()],a.prototype,"shadowOrthoScale",null);d([u()],a.prototype,"autoUpdateExtends",void 0);d([u()],a.prototype,"autoCalcShadowZBounds",void 0);d([u("orthoLeft")],a.prototype,"_orthoLeft",void 0);d([u("orthoRight")],a.prototype,"_orthoRight",void 0);d([u("orthoTop")],a.prototype,"_orthoTop",void 0);d([u("orthoBottom")],a.prototype,"_orthoBottom",void 0);Z("BABYLON.DirectionalLight",a);T.AddNodeConstructor("Light_Type_0",(m,t)=>()=>new _(m,h.Zero(),t));class _ extends E{get shadowAngle(){return this._shadowAngle}set shadowAngle(t){this._shadowAngle=t,this.forceProjectionMatrixCompute()}get direction(){return this._direction}set direction(t){const o=this.needCube();if(this._direction=t,this.needCube()!==o&&this._shadowGenerators){const e=this._shadowGenerators.values();for(let i=e.next();i.done!==!0;i=e.next())i.value.recreateShadowMap()}}constructor(t,o,e,i){super(t,e,i),this._shadowAngle=Math.PI/2,this.position=o}getClassName(){return"PointLight"}getTypeID(){return S.LIGHTTYPEID_POINTLIGHT}needCube(){return!this.direction}getShadowDirection(t){if(this.direction)return super.getShadowDirection(t);switch(t){case 0:return new h(1,0,0);case 1:return new h(-1,0,0);case 2:return new h(0,-1,0);case 3:return new h(0,1,0);case 4:return new h(0,0,1);case 5:return new h(0,0,-1)}return h.Zero()}_setDefaultShadowProjectionMatrix(t,o,e){const i=this.getScene().activeCamera,c=this.getDepthMinZ(i),f=this.getDepthMaxZ(i),s=this.getScene().getEngine().useReverseDepthBuffer;x.PerspectiveFovLHToRef(this.shadowAngle,1,s?f:c,s?c:f,t,!0,this._scene.getEngine().isNDCHalfZRange,void 0,s)}_buildUniformLayout(){this._uniformBuffer.addUniform("vLightData",4),this._uniformBuffer.addUniform("vLightDiffuse",4),this._uniformBuffer.addUniform("vLightSpecular",4),this._uniformBuffer.addUniform("vLightFalloff",4),this._uniformBuffer.addUniform("shadowsInfo",3),this._uniformBuffer.addUniform("depthValues",2),this._uniformBuffer.create()}transferToEffect(t,o){const e=this._scene.floatingOriginOffset;return this.computeTransformedInformation()?this._uniformBuffer.updateFloat4("vLightData",this.transformedPosition.x-e.x,this.transformedPosition.y-e.y,this.transformedPosition.z-e.z,0,o):this._uniformBuffer.updateFloat4("vLightData",this.position.x-e.x,this.position.y-e.y,this.position.z-e.z,0,o),this._uniformBuffer.updateFloat4("vLightFalloff",this.range,this._inverseSquaredRange,0,0,o),this}transferToNodeMaterialEffect(t,o){const e=this._scene.floatingOriginOffset;return this.computeTransformedInformation()?t.setFloat3(o,this.transformedPosition.x-e.x,this.transformedPosition.y-e.y,this.transformedPosition.z-e.z):t.setFloat3(o,this.position.x-e.x,this.position.y-e.y,this.position.z-e.z),this}prepareLightSpecificDefines(t,o){t["POINTLIGHT"+o]=!0}}d([u()],_.prototype,"shadowAngle",null);Z("BABYLON.PointLight",_);const p="KHR_lights_punctual";class N{constructor(t){this.name=p,this._loader=t,this.enabled=this._loader.isExtensionUsed(p)}dispose(){this._loader=null,delete this._lights}onLoading(){const t=this._loader.gltf.extensions;if(t&&t[this.name]){const o=t[this.name];this._lights=o.lights,D.Assign(this._lights)}}loadNodeAsync(t,o,e){return M.LoadExtensionAsync(t,o,this.name,async(i,c)=>(this._loader._allMaterialsDirtyRequired=!0,await this._loader.loadNodeAsync(t,o,f=>{let s;const n=D.Get(i,this._lights,c.light),l=n.name||f.name;switch(this._loader.babylonScene._blockEntityCollection=!!this._loader._assetContainer,n.type){case"directional":{const r=new a(l,h.Backward(),this._loader.babylonScene);r.position.setAll(0),s=r;break}case"point":{s=new _(l,h.Zero(),this._loader.babylonScene);break}case"spot":{const r=new v(l,h.Zero(),h.Backward(),0,1,this._loader.babylonScene);r.angle=(n.spot&&n.spot.outerConeAngle||Math.PI/4)*2,r.innerAngle=(n.spot&&n.spot.innerConeAngle||0)*2,s=r;break}default:throw this._loader.babylonScene._blockEntityCollection=!1,new Error(`${i}: Invalid light type (${n.type})`)}s._parentContainer=this._loader._assetContainer,this._loader.babylonScene._blockEntityCollection=!1,n._babylonLight=s,s.falloffType=S.FALLOFF_GLTF,s.diffuse=n.color?b.FromArray(n.color):b.White(),s.intensity=n.intensity==null?1:n.intensity,s.range=n.range==null?Number.MAX_VALUE:n.range,s.parent=f,this._loader._babylonLights.push(s),M.AddPointerMetadata(s,i),e(f)})))}}C(p);R(p,!0,m=>new N(m));export{N as KHR_lights};

trackio/frontend/dist/assets/KHR_materials_anisotropy-DeuhwPRx.js

@@ -0,0 +1 @@
+import{G as l}from"./glTFLoader-BPeiodqB.js";import{u as d,r as c}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./math.color-CzLaKyb6.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const n="KHR_materials_anisotropy";class u{constructor(t){this.name=n,this.order=195,this._loader=t,this.enabled=this._loader.isExtensionUsed(n)}dispose(){this._loader=null}loadMaterialPropertiesAsync(t,o,i){return l.LoadExtensionAsync(t,o,this.name,async(r,e)=>{const s=new Array;s.push(this._loader.loadMaterialPropertiesAsync(t,o,i)),s.push(this._loadAnisotropyPropertiesAsync(r,e,i)),await Promise.all(s)})}async _loadAnisotropyPropertiesAsync(t,o,i){const r=this._loader._getOrCreateMaterialAdapter(i),e=new Array,s=o.anisotropyStrength??0,y=o.anisotropyRotation??0;r.specularRoughnessAnisotropy=s,r.geometryTangentAngle=y;const a=o.extensions??{};(!a.EXT_materials_anisotropy_openpbr||!a.EXT_materials_anisotropy_openpbr.openPbrAnisotropyEnabled)&&r.configureGltfStyleAnisotropy(!0),o.anisotropyTexture&&(o.anisotropyTexture.nonColorData=!0,e.push(this._loader.loadTextureInfoAsync(`${t}/anisotropyTexture`,o.anisotropyTexture,m=>{m.name=`${i.name} (Anisotropy Intensity)`,r.geometryTangentTexture=m}))),await Promise.all(e)}}d(n);c(n,!0,p=>new u(p));export{u as KHR_materials_anisotropy};

trackio/frontend/dist/assets/KHR_materials_clearcoat-CqejipXp.js

@@ -0,0 +1 @@
+import{G as n}from"./glTFLoader-BPeiodqB.js";import{u as l,r as u}from"./dynamic-BUKysMyT.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./math.color-CzLaKyb6.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const m="KHR_materials_clearcoat";class d{constructor(a){this.name=m,this.order=190,this._loader=a,this.enabled=this._loader.isExtensionUsed(m)}dispose(){this._loader=null}loadMaterialPropertiesAsync(a,o,r){return n.LoadExtensionAsync(a,o,this.name,async(t,s)=>{const e=new Array;e.push(this._loader.loadMaterialPropertiesAsync(a,o,r)),e.push(this._loadClearCoatPropertiesAsync(t,s,r)),await Promise.all(e)})}_loadClearCoatPropertiesAsync(a,o,r){const t=this._loader._getOrCreateMaterialAdapter(r),s=new Array;return t.configureCoat(),t.coatWeight=o.clearcoatFactor!==void 0?o.clearcoatFactor:0,t.coatRoughness=o.clearcoatRoughnessFactor!==void 0?o.clearcoatRoughnessFactor:0,o.clearcoatTexture&&s.push(this._loader.loadTextureInfoAsync(`${a}/clearcoatTexture`,o.clearcoatTexture,e=>{e.name=`${r.name} (ClearCoat)`,t.coatWeightTexture=e})),o.clearcoatRoughnessTexture&&(o.clearcoatRoughnessTexture.nonColorData=!0,s.push(this._loader.loadTextureInfoAsync(`${a}/clearcoatRoughnessTexture`,o.clearcoatRoughnessTexture,e=>{e.name=`${r.name} (ClearCoat Roughness)`,t.coatRoughnessTexture=e}))),o.clearcoatNormalTexture&&(o.clearcoatNormalTexture.nonColorData=!0,s.push(this._loader.loadTextureInfoAsync(`${a}/clearcoatNormalTexture`,o.clearcoatNormalTexture,e=>{var c;e.name=`${r.name} (ClearCoat Normal)`,t.geometryCoatNormalTexture=e,((c=o.clearcoatNormalTexture)==null?void 0:c.scale)!=null&&(t.geometryCoatNormalTextureScale=o.clearcoatNormalTexture.scale)})),t.setNormalMapInversions(!r.getScene().useRightHandedSystem,r.getScene().useRightHandedSystem)),Promise.all(s).then(()=>{})}}l(m);u(m,!0,i=>new d(i));export{d as KHR_materials_clearcoat};

trackio/frontend/dist/assets/KHR_materials_coat-DOoUAE9E.js

@@ -0,0 +1 @@
+import{G as d}from"./glTFLoader-BPeiodqB.js";import{u as h,r as T}from"./dynamic-BUKysMyT.js";import{Color3 as g}from"./math.color-CzLaKyb6.js";import"./index-Bx1QoKVU.js";import"./math.vector-C1xyPDEl.js";import"./math.scalar.functions-DkeaWAWz.js";import"./tools-D01N7ptR.js";import"./decorators.serialization-C7d7ykGG.js";import"./bufferUtils-DTRdUD8L.js";import"./mesh-Fj-9677A.js";import"./mesh.vertexData-Cr3zcPIw.js";import"./buffer-DqKlo1ts.js";import"./dataBuffer-CgoqiUzT.js";import"./subMesh-UWDo5wjI.js";import"./drawWrapper-CZVk0xN-.js";import"./smartArray-CO6iJ0u5.js";import"./node-C-Iu0ALa.js";import"./math.viewport-CgkTt1RS.js";import"./sceneComponent-Dflhczui.js";import"./math.plane-Ce_75-g5.js";import"./lightConstants-B1TSTh-k.js";import"./sceneLoaderFlags-wywyb9ml.js";import"./math.axis-Ck7JfPPj.js";import"./material-CrEsrP1R.js";import"./texture-BEqhDl5Y.js";import"./baseTexture-CgAggsey.js";import"./drawWrapper.functions-Dzz0ghog.js";import"./cameraInputsManager-WrTH9PVf.js";import"./deviceInputEvents-BTza-zoR.js";import"./bone-B35odufe.js";import"./skeleton-BVUVDN0a.js";import"./rawTexture-Cp8_XuDs.js";import"./animation-IftAdLIx.js";import"./sceneLoader-CutT-qCn.js";import"./scene-gn_hoGMy.js";import"./renderingManager-CiY2OUrf.js";import"./perfCounter-DusmGz8t.js";import"./assetContainer-DOnbxwKX.js";import"./instancedMesh-Cz-e1Hca.js";import"./light-DT53MGnW.js";import"./objectModelMapping-DWcnlpHl.js";const i="KHR_materials_coat";class f{constructor(r){this.name=i,this.order=191,this.useOpenPBR=!1,this._loader=r,this.enabled=this._loader.isExtensionUsed(i)}dispose(){this._loader=null}loadMaterialPropertiesAsync(r,o,a){return d.LoadExtensionAsync(r,o,this.name,async(t,n)=>{const s=new Array;s.push(this._loader.loadMaterialPropertiesAsync(r,o,a)),o.extensions&&o.extensions.KHR_materials_openpbr&&(this.useOpenPBR=!0),s.push(this._loadCoatPropertiesAsync(t,n,a)),await Promise.all(s)})}_loadCoatPropertiesAsync(r,o,a){const t=this._loader._getOrCreateMaterialAdapter(a),n=new Array;t.configureCoat(),t.coatWeight=o.coatFactor!==void 0?o.coatFactor:0,t.coatRoughness=o.coatRoughnessFactor!==void 0?o.coatRoughnessFactor:0,o.coatTexture&&n.push(this._loader.loadTextureInfoAsync(`${r}/coatTexture`,o.coatTexture,e=>{e.name=`${a.name} (Coat)`,t.coatWeightTexture=e})),o.coatRoughnessTexture&&(o.coatRoughnessTexture.nonColorData=!0,n.push(this._loader.loadTextureInfoAsync(`${r}/coatRoughnessTexture`,o.coatRoughnessTexture,e=>{e.name=`${a.name} (Coat Roughness)`,t.coatRoughnessTexture=e}))),o.coatNormalTexture&&(o.coatNormalTexture.nonColorData=!0,n.push(this._loader.loadTextureInfoAsync(`${r}/coatNormalTexture`,o.coatNormalTexture,e=>{var m;e.name=`${a.name} (Coat Normal)`,t.geometryCoatNormalTexture=e,((m=o.coatNormalTexture)==null?void 0:m.scale)!=null&&(t.geometryCoatNormalTextureScale=o.coatNormalTexture.scale)})),t.setNormalMapInversions(!a.getScene().useRightHandedSystem,a.getScene().useRightHandedSystem)),t.coatDarkening=o.coatDarkeningFactor!==void 0?o.coatDarkeningFactor:1,t.coatIor=o.coatIor!==void 0?o.coatIor:1.5;const s=g.White();o.coatColorFactor!==void 0&&s.fromArray(o.coatColorFactor),t.coatColor=s,o.coatColorTexture&&n.push(this._loader.loadTextureInfoAsync(`${r}/coatColorTexture`,o.coatColorTexture,e=>{e.name=`${a.name} (Coat Color)`,t.coatColorTexture=e}));const u=o.coatAnisotropyStrength??0,l=o.coatAnisotropyRotation??0;return t.coatRoughnessAnisotropy=u,t.geometryCoatTangentAngle=l,this.useOpenPBR||t.configureGltfStyleAnisotropy(!0),o.coatAnisotropyTexture&&(o.coatAnisotropyTexture.nonColorData=!0,n.push(this._loader.loadTextureInfoAsync(`${r}/coatAnisotropyTexture`,o.coatAnisotropyTexture,e=>{e.name=`${a.name} (Coat Anisotropy)`,t.geometryCoatTangentTexture=e}))),Promise.all(n).then(()=>{})}}h(i);T(i,!0,c=>new f(c));export{f as KHR_materials_coat};