@firstlovecenter/ai-chat 0.2.3 → 0.5.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.5.0] — 2026-05-08
+
+Phase 2 of the package: a second chat interface that streams via the **Vercel AI SDK** alongside the existing custom SSE chat, with full structured-tool parity (charts, tables, callouts) and shared persistence so a session opened under one UI is identical under the other.
+
+The version jump (0.2.3 → 0.5.0) reflects the size of the surface change: a new route factory, a new top-level UI component, a registry of chat interfaces with `Component` references, and a new optional field on every `ToolDefinition`. No breaking changes — existing custom-chat hosts keep working unchanged.
+
+### Added
+
+- **`routes.agentVercel`** — new route factory exposed from `configureAiChat({...}).routes.agentVercel`. POST handler that runs the host's tool catalogue through Vercel AI SDK 4's `streamText({tools, ...}).toDataStreamResponse({data})` instead of the bespoke SSE protocol. Same auth / scope / persistence / lifecycle-hook contract as `agentCustom`. Persists the assistant turn in `onFinish` with the **same `blocks` + `prose` shape** the custom adapter writes, so cross-UI session hydration is lossless.
+- **`VercelChat`** — new top-level component exported from `@firstlovecenter/ai-chat/ui` with the same `AiChatProps` interface as `AiChat`. Layout copied from `AiChat`; the input pill markup is byte-for-byte identical (only state-binding callsites differ). State is driven by `useChat({ api: '/api/agent/vercel', ... })` from `@ai-sdk/react`. Renders streamed `present` blocks via the same `AnswerBlocks` primitive the custom UI uses. Stored sessions previously written by the custom chat are hydrated into `useChat` messages via reconstructed block + prose state, so toggling between Custom and Vercel mid-session preserves messages.
+- **`chatInterfaces` registry + `getChatInterface(id)`** — typed list of `{ id, label, description, Component }` exported from `@firstlovecenter/ai-chat/ui`. Hosts map over this in their settings form to render the chat-interface picker dynamically; calling `getChatInterface(id).Component` from a server page lets the host branch between `<AiChat />` and `<VercelChat />` based on the persisted `aiSettings.chatInterface` value. Adding a new interface in the package surfaces in the host UI automatically.
+- **`ChatInterfaceDef` type** — exported alongside the registry for hosts that want a strongly-typed picker.
+- **`ToolDefinition.zodSchema`** — new optional field on every tool. Required by the Vercel route (which feeds the schema into `tool({ parameters })` in Vercel AI SDK); ignored by the custom route. Throws a clear config-time error if a tool registered for the Vercel chat is missing it. Adding it is purely additive — existing custom-chat-only tools and consumers compile unchanged.
+- **`SELF_VERIFY_REQUIRED` gate reproduced on the Vercel path** — the vercel-adapter tracks `toolCallCount` in closure and rejects `present` calls with fewer than two prior tool calls, matching the custom agent loop's behaviour.
+- **`AGENT_NO_PRESENT` fallback on the Vercel path** — if `streamText` finishes with text but no `present()` call, the route synthesises a single `paragraph_brief` block from the model's text and persists it in the same shape as the custom adapter. Mirrors the existing fallback in `runAgent`.
+
+### Changed
+
+- **Title editor components moved to `_shared/`** — `SidebarTitleEditor` and `EditableTitle` were lifted from inline definitions in `ai-chat.tsx` into `src/ui/_shared/title-editors.tsx` so both UIs reuse the same source. `<AiChat />` rendered markup is unchanged; the only diff is the import path.
+
+### Build
+
+- **`zod` is now a runtime dependency** (was already a `devDependency`). The vercel-adapter imports `ZodType` for the `tool({ parameters })` boundary; tests and types import `z` directly.
+
 ## [0.2.3] — 2026-05-08
 
 ### Fixed
@@ -91,6 +115,7 @@ Initial public release on npm under `@firstlovecenter/ai-chat`.
 - Dual ESM + CJS output via `tsup` with full `.d.ts` (and `.d.cts`) generation.
 - UI bundle gets a post-build `'use client';` directive injection (tsup otherwise strips module-level directives during bundling, breaking RSC consumers that import the UI from a server file).
 
+[0.5.0]: https://github.com/firstlovecenter/flc-ai-chat/compare/v0.2.3...v0.5.0
 [0.2.3]: https://github.com/firstlovecenter/flc-ai-chat/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/firstlovecenter/flc-ai-chat/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/firstlovecenter/flc-ai-chat/compare/v0.2.0...v0.2.1

package/dist/drizzle/index.d.cts

@@ -1,7 +1,8 @@
 import * as drizzle_orm_mysql_core from 'drizzle-orm/mysql-core';
 import { MySql2Database } from 'drizzle-orm/mysql2';
-import { c as PersistencePort } from '../types-DNwFvL-C.cjs';
+import { c as PersistencePort } from '../types-CDKxdzQc.cjs';
 import 'google-auth-library';
+import 'zod';
 
 /**
  * Global AI configuration. Singleton row enforced by `id=1` default + PK.

package/dist/drizzle/index.d.ts

@@ -1,7 +1,8 @@
 import * as drizzle_orm_mysql_core from 'drizzle-orm/mysql-core';
 import { MySql2Database } from 'drizzle-orm/mysql2';
-import { c as PersistencePort } from '../types-DNwFvL-C.js';
+import { c as PersistencePort } from '../types-CDKxdzQc.js';
 import 'google-auth-library';
+import 'zod';
 
 /**
  * Global AI configuration. Singleton row enforced by `id=1` default + PK.

package/dist/prisma/index.d.cts

@@ -1,5 +1,6 @@
-import { m as ChatMessageRole, c as PersistencePort } from '../types-DNwFvL-C.cjs';
+import { m as ChatMessageRole, c as PersistencePort } from '../types-CDKxdzQc.cjs';
 import 'google-auth-library';
+import 'zod';
 
 /**
  * Prisma `PersistencePort` adapter.

package/dist/prisma/index.d.ts

@@ -1,5 +1,6 @@
-import { m as ChatMessageRole, c as PersistencePort } from '../types-DNwFvL-C.js';
+import { m as ChatMessageRole, c as PersistencePort } from '../types-CDKxdzQc.js';
 import 'google-auth-library';
+import 'zod';
 
 /**
  * Prisma `PersistencePort` adapter.

package/dist/server/index.cjs

@@ -2,6 +2,9 @@
 
 var vertexSdk = require('@anthropic-ai/vertex-sdk');
 var crypto = require('crypto');
+var ai = require('ai');
+var googleVertex = require('@ai-sdk/google-vertex');
+var anthropic = require('@ai-sdk/google-vertex/anthropic');
 var googleAuthLibrary = require('google-auth-library');
 
 // src/server/tools/types.ts
@@ -72,8 +75,8 @@ async function runAgent(input) {
     const toolResults = [];
     for (const tc of response.toolCalls) {
       transcript.push({ kind: "tool_use", name: tc.name, input: tc.input });
-      const tool = input.tools[tc.name];
-      if (!tool) {
+      const tool2 = input.tools[tc.name];
+      if (!tool2) {
         const errResult = {
           ok: false,
           error: { code: "UNKNOWN_TOOL", message: `Unknown tool: ${tc.name}` }
@@ -87,7 +90,7 @@ async function runAgent(input) {
         });
         continue;
       }
-      const result = await tool.execute(tc.input, {
+      const result = await tool2.execute(tc.input, {
         ...input.ctx,
         toolCallCount
       });
@@ -1137,6 +1140,297 @@ data: {}
     }
   };
 }
+function buildVercelTools(tools, ctx, data, onPresent) {
+  const result = {};
+  let toolCallCount = 0;
+  for (const [name, def] of Object.entries(tools)) {
+    if (!def.zodSchema) {
+      throw new Error(
+        `Tool '${name}' has no zodSchema; required for the Vercel AI SDK chat. Add a Zod schema to the tool definition (or remove it from the registry if the host only uses the custom SSE chat).`
+      );
+    }
+    if (name === TERMINAL_TOOL_NAME) {
+      result[name] = ai.tool({
+        description: def.schema.description,
+        // The Zod schema doubles as the runtime parameter validator the SDK
+        // hands the model. We accept whatever Zod shape the host registered;
+        // the SDK uses it to validate the tool-call arguments before dispatch.
+        parameters: def.zodSchema,
+        execute: async (input) => {
+          if (toolCallCount < 2) {
+            return {
+              error: {
+                code: "SELF_VERIFY_REQUIRED",
+                message: "Per FR-8.3 you must run at least one CROSS-CHECK tool call (a different metric, a different period, or a run_sql sanity-check) before present. Make that extra call now, then call present again."
+              }
+            };
+          }
+          const payload = input;
+          for (let i = 0; i < payload.blocks.length; i++) {
+            data.append({
+              type: "block",
+              value: { index: i, ...payload.blocks[i] }
+            });
+          }
+          onPresent(payload);
+          return { ok: true };
+        }
+      });
+      continue;
+    }
+    result[name] = ai.tool({
+      description: def.schema.description,
+      parameters: def.zodSchema,
+      execute: async (input) => {
+        const res = await def.execute(input, { ...ctx, toolCallCount });
+        toolCallCount += 1;
+        if (res.ok) return res.data;
+        return { error: res.error };
+      }
+    });
+  }
+  return result;
+}
+
+// src/server/routes/agent-vercel.ts
+var VALID_MODELS = /* @__PURE__ */ new Set(["claude", "gemini"]);
+function jsonError2(status, code, message) {
+  return new Response(JSON.stringify({ error: { code, message } }), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function defaultGenerateSessionId2() {
+  return crypto.randomUUID().replace(/-/g, "").slice(0, 16);
+}
+function createAgentVercelRoutes(ctx) {
+  const { persistence, auth, scope, tools, vertex, logger, hooks } = ctx;
+  return {
+    /** Next.js-compatible POST handler. */
+    POST: async (req) => {
+      if (hooks?.onRequest) {
+        const short = await hooks.onRequest(req);
+        if (short) return short;
+      }
+      const authResult = await auth.requireAuth(req);
+      if (!authResult.ok) return authResult.response;
+      const { scope: callerScope, userId } = authResult;
+      if (hooks?.onAuthenticated) {
+        const short = await hooks.onAuthenticated({
+          req,
+          scope: callerScope,
+          userId
+        });
+        if (short) return short;
+      }
+      const body = await req.json().catch(() => null);
+      const question = typeof body?.question === "string" ? body.question.trim() : "";
+      if (!question) {
+        return jsonError2(
+          400,
+          "VALIDATION_FAILED",
+          "question must be a non-empty string."
+        );
+      }
+      const rawChatSessionId = body?.chatSessionId;
+      const incomingChatSessionId = typeof rawChatSessionId === "number" && Number.isInteger(rawChatSessionId) ? rawChatSessionId : null;
+      const rawModel = body?.model;
+      const requestedModel = typeof rawModel === "string" && VALID_MODELS.has(rawModel) ? rawModel : null;
+      const aiSettings = await persistence.getAiSettings();
+      let chatSessionId;
+      if (incomingChatSessionId !== null) {
+        const owned = await persistence.getSession(
+          incomingChatSessionId,
+          userId
+        );
+        if (!owned) {
+          return jsonError2(404, "NOT_FOUND", "Chat session not found.");
+        }
+        chatSessionId = owned.id;
+      } else {
+        const created = await persistence.createSession({
+          userId,
+          title: question.slice(0, 200)
+        });
+        chatSessionId = created.id;
+      }
+      await persistence.appendMessage({
+        sessionId: chatSessionId,
+        role: "user",
+        question
+      });
+      const sessionId = hooks?.generateSessionId ? await hooks.generateSessionId({
+        scope: callerScope,
+        userId,
+        chatSessionId: incomingChatSessionId
+      }) : defaultGenerateSessionId2();
+      const scopeSummary = await scope.buildScopeSummary(callerScope);
+      const scopeLabel = await scope.resolveScopeLabel(callerScope);
+      const toolContext = {
+        scope: callerScope,
+        sessionId,
+        scopeSummary,
+        toolCallCount: 0
+      };
+      const systemBlocks = await tools.buildSystemBlocks(toolContext);
+      const provider = requestedModel ?? aiSettings.toolProvider;
+      if (!VALID_MODELS.has(provider)) {
+        return jsonError2(
+          400,
+          "INVALID_PROVIDER",
+          `Vercel chat only supports 'claude' or 'gemini'; got '${provider}'.`
+        );
+      }
+      const data = new ai.StreamData();
+      let presentPayload = null;
+      let persistedError = null;
+      let sessionStarted = false;
+      try {
+        if (hooks?.onSessionStart) {
+          await hooks.onSessionStart({
+            scope: callerScope,
+            sessionId,
+            userId
+          });
+        }
+        sessionStarted = true;
+        const vercelTools = buildVercelTools(
+          tools.tools,
+          toolContext,
+          data,
+          (p) => {
+            presentPayload = p;
+          }
+        );
+        data.append({
+          type: "meta",
+          value: { chatSessionId, scopeLabel }
+        });
+        const system = systemBlocks.map((b) => b.text).join("\n\n");
+        const model = provider === "claude" ? anthropic.createVertexAnthropic({
+          project: vertex.projectId,
+          location: vertex.defaultLocation,
+          googleAuthOptions: {}
+        })(vertex.modelIds.claude) : googleVertex.createVertex({
+          project: vertex.projectId,
+          location: aiSettings.gcpLocation,
+          googleAuthOptions: {}
+        })(vertex.modelIds.gemini);
+        const result = ai.streamText({
+          model,
+          system,
+          messages: [{ role: "user", content: question }],
+          tools: vercelTools,
+          maxSteps: 12,
+          maxTokens: 4096,
+          onFinish: async ({ text }) => {
+            try {
+              let blocks = presentPayload?.blocks ?? [];
+              const prose = {};
+              const trimmed = (text ?? "").trim();
+              if (presentPayload === null && trimmed) {
+                const topic = question.length > 80 ? question.slice(0, 77) + "..." : question;
+                const synthetic = {
+                  kind: "paragraph_brief",
+                  topic,
+                  key_facts: [trimmed]
+                };
+                blocks = [synthetic];
+                prose[0] = trimmed;
+                data.append({
+                  type: "block",
+                  value: { index: 0, ...synthetic }
+                });
+              } else if (text) {
+                const firstPbIdx = blocks.findIndex(
+                  (b) => b.kind === "paragraph_brief"
+                );
+                if (firstPbIdx >= 0) prose[firstPbIdx] = text;
+              }
+              await persistence.appendMessage({
+                sessionId: chatSessionId,
+                role: "assistant",
+                blocks: blocks.length ? blocks : null,
+                prose: Object.keys(prose).length ? prose : null,
+                errorJson: persistedError
+              });
+            } catch (err2) {
+              logger?.warn?.(
+                {
+                  chatSessionId,
+                  sessionId,
+                  err: err2.message
+                },
+                "[agent-vercel] failed to persist assistant turn"
+              );
+            } finally {
+              try {
+                await data.close();
+              } catch {
+              }
+            }
+          }
+        });
+        return result.toDataStreamResponse({ data });
+      } catch (e) {
+        const message = e.message ?? "Internal error";
+        persistedError = { code: "INTERNAL", message };
+        logger?.error?.(
+          { chatSessionId, sessionId, err: message },
+          "[agent-vercel] route errored"
+        );
+        try {
+          data.append({
+            type: "error",
+            value: { code: "INTERNAL", message }
+          });
+        } catch {
+        }
+        try {
+          await data.close();
+        } catch {
+        }
+        try {
+          await persistence.appendMessage({
+            sessionId: chatSessionId,
+            role: "assistant",
+            blocks: null,
+            prose: null,
+            errorJson: persistedError
+          });
+        } catch (err2) {
+          logger?.warn?.(
+            { chatSessionId, sessionId, err: err2.message },
+            "[agent-vercel] failed to persist error turn"
+          );
+        }
+        return jsonError2(500, "INTERNAL", message);
+      } finally {
+        if (hooks?.onSessionEnd) {
+          const cause = req.signal.aborted ? "abort" : persistedError ? "error" : "complete";
+          try {
+            await hooks.onSessionEnd({
+              scope: callerScope,
+              sessionId,
+              userId,
+              cause
+            });
+          } catch (err2) {
+            logger?.warn?.(
+              {
+                chatSessionId,
+                sessionId,
+                sessionStarted,
+                err: err2.message
+              },
+              "[agent-vercel] onSessionEnd hook failed"
+            );
+          }
+        }
+      }
+    }
+  };
+}
 
 // src/server/routes/chat-sessions.ts
 var DEFAULT_TITLE = "New chat";
@@ -1497,6 +1791,15 @@ function configureAiChat(opts) {
     resolveNarratorId: opts.resolveNarratorId,
     hooks: opts.hooks
   });
+  const agentVercel = createAgentVercelRoutes({
+    persistence: opts.persistence,
+    auth: opts.auth,
+    scope: opts.scope,
+    tools,
+    vertex: opts.vertex,
+    logger: opts.logger,
+    hooks: opts.hooks
+  });
   const chatSessions = createChatSessionsRoutes({
     persistence: opts.persistence,
     auth: opts.auth,
@@ -1513,7 +1816,7 @@ function configureAiChat(opts) {
   });
   return {
     runAgent: runAgentBound,
-    routes: { agentCustom, chatSessions, adminSettings },
+    routes: { agentCustom, agentVercel, chatSessions, adminSettings },
     registries: { toolProviders: toolProviders2, chatInterfaces }
   };
 }