feat(21-01): add shared chat types and Zod validators

- Create ChatConversation, ChatConversationListItem, ChatMessage, and list response types
- Create createConversationSchema, updateConversationSchema, createMessageSchema validators
- Re-export from @paperclipai/shared barrel files (types/index.ts, validators/index.ts)

packages/shared/src/types/chat.ts

@@ -0,0 +1,41 @@
+export interface ChatConversation {
+  id: string;
+  companyId: string;
+  title: string | null;
+  agentId: string | null;
+  pinnedAt: string | null;
+  archivedAt: string | null;
+  deletedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ChatConversationListItem {
+  id: string;
+  companyId: string;
+  title: string | null;
+  agentId: string | null;
+  pinnedAt: string | null;
+  archivedAt: string | null;
+  updatedAt: string;
+  lastMessagePreview: string | null;
+}
+
+export interface ChatMessage {
+  id: string;
+  conversationId: string;
+  role: "user" | "assistant" | "system";
+  content: string;
+  agentId: string | null;
+  createdAt: string;
+}
+
+export interface ChatConversationListResponse {
+  items: ChatConversationListItem[];
+  hasMore: boolean;
+}
+
+export interface ChatMessageListResponse {
+  items: ChatMessage[];
+  hasMore: boolean;
+}

packages/shared/src/types/index.ts

@@ -179,6 +179,7 @@ export type {
   CompanyPortabilityImportResult,
   CompanyPortabilityExportRequest,
 } from "./company-portability.js";
+export * from "./chat.js";
 export type {
   JsonSchema,
   PluginJobDeclaration,

packages/shared/src/validators/chat.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+
+export const createConversationSchema = z.object({
+  title: z.string().max(200).optional(),
+  agentId: z.string().uuid().optional(),
+});
+
+export const updateConversationSchema = z.object({
+  title: z.string().max(200).optional(),
+  agentId: z.string().uuid().nullable().optional(),
+  pinnedAt: z.string().datetime().nullable().optional(),
+  archivedAt: z.string().datetime().nullable().optional(),
+});
+
+export const createMessageSchema = z.object({
+  role: z.enum(["user", "assistant", "system"]),
+  content: z.string().min(1).max(100_000),
+  agentId: z.string().uuid().optional(),
+});
+
+export type CreateConversation = z.infer<typeof createConversationSchema>;
+export type UpdateConversation = z.infer<typeof updateConversationSchema>;
+export type CreateMessage = z.infer<typeof createMessageSchema>;

packages/shared/src/validators/index.ts

@@ -1,3 +1,5 @@
+export * from "./chat.js";
+
 export {
   instanceGeneralSettingsSchema,
   patchInstanceGeneralSettingsSchema,