yaml-flow 5.2.2 → 5.2.5

package/examples/example-board/demo-chat-handler.js

@@ -4,9 +4,15 @@
  * Invoked by reusable-server-runtime after a user message is persisted:
  *   node demo-chat-handler.js --boardId <id> --cardId <id> --extraEncJson <base64json>
  *
- * extraEncJson decodes to: { chatDir, boardDir, lastChatFile }
+ * extraEncJson decodes to:
+ *   boardSetupRoot  — absolute path to board root (parent of runtime/, surface/, runtime-out/)
+ *   boardRuntimeDir — relative subdir: 'runtime'
+ *   runtimeStatusDir— relative subdir: 'runtime-out'
+ *   cardsDir        — relative subdir: 'surface/tmp-cards'
+ *   chatDir         — absolute path to the card's chats directory
+ *   lastChatFile    — filename of the just-written user message, e.g. '001_user.txt'
  *
- * If the card has a source entry containing a "copilot" key, invokes copilot_wrapper.bat.
+ * Invokes copilot_wrapper.bat with a prompt built from conversation history.
  * Session dir is per-card: os.tmpdir()/demo-chat-handler-sessions/<boardId>_<cardId>
  */
 
@@ -27,19 +33,27 @@ function getArg(name) {
   return idx !== -1 && args[idx + 1] !== undefined ? args[idx + 1] : null;
 }
 
-const boardId  = getArg('--boardId') || '';
-const cardId   = getArg('--cardId') || '';
-const extraStr = getArg('--extraEncJson') || '';
+const boardId     = getArg('--boardId') || '';
+const cardId      = getArg('--cardId') || '';
+const extraStr    = getArg('--extraEncJson') || '';
+const cleanOnExit = getArg('--cleanOnExit') || '';
 
 let extra = {};
 try { extra = JSON.parse(Buffer.from(extraStr, 'base64').toString('utf-8')); }
 catch { console.error('[demo-chat-handler] bad --extraEncJson'); process.exit(0); }
 
-const { chatDir, boardDir, lastChatFile } = extra;
-  console.error('[demo-chat-handler] missing chatDir/lastChatFile');
+const { boardSetupRoot, boardRuntimeDir, runtimeStatusDir, cardsDir, chatDir, lastChatFile } = extra;
+if (!boardSetupRoot || !chatDir || !lastChatFile) {
+  console.error('[demo-chat-handler] missing boardSetupRoot/chatDir/lastChatFile');
   process.exit(0);
 }
 
+// Resolve absolute paths from the structured extra fields
+const boardRuntimeDirAbs  = path.join(boardSetupRoot, boardRuntimeDir  || 'runtime');
+const runtimeStatusDirAbs = path.join(boardSetupRoot, runtimeStatusDir || 'runtime-out');
+const cardsDirAbs         = path.join(boardSetupRoot, cardsDir         || path.join('surface', 'tmp-cards'));
+const chatDirAbs          = chatDir;
+
 // ---------------------------------------------------------------------------
 // Read conversation history
 // ---------------------------------------------------------------------------
@@ -57,29 +71,31 @@ function readHistory(dir) {
   } catch { return []; }
 }
 
-// ---------------------------------------------------------------------------
-// Check if card has a 'copilot' source entry
-// ---------------------------------------------------------------------------
-function hasCopilotSource(bDir, cId) {
-  try {
-    const boardGraph = JSON.parse(fs.readFileSync(path.join(bDir, 'board-graph.json'), 'utf-8'));
-    const nodes = boardGraph?.graph?.nodes ?? boardGraph?.nodes ?? {};
-    const card  = nodes[cId];
-    const sources = card.sources ?? card.card_data?.sources ?? [];
-    if (Array.isArray(sources)) return sources.some(s => s && typeof s === 'object' && 'copilot' in s);
-    if (typeof sources === 'object') return 'copilot' in sources;
-    return false;
-  } catch { return false; }
-}
-
 // ---------------------------------------------------------------------------
 // Build prompt
 // ---------------------------------------------------------------------------
-function buildPrompt(cId, bId, history) {
+function buildPrompt(cId, bId, history, responseFileRel) {
+  const cardSetupDirRel  = path.join(cardsDir, cId).replace(/\\/g, '/');
+  const runtimeDirRel    = boardRuntimeDir  || 'runtime';
+  const statusDirRel     = runtimeStatusDir || 'runtime-out';
+  const chatDirRel       = path.relative(boardSetupRoot, chatDir).replace(/\\/g, '/');
+  const lastQueryFileRel = path.join(chatDirRel, lastChatFile).replace(/\\/g, '/');
+
+  const contextBlock = [
+    'We are currently doing a three way orchestration.',
+    'You are the responder who has context of the cards in ' + cardSetupDirRel + ',',
+    'card runtime statuses in ' + runtimeDirRel + ',',
+    'and computed outputs in ' + statusDirRel + '.',
+    'I am just a mediator passing on the query.',
+    'The user sees the data available in cards which is rendered, and the status from ' + statusDirRel + '.',
+    'Everything else is internal detail not to be exposed to the user.',
+    'The conversation history can be found in ' + chatDirRel + ' and the last query is in ' + lastQueryFileRel + '.',
+    'Write your response to the user in ' + responseFileRel + ' (relative to your working directory).',
+    'Give me only a bare minimum log line on what you did — the response in ' + responseFileRel + ' is what the user will see.',
+  ].join(' ');
+
   return [
-    'You are a helpful assistant embedded in a live card (card: "' + cId + '", board: "' + bId + '").',
-    'Help the user understand and act on the data shown in this card.',
-    'Be concise.',
+    contextBlock,
     '',
     ...history,
     'Assistant:',
@@ -120,32 +136,23 @@ function runWrapper(prompt, sessionDir, workingDir) {
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
-const history    = readHistory(chatDir);
-const sessionDir = path.join(os.tmpdir(), 'demo-chat-handler-sessions', boardId + '_' + cardId);
-const workingDir = boardDir || process.cwd();
-const prompt     = buildPrompt(cardId, boardId, history);
+const serialMatch    = String(lastChatFile).match(/^(\d+)/);
+const nextSerial     = serialMatch ? parseInt(serialMatch[1], 10) + 1 : 1;
+const nextName       = String(nextSerial).padStart(3, '0') + '-assistant.txt';
+const responseFileRel = path.relative(boardSetupRoot, path.join(chatDir, nextName)).replace(/\\/g, '/');
 
-let response = '';
-if (hasCopilotSource(boardDir, cardId)) {
-  try {
-    response = runWrapper(prompt, sessionDir, workingDir);
-  } catch (err) {
-    response = 'Sorry, I could not reach the LLM right now. (' + String(err?.message ?? err).slice(0, 120) + ')';
-    console.error('[demo-chat-handler] wrapper failed: ' + (err?.message ?? err));
-  }
-} else {
-  response = 'No copilot source configured for this card.';
-}
-
-// Write assistant response as next serial file
-const serialMatch = String(lastChatFile).match(/^(\d+)/);
-const nextSerial  = serialMatch ? parseInt(serialMatch[1], 10) + 1 : 1;
-const nextName    = String(nextSerial).padStart(3, '0') + '-assistant.txt';
-const nextPath    = path.join(chatDir, nextName);
+const history    = readHistory(chatDirAbs);
+const sessionDir = path.join(os.tmpdir(), 'demo-chat-handler-sessions', boardId + '_' + cardId);
+const workingDir = boardSetupRoot;
+const prompt     = buildPrompt(cardId, boardId, history, responseFileRel);
 
 try {
-  fs.writeFileSync(nextPath, response + '\n', 'utf-8');
-  console.log('[demo-chat-handler] cardId="' + cardId + '" wrote response -> ' + nextPath);
+  runWrapper(prompt, sessionDir, workingDir);
+  console.log('[demo-chat-handler] cardId="' + cardId + '" copilot invoked, response expected at ' + responseFileRel);
 } catch (err) {
-  console.error('[demo-chat-handler] write failed: ' + err.message);
+  console.error('[demo-chat-handler] wrapper failed: ' + (err?.message ?? err));
+} finally {
+  if (cleanOnExit) {
+    try { fs.unlinkSync(cleanOnExit); } catch {}
+  }
 }

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

@@ -3,6 +3,7 @@
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';
+import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
 
@@ -90,6 +91,11 @@ function resetRuntime() {
     fs.rmSync(setupDir, { recursive: true, force: true });
     console.log(`[demo-server] reset: wiped ${setupDir}`);
   }
+  const chatSessions = path.join(os.tmpdir(), 'demo-chat-handler-sessions');
+  if (fs.existsSync(chatSessions)) {
+    fs.rmSync(chatSessions, { recursive: true, force: true });
+    console.log(`[demo-server] reset: wiped ${chatSessions}`);
+  }
 }
 
 if (RESET_ON_START) {

package/examples/example-board/demo-shell-browser.html

@@ -6,9 +6,9 @@
   <title>Example Board Demo (Browser Runtime)</title>
   <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/jsonata/jsonata.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/board-livegraph-engine.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

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

@@ -16,10 +16,10 @@
   </style>
   <script src="https://cdn.jsdelivr.net/npm/jsonata/jsonata.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/card-compute.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livegraph-engine.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.2/browser/board-livecards-runtime-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/card-compute.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/board-livegraph-engine.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@5.2.5/browser/board-livecards-runtime-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "5.2.2",
+  "version": "5.2.5",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",