Merge pull request #417 from Pipelex/release/v0.14.3

lchoquel · web-flow · commit d9c4ffb68f78 · 2025-10-29T13:52:07.000-07:00
Release/v0.14.3
diff --git a/.blackboxrules b/.blackboxrules
diff --git a/.pipelex/inference/backends/blackboxai.toml b/.pipelex/inference/backends/blackboxai.toml
@@ -78,12 +78,18 @@ inputs = ["text", "images"]
 outputs = ["text", "structured"]
 costs = { input = 15.00, output = 75.00 }
 
-[claude-sonnet-4]
+[claude-4-sonnet]
 model_id = "blackboxai/anthropic/claude-sonnet-4"
 inputs = ["text", "images"]
 outputs = ["text", "structured"]
 costs = { input = 3.00, output = 15.00 }
 
+["claude-4.5-sonnet"]
+model_id = "blackboxai/anthropic/claude-sonnet-4.5"
+inputs = ["text", "images"]
+outputs = ["text", "structured"]
+costs = { input = 0.28, output = 1.10 }
+
 # --- Google Models ------------------------------------------------------------
 ["gemini-2.5-flash"]
 model_id = "blackboxai/google/gemini-2.5-flash"
@@ -179,3 +185,47 @@ inputs = ["text"]
 outputs = ["text", "structured"]
 costs = { input = 0.00, output = 0.00 }
 
+
+################################################################################
+# IMAGE GENERATION MODELS
+################################################################################
+
+[flux-pro]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-pro"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.04 }
+
+["flux-pro/v1.1"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-1.1-pro"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.04 }
+
+["flux-pro/v1.1-ultra"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-1.1-pro-ultra"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.06 }
+
+["fast-lightning-sdxl"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/bytedance/sdxl-lightning-4step"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.0014 }
+
+[nano-banana]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/google/nano-banana"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.039 }
diff --git a/.pipelex/inference/deck/base_deck.toml b/.pipelex/inference/deck/base_deck.toml
@@ -18,11 +18,11 @@
 
 [aliases]
 base-claude = "claude-4.5-sonnet"
-base-gpt = "gpt-5"
+base-gpt = "gpt-4o"
 base-gemini = "gemini-2.5-flash"
 base-mistral = "mistral-medium"
 
-best-gpt = "gpt-5"
+best-gpt = "gpt-4o"
 best-claude = "claude-4.1-opus"
 best-gemini = "gemini-2.5-pro"
 best-mistral = "mistral-medium"
@@ -40,14 +40,14 @@ smart_llm = [
     "claude-4.5-sonnet",
     "claude-4.1-opus",
     "claude-4-sonnet",
-    "gpt-5",
     "gemini-2.5-pro",
+    "gpt-5",
 ]
 llm_for_large_codebase = ["gemini-2.5-pro", "claude-4.5-sonnet", "gpt-5"]
 
 # Image generation aliases
-base-img-gen = "flux-pro/v1.1"
-best-img-gen = "flux-pro/v1.1-ultra"
+base-img-gen = "flux-pro/v1.1-ultra"
+best-img-gen = "nano-banana"
 fast-img-gen = "fast-lightning-sdxl"
 
 ####################################################################################################
diff --git a/.pipelex/inference/routing_profiles.toml b/.pipelex/inference/routing_profiles.toml
@@ -35,11 +35,16 @@ default = "pipelex_inference"
 "claude-*" = "pipelex_inference"
 "grok-*" = "pipelex_inference"
 "gemini-*" = "pipelex_inference"
-"*-sdxl" = "fal"
-"flux-*" = "fal"
+"*-sdxl" = "blackboxai"
+"flux-*" = "blackboxai"
+"nano-banana" = "blackboxai"
 "gpt-image-1" = "openai"
 "mistral-ocr" = "mistral"
 
+[profiles.all_blackboxai]
+description = "Use BlackBoxAI backend for all its supported models"
+default = "blackboxai"
+
 [profiles.all_bedrock]
 description = "Use Bedrock backend for all its supported models"
 default = "bedrock"
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,19 +1,32 @@
 # Changelog
 
+## [v0.14.3] - 2025-10-29
+
+### Added
+ - Image generation models via BlackBoxAI backend: `flux-pro`, `flux-pro/v1.1`, `flux-pro/v1.1-ultra` (Black Forest Labs), `fast-lightning-sdxl` (ByteDance), and `nano-banana` (Google). Implemented using new `openai_alt_img_gen` SDK worker with chat completion-style API.
+ - Language model: `claude-4.5-sonnet` (Anthropic) via BlackBoxAI backend.
+ - Routing profile: `all_blackboxai` profile routes all supported model requests to BlackBoxAI backend.
+
+### Changed
+ - Model aliases in `base_deck.toml`: `base-img-gen` → `flux-pro/v1.1-ultra`, `best-img-gen` → `nano-banana`, `llm_for_large_codebase` now includes `claude-4.5-sonnet`.
+ - Configuration file: `BLACKBOX_RULES.md` renamed to `.blackboxrules`.
+
+### Fixed
+ - Image generation schema: `ImgGenJobParams.seed` field now explicitly defined with `default=None`.
+ - CLI bundle validation: `pipelex validate` command now accepts bundle path (`.plx` file) which are in the package and already loaded and performs dry run on all pipes in the bundle.
+
+
 ## [v0.14.2] - 2025-10-29
 
 ### Chaged
-
 - Improved pipe builder.
 
 ### Added
-
 - CLI to generate inputs JSON.
 
 ## [v0.14.1] - 2025-10-27
 
 ### Added
-
 - Tutorial GIF on the README.md file.
 
 ## [v0.14.0] - 2025-10-27
diff --git a/pipelex/cli/commands/validate_cmd.py b/pipelex/cli/commands/validate_cmd.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import asyncio
+from pathlib import Path
 from typing import TYPE_CHECKING, Annotated
 
 import click
@@ -15,15 +16,17 @@
 from pipelex.builder.builder_validation import validate_dry_run_bundle_blueprint
 from pipelex.core.interpreter import PipelexInterpreter
 from pipelex.exceptions import LibraryLoadingError, PipeInputError
-from pipelex.hub import get_pipes, get_required_pipe, get_telemetry_manager
+from pipelex.hub import get_library_manager, get_pipes, get_required_pipe, get_telemetry_manager
 from pipelex.pipe_run.dry_run import dry_run_pipe, dry_run_pipes
 from pipelex.pipelex import Pipelex
 from pipelex.system.runtime import IntegrationMode
 from pipelex.system.telemetry.events import EventName, EventProperty
 from pipelex.tools.misc.package_utils import get_package_version
 
 if TYPE_CHECKING:
+    from pipelex.core.pipes.pipe_abstract import PipeAbstract
     from pipelex.core.validation_errors import ValidationErrorDetailsProtocol
+
 console = Console()
 
 COMMAND = "validate"
@@ -118,6 +121,19 @@ def validate_cmd(
 
     async def validate_pipe(pipe_code: str | None = None, bundle_path: str | None = None):
         if bundle_path:
+            absolute_bundle_path = str(Path(bundle_path).resolve())
+            if absolute_bundle_path in get_library_manager().get_loaded_plx_paths():
+                bundle_blueprint = PipelexInterpreter.load_bundle_blueprint(bundle_path=bundle_path)
+                if not bundle_blueprint.pipe:
+                    typer.secho(f"Failed to validate bundle '{bundle_path}': no pipes found in bundle", fg=typer.colors.RED, err=True)
+                    raise typer.Exit(1)
+                pipe_codes = list(bundle_blueprint.pipe.keys())
+                pipes: list[PipeAbstract] = []
+                for the_pipe_code in pipe_codes:
+                    pipes.append(get_required_pipe(pipe_code=the_pipe_code))
+                await dry_run_pipes(pipes=pipes, raise_on_failure=True)
+                typer.secho(f"✅ Successfully validated all pipes in bundle '{bundle_path}'", fg=typer.colors.GREEN)
+                return
             # When validating a bundle, load_pipe_from_bundle validates ALL pipes in the bundle
             try:
                 bundle_blueprint = PipelexInterpreter.load_bundle_blueprint(bundle_path=bundle_path)
diff --git a/pipelex/cogt/img_gen/img_gen_job_components.py b/pipelex/cogt/img_gen/img_gen_job_components.py
@@ -46,7 +46,7 @@ class ImgGenJobParams(BaseModel):
     safety_tolerance: int | None = Field(default=None, ge=1, le=6)
     is_raw: bool
     output_format: OutputFormat = Field(strict=False)
-    seed: int | None = Field(None, ge=0)
+    seed: int | None = Field(default=None, ge=0)
 
 
 class ImgGenJobParamsDefaults(ConfigModel):
diff --git a/pipelex/cogt/img_gen/img_gen_worker_factory.py b/pipelex/cogt/img_gen/img_gen_worker_factory.py
@@ -70,6 +70,23 @@ def make_img_gen_worker(
                     inference_model=inference_model,
                     reporting_delegate=reporting_delegate,
                 )
+            case "openai_alt_img_gen":
+                from pipelex.plugins.openai.openai_factory import OpenAIFactory  # noqa: PLC0415
+                from pipelex.plugins.openai.openai_img_gen_alt_worker import OpenAIImgGenAlternativeWorker  # noqa: PLC0415
+
+                img_gen_sdk_instance = plugin_sdk_registry.get_sdk_instance(plugin=plugin) or plugin_sdk_registry.set_sdk_instance(
+                    plugin=plugin,
+                    sdk_instance=OpenAIFactory.make_openai_client(
+                        plugin=plugin,
+                        backend=backend,
+                    ),
+                )
+
+                img_gen_worker = OpenAIImgGenAlternativeWorker(
+                    sdk_instance=img_gen_sdk_instance,
+                    inference_model=inference_model,
+                    reporting_delegate=reporting_delegate,
+                )
             case _:
                 msg = f"Plugin '{plugin}' is not supported for image generation"
                 raise NotImplementedError(msg)
diff --git a/pipelex/kit/configs/inference/backends/blackboxai.toml b/pipelex/kit/configs/inference/backends/blackboxai.toml
@@ -78,12 +78,18 @@ inputs = ["text", "images"]
 outputs = ["text", "structured"]
 costs = { input = 15.00, output = 75.00 }
 
-[claude-sonnet-4]
+[claude-4-sonnet]
 model_id = "blackboxai/anthropic/claude-sonnet-4"
 inputs = ["text", "images"]
 outputs = ["text", "structured"]
 costs = { input = 3.00, output = 15.00 }
 
+["claude-4.5-sonnet"]
+model_id = "blackboxai/anthropic/claude-sonnet-4.5"
+inputs = ["text", "images"]
+outputs = ["text", "structured"]
+costs = { input = 0.28, output = 1.10 }
+
 # --- Google Models ------------------------------------------------------------
 ["gemini-2.5-flash"]
 model_id = "blackboxai/google/gemini-2.5-flash"
@@ -179,3 +185,47 @@ inputs = ["text"]
 outputs = ["text", "structured"]
 costs = { input = 0.00, output = 0.00 }
 
+
+################################################################################
+# IMAGE GENERATION MODELS
+################################################################################
+
+[flux-pro]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-pro"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.04 }
+
+["flux-pro/v1.1"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-1.1-pro"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.04 }
+
+["flux-pro/v1.1-ultra"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/black-forest-labs/flux-1.1-pro-ultra"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.06 }
+
+["fast-lightning-sdxl"]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/bytedance/sdxl-lightning-4step"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.0014 }
+
+[nano-banana]
+model_type = "img_gen"
+sdk = "openai_alt_img_gen"
+model_id = "blackboxai/google/nano-banana"
+inputs = ["text"]
+outputs = ["image"]
+costs = { input = 0.0, output = 0.039 }
diff --git a/pipelex/kit/configs/inference/deck/base_deck.toml b/pipelex/kit/configs/inference/deck/base_deck.toml
@@ -18,11 +18,11 @@
 
 [aliases]
 base-claude = "claude-4.5-sonnet"
-base-gpt = "gpt-5"
+base-gpt = "gpt-4o"
 base-gemini = "gemini-2.5-flash"
 base-mistral = "mistral-medium"
 
-best-gpt = "gpt-5"
+best-gpt = "gpt-4o"
 best-claude = "claude-4.1-opus"
 best-gemini = "gemini-2.5-pro"
 best-mistral = "mistral-medium"
@@ -40,8 +40,8 @@ smart_llm = [
     "claude-4.5-sonnet",
     "claude-4.1-opus",
     "claude-4-sonnet",
-    "gpt-5",
     "gemini-2.5-pro",
+    "gpt-4o",
 ]
 llm_for_large_codebase = ["gemini-2.5-pro", "claude-4.5-sonnet", "gpt-5"]
 
diff --git a/pipelex/kit/configs/inference/routing_profiles.toml b/pipelex/kit/configs/inference/routing_profiles.toml
@@ -29,14 +29,19 @@ active = "pipelex_first"
 description = "Use Pipelex Inference backend for all its supported models"
 default = "pipelex_inference"
 
+[profiles.all_blackboxai]
+description = "Use BlackBoxAI backend for all its supported models"
+default = "blackboxai"
+
 [profiles.pipelex_first.routes]
 # Pattern matching: "model-pattern" = "backend-name"
 "gpt-*" = "pipelex_inference"
 "claude-*" = "pipelex_inference"
 "grok-*" = "pipelex_inference"
 "gemini-*" = "pipelex_inference"
-"*-sdxl" = "fal"
-"flux-*" = "fal"
+"*-sdxl" = "blackboxai"
+"flux-*" = "blackboxai"
+"nano-banana" = "blackboxai"
 "gpt-image-1" = "openai"
 "mistral-ocr" = "mistral"
 
diff --git a/pipelex/kit/index.toml b/pipelex/kit/index.toml
@@ -86,7 +86,7 @@ marker_end = "<!-- END_PIPELEX_RULES -->"
 heading_1 = "# Pipelex Rules"
 
 [agent_rules.targets.blackbox]
-path = "BLACKBOX_RULES.md"
+path = ".blackboxrules"
 marker_begin = "<!-- BEGIN_PIPELEX_RULES -->"
 marker_end = "<!-- END_PIPELEX_RULES -->"
 heading_1 = "# Pipelex Rules"
diff --git a/pipelex/libraries/library_manager.py b/pipelex/libraries/library_manager.py
@@ -73,6 +73,7 @@ def __init__(
         self.domain_library = domain_library
         self.concept_library = concept_library
         self.pipe_library = pipe_library
+        self.loaded_plx_paths: list[str] = []
 
     @override
     def validate_libraries(self):
@@ -97,6 +98,10 @@ def reset(self) -> None:
         self.teardown()
         self.setup()
 
+    @override
+    def get_loaded_plx_paths(self) -> list[str]:
+        return self.loaded_plx_paths
+
     def _get_pipelex_plx_files_from_dirs(self, dirs: set[Path]) -> list[Path]:
         """Get all valid Pipelex PLX files from the given directories."""
         all_plx_paths: list[Path] = []
@@ -347,6 +352,8 @@ def load_libraries(
             blueprint.source = str(plx_file_path)
             blueprints.append(blueprint)
 
+        self.loaded_plx_paths.extend([str(plx_file_path) for plx_file_path in valid_plx_paths])
+
         # Load all domains first
         all_domains: list[Domain] = []
         for blueprint in blueprints:
diff --git a/pipelex/libraries/library_manager_abstract.py b/pipelex/libraries/library_manager_abstract.py
@@ -22,6 +22,10 @@ def reset(self) -> None:
     def validate_libraries(self) -> None:
         pass
 
+    @abstractmethod
+    def get_loaded_plx_paths(self) -> list[str]:
+        pass
+
     @abstractmethod
     def load_libraries(self, library_dirs: list[Path] | None = None, library_file_paths: list[Path] | None = None) -> None:
         pass
diff --git a/pipelex/plugins/openai/openai_factory.py b/pipelex/plugins/openai/openai_factory.py
diff --git a/pipelex/plugins/openai/openai_img_gen_alt_worker.py b/pipelex/plugins/openai/openai_img_gen_alt_worker.py
diff --git a/pyproject.toml b/pyproject.toml
diff --git a/tests/integration/pipelex/conftest.py b/tests/integration/pipelex/conftest.py
diff --git a/uv.lock b/uv.lock
