@bpmnkit/proxy 0.0.8 → 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 urbanisierung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/bpmnkit/monorepo/main/doc/logos/logo-2-gateway.svg" width="72" height="72" alt="BPMN Kit logo">
+  <h1>@bpmnkit/proxy</h1>
+  <p>Local proxy server for BPMN Kit — AI bridge (SSE/MCP) and Camunda API proxy using stored CLI profiles</p>
+
+  [![npm](https://img.shields.io/npm/v/@bpmnkit/proxy?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/proxy)
+  [![license](https://img.shields.io/npm/l/@bpmnkit/proxy?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
+  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://github.com/bpmnkit/monorepo)
+
+  [Documentation](https://docs.bpmnkit.com) · [GitHub](https://github.com/bpmnkit/monorepo) · [Changelog](https://github.com/bpmnkit/monorepo/blob/main/apps/proxy/CHANGELOG.md)
+</div>
+
+---
+
+## 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
+
+```sh
+npm install -g @bpmnkit/proxy
+# or run from the monorepo:
+pnpm proxy
+```
+
+## Quick Start
+
+```sh
+# 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:
+
+```sh
+AI_API_KEY=sk-... bpmn-ai-server
+```
+
+Or use the `X-Profile` request header to target a specific profile on the `/api/*` proxy:
+
+```sh
+curl -H "X-Profile: production" http://localhost:3033/api/v2/process-definitions
+```
+
+---
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@bpmnkit/core`](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine |
+| [`@bpmnkit/canvas`](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer |
+| [`@bpmnkit/editor`](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
+| [`@bpmnkit/engine`](https://www.npmjs.com/package/@bpmnkit/engine) | Lightweight BPMN process execution engine |
+| [`@bpmnkit/feel`](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language parser & evaluator |
+| [`@bpmnkit/plugins`](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
+| [`@bpmnkit/api`](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API TypeScript client |
+| [`@bpmnkit/ascii`](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |
+| [`@bpmnkit/ui`](https://www.npmjs.com/package/@bpmnkit/ui) | Shared design tokens and UI components |
+| [`@bpmnkit/profiles`](https://www.npmjs.com/package/@bpmnkit/profiles) | Shared auth, profile storage, and client factories for CLI & proxy |
+| [`@bpmnkit/operate`](https://www.npmjs.com/package/@bpmnkit/operate) | Monitoring & operations frontend for Camunda clusters |
+| [`@bpmnkit/connector-gen`](https://www.npmjs.com/package/@bpmnkit/connector-gen) | Generate connector templates from OpenAPI specs |
+| [`@bpmnkit/cli`](https://www.npmjs.com/package/@bpmnkit/cli) | Camunda 8 command-line interface (casen) |
+
+## License
+
+[MIT](https://github.com/bpmnkit/monorepo/blob/main/LICENSE) © BPMN Kit

package/package.json

@@ -1,35 +1,53 @@
 {
-	"name": "@bpmnkit/proxy",
-	"version": "0.0.8",
-	"description": "Local proxy server for @bpmn-sdk — AI bridge (SSE/MCP) and Camunda API proxy using stored CLI profiles",
-	"type": "module",
-	"bin": {
-		"bpmn-ai-server": "./dist/index.js",
-		"bpmn-mcp": "./dist/mcp-server.js"
-	},
-	"files": ["dist/**/*.js"],
-	"engines": {
-		"node": ">=20"
-	},
-	"dependencies": {
-		"@bpmnkit/api": "workspace:*",
-		"@bpmnkit/core": "workspace:*",
-		"@bpmnkit/profiles": "workspace:*"
-	},
-	"scripts": {
-		"start": "node dist/index.js",
-		"build": "tsc",
-		"typecheck": "tsc --noEmit",
-		"check": "biome check .",
-		"dev": "node --watch dist/index.js",
-		"bridge": "esbuild src/bridge.ts --bundle --format=iife --global-name=Bridge --platform=neutral --outfile=dist/bridge.bundle.js",
-		"bundle": "esbuild src/index.ts --bundle --platform=node --format=cjs --outfile=dist/bundle.cjs && esbuild src/mcp-server.ts --bundle --platform=node --format=cjs --outfile=dist/mcp-server.cjs && pnpm run bridge"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/bpmnkit/monorepo"
-	}
-}
+  "name": "@bpmnkit/proxy",
+  "version": "0.0.9",
+  "description": "Local proxy server for BPMN Kit — AI bridge (SSE/MCP) and Camunda API proxy using stored CLI profiles",
+  "type": "module",
+  "bin": {
+    "bpmn-ai-server": "./dist/index.js",
+    "bpmn-mcp": "./dist/mcp-server.js"
+  },
+  "files": [
+    "README.md",
+    "dist/**/*.js"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@bpmnkit/api": "0.0.9",
+    "@bpmnkit/core": "0.0.9",
+    "@bpmnkit/profiles": "0.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bpmnkit/monorepo"
+  },
+  "keywords": [
+    "bpmn",
+    "camunda",
+    "proxy",
+    "ai",
+    "mcp",
+    "server-sent-events",
+    "typescript",
+    "zeebe"
+  ],
+  "license": "MIT",
+  "homepage": "https://bpmnkit.com",
+  "bugs": {
+    "url": "https://github.com/bpmnkit/monorepo/issues"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "check": "biome check .",
+    "dev": "node --watch dist/index.js",
+    "bridge": "esbuild src/bridge.ts --bundle --format=iife --global-name=Bridge --platform=neutral --outfile=dist/bridge.bundle.js",
+    "bundle": "esbuild src/index.ts --bundle --platform=node --format=cjs --outfile=dist/bundle.cjs && esbuild src/mcp-server.ts --bundle --platform=node --format=cjs --outfile=dist/mcp-server.cjs && pnpm run bridge"
+  }
+}

package/dist/apply-ops.js

@@ -1,79 +0,0 @@
-// ── Apply ops ─────────────────────────────────────────────────────────────────
-/**
- * Apply a list of operations to a copy of the given CompactDiagram.
- * Returns the modified copy — the original is never mutated.
- */
-export function applyOps(compact, ops) {
-    const result = JSON.parse(JSON.stringify(compact));
-    for (const op of ops) {
-        const proc = result.processes.find((p) => p.id === op.processId);
-        if (!proc)
-            continue;
-        if (op.op === "add") {
-            for (const elem of op.elements ?? []) {
-                if (!proc.elements.some((e) => e.id === elem.id)) {
-                    proc.elements.push(elem);
-                }
-            }
-            for (const flow of op.flows ?? []) {
-                if (!proc.flows.some((f) => f.id === flow.id)) {
-                    proc.flows.push(flow);
-                }
-            }
-        }
-        else if (op.op === "remove") {
-            const dropEls = new Set(op.elementIds ?? []);
-            const dropFlows = new Set(op.flowIds ?? []);
-            proc.elements = proc.elements.filter((e) => !dropEls.has(e.id));
-            proc.flows = proc.flows.filter((f) => !dropFlows.has(f.id) && !dropEls.has(f.from) && !dropEls.has(f.to));
-        }
-        else if (op.op === "update") {
-            const elem = proc.elements.find((e) => e.id === op.elementId);
-            if (elem) {
-                Object.assign(elem, op.changes);
-            }
-        }
-        else if (op.op === "condition") {
-            proc.flows = proc.flows.map((f) => {
-                if (f.id !== op.flowId)
-                    return f;
-                if (op.condition === null) {
-                    // Rebuild without condition field (noDelete rule)
-                    return { id: f.id, from: f.from, to: f.to, ...(f.name ? { name: f.name } : {}) };
-                }
-                return { ...f, condition: op.condition };
-            });
-        }
-    }
-    return result;
-}
-/**
- * Extract either an ops patch or a full CompactDiagram from the LLM response.
- * Returns null if no valid JSON block is found or the format is unrecognised.
- */
-export function parseResponse(text, current) {
-    const match = /```json\s*\n([\s\S]*?)\n```/.exec(text);
-    if (!match?.[1])
-        return null;
-    let parsed;
-    try {
-        parsed = JSON.parse(match[1]);
-    }
-    catch {
-        return null;
-    }
-    if (typeof parsed !== "object" || parsed === null)
-        return null;
-    // Ops format: { "ops": [...] }
-    if ("ops" in parsed && Array.isArray(parsed.ops)) {
-        if (!current)
-            return null; // ops require an existing diagram to patch
-        return applyOps(current, parsed.ops);
-    }
-    // Full CompactDiagram: { "processes": [...] }
-    if ("processes" in parsed && Array.isArray(parsed.processes)) {
-        return parsed;
-    }
-    return null;
-}
-//# sourceMappingURL=apply-ops.js.map