"""Repository for character_profiles.""" from __future__ import annotations import json from typing import Any from backend.dto.profile_dto import CharacterProfile, ProfileListResult from database.db_helper import Database PROFILE_COLUMNS = """ profile_id, name, description, base_prompt, appearance_prompt, style_prompt, negative_prompt, default_model_route, owner_platform, owner_context_id, owner_user_id, owner_session_key, avatar_image_uri, status, metadata_json, created_at, updated_at """ def _sql_literal(fragment: str, placeholder: str) -> str: """Make a SQL fragment containing ``%`` safe for the active driver. The three ``LIKE '%"final_archive_history_id"%'`` predicates below are inlined into parameterised queries. psycopg treats the whole query as a ``%``-format template, so under ``backend: postgresql`` every one of these raised before a row came back -- ``get()`` and ``list()``, the two hottest profile reads, failed 100% of the time. SQLite's ``?`` placeholders do no such interpolation and must be left alone. """ return fragment.replace("%", "%%") if placeholder == "%s" else fragment PROFILE_GENERATION_KIND_COLUMN = """ CASE WHEN EXISTS ( SELECT 1 FROM character_profile_cards AS profile_card WHERE profile_card.profile_id = character_profiles.profile_id AND LOWER(COALESCE(profile_card.status, '')) = 'sealed' ) THEN 'detailed' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS legacy_card_workflow WHERE legacy_card_workflow.profile_id = character_profiles.profile_id AND legacy_card_workflow.workflow_type = 'character_gradual' AND LOWER(COALESCE(legacy_card_workflow.status, '')) IN ('completed', 'archived') AND COALESCE(legacy_card_workflow.metadata_json, '') LIKE '%"final_archive_history_id"%' ) THEN 'detailed' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS quick_workflow WHERE quick_workflow.profile_id = character_profiles.profile_id AND quick_workflow.workflow_type = 'character_fast' AND LOWER(COALESCE(quick_workflow.status, '')) IN ('active', 'running', 'review', 'completed') ) THEN 'quick' ELSE 'ungenerated' END AS generation_kind """ PROFILE_CATEGORY_COLUMN = """ CASE WHEN EXISTS ( SELECT 1 FROM character_profile_cards AS profile_card WHERE profile_card.profile_id = character_profiles.profile_id AND LOWER(COALESCE(profile_card.status, '')) = 'sealed' ) THEN 'profile_card' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS legacy_card_workflow WHERE legacy_card_workflow.profile_id = character_profiles.profile_id AND legacy_card_workflow.workflow_type = 'character_gradual' AND LOWER(COALESCE(legacy_card_workflow.status, '')) IN ('completed', 'archived') AND COALESCE(legacy_card_workflow.metadata_json, '') LIKE '%"final_archive_history_id"%' ) THEN 'profile_card' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS quick_workflow WHERE quick_workflow.profile_id = character_profiles.profile_id AND quick_workflow.workflow_type = 'character_fast' AND LOWER(COALESCE(quick_workflow.status, '')) IN ('active', 'running', 'review', 'completed', 'archived') ) THEN 'quick' ELSE 'ungenerated' END AS profile_category """ DETAILED_WORKFLOW_STATE_COLUMN = """ CASE WHEN EXISTS ( SELECT 1 FROM character_profile_cards AS profile_card WHERE profile_card.profile_id = character_profiles.profile_id AND LOWER(COALESCE(profile_card.status, '')) = 'sealed' ) OR EXISTS ( SELECT 1 FROM profile_workflows AS legacy_card_workflow WHERE legacy_card_workflow.profile_id = character_profiles.profile_id AND legacy_card_workflow.workflow_type = 'character_gradual' AND LOWER(COALESCE(legacy_card_workflow.status, '')) IN ('completed', 'archived') AND COALESCE(legacy_card_workflow.metadata_json, '') LIKE '%"final_archive_history_id"%' ) THEN 'archived' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS detailed_workflow WHERE detailed_workflow.profile_id = character_profiles.profile_id AND detailed_workflow.workflow_type = 'character_gradual' AND LOWER(COALESCE(detailed_workflow.status, '')) IN ('active', 'running', 'review') ) THEN 'in_progress' WHEN EXISTS ( SELECT 1 FROM profile_workflows AS detailed_workflow WHERE detailed_workflow.profile_id = character_profiles.profile_id AND detailed_workflow.workflow_type = 'character_gradual' AND LOWER(COALESCE(detailed_workflow.status, '')) = 'completed' ) THEN 'ready_to_archive' ELSE NULL END AS detailed_workflow_state """ class ProfileRepository: def __init__(self, database: Database): self.database = database @property def placeholder(self) -> str: return self.database._placeholder def create(self, payload: dict[str, Any]) -> CharacterProfile: placeholder = self.placeholder sql = f""" INSERT INTO character_profiles ( profile_id, name, description, base_prompt, appearance_prompt, style_prompt, negative_prompt, default_model_route, owner_platform, owner_context_id, owner_user_id, owner_session_key, avatar_image_uri, status, metadata_json ) VALUES ( {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder} ) """ params = ( payload["profile_id"], payload["name"], payload.get("description"), payload.get("base_prompt"), payload.get("appearance_prompt"), payload.get("style_prompt"), payload.get("negative_prompt"), payload.get("default_model_route"), payload["owner_platform"], payload.get("owner_context_id"), payload["owner_user_id"], payload.get("owner_session_key"), payload.get("avatar_image_uri"), payload.get("status", "active"), _json_or_none(payload.get("metadata")), ) conn = self.database.connect() try: conn.execute(sql, params) conn.commit() finally: conn.close() profile = self.get(payload["profile_id"]) if profile is None: raise RuntimeError("profile was inserted but could not be read back") return profile def get(self, profile_id: str) -> CharacterProfile | None: placeholder = self.placeholder conn = self.database.connect() try: row = conn.execute( f""" SELECT {PROFILE_COLUMNS}, {_sql_literal(PROFILE_GENERATION_KIND_COLUMN, placeholder)}, {_sql_literal(PROFILE_CATEGORY_COLUMN, placeholder)}, {_sql_literal(DETAILED_WORKFLOW_STATE_COLUMN, placeholder)} FROM character_profiles WHERE profile_id = {placeholder} """, (profile_id,), ).fetchone() finally: conn.close() return _row_to_profile(row) if row else None def list( self, *, owner_user_id: str | None = None, keyword: str | None = None, status: str | None = "active", page: int = 1, page_size: int = 30, ) -> ProfileListResult: placeholder = self.placeholder where, params = self._build_filters( owner_user_id=owner_user_id, keyword=keyword, status=status, ) normalized_page = _page(page) normalized_page_size = _page_size(page_size) offset = (normalized_page - 1) * normalized_page_size conn = self.database.connect() try: count_row = conn.execute( f"SELECT COUNT(*) AS total FROM character_profiles {where}", tuple(params), ).fetchone() rows = conn.execute( f""" SELECT {PROFILE_COLUMNS}, {_sql_literal(PROFILE_GENERATION_KIND_COLUMN, placeholder)}, {_sql_literal(PROFILE_CATEGORY_COLUMN, placeholder)}, {_sql_literal(DETAILED_WORKFLOW_STATE_COLUMN, placeholder)} FROM character_profiles {where} ORDER BY updated_at DESC, created_at DESC LIMIT {normalized_page_size} OFFSET {offset} """, tuple(params), ).fetchall() finally: conn.close() return ProfileListResult( items=[_row_to_profile(row) for row in rows], page=normalized_page, page_size=normalized_page_size, total=int(count_row["total"] if count_row else 0), ) def update(self, profile_id: str, payload: dict[str, Any]) -> CharacterProfile | None: allowed = { "name", "description", "base_prompt", "appearance_prompt", "style_prompt", "negative_prompt", "default_model_route", "owner_context_id", "owner_session_key", "avatar_image_uri", "status", "metadata", } assignments: list[str] = [] params: list[Any] = [] placeholder = self.placeholder for key in allowed: if key not in payload: continue column = "metadata_json" if key == "metadata" else key value = _json_or_none(payload[key]) if key == "metadata" else payload[key] assignments.append(f"{column} = {placeholder}") params.append(value) if not assignments: return self.get(profile_id) assignments.append("updated_at = CURRENT_TIMESTAMP") params.append(profile_id) conn = self.database.connect() try: conn.execute( f""" UPDATE character_profiles SET {", ".join(assignments)} WHERE profile_id = {placeholder} """, tuple(params), ) conn.commit() finally: conn.close() return self.get(profile_id) def soft_delete(self, profile_id: str) -> CharacterProfile | None: return self.update(profile_id, {"status": "deleted"}) def _build_filters( self, *, owner_user_id: str | None, keyword: str | None, status: str | None, ) -> tuple[str, list[Any]]: placeholder = self.placeholder clauses: list[str] = [] params: list[Any] = [] if owner_user_id: clauses.append(f"owner_user_id = {placeholder}") params.append(owner_user_id) if status: clauses.append(f"status = {placeholder}") params.append(status) if keyword: clauses.append( f"(name LIKE {placeholder} OR description LIKE {placeholder})" ) like_value = f"%{keyword}%" params.extend([like_value, like_value]) if not clauses: return "", params return "WHERE " + " AND ".join(clauses), params def _row_to_profile(row) -> CharacterProfile: metadata = {} if row["metadata_json"]: metadata = json.loads(row["metadata_json"]) return CharacterProfile( profile_id=row["profile_id"], name=row["name"], description=row["description"], base_prompt=row["base_prompt"], appearance_prompt=row["appearance_prompt"], style_prompt=row["style_prompt"], negative_prompt=row["negative_prompt"], default_model_route=row["default_model_route"], owner_platform=row["owner_platform"], owner_context_id=row["owner_context_id"], owner_user_id=row["owner_user_id"], owner_session_key=row["owner_session_key"], avatar_image_uri=row["avatar_image_uri"], status=row["status"], metadata=metadata, created_at=str(row["created_at"]), updated_at=str(row["updated_at"]), generation_kind=str(row["generation_kind"] or "ungenerated"), profile_category=str(row["profile_category"] or "ungenerated"), detailed_workflow_state=( str(row["detailed_workflow_state"]) if row["detailed_workflow_state"] is not None else None ), ) def _json_or_none(value: Any | None) -> str | None: if value is None: return None return json.dumps(value, ensure_ascii=False, sort_keys=True) def _page(value: Any) -> int: try: page = int(value) except (TypeError, ValueError): page = 1 return max(page, 1) def _page_size(value: Any) -> int: try: page_size = int(value) except (TypeError, ValueError): page_size = 30 return min(max(page_size, 1), 100)