yaml-flow 7.1.0 → 8.0.0

package/cli/node/step-machine-cli.js

@@ -0,0 +1,5 @@
+import*as m from'fs';import {existsSync}from'fs';import*as R from'path';import {dirname,resolve}from'path';import'ajv-formats';import {createRequire}from'module';import {fileURLToPath}from'url';import {spawn,execFile,execFileSync}from'child_process';import*as St from'os';import'net';import {randomUUID}from'crypto';import'proper-lockfile';function I(e,t,r,n){let s=e.steps[r];if(!s)throw new Error(`Step "${r}" not found in flow configuration`);if(n.result==="failure"&&s.retry){let i=t.retryCounts[r]??0;if(i<s.retry.max_attempts)return {newState:{...t,retryCounts:{...t.retryCounts,[r]:i+1},updatedAt:Date.now()},nextStep:r,isTerminal:false,isCircuitBroken:false,shouldRetry:true}}let o=s.failure_transitions?.[n.result]??s.transitions[n.result];if(!o)throw new Error(`No transition defined for result "${n.result}" in step "${r}"`);let a=!!e.terminal_states[o];return {newState:{...t,currentStep:o,stepHistory:[...t.stepHistory,r],retryCounts:{...t.retryCounts,[r]:0},updatedAt:Date.now()},nextStep:o,isTerminal:a,isCircuitBroken:false,shouldRetry:false}}function N(e,t,r){let n=e.steps[r];if(!n?.circuit_breaker)return {broken:false,newState:{...t,iterationCounts:{...t.iterationCounts,[r]:(t.iterationCounts[r]??0)+1},updatedAt:Date.now()}};let s=t.iterationCounts[r]??0;return s>=n.circuit_breaker.max_iterations?{broken:true,redirectStep:n.circuit_breaker.on_open,newState:{...t,currentStep:n.circuit_breaker.on_open,updatedAt:Date.now()}}:{broken:false,newState:{...t,iterationCounts:{...t.iterationCounts,[r]:s+1},updatedAt:Date.now()}}}function L(e,t,r){let n=e.steps[t];if(!n)throw new Error(`Step "${t}" not found`);if(n.expects_data){let s={};for(let o of n.expects_data)s[o]=r[o];return s}return {...r}}function K(e,t){if(e===false||e===void 0)return {};if(typeof e=="string")return {[e]:t[e]};if(Array.isArray(e)){let r={};for(let n of e)r[n]=t[n];return r}return {}}function q(e,t){let r=Date.now();return {runId:t,flowId:e.id??"unnamed",currentStep:e.settings.start_step,status:"running",stepHistory:[],iterationCounts:{},retryCounts:{},startedAt:r,updatedAt:r}}var k=class{runs=new Map;data=new Map;async saveRunState(t,r){this.runs.set(t,{...r});}async loadRunState(t){let r=this.runs.get(t);return r?{...r}:null}async deleteRunState(t){this.runs.delete(t),this.data.delete(t);}async setData(t,r,n){this.data.has(t)||this.data.set(t,{});let s=this.data.get(t);s[r]=n;}async getData(t,r){return this.data.get(t)?.[r]}async getAllData(t){return {...this.data.get(t)??{}}}async clearData(t){this.data.delete(t);}async listRuns(){return Array.from(this.runs.keys())}clear(){this.runs.clear(),this.data.clear();}};function Ft(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return (e==="x"?t:t&3|8).toString(16)})}var O=class{flow;handlers;store;components;options;listeners=new Map;aborted=false;constructor(t,r,n={}){this.flow=t,this.handlers=new Map(Object.entries(r)),this.store=n.store??new k,this.components=n.components??{},this.options=n,n.signal&&n.signal.addEventListener("abort",()=>{this.aborted=true;}),this.validateFlow();}validateFlow(){let{settings:t,steps:r,terminal_states:n}=this.flow;if(!t?.start_step)throw new Error("Flow must have settings.start_step defined");if(!r||Object.keys(r).length===0)throw new Error("Flow must have at least one step defined");if(!n||Object.keys(n).length===0)throw new Error("Flow must have at least one terminal_state defined");if(!r[t.start_step]&&!n[t.start_step])throw new Error(`Start step "${t.start_step}" not found`);for(let[s,o]of Object.entries(r)){for(let[a,i]of Object.entries(o.transitions))if(!r[i]&&!n[i])throw new Error(`Step "${s}" transition "${a}" points to unknown step "${i}"`);if(o.failure_transitions){for(let[a,i]of Object.entries(o.failure_transitions))if(!r[i]&&!n[i])throw new Error(`Step "${s}" failure_transition "${a}" points to unknown step "${i}"`)}}}on(t,r){this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(r);}off(t,r){this.listeners.get(t)?.delete(r);}emit(t){let r=this.listeners.get(t.type);if(r)for(let n of r)try{n(t);}catch{}}sleep(t){return new Promise(r=>setTimeout(r,t))}async run(t){let r=Ft(),n=q(this.flow,r);if(await this.store.saveRunState(r,n),t)for(let[s,o]of Object.entries(t))await this.store.setData(r,s,o);this.emit({type:"flow:start",runId:r,timestamp:n.startedAt,data:{initialData:t??{}}});try{return await this.executeLoop(r,n)}catch(s){let o=s instanceof Error?s:new Error(String(s));return this.emit({type:"flow:error",runId:r,timestamp:Date.now(),data:{error:o.message}}),this.options.onError?.(o),n={...n,status:"failed",updatedAt:Date.now()},await this.store.saveRunState(r,n),{runId:r,status:"failed",data:await this.store.getAllData(r),finalStep:n.currentStep,stepHistory:n.stepHistory,durationMs:Date.now()-n.startedAt,error:o}}}async resume(t){let r=await this.store.loadRunState(t);if(!r)throw new Error(`No run found with ID: ${t}`);if(r.status==="completed"||r.status==="failed")throw new Error(`Cannot resume a ${r.status} run`);let n={...r,status:"running",pausedAt:void 0,updatedAt:Date.now()};return await this.store.saveRunState(t,n),this.emit({type:"flow:resumed",runId:t,timestamp:Date.now(),data:{currentStep:n.currentStep}}),this.executeLoop(t,n)}async pause(t){let r=await this.store.loadRunState(t);if(!r)throw new Error(`No run found with ID: ${t}`);let n={...r,status:"paused",pausedAt:Date.now(),updatedAt:Date.now()};await this.store.saveRunState(t,n),this.emit({type:"flow:paused",runId:t,timestamp:Date.now(),data:{currentStep:n.currentStep}});}async executeLoop(t,r){let n=this.flow.settings.max_total_steps??100,s=this.flow.settings.timeout_ms,o=r,a=0;for(;a<n;){if(this.aborted)return o={...o,status:"cancelled",updatedAt:Date.now()},await this.store.saveRunState(t,o),{runId:t,status:"cancelled",data:await this.store.getAllData(t),finalStep:o.currentStep,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt};if(s&&Date.now()-o.startedAt>s)return o={...o,status:"completed",updatedAt:Date.now()},await this.store.saveRunState(t,o),{runId:t,status:"timeout",intent:"timeout",data:await this.store.getAllData(t),finalStep:o.currentStep,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt};let i=o.currentStep,l=this.flow.terminal_states[i];if(l){o={...o,status:"completed",updatedAt:Date.now()},await this.store.saveRunState(t,o);let p=await this.store.getAllData(t),g={runId:t,status:"completed",intent:l.return_intent,data:K(l.return_artifacts,p),finalStep:i,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt};return this.emit({type:"flow:complete",runId:t,timestamp:Date.now(),data:{...g}}),this.options.onComplete?.(g),g}let c=N(this.flow,o,i);if(c.broken){o=c.newState,await this.store.saveRunState(t,o),a++;continue}o=c.newState;let d=await this.store.getAllData(t),u=L(this.flow,i,d),f={runId:t,stepName:i,components:this.components,store:this.store,signal:this.options.signal,emit:(p,g)=>{this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{event:p,payload:g}});}};this.emit({type:"step:start",runId:t,timestamp:Date.now(),data:{step:i,input:u}});let h;try{let p=this.handlers.get(i);if(!p)throw new Error(`No handler registered for step "${i}"`);h=await p(u,f);}catch(p){let g=p instanceof Error?p:new Error(String(p));this.emit({type:"step:error",runId:t,timestamp:Date.now(),data:{step:i,error:g.message}}),h={result:"failure",data:{error:g.message}};}if(h.data)for(let[p,g]of Object.entries(h.data))await this.store.setData(t,p,g);this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{step:i,result:h.result}}),this.options.onStep?.(i,h);let w=I(this.flow,o,i,h);if(o=w.newState,w.shouldRetry){await this.store.saveRunState(t,o);let p=this.flow.steps[i];if(p.retry?.delay_ms){let g=o.retryCounts[i]??0,x=p.retry.backoff_multiplier?p.retry.delay_ms*Math.pow(p.retry.backoff_multiplier,g-1):p.retry.delay_ms;await this.sleep(x);}a++;continue}await this.store.saveRunState(t,o),this.emit({type:"transition",runId:t,timestamp:Date.now(),data:{from:i,to:o.currentStep,result:h.result}}),this.options.onTransition?.(i,o.currentStep),a++;}return o={...o,status:"completed",updatedAt:Date.now()},await this.store.saveRunState(t,o),{runId:t,status:"max_iterations",intent:"max_iterations",data:await this.store.getAllData(t),finalStep:o.currentStep,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt}}};function _(e,t,r){return new O(e,t,r)}async function U(e){return (await import('yaml')).parse(e)}async function Tt(e){let t=await fetch(e);if(!t.ok)throw new Error(`Failed to load flow from ${e}: ${t.statusText}`);let r=t.headers.get("content-type")??"",n=await t.text();return r.includes("json")||e.endsWith(".json")?JSON.parse(n):U(n)}async function Pt(e){let r=await(await import('fs/promises')).readFile(e,"utf-8");return e.endsWith(".json")?JSON.parse(r):U(r)}function tt(e){let t=[];if(!e||typeof e!="object")return ["Flow must be an object"];let r=e;if(!r.settings||typeof r.settings!="object"?t.push('Flow must have a "settings" object'):typeof r.settings.start_step!="string"&&t.push("settings.start_step must be a string"),!r.steps||typeof r.steps!="object")t.push('Flow must have a "steps" object');else {let n=r.steps;for(let[s,o]of Object.entries(n)){if(!o||typeof o!="object"){t.push(`Step "${s}" must be an object`);continue}let a=o;(!a.transitions||typeof a.transitions!="object")&&t.push(`Step "${s}" must have a "transitions" object`),a.failure_transitions!==void 0&&typeof a.failure_transitions!="object"&&t.push(`Step "${s}" failure_transitions must be an object when provided`);}}if(!r.terminal_states||typeof r.terminal_states!="object")t.push('Flow must have a "terminal_states" object');else {let n=r.terminal_states;for(let[s,o]of Object.entries(n)){if(!o||typeof o!="object"){t.push(`Terminal state "${s}" must be an object`);continue}typeof o.return_intent!="string"&&t.push(`Terminal state "${s}" must have a "return_intent" string`);}}return t}async function H(e){let t;typeof e=="string"?e.startsWith("http://")||e.startsWith("https://")?t=await Tt(e):e.includes("{")?t=JSON.parse(e):t=await Pt(e):t=e;let r=tt(t);if(r.length>0)throw new Error(`Invalid step flow configuration:
+- ${r.join(`
+- `)}`);return t}function V(e){return btoa(e).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function et(e){return atob(e.replace(/-/g,"+").replace(/_/g,"/"))}var j=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${V(t)}`}dataPrefix(t){return `data_${V(t)}_`}dataKey(t,r){return `${this.dataPrefix(t)}${V(r)}`}async saveRunState(t,r){this.kv.write(this.stateKey(t),r);}async loadRunState(t){let r=this.kv.read(this.stateKey(t));return r!=null&&typeof r=="object"?r:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let r of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(r);}async setData(t,r,n){this.kv.write(this.dataKey(t,r),n);}async getData(t,r){return this.kv.read(this.dataKey(t,r))}async getAllData(t){let r=this.dataPrefix(t),n={};for(let s of this.kv.listKeys(r))n[et(s.slice(r.length))]=this.kv.read(s);return n}async clearData(t){for(let r of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(r);}async listRuns(){return this.kv.listKeys("state_").map(t=>et(t.slice(6)))}};var nt=dirname(fileURLToPath(import.meta.url)),Jt=createRequire(import.meta.url);function Dt(){let e=resolve(nt,"./jsonata-sync.cjs");return existsSync(e)?e:resolve(nt,"../card-compute/jsonata-sync.cjs")}var $=Jt(Dt());function st(e,t){if(!e||typeof e!="object")throw new Error(`[step-machine-public] Step "${t}" returned a non-object result.`);let r=e,n=r.result??r.status;if(typeof n=="string"&&n.trim().length>0){let s=r.data&&typeof r.data=="object"&&!Array.isArray(r.data)?{...r.data}:{},o=typeof r.error=="string"?r.error:void 0;return o&&!("error"in s)&&(s.error=o),{result:n,data:s,...o?{error:o}:{}}}return {result:"success",data:{...r}}}function ot(e,t){if(!t||t.length===0)return e;let r={};for(let n of t)Object.prototype.hasOwnProperty.call(e,n)&&(r[n]=e[n]);return r}function z(e,t){return async(r,n)=>{let s=await e(r,n),o=st(s,n?.stepName??"unknown");return {result:o.result,data:ot(o.data,t),...o.error?{error:o.error}:{}}}}function it(e,t,r){if(!t||t.length===0)return null;for(let n of t)try{if(!$(n).evaluate(e))return {result:"failure",data:{error:`[${r}] input validation failed: ${n}`}}}catch(s){let o=s instanceof Error?s.message:String(s);return {result:"failure",data:{error:`[${r}] input validation error on "${n}": ${o}`}}}return null}function W(e,t,r){return !t||t.length===0?e:async(n,s)=>{let o=it(n,t,r);return o||e(n,s)}}var ct=dirname(fileURLToPath(import.meta.url)),Kt=createRequire(import.meta.url);function qt(){let e=resolve(ct,"./jsonata-sync.cjs");return existsSync(e)?e:resolve(ct,"../../card-compute/jsonata-sync.cjs")}var v=Kt(qt());function ut(e,t,r){if(!e||typeof e!="object")return {};let n={};if(Array.isArray(e.cmdTemplate)){let s=[];for(let o of e.cmdTemplate)try{s.push(String(v(o).evaluate(t)));}catch(a){let i=a instanceof Error?a.message:String(a);throw new Error(`[${r}] argsMassaging.cmdTemplate failed on "${o}": ${i}`)}n.cmdArgs=s;}if(typeof e.stdinTemplate=="string")try{n.stdin=v(e.stdinTemplate).evaluate(t);}catch(s){let o=s instanceof Error?s.message:String(s);throw new Error(`[${r}] argsMassaging.stdinTemplate failed: ${o}`)}if(typeof e.urlTemplate=="string")try{n.url=String(v(e.urlTemplate).evaluate(t));}catch(s){let o=s instanceof Error?s.message:String(s);throw new Error(`[${r}] argsMassaging.urlTemplate failed: ${o}`)}if(typeof e.headerTemplate=="string")try{let s=v(e.headerTemplate).evaluate(t);if(typeof s!="object"||s===null)throw new Error(`headerTemplate must produce an object, got: ${JSON.stringify(s)}`);n.headers=s;}catch(s){let o=s instanceof Error?s.message:String(s);throw new Error(`[${r}] argsMassaging.headerTemplate failed: ${o}`)}if(typeof e.bodyTemplate=="string")try{n.body=v(e.bodyTemplate).evaluate(t);}catch(s){let o=s instanceof Error?s.message:String(s);throw new Error(`[${r}] argsMassaging.bodyTemplate failed: ${o}`)}return n}function lt(e,t,r){if(!e||typeof e!="object")return t;let n={output:t},s=t.result,o=t.data,a=t.error;if(typeof e.resultExpr=="string")try{let i=v(e.resultExpr).evaluate(n);if(typeof i!="string"||!i.trim())throw new Error(`resultExpr did not produce a non-empty string (got ${JSON.stringify(i)})`);s=i;}catch(i){let l=i instanceof Error?i.message:String(i);throw new Error(`[${r}] outputTransforms.resultExpr failed: ${l}`)}if(typeof e.dataTemplate=="string")try{let i=v(e.dataTemplate).evaluate(n);if(!i||typeof i!="object"||Array.isArray(i))throw new Error(`dataTemplate did not produce an object (got ${JSON.stringify(i)})`);o=i;}catch(i){let l=i instanceof Error?i.message:String(i);throw new Error(`[${r}] outputTransforms.dataTemplate failed: ${l}`)}if(typeof e.errorExpr=="string")try{let i=v(e.errorExpr).evaluate(n);a=i!=null?String(i):void 0;}catch(i){let l=i instanceof Error?i.message:String(i);throw new Error(`[${r}] outputTransforms.errorExpr failed: ${l}`)}return a!==void 0?{result:s,data:o,error:a}:{result:s,data:o}}var J="b64:";function Ut(e){let t=new TextEncoder().encode(e),r=globalThis.Buffer,n;if(r)n=r.from(t).toString("base64");else if(typeof btoa=="function"){let s="";for(let o of t)s+=String.fromCharCode(o);n=btoa(s);}else throw new Error("No base64 encoder available in this runtime");return n.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}function Vt(e){let t=e.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-e.length%4)%4),r=globalThis.Buffer;if(r)return r.from(t,"base64").toString("utf8");if(typeof atob=="function"){let n=atob(t),s=new Uint8Array(n.length);for(let o=0;o<n.length;o+=1)s[o]=n.charCodeAt(o);return new TextDecoder().decode(s)}throw new Error("No base64 decoder available in this runtime")}function D(e){return `${J}${Ut(JSON.stringify(e))}`}function G(e){if(!e.startsWith(J))throw new Error(`Invalid ref format (expected ${J}<base64url(json)>): ${e}`);let t;try{t=JSON.parse(Vt(e.slice(J.length)));}catch{throw new Error(`Invalid ref format (malformed base64url/json): ${e}`)}if(!t||typeof t!="object")throw new Error(`Invalid ref format (expected object payload): ${e}`);let r=t;if(typeof r.kind!="string"||typeof r.value!="string")throw new Error(`Invalid ref format (payload must contain string kind/value): ${e}`);return {kind:r.kind,value:r.value}}function pt(e){return !!e&&typeof e=="object"&&e.type==="compute-jsonata"&&Array.isArray(e.expr)&&e.expr.length>0}function dt(e){if(!e||typeof e!="object")return  false;let t=e;if(t.type!=="ref"||typeof t.howToRun!="string")return  false;if(typeof t.whatToRun=="string")return  true;if(t.whatToRun&&typeof t.whatToRun=="object"){let r=t.whatToRun;return typeof r.kind=="string"&&typeof r.value=="string"}return  false}function zt(e){if(typeof e=="string"){let t=e.indexOf("=");if(t<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${e}"`);return {bindTo:e.slice(0,t).trim(),expr:e.slice(t+1).trim()}}if(e&&typeof e=="object"&&typeof e.bindTo=="string"&&typeof e.expr=="string")return e;throw new Error(`[step-machine-public] Invalid compute step: ${JSON.stringify(e)}`)}function Wt(e,t,r){let n=t.split("."),s=e;for(let o=0;o<n.length-1;o++){let a=n[o];(s[a]==null||typeof s[a]!="object")&&(s[a]={}),s=s[a];}s[n[n.length-1]]=r;}function ft(e,t,r){let n=e.expr.map(zt);return async s=>{let o=s&&typeof s=="object"&&!Array.isArray(s)?{...s}:{},a={},i={expects_data:o,data:a,...r?{config:r}:{}},l,c;for(let d of n)try{let u=$(d.expr).evaluate(i);if(d.bindTo==="result")l=u!=null?String(u):"success";else if(d.bindTo==="error")c=u!=null?String(u):void 0;else if(d.bindTo.startsWith("data."))Wt(a,d.bindTo.slice(5),u);else return {result:"failure",data:{},error:`[${t}] invalid bindTo "${d.bindTo}": must be "result", "error", or start with "data."`}}catch(u){let f=u instanceof Error?u.message:String(u);return {result:"failure",data:{},error:`[${t}] compute "${d.bindTo}" failed: ${f}`}}return l===void 0?{result:"failure",data:{},error:`[${t}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:c?{result:l,data:a,error:c}:{result:l,data:a}}}function gt(e,t,r,n){let{type:s,...o}=e,a={...o,whatToRun:typeof o.whatToRun=="object"?D(o.whatToRun):o.whatToRun};return async i=>{let l=i&&typeof i=="object"&&!Array.isArray(i)?{...i}:{};n&&(l.config=n);try{let c=await r(a,l);if(!e.outputTransforms)return c;try{return lt(e.outputTransforms,c,t)}catch(d){let u=d instanceof Error?d.message:String(d);return {result:"failure",data:{},error:u}}}catch(c){let d=c instanceof Error?c.message:String(c);return {result:"failure",data:{error:`[step-machine-public] step "${t}" invoke threw: ${d}`}}}}}function mt(){return async e=>({result:"success",data:e&&typeof e=="object"&&!Array.isArray(e)?e:{}})}function Gt(e,t,r){return async(n,s)=>{let o=n?.[t.items];if(!Array.isArray(o))return {result:"failure",data:{},error:`[${r}] forEach: "${t.items}" is not an array (got ${typeof o})`};let a=o,i=t.collectAs??`${t.items}_results`;if(a.length===0)return {result:"success",data:{[i]:[]}};let{[t.items]:l,...c}=n,d=Math.max(1,t.concurrency??1),u=new Array(a.length),f=0,h=0,w=0;return await new Promise(p=>{function g(){for(;f<d&&h<a.length;){let x=h++;f++;let P={...c,[t.as]:a[x]};e(P,s).then(S=>{u[x]=S;}).catch(S=>{let y=S instanceof Error?S.message:String(S);u[x]={result:"failure",data:{},error:y};}).finally(()=>{f--,u[x]?.result==="failure"&&w++,h>=a.length&&f===0?p():g();});}f===0&&h>=a.length&&p();}g();}),w>0?{result:"failure",data:{errors:u.filter(g=>g.result==="failure").map(g=>g.error)},error:`[${r}] forEach: ${w}/${a.length} items failed`}:{result:"success",data:{[i]:u.map(p=>p.data)}}}}function ht(e,t,r){let n=Array.isArray(t?.produces_data)?t?.produces_data:void 0,s=Array.isArray(t?.input_validations)?t?.input_validations:void 0,o=t?.config??void 0,a=t?.handler,i;return pt(a)?i=ft(a,e,o):dt(a)?i=gt(a,e,r.invoke,o):i=mt(),t?.forEach&&(i=Gt(i,t.forEach,e)),W(z(i,n),s,e)}function X(e,t){let r={};for(let[n,s]of Object.entries(e.steps??{}))r[n]=ht(n,s,t);return r}function Zt(e){if(typeof e=="object"&&e!==null){let{command:r,args:n=[],...s}=e,o=wt(r,n);return {...s,command:o.command,args:o.args}}let t=xt(e);if(t.length===0)throw new Error(`Empty command spec: ${JSON.stringify(e)}`);return wt(t[0],t.slice(1))}function wt(e,t){return /^(node|node\.exe)$/i.test(e)?{command:process.execPath,args:t}:/\.m?js$/i.test(e)?{command:process.execPath,args:[e,...t]}:{command:e,args:t}}function xt(e){let t=[],r="",n=null;for(let s of e.trim()){if(n){s===n?n=null:r+=s;continue}if(s==='"'||s==="'"){n=s;continue}if(/\s/.test(s)){r&&(t.push(r),r="");continue}r+=s;}if(n)throw new Error(`Unterminated quote in command: ${e}`);return r&&t.push(r),t}function Y(e){return process.platform==="win32"&&/\.(cmd|bat)$/i.test(e)}function vt(e,t){let{command:r,args:n=[],cwd:s,env:o,timeoutMs:a}=e;return execFileSync(r,n,{shell:Y(r),timeout:a,encoding:t?.encoding??"utf-8",cwd:s,windowsHide:true,env:o?{...process.env,...o}:void 0,input:t?.input})}function te(e,t){let{command:r,args:n=[],cwd:s,env:o,timeoutMs:a=3e4}=e;execFile(r,n,{shell:Y(r),encoding:"utf8",windowsHide:true,timeout:a,maxBuffer:10*1024*1024,cwd:s,env:o?{...process.env,...o}:void 0},(i,l,c)=>t(i??null,l,c));}R.join(St.tmpdir(),".board-live-cards-git-bash-cache.json");function Rt(e){let{command:t,args:r=[]}=e;if(process.platform==="win32"){spawn(t,r,{detached:true,stdio:"ignore",windowsHide:true,shell:Y(t)}).unref();return}spawn(t,r,{detached:true,stdio:"ignore"}).unref();}function kt(e,t,r){let n=R.join(e,"board-live-cards-cli.js");if(m.existsSync(n))return {cmd:process.execPath,args:[n,t,...r]};let s=R.join(e,"board-live-cards-cli.ts"),o=R.join(e,"..","..","node_modules","tsx","dist","cli.mjs"),a=R.join(e,"..","..","node_modules",".bin","tsx"),i=m.existsSync(o)?o:a;return m.existsSync(s)&&m.existsSync(i)?{cmd:process.execPath,args:[i,s,t,...r]}:{cmd:process.platform==="win32"?"npx.cmd":"npx",args:["tsx",s,t,...r]}}function bt(){return {executeSync(e,t,r){return vt({command:e,args:t,cwd:r?.cwd,timeoutMs:r?.timeout,env:r?.env},{encoding:r?.encoding,input:r?.input})},executeAsync(e,t,r){te({command:e,args:t},r);},resolveInvocation(e,t){let r=Zt({command:e,args:t});return {cmd:r.command,args:r.args??[]}},splitCommand:xt,spawnDetached(e,t){Rt({command:e,args:t});}}}function ee(e,t){let r=typeof e=="object"?e.value:G(e).value;switch(r){case "source-cli-task-executor":{let n=R.join(t,"source-cli-task-executor.js");if(m.existsSync(n))return {command:process.execPath,args:[n]};let s=R.join(t,"source-cli-task-executor.ts"),o=R.join(t,"..","..","node_modules","tsx","dist","cli.mjs"),a=R.join(t,"..","..","node_modules",".bin","tsx"),i=m.existsSync(o)?o:a;return m.existsSync(s)&&m.existsSync(i)?{command:process.execPath,args:[i,s]}:{command:process.execPath,args:[n]}}case "board-live-cards":{let{cmd:n,args:s}=kt(t,"_",[]);return {command:n,args:s}}default:throw new Error(`resolveBuiltIn: unknown built-in name "${r}". Supported: source-cli-task-executor, board-live-cards`)}}function re(e,t){if(e.howToRun==="built-in"){let{command:n,args:s}=ee(e.whatToRun,t);return {command:n,baseArgs:s}}let r=typeof e.whatToRun=="object"?e.whatToRun.value:G(e.whatToRun).value;switch(e.howToRun){case "local-node":return {command:process.execPath,baseArgs:[r]};case "local-python":return {command:process.platform==="win32"?"python":"python3",baseArgs:[r]};case "local-process":return {command:r,baseArgs:[]};default:throw new Error(`resolveBaseInvocation: howToRun "${e.howToRun}" is not a local transport`)}}function ne(e,t){return re(e,t)}function se(e){let t=e.trim();if(!t)throw new Error("empty stdout");try{return JSON.parse(t)}catch{let r=t.split(/\r?\n/).filter(Boolean),n=r[r.length-1];return JSON.parse(n)}}function Et(e,t,r){let n=r?.label??"invokeRefSync",s=r?.cliDir??r?.cwd??process.cwd(),o;try{o=ut(e.argsMassaging,t,n);}catch(u){return {result:"failure",data:{error:u instanceof Error?u.message:String(u)}}}let a;try{a=ne(e,s);}catch(u){let f=u instanceof Error?u.message:String(u);return {result:"failure",data:{error:`[${n}] ref resolution failed: ${f}`}}}let i=[...a.baseArgs,...o.cmdArgs??[]],l=JSON.stringify(o.stdin??t),c=bt(),d;try{d=c.executeSync(a.command,i,{timeout:r?.timeoutMs??3e4,encoding:"utf-8",cwd:r?.cwd,input:l});}catch(u){let f=u,h=(f.stderr?String(f.stderr):"").trim(),w=typeof f.status=="number"?f.status:"unknown",p=h||f.message;return {result:"failure",data:{error:`[${n}] ref exited with status ${w}${p?`: ${p}`:""}`}}}try{let u=se(d);return {result:"success",data:u&&typeof u=="object"&&!Array.isArray(u)?u:{stdout:u}}}catch{return {result:"success",data:{stdout:d.trim()}}}}function ie(e,t){if(process.platform!=="win32"){m.renameSync(e,t);return}let r=[10,20,40,80,160];for(let n=0;n<=r.length;n++)try{m.renameSync(e,t);return}catch(s){let o=s.code;if((o==="EPERM"||o==="EBUSY")&&n<r.length){Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,r[n]);continue}throw s}}function At(e){function t(n){return R.join(e,...n.split("/"))+".json"}function r(n,s,o,a){if(m.existsSync(n))for(let i of m.readdirSync(n,{withFileTypes:true})){let l=s?`${s}/${i.name}`:i.name;if(i.isDirectory()){r(R.join(n,i.name),l,o,a);continue}if(!i.isFile()||!i.name.endsWith(".json"))continue;let c=l.replace(/\.json$/,"");(!o||c.startsWith(o))&&a.push(c);}}return {read(n){let s=t(n);if(!m.existsSync(s))return null;try{return JSON.parse(m.readFileSync(s,"utf-8"))}catch{return null}},write(n,s){let o=t(n),a=`${o}.${process.pid}.${randomUUID()}.tmp`;m.mkdirSync(R.dirname(o),{recursive:true}),m.writeFileSync(a,JSON.stringify(s,null,2),"utf-8"),ie(a,o);},delete(n){let s=t(n);try{m.existsSync(s)&&m.unlinkSync(s);}catch{}},listKeys(n){let s=[];return r(e,"",n,s),s.sort()}}}var B=class extends Error{constructor(r,n){super(n);this.code=r;this.name="CliExitError";}code},ae=".pause";async function Hr(e){let t=ce(e);if(t.help||e.length===0)throw he(),new B(e.length===0?1:0);let{flowArg:r,dataArg:n,storeArg:s,storeDirArg:o,resumeRequested:a,pauseRequested:i,statusRequested:l}=t;if((i||l)&&(n||a||r))throw new Error("[step-machine-cli] --pause and --status are store-level operations. Do not provide flow, data, or --resume.");if(a&&n)throw new Error("[step-machine-cli] --initial-data cannot be combined with --resume.");let c=ue(s,o);if(l){await de(c);return}if(i){await le(c);return}if(!r)throw new Error("[step-machine-cli] Flow path is required for run/resume operations.");let d=$t(r),u=R.dirname(d),f=fe(n),{store:h}=c,w=await H(d),p=me(w,u);jt(c);let g=new AbortController,x=false,P=_(w,p,{store:h,signal:g.signal,onStep:()=>{!x&&Z(c)&&(x=true,g.abort());}}),S;if(a){if(S=await Ct(c),!S){console.warn("[step-machine-cli] No paused run found in store directory."),console.log(JSON.stringify({status:"noop",reason:"no-paused-run"},null,2));return}}else c.storeType==="file"&&!f&&(S=await Ct(c));let y=S?await P.resume(S):await P.run(f);if(x&&y.status==="cancelled"){let M=await pe(h,y.runId);jt(c),console.log(JSON.stringify({runId:y.runId,status:"paused",currentStep:M?.currentStep,pausedAt:M?.pausedAt,stepHistory:y.stepHistory,data:y.data},null,2));return}if(y.status!=="completed"){let M=y.error?.message??y.intent??y.status;throw console.error(`[step-machine-cli] Run failed: ${M}`),new B(1)}console.log(JSON.stringify({runId:y.runId,status:y.status,intent:y.intent,finalStep:y.finalStep,stepHistory:y.stepHistory,data:y.data},null,2));}function ce(e){let t=new Set(["--initial-data","--store","--store-dir"]),r={},n=[],s=false,o=false,a=false,i=false;for(let l=0;l<e.length;l++){let c=e[l];if(c==="-h"||c==="--help"){s=true;continue}if(c==="--resume"){o=true;continue}if(c==="--pause"){a=true;continue}if(c==="--status"){i=true;continue}if(t.has(c)){let d=e[l+1];if(!d||d.startsWith("--"))throw new Error(`[step-machine-cli] Missing value for ${c}.`);r[c]=d,l++;continue}if(c.startsWith("--"))throw new Error(`[step-machine-cli] Unknown flag: ${c}`);n.push(c);}if([o,a,i].filter(Boolean).length>1)throw new Error("[step-machine-cli] Use only one of --resume, --pause, or --status at a time.");return {help:s,flowArg:n[0],dataArg:r["--initial-data"],storeArg:String(r["--store"]??"memory").toLowerCase(),storeDirArg:r["--store-dir"],resumeRequested:o,pauseRequested:a,statusRequested:i}}function $t(e){return R.isAbsolute(e)?e:R.resolve(process.cwd(),e)}function ue(e,t){if(e!=="memory"&&e!=="file")throw new Error(`[step-machine-cli] Invalid --store value "${e}". Expected "memory" or "file".`);if(e==="memory")return {storeType:e,storeDir:void 0,pauseFilePath:void 0,store:new k};if(!t||t.trim().length===0)throw new Error("[step-machine-cli] --store file requires --store-dir <directory>.");let r=$t(t);return {storeType:e,storeDir:r,pauseFilePath:R.join(r,ae),store:new j(At(r))}}async function Q(e){if(!e.listRuns)return [];let t=await e.listRuns(),r=[];for(let n of t){let s=await e.loadRunState(n);s&&r.push(s);}return r.sort((n,s)=>(s.updatedAt??s.startedAt??0)-(n.updatedAt??n.startedAt??0)),r}function Z(e){return e.storeType!=="file"||!e.pauseFilePath?false:m.existsSync(e.pauseFilePath)}function jt(e){Z(e)&&m.unlinkSync(e.pauseFilePath);}async function le(e){if(e.storeType!=="file"||!e.pauseFilePath)throw new Error("[step-machine-cli] --pause requires --store file --store-dir <directory>.");let t=await Q(e.store);if(t.length===0){console.warn("[step-machine-cli] No runs found in store directory. Pause is a no-op."),console.log(JSON.stringify({status:"noop",reason:"no-runs"},null,2));return}if(!t.find(n=>n.status==="running")){console.warn("[step-machine-cli] No running run found. Pause is a no-op."),console.log(JSON.stringify({status:"noop",reason:"no-running-run"},null,2));return}m.mkdirSync(e.storeDir,{recursive:true}),m.writeFileSync(e.pauseFilePath,JSON.stringify({requestedAt:Date.now()}),"utf-8"),console.log(JSON.stringify({status:"pause-requested",storeDir:e.storeDir},null,2));}async function Ct(e){let r=(await Q(e.store)).filter(n=>n.status==="paused");if(r.length!==0)return r.length>1&&console.warn("[step-machine-cli] Multiple paused runs found; resuming the most recently updated run."),r[0].runId}async function pe(e,t){let r=await e.loadRunState(t);if(!r)return null;let n={...r,status:"paused",pausedAt:Date.now(),updatedAt:Date.now()};return await e.saveRunState(t,n),n}async function de(e){if(e.storeType!=="file")throw new Error("[step-machine-cli] --status requires --store file --store-dir <directory>.");let t=await Q(e.store),r={store:"file",storeDir:e.storeDir,pauseRequested:Z(e),totalRuns:t.length,runs:t.map(n=>({runId:n.runId,status:n.status,currentStep:n.currentStep,startedAt:n.startedAt,updatedAt:n.updatedAt,pausedAt:n.pausedAt}))};console.log(JSON.stringify(r,null,2));}function fe(e){if(e)try{let t=JSON.parse(e);if(!t||typeof t!="object"||Array.isArray(t))throw new Error("Initial data must be a JSON object.");return t}catch(t){let r=t instanceof Error?t.message:String(t);throw new Error(`[step-machine-cli] Invalid --initial-data value: ${r}`)}}function ge(e){if(!e||typeof e!="object")return e;let t=e;if(typeof t.whatToRun!="string"||!t.whatToRun.startsWith("b64:"))return e;try{let r=t.whatToRun.slice(4),n=r+"=".repeat((4-r.length%4)%4),s=Buffer.from(n.replace(/-/g,"+").replace(/_/g,"/"),"base64").toString("utf8"),o=JSON.parse(s);return !o||typeof o!="object"||typeof o.value!="string"?e:{...t,whatToRun:o}}catch{return e}}function me(e,t){return X(e,{invoke:(n,s)=>Et(ge(n),s,{cliDir:t,cwd:t})})}function he(){console.error("Usage: step-machine-cli <step-flow.yaml> [--initial-data <json>] [--store <memory|file>] [--store-dir <directory>] [--resume]"),console.error("       step-machine-cli --store file --store-dir <directory> --pause"),console.error("       step-machine-cli --store file --store-dir <directory> --status"),console.error(""),console.error("Example:"),console.error('  step-machine-cli examples/cli/step-machine-demo/two-step-math.flow.yaml --initial-data "{"a":3,"b":4}"'),console.error("  step-machine-cli ./flow.yaml --store file --store-dir ./.runs"),console.error("  step-machine-cli ./flow.yaml --store file --store-dir ./.runs --resume"),console.error("  step-machine-cli --store file --store-dir ./.runs --pause"),console.error("  step-machine-cli --store file --store-dir ./.runs --status");}
+export{B as CliExitError,Hr as cli};//# sourceMappingURL=step-machine-cli.js.map
+//# sourceMappingURL=step-machine-cli.js.map

package/{dist/board-live-cards-public-5n1-syA3.d.cts → cli/types-CziUxkiv.d.ts}

@@ -1,5 +1,5 @@
-import { ExecutionRef } from './execution-refs.cjs';
-import { L as LiveCard, B as BoardStatusObject, J as JournalStorageAdapter, O as OutputStoreEvent } from './board-live-cards-lib-Bg6EvCo5.cjs';
+import { E as ExecutionRef } from './execution-interface-C_A6WCiK.js';
+import { L as LiveCard, B as BoardStatusObject, J as JournalStorageAdapter, O as OutputStoreEvent } from './board-live-cards-lib-tjYsPt5U.js';
 
 /**
  * storage-interface.ts
@@ -266,6 +266,7 @@ interface BoardNonCorePlatformAdapter extends BoardPlatformAdapter {
      */
     invokeExecutorSync(ref: ExecutionRef, subcommand: string, args: string[], opts?: {
         timeout?: number;
+        input?: string;
     }): string;
     /** Schema-only card validator (no executor invocation). */
     validateSchema(card: Record<string, unknown>): {
@@ -284,8 +285,8 @@ interface BoardLiveCardsNonCorePublic {
         isValid: boolean;
         issues: string[];
     }>>;
-    /** body: { "card-content": <card> } — card JSON arrives via stdin */
-    validateTmpCard(input: CommandInput): CommandResult<{
+    /** body: { "card-content": <card> } — card JSON arrives via stdin; validates schema + JSONata + provides refs + source_defs (executor, if configured) */
+    validateCardPreflight(input: CommandInput): CommandResult<{
         cardId: string;
         isValid: boolean;
         issues: string[];
@@ -294,6 +295,20 @@ interface BoardLiveCardsNonCorePublic {
     probeSource(input: CommandInput): CommandResult;
     /** body: { sourceDef, mockProjections }; params: outRef? */
     probeTmpSource(input: CommandInput): CommandResult;
+    /** body: { "card-content": <card>, "mock-projections"?: {} }; params: sourceIdx, outRef? — card JSON arrives via stdin; no board state needed */
+    probeSourcePreflight(input: CommandInput): CommandResult;
+    /** body: { "card-content": <card>, "mock-fetched-sources"?: {}, "mock-requires"?: {} } — evaluates compute expressions with supplied data; no board state needed */
+    evalCardCompute(input: CommandInput): CommandResult<{
+        cardId: string;
+        ok: boolean;
+        computed_values: Record<string, unknown>;
+        errors: Array<{
+            bindTo: string;
+            error: string;
+        }>;
+    }>;
+    /** body: { "card-content": <card>, "mock-fetched-sources"?: {}, "mock-requires"?: {} } — full cycle: validate → resolve projections → probe sources → compute */
+    simulateCardCycle(input: CommandInput): CommandResult;
     /** no params needed */
     describeTaskExecutorCapabilities(input: CommandInput): CommandResult;
     /**
@@ -314,4 +329,52 @@ interface BoardLiveCardsNonCorePublic {
 }
 declare function createBoardLiveCardsNonCorePublic(baseRef: KindValueRef, adapter: BoardNonCorePlatformAdapter): BoardLiveCardsNonCorePublic;
 
-export { type BoardPlatformAdapter as B, type CommandInput as C, type KVStorage as K, type BlobStorage as a, type BoardChangeNotification as b, type BoardLiveCardsPublic as c, type CommandResult as d, type KindValueRef as e, type BoardNonCorePlatformAdapter as f, type BoardLiveCardsNonCorePublic as g, createBoardLiveCardsNonCorePublic as h, createBoardLiveCardsPublic as i, parseRef as p, serializeRef as s };
+/**
+ * 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.
+ */
+
+interface InvocationAdapter {
+    /**
+     * Fire-and-forget invocation of an ExecutionRef with args.
+     * Used for chat-handler dispatch, and potentially task-executor / inference-adapter.
+     * Returns a promise that resolves when the invocation is dispatched (not completed).
+     */
+    invoke(ref: ExecutionRef, args: Record<string, unknown>): Promise<{
+        dispatched: boolean;
+        error?: string;
+    }>;
+    /**
+     * Optional synchronous describe call — asks the target to identify itself.
+     * Used for pre-init validation (e.g. confirming a chat-handler reports kind='chat-handler').
+     * Hosts that pre-register capabilities at deploy time may omit this.
+     */
+    describe?(ref: ExecutionRef): Promise<DescribeEnvelope | null>;
+}
+interface NotificationTransport {
+    /**
+     * Start listening for events on a notification endpoint identified by a kind-ref.
+     * The ref kind determines the transport mechanism:
+     *   ::named-pipe::/tmp/board-x.sock
+     *   ::firestore-watch::collections/board-x/notifications
+     *   ::signalr::https://x.service.signalr.net/hub/board-x
+     * onEvent is called with parsed JSON notification objects.
+     * Returns a teardown function.
+     */
+    subscribe(ref: KindValueRef, onEvent: (event: unknown) => void): Promise<() => void>;
+}
+interface DescribeEnvelope {
+    name: string;
+    kind: 'task-executor' | 'chat-handler' | 'inference-adapter';
+    protocolVersion: string;
+    supports?: string[];
+}
+
+export { type BoardPlatformAdapter as B, type CommandInput as C, type DescribeEnvelope as D, type InvocationAdapter as I, type KindValueRef as K, type NotificationTransport as N, type CommandResult as a, type BlobStorage as b, type BoardNonCorePlatformAdapter as c, type BoardLiveCardsNonCorePublic as d, type BoardLiveCardsPublic as e, createBoardLiveCardsNonCorePublic as f, createBoardLiveCardsPublic as g, parseRef as p, serializeRef as s };

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.config/card-store-ref.json

@@ -0,0 +1 @@
+"b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvLmRlbW8tc2V0dXAvcnVuLTE3Nzg2NDM3MDMxNTEtMzM2MC1kb3BucHYvYm9hcmQtZGVmYXVsdC9nYW5kYWxmLXJ1bnRpbWUvY2FyZHMvc3RvcmUifQ"

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.config/chat-handler.json

@@ -0,0 +1 @@
+"{\"howToRun\":\"local-node\",\"whatToRun\":\"b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvZGVtby1jaGF0LWhhbmRsZXIuanMifQ\",\"meta\":\"chat-handler\"}"

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.config/outputs-store-ref.json

@@ -0,0 +1 @@
+"b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvLmRlbW8tc2V0dXAvcnVuLTE3Nzg2NDM3MDMxNTEtMzM2MC1kb3BucHYvYm9hcmQtZGVmYXVsdC9nYW5kYWxmLXJ1bnRpbWUtb3V0Ly5vdXRwdXRzIn0"

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.config/task-executor.json

@@ -0,0 +1 @@
+"{\"howToRun\":\"local-node\",\"whatToRun\":\"b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvZGVtby10YXNrLWV4ZWN1dG9yLmpzIn0\",\"meta\":\"task-executor\"}"

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.state-snapshot/board/graph.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "config": {
+    "settings": {
+      "completion": "manual",
+      "refreshStrategy": "data-changed"
+    },
+    "tasks": {}
+  },
+  "state": {
+    "status": "running",
+    "tasks": {},
+    "availableOutputs": [],
+    "stuckDetection": {
+      "is_stuck": false,
+      "stuck_description": null,
+      "outputs_unresolvable": [],
+      "tasks_blocked": []
+    },
+    "lastUpdated": "2026-05-13T03:41:43.304Z",
+    "executionId": "live-1778643703304",
+    "executionConfig": {
+      "executionMode": "eligibility-mode",
+      "conflictStrategy": "alphabetical",
+      "completionStrategy": "manual"
+    }
+  },
+  "snapshotAt": "2026-05-13T03:41:43.304Z"
+}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime/.state-snapshot/board/lastJournalProcessedId.json

@@ -0,0 +1 @@
+""

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/gandalf-runtime-out/.outputs/status.json

@@ -0,0 +1,25 @@
+{
+  "schema_version": "v1",
+  "meta": {
+    "board": {
+      "path": "b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvLmRlbW8tc2V0dXAvcnVuLTE3Nzg2NDM3MDMxNTEtMzM2MC1kb3BucHYvYm9hcmQtZGVmYXVsdC9nYW5kYWxmLXJ1bnRpbWUifQ"
+    }
+  },
+  "summary": {
+    "card_count": 0,
+    "completed": 0,
+    "eligible": 0,
+    "pending": 0,
+    "blocked": 0,
+    "unresolved": 0,
+    "failed": 0,
+    "in_progress": 0,
+    "orphan_cards": 0,
+    "topology": {
+      "edge_count": 0,
+      "max_fan_out_card": null,
+      "max_fan_out": 0
+    }
+  },
+  "cards": []
+}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/cards/card-market-prices/computed_values.json

@@ -0,0 +1,67 @@
+{
+  "normalizedQuotes": {
+    "quoteResponse": {
+      "result": [
+        {
+          "symbol": "AAPL",
+          "shortName": "Apple Inc.",
+          "regularMarketPrice": 294.8,
+          "regularMarketChange": 2.1200000000000045,
+          "regularMarketChangePercent": 0.7243405767391022
+        },
+        {
+          "symbol": "NVDA",
+          "shortName": "NVIDIA Corporation",
+          "regularMarketPrice": 220.78,
+          "regularMarketChange": 1.3400000000000034,
+          "regularMarketChangePercent": 0.6106452788917259
+        },
+        {
+          "symbol": "GOOG",
+          "shortName": "Alphabet Inc.",
+          "regularMarketPrice": 383.82,
+          "regularMarketChange": -2.9499999999999886,
+          "regularMarketChangePercent": -0.7627272022131987
+        },
+        {
+          "symbol": "MSFT",
+          "shortName": "Microsoft Corporation",
+          "regularMarketPrice": 407.77,
+          "regularMarketChange": -4.890000000000043,
+          "regularMarketChangePercent": -1.1849949110648095
+        }
+      ],
+      "error": null
+    }
+  },
+  "prices": [
+    {
+      "ticker": "AAPL",
+      "name": "Apple Inc.",
+      "price": 294.8,
+      "change": 2.12,
+      "chg_pct": 0.72
+    },
+    {
+      "ticker": "NVDA",
+      "name": "NVIDIA Corporation",
+      "price": 220.78,
+      "change": 1.34,
+      "chg_pct": 0.61
+    },
+    {
+      "ticker": "GOOG",
+      "name": "Alphabet Inc.",
+      "price": 383.82,
+      "change": -2.95,
+      "chg_pct": -0.76
+    },
+    {
+      "ticker": "MSFT",
+      "name": "Microsoft Corporation",
+      "price": 407.77,
+      "change": -4.89,
+      "chg_pct": -1.18
+    }
+  ]
+}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/cards/card-portfolio/computed_values.json

@@ -0,0 +1 @@
+{}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/cards/card-portfolio-value/computed_values.json

@@ -0,0 +1,52 @@
+{
+  "positions": [
+    {
+      "ticker": "AAPL",
+      "quantity": 10,
+      "cost_basis": 150,
+      "price": 294.8,
+      "value": 2948,
+      "gain_$": 1448,
+      "gain_%": 96.53,
+      "chg_$": 21.2,
+      "chg_pct": 0.72
+    },
+    {
+      "ticker": "NVDA",
+      "quantity": 5,
+      "cost_basis": 310,
+      "price": 220.78,
+      "value": 1103.9,
+      "gain_$": -446.1,
+      "gain_%": -28.78,
+      "chg_$": 6.7,
+      "chg_pct": 0.61
+    },
+    {
+      "ticker": "GOOG",
+      "quantity": 3,
+      "cost_basis": 33,
+      "price": 383.82,
+      "value": 1151.46,
+      "gain_$": 1052.46,
+      "gain_%": 1063.09,
+      "chg_$": -8.85,
+      "chg_pct": -0.76
+    },
+    {
+      "ticker": "MSFT",
+      "quantity": 1,
+      "cost_basis": 100,
+      "price": 407.77,
+      "value": 407.77,
+      "gain_$": 307.77,
+      "gain_%": 307.77,
+      "chg_$": -4.89,
+      "chg_pct": -1.18
+    }
+  ],
+  "totalValue": 5611.13,
+  "gainers": 2,
+  "losers": 2,
+  "gainersLosers": "2 up · 2 down"
+}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/data-objects/holdings.json

@@ -0,0 +1,22 @@
+[
+  {
+    "ticker": "AAPL",
+    "quantity": 10,
+    "cost_basis": 150
+  },
+  {
+    "ticker": "NVDA",
+    "quantity": 5,
+    "cost_basis": 310
+  },
+  {
+    "ticker": "GOOG",
+    "quantity": 3,
+    "cost_basis": 33
+  },
+  {
+    "ticker": "MSFT",
+    "quantity": 1,
+    "cost_basis": 100
+  }
+]

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/data-objects/positions.json

@@ -0,0 +1,46 @@
+[
+  {
+    "ticker": "AAPL",
+    "quantity": 10,
+    "cost_basis": 150,
+    "price": 294.8,
+    "value": 2948,
+    "gain_$": 1448,
+    "gain_%": 96.53,
+    "chg_$": 21.2,
+    "chg_pct": 0.72
+  },
+  {
+    "ticker": "NVDA",
+    "quantity": 5,
+    "cost_basis": 310,
+    "price": 220.78,
+    "value": 1103.9,
+    "gain_$": -446.1,
+    "gain_%": -28.78,
+    "chg_$": 6.7,
+    "chg_pct": 0.61
+  },
+  {
+    "ticker": "GOOG",
+    "quantity": 3,
+    "cost_basis": 33,
+    "price": 383.82,
+    "value": 1151.46,
+    "gain_$": 1052.46,
+    "gain_%": 1063.09,
+    "chg_$": -8.85,
+    "chg_pct": -0.76
+  },
+  {
+    "ticker": "MSFT",
+    "quantity": 1,
+    "cost_basis": 100,
+    "price": 407.77,
+    "value": 407.77,
+    "gain_$": 307.77,
+    "gain_%": 307.77,
+    "chg_$": -4.89,
+    "chg_pct": -1.18
+  }
+]

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/data-objects/quotes.json

@@ -0,0 +1,35 @@
+{
+  "quoteResponse": {
+    "result": [
+      {
+        "symbol": "AAPL",
+        "shortName": "Apple Inc.",
+        "regularMarketPrice": 294.8,
+        "regularMarketChange": 2.1200000000000045,
+        "regularMarketChangePercent": 0.7243405767391022
+      },
+      {
+        "symbol": "NVDA",
+        "shortName": "NVIDIA Corporation",
+        "regularMarketPrice": 220.78,
+        "regularMarketChange": 1.3400000000000034,
+        "regularMarketChangePercent": 0.6106452788917259
+      },
+      {
+        "symbol": "GOOG",
+        "shortName": "Alphabet Inc.",
+        "regularMarketPrice": 383.82,
+        "regularMarketChange": -2.9499999999999886,
+        "regularMarketChangePercent": -0.7627272022131987
+      },
+      {
+        "symbol": "MSFT",
+        "shortName": "Microsoft Corporation",
+        "regularMarketPrice": 407.77,
+        "regularMarketChange": -4.890000000000043,
+        "regularMarketChangePercent": -1.1849949110648095
+      }
+    ],
+    "error": null
+  }
+}

package/examples/board/.demo-setup/run-1778643703151-3360-dopnpv/board-default/runtime-out/.outputs/status.json

@@ -0,0 +1,113 @@
+{
+  "schema_version": "v1",
+  "meta": {
+    "board": {
+      "path": "b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiL2hvbWUvcnVubmVyL3dvcmsveWFtbC1mbG93L3lhbWwtZmxvdy9wdWJsaWMtZXhhbXBsZXMvYm9hcmQvLmRlbW8tc2V0dXAvcnVuLTE3Nzg2NDM3MDMxNTEtMzM2MC1kb3BucHYvYm9hcmQtZGVmYXVsdC9ydW50aW1lIn0"
+    }
+  },
+  "summary": {
+    "card_count": 3,
+    "completed": 3,
+    "eligible": 0,
+    "pending": 0,
+    "blocked": 0,
+    "unresolved": 0,
+    "failed": 0,
+    "in_progress": 0,
+    "orphan_cards": 0,
+    "topology": {
+      "edge_count": 2,
+      "max_fan_out_card": "card-portfolio",
+      "max_fan_out": 2
+    }
+  },
+  "cards": [
+    {
+      "name": "card-market-prices",
+      "status": "completed",
+      "requires": [
+        "holdings"
+      ],
+      "requires_satisfied": [
+        "holdings"
+      ],
+      "requires_missing": [],
+      "provides_declared": [
+        "quotes"
+      ],
+      "provides_runtime": [
+        "quotes"
+      ],
+      "blocked_by": [],
+      "unblocks": [
+        "card-portfolio-value"
+      ],
+      "runtime": {
+        "attempt_count": 2,
+        "restart_count": 0,
+        "in_progress_since": null,
+        "last_transition_at": "2026-05-13T03:41:45.494Z",
+        "last_completed_at": "2026-05-13T03:41:45.494Z",
+        "last_restarted_at": "2026-05-13T03:41:44.720Z",
+        "status_age_ms": 0
+      }
+    },
+    {
+      "name": "card-portfolio",
+      "status": "completed",
+      "requires": [],
+      "requires_satisfied": [],
+      "requires_missing": [],
+      "provides_declared": [
+        "holdings"
+      ],
+      "provides_runtime": [
+        "holdings"
+      ],
+      "blocked_by": [],
+      "unblocks": [
+        "card-market-prices",
+        "card-portfolio-value"
+      ],
+      "runtime": {
+        "attempt_count": 2,
+        "restart_count": 0,
+        "in_progress_since": null,
+        "last_transition_at": "2026-05-13T03:41:44.713Z",
+        "last_completed_at": "2026-05-13T03:41:44.713Z",
+        "last_restarted_at": "2026-05-13T03:41:44.712Z",
+        "status_age_ms": 0
+      }
+    },
+    {
+      "name": "card-portfolio-value",
+      "status": "completed",
+      "requires": [
+        "holdings",
+        "quotes"
+      ],
+      "requires_satisfied": [
+        "holdings",
+        "quotes"
+      ],
+      "requires_missing": [],
+      "provides_declared": [
+        "positions"
+      ],
+      "provides_runtime": [
+        "positions"
+      ],
+      "blocked_by": [],
+      "unblocks": [],
+      "runtime": {
+        "attempt_count": 3,
+        "restart_count": 0,
+        "in_progress_since": null,
+        "last_transition_at": "2026-05-13T03:41:45.498Z",
+        "last_completed_at": "2026-05-13T03:41:45.498Z",
+        "last_restarted_at": "2026-05-13T03:41:45.498Z",
+        "status_age_ms": 0
+      }
+    }
+  ]
+}

package/examples/{example-board → board}/demo-server-config.json

@@ -1,6 +1,5 @@
 {
   "port": 7799,
-  "serverMetaStoreRef": "b64:eyJraW5kIjoiZnMtcGF0aCIsInZhbHVlIjoiLi8uc2VydmVyLW1ldGEifQ",
   "cardsDir": "./cards",
   "taskExecutorPath": "./demo-task-executor.js",
   "chatHandlerPath": "./demo-chat-handler.js",