001_agent_http-server

Agent 1: HTTP Server and CLI Commands

Plan Location: plans/0049-persistent-http-server/0049-persistent-http-server-plan.md

Scope

Features: #4, #5 Own: src/server-http.ts, src/server-http-entry.ts, src/commands/start.tsx, src/commands/stop.tsx Depend on: Agent 0 for initializeSharedResources, config helpers, PID file, createServer with preloaded extensions Block: Agent 2 waiting on working start/stop

Interfaces

Export

// #4 — server-http.ts (CREATE)
export async function startHttpServer(configPathArg?: string): Promise<void>;

// #5 — commands/start.tsx (CREATE)
export const description: string;  // 'Start the limps HTTP server'
export const options: z.ZodObject<{
  config: z.ZodOptional<z.ZodString>;
  project: z.ZodOptional<z.ZodString>;
  port: z.ZodOptional<z.ZodNumber>;
  foreground: z.ZodOptional<z.ZodBoolean>;
}>;

// #5 — commands/stop.tsx (CREATE)
export const description: string;  // 'Stop the running limps server'
export const options: z.ZodObject<{
  config: z.ZodOptional<z.ZodString>;
  project: z.ZodOptional<z.ZodString>;
}>;

Receive (from Agent 0) ✅ READY when Agent 0 is PASS

// server-shared.ts
import { initializeSharedResources, cleanupSharedResources } from './server-shared.js';
// config.ts
import { getServerPort, getServerHost } from './config.js';
// pidfile.ts
import { writePidFile, readPidFile, removePidFile, isServerRunning } from './pidfile.js';
// server.ts
import { createServer } from './server.js';

Features

#4: HTTP server with StreamableHTTPServerTransport

TL;DR: Express app with MCP session management via SDK's StreamableHTTPServerTransport. Status: GAP Files: src/server-http.ts (create), src/server-http-entry.ts (create)

SDK imports:

import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';