@firstlovecenter/ai-chat 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 First Love Church
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @firstlovecenter/ai-chat
+
+Reusable AI chat module for Next.js apps. Ships:
+
+- An agent tool loop that runs against Vertex AI (Claude or Gemini).
+- Two chat UI components: a custom hand-rolled chat and a Vercel AI SDK chat.
+- Persistence routes (sessions, messages, admin AI settings).
+- ORM-agnostic persistence: bring your own Drizzle (`drizzle-orm`) or Prisma (`@prisma/client`).
+- Registries for available tool-calling models and chat interfaces — your app picks which to expose.
+
+The host app supplies its own auth, scope, tools, prompts, Vertex credentials, and settings UI. The package handles everything else.
+
+## Status
+
+Pre-release. See the project plan for the current roadmap.
+
+## Install
+
+```bash
+pnpm add @firstlovecenter/ai-chat next react react-dom
+# pick one persistence backend:
+pnpm add drizzle-orm
+# or:
+pnpm add @prisma/client
+```
+
+## Quick start
+
+```ts
+// src/lib/ai-chat.ts (host)
+import { configureAiChat } from '@firstlovecenter/ai-chat/server';
+import { createDrizzlePersistence } from '@firstlovecenter/ai-chat/server/drizzle';
+// or: import { createPrismaPersistence } from '@firstlovecenter/ai-chat/server/prisma';
+
+export const aiChat = configureAiChat({
+  persistence: createDrizzlePersistence(db),
+  auth: { requireAuth, isSuperAdmin },
+  scope: { resolveScopeLabel, buildScopeSummary },
+  tools: { tools: ALL_TOOLS, buildSystemBlocks },
+  vertex: {
+    projectId: process.env.GCP_PROJECT_ID!,
+    defaultLocation: process.env.GCP_LOCATION ?? 'us-east5',
+    auth: getVertexAuth(),
+    modelIds: { claude: process.env.GCP_CLAUDE_MODEL!, gemini: process.env.GCP_GEMINI_MODEL! }
+  }
+});
+```
+
+Detailed integration docs (Drizzle migrations, Prisma fragment paste, Vertex auth recipes, tool authoring, settings UI) ship with v0.1.0.
+
+## Database footprint
+
+See [DATABASE.md](DATABASE.md) for the full footprint: which three tables the package adds, what it explicitly does *not* add (no FKs to the host, no users table, no triggers/views), MySQL-only and BIGINT-UNSIGNED user-id assumptions, table-name configurability per ORM, and the known independence gaps for hosts whose schema doesn't match FLC's.

package/dist/drizzle/index.cjs

@@ -0,0 +1,199 @@
+'use strict';
+
+var drizzleOrm = require('drizzle-orm');
+var mysqlCore = require('drizzle-orm/mysql-core');
+
+// src/adapters/drizzle/tables.ts
+var bigintPk = () => mysqlCore.bigint("id", { mode: "number", unsigned: true }).notNull().primaryKey().autoincrement();
+var bigintFk = (name) => mysqlCore.bigint(name, { mode: "number", unsigned: true }).notNull();
+var bigintFkNullable = (name) => mysqlCore.bigint(name, { mode: "number", unsigned: true });
+var createdAt = () => mysqlCore.datetime("created_at", { mode: "string" }).notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`);
+var aiSettings = mysqlCore.mysqlTable("ai_settings", {
+  id: mysqlCore.tinyint("id").notNull().primaryKey().default(1),
+  toolProvider: mysqlCore.varchar("tool_provider", { length: 32 }).notNull().default("claude"),
+  gcpLocation: mysqlCore.varchar("gcp_location", { length: 32 }).notNull().default("us-east5"),
+  chatInterface: mysqlCore.varchar("chat_interface", { length: 32 }).notNull().default("custom"),
+  updatedAt: mysqlCore.datetime("updated_at", { mode: "string" }).notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`),
+  updatedByUserId: bigintFkNullable("updated_by_user_id")
+});
+var chatSessions = mysqlCore.mysqlTable(
+  "chat_sessions",
+  {
+    id: bigintPk(),
+    userId: bigintFk("user_id"),
+    title: mysqlCore.varchar("title", { length: 200 }).notNull(),
+    createdAt: createdAt(),
+    updatedAt: mysqlCore.datetime("updated_at", { mode: "string" }).notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`)
+  },
+  (t) => ({
+    idxUserUpdated: mysqlCore.index("idx_chat_session_user_updated").on(t.userId, t.updatedAt)
+  })
+);
+var chatMessageRoleEnum = ["user", "assistant"];
+var chatMessages = mysqlCore.mysqlTable(
+  "chat_messages",
+  {
+    id: bigintPk(),
+    sessionId: bigintFk("session_id"),
+    role: mysqlCore.mysqlEnum("role", chatMessageRoleEnum).notNull(),
+    question: mysqlCore.text("question"),
+    blocks: mysqlCore.json("blocks"),
+    prose: mysqlCore.json("prose"),
+    errorJson: mysqlCore.json("error_json"),
+    createdAt: createdAt()
+  },
+  (t) => ({
+    idxSessionCreated: mysqlCore.index("idx_chat_msg_session_created").on(t.sessionId, t.createdAt)
+  })
+);
+function mapSession(row) {
+  return {
+    id: row.id,
+    userId: row.userId,
+    title: row.title,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function mapMessage(row) {
+  return {
+    id: row.id,
+    sessionId: row.sessionId,
+    role: row.role,
+    question: row.question,
+    blocks: row.blocks,
+    prose: row.prose,
+    errorJson: row.errorJson,
+    createdAt: new Date(row.createdAt)
+  };
+}
+function mapSettings(row) {
+  return {
+    toolProvider: row.toolProvider,
+    gcpLocation: row.gcpLocation,
+    chatInterface: row.chatInterface,
+    updatedAt: row.updatedAt ? new Date(row.updatedAt) : null,
+    updatedByUserId: row.updatedByUserId
+  };
+}
+function createDrizzlePersistence(db) {
+  return {
+    // ---------------------------------------------------------------------
+    // Sessions
+    // ---------------------------------------------------------------------
+    async createSession(input) {
+      const inserted = await db.insert(chatSessions).values({
+        userId: input.userId,
+        title: input.title
+      }).$returningId();
+      const id = inserted[0]?.id;
+      if (id == null) {
+        throw new Error("createSession: insert returned no id");
+      }
+      const [row] = await db.select().from(chatSessions).where(drizzleOrm.eq(chatSessions.id, id)).limit(1);
+      if (!row) {
+        throw new Error(`createSession: row ${id} not found after insert`);
+      }
+      return mapSession(row);
+    },
+    async getSession(id, userId) {
+      const [row] = await db.select().from(chatSessions).where(drizzleOrm.and(drizzleOrm.eq(chatSessions.id, id), drizzleOrm.eq(chatSessions.userId, userId))).limit(1);
+      return row ? mapSession(row) : null;
+    },
+    async listSessionsForUser(userId, opts) {
+      const limit = opts?.limit ?? 50;
+      const rows = await db.select().from(chatSessions).where(drizzleOrm.eq(chatSessions.userId, userId)).orderBy(drizzleOrm.desc(chatSessions.updatedAt)).limit(limit);
+      return rows.map(mapSession);
+    },
+    async updateSession(id, userId, patch) {
+      if (patch.title === void 0) return;
+      await db.update(chatSessions).set({ title: patch.title }).where(drizzleOrm.and(drizzleOrm.eq(chatSessions.id, id), drizzleOrm.eq(chatSessions.userId, userId)));
+    },
+    async deleteSession(id, userId) {
+      const owned = await db.select({ id: chatSessions.id }).from(chatSessions).where(drizzleOrm.and(drizzleOrm.eq(chatSessions.id, id), drizzleOrm.eq(chatSessions.userId, userId))).limit(1);
+      if (owned.length === 0) return;
+      await db.delete(chatMessages).where(drizzleOrm.eq(chatMessages.sessionId, id));
+      await db.delete(chatSessions).where(drizzleOrm.and(drizzleOrm.eq(chatSessions.id, id), drizzleOrm.eq(chatSessions.userId, userId)));
+    },
+    // ---------------------------------------------------------------------
+    // Messages
+    // ---------------------------------------------------------------------
+    async appendMessage(input) {
+      const inserted = await db.insert(chatMessages).values({
+        sessionId: input.sessionId,
+        role: input.role,
+        question: input.question ?? null,
+        blocks: input.blocks ?? null,
+        prose: input.prose ?? null,
+        errorJson: input.errorJson ?? null
+      }).$returningId();
+      const id = inserted[0]?.id;
+      if (id == null) {
+        throw new Error("appendMessage: insert returned no id");
+      }
+      const [row] = await db.select().from(chatMessages).where(drizzleOrm.eq(chatMessages.id, id)).limit(1);
+      if (!row) {
+        throw new Error(`appendMessage: row ${id} not found after insert`);
+      }
+      return mapMessage(row);
+    },
+    async listMessagesForSession(sessionId, userId) {
+      const owned = await db.select({ id: chatSessions.id }).from(chatSessions).where(
+        drizzleOrm.and(drizzleOrm.eq(chatSessions.id, sessionId), drizzleOrm.eq(chatSessions.userId, userId))
+      ).limit(1);
+      if (owned.length === 0) return [];
+      const rows = await db.select().from(chatMessages).where(drizzleOrm.eq(chatMessages.sessionId, sessionId)).orderBy(chatMessages.createdAt, chatMessages.id);
+      return rows.map(mapMessage);
+    },
+    // ---------------------------------------------------------------------
+    // AI settings (singleton row)
+    // ---------------------------------------------------------------------
+    async getAiSettings() {
+      const [row] = await db.select().from(aiSettings).where(drizzleOrm.eq(aiSettings.id, 1)).limit(1);
+      if (!row) {
+        return {
+          toolProvider: "claude",
+          gcpLocation: "us-east5",
+          chatInterface: "custom",
+          updatedAt: null,
+          updatedByUserId: null
+        };
+      }
+      return mapSettings(row);
+    },
+    async updateAiSettings(patch, byUserId) {
+      const insertValues = {
+        id: 1,
+        toolProvider: patch.toolProvider ?? "claude",
+        gcpLocation: patch.gcpLocation ?? "us-east5",
+        chatInterface: patch.chatInterface ?? "custom",
+        updatedByUserId: byUserId
+      };
+      const updateSet = {
+        updatedByUserId: byUserId
+      };
+      if (patch.toolProvider !== void 0) {
+        updateSet.toolProvider = patch.toolProvider;
+      }
+      if (patch.gcpLocation !== void 0) {
+        updateSet.gcpLocation = patch.gcpLocation;
+      }
+      if (patch.chatInterface !== void 0) {
+        updateSet.chatInterface = patch.chatInterface;
+      }
+      await db.insert(aiSettings).values(insertValues).onDuplicateKeyUpdate({ set: updateSet });
+      const [row] = await db.select().from(aiSettings).where(drizzleOrm.eq(aiSettings.id, 1)).limit(1);
+      if (!row) {
+        throw new Error("updateAiSettings: singleton row missing after upsert");
+      }
+      return mapSettings(row);
+    }
+  };
+}
+
+exports.aiSettings = aiSettings;
+exports.chatMessages = chatMessages;
+exports.chatSessions = chatSessions;
+exports.createDrizzlePersistence = createDrizzlePersistence;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/drizzle/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/drizzle/tables.ts","../../src/adapters/drizzle/adapter.ts"],"names":["bigint","datetime","sql","mysqlTable","tinyint","varchar","index","mysqlEnum","text","json","eq","and","desc"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Canonical drizzle MySQL table definitions for `@firstlovecenter/ai-chat`.\n *\n * These three tables (`chat_sessions`, `chat_messages`, `ai_settings`) are\n * the data shape the package needs to persist its conversations and global\n * config. The host re-exports them from its own schema so that an existing\n * deployment keeps the same column names, lengths, FKs, and indexes — making\n * the host's data fully portable into and out of the package.\n *\n * Deviations from the host's prior shape are deliberate:\n *  - `tool_provider` and `gcp_location` are plain VARCHAR (not enums) so a\n *    consumer can register additional providers / regions without a schema\n *    migration. Validation against the runtime registries happens at a\n *    higher layer.\n *  - `chat_interface` is a new VARCHAR column controlling which chat UI\n *    (custom vs. vercel-ai) renders globally; default 'custom'.\n *\n * The small column helpers from the host (`bigintPk`, `bigintFk`,\n * `bigintFkNullable`, `createdAt`) are re-defined inline here — this package\n * never imports from the host repo.\n */\nimport { sql } from 'drizzle-orm';\nimport {\n  bigint,\n  datetime,\n  index,\n  json,\n  mysqlEnum,\n  mysqlTable,\n  text,\n  tinyint,\n  varchar\n} from 'drizzle-orm/mysql-core';\n\n// ---------------------------------------------------------------------------\n// Inline column helpers (mirrors host `src/db/columns.ts` shapes)\n// ---------------------------------------------------------------------------\n\n/** BIGINT UNSIGNED PK with auto-increment, returned as `number`. */\nconst bigintPk = () =>\n  bigint('id', { mode: 'number', unsigned: true })\n    .notNull()\n    .primaryKey()\n    .autoincrement();\n\n/** NOT NULL BIGINT UNSIGNED FK column, returned as `number`. */\nconst bigintFk = (name: string) =>\n  bigint(name, { mode: 'number', unsigned: true }).notNull();\n\n/** Nullable BIGINT UNSIGNED FK column, returned as `number | null`. */\nconst bigintFkNullable = (name: string) =>\n  bigint(name, { mode: 'number', unsigned: true });\n\n/** `created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP`, mode 'string'. */\nconst createdAt = () =>\n  datetime('created_at', { mode: 'string' })\n    .notNull()\n    .default(sql`CURRENT_TIMESTAMP`);\n\n// ---------------------------------------------------------------------------\n// ai_settings (singleton — always one row at id=1)\n// ---------------------------------------------------------------------------\n\n/**\n * Global AI configuration. Singleton row enforced by `id=1` default + PK.\n * `tool_provider`, `gcp_location`, and `chat_interface` are open VARCHARs;\n * the runtime layer validates against the host's registries before write.\n */\nexport const aiSettings = mysqlTable('ai_settings', {\n  id: tinyint('id').notNull().primaryKey().default(1),\n  toolProvider: varchar('tool_provider', { length: 32 })\n    .notNull()\n    .default('claude'),\n  gcpLocation: varchar('gcp_location', { length: 32 })\n    .notNull()\n    .default('us-east5'),\n  chatInterface: varchar('chat_interface', { length: 32 })\n    .notNull()\n    .default('custom'),\n  updatedAt: datetime('updated_at', { mode: 'string' })\n    .notNull()\n    .default(sql`CURRENT_TIMESTAMP`),\n  updatedByUserId: bigintFkNullable('updated_by_user_id')\n});\n\n// ---------------------------------------------------------------------------\n// chat_sessions (one per conversation)\n// ---------------------------------------------------------------------------\n\nexport const chatSessions = mysqlTable(\n  'chat_sessions',\n  {\n    id: bigintPk(),\n    userId: bigintFk('user_id'),\n    title: varchar('title', { length: 200 }).notNull(),\n    createdAt: createdAt(),\n    updatedAt: datetime('updated_at', { mode: 'string' })\n      .notNull()\n      .default(sql`CURRENT_TIMESTAMP`)\n  },\n  (t) => ({\n    idxUserUpdated: index('idx_chat_session_user_updated').on(t.userId, t.updatedAt)\n  })\n);\n\n// ---------------------------------------------------------------------------\n// chat_messages (one row per turn in a chat_session)\n// ---------------------------------------------------------------------------\n\nexport const chatMessageRoleEnum = ['user', 'assistant'] as const;\n\nexport const chatMessages = mysqlTable(\n  'chat_messages',\n  {\n    id: bigintPk(),\n    sessionId: bigintFk('session_id'),\n    role: mysqlEnum('role', chatMessageRoleEnum).notNull(),\n    question: text('question'),\n    blocks: json('blocks'),\n    prose: json('prose'),\n    errorJson: json('error_json'),\n    createdAt: createdAt()\n  },\n  (t) => ({\n    idxSessionCreated: index('idx_chat_msg_session_created').on(t.sessionId, t.createdAt)\n  })\n);\n\n// ---------------------------------------------------------------------------\n// Inferred row types — distinct from the domain types in ports/types.ts.\n// Adapters map these row shapes (datetime as string) to the domain shapes\n// (Date) at the boundary.\n// ---------------------------------------------------------------------------\n\nexport type ChatSessionRow = typeof chatSessions.$inferSelect;\nexport type ChatMessageRow = typeof chatMessages.$inferSelect;\nexport type AiSettingsRow = typeof aiSettings.$inferSelect;\n","/**\n * Drizzle MySQL implementation of `PersistencePort`.\n *\n * The package never imports a concrete drizzle client — the host passes a\n * `MySql2Database` (or any compatible drizzle MySQL handle) and we use it\n * to issue the queries this port describes.\n *\n * Boundary mapping: the drizzle MySQL `datetime` columns are declared with\n * `mode: 'string'` to match the host's existing schema, so row reads return\n * ISO strings. The PersistencePort domain types use `Date`, so every row\n * crossing the boundary is converted via `new Date(row.createdAt)`.\n *\n * Per-user safety: `getSession`, `updateSession`, `deleteSession`, and\n * `listMessagesForSession` all join `userId` into the WHERE clause — the\n * port's contract is that no caller should be able to read or mutate\n * another user's data even if they've forged a session id.\n */\nimport { and, desc, eq } from 'drizzle-orm';\nimport type { MySql2Database } from 'drizzle-orm/mysql2';\n\nimport type {\n  AiSettings,\n  AiSettingsPatch,\n  AppendMessageInput,\n  ChatMessage,\n  ChatMessageRole,\n  ChatSession,\n  CreateSessionInput,\n  ListSessionsOpts,\n  PersistencePort\n} from '../../server/ports/types';\n\nimport {\n  aiSettings,\n  chatMessages,\n  chatSessions,\n  type AiSettingsRow,\n  type ChatMessageRow,\n  type ChatSessionRow\n} from './tables';\n\n// ---------------------------------------------------------------------------\n// Row -> domain mappers\n// ---------------------------------------------------------------------------\n\nfunction mapSession(row: ChatSessionRow): ChatSession {\n  return {\n    id: row.id,\n    userId: row.userId,\n    title: row.title,\n    createdAt: new Date(row.createdAt),\n    updatedAt: new Date(row.updatedAt)\n  };\n}\n\nfunction mapMessage(row: ChatMessageRow): ChatMessage {\n  return {\n    id: row.id,\n    sessionId: row.sessionId,\n    role: row.role as ChatMessageRole,\n    question: row.question,\n    blocks: row.blocks,\n    prose: row.prose,\n    errorJson: row.errorJson,\n    createdAt: new Date(row.createdAt)\n  };\n}\n\nfunction mapSettings(row: AiSettingsRow): AiSettings {\n  return {\n    toolProvider: row.toolProvider,\n    gcpLocation: row.gcpLocation,\n    chatInterface: row.chatInterface,\n    updatedAt: row.updatedAt ? new Date(row.updatedAt) : null,\n    updatedByUserId: row.updatedByUserId\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createDrizzlePersistence(\n  db: MySql2Database<any>\n): PersistencePort {\n  return {\n    // ---------------------------------------------------------------------\n    // Sessions\n    // ---------------------------------------------------------------------\n\n    async createSession(input: CreateSessionInput): Promise<ChatSession> {\n      const inserted = await db\n        .insert(chatSessions)\n        .values({\n          userId: input.userId,\n          title: input.title\n        })\n        .$returningId();\n\n      const id = inserted[0]?.id;\n      if (id == null) {\n        throw new Error('createSession: insert returned no id');\n      }\n\n      const [row] = await db\n        .select()\n        .from(chatSessions)\n        .where(eq(chatSessions.id, id))\n        .limit(1);\n\n      if (!row) {\n        throw new Error(`createSession: row ${id} not found after insert`);\n      }\n      return mapSession(row);\n    },\n\n    async getSession(id: number, userId: number): Promise<ChatSession | null> {\n      const [row] = await db\n        .select()\n        .from(chatSessions)\n        .where(and(eq(chatSessions.id, id), eq(chatSessions.userId, userId)))\n        .limit(1);\n\n      return row ? mapSession(row) : null;\n    },\n\n    async listSessionsForUser(\n      userId: number,\n      opts?: ListSessionsOpts\n    ): Promise<ChatSession[]> {\n      const limit = opts?.limit ?? 50;\n      const rows = await db\n        .select()\n        .from(chatSessions)\n        .where(eq(chatSessions.userId, userId))\n        .orderBy(desc(chatSessions.updatedAt))\n        .limit(limit);\n\n      return rows.map(mapSession);\n    },\n\n    async updateSession(\n      id: number,\n      userId: number,\n      patch: { title?: string }\n    ): Promise<void> {\n      if (patch.title === undefined) return;\n\n      await db\n        .update(chatSessions)\n        .set({ title: patch.title })\n        .where(and(eq(chatSessions.id, id), eq(chatSessions.userId, userId)));\n    },\n\n    async deleteSession(id: number, userId: number): Promise<void> {\n      // Delete messages first (no ON DELETE CASCADE assumed at table level).\n      const owned = await db\n        .select({ id: chatSessions.id })\n        .from(chatSessions)\n        .where(and(eq(chatSessions.id, id), eq(chatSessions.userId, userId)))\n        .limit(1);\n\n      if (owned.length === 0) return;\n\n      await db.delete(chatMessages).where(eq(chatMessages.sessionId, id));\n      await db\n        .delete(chatSessions)\n        .where(and(eq(chatSessions.id, id), eq(chatSessions.userId, userId)));\n    },\n\n    // ---------------------------------------------------------------------\n    // Messages\n    // ---------------------------------------------------------------------\n\n    async appendMessage(input: AppendMessageInput): Promise<ChatMessage> {\n      const inserted = await db\n        .insert(chatMessages)\n        .values({\n          sessionId: input.sessionId,\n          role: input.role,\n          question: input.question ?? null,\n          blocks: input.blocks ?? null,\n          prose: input.prose ?? null,\n          errorJson: input.errorJson ?? null\n        })\n        .$returningId();\n\n      const id = inserted[0]?.id;\n      if (id == null) {\n        throw new Error('appendMessage: insert returned no id');\n      }\n\n      const [row] = await db\n        .select()\n        .from(chatMessages)\n        .where(eq(chatMessages.id, id))\n        .limit(1);\n\n      if (!row) {\n        throw new Error(`appendMessage: row ${id} not found after insert`);\n      }\n      return mapMessage(row);\n    },\n\n    async listMessagesForSession(\n      sessionId: number,\n      userId: number\n    ): Promise<ChatMessage[]> {\n      // Verify ownership before returning rows — never trust the caller to\n      // have filtered already.\n      const owned = await db\n        .select({ id: chatSessions.id })\n        .from(chatSessions)\n        .where(\n          and(eq(chatSessions.id, sessionId), eq(chatSessions.userId, userId))\n        )\n        .limit(1);\n\n      if (owned.length === 0) return [];\n\n      const rows = await db\n        .select()\n        .from(chatMessages)\n        .where(eq(chatMessages.sessionId, sessionId))\n        .orderBy(chatMessages.createdAt, chatMessages.id);\n\n      return rows.map(mapMessage);\n    },\n\n    // ---------------------------------------------------------------------\n    // AI settings (singleton row)\n    // ---------------------------------------------------------------------\n\n    async getAiSettings(): Promise<AiSettings> {\n      const [row] = await db\n        .select()\n        .from(aiSettings)\n        .where(eq(aiSettings.id, 1))\n        .limit(1);\n\n      if (!row) {\n        // Synthesize defaults rather than failing — the row is created on\n        // first write via INSERT … ON DUPLICATE KEY UPDATE.\n        return {\n          toolProvider: 'claude',\n          gcpLocation: 'us-east5',\n          chatInterface: 'custom',\n          updatedAt: null,\n          updatedByUserId: null\n        };\n      }\n\n      return mapSettings(row);\n    },\n\n    async updateAiSettings(\n      patch: AiSettingsPatch,\n      byUserId: number\n    ): Promise<AiSettings> {\n      // Build the values object with the singleton id and any defaults the\n      // INSERT branch needs. ON DUPLICATE KEY UPDATE only touches keys in\n      // the patch (plus updated_at / updated_by_user_id audit columns).\n      const insertValues = {\n        id: 1 as const,\n        toolProvider: patch.toolProvider ?? 'claude',\n        gcpLocation: patch.gcpLocation ?? 'us-east5',\n        chatInterface: patch.chatInterface ?? 'custom',\n        updatedByUserId: byUserId\n      };\n\n      const updateSet: Record<string, unknown> = {\n        updatedByUserId: byUserId\n      };\n      if (patch.toolProvider !== undefined) {\n        updateSet.toolProvider = patch.toolProvider;\n      }\n      if (patch.gcpLocation !== undefined) {\n        updateSet.gcpLocation = patch.gcpLocation;\n      }\n      if (patch.chatInterface !== undefined) {\n        updateSet.chatInterface = patch.chatInterface;\n      }\n\n      await db\n        .insert(aiSettings)\n        .values(insertValues)\n        .onDuplicateKeyUpdate({ set: updateSet });\n\n      const [row] = await db\n        .select()\n        .from(aiSettings)\n        .where(eq(aiSettings.id, 1))\n        .limit(1);\n\n      if (!row) {\n        throw new Error('updateAiSettings: singleton row missing after upsert');\n      }\n      return mapSettings(row);\n    }\n  };\n}\n"]}