create-byan-agent 2.12.0 → 2.13.0

package/_byan/mcp/byan-mcp-server/lib/workflow-scripts.js

@@ -0,0 +1,156 @@
+/**
+ * Workflow node scripts — thin wrapper over byan_web REST endpoints.
+ *
+ * Wraps :
+ *   GET    /api/workflow-nodes/:nodeId/scripts
+ *   GET    /api/scripts/:id
+ *   POST   /api/workflow-nodes/:nodeId/scripts
+ *   PATCH  /api/scripts/:id
+ *   DELETE /api/scripts/:id
+ *   GET    /api/scripts/:id/history
+ *   POST   /api/scripts/:id/rollback
+ *   POST   /api/workflow-nodes/:nodeId/scripts/import
+ *   POST   /api/scripts/validate
+ *
+ * `apiRequest` is injected so tests can pass a mock without an HTTP round-trip.
+ */
+
+export const ALLOWED_LANGUAGES = ['bash', 'python', 'javascript', 'typescript'];
+export const ALLOWED_EXEC_MODES = ['context', 'local'];
+
+function encodeId(id) {
+  if (!id || typeof id !== 'string') throw new Error('id must be a non-empty string');
+  return encodeURIComponent(id);
+}
+
+function unwrap(body) {
+  if (body && typeof body === 'object' && 'data' in body) return body.data;
+  return body;
+}
+
+export async function listScripts({ apiRequest, nodeId }) {
+  if (!nodeId) throw new Error('nodeId is required');
+  const body = await apiRequest(`/api/workflow-nodes/${encodeId(nodeId)}/scripts`);
+  return { data: body.data || [], total: body.total ?? (body.data || []).length };
+}
+
+export async function getScript({ apiRequest, id }) {
+  const body = await apiRequest(`/api/scripts/${encodeId(id)}`);
+  return unwrap(body);
+}
+
+export async function createScript({
+  apiRequest,
+  nodeId,
+  name,
+  language,
+  content,
+  execution_mode,
+  order_idx,
+  bypassValidation,
+}) {
+  if (!nodeId) throw new Error('nodeId is required');
+  if (!name) throw new Error('name is required');
+  if (!ALLOWED_LANGUAGES.includes(language)) {
+    throw new Error(`language must be one of ${ALLOWED_LANGUAGES.join(', ')}, got ${language}`);
+  }
+  if (typeof content !== 'string') throw new Error('content (string) is required');
+
+  const payload = { name, language, content };
+  if (execution_mode !== undefined) payload.execution_mode = execution_mode;
+  if (order_idx !== undefined) payload.order_idx = order_idx;
+  if (bypassValidation === true) payload.bypassValidation = true;
+
+  const body = await apiRequest(`/api/workflow-nodes/${encodeId(nodeId)}/scripts`, {
+    method: 'POST',
+    body: JSON.stringify(payload),
+  });
+  return unwrap(body);
+}
+
+export async function updateScript({
+  apiRequest,
+  id,
+  expected_version,
+  name,
+  language,
+  content,
+  execution_mode,
+  order_idx,
+  bypassValidation,
+}) {
+  const payload = {};
+  if (expected_version !== undefined) payload.expected_version = expected_version;
+  if (name !== undefined) payload.name = name;
+  if (language !== undefined) {
+    if (!ALLOWED_LANGUAGES.includes(language)) {
+      throw new Error(`language must be one of ${ALLOWED_LANGUAGES.join(', ')}, got ${language}`);
+    }
+    payload.language = language;
+  }
+  if (content !== undefined) payload.content = content;
+  if (execution_mode !== undefined) payload.execution_mode = execution_mode;
+  if (order_idx !== undefined) payload.order_idx = order_idx;
+  if (bypassValidation === true) payload.bypassValidation = true;
+
+  const body = await apiRequest(`/api/scripts/${encodeId(id)}`, {
+    method: 'PATCH',
+    body: JSON.stringify(payload),
+  });
+  return unwrap(body);
+}
+
+export async function deleteScript({ apiRequest, id }) {
+  const body = await apiRequest(`/api/scripts/${encodeId(id)}`, { method: 'DELETE' });
+  return unwrap(body);
+}
+
+export async function getScriptHistory({ apiRequest, id }) {
+  const body = await apiRequest(`/api/scripts/${encodeId(id)}/history`);
+  return { data: body.data || [], total: body.total ?? (body.data || []).length };
+}
+
+export async function rollbackScript({ apiRequest, id, version }) {
+  if (!Number.isInteger(version) || version < 1) {
+    throw new Error('version must be a positive integer');
+  }
+  const body = await apiRequest(`/api/scripts/${encodeId(id)}/rollback`, {
+    method: 'POST',
+    body: JSON.stringify({ version }),
+  });
+  return unwrap(body);
+}
+
+export async function importScript({
+  apiRequest,
+  nodeId,
+  url,
+  name,
+  language,
+  execution_mode,
+}) {
+  if (!nodeId) throw new Error('nodeId is required');
+  if (!url) throw new Error('url is required');
+  const payload = { url };
+  if (name !== undefined) payload.name = name;
+  if (language !== undefined) payload.language = language;
+  if (execution_mode !== undefined) payload.execution_mode = execution_mode;
+
+  const body = await apiRequest(`/api/workflow-nodes/${encodeId(nodeId)}/scripts/import`, {
+    method: 'POST',
+    body: JSON.stringify(payload),
+  });
+  return unwrap(body);
+}
+
+export async function validateScriptSyntax({ apiRequest, language, content }) {
+  if (!ALLOWED_LANGUAGES.includes(language)) {
+    throw new Error(`language must be one of ${ALLOWED_LANGUAGES.join(', ')}, got ${language}`);
+  }
+  if (typeof content !== 'string') throw new Error('content (string) is required');
+  const body = await apiRequest('/api/scripts/validate', {
+    method: 'POST',
+    body: JSON.stringify({ language, content }),
+  });
+  return unwrap(body);
+}

package/_byan/mcp/byan-mcp-server/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "byan-mcp-server",
+  "version": "0.3.0",
+  "description": "BYAN MCP server — exposes byan_web REST API (projects, FD lifecycle, kanban, ELO, fact-check, workflow-node-scripts, peer-review) as Claude Code tools.",
+  "main": "server.js",
+  "type": "module",
+  "bin": {
+    "byan-mcp": "./server.js"
+  },
+  "files": [
+    "server.js",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node server.js",
+    "test": "node --test test/*.test.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "byan",
+    "claude-code",
+    "workflow",
+    "fd-lifecycle",
+    "kanban",
+    "elo-trust",
+    "fact-check"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Les-fous-du-bus/byan_web.git",
+    "directory": "_byan/mcp/byan-mcp-server"
+  },
+  "author": "Yan Acadenice",
+  "license": "MIT"
+}