yaml-flow 8.1.1 → 8.2.0

package/examples/board/demo-server.js

@@ -16,9 +16,13 @@ import {
 import {
   createFsBoardPlatformAdapter,
   createArtifactsStore,
+  invokeRefSync,
   parseRef,
   serializeRef,
 } from 'yaml-flow/board-live-cards-node';
+import {
+  createStepMachineChatFlowRunner,
+} from 'yaml-flow/step-machine-public';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -41,6 +45,40 @@ function resolveFromConfig(configValue) {
   return path.resolve(__dirname, configValue);
 }
 
+function loadJsonFromConfig(configValue) {
+  const resolved = resolveFromConfig(configValue);
+  if (!resolved || !fs.existsSync(resolved)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(resolved, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function buildChatHandlerFlowFromScript(scriptPath) {
+  if (!scriptPath) return null;
+  const resolved = path.isAbsolute(scriptPath) ? scriptPath : path.resolve(__dirname, scriptPath);
+  return {
+    id: 'demo-chat-script-handler',
+    settings: { start_step: 'respond', max_total_steps: 5, timeout_ms: 120000 },
+    steps: {
+      respond: {
+        description: 'Run the example board chat responder from a script path',
+        handler: {
+          type: 'ref',
+          howToRun: 'local-node',
+          whatToRun: { kind: 'fs-path', value: resolved },
+        },
+        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();
@@ -62,10 +100,12 @@ const configuredCardsDir = resolveFromConfig(serverConfig.cardsDir);
 const configuredTaskExecutorPath = resolveFromConfig(serverConfig.taskExecutorPath || serverConfig.demoTaskExecutorPath);
 const configuredStepMachineCliPath = resolveFromConfig(serverConfig.stepMachineCliPath);
 const configuredChatHandlerPath = resolveFromConfig(serverConfig.chatHandlerPath);
+const configuredChatHandlerFlow = loadJsonFromConfig(serverConfig.chatHandlerFlowPath) || buildChatHandlerFlowFromScript(configuredChatHandlerPath);
 const configuredInferenceAdapterPath = resolveFromConfig(serverConfig.inferenceAdapterPath);
 const configuredGandalfCardsDir = resolveFromConfig(serverConfig.gandalfCardsDir);
 const configuredGandalfTaskExecutorPath = resolveFromConfig(serverConfig.gandalfTaskExecutorPath);
 const configuredGandalfChatHandlerPath = resolveFromConfig(serverConfig.gandalfChatHandlerPath);
+const configuredGandalfChatHandlerFlow = loadJsonFromConfig(serverConfig.gandalfChatHandlerFlowPath) || buildChatHandlerFlowFromScript(configuredGandalfChatHandlerPath);
 const configuredGandalfInferenceAdapterPath = resolveFromConfig(serverConfig.gandalfInferenceAdapterPath);
 const configuredServerMetaStoreRef = resolveKindRefFromConfig(serverConfig.serverMetaStoreRef);
 
@@ -104,12 +144,12 @@ const defaultCardsDir = path.resolve(
 );
 
 const defaultTaskExecutorPath = process.env.DEMO_TASK_EXECUTOR_PATH || configuredTaskExecutorPath || null;
-const defaultChatHandlerPath = process.env.DEMO_CHAT_HANDLER_PATH || configuredChatHandlerPath || null;
+const defaultChatHandlerFlow = configuredChatHandlerFlow || buildChatHandlerFlowFromScript(process.env.DEMO_CHAT_HANDLER_PATH || configuredChatHandlerPath || null);
 const defaultInferenceAdapterPath = process.env.DEMO_INFERENCE_ADAPTER_PATH || configuredInferenceAdapterPath || null;
 const defaultStepMachineCliPath = process.env.DEMO_STEP_MACHINE_CLI_PATH || configuredStepMachineCliPath || null;
 const defaultGandalfCardsDir = process.env.DEMO_GANDALF_CARDS_DIR || configuredGandalfCardsDir || null;
 const defaultGandalfTaskExecutorPath = process.env.DEMO_GANDALF_TASK_EXECUTOR_PATH || configuredGandalfTaskExecutorPath || null;
-const defaultGandalfChatHandlerPath = process.env.DEMO_GANDALF_CHAT_HANDLER_PATH || configuredGandalfChatHandlerPath || null;
+const defaultGandalfChatHandlerFlow = configuredGandalfChatHandlerFlow || buildChatHandlerFlowFromScript(process.env.DEMO_GANDALF_CHAT_HANDLER_PATH || configuredGandalfChatHandlerPath || null);
 const defaultGandalfInferenceAdapterPath = process.env.DEMO_GANDALF_INFERENCE_ADAPTER_PATH || configuredGandalfInferenceAdapterPath || null;
 
 // ---------------------------------------------------------------------------
@@ -287,7 +327,7 @@ const logger = { info: console.log, warn: console.warn, error: console.error };
 // Track per-board host config for demo-setup (FS paths are host concerns, not runtime concerns)
 const boardHostConfig = new Map();
 
-function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerPath, infAdapterPath, boardId) {
+function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerFlow, infAdapterPath, boardId) {
   fs.mkdirSync(boardDir, { recursive: true });
 
   // Runtime card store lives inside the board's setup dir, isolated from the source cards dir.
@@ -321,7 +361,7 @@ function buildBoardContextConfig(label, boardDir, taskExecPath, chatHandlerPath,
     outputsStoreRef: serializeRef({ kind: 'fs-path', value: path.join(path.dirname(boardDir), 'runtime-out', '.outputs') }),
     notifyRef: { kind: 'named-pipe', value: namedPipePath(notifyChannel) },
     taskExecutorRef: makeExecutionRef(taskExecPath, 'task-executor'),
-    chatHandlerRef: makeExecutionRef(chatHandlerPath, 'chat-handler'),
+    chatHandlerFlow,
     inferenceAdapterRef: makeExecutionRef(infAdapterPath, 'inference-adapter'),
   };
 }
@@ -335,24 +375,32 @@ const runtime = createMultiBoardServerRuntime({
     const sourceCardsDir = typeof entry.cardsDir === 'string' ? path.resolve(entry.cardsDir) : defaultCardsDir;
     const boardRoot = path.join(setupDir, `board-${boardId}`);
     const boardDir = path.join(boardRoot, 'runtime');
+    const flowRunner = createStepMachineChatFlowRunner({
+      invokeRef: (ref, stepArgs) => invokeRefSync(ref, stepArgs, {
+        cliDir: __dirname,
+        cwd: __dirname,
+        label: 'demo-chat-flow',
+        timeoutMs: 120000,
+      }),
+    });
 
     const taskExecPath = typeof entry.taskExecutorPath === 'string' ? entry.taskExecutorPath : defaultTaskExecutorPath;
-    const chatHandlerPath_ = typeof entry.chatHandlerPath === 'string' ? entry.chatHandlerPath : defaultChatHandlerPath;
+    const chatHandlerFlow = entry.chatHandlerFlow || loadJsonFromConfig(entry.chatHandlerFlowPath) || buildChatHandlerFlowFromScript(typeof entry.chatHandlerPath === 'string' ? entry.chatHandlerPath : null) || defaultChatHandlerFlow;
     const infAdapterPath = typeof entry.inferenceAdapterPath === 'string' ? entry.inferenceAdapterPath : defaultInferenceAdapterPath;
     const stepMachinePath = typeof entry.stepMachineCliPath === 'string' ? entry.stepMachineCliPath : defaultStepMachineCliPath;
 
     const sourceGandalfCardsDir = typeof entry.gandalfCardsDir === 'string' ? path.resolve(entry.gandalfCardsDir) : defaultGandalfCardsDir;
     const gandalfTaskExecPath = typeof entry.gandalfTaskExecutorPath === 'string' ? entry.gandalfTaskExecutorPath : defaultGandalfTaskExecutorPath;
-    const gandalfChatPath = typeof entry.gandalfChatHandlerPath === 'string' ? entry.gandalfChatHandlerPath : defaultGandalfChatHandlerPath;
+    const gandalfChatFlow = entry.gandalfChatHandlerFlow || loadJsonFromConfig(entry.gandalfChatHandlerFlowPath) || buildChatHandlerFlowFromScript(typeof entry.gandalfChatHandlerPath === 'string' ? entry.gandalfChatHandlerPath : null) || defaultGandalfChatHandlerFlow;
     const gandalfInfPath = typeof entry.gandalfInferenceAdapterPath === 'string' ? entry.gandalfInferenceAdapterPath : defaultGandalfInferenceAdapterPath;
 
-    const baseCfg = buildBoardContextConfig('base', boardDir, taskExecPath, chatHandlerPath_, infAdapterPath, boardId);
+    const baseCfg = buildBoardContextConfig('base', boardDir, taskExecPath, chatHandlerFlow, infAdapterPath, boardId);
 
     const boards = [baseCfg];
     let gandalfBoardDir = null;
     if (sourceGandalfCardsDir && gandalfTaskExecPath) {
       gandalfBoardDir = path.join(boardRoot, 'gandalf-runtime');
-      const gandalfCfg = buildBoardContextConfig('gandalf', gandalfBoardDir, gandalfTaskExecPath, gandalfChatPath, gandalfInfPath, boardId);
+      const gandalfCfg = buildBoardContextConfig('gandalf', gandalfBoardDir, gandalfTaskExecPath, gandalfChatFlow, gandalfInfPath, boardId);
       gandalfCfg.outputsStoreRef = serializeRef({ kind: 'fs-path', value: path.join(boardRoot, 'gandalf-runtime-out', '.outputs') });
       boards.push(gandalfCfg);
     }
@@ -372,6 +420,7 @@ const runtime = createMultiBoardServerRuntime({
       boardId,
       boards,
       invocationAdapter,
+      chatFlowRunner: flowRunner,
       notificationTransport,
       logger,
       serverUrl: `http://127.0.0.1:${PORT}`,

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

@@ -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.1.1/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.1.1/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.0/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/board/test/demo-http-test.js

@@ -139,6 +139,36 @@ function waitUntil(predicate, timeoutMs, label) {
   });
 }
 
+function waitUntilAsync(predicate, timeoutMs, label) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs;
+    let inFlight = false;
+    const interval = setInterval(async () => {
+      if (inFlight) return;
+      inFlight = true;
+      try {
+        const result = await predicate();
+        if (result !== undefined && result !== null && result !== false) {
+          clearInterval(interval);
+          resolve(result);
+          return;
+        }
+        if (Date.now() > deadline) {
+          clearInterval(interval);
+          reject(new Error(`Timeout (${timeoutMs}ms) waiting for: ${label}`));
+        }
+      } catch {
+        if (Date.now() > deadline) {
+          clearInterval(interval);
+          reject(new Error(`Timeout (${timeoutMs}ms) waiting for: ${label}`));
+        }
+      } finally {
+        inFlight = false;
+      }
+    }, 150);
+  });
+}
+
 const waitForInitialPayload = (ms = 15_000) =>
   waitUntil(() => NS.initialPayload || false, ms, 'initial SSE payload');
 
@@ -256,6 +286,21 @@ try {
   assert(httpSummary, 'statusSnapshot.summary missing from board-status');
   console.log(`[step4] board-status summary: ${JSON.stringify(httpSummary)}`);
 
+  console.log('\n=== Step 5: echo chat flow ===');
+  const chatCardId = initialPayload.cardDefinitions[0].id;
+  const sendChatRes = await httpJson('POST', `${BASE}/cards/${encodeURIComponent(chatCardId)}/actions`, {
+    actionType: 'chat-send',
+    payload: { text: 'hello echo test' },
+  });
+  assert(sendChatRes.status === 200, `chat-send returned ${sendChatRes.status}`);
+  const chats = await waitUntilAsync(async () => {
+    const chatsRes = await httpGet(`${BASE}/cards/${encodeURIComponent(chatCardId)}/chats`);
+    const messages = chatsRes.data && Array.isArray(chatsRes.data.messages) ? chatsRes.data.messages : [];
+    return messages.some((m) => typeof m.text === 'string' && m.text.includes('Echo: hello echo test')) ? messages : false;
+  }, 10_000, 'echo chat response');
+  assert(chats.some((m) => typeof m.text === 'string' && m.text.includes('Echo: hello echo test')), 'echo chat response missing');
+  console.log('[step5] echo chat response received');
+
   // ── T1: PATCH holdings (+1 row) and verify recomputation ──
   console.log('\n=== T1: patch holdings (+1 row) ===');
 

package/examples/board-local/demo-shell-localstorage.html

@@ -6,13 +6,13 @@
   <title>Example Board Demo (LocalStorage Runtime)</title>
   <link rel="icon" type="image/svg+xml" href="../../browser/favicon.svg" />
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.1.1/browser/compute-jsonata.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.0/browser/compute-jsonata.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
   <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.1.1/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.1.1/browser/board-livecards-localstorage.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.0/browser/board-livecards-localstorage.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/lib/{artifacts-store-lib-public-BWC3YuLa.d.ts → artifacts-store-lib-public-BPW_C15z.d.ts}

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-dJAl5IL-.js';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-B8b_0k_j.js';
 import { B as BlobStorage } from './storage-interface-BhAON-gW.js';
 
 /**

package/lib/{artifacts-store-lib-public-DBICnGL6.d.cts → artifacts-store-lib-public-DfU9t5-S.d.cts}

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-BF9FP0mL.cjs';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-W2zK59m0.cjs';
 import { B as BlobStorage } from './storage-interface-BhAON-gW.cjs';
 
 /**

package/lib/artifacts-store-public.d.cts

@@ -1,5 +1,5 @@
-import './board-live-cards-public-BF9FP0mL.cjs';
-export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-DBICnGL6.cjs';
+import './board-live-cards-public-W2zK59m0.cjs';
+export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-DfU9t5-S.cjs';
 import './storage-interface-BhAON-gW.cjs';
 import './execution-refs.cjs';
 import './types-BBhqYGhE.cjs';

package/lib/artifacts-store-public.d.ts

@@ -1,5 +1,5 @@
-import './board-live-cards-public-dJAl5IL-.js';
-export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-BWC3YuLa.js';
+import './board-live-cards-public-B8b_0k_j.js';
+export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-BPW_C15z.js';
 import './storage-interface-BhAON-gW.js';
 import './execution-refs.js';
 import './types-BBhqYGhE.js';