Nicholai 7f5efb84e2 feat(agent): migrate to Anthropic Agents SDK

Replace Vercel AI SDK with Anthropic Claude Agent SDK.
Add standalone agent server (packages/agent-server/)
with MCP tools, JWT auth, and SSE streaming. Introduce
bridge API routes (src/app/api/compass/) and custom
SSE hooks (use-agent, use-compass-chat) replacing
useChat. Remove provider.ts, tools.ts, system-prompt.ts,
github-tools.ts, usage.ts, and old agent route.

2026-02-16 18:37:26 -07:00

2.4 KiB

Raw Blame History

Agent Server

Standalone Node.js agent server wrapping the Anthropic Agent SDK for Compass.

Overview

This server provides an SSE (Server-Sent Events) endpoint that streams AI agent responses using the Anthropic Agent SDK. It handles authentication, session management, and tool execution via MCP (Model Context Protocol) servers.

Environment Variables

Required:

AGENT_AUTH_SECRET - HS256 JWT signing secret for authentication

Optional:

ANTHROPIC_API_KEY - Direct Anthropic API key (can be overridden by user BYOK)
ANTHROPIC_BASE_URL - Set to OpenRouter URL for OpenRouter mode
ALLOWED_ORIGINS - Comma-separated list of allowed CORS origins (default: http://localhost:3000)
PORT - Server port (default: 3001)

API Endpoints

POST /agent/chat

Stream AI agent responses via SSE.

Headers:

Authorization: Bearer <jwt> - Required JWT token
x-session-id: <uuid> - Session identifier (optional, auto-generated if missing)
x-current-page: <path> - Current page path for context
x-timezone: <tz> - User timezone
x-user-api-key: <key> - User's own API key (BYOK, takes priority over server key)

Request Body:

{
  "messages": [
    { "role": "user", "content": "Hello" },
    { "role": "assistant", "content": "Hi there!" },
    { "role": "user", "content": "What can you do?" }
  ]
}

Response: SSE stream with the following event types:

data: {"type":"text","content":"..."}
data: {"type":"tool_use","name":"queryData","input":{...}}
data: {"type":"tool_result","name":"queryData","output":{...}}
data: {"type":"result","subtype":"success","result":"..."}
data: [DONE]

GET /health

Health check endpoint.

Response:

{
  "status": "ok",
  "version": "0.1.0"
}

JWT Token Format

The JWT must be signed with HS256 and include the following claims:

{
  "userId": "user-uuid",
  "orgId": "org-uuid",
  "role": "admin|member|viewer",
  "isDemoUser": false
}

Running

Development:

bun run dev

Production:

bun run start

Build:

bun run build

Architecture

src/index.ts - HTTP server entry point (Bun.serve)
src/stream.ts - Wraps SDK query() → SSE response
src/auth.ts - JWT validation (HS256)
src/config.ts - Environment configuration
src/sessions.ts - In-memory session store
src/mcp/compass-server.ts - MCP server for Compass tools

2.4 KiB Raw Blame History