CREATE TABLE conversations (

id UUID PRIMARY KEY,

kb_id UUID NOT NULL REFERENCES knowledge_bases(id) ON DELETE CASCADE,

user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,

title TEXT NOT NULL DEFAULT '',

created_at TIMESTAMPTZ NOT NULL DEFAULT now(),

updated_at TIMESTAMPTZ NOT NULL DEFAULT now()

);

CREATE INDEX conversations_kb_user_idx ON conversations (kb_id, user_id, updated_at DESC);

CREATE TABLE conversation_messages (

id UUID PRIMARY KEY,

conversation_id UUID NOT NULL REFERENCES conversations(id) ON DELETE CASCADE,

role TEXT NOT NULL CHECK (role IN ('user', 'assistant')),

content TEXT NOT NULL,

-- 行动轨迹（工具调用步骤）与引用清单（历史回放；与 SSE step/sources 同构）

steps JSONB NOT NULL DEFAULT '[]',

sources JSONB NOT NULL DEFAULT '[]',

-- 这一轮认下了哪些实体（id、名字、类型），下一轮回放它。

-- **不回放整段工具结果**：那里面是 chunk 正文，每轮重复堆进上下文，几轮就

-- 把窗口吃光。要回放的是身份——有了 id，下一轮直接调 entity_facts，不必从

-- 名字重查；顺带治掉一个更隐蔽的毛病：同名歧义时两轮可能查到不同的实体，

-- 于是前后两个答案讲的不是同一个节点

resolved JSONB NOT NULL DEFAULT '[]'::jsonb,

created_at TIMESTAMPTZ NOT NULL DEFAULT now()

);

CREATE INDEX conversation_messages_conv_idx

ON conversation_messages (conversation_id, created_at);