@weirdfingers/baseboards 0.5.2 → 0.6.0

package/templates/api/config/generators.yaml

@@ -11,24 +11,99 @@ allow_unlisted: false
 # NOTE: Please keep generators in alphabetical order by class name for easier maintenance
 generators:
   # Fal.ai generators
+  - class: "boards.generators.implementations.fal.audio.beatoven_music_generation.FalBeatovenMusicGenerationGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.audio.beatoven_sound_effect_generation.FalBeatovenSoundEffectGenerationGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.clarity_upscaler.FalClarityUpscalerGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.crystal_upscaler.FalCrystalUpscalerGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.creatify_lipsync.FalCreatifyLipsyncGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.fal_bytedance_seedance_v1_pro_image_to_video.FalBytedanceSeedanceV1ProImageToVideoGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.bytedance_seedance_v1_pro_text_to_video.FalBytedanceSeedanceV1ProTextToVideoGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.audio.elevenlabs_tts_eleven_v3.FalElevenlabsTtsElevenV3Generator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.audio.fal_elevenlabs_tts_turbo_v2_5.FalElevenlabsTtsTurboV25Generator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.flux_2.FalFlux2Generator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.flux_2_edit.FalFlux2EditGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.flux_2_pro.FalFlux2ProGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.flux_2_pro_edit.FalFlux2ProEditGenerator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.image.flux_pro_kontext.FalFluxProKontextGenerator"
     enabled: true
 
   - class: "boards.generators.implementations.fal.image.flux_pro_ultra.FalFluxProUltraGenerator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.image.gemini_25_flash_image.FalGemini25FlashImageGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.gpt_image_1_edit_image.FalGptImage1EditImageGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.gpt_image_1_mini.FalGptImage1MiniGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.fal_ideogram_character.FalIdeogramCharacterGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.ideogram_character_edit.FalIdeogramCharacterEditGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.ideogram_v2.FalIdeogramV2Generator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.image.imagen4_preview_fast.FalImagen4PreviewFastGenerator"
     enabled: true
 
   - class: "boards.generators.implementations.fal.image.imagen4_preview.FalImagen4PreviewGenerator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.audio.elevenlabs_sound_effects_v2.FalElevenlabsSoundEffectsV2Generator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.infinitalk.FalInfinitalkGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.kling_video_v2_5_turbo_pro_image_to_video.FalKlingVideoV25TurboProImageToVideoGenerator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.video.kling_video_v2_5_turbo_pro_text_to_video.FalKlingVideoV25TurboProTextToVideoGenerator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.video.fal_minimax_hailuo_02_standard_text_to_video.FalMinimaxHailuo02StandardTextToVideoGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.minimax_hailuo_2_3_pro_image_to_video.FalMinimaxHailuo23ProImageToVideoGenerator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.audio.minimax_music_v2.FalMinimaxMusicV2Generator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.audio.fal_minimax_speech_26_hd.FalMinimaxSpeech26HdGenerator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.audio.minimax_speech_2_6_turbo.FalMinimaxSpeech26TurboGenerator"
     enabled: true
 
@@ -41,9 +116,42 @@ generators:
   - class: "boards.generators.implementations.fal.image.nano_banana_pro.FalNanoBananaProGenerator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.image.nano_banana_pro_edit.FalNanoBananaProEditGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.fal_pixverse_lipsync.FalPixverseLipsyncGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.qwen_image_edit.FalQwenImageEditGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.image.qwen_image.FalQwenImageGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.sora_2_text_to_video_pro.FalSora2TextToVideoProGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.fal_sora_2_text_to_video.FalSora2TextToVideoGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.sora2_image_to_video.FalSora2ImageToVideoGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.sora_2_image_to_video_pro.FalSora2ImageToVideoProGenerator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.video.sync_lipsync_v2.FalSyncLipsyncV2Generator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.video.veed_lipsync.FalVeedLipsyncGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.sync_lipsync_v2_pro.FalSyncLipsyncV2ProGenerator"
+    enabled: true
+
+  - class: "boards.generators.implementations.fal.video.veo3.FalVeo3Generator"
+    enabled: true
+
   - class: "boards.generators.implementations.fal.video.veo31_first_last_frame_to_video.FalVeo31FirstLastFrameToVideoGenerator"
     enabled: true
 
@@ -53,6 +161,9 @@ generators:
   - class: "boards.generators.implementations.fal.video.veo31_reference_to_video.FalVeo31ReferenceToVideoGenerator"
     enabled: true
 
+  - class: "boards.generators.implementations.fal.video.wan_pro_image_to_video.FalWanProImageToVideoGenerator"
+    enabled: true
+
   # OpenAI generators
   - class: "boards.generators.implementations.openai.image.dalle3.OpenAIDallE3Generator"
     enabled: true

package/templates/api/src/boards/__init__.py

@@ -3,7 +3,7 @@ Boards Backend SDK
 Open-source creative toolkit for AI-generated content
 """
 
-__version__ = "0.5.2"
+__version__ = "0.6.0"
 
 from .config import settings
 

package/templates/api/src/boards/api/app.py

@@ -142,13 +142,14 @@ def create_app() -> FastAPI:
             raise
 
     # REST API endpoints (for SSE, webhooks, etc.)
-    from .endpoints import jobs, setup, sse, storage, tenant_registration, webhooks
+    from .endpoints import jobs, setup, sse, storage, tenant_registration, uploads, webhooks
 
     app.include_router(sse.router, prefix="/api/sse", tags=["SSE"])
     app.include_router(jobs.router, prefix="/api/jobs", tags=["Jobs"])
     app.include_router(webhooks.router, prefix="/api/webhooks", tags=["Webhooks"])
     app.include_router(storage.router, prefix="/api/storage", tags=["Storage"])
     app.include_router(setup.router, prefix="/api/setup", tags=["Setup"])
+    app.include_router(uploads.router, prefix="/api", tags=["Uploads"])
     app.include_router(
         tenant_registration.router, prefix="/api/tenants", tags=["Tenant Registration"]
     )

package/templates/api/src/boards/api/endpoints/tenant_registration.py

@@ -69,7 +69,7 @@ class TenantRegistrationRequest(BaseModel):
         if v is not None:
             valid_sizes = {"small", "medium", "large", "enterprise"}
             if v.lower() not in valid_sizes:
-                raise ValueError(f'Organization size must be one of: {", ".join(valid_sizes)}')
+                raise ValueError(f"Organization size must be one of: {', '.join(valid_sizes)}")
         return v.lower() if v else None
 
 

package/templates/api/src/boards/api/endpoints/uploads.py

@@ -0,0 +1,150 @@
+"""File upload endpoints for artifact uploads."""
+
+import os
+from typing import Annotated
+from uuid import UUID
+
+from fastapi import APIRouter, Depends, File, Form, HTTPException, UploadFile
+
+from ...auth import get_auth_context
+from ...auth.context import AuthContext
+from ...config import settings
+from ...logging import get_logger
+
+router = APIRouter(prefix="/uploads", tags=["uploads"])
+logger = get_logger(__name__)
+
+
+@router.post("/artifact")
+async def upload_artifact_file(
+    board_id: Annotated[str, Form()],
+    artifact_type: Annotated[str, Form()],  # image, video, audio, text
+    file: UploadFile = File(...),
+    user_description: Annotated[str | None, Form()] = None,
+    parent_generation_id: Annotated[str | None, Form()] = None,
+    auth_context: AuthContext = Depends(get_auth_context),
+) -> dict:
+    """
+    Upload artifact file (synchronous).
+
+    Args:
+        board_id: UUID of the board to upload to
+        artifact_type: Type of artifact (image, video, audio, text)
+        file: The file to upload
+        user_description: Optional description provided by user
+        parent_generation_id: Optional parent generation UUID
+        auth_context: Authentication context
+
+    Returns:
+        Generation object as JSON
+
+    Raises:
+        HTTPException: If validation fails or upload errors occur
+    """
+    from ...graphql.resolvers.upload import upload_artifact_from_file
+
+    # Validate authentication
+    if not auth_context.is_authenticated or not auth_context.user_id:
+        raise HTTPException(
+            status_code=401,
+            detail="Authentication required",
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    # Validate artifact type
+    valid_types = {"image", "video", "audio", "text"}
+    if artifact_type not in valid_types:
+        raise HTTPException(
+            status_code=400,
+            detail=f"Invalid artifact_type. Must be one of: {', '.join(valid_types)}",
+        )
+
+    # Read file content
+    try:
+        content = await file.read()
+    except Exception as e:
+        logger.error("Failed to read uploaded file", error=str(e), filename=file.filename)
+        raise HTTPException(
+            status_code=400,
+            detail="Failed to read uploaded file",
+        ) from e
+
+    # Validate file size
+    if len(content) > settings.max_upload_size:
+        raise HTTPException(
+            status_code=413,
+            detail=(
+                f"File size {len(content)} bytes exceeds maximum allowed size "
+                f"of {settings.max_upload_size} bytes"
+            ),
+        )
+
+    # Validate extension
+    file_ext = os.path.splitext(file.filename or "")[1].lower()
+    if file_ext and file_ext not in settings.allowed_upload_extensions:
+        allowed_exts = ", ".join(settings.allowed_upload_extensions)
+        raise HTTPException(
+            status_code=400,
+            detail=(
+                f"File extension '{file_ext}' is not allowed. "
+                f"Allowed extensions: {allowed_exts}"
+            ),
+        )
+
+    # Parse UUIDs
+    try:
+        board_uuid = UUID(board_id)
+        parent_uuid = UUID(parent_generation_id) if parent_generation_id else None
+    except ValueError as e:
+        logger.warning("Invalid UUID provided", board_id=board_id, error=str(e))
+        raise HTTPException(
+            status_code=400,
+            detail="Invalid board_id or parent_generation_id format",
+        ) from e
+
+    # Call resolver
+    try:
+        generation = await upload_artifact_from_file(
+            auth_context=auth_context,
+            board_id=board_uuid,
+            artifact_type=artifact_type,
+            file_content=content,
+            filename=file.filename,
+            content_type=file.content_type,
+            user_description=user_description,
+            parent_generation_id=parent_uuid,
+        )
+
+        logger.info(
+            "File upload successful",
+            generation_id=str(generation.id),
+            artifact_type=artifact_type,
+            file_size=len(content),
+        )
+
+        return {
+            "id": str(generation.id),
+            "status": generation.status.value,
+            "storageUrl": generation.storage_url,
+            "thumbnailUrl": generation.thumbnail_url,
+            "artifactType": generation.artifact_type.value,
+            "generatorName": generation.generator_name,
+        }
+
+    except RuntimeError as e:
+        # These are expected errors (permission denied, board not found, etc.)
+        # Pass through the message since these are safe, user-facing errors
+        logger.warning("Upload failed", error=str(e))
+        raise HTTPException(status_code=400, detail=str(e)) from e
+    except Exception as e:
+        # Unexpected errors - don't expose internal details
+        logger.error(
+            "Unexpected error during upload",
+            error=str(e),
+            board_id=board_id,
+            artifact_type=artifact_type,
+        )
+        raise HTTPException(
+            status_code=500,
+            detail="An unexpected error occurred during upload",
+        ) from e

package/templates/api/src/boards/auth/factory.py

@@ -75,7 +75,7 @@ def get_auth_adapter() -> AuthAdapter:
         secret_key = config.get("secret_key") or os.getenv("CLERK_SECRET_KEY")
         if not secret_key:
             raise ValueError(
-                "Clerk secret key is required. " "Set CLERK_SECRET_KEY or provide in config."
+                "Clerk secret key is required. Set CLERK_SECRET_KEY or provide in config."
             )
 
         return ClerkAuthAdapter(

package/templates/api/src/boards/dbmodels/__init__.py

@@ -11,7 +11,6 @@ from typing import Any
 from uuid import UUID
 
 from sqlalchemy import (
-    ARRAY,
     Boolean,
     CheckConstraint,
     Column,
@@ -43,7 +42,7 @@ naming_convention = {
 class Base(DeclarativeBase):
     """Base class for all database models with type checking support."""
 
-    metadata = MetaData(naming_convention=naming_convention)
+    metadata = MetaData(naming_convention=naming_convention, schema="boards")
 
 
 class Tenants(Base):
@@ -322,11 +321,6 @@ class Generations(Base):
             ondelete="CASCADE",
             name="generations_board_id_fkey",
         ),
-        ForeignKeyConstraint(
-            ["parent_generation_id"],
-            ["generations.id"],
-            name="generations_parent_generation_id_fkey",
-        ),
         ForeignKeyConstraint(
             ["tenant_id"],
             ["tenants.id"],
@@ -341,10 +335,14 @@ class Generations(Base):
         ),
         PrimaryKeyConstraint("id", name="generations_pkey"),
         Index("idx_generations_board", "board_id"),
-        Index("idx_generations_lineage", "parent_generation_id"),
         Index("idx_generations_status", "status"),
         Index("idx_generations_tenant", "tenant_id"),
         Index("idx_generations_user", "user_id"),
+        Index(
+            "idx_generations_input_artifacts_gin",
+            "input_artifacts",
+            postgresql_using="gin",
+        ),
     )
 
     id: Mapped[UUID] = mapped_column(Uuid, server_default=text("uuid_generate_v4()"))
@@ -363,9 +361,8 @@ class Generations(Base):
     output_metadata: Mapped[dict[str, Any]] = mapped_column(
         JSONB, server_default=text("'{}'::jsonb")
     )
-    parent_generation_id: Mapped[UUID | None] = mapped_column(Uuid)
-    input_generation_ids: Mapped[list[UUID]] = mapped_column(
-        ARRAY(Uuid()), server_default=text("'{}'::uuid[]")
+    input_artifacts: Mapped[list[dict[str, Any]]] = mapped_column(
+        JSONB, server_default=text("'[]'::jsonb")
     )
     external_job_id: Mapped[str | None] = mapped_column(String(255))
     progress: Mapped[Decimal] = mapped_column(Numeric(5, 2), server_default=text("0.0"))
@@ -380,17 +377,6 @@ class Generations(Base):
     )
 
     board: Mapped["Boards"] = relationship("Boards", back_populates="generations")
-    parent_generation: Mapped["Generations | None"] = relationship(
-        "Generations",
-        remote_side="Generations.id",
-        back_populates="parent_generation_reverse",
-    )
-    parent_generation_reverse: Mapped[list["Generations"]] = relationship(
-        "Generations",
-        uselist=True,
-        remote_side="Generations.parent_generation_id",
-        back_populates="parent_generation",
-    )
     tenant: Mapped["Tenants"] = relationship("Tenants", back_populates="generations")
     user: Mapped["Users"] = relationship("Users", back_populates="generations")
     credit_transactions: Mapped[list["CreditTransactions"]] = relationship(

package/templates/api/src/boards/generators/artifact_resolution.py

@@ -59,7 +59,9 @@ def _extract_artifact_type(annotation: Any) -> type[TArtifact] | None:
     return None
 
 
-def extract_artifact_fields(schema: type[BaseModel]) -> dict[str, tuple[type[TArtifact], bool]]:
+def extract_artifact_fields(
+    schema: type[BaseModel],
+) -> dict[str, tuple[type[TArtifact], bool]]:
     """Automatically extract artifact fields from a Pydantic schema.
 
     Inspects the schema's field annotations and returns a mapping of field names
@@ -93,7 +95,14 @@ def extract_artifact_fields(schema: type[BaseModel]) -> dict[str, tuple[type[TAr
     return artifact_fields
 
 
-def _get_artifact_type_name[T: (ImageArtifact, VideoArtifact, AudioArtifact, TextArtifact)](
+def _get_artifact_type_name[
+    T: (
+        ImageArtifact,
+        VideoArtifact,
+        AudioArtifact,
+        TextArtifact,
+    )
+](
     artifact_class: type[T],
 ) -> str:
     """Get the database artifact_type string for an artifact class."""
@@ -109,9 +118,14 @@ def _get_artifact_type_name[T: (ImageArtifact, VideoArtifact, AudioArtifact, Tex
     return artifact_type
 
 
-def _generation_to_artifact[T: (ImageArtifact, VideoArtifact, AudioArtifact, TextArtifact)](
-    generation: Generations, artifact_class: type[T]
-) -> T:
+def _generation_to_artifact[
+    T: (
+        ImageArtifact,
+        VideoArtifact,
+        AudioArtifact,
+        TextArtifact,
+    )
+](generation: Generations, artifact_class: type[T]) -> T:
     """Convert a Generations database record to an artifact object.
 
     Args:
@@ -183,7 +197,12 @@ def _generation_to_artifact[T: (ImageArtifact, VideoArtifact, AudioArtifact, Tex
 
 
 async def resolve_generation_ids_to_artifacts[
-    T: (ImageArtifact, VideoArtifact, AudioArtifact, TextArtifact)
+    T: (
+        ImageArtifact,
+        VideoArtifact,
+        AudioArtifact,
+        TextArtifact,
+    )
 ](
     generation_ids: list[str | UUID],
     artifact_class: type[T],
@@ -251,7 +270,7 @@ async def resolve_input_artifacts(
     schema: type[BaseModel],
     session: AsyncSession,
     tenant_id: UUID,
-) -> dict[str, Any]:
+) -> tuple[dict[str, Any], list[dict[str, Any]]]:
     """Resolve generation IDs to artifact objects in input parameters.
 
     This function automatically detects artifact fields from the Pydantic schema
@@ -271,7 +290,7 @@ async def resolve_input_artifacts(
 
     Usage in actors.py:
         # Artifacts are automatically detected and resolved
-        resolved_params = await resolve_input_artifacts(
+        resolved_params, lineage_metadata = await resolve_input_artifacts(
             input_params,
             MyGeneratorInput,  # Just pass the schema class
             session,
@@ -287,7 +306,9 @@ async def resolve_input_artifacts(
         tenant_id: Tenant ID for access validation
 
     Returns:
-        Updated input_params dictionary with generation IDs resolved to artifacts
+        Tuple of (resolved_params, lineage_metadata):
+        - resolved_params: Updated input_params dictionary with generation IDs resolved to artifacts
+        - lineage_metadata: List of dicts with generation_id, role, and artifact_type for lineage
 
     Raises:
         ValueError: If any generation ID cannot be resolved or validated
@@ -295,13 +316,14 @@ async def resolve_input_artifacts(
     # Automatically extract artifact fields from schema
     artifact_field_map = extract_artifact_fields(schema)
 
-    # If no artifact fields, just return original params
+    # If no artifact fields, just return original params with empty lineage
     if not artifact_field_map:
-        return input_params
+        return input_params, []
 
     # Create a new dict with resolved artifacts
     # Use dict constructor to avoid shallow copy issues
     resolved_params = dict(input_params)
+    lineage_metadata: list[dict[str, Any]] = []
 
     for field_name, (artifact_class, expects_list) in artifact_field_map.items():
         field_value = resolved_params.get(field_name)
@@ -343,6 +365,17 @@ async def resolve_input_artifacts(
         except ValueError as e:
             raise ValueError(f"Failed to resolve field '{field_name}': {e}") from e
 
+        # Capture lineage metadata for each artifact
+        artifact_type_name = _get_artifact_type_name(artifact_class)
+        for gen_id in generation_ids:
+            lineage_metadata.append(
+                {
+                    "generation_id": str(gen_id),
+                    "role": field_name,  # Field name IS the role!
+                    "artifact_type": artifact_type_name,
+                }
+            )
+
         # Update params with resolved artifacts
         # If field expects a single artifact (not a list), unwrap the first artifact
         # Otherwise, keep as a list (even if there's only one artifact)
@@ -369,4 +402,4 @@ async def resolve_input_artifacts(
 
         resolved_params[field_name] = resolved_value
 
-    return resolved_params
+    return resolved_params, lineage_metadata

package/templates/api/src/boards/generators/implementations/fal/audio/__init__.py

@@ -1,4 +1,19 @@
+from .beatoven_music_generation import FalBeatovenMusicGenerationGenerator
+from .beatoven_sound_effect_generation import FalBeatovenSoundEffectGenerationGenerator
+from .elevenlabs_sound_effects_v2 import FalElevenlabsSoundEffectsV2Generator
+from .elevenlabs_tts_eleven_v3 import FalElevenlabsTtsElevenV3Generator
+from .fal_elevenlabs_tts_turbo_v2_5 import FalElevenlabsTtsTurboV25Generator
+from .fal_minimax_speech_26_hd import FalMinimaxSpeech26HdGenerator
 from .minimax_music_v2 import FalMinimaxMusicV2Generator
 from .minimax_speech_2_6_turbo import FalMinimaxSpeech26TurboGenerator
 
-__all__ = ["FalMinimaxSpeech26TurboGenerator", "FalMinimaxMusicV2Generator"]
+__all__ = [
+    "FalBeatovenMusicGenerationGenerator",
+    "FalBeatovenSoundEffectGenerationGenerator",
+    "FalElevenlabsSoundEffectsV2Generator",
+    "FalElevenlabsTtsElevenV3Generator",
+    "FalElevenlabsTtsTurboV25Generator",
+    "FalMinimaxMusicV2Generator",
+    "FalMinimaxSpeech26HdGenerator",
+    "FalMinimaxSpeech26TurboGenerator",
+]