3lc-compute-plugin-sdk 0.2.2__tar.gz → 0.2.3__tar.gz

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/CHANGELOG.md

@@ -9,6 +9,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Nothing yet.
 
+## [0.2.3] - 2026-08-21
+
+### Changed
+- Docs: the plugin guide and API docstrings describe the single runtime — a plugin runs in
+  its own venv behind a worker; the manifest's `isolation` key accepts only `"venv"` (the
+  default when absent). The guide's isolation table, the in-tree host exception callout, and
+  the `unload` endpoint reference are gone; the dev-workflow section now documents the
+  folder-Source + editable-venv + `worker/stop` loop. No code or contract change.
+
 ## [0.2.2] - 2026-08-18
 
 ### Added

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: 3lc-compute-plugin-sdk
-Version: 0.2.2
-Summary: Public Python SDK for building 3LC compute-service plugins (the import-light plugin contract).
+Version: 0.2.3
+Summary: Public Python SDK for building 3LC compute-service plugins.
 Project-URL: Homepage, https://github.com/3lc-ai/3lc-compute-plugin-sdk
 Project-URL: Repository, https://github.com/3lc-ai/3lc-compute-plugin-sdk
 Author-email: 3LC <support@3lc.ai>
@@ -46,13 +46,13 @@ pip install 3lc-compute-plugin-sdk          # import name: tlc_plugin_sdk
 
 - **`ComputePlugin`** — the base class you subclass. Implement `compute` / `get_ui_fragment`;
   job and lifecycle hooks ship as no-op defaults. There is no `register()` to call — a plugin's
-  metadata lives in its `[tool.tlc-compute]` manifest, and the host discovers it from there.
+  metadata lives in its `[tool.tlc-compute]` manifest, and the Hub discovers it from there.
 - **`JobContext`** — the surface a long-running job programs against: `progress` / `metric` /
   `log` / `result` for the generic job panel, `emit` for your plugin's own rich UI, and
   cooperative `cancelled`.
 - **The worker** (`python -m tlc_plugin_sdk.worker`) — serves your plugin's Litestar route
-  handlers + the generic reserved routes as an ASGI app, identically whether the host runs it
-  in-process or out-of-process in its own venv.
+  handlers + the generic reserved routes as an ASGI app, out-of-process in the plugin's
+  own venv.
 - **`tlc_plugin_sdk.shared.*`** — batteries the heavy plugins share: URL-alias registration,
   config storage/UI, the generic-job helpers, image/label/modality utilities, script injection.
 
@@ -65,14 +65,17 @@ format, custom routes, the job model, UI fragment, checklist).
 
 `tlc_plugin_sdk.SDK_CONTRACT_VERSION` is this package's own version — one source of truth.
 A plugin pins the SDK (`3lc-compute-plugin-sdk>=X,<Y`) and declares the contract it targets via its
-manifest. The host implements a contract range and the SDK version is the lingua franca that
-both sides agree on. Versions are SemVer; see **Status** below for the 0.x stability stance.
+manifest. The compute service implements a contract range, and the SDK version is the shared
+reference both sides agree on. Versions are SemVer; see **Status** below for the 0.x stability
+stance.
 
-## Boundary (the one rule)
+## How it fits
 
-The SDK is the **root** of the plugin dependency graph: it depends only on `3lc` + `uvicorn` +
-`litestar`, and **never** on the host (`3lc-compute`) or on any plugin. If your plugin only
-needs `tlc_plugin_sdk`, it is portable across host versions and can run in its own isolated venv.
+This SDK sits at the root of the plugin dependency graph. Its only required dependencies are
+`uvicorn` and `litestar`; the `3lc` data plane is an optional extra
+(`3lc-compute-plugin-sdk[shared]`), pulled in only by the `shared.*` helpers. It **never** depends
+on the compute service itself or on any plugin. A plugin built against `tlc_plugin_sdk` alone is
+therefore portable across service versions and runs in its own isolated environment.
 
 ## Status
 

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/README.md

@@ -20,13 +20,13 @@ pip install 3lc-compute-plugin-sdk          # import name: tlc_plugin_sdk
 
 - **`ComputePlugin`** — the base class you subclass. Implement `compute` / `get_ui_fragment`;
   job and lifecycle hooks ship as no-op defaults. There is no `register()` to call — a plugin's
-  metadata lives in its `[tool.tlc-compute]` manifest, and the host discovers it from there.
+  metadata lives in its `[tool.tlc-compute]` manifest, and the Hub discovers it from there.
 - **`JobContext`** — the surface a long-running job programs against: `progress` / `metric` /
   `log` / `result` for the generic job panel, `emit` for your plugin's own rich UI, and
   cooperative `cancelled`.
 - **The worker** (`python -m tlc_plugin_sdk.worker`) — serves your plugin's Litestar route
-  handlers + the generic reserved routes as an ASGI app, identically whether the host runs it
-  in-process or out-of-process in its own venv.
+  handlers + the generic reserved routes as an ASGI app, out-of-process in the plugin's
+  own venv.
 - **`tlc_plugin_sdk.shared.*`** — batteries the heavy plugins share: URL-alias registration,
   config storage/UI, the generic-job helpers, image/label/modality utilities, script injection.
 
@@ -39,14 +39,17 @@ format, custom routes, the job model, UI fragment, checklist).
 
 `tlc_plugin_sdk.SDK_CONTRACT_VERSION` is this package's own version — one source of truth.
 A plugin pins the SDK (`3lc-compute-plugin-sdk>=X,<Y`) and declares the contract it targets via its
-manifest. The host implements a contract range and the SDK version is the lingua franca that
-both sides agree on. Versions are SemVer; see **Status** below for the 0.x stability stance.
+manifest. The compute service implements a contract range, and the SDK version is the shared
+reference both sides agree on. Versions are SemVer; see **Status** below for the 0.x stability
+stance.
 
-## Boundary (the one rule)
+## How it fits
 
-The SDK is the **root** of the plugin dependency graph: it depends only on `3lc` + `uvicorn` +
-`litestar`, and **never** on the host (`3lc-compute`) or on any plugin. If your plugin only
-needs `tlc_plugin_sdk`, it is portable across host versions and can run in its own isolated venv.
+This SDK sits at the root of the plugin dependency graph. Its only required dependencies are
+`uvicorn` and `litestar`; the `3lc` data plane is an optional extra
+(`3lc-compute-plugin-sdk[shared]`), pulled in only by the `shared.*` helpers. It **never** depends
+on the compute service itself or on any plugin. A plugin built against `tlc_plugin_sdk` alone is
+therefore portable across service versions and runs in its own isolated environment.
 
 ## Status
 

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/docs/index.md

@@ -17,7 +17,7 @@ pip install 3lc-compute-plugin-sdk          # import name: tlc_plugin_sdk
   against: `progress` / `metric` / `log` / `result`, `emit` for rich UI, and
   cooperative `cancelled`.
 - **The worker** (`python -m tlc_plugin_sdk.worker`) — serves your plugin's Litestar
-  route handlers as an ASGI app, in-process or out-of-process in its own venv.
+  route handlers as an ASGI app, out-of-process in the plugin's own venv.
 
 ```{toctree}
 :maxdepth: 2

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/docs/plugin-guide.md

@@ -83,11 +83,6 @@ tlc_plugin_my_plugin/          # the default shape: a standalone venv-isolated p
 └── ...            # All plugin code lives here
 ```
 
-> **In-tree host exception.** A host may ship plugins inside its own package with
-> `isolation = "host"` and a host-internal entrypoint; those live in the host's source tree
-> and follow its layout. New plugins should use the `venv` + `tlc_plugin_<name>` shape shown
-> above, not the host form.
-
 ### 2. Write the manifest
 
 All metadata lives in a manifest — a standalone `plugin.toml` next to `__init__.py`. The host
@@ -96,10 +91,10 @@ source of truth for listing, routing, GPU/CPU classification, SocketIO wiring, a
 paths. (`read_manifest()` also accepts a `[tool.tlc-compute]` table in a plugin's `pyproject.toml`
 — it checks `plugin.toml` first.)
 
-A `venv` plugin keeps the **same `plugin.toml`** for metadata and adds a separate
-`pyproject.toml` alongside it that declares only its isolated venv's dependencies (no
+A plugin keeps the **same `plugin.toml`** for metadata and adds a separate
+`pyproject.toml` alongside it that declares only its venv's dependencies (no
 `[tool.tlc-compute]` table there) — see the `timm` / `sam3` / `yolo` plugins for the canonical
-layout, and the **Isolation** section below for how the two tiers run.
+layout.
 
 ```toml
 # plugin.toml — the single source of truth for this plugin's metadata.
@@ -127,34 +122,25 @@ quick_action = false                # Show in dashboard quick actions?
 # group_icon_svg = '<svg ...><rect x="2" y="2" width="12" height="12" rx="2"/></svg>'
 
 [runtime]
-isolation = "venv"                  # venv (isolated worker, the default) | host (in-process)
+isolation = "venv"                  # "venv" is the only value (and the default when absent)
 entrypoint = "tlc_plugin_my_plugin:MyPlugin"  # "pkg.module:ClassName"
 requires_gpu = false                # drives GPU vs CPU classification
-provision_extra = "my-plugin"       # REQUIRED for venv: host runs `uv sync --extra <this>`
+provision_extra = "my-plugin"       # umbrella extra the host provisions: `uv sync --extra <this>`
 # Optional SocketIO namespace for real-time updates. Defaults to "/<plugin-id>";
 # declare it only to override (the host registers it at startup so a UI can connect;
 # declaring it does NOT mean emitting custom events):
 # socketio_namespace = "/my-plugin"
 ```
 
-`runtime.provision_extra` is **required for every `venv` plugin**: it names the extra the
-host installs with `uv sync --extra <that-value>`. For first-party plugins this is a
-per-plugin extra in the `3lc-compute-plugins` umbrella `pyproject.toml`. (Host plugins don't
-declare it — their deps are a subset of the service.)
-
-**`isolation` — where the plugin runs (the *only* placement knob).** A plugin
-declares `isolation` and `requires_gpu`; it never picks a queue or names a lane.
+`runtime.provision_extra` is **required for every plugin distributed through an umbrella**:
+it names the extra the host installs with `uv sync --extra <that-value>`. For first-party
+plugins this is a per-plugin extra in the `3lc-compute-plugins` umbrella `pyproject.toml`.
 
-| `isolation` | Loaded by | Deps | Best for |
-|---|---|---|---|
-| `host` (default) | folder scan → imported **in-process** | must be a subset of the service | lightweight, hot-reloadable plugins |
-| `venv` | manifest only → spawn a worker over a UDS | its own uv-managed venv | heavy / conflicting deps (torch, ultralytics, SAM) |
-
-The plugin class is identical either way — `run_job(ctx)` talks only to `ctx`, so
-the same code runs in-process or in a worker. `requires_gpu = true` routes the job
-through the shared GPU queue (one GPU job at a time, across every plugin);
-`requires_gpu = false` jobs run on the CPU queue. Both are host-owned; the plugin
-never touches a queue.
+Every plugin runs in its own uv-managed venv, behind a worker the host spawns and talks to
+over a Unix socket — the host registers the plugin from its manifest alone and never imports
+its code. `requires_gpu` is the manifest's **only placement knob**: `true` routes the job
+through the shared GPU queue (one GPU job at a time, across every plugin); `false` jobs run
+on the CPU queue. Both are host-owned; the plugin never picks a queue or names a lane.
 
 ### 3. Implement the plugin object
 
@@ -289,13 +275,12 @@ The UI fragment is a self-contained `<style>` + `<div>` + `<script>` block. It h
 
 There is **nothing to register**. On startup, the host scans the plugin directories
 for manifests (no imports), builds a card from each, and gates compatibility against the
-service version. When a host plugin is actually needed, the host imports the module named in
-the manifest's `runtime.entrypoint` and instantiates the class, stamping the display
-identity (`id`, `name`, `icon`, `version`) from the manifest onto the instance.
+service version. When a plugin is actually needed, its **worker** imports the module named
+in the manifest's `runtime.entrypoint` and instantiates the class inside the plugin's own
+venv — the host never imports plugin code.
 
-Because metadata is read before any import, a plugin whose dependency is missing still
-**lists** (greyed-out with a reason) instead of vanishing — its behavior code is never
-imported until it's used.
+Because metadata is read without any import, a plugin whose environment is broken (or whose
+manifest is invalid) still **lists** (greyed-out with a reason) instead of vanishing.
 
 That's it. Drop the directory in place with a `plugin.toml` and it will be discovered on
 startup.
@@ -340,9 +325,8 @@ Browser (3LC Hub frontend, vanilla JS)              Compute service (:5020)
   └─ PLUGIN_API.authFetch(.../{subpath}) ───────▶  ANY  /api/plugins/{id}/{subpath} → route handler
 ```
 
-A plugin fragment is plain HTML+JS+CSS and is the **same bytes** whether the plugin runs
-in-process (`host` mode) or in an isolated venv worker (reverse-proxied) — the frontend
-can't tell. `PLUGIN_API` is the **single** host→fragment JS contract; a fragment should
+A plugin fragment is plain HTML+JS+CSS, served by the plugin's worker and reverse-proxied
+by the host — the frontend can't tell where it came from. `PLUGIN_API` is the **single** host→fragment JS contract; a fragment should
 reach for nothing else (the `API` shorthand some plugins use is just
 `var API = window.PLUGIN_API`).
 
@@ -440,9 +424,8 @@ socket.on('progress', function(data) { ... });
 For plugins that need more than the generic `compute()` method (e.g., POST bodies, multiple
 endpoints, streaming), return **relative Litestar route handlers** from `get_route_handlers()` —
 bare `@get`/`@post` handlers with **relative** paths, no `Controller` and no `/api/plugins`
-prefix. The host serves them through the plugin's own per-plugin app, behind the generic
-`/api/plugins/{id}/{subpath}` catch-all — in-process for `host` plugins, reverse-proxied to the
-worker for `venv` plugins.
+prefix. The host serves them through the plugin's own app in its worker, behind the generic
+`/api/plugins/{id}/{subpath}` catch-all.
 
 ```python
 from typing import Any
@@ -479,8 +462,8 @@ real example.
 A plugin with a long-running task (training, inference, import) **declares** the job
 in its manifest and **implements** it as `run_job(ctx)`. It does **not** grab a queue,
 push a closure, or poll a shared `cancel_flag` — the host owns the queue, the GPU/CPU
-slot lease, progress fan-out, listing, and cancellation. The same `run_job` code runs
-in-process (`host`) or in a worker (`venv`); it only ever touches `ctx`.
+slot lease, progress fan-out, listing, and cancellation. `run_job` runs in the plugin's
+worker and only ever touches `ctx`.
 
 **Declare the job in the manifest.** `requires_gpu` is the only knob:
 
@@ -582,8 +565,8 @@ independently.
 **Custom events** — `ctx.emit(name, payload)` is reserved for telemetry the generic schema
 **can't** express (e.g. a training plugin's per-epoch loss curve). The host relays it
 verbatim on the plugin's namespace; the generic panel ignores it. The name `job_update` is
-reserved and rejected. A plugin should **not** open its own SocketIO connection — emitting
-through `ctx` keeps `run_job` host/venv portable.
+reserved and rejected. A plugin should **not** open its own SocketIO connection — the host
+owns the transport; a plugin only ever emits through `ctx`.
 
 ```python
 # backend — inside run_job, for a plugin-specific chart the generic panel can't show:
@@ -639,19 +622,19 @@ color: var(--accent);           /* Accent color (#2a4a61) */
 
 ## Existing Plugins Reference
 
-| Plugin ID | display_mode | Section | isolation | Description |
+| Plugin ID | display_mode | Section | GPU | Description |
 |---|---|---|---|---|
-| `importer` | sidebar | Data Ops | **venv** | Import data (YOLO, COCO, Folder, CSV, Unlabeled) |
-| `exporter` | sidebar | Data Ops | **venv** | Export tables to CSV, XLSX, YOLO, COCO |
-| `splitter` | sidebar | Data Ops | **venv** | Split tables into train/val/test sets |
-| `merger` | sidebar | Data Ops | **venv** | Merge 2 tables by column join |
-| `image-metrics` | sidebar | Data Ops | **venv** (GPU) | Image quality metrics (brightness, sharpness, noise, etc.) |
-| `yolo` | sidebar | AI Tools | **venv** (GPU) | Ultralytics YOLO training + metrics collection |
-| `sam3` | sidebar | AI Tools | **venv** (GPU) | Auto-labeling with SAM3/GroundingDINO |
-| `timm` | sidebar | AI Tools | **venv** (GPU) | Image classification with timm models |
-| `table-statistics` | hidden | Analysis | **venv** | Per-column stats & image thumbnails (API-only) |
-| `run-insights` | action | Analysis | host (ships with the service) | Run statistics, health scores, per-class metrics |
-| `table-insights` | action | Analysis | host (ships with the service) | GT-only data quality analysis (bbox sizes, balance, etc.) |
+| `importer` | sidebar | Data Ops | — | Import data (YOLO, COCO, Folder, CSV, Unlabeled) |
+| `exporter` | sidebar | Data Ops | — | Export tables to CSV, XLSX, YOLO, COCO |
+| `splitter` | sidebar | Data Ops | — | Split tables into train/val/test sets |
+| `merger` | sidebar | Data Ops | — | Merge 2 tables by column join |
+| `image-metrics` | sidebar | Data Ops | GPU | Image quality metrics (brightness, sharpness, noise, etc.) |
+| `yolo` | sidebar | AI Tools | GPU | Ultralytics YOLO training + metrics collection |
+| `sam3` | sidebar | AI Tools | GPU | Auto-labeling with SAM3/GroundingDINO |
+| `timm` | sidebar | AI Tools | GPU | Image classification with timm models |
+| `table-statistics` | hidden | Analysis | — | Per-column stats & image thumbnails (API-only) |
+| `run-insights` | action | Analysis | — | Run statistics, health scores, per-class metrics |
+| `table-insights` | action | Analysis | — | GT-only data quality analysis (bbox sizes, balance, etc.) |
 
 ---
 
@@ -742,30 +725,32 @@ Every sidebar plugin UI should follow this structure:
 
 ---
 
-## Hot-Reload (Development)
+## The Dev Loop (Development)
+
+The fast edit-run cycle is a **folder Source + an editable venv + a worker restart** — no
+service restart, no rebuild:
 
-During development, you can hot-reload a plugin without restarting the Compute Service:
+1. Register your checkout as a folder Source (point `--plugin-dir` / the Settings page's
+   plugin-directories UI at the directory holding your plugin folder). The host provisions
+   the plugin's venv with `uv sync`, which installs your project **editable** — so the venv
+   always runs the code on disk.
+2. Edit your plugin files.
+3. Retire the worker; the next request cold-starts on the current code (sub-second):
 
 ```bash
-# 1. Edit your plugin files on the server
-# 2. Call the admin reload endpoint:
-curl -X POST http://localhost:5020/api/admin/plugins/my-plugin/reload
+curl -X POST http://localhost:5020/api/admin/plugins/my-plugin/worker/stop
 ```
 
 Or from the browser console:
 ```javascript
-TlcApi.authFetch(TlcApi.computeServiceUrl + '/api/admin/plugins/my-plugin/reload', {method:'POST'})
+TlcApi.authFetch(TlcApi.computeServiceUrl + '/api/admin/plugins/my-plugin/worker/stop', {method:'POST'})
   .then(r => r.json()).then(console.log)
 ```
 
-This purges the plugin's Python modules from `sys.modules`, re-imports the package
-(picking up file changes), and re-initialises the runtime. Running jobs in other
-plugins are unaffected. The UI cache is automatically cleared.
-
-To unload a plugin entirely:
-```bash
-curl -X POST http://localhost:5020/api/admin/plugins/my-plugin/unload
-```
+For **dependency** changes (a new package, a version bump in your `pyproject.toml`), rebuild
+the venv instead — `POST /api/admin/plugins/my-plugin/reload` runs `uv sync --reinstall` in
+the background and retires the worker when the rebuilt venv swaps in. Running jobs in other
+plugins are unaffected either way.
 
 ---
 

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/pyproject.toml

@@ -7,8 +7,8 @@ name = "3lc-compute-plugin-sdk"
 # The plugin-contract (ABI) version. This IS tlc_plugin_sdk.SDK_CONTRACT_VERSION
 # (read back via importlib.metadata) — one source of truth. SemVer MAJOR.MINOR.PATCH;
 # the 0.x line is additive-only (see README → Status).
-version = "0.2.2"
-description = "Public Python SDK for building 3LC compute-service plugins (the import-light plugin contract)."
+version = "0.2.3"
+description = "Public Python SDK for building 3LC compute-service plugins."
 requires-python = ">=3.10"
 readme = "README.md"
 authors = [{ name = "3LC", email = "support@3lc.ai" }]

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/src/tlc_plugin_sdk/asgi_app.py

@@ -4,23 +4,16 @@
 
 This is the single route-authoring pattern: a plugin exposes its custom routes as
 relative Litestar route handlers via :meth:`ComputePlugin.get_route_handlers`, and
-the **same** handlers are served two ways from the **same** builder:
+the worker (``tlc_plugin_sdk.worker``) serves the app with uvicorn on a Unix socket
+(or TCP, for a remote worker); the host reverse-proxies to it.
 
-- **host (in-process):** the compute service builds the app once per plugin
-  instance and invokes it directly through the ASGI interface (no socket);
-- **venv (out-of-process):** the worker (``tlc_plugin_sdk.worker``) serves the app
-  with uvicorn on a Unix socket and the host reverse-proxies to it.
-
-Because both modes serve the identical app, a plugin's routes get a real router,
-request validation, multipart, and binary/streaming responses in **either** mode,
-with no host/venv divergence. Litestar runs ``def`` handlers in a threadpool, so a
-synchronous, CPU-bound custom route (e.g. preview inference) does not block the
-event loop.
+Because the worker runs a real Litestar app, a plugin's routes get a real router,
+request validation, multipart, and binary/streaming responses. Litestar runs
+``def`` handlers in a threadpool, so a synchronous, CPU-bound custom route (e.g.
+preview inference) does not block the event loop.
 
 The app also mounts the host-reserved generic routes (``/health``, ``/ui``,
-``/compute``) so the worker can answer them over the socket; for the in-process host
-app these are harmless (the host serves ``/ui``/``/compute`` from its own reserved
-param routes and never forwards them here).
+``/compute``) so the worker can answer them over the socket.
 
 Litestar is a base dependency of this SDK, but it is imported **here**, not in
 the import-light :mod:`tlc_plugin_sdk` package surface — so
@@ -80,13 +73,12 @@ def build_plugin_app(
     extra_handlers: list[BaseRouteHandler] | None = None,
     debug: bool = False,
 ) -> Litestar:
-    """Build the Litestar app serving ``plugin``'s HTTP surface (host + venv).
+    """Build the Litestar app serving ``plugin``'s HTTP surface.
 
     Args:
         plugin: The plugin instance whose behavior the routes invoke.
-        extra_handlers: Worker-only handlers (the ``/jobs/{id}/run`` stream,
-            ``/jobs/{id}/cancel``, and ``/reclaim``); omitted for the host in-process
-            app, whose job lifecycle is owned by the host ``JobManager``.
+        extra_handlers: The worker's job-channel handlers (the ``/jobs/{id}/run``
+            stream, ``/jobs/{id}/cancel``, and ``/reclaim``).
         debug: Litestar debug flag.
 
     Returns:

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/src/tlc_plugin_sdk/contract.py

@@ -77,7 +77,7 @@ class ComputePlugin(ABC):
         """Run a long-running job against a host-provided context.
 
         The plugin reports progress/metrics and polls cancellation via ``ctx``;
-        the same code runs in-process (host mode) or in a worker (venv mode).
+        the code runs in the plugin's worker and only ever touches ``ctx``.
 
         Raises:
             NotImplementedError: The default — a plugin that streams jobs must
@@ -98,8 +98,7 @@ class ComputePlugin(ABC):
         Each handler's path is **relative** to the plugin's mount point
         ``/api/plugins/{plugin_id}/`` (e.g. a ``@get("/models")`` handler serves
         ``GET /api/plugins/{plugin_id}/models``). The handlers are served by the
-        plugin's own Litestar app — invoked in-process for host plugins,
-        reverse-proxied to the worker for venv plugins (see
+        plugin's own Litestar app in its worker, reverse-proxied by the host (see
         ``tlc_plugin_sdk/asgi_app.py``); Litestar runs ``def`` handlers in a threadpool,
         so a synchronous, blocking custom route does not block the event loop. The
         reserved routes (``/run``, ``/health``, ``/ui``, ``/compute``, ``/jobs/*``)

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/src/tlc_plugin_sdk/job_context.py

@@ -3,15 +3,11 @@
 """``JobContext`` — the surface a plugin's ``run_job`` programs against.
 
 A plugin implements ``run_job(ctx)`` and only ever touches ``ctx`` — it never
-grabs a host queue or polls a shared ``cancel_flag``. The same object is used in
-both ``host`` and ``venv`` modes; only the **sink** (where emitted events go) and
-the **cancel signal** differ:
-
-- ``venv`` mode: the worker harness gives a sink that enqueues events for the
-  streamed control-channel response, and a ``threading.Event`` set by the worker's
-  ``/cancel`` endpoint.
-- ``host`` mode: the host gives a sink that relays straight to SocketIO and a
-  cancel event tied to the host's job manager.
+grabs a host queue or polls a shared ``cancel_flag``. The **sink** (where emitted
+events go) and the **cancel signal** are injected: the worker harness gives a sink
+that enqueues events for the streamed control-channel response, and a
+``threading.Event`` set by the worker's ``/cancel`` endpoint. Tests inject their
+own sink and event and drive ``run_job`` directly.
 
 Import-light: stdlib only. Must not pull in the server stack.
 """
@@ -93,8 +89,7 @@ class JobContext:
         generic Queue & Progress panel ignores it. Use :meth:`progress` /
         :meth:`metric` / :meth:`log` for the generic panel, and this for
         plugin-specific UI (e.g. a training plugin's per-epoch loss curve) — so a
-        plugin never opens its own SocketIO connection and stays host/venv
-        portable (same ``run_job`` in either mode).
+        plugin never opens its own SocketIO connection; the host owns the transport.
 
         Args:
             name: Event name the plugin's UI listens for.

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/src/tlc_plugin_sdk/worker.py

@@ -10,10 +10,10 @@ The bind transport is selectable: ``--socket`` (Unix domain socket, the default
 supervisor uses) or ``--host``/``--port`` (TCP, e.g. ``--host 127.0.0.1 --port 9100``)
 for a worker reachable over the network. Exactly one of the two must be given.
 
-The worker serves the **same** Litestar app the host runs in-process for a host
-plugin (``tlc_plugin_sdk.asgi_app.build_plugin_app``): the plugin's own route handlers
+The worker serves the plugin's Litestar app
+(``tlc_plugin_sdk.asgi_app.build_plugin_app``): the plugin's own route handlers
 plus the generic reserved routes (``/health``, ``/ui``, ``/compute``). On top of that
-it adds the venv job channel the host supervisor drives:
+it adds the job channel the host supervisor drives:
 
 - ``POST /jobs/{job_id}/run``      → runs ``run_job(ctx)`` on a thread; the response
                                      **streams NDJSON events** (progress/metric/log)
@@ -28,8 +28,8 @@ process cannot know that another plugin's worker needs the card. The host decide
 when; the worker is the only side that can act, because a CUDA allocator is
 per-process and the supervisor's only in-process lever is killing the worker.
 
-Because the worker runs a real Litestar app, a plugin's custom routes get the same
-router, validation, multipart, and binary/streaming behavior they get in host mode —
+Because the worker runs a real Litestar app, a plugin's custom routes get a real
+router, validation, multipart, and binary/streaming behavior —
 and Litestar runs synchronous ``def`` handlers in a threadpool, so CPU-bound routes
 don't block the worker's event loop. Litestar + uvicorn are base dependencies of
 this SDK; they are imported here, not by the import-light :mod:`tlc_plugin_sdk`

{3lc_compute_plugin_sdk-0.2.2 → 3lc_compute_plugin_sdk-0.2.3}/uv.lock

@@ -26,36 +26,36 @@ name = "3lc"
 version = "3.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "cachetools", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "cryptlex-lexactivator", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "filelock", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "litestar", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
-    { name = "opencv-python", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pillow", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pyarrow", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pycocotools", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pyperclip", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "python-dateutil", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "anyio" },
+    { name = "cachetools" },
+    { name = "click" },
+    { name = "cryptlex-lexactivator" },
+    { name = "filelock" },
+    { name = "litestar" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
+    { name = "opencv-python" },
+    { name = "packaging" },
+    { name = "pillow" },
+    { name = "platformdirs" },
+    { name = "pyarrow" },
+    { name = "pycocotools" },
+    { name = "pydantic" },
+    { name = "pyperclip" },
+    { name = "python-dateutil" },
     { name = "pywin32", marker = "sys_platform == 'win32'" },
-    { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "randomname", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "ruamel-yaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "sentry-sdk", extra = ["litestar"], marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "termcolor", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "textual", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "tomli", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "tqdm", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "watchdog", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "pyyaml" },
+    { name = "randomname" },
+    { name = "rich" },
+    { name = "ruamel-yaml" },
+    { name = "sentry-sdk", extra = ["litestar"] },
+    { name = "termcolor" },
+    { name = "textual" },
+    { name = "tomli" },
+    { name = "tqdm" },
+    { name = "typing-extensions" },
+    { name = "uvicorn" },
+    { name = "watchdog" },
 ]
 wheels = [
     { url = "https://files.pythonhosted.org/packages/8f/1b/79914d46251a34c898d7f0c31e0f3f8e3d1b05889d43418e84cca2296254/3lc-3.2.1-cp310-cp310-macosx_13_0_arm64.whl", hash = "sha256:454d087f5ee6f2118f026bd2de8748225b71274dc43f394c0aa60aa0477d332b", size = 10291323, upload-time = "2026-08-14T18:20:27.851Z" },
@@ -78,29 +78,29 @@ wheels = [
 
 [package.optional-dependencies]
 pandas = [
-    { name = "pandas", version = "2.3.3", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "pandas", version = "3.0.3", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
+    { name = "pandas", version = "2.3.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "pandas", version = "3.0.3", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
 ]
 
 [[package]]
 name = "3lc-compute-plugin-sdk"
-version = "0.2.2"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
-    { name = "litestar", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "litestar" },
+    { name = "uvicorn" },
 ]
 
 [package.optional-dependencies]
 shared = [
-    { name = "3lc", extra = ["pandas"], marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "3lc", extra = ["pandas"] },
 ]
 
 [package.dev-dependencies]
 dev = [
-    { name = "mypy", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pytest", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "ruff", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "mypy" },
+    { name = "pytest" },
+    { name = "ruff" },
 ]
 
 [package.metadata]
@@ -132,9 +132,9 @@ name = "anyio"
 version = "4.14.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "exceptiongroup", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "(python_full_version < '3.13' and sys_platform == 'darwin') or (python_full_version < '3.13' and sys_platform == 'linux') or (python_full_version < '3.13' and sys_platform == 'win32')" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1c/b5/001890774a9552aff22502b8da382593109ce0c95314abaebbb116567545/anyio-4.14.0.tar.gz", hash = "sha256:b47c1f9ccf73e67021df785332508f99379c68fa7d0684e8e3492cb1d4b23f89", size = 253586, upload-time = "2026-06-15T22:00:49.021Z" }
 wheels = [
@@ -234,7 +234,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -267,7 +267,7 @@ name = "fire"
 version = "0.7.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "termcolor", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "termcolor" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/c0/00/f8d10588d2019d6d6452653def1ee807353b21983db48550318424b5ff18/fire-0.7.1.tar.gz", hash = "sha256:3b208f05c736de98fb343310d090dcc4d8c78b2a89ea4f32b837c586270a9cbf", size = 88720, upload-time = "2025-08-16T20:20:24.175Z" }
 wheels = [
@@ -288,8 +288,8 @@ name = "httpcore"
 version = "1.0.9"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "certifi" },
+    { name = "h11" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
 wheels = [
@@ -301,10 +301,10 @@ name = "httpx"
 version = "0.28.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "httpcore", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "idna", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
 wheels = [
@@ -419,7 +419,7 @@ name = "linkify-it-py"
 version = "2.1.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "uc-micro-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "uc-micro-py" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/2e/c9/06ea13676ef354f0af6169587ae292d3e2406e212876a413bf9eece4eb23/linkify_it_py-2.1.0.tar.gz", hash = "sha256:43360231720999c10e9328dc3691160e27a718e280673d444c38d7d3aaa3b98b", size = 29158, upload-time = "2026-03-01T07:48:47.683Z" }
 wheels = [
@@ -431,20 +431,20 @@ name = "litestar"
 version = "2.24.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "exceptiongroup", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "httpx", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "litestar-htmx", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "msgspec", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "multidict", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "polyfactory", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pyyaml", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "rich-click", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "sniffio", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "anyio" },
+    { name = "click" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "httpx" },
+    { name = "litestar-htmx" },
+    { name = "msgspec" },
+    { name = "multidict" },
+    { name = "multipart" },
+    { name = "polyfactory" },
+    { name = "pyyaml" },
+    { name = "rich" },
+    { name = "rich-click" },
+    { name = "sniffio" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/42/f6/33619a1562c6732dab211a967b1e7af3285de29d655c0b37b3f379aa2700/litestar-2.24.0.tar.gz", hash = "sha256:8f4b137cb115554b9fbc12bd01d398d5bb40ba85f2d333dd73f4b747308bbb46", size = 383070, upload-time = "2026-06-11T11:27:00.519Z" }
 wheels = [
@@ -465,7 +465,7 @@ name = "markdown-it-py"
 version = "4.2.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "mdurl", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "mdurl" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz", hash = "sha256:04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49", size = 82454, upload-time = "2026-05-07T12:08:28.36Z" }
 wheels = [
@@ -474,10 +474,10 @@ wheels = [
 
 [package.optional-dependencies]
 linkify = [
-    { name = "linkify-it-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "linkify-it-py" },
 ]
 plugins = [
-    { name = "mdit-py-plugins", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "mdit-py-plugins" },
 ]
 
 [[package]]
@@ -485,7 +485,7 @@ name = "mdit-py-plugins"
 version = "0.6.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "markdown-it-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "markdown-it-py" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/59/fc/f8d0863f8862f25602c0404d75568e89fb6b4109804645e5cdfb1be5cf56/mdit_py_plugins-0.6.1.tar.gz", hash = "sha256:a2bca0f039f39dbd35fb74ae1b5f998608c437463371f0ff7f49a19a17a114d0", size = 56114, upload-time = "2026-05-13T09:03:38.91Z" }
 wheels = [
@@ -562,7 +562,7 @@ name = "multidict"
 version = "6.7.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/1a/c2/c2d94cbe6ac1753f3fc980da97b3d930efe1da3af3c9f5125354436c073d/multidict-6.7.1.tar.gz", hash = "sha256:ec6652a1bee61c53a3e5776b6049172c53b6aaba34f18c9ad04f82712bac623d", size = 102010, upload-time = "2026-01-26T02:46:45.979Z" }
 wheels = [
@@ -709,12 +709,12 @@ name = "mypy"
 version = "2.1.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "ast-serialize", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "librt", marker = "(platform_python_implementation != 'PyPy' and sys_platform == 'darwin') or (platform_python_implementation != 'PyPy' and sys_platform == 'linux') or (platform_python_implementation != 'PyPy' and sys_platform == 'win32')" },
-    { name = "mypy-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pathspec", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "tomli", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "ast-serialize" },
+    { name = "librt", marker = "platform_python_implementation != 'PyPy'" },
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/82/15/cca9d88503549ed6fedeaa1d448cdddd542ee8a490232d732e278036fbf2/mypy-2.1.0.tar.gz", hash = "sha256:81e76ad12c2d804512e9b13240d1588316531bfba07558286078bfbce9613633", size = 3898359, upload-time = "2026-05-11T18:37:36.237Z" }
 wheels = [
@@ -934,8 +934,8 @@ name = "opencv-python"
 version = "4.13.0.92"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
 ]
 wheels = [
     { url = "https://files.pythonhosted.org/packages/fc/6f/5a28fef4c4a382be06afe3938c64cc168223016fa520c5abaf37e8862aa5/opencv_python-4.13.0.92-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:caf60c071ec391ba51ed00a4a920f996d0b64e3e46068aac1f646b5de0326a19", size = 46247052, upload-time = "2026-02-05T07:01:25.046Z" },
@@ -967,10 +967,10 @@ resolution-markers = [
     "python_full_version < '3.11' and sys_platform == 'win32'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "python-dateutil", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "pytz", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "tzdata", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" } },
+    { name = "python-dateutil" },
+    { name = "pytz" },
+    { name = "tzdata" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/33/01/d40b85317f86cf08d853a4f495195c73815fdf205eef3993821720274518/pandas-2.3.3.tar.gz", hash = "sha256:e05e1af93b977f7eafa636d043f9f94c7ee3ac81af99c13508215942e64c993b", size = 4495223, upload-time = "2025-09-29T23:34:51.853Z" }
 wheels = [
@@ -1039,9 +1039,9 @@ resolution-markers = [
     "python_full_version >= '3.11' and python_full_version < '3.14' and sys_platform == 'win32'",
 ]
 dependencies = [
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
-    { name = "python-dateutil", marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
-    { name = "tzdata", marker = "python_full_version >= '3.11' and sys_platform == 'win32'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" } },
+    { name = "python-dateutil" },
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/f8/87/4341c6252d1c47b08768c3d25ac487362bf403f0313ddae4a2a26c9b1b4c/pandas-3.0.3.tar.gz", hash = "sha256:696a4a00a2a2a35d4e5deb3fc946641b96c944f02230e4f76137fe35d806c4fc", size = 4651414, upload-time = "2026-05-11T18:54:29.21Z" }
 wheels = [
@@ -1224,8 +1224,8 @@ name = "polyfactory"
 version = "3.3.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "faker", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "faker" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/85/68/7717bd9e63ed254617a7d3dc9260904fb736d6ea203e58ffddcb186c64e4/polyfactory-3.3.0.tar.gz", hash = "sha256:237258b6ff43edf362ffd1f68086bb796466f786adfa002b0ac256dbf2246e9a", size = 348668, upload-time = "2026-02-22T09:46:28.01Z" }
 wheels = [
@@ -1294,8 +1294,8 @@ name = "pycocotools"
 version = "2.0.11"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "(python_full_version >= '3.11' and sys_platform == 'darwin') or (python_full_version >= '3.11' and sys_platform == 'linux') or (python_full_version >= '3.11' and sys_platform == 'win32')" },
+    { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
+    { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/a2/df/32354b5dda963ffdfc8f75c9acf8828ef7890723a4ed57bb3ff2dc1d6f7e/pycocotools-2.0.11.tar.gz", hash = "sha256:34254d76da85576fcaf5c1f3aa9aae16b8cb15418334ba4283b800796bd1993d", size = 25381, upload-time = "2025-12-15T22:31:46.148Z" }
 wheels = [
@@ -1341,10 +1341,10 @@ name = "pydantic"
 version = "2.13.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "annotated-types", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pydantic-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/18/a5/b60d21ac674192f8ab0ba4e9fd860690f9b4a6e51ca5df118733b487d8d6/pydantic-2.13.4.tar.gz", hash = "sha256:c40756b57adaa8b1efeeced5c196f3f3b7c435f90e84ea7f443901bec8099ef6", size = 844775, upload-time = "2026-05-06T13:43:05.343Z" }
 wheels = [
@@ -1356,7 +1356,7 @@ name = "pydantic-core"
 version = "2.46.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/9d/56/921726b776ace8d8f5db44c4ef961006580d91dc52b803c489fafd1aa249/pydantic_core-2.46.4.tar.gz", hash = "sha256:62f875393d7f270851f20523dd2e29f082bcc82292d66db2b64ea71f64b6e1c1", size = 471464, upload-time = "2026-05-06T13:37:06.98Z" }
 wheels = [
@@ -1491,12 +1491,12 @@ version = "9.1.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "colorama", marker = "sys_platform == 'win32'" },
-    { name = "exceptiongroup", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
-    { name = "iniconfig", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "packaging", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pluggy", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "tomli", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/84/0e/b5858858d74958632c49b72cb25a3976ff9f632397626715be71c89d3971/pytest-9.1.0.tar.gz", hash = "sha256:41dd9148c08072446394cefd3d79701701335a9f4cae69ba92e39f6c7f5c061c", size = 1634181, upload-time = "2026-06-13T18:52:45.983Z" }
 wheels = [
@@ -1508,7 +1508,7 @@ name = "python-dateutil"
 version = "2.9.0.post0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "six", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "six" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432, upload-time = "2024-03-01T18:36:20.211Z" }
 wheels = [
@@ -1612,7 +1612,7 @@ name = "randomname"
 version = "0.2.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "fire", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "fire" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/e8/c2/525e9e9b458c3ca493d9bd0871f3ed9b51446d26fe82d462494de188f848/randomname-0.2.1.tar.gz", hash = "sha256:b79b98302ba4479164b0a4f87995b7bebbd1d91012aeda483341e3e58ace520e", size = 64242, upload-time = "2023-01-29T02:42:26.469Z" }
 
@@ -1621,9 +1621,9 @@ name = "rich"
 version = "13.9.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "markdown-it-py", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "pygments", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/ab/3a/0316b28d0761c6734d6bc14e770d85506c986c85ffb239e688eeaab2c2bc/rich-13.9.4.tar.gz", hash = "sha256:439594978a49a09530cff7ebc4b5c7103ef57baf48d5ea3184f21d9a2befa098", size = 223149, upload-time = "2024-11-01T16:43:57.873Z" }
 wheels = [
@@ -1635,10 +1635,10 @@ name = "rich-click"
 version = "1.9.8"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "click" },
     { name = "colorama", marker = "sys_platform == 'win32'" },
-    { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "rich" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/f7/ea/21e4867ea0ef881ffd4c0550fc21a061435e50d6324bcd034396633cbc18/rich_click-1.9.8.tar.gz", hash = "sha256:4008f921da88b5d91646c134ec881c1500e5a6b3f093e90e8f29400e09608371", size = 75363, upload-time = "2026-05-28T19:54:59.144Z" }
 wheels = [
@@ -1684,8 +1684,8 @@ name = "sentry-sdk"
 version = "2.63.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "certifi", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "urllib3", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "certifi" },
+    { name = "urllib3" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/ba/c8/b3c970a5b186722d276cd40a05b3254e03bccc0208560aff20f612e018e8/sentry_sdk-2.63.0.tar.gz", hash = "sha256:2a1502bf864769275dbc8c2c9fc7a0f7f5e18358180b615d262d13a31ffba216", size = 912449, upload-time = "2026-06-16T12:45:57.553Z" }
 wheels = [
@@ -1694,7 +1694,7 @@ wheels = [
 
 [package.optional-dependencies]
 litestar = [
-    { name = "litestar", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "litestar" },
 ]
 
 [[package]]
@@ -1729,10 +1729,10 @@ name = "textual"
 version = "0.89.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "markdown-it-py", extra = ["linkify", "plugins"], marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "platformdirs", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "rich", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "markdown-it-py", extra = ["linkify", "plugins"] },
+    { name = "platformdirs" },
+    { name = "rich" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/4b/cb/b3ff0e45d812997a527cb581a4cd602f0b28793450aa26201969fd6ce42c/textual-0.89.1.tar.gz", hash = "sha256:66befe80e2bca5a8c876cd8ceeaf01752267b6b1dc1d0f73071f1f1e15d90cc8", size = 1517074, upload-time = "2024-12-05T15:17:12.903Z" }
 wheels = [
@@ -1819,7 +1819,7 @@ name = "typing-inspection"
 version = "0.4.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
 wheels = [
@@ -1858,9 +1858,9 @@ name = "uvicorn"
 version = "0.49.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },
-    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux') or (python_full_version < '3.11' and sys_platform == 'win32')" },
+    { name = "click" },
+    { name = "h11" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/c4/1f/fa18009dea8469069cca78a4e877a008ab78f08b064bfc9ab891579077ff/uvicorn-0.49.0.tar.gz", hash = "sha256:ebf4271aa580d9de97f93192d4595176df6e91f9aae919ca73e4fc07df1e66a3", size = 91284, upload-time = "2026-06-03T22:01:30.448Z" }
 wheels = [