yaml-flow 8.2.5 → 8.4.0

package/examples/board/.board-ws/cards/store/card-portfolio-value.json

@@ -1,90 +0,0 @@
-{
-  "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",
-      "ref": "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/board/.board-ws/cards/store/card-portfolio.json

@@ -1,78 +0,0 @@
-{
-  "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",
-      "ref": "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
-      },
-      {
-        "ticker": "NVDA",
-        "quantity": 5,
-        "cost_basis": 310
-      },
-      {
-        "ticker": "GOOG",
-        "quantity": 3,
-        "cost_basis": 33
-      }
-    ]
-  }
-}

package/examples/board/server/chat-flow/chat-clear-processing.js

@@ -1,41 +0,0 @@
-#!/usr/bin/env node
-
-import path from 'node:path';
-import fs from 'node:fs';
-import { createFsBoardChatStorage } from 'yaml-flow/board-live-cards-node';
-
-function readJsonStdin() {
-  try {
-    const raw = fs.readFileSync(0, 'utf-8').trim();
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === 'object' ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-const input = readJsonStdin();
-const boardSetupRoot = typeof input.boardSetupRoot === 'string' ? input.boardSetupRoot : '';
-const boardRuntimeDir = typeof input.boardRuntimeDir === 'string' ? input.boardRuntimeDir : 'runtime';
-const cardId = typeof input.cardId === 'string' ? input.cardId : '';
-
-try {
-  if (!boardSetupRoot || !cardId) {
-    process.stderr.write('chat-clear-processing requires boardSetupRoot and cardId\n');
-    process.exit(1);
-  }
-
-  const boardDir = path.join(boardSetupRoot, boardRuntimeDir || 'runtime');
-  if (!fs.existsSync(boardDir)) {
-    process.stdout.write(JSON.stringify({ cleared: true, skipped: true }));
-    process.exit(0);
-  }
-
-  const chatStorage = createFsBoardChatStorage(boardDir);
-  chatStorage.setProcessing(cardId, false);
-  process.stdout.write(JSON.stringify({ cleared: true }));
-} catch (err) {
-  process.stderr.write((err instanceof Error ? err.message : String(err)) + '\n');
-  process.exit(1);
-}

package/examples/board/server/chat-flow/chat-open-turn.js

@@ -1,144 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-
-function readJsonStdin() {
-  try {
-    const raw = fs.readFileSync(0, 'utf-8').trim();
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === 'object' ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-function parseBoolean(value, fallback = false) {
-  if (value === true || value === 1) return true;
-  if (value === false || value === 0) return false;
-  if (typeof value === 'string') {
-    const normalized = value.trim().toLowerCase();
-    if (['1', 'true', 'yes', 'on'].includes(normalized)) return true;
-    if (['0', 'false', 'no', 'off'].includes(normalized)) return false;
-  }
-  return fallback;
-}
-
-function parsePositiveInt(value, fallback = null) {
-  const n = Number(value);
-  if (!Number.isFinite(n) || n <= 0) return fallback;
-  return Math.floor(n);
-}
-
-function parseChatEnvelope(raw) {
-  // Chat payload supports either plain text or a JSON envelope.
-  // JSON fields: prompt|text|userText|query, probe, chatTimeoutMs|chatCopilotTimeoutMs, chatTimeMs.
-  if (!raw) {
-    return {
-      userText: '',
-      probe: false,
-      chatHandlerMode: 'copilot',
-      chatCopilotTimeoutMs: null,
-      chatTimeMs: null,
-    };
-  }
-
-  try {
-    const parsed = JSON.parse(raw);
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-      throw new Error('not-an-object');
-    }
-    const prompt = [parsed.prompt, parsed.text, parsed.userText, parsed.query]
-      .find((value) => typeof value === 'string' && value.trim().length > 0);
-    const probe = parseBoolean(parsed.probe, false);
-    const modeFromInput = typeof parsed.chatHandlerMode === 'string' ? parsed.chatHandlerMode.trim().toLowerCase() : '';
-    return {
-      userText: (typeof prompt === 'string' ? prompt : raw).trim(),
-      probe,
-      chatHandlerMode: modeFromInput || (probe ? 'probe' : 'copilot'),
-      chatCopilotTimeoutMs: parsePositiveInt(parsed.chatTimeoutMs ?? parsed.chatCopilotTimeoutMs, null),
-      chatTimeMs: parsePositiveInt(parsed.chatTimeMs, null),
-    };
-  } catch {
-    return {
-      userText: raw.trim(),
-      probe: false,
-      chatHandlerMode: 'copilot',
-      chatCopilotTimeoutMs: null,
-      chatTimeMs: null,
-    };
-  }
-}
-
-const extra = readJsonStdin();
-const boardId = typeof extra.boardId === 'string' ? extra.boardId : '';
-const cardId = typeof extra.cardId === 'string' ? extra.cardId : '';
-const boardSetupRoot = typeof extra.boardSetupRoot === 'string' ? extra.boardSetupRoot : '';
-const boardRuntimeDir = typeof extra.boardRuntimeDir === 'string' ? extra.boardRuntimeDir : 'runtime';
-const runtimeStatusDir = typeof extra.runtimeStatusDir === 'string' ? extra.runtimeStatusDir : 'runtime-out';
-const cardsDir = typeof extra.cardsDir === 'string' ? extra.cardsDir : 'cards';
-const projectRoot = typeof extra.projectRoot === 'string' ? extra.projectRoot : '';
-const chatFlowRoot = typeof extra.chatFlowRoot === 'string' ? extra.chatFlowRoot : '';
-const serverUrl = typeof extra.serverUrl === 'string' ? extra.serverUrl.replace(/\/$/, '') : '';
-const apiBasePath = typeof extra.apiBasePath === 'string' ? extra.apiBasePath : '/api/board';
-const lastChatEntryId = typeof extra.lastChatEntryId === 'string' ? extra.lastChatEntryId : '';
-
-if (!cardId || !serverUrl || !apiBasePath || !lastChatEntryId) {
-  process.stderr.write('chat-open-turn requires cardId, serverUrl, apiBasePath, and lastChatEntryId\n');
-  process.exit(1);
-}
-
-let messageText = '';
-try {
-  const chatsUrl = `${serverUrl}${apiBasePath}/cards/${encodeURIComponent(cardId)}/chats`;
-  const res = await fetch(chatsUrl);
-  if (!res.ok) {
-    process.stderr.write(`chat-open-turn could not fetch chat history: HTTP ${res.status}\n`);
-    process.exit(1);
-  }
-  const data = await res.json();
-  const messages = Array.isArray(data?.messages) ? data.messages : [];
-  const currentUser = messages.find((message) =>
-    typeof message?.id === 'string'
-    && message.id === lastChatEntryId
-    && message.role === 'user'
-  );
-  messageText = typeof currentUser?.text === 'string' ? currentUser.text : '';
-} catch (err) {
-  process.stderr.write(`chat-open-turn could not fetch current user turn: ${err instanceof Error ? err.message : String(err)}\n`);
-  process.exit(1);
-}
-
-if (!messageText) {
-  process.stderr.write('chat-open-turn could not resolve user text for lastChatEntryId\n');
-  process.exit(1);
-}
-
-const envelope = parseChatEnvelope(messageText);
-const userText = envelope.userText;
-const probe = envelope.probe;
-const chatHandlerMode = envelope.chatHandlerMode;
-const chatCopilotTimeoutMs = envelope.chatCopilotTimeoutMs
-  ?? (Number.isFinite(Number(extra.chatCopilotTimeoutMs)) && Number(extra.chatCopilotTimeoutMs) > 0
-    ? Math.floor(Number(extra.chatCopilotTimeoutMs))
-    : 300000);
-const chatTimeMs = envelope.chatTimeMs;
-
-process.stdout.write(JSON.stringify({
-  boardId,
-  cardId,
-  boardSetupRoot,
-  boardRuntimeDir,
-  runtimeStatusDir,
-  cardsDir,
-  projectRoot,
-  chatFlowRoot,
-  userText,
-  serverUrl,
-  apiBasePath,
-  lastChatEntryId,
-  probe,
-  chatHandlerMode,
-  chatCopilotTimeoutMs,
-  chatTimeMs,
-}));

package/examples/board/server/chat-flow/chat-write-assistant.js

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-
-function readJsonStdin() {
-  try {
-    const raw = fs.readFileSync(0, 'utf-8').trim();
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === 'object' ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-const input = readJsonStdin();
-const cardId = typeof input.cardId === 'string' ? input.cardId : '';
-const serverUrl = typeof input.serverUrl === 'string' ? input.serverUrl.replace(/\/$/, '') : '';
-const apiBasePath = typeof input.apiBasePath === 'string' ? input.apiBasePath : '/api/board';
-const replyText = typeof input.replyText === 'string' ? input.replyText : '';
-
-if (!cardId || !serverUrl) {
-  process.stderr.write('chat-write-assistant requires cardId and serverUrl\n');
-  process.exit(1);
-}
-
-try {
-  const postUrl = `${serverUrl}${apiBasePath}/cards/${encodeURIComponent(cardId)}/chats`;
-  const postRes = await fetch(postUrl, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ role: 'assistant', text: replyText, files: [], done: true }),
-  });
-  if (!postRes.ok) {
-    const err = await postRes.text();
-    process.stderr.write(`chat-write-assistant POST failed: ${err}\n`);
-    process.exit(1);
-  }
-  const postData = await postRes.json();
-  process.stdout.write(JSON.stringify({ replyId: postData?.id, replyText }));
-} catch (err) {
-  process.stderr.write((err instanceof Error ? err.message : String(err)) + '\n');
-  process.exit(1);
-}

package/examples/board/server/chat-flow/echo-probe/assistant.js

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-
-function readJsonStdin() {
-  try {
-    const raw = fs.readFileSync(0, 'utf-8').trim();
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === 'object' ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-
-const input = readJsonStdin();
-const userText = typeof input.userText === 'string' ? input.userText : '';
-const chatTimeMs = Number.isFinite(Number(input.chatTimeMs)) && Number(input.chatTimeMs) > 0
-  ? Math.min(120000, Math.floor(Number(input.chatTimeMs)))
-  : 0;
-
-if (chatTimeMs > 0) {
-  await new Promise((resolve) => setTimeout(resolve, chatTimeMs));
-}
-
-process.stdout.write(JSON.stringify({
-  replyText: `Echo: ${userText}`,
-}));