add-card-type

name	add-card-type
description	Standardized flow for adding a new message card type (13th payload kind). Use when adding rich UI cards beyond the existing 12 (text/diff/web/tasks/swatches/copy/metrics/sql/schema/logs/api/typing/ask-form).

Skill — Add a New Card Type

Polynoia 新加一种 MessagePart payload kind 的 5 步流程。

何时用

• 用户说"我想加个 X 卡"(例:profile 卡 / chart 卡 / kanban 卡)
• agent 产出有特殊结构需要专属渲染

不该用

• 卡内字段调整 — 直接改 Pydantic schema
• 改卡片视觉(颜色 / 字号)— 改 React 组件就行

步骤

1. Pydantic schema(后端 source-of-truth)

apps/server/polynoia/domain/messages.py:

class XPayload(BaseModel):
    kind: Literal["x"]
    # ... 字段

加入 MessagePayload discriminated union:

MessagePayload = Annotated[
    TextPayload | DiffPayload | ... | XPayload,
    Field(discriminator="kind"),
]

2. 自动生成 TS

make types

跑 datamodel-code-generator Pydantic → TS,产物在 packages/shared/ + apps/web/src/lib/types.ts。

3. 注册表

apps/web/src/components/parts/index.ts:

const PARTS_REGISTRY: Record<MessagePayload[], <{: }>> = {
  : ,
  : ,
  
  : ,                  
};