Got AMP to rip out the guts of the chat ui to make an inspector

This commit is contained in:
Glen Maddern 2025-06-10 16:43:06 +10:00
commit f305b6f1a8
25 changed files with 68 additions and 1722 deletions

View file

@ -1,30 +1,45 @@
# AI chat template
# MCP Inspector
An unofficial template for ⚛️ React ⨉ ⚡️ Vite ⨉ ⛅️ Cloudflare Workers AI.
A minimal demo showcasing the `use-mcp` React hook for connecting to Model Context Protocol (MCP) servers.
Full-stack AI chat application using Workers for the APIs (using the Cloudflare [vite-plugin](https://www.npmjs.com/package/@cloudflare/vite-plugin)) and Vite for the React application (hosted using [Workers Static Assets](https://developers.cloudflare.com/workers/static-assets/)). Provides chat functionality with [Workers AI](https://developers.cloudflare.com/workers-ai/), stores conversations in the browser's [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API), and uses [ai-sdk](https://sdk.vercel.ai/docs/introduction), [tailwindcss](https://tailwindcss.com/) and [workers-ai-provider](https://github.com/cloudflare/workers-ai-provider).
## Features
## Get started
- Connect to any MCP server via URL
- View available tools and their schemas
- Real-time connection status monitoring
- Debug logging for troubleshooting
- Clean, minimal UI focused on MCP functionality
Create the project using [create-cloudflare](https://www.npmjs.com/package/create-cloudflare):
## Getting Started
```sh
npm create cloudflare@latest -- --template thomasgauvin/ai-chat-template
1. Install dependencies:
```bash
pnpm install
```
2. Start the development server:
```bash
pnpm dev
```
3. Open your browser and navigate to the displayed local URL
4. Enter an MCP server URL to test the connection and explore available tools
## What This Demonstrates
This example shows how easy it is to integrate MCP servers into a React application using the `use-mcp` hook. The core functionality is just:
```tsx
import { useMcp } from 'use-mcp/react'
const connection = useMcp({
url: 'your-mcp-server-url',
debug: true,
autoRetry: false
})
// Access connection.state, connection.tools, connection.error, etc.
```
Run the project and deploy it:
```sh
cd <project-name>
npm install
npm run dev
```
```
npm run deploy
```
## What's next?
- Change the name of the package (in `package.json`)
- Change the name of the worker (in `wrangler.jsonc`)
The `McpServers` component wraps this hook to provide a complete UI for server management and tool inspection.

View file

@ -1,118 +0,0 @@
import type { LanguageModelV1StreamPart } from 'ai'
import { streamText, extractReasoningMiddleware, wrapLanguageModel } from 'ai'
import { createWorkersAI } from 'workers-ai-provider'
import { Hono } from 'hono'
interface Env {
ASSETS: Fetcher
AI: Ai
}
type message = {
role: 'system' | 'user' | 'assistant' | 'data'
content: string
}
const app = new Hono<{ Bindings: Env }>()
// Handle the /api/chat endpoint
app.post('/api/chat', async (c) => {
try {
const { messages, reasoning }: { messages: message[]; reasoning: boolean } = await c.req.json()
const workersai = createWorkersAI({ binding: c.env.AI })
// Choose model based on reasoning preference
const model = reasoning
? wrapLanguageModel({
model: workersai('@cf/deepseek-ai/deepseek-r1-distill-qwen-32b'),
middleware: [
extractReasoningMiddleware({ tagName: 'think' }),
//custom middleware to inject <think> tag at the beginning of a reasoning if it is missing
{
wrapGenerate: async ({ doGenerate }) => {
const result = await doGenerate()
if (!result.text?.includes('<think>')) {
result.text = `<think>${result.text}`
}
return result
},
wrapStream: async ({ doStream }) => {
const { stream, ...rest } = await doStream()
let generatedText = ''
const transformStream = new TransformStream<LanguageModelV1StreamPart, LanguageModelV1StreamPart>({
transform(chunk, controller) {
//we are manually adding the <think> tag because some times, distills of reasoning models omit it
if (chunk.type === 'text-delta') {
if (!generatedText.includes('<think>')) {
generatedText += '<think>'
controller.enqueue({
type: 'text-delta',
textDelta: '<think>',
})
}
generatedText += chunk.textDelta
}
controller.enqueue(chunk)
},
})
return {
stream: stream.pipeThrough(transformStream),
...rest,
}
},
},
],
})
: workersai('@cf/meta/llama-3.3-70b-instruct-fp8-fast')
const systemPrompt: message = {
role: 'system',
content: `
- Do not wrap your responses in html tags.
- Do not apply any formatting to your responses.
- You are an expert conversational chatbot. Your objective is to be as helpful as possible.
- You must keep your responses relevant to the user's prompt.
- You must respond with a maximum of 512 tokens (300 words).
- You must respond clearly and concisely, and explain your logic if required.
- You must not provide any personal information.
- Do not respond with your own personal opinions, and avoid topics unrelated to the user's prompt.
${
messages.length <= 1 &&
`- Important REMINDER: You MUST provide a 5 word title at the END of your response using <chat-title> </chat-title> tags.
If you do not do this, this session will error.
For example, <chat-title>Hello and Welcome</chat-title> Hi, how can I help you today?
`
}
`,
}
const text = await streamText({
model,
messages: [systemPrompt, ...messages],
maxTokens: 2048,
maxRetries: 3,
})
return text.toDataStreamResponse({
sendReasoning: true,
})
} catch (error) {
return c.json({ error: `Chat completion failed. ${(error as Error)?.message}` }, 500)
}
})
// Handle static assets and fallback routes
app.all('*', async (c) => {
if (c.env.ASSETS) {
return c.env.ASSETS.fetch(c.req.raw)
}
return c.text('Not found', 404)
})
export default app

View file

@ -1,47 +0,0 @@
import { test, expect } from '@playwright/test'
import { exec } from 'child_process'
import { promisify } from 'util'
const execAsync = promisify(exec)
interface ExecError extends Error {
stdout?: string
stderr?: string
}
test.describe('Build Tests', () => {
test('should build without type errors', async () => {
try {
const { stderr } = await execAsync('pnpm build', {
cwd: process.cwd(),
timeout: 60000
})
// Check for TypeScript compilation errors
expect(stderr).not.toContain('error TS')
expect(stderr).not.toContain('Type error')
} catch (error) {
const execError = error as ExecError
console.error('Build failed:', execError.stdout, execError.stderr)
throw new Error(`Build failed: ${execError.message}`)
}
})
test('should lint without errors', async () => {
try {
const { stderr } = await execAsync('pnpm lint', {
cwd: process.cwd(),
timeout: 30000
})
// ESLint should pass without errors
expect(stderr).not.toContain('error')
} catch (error) {
const execError = error as ExecError
console.error('Lint failed:', execError.stdout, execError.stderr)
throw new Error(`Lint failed: ${execError.message}`)
}
})
})

View file

@ -1,167 +0,0 @@
import { test, expect } from '@playwright/test'
test.describe('Chat Functionality', () => {
test.beforeEach(async ({ page }) => {
// Mock the external AI API calls
await page.route('https://api.groq.com/**', async route => {
// Mock streaming response for Groq
const mockResponse = 'Hello! This is a mocked response from the AI assistant.'
route.fulfill({
status: 200,
headers: {
'Content-Type': 'text/plain',
},
body: mockResponse,
})
})
await page.route('https://api.anthropic.com/**', async route => {
// Mock streaming response for Anthropic
const mockResponse = 'Hello! This is a mocked response from Claude.'
route.fulfill({
status: 200,
headers: {
'Content-Type': 'text/plain',
},
body: mockResponse,
})
})
// Mock the local API endpoint
await page.route('/api/chat', async route => {
const mockResponse = {
choices: [{
delta: {
content: 'Hello! This is a mocked response from the local API.'
}
}]
}
route.fulfill({
status: 200,
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(mockResponse),
})
})
})
test('should load the chat interface', async ({ page }) => {
await page.goto('/')
// Check if the main elements are present
await expect(page.locator('body')).toBeVisible()
// Look for chat-related elements (adjust selectors based on your UI)
const messageInput = page.locator('textarea, input[type="text"]').first()
await expect(messageInput).toBeVisible()
// Check for a send button or similar
const sendButton = page.locator('button').filter({ hasText: /send|submit/i }).first()
if (await sendButton.isVisible()) {
await expect(sendButton).toBeVisible()
}
})
test('should send a message and receive a response', async ({ page }) => {
await page.goto('/')
// Wait for the page to load
await page.waitForLoadState('networkidle')
// Find the message input field
const messageInput = page.locator('textarea, input[type="text"]').first()
await expect(messageInput).toBeVisible()
// Type a test message
const testMessage = 'Hello, can you help me?'
await messageInput.fill(testMessage)
await expect(messageInput).toHaveValue(testMessage)
// Send the message by pressing Enter (most common method)
await messageInput.press('Enter')
// Wait a moment for the form submission to process
await page.waitForTimeout(1000)
// Check that a conversation has started - look for any text content that might be a message
const pageContent = await page.textContent('body')
expect(pageContent).toContain(testMessage)
// The input may or may not clear depending on implementation details
// This is less critical than the message appearing
})
test('should handle API errors gracefully', async ({ page }) => {
// Override mocks to simulate API errors
await page.route('https://api.groq.com/**', async route => {
route.fulfill({
status: 500,
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ error: 'Internal server error' }),
})
})
await page.route('https://api.anthropic.com/**', async route => {
route.fulfill({
status: 401,
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ error: 'Unauthorized' }),
})
})
await page.goto('/')
// Try to send a message
const messageInput = page.locator('textarea, input[type="text"]').first()
await messageInput.fill('Test message')
const sendButton = page.locator('button').filter({ hasText: /send|submit/i }).first()
if (await sendButton.isVisible()) {
await sendButton.click()
} else {
await messageInput.press('Enter')
}
// Should handle the error without crashing
await page.waitForTimeout(2000)
// The app should still be functional (not showing a white screen or error page)
await expect(page.locator('body')).toBeVisible()
})
test('should persist conversations', async ({ page }) => {
await page.goto('/')
// Send a message
const messageInput = page.locator('textarea, input[type="text"]').first()
await messageInput.fill('Test message for persistence')
const sendButton = page.locator('button').filter({ hasText: /send|submit/i }).first()
if (await sendButton.isVisible()) {
await sendButton.click()
} else {
await messageInput.press('Enter')
}
await page.waitForTimeout(2000)
// Refresh the page
await page.reload()
await page.waitForLoadState('networkidle')
// Check if the conversation persisted (this depends on your IndexedDB implementation)
// We'll just verify the page loads correctly after refresh
await expect(page.locator('body')).toBeVisible()
const inputAfterReload = page.locator('textarea, input[type="text"]').first()
await expect(inputAfterReload).toBeVisible()
})
})

View file

@ -1,5 +1,5 @@
{
"name": "ai-chat-template",
"name": "mcp-inspector",
"private": true,
"version": "0.0.0",
"type": "module",
@ -7,37 +7,18 @@
"dev": "vite",
"build": "tsc -b && vite build",
"lint": "eslint .",
"preview": "vite preview",
"deploy": "npm run build && npm exec wrangler deploy",
"test": "playwright test",
"test:ui": "playwright test --ui",
"test:headed": "playwright test --headed",
"test:html": "playwright test --reporter=html"
"preview": "vite preview"
},
"dependencies": {
"@ai-sdk/anthropic": "^1.2.12",
"@ai-sdk/groq": "^1.2.9",
"@tailwindcss/typography": "^0.5.16",
"@tailwindcss/vite": "^4.0.14",
"ai": "^4.1.61",
"hono": "^4.7.9",
"idb": "^8.0.2",
"lucide-react": "^0.482.0",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-markdown": "^10.1.0",
"rehype-highlight": "^7.0.2",
"remark-gfm": "^4.0.1",
"tailwindcss": "^4.0.14",
"use-mcp": "link:..",
"workers-ai-provider": "^0.1.3"
"use-mcp": "link:.."
},
"devDependencies": {
"@ai-sdk/ui-utils": "^1.2.11",
"@cloudflare/vite-plugin": "^0.1.12",
"@cloudflare/workers-types": "^4.20250317.0",
"@eslint/js": "^9.21.0",
"@playwright/test": "^1.52.0",
"@types/react": "^19.0.10",
"@types/react-dom": "^19.0.4",
"@vitejs/plugin-react": "^4.3.4",
@ -48,8 +29,7 @@
"prettier": "^3.5.3",
"typescript": "~5.7.2",
"typescript-eslint": "^8.24.1",
"vite": "^6.2.0",
"wrangler": "^4.1.0"
"vite": "^6.2.0"
},
"packageManager": "pnpm@10.11.0+sha512.6540583f41cc5f628eb3d9773ecee802f4f9ef9923cc45b69890fb47991d4b092964694ec3a4f738a420c918a333062c8b925d312f42e4f0c263eb603551f977"
}

View file

@ -1,41 +0,0 @@
import { defineConfig, devices } from '@playwright/test'
/**
* @see https://playwright.dev/docs/test-configuration
*/
export default defineConfig({
testDir: './e2e',
/* Run tests in files in parallel */
fullyParallel: true,
/* Fail the build on CI if you accidentally left test.only in the source code. */
forbidOnly: !!process.env.CI,
/* Retry on CI only */
retries: process.env.CI ? 2 : 0,
/* Opt out of parallel tests on CI. */
workers: process.env.CI ? 1 : undefined,
/* Reporter to use. See https://playwright.dev/docs/test-reporters */
reporter: 'list',
/* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
use: {
/* Base URL to use in actions like `await page.goto('/')`. */
baseURL: 'http://localhost:5173',
/* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
trace: 'on-first-retry',
},
/* Configure projects for major browsers */
projects: [
{
name: 'chromium',
use: { ...devices['Desktop Chrome'] },
},
],
/* Run your local dev server before starting the tests */
webServer: {
command: 'pnpm dev',
url: 'http://localhost:5173',
reuseExistingServer: !process.env.CI,
},
})

View file

@ -1,11 +1,19 @@
import ChatApp from "./components/ChatApp";
import { McpServers } from './components/McpServers.js'
function App() {
return (
<>
<ChatApp />
</>
);
<div className="min-h-screen bg-gray-50 flex items-center justify-center p-4">
<div className="w-full max-w-2xl">
<div className="text-center mb-8">
<h1 className="text-3xl font-bold text-gray-900 mb-2">MCP Inspector</h1>
<p className="text-gray-600">
Minimal demo showcasing the use-mcp React hook
</p>
</div>
<McpServers />
</div>
</div>
)
}
export default App;
export default App

View file

@ -1,122 +0,0 @@
import React, { useState } from 'react'
import { createPortal } from 'react-dom'
import { X, Eye, EyeOff } from 'lucide-react'
import { type ModelProvider } from '../types/models'
interface ApiKeyModalProps {
isOpen: boolean
onClose: () => void
provider: ModelProvider
onSave: (apiKey: string) => void
}
const ApiKeyModal: React.FC<ApiKeyModalProps> = ({
isOpen,
onClose,
provider,
onSave,
}) => {
const [apiKey, setApiKey] = useState('')
const [showApiKey, setShowApiKey] = useState(false)
if (!isOpen) return null
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault()
if (apiKey.trim()) {
onSave(apiKey.trim())
setApiKey('')
onClose()
}
}
const handleClose = () => {
setApiKey('')
onClose()
}
const modalContent = (
<div
className="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50"
onClick={handleClose}
>
<div
className="bg-white rounded-lg p-6 w-full max-w-md mx-4"
onClick={(e) => e.stopPropagation()}
>
<div className="flex items-center justify-between mb-4">
<h2 className="text-lg font-semibold text-zinc-900">
{provider.logo} {provider.name} API Key
</h2>
<button
onClick={handleClose}
className="text-zinc-400 hover:text-zinc-600 p-1"
>
<X size={20} />
</button>
</div>
<p className="text-sm text-zinc-600 mb-4">
Enter your {provider.name} API key to use this model. Your key will be stored locally in your browser.
</p>
<form onSubmit={handleSubmit}>
<div className="mb-4">
<label htmlFor="apiKey" className="block text-sm font-medium text-zinc-700 mb-2">
API Key
</label>
<div className="relative">
<input
type={showApiKey ? 'text' : 'password'}
id="apiKey"
value={apiKey}
onChange={(e) => setApiKey(e.target.value)}
className="w-full px-3 py-2 border border-zinc-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent pr-10"
placeholder={`Enter your ${provider.name} API key`}
autoComplete="off"
/>
<button
type="button"
onClick={() => setShowApiKey(!showApiKey)}
className="absolute inset-y-0 right-0 pr-3 flex items-center text-zinc-400 hover:text-zinc-600"
>
{showApiKey ? <EyeOff size={16} /> : <Eye size={16} />}
</button>
</div>
</div>
<div className="flex items-center justify-between">
<a
href={provider.documentationUrl}
target="_blank"
rel="noopener noreferrer"
className="text-sm text-blue-600 hover:text-blue-800"
>
Get API key →
</a>
<div className="flex gap-2">
<button
type="button"
onClick={handleClose}
className="px-4 py-2 text-sm text-zinc-600 hover:text-zinc-800"
>
Cancel
</button>
<button
type="submit"
disabled={!apiKey.trim()}
className="px-4 py-2 text-sm bg-blue-600 text-white rounded-md hover:bg-blue-700 disabled:bg-zinc-300 disabled:cursor-not-allowed"
>
Save
</button>
</div>
</div>
</form>
</div>
</div>
)
return createPortal(modalContent, document.body)
}
export default ApiKeyModal

View file

@ -1,138 +0,0 @@
import React, { useState, useEffect } from "react";
import ChatSidebar from "./ChatSidebar.tsx";
import ChatNavbar from "./ChatNavbar.tsx";
import ConversationThread from "./ConversationThread.tsx";
import { storeName } from "../consts.ts";
import { type Conversation } from "../types";
import { useIndexedDB } from "../hooks/useIndexedDB";
import { type Model } from "../types/models";
import { getSelectedModel, setSelectedModel as saveSelectedModel } from "../utils/modelPreferences";
import { type IDBPDatabase } from "idb";
// eslint-disable-next-line @typescript-eslint/no-empty-object-type
interface ChatAppProps {}
const ChatApp: React.FC<ChatAppProps> = () => {
const [conversations, setConversations] = useState<Conversation[]>([]);
const [conversationId, setConversationId] = useState<number | undefined>(
undefined
);
const [sidebarVisible, setSidebarVisible] = useState<boolean>(true);
const [selectedModel, setSelectedModel] = useState<Model>(getSelectedModel());
const [apiKeyUpdateTrigger, setApiKeyUpdateTrigger] = useState<number>(0);
const db = useIndexedDB();
const handleApiKeyUpdate = () => {
setApiKeyUpdateTrigger(prev => prev + 1);
};
const handleModelChange = (model: Model) => {
setSelectedModel(model);
saveSelectedModel(model);
};
// set up conversations on app load
useEffect(() => {
getConversations();
deleteUnusedConversations();
startNewConversation();
}, [db]);
// Initialize sidebar visibility based on screen size
useEffect(() => {
const isMobile = window.matchMedia("(max-width: 768px)").matches;
setSidebarVisible(!isMobile);
}, []);
const getConversations = async () => {
if (!db) return;
const conversations = (await db.getAll(storeName)) as Conversation[];
const inverseConversations = conversations.reverse();
setConversations(inverseConversations);
};
const deleteConversation = async (id: number, showPromptToUser = true) => {
try {
if (
showPromptToUser &&
!window.confirm("Are you sure you want to delete this conversation?")
) {
return;
}
await db?.delete(storeName, id);
setConversations((prev) => prev.filter((conv) => conv.id !== id));
setConversationId(conversations[0]?.id);
} catch (error) {
console.error("Failed to delete conversation:", error);
}
};
const editConversationTitle = async (id: number, newTitle: string) => {
const conversation = (await db!.get(storeName, id)) as Conversation;
conversation.title = newTitle;
await db!.put(storeName, conversation);
setConversations((prev) =>
prev.map((conv) => (conv.id === id ? { ...conv, title: newTitle } : conv))
);
};
const startNewConversation = async () => {
//create unique id for new conversation
setConversationId(Date.now() + Math.floor(Math.random() * 1000));
if (window.matchMedia("(max-width: 768px)").matches) {
setSidebarVisible(false);
}
};
// delete conversations with no messages
const deleteUnusedConversations = async () => {
if (!db) return;
const conversations = (await db.getAll(storeName)) as Conversation[];
const unusedConversations = conversations.filter(
(conversation) => conversation.messages.length === 0
);
for (const conversation of unusedConversations) {
deleteConversation(conversation.id as number, false);
}
};
return (
<div className="flex h-dvh w-screen overflow-clip bg-white">
<div className="flex flex-row flex-grow flex-1 overflow-hidden relative">
<ChatSidebar
sidebarVisible={sidebarVisible}
setSidebarVisible={setSidebarVisible}
conversations={conversations}
conversationId={conversationId}
setConversationId={setConversationId}
deleteConversation={deleteConversation}
editConversationTitle={editConversationTitle}
startNewConversation={startNewConversation}
selectedModel={selectedModel}
onModelChange={handleModelChange}
apiKeyUpdateTrigger={apiKeyUpdateTrigger}
/>
<div className="flex flex-col flex-grow h-full w-[calc(100%-16rem)] lg:w-[calc(100%-32rem)]">
<ChatNavbar
sidebarVisible={sidebarVisible}
setSidebarVisible={setSidebarVisible}
/>
<ConversationThread
conversations={conversations}
conversationId={conversationId}
setConversationId={setConversationId}
setConversations={setConversations}
db={db as IDBPDatabase}
selectedModel={selectedModel}
onApiKeyUpdate={handleApiKeyUpdate}
/>
</div>
</div>
</div>
);
};
export default ChatApp;

View file

@ -1,63 +0,0 @@
import React, { FormEvent, KeyboardEvent, useRef, useEffect, Dispatch, SetStateAction } from 'react'
import { Send, Pause } from 'lucide-react'
interface ChatInputProps {
input: string
setInput: Dispatch<SetStateAction<string>>
handleSubmit: (e: FormEvent) => void
isLoading: boolean
streamStarted: boolean
controller: AbortController
messagesCount: number
}
const ChatInput: React.FC<ChatInputProps> = ({ input, setInput, handleSubmit, isLoading, streamStarted, controller, messagesCount }) => {
const textareaRef = useRef<HTMLTextAreaElement>(null)
useEffect(() => {
if (textareaRef.current) {
textareaRef.current.style.height = 'auto'
textareaRef.current.style.height = `${textareaRef.current.scrollHeight}px`
}
}, [input])
const handleKeyDown = (e: KeyboardEvent<HTMLTextAreaElement>) => {
if (e.key === 'Enter' && !e.shiftKey) {
e.preventDefault()
handleSubmit(e as unknown as FormEvent)
}
if (e.key === 'Enter' && e.shiftKey) {
e.preventDefault()
setInput((prev: string) => prev + '\n')
}
}
return (
<div className="relative rounded-lg border border-zinc-200 bg-white shadow-sm">
<form onSubmit={handleSubmit} className={`w-full items-center`}>
<div className="flex justify-end items-center">
<textarea
ref={textareaRef}
value={input}
rows={1}
onChange={(e) => setInput(e.target.value)}
onKeyDown={handleKeyDown}
className="w-full flex-1 p-3 bg-transparent resize-none focus:outline-none"
placeholder={messagesCount === 0 ? 'Ask anything...' : 'Type your message...'}
style={{ maxHeight: '200px' }}
/>
<button
type={isLoading && streamStarted ? 'button' : 'submit'}
onClick={isLoading && streamStarted ? () => controller.abort() : undefined}
className="m-2 hover:bg-zinc-100 rounded-lg p-2 text-zinc-600 hover:text-zinc-900"
disabled={!isLoading && !input.trim()}
>
{isLoading && streamStarted ? <Pause size={20} /> : <Send size={20} />}
</button>
</div>
</form>
</div>
)
}
export default ChatInput

View file

@ -1,46 +0,0 @@
import React from "react";
import ReactMarkdown from "react-markdown";
import remarkGfm from "remark-gfm";
import rehypeHighlight from "rehype-highlight";
import { type Message } from "../types";
interface ChatMessageProps {
message: Message;
}
const ChatMessage: React.FC<ChatMessageProps> = ({
message,
}) => {
return (
<div
className={`flex ${
message.role === "user" ? "justify-end" : "justify-start"
}`}
>
<div
className={`
${
message.role === "user"
? "max-w-[80%] rounded-2xl px-3 py-2 border border-zinc-200/10 bg-zinc-100 text-black"
: " text-zinc-900 w-full"
}`}
>
<div className="prose prose-zinc">
<ReactMarkdown
remarkPlugins={[remarkGfm]}
rehypePlugins={[rehypeHighlight]}
components={{
table: ({ children }) => (
<div className="overflow-x-scroll text-sm">{children}</div>
),
}}
>
{message.content}
</ReactMarkdown>
</div>
</div>
</div>
);
};
export default ChatMessage;

View file

@ -1,39 +0,0 @@
import React from "react";
import { PanelLeftOpen } from "lucide-react";
interface ChatNavbarProps {
sidebarVisible: boolean;
setSidebarVisible: React.Dispatch<React.SetStateAction<boolean>>;
}
const ChatNavbar: React.FC<ChatNavbarProps> = ({
sidebarVisible,
setSidebarVisible,
}) => {
return (
<div className="sticky top-0 bg-white border-b border-zinc-200 z-10">
<div className="my-3 mx-2 flex items-center justify-between">
<div className="flex items-center">
{!sidebarVisible && (
<div>
<button
onClick={() => setSidebarVisible(!sidebarVisible)}
className="
rounded-lg p-[0.4em]
hover:bg-zinc-100 hover:cursor-pointer
mr-2 transition-colors text-zinc-600 hover:text-zinc-800"
>
<PanelLeftOpen size={20} />
</button>
</div>
)}
<h1 className="text-base font-semibold text-zinc-600 ml-2">
AI Chat Template
</h1>
</div>
</div>
</div>
);
};
export default ChatNavbar;

View file

@ -1,174 +0,0 @@
import React from "react";
import {
Edit,
Trash2,
PanelLeftClose,
PanelLeftOpen,
SquarePen,
} from "lucide-react";
import ModelSelector from "./ModelSelector";
import { McpServers } from "./McpServers";
import { type Model } from "../types/models";
import { type Message } from "../types";
interface Conversation {
id?: number;
title: string;
messages: Message[];
}
interface ChatSidebarProps {
sidebarVisible: boolean;
setSidebarVisible: React.Dispatch<React.SetStateAction<boolean>>;
conversations: Conversation[];
conversationId: number | undefined;
setConversationId: React.Dispatch<React.SetStateAction<number | undefined>>;
deleteConversation: (id: number) => void;
editConversationTitle: (id: number, newTitle: string) => void;
startNewConversation: () => void;
selectedModel: Model;
onModelChange: (model: Model) => void;
apiKeyUpdateTrigger: number;
}
const ChatSidebar: React.FC<ChatSidebarProps> = ({
sidebarVisible,
setSidebarVisible,
conversations,
conversationId,
setConversationId,
deleteConversation,
editConversationTitle,
startNewConversation,
selectedModel,
onModelChange,
apiKeyUpdateTrigger,
}) => {
const handleConversationClick = (id: number | undefined) => {
setConversationId(id);
if (window.matchMedia("(max-width: 768px)").matches) {
setSidebarVisible(false);
}
};
return (
<>
{/* Mobile overlay */}
{sidebarVisible && (
<div
className="md:hidden fixed inset-0 bg-black/30 z-20"
onClick={() => setSidebarVisible(false)}
/>
)}
<div
className={`
fixed md:relative
z-30 md:z-auto
h-full
bg-zinc-50
transition-all duration-300
${
sidebarVisible
? "w-64 lg:w-[32rem] translate-x-0"
: "w-0 -translate-x-full md:translate-x-0"
}
`}
>
<div
className={`m-2 flex items-center justify-between
${sidebarVisible ? "sticky" : "hidden"}
`}
>
<button
onClick={() => setSidebarVisible(!sidebarVisible)}
className="
rounded-lg p-[0.4em]
hover:bg-zinc-100 hover:cursor-pointer
transition-colors text-zinc-600 hover:text-zinc-800"
>
{sidebarVisible ? (
<PanelLeftClose size={20} />
) : (
<PanelLeftOpen size={20} />
)}
</button>
<button
className="rounded-lg p-[0.4em]
hover:bg-zinc-100 hover:cursor-pointer
transition-colors text-zinc-600 hover:text-zinc-800"
onClick={startNewConversation}
>
<SquarePen size={20} />
</button>
</div>
<div
className=" h-[calc(100%-3rem)]
overflow-y-scroll scrollbar-thin
flex flex-col justify-between border-r border-zinc-200 transition-all duration-300"
>
<div className="flex flex-col">
<ul className="p-2 space-y-1">
{conversations.map((conversation) => (
<li
key={conversation.id}
className={`cursor-pointer p-2 transition-colors rounded-lg ${
conversation.id === conversationId ||
(!conversationId && !conversation.id)
? "bg-zinc-200 text-zinc-900"
: "hover:bg-zinc-200 text-zinc-600"
}`}
onClick={() => handleConversationClick(conversation.id)}
>
<div className="flex items-center justify-between">
<span className="truncate flex-grow text-sm">
{conversation.title}
</span>
<div className="flex space-x-2 ml-2">
<button
className="opacity-60 hover:opacity-100 transition-opacity"
onClick={(e) => {
e.stopPropagation();
const newTitle = prompt(
"Enter new title:",
conversation.title
);
if (newTitle)
editConversationTitle(conversation.id!, newTitle);
}}
>
<Edit size={14} />
</button>
<button
className="opacity-60 hover:opacity-100 transition-opacity"
onClick={(e) => {
e.stopPropagation();
deleteConversation(conversation.id!);
setConversationId(undefined);
}}
>
<Trash2 size={14} />
</button>
</div>
</div>
</li>
))}
</ul>
</div>
{/* Model Selector and MCP Servers at bottom */}
<div className="p-2 border-t border-zinc-200 space-y-3">
<ModelSelector
selectedModel={selectedModel}
onModelChange={onModelChange}
apiKeyUpdateTrigger={apiKeyUpdateTrigger}
/>
<McpServers />
</div>
</div>
</div>
</>
);
};
export default ChatSidebar;

View file

@ -1,219 +0,0 @@
import React, { useState, useEffect, FormEvent } from 'react'
import { storeName } from '../consts'
import '../styles/scrollbar.css'
import '../styles/github.css'
import { type Conversation, type Message } from '../types'
import { type Model } from '../types/models'
import { type IDBPDatabase } from 'idb'
import ChatMessage from './ChatMessage'
import ChatInput from './ChatInput'
import { useAutoscroll } from '../hooks/useAutoscroll'
import { useStreamResponse } from '../hooks/useStreamResponse'
import { setApiKey } from '../utils/apiKeys'
import ApiKeyModal from './ApiKeyModal'
interface ConversationThreadProps {
conversations: Conversation[]
conversationId?: number
setConversationId: (id: number) => void
setConversations: React.Dispatch<React.SetStateAction<Conversation[]>>
db: IDBPDatabase
selectedModel: Model
onApiKeyUpdate: () => void
}
const ConversationThread: React.FC<ConversationThreadProps> = ({
conversations,
conversationId,
setConversationId,
setConversations,
db,
selectedModel,
onApiKeyUpdate,
}) => {
const [input, setInput] = useState<string>('')
const [apiKeyModal, setApiKeyModal] = useState<{ isOpen: boolean; model: Model | null }>({
isOpen: false,
model: null,
})
const { messagesEndRef, messagesContainerRef, scrollToBottom } = useAutoscroll()
const handleApiKeyRequired = async (model: Model): Promise<boolean> => {
return new Promise((resolve) => {
setApiKeyModal({
isOpen: true,
model,
})
// Store the resolve function to call when modal is closed
window.apiKeyModalResolve = resolve
})
}
const handleApiKeySave = (apiKey: string) => {
if (apiKeyModal.model) {
setApiKey(apiKeyModal.model.provider.id, apiKey)
setApiKeyModal({ isOpen: false, model: null })
// Notify parent that API key was updated
onApiKeyUpdate()
// Resolve the promise to continue with the request
if (window.apiKeyModalResolve) {
window.apiKeyModalResolve(true)
delete window.apiKeyModalResolve
}
}
}
const handleApiKeyCancel = () => {
setApiKeyModal({ isOpen: false, model: null })
// Resolve the promise with false to cancel the request
if (window.apiKeyModalResolve) {
window.apiKeyModalResolve(false)
delete window.apiKeyModalResolve
}
}
const { isLoading, setIsLoading, streamStarted, controller, streamResponse, aiResponseRef } = useStreamResponse({
conversationId,
setConversations,
scrollToBottom,
selectedModel,
onApiKeyRequired: handleApiKeyRequired,
})
const currentConversation = conversations.find((conv) => conv.id === conversationId) || { messages: [], title: '' }
//when new message chunks are streamed in, scroll to bottom
useEffect(() => {
scrollToBottom()
}, [aiResponseRef.current])
//when conversation changes, scroll to bottom
useEffect(scrollToBottom, [conversationId])
//when conversation changes, reset input
useEffect(() => {
setInput('')
}, [conversationId])
const handleSubmit = async (e: FormEvent) => {
e.preventDefault()
if (!input.trim()) return
if (currentConversation.messages.length === 0) {
setConversations((prev) => {
const updated = [...prev]
updated.unshift({
id: conversationId,
title: 'New conversation',
messages: [],
})
return updated
})
}
const userMessage: Message = { role: 'user', content: input }
setInput('')
setIsLoading(true)
setConversations((prev) => {
const updated = [...prev]
const conv = updated.find((c) => c.id === conversationId)
if (conv && conv.messages?.[conv.messages.length - 1] !== userMessage) {
conv.messages.push(userMessage)
}
return updated
})
await streamResponse([...currentConversation.messages, userMessage])
setIsLoading(false)
}
const storeMessages = async () => {
if (!currentConversation.messages || currentConversation.messages.length === 0) {
return
}
const store = db.transaction(storeName, 'readwrite').objectStore(storeName)
const objectData = {
id: conversationId,
title: currentConversation.title,
messages: currentConversation.messages,
}
const value = await store.put(objectData)
setConversationId(Number(value))
}
useEffect(() => {
if (db && conversationId) {
storeMessages()
}
}, [conversations])
console.log({ currentConversation })
return (
<div className={`flex flex-col h-[calc(100%-3rem)] w-full ${currentConversation.messages.length === 0 ? 'justify-center' : ''}`}>
<div
ref={messagesContainerRef}
className={`
overflow-x-hidden
${currentConversation.messages.length === 0 ? 'flex items-center justify-center pb-6' : 'flex-1 overflow-y-scroll'}`}
>
<div className="max-w-2xl mx-auto w-full px-4">
{currentConversation.messages.length === 0 ? (
<div className="text-center">
<h1 className="text-4xl font-semibold text-zinc-800">What do you want to know?</h1>
<div className="mt-4">
<h2 className="mt-2 text-md opacity-70">
AI chat template built with React, Vite and Cloudflare Workers AI.
<div className="mt-1 w-full">
Find the source code on{' '}
<a className="text-blue-700" href="https://github.com/thomasgauvin/ai-chat-template">
GitHub
</a>
.
</div>
</h2>
</div>
</div>
) : (
<div className="py-4 px-4 space-y-4">
{currentConversation.messages.map((message, index) => (
<ChatMessage key={index} message={message} />
))}
{isLoading && !streamStarted && <div className="text-center text-sm text-zinc-600">Thinking...</div>}
<div ref={messagesEndRef} />
</div>
)}
</div>
</div>
<div className={`p-4 ${currentConversation.messages.length === 0 ? 'pb-35' : ''}`}>
<div className="max-w-2xl mx-auto">
<ChatInput
input={input}
setInput={setInput}
handleSubmit={handleSubmit}
isLoading={isLoading}
streamStarted={streamStarted}
controller={controller}
messagesCount={currentConversation.messages.length}
/>
</div>
</div>
<ApiKeyModal
isOpen={apiKeyModal.isOpen}
onClose={handleApiKeyCancel}
provider={apiKeyModal.model?.provider ?? { id: '', name: '', baseUrl: '', apiKeyHeader: '', documentationUrl: '' }}
onSave={handleApiKeySave}
/>
</div>
)
}
export default ConversationThread

View file

@ -262,21 +262,31 @@ export function McpServers({
{/* Tools display when connected */}
{state === 'ready' && tools.length > 0 && (
<div>
<h3 className="font-medium text-xs mb-2">
<h3 className="font-medium text-sm mb-3">
Available Tools ({tools.length})
</h3>
<div className="border border-gray-200 rounded p-2 bg-gray-50 max-h-32 overflow-y-auto space-y-2">
<div className="border border-gray-200 rounded p-4 bg-gray-50 max-h-96 overflow-y-auto space-y-3">
{tools.map((tool: Tool, index: number) => (
<div
key={index}
className="text-xs pb-2 border-b border-gray-100 last:border-b-0"
className="bg-white p-3 rounded border border-gray-100 shadow-sm"
>
<span className="font-medium">{tool.name}</span>
<div className="font-mono font-medium text-sm text-blue-700">
{tool.name}
</div>
{tool.description && (
<p className="text-gray-500 mt-1 text-xs">
<p className="text-gray-600 mt-2 text-sm leading-relaxed">
{tool.description}
</p>
)}
{tool.inputSchema && (
<div className="mt-3 pt-2 border-t border-gray-100">
<div className="text-xs font-medium text-gray-700 mb-2">Parameters:</div>
<pre className="text-xs text-gray-600 bg-gray-50 p-2 rounded overflow-x-auto">
{JSON.stringify(tool.inputSchema, null, 2)}
</pre>
</div>
)}
</div>
))}
</div>

View file

@ -1,146 +0,0 @@
import React, { useState, useEffect, useRef } from 'react'
import { ChevronDown, AlertCircle, X } from 'lucide-react'
import { availableModels, type Model } from '../types/models'
import { hasApiKey, setApiKey, clearApiKey } from '../utils/apiKeys'
import ApiKeyModal from './ApiKeyModal'
interface ModelSelectorProps {
selectedModel: Model
onModelChange: (model: Model) => void
apiKeyUpdateTrigger: number
}
const ModelSelector: React.FC<ModelSelectorProps> = ({
selectedModel,
onModelChange,
apiKeyUpdateTrigger,
}) => {
const [isOpen, setIsOpen] = useState(false)
const [apiKeyModal, setApiKeyModal] = useState<{ isOpen: boolean; model: Model | null }>({
isOpen: false,
model: null,
})
const [apiKeyStatuses, setApiKeyStatuses] = useState<Record<string, boolean>>({})
const dropdownRef = useRef<HTMLDivElement>(null)
useEffect(() => {
const statuses: Record<string, boolean> = {}
availableModels.forEach(model => {
statuses[model.provider.id] = hasApiKey(model.provider.id)
})
setApiKeyStatuses(statuses)
}, [apiKeyUpdateTrigger])
useEffect(() => {
const handleClickOutside = (event: MouseEvent) => {
if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
setIsOpen(false)
}
}
if (isOpen) {
document.addEventListener('mousedown', handleClickOutside)
return () => document.removeEventListener('mousedown', handleClickOutside)
}
}, [isOpen])
const handleModelSelect = (model: Model) => {
const hasKey = hasApiKey(model.provider.id)
if (!hasKey) {
setApiKeyModal({ isOpen: true, model })
} else {
onModelChange(model)
}
setIsOpen(false)
}
const handleApiKeySave = (apiKey: string) => {
if (apiKeyModal.model) {
setApiKey(apiKeyModal.model.provider.id, apiKey)
setApiKeyStatuses(prev => ({ ...prev, [apiKeyModal.model!.provider.id]: true }))
onModelChange(apiKeyModal.model)
}
}
const handleClearApiKey = (providerId: string, e: React.MouseEvent) => {
e.stopPropagation()
clearApiKey(providerId)
setApiKeyStatuses(prev => ({ ...prev, [providerId]: false }))
}
const getApiKeyIcon = (providerId: string) => {
const hasKey = apiKeyStatuses[providerId]
if (hasKey) {
return (
<button
onClick={(e) => handleClearApiKey(providerId, e)}
className="text-zinc-400 hover:text-red-500 p-1"
title="Clear token"
>
<X size={14} />
</button>
)
} else {
return (
<div className="text-red-500 p-1" title="API Key not found">
<AlertCircle size={14} />
</div>
)
}
}
return (
<>
<div className="relative" ref={dropdownRef}>
<button
onClick={() => setIsOpen(!isOpen)}
className="w-full flex items-center justify-between p-3 text-left bg-white border border-zinc-200 rounded-lg hover:bg-zinc-50 focus:outline-none focus:ring-2 focus:ring-blue-500"
>
<div className="flex items-center gap-2">
<span className="text-lg">{selectedModel.provider.logo}</span>
<div>
<div className="font-medium text-zinc-900">{selectedModel.name}</div>
<div className="text-xs text-zinc-500">{selectedModel.provider.name}</div>
</div>
</div>
<div className="flex items-center gap-1">
{getApiKeyIcon(selectedModel.provider.id)}
<ChevronDown size={16} className={`text-zinc-400 transition-transform ${isOpen ? 'rotate-180' : ''}`} />
</div>
</button>
{isOpen && (
<div className="absolute bottom-full left-0 right-0 mb-2 bg-white border border-zinc-200 rounded-lg shadow-lg z-50">
{availableModels.map((model) => (
<button
key={model.id}
onClick={() => handleModelSelect(model)}
className="w-full flex items-center justify-between p-3 text-left hover:bg-zinc-50 first:rounded-t-lg last:rounded-b-lg"
>
<div className="flex items-center gap-2">
<span className="text-lg">{model.provider.logo}</span>
<div>
<div className="font-medium text-zinc-900">{model.name}</div>
<div className="text-xs text-zinc-500">{model.provider.name}</div>
</div>
</div>
{getApiKeyIcon(model.provider.id)}
</button>
))}
</div>
)}
</div>
<ApiKeyModal
isOpen={apiKeyModal.isOpen}
onClose={() => setApiKeyModal({ isOpen: false, model: null })}
provider={apiKeyModal.model?.provider ?? { id: '', name: '', baseUrl: '', apiKeyHeader: '', documentationUrl: '' }}
onSave={handleApiKeySave}
/>
</>
)
}
export default ModelSelector

View file

@ -1,2 +0,0 @@
export const storeName = "conversations";
export const dbName = "localgpt";

View file

@ -1,36 +0,0 @@
import { useEffect, useRef } from "react";
export const useAutoscroll = () => {
const messagesEndRef = useRef<HTMLDivElement>(null);
const messagesContainerRef = useRef<HTMLDivElement>(null);
const shouldAutoScrollRef = useRef(true);
useEffect(() => {
const container = messagesContainerRef.current;
if (!container) return;
const handleScroll = () => {
const isAtBottom =
container.scrollHeight - container.clientHeight - container.scrollTop <=
200;
shouldAutoScrollRef.current = isAtBottom;
};
container.addEventListener("scroll", handleScroll);
return () => {
container.removeEventListener("scroll", handleScroll);
};
}, []);
const scrollToBottom = () => {
if (shouldAutoScrollRef.current) {
messagesEndRef.current?.scrollIntoView({ behavior: "smooth" });
}
};
return {
messagesEndRef,
messagesContainerRef,
scrollToBottom,
};
};

View file

@ -1,24 +0,0 @@
import { useState, useEffect } from "react";
import { openDB, IDBPDatabase } from "idb";
import { dbName, storeName } from "../consts";
export function useIndexedDB() {
const [db, setDb] = useState<IDBPDatabase | null>(null);
useEffect(() => {
const initDb = async () => {
const db = await openDB(dbName, 1, {
upgrade(db) {
db.createObjectStore(storeName, {
keyPath: "id",
autoIncrement: true,
});
},
});
setDb(db);
};
initDb();
}, []);
return db;
}

View file

@ -1,153 +0,0 @@
import { useState, useRef } from 'react'
import { streamText } from 'ai'
import { createGroq } from '@ai-sdk/groq'
import { createAnthropic } from '@ai-sdk/anthropic'
import { type Message, type Conversation } from '../types'
import { type Model } from '../types/models'
import { getApiKey } from '../utils/apiKeys'
interface UseStreamResponseProps {
conversationId?: number
setConversations: React.Dispatch<React.SetStateAction<Conversation[]>>
scrollToBottom: () => void
selectedModel: Model
onApiKeyRequired: (model: Model) => Promise<boolean>
}
export const useStreamResponse = ({
conversationId,
setConversations,
scrollToBottom,
selectedModel,
onApiKeyRequired,
}: UseStreamResponseProps) => {
const [isLoading, setIsLoading] = useState(false)
const [streamStarted, setStreamStarted] = useState(false)
const [controller, setController] = useState(new AbortController())
const aiResponseRef = useRef<string>('')
const getModelInstance = (model: Model, apiKey: string) => {
switch (model.provider.id) {
case 'groq': {
const groqProvider = createGroq({ apiKey })
return groqProvider(model.modelId)
}
case 'anthropic': {
const anthropicProvider = createAnthropic({
apiKey,
headers: {
'anthropic-dangerous-direct-browser-access': 'true',
},
})
return anthropicProvider(model.modelId)
}
default:
throw new Error(`Unsupported provider: ${model.provider.id}`)
}
}
const streamResponse = async (messages: Message[]) => {
let aiResponse = ''
console.log({ messages })
// Check if API key is available
let apiKey = getApiKey(selectedModel.provider.id)
if (!apiKey) {
const keyProvided = await onApiKeyRequired(selectedModel)
if (!keyProvided) {
return // User cancelled
}
apiKey = getApiKey(selectedModel.provider.id)
if (!apiKey) {
throw new Error('No API key provided')
}
}
try {
const modelInstance = getModelInstance(selectedModel, apiKey)
setConversations((prev) => {
const updated = [...prev]
const conv = updated.find((c) => c.id === conversationId)
if (conv) {
console.log('POPPING')
conv.messages.push({ role: 'assistant', content: '' })
}
return updated
})
setStreamStarted(true)
const result = await streamText({
model: modelInstance,
messages: messages.map((msg) => ({
role: msg.role,
content: msg.content,
})),
abortSignal: controller.signal,
})
for await (const chunk of result.textStream) {
try {
aiResponse += chunk
aiResponseRef.current = aiResponse
//custom extraction of <chat-title> tag
const titleMatch = aiResponse.match(/<chat-title>(.*?)<\/chat-title>/)
if (titleMatch) {
const title = titleMatch[1].trim()
setConversations((prev) => {
const updated = [...prev]
const conv = updated.find((c) => c.id === conversationId)
if (conv) {
conv.title = title
}
return updated
})
aiResponse = aiResponse.replace(/<chat-title>.*?<\/chat-title>/, '').trim()
}
setConversations((prev) => {
const updated = [...prev]
const conv = updated.find((c) => c.id === conversationId)
if (conv) {
conv.messages[conv.messages.length - 1].content = aiResponse
}
return updated
})
scrollToBottom()
} catch (e) {
console.log('Error in text chunk', e)
}
}
} catch (error: unknown) {
if (controller.signal.aborted) {
console.log('Stream aborted')
} else {
console.error('Error generating response:', error)
// Remove the assistant message if there was an error
setConversations((prev) => {
const updated = [...prev]
const conv = updated.find((c) => c.id === conversationId)
if (conv && conv.messages[conv.messages.length - 1].role === 'assistant') {
conv.messages.pop()
}
return updated
})
}
} finally {
setStreamStarted(false)
setController(new AbortController())
}
return aiResponse
}
return {
isLoading,
setIsLoading,
streamStarted,
controller,
streamResponse,
aiResponseRef,
}
}

Some files were not shown because too many files have changed in this diff Show more