yaml-flow 8.7.1 → 8.8.5

package/examples/ARCHITECTURE.md

@@ -82,32 +82,6 @@ No public API — just sets `window.jsonataSync` for other bundles to pick up.
 
 ---
 
-### board-livecards-client.js → `window.BoardLiveCardsClient`
-
-**Client for a yaml-flow HTTP/SSE server.** Two modes in one bundle:
-
-1. **SSE/HTTP mode** — connects to a `board-live-cards-server-runtime` host:
-```html
-<script src="board-livecards-client.js"></script>
-<script>
-  const client = BoardLiveCardsClient.createBoardRuntimeClient({
-    fetchServer,
-    boardPaths: BoardLiveCardsClient.defaultBoardPaths('my-board'),
-    getServerOrigin,
-  });
-  await client.bootstrapBoard({ boardId: 'my-board', rootElement: el });
-</script>
-```
-
-2. **Custom transport mode** — use the platform-free state layer with Firebase,
-   WebSocket, or any other transport. Import `buildBoardState`, `applyNotification`,
-   `selectAllLiveCardModels` and drive them yourself.
-
-Key exports: `createBoardRuntimeClient`, `defaultBoardPaths`, `singleBoardPaths`,
-`buildBoardState`, `applyNotification`, `selectLiveCardModel`, `selectAllLiveCardModels`
-
----
-
 ### live-cards.js → `window.LiveCard`
 
 **UI rendering engine** — turns board state (card models) into interactive HTML.
@@ -156,6 +130,5 @@ charts fall back to tables and markdown renders as escaped plain text.
 <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
 
 <!-- 2. yaml-flow bundles -->
-<script src="board-livecards-client.js"></script>
 <script src="live-cards.js"></script>
 ```

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

@@ -26,6 +26,7 @@ import {
   createFsBoardNonCorePlatformAdapter,
   createInProcessBoardCallbackTransport,
   createFsBoardChatStorage,
+  createInMemoryChatStorage,
   createNodeSpawnInvocationAdapter,
   createArtifactsStore,
   evaluateArgsMassaging,
@@ -34,9 +35,12 @@ import {
   registerInProcessExecutionHandler,
   startQueueLaneRunners,
   serializeRef,
-  serializeExecutionRef,
 } from 'yaml-flow/board-live-cards-node';
-import { registerInProcessBoardWorkerCallback } from 'yaml-flow/board-worker-adapter';
+import {
+  createImmediateBoardWorkerHook,
+  registerInProcessBoardWorkerCallback,
+  registerInProcessBoardWorkerInvoke,
+} from 'yaml-flow/board-worker-adapter';
 import {
   createStepMachineChatFlowRunner,
 } from 'yaml-flow/step-machine-public';
@@ -106,32 +110,6 @@ function applyFlowTimeout(flow, timeoutMs) {
   };
 }
 
-function buildChatHandlerFlowFromScript(scriptPath, timeoutMs = null) {
-  if (!scriptPath) return null;
-  const resolved = path.isAbsolute(scriptPath) ? scriptPath : path.resolve(BOARD_ROOT, scriptPath);
-  const resolvedTimeoutMs = normalizeTimeoutMs(timeoutMs, 300000);
-  return {
-    id: 'demo-chat-script-handler',
-    settings: { start_step: 'respond', max_total_steps: 5, timeout_ms: resolvedTimeoutMs },
-    steps: {
-      respond: {
-        description: 'Run the demo board chat responder from a script path',
-        handler: {
-          type: 'ref',
-          howToRun: 'local-node',
-          whatToRun: { kind: 'fs-path', value: resolved },
-          meta: 'chat-handler',
-        },
-        transitions: { success: 'completed', failure: 'failed' },
-      },
-    },
-    terminal_states: {
-      completed: { description: 'Chat response completed', return_intent: 'success', return_artifacts: false },
-      failed: { description: 'Chat response failed', return_intent: 'failure', return_artifacts: false },
-    },
-  };
-}
-
 function resolveKindRefFromConfig(configValue) {
   if (typeof configValue !== 'string' || !configValue.trim()) return null;
   const trimmed = configValue.trim();
@@ -174,20 +152,18 @@ const configuredRuntimeMode = normalizeRuntimeMode(
 );
 
 // Resolve top-level config defaults (used as fallbacks for per-board config)
-const configuredTaskExecutorPath = resolveFromConfig(serverConfig.taskExecutorPath);
-const configuredChatHandlerPath = resolveFromConfig(serverConfig.chatHandlerPath);
-const configuredFlowFromPath = loadJsonFromConfig(serverConfig.chatHandlerFlowPath);
+const configuredTaskExecutorPath = resolveFromConfig(serverConfig.taskExecutorPath)
+  || path.join(SERVER_DIR, 'board-worker', 'task-executor.js');
+const configuredChatHandlerPath = resolveFromConfig(serverConfig.chatHandlerPath)
+  || path.join(SERVER_DIR, 'chat-flow', 'copilot-chat', 'assistant.js');
+const configuredFlowFromPath = loadJsonFromConfig(serverConfig.chatHandlerFlowPath)
+  || loadJsonFromConfig(path.join('server', 'chat-flow', 'flow-steps.json'));
 const configuredChatHandlerFlow = applyFlowTimeout(
-  configuredFlowFromPath || buildChatHandlerFlowFromScript(configuredChatHandlerPath, configuredChatFlowTimeoutMs),
+  configuredFlowFromPath,
   configuredChatFlowTimeoutMs,
 );
 const configuredInferenceAdapterPath = resolveFromConfig(serverConfig.inferenceAdapterPath);
-const configuredStepMachineCliPath = resolveFromConfig(serverConfig.stepMachineCliPath);
 const configuredServerMetaStoreRef = resolveKindRefFromConfig(serverConfig.serverMetaStoreRef);
-
-if (!process.env.DEMO_STEP_MACHINE_CLI_PATH && configuredStepMachineCliPath) {
-  process.env.DEMO_STEP_MACHINE_CLI_PATH = configuredStepMachineCliPath;
-}
 if (!process.env.DEMO_CHAT_HANDLER_PATH && configuredChatHandlerPath) {
   process.env.DEMO_CHAT_HANDLER_PATH = configuredChatHandlerPath;
 }
@@ -262,24 +238,6 @@ 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') {
@@ -311,6 +269,21 @@ function makeHostedBoardWorkerRef(boardId, taskExecPath, transport, executionExt
   throw new Error(`Unsupported board-worker transport for demo host: ${transport}`);
 }
 
+function isHostedTaskExecutorRef(ref) {
+  return ref?.howToRun === 'queue-storage'
+    || ref?.howToRun === 'in-process-loop'
+    || ref?.howToRun === 'http:post'
+    || ref?.howToRun === 'http:get';
+}
+
+function normalizeImmediateExecutorResult(result) {
+  if (typeof result === 'string') return result;
+  if (result && typeof result === 'object' && !Array.isArray(result) && typeof result.stdout === 'string') {
+    return String(result.stdout);
+  }
+  return JSON.stringify(result ?? {});
+}
+
 function makeBoardWorkerCallbackTransport(serverUrl, boardApiBasePath, transport, boardId) {
   if (transport === 'in-process-loop' || transport === 'queue' || transport === 'http') {
     return createInProcessBoardCallbackTransport(`board:${boardId}:board-worker-callback`);
@@ -504,6 +477,24 @@ class MemoryAsyncBlobStorage {
     this.byteValues.delete(key);
   }
 
+  async renameKey(from, to) {
+    if (this.byteValues.has(from)) {
+      this.byteValues.set(to, this.byteValues.get(from));
+      this.byteValues.delete(from);
+      this.textValues.delete(to);
+      this.textValues.delete(from);
+      return true;
+    }
+    if (this.textValues.has(from)) {
+      this.textValues.set(to, this.textValues.get(from));
+      this.textValues.delete(from);
+      this.byteValues.delete(to);
+      this.byteValues.delete(from);
+      return true;
+    }
+    return false;
+  }
+
   async exists(key) {
     return this.textValues.has(key) || this.byteValues.has(key);
   }
@@ -735,6 +726,10 @@ function getCloudBoardBundle(boardId, notifyChannel, boardDir = null) {
   const kvNamespaces = new Map();
   const kvRefs = new Map();
   const blobNamespaces = new Map();
+  const blobRefs = new Map();
+  const chatRefs = new Map();
+  const queueRefs = new Map();
+  const journalRefs = new Map();
   const blobKindToNamespace = new Map([
     ['cloud-blob-key', ''],
     ['cloud-source-key', 'sources'],
@@ -772,11 +767,51 @@ function getCloudBoardBundle(boardId, notifyChannel, boardDir = null) {
     }
     return blobNamespaces.get(key);
   };
+  const getBlobRef = (ref) => {
+    const key = String(ref || '');
+    if (!blobRefs.has(key)) {
+      let kind = 'cloud-blob-key';
+      try {
+        kind = parseRef(key).kind;
+      } catch {
+        if (key.endsWith(':sources')) kind = 'cloud-source-key';
+        else if (key.endsWith(':archive')) kind = 'cloud-archive-key';
+        else if (key.endsWith(':scratch')) kind = 'cloud-scratch-key';
+      }
+      const keyRefFactory = kind === 'cloud-source-key' && stagedSourcesDir
+        ? (blobKey) => ({ kind: 'fs-path', value: path.join(stagedSourcesDir, ...String(blobKey).split('/')) })
+        : null;
+      blobRefs.set(key, new MemoryAsyncBlobStorage(kind, keyRefFactory));
+    }
+    return blobRefs.get(key);
+  };
+  const getChatRef = (ref) => {
+    const key = String(ref || '');
+    if (!chatRefs.has(key)) chatRefs.set(key, createInMemoryChatStorage());
+    return chatRefs.get(key);
+  };
+  const getQueueRef = (ref, lane) => {
+    const key = `${String(ref || '')}::${String(lane || '')}`;
+    if (!queueRefs.has(key)) {
+      if (lane === 'task-executor') queueRefs.set(key, boardWorkerQueueStorage);
+      else if (lane === 'chat-agent') queueRefs.set(key, chatAgentQueueStorage);
+      else if (lane === 'process-accumulated') queueRefs.set(key, processAccumulatedQueueStorage);
+      else queueRefs.set(key, new MemoryAsyncQueueStorage());
+    }
+    return queueRefs.get(key);
+  };
+  const getJournalRef = (ref) => {
+    const key = String(ref || '');
+    if (!journalRefs.has(key)) journalRefs.set(key, archiveFactory.stream(`board-journal-${stableHash(key)}`));
+    return journalRefs.get(key);
+  };
+  const queueStoreRef = serializeRef({ kind: 'cloud-queue-ref', value: `${boardId}:runtime` });
 
   const bundle = {
     getKvNamespace,
     getKvRef,
     getBlobNamespace,
+    getChatRef,
     adapter: null,
     notifyChannel,
   };
@@ -786,14 +821,16 @@ function getCloudBoardBundle(boardId, notifyChannel, boardDir = null) {
     kvStorage: (namespace) => getKvNamespace(namespace),
     kvStorageForRef: (ref) => getKvRef(ref),
     blobStorage: (namespace) => getBlobNamespace(namespace),
+    blobStorageForRef: (ref) => getBlobRef(ref),
+    chatStorageForRef: (ref) => getChatRef(ref),
+    queueStorageForRef: (ref, lane) => getQueueRef(ref, lane),
     scratchStorage: () => scratchStore,
     scratchStorageForRef: () => scratchStore,
     archiveFactory: () => archiveFactory,
     archiveFactoryForRef: () => archiveFactory,
     journalStorage: () => journalStorage,
-    queueStorage: boardWorkerQueueStorage,
-    chatAgentQueueStorage,
-    processAccumulatedQueueStorage,
+    journalStorageForRef: (ref) => getJournalRef(ref),
+    queueStoreRef,
     lock: createImmediateAsyncLock(),
     callbackTransport: undefined,
     resolveBlob: async (ref) => {
@@ -851,8 +888,10 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
   const runtimeCardStoreDir = path.join(runtimeCardsDir, 'store');
   fs.mkdirSync(runtimeCardStoreDir, { recursive: true });
   const runtimeOutDir = path.join(path.dirname(boardDir), 'runtime-out');
+  const fetchedSourcesDir = path.join(path.dirname(boardDir), 'sources');
   const scratchDir = path.join(runtimeOutDir, '.tmp');
   const archiveDir = path.join(runtimeOutDir, 'archive');
+  fs.mkdirSync(fetchedSourcesDir, { recursive: true });
   fs.mkdirSync(scratchDir, { recursive: true });
   fs.mkdirSync(archiveDir, { recursive: true });
 
@@ -866,6 +905,7 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
   if (runtimeMode === 'cloud') {
     const cloudBundle = getCloudBoardBundle(boardId, notifyChannel, boardDir);
     cloudBundle.adapter.callbackTransport = callbackTransport;
+    const boardRuntimeStoreRef = serializeRef({ kind: 'cloud-kv-ref', value: `${boardId}:runtime-board` });
     const cloudNonCoreAdapter = createFsBoardNonCorePlatformAdapter(
       parseRef(serializeRef({ kind: 'fs-path', value: boardDir })),
       {
@@ -873,35 +913,46 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
         ...(callbackTransport ? { callbackTransport } : {}),
       },
     );
+    const cloudKvStorageForRef = cloudNonCoreAdapter.kvStorageForRef.bind(cloudNonCoreAdapter);
+    cloudNonCoreAdapter.kvStorageForRef = (ref) => {
+      try {
+        if (parseRef(ref).kind === 'cloud-kv-ref') return cloudBundle.getKvRef(ref);
+      } catch {}
+      return cloudKvStorageForRef(ref);
+    };
     const cloudHostedTaskExecutorRef = makeHostedBoardWorkerRef(boardId, taskExecPath, boardWorkerTransport, executionExtra);
-    const cloudLocalSyncTaskExecutorRef = makeLocalTaskExecutorRef(taskExecPath, executionExtra);
-    if (cloudLocalSyncTaskExecutorRef) {
+    const hostedBoardWorkerDispatch = createHostedBoardWorkerDispatcher(boardId, taskExecPath);
+    if (hostedBoardWorkerDispatch) {
+      const immediateTaskExecutor = createImmediateBoardWorkerHook(hostedBoardWorkerDispatch, executionExtra);
       const invokeExecutor = cloudNonCoreAdapter.invokeExecutor.bind(cloudNonCoreAdapter);
-      cloudNonCoreAdapter.invokeExecutor = (ref, subcommand, execOpts) => {
-        const syncRef = isHostedTaskExecutorRef(ref) ? cloudLocalSyncTaskExecutorRef : ref;
-        return invokeExecutor(syncRef, subcommand, execOpts);
+      cloudNonCoreAdapter.invokeExecutor = async (ref, subcommand, execOpts) => {
+        if (isHostedTaskExecutorRef(ref)) {
+          const result = await immediateTaskExecutor({
+            subcommand,
+            ...(execOpts?.input !== undefined ? { input: execOpts.input } : {}),
+            ...(execOpts?.timeout !== undefined ? { timeoutMs: execOpts.timeout } : {}),
+            ...(ref?.extra ? { extra: ref.extra } : {}),
+          });
+          return normalizeImmediateExecutorResult(result);
+        }
+        return invokeExecutor(ref, subcommand, execOpts);
       };
     }
     cloudNonCoreAdapter.requestProcessAccumulated = () => {};
-    try {
-      const seedTeRef = cloudLocalSyncTaskExecutorRef ?? cloudHostedTaskExecutorRef;
-      if (seedTeRef) {
-        cloudNonCoreAdapter.kvStorage('config').write('task-executor', serializeExecutionRef(seedTeRef));
-      }
-    } catch (e) {
-      logger.warn(`[cloud:${boardId}] failed to seed non-core task-executor config: ${e?.message || e}`);
-    }
     return {
       label,
       boardAdapter: cloudBundle.adapter,
       nonCoreAdapter: cloudNonCoreAdapter,
-      artifactsAdapter: cloudBundle.adapter,
       baseRef: { kind: 'cloud-board', value: `board:${boardId}` },
-      cardStoreRef: `cloud:${boardId}:cards`,
-      outputsStoreRef: `cloud:${boardId}:runtime-out`,
-      artifactsStoreRef: `cloud:${boardId}:artifacts`,
-      scratchStoreRef: `cloud:${boardId}:scratch`,
-      archiveStoreRef: `cloud:${boardId}:archive`,
+      boardRuntimeStoreRef,
+      cardStoreRef: serializeRef({ kind: 'cloud-kv-ref', value: `${boardId}:cards` }),
+      outputsStoreRef: serializeRef({ kind: 'cloud-blob-key', value: `${boardId}:runtime-out` }),
+      queueStoreRef: serializeRef({ kind: 'cloud-queue-ref', value: `${boardId}:runtime` }),
+      fetchedSourcesStoreRef: serializeRef({ kind: 'cloud-source-key', value: `${boardId}:sources` }),
+      chatStoreRef: serializeRef({ kind: 'cloud-chat-ref', value: `${boardId}:chat` }),
+      artifactsStoreRef: serializeRef({ kind: 'cloud-blob-key', value: `${boardId}:artifacts` }),
+      scratchStoreRef: serializeRef({ kind: 'cloud-scratch-key', value: `${boardId}:scratch` }),
+      archiveStoreRef: serializeRef({ kind: 'cloud-archive-key', value: `${boardId}:archive` }),
       notifyRef: { kind: 'in-memory-notify', value: notifyChannel },
       taskExecutorRef: cloudHostedTaskExecutorRef,
       chatHandlerFlow,
@@ -910,40 +961,38 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow,
   }
 
   const baseRef = parseRef(serializeRef({ kind: 'fs-path', value: boardDir }));
+  const artifactsStoreRef = serializeRef({ kind: 'fs-path', value: runtimeCardsDir });
+  const cardStoreRef = serializeRef({ kind: 'fs-path', value: runtimeCardStoreDir });
+  const fetchedSourcesStoreRef = serializeRef({ kind: 'fs-path', value: fetchedSourcesDir });
+  const boardRuntimeStoreRef = serializeRef({ kind: 'fs-path', value: path.join(runtimeOutDir, '.board-runtime') });
+  const queueStoreRef = serializeRef({ kind: 'fs-path', value: path.join(runtimeOutDir, '.runtime') });
+  const scratchStoreRef = serializeRef({ kind: 'fs-path', value: scratchDir });
+  const archiveStoreRef = serializeRef({ kind: 'fs-path', value: archiveDir });
+  const chatStoreRef = serializeRef({ kind: 'fs-path', value: boardDir });
   const boardAdapter = createFsBoardPlatformAdapter(baseRef, {
     notifyChannel,
+    boardRuntimeStoreRef,
+    queueStoreRef,
     ...(callbackTransport ? { callbackTransport } : {}),
   });
   const nonCoreAdapter = createFsBoardNonCorePlatformAdapter(baseRef, {
     notifyChannel,
     ...(callbackTransport ? { callbackTransport } : {}),
   });
-  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 = () => {};
 
-  const artifactsRef = parseRef(serializeRef({ kind: 'fs-path', value: runtimeCardsDir }));
-  const artifactsAdapter = createFsBoardPlatformAdapter(artifactsRef, { suppressSpawn: true });
-  const artifactsStoreRef = serializeRef({ kind: 'fs-path', value: runtimeCardsDir });
-  const cardStoreRef = serializeRef({ kind: 'fs-path', value: runtimeCardStoreDir });
-  const scratchStoreRef = serializeRef({ kind: 'fs-path', value: scratchDir });
-  const archiveStoreRef = serializeRef({ kind: 'fs-path', value: archiveDir });
-
   return {
     label,
     boardAdapter,
     nonCoreAdapter,
-    artifactsAdapter,
     baseRef,
+    boardRuntimeStoreRef,
     cardStoreRef,
     outputsStoreRef: serializeRef({ kind: 'fs-path', value: runtimeOutDir }),
+    queueStoreRef,
+    fetchedSourcesStoreRef,
+    chatStoreRef,
     artifactsStoreRef,
     scratchStoreRef,
     archiveStoreRef,
@@ -1018,12 +1067,10 @@ const runtime = createMultiBoardServerRuntime({
     const chatHandlerFlow = applyFlowTimeout(
       loadJsonFromConfig(regular.chatHandlerFlowPath)
         || entry?.chatHandlerFlow
-        || buildChatHandlerFlowFromScript(chatHandlerPath, boardFlowTimeoutMs)
         || configuredChatHandlerFlow,
       boardFlowTimeoutMs,
     );
     const infAdapterPath = resolveFromConfig(regular.inferenceAdapterPath) || (entry?.inferenceAdapterPath || configuredInferenceAdapterPath);
-    const stepMachinePath = resolveFromConfig(regular.stepMachineCliPath || cfg?.stepMachineCliPath) || (entry?.stepMachineCliPath || configuredStepMachineCliPath);
     const runtimeMode = normalizeRuntimeMode(regular.mode || entry?.mode || cfg?.mode || configuredRuntimeMode);
     const boardWorkerTransport = normalizeHostedBoardWorkerTransport(
       runtimeMode,
@@ -1066,7 +1113,6 @@ const runtime = createMultiBoardServerRuntime({
       serverUrl: `http://127.0.0.1:${PORT}`,
       taskExecutorTransport: boardWorkerTransport,
       chatCopilotTimeoutMs,
-      ...(stepMachinePath ? { stepMachineCliPath: stepMachinePath } : {}),
     };
 
     const baseCfg = buildBoardContextConfig('base', boardDir, taskExecPath, chatHandlerFlow, infAdapterPath, boardId, baseExecutionExtra, runtimeMode);
@@ -1083,13 +1129,14 @@ const runtime = createMultiBoardServerRuntime({
       }
     }
 
-    const chatStorage = createFsBoardChatStorage(boardDir);
+    const chatStorage = runtimeMode === 'cloud'
+      ? getCloudBoardBundle(boardId, baseCfg.notifyRef.value, boardDir).getChatRef(baseCfg.chatStoreRef)
+      : createFsBoardChatStorage(boardDir);
     hostedBoardChatStorages.set(boardId, chatStorage);
 
     const singleBoardRuntime = createSingleBoardServerRuntime({
       apiBasePath: `${apiBasePath}/${boardId}`,
       boardId,
-      chatStorage,
       boards,
       invocationAdapter,
       chatFlowRunner: flowRunner,
@@ -1105,7 +1152,6 @@ const runtime = createMultiBoardServerRuntime({
         projectRoot: BOARD_ROOT,
         chatFlowRoot,
         chatCopilotTimeoutMs,
-        ...(stepMachinePath ? { stepMachineCliPath: stepMachinePath } : {}),
       },
     });
 
@@ -1125,6 +1171,9 @@ const runtime = createMultiBoardServerRuntime({
         });
         return { result: 'success', data: { dispatched: true } };
       });
+      registerInProcessBoardWorkerInvoke(`board:${boardId}:board-worker`, async (request) => {
+        return await hostedBoardWorkerDispatch(request);
+      });
     }
     if ((boardWorkerTransport === 'in-process-loop' || boardWorkerTransport === 'queue' || boardWorkerTransport === 'http') && hostedBoardWorkerDispatch) {
       registerInProcessBoardWorkerCallback(`board:${boardId}:board-worker-callback`, (payload) => {
@@ -1136,6 +1185,7 @@ const runtime = createMultiBoardServerRuntime({
     }
     const stopQueueRunner = startQueueLaneRunners(createHostedBoardQueueLaneRegistry({
       boardId,
+      queueStoreRef: baseCfg.queueStoreRef,
       runtime: singleBoardRuntime,
       boardAdapter: baseCfg.boardAdapter,
       logger,
@@ -1293,7 +1343,7 @@ server.listen(PORT, '127.0.0.1', () => {
   console.log('[board-server] endpoints:');
   console.log(`  GET  ${apiBasePath}                          <- list boards`);
   console.log(`  POST ${apiBasePath}  {id, label?}            <- register board`);
-  console.log(`  GET  ${apiBasePath}/:boardId/init-board`);
+  console.log(`  GET  ${apiBasePath}/:boardId/sse?one-shot`);
   console.log(`  GET  ${apiBasePath}/:boardId/sse`);
   console.log(`  GET  ${apiBasePath}/:boardId/board-status`);
   console.log(`  GET  ${apiBasePath}/:boardId/cards/:id`);

package/examples/board/server/board-worker/source_def_flows.json

@@ -36,14 +36,6 @@
       "serverUrl": {
         "type": "string",
         "description": "Base URL of the hosting server (e.g. http://127.0.0.1:7799). Used by source kinds that call server-side endpoints."
-      },
-      "boardLiveCardsCliJs": {
-        "type": "string",
-        "description": "Absolute path to board-live-cards-cli.js when injected by the runtime; for authored ExecutionRefs that target the packaged CLI, prefer kind 'yaml-flow-cli' with value 'board-live-cards-cli.js'."
-      },
-      "stepMachineCliPath": {
-        "type": "string",
-        "description": "Absolute path to step-machine-cli.js when injected by the runtime; for authored ExecutionRefs that target the packaged CLI, prefer kind 'yaml-flow-cli' with value 'step-machine-cli.js'."
       }
     }
   },

package/examples/board/server/board-worker/task-executor.js

@@ -38,9 +38,7 @@
  *     "boardRuntimeDir": "<relative>",
  *     "runtimeStatusDir": "<relative>",
  *     "cardsDir": "<relative>",
- *     "serverUrl": "<base url>",
- *     "boardLiveCardsCliJs": "<abs path>",
- *     "stepMachineCliPath": "<abs path>"
+ *     "serverUrl": "<base url>"
  *   }
  *
  * Source kinds are resolved from source_def_flows.json in resolveOrder.

package/examples/board/server/chat-flow/flow-steps.json

@@ -72,11 +72,10 @@
           "data._legacyEnvelope = data._hasLegacyEnvelope ? $eval(data._rawMessageText) : null",
           "data._legacyPrompt = ($type(data._legacyEnvelope.prompt) = \"string\" and $length($trim(data._legacyEnvelope.prompt)) > 0) ? data._legacyEnvelope.prompt : (($type(data._legacyEnvelope.text) = \"string\" and $length($trim(data._legacyEnvelope.text)) > 0) ? data._legacyEnvelope.text : (($type(data._legacyEnvelope.userText) = \"string\" and $length($trim(data._legacyEnvelope.userText)) > 0) ? data._legacyEnvelope.userText : (($type(data._legacyEnvelope.query) = \"string\" and $length($trim(data._legacyEnvelope.query)) > 0) ? data._legacyEnvelope.query : null)))",
           "data.userText = data._isEchoProbe ? $trim($substring(data._rawMessageText, data._markerLen, $length(data._rawMessageText) - (data._markerLen * 2))) : (($type(data._legacyPrompt) = \"string\" and $length($trim(data._legacyPrompt)) > 0) ? $trim(data._legacyPrompt) : data._rawMessageText)",
-          "data._attachMarker = \"[attach]\"",
-          "data.probeGenerateAttachment = $lowercase($substring(data.userText, 0, $length(data._attachMarker))) = data._attachMarker",
-          "data.userText = data.probeGenerateAttachment ? $trim($substring(data.userText, $length(data._attachMarker))) : data.userText",
+          "data._probeMode = $type(expects_data.probe) = \"string\" ? $lowercase($trim(expects_data.probe)) : \"\"",
+          "data.probeGenerateAttachment = data._probeMode = \"echoattach\"",
           "data.replyFiles = []",
-          "data.probe = data._isEchoProbe ? true : (data._legacyEnvelope.probe = true or data._legacyEnvelope.probe = 1 or ($type(data._legacyEnvelope.probe) = \"string\" and $count($filter([\"1\", \"true\", \"yes\", \"on\"], function($value) { $value = $lowercase($trim(data._legacyEnvelope.probe)) })) > 0))",
+          "data.probe = (data._isEchoProbe or $length(data._probeMode) > 0) ? true : (data._legacyEnvelope.probe = true or data._legacyEnvelope.probe = 1 or ($type(data._legacyEnvelope.probe) = \"string\" and $count($filter([\"1\", \"true\", \"yes\", \"on\"], function($value) { $value = $lowercase($trim(data._legacyEnvelope.probe)) })) > 0))",
           "data.chatHandlerMode = data._isEchoProbe ? \"echo-probe\" : (($type(data._legacyEnvelope.chatHandlerMode) = \"string\" and $length($trim(data._legacyEnvelope.chatHandlerMode)) > 0) ? $lowercase($trim(data._legacyEnvelope.chatHandlerMode)) : (data.probe ? \"probe\" : \"copilot\"))",
           "data.chatCopilotTimeoutMs = ($parsePositiveInt := function($value) { ($type($value) = \"number\" and $value > 0) ? $floor($value) : (($type($value) = \"string\" and $count($match($trim($value), /^[0-9]+$/)) > 0 and $number($trim($value)) > 0) ? $floor($number($trim($value))) : null) }; $legacyTimeout := $parsePositiveInt(data._legacyEnvelope.chatTimeoutMs); $legacyCopilotTimeout := $parsePositiveInt(data._legacyEnvelope.chatCopilotTimeoutMs); $fallbackTimeout := $parsePositiveInt(expects_data.chatCopilotTimeoutMs); $legacyTimeout ? $legacyTimeout : ($legacyCopilotTimeout ? $legacyCopilotTimeout : ($fallbackTimeout ? $fallbackTimeout : 300000)))",
           "result = \"success\""
@@ -95,7 +94,8 @@
       "handler": {
         "type": "compute-jsonata",
         "expr": [
-          "data.selectedAssistant = (expects_data.probe = true or expects_data.probe = \"true\" or expects_data.probe = 1 or $lowercase($string(expects_data.chatHandlerMode)) = \"probe\" or $lowercase($string(expects_data.chatHandlerMode)) = \"echo-probe\") ? \"probe\" : \"copilot\"",
+          "data._probeMode = $type(expects_data.probe) = \"string\" ? $lowercase($trim(expects_data.probe)) : \"\"",
+          "data.selectedAssistant = (expects_data.probe = true or expects_data.probe = \"true\" or expects_data.probe = 1 or $length(data._probeMode) > 0 or $lowercase($string(expects_data.chatHandlerMode)) = \"probe\" or $lowercase($string(expects_data.chatHandlerMode)) = \"echo-probe\") ? \"probe\" : \"copilot\"",
           "result = data.selectedAssistant"
         ]
       },