synth-optimizers 0.2.8.dev20260814__tar.gz → 0.2.11.dev20260816__tar.gz

{synth_optimizers-0.2.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/Cargo.lock

@@ -1306,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "synth_gepa"
-version = "0.2.8"
+version = "0.2.9"
 dependencies = [
  "base64",
  "fs2",
@@ -1321,7 +1321,7 @@ dependencies = [
 
 [[package]]
 name = "synth_mapo"
-version = "0.2.8"
+version = "0.2.9"
 dependencies = [
  "serde",
  "serde_json",
@@ -1333,7 +1333,7 @@ dependencies = [
 
 [[package]]
 name = "synth_marl_promptopt"
-version = "0.2.8"
+version = "0.2.9"
 dependencies = [
  "clap",
  "serde",
@@ -1347,7 +1347,7 @@ dependencies = [
 
 [[package]]
 name = "synth_optimizer_platform"
-version = "0.2.8"
+version = "0.2.9"
 dependencies = [
  "fs2",
  "libc",
@@ -1364,7 +1364,7 @@ dependencies = [
 
 [[package]]
 name = "synth_optimizers_py"
-version = "0.2.8"
+version = "0.2.9"
 dependencies = [
  "pyo3",
  "serde_json",

{synth_optimizers-0.2.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/Cargo.toml

@@ -3,7 +3,7 @@ members = ["rust/crates/synth_optimizer_platform", "rust/crates/synth_gepa", "ru
 resolver = "2"
 
 [workspace.package]
-version = "0.2.8"
+version = "0.2.9"
 edition = "2021"
 license = "Apache-2.0"
 authors = ["Synth Laboratories <josh@usesynth.ai>"]

{synth_optimizers-0.2.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-optimizers
-Version: 0.2.8.dev20260814
+Version: 0.2.11.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.8.dev20260814 → synth_optimizers-0.2.11.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.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-optimizers"
-version = "0.2.8.dev20260814"
+version = "0.2.11.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.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/rust/crates/synth_gepa/src/lib.rs

@@ -3799,7 +3799,7 @@ fn consume_async_lane_work(
             | OptimizerJobStatus::Cancelled
             | OptimizerJobStatus::Expired => {
                 if let Some(outcome) =
-                    schedule_failed_rollout_retry_if_allowed(context, state, resources, &job)?
+                    schedule_failed_runtime_retry_if_allowed(context, state, resources, &job)?
                 {
                     if let Some(updated) =
                         state.cursor.pipeline_state.lane_leases.get_mut(&lease_key)
@@ -6956,7 +6956,7 @@ fn advance_pending_runtime_job(
                             });
                         }
                         if updated_job.status.is_terminal() {
-                            if let Some(outcome) = schedule_failed_rollout_retry_if_allowed(
+                            if let Some(outcome) = schedule_failed_runtime_retry_if_allowed(
                                 context,
                                 state,
                                 resources,
@@ -7078,7 +7078,7 @@ fn advance_pending_runtime_job(
         | OptimizerJobStatus::Cancelled
         | OptimizerJobStatus::Expired => {
             if let Some(outcome) =
-                schedule_failed_rollout_retry_if_allowed(context, state, resources, &job)?
+                schedule_failed_runtime_retry_if_allowed(context, state, resources, &job)?
             {
                 return Ok(outcome);
             }
@@ -9354,14 +9354,16 @@ fn consume_failed_rollout_attempt(
     Ok(())
 }
 
-fn schedule_failed_rollout_retry_if_allowed(
+fn schedule_failed_runtime_retry_if_allowed(
     context: &mut GepaRunContext,
     state: &mut GepaRunState,
     resources: &GepaStepResources,
     job: &OptimizerJob,
 ) -> Result<Option<GepaAdvanceOutcome>> {
-    if !matches!(job.kind, OptimizerJobKind::Rollout)
-        || matches!(job.status, OptimizerJobStatus::Cancelled)
+    if !matches!(
+        job.kind,
+        OptimizerJobKind::Rollout | OptimizerJobKind::Proposer
+    ) || matches!(job.status, OptimizerJobStatus::Cancelled)
     {
         return Ok(None);
     }
@@ -9391,7 +9393,7 @@ fn schedule_failed_rollout_retry_if_allowed(
         resources,
         state.cursor.phase.clone(),
         "retry_scheduled",
-        "scheduled GEPA failed rollout job retry",
+        "scheduled GEPA failed runtime job retry",
         Map::new(),
     )?;
     Ok(Some(GepaAdvanceOutcome {
@@ -9399,8 +9401,9 @@ fn schedule_failed_rollout_retry_if_allowed(
         terminal: false,
         result: None,
         message: format!(
-            "scheduled GEPA failed rollout job retry: {} attempt={}/{}",
+            "scheduled GEPA failed runtime job retry: {} kind={} attempt={}/{}",
             updated.job_id,
+            updated.kind.as_str(),
             updated.attempt.saturating_add(1),
             updated.retry_policy.max_attempts
         ),
@@ -20225,17 +20228,7 @@ fn record_runtime_effect_job(
     let mut job = OptimizerJob::new(input.job_id, input.run_id, input.kind);
     job.status = input.status;
     job.candidate_id = input.candidate_id.map(str::to_string);
-    if matches!(job.kind, OptimizerJobKind::Rollout) {
-        job.retry_policy = RetryPolicy {
-            max_attempts: 3,
-            backoff_seconds: 2,
-            retryable_failure_types: vec![
-                "synth_optimizer_http_error".to_string(),
-                "synth_optimizer_container_error".to_string(),
-                "synth_optimizer_failed".to_string(),
-            ],
-        };
-    }
+    job.retry_policy = runtime_effect_retry_policy(&job.kind);
     job.attempt = if matches!(job.status, OptimizerJobStatus::Pending) {
         input.effect.attempt.saturating_sub(1)
     } else {
@@ -20301,6 +20294,26 @@ fn record_runtime_effect_job(
     workspace.record_optimizer_job(&job)
 }
 
+fn runtime_effect_retry_policy(kind: &OptimizerJobKind) -> RetryPolicy {
+    match kind {
+        OptimizerJobKind::Rollout => RetryPolicy {
+            max_attempts: 3,
+            backoff_seconds: 2,
+            retryable_failure_types: vec![
+                "synth_optimizer_http_error".to_string(),
+                "synth_optimizer_container_error".to_string(),
+                "synth_optimizer_failed".to_string(),
+            ],
+        },
+        OptimizerJobKind::Proposer => RetryPolicy {
+            max_attempts: 2,
+            backoff_seconds: 2,
+            retryable_failure_types: vec!["synth_optimizer_proposer_error".to_string()],
+        },
+        _ => RetryPolicy::default(),
+    }
+}
+
 fn budget_exceeded_error(run_id: &str, breach: &BudgetLimitBreach) -> OptimizerError {
     OptimizerError::BudgetExceeded {
         run_id: run_id.to_string(),
@@ -21714,4 +21727,22 @@ mod run_loop_terminalization_tests {
             None
         );
     }
+
+    #[test]
+    fn proposer_runtime_jobs_get_one_bounded_retry() {
+        let policy = runtime_effect_retry_policy(&OptimizerJobKind::Proposer);
+        assert_eq!(policy.max_attempts, 2);
+        assert_eq!(policy.backoff_seconds, 2);
+        assert_eq!(
+            policy.retryable_failure_types,
+            vec!["synth_optimizer_proposer_error".to_string()]
+        );
+    }
+
+    #[test]
+    fn unrelated_runtime_jobs_keep_the_fail_closed_default() {
+        let policy = runtime_effect_retry_policy(&OptimizerJobKind::Annotation);
+        assert_eq!(policy.max_attempts, 1);
+        assert!(policy.retryable_failure_types.is_empty());
+    }
 }

{synth_optimizers-0.2.8.dev20260814 → synth_optimizers-0.2.11.dev20260816}/rust/crates/synth_gepa/src/runtime.rs

@@ -468,7 +468,7 @@ impl<'a> GepaRuntimeExecutor<'a> {
             Ok(outcome) => outcome,
             Err(error) => {
                 if let Some(retry) =
-                    self.schedule_rollout_retry_if_allowed(&running_job, &lease_id, &error)?
+                    self.schedule_runtime_retry_if_allowed(&running_job, &lease_id, &error)?
                 {
                     return Err(retry);
                 }
@@ -528,14 +528,13 @@ impl<'a> GepaRuntimeExecutor<'a> {
         Ok(outcome)
     }
 
-    fn schedule_rollout_retry_if_allowed(
+    fn schedule_runtime_retry_if_allowed(
         &self,
         job: &OptimizerJob,
         lease_id: &str,
         error: &OptimizerError,
     ) -> Result<Option<OptimizerError>> {
-        if !matches!(job.kind, OptimizerJobKind::Rollout)
-            || !is_retryable_rollout_runtime_error(error)
+        if !is_retryable_runtime_job_error(job, error)
             || job.attempt >= job.retry_policy.max_attempts
         {
             return Ok(None);
@@ -556,8 +555,9 @@ impl<'a> GepaRuntimeExecutor<'a> {
             return Ok(None);
         };
         Ok(Some(OptimizerError::Failed(format!(
-            "retryable rollout runtime failure scheduled for retry job_id={} attempt={}/{} next_retry_at={}",
+            "retryable runtime failure scheduled for retry job_id={} kind={} attempt={}/{} next_retry_at={}",
             updated.job_id,
+            updated.kind.as_str(),
             updated.attempt.saturating_add(1),
             updated.retry_policy.max_attempts,
             updated.next_retry_at.unwrap_or_else(|| "now".to_string())
@@ -1097,6 +1097,32 @@ fn is_retryable_rollout_runtime_error(error: &OptimizerError) -> bool {
     )
 }
 
+fn is_retryable_runtime_job_error(job: &OptimizerJob, error: &OptimizerError) -> bool {
+    match job.kind {
+        OptimizerJobKind::Rollout => is_retryable_rollout_runtime_error(error),
+        OptimizerJobKind::Proposer => matches!(error, OptimizerError::Proposer(_)),
+        _ => false,
+    }
+}
+
+#[cfg(test)]
+mod runtime_job_retry_tests {
+    use super::*;
+
+    #[test]
+    fn proposer_errors_are_retryable_runtime_job_errors() {
+        let job = OptimizerJob::new("proposer-job", "run", OptimizerJobKind::Proposer);
+        assert!(is_retryable_runtime_job_error(
+            &job,
+            &OptimizerError::Proposer("app-server stalled".to_string())
+        ));
+        assert!(!is_retryable_runtime_job_error(
+            &job,
+            &OptimizerError::Config("invalid proposer config".to_string())
+        ));
+    }
+}
+
 fn dispatch_async_rollout(
     client: &ContainerClient,
     request: &Value,

{synth_optimizers-0.2.8.dev20260814 → synth_optimizers-0.2.11.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.8.dev20260814 → synth_optimizers-0.2.11.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.8.dev20260814 → synth_optimizers-0.2.11.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.11.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.8.dev20260814 → synth_optimizers-0.2.11.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,
     *,