@firstlovecenter/ai-chat 0.7.0 → 0.8.0

package/dist/prisma/index.js.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.js","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":"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","file":"index.js","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/server/index.cjs

@@ -25,7 +25,10 @@ async function runAgent(input) {
   const maxOutputTokens = input.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
   const transcript = [];
   transcript.push({ kind: "user", text: input.question });
-  const messages = [{ role: "user", text: input.question }];
+  const messages = [
+    ...input.priorMessages ?? [],
+    { role: "user", text: input.question }
+  ];
   const system = input.systemBlocks;
   const toolSchemas = Object.values(input.tools).map((t) => t.schema);
   let toolCallCount = 0;
@@ -218,11 +221,28 @@ function toAnthropicMessages(messages) {
   const out = [];
   for (const msg of messages) {
     if (msg.role === "user") {
-      out.push({ role: "user", content: msg.text });
+      if (msg.cached) {
+        out.push({
+          role: "user",
+          content: [
+            {
+              type: "text",
+              text: msg.text,
+              cache_control: { type: "ephemeral" }
+            }
+          ]
+        });
+      } else {
+        out.push({ role: "user", content: msg.text });
+      }
     } else if (msg.role === "assistant") {
       const blocks = [];
       if (msg.text) {
-        blocks.push({ type: "text", text: msg.text });
+        const textBlock = { type: "text", text: msg.text };
+        if (msg.cached && msg.toolCalls.length === 0) {
+          textBlock.cache_control = { type: "ephemeral" };
+        }
+        blocks.push(textBlock);
       }
       for (const tc of msg.toolCalls) {
         blocks.push({
@@ -574,6 +594,87 @@ var toolProviders = [
 function getToolProvider(id) {
   return toolProviders.find((p) => p.id === id);
 }
+
+// src/server/history.ts
+var DEFAULT_MAX_HISTORY_PAIRS = 20;
+var DEFAULT_MAX_TEXT_CHARS = 4e3;
+function historyToNormalizedMessages(rows, opts = {}) {
+  const maxPairs = opts.maxPairs ?? DEFAULT_MAX_HISTORY_PAIRS;
+  const maxTextChars = opts.maxTextChars ?? DEFAULT_MAX_TEXT_CHARS;
+  const pairs = [];
+  let i = 0;
+  while (i < rows.length) {
+    const row = rows[i];
+    if (row.role !== "user" || !row.question) {
+      i += 1;
+      continue;
+    }
+    const next = rows[i + 1];
+    if (next?.role !== "assistant") {
+      i += 1;
+      continue;
+    }
+    const assistantText = truncate(
+      assistantMessageToText(next),
+      maxTextChars
+    );
+    if (assistantText) {
+      pairs.push([
+        { role: "user", text: truncate(row.question, maxTextChars) },
+        { role: "assistant", text: assistantText, toolCalls: [] }
+      ]);
+    }
+    i += 2;
+  }
+  const kept = maxPairs > 0 ? pairs.slice(-maxPairs) : pairs;
+  return kept.flat();
+}
+function truncate(text, max) {
+  if (max <= 0 || text.length <= max) return text;
+  return text.slice(0, max);
+}
+function assistantMessageToText(row) {
+  if (row.errorJson) return "";
+  const proseText = proseToText(row.prose);
+  if (proseText) return proseText;
+  const blockText = blocksToText(row.blocks);
+  return blockText;
+}
+function proseToText(prose) {
+  if (!prose || typeof prose !== "object") return "";
+  const entries = Object.entries(prose).map(([k, v]) => [Number(k), typeof v === "string" ? v : ""]).filter(([k, v]) => Number.isFinite(k) && v.length > 0).sort(([a], [b]) => a - b);
+  return entries.map(([, v]) => v).join("\n\n").trim();
+}
+function blocksToText(blocks) {
+  if (!Array.isArray(blocks)) return "";
+  const parts = [];
+  for (const raw of blocks) {
+    if (!raw || typeof raw !== "object") continue;
+    const b = raw;
+    switch (b.kind) {
+      case "paragraph_brief": {
+        const facts = (b.key_facts ?? []).filter((f) => f && f.trim());
+        if (b.topic) parts.push(b.topic);
+        if (facts.length) parts.push(facts.join("\n"));
+        break;
+      }
+      case "list": {
+        const items = (b.items ?? []).filter((s) => s && s.trim());
+        if (b.title) parts.push(b.title);
+        if (items.length) parts.push(items.map((s) => `- ${s}`).join("\n"));
+        break;
+      }
+      case "chart":
+      case "table":
+        if (b.title) parts.push(`[${b.title}]`);
+        break;
+      case "callout":
+        if (b.text) parts.push(b.text);
+        break;
+    }
+  }
+  return parts.join("\n\n").trim();
+}
 function vertexHost2(location) {
   return location === "global" ? "aiplatform.googleapis.com" : `${location}-aiplatform.googleapis.com`;
 }
@@ -916,12 +1017,23 @@ function createAgentCustomRoutes(ctx) {
       const aiSettings = await persistence.getAiSettings();
       const effectiveProjectId = aiSettings.gcpProjectId ?? vertex.projectId;
       let chatSessionId;
+      let priorMessages = [];
       if (incomingChatSessionId !== null) {
         const owned = await persistence.getSession(incomingChatSessionId, userId);
         if (!owned) {
           return jsonError(404, "NOT_FOUND", "Chat session not found.");
         }
         chatSessionId = owned.id;
+        const stored = await persistence.listMessagesForSession(chatSessionId, userId);
+        priorMessages = historyToNormalizedMessages(stored);
+        if (priorMessages.length > 0) {
+          const last = priorMessages[priorMessages.length - 1];
+          if (last.role === "assistant" && last.toolCalls.length === 0) {
+            priorMessages[priorMessages.length - 1] = { ...last, cached: true };
+          } else if (last.role === "user") {
+            priorMessages[priorMessages.length - 1] = { ...last, cached: true };
+          }
+        }
       } else {
         const created = await persistence.createSession({
           userId,
@@ -1009,6 +1121,7 @@ data: ${JSON.stringify(data)}
             send("meta", { chatSessionId, scopeLabel });
             const agentResult = await runAgent({
               question,
+              priorMessages,
               ctx: toolContext,
               tools: tools.tools,
               systemBlocks,
@@ -1227,7 +1340,17 @@ function createAgentVercelRoutes(ctx) {
         if (short) return short;
       }
       const body = await req.json().catch(() => null);
-      const question = typeof body?.question === "string" ? body.question.trim() : "";
+      let question = typeof body?.question === "string" ? body.question.trim() : "";
+      if (!question && Array.isArray(body?.messages)) {
+        const msgs = body.messages;
+        for (let i = msgs.length - 1; i >= 0; i -= 1) {
+          const m = msgs[i];
+          if (m && m.role === "user" && typeof m.content === "string") {
+            question = m.content.trim();
+            break;
+          }
+        }
+      }
       if (!question) {
         return jsonError2(
           400,
@@ -1242,6 +1365,7 @@ function createAgentVercelRoutes(ctx) {
       const aiSettings = await persistence.getAiSettings();
       const effectiveProjectId = aiSettings.gcpProjectId ?? vertex.projectId;
       let chatSessionId;
+      let priorMessages = [];
       if (incomingChatSessionId !== null) {
         const owned = await persistence.getSession(
           incomingChatSessionId,
@@ -1251,6 +1375,11 @@ function createAgentVercelRoutes(ctx) {
           return jsonError2(404, "NOT_FOUND", "Chat session not found.");
         }
         chatSessionId = owned.id;
+        const stored = await persistence.listMessagesForSession(
+          chatSessionId,
+          userId
+        );
+        priorMessages = historyToNormalizedMessages(stored);
       } else {
         const created = await persistence.createSession({
           userId,
@@ -1320,10 +1449,16 @@ function createAgentVercelRoutes(ctx) {
           location: aiSettings.gcpLocation,
           googleAuthOptions: {}
         })(vertex.modelIds.gemini);
+        const priorCoreMessages = priorMessages.filter(
+          (m) => m.role === "user" || m.role === "assistant"
+        ).map((m) => ({ role: m.role, content: m.text }));
         const result = ai.streamText({
           model,
           system,
-          messages: [{ role: "user", content: question }],
+          messages: [
+            ...priorCoreMessages,
+            { role: "user", content: question }
+          ],
           tools: vercelTools,
           maxSteps: 12,
           maxTokens: aiSettings.maxOutputTokens,