Website · Documentation · GitHub · Changelog

Overview

@bpmnkit/proxy is a local Node.js server that bridges the BPMN Kit editor with AI services and your Camunda cluster. It runs on port 3033 and provides:

• AI chat bridge — SSE streaming endpoint for AI-assisted diagram editing; connects to any OpenAI-compatible LLM API
• MCP server — Model Context Protocol server for AI agent integrations (stdio transport)
• Camunda API proxy — transparent HTTP proxy that injects auth from your casen CLI profiles

The proxy reads authentication from profiles stored by the @bpmnkit/cli (~/.config/casen/config.json), so you don't need to configure credentials separately.

Installation

npm install -g @bpmnkit/proxy
# or run from the monorepo:
pnpm proxy

Quick Start

# Start the proxy server (port 3033)
bpmn-ai-server

# Or start the MCP server (stdio)
bpmn-mcp

Endpoints

| Method | Path | Description | |--------|------|-------------| | GET | /status | Health check; returns server version and active profile | | POST | /chat | AI chat — SSE stream; sends data: { type, content } events | | GET | /profiles | List all configured casen profiles | | ALL | /api/* | Transparent proxy to your Camunda cluster (adds auth header) | | GET | /operate/stream | SSE stream for the @bpmnkit/operate monitoring frontend |

Configuration

The proxy reads from the active casen CLI profile. Set an AI_API_KEY environment variable for the AI bridge:

AI_API_KEY=sk-... bpmn-ai-server

Or use the X-Profile request header to target a specific profile on the /api/* proxy:

curl -H "X-Profile: production" http://localhost:3033/api/v2/process-definitions

Related Packages

| Package | Description | |---------|-------------| | @bpmnkit/core | BPMN/DMN/Form parser, builder, layout engine | | @bpmnkit/canvas | Zero-dependency SVG BPMN viewer | | @bpmnkit/editor | Full-featured interactive BPMN editor | | @bpmnkit/engine | Lightweight BPMN process execution engine | | @bpmnkit/feel | FEEL expression language parser & evaluator | | @bpmnkit/plugins | 22 composable canvas plugins | | @bpmnkit/api | Camunda 8 REST API TypeScript client | | @bpmnkit/ascii | Render BPMN diagrams as Unicode ASCII art | | @bpmnkit/ui | Shared design tokens and UI components | | @bpmnkit/profiles | Shared auth, profile storage, and client factories for CLI & proxy | | @bpmnkit/operate | Monitoring & operations frontend for Camunda clusters | | @bpmnkit/connector-gen | Generate connector templates from OpenAPI specs | | @bpmnkit/cli | Camunda 8 command-line interface (casen) | | @bpmnkit/cli-sdk | Plugin authoring SDK for the casen CLI | | @bpmnkit/create-casen-plugin | Scaffold a new casen CLI plugin in seconds | | @bpmnkit/casen-report | HTML reports from Camunda 8 incident and SLA data | | @bpmnkit/casen-worker-http | Example HTTP worker plugin — completes jobs with live JSONPlaceholder API data | | @bpmnkit/casen-worker-ai | AI task worker — classify, summarize, extract, and decide using Claude |

License

MIT © BPMN Kit — made by u11g