traigent 0.16.0__tar.gz → 0.17.0.dev0__tar.gz

{traigent-0.16.0 → traigent-0.17.0.dev0}/CHANGELOG.md

@@ -16,6 +16,15 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
   `auto`, explicit local `grid`/`random`, zero-egress offline mode, result
   provenance, and legacy selector deprecations.
 
+### Removed
+- Removed public pruner exports: `CeilingPruner`, `CeilingPrunerConfig`,
+  `StatisticalInferiorityPruner`, and `StatisticalInferiorityPrunerConfig`.
+- Dropped the `optuna` runtime dependency.
+- Removed `register_optuna_optimizers` and the legacy Optuna feature flag/env
+  var (`OPTUNA_ROLLOUT`, renamed during the managed-routing migration).
+- Smart algorithms (`bayesian` and the Optuna family) now route to the Traigent
+  cloud; the local SDK supports `grid` and `random` only.
+
 ## [0.14.1] - 2026-06-19
 
 ### Fixed

{traigent-0.16.0/traigent.egg-info → traigent-0.17.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: traigent
-Version: 0.16.0
+Version: 0.17.0.dev0
 Summary: Enterprise-grade LLM optimization platform with advanced analytics and AI-powered insights
 Author-email: Traigent Team <opensource@traigent.ai>
 License-Expression: AGPL-3.0-only OR LicenseRef-Traigent-Commercial
@@ -38,7 +38,6 @@ Requires-Dist: PyJWT[crypto]<3.0.0,>=2.13.0
 Requires-Dist: backoff>=2.2.0
 Requires-Dist: litellm==1.87.1
 Requires-Dist: rank-bm25
-Requires-Dist: optuna>=4.5.0
 Requires-Dist: psutil>=5.8.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: analytics

{traigent-0.16.0 → traigent-0.17.0.dev0}/docs/README.md

@@ -50,7 +50,7 @@ def answer_question(question: str) -> str:
 - **[Injection Modes](user-guide/injection_modes.md)** - Different ways to integrate Traigent
 - **[Interactive Optimization](user-guide/interactive_optimization.md)** - Real-time optimization workflows
 - **[Evaluation Guide](user-guide/evaluation_guide.md)** - Measure and improve performance
-- **[Optuna Integration](user-guide/optuna_integration.md)** - Optuna-backed optimizers, coordinator, and adapter
+- **[Smart Optimization](user-guide/smart_optimization.md)** - Backend-routed smart optimizer strategies
 
 ### 🧭 [Guides](guides/)
 - **[Optimization Routing](guides/execution-modes.md)** - Default smart optimization, local search, portal sync, and no-egress runs

{traigent-0.16.0 → traigent-0.17.0.dev0}/docs/api-reference/telemetry.md

@@ -164,61 +164,23 @@ Any other value (including unset) means telemetry is enabled.
 
 When `TRAIGENT_DISABLE_TELEMETRY` is set:
 
-1. **No telemetry events are emitted** - The `OptunaMetricsEmitter` immediately returns without recording
+1. **No telemetry events are emitted** - SDK telemetry collectors return without recording
 2. **No metrics are sent to collectors** - MetricsCollector calls are skipped
 3. **Optimization still works normally** - Only telemetry is disabled, not functionality
 4. **Local results are still saved** - Optimization results are still persisted locally for your use
 
 ## Telemetry Implementation
 
-### OptunaMetricsEmitter
-
-The main telemetry component is `OptunaMetricsEmitter` in `traigent/telemetry/optuna_metrics.py`:
-
-```python
-from traigent.telemetry.optuna_metrics import OptunaMetricsEmitter
-
-# Telemetry is automatically disabled when env var is set
-emitter = OptunaMetricsEmitter(
-    metrics_collector=collector,
-    listeners=[my_listener],
-)
-
-# This call does nothing if TRAIGENT_DISABLE_TELEMETRY is set
-emitter.emit_trial_update(
-    event="trial_completed",
-    trial_id=123,
-    study_name="my_optimization",
-    payload={"metrics": {"accuracy": 0.95}},
-)
-```
-
-### Implementation Details
-
-The `OptunaMetricsEmitter` checks the environment variable on initialization:
-
-```python
-class OptunaMetricsEmitter:
-    def __init__(self, ...):
-        self._disabled = os.getenv("TRAIGENT_DISABLE_TELEMETRY", "").lower() in (
-            "1",
-            "true",
-            "yes",
-        )
-
-    def emit_trial_update(self, ...):
-        if self._disabled:
-            return {}  # No-op when disabled
-
-        # Normal telemetry emission
-        ...
-```
+Telemetry is routed through optimization storage, observability clients, and
+workflow tracing. The previous SDK-local Optuna telemetry emitter has been
+removed with the local Optuna dependency; smart optimizer telemetry is now a
+backend concern.
 
 ### Event Types
 
 When telemetry is enabled, the following events may be emitted (not exhaustive):
 
-- `trial_suggested` - Optuna proposed a new trial configuration
+- `trial_suggested` - An optimizer proposed a new trial configuration
 - `trial_intermediate` - Intermediate metric reported (pruning signal)
 - `trial_completed` - A trial finished successfully
 - `trial_failed` - A trial encountered an error
@@ -282,49 +244,12 @@ Traigent writes a `.gitignore` (`*`) into the log root so this content is not
 accidentally committed, but you should still keep `.traigent/` out of version
 control and CI artifact collection in sensitive projects.
 
-## Telemetry Listeners
-
-You can subscribe to telemetry events for your own monitoring:
-
-```python
-from traigent.telemetry.optuna_metrics import OptunaMetricsEmitter
-
-def my_listener(event_data: dict):
-    print(f"Trial event: {event_data['event']}")
-    print(f"Trial ID: {event_data['trial_id']}")
-    print(f"Metrics: {event_data.get('payload', {})}")
-
-emitter = OptunaMetricsEmitter()
-emitter.subscribe(my_listener)
-
-# Your listener will be called for each telemetry event
-# (unless TRAIGENT_DISABLE_TELEMETRY is set)
-```
-
 ## Security and Sensitive Data
 
 ### Data Sanitization
 
-Configuration data is automatically sanitized before telemetry:
-
-```python
-from traigent.telemetry.optuna_metrics import sanitize_config
-
-config = {
-    "model": "gpt-4",
-    "temperature": 0.7,
-    "_internal_key": "should_not_be_logged",
-}
-
-safe_config = sanitize_config(config)
-# Returns: {"model": "gpt-4", "temperature": 0.7"}
-```
-
-Private/internal keys (starting with `_`) are automatically removed.
-
-### Thread Safety
-
-The `OptunaMetricsEmitter` is thread-safe and uses `threading.RLock` to protect listener subscription operations.
+Configuration data is sanitized before telemetry. Private/internal keys
+(starting with `_`) are automatically removed.
 
 ### Error Handling
 

{traigent-0.16.0 → traigent-0.17.0.dev0}/docs/examples/QUICK_REFERENCE.md

@@ -13,7 +13,7 @@ python examples/core/simple-prompt/run.py
 # With real LLMs
 export ANTHROPIC_API_KEY="your-key" # pragma: allowlist secret
 export OPENAI_API_KEY="your-key" # pragma: allowlist secret
-python examples/core/multi-objective-tradeoff/run_openai_optuna.py
+python examples/core/multi-objective-tradeoff/run_openai_backend_smart.py
 ```
 
 ## Core optimize pattern

{traigent-0.16.0 → traigent-0.17.0.dev0}/docs/getting-started/installation.md

@@ -36,7 +36,7 @@ License: Traigent SDK is dual-licensed under AGPL-3.0-only OR LicenseRef-Traigen
 | **`recommended`** | **All user-facing features (integrations + analytics + bayesian + visualization + hybrid + pydanticai)** | **`pip install "traigent[recommended]"`** |
 | `integrations` | LangChain, OpenAI, Anthropic, MLflow, W&B | `pip install -e ".[integrations]"` |
 | `analytics` | numpy, pandas, matplotlib | `pip install -e ".[analytics]"` |
-| `bayesian` | Optuna + sklearn/scipy | `pip install -e ".[bayesian]"` |
+| `bayesian` | scikit-learn + scipy | `pip install -e ".[bayesian]"` |
 | `visualization` | matplotlib, plotly | `pip install -e ".[visualization]"` |
 | `hybrid` | HTTP/2 transport plus MCP-backed hybrid integrations | `pip install -e ".[hybrid]"` |
 | `cloud` | Reserved dependencies for future remote execution; not required for portal-tracked `hybrid` runs | `pip install -e ".[cloud]"` |

{traigent-0.16.0 → traigent-0.17.0.dev0}/docs/user-guide/README.md

@@ -11,7 +11,7 @@ Comprehensive guides for using Traigent SDK features and capabilities.
 - **[Injection Modes](injection_modes.md)** - Different ways to integrate Traigent with your code
 - **[Interactive Optimization](interactive_optimization.md)** - Real-time optimization workflows and monitoring
 - **[Evaluation Guide](evaluation_guide.md)** - Measure and improve model performance
-- **[Optuna Integration](optuna_integration.md)** - Use the Optuna-backed optimizers and distributed coordinator
+- **[Smart Optimization](smart_optimization.md)** - Use backend-routed smart optimizer strategies
 
 ## Learning Path
 
@@ -21,7 +21,7 @@ Comprehensive guides for using Traigent SDK features and capabilities.
 
 **Tuned Variables**: Use [Tuned Variables](tuned_variables.md) to auto-detect parameters and discover callables
 
-**Advanced Users**: Explore [Agent Optimization](agent_optimization.md), [Interactive Optimization](interactive_optimization.md), and [Optuna Integration](optuna_integration.md)
+**Advanced Users**: Explore [Agent Optimization](agent_optimization.md), [Interactive Optimization](interactive_optimization.md), and [Smart Optimization](smart_optimization.md)
 
 **Evaluation**: Use [Evaluation Guide](evaluation_guide.md) to measure success
 

traigent-0.17.0.dev0/docs/user-guide/smart_optimization.md

@@ -0,0 +1,65 @@
+# Smart Optimization
+
+Traigent SDKs expose a small local optimizer surface by default:
+
+- `grid`
+- `random`
+
+Smart optimization is backend-routed. Use a TraigentBackend typed session or
+hybrid SDK mode when you need guided search beyond the local defaults.
+
+## Public Smart Strategies
+
+| Strategy         | Runs In         | Use Case                                                 |
+| ---------------- | --------------- | -------------------------------------------------------- |
+| `bayesian`       | TraigentBackend | Public alias for guided TPE-style search                 |
+| `tpe`            | TraigentBackend | Guided search over categorical and continuous spaces     |
+| `optuna`         | TraigentBackend | Managed Optuna-family routing                            |
+| `optuna_tpe`     | TraigentBackend | Explicit TPE routing                                     |
+| `optuna_random`  | TraigentBackend | Managed random-search routing                            |
+| `optuna_grid`    | TraigentBackend | Managed grid-search routing                              |
+| `optuna_cmaes`   | TraigentBackend | Managed CMA-ES routing                                   |
+| `optuna_nsga2`   | TraigentBackend | Managed NSGA-II routing                                  |
+| `nsga2`          | TraigentBackend | NSGA-II alias                                            |
+| `nsgaii`         | TraigentBackend | NSGA-II alias                                            |
+| `nsga_ii`        | TraigentBackend | NSGA-II alias                                            |
+| `cmaes`          | TraigentBackend | CMA-ES alias                                             |
+| `cma_es`         | TraigentBackend | CMA-ES alias                                             |
+
+Local SDK runs accept `grid` and `random`. Smart strategies listed above are
+validated by the SDK and routed to TraigentBackend.
+
+## Python Hybrid Session Example
+
+```python
+import traigent
+from traigent import Choices, Range
+
+
+@traigent.optimize(
+    eval_dataset=[
+        {"input": "What is the capital of France?", "expected": "Paris"},
+        {"input": "What is the capital of Germany?", "expected": "Berlin"},
+    ],
+    objectives=["accuracy", "cost"],
+    model=Choices(["fast", "accurate"]),
+    temperature=Range(0.0, 1.0),
+)
+def answer_quality(question: str, model: str, temperature: float) -> str:
+    return call_model(question, model=model, temperature=temperature)
+
+
+result = await answer_quality.optimize(
+    max_trials=12,
+    algorithm="tpe",
+)
+```
+
+Use `bayesian`, `tpe`, or one of the accepted Optuna-family aliases when you
+want managed smart search through TraigentBackend.
+
+## Local Defaults
+
+For offline/local SDK runs, keep using `grid` or `random`. These require no
+backend service and remain deterministic/reproducible under the existing local
+SDK execution path.

{traigent-0.16.0 → traigent-0.17.0.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "traigent"
-version = "0.16.0"
+version = "0.17.0.dev0"
 authors = [
     {name = "Traigent Team", email = "opensource@traigent.ai"},
 ]
@@ -45,8 +45,6 @@ dependencies = [
     "backoff>=2.2.0",
     "litellm==1.87.1",  # Stable pin: 1.83.x python-dotenv==1.0.1 and 1.83.14 openai==2.24.0 sub-pins are gone from stable 1.84+ (1.87.1 ships openai>=2.20,<3 and python-dotenv>=1.0,<2, compatible with langchain-openai>=1.1.14). Keep pinned + verified on bumps; no need for RC/dev builds anymore.
     "rank-bm25",
-    # Required by core optimizer modules
-    "optuna>=4.5.0",
     "psutil>=5.8.0",
     # Required by API decorators and config validation
     "pydantic>=2.0.0",

{traigent-0.16.0 → traigent-0.17.0.dev0}/requirements/requirements-all.txt

@@ -4,10 +4,10 @@
 
 -r requirements.txt
 -r requirements-analytics.txt
--r requirements-bayesian.txt
--r requirements-integrations.txt
--r requirements-security.txt
--r requirements-hybrid.txt
+-r requirements-bayesian.txt
+-r requirements-integrations.txt
+-r requirements-security.txt
+-r requirements-hybrid.txt
 
 # Visualization
 matplotlib>=3.5.0

traigent-0.17.0.dev0/requirements/requirements-bayesian.txt

@@ -0,0 +1,2 @@
+scikit-learn>=1.0.0
+scipy>=1.7.0

{traigent-0.16.0 → traigent-0.17.0.dev0}/requirements/requirements-dev.txt

@@ -3,10 +3,10 @@
 # Excludes Chroma until chromadb has a patched release for CVE-2026-45829.
 
 -r requirements.txt
--r requirements-analytics.txt
--r requirements-bayesian.txt
--r requirements-integrations.txt
--r requirements-security.txt
+-r requirements-analytics.txt
+-r requirements-bayesian.txt
+-r requirements-integrations.txt
+-r requirements-security.txt
 
 # Development and testing
 pytest>=9.0.3

{traigent-0.16.0 → traigent-0.17.0.dev0}/requirements/requirements-test.txt

@@ -12,14 +12,14 @@ rapidfuzz>=3.14.0
 # Core dependencies needed for tests
 -r requirements.txt
 
-# Analytics dependencies needed for insights tests
--r requirements-analytics.txt
-
-# Bayesian dependencies needed for optimization tests
--r requirements-bayesian.txt
-
-# Security dependencies needed for enterprise tests
--r requirements-security.txt
+# Analytics dependencies needed for insights tests
+-r requirements-analytics.txt
+
+# Bayesian dependencies needed for optimization tests
+-r requirements-bayesian.txt
+
+# Security dependencies needed for enterprise tests
+-r requirements-security.txt
 
 # Integration dependencies needed for framework tests
 -r requirements-integrations.txt

{traigent-0.16.0 → traigent-0.17.0.dev0}/requirements/requirements.txt

@@ -12,5 +12,4 @@ mcp>=1.27.0
 backoff>=2.2.0
 litellm==1.87.1
 rank-bm25
-optuna>=4.5.0
 psutil>=5.8.0

{traigent-0.16.0 → traigent-0.17.0.dev0}/traigent/config/feature_flags.py

@@ -170,7 +170,7 @@ class FlagRegistry:
 class FlagNames:
     """Canonical flag identifiers used across the codebase."""
 
-    OPTUNA_ROLLOUT = "optimizers.optuna.enabled"
+    LOCAL_ADVANCED_OPTIMIZERS = "optimizers.local_advanced.enabled"
 
 
 # Global registry instance
@@ -179,19 +179,19 @@ flag_registry = FlagRegistry()
 # Register built-in flags
 flag_registry.register(
     Flag(
-        name=FlagNames.OPTUNA_ROLLOUT,
+        name=FlagNames.LOCAL_ADVANCED_OPTIMIZERS,
         default=True,
-        env_var="TRAIGENT_OPTUNA_ENABLED",
-        description="Toggle Optuna-backed optimizers globally.",
-        config_path="optimizers.optuna.enabled",
+        env_var="TRAIGENT_LOCAL_ADVANCED_OPTIMIZERS_ENABLED",
+        description="Toggle local advanced optimizer hooks globally.",
+        config_path="optimizers.local_advanced.enabled",
     )
 )
 
 
-def is_optuna_enabled() -> bool:
-    """Convenience accessor for the Optuna rollout flag."""
+def is_local_advanced_optimizers_enabled() -> bool:
+    """Convenience accessor for the local advanced optimizer flag."""
 
-    return flag_registry.is_enabled(FlagNames.OPTUNA_ROLLOUT)
+    return flag_registry.is_enabled(FlagNames.LOCAL_ADVANCED_OPTIMIZERS)
 
 
 __all__ = [
@@ -199,5 +199,5 @@ __all__ = [
     "FlagNames",
     "FlagRegistry",
     "flag_registry",
-    "is_optuna_enabled",
+    "is_local_advanced_optimizers_enabled",
 ]

{traigent-0.16.0 → traigent-0.17.0.dev0}/traigent/config/seamless_injection.py

@@ -1,4 +1,4 @@
-"""Seamless configuration injection helpers for Optuna-backed flows."""
+"""Seamless configuration injection helpers for optimizer-backed flows."""
 
 # Traceability: CONC-ConfigInjection CONC-Invocation FUNC-API-ENTRY FUNC-INVOKERS REQ-INJ-002 SYNC-OptimizationFlow CONC-Layer-Core
 
@@ -47,7 +47,7 @@ class RuntimeShim:
         self.config: dict[str, Any] = dict(config)
         self._access_log: list[tuple[str, Any]] = []
 
-        trial_id = self.config.get("_optuna_trial_id")
+        trial_id = self.config.get("_optimizer_trial_id")
         if trial_id is not None:
             with self.__class__._cache_lock:
                 cache = self.__class__._state_cache
@@ -99,10 +99,10 @@ class SeamlessInjectionConfigurator:
         *,
         metadata: Mapping[str, Any] | None = None,
     ) -> Callable[..., Any]:
-        if "_optuna_trial_id" not in trial_config:
-            raise ValueError("trial_config must include '_optuna_trial_id'")
+        if "_optimizer_trial_id" not in trial_config:
+            raise ValueError("trial_config must include '_optimizer_trial_id'")
 
-        trial_id = trial_config["_optuna_trial_id"]
+        trial_id = trial_config["_optimizer_trial_id"]
         shim = self._shim_factory(trial_config)
         sanitized_config = {
             key: value for key, value in trial_config.items() if not key.startswith("_")

{traigent-0.16.0 → traigent-0.17.0.dev0}/traigent/core/orchestrator.py

@@ -54,15 +54,14 @@ from traigent.core.cost_enforcement import (
 from traigent.core.cost_estimator import CostEstimator
 from traigent.core.exception_handler import VendorErrorCategory
 from traigent.core.execution_policy_runtime import (
-    CloudBrainUnavailableError,
     SOURCE_CLOUD_BRAIN,
     SOURCE_LOCAL_FALLBACK,
+    CloudBrainUnavailableError,
     backend_egress_disabled,
     is_offline_requested,
     policy_from_config,
     policy_is_cloud_brain,
 )
-from traigent.utils.env_config import is_backend_offline as is_backend_offline  # noqa: F401
 from traigent.core.logger_facade import LoggerFacade
 from traigent.core.metadata_helpers import merge_run_metrics_into_session_summary
 from traigent.core.metric_registry import MetricRegistry, MetricSpec
@@ -103,6 +102,9 @@ from traigent.metrics.registry import clone_registry
 from traigent.optimizers.base import BaseOptimizer
 from traigent.tvl.promotion_gate import PromotionGate
 from traigent.utils.callbacks import CallbackManager, OptimizationCallback, ProgressInfo
+from traigent.utils.env_config import (  # noqa: F401
+    is_backend_offline as is_backend_offline,
+)
 from traigent.utils.exceptions import OptimizationError, VendorPauseError
 from traigent.utils.function_identity import (
     FunctionDescriptor,
@@ -2860,6 +2862,9 @@ class OptimizationOrchestrator:
     ) -> None:
         """Finalize an asked Optuna trial that will never be executed.
 
+        Deferred cleanup: this ask/tell residual is guarded for local execution
+        and should be genericized or removed with the parallel path follow-up.
+
         Creates a TrialResult for the abandoned trial and:
         1. Appends it to self._trials so it appears in OptimizationResult
         2. Logs the trial via the logger facade