Skip to content

armgit / dify

Public Imported from GitHub
0

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

6.0 KB
Raw Blame
import uuid
from typing import Any, Literal

from pydantic import AliasChoices, BaseModel, Field, field_validator


class SnippetListQuery(BaseModel):
    """Query parameters for listing snippets."""

    page: int = Field(default=1, ge=1, le=99999)
    limit: int = Field(default=20, ge=1, le=100)
    keyword: str | None = None
    is_published: bool | None = Field(default=None, description="Filter by published status")
    creators: list[str] | None = Field(
        default=None,
        description="Filter by creator account IDs",
        validation_alias=AliasChoices("creators", "creator_id"),
    )
    tag_ids: list[str] | None = Field(default=None, description="Filter by tag IDs")

    @field_validator("creators", mode="before")
    @classmethod
    def parse_creators(cls, value: object) -> list[str] | None:
        """Normalize creator filters without comma-splitting list values."""
        if value is None:
            return None
        if isinstance(value, str):
            item = value.strip()
            return [item] if item else None
        return cls._normalize_string_list(value, "creators")

    @field_validator("tag_ids", mode="before")
    @classmethod
    def parse_tag_ids(cls, value: object) -> list[str] | None:
        """Normalize and validate tag IDs from repeated query parameters."""
        items = cls._normalize_string_list(value, "tag_ids")
        if not items:
            return None
        try:
            return [str(uuid.UUID(item)) for item in items]
        except ValueError as exc:
            raise ValueError("Invalid UUID format in tag_ids.") from exc

    @staticmethod
    def _normalize_string_list(value: object, field_name: str) -> list[str] | None:
        if value is None:
            return None
        if isinstance(value, list):
            return [str(item).strip() for item in value if str(item).strip()] or None
        raise ValueError(f"Unsupported {field_name} type.")


class IconInfo(BaseModel):
    """Icon information model."""

    icon: str | None = None
    icon_type: Literal["emoji", "image"] | None = None
    icon_background: str | None = None
    icon_url: str | None = None


class InputFieldDefinition(BaseModel):
    """Input field definition for snippet parameters."""

    default: str | None = None
    hint: bool | None = None
    label: str | None = None
    max_length: int | None = None
    options: list[str] | None = None
    placeholder: str | None = None
    required: bool | None = None
    type: str | None = None  # e.g., "text-input"


class CreateSnippetPayload(BaseModel):
    """Payload for creating a new snippet."""

    name: str = Field(..., min_length=1, max_length=255)
    description: str | None = Field(default=None, max_length=2000)
    type: Literal["node", "group"] = "node"
    icon_info: IconInfo | None = None
    graph: dict[str, Any] | None = Field(default=None)
    input_fields: list[InputFieldDefinition] | None = Field(default_factory=list)


class UpdateSnippetPayload(BaseModel):
    """Payload for updating a snippet."""

    name: str | None = Field(default=None, min_length=1, max_length=255)
    description: str | None = Field(default=None, max_length=2000)
    icon_info: IconInfo | None = None


class SnippetDraftSyncPayload(BaseModel):
    """Payload for syncing snippet draft workflow."""

    graph: dict[str, Any]
    hash: str | None = None
    conversation_variables: list[dict[str, Any]] | None = Field(
        default=None,
        description="Ignored. Snippet workflows do not persist conversation variables.",
    )
    input_fields: list[dict[str, Any]] | None = Field(default=None)


class SnippetWorkflowListQuery(BaseModel):
    """Query parameters for listing snippet published workflows."""

    page: int = Field(default=1, ge=1, le=99999)
    limit: int = Field(default=10, ge=1, le=100)


class SnippetWorkflowRunQuery(BaseModel):
    """Query parameters for workflow runs."""

    last_id: str | None = None
    limit: int = Field(default=20, ge=1, le=100)


class SnippetDraftRunPayload(BaseModel):
    """Payload for running snippet draft workflow."""

    inputs: dict[str, Any]
    files: list[dict[str, Any]] | None = Field(default=None)


class SnippetDraftNodeRunPayload(BaseModel):
    """Payload for running a single node in snippet draft workflow."""

    inputs: dict[str, Any]
    query: str = ""
    files: list[dict[str, Any]] | None = Field(default=None)


class SnippetIterationNodeRunPayload(BaseModel):
    """Payload for running an iteration node in snippet draft workflow."""

    inputs: dict[str, Any] | None = Field(default=None)


class SnippetLoopNodeRunPayload(BaseModel):
    """Payload for running a loop node in snippet draft workflow."""

    inputs: dict[str, Any] | None = Field(default=None)


class SnippetPublishWorkflowPayload(BaseModel):
    """Payload for publishing snippet workflow."""

    knowledge_base_setting: dict[str, Any] | None = Field(default=None)
    marked_name: str | None = Field(default=None, max_length=20)
    marked_comment: str | None = Field(default=None, max_length=100)


class SnippetImportPayload(BaseModel):
    """Payload for importing snippet from DSL."""

    mode: str = Field(..., description="Import mode: yaml-content or yaml-url")
    yaml_content: str | None = Field(default=None, description="YAML content (required for yaml-content mode)")
    yaml_url: str | None = Field(default=None, description="YAML URL (required for yaml-url mode)")
    name: str | None = Field(default=None, description="Override snippet name")
    description: str | None = Field(default=None, description="Override snippet description")
    snippet_id: str | None = Field(default=None, description="Snippet ID to update (optional)")


class IncludeSecretQuery(BaseModel):
    """Query parameter for including secret variables in export."""

    include_secret: str = Field(default="false", description="Whether to include secret variables")


class SnippetExportQuery(IncludeSecretQuery):
    """Query parameters for exporting a snippet workflow as DSL."""

    workflow_id: str | None = Field(default=None, description="Specific published workflow version to export")