"""Prompt composition helpers.""" from __future__ import annotations from dataclasses import dataclass from typing import Any, Mapping @dataclass(frozen=True) class PromptPart: text: str weight: float = 1.0 enabled: bool = True def render(self) -> str: text = self.text.strip() if not text: return "" if self.weight == 1: return text return f"({text}:{self.weight:g})" @dataclass(frozen=True) class PromptResult: prompt: str negative_prompt: str parts: list[str] negative_parts: list[str] def to_dict(self) -> dict[str, Any]: return { "prompt": self.prompt, "negative_prompt": self.negative_prompt, "parts": self.parts, "negative_parts": self.negative_parts, } def compose_prompt( parts: list[str | PromptPart], *, negative_parts: list[str | PromptPart] | None = None, variables: Mapping[str, Any] | None = None, ) -> PromptResult: rendered_parts = _render_parts(parts, variables or {}) rendered_negative = _render_parts(negative_parts or [], variables or {}) return PromptResult( prompt=", ".join(rendered_parts), negative_prompt=", ".join(rendered_negative), parts=rendered_parts, negative_parts=rendered_negative, ) def merge_prompt_sections(*sections: Mapping[str, Any]) -> PromptResult: parts: list[str | PromptPart] = [] negative_parts: list[str | PromptPart] = [] variables: dict[str, Any] = {} for section in sections: variables.update(section.get("variables") or {}) parts.extend(_as_list(section.get("prompt") or section.get("parts"))) negative_parts.extend(_as_list(section.get("negative_prompt") or section.get("negative_parts"))) return compose_prompt(parts, negative_parts=negative_parts, variables=variables) def _render_parts(parts: list[str | PromptPart], variables: Mapping[str, Any]) -> list[str]: rendered: list[str] = [] seen: set[str] = set() for part in parts: prompt_part = part if isinstance(part, PromptPart) else PromptPart(str(part)) if not prompt_part.enabled: continue text = _substitute(prompt_part.render(), variables) if text and text not in seen: rendered.append(text) seen.add(text) return rendered def _substitute(text: str, variables: Mapping[str, Any]) -> str: rendered = text for key, value in variables.items(): rendered = rendered.replace("{" + str(key) + "}", str(value)) return rendered.strip() def _as_list(value: Any) -> list[Any]: if value is None: return [] if isinstance(value, list): return value return [value]