From c49cda8cc6b2a4148049901e03b5699309d9192b Mon Sep 17 00:00:00 2001
From: Zen0space <tartnenas_kai@outlook.com>
Date: Thu, 26 Mar 2026 19:12:01 +0800
Subject: [PATCH] feat: chat workflow agent + right-side push panel + markdown
 rendering

- BAML: new agent functions (FormatFoodResponse, FormatRecipeResponse,
  FormatApiHelpResponse, StreamChat), ApiHelp intent, claude client
- Backend: SSE streaming endpoint (POST /api/chat/stream), async
  generator workflow with tRPC caller for food search, removed
  sendMessage mutation and food-search.ts
- Frontend: right-side push panel with activity bar (replaces FAB
  popup), ChatPanelContext for open/close state, responsive panel
  (400-500px desktop, fullscreen mobile)
- Markdown: react-markdown + remark-gfm for AI replies with dark
  theme styling, code blocks with copy button, tables, links
- UI: global seamless dark scrollbar, gradient green chat icon,
  hamburger menu for thread list, no focus highlight on input
- Shared: ChatSSEEvent discriminated union type, ChatToolName type
---
 .env.example                                  |   9 +-
 .../docker-compose.yml => docker-compose.yml  |  26 -
 packages/kal-backend/src/index.ts             |  17 +
 packages/kal-backend/src/lib/chat-workflow.ts | 536 +++++++++++
 packages/kal-backend/src/lib/trpc.ts          |   1 +
 .../kal-backend/src/middleware/timeout.ts     |   6 +-
 packages/kal-backend/src/routers/chat.ts      | 361 +-------
 packages/kal-backend/src/routers/halal.ts     |   8 +-
 .../kal-backend/src/routes/chat-stream.ts     | 141 +++
 .../kal-baml/baml_src/clients/claude.baml     |   9 +
 packages/kal-baml/baml_src/clients/glm.baml   |  21 -
 .../kal-baml/baml_src/functions/agent.baml    | 202 ++++
 .../kal-baml/baml_src/functions/analysis.baml |   4 +-
 .../kal-baml/baml_src/functions/chat.baml     |   6 +-
 .../kal-baml/baml_src/functions/recipe.baml   |  10 +-
 .../baml_src/functions/stream-chat.baml       |  27 +
 .../kal-baml/baml_src/functions/thinking.baml |  30 +-
 packages/kal-baml/baml_src/types/chat.baml    |   1 +
 packages/kal-baml/src/chat.ts                 | 182 +++-
 packages/kal-baml/src/index.ts                |  15 +-
 packages/kal-frontend/package.json            |   4 +-
 packages/kal-frontend/src/app/globals.css     |  85 +-
 packages/kal-frontend/src/app/layout.tsx      |  16 +-
 .../src/components/chat/ChatActivityBar.tsx   |  68 ++
 .../src/components/chat/ChatMessage.tsx       | 332 +++++++
 .../src/components/chat/ChatPanel.tsx         | 487 ++++++++++
 .../src/components/chat/ChatWidget.tsx        |  82 ++
 .../src/components/chat/ToolStepIndicator.tsx |  72 ++
 .../src/contexts/ChatPanelContext.tsx         |  40 +
 packages/kal-frontend/src/lib/chat-stream.ts  | 213 +++++
 packages/kal-frontend/tailwind.config.ts      |   5 +
 packages/kal-shared/src/types/index.ts        |  79 +-
 pnpm-lock.yaml                                | 874 ++++++++++++++++++
 33 files changed, 3484 insertions(+), 485 deletions(-)
 rename docker/docker-compose.yml => docker-compose.yml (68%)
 create mode 100644 packages/kal-backend/src/lib/chat-workflow.ts
 create mode 100644 packages/kal-backend/src/routes/chat-stream.ts
 create mode 100644 packages/kal-baml/baml_src/clients/claude.baml
 delete mode 100644 packages/kal-baml/baml_src/clients/glm.baml
 create mode 100644 packages/kal-baml/baml_src/functions/agent.baml
 create mode 100644 packages/kal-baml/baml_src/functions/stream-chat.baml
 create mode 100644 packages/kal-frontend/src/components/chat/ChatActivityBar.tsx
 create mode 100644 packages/kal-frontend/src/components/chat/ChatMessage.tsx
 create mode 100644 packages/kal-frontend/src/components/chat/ChatPanel.tsx
 create mode 100644 packages/kal-frontend/src/components/chat/ChatWidget.tsx
 create mode 100644 packages/kal-frontend/src/components/chat/ToolStepIndicator.tsx
 create mode 100644 packages/kal-frontend/src/contexts/ChatPanelContext.tsx
 create mode 100644 packages/kal-frontend/src/lib/chat-stream.ts

diff --git a/.env.example b/.env.example
index 1432634..0a336c3 100644
--- a/.env.example
+++ b/.env.example
@@ -36,11 +36,14 @@ CHAT_FRONTEND_URL=http://localhost:3003
 # Session Secret (for express-session)
 SESSION_SECRET=
 
+# Internal API Key (for backend-to-backend communication)
+INTERNAL_API_KEY=
+
 # ===================
-# GLM 4.6 (Zhipu AI) - BAML Chat API
+# Pika AI (Anthropic Proxy) - BAML Chat API
 # ===================
-GLM_API_BASE_URL=https://api.z.ai/api/paas/v4
-GLM_API_KEY=
+PIKA_BASE_URL=https://pikaai.xyz
+PIKA_API_KEY=
 
 # ============================================
 # PRODUCTION (VPS 72.62.74.47) - Copy to .env.production
diff --git a/docker/docker-compose.yml b/docker-compose.yml
similarity index 68%
rename from docker/docker-compose.yml
rename to docker-compose.yml
index b147caa..75bc352 100644
--- a/docker/docker-compose.yml
+++ b/docker-compose.yml
@@ -71,32 +71,6 @@ services:
       timeout: 3s
       retries: 5
 
-  backend:
-    # Image built in GitHub Actions and pushed to GHCR on every merge to main.
-    # To update on VPS: docker compose pull backend && docker compose up -d backend
-    image: ghcr.io/zen0space/kal-monorepo/kal-backend:latest
-    container_name: kal-backend
-    ports:
-      - "${BACKEND_PORT:-4000}:3000"
-    environment:
-      - NODE_ENV=production
-      - MONGODB_URI=mongodb://${MONGODB_USER}:${MONGODB_PASSWORD}@mongodb:27017/${MONGODB_DATABASE}?authSource=admin
-      - REDIS_URL=redis://redis:6379
-      - LOGTO_ENDPOINT=${LOGTO_ENDPOINT}
-      - LOGTO_APP_ID=${LOGTO_APP_ID}
-      - LOGTO_APP_SECRET=${LOGTO_APP_SECRET}
-      - SESSION_SECRET=${SESSION_SECRET}
-      - GLM_API_BASE_URL=${GLM_API_BASE_URL}
-      - GLM_API_KEY=${GLM_API_KEY}
-      - INTERNAL_API_KEY=${INTERNAL_API_KEY}
-      - FRONTEND_URL=${FRONTEND_URL}
-    depends_on:
-      - mongodb
-      - logto
-      - redis
-    networks:
-      - kal-network
-
 volumes:
   mongodb_data:
   postgres_data:
diff --git a/packages/kal-backend/src/index.ts b/packages/kal-backend/src/index.ts
index 0f48617..190d287 100644
--- a/packages/kal-backend/src/index.ts
+++ b/packages/kal-backend/src/index.ts
@@ -7,6 +7,7 @@ import cors from "cors";
 import express from "express";
 import session from "express-session";
 import helmet from "helmet";
+import { quickChat } from "kal-baml";
 import { API_BASE_PATH } from "kal-shared";
 import swaggerUi from "swagger-ui-express";
 
@@ -26,6 +27,7 @@ import {
   configureServerTimeouts,
 } from "./middleware/timeout.js";
 import { apiRouter } from "./routers/api.js";
+import { chatStreamRouter } from "./routes/chat-stream.js";
 import { appRouter } from "./routers/index.js";
 
 const PORT = process.env.BACKEND_PORT || 3000;
@@ -43,6 +45,17 @@ async function main() {
     console.log("⚠️  Redis not available (caching disabled)");
   }
 
+  // Verify BAML/LLM connection (Anthropic via Pika AI proxy)
+  try {
+    await quickChat("Say hi in one word.", "Respond with a single word only.");
+    console.log("✅ BAML connected (claude-haiku-4.5 via pikaai.xyz)");
+  } catch (error) {
+    console.warn(
+      "⚠️  BAML/LLM connection failed:",
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+
   const app = express();
 
   // Security headers (Helmet)
@@ -95,6 +108,7 @@ async function main() {
 
   // Apply PRIVATE CORS to everything else (tRPC, health, auth routes)
   app.use("/trpc", cors(privateCorsOptions));
+  app.use("/api/chat", cors(privateCorsOptions));
   app.use("/health", cors(privateCorsOptions));
 
   // Request timeout middleware (scalable - uses native req.setTimeout)
@@ -285,6 +299,9 @@ async function main() {
     `);
   });
 
+  // Chat SSE streaming endpoint (private — requires x-logto-id header)
+  app.use("/api/chat", chatStreamRouter);
+
   // REST API routes
   app.use(API_BASE_PATH, apiRouter);
 
diff --git a/packages/kal-backend/src/lib/chat-workflow.ts b/packages/kal-backend/src/lib/chat-workflow.ts
new file mode 100644
index 0000000..032fe4f
--- /dev/null
+++ b/packages/kal-backend/src/lib/chat-workflow.ts
@@ -0,0 +1,536 @@
+/**
+ * Chat Workflow Orchestrator
+ *
+ * Orchestrates the multi-step AI chat workflow and emits SSE events
+ * so the frontend can show each step in real-time.
+ *
+ * Workflow:
+ *   1. Save user message
+ *   2. Classify intent (tool step)
+ *   3. If food query → extract search term → search DB (tool steps)
+ *   4. Stream AI response using the appropriate BAML function
+ *   5. Save assistant message
+ */
+
+import type { ChatSSEEvent } from "kal-shared";
+import {
+  classifyIntent,
+  extractFoodSearchTerm,
+  estimateNutrition,
+  UserIntent,
+  streamFormatFoodResponse,
+  streamFormatRecipeResponse,
+  streamGeneralChat,
+  streamFormatApiHelpResponse,
+  parseRecipe,
+  type RecipeIngredient,
+} from "kal-baml";
+import { ObjectId } from "mongodb";
+import type { Db } from "mongodb";
+import type { ChatMessage, ChatThread } from "kal-shared";
+
+import { appRouter } from "../routers/index.js";
+import { createCallerFactory } from "./trpc.js";
+
+// ── tRPC server-side caller factory ──
+const createCaller = createCallerFactory(appRouter);
+
+// ── Unified result type (tagged with source) ──
+interface FoodSearchResult {
+  id: string;
+  name: string;
+  calories: number;
+  protein: number;
+  carbs: number;
+  fat: number;
+  serving: string;
+  category?: string;
+  source: "halal" | "natural" | "estimated";
+  brand?: string;
+  halalCertifier?: string;
+  halalCertYear?: number;
+}
+
+// ── Search foods via tRPC caller (hits both collections with caching) ──
+async function searchFoods(
+  db: Db,
+  query: string,
+  limit = 10
+): Promise<FoodSearchResult[]> {
+  const caller = createCaller({ db, user: null, userId: undefined });
+
+  const [halalRaw, naturalRaw] = await Promise.all([
+    caller.halal.search({ query }),
+    caller.food.search({ query }),
+  ]);
+
+  const halalResults: FoodSearchResult[] = halalRaw.map((r) => ({
+    id: r._id,
+    name: r.name as string,
+    calories: r.calories as number,
+    protein: r.protein as number,
+    carbs: r.carbs as number,
+    fat: r.fat as number,
+    serving: r.serving as string,
+    category: r.category as string | undefined,
+    source: "halal" as const,
+    brand: r.brand as string | undefined,
+    halalCertifier: r.halalCertifier as string | undefined,
+    halalCertYear: r.halalCertYear as number | undefined,
+  }));
+
+  const naturalResults: FoodSearchResult[] = naturalRaw.map((r) => ({
+    id: r._id,
+    name: r.name as string,
+    calories: r.calories as number,
+    protein: r.protein as number,
+    carbs: r.carbs as number,
+    fat: r.fat as number,
+    serving: r.serving as string,
+    source: "natural" as const,
+  }));
+
+  // Halal first, then natural, capped at limit
+  return [...halalResults, ...naturalResults].slice(0, limit);
+}
+
+// ── Format results into a string for the AI prompt ──
+function formatFoodDataForPrompt(results: FoodSearchResult[]): string {
+  if (results.length === 0) return "";
+
+  return results
+    .map((r) => {
+      const parts = [
+        `Name: ${r.name}`,
+        `Calories: ${r.calories} kcal`,
+        `Protein: ${r.protein}g`,
+        `Carbs: ${r.carbs}g`,
+        `Fat: ${r.fat}g`,
+        `Serving: ${r.serving}`,
+        `Source: ${r.source}`,
+      ];
+      if (r.brand) parts.push(`Brand: ${r.brand}`);
+      if (r.halalCertifier) parts.push(`Halal Certifier: ${r.halalCertifier}`);
+      if (r.halalCertYear) parts.push(`Halal Cert Year: ${r.halalCertYear}`);
+      if (r.category) parts.push(`Category: ${r.category}`);
+      return parts.join(" | ");
+    })
+    .join("\n");
+}
+
+// Store recent recipes in memory for quick reference (per thread)
+const recentRecipes = new Map<
+  string,
+  { name: string; ingredients: Array<{ name: string; quantity: string }> }
+>();
+
+/**
+ * Run the full chat workflow as an async generator that yields SSE events.
+ *
+ * The caller (SSE route) iterates over these events and writes them
+ * to the HTTP response as Server-Sent Events.
+ */
+export async function* runChatWorkflow(params: {
+  threadId: string;
+  content: string;
+  userId: string;
+  db: Db;
+}): AsyncGenerator<ChatSSEEvent, void, unknown> {
+  const { threadId, content, userId, db } = params;
+  const now = new Date();
+
+  // ──────────────────────────────────────────────
+  // Step 0: Verify thread ownership & save user message
+  // ──────────────────────────────────────────────
+  const thread = await db.collection("chat_threads").findOne({
+    _id: new ObjectId(threadId),
+    userId,
+  });
+
+  if (!thread) {
+    yield { type: "error", message: "Thread not found or access denied" };
+    yield { type: "done" };
+    return;
+  }
+
+  // Save user message
+  const userMessage: Omit<ChatMessage, "_id"> = {
+    threadId,
+    userId,
+    role: "User",
+    content,
+    createdAt: now,
+  };
+  await db.collection("chat_messages").insertOne(userMessage);
+
+  // Get recent conversation history
+  const recentMessages = await db
+    .collection("chat_messages")
+    .find({ threadId })
+    .sort({ createdAt: -1 })
+    .limit(10)
+    .toArray();
+  recentMessages.reverse();
+
+  const conversationContext = recentMessages
+    .slice(-6)
+    .map((m) => `${m.role}: ${(m.content as string).slice(0, 150)}`)
+    .join("\n");
+
+  // ──────────────────────────────────────────────
+  // Step 1: Classify intent
+  // ──────────────────────────────────────────────
+  yield {
+    type: "tool_start",
+    tool: "classify_intent",
+    message: "Understanding your question...",
+  };
+
+  let intentResult;
+  try {
+    intentResult = await classifyIntent(content, conversationContext);
+    console.log(
+      "[Workflow] Intent:",
+      intentResult.intent,
+      "Confidence:",
+      intentResult.confidence
+    );
+  } catch (error) {
+    console.warn("[Workflow] Intent classification failed:", error);
+    // Default to FoodQuery — a DB search is cheap (cached via tRPC) and
+    // harmless if nothing is found (falls through to general chat).
+    intentResult = {
+      intent: UserIntent.FoodQuery,
+      confidence: 0.3,
+      reasoning: "Fallback — intent classification failed, will search DB",
+      extracted_food_terms: [] as string[],
+      requires_api_lookup: true,
+      requires_recipe_parse: false,
+    };
+  }
+
+  const intentLabel =
+    intentResult.intent === UserIntent.FoodQuery
+      ? "Food nutrition query"
+      : intentResult.intent === UserIntent.RecipeRequest
+        ? "Recipe request"
+        : intentResult.intent === UserIntent.RecipeNutrition
+          ? "Recipe nutrition query"
+          : intentResult.intent === UserIntent.ApiHelp
+            ? "API documentation help"
+            : intentResult.intent === UserIntent.Greeting
+              ? "Greeting"
+              : "General question";
+
+  yield {
+    type: "tool_end",
+    tool: "classify_intent",
+    message: intentLabel,
+    data: {
+      intent: intentResult.intent,
+      confidence: intentResult.confidence,
+      foodTerms: intentResult.extracted_food_terms,
+    },
+  };
+
+  // ──────────────────────────────────────────────
+  // Step 2: Route based on intent
+  // ──────────────────────────────────────────────
+  let foodData = "";
+  let hasDbResults = false;
+  let foodResults: FoodSearchResult[] = [];
+
+  let needsFoodSearch =
+    intentResult.intent === UserIntent.FoodQuery ||
+    intentResult.requires_api_lookup;
+
+  const isRecipeRequest = intentResult.intent === UserIntent.RecipeRequest;
+  const isRecipeNutrition = intentResult.intent === UserIntent.RecipeNutrition;
+  const isApiHelp = intentResult.intent === UserIntent.ApiHelp;
+
+  // ApiHelp never needs food search
+  if (isApiHelp) {
+    needsFoodSearch = false;
+  }
+
+  // ── Food Query Path ──
+  if (needsFoodSearch && !isRecipeRequest && !isRecipeNutrition) {
+    // Extract search term
+    yield {
+      type: "tool_start",
+      tool: "extract_search_term",
+      message: "Extracting food name...",
+    };
+
+    let searchTerm: string;
+    try {
+      searchTerm = await extractFoodSearchTerm(content);
+    } catch {
+      // Fallback: use extracted food terms from intent or the raw message
+      searchTerm =
+        intentResult.extracted_food_terms?.[0] || content.toLowerCase();
+    }
+
+    yield {
+      type: "tool_end",
+      tool: "extract_search_term",
+      message: `Searching for "${searchTerm}"`,
+      data: { searchTerm },
+    };
+
+    // Search database
+    yield {
+      type: "tool_start",
+      tool: "search_database",
+      message: `Searching Kalori database for "${searchTerm}"...`,
+    };
+
+    foodResults = await searchFoods(db, searchTerm);
+    hasDbResults = foodResults.length > 0;
+
+    if (hasDbResults) {
+      const halalCount = foodResults.filter((r) => r.source === "halal").length;
+      const naturalCount = foodResults.filter(
+        (r) => r.source === "natural"
+      ).length;
+
+      const parts: string[] = [];
+      if (halalCount > 0) parts.push(`${halalCount} halal`);
+      if (naturalCount > 0) parts.push(`${naturalCount} natural`);
+
+      yield {
+        type: "tool_end",
+        tool: "search_database",
+        message: `Found ${foodResults.length} results (${parts.join(", ")})`,
+        data: {
+          count: foodResults.length,
+          halalCount,
+          naturalCount,
+          foods: foodResults.map((f) => f.name),
+        },
+      };
+
+      foodData = formatFoodDataForPrompt(foodResults);
+    } else {
+      yield {
+        type: "tool_end",
+        tool: "search_database",
+        message: `No results found for "${searchTerm}"`,
+        data: { count: 0 },
+      };
+
+      // Try AI estimation
+      yield {
+        type: "tool_start",
+        tool: "estimate_nutrition",
+        message: `Estimating nutrition for "${searchTerm}"...`,
+      };
+
+      try {
+        const estimated = await estimateNutrition(searchTerm);
+        const estimatedResult: FoodSearchResult = {
+          id: `estimated-${Date.now()}`,
+          name: estimated.name,
+          calories: estimated.calories,
+          protein: estimated.protein,
+          carbs: estimated.carbs,
+          fat: estimated.fat,
+          serving: estimated.serving,
+          source: "estimated",
+        };
+        foodResults = [estimatedResult];
+        foodData = formatFoodDataForPrompt(foodResults);
+
+        yield {
+          type: "tool_end",
+          tool: "estimate_nutrition",
+          message: "AI estimation ready (not from database)",
+          data: { estimated: true },
+        };
+      } catch (error) {
+        console.warn("[Workflow] Estimation failed:", error);
+        yield {
+          type: "tool_end",
+          tool: "estimate_nutrition",
+          message: "Not found — will respond as general chat",
+        };
+        // No food data at all — fall through to general chat formatter
+        needsFoodSearch = false;
+      }
+    }
+  }
+
+  // ── Recipe Nutrition Path ──
+  if (isRecipeNutrition) {
+    const cachedRecipe = recentRecipes.get(threadId);
+    if (cachedRecipe) {
+      yield {
+        type: "tool_start",
+        tool: "search_database",
+        message: `Looking up nutrition for ${cachedRecipe.ingredients.length} ingredients...`,
+      };
+
+      // Search ingredients in DB
+      const ingredientResults: FoodSearchResult[] = [];
+      for (const ing of cachedRecipe.ingredients) {
+        const results = await searchFoods(db, ing.name, 1);
+        if (results.length > 0) {
+          ingredientResults.push(results[0]);
+        } else {
+          // Estimate
+          try {
+            const est = await estimateNutrition(ing.name, ing.quantity);
+            ingredientResults.push({
+              id: `estimated-${Date.now()}`,
+              name: est.name,
+              calories: est.calories,
+              protein: est.protein,
+              carbs: est.carbs,
+              fat: est.fat,
+              serving: est.serving,
+              source: "estimated",
+            });
+          } catch {
+            // Skip failed estimations
+          }
+        }
+      }
+
+      foodData = formatFoodDataForPrompt(ingredientResults);
+      hasDbResults = ingredientResults.some((r) => r.source !== "estimated");
+
+      yield {
+        type: "tool_end",
+        tool: "search_database",
+        message: `Found nutrition for ${ingredientResults.length} ingredients`,
+        data: { count: ingredientResults.length },
+      };
+    }
+  }
+
+  // ──────────────────────────────────────────────
+  // Step 3: Stream AI response
+  // ──────────────────────────────────────────────
+  yield {
+    type: "tool_start",
+    tool: "generate_response",
+    message: "Generating response...",
+  };
+
+  yield { type: "stream_start" };
+
+  let fullResponse = "";
+
+  try {
+    let streamGen: AsyncGenerator<string, void, unknown>;
+
+    if (isApiHelp) {
+      // API documentation help → use FormatApiHelpResponse
+      streamGen = streamFormatApiHelpResponse({
+        userMessage: content,
+        conversationContext,
+      });
+    } else if (isRecipeRequest || isRecipeNutrition) {
+      // Recipe → use FormatRecipeResponse
+      streamGen = streamFormatRecipeResponse({
+        userMessage: content,
+        ingredientNutrition: foodData || undefined,
+        conversationContext,
+      });
+    } else if (needsFoodSearch) {
+      // Food query → use FormatFoodResponse with strict DB data
+      streamGen = streamFormatFoodResponse({
+        userMessage: content,
+        foodData: foodData || "No data available.",
+        hasDbResults,
+        conversationContext,
+      });
+    } else {
+      // General chat / greeting → use StreamChat
+      streamGen = streamGeneralChat({
+        userMessage: content,
+        conversationContext,
+      });
+    }
+
+    for await (const chunk of streamGen) {
+      if (chunk && typeof chunk === "string") {
+        // BAML streaming yields cumulative text, so we need the delta
+        const delta = chunk.slice(fullResponse.length);
+        if (delta) {
+          fullResponse = chunk;
+          yield { type: "stream_delta", delta };
+        }
+      }
+    }
+  } catch (error) {
+    console.error("[Workflow] Stream error:", error);
+    if (!fullResponse) {
+      fullResponse =
+        "I'm sorry, I encountered an error generating a response. Please try again.";
+      yield { type: "stream_delta", delta: fullResponse };
+    }
+  }
+
+  yield {
+    type: "tool_end",
+    tool: "generate_response",
+    message: "Response complete",
+  };
+
+  // ──────────────────────────────────────────────
+  // Step 4: Save assistant message & update thread
+  // ──────────────────────────────────────────────
+  const assistantMessage: Omit<ChatMessage, "_id"> = {
+    threadId,
+    userId,
+    role: "Assistant",
+    content: fullResponse,
+    createdAt: new Date(),
+  };
+
+  const assistantResult = await db
+    .collection("chat_messages")
+    .insertOne(assistantMessage);
+
+  // If recipe response, try to cache it for future nutrition queries
+  if (isRecipeRequest || fullResponse.toLowerCase().includes("ingredients")) {
+    try {
+      const parsed = await parseRecipe(fullResponse);
+      if (parsed.ingredients.length > 0) {
+        recentRecipes.set(threadId, {
+          name: parsed.name,
+          ingredients: parsed.ingredients.map((i: RecipeIngredient) => ({
+            name: i.name,
+            quantity: i.quantity,
+          })),
+        });
+      }
+    } catch {
+      // Not a parseable recipe — that's fine
+    }
+  }
+
+  // Update thread metadata
+  const isFirstMessage = (thread.messageCount as number) === 0;
+  const updateData: Partial<ChatThread> = {
+    updatedAt: new Date(),
+    messageCount: (thread.messageCount as number) + 2,
+  };
+
+  if (isFirstMessage) {
+    updateData.title =
+      content.slice(0, 50) + (content.length > 50 ? "..." : "");
+  }
+
+  await db
+    .collection("chat_threads")
+    .updateOne({ _id: new ObjectId(threadId) }, { $set: updateData });
+
+  yield {
+    type: "stream_end",
+    messageId: assistantResult.insertedId.toString(),
+  };
+
+  yield { type: "done" };
+}
diff --git a/packages/kal-backend/src/lib/trpc.ts b/packages/kal-backend/src/lib/trpc.ts
index 2e53294..abfbf79 100644
--- a/packages/kal-backend/src/lib/trpc.ts
+++ b/packages/kal-backend/src/lib/trpc.ts
@@ -6,6 +6,7 @@ const t = initTRPC.context<Context>().create();
 
 export const router = t.router;
 export const publicProcedure = t.procedure;
+export const createCallerFactory = t.createCallerFactory;
 
 // Middleware to check if user is authenticated
 const isAuthenticated = t.middleware(({ ctx, next }) => {
diff --git a/packages/kal-backend/src/middleware/timeout.ts b/packages/kal-backend/src/middleware/timeout.ts
index 0874c9a..9b889bb 100644
--- a/packages/kal-backend/src/middleware/timeout.ts
+++ b/packages/kal-backend/src/middleware/timeout.ts
@@ -38,8 +38,10 @@ export function requestTimeout(timeoutMs: number = DEFAULT_TIMEOUT_MS) {
     }
 
     // Use extended timeout for AI/chat routes that may take longer
-    const extendedTimeoutPaths = ["/trpc/chat.sendMessage", "/trpc/chat"];
-    const isExtendedPath = extendedTimeoutPaths.some((path) => req.path.includes(path));
+    const extendedTimeoutPaths = ["/trpc/chat", "/api/chat/stream"];
+    const isExtendedPath = extendedTimeoutPaths.some((path) =>
+      req.path.includes(path)
+    );
     const effectiveTimeout = isExtendedPath ? EXTENDED_TIMEOUT_MS : timeoutMs;
 
     // Use native request timeout - no custom timers needed
diff --git a/packages/kal-backend/src/routers/chat.ts b/packages/kal-backend/src/routers/chat.ts
index 1c98664..0476ef7 100644
--- a/packages/kal-backend/src/routers/chat.ts
+++ b/packages/kal-backend/src/routers/chat.ts
@@ -1,23 +1,7 @@
-import {
-  smartChat,
-  classifyIntent,
-  parseRecipe,
-  type ParsedRecipe,
-  type RecipeIngredient,
-  UserIntent,
-} from "kal-baml";
-import type { ChatMessage, ChatThread, ChatThreadPreview } from "kal-shared";
+import type { ChatThread, ChatThreadPreview } from "kal-shared";
 import { ObjectId } from "mongodb";
 import { z } from "zod";
 
-import {
-  isFoodQuery,
-  isRecipeNutritionQuery,
-  searchKaloriApi,
-  searchRecipeIngredients,
-  formatNutritionForChat,
-  calculateTotalNutrition,
-} from "../lib/kalori-api-tool.js";
 import { router, protectedProcedure } from "../lib/trpc.js";
 
 // Helper to ensure user is authenticated
@@ -28,9 +12,6 @@ function requireUser(user: { logtoId: string } | null): { logtoId: string } {
   return user;
 }
 
-// Store recent recipes in memory for quick reference (per thread)
-const recentRecipes = new Map<string, ParsedRecipe>();
-
 // ===================
 // Thread Management
 // ===================
@@ -127,350 +108,14 @@ export const chatRouter = router({
         .collection("chat_threads")
         .deleteOne({ _id: new ObjectId(threadId) });
 
-      // Clear any cached recipes for this thread
-      recentRecipes.delete(threadId);
-
       return { success: true };
     }),
 
   // ===================
   // Message Management
   // ===================
-
-  // Send a message and get AI response
-  sendMessage: protectedProcedure
-    .input(
-      z.object({
-        threadId: z.string(),
-        content: z.string().min(1).max(10000),
-      })
-    )
-    .mutation(async ({ ctx, input }) => {
-      const user = requireUser(ctx.user);
-      const { threadId, content } = input;
-      const now = new Date();
-
-      console.log("[Chat] sendMessage called:", {
-        user: user.logtoId,
-        threadId,
-        content: content.slice(0, 50),
-      });
-
-      // Verify thread ownership
-      const thread = await ctx.db.collection("chat_threads").findOne({
-        _id: new ObjectId(threadId),
-        userId: user.logtoId,
-      });
-
-      if (!thread) {
-        console.log("[Chat] Thread not found or access denied:", threadId);
-        throw new Error("Thread not found or access denied");
-      }
-
-      // Save user message
-      const userMessage: Omit<ChatMessage, "_id"> = {
-        threadId,
-        userId: user.logtoId,
-        role: "User",
-        content,
-        createdAt: now,
-      };
-
-      const userMsgResult = await ctx.db
-        .collection("chat_messages")
-        .insertOne(userMessage);
-
-      console.log(
-        "[Chat] User message saved:",
-        userMsgResult.insertedId.toString()
-      );
-
-      // Get recent conversation history for context (last 10 messages)
-      const recentMessages = await ctx.db
-        .collection("chat_messages")
-        .find({ threadId })
-        .sort({ createdAt: -1 })
-        .limit(10)
-        .toArray();
-
-      // Reverse to chronological order
-      recentMessages.reverse();
-
-      // Build conversation context for intent classification
-      const conversationContext = recentMessages
-        .slice(-5)
-        .map((m) => `${m.role}: ${(m.content as string).slice(0, 100)}`)
-        .join("\n");
-
-      // Classify intent to determine how to handle the message
-      console.log("[Thinking] Classifying user intent...");
-      let intentResult;
-      try {
-        intentResult = await classifyIntent(content, conversationContext);
-        console.log(
-          "[Thinking] Intent:",
-          intentResult.intent,
-          "Confidence:",
-          intentResult.confidence
-        );
-      } catch (_error) {
-        intentResult = {
-          intent: UserIntent.GeneralChat,
-          confidence: 0.5,
-          reasoning: "Fallback",
-          extracted_food_terms: [],
-          requires_api_lookup: isFoodQuery(content),
-          requires_recipe_parse: false,
-        };
-      }
-
-      // Process based on intent
-      let foodContext = "";
-      let recipeContext = "";
-
-      // Check if user is asking about a recipe's nutrition
-      if (isRecipeNutritionQuery(content)) {
-        console.log("[Tool: recipe] Recipe nutrition query detected");
-
-        // Check if we have a recent recipe for this thread
-        const cachedRecipe = recentRecipes.get(threadId);
-
-        if (cachedRecipe) {
-          console.log("[Tool: recipe] Using cached recipe:", cachedRecipe.name);
-
-          // Search for all ingredients
-          const ingredients = cachedRecipe.ingredients.map(
-            (i: RecipeIngredient) => ({
-              name: i.name,
-              quantity: i.quantity,
-            })
-          );
-
-          console.log(
-            "[Tool: recipe] Searching nutrition for",
-            ingredients.length,
-            "ingredients"
-          );
-          const nutritionResults = await searchRecipeIngredients(ingredients);
-
-          // Calculate totals
-          const totals = calculateTotalNutrition(nutritionResults);
-
-          // Format for context
-          foodContext = `Recipe: ${cachedRecipe.name}\n\nIngredient nutrition:\n${formatNutritionForChat(nutritionResults)}`;
-          foodContext += `\n\n**Total Nutrition:**\n- Calories: ${totals.totalCalories} cal\n- Protein: ${totals.totalProtein}g\n- Carbs: ${totals.totalCarbs}g\n- Fat: ${totals.totalFat}g`;
-          if (totals.hasEstimates) {
-            foodContext +=
-              "\n\n_Note: Some values are AI estimates as the ingredients were not found in our database._";
-          }
-        } else {
-          // Try to find a recipe in recent messages
-          console.log(
-            "[Tool: recipe] No cached recipe, looking in conversation..."
-          );
-
-          // Look for recipe in recent assistant messages
-          const recentAssistantMessages = recentMessages
-            .filter((m) => m.role === "Assistant")
-            .slice(-3);
-
-          for (const msg of recentAssistantMessages) {
-            const msgContent = msg.content as string;
-            if (
-              msgContent.includes("Ingredients") ||
-              msgContent.includes("Recipe")
-            ) {
-              console.log(
-                "[Tool: recipe] Found recipe in conversation, parsing..."
-              );
-              try {
-                const parsedRecipe = await parseRecipe(msgContent);
-                recentRecipes.set(threadId, parsedRecipe);
-
-                // Search for all ingredients
-                const ingredients = parsedRecipe.ingredients.map(
-                  (i: RecipeIngredient) => ({
-                    name: i.name,
-                    quantity: i.quantity,
-                  })
-                );
-
-                console.log(
-                  "[Tool: recipe] Searching nutrition for",
-                  ingredients.length,
-                  "ingredients"
-                );
-                const nutritionResults =
-                  await searchRecipeIngredients(ingredients);
-                const totals = calculateTotalNutrition(nutritionResults);
-
-                foodContext = `Recipe: ${parsedRecipe.name}\n\nIngredient nutrition:\n${formatNutritionForChat(nutritionResults)}`;
-                foodContext += `\n\n**Total Nutrition:**\n- Calories: ${totals.totalCalories} cal\n- Protein: ${totals.totalProtein}g\n- Carbs: ${totals.totalCarbs}g\n- Fat: ${totals.totalFat}g`;
-                if (totals.hasEstimates) {
-                  foodContext += "\n\n_Note: Some values are AI estimates._";
-                }
-                break;
-              } catch (error) {
-                console.log("[Tool: recipe] Failed to parse recipe:", error);
-              }
-            }
-          }
-        }
-      }
-      // Handle recipe requests - save for later nutrition queries
-      else if (
-        intentResult.intent === UserIntent.RecipeRequest ||
-        content.toLowerCase().includes("recipe")
-      ) {
-        console.log("[Tool: recipe] Recipe request detected");
-        recipeContext =
-          "User is asking for a recipe. After providing the recipe, they may ask about its nutrition.";
-      }
-      // Handle food queries
-      else if (intentResult.requires_api_lookup || isFoodQuery(content)) {
-        console.log(
-          "[Tool: api_checker] Food query detected, searching API..."
-        );
-        const foodResults = await searchKaloriApi(content);
-
-        if (foodResults.length > 0) {
-          foodContext = formatNutritionForChat(foodResults);
-          console.log(
-            "[Tool: api_checker] Added",
-            foodResults.length,
-            "results to context"
-          );
-        }
-      }
-
-      // Build messages for SmartChat
-      const chatMessages = recentMessages.map((m) => ({
-        role: m.role as "User" | "Assistant" | "System",
-        content: m.content as string,
-      }));
-
-      // Build enhanced system prompt
-      const systemPrompt = `You are Kal, a helpful AI nutrition assistant powered by Kalori. You help users with:
-- Food nutrition information (calories, protein, carbs, fat)
-- Recipe suggestions with Malaysian/halal food focus
-- Healthy eating advice
-
-**IMPORTANT: Format all responses using proper Markdown:**
-- Use **bold** for section headers like **Ingredients:** and **Instructions:**
-- Use bullet points (- item) for lists with a blank line before the list
-- Use numbered lists (1. step) for instructions
-- Add blank lines between sections for readability
-- Use ### for recipe titles
-
-Always respond in English. Be friendly, concise, and accurate.
-${recipeContext}`;
-
-      // Generate AI response using SmartChat with full context
-      console.log("[Streaming] Generating AI response with SmartChat...");
-      let aiResponse = await smartChat({
-        messages: chatMessages,
-        systemPrompt,
-        foodContext: foodContext || undefined,
-      });
-      console.log(
-        "[Streaming] Response generated:",
-        aiResponse.slice(0, 50) + "..."
-      );
-
-      // If this was a recipe response, parse it and append nutrition summary
-      if (
-        intentResult.intent === UserIntent.RecipeRequest ||
-        aiResponse.toLowerCase().includes("ingredients")
-      ) {
-        try {
-          const parsedRecipe = await parseRecipe(aiResponse);
-          if (parsedRecipe.ingredients.length > 0) {
-            console.log("[Tool: recipe] Caching recipe:", parsedRecipe.name);
-            recentRecipes.set(threadId, parsedRecipe);
-
-            // Calculate nutrition for all ingredients
-            console.log(
-              "[Tool: recipe] Calculating nutrition for",
-              parsedRecipe.ingredients.length,
-              "ingredients"
-            );
-            const ingredients = parsedRecipe.ingredients.map(
-              (i: RecipeIngredient) => ({
-                name: i.name,
-                quantity: i.quantity,
-              })
-            );
-
-            const nutritionResults = await searchRecipeIngredients(ingredients);
-            const totals = calculateTotalNutrition(nutritionResults);
-
-            // Build nutrition summary
-            let nutritionSummary =
-              "\n\n---\n\n**Nutrition Summary (estimated per serving):**\n";
-            nutritionSummary += `- **Calories:** ${totals.totalCalories} cal\n`;
-            nutritionSummary += `- **Protein:** ${totals.totalProtein}g\n`;
-            nutritionSummary += `- **Carbs:** ${totals.totalCarbs}g\n`;
-            nutritionSummary += `- **Fat:** ${totals.totalFat}g\n`;
-
-            if (totals.hasEstimates) {
-              nutritionSummary +=
-                "\n_Some values are estimated as ingredients were not found in our database._";
-            }
-
-            // Append to response
-            aiResponse += nutritionSummary;
-            console.log("[Tool: recipe] Nutrition summary appended");
-          }
-        } catch (error) {
-          console.log(
-            "[Tool: recipe] Failed to parse/calculate nutrition:",
-            error
-          );
-          // Not a recipe or failed to parse - that's okay
-        }
-      }
-
-      // Save assistant message
-      const assistantMessage: Omit<ChatMessage, "_id"> = {
-        threadId,
-        userId: user.logtoId,
-        role: "Assistant",
-        content: aiResponse,
-        createdAt: new Date(),
-      };
-
-      const assistantResult = await ctx.db
-        .collection("chat_messages")
-        .insertOne(assistantMessage);
-
-      // Update thread
-      const isFirstMessage = (thread.messageCount as number) === 0;
-      const updateData: Partial<ChatThread> = {
-        updatedAt: new Date(),
-        messageCount: (thread.messageCount as number) + 2, // User + Assistant
-      };
-
-      // Auto-generate title from first message
-      if (isFirstMessage) {
-        updateData.title =
-          content.slice(0, 50) + (content.length > 50 ? "..." : "");
-      }
-
-      await ctx.db
-        .collection("chat_threads")
-        .updateOne({ _id: new ObjectId(threadId) }, { $set: updateData });
-
-      return {
-        userMessage: {
-          _id: userMsgResult.insertedId.toString(),
-          ...userMessage,
-        },
-        assistantMessage: {
-          _id: assistantResult.insertedId.toString(),
-          ...assistantMessage,
-        },
-      };
-    }),
+  // NOTE: sendMessage has been replaced by the SSE endpoint at POST /api/chat/stream
+  // See: routes/chat-stream.ts + lib/chat-workflow.ts
 
   // Get messages for a thread
   getMessages: protectedProcedure
diff --git a/packages/kal-backend/src/routers/halal.ts b/packages/kal-backend/src/routers/halal.ts
index 416e88e..c68cd0b 100644
--- a/packages/kal-backend/src/routers/halal.ts
+++ b/packages/kal-backend/src/routers/halal.ts
@@ -2,6 +2,7 @@ import { z } from "zod";
 
 import { CacheKeys, CacheTTL } from "../lib/cache-keys.js";
 import { cache } from "../lib/cache.js";
+import { buildSearchQuery } from "../lib/search.js";
 import { router, publicProcedure } from "../lib/trpc.js";
 
 export const halalRouter = router({
@@ -12,9 +13,10 @@ export const halalRouter = router({
       const cacheKey = CacheKeys.trpcHalalSearch(input.query);
 
       return cache.wrap(cacheKey, CacheTTL.SEARCH_RESULTS, async () => {
+        const searchQuery = buildSearchQuery(input.query);
         const foods = await ctx.db
           .collection("halal_foods")
-          .find({ name: { $regex: input.query, $options: "i" } })
+          .find(searchQuery)
           .limit(20)
           .toArray();
 
@@ -117,9 +119,7 @@ export const halalRouter = router({
     const cacheKey = CacheKeys.trpcHalalBrands();
 
     return cache.wrap(cacheKey, CacheTTL.BRANDS, async () => {
-      const brands = await ctx.db
-        .collection("halal_foods")
-        .distinct("brand");
+      const brands = await ctx.db.collection("halal_foods").distinct("brand");
       return brands.filter(Boolean).sort();
     });
   }),
diff --git a/packages/kal-backend/src/routes/chat-stream.ts b/packages/kal-backend/src/routes/chat-stream.ts
new file mode 100644
index 0000000..07dd7b8
--- /dev/null
+++ b/packages/kal-backend/src/routes/chat-stream.ts
@@ -0,0 +1,141 @@
+/**
+ * SSE endpoint for streaming chat responses.
+ *
+ * POST /api/chat/stream
+ *   Body: { threadId: string, content: string }
+ *   Headers: x-logto-id (required), x-logto-email, x-logto-name
+ *
+ * Responds with Server-Sent Events following the ChatSSEEvent protocol.
+ */
+
+import { Router, type Request, type Response } from "express";
+import type { User } from "kal-shared";
+
+import { getDB } from "../lib/db.js";
+import { runChatWorkflow } from "../lib/chat-workflow.js";
+
+export const chatStreamRouter: Router = Router();
+
+/**
+ * Resolve user from x-logto-id header (same logic as context.ts).
+ * Returns null if not authenticated.
+ */
+async function resolveUser(req: Request): Promise<{ logtoId: string } | null> {
+  const logtoId = req.headers["x-logto-id"] as string | undefined;
+  if (!logtoId) return null;
+
+  const db = getDB();
+
+  // Try to find user or auto-create (mirrors context.ts behaviour)
+  let user = await db.collection<User>("users").findOne({ logtoId });
+
+  if (!user) {
+    const email = (req.headers["x-logto-email"] as string) || null;
+    const name = (req.headers["x-logto-name"] as string) || undefined;
+    const now = new Date();
+
+    const result = await db.collection("users").findOneAndUpdate(
+      { logtoId },
+      {
+        $set: {
+          email,
+          ...(name ? { name } : {}),
+          updatedAt: now,
+        },
+        $setOnInsert: {
+          logtoId,
+          tier: "free",
+          createdAt: now,
+        },
+      },
+      { upsert: true, returnDocument: "after" }
+    );
+    user = result as unknown as User | null;
+  }
+
+  return user ? { logtoId: user.logtoId } : null;
+}
+
+// ── POST /api/chat/stream ──
+chatStreamRouter.post("/stream", async (req: Request, res: Response) => {
+  // --- Auth ---
+  const user = await resolveUser(req);
+  if (!user) {
+    res.status(401).json({ error: "Authentication required" });
+    return;
+  }
+
+  // --- Validate body ---
+  const { threadId, content } = req.body as {
+    threadId?: string;
+    content?: string;
+  };
+
+  if (!threadId || typeof threadId !== "string") {
+    res.status(400).json({ error: "threadId is required" });
+    return;
+  }
+  if (!content || typeof content !== "string" || content.trim().length === 0) {
+    res.status(400).json({ error: "content is required" });
+    return;
+  }
+  if (content.length > 10000) {
+    res.status(400).json({ error: "content exceeds maximum length (10000)" });
+    return;
+  }
+
+  // --- Setup SSE headers ---
+  res.writeHead(200, {
+    "Content-Type": "text/event-stream",
+    "Cache-Control": "no-cache",
+    Connection: "keep-alive",
+    "X-Accel-Buffering": "no", // Disable nginx buffering
+  });
+
+  // Flush headers immediately
+  res.flushHeaders();
+
+  // Handle client disconnect
+  let aborted = false;
+  req.on("close", () => {
+    aborted = true;
+  });
+
+  // --- Run workflow and stream events ---
+  const db = getDB();
+
+  try {
+    const workflow = runChatWorkflow({
+      threadId,
+      content: content.trim(),
+      userId: user.logtoId,
+      db,
+    });
+
+    for await (const event of workflow) {
+      if (aborted) break;
+
+      // Write SSE: event type + JSON data
+      res.write(`event: ${event.type}\n`);
+      res.write(`data: ${JSON.stringify(event)}\n\n`);
+    }
+  } catch (error) {
+    console.error("[SSE] Workflow error:", error);
+
+    if (!aborted) {
+      const errorEvent = JSON.stringify({
+        type: "error",
+        message: "Internal server error",
+      });
+      res.write(`event: error\n`);
+      res.write(`data: ${errorEvent}\n\n`);
+
+      res.write(`event: done\n`);
+      res.write(`data: ${JSON.stringify({ type: "done" })}\n\n`);
+    }
+  } finally {
+    if (!aborted) {
+      res.end();
+    }
+  }
+});
diff --git a/packages/kal-baml/baml_src/clients/claude.baml b/packages/kal-baml/baml_src/clients/claude.baml
new file mode 100644
index 0000000..36233e3
--- /dev/null
+++ b/packages/kal-baml/baml_src/clients/claude.baml
@@ -0,0 +1,9 @@
+// Claude Haiku 4.5 via Pika AI proxy
+client<llm> Claude {
+  provider anthropic
+  options {
+    base_url env.PIKA_BASE_URL
+    api_key env.PIKA_API_KEY
+    model "claude-haiku-4.5"
+  }
+}
diff --git a/packages/kal-baml/baml_src/clients/glm.baml b/packages/kal-baml/baml_src/clients/glm.baml
deleted file mode 100644
index 4297b5e..0000000
--- a/packages/kal-baml/baml_src/clients/glm.baml
+++ /dev/null
@@ -1,21 +0,0 @@
-// GLM 4.6V FlashX client configuration for Zhipu AI (cheapest option)
-client<llm> GLM46 {
-  provider openai-generic
-  options {
-    base_url env.GLM_API_BASE_URL
-    api_key env.GLM_API_KEY
-    model "glm-4.6v-flashx"
-    default_role "user"
-    headers {
-      "Content-Type" "application/json"
-    }
-  }
-}
-
-// Fallback client for resilience
-client<llm> GLM46WithFallback {
-  provider fallback
-  options {
-    strategy [GLM46]
-  }
-}
diff --git a/packages/kal-baml/baml_src/functions/agent.baml b/packages/kal-baml/baml_src/functions/agent.baml
new file mode 100644
index 0000000..65cfe28
--- /dev/null
+++ b/packages/kal-baml/baml_src/functions/agent.baml
@@ -0,0 +1,202 @@
+// ============================================
+// Agent Workflow Functions
+// Database-first food response generation
+// ============================================
+
+// Generate a response using ONLY data from the Kalori database
+// This is the core function for food queries — it prevents hallucinated nutrition numbers
+function FormatFoodResponse(
+  user_message: string,
+  food_data: string,
+  has_db_results: bool,
+  conversation_context: string?
+) -> string {
+  client Claude
+  prompt #"
+    {{ _.role("system") }}
+    You are Kal, a Malaysian food nutrition assistant powered by the Kalori database.
+
+    STRICT RULES:
+    1. If food_data is provided with has_db_results=true, your response MUST use ONLY the numbers from that data. Do NOT invent, round, or adjust any calorie/protein/carbs/fat values.
+    2. Present the data clearly with the food name, serving size, and all macros.
+    3. If a food has source "halal", mention it is halal-certified. Include the certifier and year if available.
+    4. If a food has source "natural", present it as from the natural foods database.
+    5. If a food has source "estimated", clearly mark it: "(AI estimate — not verified in our database)"
+    6. If has_db_results=false, tell the user the food was not found in the Kalori database, then provide an AI estimate clearly labeled as such.
+    7. Always respond in English. Be friendly and concise.
+    8. Use markdown formatting: **bold** for headers, bullet points (- item) for data lists.
+    9. If multiple results are returned, show the most relevant ones (max 5).
+    10. End with a brief helpful tip or offer to look up related foods.
+    11. Do NOT add disclaimers about consulting nutritionists unless the user asks for medical advice.
+    12. When showing nutrition, always use this format per food item:
+        **Food Name** (serving size)
+        - Calories: X kcal
+        - Protein: Xg
+        - Carbs: Xg
+        - Fat: Xg
+
+    {% if conversation_context %}
+    Recent conversation:
+    {{ conversation_context }}
+    {% endif %}
+
+    {% if food_data %}
+    DATABASE RESULTS:
+    {{ food_data }}
+    {% endif %}
+
+    {{ _.role("user") }}
+    {{ user_message }}
+
+    {{ _.role("assistant") }}
+  "#
+}
+
+// Generate a response for recipe queries with nutrition from the database
+function FormatRecipeResponse(
+  user_message: string,
+  recipe_data: string?,
+  ingredient_nutrition: string?,
+  conversation_context: string?
+) -> string {
+  client Claude
+  prompt #"
+    {{ _.role("system") }}
+    You are Kal, a Malaysian cooking and nutrition expert.
+
+    RULES:
+    1. When providing a recipe, include clear ingredients and step-by-step instructions.
+    2. Use markdown: ### for recipe title, **bold** for section headers, numbered lists for steps, bullet lists for ingredients.
+    3. Focus on Malaysian and halal-friendly recipes.
+    4. If ingredient_nutrition is provided, include a nutrition summary section at the end using ONLY those numbers.
+    5. If some ingredients show source "estimated", note that some nutrition values are AI estimates.
+    6. Always respond in English. Be friendly and practical.
+    7. Keep recipes simple and achievable with common Malaysian ingredients.
+
+    {% if conversation_context %}
+    Recent conversation:
+    {{ conversation_context }}
+    {% endif %}
+
+    {% if recipe_data %}
+    Recipe context:
+    {{ recipe_data }}
+    {% endif %}
+
+    {% if ingredient_nutrition %}
+    INGREDIENT NUTRITION FROM DATABASE:
+    {{ ingredient_nutrition }}
+    {% endif %}
+
+    {{ _.role("user") }}
+    {{ user_message }}
+
+    {{ _.role("assistant") }}
+  "#
+}
+
+// Generate a response for API help/documentation questions
+// The system prompt contains the full API reference so the AI gives accurate endpoint info
+function FormatApiHelpResponse(
+  user_message: string,
+  conversation_context: string?
+) -> string {
+  client Claude
+  prompt #"
+    {{ _.role("system") }}
+    You are Kal, the AI assistant for the Kalori API — a Malaysian food nutrition API.
+    You have COMPLETE knowledge of the Kalori API. Answer developer questions accurately using ONLY the information below.
+
+    RULES:
+    1. Always give specific, accurate endpoint URLs and parameters from the reference below.
+    2. Include working curl examples when showing endpoints.
+    3. Use markdown formatting: code blocks for URLs/curl/JSON, tables for parameters, bold for emphasis.
+    4. If the user mentions a specific food (e.g. "nasi lemak"), show them the exact search endpoint with that food URL-encoded in the query.
+    5. Always mention they need an API key and where to get one.
+    6. Be concise and developer-friendly. No filler.
+    7. Always respond in English.
+    8. If asking about something NOT covered by the API (e.g. write endpoints, user auth), say so clearly.
+
+    ═══════════════════════════════════════════
+    KALORI API REFERENCE
+    ═══════════════════════════════════════════
+
+    Base URL: https://api.kalori-api.my/api/v1
+    Authentication: x-api-key header (required for all requests)
+    Get an API key: Sign in at https://kalori-api.my → Dashboard → Generate API Key
+
+    Documentation:
+    - Interactive Swagger UI: https://api.kalori-api.my/api-docs
+    - Custom docs page: https://api.kalori-api.my/docs
+    - OpenAPI 3.0 spec: https://api.kalori-api.my/openapi.json
+
+    ── NATURAL FOODS ──
+
+    GET /api/v1/foods/search?q={query}
+      Search natural foods by name. Returns up to 20 results.
+      Response: { success: true, data: [{ id, name, calories, protein, carbs, fat, serving, category }], count }
+
+    GET /api/v1/foods?category={cat}&limit={n}&offset={n}
+      List all natural foods. Optional filters: category, limit (default 50, max 200), offset.
+      Response: { success: true, data: [...], pagination: { total, limit, offset, hasMore } }
+
+    GET /api/v1/foods/:id
+      Get a single food by MongoDB ObjectId.
+      Response: { success: true, data: { id, name, calories, protein, carbs, fat, serving, category } }
+
+    GET /api/v1/categories
+      List all food categories.
+      Response: { success: true, data: ["Basics", "Desserts", "Drinks", "Meat", "Noodles", "Rice", ...] }
+
+    ── HALAL FOODS ──
+
+    GET /api/v1/halal/search?q={query}
+      Search halal-certified foods by name. Returns up to 20 results.
+      Response: { success: true, data: [{ id, name, calories, protein, carbs, fat, serving, category, brand, halalCertifier, halalCertYear }], count }
+
+    GET /api/v1/halal?brand={brand}&category={cat}&limit={n}&offset={n}
+      List halal foods with optional filters.
+      Response: { success: true, data: [...], pagination: { total, limit, offset, hasMore } }
+
+    GET /api/v1/halal/:id
+      Get a single halal food by ID.
+
+    GET /api/v1/halal/brands?q={filter}&withCount=true
+      List all halal brands. Optional: q (filter brand names), withCount (include product counts).
+
+    ── STATS ──
+
+    GET /api/v1/stats
+      Database statistics.
+      Response: { success: true, data: { naturalFoods: { total, categories }, halalFoods: { total, brands } } }
+
+    ── DATA TYPES ──
+
+    Food: { id: string, name: string, calories: number, protein: number, carbs: number, fat: number, serving: string, category: string }
+    HalalFood extends Food: { brand: string, halalCertifier: string, halalCertYear: number }
+
+    ── ERROR RESPONSES ──
+
+    All errors: { success: false, error: "message" }
+    Status codes: 400 (bad request), 401 (invalid API key), 404 (not found), 429 (rate limit), 500 (server error)
+
+    ── RATE LIMITS ──
+
+    Free tier: 65/min, 3,300/day, 95,000/month
+    Tier 1: 130/min, 6,600/day, 195,000/month
+    Tier 2: 145/min, 7,500/day, 215,000/month
+    Rate limit headers included in all responses: X-RateLimit-Limit-Minute, X-RateLimit-Remaining-Minute, etc.
+
+    ═══════════════════════════════════════════
+
+    {% if conversation_context %}
+    Recent conversation:
+    {{ conversation_context }}
+    {% endif %}
+
+    {{ _.role("user") }}
+    {{ user_message }}
+
+    {{ _.role("assistant") }}
+  "#
+}
diff --git a/packages/kal-baml/baml_src/functions/analysis.baml b/packages/kal-baml/baml_src/functions/analysis.baml
index f0bb56c..a8ffc7d 100644
--- a/packages/kal-baml/baml_src/functions/analysis.baml
+++ b/packages/kal-baml/baml_src/functions/analysis.baml
@@ -4,7 +4,7 @@
 
 // Analyze food from text description
 function AnalyzeFood(description: string) -> NutritionAnalysis {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a nutrition expert. Analyze the food described and provide
@@ -23,7 +23,7 @@ function EstimateNutrition(
   food_name: string,
   quantity: string?
 ) -> NutritionItem {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a nutrition expert. Estimate the nutrition for this food item.
diff --git a/packages/kal-baml/baml_src/functions/chat.baml b/packages/kal-baml/baml_src/functions/chat.baml
index 178126c..b6fb1fe 100644
--- a/packages/kal-baml/baml_src/functions/chat.baml
+++ b/packages/kal-baml/baml_src/functions/chat.baml
@@ -4,7 +4,7 @@
 
 // Simple chat completion
 function Chat(messages: ChatMessage[], system_prompt: string?) -> ChatResponse {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     {{ system_prompt | default("You are a helpful AI assistant. Always respond in English only.") }}
@@ -21,7 +21,7 @@ function Chat(messages: ChatMessage[], system_prompt: string?) -> ChatResponse {
 
 // Chat with structured response
 function StructuredChat(messages: ChatMessage[], system_prompt: string?, extract_sources: bool, suggest_followups: bool) -> StructuredChatResponse {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     {{ system_prompt | default("You are a helpful AI assistant. Always respond in English only.") }}
@@ -47,7 +47,7 @@ function StructuredChat(messages: ChatMessage[], system_prompt: string?, extract
 
 // Single-turn quick chat
 function QuickChat(user_message: string, system_prompt: string?) -> string {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     {{ system_prompt | default("You are a helpful AI assistant. Be concise and direct. Always respond in English only.") }}
diff --git a/packages/kal-baml/baml_src/functions/recipe.baml b/packages/kal-baml/baml_src/functions/recipe.baml
index a0df118..c6312a0 100644
--- a/packages/kal-baml/baml_src/functions/recipe.baml
+++ b/packages/kal-baml/baml_src/functions/recipe.baml
@@ -5,7 +5,7 @@
 
 // Parse a recipe text and extract ingredients
 function ParseRecipe(recipe_text: string) -> ParsedRecipe {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a recipe parser. Extract the recipe name and ingredients from the text.
@@ -33,7 +33,7 @@ function GenerateRecipe(
   preferences: string?,
   dietary_restrictions: string?
 ) -> ParsedRecipe {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a Malaysian cooking expert. Generate a simple, practical recipe.
@@ -62,7 +62,7 @@ function GenerateRecipe(
 
 // Extract food search terms from any text (improved version)
 function ExtractFoodSearchTerm(user_message: string) -> string {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a food search term extractor for a Malaysian nutrition database.
@@ -94,7 +94,7 @@ function ExtractFoodSearchTerm(user_message: string) -> string {
 // Normalize ingredient name for database search
 // This function cleans up recipe ingredient names to match database entries
 function NormalizeIngredientName(ingredient_name: string) -> string {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a food database search optimizer. Convert recipe ingredient names to simple, searchable food names that would match a nutrition database.
@@ -133,7 +133,7 @@ function SummarizeNutrition(
   ingredients_data: string,
   servings: int?
 ) -> NutritionSummary {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a nutrition calculator. Given ingredient nutrition data, calculate totals.
diff --git a/packages/kal-baml/baml_src/functions/stream-chat.baml b/packages/kal-baml/baml_src/functions/stream-chat.baml
new file mode 100644
index 0000000..97b4cb7
--- /dev/null
+++ b/packages/kal-baml/baml_src/functions/stream-chat.baml
@@ -0,0 +1,27 @@
+// ============================================
+// Streaming-optimized chat functions
+// Used for non-food general conversation queries
+// ============================================
+
+// General streaming chat for greetings, general questions, etc.
+function StreamChat(
+  user_message: string,
+  system_prompt: string?,
+  conversation_context: string?
+) -> string {
+  client Claude
+  prompt #"
+    {{ _.role("system") }}
+    {{ system_prompt | default("You are Kal, a friendly Malaysian food nutrition AI assistant. Always respond in English. Be concise and helpful. If the user asks about food nutrition, let them know you can look up accurate data from the Kalori database.") }}
+
+    {% if conversation_context %}
+    Recent conversation:
+    {{ conversation_context }}
+    {% endif %}
+
+    {{ _.role("user") }}
+    {{ user_message }}
+
+    {{ _.role("assistant") }}
+  "#
+}
diff --git a/packages/kal-baml/baml_src/functions/thinking.baml b/packages/kal-baml/baml_src/functions/thinking.baml
index 577ea94..529f6bb 100644
--- a/packages/kal-baml/baml_src/functions/thinking.baml
+++ b/packages/kal-baml/baml_src/functions/thinking.baml
@@ -8,20 +8,32 @@ function ClassifyIntent(
   user_message: string,
   conversation_context: string?
 ) -> IntentClassification {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are an intent classifier for a nutrition and food assistant app called Kalori.
     Analyze the user's message and classify their intent.
 
     Available intents:
-    - FoodQuery: User is asking about nutrition/calories of a specific food
-    - RecipeRequest: User wants a recipe or cooking instructions
-    - RecipeNutrition: User wants to know nutrition of a recipe they provided or we suggested
-    - GeneralChat: General conversation not about food
-    - Greeting: Simple hello/hi/thanks
+    - FoodQuery: User is asking about nutrition/calories of a specific food. This includes ANY mention of a food item even without explicit nutrition keywords (e.g. "nasi lemak", "tell me about roti canai", "what about ayam goreng").
+    - RecipeRequest: User wants a recipe or cooking instructions (e.g. "how to cook", "recipe for", "cara masak")
+    - RecipeNutrition: User wants to know nutrition of a recipe they provided or we suggested (e.g. "nutrition for this recipe", "calories of those ingredients")
+    - ApiHelp: User is asking about API endpoints, how to integrate Kalori data into their own app, API documentation, API keys, or developer-related questions (e.g. "give me the API endpoint", "how do I use the API", "I want to fetch nasi lemak data in my app", "API for food data", "how to get API key", "show me the docs")
+    - GeneralChat: General conversation not about food (e.g. "what can you do?", "tell me a joke")
+    - Greeting: Simple hello/hi/thanks/bye
     - Unknown: Cannot determine intent
 
+    IMPORTANT classification rules:
+    - If the message mentions ANY specific food name (Malaysian or international), classify as FoodQuery even without words like "calories" or "nutrition"
+    - EXCEPTION: If the message mentions food in the context of API/endpoint/integration (e.g. "API endpoint for nasi lemak", "fetch nasi lemak data"), classify as ApiHelp NOT FoodQuery
+    - Malaysian food names to watch for: nasi, mee, roti, ayam, ikan, daging, sayur, kuih, teh, kopi, milo, sambal, rendang, laksa, satay, char kuey teow, etc.
+    - Brand/restaurant names count as FoodQuery: Ramly, McD, KFC, Starbucks, Tealive, etc.
+    - "How healthy is X" or "is X good for diet" = FoodQuery
+    - "API endpoint for X" or "how to get X data in my app" = ApiHelp
+    - Set requires_api_lookup=true for ALL FoodQuery and RecipeNutrition intents
+    - Set requires_recipe_parse=true for RecipeRequest and RecipeNutrition intents
+    - Extract ALL food terms mentioned, even partial matches
+
     {% if conversation_context %}
     Recent conversation context:
     {{ conversation_context }}
@@ -41,7 +53,7 @@ function Think(
   context: string?,
   available_data: string?
 ) -> ThinkingResult {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     You are a thoughtful AI assistant. Think through the problem step by step.
@@ -64,14 +76,14 @@ function Think(
   "#
 }
 
-// Smart chat that uses conversation history
+// Smart chat that uses conversation history (kept for backward compatibility)
 function SmartChat(
   messages: ChatMessage[],
   system_prompt: string?,
   food_context: string?,
   thread_summary: string?
 ) -> string {
-  client GLM46
+  client Claude
   prompt #"
     {{ _.role("system") }}
     {{ system_prompt | default("You are Kal, a helpful AI nutrition assistant. Always respond in English only. Be friendly and helpful.") }}
diff --git a/packages/kal-baml/baml_src/types/chat.baml b/packages/kal-baml/baml_src/types/chat.baml
index f55b624..685a217 100644
--- a/packages/kal-baml/baml_src/types/chat.baml
+++ b/packages/kal-baml/baml_src/types/chat.baml
@@ -91,6 +91,7 @@ enum UserIntent {
   FoodQuery              // Asking about food nutrition
   RecipeRequest          // Asking for a recipe
   RecipeNutrition        // Asking about nutrition of a recipe
+  ApiHelp                // Asking about API endpoints, integration, or docs
   GeneralChat            // General conversation
   Greeting               // Simple greeting
   Unknown                // Unable to classify
diff --git a/packages/kal-baml/src/chat.ts b/packages/kal-baml/src/chat.ts
index cb0e7f3..060a2aa 100644
--- a/packages/kal-baml/src/chat.ts
+++ b/packages/kal-baml/src/chat.ts
@@ -1,4 +1,4 @@
-import { b } from '../baml_client/baml_client/index.js';
+import { b } from "../baml_client/baml_client/index.js";
 import {
   Role,
   UserIntent,
@@ -11,14 +11,14 @@ import {
   type ParsedRecipe,
   type IntentClassification,
   type ThinkingResult,
-} from '../baml_client/baml_client/types.js';
+} from "../baml_client/baml_client/types.js";
 
 // ============================================
 // Type Exports
 // ============================================
 
 export interface ChatInput {
-  messages: Array<{ role: 'User' | 'Assistant' | 'System'; content: string }>;
+  messages: Array<{ role: "User" | "Assistant" | "System"; content: string }>;
   systemPrompt?: string;
 }
 
@@ -29,7 +29,7 @@ export interface ChatResult {
 }
 
 export interface SmartChatInput {
-  messages: Array<{ role: 'User' | 'Assistant' | 'System'; content: string }>;
+  messages: Array<{ role: "User" | "Assistant" | "System"; content: string }>;
   systemPrompt?: string;
   foodContext?: string;
   threadSummary?: string;
@@ -39,10 +39,8 @@ export interface SmartChatInput {
 // Helper Functions
 // ============================================
 
-
-
 function toMessages(
-  messages: Array<{ role: 'User' | 'Assistant' | 'System'; content: string }>
+  messages: Array<{ role: "User" | "Assistant" | "System"; content: string }>
 ): ChatMessage[] {
   return messages.map((m) => ({
     role: m.role.toLowerCase(),
@@ -63,10 +61,10 @@ export async function chat(input: ChatInput): Promise<ChatResult> {
     const response = await b.Chat(messages, input.systemPrompt ?? null);
     return { success: true, data: response };
   } catch (error) {
-    console.error('[kal-baml] Chat error:', error);
+    console.error("[kal-baml] Chat error:", error);
     return {
       success: false,
-      error: error instanceof Error ? error.message : 'Unknown error',
+      error: error instanceof Error ? error.message : "Unknown error",
     };
   }
 }
@@ -121,12 +119,12 @@ export async function* streamQuickChat(
     const stream = b.stream.QuickChat(message, systemPrompt ?? null);
 
     for await (const chunk of stream) {
-      if (chunk && typeof chunk === 'string') {
+      if (chunk && typeof chunk === "string") {
         yield chunk;
       }
     }
   } catch (error) {
-    console.error('[kal-baml] Stream error:', error);
+    console.error("[kal-baml] Stream error:", error);
     throw error;
   }
 }
@@ -190,7 +188,7 @@ export async function extractFoodSearchTerm(message: string): Promise<string> {
     const term = await b.ExtractFoodSearchTerm(message);
     return term.trim().toLowerCase();
   } catch (error) {
-    console.error('[kal-baml] Extract food term error:', error);
+    console.error("[kal-baml] Extract food term error:", error);
     return message;
   }
 }
@@ -200,12 +198,14 @@ export async function extractFoodSearchTerm(message: string): Promise<string> {
  * Removes preparation words (patty, slice), cooking methods (fried, grilled),
  * and state words (fresh, frozen) while keeping brand names and core food identity
  */
-export async function normalizeIngredientName(ingredientName: string): Promise<string> {
+export async function normalizeIngredientName(
+  ingredientName: string
+): Promise<string> {
   try {
     const normalized = await b.NormalizeIngredientName(ingredientName);
     return normalized.trim().toLowerCase();
   } catch (error) {
-    console.error('[kal-baml] Normalize ingredient error:', error);
+    console.error("[kal-baml] Normalize ingredient error:", error);
     return ingredientName.toLowerCase();
   }
 }
@@ -248,6 +248,160 @@ export async function summarizeNutrition(
   );
 }
 
+// ============================================
+// Agent Workflow Functions (NEW)
+// ============================================
+
+/**
+ * Format a food response using ONLY database data.
+ * The prompt is strict: it will not hallucinate nutrition numbers.
+ */
+export async function formatFoodResponse(params: {
+  userMessage: string;
+  foodData: string;
+  hasDbResults: boolean;
+  conversationContext?: string;
+}): Promise<string> {
+  return await b.FormatFoodResponse(
+    params.userMessage,
+    params.foodData,
+    params.hasDbResults,
+    params.conversationContext ?? null
+  );
+}
+
+/**
+ * Stream a food response using ONLY database data.
+ * Yields partial strings as the AI generates them.
+ */
+export async function* streamFormatFoodResponse(params: {
+  userMessage: string;
+  foodData: string;
+  hasDbResults: boolean;
+  conversationContext?: string;
+}): AsyncGenerator<string, void, unknown> {
+  const stream = b.stream.FormatFoodResponse(
+    params.userMessage,
+    params.foodData,
+    params.hasDbResults,
+    params.conversationContext ?? null
+  );
+
+  for await (const chunk of stream) {
+    if (chunk && typeof chunk === "string") {
+      yield chunk;
+    }
+  }
+}
+
+/**
+ * Format a recipe response with optional ingredient nutrition from DB.
+ */
+export async function formatRecipeResponse(params: {
+  userMessage: string;
+  recipeData?: string;
+  ingredientNutrition?: string;
+  conversationContext?: string;
+}): Promise<string> {
+  return await b.FormatRecipeResponse(
+    params.userMessage,
+    params.recipeData ?? null,
+    params.ingredientNutrition ?? null,
+    params.conversationContext ?? null
+  );
+}
+
+/**
+ * Stream a recipe response with optional ingredient nutrition from DB.
+ */
+export async function* streamFormatRecipeResponse(params: {
+  userMessage: string;
+  recipeData?: string;
+  ingredientNutrition?: string;
+  conversationContext?: string;
+}): AsyncGenerator<string, void, unknown> {
+  const stream = b.stream.FormatRecipeResponse(
+    params.userMessage,
+    params.recipeData ?? null,
+    params.ingredientNutrition ?? null,
+    params.conversationContext ?? null
+  );
+
+  for await (const chunk of stream) {
+    if (chunk && typeof chunk === "string") {
+      yield chunk;
+    }
+  }
+}
+
+/**
+ * Stream a general chat response (non-food queries).
+ */
+export async function* streamGeneralChat(params: {
+  userMessage: string;
+  systemPrompt?: string;
+  conversationContext?: string;
+}): AsyncGenerator<string, void, unknown> {
+  const stream = b.stream.StreamChat(
+    params.userMessage,
+    params.systemPrompt ?? null,
+    params.conversationContext ?? null
+  );
+
+  for await (const chunk of stream) {
+    if (chunk && typeof chunk === "string") {
+      yield chunk;
+    }
+  }
+}
+
+/**
+ * Non-streaming general chat response (non-food queries).
+ */
+export async function generalChat(params: {
+  userMessage: string;
+  systemPrompt?: string;
+  conversationContext?: string;
+}): Promise<string> {
+  return await b.StreamChat(
+    params.userMessage,
+    params.systemPrompt ?? null,
+    params.conversationContext ?? null
+  );
+}
+
+/**
+ * Format an API help response with full Kalori API reference.
+ */
+export async function formatApiHelpResponse(params: {
+  userMessage: string;
+  conversationContext?: string;
+}): Promise<string> {
+  return await b.FormatApiHelpResponse(
+    params.userMessage,
+    params.conversationContext ?? null
+  );
+}
+
+/**
+ * Stream an API help response with full Kalori API reference.
+ */
+export async function* streamFormatApiHelpResponse(params: {
+  userMessage: string;
+  conversationContext?: string;
+}): AsyncGenerator<string, void, unknown> {
+  const stream = b.stream.FormatApiHelpResponse(
+    params.userMessage,
+    params.conversationContext ?? null
+  );
+
+  for await (const chunk of stream) {
+    if (chunk && typeof chunk === "string") {
+      yield chunk;
+    }
+  }
+}
+
 // ============================================
 // Re-export types and enums
 // ============================================
diff --git a/packages/kal-baml/src/index.ts b/packages/kal-baml/src/index.ts
index b1c59d8..36aa64c 100644
--- a/packages/kal-baml/src/index.ts
+++ b/packages/kal-baml/src/index.ts
@@ -1,5 +1,5 @@
 // Re-export all BAML generated types and functions
-export * from '../baml_client/baml_client/index.js';
+export * from "../baml_client/baml_client/index.js";
 
 // Export convenience wrapper functions
 export {
@@ -9,6 +9,15 @@ export {
   smartChat,
   streamQuickChat,
   structuredChat,
+  // Agent workflow (NEW)
+  formatFoodResponse,
+  streamFormatFoodResponse,
+  formatRecipeResponse,
+  streamFormatRecipeResponse,
+  streamGeneralChat,
+  generalChat,
+  formatApiHelpResponse,
+  streamFormatApiHelpResponse,
   // Thinking & Intent
   classifyIntent,
   think,
@@ -24,7 +33,7 @@ export {
   // Enums
   Role,
   UserIntent,
-} from './chat.js';
+} from "./chat.js";
 
 // Export types
 export type {
@@ -40,4 +49,4 @@ export type {
   ParsedRecipe,
   IntentClassification,
   ThinkingResult,
-} from './chat.js';
+} from "./chat.js";
diff --git a/packages/kal-frontend/package.json b/packages/kal-frontend/package.json
index f1cb9dd..62c9655 100644
--- a/packages/kal-frontend/package.json
+++ b/packages/kal-frontend/package.json
@@ -21,7 +21,9 @@
     "react": "^19.0.0",
     "react-chartjs-2": "^5.3.1",
     "react-dom": "^19.0.0",
-    "react-feather": "^2.0.10"
+    "react-feather": "^2.0.10",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
diff --git a/packages/kal-frontend/src/app/globals.css b/packages/kal-frontend/src/app/globals.css
index 852f4a3..5fde71c 100644
--- a/packages/kal-frontend/src/app/globals.css
+++ b/packages/kal-frontend/src/app/globals.css
@@ -16,6 +16,27 @@
 
 * {
   box-sizing: border-box;
+  /* Seamless dark scrollbar everywhere */
+  scrollbar-width: thin;
+  scrollbar-color: var(--border-color) transparent;
+}
+
+*::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+
+*::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+*::-webkit-scrollbar-thumb {
+  background: var(--border-color);
+  border-radius: 9999px;
+}
+
+*::-webkit-scrollbar-thumb:hover {
+  background: var(--text-muted);
 }
 
 body {
@@ -669,8 +690,60 @@ html {
   display: none;
 }
 .scrollbar-hide {
-  -ms-overflow-style: none;  /* IE and Edge */
-  scrollbar-width: none;  /* Firefox */
+  -ms-overflow-style: none; /* IE and Edge */
+  scrollbar-width: none; /* Firefox */
+}
+
+/* Thin seamless scrollbar for chat widget */
+.chat-scrollbar {
+  scrollbar-width: thin; /* Firefox */
+  scrollbar-color: var(--border-color) transparent;
+}
+.chat-scrollbar::-webkit-scrollbar {
+  width: 4px;
+}
+.chat-scrollbar::-webkit-scrollbar-track {
+  background: transparent;
+}
+.chat-scrollbar::-webkit-scrollbar-thumb {
+  background: var(--border-color);
+  border-radius: 9999px;
+}
+.chat-scrollbar::-webkit-scrollbar-thumb:hover {
+  background: var(--text-muted);
+}
+
+/* Gradient green chat icon */
+.chat-gradient-icon svg {
+  stroke: url(#chat-icon-gradient);
+}
+
+/* Chat markdown — list styling */
+.chat-md-ul {
+  list-style: none;
+}
+.chat-md-ul > .chat-md-li::before {
+  content: "•";
+  color: var(--accent-green);
+  font-weight: bold;
+  display: inline-block;
+  width: 1em;
+  margin-left: -0.25em;
+}
+.chat-md-ol {
+  list-style: decimal;
+  list-style-position: inside;
+}
+.chat-md-ol > .chat-md-li::marker {
+  color: var(--text-muted);
+}
+
+/* Chat markdown — remove spacing from last child in nested contexts */
+.chat-markdown > :first-child {
+  margin-top: 0;
+}
+.chat-markdown > :last-child {
+  margin-bottom: 0;
 }
 
 /* ============================================
@@ -764,7 +837,9 @@ html {
   padding: 0.25rem;
   margin: -0.25rem;
   border-radius: 0.25rem;
-  transition: color 0.2s, background-color 0.2s;
+  transition:
+    color 0.2s,
+    background-color 0.2s;
 }
 
 .toast-close:hover {
@@ -875,7 +950,7 @@ html {
     right: 1rem;
     width: auto;
   }
-  
+
   .toast {
     padding: 0.875rem;
   }
@@ -894,7 +969,7 @@ html {
   --grid-min-md: 280px;
   --grid-min-lg: 320px;
   --grid-min-xl: 400px;
-  
+
   /* Responsive max-widths */
   --container-lg: 1024px;
   --container-xl: 1280px;
diff --git a/packages/kal-frontend/src/app/layout.tsx b/packages/kal-frontend/src/app/layout.tsx
index 0cb1aca..6f41bc6 100644
--- a/packages/kal-frontend/src/app/layout.tsx
+++ b/packages/kal-frontend/src/app/layout.tsx
@@ -2,7 +2,9 @@ import type { Metadata } from "next";
 import { Inter } from "next/font/google";
 
 import "./globals.css";
+import { ChatWidget } from "@/components/chat/ChatWidget";
 import { ToastContainer } from "@/components/ui/Toast";
+import { ChatPanelProvider } from "@/contexts/ChatPanelContext";
 import { ToastProvider } from "@/contexts/ToastContext";
 import { AuthProvider } from "@/lib/auth-context";
 import { TRPCProvider } from "@/lib/trpc-provider";
@@ -82,7 +84,18 @@ export default function RootLayout({
       <body className={inter.className}>
         <ToastProvider>
           <AuthProvider logtoId={null}>
-            <TRPCProvider>{children}</TRPCProvider>
+            <TRPCProvider>
+              <ChatPanelProvider>
+                <div className="flex h-screen overflow-hidden">
+                  {/* Main content — scrollable, takes remaining space */}
+                  <div className="flex-1 min-w-0 overflow-y-auto">
+                    {children}
+                  </div>
+                  {/* Right side: activity bar + chat panel (auth-gated internally) */}
+                  <ChatWidget />
+                </div>
+              </ChatPanelProvider>
+            </TRPCProvider>
           </AuthProvider>
           <ToastContainer />
         </ToastProvider>
@@ -90,4 +103,3 @@ export default function RootLayout({
     </html>
   );
 }
-
diff --git a/packages/kal-frontend/src/components/chat/ChatActivityBar.tsx b/packages/kal-frontend/src/components/chat/ChatActivityBar.tsx
new file mode 100644
index 0000000..93b9e32
--- /dev/null
+++ b/packages/kal-frontend/src/components/chat/ChatActivityBar.tsx
@@ -0,0 +1,68 @@
+"use client";
+
+import { MessageCircle } from "react-feather";
+
+import { useChatPanel } from "@/contexts/ChatPanelContext";
+import { useAuth } from "@/lib/auth-context";
+
+/**
+ * Thin right-side activity bar with a chat icon.
+ * Always visible on desktop for authenticated users.
+ * Hidden on mobile (mobile uses a FAB instead).
+ */
+export function ChatActivityBar() {
+  const { logtoId } = useAuth();
+  const { isOpen, toggle } = useChatPanel();
+
+  // Only show for authenticated users
+  if (!logtoId) return null;
+
+  return (
+    <div
+      className={[
+        "hidden sm:flex flex-col items-center",
+        "w-12 shrink-0",
+        "bg-dark-surface border-l border-dark-border",
+        "py-4",
+      ].join(" ")}
+    >
+      <button
+        onClick={toggle}
+        className={[
+          "w-9 h-9 rounded-lg",
+          "flex items-center justify-center",
+          "transition-all duration-150",
+          "focus:outline-none focus-visible:ring-2 focus-visible:ring-accent",
+          isOpen ? "bg-accent/15" : "hover:bg-dark-elevated",
+        ].join(" ")}
+        aria-label={isOpen ? "Close chat" : "Open chat"}
+        title={isOpen ? "Close chat" : "Open chat"}
+      >
+        {/* SVG gradient definition for the icon stroke */}
+        <svg width="0" height="0" className="absolute">
+          <defs>
+            <linearGradient
+              id="chat-icon-gradient"
+              x1="0%"
+              y1="0%"
+              x2="100%"
+              y2="100%"
+            >
+              <stop offset="0%" stopColor="#10b981" />
+              <stop offset="100%" stopColor="#34d399" />
+            </linearGradient>
+          </defs>
+        </svg>
+        <span
+          className={[
+            "chat-gradient-icon",
+            isOpen ? "opacity-100" : "opacity-60 hover:opacity-100",
+            "transition-opacity duration-150",
+          ].join(" ")}
+        >
+          <MessageCircle size={20} />
+        </span>
+      </button>
+    </div>
+  );
+}
diff --git a/packages/kal-frontend/src/components/chat/ChatMessage.tsx b/packages/kal-frontend/src/components/chat/ChatMessage.tsx
new file mode 100644
index 0000000..1639861
--- /dev/null
+++ b/packages/kal-frontend/src/components/chat/ChatMessage.tsx
@@ -0,0 +1,332 @@
+"use client";
+
+import {
+  memo,
+  useState,
+  useCallback,
+  type ComponentPropsWithoutRef,
+} from "react";
+import { User, Copy, Check } from "react-feather";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+
+interface ChatMessageProps {
+  role: "User" | "Assistant";
+  content: string;
+  createdAt?: Date;
+  /** When true, shows a blinking cursor after the content (streaming in progress) */
+  streaming?: boolean;
+}
+
+function formatTime(date: Date): string {
+  return new Date(date).toLocaleTimeString([], {
+    hour: "2-digit",
+    minute: "2-digit",
+  });
+}
+
+/** Small copy button for code blocks */
+function CopyButton({ text }: { text: string }) {
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = useCallback(() => {
+    navigator.clipboard.writeText(text).then(() => {
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    });
+  }, [text]);
+
+  return (
+    <button
+      onClick={handleCopy}
+      className="absolute top-2 right-2 p-1 rounded bg-dark-elevated/80 hover:bg-dark-border text-content-muted hover:text-content-primary transition-colors opacity-0 group-hover:opacity-100"
+      title="Copy code"
+    >
+      {copied ? (
+        <Check size={12} className="text-accent" />
+      ) : (
+        <Copy size={12} />
+      )}
+    </button>
+  );
+}
+
+/** Custom component overrides for ReactMarkdown — dark theme styling */
+const markdownComponents = {
+  // Headings
+  h1: ({ children, ...props }: ComponentPropsWithoutRef<"h1">) => (
+    <h1
+      className="text-base font-bold text-content-primary mt-3 mb-1.5"
+      {...props}
+    >
+      {children}
+    </h1>
+  ),
+  h2: ({ children, ...props }: ComponentPropsWithoutRef<"h2">) => (
+    <h2 className="text-sm font-bold text-content-primary mt-3 mb-1" {...props}>
+      {children}
+    </h2>
+  ),
+  h3: ({ children, ...props }: ComponentPropsWithoutRef<"h3">) => (
+    <h3
+      className="text-sm font-semibold text-content-primary mt-2 mb-1"
+      {...props}
+    >
+      {children}
+    </h3>
+  ),
+  h4: ({ children, ...props }: ComponentPropsWithoutRef<"h4">) => (
+    <h4
+      className="text-sm font-semibold text-content-secondary mt-2 mb-0.5"
+      {...props}
+    >
+      {children}
+    </h4>
+  ),
+
+  // Paragraphs
+  p: ({ children, ...props }: ComponentPropsWithoutRef<"p">) => (
+    <p className="mb-2 last:mb-0 leading-relaxed" {...props}>
+      {children}
+    </p>
+  ),
+
+  // Strong / emphasis
+  strong: ({ children, ...props }: ComponentPropsWithoutRef<"strong">) => (
+    <strong className="font-semibold text-content-primary" {...props}>
+      {children}
+    </strong>
+  ),
+  em: ({ children, ...props }: ComponentPropsWithoutRef<"em">) => (
+    <em className="italic text-content-secondary" {...props}>
+      {children}
+    </em>
+  ),
+
+  // Links
+  a: ({ children, href, ...props }: ComponentPropsWithoutRef<"a">) => (
+    <a
+      href={href}
+      target="_blank"
+      rel="noopener noreferrer"
+      className="text-accent hover:text-accent-hover underline underline-offset-2 transition-colors"
+      {...props}
+    >
+      {children}
+    </a>
+  ),
+
+  // Lists
+  ul: ({ children, ...props }: ComponentPropsWithoutRef<"ul">) => (
+    <ul className="mb-2 last:mb-0 space-y-0.5 ml-1 chat-md-ul" {...props}>
+      {children}
+    </ul>
+  ),
+  ol: ({ children, ...props }: ComponentPropsWithoutRef<"ol">) => (
+    <ol className="mb-2 last:mb-0 space-y-0.5 ml-1 chat-md-ol" {...props}>
+      {children}
+    </ol>
+  ),
+  li: ({ children, ...props }: ComponentPropsWithoutRef<"li">) => (
+    <li className="chat-md-li pl-1" {...props}>
+      {children}
+    </li>
+  ),
+
+  // Horizontal rule
+  hr: (props: ComponentPropsWithoutRef<"hr">) => (
+    <hr className="border-dark-border my-3" {...props} />
+  ),
+
+  // Code — inline and block
+  code: ({
+    children,
+    className,
+    ...props
+  }: ComponentPropsWithoutRef<"code">) => {
+    const isBlock = className?.includes("language-");
+
+    // Inline code
+    if (!isBlock) {
+      return (
+        <code
+          className="bg-dark/60 border border-dark-border px-1.5 py-0.5 rounded text-[12px] font-mono text-accent"
+          {...props}
+        >
+          {children}
+        </code>
+      );
+    }
+
+    // Block code — rendered inside <pre> by ReactMarkdown
+    return (
+      <code
+        className={`text-[12px] font-mono leading-relaxed ${className ?? ""}`}
+        {...props}
+      >
+        {children}
+      </code>
+    );
+  },
+  pre: ({ children, ...props }: ComponentPropsWithoutRef<"pre">) => {
+    // Extract text content for the copy button
+    const text = extractText(children);
+
+    return (
+      <div className="relative group my-2">
+        <pre
+          className="bg-[#0a0a0a] border border-dark-border rounded-lg px-3 py-2.5 overflow-x-auto text-content-secondary chat-scrollbar"
+          {...props}
+        >
+          {children}
+        </pre>
+        <CopyButton text={text} />
+      </div>
+    );
+  },
+
+  // Block quotes
+  blockquote: ({
+    children,
+    ...props
+  }: ComponentPropsWithoutRef<"blockquote">) => (
+    <blockquote
+      className="border-l-2 border-accent/40 pl-3 my-2 text-content-secondary italic"
+      {...props}
+    >
+      {children}
+    </blockquote>
+  ),
+
+  // Tables
+  table: ({ children, ...props }: ComponentPropsWithoutRef<"table">) => (
+    <div className="my-2 overflow-x-auto chat-scrollbar rounded-lg border border-dark-border">
+      <table className="w-full text-[12px]" {...props}>
+        {children}
+      </table>
+    </div>
+  ),
+  thead: ({ children, ...props }: ComponentPropsWithoutRef<"thead">) => (
+    <thead className="bg-dark-elevated" {...props}>
+      {children}
+    </thead>
+  ),
+  tbody: ({ children, ...props }: ComponentPropsWithoutRef<"tbody">) => (
+    <tbody className="divide-y divide-dark-border" {...props}>
+      {children}
+    </tbody>
+  ),
+  tr: ({ children, ...props }: ComponentPropsWithoutRef<"tr">) => (
+    <tr className="hover:bg-dark-elevated/50 transition-colors" {...props}>
+      {children}
+    </tr>
+  ),
+  th: ({ children, ...props }: ComponentPropsWithoutRef<"th">) => (
+    <th
+      className="px-2.5 py-1.5 text-left font-semibold text-content-primary border-b border-dark-border"
+      {...props}
+    >
+      {children}
+    </th>
+  ),
+  td: ({ children, ...props }: ComponentPropsWithoutRef<"td">) => (
+    <td className="px-2.5 py-1.5 text-content-secondary" {...props}>
+      {children}
+    </td>
+  ),
+};
+
+/** Recursively extract text content from React children (for copy button) */
+function extractText(node: React.ReactNode): string {
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  if (!node) return "";
+  if (Array.isArray(node)) return node.map(extractText).join("");
+  if (typeof node === "object" && "props" in node) {
+    return extractText(
+      (node as { props: { children?: React.ReactNode } }).props.children
+    );
+  }
+  return "";
+}
+
+export const ChatMessage = memo(function ChatMessage({
+  role,
+  content,
+  createdAt,
+  streaming,
+}: ChatMessageProps) {
+  const isUser = role === "User";
+
+  return (
+    <div className={`flex gap-2.5 ${isUser ? "flex-row-reverse" : "flex-row"}`}>
+      {/* Avatar */}
+      <div
+        className={`shrink-0 w-7 h-7 rounded-full flex items-center justify-center text-xs mt-0.5 ${
+          isUser
+            ? "bg-accent text-dark"
+            : "bg-dark-elevated border border-dark-border text-accent"
+        }`}
+      >
+        {isUser ? (
+          <User size={14} />
+        ) : (
+          <span className="font-bold text-[11px]">K</span>
+        )}
+      </div>
+
+      {/* Bubble */}
+      <div
+        className={`max-w-[85%] rounded-2xl px-3.5 py-2.5 text-sm leading-relaxed ${
+          isUser
+            ? "bg-accent text-dark rounded-tr-md"
+            : "bg-dark-elevated border border-dark-border text-content-primary rounded-tl-md"
+        }`}
+      >
+        {isUser ? (
+          content
+        ) : (
+          <div className="chat-markdown">
+            <ReactMarkdown
+              remarkPlugins={[remarkGfm]}
+              components={markdownComponents}
+            >
+              {content}
+            </ReactMarkdown>
+          </div>
+        )}
+        {streaming && (
+          <span className="inline-block w-1.5 h-4 ml-0.5 bg-accent/70 animate-pulse rounded-sm align-text-bottom" />
+        )}
+
+        {createdAt && !streaming && (
+          <div
+            className={`text-[10px] mt-1.5 ${
+              isUser ? "text-dark/50" : "text-content-muted"
+            }`}
+          >
+            {formatTime(createdAt)}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+});
+
+/** Animated typing indicator shown while waiting for AI response. */
+export function TypingIndicator() {
+  return (
+    <div className="flex gap-2.5">
+      <div className="shrink-0 w-7 h-7 rounded-full flex items-center justify-center bg-dark-elevated border border-dark-border text-accent mt-0.5">
+        <span className="font-bold text-[11px]">K</span>
+      </div>
+      <div className="bg-dark-elevated border border-dark-border rounded-2xl rounded-tl-md px-4 py-3">
+        <div className="flex gap-1">
+          <span className="w-1.5 h-1.5 bg-content-muted rounded-full animate-bounce [animation-delay:0ms]" />
+          <span className="w-1.5 h-1.5 bg-content-muted rounded-full animate-bounce [animation-delay:150ms]" />
+          <span className="w-1.5 h-1.5 bg-content-muted rounded-full animate-bounce [animation-delay:300ms]" />
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/packages/kal-frontend/src/components/chat/ChatPanel.tsx b/packages/kal-frontend/src/components/chat/ChatPanel.tsx
new file mode 100644
index 0000000..201aff1
--- /dev/null
+++ b/packages/kal-frontend/src/components/chat/ChatPanel.tsx
@@ -0,0 +1,487 @@
+"use client";
+
+import {
+  useState,
+  useMemo,
+  useRef,
+  useCallback,
+  useLayoutEffect,
+  type FormEvent,
+  type KeyboardEvent,
+} from "react";
+import {
+  Send,
+  ChevronRight,
+  Plus,
+  Trash2,
+  ChevronLeft,
+  Menu,
+  MessageCircle,
+} from "react-feather";
+
+import { ChatMessage } from "./ChatMessage";
+import { ToolStepIndicator, type ToolStep } from "./ToolStepIndicator";
+
+import { useToast } from "@/contexts/ToastContext";
+import { useAuth } from "@/lib/auth-context";
+import { sendChatStream } from "@/lib/chat-stream";
+import { trpc } from "@/lib/trpc";
+
+interface Message {
+  _id: string;
+  role: "User" | "Assistant";
+  content: string;
+  createdAt: Date;
+  streaming?: boolean;
+}
+
+interface ChatPanelProps {
+  onClose: () => void;
+}
+
+export function ChatPanel({ onClose }: ChatPanelProps) {
+  const [activeThreadId, setActiveThreadId] = useState<string | null>(null);
+  const [optimisticMessages, setOptimisticMessages] = useState<Message[]>([]);
+  const [streamingContent, setStreamingContent] = useState("");
+  const [toolSteps, setToolSteps] = useState<ToolStep[]>([]);
+  const [isSending, setIsSending] = useState(false);
+  const [input, setInput] = useState("");
+  const [showThreadList, setShowThreadList] = useState(false);
+
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+  const inputRef = useRef<HTMLTextAreaElement>(null);
+  const abortRef = useRef<AbortController | null>(null);
+  const toast = useToast();
+  const auth = useAuth();
+
+  // ---- tRPC hooks (threads + messages CRUD, no more sendMessage) ----
+  const threadsQuery = trpc.chat.getThreads.useQuery(
+    { limit: 20 },
+    { enabled: true }
+  );
+
+  const messagesQuery = trpc.chat.getMessages.useQuery(
+    { threadId: activeThreadId ?? "", limit: 50 },
+    {
+      enabled: !!activeThreadId,
+      refetchOnWindowFocus: false,
+    }
+  );
+
+  const createThread = trpc.chat.createThread.useMutation({
+    onSuccess: (thread) => {
+      setActiveThreadId(thread._id);
+      setShowThreadList(false);
+      threadsQuery.refetch();
+    },
+    onError: () => {
+      toast.error("Failed to create conversation");
+    },
+  });
+
+  const deleteThread = trpc.chat.deleteThread.useMutation({
+    onSuccess: () => {
+      if (activeThreadId) {
+        setActiveThreadId(null);
+      }
+      threadsQuery.refetch();
+    },
+    onError: () => {
+      toast.error("Failed to delete conversation");
+    },
+  });
+
+  // Derive displayed messages: server data + optimistic overlay + streaming
+  const displayMessages = useMemo<Message[]>(() => {
+    const serverMessages: Message[] = (messagesQuery.data ?? []).map((m) => ({
+      _id: m._id,
+      role: m.role,
+      content: m.content,
+      createdAt: new Date(m.createdAt),
+    }));
+
+    const messages = [...serverMessages, ...optimisticMessages];
+
+    // If we're streaming, append the in-progress assistant message
+    if (streamingContent) {
+      messages.push({
+        _id: "streaming",
+        role: "Assistant",
+        content: streamingContent,
+        createdAt: new Date(),
+        streaming: true,
+      });
+    }
+
+    return messages;
+  }, [messagesQuery.data, optimisticMessages, streamingContent]);
+
+  // Auto-scroll to bottom when messages change or streaming updates
+  useLayoutEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
+  }, [displayMessages, toolSteps]);
+
+  // Auto-load the most recent thread on mount
+  const hasAutoLoaded = useRef(false);
+  if (threadsQuery.data && !hasAutoLoaded.current && !activeThreadId) {
+    hasAutoLoaded.current = true;
+    if (threadsQuery.data.length > 0) {
+      setActiveThreadId(threadsQuery.data[0]._id);
+    }
+  }
+
+  // ---- SSE send handler ----
+  const startStream = useCallback(
+    (threadId: string, content: string) => {
+      if (!auth.logtoId) {
+        toast.error("Not authenticated");
+        return;
+      }
+
+      setIsSending(true);
+      setToolSteps([]);
+      setStreamingContent("");
+
+      // Show optimistic user message
+      setOptimisticMessages([
+        {
+          _id: `optimistic-${Date.now()}`,
+          role: "User",
+          content,
+          createdAt: new Date(),
+        },
+      ]);
+
+      const controller = sendChatStream(
+        {
+          threadId,
+          content,
+          logtoId: auth.logtoId,
+          email: auth.email,
+          name: auth.name,
+        },
+        {
+          onToolStart: (tool, message) => {
+            setToolSteps((prev) => [
+              ...prev,
+              { tool, message, status: "running" },
+            ]);
+          },
+          onToolEnd: (tool, message) => {
+            setToolSteps((prev) =>
+              prev.map((s) =>
+                s.tool === tool && s.status === "running"
+                  ? { ...s, message, status: "done" }
+                  : s
+              )
+            );
+          },
+          onStreamStart: () => {
+            // Clear tool steps for generate_response since we're now streaming
+            setToolSteps((prev) =>
+              prev.filter((s) => s.tool !== "generate_response")
+            );
+          },
+          onStreamDelta: (delta) => {
+            setStreamingContent((prev) => prev + delta);
+          },
+          onStreamEnd: () => {
+            // Streaming complete — refetch real messages from server
+            setStreamingContent("");
+            setOptimisticMessages([]);
+            setToolSteps([]);
+            setIsSending(false);
+            messagesQuery.refetch();
+            threadsQuery.refetch();
+          },
+          onError: (message) => {
+            toast.error(message || "Failed to send message");
+            setStreamingContent("");
+            setOptimisticMessages([]);
+            setToolSteps([]);
+            setIsSending(false);
+          },
+          onDone: () => {
+            // Final cleanup in case onStreamEnd didn't fire
+            setIsSending(false);
+          },
+        }
+      );
+
+      abortRef.current = controller;
+    },
+    [auth.logtoId, auth.email, auth.name, toast, messagesQuery, threadsQuery]
+  );
+
+  const handleSend = useCallback(
+    (e?: FormEvent) => {
+      e?.preventDefault();
+      const trimmed = input.trim();
+      if (!trimmed || isSending) return;
+
+      setInput("");
+
+      if (activeThreadId) {
+        startStream(activeThreadId, trimmed);
+      } else {
+        // Auto-create thread on first message
+        createThread.mutate(undefined, {
+          onSuccess: (thread) => {
+            startStream(thread._id, trimmed);
+          },
+        });
+      }
+    },
+    [input, activeThreadId, isSending, startStream, createThread]
+  );
+
+  const handleKeyDown = useCallback(
+    (e: KeyboardEvent<HTMLTextAreaElement>) => {
+      if (e.key === "Enter" && !e.shiftKey) {
+        e.preventDefault();
+        handleSend();
+      }
+    },
+    [handleSend]
+  );
+
+  const handleNewChat = useCallback(() => {
+    // Abort any in-progress stream
+    abortRef.current?.abort();
+    setStreamingContent("");
+    setOptimisticMessages([]);
+    setToolSteps([]);
+    setIsSending(false);
+    createThread.mutate();
+  }, [createThread]);
+
+  const handleSelectThread = useCallback((threadId: string) => {
+    abortRef.current?.abort();
+    setActiveThreadId(threadId);
+    setOptimisticMessages([]);
+    setStreamingContent("");
+    setToolSteps([]);
+    setIsSending(false);
+    setShowThreadList(false);
+  }, []);
+
+  const handleDeleteThread = useCallback(
+    (threadId: string) => {
+      deleteThread.mutate({ threadId });
+    },
+    [deleteThread]
+  );
+
+  // ---- Thread list view ----
+  if (showThreadList) {
+    return (
+      <div className="flex flex-col h-full">
+        {/* Header */}
+        <div className="flex items-center justify-between px-4 py-3 border-b border-dark-border shrink-0">
+          <button
+            onClick={() => setShowThreadList(false)}
+            className="p-1.5 rounded-lg hover:bg-dark-elevated text-content-secondary hover:text-content-primary transition-colors"
+          >
+            <ChevronLeft size={18} />
+          </button>
+          <h3 className="text-sm font-semibold text-content-primary">
+            Conversations
+          </h3>
+          <button
+            onClick={handleNewChat}
+            className="p-1.5 rounded-lg hover:bg-dark-elevated text-accent transition-colors"
+            title="New chat"
+          >
+            <Plus size={18} />
+          </button>
+        </div>
+
+        {/* Thread list */}
+        <div className="flex-1 overflow-y-auto chat-scrollbar">
+          {threadsQuery.isLoading && (
+            <div className="p-4 text-center text-content-muted text-sm">
+              Loading...
+            </div>
+          )}
+          {threadsQuery.data?.length === 0 && (
+            <div className="p-6 text-center text-content-muted text-sm">
+              No conversations yet.
+              <br />
+              Start a new chat!
+            </div>
+          )}
+          {threadsQuery.data?.map((thread) => (
+            <div
+              key={thread._id}
+              className={`flex items-center gap-2 px-4 py-3 border-b border-dark-border/50 cursor-pointer hover:bg-dark-elevated transition-colors group ${
+                thread._id === activeThreadId ? "bg-dark-elevated" : ""
+              }`}
+            >
+              <button
+                onClick={() => handleSelectThread(thread._id)}
+                className="flex-1 text-left min-w-0"
+              >
+                <div className="text-sm text-content-primary truncate">
+                  {thread.title}
+                </div>
+                {thread.lastMessage && (
+                  <div className="text-xs text-content-muted truncate mt-0.5">
+                    {thread.lastMessage}
+                  </div>
+                )}
+              </button>
+              <button
+                onClick={(e) => {
+                  e.stopPropagation();
+                  handleDeleteThread(thread._id);
+                }}
+                className="p-1 rounded opacity-0 group-hover:opacity-100 hover:bg-dark-surface text-content-muted hover:text-red-400 transition-all"
+                title="Delete"
+              >
+                <Trash2 size={14} />
+              </button>
+            </div>
+          ))}
+        </div>
+      </div>
+    );
+  }
+
+  // ---- Main chat view ----
+  return (
+    <div className="flex flex-col h-full">
+      {/* Header */}
+      <div className="flex items-center justify-between px-4 py-3 border-b border-dark-border shrink-0">
+        <div className="flex items-center gap-2">
+          <button
+            onClick={() => setShowThreadList(true)}
+            className="p-1.5 rounded-lg hover:bg-dark-elevated text-content-secondary hover:text-content-primary transition-colors"
+            title="Conversations"
+          >
+            <Menu size={16} />
+          </button>
+          <div>
+            <h3 className="text-sm font-semibold text-content-primary">
+              Kal Assistant
+            </h3>
+            <p className="text-[10px] text-content-muted leading-tight">
+              Malaysian food nutrition AI
+            </p>
+          </div>
+        </div>
+        <div className="flex items-center gap-1">
+          <button
+            onClick={handleNewChat}
+            className="p-1.5 rounded-lg hover:bg-dark-elevated text-content-secondary hover:text-accent transition-colors"
+            title="New chat"
+          >
+            <Plus size={16} />
+          </button>
+          <button
+            onClick={onClose}
+            className="p-1.5 rounded-lg hover:bg-dark-elevated text-content-secondary hover:text-content-primary transition-colors"
+            title="Close panel"
+          >
+            <ChevronRight size={16} />
+          </button>
+        </div>
+      </div>
+
+      {/* Messages */}
+      <div className="flex-1 overflow-y-auto px-4 py-4 space-y-4 chat-scrollbar">
+        {/* Loading state */}
+        {messagesQuery.isLoading && activeThreadId && (
+          <div className="flex items-center justify-center py-8">
+            <div className="w-5 h-5 border-2 border-accent border-t-transparent rounded-full animate-spin" />
+          </div>
+        )}
+
+        {/* Empty state */}
+        {displayMessages.length === 0 &&
+          !messagesQuery.isLoading &&
+          !isSending && (
+            <div className="flex flex-col items-center justify-center h-full text-center px-4">
+              <div className="w-12 h-12 rounded-full bg-accent/10 flex items-center justify-center mb-3">
+                <MessageCircle size={24} className="text-accent" />
+              </div>
+              <h4 className="text-sm font-semibold text-content-primary mb-1">
+                Ask me anything!
+              </h4>
+              <p className="text-xs text-content-muted max-w-[200px]">
+                I can help with Malaysian food nutrition, calories, recipes, and
+                healthy eating tips.
+              </p>
+              <div className="flex flex-wrap gap-1.5 mt-4 justify-center">
+                {[
+                  "Calories in nasi lemak?",
+                  "Healthy roti canai recipe",
+                  "Protein in ayam goreng",
+                ].map((suggestion) => (
+                  <button
+                    key={suggestion}
+                    onClick={() => {
+                      setInput(suggestion);
+                      inputRef.current?.focus();
+                    }}
+                    className="text-[11px] px-2.5 py-1.5 rounded-full border border-dark-border text-content-secondary hover:border-accent hover:text-accent transition-colors"
+                  >
+                    {suggestion}
+                  </button>
+                ))}
+              </div>
+            </div>
+          )}
+
+        {/* Message bubbles */}
+        {displayMessages.map((msg) => (
+          <ChatMessage
+            key={msg._id}
+            role={msg.role}
+            content={msg.content}
+            createdAt={msg.createdAt}
+            streaming={msg.streaming}
+          />
+        ))}
+
+        {/* Tool step indicators (shown while workflow is running) */}
+        {toolSteps.length > 0 && !streamingContent && (
+          <ToolStepIndicator steps={toolSteps} />
+        )}
+
+        <div ref={messagesEndRef} />
+      </div>
+
+      {/* Input */}
+      <form
+        onSubmit={handleSend}
+        className="px-3 py-3 border-t border-dark-border shrink-0"
+      >
+        <div className="flex items-end gap-2 bg-dark-elevated border border-dark-border rounded-xl px-3 py-2 transition-colors">
+          <textarea
+            ref={inputRef}
+            value={input}
+            onChange={(e) => {
+              setInput(e.target.value);
+              // Auto-resize up to 5 lines, then scroll
+              e.target.style.height = "auto";
+              e.target.style.height =
+                Math.min(e.target.scrollHeight, 100) + "px";
+            }}
+            onKeyDown={handleKeyDown}
+            placeholder="Ask about food nutrition..."
+            rows={1}
+            className="flex-1 bg-transparent text-sm text-content-primary placeholder:text-content-muted resize-none outline-none focus-visible:outline-none max-h-[100px] overflow-y-auto chat-scrollbar"
+            disabled={isSending || createThread.isPending}
+          />
+          <button
+            type="submit"
+            disabled={!input.trim() || isSending || createThread.isPending}
+            className="shrink-0 p-1.5 rounded-lg bg-accent text-dark disabled:opacity-30 disabled:cursor-not-allowed hover:bg-accent-hover transition-colors"
+          >
+            <Send size={14} />
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+}
diff --git a/packages/kal-frontend/src/components/chat/ChatWidget.tsx b/packages/kal-frontend/src/components/chat/ChatWidget.tsx
new file mode 100644
index 0000000..6b562d7
--- /dev/null
+++ b/packages/kal-frontend/src/components/chat/ChatWidget.tsx
@@ -0,0 +1,82 @@
+"use client";
+
+import { MessageCircle, X } from "react-feather";
+
+import { ChatActivityBar } from "./ChatActivityBar";
+import { ChatPanel } from "./ChatPanel";
+
+import { useChatPanel } from "@/contexts/ChatPanelContext";
+import { useAuth } from "@/lib/auth-context";
+
+/**
+ * Chat widget — orchestrates the right-side panel layout.
+ *
+ * Desktop (sm+): Activity bar (always visible) + push panel that takes space in the flex row.
+ * Mobile (<sm): Floating action button + fullscreen overlay.
+ *
+ * Rendered at the root layout level, auth-gated internally.
+ */
+export function ChatWidget() {
+  const { logtoId } = useAuth();
+  const { isOpen, toggle, close } = useChatPanel();
+
+  // Only show for authenticated users
+  if (!logtoId) return null;
+
+  return (
+    <>
+      {/* ── Desktop: Activity bar + push panel ── */}
+      <ChatActivityBar />
+
+      {isOpen && (
+        <div
+          className={[
+            // Desktop: inline push panel (part of flex row)
+            "hidden sm:flex flex-col shrink-0",
+            "w-[400px] lg:w-[500px]",
+            "h-full",
+            "bg-dark-surface border-l border-dark-border",
+            "animate-panel-slide-in",
+          ].join(" ")}
+        >
+          <ChatPanel onClose={close} />
+        </div>
+      )}
+
+      {/* ── Mobile: FAB + fullscreen overlay ── */}
+      {isOpen && (
+        <>
+          {/* Backdrop */}
+          <div
+            className="fixed inset-0 bg-black/40 backdrop-blur-sm z-[60] sm:hidden"
+            onClick={close}
+          />
+          {/* Fullscreen panel */}
+          <div className="fixed inset-0 z-[61] sm:hidden bg-dark-surface flex flex-col animate-fade-in">
+            <ChatPanel onClose={close} />
+          </div>
+        </>
+      )}
+
+      {/* Mobile FAB (visible only on mobile) */}
+      <button
+        onClick={toggle}
+        className={[
+          "fixed bottom-6 right-6 z-[62]",
+          "w-14 h-14 rounded-full",
+          "flex items-center justify-center",
+          "shadow-lg shadow-black/30",
+          "transition-all duration-200",
+          "sm:hidden", // hide on desktop — activity bar handles it
+          "focus:outline-none focus-visible:ring-2 focus-visible:ring-accent focus-visible:ring-offset-2 focus-visible:ring-offset-dark",
+          isOpen
+            ? "bg-dark-elevated border border-dark-border text-content-secondary hover:text-content-primary"
+            : "bg-accent text-dark hover:bg-accent-hover hover:scale-105 active:scale-95",
+        ].join(" ")}
+        aria-label={isOpen ? "Close chat" : "Open chat"}
+      >
+        {isOpen ? <X size={22} /> : <MessageCircle size={22} />}
+      </button>
+    </>
+  );
+}
diff --git a/packages/kal-frontend/src/components/chat/ToolStepIndicator.tsx b/packages/kal-frontend/src/components/chat/ToolStepIndicator.tsx
new file mode 100644
index 0000000..bb0ff6a
--- /dev/null
+++ b/packages/kal-frontend/src/components/chat/ToolStepIndicator.tsx
@@ -0,0 +1,72 @@
+"use client";
+
+import type { ChatToolName } from "kal-shared";
+import { memo } from "react";
+import { Search, CheckCircle, Loader } from "react-feather";
+
+export interface ToolStep {
+  tool: ChatToolName;
+  message: string;
+  status: "running" | "done";
+}
+
+// Map tool names to friendly icons
+function ToolIcon({
+  tool,
+  status,
+}: {
+  tool: ChatToolName;
+  status: "running" | "done";
+}) {
+  if (status === "done") {
+    return <CheckCircle size={13} className="text-accent shrink-0" />;
+  }
+
+  if (tool === "search_database" || tool === "extract_search_term") {
+    return (
+      <Search size={13} className="text-content-muted shrink-0 animate-pulse" />
+    );
+  }
+
+  return (
+    <Loader size={13} className="text-content-muted shrink-0 animate-spin" />
+  );
+}
+
+export const ToolStepIndicator = memo(function ToolStepIndicator({
+  steps,
+}: {
+  steps: ToolStep[];
+}) {
+  if (steps.length === 0) return null;
+
+  return (
+    <div className="flex gap-2.5">
+      {/* Avatar column — matches ChatMessage layout */}
+      <div className="shrink-0 w-7 h-7 rounded-full flex items-center justify-center bg-dark-elevated border border-dark-border text-accent mt-0.5">
+        <span className="font-bold text-[11px]">K</span>
+      </div>
+
+      {/* Steps */}
+      <div className="flex flex-col gap-1.5 py-1">
+        {steps.map((step, i) => (
+          <div
+            key={`${step.tool}-${i}`}
+            className="flex items-center gap-1.5 text-xs text-content-muted"
+          >
+            <ToolIcon tool={step.tool} status={step.status} />
+            <span
+              className={
+                step.status === "done"
+                  ? "text-content-secondary"
+                  : "text-content-muted"
+              }
+            >
+              {step.message}
+            </span>
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+});
diff --git a/packages/kal-frontend/src/contexts/ChatPanelContext.tsx b/packages/kal-frontend/src/contexts/ChatPanelContext.tsx
new file mode 100644
index 0000000..e9a3679
--- /dev/null
+++ b/packages/kal-frontend/src/contexts/ChatPanelContext.tsx
@@ -0,0 +1,40 @@
+"use client";
+
+import {
+  createContext,
+  useContext,
+  useState,
+  useCallback,
+  type ReactNode,
+} from "react";
+
+interface ChatPanelContextValue {
+  isOpen: boolean;
+  toggle: () => void;
+  open: () => void;
+  close: () => void;
+}
+
+const ChatPanelContext = createContext<ChatPanelContextValue | null>(null);
+
+export function ChatPanelProvider({ children }: { children: ReactNode }) {
+  const [isOpen, setIsOpen] = useState(false);
+
+  const toggle = useCallback(() => setIsOpen((prev) => !prev), []);
+  const open = useCallback(() => setIsOpen(true), []);
+  const close = useCallback(() => setIsOpen(false), []);
+
+  return (
+    <ChatPanelContext.Provider value={{ isOpen, toggle, open, close }}>
+      {children}
+    </ChatPanelContext.Provider>
+  );
+}
+
+export function useChatPanel() {
+  const ctx = useContext(ChatPanelContext);
+  if (!ctx) {
+    throw new Error("useChatPanel must be used within ChatPanelProvider");
+  }
+  return ctx;
+}
diff --git a/packages/kal-frontend/src/lib/chat-stream.ts b/packages/kal-frontend/src/lib/chat-stream.ts
new file mode 100644
index 0000000..2d506e4
--- /dev/null
+++ b/packages/kal-frontend/src/lib/chat-stream.ts
@@ -0,0 +1,213 @@
+/**
+ * SSE client for the chat streaming endpoint.
+ *
+ * Uses the browser Fetch API with ReadableStream to consume
+ * Server-Sent Events from POST /api/chat/stream.
+ */
+
+import type { ChatSSEEvent, ChatToolName } from "kal-shared";
+
+// ---- Callback types ----
+
+export interface ChatStreamCallbacks {
+  /** A tool step has started (e.g., "Searching database...") */
+  onToolStart?: (tool: ChatToolName, message: string) => void;
+  /** A tool step completed */
+  onToolEnd?: (
+    tool: ChatToolName,
+    message: string,
+    data?: Record<string, unknown>
+  ) => void;
+  /** AI streaming has begun */
+  onStreamStart?: () => void;
+  /** A chunk of the AI response text */
+  onStreamDelta?: (delta: string) => void;
+  /** AI response complete — messageId is the DB id of the saved message */
+  onStreamEnd?: (messageId: string) => void;
+  /** An error occurred */
+  onError?: (message: string) => void;
+  /** Entire flow is done */
+  onDone?: () => void;
+}
+
+// ---- SSE parsing helpers ----
+
+function getApiUrl(): string {
+  return process.env.NEXT_PUBLIC_API_URL || "http://localhost:4000";
+}
+
+/**
+ * Parse a raw SSE chunk into individual events.
+ * Each event is separated by a double newline.
+ * Format:  event: <type>\ndata: <json>\n\n
+ */
+function parseSSEEvents(raw: string): ChatSSEEvent[] {
+  const events: ChatSSEEvent[] = [];
+  // Split on double newline (event boundary)
+  const blocks = raw.split("\n\n").filter((b) => b.trim());
+
+  for (const block of blocks) {
+    const lines = block.split("\n");
+    let data = "";
+
+    for (const line of lines) {
+      if (line.startsWith("data: ")) {
+        data = line.slice(6);
+      }
+    }
+
+    if (data) {
+      try {
+        events.push(JSON.parse(data) as ChatSSEEvent);
+      } catch {
+        // Skip malformed JSON
+      }
+    }
+  }
+
+  return events;
+}
+
+// ---- Main function ----
+
+/**
+ * Send a chat message via SSE and process the stream.
+ *
+ * @returns An AbortController that can be used to cancel the request.
+ */
+export function sendChatStream(
+  params: {
+    threadId: string;
+    content: string;
+    logtoId: string;
+    email?: string | null;
+    name?: string | null;
+  },
+  callbacks: ChatStreamCallbacks
+): AbortController {
+  const controller = new AbortController();
+
+  // Fire-and-forget async IIFE
+  (async () => {
+    try {
+      const headers: Record<string, string> = {
+        "Content-Type": "application/json",
+        "x-logto-id": params.logtoId,
+      };
+      if (params.email) headers["x-logto-email"] = params.email;
+      if (params.name) headers["x-logto-name"] = params.name;
+
+      const response = await fetch(`${getApiUrl()}/api/chat/stream`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          threadId: params.threadId,
+          content: params.content,
+        }),
+        signal: controller.signal,
+        credentials: "include",
+      });
+
+      if (!response.ok) {
+        const body = await response.text();
+        callbacks.onError?.(
+          `Server error (${response.status}): ${body || "Unknown error"}`
+        );
+        callbacks.onDone?.();
+        return;
+      }
+
+      if (!response.body) {
+        callbacks.onError?.("No response body");
+        callbacks.onDone?.();
+        return;
+      }
+
+      // Read the stream
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+
+        buffer += decoder.decode(value, { stream: true });
+
+        // Process complete events (delimited by double newline)
+        const lastDoubleNewline = buffer.lastIndexOf("\n\n");
+        if (lastDoubleNewline === -1) continue;
+
+        const complete = buffer.slice(0, lastDoubleNewline + 2);
+        buffer = buffer.slice(lastDoubleNewline + 2);
+
+        const events = parseSSEEvents(complete);
+
+        for (const event of events) {
+          switch (event.type) {
+            case "tool_start":
+              callbacks.onToolStart?.(event.tool, event.message);
+              break;
+            case "tool_end":
+              callbacks.onToolEnd?.(event.tool, event.message, event.data);
+              break;
+            case "stream_start":
+              callbacks.onStreamStart?.();
+              break;
+            case "stream_delta":
+              callbacks.onStreamDelta?.(event.delta);
+              break;
+            case "stream_end":
+              callbacks.onStreamEnd?.(event.messageId);
+              break;
+            case "error":
+              callbacks.onError?.(event.message);
+              break;
+            case "done":
+              callbacks.onDone?.();
+              break;
+          }
+        }
+      }
+
+      // Process any remaining buffer
+      if (buffer.trim()) {
+        const events = parseSSEEvents(buffer);
+        for (const event of events) {
+          switch (event.type) {
+            case "tool_start":
+              callbacks.onToolStart?.(event.tool, event.message);
+              break;
+            case "tool_end":
+              callbacks.onToolEnd?.(event.tool, event.message, event.data);
+              break;
+            case "stream_start":
+              callbacks.onStreamStart?.();
+              break;
+            case "stream_delta":
+              callbacks.onStreamDelta?.(event.delta);
+              break;
+            case "stream_end":
+              callbacks.onStreamEnd?.(event.messageId);
+              break;
+            case "error":
+              callbacks.onError?.(event.message);
+              break;
+            case "done":
+              callbacks.onDone?.();
+              break;
+          }
+        }
+      }
+    } catch (error) {
+      if ((error as Error).name === "AbortError") {
+        // User cancelled — not an error
+        return;
+      }
+      callbacks.onError?.((error as Error).message || "Network error");
+      callbacks.onDone?.();
+    }
+  })();
+
+  return controller;
+}
diff --git a/packages/kal-frontend/tailwind.config.ts b/packages/kal-frontend/tailwind.config.ts
index 7bca31e..a04326b 100644
--- a/packages/kal-frontend/tailwind.config.ts
+++ b/packages/kal-frontend/tailwind.config.ts
@@ -35,6 +35,7 @@ const config: Config = {
       animation: {
         "fade-in": "fadeIn 0.5s ease-out",
         "slide-up": "slideUp 0.5s ease-out",
+        "panel-slide-in": "panelSlideIn 0.25s ease-out",
       },
       keyframes: {
         fadeIn: {
@@ -45,6 +46,10 @@ const config: Config = {
           "0%": { opacity: "0", transform: "translateY(20px)" },
           "100%": { opacity: "1", transform: "translateY(0)" },
         },
+        panelSlideIn: {
+          "0%": { opacity: "0", transform: "translateX(100%)" },
+          "100%": { opacity: "1", transform: "translateX(0)" },
+        },
       },
     },
   },
diff --git a/packages/kal-shared/src/types/index.ts b/packages/kal-shared/src/types/index.ts
index 6cf3f21..554bb78 100644
--- a/packages/kal-shared/src/types/index.ts
+++ b/packages/kal-shared/src/types/index.ts
@@ -1,7 +1,7 @@
 // ===================
 // User Tiers
 // ===================
-export type UserTier = 'free' | 'tier_1' | 'tier_2';
+export type UserTier = "free" | "tier_1" | "tier_2";
 
 export interface User {
   _id: string;
@@ -18,14 +18,14 @@ export interface User {
 // ===================
 export interface RateLimitConfig {
   // Base limits
-  minuteLimit: number;       // requests per minute
-  dailyLimit: number;        // requests per day
-  monthlyLimit: number;      // requests per month
-  
+  minuteLimit: number; // requests per minute
+  dailyLimit: number; // requests per day
+  monthlyLimit: number; // requests per month
+
   // Burst configuration
-  burstBonus: number;        // extra requests allowed during burst
+  burstBonus: number; // extra requests allowed during burst
   burstWindowSeconds: number; // burst window duration (typically 10 seconds)
-  maxBurstTotal: number;     // max total requests including burst
+  maxBurstTotal: number; // max total requests including burst
 }
 
 export const RATE_LIMITS: Record<UserTier, RateLimitConfig> = {
@@ -70,22 +70,22 @@ export interface RateLimitUsage {
   _id: string;
   userId: string;
   date: string; // YYYY-MM-DD format
-  
+
   // Daily tracking
   dailyCount: number;
-  
+
   // Minute tracking
   minuteWindow: Date;
   minuteCount: number;
-  
+
   // Second tracking (for VPS safety cap)
   secondWindow?: Date;
   secondCount?: number;
-  
+
   // Burst window tracking
   burstWindowStart?: Date;
   burstCount?: number;
-  
+
   updatedAt: Date;
 }
 
@@ -103,16 +103,16 @@ export interface LogtoUserInfo {
 // ===================
 // API Keys
 // ===================
-export type ApiKeyExpiration = '1_week' | '1_month' | 'never';
+export type ApiKeyExpiration = "1_week" | "1_month" | "never";
 
 export interface ApiKey {
   _id: string;
-  userId: string;           // Reference to user
-  key: string;              // The actual API key (hashed in DB)
-  keyPrefix: string;        // First 8 chars for display (e.g., "kal_a1b2...")
-  name: string;             // User-defined name for the key
+  userId: string; // Reference to user
+  key: string; // The actual API key (hashed in DB)
+  keyPrefix: string; // First 8 chars for display (e.g., "kal_a1b2...")
+  name: string; // User-defined name for the key
   expiration: ApiKeyExpiration;
-  expiresAt: Date | null;   // null = never expires
+  expiresAt: Date | null; // null = never expires
   createdAt: Date;
   lastUsedAt: Date | null;
   isRevoked: boolean;
@@ -131,8 +131,6 @@ export interface ApiKeyPublic {
   isRevoked: boolean;
 }
 
-
-
 export interface FoodEntry {
   _id: string;
   userId: string;
@@ -161,14 +159,14 @@ export interface PaginatedResponse<T> {
 }
 
 // ===================
-// Chat (BAML + GLM 4.6)
+// Chat (BAML + Claude via Pika AI)
 // ===================
-export type ChatRole = 'User' | 'Assistant';
+export type ChatRole = "User" | "Assistant";
 
 export interface ChatThread {
   _id: string;
-  userId: string;           // Logto user ID
-  title: string;            // Auto-generated from first message
+  userId: string; // Logto user ID
+  title: string; // Auto-generated from first message
   createdAt: Date;
   updatedAt: Date;
   messageCount: number;
@@ -176,8 +174,8 @@ export interface ChatThread {
 
 export interface ChatMessage {
   _id: string;
-  threadId: string;         // Reference to chat_threads
-  userId: string;           // Logto user ID
+  threadId: string; // Reference to chat_threads
+  userId: string; // Logto user ID
   role: ChatRole;
   content: string;
   createdAt: Date;
@@ -189,6 +187,33 @@ export interface ChatThreadPreview {
   title: string;
   updatedAt: Date;
   messageCount: number;
-  lastMessage?: string;     // Preview of last message content
+  lastMessage?: string; // Preview of last message content
 }
 
+// ===================
+// Chat SSE Streaming Events
+// ===================
+
+/** Tool step names used in the chat workflow */
+export type ChatToolName =
+  | "classify_intent"
+  | "extract_search_term"
+  | "search_database"
+  | "estimate_nutrition"
+  | "parse_recipe"
+  | "generate_response";
+
+/** SSE events sent during chat streaming */
+export type ChatSSEEvent =
+  | { type: "tool_start"; tool: ChatToolName; message: string }
+  | {
+      type: "tool_end";
+      tool: ChatToolName;
+      message: string;
+      data?: Record<string, unknown>;
+    }
+  | { type: "stream_start" }
+  | { type: "stream_delta"; delta: string }
+  | { type: "stream_end"; messageId: string }
+  | { type: "error"; message: string }
+  | { type: "done" };
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index c49c113..873c0a5 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -261,6 +261,12 @@ importers:
       react-feather:
         specifier: ^2.0.10
         version: 2.0.10(react@19.2.3)
+      react-markdown:
+        specifier: ^10.1.0
+        version: 10.1.0(@types/react@19.2.7)(react@19.2.3)
+      remark-gfm:
+        specifier: ^4.0.1
+        version: 4.0.1
     devDependencies:
       '@types/node':
         specifier: ^22.10.2
@@ -955,6 +961,12 @@ packages:
   '@types/cors@2.8.19':
     resolution: {integrity: sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==}
 
+  '@types/debug@4.1.13':
+    resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
+
+  '@types/estree-jsx@1.0.5':
+    resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
+
   '@types/estree@1.0.8':
     resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
 
@@ -967,6 +979,9 @@ packages:
   '@types/express@5.0.6':
     resolution: {integrity: sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==}
 
+  '@types/hast@3.0.4':
+    resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==}
+
   '@types/http-errors@2.0.5':
     resolution: {integrity: sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==}
 
@@ -976,6 +991,12 @@ packages:
   '@types/json5@0.0.29':
     resolution: {integrity: sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==}
 
+  '@types/mdast@4.0.4':
+    resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
+  '@types/ms@2.1.0':
+    resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==}
+
   '@types/node@22.19.3':
     resolution: {integrity: sha512-1N9SBnWYOJTrNZCdh/yJE+t910Y128BoyY+zBLWhL3r0TYzlTmFdXrPwHL9DyFZmlEXNQQolTZh3KHV31QDhyA==}
 
@@ -1002,6 +1023,12 @@ packages:
   '@types/swagger-ui-express@4.1.8':
     resolution: {integrity: sha512-AhZV8/EIreHFmBV5wAs0gzJUNq9JbbSXgJLQubCC0jtIo6prnI9MIRRxnU4MZX9RB9yXxF1V4R7jtLl/Wcj31g==}
 
+  '@types/unist@2.0.11':
+    resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==}
+
+  '@types/unist@3.0.3':
+    resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==}
+
   '@types/webidl-conversions@7.0.3':
     resolution: {integrity: sha512-CiJJvcRtIgzadHCYXw7dqEnMNRjhGZlYK05Mj9OyktqV8uVT8fD2BFOB7S1uwBE3Kj2Z+4UyPmFw/Ixgw/LAlA==}
 
@@ -1070,6 +1097,9 @@ packages:
     resolution: {integrity: sha512-IrDKrw7pCRUR94zeuCSUWQ+w8JEf5ZX5jl/e6AHGSLi1/zIr0lgutfn/7JpfCey+urpgQEdrZVYzCaVVKiTwhQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
+  '@ungap/structured-clone@1.3.0':
+    resolution: {integrity: sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==}
+
   accepts@1.3.8:
     resolution: {integrity: sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==}
     engines: {node: '>= 0.6'}
@@ -1161,6 +1191,9 @@ packages:
   babel-plugin-react-compiler@1.0.0:
     resolution: {integrity: sha512-Ixm8tFfoKKIPYdCCKYTsqv+Fd4IJ0DQqMyEimo+pxUOMUR9cVPlwTrFt9Avu+3cb6Zp3mAzl+t1MrG2fxxKsxw==}
 
+  bail@2.0.2:
+    resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==}
+
   balanced-match@1.0.2:
     resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
 
@@ -1230,10 +1263,25 @@ packages:
   caniuse-lite@1.0.30001761:
     resolution: {integrity: sha512-JF9ptu1vP2coz98+5051jZ4PwQgd2ni8A+gYSN7EA7dPKIMf0pDlSUxhdmVOaV3/fYK5uWBkgSXJaRLr4+3A6g==}
 
+  ccount@2.0.1:
+    resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==}
+
   chalk@4.1.2:
     resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
     engines: {node: '>=10'}
 
+  character-entities-html4@2.1.0:
+    resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==}
+
+  character-entities-legacy@3.0.0:
+    resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==}
+
+  character-entities@2.0.2:
+    resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==}
+
+  character-reference-invalid@2.0.1:
+    resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==}
+
   chart.js@4.5.1:
     resolution: {integrity: sha512-GIjfiT9dbmHRiYi6Nl2yFCq7kkwdkp1W/lp2J99rX0yo9tgJGn3lKQATztIjb5tVtevcBtIdICNWqlq5+E8/Pw==}
     engines: {pnpm: '>=8'}
@@ -1260,6 +1308,9 @@ packages:
   color-name@1.1.4:
     resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
 
+  comma-separated-tokens@2.0.3:
+    resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==}
+
   commander@14.0.2:
     resolution: {integrity: sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ==}
     engines: {node: '>=20'}
@@ -1362,6 +1413,9 @@ packages:
       supports-color:
         optional: true
 
+  decode-named-character-reference@1.3.0:
+    resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==}
+
   deep-is@0.1.4:
     resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
 
@@ -1381,6 +1435,10 @@ packages:
     resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}
     engines: {node: '>= 0.8'}
 
+  dequal@2.0.3:
+    resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+    engines: {node: '>=6'}
+
   destroy@1.2.0:
     resolution: {integrity: sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==}
     engines: {node: '>= 0.8', npm: 1.2.8000 || >= 1.4.16}
@@ -1389,6 +1447,9 @@ packages:
     resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
     engines: {node: '>=8'}
 
+  devlop@1.1.0:
+    resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==}
+
   didyoumean@1.2.2:
     resolution: {integrity: sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==}
 
@@ -1468,6 +1529,10 @@ packages:
     resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
     engines: {node: '>=10'}
 
+  escape-string-regexp@5.0.0:
+    resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+    engines: {node: '>=12'}
+
   eslint-config-prettier@10.1.8:
     resolution: {integrity: sha512-82GZUjRS0p/jganf6q1rEO25VSoHH0hKPCTrgillPjdI/3bgBhAE1QzHrHTizjpRvy6pGAvKjDJtk2pF9NDq8w==}
     hasBin: true
@@ -1558,6 +1623,9 @@ packages:
     resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==}
     engines: {node: '>=4.0'}
 
+  estree-util-is-identifier-name@3.0.0:
+    resolution: {integrity: sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==}
+
   esutils@2.0.3:
     resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
     engines: {node: '>=0.10.0'}
@@ -1574,6 +1642,9 @@ packages:
     resolution: {integrity: sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==}
     engines: {node: '>= 0.10.0'}
 
+  extend@3.0.2:
+    resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+
   fast-deep-equal@3.1.3:
     resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
 
@@ -1726,6 +1797,12 @@ packages:
     resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
     engines: {node: '>= 0.4'}
 
+  hast-util-to-jsx-runtime@2.3.6:
+    resolution: {integrity: sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==}
+
+  hast-util-whitespace@3.0.0:
+    resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==}
+
   helmet@8.1.0:
     resolution: {integrity: sha512-jOiHyAZsmnr8LqoPGmCjYAaiuWwjAPLgY8ZX2XrmHawt99/u1y6RgrZMTeoPfpUbV96HOalYgz1qzkRbw54Pmg==}
     engines: {node: '>=18.0.0'}
@@ -1736,6 +1813,9 @@ packages:
   hermes-parser@0.25.1:
     resolution: {integrity: sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==}
 
+  html-url-attributes@3.0.1:
+    resolution: {integrity: sha512-ol6UPyBWqsrO6EJySPz2O7ZSr856WDrEzM5zMqp+FJJLGMW35cLYmmZnl0vztAZxRUoNZJFTCohfjuIJ8I4QBQ==}
+
   http-errors@2.0.1:
     resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==}
     engines: {node: '>= 0.8'}
@@ -1763,6 +1843,9 @@ packages:
   inherits@2.0.4:
     resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
 
+  inline-style-parser@0.2.7:
+    resolution: {integrity: sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==}
+
   internal-slot@1.1.0:
     resolution: {integrity: sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==}
     engines: {node: '>= 0.4'}
@@ -1775,6 +1858,12 @@ packages:
     resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}
     engines: {node: '>= 0.10'}
 
+  is-alphabetical@2.0.1:
+    resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==}
+
+  is-alphanumerical@2.0.1:
+    resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==}
+
   is-array-buffer@3.0.5:
     resolution: {integrity: sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==}
     engines: {node: '>= 0.4'}
@@ -1811,6 +1900,9 @@ packages:
     resolution: {integrity: sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==}
     engines: {node: '>= 0.4'}
 
+  is-decimal@2.0.1:
+    resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==}
+
   is-extglob@2.1.1:
     resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
     engines: {node: '>=0.10.0'}
@@ -1831,6 +1923,9 @@ packages:
     resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
     engines: {node: '>=0.10.0'}
 
+  is-hexadecimal@2.0.1:
+    resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==}
+
   is-map@2.0.3:
     resolution: {integrity: sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==}
     engines: {node: '>= 0.4'}
@@ -1847,6 +1942,10 @@ packages:
     resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
     engines: {node: '>=0.12.0'}
 
+  is-plain-obj@4.1.0:
+    resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==}
+    engines: {node: '>=12'}
+
   is-regex@1.2.1:
     resolution: {integrity: sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==}
     engines: {node: '>= 0.4'}
@@ -1968,6 +2067,9 @@ packages:
   lodash.merge@4.6.2:
     resolution: {integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==}
 
+  longest-streak@3.1.0:
+    resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==}
+
   loose-envify@1.4.0:
     resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==}
     hasBin: true
@@ -1979,10 +2081,58 @@ packages:
     resolution: {integrity: sha512-2L3MIgJynYrZ3TYMriLDLWocz15okFakV6J12HXvMXDHui2x/zgChzg1u9mFFGbbGWE+GsLpQByt4POb9Or+uA==}
     engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
 
+  markdown-table@3.0.4:
+    resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
+
   math-intrinsics@1.1.0:
     resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
     engines: {node: '>= 0.4'}
 
+  mdast-util-find-and-replace@3.0.2:
+    resolution: {integrity: sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==}
+
+  mdast-util-from-markdown@2.0.3:
+    resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==}
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    resolution: {integrity: sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==}
+
+  mdast-util-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==}
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    resolution: {integrity: sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==}
+
+  mdast-util-gfm-table@2.0.0:
+    resolution: {integrity: sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==}
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    resolution: {integrity: sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==}
+
+  mdast-util-gfm@3.1.0:
+    resolution: {integrity: sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==}
+
+  mdast-util-mdx-expression@2.0.1:
+    resolution: {integrity: sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==}
+
+  mdast-util-mdx-jsx@3.2.0:
+    resolution: {integrity: sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==}
+
+  mdast-util-mdxjs-esm@2.0.1:
+    resolution: {integrity: sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==}
+
+  mdast-util-phrasing@4.1.0:
+    resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==}
+
+  mdast-util-to-hast@13.2.1:
+    resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==}
+
+  mdast-util-to-markdown@2.1.2:
+    resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==}
+
+  mdast-util-to-string@4.0.0:
+    resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==}
+
   media-typer@0.3.0:
     resolution: {integrity: sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==}
     engines: {node: '>= 0.6'}
@@ -2001,6 +2151,90 @@ packages:
     resolution: {integrity: sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==}
     engines: {node: '>= 0.6'}
 
+  micromark-core-commonmark@2.0.3:
+    resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==}
+
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    resolution: {integrity: sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==}
+
+  micromark-extension-gfm-footnote@2.1.0:
+    resolution: {integrity: sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==}
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    resolution: {integrity: sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==}
+
+  micromark-extension-gfm-table@2.1.1:
+    resolution: {integrity: sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==}
+
+  micromark-extension-gfm-tagfilter@2.0.0:
+    resolution: {integrity: sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==}
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    resolution: {integrity: sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==}
+
+  micromark-extension-gfm@3.0.0:
+    resolution: {integrity: sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==}
+
+  micromark-factory-destination@2.0.1:
+    resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==}
+
+  micromark-factory-label@2.0.1:
+    resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==}
+
+  micromark-factory-space@2.0.1:
+    resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==}
+
+  micromark-factory-title@2.0.1:
+    resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==}
+
+  micromark-factory-whitespace@2.0.1:
+    resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==}
+
+  micromark-util-character@2.1.1:
+    resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==}
+
+  micromark-util-chunked@2.0.1:
+    resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==}
+
+  micromark-util-classify-character@2.0.1:
+    resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==}
+
+  micromark-util-combine-extensions@2.0.1:
+    resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==}
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==}
+
+  micromark-util-decode-string@2.0.1:
+    resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==}
+
+  micromark-util-encode@2.0.1:
+    resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==}
+
+  micromark-util-html-tag-name@2.0.1:
+    resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==}
+
+  micromark-util-normalize-identifier@2.0.1:
+    resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==}
+
+  micromark-util-resolve-all@2.0.1:
+    resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==}
+
+  micromark-util-sanitize-uri@2.0.1:
+    resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==}
+
+  micromark-util-subtokenize@2.1.0:
+    resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==}
+
+  micromark-util-symbol@2.0.1:
+    resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==}
+
+  micromark-util-types@2.0.2:
+    resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==}
+
+  micromark@4.0.2:
+    resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==}
+
   micromatch@4.0.8:
     resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
     engines: {node: '>=8.6'}
@@ -2178,6 +2412,9 @@ packages:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
 
+  parse-entities@4.0.2:
+    resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==}
+
   parseurl@1.3.3:
     resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
     engines: {node: '>= 0.8'}
@@ -2282,6 +2519,9 @@ packages:
   prop-types@15.8.1:
     resolution: {integrity: sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==}
 
+  property-information@7.1.0:
+    resolution: {integrity: sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ==}
+
   proxy-addr@2.0.7:
     resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==}
     engines: {node: '>= 0.10'}
@@ -2332,6 +2572,12 @@ packages:
   react-is@16.13.1:
     resolution: {integrity: sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==}
 
+  react-markdown@10.1.0:
+    resolution: {integrity: sha512-qKxVopLT/TyA6BX3Ue5NwabOsAzm0Q7kAPwq6L+wWDwisYs7R8vZ0nRXqq6rkueboxpkjvLGU9fWifiX/ZZFxQ==}
+    peerDependencies:
+      '@types/react': '>=18'
+      react: '>=18'
+
   react@19.2.3:
     resolution: {integrity: sha512-Ku/hhYbVjOQnXDZFv2+RibmLFGwFdeeKHFcOTlrt7xplBnya5OGn/hIRDsqDiSUcfORsDC7MPxwork8jBwsIWA==}
     engines: {node: '>=0.10.0'}
@@ -2359,6 +2605,18 @@ packages:
     resolution: {integrity: sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==}
     engines: {node: '>= 0.4'}
 
+  remark-gfm@4.0.1:
+    resolution: {integrity: sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==}
+
+  remark-parse@11.0.0:
+    resolution: {integrity: sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==}
+
+  remark-rehype@11.1.2:
+    resolution: {integrity: sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==}
+
+  remark-stringify@11.0.0:
+    resolution: {integrity: sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==}
+
   resolve-from@4.0.0:
     resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
     engines: {node: '>=4'}
@@ -2467,6 +2725,9 @@ packages:
     resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
     engines: {node: '>=0.10.0'}
 
+  space-separated-tokens@2.0.2:
+    resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
+
   sparse-bitfield@3.0.3:
     resolution: {integrity: sha512-kvzhi7vqKTfkh0PZU+2D2PIllw2ymqJKujUcyPMd9Y75Nv4nPbGJZXNhxsgdQab2BmlDct1YnfQCguEvHr7VsQ==}
 
@@ -2504,6 +2765,9 @@ packages:
     resolution: {integrity: sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==}
     engines: {node: '>= 0.4'}
 
+  stringify-entities@4.0.4:
+    resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==}
+
   strip-ansi@6.0.1:
     resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
     engines: {node: '>=8'}
@@ -2516,6 +2780,12 @@ packages:
     resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==}
     engines: {node: '>=8'}
 
+  style-to-js@1.1.21:
+    resolution: {integrity: sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==}
+
+  style-to-object@1.0.14:
+    resolution: {integrity: sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==}
+
   styled-jsx@5.1.6:
     resolution: {integrity: sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA==}
     engines: {node: '>= 12.0.0'}
@@ -2579,6 +2849,12 @@ packages:
     resolution: {integrity: sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==}
     engines: {node: '>=18'}
 
+  trim-lines@3.0.1:
+    resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==}
+
+  trough@2.2.0:
+    resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==}
+
   ts-api-utils@2.1.0:
     resolution: {integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==}
     engines: {node: '>=18.12'}
@@ -2677,6 +2953,24 @@ packages:
   undici-types@6.21.0:
     resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
 
+  unified@11.0.5:
+    resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
+
+  unist-util-is@6.0.1:
+    resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==}
+
+  unist-util-position@5.0.0:
+    resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==}
+
+  unist-util-stringify-position@4.0.0:
+    resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==}
+
+  unist-util-visit-parents@6.0.2:
+    resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==}
+
+  unist-util-visit@5.1.0:
+    resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==}
+
   unpipe@1.0.0:
     resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==}
     engines: {node: '>= 0.8'}
@@ -2701,6 +2995,12 @@ packages:
     resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}
     engines: {node: '>= 0.8'}
 
+  vfile-message@4.0.3:
+    resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==}
+
+  vfile@6.0.3:
+    resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==}
+
   webidl-conversions@7.0.0:
     resolution: {integrity: sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==}
     engines: {node: '>=12'}
@@ -2767,6 +3067,9 @@ packages:
   zod@3.25.76:
     resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
 
+  zwitch@2.0.4:
+    resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==}
+
 snapshots:
 
   '@alloc/quick-lru@5.2.0': {}
@@ -3313,6 +3616,14 @@ snapshots:
     dependencies:
       '@types/node': 22.19.3
 
+  '@types/debug@4.1.13':
+    dependencies:
+      '@types/ms': 2.1.0
+
+  '@types/estree-jsx@1.0.5':
+    dependencies:
+      '@types/estree': 1.0.8
+
   '@types/estree@1.0.8': {}
 
   '@types/express-serve-static-core@5.1.0':
@@ -3332,12 +3643,22 @@ snapshots:
       '@types/express-serve-static-core': 5.1.0
       '@types/serve-static': 2.2.0
 
+  '@types/hast@3.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
   '@types/http-errors@2.0.5': {}
 
   '@types/json-schema@7.0.15': {}
 
   '@types/json5@0.0.29': {}
 
+  '@types/mdast@4.0.4':
+    dependencies:
+      '@types/unist': 3.0.3
+
+  '@types/ms@2.1.0': {}
+
   '@types/node@22.19.3':
     dependencies:
       undici-types: 6.21.0
@@ -3368,6 +3689,10 @@ snapshots:
       '@types/express': 5.0.6
       '@types/serve-static': 2.2.0
 
+  '@types/unist@2.0.11': {}
+
+  '@types/unist@3.0.3': {}
+
   '@types/webidl-conversions@7.0.3': {}
 
   '@types/whatwg-url@11.0.5':
@@ -3469,6 +3794,8 @@ snapshots:
       '@typescript-eslint/types': 8.50.1
       eslint-visitor-keys: 4.2.1
 
+  '@ungap/structured-clone@1.3.0': {}
+
   accepts@1.3.8:
     dependencies:
       mime-types: 2.1.35
@@ -3593,6 +3920,8 @@ snapshots:
       '@babel/types': 7.28.5
     optional: true
 
+  bail@2.0.2: {}
+
   balanced-match@1.0.2: {}
 
   baseline-browser-mapping@2.9.11: {}
@@ -3673,11 +4002,21 @@ snapshots:
 
   caniuse-lite@1.0.30001761: {}
 
+  ccount@2.0.1: {}
+
   chalk@4.1.2:
     dependencies:
       ansi-styles: 4.3.0
       supports-color: 7.2.0
 
+  character-entities-html4@2.1.0: {}
+
+  character-entities-legacy@3.0.0: {}
+
+  character-entities@2.0.2: {}
+
+  character-reference-invalid@2.0.1: {}
+
   chart.js@4.5.1:
     dependencies:
       '@kurkle/color': 0.3.4
@@ -3710,6 +4049,8 @@ snapshots:
 
   color-name@1.1.4: {}
 
+  comma-separated-tokens@2.0.3: {}
+
   commander@14.0.2: {}
 
   commander@4.1.1: {}
@@ -3788,6 +4129,10 @@ snapshots:
     dependencies:
       ms: 2.1.3
 
+  decode-named-character-reference@1.3.0:
+    dependencies:
+      character-entities: 2.0.2
+
   deep-is@0.1.4: {}
 
   define-data-property@1.1.4:
@@ -3806,11 +4151,17 @@ snapshots:
 
   depd@2.0.0: {}
 
+  dequal@2.0.3: {}
+
   destroy@1.2.0: {}
 
   detect-libc@2.1.2:
     optional: true
 
+  devlop@1.1.0:
+    dependencies:
+      dequal: 2.0.3
+
   didyoumean@1.2.2: {}
 
   dlv@1.1.3: {}
@@ -3971,6 +4322,8 @@ snapshots:
 
   escape-string-regexp@4.0.0: {}
 
+  escape-string-regexp@5.0.0: {}
+
   eslint-config-prettier@10.1.8(eslint@9.39.2(jiti@2.6.1)):
     dependencies:
       eslint: 9.39.2(jiti@2.6.1)
@@ -4121,6 +4474,8 @@ snapshots:
 
   estraverse@5.3.0: {}
 
+  estree-util-is-identifier-name@3.0.0: {}
+
   esutils@2.0.3: {}
 
   etag@1.8.1: {}
@@ -4174,6 +4529,8 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  extend@3.0.2: {}
+
   fast-deep-equal@3.1.3: {}
 
   fast-glob@3.3.3:
@@ -4327,6 +4684,30 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  hast-util-to-jsx-runtime@2.3.6:
+    dependencies:
+      '@types/estree': 1.0.8
+      '@types/hast': 3.0.4
+      '@types/unist': 3.0.3
+      comma-separated-tokens: 2.0.3
+      devlop: 1.1.0
+      estree-util-is-identifier-name: 3.0.0
+      hast-util-whitespace: 3.0.0
+      mdast-util-mdx-expression: 2.0.1
+      mdast-util-mdx-jsx: 3.2.0
+      mdast-util-mdxjs-esm: 2.0.1
+      property-information: 7.1.0
+      space-separated-tokens: 2.0.2
+      style-to-js: 1.1.21
+      unist-util-position: 5.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  hast-util-whitespace@3.0.0:
+    dependencies:
+      '@types/hast': 3.0.4
+
   helmet@8.1.0: {}
 
   hermes-estree@0.25.1: {}
@@ -4335,6 +4716,8 @@ snapshots:
     dependencies:
       hermes-estree: 0.25.1
 
+  html-url-attributes@3.0.1: {}
+
   http-errors@2.0.1:
     dependencies:
       depd: 2.0.0
@@ -4360,6 +4743,8 @@ snapshots:
 
   inherits@2.0.4: {}
 
+  inline-style-parser@0.2.7: {}
+
   internal-slot@1.1.0:
     dependencies:
       es-errors: 1.3.0
@@ -4382,6 +4767,13 @@ snapshots:
 
   ipaddr.js@1.9.1: {}
 
+  is-alphabetical@2.0.1: {}
+
+  is-alphanumerical@2.0.1:
+    dependencies:
+      is-alphabetical: 2.0.1
+      is-decimal: 2.0.1
+
   is-array-buffer@3.0.5:
     dependencies:
       call-bind: 1.0.8
@@ -4426,6 +4818,8 @@ snapshots:
       call-bound: 1.0.4
       has-tostringtag: 1.0.2
 
+  is-decimal@2.0.1: {}
+
   is-extglob@2.1.1: {}
 
   is-finalizationregistry@1.1.1:
@@ -4446,6 +4840,8 @@ snapshots:
     dependencies:
       is-extglob: 2.1.1
 
+  is-hexadecimal@2.0.1: {}
+
   is-map@2.0.3: {}
 
   is-negative-zero@2.0.3: {}
@@ -4457,6 +4853,8 @@ snapshots:
 
   is-number@7.0.0: {}
 
+  is-plain-obj@4.1.0: {}
+
   is-regex@1.2.1:
     dependencies:
       call-bound: 1.0.4
@@ -4568,6 +4966,8 @@ snapshots:
 
   lodash.merge@4.6.2: {}
 
+  longest-streak@3.1.0: {}
+
   loose-envify@1.4.0:
     dependencies:
       js-tokens: 4.0.0
@@ -4578,8 +4978,163 @@ snapshots:
 
   map-obj@5.0.0: {}
 
+  markdown-table@3.0.4: {}
+
   math-intrinsics@1.1.0: {}
 
+  mdast-util-find-and-replace@3.0.2:
+    dependencies:
+      '@types/mdast': 4.0.4
+      escape-string-regexp: 5.0.0
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
+  mdast-util-from-markdown@2.0.3:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      mdast-util-to-string: 4.0.0
+      micromark: 4.0.2
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-decode-string: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+      unist-util-stringify-position: 4.0.0
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-autolink-literal@2.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-find-and-replace: 3.0.2
+      micromark-util-character: 2.1.1
+
+  mdast-util-gfm-footnote@2.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      micromark-util-normalize-identifier: 2.0.1
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-strikethrough@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-table@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      markdown-table: 3.0.4
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm-task-list-item@2.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-gfm@3.1.0:
+    dependencies:
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-gfm-autolink-literal: 2.0.1
+      mdast-util-gfm-footnote: 2.1.0
+      mdast-util-gfm-strikethrough: 2.0.0
+      mdast-util-gfm-table: 2.0.0
+      mdast-util-gfm-task-list-item: 2.0.0
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-expression@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdx-jsx@3.2.0:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      ccount: 2.0.1
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+      parse-entities: 4.0.2
+      stringify-entities: 4.0.4
+      unist-util-stringify-position: 4.0.0
+      vfile-message: 4.0.3
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-mdxjs-esm@2.0.1:
+    dependencies:
+      '@types/estree-jsx': 1.0.5
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      devlop: 1.1.0
+      mdast-util-from-markdown: 2.0.3
+      mdast-util-to-markdown: 2.1.2
+    transitivePeerDependencies:
+      - supports-color
+
+  mdast-util-phrasing@4.1.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      unist-util-is: 6.0.1
+
+  mdast-util-to-hast@13.2.1:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@ungap/structured-clone': 1.3.0
+      devlop: 1.1.0
+      micromark-util-sanitize-uri: 2.0.1
+      trim-lines: 3.0.1
+      unist-util-position: 5.0.0
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+
+  mdast-util-to-markdown@2.1.2:
+    dependencies:
+      '@types/mdast': 4.0.4
+      '@types/unist': 3.0.3
+      longest-streak: 3.1.0
+      mdast-util-phrasing: 4.1.0
+      mdast-util-to-string: 4.0.0
+      micromark-util-classify-character: 2.0.1
+      micromark-util-decode-string: 2.0.1
+      unist-util-visit: 5.1.0
+      zwitch: 2.0.4
+
+  mdast-util-to-string@4.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+
   media-typer@0.3.0: {}
 
   memory-pager@1.5.0: {}
@@ -4590,6 +5145,197 @@ snapshots:
 
   methods@1.1.2: {}
 
+  micromark-core-commonmark@2.0.3:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-factory-destination: 2.0.1
+      micromark-factory-label: 2.0.1
+      micromark-factory-space: 2.0.1
+      micromark-factory-title: 2.0.1
+      micromark-factory-whitespace: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-html-tag-name: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-autolink-literal@2.1.0:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-footnote@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-strikethrough@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-classify-character: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-table@2.1.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-tagfilter@2.0.0:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm-task-list-item@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-extension-gfm@3.0.0:
+    dependencies:
+      micromark-extension-gfm-autolink-literal: 2.1.0
+      micromark-extension-gfm-footnote: 2.1.0
+      micromark-extension-gfm-strikethrough: 2.1.0
+      micromark-extension-gfm-table: 2.1.1
+      micromark-extension-gfm-tagfilter: 2.0.0
+      micromark-extension-gfm-task-list-item: 2.1.0
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-destination@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-label@2.0.1:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-space@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-title@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-factory-whitespace@2.0.1:
+    dependencies:
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-character@2.1.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-chunked@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-classify-character@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-combine-extensions@2.0.1:
+    dependencies:
+      micromark-util-chunked: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-decode-numeric-character-reference@2.0.2:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-decode-string@2.0.1:
+    dependencies:
+      decode-named-character-reference: 1.3.0
+      micromark-util-character: 2.1.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-encode@2.0.1: {}
+
+  micromark-util-html-tag-name@2.0.1: {}
+
+  micromark-util-normalize-identifier@2.0.1:
+    dependencies:
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-resolve-all@2.0.1:
+    dependencies:
+      micromark-util-types: 2.0.2
+
+  micromark-util-sanitize-uri@2.0.1:
+    dependencies:
+      micromark-util-character: 2.1.1
+      micromark-util-encode: 2.0.1
+      micromark-util-symbol: 2.0.1
+
+  micromark-util-subtokenize@2.1.0:
+    dependencies:
+      devlop: 1.1.0
+      micromark-util-chunked: 2.0.1
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+
+  micromark-util-symbol@2.0.1: {}
+
+  micromark-util-types@2.0.2: {}
+
+  micromark@4.0.2:
+    dependencies:
+      '@types/debug': 4.1.13
+      debug: 4.4.3
+      decode-named-character-reference: 1.3.0
+      devlop: 1.1.0
+      micromark-core-commonmark: 2.0.3
+      micromark-factory-space: 2.0.1
+      micromark-util-character: 2.1.1
+      micromark-util-chunked: 2.0.1
+      micromark-util-combine-extensions: 2.0.1
+      micromark-util-decode-numeric-character-reference: 2.0.2
+      micromark-util-encode: 2.0.1
+      micromark-util-normalize-identifier: 2.0.1
+      micromark-util-resolve-all: 2.0.1
+      micromark-util-sanitize-uri: 2.0.1
+      micromark-util-subtokenize: 2.1.0
+      micromark-util-symbol: 2.0.1
+      micromark-util-types: 2.0.2
+    transitivePeerDependencies:
+      - supports-color
+
   micromatch@4.0.8:
     dependencies:
       braces: 3.0.3
@@ -4751,6 +5497,16 @@ snapshots:
     dependencies:
       callsites: 3.1.0
 
+  parse-entities@4.0.2:
+    dependencies:
+      '@types/unist': 2.0.11
+      character-entities-legacy: 3.0.0
+      character-reference-invalid: 2.0.1
+      decode-named-character-reference: 1.3.0
+      is-alphanumerical: 2.0.1
+      is-decimal: 2.0.1
+      is-hexadecimal: 2.0.1
+
   parseurl@1.3.3: {}
 
   path-exists@4.0.0: {}
@@ -4828,6 +5584,8 @@ snapshots:
       object-assign: 4.1.1
       react-is: 16.13.1
 
+  property-information@7.1.0: {}
+
   proxy-addr@2.0.7:
     dependencies:
       forwarded: 0.2.0
@@ -4871,6 +5629,24 @@ snapshots:
 
   react-is@16.13.1: {}
 
+  react-markdown@10.1.0(@types/react@19.2.7)(react@19.2.3):
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      '@types/react': 19.2.7
+      devlop: 1.1.0
+      hast-util-to-jsx-runtime: 2.3.6
+      html-url-attributes: 3.0.1
+      mdast-util-to-hast: 13.2.1
+      react: 19.2.3
+      remark-parse: 11.0.0
+      remark-rehype: 11.1.2
+      unified: 11.0.5
+      unist-util-visit: 5.1.0
+      vfile: 6.0.3
+    transitivePeerDependencies:
+      - supports-color
+
   react@19.2.3: {}
 
   read-cache@1.0.0:
@@ -4907,6 +5683,40 @@ snapshots:
       gopd: 1.2.0
       set-function-name: 2.0.2
 
+  remark-gfm@4.0.1:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-gfm: 3.1.0
+      micromark-extension-gfm: 3.0.0
+      remark-parse: 11.0.0
+      remark-stringify: 11.0.0
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-parse@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-from-markdown: 2.0.3
+      micromark-util-types: 2.0.2
+      unified: 11.0.5
+    transitivePeerDependencies:
+      - supports-color
+
+  remark-rehype@11.1.2:
+    dependencies:
+      '@types/hast': 3.0.4
+      '@types/mdast': 4.0.4
+      mdast-util-to-hast: 13.2.1
+      unified: 11.0.5
+      vfile: 6.0.3
+
+  remark-stringify@11.0.0:
+    dependencies:
+      '@types/mdast': 4.0.4
+      mdast-util-to-markdown: 2.1.2
+      unified: 11.0.5
+
   resolve-from@4.0.0: {}
 
   resolve-pkg-maps@1.0.0: {}
@@ -5077,6 +5887,8 @@ snapshots:
 
   source-map-js@1.2.1: {}
 
+  space-separated-tokens@2.0.2: {}
+
   sparse-bitfield@3.0.3:
     dependencies:
       memory-pager: 1.5.0
@@ -5140,6 +5952,11 @@ snapshots:
       define-properties: 1.2.1
       es-object-atoms: 1.1.1
 
+  stringify-entities@4.0.4:
+    dependencies:
+      character-entities-html4: 2.1.0
+      character-entities-legacy: 3.0.0
+
   strip-ansi@6.0.1:
     dependencies:
       ansi-regex: 5.0.1
@@ -5148,6 +5965,14 @@ snapshots:
 
   strip-json-comments@3.1.1: {}
 
+  style-to-js@1.1.21:
+    dependencies:
+      style-to-object: 1.0.14
+
+  style-to-object@1.0.14:
+    dependencies:
+      inline-style-parser: 0.2.7
+
   styled-jsx@5.1.6(@babel/core@7.28.5)(react@19.2.3):
     dependencies:
       client-only: 0.0.1
@@ -5231,6 +6056,10 @@ snapshots:
     dependencies:
       punycode: 2.3.1
 
+  trim-lines@3.0.1: {}
+
+  trough@2.2.0: {}
+
   ts-api-utils@2.1.0(typescript@5.9.3):
     dependencies:
       typescript: 5.9.3
@@ -5339,6 +6168,39 @@ snapshots:
 
   undici-types@6.21.0: {}
 
+  unified@11.0.5:
+    dependencies:
+      '@types/unist': 3.0.3
+      bail: 2.0.2
+      devlop: 1.1.0
+      extend: 3.0.2
+      is-plain-obj: 4.1.0
+      trough: 2.2.0
+      vfile: 6.0.3
+
+  unist-util-is@6.0.1:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-position@5.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-stringify-position@4.0.0:
+    dependencies:
+      '@types/unist': 3.0.3
+
+  unist-util-visit-parents@6.0.2:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+
+  unist-util-visit@5.1.0:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-is: 6.0.1
+      unist-util-visit-parents: 6.0.2
+
   unpipe@1.0.0: {}
 
   update-browserslist-db@1.2.3(browserslist@4.28.1):
@@ -5357,6 +6219,16 @@ snapshots:
 
   vary@1.1.2: {}
 
+  vfile-message@4.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      unist-util-stringify-position: 4.0.0
+
+  vfile@6.0.3:
+    dependencies:
+      '@types/unist': 3.0.3
+      vfile-message: 4.0.3
+
   webidl-conversions@7.0.0: {}
 
   whatwg-url@14.2.0:
@@ -5425,3 +6297,5 @@ snapshots:
       zod: 3.25.76
 
   zod@3.25.76: {}
+
+  zwitch@2.0.4: {}