yaml-flow 8.7.1 → 8.8.5

package/lib/{types-Ba8H5_Wo.d.cts → types-CPnYv7RC.d.cts}

@@ -1,10 +1,55 @@
-import { a as ArtifactsStore } from './artifacts-store-lib-D9nMkVcE.cjs';
-import { e as BoardPlatformAdapter, g as BoardLiveCardsNonCorePublic, d as BoardNonCorePlatformAdapter, c as BoardLiveCardsPublic, a as CommandResult, f as BoardWorkerRequest } from './board-live-cards-public-LlVUQPL2.cjs';
-import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-BfHmHdx2.cjs';
-import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-Di9QB141.cjs';
+import { l as BoardLiveCardsNonCorePublic, e as BoardPlatformAdapter, d as BoardNonCorePlatformAdapter, c as BoardLiveCardsPublic, a as CommandResult } from './board-live-cards-public-BT5HrgqZ.cjs';
 import { ExecutionRef } from './execution-refs.cjs';
-import { a as KindValueRef } from './storage-interface-BFiD3kyB.cjs';
-import { C as ChatStorage } from './chat-storage-lib-B9Q34Dyv.cjs';
+import { f as QueueStorage, a as KindValueRef } from './storage-interface-D-iEiTJA.cjs';
+import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-BZIftm36.cjs';
+import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-CYjr4mgX.cjs';
+
+interface BoardWorkerRequest {
+    boardId?: string;
+    ref: ExecutionRef;
+    args: Record<string, unknown>;
+}
+interface BoardWorkerQueuedRequest {
+    messageId: string;
+    enqueuedAt: string;
+    attempt: number;
+    request: BoardWorkerRequest;
+}
+interface BoardWorkerLeasedRequest extends BoardWorkerQueuedRequest {
+    leaseToken: string;
+    leaseExpiresAt: string;
+}
+interface BoardWorkerDeadLetterRequest extends BoardWorkerQueuedRequest {
+    reason?: string;
+}
+interface BoardWorkerStore {
+    enqueueRequest(request: BoardWorkerRequest): string;
+    enqueueRequestIfAbsent?(request: BoardWorkerRequest, dedupKey: string): string | null;
+    leaseRequests(opts?: {
+        max?: number;
+        visibilityMs?: number;
+    }): BoardWorkerLeasedRequest[];
+    ackRequest(messageId: string, leaseToken: string): boolean;
+    nackRequest(messageId: string, leaseToken: string, opts?: {
+        dead?: boolean;
+        reason?: string;
+    }): boolean;
+    peekActive(): BoardWorkerQueuedRequest[];
+    peekDeadLetter(): BoardWorkerDeadLetterRequest[];
+}
+declare function createBoardWorkerStore(queue: QueueStorage): BoardWorkerStore;
+
+/**
+ * server-runtime/types.ts
+ *
+ * Platform-free adapter interfaces for the board server runtime.
+ *
+ * The runtime (index.ts) imports ONLY this file and board-live-cards-public
+ * for its dependencies — no node:fs, node:net, node:child_process, etc.
+ *
+ * Hosts (demo-server, Azure Function, Firebase Function) provide implementations
+ * of these interfaces when constructing the runtime.
+ */
 
 type BoardRuntimeNonCorePublic = Pick<BoardLiveCardsNonCorePublic, 'describeTaskExecutorCapabilities' | 'validateCardPreflight' | 'evalCardCompute' | 'probeSourcePreflight' | 'runSourcePreflight' | 'simulateCardCycle'>;
 type Awaitable<T> = T | Promise<T>;
@@ -83,26 +128,20 @@ interface BoardContextConfig {
     boardAdapter: BoardRuntimePlatformAdapter;
     nonCore?: BoardRuntimeNonCorePublic;
     nonCoreAdapter?: BoardNonCorePlatformAdapter;
-    /** Optional separate adapter for file/chat blob storage (defaults to boardAdapter) */
-    artifactsAdapter?: BoardRuntimePlatformAdapter;
-    /** Optional explicit blob root ref for persisted card/file attachments. */
-    artifactsStoreRef?: string;
-    /**
-     * Optional caller-supplied file artifacts store. When provided, this is used
-     * verbatim and the runtime does NOT consult artifactsAdapter.blobStorage('files').
-     * Use this to give the embedder full control over the on-disk layout (e.g.
-     * via createFsBoardFileArtifactsStore(baseDir, { filesSubdir: '' })).
-     */
-    filesArtifactsStore?: ArtifactsStore;
+    boardRuntimeStoreRef: string;
+    /** Explicit ref for externally backed runtime storage (journal + internal queue lanes). */
+    queueStoreRef: string;
+    /** Explicit blob root ref for persisted card/file attachments. */
+    artifactsStoreRef: string;
+    /** Explicit ref for fetched source payloads. */
+    fetchedSourcesStoreRef: string;
     baseRef: KindValueRef;
     cardStoreRef: string;
     outputsStoreRef: string;
-    /** Optional ref pointing persisted card chat storage at a different backend. */
-    chatStoreRef?: string;
-    /** Optional ref pointing scratch storage at a different backend than the board runtime. */
-    scratchStoreRef?: string;
-    /** Optional ref pointing archive storage at a different backend than the board runtime. */
-    archiveStoreRef?: string;
+    /** Explicit ref pointing persisted card chat storage at a different backend. */
+    chatStoreRef: string;
+    /** Explicit ref pointing scratch storage at a different backend than the board runtime. */
+    scratchStoreRef: string;
     /** Notification endpoint ref — e.g. ::named-pipe::<path> or ::firestore-watch::<path> */
     notifyRef?: KindValueRef;
     taskExecutorRef?: ExecutionRef;
@@ -119,8 +158,6 @@ interface SingleBoardRuntimeOptions {
     boards: BoardContextConfig[];
     invocationAdapter: InvocationAdapter;
     chatFlowRunner?: ChatHandlerFlowRunner;
-    /** Chat storage backend. Defaults to an in-memory store when omitted. */
-    chatStorage?: ChatStorage;
     notificationTransport?: NotificationTransport;
     logger?: RuntimeLogger;
     serverUrl?: string;
@@ -158,10 +195,8 @@ interface SingleBoardRuntime {
     readonly queueLaneTuning: HostedBoardQueueLaneTuning;
     handleRuntimeApi(req: RuntimeRequest, res: RuntimeResponse, parsedUrl: URL): Promise<boolean>;
     buildPublishedRuntimePayload(): Awaitable<unknown>;
-    processAccumulatedEvents(): Awaitable<CommandResult>;
-    processAccumulatedLane(): Awaitable<CommandResult>;
     handleChatAgentRequest(request: BoardWorkerRequest): Awaitable<void>;
-    clearChatRecords(cardId: string): void;
+    clearChatRecords(cardId: string): Awaitable<void>;
     /** Report that a source fetch completed. Token is the source callback token; ref is the blob ref (b64:<base64url(json)>). */
     reportSourceFetched(token: string, ref: string): Awaitable<CommandResult>;
     /** Report that a source fetch failed. Token is the source callback token. */
@@ -211,4 +246,4 @@ interface RuntimeResponse {
     end(data?: string | Buffer): void;
 }
 
-export type { Awaitable as A, BoardContextConfig as B, ChatHandlerFlowRunner as C, DescribeEnvelope as D, HostedBoardQueueLaneTuning as H, InvocationAdapter as I, MultiBoardRuntimeOptions as M, NotificationTransport as N, QueueLaneRuntimeTuning as Q, RuntimeLogger as R, SingleBoardRuntimeOptions as S, MultiBoardRuntime as a, SingleBoardRuntime as b, BoardRuntimeNonCorePublic as c, BoardRuntimePlatformAdapter as d, BoardRuntimePublic as e, RuntimeRequest as f, RuntimeResponse as g };
+export { type Awaitable as A, type BoardContextConfig as B, type ChatHandlerFlowRunner as C, type DescribeEnvelope as D, type HostedBoardQueueLaneTuning as H, type InvocationAdapter as I, type MultiBoardRuntimeOptions as M, type NotificationTransport as N, type QueueLaneRuntimeTuning as Q, type RuntimeLogger as R, type SingleBoardRuntimeOptions as S, type MultiBoardRuntime as a, type SingleBoardRuntime as b, type BoardRuntimeNonCorePublic as c, type BoardRuntimePlatformAdapter as d, type BoardRuntimePublic as e, type BoardWorkerRequest as f, type RuntimeRequest as g, type RuntimeResponse as h, type BoardWorkerStore as i, type BoardWorkerDeadLetterRequest as j, type BoardWorkerLeasedRequest as k, type BoardWorkerQueuedRequest as l, createBoardWorkerStore as m };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "8.7.1",
+  "version": "8.8.5",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
@@ -136,16 +136,15 @@
     "!examples/**/cards/**/files/**"
   ],
   "scripts": {
-    "build": "npm run -s build:lib && npm run -s build:cli && npm run -s build:cli-bundled && npm run -s build:public-examples",
+    "build": "npm run -s build:lib",
     "build:lib": "tsup --config tsup.config.ts",
     "build:cli": "tsup --config tsup.cli.config.ts",
     "build:cli-bundled": "node scripts/build-cli-bundled.mjs",
-    "build:public-examples": "node scripts/generate-public-examples.mjs",
     "build:browser": "tsup --config tsup.browser.config.ts && node scripts/generate-browser-integrity.mjs",
     "check:bundle-budget": "node scripts/check-bundle-budgets.mjs",
     "check:browser-bundle": "node scripts/check-browser-bundle-safety.mjs",
     "check:minified": "node scripts/check-minified.mjs",
-    "release:gate": "npm run -s build && npm run -s build:browser && npm run -s test:run && npm run -s test:e2e && npm run -s check:bundle-budget && npm run -s check:browser-bundle && npm run -s check:minified",
+    "release:gate": "npm run -s build && npm run -s build:cli && npm run -s build:browser && npm run -s test:run && npm run -s test:e2e && npm run -s check:bundle-budget && npm run -s check:browser-bundle && npm run -s check:minified",
     "standalone": "echo standalone is canonical; no assembly step required",
     "pycli:install": "python -m pip install -r py-standalone/requirements.txt",
     "pycli:install:venv": "c:/Users/sreenaga/ADO/ai-tool-evolver/.venv/Scripts/python.exe -m pip install -r py-standalone/requirements.txt",
@@ -161,7 +160,7 @@
     "validate:cards": "tsx scripts/validate-live-cards.ts",
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm run build:browser && npm run build:public-examples && npm run check:bundle-budget && npm run check:browser-bundle && npm run check:minified"
+    "prepublishOnly": "npm run build && npm run build:cli && npm run build:browser && npm run check:bundle-budget && npm run check:browser-bundle && npm run check:minified"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",

package/browser/board-livecards-client.js

@@ -1,2 +0,0 @@
-var BoardLiveCardsClient=(function(exports){'use strict';function W(t){return t==="running"||t==="in-progress"?"loading":t==="failed"?"error":"fresh"}function pt(t,e){let r=e&&typeof e=="object"&&!Array.isArray(e)?e:{};return {schema_version:r.schema_version||"v1",card_id:typeof r.card_id=="string"?r.card_id:t,card_data:r.card_data&&typeof r.card_data=="object"&&!Array.isArray(r.card_data)?structuredClone(r.card_data):{},computed_values:r.computed_values&&typeof r.computed_values=="object"&&!Array.isArray(r.computed_values)?structuredClone(r.computed_values):{}}}function E(t,e){if(!t||typeof t!="object")throw new Error("payload must be an object");if(!e)throw new Error("cardId is required");let m=(Array.isArray(t.cardDefinitions)?t.cardDefinitions:[]).find(C=>C.id===e);if(!m)throw new Error(`cardDefinitions has no entry with id ${e}`);let n=t.statusSnapshot&&typeof t.statusSnapshot=="object"?t.statusSnapshot:{},o=t.cardRuntimeById&&typeof t.cardRuntimeById=="object"?t.cardRuntimeById:{},y=t.dataObjectsByToken&&typeof t.dataObjectsByToken=="object"?t.dataObjectsByToken:{},u=(Array.isArray(n.cards)?n.cards:[]).find(C=>C.name===e),l=structuredClone(m),i=pt(e,o[e]),s={...l.card_data&&typeof l.card_data=="object"&&!Array.isArray(l.card_data)?l.card_data:{},...i.card_data||{},status:W(u?.status),lastRun:u?.runtime?.last_transition_at??null};u?.error?.message&&(s.error=u.error.message);let g=u?{task_status:u.status??null,card_status:W(u.status),runtime:structuredClone(u.runtime??{}),error:u.error?structuredClone(u.error):null,blocked_by:Array.isArray(u.blocked_by)?structuredClone(u.blocked_by):[],requires_missing:Array.isArray(u.requires_missing)?structuredClone(u.requires_missing):[]}:{task_status:null,card_status:s.status??"fresh",runtime:{last_transition_at:s.lastRun??null},error:s.error?{message:s.error}:null,blocked_by:[],requires_missing:[]},k=Array.isArray(l.requires)?l.requires:[],c={};for(let[C,x]of Object.entries(y))c[C]=structuredClone(x);for(let C of k)Object.prototype.hasOwnProperty.call(c,C)||(c[C]=null);let d=(t.cardChatsByCardId&&typeof t.cardChatsByCardId=="object"?t.cardChatsByCardId:{})[e],S=d?{messages:Array.isArray(d.messages)?d.messages:[],receiving:!!d.receiving,processing:!!d.processing}:null;return {id:e,card:l,card_data:s,requires:c,computed_values:i.computed_values,runtime_state:g,card_chats:S}}function U(t){if(!t||typeof t!="object")throw new Error("payload must be an object");return (Array.isArray(t.cardDefinitions)?t.cardDefinitions:[]).map(r=>E(t,r.id))}function G(t){return JSON.parse(JSON.stringify(t))}function B(t,e){if(t===e)return t;try{if(JSON.stringify(t)===JSON.stringify(e))return t}catch{}return e}function _(t,e){if(t===e)return  true;try{return JSON.stringify(t)===JSON.stringify(e)}catch{return  false}}function gt(t){return t==="running"||t==="in-progress"?"loading":t==="failed"?"error":"fresh"}function q(t,e,r){let m=t,o=(m&&Array.isArray(m.cardDefinitions)?m.cardDefinitions:[]).map(u=>u.id),y=e&&e.modelsById||{},h={};for(let u of o){let l=r(t,u),i=y[u];if(!i){h[u]=l;continue}let p=l.card_chats!=null?B(i.card_chats,l.card_chats??null):i.card_chats??null,s={id:l.id,card:B(i.card,l.card),card_data:B(i.card_data,l.card_data),requires:B(i.requires,l.requires),computed_values:B(i.computed_values,l.computed_values),runtime_state:B(i.runtime_state,l.runtime_state),card_chats:p};h[u]=s.card===i.card&&s.card_data===i.card_data&&s.requires===i.requires&&s.computed_values===i.computed_values&&s.runtime_state===i.runtime_state&&s.card_chats===i.card_chats?i:s;}return {payload:t,cardIds:o,modelsById:h}}function H(t,e={}){if(!t)return t;let r=typeof e.includeCard=="function"?e.includeCard:(()=>true),m=typeof e.mapCard=="function"?e.mapCard:(u=>u),n=false,o=[],y={};for(let u of t.cardIds){let l=t.modelsById[u];if(!l){n=true;continue}if(!r(l,t)){n=true;continue}let i=m(l,t);if(!i||i.id!==u)throw new Error(`deriveBoardState: mapped card must preserve id "${u}"`);i!==l&&(n=true),o.push(u),y[u]=i;}let h=typeof e.mapPayload=="function"?e.mapPayload(t.payload,{sourceState:t,cardIds:o,modelsById:y}):t.payload;return h!==t.payload&&(n=true),!n&&o.length===t.cardIds.length?t:{payload:h,cardIds:o,modelsById:y}}function J(t,e,r,m){if(!t||!Array.isArray(e)||e.length===0)return t;let n=t.modelsById,o=t.cardIds,y=false,h=false,u={};for(let i of o){let p=n[i],s=p&&p.requires;if(s&&typeof s=="object")for(let g of Object.keys(s))(u[g]=u[g]||[]).push(i);}function l(){y||(n={...n},y=true);}for(let i of e)if(!(!i||!i.kind)){if(i.kind==="computed_values"){let p=i.cardId,s=n[p];if(!s)continue;let g=i.values||{};if(_(s.computed_values,g))continue;l(),n[p]={...s,computed_values:g},h=true;}else if(i.kind==="data_object"){let p=i.key,s=i.payload,g=u[p]||[];for(let k of g){let c=n[k];if(!c)continue;let w=c.requires||{};_(w[p],s)||(l(),n[k]={...c,requires:{...w,[p]:s}},h=true);}}else if(i.kind==="card_refreshed"){let p=i.cardId,s=null,g=n[p],k=i.card;if(g&&k&&typeof k=="object"&&!Array.isArray(k)){let c=k,w=c.card_data&&typeof c.card_data=="object"&&!Array.isArray(c.card_data)?c.card_data:g.card_data,d=c.requires&&typeof c.requires=="object"&&!Array.isArray(c.requires)?c.requires:g.requires,S=c.computed_values&&typeof c.computed_values=="object"&&!Array.isArray(c.computed_values)?c.computed_values:g.computed_values,C=c.runtime_state&&typeof c.runtime_state=="object"&&!Array.isArray(c.runtime_state)?c.runtime_state:g.runtime_state;s={...g,card:k,card_data:w,requires:d,computed_values:S,runtime_state:C};}if(!s)try{let c=m();c&&(s=r(c,p));}catch{}if(!s||g&&_(g.card,s.card)&&_(g.card_data,s.card_data)&&_(g.requires,s.requires)&&_(g.computed_values,s.computed_values)&&_(g.runtime_state,s.runtime_state))continue;l(),n[p]=s,o.includes(p)||(o=[...o,p]),h=true;}else if(i.kind==="card_removed"){let p=i.cardId;if(!n[p])continue;l(),delete n[p],o=o.filter(s=>s!==p),h=true;}else if(i.kind==="card_chats"){let p=i.cardId,s=n[p];if(!s)continue;let g=Array.isArray(i.messages)?i.messages:s.card_chats?.messages??[],k=typeof i.receiving=="boolean"?i.receiving:s.card_chats?.receiving??false,c=typeof i.processing=="boolean"?i.processing:s.card_chats?.processing??false,w={messages:g,receiving:k,processing:c};if(_(s.card_chats,w))continue;l(),n[p]={...s,card_chats:w},h=true;}else if(i.kind==="chat_messages"){let p=i.cardId,s=n[p];if(!s)continue;let g=Array.isArray(i.messages)?i.messages:[],k=s.card_chats||{receiving:false,processing:false},c={messages:g,receiving:k.receiving,processing:!!k.processing};if(_(s.card_chats,c))continue;l(),n[p]={...s,card_chats:c},h=true;}else if(i.kind==="status"){let p=i.status?.cards??[];for(let s of p){let g=s?.name;if(!g||!n[g])continue;let k=n[g],c=gt(s.status),w={...k.card_data||{},status:c,lastRun:s.runtime?.last_transition_at??null,...s.error?.message?{error:s.error.message}:{}};s.error?.message||delete w.error;let d={task_status:s.status??null,card_status:c,runtime:s.runtime?G(s.runtime):{},error:s.error?G(s.error):null,blocked_by:Array.isArray(s.blocked_by)?G(s.blocked_by):[],requires_missing:Array.isArray(s.requires_missing)?G(s.requires_missing):[]};_(k.card_data,w)&&_(k.runtime_state,d)||(l(),n[g]={...k,card_data:w,runtime_state:d},h=true);}}}return h?{payload:t.payload,cardIds:o,modelsById:n}:t}function Ie(t,e="/api/boards"){let r=e.replace(/\/$/,""),m=encodeURIComponent(t||"default"),n=`${r}/${m}`;return {initBoard:`${n}/init-board`,stream:`${n}/sse`,patchCard:o=>`${n}/cards/${encodeURIComponent(o)}`,retriggerCard:o=>`${n}/cards/${encodeURIComponent(o)}/retrigger`,cardAction:o=>`${n}/cards/${encodeURIComponent(o)}/actions`,cardFile:o=>`${n}/cards/${encodeURIComponent(o)}/files`,cardChats:o=>`${n}/cards/${encodeURIComponent(o)}/chats`,chatSubscribeSse:o=>`${n}/cards/${encodeURIComponent(o)}/chats/subscribe-sse`,chatUnsubscribeSse:o=>`${n}/cards/${encodeURIComponent(o)}/chats/unsubscribe-sse`}}function Be(t="/api/board"){let e=t.replace(/\/$/,"");return {initBoard:`${e}/init-board`,stream:`${e}/sse`,patchCard:r=>`${e}/cards/${encodeURIComponent(r)}`,retriggerCard:r=>`${e}/cards/${encodeURIComponent(r)}/retrigger`,cardAction:r=>`${e}/cards/${encodeURIComponent(r)}/actions`,cardFile:r=>`${e}/cards/${encodeURIComponent(r)}/files`,cardChats:r=>`${e}/cards/${encodeURIComponent(r)}/chats`,chatSubscribeSse:r=>`${e}/cards/${encodeURIComponent(r)}/chats/subscribe-sse`,chatUnsubscribeSse:r=>`${e}/cards/${encodeURIComponent(r)}/chats/unsubscribe-sse`}}function ht(t){let e=t.getServerOrigin();if(!e||!t.boardId)return null;let r=t.boardPaths(t.boardId);return `${e}${r.initBoard.replace(/\/init-board$/,"")}`}async function Z(t){if(!t.file)return null;let e=t.boardPaths(t.boardId),r=typeof t.turnId=="string"&&t.turnId!=="",m=t.inChat?`${e.cardFile(t.cardId)}?inChat=true${r?`&turn-id=${encodeURIComponent(t.turnId)}`:""}`:e.cardFile(t.cardId),n=typeof t.file.name=="string"?t.file.name:"upload.bin",o=t.file.type||"application/octet-stream",y=await t.fetchServer(m,{method:"POST",headers:{"content-type":o,"x-file-name":encodeURIComponent(n)},body:t.file});if(!y.ok){let u=await y.text();throw new Error(`Upload failed for ${t.cardId} (${y.status})${u?": "+u:""}`)}return (await y.json())?.file??null}async function mt(t){let{actionType:e}=t;if(e!=="chat-send"&&e!=="file-upload")return t.payload||{};let r={...t.payload||{}},m=typeof r["turn-id"]=="string"?String(r["turn-id"]):typeof r.turnId=="string"?String(r.turnId):typeof r.turn=="string"?String(r.turn):"",n=Array.isArray(r.files)?r.files:[];if(!n.length)return r.files=[],r;let o=[];for(let y of n){let h=await Z({...t,file:y,inChat:e==="chat-send",turnId:e==="chat-send"?m:void 0});h&&o.push(h);}return r.files=e==="chat-send"?[]:o,r}async function yt(t){let e=t.boardPaths(t.boardId),r=await t.fetchServer(e.patchCard(t.cardId),{method:"PATCH",headers:{"content-type":"application/json"},body:JSON.stringify(t.patch||{})});if(!r.ok)throw new Error(`PATCH failed for ${t.cardId} (${r.status})`)}async function kt(t){let e=t.boardPaths(t.boardId),r=await t.fetchServer(e.retriggerCard(t.cardId),{method:"POST"});if(!r.ok)throw new Error(`retrigger failed for ${t.cardId} (${r.status})`)}async function St(t){let e=t.boardPaths(t.boardId),r=await mt(t),m=await t.fetchServer(e.cardAction(t.cardId),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({actionType:t.actionType,payload:r})});if(!m.ok)throw new Error(`${t.actionType==="refresh"?"Refresh":"Action"} failed for ${t.cardId} (${m.status})`);return {payload:r}}function Oe(t,e=null){return q(t,e,E)}function Pe(t,e,r){return J(t,e,E,r)}function De(t,e){let r=new Set(e.map(String)),m=t.cardIds.filter(o=>r.has(o)),n={};for(let o of m)n[o]=t.modelsById[o];return {payload:t.payload,cardIds:m,modelsById:n}}function je(t,e){let r=e instanceof Set?e:new Set(e.map(String)),m=t.cardIds.filter(o=>!r.has(o)),n={};for(let o of m)n[o]=t.modelsById[o];return {payload:t.payload,cardIds:m,modelsById:n}}function vt(t){let e=t?.core,r=t?.engine??e?.engine;r&&typeof r.onServerSseEvent=="function"?r.onServerSseEvent():r&&typeof r.refreshOpenChatModal=="function"&&r.refreshOpenChatModal();}function bt(){let t=globalThis.LiveCard;if(!t)throw new Error("LiveCard global not loaded \u2014 include live-cards.js before this script");return t}function Ct(t){if(!t||typeof t!="object")throw new Error("options are required");let{fetchServer:e,boardPaths:r,getServerOrigin:m}=t;if(typeof e!="function")throw new Error("options.fetchServer is required");if(typeof r!="function")throw new Error("options.boardPaths is required");if(typeof m!="function")throw new Error("options.getServerOrigin is required");let n={current:null},o=new Set,y=null,h=null,u=null,l={},i={},p=globalThis.crypto&&typeof globalThis.crypto.randomUUID=="function"?globalThis.crypto.randomUUID():`lc-${Date.now()}-${Math.random().toString(36).slice(2)}`;function s(){for(let a of o)a(n.current);}function g(){return n.current?n.current.payload:null}function k(a){return n.current=a,s(),n.current}function c(){let a=h;if(!a)throw new Error("Board runtime session is not bound to a board yet");let f=u??r(a);return u=f,{boardId:a,paths:f}}function w(a){let f=q(a,n.current,E);return k(f),f}function d(a,f){let v=q(a,f??n.current,E);return k(v),v}function S(a){return k(a)}function C(a){if(!n.current)return n.current;let f=J(n.current,a,E,g);return k(f),f}async function x(a,f,v){let{boardId:R}=c();return Z({fetchServer:e,boardPaths:r,boardId:R,cardId:a,file:f,inChat:v?.inChat,turnId:v?.turnId})}async function M(a,f,v){let{boardId:R}=c();return f==="chat-send"&&await A(a),St({fetchServer:e,boardPaths:r,boardId:R,cardId:a,actionType:f,payload:v})}function b(a,f){return i[a]=f,f.finally(()=>{i[a]===f&&delete i[a];})}async function A(a){let f=i[a];if(f){await f;return}l[a]||await K(a);}async function $(a,f){let{boardId:v}=c();await yt({fetchServer:e,boardPaths:r,boardId:v,cardId:a,patch:f});}async function tt(a){let{boardId:f}=c();await kt({fetchServer:e,boardPaths:r,boardId:f,cardId:a});}async function K(a){let{paths:f}=c(),v=i[a];if(v){await v;return}if(l[a])return;l[a]=true;let R=(async()=>{await e(f.chatSubscribeSse(a),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({clientId:p})});})().catch(()=>{delete l[a];});await b(a,R);}async function et(a){let{paths:f}=c(),v=i[a];if(v)try{await v;}catch{}delete l[a];try{await e(f.chatUnsubscribeSse(a),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({clientId:p})});}catch{}}function rt(a){Object.keys(l).forEach(f=>{e(a.chatSubscribeSse(f),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({clientId:p})}).catch(()=>{});});}function V(a){let f=a;f?.kind==="notification-batch"&&Array.isArray(f.notifications)?C(f.notifications):f?.cardDefinitions&&w(f);}function nt(a){return h=String(a.boardId||"default"),u=r(h),a.state!==void 0?S(a.state??null):a.payload?d(a.payload,n.current):n.current}function st(a){return V(a),n.current}function F(){y&&(y.close(),y=null);}async function at(a={}){let f=String(a.boardId||h||"default");h=f;let v=r(f);if(u=v,a.initialState!==void 0?S(a.initialState??null):a.initialPayload!==void 0&&d(a.initialPayload,n.current),a.skipInitBoard!==true){let O=typeof a.taskExecutorPath=="string"?a.taskExecutorPath.trim():"",P=O?`${v.initBoard}?taskExecutorPath=${encodeURIComponent(O)}`:v.initBoard,T=await e(P);if(!T.ok)throw new Error(`Server init-board failed (${T.status}).`)}let R=m();if(!R)throw new Error("Server origin not resolved before SSE start");F();let I=!n.current,dt=`${R}${v.stream}${v.stream.includes("?")?"&":"?"}clientId=${encodeURIComponent(p)}`,X=await new Promise((O,P)=>{let T=new EventSource(dt);y=T;let D=false,j=I?setTimeout(()=>{D||P(new Error("SSE initial payload timeout (15s)"));},15e3):null;T.onopen=()=>{rt(v),I||O(n.current?.payload??null);},T.onmessage=ct=>{try{let N=JSON.parse(ct.data||"{}");V(N),!D&&I&&(N?.cardDefinitions||U(N))&&(D=!0,j&&clearTimeout(j),O(N));}catch{if(!I)return}},T.onerror=()=>{I&&!D&&(j&&clearTimeout(j),P(new Error("SSE connection failed during bootstrap")));};});if(I){if(!U(X))throw new Error("SSE payload missing published runtime artifacts");w(X);}return n.current}function ot(a){return o.add(a),a(n.current),()=>{o.delete(a);}}function it(){F(),Object.keys(l).forEach(a=>delete l[a]),u=null,h=null,o.clear(),n.current=null;}return {bootstrap:at,attachProvidedState:nt,applyServerUpdate:st,seedStateFromPayload:d,seedState:S,applyNotificationBatch:C,replacePayload:w,subscribe:ot,closeSse:F,isConnected:()=>y!=null,getState:()=>n.current,getPayload:g,getBoardId:()=>h,getClientId:()=>p,getSseClientId:()=>p,patchCardState:$,retriggerCard:tt,dispatchCardAction:M,uploadCardFile:x,subscribeCardChats:K,unsubscribeCardChats:et,dispose:it}}function Q(t){if(!t||typeof t!="object")throw new Error("options are required");if(!t.session)throw new Error("options.session is required");let{session:e,...r}=t,m=t.session&&"canvas"in t&&typeof t.canvas=="object"?t.canvas:{height:"72vh",overflow:"auto"},n=e.getState()?H(e.getState(),r):null,o=null,y=String(t.initialMode||"board"),h=new Set;function u(){for(let d of h)d(n);}function l(d){n=d?H(d,r):null,u(),o&&n&&(o.setState(()=>n),vt(o));}let i=e.subscribe(d=>{l(d);});function p(d){if(!n)throw new Error("Derived board runtime has no state to mount");let S=d?.rootElement;if(!S)throw new Error("mountBoard requires params.rootElement");y=String(d?.mode||y||"board");let C=r.boardPaths&&r.getServerOrigin&&e.getBoardId()?ht({boardPaths:r.boardPaths,getServerOrigin:r.getServerOrigin,boardId:e.getBoardId()}):null,x=bt(),M=x.init({resolve:b=>n?.modelsById[b],chartLib:globalThis.Chart??null,markdown:globalThis.marked?b=>globalThis.marked.parse(b):null,sanitize:globalThis.DOMPurify?b=>globalThis.DOMPurify.sanitize(b):null,onPatchState:(b,A)=>e.patchCardState(b,A),onRefresh:b=>e.retriggerCard(b),onAction:(b,A,$)=>e.dispatchCardAction(b,A,$).then(()=>{}),startReceivingChats:b=>{e.subscribeCardChats(b);},stopReceivingChats:b=>{e.unsubscribeCardChats(b);},fileUrlBase:C||void 0});return S.innerHTML="",o=x.Board(M,S,{initialState:n,getNodeIds:b=>b.cardIds,selectNode:(b,A)=>b.modelsById[A],mode:y,canvas:m}),o}function s(d){return h.add(d),d(n),()=>{h.delete(d);}}function g(d){y=String(d||"board");let S=o&&o.core;S&&typeof S.setMode=="function"&&S.setMode(y);}function k(){if(!o)return;y="canvas";let d=o.core;d&&typeof d.setMode=="function"&&d.setMode("canvas"),d&&typeof d.autoLayout=="function"&&d.autoLayout();}function c(d){let S=o&&o.core;S&&typeof S.setDevMode=="function"&&S.setDevMode(!!d);}function w(){i(),h.clear(),o=null;}return {mountBoard:p,subscribe:s,getState:()=>n,getFullState:()=>e.getState(),getBoardId:()=>e.getBoardId(),getClientId:()=>e.getClientId(),getSseClientId:()=>e.getSseClientId(),patchCardState:(d,S)=>e.patchCardState(d,S),retriggerCard:d=>e.retriggerCard(d),dispatchCardAction:(d,S,C)=>e.dispatchCardAction(d,S,C),uploadCardFile:(d,S,C)=>e.uploadCardFile(d,S,C),subscribeCardChats:d=>e.subscribeCardChats(d),unsubscribeCardChats:d=>e.unsubscribeCardChats(d),setMode:g,autoLayout:k,setDevMode:c,getCurrentMode:()=>y,dispose:w}}function Ne(t){let e=Ct(t),r=Q({session:e,boardPaths:t.boardPaths,getServerOrigin:t.getServerOrigin});async function m(n){let o=String(n?.boardId||"default");return await e.bootstrap({boardId:o,taskExecutorPath:n?.taskExecutorPath}),r.mountBoard({rootElement:n.rootElement,mode:n.mode})}return {bootstrapBoard:m,dispose:()=>{r.dispose(),e.dispose();},setMode:n=>r.setMode(n),autoLayout:()=>r.autoLayout(),setDevMode:n=>r.setDevMode(n),getCurrentMode:()=>r.getCurrentMode(),getState:()=>e.getState(),getRuntimeSession:()=>e,createDerivedRuntime:(n={})=>Q({session:e,...n})}}exports.applyBoardNotifications=Pe;exports.applyNotification=J;exports.buildBoardState=q;exports.buildFileUrlBase=ht;exports.createBoardRuntimeClient=Ne;exports.createBoardRuntimeSession=Ct;exports.createDerivedBoardRuntime=Q;exports.defaultBoardPaths=Ie;exports.deriveBoardState=H;exports.dispatchCardAction=St;exports.patchCardState=yt;exports.pickBoardState=De;exports.prepareActionPayload=mt;exports.retriggerCard=kt;exports.selectAllLiveCardModels=U;exports.selectLiveCardModel=E;exports.serverPayloadToBoardState=Oe;exports.singleBoardPaths=Be;exports.subtractBoardState=je;exports.uploadCardFile=Z;return exports;})({});//# sourceMappingURL=board-livecards-client.js.map
-//# sourceMappingURL=board-livecards-client.js.map

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

@@ -1,272 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>Example Board Demo (Server 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" />
-  <style>
-    /* Scale down markdown headings inside cards to stay in proportion with card body text */
-    .lc-result h1 { font-size: 1rem;   font-weight: 700; margin: 0.5rem 0 0.25rem; }
-    .lc-result h2 { font-size: 0.9rem; font-weight: 700; margin: 0.5rem 0 0.25rem; border-bottom: 1px solid #dee2e6; padding-bottom: 0.1rem; }
-    .lc-result h3 { font-size: 0.85rem; font-weight: 600; margin: 0.4rem 0 0.2rem; }
-    .lc-result p  { font-size: 0.8rem; margin: 0 0 0.25rem; }
-    .lc-result ul, .lc-result ol { font-size: 0.8rem; margin: 0 0 0.25rem; padding-left: 1.2rem; }
-    .lc-result li { margin-bottom: 0.15rem; }
-  </style>
-  <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.7.1/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.7.1/browser/board-livecards-client.js"></script>
-</head>
-<body class="bg-light">
-  <div class="container-fluid py-3">
-    <div class="d-flex flex-wrap align-items-center justify-content-between gap-2 mb-3">
-      <div>
-        <h1 class="h4 mb-0" id="boardTitle">Example Board (Server Runtime)</h1>
-        <div class="small text-muted" id="boardDesc"></div>
-      </div>
-      <div class="d-flex align-items-center gap-2">
-        <select class="form-select form-select-sm" id="boardSelector" style="max-width:180px" title="Active board"></select>
-        <button class="btn btn-sm btn-outline-success" id="addBoardBtn">+ Board</button>
-        <div id="addBoardForm" class="d-flex align-items-center gap-1" style="display:none!important">
-          <input class="form-control form-control-sm" id="newBoardId" placeholder="board-id" style="max-width:110px" />
-          <input class="form-control form-control-sm" id="newBoardLabel" placeholder="Label (optional)" style="max-width:150px" />
-          <button class="btn btn-sm btn-success" id="addBoardSubmit">Add</button>
-          <button class="btn btn-sm btn-secondary" id="addBoardCancel">Cancel</button>
-        </div>
-        <button class="btn btn-sm btn-outline-primary" id="modeBoard">Board</button>
-        <button class="btn btn-sm btn-outline-primary" id="modeCanvas">Canvas</button>
-        <button class="btn btn-sm btn-outline-secondary" id="autoLayout">Auto Layout</button>
-        <button class="btn btn-sm btn-outline-dark" id="refreshAll" style="display:none">Refresh All</button>
-        <div class="form-check ms-2">
-          <input class="form-check-input" type="checkbox" id="devModeToggle" />
-          <label class="form-check-label" for="devModeToggle">Dev Mode</label>
-        </div>
-      </div>
-    </div>
-
-    <div class="alert alert-info small py-2 mb-3">
-      Server runtime mode: board initializes on first connect and streams updates via SSE.
-      Source execution and event processing happen on the server side.
-    </div>
-
-    <div id="boardRoot">
-      <div class="d-flex align-items-center justify-content-center" style="height: 72vh;">
-        <div class="text-center">
-          <div class="spinner-border mb-3" role="status">
-            <span class="visually-hidden">Loading...</span>
-          </div>
-          <p class="text-muted">Initializing board...</p>
-        </div>
-      </div>
-    </div>
-  </div>
-
-  <script>
-    (function () {
-      const createBoardRuntimeClient = window.BoardLiveCardsClient && window.BoardLiveCardsClient.createBoardRuntimeClient;
-      const defaultBoardPaths = window.BoardLiveCardsClient && window.BoardLiveCardsClient.defaultBoardPaths;
-      if (!createBoardRuntimeClient || !defaultBoardPaths) {
-        document.getElementById('boardRoot').innerHTML =
-          '<div class="alert alert-danger">board-livecards-client.js not loaded. Run <code>npm run build:browser</code> first.</div>';
-        throw new Error('BoardLiveCardsClient not loaded');
-      }
-      let currentMode = 'canvas';
-      let bootstrapCompleted = false;
-      let activeBoardId = 'live';
-      let runtimeClient = null;
-
-      function boardPaths(boardId) {
-        return defaultBoardPaths(boardId || activeBoardId || 'default');
-      }
-
-      function localServerOrigins() {
-        const params = new URLSearchParams(window.location.search || '');
-        const fromQuery = params.get('demoServerOrigin');
-        const fromWindow = window.DEMO_SERVER_ORIGIN;
-        const hostPref = window.location.hostname === 'localhost' ? 'localhost' : '127.0.0.1';
-        const hostAlt = hostPref === 'localhost' ? '127.0.0.1' : 'localhost';
-        const defaults = [
-          `http://${hostPref}:7799`,
-          `http://${hostAlt}:7799`,
-        ];
-
-        const unique = [];
-        const push = (v) => {
-          if (!v || typeof v !== 'string') return;
-          if (unique.includes(v)) return;
-          unique.push(v);
-        };
-
-        push(fromWindow);
-        push(fromQuery);
-        defaults.forEach(push);
-        return unique;
-      }
-
-      let activeServerOrigin = null;
-
-      async function fetchServer(path, init) {
-        const origins = activeServerOrigin ? [activeServerOrigin] : localServerOrigins();
-        const failures = [];
-
-        for (const origin of origins) {
-          const url = `${origin}${path}`;
-          try {
-            const res = await fetch(url, init);
-            activeServerOrigin = origin;
-            return res;
-          } catch (err) {
-            failures.push(`${url} -> ${String(err && err.message || err)}`);
-          }
-        }
-
-        const tip = 'Start the server from the yaml-flow folder: node public-examples/board/server/board-server.js';
-        throw new Error(`Unable to reach example-board demo server. Tried: ${failures.join(' | ')}. ${tip}`);
-      }
-
-      runtimeClient = createBoardRuntimeClient({
-        fetchServer,
-        boardPaths,
-        getServerOrigin: function () { return activeServerOrigin; },
-        initialMode: currentMode,
-        canvas: { height: '72vh', overflow: 'auto' },
-      });
-
-      async function loadBoardList() {
-        try {
-          const res = await fetchServer('/api/boards');
-          if (!res.ok) return;
-          const data = await res.json();
-          const boards = Array.isArray(data && data.boards) ? data.boards : [];
-          const sel = document.getElementById('boardSelector');
-          const prev = sel.value;
-          sel.innerHTML = boards.map((b) =>
-            `<option value="${b.id}"${b.id === (prev || activeBoardId) ? ' selected' : ''}>${b.label || b.id}</option>`
-          ).join('');
-          if (boards.length && !boards.some((b) => b.id === activeBoardId)) {
-            activeBoardId = boards[0].id;
-            sel.value = activeBoardId;
-          }
-        } catch (err) {
-          console.warn('Could not load board list', err);
-        }
-      }
-
-      async function switchBoard(boardId) {
-        if (boardId === activeBoardId && bootstrapCompleted) return;
-        runtimeClient.dispose();
-        bootstrapCompleted = false;
-        activeBoardId = boardId;
-        document.getElementById('boardRoot').innerHTML =
-          '<div class="d-flex align-items-center justify-content-center" style="height:72vh">'
-          + '<div class="text-center"><div class="spinner-border mb-3" role="status">'
-          + '<span class="visually-hidden">Loading...</span></div>'
-          + '<p class="text-muted">Loading board...</p></div></div>';
-        await bootstrap(boardId);
-      }
-
-      async function bootstrap(boardId) {
-        const bid = boardId || activeBoardId || 'default';
-
-        // Board title from registry label or fallback
-        document.getElementById('boardTitle').textContent = bid + ' (Server Runtime)';
-        document.getElementById('boardDesc').textContent = '';
-
-        // SSE-first bootstrap: init-board initializes the board server-side,
-        // then /sse sends the full payload as the first frame. No separate
-        // demo-setup step needed — the server runs it automatically at init time.
-        await runtimeClient.bootstrapBoard({
-          boardId: bid,
-          rootElement: document.getElementById('boardRoot'),
-          mode: currentMode,
-        });
-
-        bootstrapCompleted = true;
-      }
-
-      document.getElementById('modeBoard').addEventListener('click', function () {
-        currentMode = 'board';
-        runtimeClient.setMode('board');
-      });
-
-      document.getElementById('modeCanvas').addEventListener('click', function () {
-        currentMode = 'canvas';
-        runtimeClient.setMode('canvas');
-      });
-
-      document.getElementById('autoLayout').addEventListener('click', function () {
-        currentMode = 'canvas';
-        runtimeClient.autoLayout();
-      });
-
-      document.getElementById('devModeToggle').addEventListener('change', function () {
-        runtimeClient.setDevMode(this.checked);
-      });
-
-      document.getElementById('boardSelector').addEventListener('change', function () {
-        switchBoard(this.value).catch(function (err) {
-          console.error(err);
-          document.getElementById('boardRoot').innerHTML =
-            `<div class="alert alert-danger">Failed to switch board: ${String(err && err.message || err)}</div>`;
-        });
-      });
-
-      document.getElementById('addBoardBtn').addEventListener('click', function () {
-        document.getElementById('addBoardForm').style.removeProperty('display');
-        document.getElementById('newBoardId').focus();
-      });
-
-      document.getElementById('addBoardCancel').addEventListener('click', function () {
-        document.getElementById('addBoardForm').style.display = 'none';
-        document.getElementById('newBoardId').value = '';
-        document.getElementById('newBoardLabel').value = '';
-      });
-
-      document.getElementById('addBoardSubmit').addEventListener('click', async function () {
-        const id = document.getElementById('newBoardId').value.trim();
-        const label = document.getElementById('newBoardLabel').value.trim();
-        if (!id) {
-          alert('Board id is required');
-          return;
-        }
-        try {
-          const res = await fetchServer('/api/boards', {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify({ id, label: label || id }),
-          });
-          const data = await res.json();
-          if (!res.ok) {
-            alert(data.error || 'Failed to add board');
-            return;
-          }
-          document.getElementById('addBoardForm').style.display = 'none';
-          document.getElementById('newBoardId').value = '';
-          document.getElementById('newBoardLabel').value = '';
-          await loadBoardList();
-          await switchBoard(id);
-        } catch (err) {
-          alert('Error adding board: ' + String((err && err.message) || err));
-        }
-      });
-
-      loadBoardList().then(function () {
-        return bootstrap(activeBoardId);
-      }).catch(function (err) {
-        console.error(err);
-        document.getElementById('boardRoot').innerHTML =
-          `<div class="alert alert-danger">Failed to start server runtime demo: ${String(err && err.message || err)}</div>`;
-      });
-
-      window.addEventListener('beforeunload', function () {
-        runtimeClient.dispose();
-      });
-    })();
-  </script>
-</body>
-</html>