@firstlovecenter/ai-chat 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to `@firstlovecenter/ai-chat` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] — 2026-05-09
+
+Conversation memory in the agent loop, plus URL-driven session restore. Follow-up questions in the same chat (`"summarize that"`, `"how many of those are youth?"`) now resolve correctly because each request seeds the LLM context with prior turns. The chat UI is now URL-addressable (`/chat/[id]`), so reload, multi-tab, and bookmarks restore the exact conversation the user was viewing.
+
+### Added
+
+- **`AgentInput.priorMessages`** (`NormalizedMessage[]`, optional) — the agent loop now seeds its prompt with prior conversation turns before the new user question.
+- **`historyToNormalizedMessages(rows, opts?)`** (`./server/history`) — converts stored `chat_messages` rows into the `NormalizedMessage[]` shape `runAgent` expects. Walks user→assistant pairs, skips errored turns, falls back from `prose` → block-text extraction. Defaults: cap last 20 pairs (`maxPairs`), truncate per-turn text to 4000 chars (`maxTextChars`).
+- **`NormalizedMessage.cached`** (boolean, optional) — cache breakpoint hint. The Anthropic adapter promotes a marker on cached messages to `cache_control: { type: 'ephemeral' }` so the entire system + history prefix becomes cacheable on follow-up turns within the 5-min TTL. Vertex Gemini ignores the flag (its prefix cache works automatically).
+- **`AiChatProps.initialSessionId`** (number | null, optional) — host-resolved session id (typically from `/chat/[id]` route segment). Drives initial hydration; the URL is now the source of truth.
+
+### Changed
+
+- **`agent-custom` and `agent-vercel` routes** load `priorMessages` via `persistence.listMessagesForSession()` *before* appending the new user turn (avoids duplicating the just-inserted row into the prompt) and pass the result into the agent loop. The custom route also marks the last historical message `cached: true` for prompt-cache coverage on Anthropic.
+- **`agent-vercel` body parsing** accepts both `body.question` (legacy) and `body.messages` (Vercel SDK shape sent by `useChat`'s `experimental_prepareRequestBody`). Derives the latest user question from `messages[]` when only that's present.
+- **`AiChat` and `VercelChat`** drop the "auto-open most recent session on first mount" effect. The host's URL is now authoritative — pass `initialSessionId` from your `/chat/[id]` server component. Both shells push `/chat/<id>` (or `/chat`) via `next/navigation`'s router whenever the active session changes (open/new/delete/lazy-create-on-submit).
+- **Drizzle, Prisma, and memory adapters** bump `chat_sessions.updated_at` inside `appendMessage` so `listSessionsForUser` (ordered by `updatedAt DESC`) reflects the most recent activity rather than creation time.
+
+### Migration notes
+
+- **Hosts using the bundled UI** must wire a dynamic route segment for sessions, e.g. `app/chat/[id]/page.tsx`, and pass the parsed id as `initialSessionId={...}` to `AiChat`/`VercelChat`. The empty `/chat` route should pass `initialSessionId={null}`. Reload no longer auto-opens "most recent" — the URL is the contract.
+- **Hosts calling `runAgent` directly** are unaffected. `priorMessages` is optional and defaults to empty (existing single-turn behaviour preserved).
+- **No schema migration required** — `chat_sessions.updated_at` already exists; the adapter change just starts writing to it on every message append.
+
 ## [0.7.0] — 2026-05-08
 
 Admin-configurable GCP project. A third runtime knob on `ai_settings` joins `max_output_tokens` (0.6.0) and `role_prompt` (0.6.0): admins can flip the active GCP project from the settings UI without redeploying — useful for staging/prod migrations and running multiple FLC tenants from one runtime.

package/dist/drizzle/index.cjs

@@ -153,6 +153,7 @@ function createDrizzlePersistence(db) {
       if (id == null) {
         throw new Error("appendMessage: insert returned no id");
       }
+      await db.update(chatSessions).set({ updatedAt: drizzleOrm.sql`CURRENT_TIMESTAMP` }).where(drizzleOrm.eq(chatSessions.id, input.sessionId));
       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`);

package/dist/drizzle/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/drizzle/tables.ts","../../src/server/ports/types.ts","../../src/adapters/drizzle/adapter.ts"],"names":["bigint","datetime","sql","mysqlTable","tinyint","varchar","int","text","index","mysqlEnum","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  int,\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  /**\n   * Admin-editable GCP project override. NULL means the host's static\n   * `VertexPort.projectId` is used. Lets admins flip the active GCP\n   * project without redeploying — useful for staging/prod migrations\n   * or running multiple FLC tenants from one runtime.\n   */\n  gcpProjectId: varchar('gcp_project_id', { length: 64 }),\n  // Caps the per-turn output budget for both the agent loop AND the prose\n  // narrator. Reasoning models charge internal thinking against this; bump\n  // it well past 4096 when one is in use.\n  maxOutputTokens: int('max_output_tokens').notNull().default(4096),\n  // Optional admin-editable role/persona. NULL means the host's static\n  // `rolePrompt` (passed to configureAiChat) is used as the fallback.\n  rolePrompt: text('role_prompt'),\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 * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\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 {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type 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    maxOutputTokens: row.maxOutputTokens,\n    rolePrompt: row.rolePrompt,\n    gcpProjectId: row.gcpProjectId,\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          maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n          rolePrompt: null,\n          gcpProjectId: null,\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        maxOutputTokens:\n          patch.maxOutputTokens ?? DEFAULT_AI_MAX_OUTPUT_TOKENS,\n        rolePrompt: patch.rolePrompt ?? null,\n        gcpProjectId: patch.gcpProjectId ?? null,\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      if (patch.maxOutputTokens !== undefined) {\n        updateSet.maxOutputTokens = patch.maxOutputTokens;\n      }\n      if (patch.rolePrompt !== undefined) {\n        updateSet.rolePrompt = patch.rolePrompt;\n      }\n      if (patch.gcpProjectId !== undefined) {\n        updateSet.gcpProjectId = patch.gcpProjectId;\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"]}
+{"version":3,"sources":["../../src/adapters/drizzle/tables.ts","../../src/server/ports/types.ts","../../src/adapters/drizzle/adapter.ts"],"names":["bigint","datetime","sql","mysqlTable","tinyint","varchar","int","text","index","mysqlEnum","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  int,\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  /**\n   * Admin-editable GCP project override. NULL means the host's static\n   * `VertexPort.projectId` is used. Lets admins flip the active GCP\n   * project without redeploying — useful for staging/prod migrations\n   * or running multiple FLC tenants from one runtime.\n   */\n  gcpProjectId: varchar('gcp_project_id', { length: 64 }),\n  // Caps the per-turn output budget for both the agent loop AND the prose\n  // narrator. Reasoning models charge internal thinking against this; bump\n  // it well past 4096 when one is in use.\n  maxOutputTokens: int('max_output_tokens').notNull().default(4096),\n  // Optional admin-editable role/persona. NULL means the host's static\n  // `rolePrompt` (passed to configureAiChat) is used as the fallback.\n  rolePrompt: text('role_prompt'),\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 * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\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, sql } from 'drizzle-orm';\nimport type { MySql2Database } from 'drizzle-orm/mysql2';\n\nimport {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type 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    maxOutputTokens: row.maxOutputTokens,\n    rolePrompt: row.rolePrompt,\n    gcpProjectId: row.gcpProjectId,\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      // Bump the parent session's `updated_at` so `listSessionsForUser`\n      // (ordered by updatedAt DESC) reflects \"most recent activity\"\n      // rather than creation time. The column has no MySQL ON UPDATE\n      // clause, so we set it explicitly here.\n      await db\n        .update(chatSessions)\n        .set({ updatedAt: sql`CURRENT_TIMESTAMP` })\n        .where(eq(chatSessions.id, input.sessionId));\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          maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n          rolePrompt: null,\n          gcpProjectId: null,\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        maxOutputTokens:\n          patch.maxOutputTokens ?? DEFAULT_AI_MAX_OUTPUT_TOKENS,\n        rolePrompt: patch.rolePrompt ?? null,\n        gcpProjectId: patch.gcpProjectId ?? null,\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      if (patch.maxOutputTokens !== undefined) {\n        updateSet.maxOutputTokens = patch.maxOutputTokens;\n      }\n      if (patch.rolePrompt !== undefined) {\n        updateSet.rolePrompt = patch.rolePrompt;\n      }\n      if (patch.gcpProjectId !== undefined) {\n        updateSet.gcpProjectId = patch.gcpProjectId;\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"]}

package/dist/drizzle/index.js

@@ -151,6 +151,7 @@ function createDrizzlePersistence(db) {
       if (id == null) {
         throw new Error("appendMessage: insert returned no id");
       }
+      await db.update(chatSessions).set({ updatedAt: sql`CURRENT_TIMESTAMP` }).where(eq(chatSessions.id, input.sessionId));
       const [row] = await db.select().from(chatMessages).where(eq(chatMessages.id, id)).limit(1);
       if (!row) {
         throw new Error(`appendMessage: row ${id} not found after insert`);

package/dist/drizzle/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/drizzle/tables.ts","../../src/server/ports/types.ts","../../src/adapters/drizzle/adapter.ts"],"names":[],"mappings":";;;;AAwCA,IAAM,QAAA,GAAW,MACf,MAAA,CAAO,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,CAAA,CAC5C,OAAA,EAAQ,CACR,UAAA,GACA,aAAA,EAAc;AAGnB,IAAM,QAAA,GAAW,CAAC,IAAA,KAChB,MAAA,CAAO,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,CAAA,CAAE,OAAA,EAAQ;AAG3D,IAAM,gBAAA,GAAmB,CAAC,IAAA,KACxB,MAAA,CAAO,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,CAAA;AAGjD,IAAM,SAAA,GAAY,MAChB,QAAA,CAAS,YAAA,EAAc,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,CACtC,OAAA,EAAQ,CACR,OAAA,CAAQ,GAAA,CAAA,iBAAA,CAAsB,CAAA;AAW5B,IAAM,UAAA,GAAa,WAAW,aAAA,EAAe;AAAA,EAClD,EAAA,EAAI,QAAQ,IAAI,CAAA,CAAE,SAAQ,CAAE,UAAA,EAAW,CAAE,OAAA,CAAQ,CAAC,CAAA;AAAA,EAClD,YAAA,EAAc,OAAA,CAAQ,eAAA,EAAiB,EAAE,MAAA,EAAQ,EAAA,EAAI,CAAA,CAClD,OAAA,EAAQ,CACR,OAAA,CAAQ,QAAQ,CAAA;AAAA,EACnB,WAAA,EAAa,OAAA,CAAQ,cAAA,EAAgB,EAAE,MAAA,EAAQ,EAAA,EAAI,CAAA,CAChD,OAAA,EAAQ,CACR,OAAA,CAAQ,UAAU,CAAA;AAAA,EACrB,aAAA,EAAe,OAAA,CAAQ,gBAAA,EAAkB,EAAE,MAAA,EAAQ,EAAA,EAAI,CAAA,CACpD,OAAA,EAAQ,CACR,OAAA,CAAQ,QAAQ,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnB,cAAc,OAAA,CAAQ,gBAAA,EAAkB,EAAE,MAAA,EAAQ,IAAI,CAAA;AAAA;AAAA;AAAA;AAAA,EAItD,iBAAiB,GAAA,CAAI,mBAAmB,EAAE,OAAA,EAAQ,CAAE,QAAQ,IAAI,CAAA;AAAA;AAAA;AAAA,EAGhE,UAAA,EAAY,KAAK,aAAa,CAAA;AAAA,EAC9B,SAAA,EAAW,QAAA,CAAS,YAAA,EAAc,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,CACjD,OAAA,EAAQ,CACR,OAAA,CAAQ,GAAA,CAAA,iBAAA,CAAsB,CAAA;AAAA,EACjC,eAAA,EAAiB,iBAAiB,oBAAoB;AACxD,CAAC;AAMM,IAAM,YAAA,GAAe,UAAA;AAAA,EAC1B,eAAA;AAAA,EACA;AAAA,IACE,IAAI,QAAA,EAAS;AAAA,IACb,MAAA,EAAQ,SAAS,SAAS,CAAA;AAAA,IAC1B,KAAA,EAAO,QAAQ,OAAA,EAAS,EAAE,QAAQ,GAAA,EAAK,EAAE,OAAA,EAAQ;AAAA,IACjD,WAAW,SAAA,EAAU;AAAA,IACrB,SAAA,EAAW,QAAA,CAAS,YAAA,EAAc,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,CACjD,OAAA,EAAQ,CACR,OAAA,CAAQ,GAAA,CAAA,iBAAA,CAAsB;AAAA,GACnC;AAAA,EACA,CAAC,CAAA,MAAO;AAAA,IACN,cAAA,EAAgB,MAAM,+BAA+B,CAAA,CAAE,GAAG,CAAA,CAAE,MAAA,EAAQ,EAAE,SAAS;AAAA,GACjF;AACF;AAMO,IAAM,mBAAA,GAAsB,CAAC,MAAA,EAAQ,WAAW,CAAA;AAEhD,IAAM,YAAA,GAAe,UAAA;AAAA,EAC1B,eAAA;AAAA,EACA;AAAA,IACE,IAAI,QAAA,EAAS;AAAA,IACb,SAAA,EAAW,SAAS,YAAY,CAAA;AAAA,IAChC,IAAA,EAAM,SAAA,CAAU,MAAA,EAAQ,mBAAmB,EAAE,OAAA,EAAQ;AAAA,IACrD,QAAA,EAAU,KAAK,UAAU,CAAA;AAAA,IACzB,MAAA,EAAQ,KAAK,QAAQ,CAAA;AAAA,IACrB,KAAA,EAAO,KAAK,OAAO,CAAA;AAAA,IACnB,SAAA,EAAW,KAAK,YAAY,CAAA;AAAA,IAC5B,WAAW,SAAA;AAAU,GACvB;AAAA,EACA,CAAC,CAAA,MAAO;AAAA,IACN,iBAAA,EAAmB,MAAM,8BAA8B,CAAA,CAAE,GAAG,CAAA,CAAE,SAAA,EAAW,EAAE,SAAS;AAAA,GACtF;AACF;;;AC1DO,IAAM,4BAAA,GAA+B,IAAA;;;ACrC5C,SAAS,WAAW,GAAA,EAAkC;AACpD,EAAA,OAAO;AAAA,IACL,IAAI,GAAA,CAAI,EAAA;AAAA,IACR,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,SAAA,EAAW,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS,CAAA;AAAA,IACjC,SAAA,EAAW,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS;AAAA,GACnC;AACF;AAEA,SAAS,WAAW,GAAA,EAAkC;AACpD,EAAA,OAAO;AAAA,IACL,IAAI,GAAA,CAAI,EAAA;AAAA,IACR,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,UAAU,GAAA,CAAI,QAAA;AAAA,IACd,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,WAAW,GAAA,CAAI,SAAA;AAAA,IACf,SAAA,EAAW,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS;AAAA,GACnC;AACF;AAEA,SAAS,YAAY,GAAA,EAAgC;AACnD,EAAA,OAAO;AAAA,IACL,cAAc,GAAA,CAAI,YAAA;AAAA,IAClB,aAAa,GAAA,CAAI,WAAA;AAAA,IACjB,eAAe,GAAA,CAAI,aAAA;AAAA,IACnB,iBAAiB,GAAA,CAAI,eAAA;AAAA,IACrB,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,cAAc,GAAA,CAAI,YAAA;AAAA,IAClB,WAAW,GAAA,CAAI,SAAA,GAAY,IAAI,IAAA,CAAK,GAAA,CAAI,SAAS,CAAA,GAAI,IAAA;AAAA,IACrD,iBAAiB,GAAA,CAAI;AAAA,GACvB;AACF;AAMO,SAAS,yBACd,EAAA,EACiB;AACjB,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAKL,MAAM,cAAc,KAAA,EAAiD;AACnE,MAAA,MAAM,WAAW,MAAM,EAAA,CACpB,MAAA,CAAO,YAAY,EACnB,MAAA,CAAO;AAAA,QACN,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,OAAO,KAAA,CAAM;AAAA,OACd,EACA,YAAA,EAAa;AAEhB,MAAA,MAAM,EAAA,GAAK,QAAA,CAAS,CAAC,CAAA,EAAG,EAAA;AACxB,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,MAAM,IAAI,MAAM,sCAAsC,CAAA;AAAA,MACxD;AAEA,MAAA,MAAM,CAAC,GAAG,CAAA,GAAI,MAAM,EAAA,CACjB,MAAA,GACA,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,GAAG,YAAA,CAAa,EAAA,EAAI,EAAE,CAAC,CAAA,CAC7B,MAAM,CAAC,CAAA;AAEV,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,EAAE,CAAA,uBAAA,CAAyB,CAAA;AAAA,MACnE;AACA,MAAA,OAAO,WAAW,GAAG,CAAA;AAAA,IACvB,CAAA;AAAA,IAEA,MAAM,UAAA,CAAW,EAAA,EAAY,MAAA,EAA6C;AACxE,MAAA,MAAM,CAAC,GAAG,CAAA,GAAI,MAAM,EAAA,CACjB,QAAO,CACP,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,GAAA,CAAI,GAAG,YAAA,CAAa,EAAA,EAAI,EAAE,CAAA,EAAG,EAAA,CAAG,YAAA,CAAa,MAAA,EAAQ,MAAM,CAAC,CAAC,CAAA,CACnE,KAAA,CAAM,CAAC,CAAA;AAEV,MAAA,OAAO,GAAA,GAAM,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA;AAAA,IACjC,CAAA;AAAA,IAEA,MAAM,mBAAA,CACJ,MAAA,EACA,IAAA,EACwB;AACxB,MAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,IAAS,EAAA;AAC7B,MAAA,MAAM,IAAA,GAAO,MAAM,EAAA,CAChB,MAAA,GACA,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,EAAA,CAAG,YAAA,CAAa,QAAQ,MAAM,CAAC,EACrC,OAAA,CAAQ,IAAA,CAAK,aAAa,SAAS,CAAC,CAAA,CACpC,KAAA,CAAM,KAAK,CAAA;AAEd,MAAA,OAAO,IAAA,CAAK,IAAI,UAAU,CAAA;AAAA,IAC5B,CAAA;AAAA,IAEA,MAAM,aAAA,CACJ,EAAA,EACA,MAAA,EACA,KAAA,EACe;AACf,MAAA,IAAI,KAAA,CAAM,UAAU,MAAA,EAAW;AAE/B,MAAA,MAAM,EAAA,CACH,OAAO,YAAY,CAAA,CACnB,IAAI,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,CAAA,CAC1B,MAAM,GAAA,CAAI,EAAA,CAAG,YAAA,CAAa,EAAA,EAAI,EAAE,CAAA,EAAG,GAAG,YAAA,CAAa,MAAA,EAAQ,MAAM,CAAC,CAAC,CAAA;AAAA,IACxE,CAAA;AAAA,IAEA,MAAM,aAAA,CAAc,EAAA,EAAY,MAAA,EAA+B;AAE7D,MAAA,MAAM,KAAA,GAAQ,MAAM,EAAA,CACjB,MAAA,CAAO,EAAE,EAAA,EAAI,YAAA,CAAa,EAAA,EAAI,CAAA,CAC9B,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,GAAA,CAAI,EAAA,CAAG,YAAA,CAAa,EAAA,EAAI,EAAE,CAAA,EAAG,EAAA,CAAG,YAAA,CAAa,MAAA,EAAQ,MAAM,CAAC,CAAC,CAAA,CACnE,KAAA,CAAM,CAAC,CAAA;AAEV,MAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AAExB,MAAA,MAAM,EAAA,CAAG,OAAO,YAAY,CAAA,CAAE,MAAM,EAAA,CAAG,YAAA,CAAa,SAAA,EAAW,EAAE,CAAC,CAAA;AAClE,MAAA,MAAM,GACH,MAAA,CAAO,YAAY,CAAA,CACnB,KAAA,CAAM,IAAI,EAAA,CAAG,YAAA,CAAa,EAAA,EAAI,EAAE,GAAG,EAAA,CAAG,YAAA,CAAa,MAAA,EAAQ,MAAM,CAAC,CAAC,CAAA;AAAA,IACxE,CAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM,cAAc,KAAA,EAAiD;AACnE,MAAA,MAAM,WAAW,MAAM,EAAA,CACpB,MAAA,CAAO,YAAY,EACnB,MAAA,CAAO;AAAA,QACN,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,QAAA,EAAU,MAAM,QAAA,IAAY,IAAA;AAAA,QAC5B,MAAA,EAAQ,MAAM,MAAA,IAAU,IAAA;AAAA,QACxB,KAAA,EAAO,MAAM,KAAA,IAAS,IAAA;AAAA,QACtB,SAAA,EAAW,MAAM,SAAA,IAAa;AAAA,OAC/B,EACA,YAAA,EAAa;AAEhB,MAAA,MAAM,EAAA,GAAK,QAAA,CAAS,CAAC,CAAA,EAAG,EAAA;AACxB,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,MAAM,IAAI,MAAM,sCAAsC,CAAA;AAAA,MACxD;AAEA,MAAA,MAAM,CAAC,GAAG,CAAA,GAAI,MAAM,EAAA,CACjB,MAAA,GACA,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,GAAG,YAAA,CAAa,EAAA,EAAI,EAAE,CAAC,CAAA,CAC7B,MAAM,CAAC,CAAA;AAEV,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,EAAE,CAAA,uBAAA,CAAyB,CAAA;AAAA,MACnE;AACA,MAAA,OAAO,WAAW,GAAG,CAAA;AAAA,IACvB,CAAA;AAAA,IAEA,MAAM,sBAAA,CACJ,SAAA,EACA,MAAA,EACwB;AAGxB,MAAA,MAAM,KAAA,GAAQ,MAAM,EAAA,CACjB,MAAA,CAAO,EAAE,EAAA,EAAI,YAAA,CAAa,EAAA,EAAI,CAAA,CAC9B,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA;AAAA,QACC,GAAA,CAAI,EAAA,CAAG,YAAA,CAAa,EAAA,EAAI,SAAS,GAAG,EAAA,CAAG,YAAA,CAAa,MAAA,EAAQ,MAAM,CAAC;AAAA,OACrE,CACC,MAAM,CAAC,CAAA;AAEV,MAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAEhC,MAAA,MAAM,OAAO,MAAM,EAAA,CAChB,QAAO,CACP,IAAA,CAAK,YAAY,CAAA,CACjB,KAAA,CAAM,GAAG,YAAA,CAAa,SAAA,EAAW,SAAS,CAAC,CAAA,CAC3C,QAAQ,YAAA,CAAa,SAAA,EAAW,aAAa,EAAE,CAAA;AAElD,MAAA,OAAO,IAAA,CAAK,IAAI,UAAU,CAAA;AAAA,IAC5B,CAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM,aAAA,GAAqC;AACzC,MAAA,MAAM,CAAC,GAAG,CAAA,GAAI,MAAM,EAAA,CACjB,MAAA,GACA,IAAA,CAAK,UAAU,CAAA,CACf,KAAA,CAAM,GAAG,UAAA,CAAW,EAAA,EAAI,CAAC,CAAC,CAAA,CAC1B,MAAM,CAAC,CAAA;AAEV,MAAA,IAAI,CAAC,GAAA,EAAK;AAGR,QAAA,OAAO;AAAA,UACL,YAAA,EAAc,QAAA;AAAA,UACd,WAAA,EAAa,UAAA;AAAA,UACb,aAAA,EAAe,QAAA;AAAA,UACf,eAAA,EAAiB,4BAAA;AAAA,UACjB,UAAA,EAAY,IAAA;AAAA,UACZ,YAAA,EAAc,IAAA;AAAA,UACd,SAAA,EAAW,IAAA;AAAA,UACX,eAAA,EAAiB;AAAA,SACnB;AAAA,MACF;AAEA,MAAA,OAAO,YAAY,GAAG,CAAA;AAAA,IACxB,CAAA;AAAA,IAEA,MAAM,gBAAA,CACJ,KAAA,EACA,QAAA,EACqB;AAIrB,MAAA,MAAM,YAAA,GAAe;AAAA,QACnB,EAAA,EAAI,CAAA;AAAA,QACJ,YAAA,EAAc,MAAM,YAAA,IAAgB,QAAA;AAAA,QACpC,WAAA,EAAa,MAAM,WAAA,IAAe,UAAA;AAAA,QAClC,aAAA,EAAe,MAAM,aAAA,IAAiB,QAAA;AAAA,QACtC,eAAA,EACE,MAAM,eAAA,IAAmB,4BAAA;AAAA,QAC3B,UAAA,EAAY,MAAM,UAAA,IAAc,IAAA;AAAA,QAChC,YAAA,EAAc,MAAM,YAAA,IAAgB,IAAA;AAAA,QACpC,eAAA,EAAiB;AAAA,OACnB;AAEA,MAAA,MAAM,SAAA,GAAqC;AAAA,QACzC,eAAA,EAAiB;AAAA,OACnB;AACA,MAAA,IAAI,KAAA,CAAM,iBAAiB,MAAA,EAAW;AACpC,QAAA,SAAA,CAAU,eAAe,KAAA,CAAM,YAAA;AAAA,MACjC;AACA,MAAA,IAAI,KAAA,CAAM,gBAAgB,MAAA,EAAW;AACnC,QAAA,SAAA,CAAU,cAAc,KAAA,CAAM,WAAA;AAAA,MAChC;AACA,MAAA,IAAI,KAAA,CAAM,kBAAkB,MAAA,EAAW;AACrC,QAAA,SAAA,CAAU,gBAAgB,KAAA,CAAM,aAAA;AAAA,MAClC;AACA,MAAA,IAAI,KAAA,CAAM,oBAAoB,MAAA,EAAW;AACvC,QAAA,SAAA,CAAU,kBAAkB,KAAA,CAAM,eAAA;AAAA,MACpC;AACA,MAAA,IAAI,KAAA,CAAM,eAAe,MAAA,EAAW;AAClC,QAAA,SAAA,CAAU,aAAa,KAAA,CAAM,UAAA;AAAA,MAC/B;AACA,MAAA,IAAI,KAAA,CAAM,iBAAiB,MAAA,EAAW;AACpC,QAAA,SAAA,CAAU,eAAe,KAAA,CAAM,YAAA;AAAA,MACjC;AAEA,MAAA,MAAM,EAAA,CACH,MAAA,CAAO,UAAU,CAAA,CACjB,MAAA,CAAO,YAAY,CAAA,CACnB,oBAAA,CAAqB,EAAE,GAAA,EAAK,SAAA,EAAW,CAAA;AAE1C,MAAA,MAAM,CAAC,GAAG,CAAA,GAAI,MAAM,EAAA,CACjB,MAAA,GACA,IAAA,CAAK,UAAU,CAAA,CACf,KAAA,CAAM,GAAG,UAAA,CAAW,EAAA,EAAI,CAAC,CAAC,CAAA,CAC1B,MAAM,CAAC,CAAA;AAEV,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAM,IAAI,MAAM,sDAAsD,CAAA;AAAA,MACxE;AACA,MAAA,OAAO,YAAY,GAAG,CAAA;AAAA,IACxB;AAAA,GACF;AACF","file":"index.js","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  int,\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  /**\n   * Admin-editable GCP project override. NULL means the host's static\n   * `VertexPort.projectId` is used. Lets admins flip the active GCP\n   * project without redeploying — useful for staging/prod migrations\n   * or running multiple FLC tenants from one runtime.\n   */\n  gcpProjectId: varchar('gcp_project_id', { length: 64 }),\n  // Caps the per-turn output budget for both the agent loop AND the prose\n  // narrator. Reasoning models charge internal thinking against this; bump\n  // it well past 4096 when one is in use.\n  maxOutputTokens: int('max_output_tokens').notNull().default(4096),\n  // Optional admin-editable role/persona. NULL means the host's static\n  // `rolePrompt` (passed to configureAiChat) is used as the fallback.\n  rolePrompt: text('role_prompt'),\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 * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\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 {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type 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    maxOutputTokens: row.maxOutputTokens,\n    rolePrompt: row.rolePrompt,\n    gcpProjectId: row.gcpProjectId,\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          maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n          rolePrompt: null,\n          gcpProjectId: null,\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        maxOutputTokens:\n          patch.maxOutputTokens ?? DEFAULT_AI_MAX_OUTPUT_TOKENS,\n        rolePrompt: patch.rolePrompt ?? null,\n        gcpProjectId: patch.gcpProjectId ?? null,\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      if (patch.maxOutputTokens !== undefined) {\n        updateSet.maxOutputTokens = patch.maxOutputTokens;\n      }\n      if (patch.rolePrompt !== undefined) {\n        updateSet.rolePrompt = patch.rolePrompt;\n      }\n      if (patch.gcpProjectId !== undefined) {\n        updateSet.gcpProjectId = patch.gcpProjectId;\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"]}
+{"version":3,"sources":["../../src/adapters/drizzle/tables.ts","../../src/server/ports/types.ts","../../src/adapters/drizzle/adapter.ts"],"names":["sql"],"mappings":"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","file":"index.js","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  int,\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  /**\n   * Admin-editable GCP project override. NULL means the host's static\n   * `VertexPort.projectId` is used. Lets admins flip the active GCP\n   * project without redeploying — useful for staging/prod migrations\n   * or running multiple FLC tenants from one runtime.\n   */\n  gcpProjectId: varchar('gcp_project_id', { length: 64 }),\n  // Caps the per-turn output budget for both the agent loop AND the prose\n  // narrator. Reasoning models charge internal thinking against this; bump\n  // it well past 4096 when one is in use.\n  maxOutputTokens: int('max_output_tokens').notNull().default(4096),\n  // Optional admin-editable role/persona. NULL means the host's static\n  // `rolePrompt` (passed to configureAiChat) is used as the fallback.\n  rolePrompt: text('role_prompt'),\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 * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\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, sql } from 'drizzle-orm';\nimport type { MySql2Database } from 'drizzle-orm/mysql2';\n\nimport {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type 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    maxOutputTokens: row.maxOutputTokens,\n    rolePrompt: row.rolePrompt,\n    gcpProjectId: row.gcpProjectId,\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      // Bump the parent session's `updated_at` so `listSessionsForUser`\n      // (ordered by updatedAt DESC) reflects \"most recent activity\"\n      // rather than creation time. The column has no MySQL ON UPDATE\n      // clause, so we set it explicitly here.\n      await db\n        .update(chatSessions)\n        .set({ updatedAt: sql`CURRENT_TIMESTAMP` })\n        .where(eq(chatSessions.id, input.sessionId));\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          maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n          rolePrompt: null,\n          gcpProjectId: null,\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        maxOutputTokens:\n          patch.maxOutputTokens ?? DEFAULT_AI_MAX_OUTPUT_TOKENS,\n        rolePrompt: patch.rolePrompt ?? null,\n        gcpProjectId: patch.gcpProjectId ?? null,\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      if (patch.maxOutputTokens !== undefined) {\n        updateSet.maxOutputTokens = patch.maxOutputTokens;\n      }\n      if (patch.rolePrompt !== undefined) {\n        updateSet.rolePrompt = patch.rolePrompt;\n      }\n      if (patch.gcpProjectId !== undefined) {\n        updateSet.gcpProjectId = patch.gcpProjectId;\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"]}

package/dist/prisma/index.cjs

@@ -84,6 +84,10 @@ function createPrismaPersistence(prisma) {
           errorJson: input.errorJson ?? null
         }
       });
+      await prisma.chatSession.update({
+        where: { id: input.sessionId },
+        data: { updatedAt: /* @__PURE__ */ new Date() }
+      });
       return toMessage(row);
     },
     async listMessagesForSession(sessionId, userId) {

package/dist/prisma/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/ports/types.ts","../../src/adapters/prisma/adapter.ts","../../src/adapters/prisma/schema.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\n","/**\n * Prisma `PersistencePort` adapter.\n *\n * Hosts call `createPrismaPersistence(prisma)` with their own configured\n * `PrismaClient` and pass the result to `configureAiChat({ persistence, ... })`.\n *\n * The concrete `PrismaClient` is an OPTIONAL peer dep, so this module never\n * imports a runtime value from `@prisma/client`. Instead it accepts a\n * structural duck-typed shape covering only the delegate methods the port\n * uses. Any object that satisfies `PrismaLike` works — including a real\n * `PrismaClient`, a Prisma extension proxy, or a hand-rolled fake in tests.\n *\n * BigInt note: Prisma returns row IDs as JavaScript `BigInt`. Domain types\n * use plain `number` (sessions/messages are nowhere near 2^53). The adapter\n * widens via `Number(row.id)` on every read; writes accept `number` and\n * Prisma narrows internally.\n */\nimport {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type PersistencePort\n} from '../../server/ports/types';\n\n// ---------------------------------------------------------------------------\n// Structural Prisma shape — covers exactly what this adapter touches.\n// Avoids a value-level dependency on `@prisma/client` (optional peer dep).\n// ---------------------------------------------------------------------------\n\ntype ChatSessionRow = {\n  id: bigint | number;\n  userId: bigint | number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\ntype ChatMessageRow = {\n  id: bigint | number;\n  sessionId: bigint | number;\n  role: string;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\ntype AiSettingsRow = {\n  id: number;\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: bigint | number | null;\n};\n\ntype ChatSessionDelegate = {\n  create(args: {\n    data: { userId: number; title: string };\n  }): Promise<ChatSessionRow>;\n  findFirst(args: {\n    where: { id: number; userId: number };\n  }): Promise<ChatSessionRow | null>;\n  findMany(args: {\n    where: { userId: number };\n    orderBy: { updatedAt: 'desc' };\n    take?: number;\n  }): Promise<ChatSessionRow[]>;\n  update(args: {\n    where: { id: number };\n    data: { title?: string; updatedAt?: Date };\n  }): Promise<ChatSessionRow>;\n  updateMany(args: {\n    where: { id: number; userId: number };\n    data: { title?: string; updatedAt?: Date };\n  }): Promise<{ count: number }>;\n  deleteMany(args: {\n    where: { id: number; userId: number };\n  }): Promise<{ count: number }>;\n};\n\ntype ChatMessageDelegate = {\n  create(args: {\n    data: {\n      sessionId: number;\n      role: ChatMessageRole;\n      question: string | null;\n      blocks: unknown | null;\n      prose: unknown | null;\n      errorJson: unknown | null;\n    };\n  }): Promise<ChatMessageRow>;\n  findMany(args: {\n    where: { sessionId: number };\n    orderBy: { createdAt: 'asc' };\n  }): Promise<ChatMessageRow[]>;\n};\n\ntype AiSettingsDelegate = {\n  findUnique(args: { where: { id: number } }): Promise<AiSettingsRow | null>;\n  upsert(args: {\n    where: { id: number };\n    create: {\n      id: number;\n      toolProvider?: string;\n      gcpLocation?: string;\n      chatInterface?: string;\n      maxOutputTokens?: number;\n      rolePrompt?: string | null;\n      gcpProjectId?: string | null;\n      updatedByUserId: number;\n    };\n    update: {\n      toolProvider?: string;\n      gcpLocation?: string;\n      chatInterface?: string;\n      maxOutputTokens?: number;\n      rolePrompt?: string | null;\n      gcpProjectId?: string | null;\n      updatedByUserId: number;\n    };\n  }): Promise<AiSettingsRow>;\n};\n\nexport type PrismaLike = {\n  chatSession: ChatSessionDelegate;\n  chatMessage: ChatMessageDelegate;\n  aiSettings: AiSettingsDelegate;\n};\n\n// ---------------------------------------------------------------------------\n// Row -> domain mappers\n// ---------------------------------------------------------------------------\n\nconst toSession = (row: ChatSessionRow): ChatSession => ({\n  id: Number(row.id),\n  userId: Number(row.userId),\n  title: row.title,\n  createdAt: row.createdAt,\n  updatedAt: row.updatedAt\n});\n\nconst toMessage = (row: ChatMessageRow): ChatMessage => ({\n  id: Number(row.id),\n  sessionId: Number(row.sessionId),\n  // Stored as VARCHAR(16) but constrained to ChatMessageRole at write time.\n  role: row.role as ChatMessageRole,\n  question: row.question,\n  blocks: row.blocks,\n  prose: row.prose,\n  errorJson: row.errorJson,\n  createdAt: row.createdAt\n});\n\nconst toAiSettings = (row: AiSettingsRow): AiSettings => ({\n  toolProvider: row.toolProvider,\n  gcpLocation: row.gcpLocation,\n  chatInterface: row.chatInterface,\n  maxOutputTokens: row.maxOutputTokens,\n  rolePrompt: row.rolePrompt,\n  gcpProjectId: row.gcpProjectId,\n  updatedAt: row.updatedAt,\n  updatedByUserId: row.updatedByUserId === null ? null : Number(row.updatedByUserId)\n});\n\nconst DEFAULT_AI_SETTINGS: AiSettings = {\n  toolProvider: 'claude',\n  gcpLocation: 'us-east5',\n  chatInterface: 'custom',\n  maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  rolePrompt: null,\n  gcpProjectId: null,\n  updatedAt: null,\n  updatedByUserId: null\n};\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createPrismaPersistence(prisma: PrismaLike): PersistencePort {\n  return {\n    // Sessions ---------------------------------------------------------------\n\n    async createSession(input: CreateSessionInput): Promise<ChatSession> {\n      const row = await prisma.chatSession.create({\n        data: { userId: input.userId, title: input.title }\n      });\n      return toSession(row);\n    },\n\n    async getSession(id: number, userId: number): Promise<ChatSession | null> {\n      const row = await prisma.chatSession.findFirst({ where: { id, userId } });\n      return row ? toSession(row) : null;\n    },\n\n    async listSessionsForUser(\n      userId: number,\n      opts?: ListSessionsOpts\n    ): Promise<ChatSession[]> {\n      const rows = await prisma.chatSession.findMany({\n        where: { userId },\n        orderBy: { updatedAt: 'desc' },\n        take: opts?.limit\n      });\n      return rows.map(toSession);\n    },\n\n    async updateSession(\n      id: number,\n      userId: number,\n      patch: { title?: string }\n    ): Promise<void> {\n      // updateMany so the userId scope filters; no-ops cleanly when the\n      // session doesn't exist or belongs to another user.\n      await prisma.chatSession.updateMany({\n        where: { id, userId },\n        data: { ...patch, updatedAt: new Date() }\n      });\n    },\n\n    async deleteSession(id: number, userId: number): Promise<void> {\n      await prisma.chatSession.deleteMany({ where: { id, userId } });\n    },\n\n    // Messages ---------------------------------------------------------------\n\n    async appendMessage(input: AppendMessageInput): Promise<ChatMessage> {\n      const row = await prisma.chatMessage.create({\n        data: {\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      });\n      return toMessage(row);\n    },\n\n    async listMessagesForSession(\n      sessionId: number,\n      userId: number\n    ): Promise<ChatMessage[]> {\n      // Re-assert ownership before returning rows. A caller passing a\n      // sessionId they don't own should get an empty list, not someone\n      // else's transcript.\n      const session = await prisma.chatSession.findFirst({\n        where: { id: sessionId, userId }\n      });\n      if (!session) return [];\n      const rows = await prisma.chatMessage.findMany({\n        where: { sessionId },\n        orderBy: { createdAt: 'asc' }\n      });\n      return rows.map(toMessage);\n    },\n\n    // AI settings (singleton row at id=1) -----------------------------------\n\n    async getAiSettings(): Promise<AiSettings> {\n      const row = await prisma.aiSettings.findUnique({ where: { id: 1 } });\n      return row ? toAiSettings(row) : { ...DEFAULT_AI_SETTINGS };\n    },\n\n    async updateAiSettings(\n      patch: AiSettingsPatch,\n      byUserId: number\n    ): Promise<AiSettings> {\n      const row = await prisma.aiSettings.upsert({\n        where: { id: 1 },\n        create: { id: 1, ...patch, updatedByUserId: byUserId },\n        update: { ...patch, updatedByUserId: byUserId }\n      });\n      return toAiSettings(row);\n    }\n  };\n}\n","/**\n * The Prisma schema fragment hosts paste into their own `schema.prisma`.\n *\n * Kept in lock-step with `prisma/chat-models.prisma` at the package root.\n * The fragment is inlined here (not read from disk) so consumer bundlers\n * never need to resolve a runtime fs path.\n *\n * Codegen tooling can import this constant and write it out, splice it into\n * a host's `schema.prisma`, etc.\n */\nexport const prismaSchemaFragment: string = `// =============================================================================\n// @firstlovecenter/ai-chat — Prisma schema fragment\n// =============================================================================\n//\n// HOSTS: copy the three models below into your own \\`schema.prisma\\`, then run\n//\n//     pnpm prisma generate\n//     pnpm prisma migrate dev --name flc_ai_chat\n//\n// Column names, SQL types, and indexes match the Drizzle adapter shipped at\n// \\`@firstlovecenter/ai-chat/server/drizzle\\` byte-for-byte, so the underlying MySQL schema\n// is identical regardless of which ORM your host picks. A host could swap\n// from one adapter to the other without touching data.\n// =============================================================================\n\nmodel ChatSession {\n  id        BigInt   @id @default(autoincrement()) @db.UnsignedBigInt\n  userId    BigInt   @map(\"user_id\") @db.UnsignedBigInt\n  title     String   @db.VarChar(200)\n  createdAt DateTime @default(now()) @map(\"created_at\") @db.DateTime(0)\n  updatedAt DateTime @default(now()) @map(\"updated_at\") @db.DateTime(0)\n\n  @@index([userId, updatedAt], map: \"idx_chat_session_user_updated\")\n  @@map(\"chat_sessions\")\n}\n\nmodel ChatMessage {\n  id        BigInt   @id @default(autoincrement()) @db.UnsignedBigInt\n  sessionId BigInt   @map(\"session_id\") @db.UnsignedBigInt\n  role      String   @db.VarChar(16)\n  question  String?  @db.Text\n  blocks    Json?\n  prose     Json?\n  errorJson Json?    @map(\"error_json\")\n  createdAt DateTime @default(now()) @map(\"created_at\") @db.DateTime(0)\n\n  @@index([sessionId, createdAt], map: \"idx_chat_msg_session_created\")\n  @@map(\"chat_messages\")\n}\n\nmodel AiSettings {\n  id              Int       @id @default(1) @db.UnsignedTinyInt\n  toolProvider    String    @default(\"claude\") @map(\"tool_provider\") @db.VarChar(32)\n  gcpLocation     String    @default(\"us-east5\") @map(\"gcp_location\") @db.VarChar(32)\n  chatInterface   String    @default(\"custom\") @map(\"chat_interface\") @db.VarChar(32)\n  updatedAt       DateTime  @default(now()) @map(\"updated_at\") @db.DateTime(0)\n  updatedByUserId BigInt?   @map(\"updated_by_user_id\") @db.UnsignedBigInt\n\n  @@map(\"ai_settings\")\n}\n`;\n"]}
+{"version":3,"sources":["../../src/server/ports/types.ts","../../src/adapters/prisma/adapter.ts","../../src/adapters/prisma/schema.ts"],"names":[],"mappings":";;;AAmFO,IAAM,4BAAA,GAA+B,IAAA;;;AC6D5C,IAAM,SAAA,GAAY,CAAC,GAAA,MAAsC;AAAA,EACvD,EAAA,EAAI,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAAA,EACjB,MAAA,EAAQ,MAAA,CAAO,GAAA,CAAI,MAAM,CAAA;AAAA,EACzB,OAAO,GAAA,CAAI,KAAA;AAAA,EACX,WAAW,GAAA,CAAI,SAAA;AAAA,EACf,WAAW,GAAA,CAAI;AACjB,CAAA,CAAA;AAEA,IAAM,SAAA,GAAY,CAAC,GAAA,MAAsC;AAAA,EACvD,EAAA,EAAI,MAAA,CAAO,GAAA,CAAI,EAAE,CAAA;AAAA,EACjB,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,SAAS,CAAA;AAAA;AAAA,EAE/B,MAAM,GAAA,CAAI,IAAA;AAAA,EACV,UAAU,GAAA,CAAI,QAAA;AAAA,EACd,QAAQ,GAAA,CAAI,MAAA;AAAA,EACZ,OAAO,GAAA,CAAI,KAAA;AAAA,EACX,WAAW,GAAA,CAAI,SAAA;AAAA,EACf,WAAW,GAAA,CAAI;AACjB,CAAA,CAAA;AAEA,IAAM,YAAA,GAAe,CAAC,GAAA,MAAoC;AAAA,EACxD,cAAc,GAAA,CAAI,YAAA;AAAA,EAClB,aAAa,GAAA,CAAI,WAAA;AAAA,EACjB,eAAe,GAAA,CAAI,aAAA;AAAA,EACnB,iBAAiB,GAAA,CAAI,eAAA;AAAA,EACrB,YAAY,GAAA,CAAI,UAAA;AAAA,EAChB,cAAc,GAAA,CAAI,YAAA;AAAA,EAClB,WAAW,GAAA,CAAI,SAAA;AAAA,EACf,iBAAiB,GAAA,CAAI,eAAA,KAAoB,OAAO,IAAA,GAAO,MAAA,CAAO,IAAI,eAAe;AACnF,CAAA,CAAA;AAEA,IAAM,mBAAA,GAAkC;AAAA,EACtC,YAAA,EAAc,QAAA;AAAA,EACd,WAAA,EAAa,UAAA;AAAA,EACb,aAAA,EAAe,QAAA;AAAA,EACf,eAAA,EAAiB,4BAAA;AAAA,EACjB,UAAA,EAAY,IAAA;AAAA,EACZ,YAAA,EAAc,IAAA;AAAA,EACd,SAAA,EAAW,IAAA;AAAA,EACX,eAAA,EAAiB;AACnB,CAAA;AAMO,SAAS,wBAAwB,MAAA,EAAqC;AAC3E,EAAA,OAAO;AAAA;AAAA,IAGL,MAAM,cAAc,KAAA,EAAiD;AACnE,MAAA,MAAM,GAAA,GAAM,MAAM,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO;AAAA,QAC1C,MAAM,EAAE,MAAA,EAAQ,MAAM,MAAA,EAAQ,KAAA,EAAO,MAAM,KAAA;AAAM,OAClD,CAAA;AACD,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAA;AAAA,IAEA,MAAM,UAAA,CAAW,EAAA,EAAY,MAAA,EAA6C;AACxE,MAAA,MAAM,GAAA,GAAM,MAAM,MAAA,CAAO,WAAA,CAAY,SAAA,CAAU,EAAE,KAAA,EAAO,EAAE,EAAA,EAAI,MAAA,EAAO,EAAG,CAAA;AACxE,MAAA,OAAO,GAAA,GAAM,SAAA,CAAU,GAAG,CAAA,GAAI,IAAA;AAAA,IAChC,CAAA;AAAA,IAEA,MAAM,mBAAA,CACJ,MAAA,EACA,IAAA,EACwB;AACxB,MAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,WAAA,CAAY,QAAA,CAAS;AAAA,QAC7C,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,QAChB,OAAA,EAAS,EAAE,SAAA,EAAW,MAAA,EAAO;AAAA,QAC7B,MAAM,IAAA,EAAM;AAAA,OACb,CAAA;AACD,MAAA,OAAO,IAAA,CAAK,IAAI,SAAS,CAAA;AAAA,IAC3B,CAAA;AAAA,IAEA,MAAM,aAAA,CACJ,EAAA,EACA,MAAA,EACA,KAAA,EACe;AAGf,MAAA,MAAM,MAAA,CAAO,YAAY,UAAA,CAAW;AAAA,QAClC,KAAA,EAAO,EAAE,EAAA,EAAI,MAAA,EAAO;AAAA,QACpB,MAAM,EAAE,GAAG,OAAO,SAAA,kBAAW,IAAI,MAAK;AAAE,OACzC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,MAAM,aAAA,CAAc,EAAA,EAAY,MAAA,EAA+B;AAC7D,MAAA,MAAM,MAAA,CAAO,YAAY,UAAA,CAAW,EAAE,OAAO,EAAE,EAAA,EAAI,MAAA,EAAO,EAAG,CAAA;AAAA,IAC/D,CAAA;AAAA;AAAA,IAIA,MAAM,cAAc,KAAA,EAAiD;AACnE,MAAA,MAAM,GAAA,GAAM,MAAM,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO;AAAA,QAC1C,IAAA,EAAM;AAAA,UACJ,WAAW,KAAA,CAAM,SAAA;AAAA,UACjB,MAAM,KAAA,CAAM,IAAA;AAAA,UACZ,QAAA,EAAU,MAAM,QAAA,IAAY,IAAA;AAAA,UAC5B,MAAA,EAAQ,MAAM,MAAA,IAAU,IAAA;AAAA,UACxB,KAAA,EAAO,MAAM,KAAA,IAAS,IAAA;AAAA,UACtB,SAAA,EAAW,MAAM,SAAA,IAAa;AAAA;AAChC,OACD,CAAA;AAKD,MAAA,MAAM,MAAA,CAAO,YAAY,MAAA,CAAO;AAAA,QAC9B,KAAA,EAAO,EAAE,EAAA,EAAI,KAAA,CAAM,SAAA,EAAU;AAAA,QAC7B,IAAA,EAAM,EAAE,SAAA,kBAAW,IAAI,MAAK;AAAE,OAC/B,CAAA;AACD,MAAA,OAAO,UAAU,GAAG,CAAA;AAAA,IACtB,CAAA;AAAA,IAEA,MAAM,sBAAA,CACJ,SAAA,EACA,MAAA,EACwB;AAIxB,MAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,WAAA,CAAY,SAAA,CAAU;AAAA,QACjD,KAAA,EAAO,EAAE,EAAA,EAAI,SAAA,EAAW,MAAA;AAAO,OAChC,CAAA;AACD,MAAA,IAAI,CAAC,OAAA,EAAS,OAAO,EAAC;AACtB,MAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,WAAA,CAAY,QAAA,CAAS;AAAA,QAC7C,KAAA,EAAO,EAAE,SAAA,EAAU;AAAA,QACnB,OAAA,EAAS,EAAE,SAAA,EAAW,KAAA;AAAM,OAC7B,CAAA;AACD,MAAA,OAAO,IAAA,CAAK,IAAI,SAAS,CAAA;AAAA,IAC3B,CAAA;AAAA;AAAA,IAIA,MAAM,aAAA,GAAqC;AACzC,MAAA,MAAM,GAAA,GAAM,MAAM,MAAA,CAAO,UAAA,CAAW,UAAA,CAAW,EAAE,KAAA,EAAO,EAAE,EAAA,EAAI,CAAA,EAAE,EAAG,CAAA;AACnE,MAAA,OAAO,MAAM,YAAA,CAAa,GAAG,CAAA,GAAI,EAAE,GAAG,mBAAA,EAAoB;AAAA,IAC5D,CAAA;AAAA,IAEA,MAAM,gBAAA,CACJ,KAAA,EACA,QAAA,EACqB;AACrB,MAAA,MAAM,GAAA,GAAM,MAAM,MAAA,CAAO,UAAA,CAAW,MAAA,CAAO;AAAA,QACzC,KAAA,EAAO,EAAE,EAAA,EAAI,CAAA,EAAE;AAAA,QACf,QAAQ,EAAE,EAAA,EAAI,GAAG,GAAG,KAAA,EAAO,iBAAiB,QAAA,EAAS;AAAA,QACrD,MAAA,EAAQ,EAAE,GAAG,KAAA,EAAO,iBAAiB,QAAA;AAAS,OAC/C,CAAA;AACD,MAAA,OAAO,aAAa,GAAG,CAAA;AAAA,IACzB;AAAA,GACF;AACF;;;AC9RO,IAAM,oBAAA,GAA+B,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA","file":"index.cjs","sourcesContent":["/**\n * Ports — the contract between this package and any host that consumes it.\n *\n * Every project-specific concern (auth, scope, persistence, tools, credentials)\n * crosses the boundary as a typed port the host implements and passes into\n * `configureAiChat({...})`. The package itself has zero knowledge of the\n * host's database, RBAC model, or environment.\n *\n * Domain types (ChatSession, ChatMessage, AiSettings, PresentPayload, Block)\n * are pure TS — no ORM coupling. The Drizzle and Prisma adapters each map\n * their respective row types into these shapes so callers see one contract\n * regardless of the chosen ORM.\n */\nimport type { GoogleAuth } from 'google-auth-library';\nimport type { ToolDefinition, ToolContext, SystemBlock } from '../tools/types';\n\n// ---------------------------------------------------------------------------\n// Domain types — used by every port\n// ---------------------------------------------------------------------------\n\nexport type ChatSession = {\n  id: number;\n  userId: number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\nexport type ChatMessageRole = 'user' | 'assistant';\n\n/**\n * One message turn. For 'user' rows, `question` carries the raw question text.\n * For 'assistant' rows, `blocks` holds the structured PresentPayload and\n * `prose` holds any paragraph_brief prose collected from the streamed\n * narrator. `errorJson` is set when an assistant turn failed mid-stream.\n */\nexport type ChatMessage = {\n  id: number;\n  sessionId: number;\n  role: ChatMessageRole;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\n/**\n * Singleton row controlling global AI runtime settings. All open-string\n * fields are validated at runtime against the registries the host configures\n * — they are not enums in the package's types so consumers can register\n * additional providers / interfaces without a schema change.\n *\n * `maxOutputTokens` caps both the agent loop's per-turn output AND each\n * narrator's prose pass. Reasoning models (e.g. `xai/grok-4.1-fast-reasoning`)\n * charge internal thinking against this budget — set it generously when\n * those are in use.\n *\n * `rolePrompt` is the persona the assistant adopts. When non-null, it\n * takes precedence over the host's static `rolePrompt` configureAiChat\n * option, so admins can edit live in the settings UI.\n *\n * `gcpProjectId` is an admin-editable override for the GCP project that\n * every Vertex API call targets. When non-null, it takes precedence over\n * the host's static `VertexPort.projectId` so admins can flip projects\n * (staging ↔ prod, multi-tenant) without redeploying.\n */\nexport type AiSettings = {\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: number | null;\n};\n\n/**\n * Default cap when nothing is persisted. Conservative so non-reasoning\n * models don't pay for headroom they don't need; admins bump it for\n * reasoning models via the settings UI.\n */\nexport const DEFAULT_AI_MAX_OUTPUT_TOKENS = 4096;\n\n// ---------------------------------------------------------------------------\n// AuthPort — the host tells us who's calling\n// ---------------------------------------------------------------------------\n\n/**\n * The host's resolved Scope (org/tenant/RBAC shape) is opaque to the package.\n * `S` is whatever the host wants — typically a discriminated union with at\n * least `userId: number` plus role/tenancy fields.\n */\nexport type AuthOk<S> = { ok: true; scope: S; userId: number };\nexport type AuthFail = { ok: false; response: Response };\nexport type AuthResult<S> = AuthOk<S> | AuthFail;\n\nexport type AuthPort<S = unknown> = {\n  /**\n   * Resolve the calling user from the request. Returning `{ ok: false }`\n   * lets the route hand back the prepared 401/403 response untouched.\n   */\n  requireAuth(req: Request): Promise<AuthResult<S>>;\n  /**\n   * Predicate the admin-settings route uses to gate writes. Hosts that\n   * don't model admins can return `() => true` if they trust their own\n   * routing layer.\n   */\n  isSuperAdmin(scope: S): boolean;\n};\n\n// ---------------------------------------------------------------------------\n// ScopePort — human-readable scope description fed into the system prompt\n// ---------------------------------------------------------------------------\n\nexport type ScopePort<S = unknown> = {\n  /** Short label rendered in the chat UI (e.g. \"Ghana\", \"All countries\"). */\n  resolveScopeLabel(scope: S): Promise<string>;\n  /** Longer narrative the system prompt uses to describe the data slice. */\n  buildScopeSummary(scope: S): Promise<string>;\n};\n\n// ---------------------------------------------------------------------------\n// ToolsPort — host supplies its own tool registry + system prompts\n// ---------------------------------------------------------------------------\n\nexport type ToolsPort = {\n  /**\n   * Map of tool name → definition. Keys must match `definition.schema.name`.\n   * Must include the terminal `present` tool — the agent loop refuses to\n   * end a turn without it.\n   */\n  tools: Record<string, ToolDefinition>;\n  /**\n   * Build the ordered list of system blocks for one agent run. The host\n   * decides how much of the prompt is project-specific (schema doc,\n   * semantic-layer doc, scope summary, etc.). Blocks marked `cached: true`\n   * become Anthropic ephemeral cache markers and Vertex prefix-cache hints.\n   */\n  buildSystemBlocks(ctx: ToolContext): Promise<SystemBlock[]>;\n};\n\n// ---------------------------------------------------------------------------\n// VertexPort — credentials are host-supplied; the package never reads env\n// ---------------------------------------------------------------------------\n\nexport type VertexPort = {\n  projectId: string;\n  /** e.g. 'us-east5' or 'global' — used unless `aiSettings.gcpLocation` overrides per-request. */\n  defaultLocation: string;\n  /**\n   * A constructed `GoogleAuth` instance. Any auth scheme that yields one\n   * works (ADC, Workload Identity Federation, split-key env vars,\n   * Secret Manager, etc.). The package never reads `process.env.GCP_*`.\n   */\n  auth: GoogleAuth;\n  /** Vertex model IDs pinned by the host (orgs pin their own versions). */\n  modelIds: { claude: string; gemini: string };\n};\n\n// ---------------------------------------------------------------------------\n// LoggerPort — optional structured logging\n// ---------------------------------------------------------------------------\n\nexport type LoggerPort = {\n  debug(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n};\n\n// ---------------------------------------------------------------------------\n// PersistencePort — domain-shaped queries the package needs\n// ---------------------------------------------------------------------------\n\nexport type CreateSessionInput = {\n  userId: number;\n  title: string;\n};\n\nexport type AppendMessageInput = {\n  sessionId: number;\n  role: ChatMessageRole;\n  question?: string | null;\n  blocks?: unknown | null;\n  prose?: unknown | null;\n  errorJson?: unknown | null;\n};\n\nexport type ListSessionsOpts = {\n  limit?: number;\n};\n\nexport type AiSettingsPatch = {\n  toolProvider?: string;\n  gcpLocation?: string;\n  chatInterface?: string;\n  maxOutputTokens?: number;\n  /** Pass `null` to clear back to the host's static fallback. */\n  rolePrompt?: string | null;\n  /** Pass `null` to clear back to the host's static VertexPort.projectId. */\n  gcpProjectId?: string | null;\n};\n\n/**\n * The whole reason this package is ORM-agnostic. Implemented by:\n *   - createDrizzlePersistence (src/adapters/drizzle/)\n *   - createPrismaPersistence  (src/adapters/prisma/)\n *   - createMemoryPersistence  (src/adapters/memory/, internal test use)\n *\n * Routes, agent loop, and UI never touch ORMs directly — they only call\n * methods on this port. A parameterized contract test runs the same\n * assertions against all three adapters to keep them in sync.\n */\nexport type PersistencePort = {\n  // Sessions ---------------------------------------------------------------\n  createSession(input: CreateSessionInput): Promise<ChatSession>;\n  /** Returns null when the session doesn't exist OR doesn't belong to this user. */\n  getSession(id: number, userId: number): Promise<ChatSession | null>;\n  listSessionsForUser(userId: number, opts?: ListSessionsOpts): Promise<ChatSession[]>;\n  /** No-op when session doesn't exist or doesn't belong to user — caller asserted authorisation. */\n  updateSession(id: number, userId: number, patch: { title?: string }): Promise<void>;\n  deleteSession(id: number, userId: number): Promise<void>;\n\n  // Messages ---------------------------------------------------------------\n  appendMessage(input: AppendMessageInput): Promise<ChatMessage>;\n  listMessagesForSession(sessionId: number, userId: number): Promise<ChatMessage[]>;\n\n  // AI settings (singleton row) -------------------------------------------\n  /** Returns the singleton row, applying defaults if it's never been written. */\n  getAiSettings(): Promise<AiSettings>;\n  /**\n   * Upsert. Validates `toolProvider` and `chatInterface` against the runtime\n   * registries before writing — invalid values throw before SQL is issued.\n   */\n  updateAiSettings(patch: AiSettingsPatch, byUserId: number): Promise<AiSettings>;\n};\n","/**\n * Prisma `PersistencePort` adapter.\n *\n * Hosts call `createPrismaPersistence(prisma)` with their own configured\n * `PrismaClient` and pass the result to `configureAiChat({ persistence, ... })`.\n *\n * The concrete `PrismaClient` is an OPTIONAL peer dep, so this module never\n * imports a runtime value from `@prisma/client`. Instead it accepts a\n * structural duck-typed shape covering only the delegate methods the port\n * uses. Any object that satisfies `PrismaLike` works — including a real\n * `PrismaClient`, a Prisma extension proxy, or a hand-rolled fake in tests.\n *\n * BigInt note: Prisma returns row IDs as JavaScript `BigInt`. Domain types\n * use plain `number` (sessions/messages are nowhere near 2^53). The adapter\n * widens via `Number(row.id)` on every read; writes accept `number` and\n * Prisma narrows internally.\n */\nimport {\n  DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  type AiSettings,\n  type AiSettingsPatch,\n  type AppendMessageInput,\n  type ChatMessage,\n  type ChatMessageRole,\n  type ChatSession,\n  type CreateSessionInput,\n  type ListSessionsOpts,\n  type PersistencePort\n} from '../../server/ports/types';\n\n// ---------------------------------------------------------------------------\n// Structural Prisma shape — covers exactly what this adapter touches.\n// Avoids a value-level dependency on `@prisma/client` (optional peer dep).\n// ---------------------------------------------------------------------------\n\ntype ChatSessionRow = {\n  id: bigint | number;\n  userId: bigint | number;\n  title: string;\n  createdAt: Date;\n  updatedAt: Date;\n};\n\ntype ChatMessageRow = {\n  id: bigint | number;\n  sessionId: bigint | number;\n  role: string;\n  question: string | null;\n  blocks: unknown | null;\n  prose: unknown | null;\n  errorJson: unknown | null;\n  createdAt: Date;\n};\n\ntype AiSettingsRow = {\n  id: number;\n  toolProvider: string;\n  gcpLocation: string;\n  chatInterface: string;\n  maxOutputTokens: number;\n  rolePrompt: string | null;\n  gcpProjectId: string | null;\n  updatedAt: Date | null;\n  updatedByUserId: bigint | number | null;\n};\n\ntype ChatSessionDelegate = {\n  create(args: {\n    data: { userId: number; title: string };\n  }): Promise<ChatSessionRow>;\n  findFirst(args: {\n    where: { id: number; userId: number };\n  }): Promise<ChatSessionRow | null>;\n  findMany(args: {\n    where: { userId: number };\n    orderBy: { updatedAt: 'desc' };\n    take?: number;\n  }): Promise<ChatSessionRow[]>;\n  update(args: {\n    where: { id: number };\n    data: { title?: string; updatedAt?: Date };\n  }): Promise<ChatSessionRow>;\n  updateMany(args: {\n    where: { id: number; userId: number };\n    data: { title?: string; updatedAt?: Date };\n  }): Promise<{ count: number }>;\n  deleteMany(args: {\n    where: { id: number; userId: number };\n  }): Promise<{ count: number }>;\n};\n\ntype ChatMessageDelegate = {\n  create(args: {\n    data: {\n      sessionId: number;\n      role: ChatMessageRole;\n      question: string | null;\n      blocks: unknown | null;\n      prose: unknown | null;\n      errorJson: unknown | null;\n    };\n  }): Promise<ChatMessageRow>;\n  findMany(args: {\n    where: { sessionId: number };\n    orderBy: { createdAt: 'asc' };\n  }): Promise<ChatMessageRow[]>;\n};\n\ntype AiSettingsDelegate = {\n  findUnique(args: { where: { id: number } }): Promise<AiSettingsRow | null>;\n  upsert(args: {\n    where: { id: number };\n    create: {\n      id: number;\n      toolProvider?: string;\n      gcpLocation?: string;\n      chatInterface?: string;\n      maxOutputTokens?: number;\n      rolePrompt?: string | null;\n      gcpProjectId?: string | null;\n      updatedByUserId: number;\n    };\n    update: {\n      toolProvider?: string;\n      gcpLocation?: string;\n      chatInterface?: string;\n      maxOutputTokens?: number;\n      rolePrompt?: string | null;\n      gcpProjectId?: string | null;\n      updatedByUserId: number;\n    };\n  }): Promise<AiSettingsRow>;\n};\n\nexport type PrismaLike = {\n  chatSession: ChatSessionDelegate;\n  chatMessage: ChatMessageDelegate;\n  aiSettings: AiSettingsDelegate;\n};\n\n// ---------------------------------------------------------------------------\n// Row -> domain mappers\n// ---------------------------------------------------------------------------\n\nconst toSession = (row: ChatSessionRow): ChatSession => ({\n  id: Number(row.id),\n  userId: Number(row.userId),\n  title: row.title,\n  createdAt: row.createdAt,\n  updatedAt: row.updatedAt\n});\n\nconst toMessage = (row: ChatMessageRow): ChatMessage => ({\n  id: Number(row.id),\n  sessionId: Number(row.sessionId),\n  // Stored as VARCHAR(16) but constrained to ChatMessageRole at write time.\n  role: row.role as ChatMessageRole,\n  question: row.question,\n  blocks: row.blocks,\n  prose: row.prose,\n  errorJson: row.errorJson,\n  createdAt: row.createdAt\n});\n\nconst toAiSettings = (row: AiSettingsRow): AiSettings => ({\n  toolProvider: row.toolProvider,\n  gcpLocation: row.gcpLocation,\n  chatInterface: row.chatInterface,\n  maxOutputTokens: row.maxOutputTokens,\n  rolePrompt: row.rolePrompt,\n  gcpProjectId: row.gcpProjectId,\n  updatedAt: row.updatedAt,\n  updatedByUserId: row.updatedByUserId === null ? null : Number(row.updatedByUserId)\n});\n\nconst DEFAULT_AI_SETTINGS: AiSettings = {\n  toolProvider: 'claude',\n  gcpLocation: 'us-east5',\n  chatInterface: 'custom',\n  maxOutputTokens: DEFAULT_AI_MAX_OUTPUT_TOKENS,\n  rolePrompt: null,\n  gcpProjectId: null,\n  updatedAt: null,\n  updatedByUserId: null\n};\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\nexport function createPrismaPersistence(prisma: PrismaLike): PersistencePort {\n  return {\n    // Sessions ---------------------------------------------------------------\n\n    async createSession(input: CreateSessionInput): Promise<ChatSession> {\n      const row = await prisma.chatSession.create({\n        data: { userId: input.userId, title: input.title }\n      });\n      return toSession(row);\n    },\n\n    async getSession(id: number, userId: number): Promise<ChatSession | null> {\n      const row = await prisma.chatSession.findFirst({ where: { id, userId } });\n      return row ? toSession(row) : null;\n    },\n\n    async listSessionsForUser(\n      userId: number,\n      opts?: ListSessionsOpts\n    ): Promise<ChatSession[]> {\n      const rows = await prisma.chatSession.findMany({\n        where: { userId },\n        orderBy: { updatedAt: 'desc' },\n        take: opts?.limit\n      });\n      return rows.map(toSession);\n    },\n\n    async updateSession(\n      id: number,\n      userId: number,\n      patch: { title?: string }\n    ): Promise<void> {\n      // updateMany so the userId scope filters; no-ops cleanly when the\n      // session doesn't exist or belongs to another user.\n      await prisma.chatSession.updateMany({\n        where: { id, userId },\n        data: { ...patch, updatedAt: new Date() }\n      });\n    },\n\n    async deleteSession(id: number, userId: number): Promise<void> {\n      await prisma.chatSession.deleteMany({ where: { id, userId } });\n    },\n\n    // Messages ---------------------------------------------------------------\n\n    async appendMessage(input: AppendMessageInput): Promise<ChatMessage> {\n      const row = await prisma.chatMessage.create({\n        data: {\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      });\n      // Bump the parent session's `updatedAt` so `listSessionsForUser`\n      // reflects \"most recent activity\" rather than creation time. Done\n      // as a separate update so the message insert remains the source of\n      // truth for ordering across replicas.\n      await prisma.chatSession.update({\n        where: { id: input.sessionId },\n        data: { updatedAt: new Date() }\n      });\n      return toMessage(row);\n    },\n\n    async listMessagesForSession(\n      sessionId: number,\n      userId: number\n    ): Promise<ChatMessage[]> {\n      // Re-assert ownership before returning rows. A caller passing a\n      // sessionId they don't own should get an empty list, not someone\n      // else's transcript.\n      const session = await prisma.chatSession.findFirst({\n        where: { id: sessionId, userId }\n      });\n      if (!session) return [];\n      const rows = await prisma.chatMessage.findMany({\n        where: { sessionId },\n        orderBy: { createdAt: 'asc' }\n      });\n      return rows.map(toMessage);\n    },\n\n    // AI settings (singleton row at id=1) -----------------------------------\n\n    async getAiSettings(): Promise<AiSettings> {\n      const row = await prisma.aiSettings.findUnique({ where: { id: 1 } });\n      return row ? toAiSettings(row) : { ...DEFAULT_AI_SETTINGS };\n    },\n\n    async updateAiSettings(\n      patch: AiSettingsPatch,\n      byUserId: number\n    ): Promise<AiSettings> {\n      const row = await prisma.aiSettings.upsert({\n        where: { id: 1 },\n        create: { id: 1, ...patch, updatedByUserId: byUserId },\n        update: { ...patch, updatedByUserId: byUserId }\n      });\n      return toAiSettings(row);\n    }\n  };\n}\n","/**\n * The Prisma schema fragment hosts paste into their own `schema.prisma`.\n *\n * Kept in lock-step with `prisma/chat-models.prisma` at the package root.\n * The fragment is inlined here (not read from disk) so consumer bundlers\n * never need to resolve a runtime fs path.\n *\n * Codegen tooling can import this constant and write it out, splice it into\n * a host's `schema.prisma`, etc.\n */\nexport const prismaSchemaFragment: string = `// =============================================================================\n// @firstlovecenter/ai-chat — Prisma schema fragment\n// =============================================================================\n//\n// HOSTS: copy the three models below into your own \\`schema.prisma\\`, then run\n//\n//     pnpm prisma generate\n//     pnpm prisma migrate dev --name flc_ai_chat\n//\n// Column names, SQL types, and indexes match the Drizzle adapter shipped at\n// \\`@firstlovecenter/ai-chat/server/drizzle\\` byte-for-byte, so the underlying MySQL schema\n// is identical regardless of which ORM your host picks. A host could swap\n// from one adapter to the other without touching data.\n// =============================================================================\n\nmodel ChatSession {\n  id        BigInt   @id @default(autoincrement()) @db.UnsignedBigInt\n  userId    BigInt   @map(\"user_id\") @db.UnsignedBigInt\n  title     String   @db.VarChar(200)\n  createdAt DateTime @default(now()) @map(\"created_at\") @db.DateTime(0)\n  updatedAt DateTime @default(now()) @map(\"updated_at\") @db.DateTime(0)\n\n  @@index([userId, updatedAt], map: \"idx_chat_session_user_updated\")\n  @@map(\"chat_sessions\")\n}\n\nmodel ChatMessage {\n  id        BigInt   @id @default(autoincrement()) @db.UnsignedBigInt\n  sessionId BigInt   @map(\"session_id\") @db.UnsignedBigInt\n  role      String   @db.VarChar(16)\n  question  String?  @db.Text\n  blocks    Json?\n  prose     Json?\n  errorJson Json?    @map(\"error_json\")\n  createdAt DateTime @default(now()) @map(\"created_at\") @db.DateTime(0)\n\n  @@index([sessionId, createdAt], map: \"idx_chat_msg_session_created\")\n  @@map(\"chat_messages\")\n}\n\nmodel AiSettings {\n  id              Int       @id @default(1) @db.UnsignedTinyInt\n  toolProvider    String    @default(\"claude\") @map(\"tool_provider\") @db.VarChar(32)\n  gcpLocation     String    @default(\"us-east5\") @map(\"gcp_location\") @db.VarChar(32)\n  chatInterface   String    @default(\"custom\") @map(\"chat_interface\") @db.VarChar(32)\n  updatedAt       DateTime  @default(now()) @map(\"updated_at\") @db.DateTime(0)\n  updatedByUserId BigInt?   @map(\"updated_by_user_id\") @db.UnsignedBigInt\n\n  @@map(\"ai_settings\")\n}\n`;\n"]}

package/dist/prisma/index.js

@@ -82,6 +82,10 @@ function createPrismaPersistence(prisma) {
           errorJson: input.errorJson ?? null
         }
       });
+      await prisma.chatSession.update({
+        where: { id: input.sessionId },
+        data: { updatedAt: /* @__PURE__ */ new Date() }
+      });
       return toMessage(row);
     },
     async listMessagesForSession(sessionId, userId) {