/** trace 的存储端口 —— 落库形状由 adapter 决定,usecase 不认识 Drizzle */
import type { TraceSpan } from './contract.ts';

export type TraceStore = {
  /** 只增不改的两笔:开 span 写一行,收尾补 output/ended_at */
  insert(span: TraceSpan): Promise<void>;
  finish(id: string, patch: { output?: Record<string, unknown>; error?: { message: string }; attributes?: Record<string, unknown>; endedAt: string }): Promise<void>;
  listByWorkflow(workflowId: string): Promise<TraceSpan[]>;
  listByTask(taskId: string): Promise<TraceSpan[]>;
};

export type Clock = { now(): Date };