synth-optimizers 0.2.16__tar.gz → 0.2.22__tar.gz

{synth_optimizers-0.2.16 → synth_optimizers-0.2.22}/Cargo.lock

@@ -1306,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "synth_gepa"
-version = "0.2.16"
+version = "0.2.22"
 dependencies = [
  "base64",
  "fs2",
@@ -1322,7 +1322,7 @@ dependencies = [
 
 [[package]]
 name = "synth_mapo"
-version = "0.2.16"
+version = "0.2.22"
 dependencies = [
  "serde",
  "serde_json",
@@ -1334,7 +1334,7 @@ dependencies = [
 
 [[package]]
 name = "synth_marl_promptopt"
-version = "0.2.16"
+version = "0.2.22"
 dependencies = [
  "clap",
  "serde",
@@ -1348,7 +1348,7 @@ dependencies = [
 
 [[package]]
 name = "synth_optimizer_platform"
-version = "0.2.16"
+version = "0.2.22"
 dependencies = [
  "fs2",
  "libc",
@@ -1365,7 +1365,7 @@ dependencies = [
 
 [[package]]
 name = "synth_optimizers_py"
-version = "0.2.16"
+version = "0.2.22"
 dependencies = [
  "pyo3",
  "serde_json",

{synth_optimizers-0.2.16 → synth_optimizers-0.2.22}/Cargo.toml

@@ -3,11 +3,11 @@ members = ["rust/crates/synth_optimizer_platform", "rust/crates/synth_gepa", "ru
 resolver = "2"
 
 [workspace.package]
-version = "0.2.16"
+version = "0.2.22"
 edition = "2021"
 license = "Apache-2.0"
 authors = ["Synth Laboratories <josh@usesynth.ai>"]
-repository = "https://github.com/synth-laboratories/synth-cookbooks-public"
+repository = "https://github.com/synth-laboratories/optimizers"
 
 [workspace.dependencies]
 anyhow = "1.0"
@@ -26,3 +26,11 @@ thiserror = "1.0"
 time = { version = "0.3", features = ["formatting", "macros", "parsing"] }
 toml = "0.8"
 uuid = { version = "1.10", features = ["v4"] }
+
+# Several constructors and snapshot builders take eight or more distinct domain
+# values. Bundling them into parameter structs would only move the arity into a
+# literal at every call site, and the alternative -- an attribute per function --
+# grows source files that the file-size ratchet in
+# `synth_optimizer_platform/tests/file_size_cap.rs` allows only to shrink.
+[workspace.lints.clippy]
+too_many_arguments = "allow"

synth_optimizers-0.2.16/README.md → synth_optimizers-0.2.22/PKG-INFO

@@ -1,3 +1,39 @@
+Metadata-Version: 2.4
+Name: synth-optimizers
+Version: 0.2.22
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: synth-containers==0.4.3
+Requires-Dist: websocket-client>=1.8.0
+Requires-Dist: datasets>=2.19.0 ; extra == 'banking77'
+Requires-Dist: openai>=1.0.0 ; extra == 'banking77'
+Requires-Dist: fastapi>=0.115 ; extra == 'benchmark-server'
+Requires-Dist: uvicorn>=0.30 ; extra == 'benchmark-server'
+Requires-Dist: httpx>=0.27 ; extra == 'benchmark-server'
+Requires-Dist: daytona==0.210.0 ; extra == 'daytona'
+Requires-Dist: maturin>=1.7.0 ; extra == 'dev'
+Requires-Dist: numpy>=2.0 ; extra == 'dev'
+Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.6.0 ; extra == 'dev'
+Requires-Dist: ty>=0.0.32 ; extra == 'dev'
+Requires-Dist: pyarrow>=17 ; extra == 'eval-target-build'
+Requires-Dist: huggingface-hub>=0.24 ; extra == 'eval-target-build'
+Requires-Dist: tinker ; extra == 'tinker'
+Requires-Dist: renderers>=0.1.9 ; extra == 'tinker'
+Provides-Extra: banking77
+Provides-Extra: benchmark-server
+Provides-Extra: daytona
+Provides-Extra: dev
+Provides-Extra: eval-target-build
+Provides-Extra: tinker
+Summary: Public Synth optimizer tooling with a Rust GEPA core.
+Author-email: Synth Laboratories <josh@usesynth.ai>
+License-Expression: Apache-2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/synth-laboratories/optimizers
+Project-URL: Issues, https://github.com/synth-laboratories/optimizers/issues
+Project-URL: Repository, https://github.com/synth-laboratories/optimizers
+
 <h1 align="center">synth-optimizers</h1>
 <p align="center">A shared optimizer platform for AI applications — starting with open-source GEPA on a language-agnostic task contract.</p>
 <p align="center">
@@ -19,31 +55,28 @@ contract.
 
 | Algorithm | Status | In this repo | Paper & docs |
 | --- | --- | --- | --- |
-| **GEPA** — reflective prompt evolution | Supported | [`rust/crates/synth_gepa/`](rust/crates/synth_gepa/) (Rust engine + service), [`src/synth_optimizers/gepa.py`](src/synth_optimizers/gepa.py) (Python API), [`skills/gepa/SKILL.md`](skills/gepa/SKILL.md) (agent runbook) | [Paper](https://arxiv.org/abs/2507.19457) · [gepa-ai docs](https://gepa-ai.github.io/gepa/) · bundled HTML via `gepa console` |
-| **GELO** — Go-Explore in prompt space (hosted) | Hosted submit | [`src/synth_optimizers/gelo.py`](src/synth_optimizers/gelo.py), [`skills/gelo/SKILL.md`](skills/gelo/SKILL.md), [`GELO_HOSTED_SDK_CLI_SPEC.md`](GELO_HOSTED_SDK_CLI_SPEC.md) | Bundled HTML via `gelo console` — [`src/synth_optimizers/docs/gelo/`](src/synth_optimizers/docs/gelo/) |
-| **SFT** — supervised fine-tuning (hosted) | Hosted submit | `HostedOptimizerClient.submit_sft()` / `submit_sft()` | Executed by the private Optimizers-beta runtime; the public client uses the shared hosted run API. |
+| **GEPA** — reflective prompt evolution | Supported | [`rust/crates/synth_gepa/`](rust/crates/synth_gepa/) (Rust engine + service), [`src/synth_optimizers/gepa.py`](src/synth_optimizers/gepa.py) (Python API), [`skills/gepa/SKILL.md`](skills/gepa/SKILL.md) (agent runbook) | [Paper](https://arxiv.org/abs/2507.19457) · [gepa-ai docs](https://gepa-ai.github.io/gepa/) · bundled HTML via `synth-optimizers gepa console` |
+| **GELO** — Go-Explore in prompt space (hosted) | Hosted submit | [`src/synth_optimizers/gelo.py`](src/synth_optimizers/gelo.py), [`skills/gelo/SKILL.md`](skills/gelo/SKILL.md), [`GELO_HOSTED_SDK_CLI_SPEC.md`](GELO_HOSTED_SDK_CLI_SPEC.md) | Bundled HTML via `synth-optimizers gelo console` — [`src/synth_optimizers/docs/gelo/`](src/synth_optimizers/docs/gelo/) |
+| **SFT** — supervised fine-tuning | Local + hosted submit | `HostedOptimizerClient.submit_sft()` / `SftService` / `TinkerSftExecutor` | In-process Tinker executor in this repo. Default model `openai/gpt-oss-20b`. |
+| **CISPO** — `cispo.slime.v1` | Local + hosted submit | `HostedOptimizerClient.submit_cispo()` / `TinkerCispoExecutor` | True slime CISPO only. Generic importance sampling is not CISPO. |
 
 The shared [`synth_optimizer_platform`](rust/crates/synth_optimizer_platform/)
 crate is the substrate for optimizer implementations; GEPA is the first public
-local algorithm; GELO and SFT are hosted-only in the public package and run on
-Synth hosted optimizer infrastructure. Hosted GEPA, GELO, and SFT submission is
-covered in [`docs/hosted-optimizers.md`](docs/hosted-optimizers.md).
+local algorithm. GELO remains hosted-only. Standalone SFT and CISPO execute in
+this repository against Tinker. Hosted submission is covered in
+[`docs/hosted-optimizers.md`](docs/hosted-optimizers.md). Identity rules are in
+[`docs/sft-cispo-identity.md`](docs/sft-cispo-identity.md).
 
-### Hosted SFT control plane
+### SFT control plane
 
-SFT is served by `synth-optimizers`; Optimizers-beta is an internal training executor,
-not a Workshop-facing API. For local QA, start beta with its executor token and then
-start the public façade:
+SFT is served by `synth-optimizers` with an in-process Tinker executor. No
+`optimizers-beta` process, URL, or service token is required.
 
 ```bash
-# In the Optimizers-beta checkout:
-OPTIMIZERS_BETA_SERVICE_TOKEN=local-dev-token \
-  cargo run --bin optimizers-beta -- serve --bind 127.0.0.1:8879
-
-# In this checkout:
-export SYNTH_OPTIMIZERS_BETA_URL=http://127.0.0.1:8879
-export OPTIMIZERS_BETA_SERVICE_TOKEN=local-dev-token  # held only by the façade
-export SYNTH_OPTIMIZERS_SFT_SERVICE_TOKEN=local-qa-token  # Workshop / CLI callers
+export TINKER_API_KEY=...
+export SYNTH_OPTIMIZERS_SFT_SERVICE_TOKEN=local-qa-token
+# Fixture-only local QA without paid Tinker work:
+export SYNTH_OPTIMIZERS_SFT_FIXTURE=1
 synth-optimizers sft service --db .sft/service.sqlite --bind 127.0.0.1:8878
 ```
 
@@ -76,13 +109,18 @@ pip install synth-optimizers
 uv add synth-optimizers
 ```
 
+This source targets `synth-optimizers==0.2.22` with `synth-containers==0.4.2`.
+For an unpublished candidate, build from a checkout as shown below; published
+versions are listed on PyPI.
+
 Install [`uv`](https://github.com/astral-sh/uv) for local development and editable installs.
 
 ## Local development
 
-Sync the repo and install the local Python/Rust extension in editable mode:
+Clone the repo and install the local Python/Rust extension in editable mode:
 
 ```bash
+git clone https://github.com/synth-laboratories/optimizers.git
 cd optimizers
 uv sync --group dev
 uv pip install -e .
@@ -105,39 +143,31 @@ target_modules = ["stage2_system"]
 [seed_candidate]
 stage2_system = "Classify the query into exactly one Banking77 intent. Return only the label."
 
-[dataset]
-train_seeds = [0, 1, 2, 3, 4, 5, 6, 7]
-heldout_seeds = [100, 101, 102, 103]
+[taskset]
+train_ids = ["train:0", "train:1", "train:2", "train:3"]
+heldout_ids = ["test:100", "test:101"]
+
+[gepa.task_pools]
+pareto = ["train:0", "train:1", "train:2", "train:3"]
+minibatch = ["train:0", "train:1"]
+reflection = ["train:0", "train:1", "train:2", "train:3"]
+heldout = ["test:100", "test:101"]
 ```
 
 ```python
-from synth_containers import Container
-from synth_optimizers import GepaConfig, GepaRun, GepaTaskPools, OptimizerRun, TasksetSelection
-
-container = Container("my-task")
-
-with container.serve() as handle:
-    result = OptimizerRun(
-        GepaConfig(
-            container=handle.connection(),
-            taskset=TasksetSelection(train_ids=["train:0", "train:1"], heldout_ids=["test:100"]),
-            task_pools=GepaTaskPools(
-                pareto=["train:0"],
-                minibatch=["train:0"],
-                reflection=["train:0", "train:1"],
-                heldout=["test:100"],
-            ),
-            program=None,
-            objectives=None,
-            policy=None,
-        )
-    ).execute()
+from synth_optimizers import GepaRun
+
+# Use a complete cookbook config with its task service, policy, and proposer.
+# Configure authorized provider credentials before executing a paid run.
+result = GepaRun.from_toml("gepa.toml").execute()
 
 print(result.best_candidate)
 print("cost: unknown" if result.cost_usd is None else f"cost: ${result.cost_usd:.2f}")
 ```
 
-Or load TOML directly: `GepaRun.from_toml("gepa.toml").execute()`.
+The TOML above illustrates task selection, not a standalone task server. Run it
+from the GEPA cookbook directory and add the recipe's policy/proposer settings.
+The legacy `[dataset]` seed selection is not the current GEPA schema.
 
 CLI:
 
@@ -147,8 +177,23 @@ synth-optimizers gepa service --db service.sqlite
 synth-optimizers events compare --left a.jsonl --right b.jsonl
 ```
 
-Runnable task examples: [GEPA cookbooks](https://github.com/synth-laboratories/synth-cookbooks-public/tree/main/cookbooks/optimizers/gepa)
-(Banking77, HotpotQA, MiniGrid, TBLite, Crafter).
+Runnable task examples are **not in this repository**. They live in the separate
+public repo
+[`synth-laboratories/synth-cookbooks-public`](https://github.com/synth-laboratories/synth-cookbooks-public/tree/main/cookbooks/optimizers/gepa)
+— Banking77, HotpotQA, MiniGrid, and Crafter. TBLite is optional evaluation
+infrastructure. HealthBench is parked because Containers 0.4.2 does not include
+its runtime. Config-relative paths resolve against the config file's directory.
+Follow the selected cookbook's setup instructions before launching:
+
+```bash
+git clone https://github.com/synth-laboratories/synth-cookbooks-public.git
+cd synth-cookbooks-public/cookbooks/optimizers/gepa/banking77_container
+synth-optimizers gepa run --config gepa.toml
+```
+
+The cookbook configs published there still declare the legacy `[dataset]` seed
+selection, which `0.2.22` ignores; add `[taskset]` and `[gepa.task_pools]`
+blocks like the ones in the quickstart above before one of them will load.
 
 <details>
 <summary><strong>Authentication and models</strong></summary>
@@ -213,3 +258,4 @@ Agent docs: [skills/gepa/SKILL.md](skills/gepa/SKILL.md).
 ## License
 
 Apache-2.0
+

synth_optimizers-0.2.16/PKG-INFO → synth_optimizers-0.2.22/README.md

@@ -1,25 +1,3 @@
-Metadata-Version: 2.4
-Name: synth-optimizers
-Version: 0.2.16
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: synth-containers==0.4.1
-Requires-Dist: websocket-client>=1.8.0
-Requires-Dist: datasets>=2.19.0 ; extra == 'banking77'
-Requires-Dist: openai>=1.0.0 ; extra == 'banking77'
-Requires-Dist: maturin>=1.7.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.6.0 ; extra == 'dev'
-Requires-Dist: ty>=0.0.32 ; extra == 'dev'
-Provides-Extra: banking77
-Provides-Extra: dev
-Summary: Public Synth optimizer tooling with a Rust GEPA core.
-Author-email: Synth Laboratories <josh@usesynth.ai>
-License-Expression: Apache-2.0
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://github.com/synth-laboratories/optimizers
-Project-URL: Issues, https://github.com/synth-laboratories/optimizers/issues
-Project-URL: Repository, https://github.com/synth-laboratories/optimizers
-
 <h1 align="center">synth-optimizers</h1>
 <p align="center">A shared optimizer platform for AI applications — starting with open-source GEPA on a language-agnostic task contract.</p>
 <p align="center">
@@ -41,31 +19,28 @@ contract.
 
 | Algorithm | Status | In this repo | Paper & docs |
 | --- | --- | --- | --- |
-| **GEPA** — reflective prompt evolution | Supported | [`rust/crates/synth_gepa/`](rust/crates/synth_gepa/) (Rust engine + service), [`src/synth_optimizers/gepa.py`](src/synth_optimizers/gepa.py) (Python API), [`skills/gepa/SKILL.md`](skills/gepa/SKILL.md) (agent runbook) | [Paper](https://arxiv.org/abs/2507.19457) · [gepa-ai docs](https://gepa-ai.github.io/gepa/) · bundled HTML via `gepa console` |
-| **GELO** — Go-Explore in prompt space (hosted) | Hosted submit | [`src/synth_optimizers/gelo.py`](src/synth_optimizers/gelo.py), [`skills/gelo/SKILL.md`](skills/gelo/SKILL.md), [`GELO_HOSTED_SDK_CLI_SPEC.md`](GELO_HOSTED_SDK_CLI_SPEC.md) | Bundled HTML via `gelo console` — [`src/synth_optimizers/docs/gelo/`](src/synth_optimizers/docs/gelo/) |
-| **SFT** — supervised fine-tuning (hosted) | Hosted submit | `HostedOptimizerClient.submit_sft()` / `submit_sft()` | Executed by the private Optimizers-beta runtime; the public client uses the shared hosted run API. |
+| **GEPA** — reflective prompt evolution | Supported | [`rust/crates/synth_gepa/`](rust/crates/synth_gepa/) (Rust engine + service), [`src/synth_optimizers/gepa.py`](src/synth_optimizers/gepa.py) (Python API), [`skills/gepa/SKILL.md`](skills/gepa/SKILL.md) (agent runbook) | [Paper](https://arxiv.org/abs/2507.19457) · [gepa-ai docs](https://gepa-ai.github.io/gepa/) · bundled HTML via `synth-optimizers gepa console` |
+| **GELO** — Go-Explore in prompt space (hosted) | Hosted submit | [`src/synth_optimizers/gelo.py`](src/synth_optimizers/gelo.py), [`skills/gelo/SKILL.md`](skills/gelo/SKILL.md), [`GELO_HOSTED_SDK_CLI_SPEC.md`](GELO_HOSTED_SDK_CLI_SPEC.md) | Bundled HTML via `synth-optimizers gelo console` — [`src/synth_optimizers/docs/gelo/`](src/synth_optimizers/docs/gelo/) |
+| **SFT** — supervised fine-tuning | Local + hosted submit | `HostedOptimizerClient.submit_sft()` / `SftService` / `TinkerSftExecutor` | In-process Tinker executor in this repo. Default model `openai/gpt-oss-20b`. |
+| **CISPO** — `cispo.slime.v1` | Local + hosted submit | `HostedOptimizerClient.submit_cispo()` / `TinkerCispoExecutor` | True slime CISPO only. Generic importance sampling is not CISPO. |
 
 The shared [`synth_optimizer_platform`](rust/crates/synth_optimizer_platform/)
 crate is the substrate for optimizer implementations; GEPA is the first public
-local algorithm; GELO and SFT are hosted-only in the public package and run on
-Synth hosted optimizer infrastructure. Hosted GEPA, GELO, and SFT submission is
-covered in [`docs/hosted-optimizers.md`](docs/hosted-optimizers.md).
+local algorithm. GELO remains hosted-only. Standalone SFT and CISPO execute in
+this repository against Tinker. Hosted submission is covered in
+[`docs/hosted-optimizers.md`](docs/hosted-optimizers.md). Identity rules are in
+[`docs/sft-cispo-identity.md`](docs/sft-cispo-identity.md).
 
-### Hosted SFT control plane
+### SFT control plane
 
-SFT is served by `synth-optimizers`; Optimizers-beta is an internal training executor,
-not a Workshop-facing API. For local QA, start beta with its executor token and then
-start the public façade:
+SFT is served by `synth-optimizers` with an in-process Tinker executor. No
+`optimizers-beta` process, URL, or service token is required.
 
 ```bash
-# In the Optimizers-beta checkout:
-OPTIMIZERS_BETA_SERVICE_TOKEN=local-dev-token \
-  cargo run --bin optimizers-beta -- serve --bind 127.0.0.1:8879
-
-# In this checkout:
-export SYNTH_OPTIMIZERS_BETA_URL=http://127.0.0.1:8879
-export OPTIMIZERS_BETA_SERVICE_TOKEN=local-dev-token  # held only by the façade
-export SYNTH_OPTIMIZERS_SFT_SERVICE_TOKEN=local-qa-token  # Workshop / CLI callers
+export TINKER_API_KEY=...
+export SYNTH_OPTIMIZERS_SFT_SERVICE_TOKEN=local-qa-token
+# Fixture-only local QA without paid Tinker work:
+export SYNTH_OPTIMIZERS_SFT_FIXTURE=1
 synth-optimizers sft service --db .sft/service.sqlite --bind 127.0.0.1:8878
 ```
 
@@ -98,13 +73,18 @@ pip install synth-optimizers
 uv add synth-optimizers
 ```
 
+This source targets `synth-optimizers==0.2.22` with `synth-containers==0.4.2`.
+For an unpublished candidate, build from a checkout as shown below; published
+versions are listed on PyPI.
+
 Install [`uv`](https://github.com/astral-sh/uv) for local development and editable installs.
 
 ## Local development
 
-Sync the repo and install the local Python/Rust extension in editable mode:
+Clone the repo and install the local Python/Rust extension in editable mode:
 
 ```bash
+git clone https://github.com/synth-laboratories/optimizers.git
 cd optimizers
 uv sync --group dev
 uv pip install -e .
@@ -127,39 +107,31 @@ target_modules = ["stage2_system"]
 [seed_candidate]
 stage2_system = "Classify the query into exactly one Banking77 intent. Return only the label."
 
-[dataset]
-train_seeds = [0, 1, 2, 3, 4, 5, 6, 7]
-heldout_seeds = [100, 101, 102, 103]
+[taskset]
+train_ids = ["train:0", "train:1", "train:2", "train:3"]
+heldout_ids = ["test:100", "test:101"]
+
+[gepa.task_pools]
+pareto = ["train:0", "train:1", "train:2", "train:3"]
+minibatch = ["train:0", "train:1"]
+reflection = ["train:0", "train:1", "train:2", "train:3"]
+heldout = ["test:100", "test:101"]
 ```
 
 ```python
-from synth_containers import Container
-from synth_optimizers import GepaConfig, GepaRun, GepaTaskPools, OptimizerRun, TasksetSelection
-
-container = Container("my-task")
-
-with container.serve() as handle:
-    result = OptimizerRun(
-        GepaConfig(
-            container=handle.connection(),
-            taskset=TasksetSelection(train_ids=["train:0", "train:1"], heldout_ids=["test:100"]),
-            task_pools=GepaTaskPools(
-                pareto=["train:0"],
-                minibatch=["train:0"],
-                reflection=["train:0", "train:1"],
-                heldout=["test:100"],
-            ),
-            program=None,
-            objectives=None,
-            policy=None,
-        )
-    ).execute()
+from synth_optimizers import GepaRun
+
+# Use a complete cookbook config with its task service, policy, and proposer.
+# Configure authorized provider credentials before executing a paid run.
+result = GepaRun.from_toml("gepa.toml").execute()
 
 print(result.best_candidate)
 print("cost: unknown" if result.cost_usd is None else f"cost: ${result.cost_usd:.2f}")
 ```
 
-Or load TOML directly: `GepaRun.from_toml("gepa.toml").execute()`.
+The TOML above illustrates task selection, not a standalone task server. Run it
+from the GEPA cookbook directory and add the recipe's policy/proposer settings.
+The legacy `[dataset]` seed selection is not the current GEPA schema.
 
 CLI:
 
@@ -169,8 +141,23 @@ synth-optimizers gepa service --db service.sqlite
 synth-optimizers events compare --left a.jsonl --right b.jsonl
 ```
 
-Runnable task examples: [GEPA cookbooks](https://github.com/synth-laboratories/synth-cookbooks-public/tree/main/cookbooks/optimizers/gepa)
-(Banking77, HotpotQA, MiniGrid, TBLite, Crafter).
+Runnable task examples are **not in this repository**. They live in the separate
+public repo
+[`synth-laboratories/synth-cookbooks-public`](https://github.com/synth-laboratories/synth-cookbooks-public/tree/main/cookbooks/optimizers/gepa)
+— Banking77, HotpotQA, MiniGrid, and Crafter. TBLite is optional evaluation
+infrastructure. HealthBench is parked because Containers 0.4.2 does not include
+its runtime. Config-relative paths resolve against the config file's directory.
+Follow the selected cookbook's setup instructions before launching:
+
+```bash
+git clone https://github.com/synth-laboratories/synth-cookbooks-public.git
+cd synth-cookbooks-public/cookbooks/optimizers/gepa/banking77_container
+synth-optimizers gepa run --config gepa.toml
+```
+
+The cookbook configs published there still declare the legacy `[dataset]` seed
+selection, which `0.2.22` ignores; add `[taskset]` and `[gepa.task_pools]`
+blocks like the ones in the quickstart above before one of them will load.
 
 <details>
 <summary><strong>Authentication and models</strong></summary>
@@ -235,4 +222,3 @@ Agent docs: [skills/gepa/SKILL.md](skills/gepa/SKILL.md).
 ## License
 
 Apache-2.0
-

{synth_optimizers-0.2.16 → synth_optimizers-0.2.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-optimizers"
-version = "0.2.16"
+version = "0.2.22"
 description = "Public Synth optimizer tooling with a Rust GEPA core."
 authors = [{name = "Synth Laboratories", email = "josh@usesynth.ai"}]
 readme = "README.md"
@@ -8,17 +8,26 @@ requires-python = ">=3.11"
 license = "Apache-2.0"
 dependencies = [
     "pydantic>=2.0.0",
-    "synth-containers==0.4.1",
+    "synth-containers==0.4.3",
     "websocket-client>=1.8.0",
 ]
 
 [project.optional-dependencies]
+eval-target-build = ["pyarrow>=17", "huggingface-hub>=0.24"]
+daytona = ["daytona==0.210.0"]
+benchmark-server = ["fastapi>=0.115", "uvicorn>=0.30", "httpx>=0.27"]
 banking77 = [
     "datasets>=2.19.0",
     "openai>=1.0.0",
 ]
+tinker = [
+    "tinker",
+    "renderers>=0.1.9",
+]
 dev = [
     "maturin>=1.7.0",
+    "numpy>=2.0",
+    "pytest>=8.0.0",
     "ruff>=0.6.0",
     "ty>=0.0.32",
 ]
@@ -26,12 +35,15 @@ dev = [
 [dependency-groups]
 dev = [
     "maturin>=1.7.0",
+    "numpy>=2.0",
+    "pytest>=8.0.0",
     "ruff>=0.6.0",
     "ty>=0.0.32",
 ]
 
 [project.scripts]
 synth-optimizers = "synth_optimizers.cli:main"
+synth-optimizers-cispo = "synth_optimizers.cispo_cli:main"
 
 [project.urls]
 Homepage = "https://github.com/synth-laboratories/optimizers"
@@ -54,7 +66,8 @@ include = ["src/synth_optimizers/docs/**/*", "src/synth_optimizers/eval/catalog/
 package = true
 
 [tool.uv.sources]
-synth-containers = { git = "https://github.com/synth-laboratories/containers.git", rev = "5453731dabc078fc4aae700015f7ecd2ae95a969" }
+# Coordinated-release candidate; no sibling checkout is required by uv users.
+synth-containers = { path = "vendor/synth-containers/synth_containers-0.4.3-py3-none-any.whl" }
 
 [tool.ruff]
 line-length = 100

{synth_optimizers-0.2.16 → synth_optimizers-0.2.22}/rust/crates/synth_gepa/Cargo.toml

@@ -18,3 +18,6 @@ sha1.workspace = true
 sha2.workspace = true
 synth_optimizer_platform = { path = "../synth_optimizer_platform" }
 time.workspace = true
+
+[lints]
+workspace = true

synth_optimizers-0.2.22/rust/crates/synth_gepa/src/codex_app_server/cost_tests.rs

@@ -0,0 +1,31 @@
+use super::*;
+
+#[test]
+fn chatgpt_proposer_emits_explicit_zero_incremental_api_cost() {
+    let mut config = SynthOptimizerConfig::default();
+    config.proposer.auth_mode = "chatgpt".to_string();
+    let usage = normalize_proposer_usage(
+        &config,
+        "gpt-5.6-luna",
+        json!({"prompt_tokens": 100, "completion_tokens": 20, "total_tokens": 120}),
+    );
+    assert_eq!(usage.get("cost_usd"), Some(&json!(0.0)));
+    assert_eq!(
+        usage.get("cost_source"),
+        Some(&json!("chatgpt_subscription_no_incremental_api_charge"))
+    );
+    assert_eq!(usage.get("provider"), Some(&json!("chatgpt_subscription")));
+}
+
+#[test]
+fn chatgpt_proposer_preserves_an_explicit_cost_receipt() {
+    let mut config = SynthOptimizerConfig::default();
+    config.proposer.auth_mode = "chatgpt".to_string();
+    let usage = normalize_proposer_usage(
+        &config,
+        "gpt-5.6-luna",
+        json!({"cost_usd": 0.25, "cost_source": "provider"}),
+    );
+    assert_eq!(usage.get("cost_usd"), Some(&json!(0.25)));
+    assert_eq!(usage.get("cost_source"), Some(&json!("provider")));
+}

synth_optimizers-0.2.22/rust/crates/synth_gepa/src/codex_app_server/openrouter_usage.rs

@@ -0,0 +1,24 @@
+use serde_json::{json, Map, Value};
+
+pub(super) fn normalize(
+    model: &str,
+    mut usage: Map<String, Value>,
+    reported_cost: Option<f64>,
+) -> Value {
+    usage.insert("provider".into(), Value::String("openrouter".into()));
+    usage.insert("model".into(), Value::String(model.into()));
+    if reported_cost.is_none() {
+        let cost = usage
+            .get("cost")
+            .and_then(Value::as_f64)
+            .filter(|value| value.is_finite() && *value >= 0.0);
+        if let Some(cost) = cost {
+            usage.insert("cost_usd".into(), json!(cost));
+            usage.insert(
+                "cost_source".into(),
+                Value::String("openrouter_provider_billed".into()),
+            );
+        }
+    }
+    Value::Object(usage)
+}

{synth_optimizers-0.2.16 → synth_optimizers-0.2.22}/rust/crates/synth_gepa/src/codex_app_server.rs

@@ -1,9 +1,12 @@
-use std::collections::{BTreeMap, BTreeSet};
-use std::env;
-use std::fs;
-use std::path::{Path, PathBuf};
-use std::sync::{Mutex, OnceLock};
-use std::time::Duration;
+use std::{
+    collections::{BTreeMap, BTreeSet},
+    env, fs,
+    path::{Path, PathBuf},
+    sync::{Mutex, OnceLock},
+    time::Duration,
+};
+
+mod openrouter_usage;
 
 use crate::{CandidateRecord, RolloutScore};
 use reqwest::blocking::Client;
@@ -168,9 +171,10 @@ pub(crate) fn run_deepseek_chat_proposer(input: CodexProposerInput<'_>) -> Resul
                 "gpt-4.1-mini",
                 false,
             ),
+            "openrouter" => ("https://openrouter.ai/api/v1", "OPENROUTER_API_KEY", "openai/gpt-5.6-luna", false),
             other => {
                 return Err(OptimizerError::Config(format!(
-                    "chat-completions proposer backend requires proposer.provider = \"deepseek\", \"nvidia\", or \"openai\"; got {other:?}"
+                    "chat-completions proposer backend requires proposer.provider = \"deepseek\", \"nvidia\", \"openai\", or \"openrouter\"; got {other:?}"
                 )))
             }
         };
@@ -579,6 +583,9 @@ fn normalize_proposer_usage(config: &SynthOptimizerConfig, model: &str, usage: V
     if provider.eq_ignore_ascii_case("openrouter") && model_lower == OPENROUTER_GROK43_MODEL {
         return normalize_openrouter_grok43_usage(model, usage_map);
     }
+    if provider.eq_ignore_ascii_case("openrouter") {
+        return openrouter_usage::normalize(model, usage_map, reported_cost);
+    }
     if provider.eq_ignore_ascii_case("deepseek") || model_lower.contains("deepseek") {
         usage_map.insert(
             "provider".to_string(),
@@ -3399,36 +3406,4 @@ fn non_empty(value: Option<&str>) -> Option<&str> {
 }
 
 #[cfg(test)]
-mod cost_tests {
-    use super::*;
-
-    #[test]
-    fn chatgpt_proposer_emits_explicit_zero_incremental_api_cost() {
-        let mut config = SynthOptimizerConfig::default();
-        config.proposer.auth_mode = "chatgpt".to_string();
-        let usage = normalize_proposer_usage(
-            &config,
-            "gpt-5.6-luna",
-            json!({"prompt_tokens": 100, "completion_tokens": 20, "total_tokens": 120}),
-        );
-        assert_eq!(usage.get("cost_usd"), Some(&json!(0.0)));
-        assert_eq!(
-            usage.get("cost_source"),
-            Some(&json!("chatgpt_subscription_no_incremental_api_charge"))
-        );
-        assert_eq!(usage.get("provider"), Some(&json!("chatgpt_subscription")));
-    }
-
-    #[test]
-    fn chatgpt_proposer_preserves_an_explicit_cost_receipt() {
-        let mut config = SynthOptimizerConfig::default();
-        config.proposer.auth_mode = "chatgpt".to_string();
-        let usage = normalize_proposer_usage(
-            &config,
-            "gpt-5.6-luna",
-            json!({"cost_usd": 0.25, "cost_source": "provider"}),
-        );
-        assert_eq!(usage.get("cost_usd"), Some(&json!(0.25)));
-        assert_eq!(usage.get("cost_source"), Some(&json!("provider")));
-    }
-}
+mod cost_tests;