npm - yaml-flow - Versions diffs - 8.5.2 → 8.6.1 - Mend

yaml-flow 8.5.2 → 8.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

package/browser/asset-integrity.json +3 -3
package/examples/board/demo-shell-with-server.html +2 -2
package/examples/board/doc.html +2 -2
package/examples/board/server/board-server.js +266 -5
package/examples/board/server/board-worker/task-executor.js +166 -51
package/examples/board/server/chat-flow/copilot-chat/assistant.js +25 -12
package/examples/board/server/chat-flow/copilot-chat/probe.js +7 -0
package/examples/board/server/chat-flow/copilot-chat/shared.js +97 -0
package/examples/board/server/chat-flow/flow-steps.json +109 -51
package/examples/board/server-config.json +1 -0
package/examples/board/test/server-http-test.js +870 -67
package/examples/board-local/demo-shell-localstorage.html +3 -3
package/lib/{artifacts-store-lib-D-k-E8Vy.d.ts → artifacts-store-lib-C1rtrkxm.d.ts} +1 -1
package/lib/{artifacts-store-lib-CVgtQrNZ.d.cts → artifacts-store-lib-CLOtsiav.d.cts} +1 -1
package/lib/artifacts-store-public.cjs +1 -1
package/lib/artifacts-store-public.d.cts +3 -3
package/lib/artifacts-store-public.d.ts +3 -3
package/lib/artifacts-store-public.js +1 -1
package/lib/batch/index.cjs +1 -1
package/lib/batch/index.js +1 -1
package/lib/board-live-cards-mcp.cjs +1 -1
package/lib/board-live-cards-mcp.d.cts +36 -16
package/lib/board-live-cards-mcp.d.ts +36 -16
package/lib/board-live-cards-mcp.js +1 -1
package/lib/board-live-cards-node.cjs +8 -16
package/lib/board-live-cards-node.d.cts +32 -12
package/lib/board-live-cards-node.d.ts +32 -12
package/lib/board-live-cards-node.js +8 -16
package/lib/{board-live-cards-public-BGS22cMb.d.ts → board-live-cards-public-CBVjm327.d.ts} +59 -24
package/lib/{board-live-cards-public-B13InXhC.d.cts → board-live-cards-public-CPJy-aGW.d.cts} +59 -24
package/lib/board-live-cards-public.cjs +1 -2
package/lib/board-live-cards-public.d.cts +2 -2
package/lib/board-live-cards-public.d.ts +2 -2
package/lib/board-live-cards-public.js +1 -2
package/lib/board-live-cards-server-runtime.cjs +1 -7
package/lib/board-live-cards-server-runtime.d.cts +5 -5
package/lib/board-live-cards-server-runtime.d.ts +5 -5
package/lib/board-live-cards-server-runtime.js +1 -7
package/lib/board-livegraph-runtime/index.cjs +1 -2
package/lib/board-livegraph-runtime/index.js +1 -2
package/lib/board-worker-adapter.cjs +21 -7
package/lib/board-worker-adapter.d.cts +17 -2
package/lib/board-worker-adapter.d.ts +17 -2
package/lib/board-worker-adapter.js +21 -7
package/lib/card-compute/index.cjs +1 -9
package/lib/card-compute/index.js +1 -9
package/lib/card-store-public.cjs +1 -1
package/lib/card-store-public.d.cts +2 -2
package/lib/card-store-public.d.ts +2 -2
package/lib/card-store-public.js +1 -1
package/lib/card-validation.cjs +1 -9
package/lib/card-validation.js +1 -9
package/lib/{chat-storage-lib-CJn7a6OH.d.ts → chat-storage-lib-Bce-xx6l.d.ts} +1 -1
package/lib/{chat-storage-lib-0imhRX3l.d.cts → chat-storage-lib-CKylihjm.d.cts} +1 -1
package/lib/chat-store-public.cjs +1 -1
package/lib/chat-store-public.d.cts +3 -3
package/lib/chat-store-public.d.ts +3 -3
package/lib/chat-store-public.js +1 -1
package/lib/chunk-2MZUYY65.cjs +2 -0
package/lib/chunk-5DB54ZX2.cjs +2 -0
package/lib/chunk-5EA2ESS4.cjs +16 -0
package/lib/chunk-6APH25VI.js +2 -0
package/lib/chunk-76ON3V7R.js +2 -0
package/lib/chunk-7BKNHFNH.js +2 -0
package/lib/chunk-CWREBRXS.js +3 -0
package/lib/chunk-DAXACY63.js +2 -0
package/lib/chunk-FW4363Y4.js +2 -0
package/lib/chunk-FZ2SBU5M.js +3 -0
package/lib/chunk-G4XXRHL2.cjs +3 -0
package/lib/chunk-GNFE24S7.cjs +2 -0
package/lib/chunk-GYQXDNNI.cjs +2 -0
package/lib/chunk-H5KD3JPY.cjs +2 -0
package/lib/chunk-HLJH7LGW.js +16 -0
package/lib/chunk-I4WH5U5D.cjs +2 -0
package/lib/chunk-IXZG74EW.cjs +2 -0
package/lib/chunk-JAL25FGA.cjs +2 -0
package/lib/chunk-JM5EKT57.js +2 -0
package/lib/chunk-JMDHDY6M.js +2 -0
package/lib/chunk-KBELAKIY.js +2 -0
package/lib/chunk-KHJABJ45.cjs +3 -0
package/lib/chunk-KLRUISRY.cjs +2 -0
package/lib/chunk-KNFFDVLD.cjs +2 -0
package/lib/chunk-LBMEVV4U.js +2 -0
package/lib/chunk-LDAP75GN.js +2 -0
package/lib/chunk-LODXIALE.cjs +2 -0
package/lib/chunk-LVNQCE5X.cjs +3 -0
package/lib/chunk-M7EQRS6W.js +3 -0
package/lib/chunk-MNEOJWPS.js +10 -0
package/lib/chunk-NJJ7WEDT.cjs +2 -0
package/lib/chunk-NMZ6XNLB.cjs +3 -0
package/lib/chunk-OPNGCSXJ.js +2 -0
package/lib/chunk-P64UKI3L.cjs +8 -0
package/lib/chunk-P7ZCDICS.cjs +2 -0
package/lib/chunk-Q6H7NINN.cjs +5 -0
package/lib/chunk-Q6VSL327.js +8 -0
package/lib/chunk-QWBNDVUA.js +5 -0
package/lib/chunk-S6DRP2HX.cjs +2 -0
package/lib/chunk-UJ7ZTV4J.cjs +10 -0
package/lib/chunk-UVE65IPR.cjs +3 -0
package/lib/chunk-VCCTAUIG.js +2 -0
package/lib/chunk-VGT3TRQG.js +3 -0
package/lib/chunk-VLBB3D6B.js +3 -0
package/lib/chunk-WDPOGXTY.js +2 -0
package/lib/chunk-X3LC4LII.js +2 -0
package/lib/chunk-YGKDQLYP.js +2 -0
package/lib/chunk-YMEIPKLW.cjs +2 -0
package/lib/config/index.cjs +1 -1
package/lib/config/index.js +1 -1
package/lib/continuous-event-graph/index.cjs +1 -2
package/lib/continuous-event-graph/index.js +1 -2
package/lib/event-graph/index.cjs +1 -22
package/lib/event-graph/index.js +1 -22
package/lib/execution-refs.cjs +1 -2
package/lib/execution-refs.d.cts +3 -2
package/lib/execution-refs.d.ts +3 -2
package/lib/execution-refs.js +1 -2
package/lib/index.cjs +2 -24
package/lib/index.d.cts +1 -1
package/lib/index.d.ts +1 -1
package/lib/index.js +2 -24
package/lib/server-runtime/index.cjs +1 -7
package/lib/server-runtime/index.d.cts +6 -6
package/lib/server-runtime/index.d.ts +6 -6
package/lib/server-runtime/index.js +1 -7
package/lib/step-machine/index.cjs +1 -11
package/lib/step-machine/index.js +1 -11
package/lib/step-machine-public/index.cjs +1 -4
package/lib/step-machine-public/index.d.cts +1 -1
package/lib/step-machine-public/index.d.ts +1 -1
package/lib/step-machine-public/index.js +1 -4
package/lib/{storage-interface-B2WD9D5n.d.cts → storage-interface-Ct-C4tlz.d.cts} +28 -1
package/lib/{storage-interface-B2WD9D5n.d.ts → storage-interface-Ct-C4tlz.d.ts} +28 -1
package/lib/stores/index.cjs +1 -2
package/lib/stores/index.d.cts +1 -1
package/lib/stores/index.d.ts +1 -1
package/lib/stores/index.js +1 -2
package/lib/stores/kv.cjs +1 -2
package/lib/stores/kv.d.cts +1 -1
package/lib/stores/kv.d.ts +1 -1
package/lib/stores/kv.js +1 -2
package/lib/stores/memory.cjs +1 -1
package/lib/stores/memory.js +1 -1
package/lib/{types-30R357js.d.ts → types-BuK2UMxk.d.ts} +4 -4
package/lib/{types-CIgsh56O.d.cts → types-DRl0Hy_p.d.cts} +4 -4
package/package.json +2 -16
package/cli/board-live-cards-lib-COi4bSpk.d.ts +0 -322
package/cli/browser-api/board-live-cards-browser-adapter.d.ts +0 -36
package/cli/browser-api/board-live-cards-browser-adapter.js +0 -4
package/cli/browser-api/card-store-browser-api.d.ts +0 -25
package/cli/browser-api/card-store-browser-api.js +0 -2
package/cli/browser-api/jsonata-sync.cjs +0 -7623
package/cli/bundled/artifacts-store-cli.mjs +0 -12
package/cli/bundled/batch-runner-cli.mjs +0 -3
package/cli/bundled/board-live-cards-cli.mjs +0 -29
package/cli/bundled/card-store-cli.mjs +0 -154
package/cli/bundled/chat-store-cli.mjs +0 -16
package/cli/bundled/jsonata-sync.cjs +0 -7623
package/cli/bundled/step-machine-cli.mjs +0 -150
package/cli/execution-interface-BCIhu1gO.d.ts +0 -442
package/cli/types-H3EMBPY2.d.ts +0 -398
package/examples/board/server/README-mcp-api.md +0 -680
package/examples/board/test/server-http-mcp-test.js +0 -1163
package/lib/board-livegraph-runtime/jsonata-sync.cjs +0 -7623
package/lib/card-compute/jsonata-sync.cjs +0 -7623
package/lib/continuous-event-graph/jsonata-sync.cjs +0 -7623
package/lib/server-runtime/jsonata-sync.cjs +0 -7623

package/browser/asset-integrity.json CHANGED Viewed

@@ -1,10 +1,10 @@
 {
-  "generatedAt": "2026-05-28T18:29:20.093Z",
+  "generatedAt": "2026-05-31T10:04:54.839Z",
   "algorithm": "sha256",
   "files": {
     "browser/board-livecards-localstorage.js": {
-      "sha256": "sha256-ukHGdsDK8ytpOVMNh82v3OUUtYThohkEWbgGlROvO6s=",
-      "bytes": 144037
+      "sha256": "sha256-ZsTMRbMZNr915issy2horB25TVTwUCI35oGGZ8vWF7k=",
+      "bytes": 153257
     },
     "browser/live-cards.schema.json": {
       "sha256": "sha256-F5nfqDzZ5L3p0lLTMxGt4YtMa2sVzdNPh8sbQ8OiXHE=",

package/examples/board/demo-shell-with-server.html CHANGED Viewed

@@ -19,8 +19,8 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.2/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.6.1/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.6.1/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/board/doc.html CHANGED Viewed

@@ -37,8 +37,8 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.2/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.6.1/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.6.1/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/board/server/board-server.js CHANGED Viewed

@@ -6,7 +6,7 @@ import path from 'node:path';
 import net from 'node:net';
 import os from 'node:os';
 import { spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import {
   createMultiBoardServerRuntime,
@@ -23,8 +23,11 @@ import {
   evaluateArgsMassaging,
   invokeExecutionRef,
   parseRef,
+  registerInProcessExecutionHandler,
+  startBoardWorkerQueueRunner,
   serializeRef,
 } from 'yaml-flow/board-live-cards-node';
+import { registerInProcessBoardWorkerCallback } from 'yaml-flow/board-worker-adapter';
 import {
   createStepMachineChatFlowRunner,
 } from 'yaml-flow/step-machine-public';
@@ -141,6 +144,17 @@ const configuredChatFlowTimeoutMs = normalizeTimeoutMs(serverConfig.chatFlowTime
 const configuredInvokeRefTimeoutMs = normalizeTimeoutMs(serverConfig.chatInvokeRefTimeoutMs, 300000);
 const configuredCopilotTimeoutMs = normalizeTimeoutMs(serverConfig.chatCopilotTimeoutMs, 300000);
+function normalizeBoardWorkerTransport(value) {
+  const normalized = String(value || '').trim().toLowerCase();
+  if (normalized === 'http') return 'http';
+  if (normalized === 'queue') return 'queue';
+  return 'in-process-loop';
+}
+const configuredBoardWorkerTransport = normalizeBoardWorkerTransport(
+  process.env.DEMO_TASK_EXECUTOR_TRANSPORT || serverConfig.taskExecutorTransport || 'in-process-loop',
+);
 // Resolve top-level config defaults (used as fallbacks for per-board config)
 const configuredTaskExecutorPath = resolveFromConfig(serverConfig.taskExecutorPath);
 const configuredChatHandlerPath = resolveFromConfig(serverConfig.chatHandlerPath);
@@ -167,6 +181,7 @@ const PORT = Number(process.env.DEMO_SERVER_PORT || serverConfig.port || 7799);
 const cardsPatternArgIndex = cliArgs.indexOf('--cards-pattern');
 const cliCardsPattern = cardsPatternArgIndex !== -1 ? cliArgs[cardsPatternArgIndex + 1] : null;
 const selectedCardsPattern = (process.env.DEMO_CARDS_PATTERN || cliCardsPattern || '').trim() || null;
+const enableTestReq = /^(1|true|yes|on)$/i.test((process.env.BOARD_SERVER_ENABLE_TEST_REQ || '').trim());
 const CORS_HEADERS = {
   'Access-Control-Allow-Origin': '*',
@@ -229,6 +244,107 @@ function makeExecutionRef(scriptPath, extra) {
   };
 }
+function makeLocalTaskExecutorRef(scriptPath, extra) {
+  if (!scriptPath) return undefined;
+  const resolved = path.isAbsolute(scriptPath) ? scriptPath : path.resolve(process.cwd(), scriptPath);
+  return {
+    meta: 'task-executor',
+    howToRun: 'local-node',
+    whatToRun: serializeRef({ kind: 'fs-path', value: resolved }),
+    ...(extra !== undefined ? { extra } : {}),
+  };
+}
+function isHostedTaskExecutorRef(ref) {
+  return ref?.howToRun === 'queue-storage'
+    || ref?.howToRun === 'in-process-loop'
+    || ref?.howToRun === 'http:post'
+    || ref?.howToRun === 'http:get';
+}
+function makeHostedBoardWorkerRef(boardId, taskExecPath, transport, executionExtra) {
+  if (!taskExecPath) return undefined;
+  if (transport === 'in-process-loop') {
+    return {
+      meta: 'task-executor',
+      howToRun: 'in-process-loop',
+      whatToRun: serializeRef({ kind: 'in-process-loop', value: `board:${boardId}:board-worker` }),
+    };
+  }
+  if (transport === 'http') {
+    return {
+      meta: 'task-executor',
+      howToRun: 'http:post',
+      whatToRun: serializeRef({
+        kind: 'http-url',
+        value: `${String(executionExtra.serverUrl || '').replace(/\/+$/, '')}/api/board-worker`,
+      }),
+      extra: { boardId },
+    };
+  }
+  if (transport === 'queue') {
+    return {
+      meta: 'task-executor',
+      howToRun: 'queue-storage',
+      whatToRun: serializeRef({ kind: 'queue-storage', value: `board:${boardId}:board-worker` }),
+      extra: { boardId },
+    };
+  }
+  throw new Error(`Unsupported board-worker transport for demo host: ${transport}`);
+}
+function makeBoardWorkerCallbackSelfRef(serverUrl, boardApiBasePath, transport, boardId) {
+  if (transport === 'in-process-loop' || transport === 'queue') {
+    return {
+      meta: 'board-live-cards',
+      howToRun: 'in-process-loop',
+      whatToRun: serializeRef({ kind: 'in-process-loop', value: `board:${boardId}:board-worker-callback` }),
+    };
+  }
+  const normalizedServerUrl = typeof serverUrl === 'string' ? serverUrl.trim().replace(/\/+$/, '') : '';
+  const normalizedApiBasePath = typeof boardApiBasePath === 'string' ? boardApiBasePath.trim().replace(/\/+$/, '') : '';
+  if (!normalizedServerUrl || !normalizedApiBasePath) return undefined;
+  return {
+    meta: 'board-live-cards',
+    howToRun: 'http:post',
+    whatToRun: serializeRef({
+      kind: 'http-url',
+      value: `${normalizedServerUrl}${normalizedApiBasePath}/callback/board-worker`,
+    }),
+  };
+}
+async function readJsonRequest(req) {
+  const parts = [];
+  for await (const chunk of req) parts.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  const raw = Buffer.concat(parts).toString('utf-8').trim();
+  return raw ? JSON.parse(raw) : {};
+}
+const boardWorkerModuleCache = new Map();
+async function loadBoardWorkerModule(taskExecPath) {
+  const resolved = path.isAbsolute(taskExecPath) ? taskExecPath : path.resolve(BOARD_ROOT, taskExecPath);
+  if (!boardWorkerModuleCache.has(resolved)) {
+    boardWorkerModuleCache.set(resolved, import(pathToFileURL(resolved).href));
+  }
+  return boardWorkerModuleCache.get(resolved);
+}
+function createHostedBoardWorkerDispatcher(boardId, taskExecPath) {
+  if (!taskExecPath) return null;
+  return async (request) => {
+    const mod = await loadBoardWorkerModule(taskExecPath);
+    if (typeof mod.executeBoardWorkerRequest === 'function') {
+      return await mod.executeBoardWorkerRequest(request);
+    }
+    if (typeof mod.executeTaskExecutorRequest === 'function') {
+      return await mod.executeTaskExecutorRequest(request);
+    }
+    throw new Error(`Hosted board worker for board ${boardId} must export executeBoardWorkerRequest(request)`);
+  };
+}
 function createNamedPipeNotificationTransport() {
   return {
     async subscribe(ref, onEvent) {
@@ -283,6 +399,9 @@ const apiBasePath = '/api/boards';
 const invocationAdapter = createNodeSpawnInvocationAdapter();
 const notificationTransport = createNamedPipeNotificationTransport();
 const logger = { info: console.log, warn: console.warn, error: console.error };
+const hostedBoardWorkerDispatchers = new Map();
+const hostedBoardWorkerQueueStops = new Map();
+const hostedBoardChatStorages = new Map();
 // Map config keys to board entries for the factory
 const boardConfigEntries = serverConfig.boards ? Object.entries(serverConfig.boards) : [];
@@ -301,8 +420,24 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
   const notifyChannel = `yaml-flow-server-${label}-${boardId}-${process.pid}`;
   const baseRef = parseRef(serializeRef({ kind: 'fs-path', value: boardDir }));
-  const boardAdapter = createFsBoardPlatformAdapter(baseRef, { notifyChannel });
-  const nonCoreAdapter = createFsBoardNonCorePlatformAdapter(baseRef, { notifyChannel });
+  const boardWorkerTransport = normalizeBoardWorkerTransport(executionExtra.taskExecutorTransport);
+  const callbackSelfRef = makeBoardWorkerCallbackSelfRef(executionExtra.serverUrl, executionExtra.apiBasePath, boardWorkerTransport, boardId);
+  const boardAdapter = createFsBoardPlatformAdapter(baseRef, {
+    notifyChannel,
+    ...(callbackSelfRef ? { selfRef: callbackSelfRef } : {}),
+  });
+  const nonCoreAdapter = createFsBoardNonCorePlatformAdapter(baseRef, {
+    notifyChannel,
+    ...(callbackSelfRef ? { selfRef: callbackSelfRef } : {}),
+  });
+  const localSyncTaskExecutorRef = makeLocalTaskExecutorRef(taskExecPath, executionExtra);
+  if (localSyncTaskExecutorRef) {
+    const invokeExecutor = nonCoreAdapter.invokeExecutor.bind(nonCoreAdapter);
+    nonCoreAdapter.invokeExecutor = (ref, subcommand, execOpts) => {
+      const syncRef = isHostedTaskExecutorRef(ref) ? localSyncTaskExecutorRef : ref;
+      return invokeExecutor(syncRef, subcommand, execOpts);
+    };
+  }
   boardAdapter.requestProcessAccumulated = () => {};
   nonCoreAdapter.requestProcessAccumulated = () => {};
@@ -325,7 +460,7 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
     scratchStoreRef,
     archiveStoreRef,
     notifyRef: { kind: 'named-pipe', value: namedPipePath(notifyChannel) },
-    taskExecutorRef: makeExecutionRef(taskExecPath, executionExtra),
+    taskExecutorRef: makeHostedBoardWorkerRef(boardId, taskExecPath, boardWorkerTransport, executionExtra),
     chatHandlerFlow,
     inferenceAdapterRef: makeExecutionRef(infAdapterPath),
   };
@@ -401,6 +536,7 @@ const runtime = createMultiBoardServerRuntime({
     );
     const infAdapterPath = resolveFromConfig(regular.inferenceAdapterPath) || (entry?.inferenceAdapterPath || configuredInferenceAdapterPath);
     const stepMachinePath = resolveFromConfig(regular.stepMachineCliPath || cfg?.stepMachineCliPath) || (entry?.stepMachineCliPath || configuredStepMachineCliPath);
+    const boardWorkerTransport = normalizeBoardWorkerTransport(regular.taskExecutorTransport || entry?.taskExecutorTransport || configuredBoardWorkerTransport);
     const chatInvokeRefTimeoutMs = configuredInvokeRefTimeoutMs;
     const chatCopilotTimeoutMs = configuredCopilotTimeoutMs;
@@ -436,6 +572,7 @@ const runtime = createMultiBoardServerRuntime({
       chatFlowRoot,
       apiBasePath: `${apiBasePath}/${boardId}`,
       serverUrl: `http://127.0.0.1:${PORT}`,
+      taskExecutorTransport: boardWorkerTransport,
       chatCopilotTimeoutMs,
       ...(stepMachinePath ? { stepMachineCliPath: stepMachinePath } : {}),
     };
@@ -446,6 +583,7 @@ const runtime = createMultiBoardServerRuntime({
     demoPrepSetup({ cardsDir, boardDir });
     const chatStorage = createFsBoardChatStorage(boardDir);
+    hostedBoardChatStorages.set(boardId, chatStorage);
     const singleBoardRuntime = createSingleBoardServerRuntime({
       apiBasePath: `${apiBasePath}/${boardId}`,
@@ -470,6 +608,44 @@ const runtime = createMultiBoardServerRuntime({
       },
     });
+    const hostedBoardWorkerDispatch = createHostedBoardWorkerDispatcher(boardId, taskExecPath);
+    if (hostedBoardWorkerDispatch) {
+      hostedBoardWorkerDispatchers.set(boardId, hostedBoardWorkerDispatch);
+    }
+    const previousQueueStop = hostedBoardWorkerQueueStops.get(boardId);
+    if (previousQueueStop) {
+      previousQueueStop();
+      hostedBoardWorkerQueueStops.delete(boardId);
+    }
+    if (boardWorkerTransport === 'in-process-loop' && hostedBoardWorkerDispatch) {
+      registerInProcessExecutionHandler(`board:${boardId}:board-worker`, async (_ref, args) => {
+        void hostedBoardWorkerDispatch(args).catch((err) => {
+          logger.error(`[board-server] in-process board-worker failed for ${boardId}: ${String(err && err.message || err)}`);
+        });
+        return { result: 'success', data: { dispatched: true } };
+      });
+    }
+    if ((boardWorkerTransport === 'in-process-loop' || boardWorkerTransport === 'queue') && hostedBoardWorkerDispatch) {
+      registerInProcessBoardWorkerCallback(`board:${boardId}:board-worker-callback`, (payload) => {
+        if (payload.outcome === 'success') {
+          return singleBoardRuntime.reportSourceFetched(payload.token, String(payload.ref || ''));
+        }
+        return singleBoardRuntime.reportSourceFetchFailure(payload.token, String(payload.reason || 'unknown'));
+      });
+    }
+    if (boardWorkerTransport === 'queue' && hostedBoardWorkerDispatch) {
+      const stopQueueRunner = startBoardWorkerQueueRunner({
+        workerStore: baseCfg.boardAdapter.boardWorkerStore(),
+        executeBoardWorkerRequest: hostedBoardWorkerDispatch,
+        onError: (error, lease) => {
+          logger.error(
+            `[board-server] queued board-worker failed for ${boardId} (attempt ${lease.attempt}): ${String(error && error.message || error)}`,
+          );
+        },
+      });
+      hostedBoardWorkerQueueStops.set(boardId, stopQueueRunner);
+    }
     // Seed card store from source cardsDir if empty
     const existing = singleBoardRuntime.cardStore.get({});
     const isEmpty = existing.status !== 'success' || !existing.data?.cards?.length;
@@ -509,7 +685,7 @@ function jsonReply(res, status, payload) {
   res.end(body);
 }
-const server = http.createServer((req, res) => {
+const server = http.createServer(async (req, res) => {
   const method = req.method || 'GET';
   const url = new URL(req.url || '/', 'http://localhost');
   const pathname = url.pathname;
@@ -520,6 +696,87 @@ const server = http.createServer((req, res) => {
     return;
   }
+  const testSystemChatMatch = pathname.match(/^\/test-req\/boards\/([^/]+)\/chat\/system-message$/);
+  if (method === 'POST' && testSystemChatMatch) {
+    if (!enableTestReq) {
+      jsonReply(res, 404, { error: 'Not found' });
+      return;
+    }
+    try {
+      const boardId = decodeURIComponent(testSystemChatMatch[1]);
+      runtime.requireBoardService(boardId);
+      const chatStorage = hostedBoardChatStorages.get(boardId);
+      if (!chatStorage) {
+        jsonReply(res, 409, { error: `No hosted chat storage configured for board: ${boardId}` });
+        return;
+      }
+      const body = await readJsonRequest(req);
+      const cardId = typeof body?.cardId === 'string' ? body.cardId.trim() : '';
+      const text = typeof body?.text === 'string' ? body.text : '';
+      const turn = typeof body?.turn === 'string' ? body.turn : '';
+      const files = Array.isArray(body?.files) ? body.files : [];
+      if (!cardId) {
+        jsonReply(res, 400, { error: 'cardId is required' });
+        return;
+      }
+      if (typeof body?.text !== 'string') {
+        jsonReply(res, 400, { error: 'text is required' });
+        return;
+      }
+      const id = chatStorage.append(cardId, 'system', text, files, turn);
+      jsonReply(res, 200, {
+        status: 'success',
+        data: {
+          id,
+          boardId,
+          cardId,
+          role: 'system',
+          text,
+          turn,
+          files,
+        },
+      });
+      return;
+    } catch (err) {
+      jsonReply(res, 404, { error: String(err && err.message || err) });
+      return;
+    }
+  }
+  if (method === 'POST' && pathname === '/api/board-worker') {
+    try {
+      const body = await readJsonRequest(req);
+      const boardId = typeof body?.extra?.boardId === 'string' ? body.extra.boardId.trim() : '';
+      if (!boardId) {
+        jsonReply(res, 400, { error: 'boardId is required in request.extra.boardId' });
+        return;
+      }
+      runtime.requireBoardService(boardId);
+      const dispatcher = hostedBoardWorkerDispatchers.get(boardId);
+      if (!dispatcher) {
+        jsonReply(res, 409, { error: `No hosted board-worker configured for board: ${boardId}` });
+        return;
+      }
+      if (body?.source_def) {
+        void dispatcher(body).catch((err) => {
+          logger.error(`[board-server] hosted board-worker failed for ${boardId}: ${String(err && err.message || err)}`);
+        });
+        jsonReply(res, 202, { status: 'success', dispatched: true });
+        return;
+      }
+      const workerResult = await dispatcher(body);
+      jsonReply(res, 200, workerResult ?? { status: 'success', data: {} });
+      return;
+    } catch (err) {
+      jsonReply(res, 404, { error: String(err && err.message || err) });
+      return;
+    }
+  }
   // All other /api/boards routes are handled by the platform-free runtime
   runtime.handleApi(req, res, url).then((handled) => {
     if (!handled) {
@@ -546,4 +803,8 @@ server.listen(PORT, '127.0.0.1', () => {
   console.log(`  GET  ${apiBasePath}/:boardId/cards/:id/chats`);
   console.log(`  POST ${apiBasePath}/:boardId/cards/:id/chats/subscribe-sse`);
   console.log(`  POST ${apiBasePath}/:boardId/cards/:id/chats/unsubscribe-sse`);
+  console.log('  POST /api/board-worker');
+  if (enableTestReq) {
+    console.log('  POST /test-req/boards/:boardId/chat/system-message');
+  }
 });