"""Agent 声明式抽象（ARCH §5.1）+ 续审 Agent 实例。

`AgentSpec` 是内置 Agent 与用户 Skill 的同构声明：一份只读声明，由编排器加载、
经网关按 `tier` 执行。不变量 #2：agent 只声明 `tier`，**不**写具体 model。
不变量 #3：四审 `writes=[]`（只读），任何 AI 产出入库必经验收事务。

不可变：`AgentSpec` 为 frozen Pydantic 模型——加载后不得改动。
"""

from __future__ import annotations

from pydantic import BaseModel, ConfigDict, Field
from ww_llm_gateway.types import Tier

from .schemas import ContinuityReview


class AgentSpec(BaseModel):
    """单一 Agent / Skill 的声明（ARCH §5.1）。"""

    model_config = ConfigDict(frozen=True, arbitrary_types_allowed=True)

    name: str
    tier: Tier  # 能力档位（网关解析 provider+model）；不含具体 model
    system_prompt: str
    # 入/出参契约（Pydantic 模型类型）；writer 纯文本 → output_schema 可为 None
    input_schema: type[BaseModel] | None = None
    output_schema: type[BaseModel] | None = None
    reads: list[str] = Field(default_factory=list)  # 声明式表读权限
    writes: list[str] = Field(default_factory=list)  # 声明式表写权限（经验收才生效）
    genre: str | None = None  # 题材适用（Skill 用）
    scope: str = "builtin"  # builtin / custom / community


CONTINUITY_SYSTEM_PROMPT = """你是长篇连载小说的「一致性续审」。你的唯一职责：把本章草稿与\
作品的既有真相源逐项比对，找出一致性冲突，产出结构化冲突清单。

比对依据（注入材料）：
- 近况摘要（最近若干章的 chapter_digests）；
- 相关人物卡（性格、能力、关系、最新状态 latest_state）；
- 世界观硬规则（world_entities 的不可违背设定）。

按以下五类判定冲突，每条给出本章定位、来源引用与改法建议：
- 性格漂移：人物言行与其设定/既往表现不符；
- 能力不符：超出或低于已建立的能力/力量体系边界；
- 设定违例：违反世界观硬规则；
- 地理矛盾：地点/距离/空间关系与既有设定冲突；
- 时间线倒错：事件先后、时序与既有章节矛盾。

纪律：
- 你**只读、只报冲突**，不改稿、不写库、不产章节摘要（摘要在验收时从终稿另提）。
- 只报有据可依的真冲突；无冲突则返回空列表，不要臆造。
- 引用要具体（章节号、设定项、人物卡条目），便于作者就地裁决。"""


continuity_spec = AgentSpec(
    name="continuity",
    tier="analyst",
    system_prompt=CONTINUITY_SYSTEM_PROMPT,
    input_schema=None,  # 注入材料为序列化文本（经记忆 assemble），非结构化入参
    output_schema=ContinuityReview,
    reads=["chapter_digests", "characters", "world_entities"],
    writes=[],  # 只读（不变量 #3）
    scope="builtin",
)