synth-optimizers 0.2.9.dev20260814__tar.gz → 0.2.12.dev20260816__tar.gz

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-optimizers
-Version: 0.2.9.dev20260814
+Version: 0.2.12.dev20260816
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: synth-containers==0.4.1.dev20260814
 Requires-Dist: websocket-client>=1.8.0
@@ -43,12 +43,22 @@ contract.
 | --- | --- | --- | --- |
 | **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. |
 
 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 is hosted-only in the public package and runs on Synth
-hosted optimizer infrastructure.
-Hosted GEPA/GELO submission is covered in [`docs/hosted-optimizers.md`](docs/hosted-optimizers.md).
+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).
+
+## Future hosted-algorithm compatibility
+
+MAPO, OHCO, Online Reflexion, and MARL prompt-optimization identifiers are retained
+in [`future_algorithms.py`](src/synth_optimizers/future_algorithms.py) so clients can
+parse hosted catalogs and historical runs. They are **not supported public optimizer
+algorithms**: they carry no local executor, cookbook, or release commitment. New
+public algorithms graduate into the table above only after their public API contract,
+replay semantics, and end-to-end evidence are ready.
 
 ## Install
 
@@ -173,7 +183,7 @@ policy can stay on OpenAI. See [skills/gepa/SKILL.md](skills/gepa/SKILL.md) for
 
 - **OpenAI API key proposer** — run-local Codex home; does not use your host `~/.codex` login.
 - **OpenRouter proposer** — provider-aware Codex config and base URL; OpenRouter works for policy rollouts too.
-- **ChatGPT subscription proposer** — `auth_mode = "chatgpt"` with required `codex_home` (OAuth via [Codex CLI](https://github.com/openai/codex) or [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)); models include `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.3-codex-spark`, `gpt-5.5`; proposer usage is $0, policy rollouts still bill normally.
+- **ChatGPT subscription proposer** — `auth_mode = "chatgpt"` with required `codex_home` (OAuth via [Codex CLI](https://github.com/openai/codex) or [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)); models include `gpt-5.4-mini`, `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.3-codex-spark`, `gpt-5.5`, `gpt-5.6-luna`, `gpt-5.6-sol`, and `gpt-5.6-terra`; proposer usage is $0, policy rollouts still bill normally.
 - **Nano-Codex proposer harness** — explicit `[proposer.nano_codex]` opt-in keeps one ChatGPT-authenticated app-server session warm across compatible GEPA generations, caches static task/program context by content digest, records monotonic JSONL events and typed turn receipts, and can replay receipts with zero live model or tool calls. See [`dev_examples/nano_codex_gepa/`](dev_examples/nano_codex_gepa/).
 - **Live usage** — `SYNTH_OPTIMIZERS_TERMINAL=1` prints running token and cost splits (`usage total=… policy=… proposer=…`).
 - **Docker proposer** — `runtime_substrate = "docker"` with `[proposer.docker].image`; workspaces stage under `~/.cache/synth-gepa-docker-workspaces/`, sync back, then cleanup; image: `docker/codex-gepa-proposer/Dockerfile`.

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/README.md

@@ -21,12 +21,22 @@ contract.
 | --- | --- | --- | --- |
 | **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. |
 
 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 is hosted-only in the public package and runs on Synth
-hosted optimizer infrastructure.
-Hosted GEPA/GELO submission is covered in [`docs/hosted-optimizers.md`](docs/hosted-optimizers.md).
+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).
+
+## Future hosted-algorithm compatibility
+
+MAPO, OHCO, Online Reflexion, and MARL prompt-optimization identifiers are retained
+in [`future_algorithms.py`](src/synth_optimizers/future_algorithms.py) so clients can
+parse hosted catalogs and historical runs. They are **not supported public optimizer
+algorithms**: they carry no local executor, cookbook, or release commitment. New
+public algorithms graduate into the table above only after their public API contract,
+replay semantics, and end-to-end evidence are ready.
 
 ## Install
 
@@ -151,7 +161,7 @@ policy can stay on OpenAI. See [skills/gepa/SKILL.md](skills/gepa/SKILL.md) for
 
 - **OpenAI API key proposer** — run-local Codex home; does not use your host `~/.codex` login.
 - **OpenRouter proposer** — provider-aware Codex config and base URL; OpenRouter works for policy rollouts too.
-- **ChatGPT subscription proposer** — `auth_mode = "chatgpt"` with required `codex_home` (OAuth via [Codex CLI](https://github.com/openai/codex) or [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)); models include `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.3-codex-spark`, `gpt-5.5`; proposer usage is $0, policy rollouts still bill normally.
+- **ChatGPT subscription proposer** — `auth_mode = "chatgpt"` with required `codex_home` (OAuth via [Codex CLI](https://github.com/openai/codex) or [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)); models include `gpt-5.4-mini`, `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.3-codex-spark`, `gpt-5.5`, `gpt-5.6-luna`, `gpt-5.6-sol`, and `gpt-5.6-terra`; proposer usage is $0, policy rollouts still bill normally.
 - **Nano-Codex proposer harness** — explicit `[proposer.nano_codex]` opt-in keeps one ChatGPT-authenticated app-server session warm across compatible GEPA generations, caches static task/program context by content digest, records monotonic JSONL events and typed turn receipts, and can replay receipts with zero live model or tool calls. See [`dev_examples/nano_codex_gepa/`](dev_examples/nano_codex_gepa/).
 - **Live usage** — `SYNTH_OPTIMIZERS_TERMINAL=1` prints running token and cost splits (`usage total=… policy=… proposer=…`).
 - **Docker proposer** — `runtime_substrate = "docker"` with `[proposer.docker].image`; workspaces stage under `~/.cache/synth-gepa-docker-workspaces/`, sync back, then cleanup; image: `docker/codex-gepa-proposer/Dockerfile`.

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-optimizers"
-version = "0.2.9.dev20260814"
+version = "0.2.12.dev20260816"
 description = "Public Synth optimizer tooling with a Rust GEPA core."
 authors = [{name = "Synth Laboratories", email = "josh@usesynth.ai"}]
 readme = "README.md"

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/rust/crates/synth_gepa/openapi/gepa-service-v1.yaml

@@ -32,6 +32,28 @@ servers:
     description: Local single-workspace server
 
 paths:
+  /v1/optimizer/capabilities:
+    get:
+      operationId: getOptimizerCapabilities
+      summary: Advertise Workshop optimizer compatibility
+      responses:
+        '200':
+          description: Optimizer algorithms, recipes, and runtime capabilities.
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/OptimizerCapabilities' }
+
+  /v1/optimizer/status:
+    get:
+      operationId: getOptimizerStatus
+      summary: Return the Workshop-compatible optimizer status document
+      responses:
+        '200':
+          description: Alias of the optimizer capability document for compatibility.
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/OptimizerCapabilities' }
+
   # ---------------------------------------------------------------------------
   # Submission + lifecycle
   # ---------------------------------------------------------------------------
@@ -648,7 +670,6 @@ paths:
 
 # =============================================================================
 components:
-
   parameters:
     RunId:
       name: run_id
@@ -698,6 +719,25 @@ components:
           schema: { $ref: '#/components/schemas/ErrorEnvelope' }
 
   schemas:
+    OptimizerCapabilities:
+      type: object
+      required: [status, algorithms, recipes, replay, cancellation, compatibleTemplateIds]
+      properties:
+        status: { type: string, const: ok }
+        algorithms:
+          type: array
+          minItems: 1
+          items: { type: string }
+        recipes:
+          type: array
+          minItems: 1
+          items: { type: string }
+        replay: { type: boolean }
+        cancellation: { type: boolean }
+        compatibleTemplateIds:
+          type: array
+          minItems: 1
+          items: { type: string }
 
     # ---- Enums -------------------------------------------------------------
     RunStatus:

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/rust/crates/synth_gepa/src/service.rs

@@ -1508,6 +1508,9 @@ fn route_request(request: HttpRequest, runtime: GepaServiceRuntime) -> HttpRespo
     let config = &runtime.config;
     match (request.method.as_str(), segments.as_slice()) {
         ("GET", ["health"]) => json_response(200, &json!({"status": "ok"})),
+        ("GET", ["v1", "optimizer", "capabilities"]) | ("GET", ["v1", "optimizer", "status"]) => {
+            json_response(200, &optimizer_capabilities_payload())
+        }
         ("GET", ["whoami"]) => json_response(
             200,
             &service_identity_payload(config, &runtime.service_url, &runtime.started_at, None),
@@ -1592,6 +1595,25 @@ fn route_request(request: HttpRequest, runtime: GepaServiceRuntime) -> HttpRespo
     }
 }
 
+fn optimizer_capabilities_payload() -> Value {
+    json!({
+        "status": "ok",
+        "algorithms": ["gepa"],
+        "recipes": [
+            "gepa.banking77.smoke.v1",
+            "gepa.banking77.luna.v1",
+            "gepa.banking77.sol.v1",
+            "gepa.craftax.smoke.v1"
+        ],
+        "replay": true,
+        "cancellation": true,
+        "compatibleTemplateIds": [
+            "optimizer.gepa.live.v1",
+            "optimizer.run.v1"
+        ]
+    })
+}
+
 fn handle_websocket_connection(
     stream: &mut TcpStream,
     runtime: GepaServiceRuntime,
@@ -5772,6 +5794,23 @@ mod tests {
         );
     }
 
+    #[test]
+    fn workshop_capability_handshake_is_complete() {
+        let capabilities = optimizer_capabilities_payload();
+        for field in ["algorithms", "recipes", "compatibleTemplateIds"] {
+            let values = capabilities[field].as_array().unwrap();
+            assert!(!values.is_empty());
+            assert!(values.iter().all(Value::is_string));
+        }
+        assert_eq!(capabilities["replay"], true);
+        assert_eq!(capabilities["cancellation"], true);
+        assert!(capabilities["recipes"]
+            .as_array()
+            .unwrap()
+            .iter()
+            .any(|recipe| recipe == "gepa.banking77.smoke.v1"));
+    }
+
     #[test]
     fn optimizer_event_pages_are_cursor_idempotent_and_run_isolated() {
         let path = scratch_path("cursor");

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/rust/crates/synth_optimizer_platform/src/config.rs

@@ -1252,6 +1252,7 @@ pub const CHATGPT_PROPOSER_MODELS: &[&str] = &[
     "gpt-5.5",
     "gpt-5.6-luna",
     "gpt-5.6-sol",
+    "gpt-5.6-terra",
 ];
 
 pub fn proposer_auth_mode_normalized(auth_mode: &str) -> String {
@@ -2895,8 +2896,8 @@ mod tests {
     use super::*;
 
     #[test]
-    fn locked_luna_and_sol_chatgpt_proposers_are_allowed() {
-        for model in ["gpt-5.6-luna", "gpt-5.6-sol"] {
+    fn locked_5_6_chatgpt_proposers_are_allowed() {
+        for model in ["gpt-5.6-luna", "gpt-5.6-sol", "gpt-5.6-terra"] {
             assert!(CHATGPT_PROPOSER_MODELS.contains(&model));
             validate_chatgpt_proposer_model(model).expect("locked ChatGPT proposer model");
             validate_chatgpt_proposer_model(&model.to_ascii_uppercase())
@@ -2911,6 +2912,7 @@ mod tests {
         assert!(error.to_string().contains("not allowed"));
         assert!(error.to_string().contains("gpt-5.6-luna"));
         assert!(error.to_string().contains("gpt-5.6-sol"));
+        assert!(error.to_string().contains("gpt-5.6-terra"));
     }
 
     #[test]

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/src/synth_optimizers/__init__.py

@@ -79,10 +79,16 @@ from .hosted import (
     OptimizerStartupCatalog,
     RunStatus as HostedRunStatus,
     submit_mapo,
+    submit_sft,
     submit_online_reflexion,
     validate_online_reflexion_evidence_notes,
 )
 from .hosted_config import HostedOptimizerConfig
+from .future_algorithms import (
+    FUTURE_HOSTED_ALGORITHMS,
+    FutureHostedAlgorithm,
+    FutureHostedAlgorithmSlug,
+)
 from .o11y import (
     LiveProgress,
     RegistryRecord,
@@ -220,6 +226,9 @@ __all__ = [
     "HostedOptimizerClient",
     "HostedOptimizerError",
     "HostedOptimizerConfig",
+    "FUTURE_HOSTED_ALGORITHMS",
+    "FutureHostedAlgorithm",
+    "FutureHostedAlgorithmSlug",
     "HostedRunStatus",
     "InvariantError",
     "InMemoryRunLog",
@@ -287,6 +296,7 @@ __all__ = [
     "gepa_delete_run_storage",
     "gepa_serve",
     "submit_mapo",
+    "submit_sft",
     "submit_online_reflexion",
     "validate_online_reflexion_evidence_notes",
 ]

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/src/synth_optimizers/docs/gepa/algorithms/20-proposer-and-policies.md

@@ -18,7 +18,7 @@ The proposer is a Codex app-server. Configure it under `[proposer]` (TOML) or
 | `runtime_substrate` | `local` (host) or `docker` (`[proposer.docker].image`). |
 | `provider` | `openai`, `openrouter`, `deepseek`. |
 | `auth_mode` | `auto`, `api_key`, `chatgpt`, or `host`. |
-| `model` | e.g. `gpt-5.4-nano`, `gpt-5.4-mini`, `gpt-5.5`. |
+| `model` | e.g. `gpt-5.4-mini`, `gpt-5.5`, `gpt-5.6-luna`, `gpt-5.6-sol`, `gpt-5.6-terra`. |
 | `reasoning_effort` | `none` / `low` / `medium` / `high`. |
 | `execution_mode` | `local_process` / `stdio` (JSON-RPC over stdin/stdout) or `websocket` / `ws`. |
 | `service_tier` | `default` or `fast` (Codex Fast mode; requires ChatGPT auth). |

synth_optimizers-0.2.12.dev20260816/src/synth_optimizers/future_algorithms.py

@@ -0,0 +1,39 @@
+"""Compatibility identifiers for hosted algorithms not yet publicly supported.
+
+These identifiers let the SDK parse a hosted catalog and preserve run history without
+implying that the package provides a supported local executor, cookbook, or release
+commitment.  Promote an entry only when its public contract and end-to-end evidence
+are ready.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+
+
+class FutureHostedAlgorithmSlug(StrEnum):
+    MAPO = "mapo"
+    OHCO = "ohco"
+    ONLINE_REFLEXION = "online-reflexion"
+    MARL_PROMPTOPT = "marl-promptopt"
+
+
+@dataclass(frozen=True, slots=True)
+class FutureHostedAlgorithm:
+    slug: FutureHostedAlgorithmSlug
+    summary: str
+
+
+FUTURE_HOSTED_ALGORITHMS: tuple[FutureHostedAlgorithm, ...] = (
+    FutureHostedAlgorithm(FutureHostedAlgorithmSlug.MAPO, "Private hosted compatibility lane."),
+    FutureHostedAlgorithm(FutureHostedAlgorithmSlug.OHCO, "Private hosted compatibility lane."),
+    FutureHostedAlgorithm(
+        FutureHostedAlgorithmSlug.ONLINE_REFLEXION,
+        "Gated hosted compatibility lane pending release evidence.",
+    ),
+    FutureHostedAlgorithm(
+        FutureHostedAlgorithmSlug.MARL_PROMPTOPT,
+        "Research executable; not a public hosted product lane.",
+    ),
+)

{synth_optimizers-0.2.9.dev20260814 → synth_optimizers-0.2.12.dev20260816}/src/synth_optimizers/hosted.py

@@ -85,6 +85,7 @@ _USAGE_REGISTRATION_TIMEOUT_SECONDS = 2.0
 class OptimizerAlgorithmSlug(StrEnum):
     GEPA = "gepa"
     GELO = "go-ex"
+    SFT = "sft"
     MAPO = "mapo"
     OHCO = "ohco"
     ONLINE_REFLEXION = "online-reflexion"
@@ -392,6 +393,14 @@ class HostedOptimizerClient:
     ) -> OptimizerRunSubmitResponse:
         return self._submit(OptimizerAlgorithmSlug.GELO, config, **kwargs)
 
+    def submit_sft(
+        self,
+        config: Mapping[str, Any] | Any,
+        **kwargs: Any,
+    ) -> OptimizerRunSubmitResponse:
+        """Submit a hosted SFT run executed by the Optimizers-beta backend."""
+        return self._submit(OptimizerAlgorithmSlug.SFT, config, **kwargs)
+
     def submit_mapo(
         self,
         config: Mapping[str, Any] | Any,
@@ -983,6 +992,17 @@ def submit_mapo(
     return active_client.submit_mapo(config, **kwargs)
 
 
+def submit_sft(
+    config: Mapping[str, Any] | Any,
+    *,
+    client: HostedOptimizerClient | None = None,
+    **kwargs: Any,
+) -> OptimizerRunSubmitResponse:
+    """Submit an SFT run through the public hosted Optimizers API."""
+    active_client = client or HostedOptimizerClient()
+    return active_client.submit_sft(config, **kwargs)
+
+
 def submit_online_reflexion(
     config: Mapping[str, Any] | Any,
     *,