yaml-flow 5.1.0 → 5.2.0

package/examples/example-board/cards/card-market-prices.json

@@ -0,0 +1,51 @@
+{
+  "id": "card-market-prices",
+  "meta": {
+    "title": "Market Prices",
+    "tags": ["prices", "market"],
+    "desc": "Fetches live prices for portfolio tickers. Publishes enriched quote data for downstream portfolio value calculations."
+  },
+  "requires": ["holdings"],
+  "sources": [
+    {
+      "bindTo": "quotes",
+      "outputFile": "market-prices-quotes.json",
+      "chartApi": {
+        "url": "https://query1.finance.yahoo.com/v8/finance/chart/{{ticker}}?interval=1d&range=1d",
+        "headers": {
+          "User-Agent": "Mozilla/5.0 (compatible; portfolio-tracker-demo/1.0)"
+        }
+      },
+      "tickersFrom": "holdings.ticker",
+      "mock": "quotes"
+    }
+  ],
+  "compute": [
+    {
+      "bindTo": "prices",
+      "expr": "$map(fetched_sources.quotes.quoteResponse.result, function($q) { {\"ticker\": $q.symbol, \"name\": $q.shortName, \"price\": $round($q.regularMarketPrice, 2), \"change\": $round($q.regularMarketChange, 2), \"chg_pct\": $round($q.regularMarketChangePercent, 2)} })"
+    }
+  ],
+  "provides": [
+    { "bindTo": "quotes", "src": "fetched_sources.quotes" }
+  ],
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Prices",
+        "data": {
+          "bind": "computed_values.prices",
+          "columns": ["ticker", "name", "price", "change", "chg_pct"],
+          "sortable": true
+        }
+      }
+    ],
+    "layout": {
+      "board": { "col": 4, "order": 2 },
+      "canvas": { "x": 400, "y": 50, "w": 400, "h": 340 }
+    },
+    "features": { "refresh": true }
+  },
+  "card_data": {}
+}

package/examples/example-board/cards/card-portfolio-action.json

@@ -0,0 +1,19 @@
+{
+  "id": "card-portfolio-action",
+  "meta": {
+    "title": "Action Signal",
+    "tags": ["portfolio", "action"],
+    "desc": "Actionable recommendation sourced from Portfolio Intelligence."
+  },
+  "requires": ["portfolio_action"],
+  "view": {
+    "elements": [
+      { "kind": "markdown", "data": { "bind": "requires.portfolio_action" } }
+    ],
+    "layout": {
+      "board": { "col": 4, "order": 6 },
+      "canvas": { "x": 1660, "y": 50, "w": 300, "h": 160 }
+    }
+  },
+  "card_data": {}
+}

package/examples/example-board/cards/card-portfolio-risks.json

@@ -0,0 +1,19 @@
+{
+  "id": "card-portfolio-risks",
+  "meta": {
+    "title": "Risk Watch",
+    "tags": ["portfolio", "risk"],
+    "desc": "Per-ticker risk signals sourced from Portfolio Intelligence."
+  },
+  "requires": ["portfolio_risks"],
+  "view": {
+    "elements": [
+      { "kind": "markdown", "data": { "bind": "requires.portfolio_risks" } }
+    ],
+    "layout": {
+      "board": { "col": 3, "order": 5 },
+      "canvas": { "x": 1300, "y": 270, "w": 340, "h": 220 }
+    }
+  },
+  "card_data": {}
+}

package/examples/example-board/cards/card-portfolio-value.json

@@ -0,0 +1,62 @@
+{
+  "id": "card-portfolio-value",
+  "meta": {
+    "title": "Portfolio Value",
+    "tags": ["portfolio", "value"],
+    "desc": "Computes total portfolio value, gainers/losers summary, and per-position P&L from holdings and live market quotes."
+  },
+  "requires": ["holdings", "quotes"],
+  "provides": [
+    { "bindTo": "positions", "src": "computed_values.positions" }
+  ],
+  "compute": [
+    {
+      "bindTo": "positions",
+      "expr": "($hMap := $merge(requires.holdings.{ticker: $}); $map(requires.quotes.quoteResponse.result, function($q) { ($h := $lookup($hMap, $q.symbol); $qty := $h.quantity; $cb := $h.cost_basis; $val := $round($q.regularMarketPrice * $qty, 2); $cost := $round($cb * $qty, 2); $chg := $round($q.regularMarketChange * $qty, 2); {\"ticker\": $q.symbol, \"quantity\": $qty, \"cost_basis\": $cb, \"price\": $round($q.regularMarketPrice, 2), \"value\": $val, \"gain_$\": $round($val - $cost, 2), \"gain_%\": $round(($val - $cost) / $cost * 100, 2), \"chg_$\": $chg, \"chg_pct\": $round($q.regularMarketChangePercent, 2)}) }))"
+    },
+    {
+      "bindTo": "totalValue",
+      "expr": "$round($sum(computed_values.positions.value), 2)"
+    },
+    {
+      "bindTo": "gainers",
+      "expr": "$count($filter(computed_values.positions, function($p){ $p.chg_pct > 0 }))"
+    },
+    {
+      "bindTo": "losers",
+      "expr": "$count($filter(computed_values.positions, function($p){ $p.chg_pct < 0 }))"
+    },
+    {
+      "bindTo": "gainersLosers",
+      "expr": "computed_values.gainers & ' up · ' & computed_values.losers & ' down'"
+    }
+  ],
+  "view": {
+    "elements": [
+      {
+        "kind": "metric",
+        "label": "Portfolio Value ($)",
+        "data": { "bind": "computed_values.totalValue" }
+      },
+      {
+        "kind": "text",
+        "data": { "bind": "computed_values.gainersLosers" }
+      },
+      {
+        "kind": "table",
+        "label": "Positions",
+        "data": {
+          "bind": "computed_values.positions",
+          "columns": ["ticker", "value", "gain_$", "gain_%"],
+          "sortable": true
+        }
+      }
+    ],
+    "layout": {
+      "board": { "col": 4, "order": 3 },
+      "canvas": { "x": 840, "y": 50, "w": 420, "h": 380 }
+    },
+    "features": { "chat": true }
+  },
+  "card_data": {}
+}

package/examples/example-board/cards/card-portfolio.json

@@ -0,0 +1,44 @@
+{
+  "id": "card-portfolio",
+  "meta": {
+    "title": "My Portfolio",
+    "tags": ["portfolio"],
+    "desc": "Manage your stock holdings — edit tickers and quantities inline, add or delete rows. Changes propagate downstream immediately."
+  },
+  "provides": [
+    { "bindTo": "holdings", "src": "card_data.holdings" }
+  ],
+  "compute": [],
+  "view": {
+    "elements": [
+      {
+        "kind": "editable-table",
+        "label": "Holdings",
+        "data": {
+          "bind": "card_data.holdings",
+          "writeTo": "card_data.holdings",
+          "columns": ["ticker", "quantity", "cost_basis"],
+          "schema": {
+            "properties": {
+              "quantity":   { "type": "number" },
+              "cost_basis": { "type": "number" }
+            }
+          }
+        }
+      }
+    ],
+    "layout": {
+      "board": { "col": 4, "order": 1 },
+      "canvas": { "x": 50, "y": 50, "w": 320, "h": 340 }
+    },
+    "features": { "chat": true }
+  },
+  "card_data": {
+    "holdings": [
+      { "ticker": "AAPL",  "quantity": 10, "cost_basis": 150.00 },
+      { "ticker": "MSFT",  "quantity": 5,  "cost_basis": 310.00 },
+      { "ticker": "GOOGL", "quantity": 2,  "cost_basis": 280.00 },
+      { "ticker": "TSLA",  "quantity": 3,  "cost_basis": 200.00 }
+    ]
+  }
+}

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

@@ -1,21 +1,26 @@
 #!/usr/bin/env node
-// demo-chat-handler.js — Echo chat handler for demo/example boards.
-//
-// Invoked by reusable-server-runtime after a user chat message is persisted,
-// when a .chat-handler file is present in the board runtime directory.
-//
-// Invocation contract:
-//   node demo-chat-handler.js --boardId <id> --cardId <id> --extra <json>
-//
-// --extra JSON shape: { chatDir: "<abs path>", boardDir: "<abs path>", lastChatFile: "<filename>" }
-//
-// This demo handler:
-//   1. Reads the content of the last chat file (the user message just written).
-//   2. Computes the next serial by incrementing the leading number from lastChatFile.
-//   3. Writes <nextSerial>-assistant.txt to chatDir with: "Echoing <original content>"
+/**
+ * demo-chat-handler.js — LLM-based chat handler for example-board.
+ *
+ * Protocol (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: "<abs>", boardDir: "<abs>", lastChatFile: "<filename>" }
+ *
+ * Design:
+ *   The chat handler is universal — it does not depend on any source definition or card model.
+ *   It reads the full conversation history from chatDir, builds a grounded system prompt
+ *   (scoped to the card and board), and calls the LLM directly (Copilot CLI).
+ *   Copilot is invoked from boardDir (cwd), so it naturally has access to board files.
+ *
+ *   The LLM is the sole decision-maker. No rule-based fallback is used here — if the LLM
+ *   is unavailable, the handler writes a short error acknowledgment so the user isn't left
+ *   with a silent failure.
+ */
 
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
 
 const args = process.argv.slice(2);
 
@@ -24,46 +29,381 @@ 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') || '';
 
 let extra = {};
 try {
   extra = JSON.parse(Buffer.from(extraStr, 'base64').toString('utf-8'));
 } catch {
-  console.error('[demo-chat-handler] could not parse --extra JSON');
+  console.error('[demo-chat-handler] could not parse --extraEncJson');
   process.exit(0);
 }
 
-const { chatDir, lastChatFile } = extra;
+const { chatDir, boardDir, lastChatFile } = extra;
 
 if (!chatDir || !lastChatFile) {
-  console.error('[demo-chat-handler] --extra must contain chatDir and lastChatFile');
+  console.error('[demo-chat-handler] --extraEncJson must contain chatDir and lastChatFile');
   process.exit(0);
 }
 
-// Read the user message from the last chat file.
-const lastChatPath = path.join(chatDir, lastChatFile);
-let content = '';
+// ---------------------------------------------------------------------------
+// Read full conversation history from chatDir (all user + assistant turns)
+// ---------------------------------------------------------------------------
+function readConversationHistory(dir) {
+  let files;
+  try {
+    files = fs.readdirSync(dir).filter(f => /^\d+[-_](user|assistant)\.txt$/i.test(f));
+    files.sort();
+  } catch {
+    return [];
+  }
+  return files.map(f => {
+    const role = /user/i.test(f) ? 'User' : 'Assistant';
+    let text = '';
+    try { text = fs.readFileSync(path.join(dir, f), 'utf-8').trim(); } catch {}
+    return `${role}: ${text}`;
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Build prompt: system instruction + conversation turns
+// ---------------------------------------------------------------------------
+function buildPrompt(bId, cId, history) {
+  return [
+    `You are a helpful assistant embedded in a live data card (card: "${cId}", board: "${bId}").`,
+    'Help the user understand and act on the data shown in this card.',
+    'Be concise — this is an inline card chat, not a full conversation window.',
+    'Ground answers in the card\'s data context. Ask one short question if the intent is ambiguous.',
+    '',
+    ...history,
+    'Assistant:',
+  ].join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// Call Copilot CLI — same pattern as demo-task-executor.js
+// ---------------------------------------------------------------------------
+function stripCopilotFooter(rawText) {
+  const lines = String(rawText ?? '').split(/\r?\n/);
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  if (
+    lines.length >= 3 &&
+    /^Changes\b/i.test(lines[lines.length - 3]) &&
+    /^Requests\b/i.test(lines[lines.length - 2]) &&
+    /^Tokens\b/i.test(lines[lines.length - 1])
+  ) {
+    lines.splice(lines.length - 3, 3);
+  }
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  return lines.join('\n');
+}
+
+function resolveCopilotExecutable() {
+  const envBin = process.env.COPILOT_BIN;
+  if (envBin && fs.existsSync(envBin)) return envBin;
+  if (process.platform === 'win32') {
+    try {
+      const out = execFileSync('where.exe', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const candidates = out.split(/\r?\n/).map(s => s.trim()).filter(Boolean);
+      return candidates.find(p => /\.(cmd|exe|bat)$/i.test(p)) ?? candidates[0] ?? 'copilot';
+    } catch {}
+  } else {
+    try {
+      const out = execFileSync('which', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      return out.split(/\r?\n/).map(s => s.trim()).find(Boolean) ?? 'copilot';
+    } catch {}
+  }
+  return 'copilot';
+}
+
+function runCopilotPrompt(prompt, cwd) {
+  const copilotBin = resolveCopilotExecutable();
+  const opts = {
+    input: String(prompt),
+    encoding: 'utf-8',
+    stdio: ['pipe', 'pipe', 'pipe'],
+    maxBuffer: 10 * 1024 * 1024,
+    timeout: 60000,
+    ...(cwd ? { cwd } : {}),
+  };
+  try {
+    return execFileSync(copilotBin, ['--allow-all'], opts);
+  } catch (directErr) {
+    if (process.platform === 'win32') {
+      try {
+        return execFileSync('cmd.exe', ['/d', '/c', 'copilot --allow-all'], opts);
+      } catch (cmdErr) {
+        const msg = [
+          directErr?.stderr?.trim?.(),
+          cmdErr?.stderr?.trim?.(),
+          String(cmdErr?.message ?? cmdErr),
+        ].filter(Boolean).join(' | ');
+        throw new Error(msg || 'copilot invocation failed');
+      }
+    }
+    const msg = [directErr?.stderr?.trim?.(), String(directErr?.message ?? directErr)].filter(Boolean).join(' | ');
+    throw new Error(msg || 'copilot invocation failed');
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+const history  = readConversationHistory(chatDir);
+const prompt   = buildPrompt(boardId, cardId, history);
+const cwd      = boardDir && fs.existsSync(boardDir) ? boardDir : undefined;
+
+let response = '';
 try {
-  content = fs.readFileSync(lastChatPath, 'utf-8').trim();
+  response = stripCopilotFooter(runCopilotPrompt(prompt, cwd)).trim();
 } catch (err) {
-  console.error(`[demo-chat-handler] could not read ${lastChatPath}: ${err.message}`);
-  process.exit(0);
+  const lastUser = [...history].reverse().find(l => l.startsWith('User:')) ?? '';
+  response = `Sorry, I could not reach the LLM right now. (${String(err?.message ?? err).slice(0, 120)})`;
+  console.error(`[demo-chat-handler] LLM call failed: ${err?.message ?? err}`);
 }
 
-// Derive next serial by incrementing the leading digits in lastChatFile.
-// e.g. "007_user.txt" → 7 → next = 8 → "008-assistant.txt"
+// 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 nextSerial  = serialMatch ? parseInt(serialMatch[1], 10) + 1 : 1;
+const nextName    = `${String(nextSerial).padStart(3, '0')}-assistant.txt`;
+const nextPath    = path.join(chatDir, nextName);
 
 try {
-  fs.writeFileSync(nextPath, `Echoing ${content}\n`, 'utf-8');
-  console.log(`[demo-chat-handler] boardId="${boardId}" cardId="${cardId}" wrote echo → ${nextPath}`);
+  fs.writeFileSync(nextPath, response + '\n', 'utf-8');
+  console.log(`[demo-chat-handler] boardId="${boardId}" cardId="${cardId}" → ${nextPath}`);
 } catch (err) {
   console.error(`[demo-chat-handler] write failed: ${err.message}`);
+}
+ *
+ * Protocol (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: "<abs>", boardDir: "<abs>", lastChatFile: "<filename>" }
+ *
+ * Responsibilities:
+ *   1. Read the full conversation history from chatDir (all *_user.txt / *-assistant.txt files).
+ *   2. Read the current card state from boardDir/board-graph.json (card_data, fetched_sources,
+ *      computed_values for cardId) to use as grounding context.
+ *   3. Build a system prompt that situates the LLM as an assistant for this specific card,
+ *      including the card's current data as context.
+ *   4. Send the conversation + context to the LLM (Copilot via CLI).
+ *   5. Write the response as <nextSerial>-assistant.txt to chatDir.
+ *
+ * Design principle:
+ *   The chat is always scoped to the card where the chat button is embedded.
+ *   The card's current state (card_data, computed_values, fetched_sources) is the primary
+ *   grounding context. The LLM should help the user understand, explore, or act on that card's
+ *   data — not give generic answers disconnected from the card's content.
+ *
+ *   The system prompt should encourage the LLM to:
+ *   - Reference the card's actual values when answering
+ *   - Ask clarifying questions if the user's intent is ambiguous
+ *   - Suggest next steps relevant to the card's domain
+ *   - Be concise (the chat is embedded in a card, not a full chat window)
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+
+const args = process.argv.slice(2);
+
+function getArg(name) {
+  const idx = args.indexOf(name);
+  return idx !== -1 && args[idx + 1] !== undefined ? args[idx + 1] : null;
+}
+
+const boardId  = getArg('--boardId') || '';
+const cardId   = getArg('--cardId') || '';
+const extraStr = getArg('--extraEncJson') || '';
+
+let extra = {};
+try {
+  extra = JSON.parse(Buffer.from(extraStr, 'base64').toString('utf-8'));
+} catch {
+  console.error('[demo-chat-handler] could not parse --extraEncJson');
   process.exit(0);
 }
+
+const { chatDir, boardDir, lastChatFile } = extra;
+
+if (!chatDir || !lastChatFile) {
+  console.error('[demo-chat-handler] --extraEncJson must contain chatDir and lastChatFile');
+  process.exit(0);
+}
+
+// ---------------------------------------------------------------------------
+// 1. Read full conversation history from chatDir
+// ---------------------------------------------------------------------------
+function readConversationHistory(dir) {
+  let files;
+  try {
+    files = fs.readdirSync(dir).filter(f => /^\d+[-_](user|assistant)\.txt$/i.test(f));
+    files.sort();
+  } catch {
+    return [];
+  }
+  return files.map(f => {
+    const role = /user/i.test(f) ? 'user' : 'assistant';
+    let text = '';
+    try { text = fs.readFileSync(path.join(dir, f), 'utf-8').trim(); } catch {}
+    return { role, text };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// 2. Read card state from board-graph.json
+// ---------------------------------------------------------------------------
+function readCardState(bDir, cId) {
+  if (!bDir) return null;
+  try {
+    const boardGraph = JSON.parse(fs.readFileSync(path.join(bDir, 'board-graph.json'), 'utf-8'));
+    // board-graph.json wraps a LiveGraph snapshot; cards live under graph.nodes
+    const nodes = boardGraph?.graph?.nodes ?? boardGraph?.nodes ?? {};
+    return nodes[cId] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 3. Build system prompt grounded in the card's current state
+// ---------------------------------------------------------------------------
+function buildSystemPrompt(cId, cardState) {
+  const lines = [
+    `You are a helpful assistant embedded inside a live card (id: "${cId}") on a data dashboard.`,
+    'Your role is to help the user understand, interpret, and act on the data shown in this card.',
+    'Always ground your answers in the card\'s actual current values. Be concise — this is an embedded card chat, not a full conversation window.',
+    'If the user\'s question is ambiguous, ask one short clarifying question.',
+    'Suggest relevant next steps or insights when appropriate.',
+    '',
+    '--- Current card state ---',
+  ];
+
+  if (cardState) {
+    if (cardState.card_data && Object.keys(cardState.card_data).length > 0) {
+      lines.push('card_data: ' + JSON.stringify(cardState.card_data, null, 2));
+    }
+    if (cardState.computed_values && Object.keys(cardState.computed_values).length > 0) {
+      lines.push('computed_values: ' + JSON.stringify(cardState.computed_values, null, 2));
+    }
+    if (cardState.fetched_sources && Object.keys(cardState.fetched_sources).length > 0) {
+      lines.push('fetched_sources: ' + JSON.stringify(cardState.fetched_sources, null, 2));
+    }
+  } else {
+    lines.push('(card state not available)');
+  }
+
+  lines.push('--- End card state ---');
+  return lines.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// 4. Build the full prompt (system + conversation turns)
+// ---------------------------------------------------------------------------
+function buildPrompt(systemPrompt, history) {
+  const parts = [systemPrompt, ''];
+  for (const turn of history) {
+    parts.push(`${turn.role === 'user' ? 'User' : 'Assistant'}: ${turn.text}`);
+  }
+  parts.push('Assistant:');
+  return parts.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// 5. Call LLM (Copilot CLI)
+// ---------------------------------------------------------------------------
+function resolveCopilotExecutable() {
+  const envBin = process.env.COPILOT_BIN;
+  if (envBin && fs.existsSync(envBin)) return envBin;
+
+  if (process.platform === 'win32') {
+    try {
+      const out = execFileSync('where.exe', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const candidates = out.split(/\r?\n/).map(s => s.trim()).filter(Boolean);
+      return candidates.find(p => /\.(cmd|exe|bat)$/i.test(p)) ?? candidates[0] ?? 'copilot';
+    } catch {}
+  } else {
+    try {
+      const out = execFileSync('which', ['copilot'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+      return out.split(/\r?\n/).map(s => s.trim()).find(Boolean) ?? 'copilot';
+    } catch {}
+  }
+  return 'copilot';
+}
+
+function stripCopilotFooter(rawText) {
+  const lines = String(rawText ?? '').split(/\r?\n/);
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  if (
+    lines.length >= 3 &&
+    /^Changes\b/i.test(lines[lines.length - 3]) &&
+    /^Requests\b/i.test(lines[lines.length - 2]) &&
+    /^Tokens\b/i.test(lines[lines.length - 1])
+  ) {
+    lines.splice(lines.length - 3, 3);
+  }
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
+  return lines.join('\n');
+}
+
+function runLLM(prompt) {
+  const copilotBin = resolveCopilotExecutable();
+  try {
+    const raw = execFileSync(copilotBin, ['--allow-all'], {
+      input: String(prompt),
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      maxBuffer: 10 * 1024 * 1024,
+      timeout: 60000,
+    });
+    return stripCopilotFooter(raw).trim();
+  } catch (err) {
+    if (process.platform === 'win32') {
+      try {
+        const raw = execFileSync('cmd.exe', ['/d', '/c', 'copilot --allow-all'], {
+          input: String(prompt),
+          encoding: 'utf-8',
+          stdio: ['pipe', 'pipe', 'pipe'],
+          maxBuffer: 10 * 1024 * 1024,
+          timeout: 60000,
+        });
+        return stripCopilotFooter(raw).trim();
+      } catch {}
+    }
+    throw err;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+const history     = readConversationHistory(chatDir);
+const cardState   = readCardState(boardDir, cardId);
+const systemPmt   = buildSystemPrompt(cardId, cardState);
+const fullPrompt  = buildPrompt(systemPmt, history);
+
+let response = '';
+try {
+  response = runLLM(fullPrompt);
+} catch (err) {
+  // Fallback: acknowledge the message so the user sees something
+  const lastUserMsg = [...history].reverse().find(t => t.role === 'user')?.text ?? '';
+  response = `I received your message ("${lastUserMsg.slice(0, 80)}") but could not reach the LLM right now. Please try again.`;
+  console.error(`[demo-chat-handler] LLM call failed: ${err && err.message || err}`);
+}
+
+// Derive next serial and write assistant response
+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);
+
+try {
+  fs.writeFileSync(nextPath, response + '\n', 'utf-8');
+  console.log(`[demo-chat-handler] boardId="${boardId}" cardId="${cardId}" wrote response → ${nextPath}`);
+} catch (err) {
+  console.error(`[demo-chat-handler] write failed: ${err.message}`);
+}

package/examples/example-board/demo-server-config.json

@@ -1,7 +1,5 @@
 {
   "port": 7799,
-  "boardLiveCardsCliJs": "../../dist/cli/board-live-cards-cli.js",
-  "stepMachineCliPath": "../../step-machine-cli.js",
   "taskExecutorPath": "./demo-task-executor.js",
   "chatHandlerPath": "./demo-chat-handler.js"
 }