@bootstrapp/claude

@bootstrapp/claude

Claude Code SDK integration for Bootstrapp applications. Provides a bridge server for connecting Claude agents to your Bootstrapp projects with MCP (Model Context Protocol) tool support.

Installation

npm install @bootstrapp/claude

Features

• Bridge server for Claude Agent SDK integration
• MCP tool discovery and management
• Session-based conversations with streaming responses
• Permission management for tool execution
• Question/answer flow for interactive agents

CLI Usage

Start the Bridge Server

bootstrapp claude:bridge [options]

Options:

Option	Description	Default
--port <number>	Port to listen on	8765
--host <string>	Host to bind to	localhost
--model <string>	Default Claude model	claude-sonnet-4-5-20250929
--project <path>	Project directory	Current directory
--dev-port <number>	Dev server port for MCP tools	1315

Example:

bootstrapp claude:bridge --port 8080 --model claude-sonnet-4-5-20250929

API Reference

Provider (@bootstrapp/claude/provider)

The provider adapts messages for Claude Agent SDK:

import { claudeAgentProvider } from "@bootstrapp/claude/provider";

// Provider interface
const provider = {
  type: "claude-code",
  adaptMessages: (messages) => string,
  adaptTools: (tools) => tools,
  adaptResponse: (res) => res,
  streamAPI: async function* ({ provider, model, messages }) { ... },
  processStream: async function* (stream) { ... },
};

Transport (@bootstrapp/claude/transport)

The transport plugin creates HTTP connections to the bridge server:

import claudeTransport from "@bootstrapp/claude/transport";

// Initialize with a host that has a transports registry
claudeTransport.initialize(host);

// Create a transport instance
const transport = await host.transports.get("claude-code").createTransport({
  baseUrl: "http://localhost:8765"
});

// Use the transport
const session = await transport.createSession({ model: "claude-sonnet-4-5-20250929" });
await transport.send(session.sessionId, "Hello!");

for await (const message of transport.receive(session.sessionId)) {
  console.log(message);
}

await transport.close(session.sessionId);

Transport Methods

Method	Description
createSession(options)	Create a new conversation session
send(sessionId, message)	Send a message to the session
receive(sessionId)	Async generator yielding responses
close(sessionId)	Close and cleanup a session
resumeSession(sessionId, options)	Resume an existing session
health()	Check bridge server health

Bridge Server HTTP API

Endpoints

Method	Path	Description
POST	/session	Create new session
POST	/send	Send message to session
GET	/receive/:sessionId	SSE stream for responses
DELETE	/session/:sessionId	Close session
GET	/health	Health check
POST	/permission	Approve/deny tool permissions
POST	/question	Answer agent questions
GET	/mcp/tools	List available MCP tools
GET	/mcp/resources	List MCP resources
POST	/mcp/config	Configure tool availability

SSE Events

The /receive/:sessionId endpoint streams the following events:

• assistant - Text content from Claude
• tool_use - Tool execution requests
• tool_result - Tool execution results
• permission_request - Tool permission requests
• question_request - Agent questions
• done - Conversation turn complete
• error - Error occurred

Project Configuration

Configure the bridge in your project's package.json:

{
  "settings": {
    "agent": {
      "port": 8765,
      "hostname": "localhost",
      "model": "claude-sonnet-4-5-20250929"
    }
  }
}

Requirements

• Node.js >= 18.0.0
• @anthropic-ai/claude-agent-sdk (peer dependency, auto-installed by CLI)
• @bootstrapp/mcp for MCP tool support

License

AGPL-3.0