yaml-flow 4.0.0 → 5.0.0

package/schema/live-cards.schema.json

@@ -1,15 +1,13 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://nsreehari.github.io/boards/live-cards.schema.json",
-  "title": "LiveCards Node Schema",
-  "description": "Schema for Card and ExternalSource nodes in the LiveCards Board/Canvas engine",
 
   "definitions": {
 
     "bind_ref": {
-      "description": "A state path reference, e.g. 'state.raw_quotes' or 'requires.upstream'",
+      "description": "A card data path reference, e.g. 'card_data.raw_quotes' or 'requires.upstream'",
       "type": "string",
-      "pattern": "^(state|requires|computed_values)\\."
+      "pattern": "^(card_data|requires|fetched_sources|computed_values)(\\.|$)"
     },
 
     "bind_or_literal": {
@@ -46,7 +44,7 @@
           ]
         },
         "input": {
-          "description": "state.path, literal, array of inputs, or nested compute_expr",
+          "description": "card_data.path, literal, array of inputs, or nested compute_expr",
           "oneOf": [
             { "type": "string" },
             { "type": "number" },
@@ -85,19 +83,19 @@
         "required": ["bindTo", "src"],
         "properties": {
           "bindTo": { "type": "string", "description": "Token name published downstream" },
-          "src":    { "type": "string", "description": "Path to read value from (state.*, requires.*, computed_values.*)" }
+          "src":    { "type": "string", "description": "Path to read value from (card_data.*, requires.*, fetched_sources.*, computed_values.*)" }
         }
       },
-      "description": "Explicit bindings exposing computed/state values downstream as named tokens"
+      "description": "Explicit bindings exposing computed or card_data values downstream as named tokens"
     },
 
     "compute_step": {
-      "description": "A single ordered compute step: reads state.*/requires.*/computed_values.*, writes to computed_values[bindTo]",
+      "description": "A single ordered compute step: reads card_data.*/requires.*/computed_values.*, writes to computed_values[bindTo]",
       "type": "object",
       "required": ["bindTo", "expr"],
       "properties": {
         "bindTo": { "type": "string", "description": "Key in computed_values to write result" },
-        "expr":   { "type": "string", "description": "JSONata expression evaluated against { state, requires, sources, computed_values }" }
+        "expr":   { "type": "string", "description": "JSONata expression evaluated against { card_data, requires, fetched_sources, computed_values }" }
       }
     },
 
@@ -107,7 +105,7 @@
       "required": ["bindTo"],
       "additionalProperties": true,
       "properties": {
-        "bindTo":     { "type": "string",  "description": "Key under sources.* available in compute expressions" },
+        "bindTo":     { "type": "string",  "description": "Key under fetched_sources.* available in compute expressions" },
         "outputFile": { "type": "string",  "description": "Board-relative path the executor writes its JSON result to. Presence of this file signals delivery." },
         "optionalForCompletionGating":   { "type": "boolean", "default": false, "description": "When true this source does not gate card completion. Default false when absent, so sources are completion-gating by default." },
         "timeout":    { "type": "integer", "minimum": 0, "default": 120000, "description": "Executor/script timeout in ms. Default: 120 000 (2 min)." },
@@ -123,16 +121,16 @@
         "kind":      {
           "enum": ["metric", "table", "chart", "form", "filter", "list",
                    "notes", "todo", "alert", "narrative", "badge", "text",
-                   "markdown", "custom", "file-upload", "chat", "actions"]
+                   "markdown", "custom", "actions"]
         },
         "label":     { "type": "string", "description": "Heading above this element" },
         "className": { "type": "string", "description": "Bootstrap grid class, e.g. 'col-12 col-md-6'" },
-        "visible":   { "type": "string", "description": "state path — element shown only if truthy" },
+        "visible":   { "type": "string", "description": "card_data/requires/fetched_sources/computed_values path — element shown only if truthy" },
         "data": {
           "type": "object",
           "properties": {
-            "bind":        { "$ref": "#/definitions/bind_ref", "description": "state path to read data from" },
-            "writeTo":     { "$ref": "#/definitions/bind_ref", "description": "state path for user input (form, filter, todo, notes)" },
+            "bind":        { "$ref": "#/definitions/bind_ref", "description": "card_data/requires/fetched_sources/computed_values path to read data from" },
+            "writeTo":     { "$ref": "#/definitions/bind_ref", "description": "card_data path for user input (form, filter, todo, notes)" },
             "columns":     { "type": "array", "items": { "type": "string" }, "description": "table: visible columns" },
             "maxRows":     { "type": "integer", "description": "table/list: max rows to display" },
             "sortable":    { "type": "boolean", "default": true, "description": "table: enable click-to-sort" },
@@ -165,7 +163,7 @@
                   "label":    { "type": "string" },
                   "style":    { "type": "string", "description": "Bootstrap button variant, e.g. 'success', 'outline-danger'" },
                   "size":     { "type": "string", "default": "sm" },
-                  "disabled": { "oneOf": [{ "type": "boolean" }, { "type": "string", "description": "state path — truthy = disabled" }] }
+                  "disabled": { "oneOf": [{ "type": "boolean" }, { "type": "string", "description": "card_data/requires/fetched_sources/computed_values path — truthy = disabled" }] }
                 }
               }
             }
@@ -227,12 +225,39 @@
     "provides": { "$ref": "#/definitions/provides" },
     "meta":     { "$ref": "#/definitions/meta" },
     "view":     { "$ref": "#/definitions/view" },
-    "state":    { "type": "object", "additionalProperties": true,
+    "card_data": {
+      "type": "object",
+      "description": "Authored card data supplied in the card definition",
       "properties": {
-        "status":  { "enum": ["fresh", "stale", "loading", "error"] },
-        "lastRun": { "type": "string", "format": "date-time" },
-        "error":   { "type": "string" }
-      }
+        "files": {
+          "type": "array",
+          "description": "Optional uploaded-file metadata maintained by host handlers. Stored name is normalized and serial-prefixed (for example 001-my_file.pdf).",
+          "items": {
+            "type": "object",
+            "required": ["name", "stored_name"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "stored_name": {
+                "type": "string",
+                "minLength": 5,
+                "maxLength": 32,
+                "pattern": "^[0-9]{3,}-[a-z0-9._-]+$"
+              },
+              "size": {
+                "oneOf": [
+                  { "type": "integer", "minimum": 0 },
+                  { "type": "null" }
+                ]
+              },
+              "mime_type": { "type": "string" },
+              "path": { "type": "string", "pattern": "^[^\\s]+/files/[0-9]{3,}-[a-z0-9._-]+$" },
+              "uploaded_at": { "type": "string", "format": "date-time" }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": true
     },
     "sources": {
       "type": "array",
@@ -241,7 +266,7 @@
     },
     "compute": {
       "type": "array",
-      "description": "Ordered array of compute steps. Each reads state.*/requires.*/sources.*/computed_values.* and writes to ephemeral computed_values[bindTo].",
+      "description": "Ordered array of compute steps. Each reads card_data.*/requires.*/fetched_sources.*/computed_values.* and writes to ephemeral computed_values[bindTo].",
       "items": { "$ref": "#/definitions/compute_step" }
     }
   }

package/browser/ingest-board.js

@@ -1,296 +0,0 @@
-// ingest-board.js — Ingest Board: a LiveCard Board type for batch ingest UIs
-//
-// Pure component. Zero I/O (no fetch, no EventSource, no polling).
-// All side-effects delegated to host via callbacks.
-//
-// API:
-//   const ib = IngestBoard.create(containerEl, opts)
-//
-//   ib.setBatches(batches)               — rebuild board from batch array
-//   ib.getChat(boardId)                  — get chat element API for a card
-//   ib.getFileUpload(boardId)            — get file-upload element API for a card
-//   ib.getActions(boardId)               — get actions element API for a card
-//   ib.showChatModal(boardId, messages)  — open Bootstrap modal with chat history
-//   ib.destroy()
-//
-// Required opts:
-//   onSend(boardId, { text, files })     — host handles: upload files + message → call getChat().appendMessage() with results
-//   onConfirm(boardId)                   — host handles: POST confirm → SSE → update board
-//   onDiscard(boardId)                   — host handles: POST discard → call ib.setBatches()
-//
-// Optional opts:
-//   onViewChat(boardId)                  — host handles: fetch chat → call ib.showChatModal()
-//   onRefresh()                          — host handles: fetch batches → call ib.setBatches()
-//   compact         — smaller card columns (default: false)
-//   engine          — existing LiveCard engine (one is created if omitted)
-//   markdown        — markdown renderer fn
-//   sanitize        — HTML sanitizer fn
-
-// eslint-disable-next-line no-unused-vars
-var IngestBoard = (function () {
-  'use strict';
-
-  function create(containerEl, opts) {
-    opts = opts || {};
-    if (!opts.onSend)    throw new Error('IngestBoard: opts.onSend is required');
-    if (!opts.onConfirm) throw new Error('IngestBoard: opts.onConfirm is required');
-    if (!opts.onDiscard) throw new Error('IngestBoard: opts.onDiscard is required');
-
-    const compact     = opts.compact || false;
-    const onSend      = opts.onSend;
-    const onConfirm   = opts.onConfirm;
-    const onDiscard   = opts.onDiscard;
-    const onViewChat  = opts.onViewChat || null;
-    const onRefresh   = opts.onRefresh || null;
-    const mdFn        = opts.markdown || (typeof marked   !== 'undefined' ? function (t) { return marked.parse(t); } : null);
-    const sanFn       = opts.sanitize || (typeof DOMPurify !== 'undefined' ? function (h) { return DOMPurify.sanitize(h); } : null);
-
-    let board = null;
-    const nodes = {};  // id → node
-
-    // ---- Engine ----
-
-    const engine = opts.engine || LiveCard.init({
-      resolve:      function (id) { return nodes[id]; },
-      onPatch:      function () {},
-      onPatchState: function () {},
-      onRefresh:    onRefresh || function () {},
-      onAction:     handleAction,
-      markdown:     mdFn,
-      sanitize:     sanFn,
-    });
-
-    // ---- Action dispatcher (pure — delegates to host callbacks) ----
-
-    function handleAction(nodeId, actionType, payload) {
-      if (actionType === 'chat-send') {
-        // For the "new" card, boardId is null until host creates one
-        var boardId = nodeId === '__new__' ? null : nodeId;
-        onSend(boardId, { text: payload.text, files: payload.files });
-      } else if (actionType === 'action') {
-        if (payload.buttonId === 'confirm') onConfirm(nodeId);
-        else if (payload.buttonId === 'discard') onDiscard(nodeId);
-        else if (payload.buttonId === 'view-chat' && onViewChat) onViewChat(nodeId);
-      }
-    }
-
-    // ---- Node builders ----
-
-    function buildActiveNode(batch) {
-      return {
-        id: batch.id,
-        type: 'card',
-        meta: { title: batch.id, tags: [batch.status === 'open-items' ? 'open-items' : 'ready'] },
-        state: {
-          status: batch.processing ? 'loading' : 'fresh',
-          messages: batch.chat || [],
-          files: batch.files || [],
-          batchStatus: batch.status,
-        },
-        view: {
-          elements: [
-            {
-              id: 'chat',
-              kind: 'chat',
-              data: { bind: 'state.messages', fileAttach: true, placeholder: 'Add files or type a message...' }
-            },
-            {
-              id: 'actions',
-              kind: 'actions',
-              data: {
-                buttons: [
-                  { id: 'confirm', label: 'Confirm & Merge', style: 'success', disabled: batch.status !== 'ready' || !!batch.processing },
-                  { id: 'discard', label: 'Discard', style: 'outline-danger' }
-                ]
-              }
-            }
-          ],
-          layout: { board: { col: compact ? 6 : 8, order: 0 } },
-          features: { refresh: false }
-        }
-      };
-    }
-
-    function buildCompletedNode(batch, order) {
-      var elements = [];
-
-      if (batch.files && batch.files.length) {
-        elements.push({
-          id: 'files',
-          kind: 'file-upload',
-          data: { bind: 'state.files', upload: false }
-        });
-      }
-
-      if (batch.summary) {
-        elements.push({
-          id: 'summary',
-          kind: 'text',
-          data: { bind: 'state.summary', style: 'muted' }
-        });
-      }
-
-      if (batch.chatCount > 0 && onViewChat) {
-        elements.push({
-          id: 'card-actions',
-          kind: 'actions',
-          data: { buttons: [{ id: 'view-chat', label: '\uD83D\uDCAC ' + batch.chatCount + ' message(s)', style: 'outline-secondary' }] }
-        });
-      }
-
-      return {
-        id: batch.id,
-        type: 'card',
-        meta: { title: batch.id, tags: ['confirmed'] },
-        state: {
-          status: 'fresh',
-          files: batch.files || [],
-          summary: batch.summary || '',
-        },
-        view: {
-          elements: elements,
-          layout: { board: { col: compact ? 6 : 4, order: order } },
-          features: { refresh: false }
-        }
-      };
-    }
-
-    function buildNewNode() {
-      return {
-        id: '__new__',
-        type: 'card',
-        meta: { title: 'New Batch', tags: ['new'] },
-        state: { status: 'fresh', messages: [] },
-        view: {
-          elements: [
-            {
-              id: 'chat',
-              kind: 'chat',
-              data: { bind: 'state.messages', fileAttach: true, placeholder: 'Add files or type a message...' }
-            }
-          ],
-          layout: { board: { col: compact ? 6 : 8, order: -1 } },
-          features: { refresh: false }
-        }
-      };
-    }
-
-    // ---- setBatches — rebuild the board from data ----
-
-    function setBatches(batches) {
-      Object.keys(nodes).forEach(function (k) { delete nodes[k]; });
-
-      var hasActive = batches.some(function (b) { return b.status === 'ready' || b.status === 'open-items'; });
-      var allNodes = [];
-
-      if (!hasActive) {
-        var nn = buildNewNode();
-        nodes.__new__ = nn;
-        allNodes.push(nn);
-      }
-
-      var order = 1;
-      batches.forEach(function (b) {
-        var isActive = b.status === 'ready' || b.status === 'open-items';
-        var n = isActive ? buildActiveNode(b) : buildCompletedNode(b, order++);
-        nodes[b.id] = n;
-        allNodes.push(n);
-      });
-
-      if (board) board.destroy();
-      board = LiveCard.Board(engine, containerEl, {
-        nodes: allNodes,
-        mode: 'board',
-        showNotes: false,
-        showChat: false,
-      });
-    }
-
-    // ---- Element accessors (host uses these to push data in) ----
-
-    function getChat(boardId) {
-      var el = engine.getElement(boardId, 'chat');
-      return el && el._chat || null;
-    }
-
-    function getFileUpload(boardId) {
-      var el = engine.getElement(boardId, 'files');
-      return el && el._fileUpload || null;
-    }
-
-    function getActions(boardId) {
-      var el = engine.getElement(boardId, 'actions') || engine.getElement(boardId, 'card-actions');
-      return el && el._actions || null;
-    }
-
-    // ---- Chat modal (pure — caller passes messages) ----
-
-    function showChatModal(boardId, messages) {
-      var existing = document.getElementById('lc-chat-modal');
-      if (existing) existing.remove();
-      var bd = document.querySelector('.modal-backdrop');
-      if (bd) bd.remove();
-
-      var _e = function (t) { var d = document.createElement('div'); d.textContent = t; return d.innerHTML; };
-
-      var wrap = document.createElement('div');
-      wrap.innerHTML =
-        '<div class="modal fade" id="lc-chat-modal" tabindex="-1">' +
-          '<div class="modal-dialog modal-dialog-scrollable">' +
-            '<div class="modal-content">' +
-              '<div class="modal-header">' +
-                '<h6 class="modal-title">' + _e(boardId) + '</h6>' +
-                '<button type="button" class="btn-close" data-bs-dismiss="modal"></button>' +
-              '</div>' +
-              '<div class="modal-body"><div class="lc-chat-body" id="lc-chat-modal-body" style="max-height:none"></div></div>' +
-            '</div>' +
-          '</div>' +
-        '</div>';
-      document.body.appendChild(wrap.firstElementChild);
-
-      var bodyEl = document.getElementById('lc-chat-modal-body');
-      messages.forEach(function (msg) {
-        var bub = document.createElement('div');
-        var rc = msg.role === 'user' ? 'lc-chat-bubble-user'
-          : msg.role === 'assistant' ? 'lc-chat-bubble-assistant'
-          : 'lc-chat-bubble-system';
-        bub.className = 'lc-chat-bubble ' + rc;
-        if (msg.role === 'assistant' && mdFn) {
-          var html = mdFn(msg.text);
-          if (sanFn) html = sanFn(html);
-          bub.innerHTML = html;
-        } else {
-          bub.textContent = msg.text;
-        }
-        bodyEl.appendChild(bub);
-      });
-
-      var modal = new bootstrap.Modal(document.getElementById('lc-chat-modal'));
-      modal.show();
-      document.getElementById('lc-chat-modal').addEventListener('hidden.bs.modal', function () {
-        document.getElementById('lc-chat-modal').remove();
-      });
-    }
-
-    // ---- Lifecycle ----
-
-    function destroy() {
-      if (board) board.destroy();
-      board = null;
-      Object.keys(nodes).forEach(function (k) { delete nodes[k]; });
-    }
-
-    return {
-      setBatches:    setBatches,
-      getChat:       getChat,
-      getFileUpload: getFileUpload,
-      getActions:    getActions,
-      showChatModal: showChatModal,
-      destroy:       destroy,
-      get engine()   { return engine; },
-      get board()    { return board; },
-    };
-  }
-
-  return { create: create };
-})();