yaml-flow 7.0.0 → 8.0.0

package/lib/server-runtime/index.js

@@ -0,0 +1,9 @@
+import {createRequire}from'module';import'ajv-formats';var Bt="b64:";function Qe(t){let e=new TextEncoder().encode(t),n=globalThis.Buffer,r;if(n)r=n.from(e).toString("base64");else if(typeof btoa=="function"){let o="";for(let s of e)o+=String.fromCharCode(s);r=btoa(o);}else throw new Error("No base64 encoder available in this runtime");return r.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}function Ze(t){let e=t.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-t.length%4)%4),n=globalThis.Buffer;if(n)return n.from(e,"base64").toString("utf8");if(typeof atob=="function"){let r=atob(e),o=new Uint8Array(r.length);for(let s=0;s<r.length;s+=1)o[s]=r.charCodeAt(s);return new TextDecoder().decode(o)}throw new Error("No base64 decoder available in this runtime")}function ht(t){return `${Bt}${Qe(JSON.stringify(t))}`}function ae(t){if(!t.startsWith(Bt))throw new Error(`Invalid ref format (expected ${Bt}<base64url(json)>): ${t}`);let e;try{e=JSON.parse(Ze(t.slice(Bt.length)));}catch{throw new Error(`Invalid ref format (malformed base64url/json): ${t}`)}if(!e||typeof e!="object")throw new Error(`Invalid ref format (expected object payload): ${t}`);let n=e;if(typeof n.kind!="string"||typeof n.value!="string")throw new Error(`Invalid ref format (payload must contain string kind/value): ${t}`);return {kind:n.kind,value:n.value}}async function ie(t,e,n){let r=t.tryAcquire();if(!r)return  false;try{await e();}finally{r();}return n?.(),true}var yt={RUNNING:"running",COMPLETED:"completed",FAILED:"failed",INACTIVATED:"inactivated"};function ot(t){return t?Array.isArray(t.provides)?t.provides:[]:[]}function kt(t){return t?Array.isArray(t.requires)?t.requires:[]:[]}function ue(t){return t.tasks??{}}function Yt(t){return t?t.status===yt.FAILED||t.status===yt.INACTIVATED:false}function ce(t,e){return t.refreshStrategy??e?.refreshStrategy??"data-changed"}function de(t){return t.maxExecutions}function le(t,e){let n=new Set;for(let[r,o]of Object.entries(e))if(o.status===yt.COMPLETED){let s=t.tasks[r];s&&ot(s).forEach(u=>n.add(u));}return Array.from(n)}function fe(t,e){let n={};return t.forEach(r=>{let o=e[r];if(!o)return;ot(o).forEach(i=>{n[i]||(n[i]=[]),n[i].push(r);});}),n}function pe(t,e,n){let r=t.tasks[e]??Pt(),o={};if(n){let i=n.tasks[e],u=kt(i);for(let f of u)for(let[x,D]of Object.entries(n.tasks))if(ot(D).includes(f)){let C=t.tasks[x];C?.lastDataHash&&(o[f]=C.lastDataHash);break}}let s={...r,status:"running",startedAt:new Date().toISOString(),lastUpdated:new Date().toISOString(),progress:0,error:void 0,startConsumedHashes:o};return {...t,tasks:{...t.tasks,[e]:s},lastUpdated:new Date().toISOString()}}function ge(t,e,n,r,o,s){let i=t.tasks[n]??Pt(),u=e.tasks[n];if(!u)throw new Error(`Task "${n}" not found in graph`);let f;r&&u.on&&u.on[r]?f=u.on[r]:f=ot(u);let x=i.startConsumedHashes?{...i.startConsumedHashes}:{...i.lastConsumedHashes};if(!i.startConsumedHashes){let j=u.requires??[];for(let w of j)for(let[g,y]of Object.entries(e.tasks))if(ot(y).includes(w)){let v=t.tasks[g];v?.lastDataHash&&(x[w]=v.lastDataHash);break}}let D={...i,status:"completed",completedAt:new Date().toISOString(),lastUpdated:new Date().toISOString(),executionCount:i.executionCount+1,lastEpoch:i.executionCount+1,lastDataHash:o,data:s,lastConsumedHashes:x,error:void 0},C=[...new Set([...t.availableOutputs,...f])];return {...t,tasks:{...t.tasks,[n]:D},availableOutputs:C,lastUpdated:new Date().toISOString()}}function me(t,e,n,r){let o=t.tasks[n]??Pt(),s=e.tasks[n];if(s?.retry){let f=o.retryCount+1;if(f<=s.retry.max_attempts){let x={...o,status:"not-started",retryCount:f,lastUpdated:new Date().toISOString(),error:r};return {...t,tasks:{...t.tasks,[n]:x},lastUpdated:new Date().toISOString()}}}let i={...o,status:"failed",failedAt:new Date().toISOString(),lastUpdated:new Date().toISOString(),error:r,executionCount:o.executionCount+1},u=t.availableOutputs;if(s?.on_failure&&s.on_failure.length>0&&(u=[...new Set([...t.availableOutputs,...s.on_failure])]),s?.circuit_breaker&&i.executionCount>=s.circuit_breaker.max_executions){let f=s.circuit_breaker.on_break;u=[...new Set([...u,...f])];}return {...t,tasks:{...t.tasks,[n]:i},availableOutputs:u,lastUpdated:new Date().toISOString()}}function he(t,e,n,r){let o=t.tasks[e]??Pt(),s={...o,progress:typeof r=="number"?r:o.progress,messages:[...o.messages??[],...n?[{message:n,timestamp:new Date().toISOString(),status:o.status}]:[]],lastUpdated:new Date().toISOString()};return {...t,tasks:{...t.tasks,[e]:s},lastUpdated:new Date().toISOString()}}function ye(t,e){let n=t.tasks[e];if(!n)return t;let r={...n,status:"not-started",startedAt:void 0,completedAt:void 0,failedAt:void 0,error:void 0,data:void 0,progress:null,lastUpdated:new Date().toISOString()};return {...t,tasks:{...t.tasks,[e]:r},lastUpdated:new Date().toISOString()}}function Pt(){return {status:"not-started",executionCount:0,retryCount:0,lastEpoch:0,messages:[],progress:null}}function Lt(t,e){let n=`live-${Date.now()}`,r={};for(let s of Object.keys(t.tasks))r[s]=Se();let o={status:"running",tasks:r,availableOutputs:[],stuckDetection:{is_stuck:false,stuck_description:null,outputs_unresolvable:[],tasks_blocked:[]},lastUpdated:new Date().toISOString(),executionId:n,executionConfig:{executionMode:t.settings.execution_mode??"eligibility-mode",conflictStrategy:t.settings.conflict_strategy??"alphabetical",completionStrategy:t.settings.completion}};return {config:t,state:o}}function tn(t,e){let{config:n,state:r}=t;if("executionId"in e&&e.executionId&&e.executionId!==r.executionId)return t;switch(e.type){case "task-started":return {config:n,state:pe(r,e.taskName,n)};case "task-completed":return {config:n,state:ge(r,n,e.taskName,e.result,e.dataHash,e.data)};case "task-failed":return {config:n,state:me(r,n,e.taskName,e.error)};case "task-progress":return {config:n,state:he(r,e.taskName,e.message,e.progress)};case "task-restart":return {config:n,state:ye(r,e.taskName)};case "inject-tokens":return {config:n,state:{...r,availableOutputs:[...new Set([...r.availableOutputs,...e.tokens])],lastUpdated:new Date().toISOString()}};case "agent-action":return {config:n,state:un(r,e.action)};case "task-upsert":return en(t,e.taskName,e.taskConfig);case "task-removal":return nn(t,e.taskName);case "node-requires-add":return rn(t,e.nodeName,e.tokens);case "node-requires-remove":return on(t,e.nodeName,e.tokens);case "node-provides-add":return sn(t,e.nodeName,e.tokens);case "node-provides-remove":return an(t,e.nodeName,e.tokens);default:return t}}function ke(t,e){return e.reduce((n,r)=>tn(n,r),t)}function en(t,e,n){let r=!!t.config.tasks[e];return {config:{...t.config,tasks:{...t.config.tasks,[e]:n}},state:{...t.state,tasks:{...t.state.tasks,[e]:r?t.state.tasks[e]:Se()},lastUpdated:new Date().toISOString()}}}function nn(t,e){if(!t.config.tasks[e])return t;let{[e]:n,...r}=t.config.tasks,{[e]:o,...s}=t.state.tasks;return {config:{...t.config,tasks:r},state:{...t.state,tasks:s,lastUpdated:new Date().toISOString()}}}function rn(t,e,n){let r=t.config.tasks[e];if(!r)return t;let o=kt(r),s=n.filter(i=>!o.includes(i));return s.length===0?t:{config:{...t.config,tasks:{...t.config.tasks,[e]:{...r,requires:[...o,...s]}}},state:t.state}}function on(t,e,n){let r=t.config.tasks[e];if(!r)return t;let o=kt(r),s=o.filter(i=>!n.includes(i));return s.length===o.length?t:{config:{...t.config,tasks:{...t.config.tasks,[e]:{...r,requires:s}}},state:t.state}}function sn(t,e,n){let r=t.config.tasks[e];if(!r)return t;let o=ot(r),s=n.filter(i=>!o.includes(i));return s.length===0?t:{config:{...t.config,tasks:{...t.config.tasks,[e]:{...r,provides:[...o,...s]}}},state:t.state}}function an(t,e,n){let r=t.config.tasks[e];if(!r)return t;let o=ot(r),s=o.filter(i=>!n.includes(i));return s.length===o.length?t:{config:{...t.config,tasks:{...t.config.tasks,[e]:{...r,provides:s}}},state:t.state}}function Tt(t){return {version:1,config:t.config,state:t.state,snapshotAt:new Date().toISOString()}}function qt(t){if(!t||typeof t!="object")throw new Error("Invalid snapshot: expected an object");let e=t;if(!e.config||typeof e.config!="object")throw new Error('Invalid snapshot: missing or invalid "config"');if(!e.state||typeof e.state!="object")throw new Error('Invalid snapshot: missing or invalid "state"');let n=e.config,r=e.state;if(!n.settings||typeof n.settings!="object")throw new Error("Invalid snapshot: config.settings missing");if(!n.tasks||typeof n.tasks!="object")throw new Error("Invalid snapshot: config.tasks missing");if(!r.tasks||typeof r.tasks!="object")throw new Error("Invalid snapshot: state.tasks missing");if(!Array.isArray(r.availableOutputs))throw new Error("Invalid snapshot: state.availableOutputs must be an array");return {config:n,state:r}}function Se(){return {status:"not-started",executionCount:0,retryCount:0,lastEpoch:0,messages:[],progress:null}}function un(t,e){let n=new Date().toISOString();switch(e){case "stop":return {...t,status:"stopped",lastUpdated:n};case "pause":return {...t,status:"paused",lastUpdated:n};case "resume":return {...t,status:"running",lastUpdated:n};default:return t}}function It(t){let{config:e,state:n}=t,r=ue(e);if(Object.keys(r).length===0)return {eligible:[],pending:[],unresolved:[],blocked:[],conflicts:{}};let s=cn(r),i=le(e,n.tasks),u=new Set([...i,...n.availableOutputs]),f=[],x=[],D=[],C=[];for(let[w,g]of Object.entries(r)){let y=n.tasks[w],v=ce(g,e.settings),E=v!=="once";if(y?.status===yt.RUNNING||Yt(y))continue;let m=de(g);if(m!==void 0&&y&&y.executionCount>=m||g.circuit_breaker&&y&&y.executionCount>=g.circuit_breaker.max_executions||!E&&y?.status===yt.COMPLETED)continue;if(E&&y?.status===yt.COMPLETED){let T=kt(g),N=false;switch(v){case "data-changed":{T.length>0&&T.some(M=>{for(let[K,X]of Object.entries(r))if(ot(X).includes(M)){let W=n.tasks[K];if(!W)continue;let St=y.lastConsumedHashes?.[M];return W.lastDataHash==null?W.executionCount>y.lastEpoch:W.lastDataHash!==St}return  false})||(N=true);break}case "epoch-changed":{T.length>0&&T.some(M=>{for(let[K,X]of Object.entries(r))if(ot(X).includes(M)){let W=n.tasks[K];if(W&&W.executionCount>y.lastEpoch)return  true}return  false})||(N=true);break}case "time-based":{let U=g.refreshInterval??0;if(U<=0){N=true;break}let M=y.completedAt;if(!M){N=true;break}(Date.now()-Date.parse(M))/1e3<U&&(N=true);break}case "manual":N=true;break}if(N)continue}let A=kt(g);if(A.length===0){f.push(w);continue}let B=[],q=[],G=[];for(let T of A){if(u.has(T))continue;let N=s[T]||[];N.length===0?B.push(T):N.every(M=>Yt(n.tasks[M]))?G.push({token:T,failedProducer:N[0]}):q.push(T);}B.length>0?D.push({taskName:w,missingTokens:B}):G.length>0?C.push({taskName:w,failedTokens:G.map(T=>T.token),failedProducers:[...new Set(G.map(T=>T.failedProducer))]}):q.length>0?x.push({taskName:w,waitingOn:q}):f.push(w);}let j={};if(f.length>1){let w=fe(f,r);for(let[g,y]of Object.entries(w))y.length>1&&(j[g]=y);}return {eligible:f,pending:x,unresolved:D,blocked:C,conflicts:j}}function cn(t){let e={};for(let[n,r]of Object.entries(t)){for(let o of ot(r))e[o]||(e[o]=[]),e[o].push(n);if(r.on)for(let o of Object.values(r.on))for(let s of o)e[s]||(e[s]=[]),e[s].includes(n)||e[s].push(n);if(r.on_failure)for(let o of r.on_failure)e[o]||(e[o]=[]),e[o].includes(n)||e[o].push(n);}return e}var Ot=class{buffer=[];append(e){this.buffer.push(e);}drain(){let e=this.buffer;return this.buffer=[],e}get size(){return this.buffer.length}};function Xt(t){let e=Wt(t);return dn(e)}function Wt(t){if(t==null||typeof t!="object")return JSON.stringify(t);if(Array.isArray(t))return "["+t.map(Wt).join(",")+"]";let e=t;return "{"+Object.keys(e).sort().map(r=>JSON.stringify(r)+":"+Wt(e[r])).join(",")+"}"}function dn(t){let e=0xcbf29ce484222325n,n=0x100000001b3n,r=0xffffffffffffffffn;for(let o=0;o<t.length;o++)e^=BigInt(t.charCodeAt(o)),e=e*n&r;return e.toString(16).padStart(16,"0")}function ln(t){if(typeof Buffer<"u")return Buffer.from(t,"utf8").toString("base64url");if(typeof btoa=="function"){let e=new TextEncoder().encode(t),n="";for(let r of e)n+=String.fromCharCode(r);return btoa(n).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}throw new Error("No base64 encoder available in this runtime")}function fn(t){if(typeof Buffer<"u")return Buffer.from(t,"base64url").toString("utf8");if(typeof atob=="function"){let e=t.replace(/-/g,"+").replace(/_/g,"/"),n=e+"=".repeat((4-e.length%4)%4),r=atob(n),o=new Uint8Array(r.length);for(let s=0;s<r.length;s++)o[s]=r.charCodeAt(s);return new TextDecoder().decode(o)}throw new Error("No base64 decoder available in this runtime")}function Re(t){let e=JSON.stringify({t,n:Date.now().toString(36)+Math.random().toString(36).slice(2,6)});return ln(e)}function pn(t){try{let e=JSON.parse(fn(t));return typeof e?.t=="string"?{taskName:e.t}:null}catch{return null}}function Ce(t,e,n){let{handlers:r,onDrain:o}=e,s=new Ot,i="state"in t&&"config"in t?t:Lt(t),u=false,f=new Set,x=new Map(Object.entries(r)),D=new Ot,C=false,j=false;function w(){if(!u){if(C){j=true;return}C=true;try{do j=!1,g();while(j)}finally{C=false;}}}function g(){let m=D.drain(),A=s.drain(),B=[...m,...A];B.length>0&&(i=ke(i,B));let q=It(i);B.length>0&&o?.(B,i,q);for(let G of q.eligible)E(G);for(let G of B)if(G.type==="task-progress"){let{taskName:T,update:N}=G;if(!i.config.tasks[T])continue;let M=i.state.tasks[T];if(!M||M.status!=="running")continue;let K=Re(T),X=v(T,K,N).catch(W=>{u||(D.append({type:"task-failed",taskName:T,error:W.message??String(W),timestamp:new Date().toISOString()}),w());}).finally(()=>{f.delete(X);});f.add(X);}}function y(m){let B=i.config.tasks[m].requires??[],q=new Map;for(let[T,N]of Object.entries(i.config.tasks))for(let U of N.provides??[])q.set(U,T);let G={};for(let T of B){let N=q.get(T);N?G[T]=i.state.tasks[N]?.data:G[T]=void 0;}return G}async function v(m,A,B){let q=i.config.tasks[m],G=q.taskHandlers??[],T=y(m);for(let N of G){let U=x.get(N);if(!U)throw new Error(`Handler '${N}' not found in registry (task '${m}')`);let M={nodeId:m,state:T,taskState:i.state.tasks[m],config:q,callbackToken:A,update:B};if(await U(M)==="task-initiate-failure")throw new Error(`Handler '${N}' returned task-initiate-failure (task '${m}')`)}}function E(m){let B=i.config.tasks[m]?.taskHandlers;if(!B||B.length===0)return;D.append({type:"task-started",taskName:m,timestamp:new Date().toISOString()}),w();let q=Re(m),G=v(m,q).catch(T=>{u||(D.append({type:"task-failed",taskName:m,error:T.message??String(T),timestamp:new Date().toISOString()}),w());}).finally(()=>{f.delete(G);});f.add(G);}return {push(m){u||(m.type==="task-completed"&&m.data&&!m.dataHash&&(m={...m,dataHash:Xt(m.data)}),s.append(m),w());},pushAll(m){if(!u){for(let A of m)A.type==="task-completed"&&A.data&&!A.dataHash?s.append({...A,dataHash:Xt(A.data)}):s.append(A);w();}},resolveCallback(m,A,B){if(u)return;let q=pn(m);if(!q)return;let{taskName:G}=q;if(i.config.tasks[G]){if(B&&B.length>0)s.append({type:"task-failed",taskName:G,error:B.join("; "),timestamp:new Date().toISOString()});else {let T=A&&Object.keys(A).length>0?Xt(A):void 0;s.append({type:"task-completed",taskName:G,data:A,dataHash:T,timestamp:new Date().toISOString()});}w();}},addNode(m,A){u||(s.append({type:"task-upsert",taskName:m,taskConfig:A,timestamp:new Date().toISOString()}),w());},removeNode(m){u||(s.append({type:"task-removal",taskName:m,timestamp:new Date().toISOString()}),w());},addRequires(m,A){u||(s.append({type:"node-requires-add",nodeName:m,tokens:A,timestamp:new Date().toISOString()}),w());},removeRequires(m,A){u||(s.append({type:"node-requires-remove",nodeName:m,tokens:A,timestamp:new Date().toISOString()}),w());},addProvides(m,A){u||(s.append({type:"node-provides-add",nodeName:m,tokens:A,timestamp:new Date().toISOString()}),w());},removeProvides(m,A){u||(s.append({type:"node-provides-remove",nodeName:m,tokens:A,timestamp:new Date().toISOString()}),w());},registerHandler(m,A){x.set(m,A);},unregisterHandler(m){x.delete(m);},retrigger(m){u||i.config.tasks[m]&&(s.append({type:"task-restart",taskName:m,timestamp:new Date().toISOString()}),w());},retriggerAll(m){if(!u){for(let A of m)i.config.tasks[A]&&s.append({type:"task-restart",taskName:A,timestamp:new Date().toISOString()});w();}},snapshot(){return Tt(i)},getState(){return i},getSchedule(){return It(i)},async waitForHandlers(){f.size>0&&await Promise.allSettled([...f]);},async dispose(m){m?.wait&&f.size>0&&await Promise.allSettled([...f]),u=true;}}}var mn=createRequire(import.meta.url);mn("./jsonata-sync.cjs");var yn=createRequire(import.meta.url),Gt=yn("./jsonata-sync.cjs"),ve=Gt;function be(t,e){if(!e||!t)return;let n=e.split("."),r=t;for(let o=0;o<n.length;o++){if(r==null)return;r=r[n[o]];}return r}function xe(t,e,n){let r=e.split("."),o=t;for(let s=0;s<r.length-1;s++)(o[r[s]]==null||typeof o[r[s]]!="object")&&(o[r[s]]={}),o=o[r[s]];o[r[r.length-1]]=n;}async function kn(t,e){if(!t?.compute?.length)return t;t.card_data||(t.card_data={}),t.computed_values={},t._sourcesData=e?.sourcesData??{};let n=t.requires??{},r={card_data:t.card_data,requires:n,expects_data:n,fetched_sources:t._sourcesData,data:t.computed_values,computed_values:t.computed_values};for(let o of t.compute)try{let s=await Gt(o.expr).evaluate(r);xe(t.computed_values,o.bindTo,s),r.computed_values=t.computed_values;}catch{}return t}function Sn(t,e){if(!t?.compute?.length)return {ok:true,node:t};t.card_data||(t.card_data={}),t.computed_values={},t._sourcesData=e?.sourcesData??{};let n=t.requires??{},r={card_data:t.card_data,requires:n,expects_data:n,fetched_sources:t._sourcesData,data:t.computed_values,computed_values:t.computed_values},o=[];for(let s of t.compute)try{let i=ve(s.expr).evaluate(r);xe(t.computed_values,s.bindTo,i),r.computed_values=t.computed_values;}catch(i){let u=i instanceof Error?i.message:String(i);o.push({bindTo:s.bindTo,error:u});}return o.length>0?{ok:true,node:t,errors:o}:{ok:true,node:t}}async function Rn(t,e,n){let r={...n??{},card_data:e.card_data??{},requires:e.requires??{},fetched_sources:e._sourcesData??{},computed_values:e.computed_values??{}};return Gt(t).evaluate(r)}function Cn(t,e){return e.startsWith("fetched_sources.")?be(t._sourcesData??{},e.slice(16)):be(t,e)}var we=new Set(["metric","table","editable-table","chart","form","filter","list","notes","todo","alert","narrative","badge","text","markdown","ref","custom","actions"]),bn=new Set(["id","meta","requires","provides","view","card_data","compute","source_defs"]);function wn(t){let e=[];if(!t||typeof t!="object"||Array.isArray(t))return {ok:false,errors:["Node must be a non-null object"]};let n=t;(typeof n.id!="string"||!n.id)&&e.push("id: required, must be a non-empty string");for(let r of Object.keys(n))bn.has(r)||e.push(`Unknown top-level key: "${r}"`);if((n.card_data==null||typeof n.card_data!="object"||Array.isArray(n.card_data))&&e.push("card_data: required, must be an object"),n.meta!=null)if(typeof n.meta!="object"||Array.isArray(n.meta))e.push("meta: must be an object");else {let r=n.meta;r.title!=null&&typeof r.title!="string"&&e.push("meta.title: must be a string"),r.tags!=null&&!Array.isArray(r.tags)&&e.push("meta.tags: must be an array");}if(n.requires!=null&&!Array.isArray(n.requires)&&e.push("requires: must be an array of strings"),n.provides!=null&&(Array.isArray(n.provides)?n.provides.forEach((r,o)=>{if(!r||typeof r!="object"||Array.isArray(r))e.push(`provides[${o}]: must be an object with bindTo and ref`);else {let s=r;(typeof s.bindTo!="string"||!s.bindTo)&&e.push(`provides[${o}]: missing required "bindTo" string`),(typeof s.ref!="string"||!s.ref)&&e.push(`provides[${o}]: missing required "ref" string`);}}):e.push("provides: must be an array of { bindTo, ref } bindings")),n.compute!=null&&(Array.isArray(n.compute)?n.compute.forEach((r,o)=>{if(!r||typeof r!="object"||Array.isArray(r))e.push(`compute[${o}]: must be a compute step object`);else {let s=r;(typeof s.bindTo!="string"||!s.bindTo)&&e.push(`compute[${o}]: missing required "bindTo" property`),(typeof s.expr!="string"||!s.expr)&&e.push(`compute[${o}]: missing required "expr" string (JSONata expression)`);}}):e.push("compute: must be an array of compute steps")),n.source_defs!=null)if(!Array.isArray(n.source_defs))e.push("source_defs: must be an array");else {let r=new Set,o=new Set;n.source_defs.forEach((s,i)=>{if(!s||typeof s!="object"||Array.isArray(s))e.push(`source_defs[${i}]: must be an object`);else {let u=s;typeof u.bindTo!="string"||!u.bindTo?e.push(`source_defs[${i}]: missing required "bindTo" property`):(r.has(u.bindTo)&&e.push(`source_defs[${i}]: bindTo "${u.bindTo}" is not unique across source_defs`),r.add(u.bindTo)),typeof u.outputFile!="string"||!u.outputFile?e.push(`source_defs[${i}]: missing required "outputFile" property`):(o.has(u.outputFile)&&e.push(`source_defs[${i}]: outputFile "${u.outputFile}" is not unique across source_defs`),o.add(u.outputFile)),u.optionalForCompletionGating!=null&&typeof u.optionalForCompletionGating!="boolean"&&e.push(`source_defs[${i}]: optionalForCompletionGating must be a boolean`);}});}if(n.view!=null)if(typeof n.view!="object"||Array.isArray(n.view))e.push("view: must be an object");else {let r=n.view;!Array.isArray(r.elements)||r.elements.length===0?e.push("view.elements: required, must be a non-empty array"):r.elements.forEach((o,s)=>{if(!o||typeof o!="object"){e.push(`view.elements[${s}]: must be an object`);return}!o.kind||typeof o.kind!="string"?e.push(`view.elements[${s}].kind: required, must be a string`):we.has(o.kind)||e.push(`view.elements[${s}].kind: unknown kind "${o.kind}". Valid: ${[...we].join(", ")}`),o.data!=null&&(typeof o.data!="object"||Array.isArray(o.data))&&e.push(`view.elements[${s}].data: must be an object`);}),r.layout!=null&&(typeof r.layout!="object"||Array.isArray(r.layout))&&e.push("view.layout: must be an object"),r.features!=null&&(typeof r.features!="object"||Array.isArray(r.features))&&e.push("view.features: must be an object");}return {ok:e.length===0,errors:e}}async function vn(t,e){if(!t||t.length===0)return [];let n={card_data:e.card_data??{},requires:e.requires??{}};return Promise.all(t.map(async r=>{let o={};if(r.projections&&typeof r.projections=="object"&&!Array.isArray(r.projections)){for(let[s,i]of Object.entries(r.projections))if(typeof i=="string"&&i.trim().length>0)try{o[s]=await Gt(i).evaluate(n);}catch{o[s]=void 0;}}return {...r,_projections:o}}))}function xn(t,e){if(!t||t.length===0)return [];let n={card_data:e.card_data??{},requires:e.requires??{}};return t.map(r=>{let o={};if(r.projections&&typeof r.projections=="object"&&!Array.isArray(r.projections)){for(let[s,i]of Object.entries(r.projections))if(typeof i=="string"&&i.trim().length>0)try{o[s]=ve(i).evaluate(n);}catch{o[s]=void 0;}}return {...r,_projections:o}})}var jt={run:kn,runSync:Sn,eval:Rn,resolve:Cn,validate:wn,enrichSources:vn,enrichSourcesSync:xn};function Qt(t){return JSON.stringify(t)}function Zt(t){let e;try{e=JSON.parse(t);}catch{throw new Error(`parseExecutionRef: invalid JSON \u2014 ${t}`)}if(typeof e!="object"||e===null||typeof e.howToRun!="string"||typeof e.whatToRun!="string")throw new Error(`parseExecutionRef: missing required fields howToRun/whatToRun \u2014 ${t}`);return e}function Vt(t,e){function n(){return t.readIndex()??{}}function r(o,s,i){let u=String(s||"").split(".").filter(Boolean);if(u.length===0)return i&&typeof i=="object"&&!Array.isArray(i)?i:{value:i};let f={...o},x=f;for(let D=0;D<u.length-1;D++){let C=u[D],j=x[C],w=j&&typeof j=="object"&&!Array.isArray(j)?{...j}:{};x[C]=w,x=w;}return x[u[u.length-1]]=i,f}return {readCard(o){let s=n()[o];return !s||!t.cardExists(s.key)?null:t.readCard(s.key)},readCardKey(o){return n()[o]?.key??null},readAllCards(){let o=[];for(let[s,i]of Object.entries(n())){if(!t.cardExists(i.key))continue;let u=t.readCard(i.key);u?o.push(u):e?.(`[card-store] could not read card "${s}" at key "${i.key}"`);}return o},readChecksumIndex(){let o={};for(let[s,i]of Object.entries(n()))o[s]=i.checksum;return o},changedSince(o){let s=n(),i=[];for(let[u,f]of Object.entries(s))o[u]!==f.checksum&&i.push(u);for(let u of Object.keys(o))s[u]||i.push(u);return i},validateUpsert(o,s){let i=n(),u=i[o],f=Object.entries(i).find(([,x])=>x.key===s);return u&&u.key!==s?{ok:false,error:`Card id "${o}" is already mapped to key "${u.key}", cannot remap to "${s}"`}:f&&f[0]!==o?{ok:false,error:`Key "${s}" is already mapped to card id "${f[0]}", cannot remap to "${o}"`}:{ok:true}},writeCard(o,s,i){let u=n(),f=i??u[o]?.key??t.defaultCardKey(o),x=t.writeCard(f,s);u[o]={key:f,checksum:x,updatedAt:new Date().toISOString()},t.writeIndex(u);},patchCard(o,s,i){let u=n(),f=u[o];if(!f||!t.cardExists(f.key))throw new Error(`card "${o}" not found`);let x=t.readCard(f.key);if(!x||typeof x!="object"||Array.isArray(x))throw new Error(`card "${o}" is not patchable`);let D=r(x,s,i),C=t.writeCard(f.key,D);u[o]={key:f.key,checksum:C,updatedAt:new Date().toISOString()},t.writeIndex(u);},removeCard(o){let s=n();s[o]&&(delete s[o],t.writeIndex(s));},readIndex(){return n()}}}function te(t,e){return {readSourceData(n,r){let o=t.read(`${n}/${r}`);if(o==null)return null;let s=o.trim();if(!s)return null;try{return JSON.parse(s)}catch{return s}},ingestSourceDataStaged(n,r,o,s){let i=e(o);t.write(`${n}/.staged/${s}/${r}`,i);},commitSourceData(n,r,o){let s=`${n}/.staged/${o}/${r}`,i=t.read(s);return i==null?false:(t.write(`${n}/${r}`,i),t.remove(s),true)},hasSource(n,r){return t.exists(`${n}/${r}`)}}}function Ee(t){function e(n){let r=t.readAllEntries();if(!n)return r;let o=r.findIndex(s=>s.id===n);return o===-1?r:r.slice(o+1)}return {readEntriesAfterCursor(n){let r=e(n);return r.length===0?{events:[],newCursor:n}:{events:r.map(o=>o.event),newCursor:r[r.length-1].id}},pendingCount(n){return e(n).length},appendEvent(n){t.appendEntry({id:t.generateId(),event:n});}}}function Te(t,e){return {appendEntries(n,r){if(!n||r.length===0)return;let o=t.read(n)??[];t.write(n,[...o,...r]);},dispatchEntriesForJournalId(n,r){if(!n)return;let o=t.read(n);if(!(!o||o.length===0)){for(let s of o)try{r(s);}catch(i){let u=i instanceof Error?i.message:String(i);try{e(s,u);}catch{}}t.delete(n);}}}}var Mt="v1",wt="board/graph",Ie="board/lastJournalProcessedId";function Ae(t){return `cards/${t}/runtime`}function Oe(t){return {readRuntime(e){return t.read(Ae(e))??{_sources:{}}},writeRuntime(e,n){t.write(Ae(e),n);}}}function An(t,e){let n={...t};for(let r of e.deleteKeys)delete n[r];return {...n,...e.shallowMerge}}function je(t){return {readSnapshot(e){return t.readValues(e)},commitSnapshot(e,n){if(n.schemaVersion!==Mt)throw new Error(`Unsupported snapshot schema version: ${n.schemaVersion}`);let r=t.readValues(e);if(r.version!==n.expectedVersion)return {ok:false,reason:"version-mismatch",currentVersion:r.version};let o=An(r.values,n);return {ok:true,newVersion:t.writeValues(e,o,n.deleteKeys)}}}}function Ne(t){function e(n){let r=t.read(n);return r==null?null:typeof r=="string"?r:JSON.stringify(r)}return {readTaskExecutorRef(){let n=e("task-executor");if(n?.trim())return Zt(n.trim())},writeTaskExecutorRef(n){t.write("task-executor",Qt(n));},readChatHandlerRef(){let n=e("chat-handler");if(n?.trim())return Zt(n.trim())},writeChatHandlerRef(n){t.write("chat-handler",Qt(n));},readCardStoreRef(){return e("card-store-ref")},writeCardStoreRef(n){t.write("card-store-ref",n);},readOutputsStoreRef(){return e("outputs-store-ref")},writeOutputsStoreRef(n){t.write("outputs-store-ref",n);},readChatHandler(){return e("chat-handler")?.trim()||void 0},writeChatHandler(n){t.write("chat-handler",n);}}}function $e(t){return {writeComputedValues(e,n){t.write(`cards/${e}/computed_values`,n);},readComputedValues(e){return t.read(`cards/${e}/computed_values`)},readAllComputedValues(){let e={};for(let n of t.listKeys("cards/")){let r=n.match(/^cards\/([^/]+)\/computed_values$/);r&&(e[r[1]]=t.read(n));}return e},writeDataObjects(e){for(let[n,r]of Object.entries(e))n&&t.write(`data-objects/${n}`,r);},readDataObject(e){return t.read(`data-objects/${e}`)},readAllDataObjects(){let e={};for(let n of t.listKeys("data-objects/"))e[n.slice(13)]=t.read(n);return e},writeStatusSnapshot(e){t.write("status",e);},readStatusSnapshot(){return t.read("status")}}}function _n(t){return t?.lastRequestedAt?!t.lastFetchedAt||t.lastFetchedAt<t.lastRequestedAt:false}function En(t,e){return t?.lastRequestedAt?_n(t)?"in-flight":!t.lastFetchedAt||t.lastFetchedAt<e?"dispatch":"idle":"dispatch"}function Tn(t,e){let n={...t,lastFetchedAt:e};return delete n.lastError,n}function _e(t,e){let n={...t,lastError:e};return delete n.lastFetchedAt,n}function Ut(t,e){let n=e.state.tasks,r=e.config.tasks,o=Object.keys(n),s=It(e),i={completed:0,failed:0,in_progress:0,pending:0,blocked:0,unresolved:0},u=new Map;for(let g of s.pending)u.set(g.taskName,g.waitingOn);for(let g of s.unresolved)u.set(g.taskName,g.missingTokens);for(let g of s.blocked)u.set(g.taskName,g.failedTokens);let f=new Map;for(let[g,y]of Object.entries(r))for(let v of y.requires??[]){let E=f.get(v)??[];E.push(g),f.set(v,E);}let x=o.sort().map(g=>{let y=n[g],v=r[g]??{requires:[],provides:[]};y.status==="completed"?i.completed+=1:y.status==="failed"?i.failed+=1:y.status==="in-progress"&&(i.in_progress+=1);let E=v.requires??[],m=v.provides??[],A=Object.keys(y.data??{}).sort(),B=E.filter(M=>e.state.availableOutputs.includes(M)),q=E.filter(M=>!e.state.availableOutputs.includes(M)),G=u.get(g)??q,T=new Set;for(let M of m)for(let K of f.get(M)??[])K!==g&&T.add(K);let N=y.failedAt,U=y.error?{message:y.error,code:"TASK_FAILED",at:N,source:"task-runtime"}:void 0;return {name:g,status:y.status,error:U,requires:E,requires_satisfied:B,requires_missing:q,provides_declared:m,provides_runtime:A,blocked_by:G,unblocks:Array.from(T).sort(),runtime:{attempt_count:y.executionCount??0,restart_count:y.retryCount??0,in_progress_since:y.status==="in-progress"?y.startedAt??null:null,last_transition_at:y.lastUpdated??null,last_completed_at:y.completedAt??null,last_restarted_at:y.startedAt??null,status_age_ms:y.lastUpdated?0:null}}});i.pending=s.pending.length,i.blocked=s.blocked.length,i.unresolved=s.unresolved.length;let D=x.map(g=>({name:g.name,fanOut:g.unblocks.length})).sort((g,y)=>y.fanOut-g.fanOut||g.name.localeCompare(y.name)),C=D.length>0?D[0]:{name:null,fanOut:0},j=new Set;for(let g of Object.values(r))for(let y of g.requires??[])j.add(y);let w=0;for(let[g,y]of Object.entries(r)){let v=(y.requires??[]).length===0,m=(y.provides??[]).some(A=>(f.get(A)??[]).some(B=>B!==g));v&&!m&&(w+=1);}return {schema_version:"v1",meta:{board:{path:t}},summary:{card_count:o.length,completed:i.completed,eligible:s.eligible.length,pending:i.pending,blocked:i.blocked,unresolved:i.unresolved,failed:i.failed,in_progress:i.in_progress,orphan_cards:w,topology:{edge_count:Array.from(j).length,max_fan_out_card:C.name,max_fan_out:C.fanOut}},cards:x}}function In(){return new Date().toISOString()}function Fe(t,e,n,r,o,s,i){return async u=>{let f=[],x=n.cardStore.readCard(u.nodeId);if(!x)return "task-initiate-failure";let D=x.id,C=x.card_data??{},j=x.source_defs??[],w=j.filter(P=>P.optionalForCompletionGating!==true),g=n.cardRuntimeStore.readRuntime(D),y=false,v=()=>{y&&(n.cardRuntimeStore.writeRuntime(D,g),y=false);},E=P=>({...g._sources[P]??{}}),m=(P,L)=>{g._sources[P]=L,y=true;},A=u.taskState?.executionCount??0,B=g._lastExecutionCount;if(typeof B=="number"&&B!==A&&(g._sources={},y=true),B!==A&&(g._lastExecutionCount=A,y=true),u.update){let P=u.update,L=P.outputFile;if(L){let S=E(L);if(P.failure)m(L,_e(S,P.reason??"unknown"));else {let l=P.rqt;if(!S.lastFetchedAt||l>S.lastFetchedAt){let _=typeof P.deliveryToken=="string"?P.deliveryToken:void 0,O=false;_&&(O=n.fetchedSourcesStore.commitSourceData(D,L,_)),O?m(L,Tn(S,l)):m(L,_e(S,`source delivery commit failed for ${L} token=${String(_)}`));}}v();}}let q={};for(let P of j)if(P.outputFile){let L=n.fetchedSourcesStore.readSourceData(D,P.outputFile);L!==null&&(q[P.bindTo]=L);}let G={};for(let[P,L]of Object.entries(u.state??{}))if(L!==null&&typeof L=="object"&&!Array.isArray(L)){let S=L[P];G[P]=S!==void 0?S:L;}else G[P]=L;let T={id:D,card_data:{...C},requires:G,source_defs:j,compute:x.compute};T._sourcesData=q,x.compute&&jt.runSync(T,{sourcesData:q}),(s??n.outputStore.writeComputedValues.bind(n.outputStore))(D,T.computed_values??{});let N={...x},U=jt.enrichSourcesSync(Array.isArray(x.source_defs)?x.source_defs:void 0,{card_data:x.card_data,requires:G}),M=t.value;N.source_defs=Array.isArray(U)?U.map(P=>({...P,boardDir:typeof P.boardDir=="string"&&P.boardDir?P.boardDir:M})):U;let K=In(),X=u.update?void 0:K,W=w.filter(P=>{let L=P.outputFile;if(typeof L!="string"||!L)return  true;let S=E(L);X&&(S={...S,queueRequestedAt:X},m(L,S));let l=S.queueRequestedAt??S.lastRequestedAt??K,_=En(S,l);return _==="in-flight"?false:_==="dispatch"});if(v(),W.length>0){let P=false,L=K;for(let S of W){let l=S.outputFile;if(typeof l!="string"||!l)continue;let _=E(l),O=_.queueRequestedAt??K;m(l,{..._,lastRequestedAt:O}),L=O,P=true;}return P&&v(),P&&(f.push({taskKind:"source-fetch",payload:{boardRef:ht(t),enrichedCard:N,callbackToken:u.callbackToken,rqt:L}}),n.executionRequestStore.appendEntries(e,f)),"task-initiated"}let St=x.provides??[],Rt={};for(let{bindTo:P,ref:L}of St)Rt[P]=jt.resolve(T,L);return (i??n.outputStore.writeDataObjects.bind(n.outputStore))(Rt),j.filter(P=>{if(P.optionalForCompletionGating!==true)return  false;let L=E(P.outputFile);return !L.lastRequestedAt||!L.lastFetchedAt?true:L.lastFetchedAt<=L.lastRequestedAt}).length>0&&f.push({taskKind:"source-fetch",payload:{boardRef:ht(t),enrichedCard:N,callbackToken:u.callbackToken,rqt:K}}),r(u.nodeId,Rt),f.length>0&&n.executionRequestStore.appendEntries(e,f),"task-initiated"}}var ee={settings:{completion:"manual",refreshStrategy:"data-changed"},tasks:{}};function De(t){return {[wt]:t.graph,[Ie]:t.lastDrainedJournalId}}function Be(t){let e=t[wt],n=t[Ie];if(!e||typeof e!="object")throw new Error(`State snapshot is missing required key: ${wt}`);return {graph:e,lastDrainedJournalId:typeof n=="string"?n:""}}function Pe(t){let e=t.requires,n=t.provides?.map(r=>r.bindTo)??[];return {requires:e&&e.length>0?e:void 0,provides:n,taskHandlers:["card-handler"],description:t.meta?.title??t.id}}function et(t){return t!==void 0?{status:"success",data:t}:{status:"success"}}function Y(t){return {status:"fail",error:t}}function nt(t){return {status:"error",error:t instanceof Error?t.message:String(t)}}function On(t){let e=new TextEncoder().encode(t),n=Array.from(e,r=>String.fromCharCode(r)).join("");return btoa(n).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function qe(t){let e=t.replace(/-/g,"+").replace(/_/g,"/"),n=e+"=".repeat((4-e.length%4)%4),r=atob(n),o=Uint8Array.from(r,s=>s.charCodeAt(0));return new TextDecoder().decode(o)}function Ht(t){try{let e=JSON.parse(qe(t));return typeof e?.t=="string"?{taskName:e.t}:null}catch{return null}}function jn(t){return On(JSON.stringify(t))}function Le(t){try{let e=JSON.parse(qe(t));return typeof e?.cbk=="string"&&typeof e?.cid=="string"&&typeof e?.b=="string"&&typeof e?.d=="string"?e:null}catch{return null}}function st(){return new Date().toISOString()}function Ge(t,e){let n=e.onWarn??(()=>{}),r=ht(t);function o(S){if(S.length!==0)try{let l=e.publishBoardChangeNotifications?.(S);l&&typeof l.catch=="function"&&l.catch(_=>n(`[board-live-cards-public] publishBoardChangeNotifications failed: ${_ instanceof Error?_.message:String(_)}`));}catch(l){n(`[board-live-cards-public] publishBoardChangeNotifications failed: ${l instanceof Error?l.message:String(l)}`);}}function s(){let S=u().readCardStoreRef();if(!S)throw new Error(`Board at ${t.value} has no card store configured. Run: init --base-ref <ref> --store-ref <b64-ref>`);let l=e.kvStorageForRef(S);return {readIndex(){return l.read("_index")},writeIndex(_){l.write("_index",_);},readCard(_){return l.read(_)},writeCard(_,O){return l.write(_,O),e.hashFn(O)},cardExists(_){return l.read(_)!==null},defaultCardKey(_){return _}}}let i={readValues(S){let l=e.kvStorage("state-snapshot"),_=l.listKeys().sort();if(_.length===0)return {version:null,values:{}};let O={};for(let H of _)O[H]=l.read(H);return {version:e.hashFn(O),values:O}},writeValues(S,l,_){let O=e.kvStorage("state-snapshot");for(let H of _)O.delete(H);for(let[H,J]of Object.entries(l))O.write(H,J);return e.hashFn(l)}},u=()=>Ne(e.kvStorage("config")),f=()=>je(i),x=()=>Ee(e.journalAdapter()),D=()=>Vt(s(),n),C=()=>{let S=u().readOutputsStoreRef();if(!S)throw new Error(`Board at ${t.value} has no outputs store configured. Run: init --outputs-store-ref <b64-ref>`);return $e(e.kvStorageForRef(S))};function j(){return !!f().readSnapshot(t.value).values[wt]}function w(){let S=f().readSnapshot(t.value);if(!S.values[wt])throw new Error(`Board not initialized at ${t.value}`);return Be(S.values)}function g(S,l){let _=f().commitSnapshot(t.value,{schemaVersion:Mt,expectedVersion:l,commitId:e.genId(),committedAt:st(),deleteKeys:[],shallowMerge:De(S)});if(!_.ok)throw new Error(`Snapshot commit failed (version mismatch): expected=${l??"null"} current=${_.currentVersion??"null"}`)}function y(S){x().appendEvent(S);}async function v(){let S=(p,h)=>{let $=p.payload,F=($?.enrichedCard??{}).id??$?.cardId??"unknown";y({type:"task-failed",taskName:F,error:h,timestamp:st()});},l=Te(e.kvStorage("execution-requests"),S),_=Oe(e.kvStorage("card-runtime")),O=te(e.blobStorage("sources"),p=>e.resolveBlob(p)),H=new Map,J={readRuntime(p){return H.get(p)??_.readRuntime(p)},writeRuntime(p,h){H.set(p,h);}},at=[],rt=new Map,lt={readSourceData(p,h){let $=`${p}/${h}`;return rt.has($)?rt.get($):O.readSourceData(p,h)},ingestSourceDataStaged(p,h,$,V){O.ingestSourceDataStaged(p,h,$,V);},commitSourceData(p,h,$){let V=`${p}/.staged/${$}/${h}`,z=e.blobStorage("sources").read(V);if(z==null)return  false;let tt=`${p}/${h}`,Z=z.trim();try{rt.set(tt,JSON.parse(Z));}catch{rt.set(tt,Z);}return at.push({cardId:p,outputFile:h,deliveryToken:$}),true},hasSource(p,h){let $=`${p}/${h}`;return rt.has($)?true:O.hasSource(p,h)}},it={cardStore:D(),cardRuntimeStore:J,fetchedSourcesStore:lt,outputStore:C(),executionRequestStore:l},ft=w(),pt=qt(ft.graph),{events:Q,newCursor:gt}=x().readEntriesAfterCursor(ft.lastDrainedJournalId),mt=[],vt=[],xt=[],Et=new Map,Jt=(p,h)=>{mt.push({type:"task-completed",taskName:p,data:h,timestamp:st()});},$t=(p,h)=>y({type:"task-failed",taskName:p,error:h,timestamp:st()}),c=Ce(pt,{handlers:{"card-handler":Fe(t,gt,it,Jt,$t,(p,h)=>{vt.push({cardId:p,values:h});},p=>{xt.push(p);})}});for(mt=Q;mt.length>0;){let p=mt;mt=[];for(let h of p)if(h.type==="task-restart"){let $=it.cardStore.readCard(h.taskName);$&&Et.set(h.taskName,$);}c.pushAll(p),await c.waitForHandlers();}let d=c.getState();await c.dispose({wait:true});let b=f().readSnapshot(t.value).version;g({lastDrainedJournalId:gt,graph:Tt(d)},b);for(let{cardId:p,values:h}of vt)it.outputStore.writeComputedValues(p,h);for(let p of xt)it.outputStore.writeDataObjects(p);for(let[p,h]of H)_.writeRuntime(p,h);for(let{cardId:p,outputFile:h,deliveryToken:$}of at)O.commitSourceData(p,h,$);let k;try{k=Ut(r,d),it.outputStore.writeStatusSnapshot(k);}catch(p){n(`[board-live-cards-public] status publish failed: ${p instanceof Error?p.message:String(p)}`);}let R=[];for(let{cardId:p,values:h}of vt)R.push({kind:"computed_values",cardId:p,values:h});for(let p of xt)for(let[h,$]of Object.entries(p))h&&R.push({kind:"data_object",key:h,payload:$});for(let[p,h]of Et)R.push({kind:"card_refreshed",cardId:p,card:h});k!==void 0&&R.push({kind:"status",status:k}),o(R);let I=u().readTaskExecutorRef()??{howToRun:"built-in",whatToRun:ht({kind:"built-in",value:"source-cli-task-executor"})};l.dispatchEntriesForJournalId(gt,p=>{if(p.taskKind!=="source-fetch"){n(`[process-accumulated-events] unknown taskKind "${p.taskKind}" \u2014 skipping`);return}let h=p.payload,$=h.enrichedCard?.id??"unknown",V=h.enrichedCard?.source_defs??[];for(let F of V){if(!F.outputFile){n(`[dispatch] source "${F.bindTo}" has no outputFile \u2014 skipping`);continue}let z=jn({cbk:h.callbackToken,rg:t.value,br:ht(t),cid:$,b:F.bindTo,d:F.outputFile,cs:void 0,rqt:h.rqt});e.dispatchExecution(I,{source_def:F,base_ref:ht(t),callback:{token:z,via:e.selfRef}}).catch(tt=>$t($,tt instanceof Error?tt.message:String(tt)));}});}async function E(){try{let S=()=>{let _=w(),{events:O}=x().readEntriesAfterCursor(_.lastDrainedJournalId);O.length<=0||(E(),e.requestProcessAccumulated?.());},l=await ie(e.lock,v,S);return et({ran:l!==!1})}catch(S){return nt(S)}}function m(S){try{let l=S.params?.cardStoreRef;if(!l)return Y("init requires params.cardStoreRef \u2014 create a card store with card-store-cli and pass its ref here");if(!j()){let J=Lt(ee);g({lastDrainedJournalId:"",graph:Tt(J)},null);}let _=S.params?.outputsStoreRef;if(!_)return Y("init requires params.outputsStoreRef \u2014 pass the outputs store ref here");let O=u();O.writeCardStoreRef(l),O.writeOutputsStoreRef(_);let H=S.body??{};H["task-executor-ref"]&&O.writeTaskExecutorRef(H["task-executor-ref"]),H["chat-handler-ref"]&&O.writeChatHandlerRef(H["chat-handler-ref"]);try{C().writeStatusSnapshot(Ut(r,qt(w().graph)));}catch{}return et()}catch(l){return nt(l)}}function A(S){try{let l=C().readStatusSnapshot();if(!l){l=Ut(r,qt(w().graph));try{C().writeStatusSnapshot(l);}catch{}}return et(l)}catch(l){return nt(l)}}function B(S){try{let l=S.params?.id;return l?(y({type:"task-removal",taskName:l,timestamp:st()}),E(),et()):Y("removeCard requires params.id")}catch(l){return nt(l)}}function q(S){try{let l=S.params?.id;return l?(y({type:"task-restart",taskName:l,timestamp:st()}),E(),et()):Y("retrigger requires params.id")}catch(l){return nt(l)}}async function G(S){return E()}function T(S){try{let l=S.params?.cardId,_=S.params?.all,O=!!S.params?.restart;if(!l&&!_)return Y("upsertCard requires --card-id <id> or --all");let H=_?D().readAllCards().map(J=>J.id):[l];for(let J of H)if(!D().readCard(J))return Y(`Card "${J}" not found in board at ${t.value}`);for(let J of H){let at=D().readCard(J),rt=Pe(at),lt=e.hashFn(rt),it=e.kvStorage("card-upsert"),ft=it.read(J),pt=ft?.taskConfigHash!==lt;if(!(!pt&&!O)){if(pt){let Q=ft?.blobRef??D().readCardKey(J)??J;y({type:"task-upsert",taskName:J,taskConfig:rt,timestamp:st()}),it.write(J,{blobRef:Q,taskConfigHash:lt,updatedAt:st()});}O&&y({type:"task-restart",taskName:J,timestamp:st()});}}return E(),et()}catch(l){return nt(l)}}function N(S){try{let l=S.params?.token;if(!l)return Y("taskFailed requires params.token");let _=S.params?.error??"unknown error",O=Ht(l);return O?(y({type:"task-failed",taskName:O.taskName,error:_,timestamp:st()}),E(),et()):Y("Invalid callback token")}catch(l){return nt(l)}}function U(S){try{let l=S.params?.token;if(!l)return Y("taskProgress requires params.token");let O=(S.body??{}).update??{},H=Ht(l);return H?(y({type:"task-progress",taskName:H.taskName,update:O,timestamp:st()}),E(),et()):Y("Invalid callback token")}catch(l){return nt(l)}}function M(S){try{let l=S.params?.token,_=S.params?.ref;if(!l)return Y("sourceDataFetched requires params.token");if(!_)return Y("sourceDataFetched requires params.ref");let O=Le(l);if(!O)return Y("Invalid source token");let{cbk:H,cid:J,b:at,d:rt,cs:lt,rqt:it}=O,ft=te(e.blobStorage("sources"),mt=>e.resolveBlob(mt)),pt=e.genId();ft.ingestSourceDataStaged(J,rt,ae(_),pt);let Q=Ht(H);if(!Q)return Y("Invalid callback token embedded in source token");let gt=st();return y({type:"task-progress",taskName:Q.taskName,update:{bindTo:at,outputFile:rt,fetchedAt:gt,deliveryToken:pt,sourceChecksum:lt,rqt:it},timestamp:gt}),E(),et()}catch(l){return nt(l)}}function K(S){try{let l=S.params?.token,_=S.params?.reason??"unknown";if(!l)return Y("sourceDataFetchFailure requires params.token");let O=Le(l);if(!O)return Y("Invalid source token");let{cbk:H,b:J,d:at,cs:rt}=O,lt=Ht(H);return lt?(y({type:"task-progress",taskName:lt.taskName,update:{bindTo:J,outputFile:at,failure:!0,reason:_,sourceChecksum:rt},timestamp:st()}),E(),et()):Y("Invalid callback token embedded in source token")}catch(l){return nt(l)}}function X(S){try{let l=u().readCardStoreRef();return l?et({storeRef:l}):Y(`Board at ${t.value} has no card store configured`)}catch(l){return nt(l)}}function W(S){try{let l=u().readOutputsStoreRef();return l?et({storeRef:l}):Y(`Board at ${t.value} has no outputs store configured`)}catch(l){return nt(l)}}function St(S){try{let l=S.params?.key;if(!l)return Y("getConfig requires params.key");let _=u(),O;switch(l){case "task-executor":O=_.readTaskExecutorRef()??null;break;case "chat-handler":O=_.readChatHandlerRef()??null;break;case "card-store-ref":O=_.readCardStoreRef();break;case "outputs-store-ref":O=_.readOutputsStoreRef();break;default:return Y(`getConfig: unknown key "${l}"`)}return et({value:O})}catch(l){return nt(l)}}function Rt(S){try{let l=S.params?.key;if(!l)return Y("getOutputsDataObject requires params.key");let _=C().readDataObject(l);return et(_)}catch(l){return nt(l)}}function Ct(S){try{return et(C().readAllDataObjects())}catch(l){return nt(l)}}function P(S){try{let l=S.params?.key;if(!l)return Y("getOutputsComputedValues requires params.key");let _=C().readComputedValues(l);return et(_)}catch(l){return nt(l)}}function L(S){try{return et(C().readAllComputedValues())}catch(l){return nt(l)}}return {init:m,status:A,getCardStoreRef:X,getOutputsStoreRef:W,getConfig:St,getOutputsDataObject:Rt,getAllOutputsDataObjects:Ct,getOutputsComputedValues:P,getAllOutputsComputedValues:L,removeCard:B,retrigger:q,processAccumulatedEvents:G,upsertCard:T,taskFailed:N,taskProgress:U,sourceDataFetched:M,sourceDataFetchFailure:K}}function Ve(t){function e(o){return {status:"success",data:o}}function n(o){return {status:"fail",error:o}}function r(o){return {status:"error",error:o instanceof Error?o.message:String(o)}}return {get(o){try{let s=o.params?.id;if(s){let i=t.readCard(s);return i?e({cards:[i]}):n(`card "${s}" not found`)}return e({cards:t.readAllCards()})}catch(s){return r(s)}},set(o){try{let s=o.body;if(s==null)return n("set requires a body (card object or array of cards)");let i=Array.isArray(s)?s:[s];for(let u of i){if(typeof u.id!="string")return n("each card must have a string `id` field");t.writeCard(u.id,u);}return e({count:i.length})}catch(s){return r(s)}},del(o){try{let s=o.body?.ids??[],i=o.params?.id,u=i?[...s,i]:s;if(u.length===0)return n("del requires body.ids (string[]) or params.id");for(let f of u)t.removeCard(f);return e({count:u.length})}catch(s){return r(s)}},patch(o){try{let s=o.params?.id,i=o.params?.path;if(!s)return n("patch requires params.id");if(!i)return n("patch requires params.path");let u=o.body,f=u&&Object.prototype.hasOwnProperty.call(u,"value")?u.value:o.body;return t.patchCard(s,i,f),e({count:1})}catch(s){return r(s)}}}}var Kt=".artifacts-index.json";function Me(){return new Date().toISOString()}function Ue(t){return new TextEncoder().encode(t).byteLength}function Nt(t){let e=t.read(Kt);if(!e)return {entries:{}};try{let n=JSON.parse(e);if(n&&n.entries&&typeof n.entries=="object")return n}catch{}return {entries:{}}}function ne(t,e){t.write(Kt,JSON.stringify(e,null,2));}function Nn(t){return t?{key:t.key,size:t.size,updatedAt:t.updatedAt,contentType:t.contentType}:null}function He(t,e,n){t.entries[e]={key:e,size:n.size,updatedAt:n.updatedAt,contentType:n.contentType};}function re(t){let e=String(t||"").match(/^(\d+)[-_]/);return e?parseInt(e[1],10):0}function $n(t){let e=String(t||"").trim();if(!e)return "upload.bin";let n=Math.max(e.lastIndexOf("/"),e.lastIndexOf("\\"));return (n>=0?e.slice(n+1):e)||"upload.bin"}function Fn(t){return String(t||"").toLowerCase().replace(/\s+/g,"_").replace(/[^a-z0-9_-]/g,"_").replace(/_+/g,"_").replace(/^_+|_+$/g,"")||"file"}function Dn(t){if(!t||t===".")return "";let e=String(t).replace(/^\./,"").toLowerCase().replace(/[^a-z0-9]/g,"");return e?`.${e}`:""}function Bn(t){let e=$n(t),n=e.lastIndexOf(".");return n<=0||n===e.length-1?{stem:e,ext:""}:{stem:e.slice(0,n),ext:e.slice(n)}}function Pn(t){let e=t.lastIndexOf("/");return e>=0?t.slice(e+1):t}function oe(t){function e(n){let r=t.stat?Nn(t.stat(n)):null;if(r)return r;let s=Nt(t).entries[n];if(s)return {...s};if(!t.exists(n))return null;let i=t.read(n);return i===null?{key:n}:{key:n,size:Ue(i)}}return {exists(n){return t.exists(n)},putText(n,r,o="text/plain; charset=utf-8"){t.write(n,r);let s=e(n)??{key:n};s.contentType=o,s.updatedAt=s.updatedAt??Me(),s.size=s.size??Ue(r);let i=Nt(t);return He(i,n,s),ne(t,i),s},putBytes(n,r,o="application/octet-stream"){if(t.writeBytes)t.writeBytes(n,r);else {let u=JSON.stringify({__kind:"bytes-array",data:[...r]});t.write(n,u);}let s=e(n)??{key:n};s.contentType=o,s.updatedAt=s.updatedAt??Me(),s.size=s.size??r.byteLength;let i=Nt(t);return He(i,n,s),ne(t,i),s},getText(n){let r=t.read(n);if(r===null){if(!t.readBytes)return null;let o=t.readBytes(n);return o===null?null:Buffer.from(o).toString("utf-8")}try{let o=JSON.parse(r);if(o&&o.__kind==="bytes-array"&&Array.isArray(o.data))return new TextDecoder("utf-8").decode(new Uint8Array(o.data))}catch{}return r},getBytes(n){if(t.readBytes){let o=t.readBytes(n);if(o!==null)return o}let r=t.read(n);if(r===null)return null;try{let o=JSON.parse(r);if(o&&o.__kind==="bytes-array"&&Array.isArray(o.data))return new Uint8Array(o.data)}catch{}return new TextEncoder().encode(r)},head:e,list(n=""){let r=new Map;if(t.listKeys)for(let s of t.listKeys(n)){if(s===Kt)continue;let i=e(s)??{key:s};r.set(s,i);}let o=Nt(t);for(let[s,i]of Object.entries(o.entries))s===Kt||n&&!s.startsWith(n)||r.has(s)||r.set(s,{...i});return [...r.values()].sort((s,i)=>s.key.localeCompare(i.key))},remove(n){t.remove(n);let r=Nt(t);delete r.entries[n],ne(t,r);}}}function Ke(t,e){let n=e?.indexFileName;function r(C){return `${C}/${n}`}function o(C){let j=t.getText(r(C));if(!j)return [];try{let w=JSON.parse(j);return Array.isArray(w)?w.filter(g=>g&&typeof g.stored_name=="string").map(g=>({serial:Number(g.serial||re(String(g.stored_name))||0),role:String(g.role||"system").toLowerCase(),stored_name:String(g.stored_name),path:typeof g.path=="string"?g.path:`${C}/chats/${String(g.stored_name)}`,updated_at:typeof g.updated_at=="string"?g.updated_at:null})):[]}catch{return []}}function s(C,j){t.putText(r(C),JSON.stringify(j,null,2),"application/json; charset=utf-8");}function i(C){let j=o(C),w=0;for(let g of j){let y=Number(g.serial||0);Number.isFinite(y)&&y>w&&(w=y);}return w+1}function u(C,j){let w=o(C);w.push(j),s(C,w);}function f(C){let j=o(C),w=[];for(let g of j){let y=`${C}/${g.stored_name}`,v=t.getText(y);v!==null&&w.push({serial:Number(g.serial||re(g.stored_name)||0),role:String(g.role||"system").toLowerCase(),text:v,path:typeof g.path=="string"?g.path:`${C}/chats/${g.stored_name}`,stored_name:g.stored_name,updated_at:g.updated_at||null});}return w.sort((g,y)=>g.serial-y.serial||g.stored_name.localeCompare(y.stored_name)),w}function x(C){let j=`${C}/`;for(let w of t.list(j))t.remove(w.key);}function D(C){let j=`${C}/`,w=t.list(j),g=0,y=0,v=false;for(let E of w){let m=E.key.slice(j.length);if(m===".processing"){v=true;continue}if(!/^(\d+)[-_]([a-z0-9_-]+)\.txt$/i.test(m))continue;g+=1;let A=E.updatedAt?Number(new Date(E.updatedAt).getTime()||0):0;A>y&&(y=A);}return {count:g,latest_mtime_ms:y,processing:v}}return {indexKey:r,loadIndex:o,saveIndex:s,nextSerial:i,appendIndexRecord:u,readRecords:f,clear:x,readSignal:D}}function Je(t){function e(o,s){let i=0,u=[];Array.isArray(s)&&u.push(...s);for(let f of t.list(`${o}/`))u.push(Pn(f.key));for(let f of u){let x=re(f);Number.isFinite(x)&&x>i&&(i=x);}return i+1}function n(o,s,i){let u=Number(i?.maxLen||32),{stem:f,ext:x}=Bn(o),D=Dn(x),C=Fn(f),j=`${String(s).padStart(3,"0")}-`,w=D,g=u-j.length-w.length;g<1&&(w="",g=u-j.length);let y=C.slice(0,Math.max(1,g)),v=`${j}${y}${w}`;return v.length>u&&(v=v.slice(0,u).replace(/\.$/,"")),v}function r(o,s,i){let u=e(o,i?.seedNames),f=n(s,u,{maxLen:i?.maxLen});for(;t.exists(`${o}/${f}`);)u+=1,f=n(s,u,{maxLen:i?.maxLen});return f}return {nextSerial:e,buildStoredName:n,allocateStoredName:r}}function ze(){function t(o,s){if(!Array.isArray(o))return [];let i=[];for(let u of o){if(!u||typeof u!="object")continue;let f=u;typeof f.stored_name=="string"&&i.push({name:typeof f.name=="string"?f.name:f.stored_name,stored_name:f.stored_name,size:typeof f.size=="number"&&Number.isFinite(f.size)?f.size:null,mime_type:typeof f.mime_type=="string"?f.mime_type:null,path:typeof f.path=="string"?f.path:null,uploaded_at:typeof f.uploaded_at=="string"?f.uploaded_at:s||null});}return i}function e(o){return !o||typeof o!="object"?[]:t(o.files,void 0)}function n(o,s){let i=e(o);if(s.length===0)return o.files=i,i;let u=new Set(i.map(f=>f.stored_name));for(let f of s)u.has(f.stored_name)||(i.push(f),u.add(f.stored_name));return o.files=i,i}function r(o,s,i){let u=e(o);if(!Number.isInteger(s)||s<0||s>=u.length)return {ok:false,reason:"index_out_of_range"};let f=u[s];return !f||!f.stored_name?{ok:false,reason:"missing_stored_name"}:i&&i!==f.stored_name?{ok:false,reason:"stale_reference"}:{ok:true,file:f}}return {read:e,normalizeIncoming:t,merge:n,resolve:r}}var Ye={"Access-Control-Allow-Origin":"*","Access-Control-Allow-Headers":"content-type,x-file-name","Access-Control-Allow-Methods":"GET,POST,PATCH,OPTIONS"},Ln=32;function qn(){return {status:null,computedValues:{},dataObjects:{},cards:{}}}function Xe(t){if(!t||typeof t!="object")return  false;let e=t.summary;return !e||typeof e!="object"?false:Number(e.card_count||0)>0}function We(t,e){if(!e||typeof e!="object")return;let n=e;if(n.kind==="notification-batch"&&Array.isArray(n.notifications)){for(let r of n.notifications)We(t,r);return}n.kind==="status"&&Xe(n.status)&&(t.status=n.status),n.kind==="computed_values"&&n.cardId&&(t.computedValues[n.cardId]=n.values),n.kind==="data_object"&&n.key&&(t.dataObjects[n.key]=n.payload),n.kind==="card_refreshed"&&n.cardId&&(t.cards[n.cardId]=n.card);}function Br(t){let e=String(t.apiBasePath||"/api/board").replace(/\/$/,""),n={...Ye,...t.corsHeaders||{}},r=t.boardId||"",o=t.logger||{info:console.log,warn:console.warn,error:console.error},s=t.invocationAdapter,i=t.notificationTransport||null,u=t.serverUrl||null,f=t.executionExtra||{},x=new Set;function D(a){let c=Ge(a.baseRef,a.boardAdapter),d=a.boardAdapter.kvStorageForRef(a.cardStoreRef),k=Ve(Vt({readIndex:()=>d.read("_index"),writeIndex:h=>d.write("_index",h),readCard:h=>d.read(h),writeCard:(h,$)=>(d.write(h,$),h),cardExists:h=>d.read(h)!==null,defaultCardKey:h=>h},o.warn)),R=a.artifactsAdapter||a.boardAdapter,I=null,p=null;return {label:a.label,board:c,cardStore:k,get filesArtifacts(){return I??=oe(R.blobStorage("files"))},get chatsArtifacts(){return p??=oe(R.blobStorage("chats"))},boardAdapter:a.boardAdapter,cardStoreRef:a.cardStoreRef,outputsStoreRef:a.outputsStoreRef,notifyRef:a.notifyRef,taskExecutorRef:a.taskExecutorRef,chatHandlerRef:a.chatHandlerRef,inferenceAdapterRef:a.inferenceAdapterRef,notification:qn(),notificationTeardown:null,initialized:false,cardsBootstrapped:false}}let C=t.boards.map(D),j=new Map;function w(a){return j.get(a)??0}function g(a){let c=C[w(a)];return {files:c?c.filesArtifacts:null,chats:c?c.chatsArtifacts:null}}function y(a){let c=g(a);return c.chats?Ke(c.chats,{indexFileName:".index.json"}):null}function v(a){let c=g(a);return c.files?Je(c.files):null}function E(){return ze()}function m(a){return String(a||"").replace(/[^a-zA-Z0-9_-]/g,"_")||"unknown-card"}async function A(a){if(!a||a.notificationTeardown||!i||!a.notifyRef)return;let c=await i.subscribe(a.notifyRef,d=>{We(a.notification,d);let b=d.kind==="notification-batch"?d.notifications:[d];Jt(b);});a.notificationTeardown=c;}async function B(a){if(!a||a.initialized)return;let c={cardStoreRef:a.cardStoreRef,outputsStoreRef:a.outputsStoreRef},d={};a.taskExecutorRef&&(d["task-executor-ref"]=a.taskExecutorRef),a.chatHandlerRef&&(d["chat-handler-ref"]=a.chatHandlerRef),a.inferenceAdapterRef&&(d["inference-adapter-ref"]=a.inferenceAdapterRef);let b=a.board.init({params:c,body:d});if(b.status!=="success")throw Object.assign(new Error(b.error||`init failed for ${a.label}`),{statusCode:500});if(await A(a),a.chatHandlerRef&&s.describe)try{let k=await s.describe(a.chatHandlerRef);k&&k.kind!=="chat-handler"?o.warn(`[init] chat-handler describe returned kind="${k.kind}", expected "chat-handler" for ${a.label}`):k&&o.info(`[init] chat-handler validated: ${k.name} (protocol ${k.protocolVersion}) for ${a.label}`);}catch(k){o.warn(`[init] chat-handler describe failed for ${a.label}: ${k?.message||String(k)}`);}a.initialized=true;}function q(a){if(!a.boardAdapter.publishBoardChangeNotifications)return;let c=[],d=a.board.status({});d.status==="success"&&d.data!=null&&Xe(d.data)&&c.push({kind:"status",status:d.data});let b=a.board.getAllOutputsDataObjects({});if(b.status==="success"&&b.data!=null)for(let[R,I]of Object.entries(b.data))R&&c.push({kind:"data_object",key:R,payload:I});let k=a.board.getAllOutputsComputedValues({});if(k.status==="success"&&k.data!=null)for(let[R,I]of Object.entries(k.data))R&&c.push({kind:"computed_values",cardId:R,values:I});c.length>0&&a.boardAdapter.publishBoardChangeNotifications(c);}function G(a,c){if(!a||a.cardsBootstrapped)return;let d=a.cardStore.get({}),b=d.status==="success"&&Array.isArray(d.data?.cards)?d.data.cards:[];for(let k of b)typeof k.id=="string"&&(j.set(k.id,c),a.board.upsertCard({params:{cardId:k.id}}));a.cardsBootstrapped=true;}async function T(){for(let a of C)await B(a);}async function N(){await T();for(let a=0;a<C.length;a++)q(C[a]),G(C[a],a);}function U(a){return C[w(a)]??null}function M(a){let c=U(a);if(!c)return null;let d=c.cardStore.get({params:{id:a}});if(d.status!=="success")return null;let b=Array.isArray(d.data?.cards)?d.data.cards:[];return b.length>0?b[0]:null}function K(){let a=d=>{if(!d||!d.cardStore)return [];let b=d.cardStore.get({});return b.status!=="success"||!Array.isArray(b.data?.cards)?[]:b.data.cards},c=[];for(let d of C)c.push(...a(d));return c}function X(){let a=C.map(R=>{try{let p=R.boardAdapter.kvStorageForRef(R.outputsStoreRef).read("status");if(p!=null)return p}catch{}return R.notification.status}).filter(Boolean);if(a.length===0)return null;if(a.length===1)return a[0];let c=[],d=["completed","eligible","pending","blocked","unresolved","failed","in_progress","orphan_cards"],b={};for(let R of d)b[R]=0;for(let R of a){let I=R,p=Array.isArray(I.cards)?I.cards:[];c.push(...p);for(let h of d)b[h]+=Number(I?.summary?.[h]||0);}let k=a[0];return {...k,cards:c,summary:{...k.summary||{},card_count:c.length,...b}}}function W(){let a={},c=d=>{for(let[b,k]of Object.entries(d.notification.computedValues)){let R=d.notification.cards[b];a[b]={schema_version:"v1",card_id:b,card_data:R?.card_data??{},computed_values:k??{}};}};for(let d of C)c(d);return a}function St(){let a={};for(let c of C)Object.assign(a,c.notification.dataObjects||{});return a}function Rt(a){let c=m(a),d=y(a);return d?d.readSignal(c):{count:0,latest_mtime_ms:0,processing:false}}function Ct(){let a=K(),c=W(),d=St(),b={};for(let k of a){if(!k?.id)continue;let R=k.id,I=c[R]||{},p=Rt(R),h={...I.card_data&&typeof I.card_data=="object"?I.card_data:k.card_data&&typeof k.card_data=="object"?k.card_data:{},__chat_signal:p};b[R]={schema_version:I.schema_version||"v1",card_id:I.card_id||R,card_data:h,computed_values:I.computed_values&&typeof I.computed_values=="object"?I.computed_values:{}};}return {boardId:r,cardDefinitions:a,statusSnapshot:X(),dataObjectsByToken:d,cardRuntimeById:b}}function P(a,c,d){let b=d?.syncBoard!==false,k=U(a);if(!k)throw Object.assign(new Error(`Card not found: ${a}`),{statusCode:404});let R=M(a);if(!R)throw Object.assign(new Error(`Card not found: ${a}`),{statusCode:404});let I=c(R)||R,p=k.cardStore.set({body:I});if(p.status!=="success")throw Object.assign(new Error(p.error||`Failed to persist card: ${a}`),{statusCode:500});if(b){let h=k.board.upsertCard({params:{cardId:a,restart:true}});if(h.status!=="success")throw Object.assign(new Error(h.error||`Failed to upsert card: ${a}`),{statusCode:500})}}function L(a,c){P(a,c,{syncBoard:true});}function S(a,c){P(a,c,{syncBoard:false});}function l(a,c){L(a,d=>{if(!c||typeof c!="object"||Object.keys(c).length===0)return d;function b(k,R,I){let p=String(R||"").split(".").filter(Boolean);if(!p.length)return;let h=k;for(let $=0;$<p.length-1;$++){let V=p[$];(!h[V]||typeof h[V]!="object")&&(h[V]={}),h=h[V];}h[p[p.length-1]]=I;}if(c.fieldValues!==void 0&&c.fieldValues!==null){let k=null,R=d.view;if(R&&Array.isArray(R.elements)){for(let I of R.elements)if(I?.data&&I.data.writeTo){k=I.data.writeTo;break}}k?b(d,k,c.fieldValues):typeof c.fieldValues=="object"&&!Array.isArray(c.fieldValues)&&(d.card_data={...d.card_data||{},...c.fieldValues});}else {if(Array.isArray(c._stagedFiles)&&c._stagedFiles.length>0)return d;for(let[k,R]of Object.entries(c))k!=="_stagedFiles"&&(R!==null&&typeof R=="object"&&!Array.isArray(R)&&d[k]!==null&&typeof d[k]=="object"&&!Array.isArray(d[k])?d[k]={...d[k],...R}:d[k]=R);}return d});}function _(a){let c=String(a||"").match(/^(\d+)[-_]/);return c?parseInt(c[1],10):0}function O(a){let c=String(a||"").trim();if(!c)return "upload.bin";let d=Math.max(c.lastIndexOf("/"),c.lastIndexOf("\\"));return (d>=0?c.slice(d+1):c)||"upload.bin"}function H(a){let c=m(a),d=y(a);d&&d.clear(c);}function J(a,c){let d=m(a),b=y(a),k=b?b.nextSerial(d):1,R=String(c||"system").toLowerCase().replace(/[^a-z0-9_-]/g,"_")||"system";return `${String(k).padStart(3,"0")}_${R}.txt`}function at(a,c,d,b){let k=new Date().toISOString(),R=m(a),I=g(a),p=J(a,c||"system"),h=`${R}/${p}`,$=[],V=typeof d=="string"?d.trim():"";V&&$.push(V);let F=Array.isArray(b)?b:[];if(F.length){$.length&&$.push(""),$.push("files:");for(let Z of F){if(!Z||typeof Z!="object")continue;let ut=typeof Z.name=="string"?Z.name:"file",ct=typeof Z.stored_name=="string"?Z.stored_name:"";$.push(ct?`- ${ut} -> ${ct}`:`- ${ut}`);}}I.chats&&I.chats.putText(h,`${$.join(`
+`)}
+`);let z=_(p),tt=y(a);return tt&&tt.appendIndexRecord(R,{serial:z,role:c||"system",stored_name:p,path:`${a}/chats/${p}`,updated_at:k}),{at:k,role:c||"system",text:V,files:F,path:`${a}/chats/${p}`}}function rt(a){let c=m(a),d=y(a);return d?d.readRecords(c).map(b=>({...b,path:`${a}/chats/${b.stored_name}`})):[]}function lt(a){let c=[];try{let d=M(a);if(!d)return c;let b=E().read(d.card_data&&typeof d.card_data=="object"?d.card_data:null);for(let k of b)c.push(k.stored_name);}catch{}return c}function it(a,c,d,b){let k=m(a),R=g(a),I=O(c),p=v(a),h=p?p.allocateStoredName(k,I,{seedNames:lt(a),maxLen:Ln}):`${String(Date.now())}-${I}`;return R.files&&R.files.putBytes(`${k}/${h}`,new Uint8Array(b),d||"application/octet-stream"),{name:I,stored_name:h,size:b.length,mime_type:d||"application/octet-stream",path:`${a}/files/${h}`,uploaded_at:new Date().toISOString()}}function ft(a,c,d){let b=U(a);if(!b)return;let k=b.board.getConfig({params:{key:"chat-handler"}});if(k.status!=="success")return;let R=k.data?.value;if(!R||typeof R!="object")return;let I=m(a),p=g(a),h=`${I}/.processing`;try{p.chats?.putText(h,"","text/plain; charset=utf-8");}catch{}let $={boardId:r,cardId:String(a),chatsKeyPrefix:c,chatProcessingMarkerKey:h,lastChatFile:d,...f,...u?{serverUrl:u}:{}};s.invoke(R,$).then(V=>{if(V.dispatched)o.info(`[chat-handler] invoked for card "${a}" (boardId: "${r}")`);else {try{p.chats?.remove(h);}catch{}o.warn(`[chat-handler] dispatch failed for card "${a}": ${V.error||"unknown"}`);}},V=>{try{p.chats?.remove(h);}catch{}o.warn(`[chat-handler] invoke failed for card "${a}": ${V?.message||String(V)}`);});}function pt(a,c,d){let b=c==="chat-send"?S:L,k;b(a,R=>{let I=new Date().toISOString(),p=R.card_data&&typeof R.card_data=="object"?R.card_data:{};if(R.card_data=p,c==="chat-send"){let h=d&&typeof d.text=="string"?d.text.trim():"",$=[];if(Array.isArray(d?.files)){for(let V of d.files)if(V){if(typeof V=="string"){$.push({name:V});continue}if(typeof V=="object"){let F=V;typeof F.name=="string"&&$.push({name:F.name,size:F.size,mime_type:F.mime_type,path:F.path,uploaded_at:F.uploaded_at,stored_name:F.stored_name});}}}if(h||$.length>0){let V=m(a),z=at(a,"user",h,$).path,tt=z.includes("/")?z.slice(z.lastIndexOf("/")+1):z;k={chatsKeyPrefix:`${V}/chats`,lastChatFile:tt};for(let Z of $){if(!Z||typeof Z!="object")continue;let ut=typeof Z.name=="string"?Z.name:"file",ct=typeof Z.stored_name=="string"?Z.stored_name:null;ct&&at(a,"system",`File ${ut} uploaded as ${ct}.`,[]);}}return R}if(c==="file-upload"){let h=E().normalizeIncoming(d?.files,I);return h.length>0&&E().merge(p,h),R}if(c==="action"){let h=d&&typeof d.buttonId=="string"?d.buttonId:"";if(!h)return R;p.lastAction={buttonId:h,at:I},p.lastActionText=`${h} @ ${I}`;}return R}),k&&ft(a,k.chatsKeyPrefix,k.lastChatFile);}function Q(a,c,d){let b=JSON.stringify(d),k=typeof Buffer<"u"?Buffer.byteLength(b):new TextEncoder().encode(b).length;a.writeHead(c,{...n,"Content-Type":"application/json; charset=utf-8","Content-Length":k}),a.end(b);}async function gt(a){let c=[];for await(let b of a)c.push(b);let d=typeof Buffer<"u"?Buffer.concat(c).toString("utf-8").trim():new TextDecoder().decode(vt(c)).trim();return d?JSON.parse(d):{}}async function mt(a){let c=[];for await(let d of a)c.push(d);return typeof Buffer<"u"?Buffer.concat(c):vt(c)}function vt(a){let c=a.reduce((k,R)=>k+R.length,0),d=new Uint8Array(c),b=0;for(let k of a)d.set(k,b),b+=k.length;return d}let xt=0;function Et(a){let c=JSON.stringify(a);return xt++,`id: ${xt}
+data: ${c}
+
+`}function Jt(a){if(!a||a.length===0)return;let c=Et({kind:"notification-batch",notifications:a});for(let d of x)try{d.write(c);}catch{x.delete(d);}}function $t(a,c){c.writeHead(200,{...n,"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"}),x.add(c);let d=Ct(),b=Et(d);c.write(b);let k=setInterval(()=>{try{c.write(`: keepalive
+
+`);}catch{}},15e3);a.on("close",()=>{clearInterval(k),x.delete(c),c.end();});}async function se(a,c,d){let b=a.method||"GET",k=d,R=k.pathname;try{if(b==="GET"&&R===`${e}/init-board`)return await T(),Q(c,200,Ct()),!0;if(b==="GET"&&R===`${e}/sse`){await T(),$t(a,c);for(let F=0;F<C.length;F++)q(C[F]),G(C[F],F);return !0}if(b==="GET"&&R===`${e}/board-status`)return Q(c,200,Ct()),!0;let I=R.match(new RegExp(`^${_t(e)}/cards/([^/]+)$`));if(b==="GET"&&I){await N();let F=decodeURIComponent(I[1]),z=M(F);return z?(Q(c,200,z),!0):(Q(c,404,{error:`card not found: ${F}`}),!0)}if(b==="PATCH"&&I){await N();let F=decodeURIComponent(I[1]),z=await gt(a);return l(F,z),Q(c,200,{ok:!0}),!0}let p=R.match(new RegExp(`^${_t(e)}/cards/([^/]+)/actions$`));if(b==="POST"&&p){await N();let F=decodeURIComponent(p[1]),z=await gt(a);return pt(F,z?.actionType,z?.payload),Q(c,200,{ok:!0}),!0}let h=R.match(new RegExp(`^${_t(e)}/cards/([^/]+)/chats$`));if(b==="GET"&&h){await N();let F=decodeURIComponent(h[1]);return Q(c,200,{ok:!0,messages:rt(F)}),!0}let $=R.match(new RegExp(`^${_t(e)}/cards/([^/]+)/files$`));if(b==="POST"&&$){await N();let F=decodeURIComponent($[1]),z=String(k.searchParams.get("inChat")||"").toLowerCase()==="true",tt=a.headers["x-file-name"],Z=String(a.headers["content-type"]||"application/octet-stream"),ut=Array.isArray(tt)?tt[0]:tt,ct=ut?decodeURIComponent(String(ut)):"upload.bin",Ft=await mt(a);if(!Ft.length)return Q(c,400,{error:"Empty upload body"}),!0;let dt=it(F,ct,Z,Ft);return z&&(S(F,bt=>{let At=new Date().toISOString(),Dt=bt.card_data&&typeof bt.card_data=="object"?bt.card_data:{};bt.card_data=Dt;let zt=E().normalizeIncoming([{name:dt.name,stored_name:dt.stored_name,size:dt.size,mime_type:dt.mime_type,path:dt.path,uploaded_at:dt.uploaded_at||At}],At);return E().merge(Dt,zt),bt}),at(F,"system",`file uploaded: ${dt.name} as ${dt.stored_name}`,[])),Q(c,200,{ok:!0,file:dt}),!0}let V=R.match(new RegExp(`^${_t(e)}/cards/([^/]+)/files/(\\d+)$`));if(b==="GET"&&V){let F=decodeURIComponent(V[1]),z=parseInt(V[2],10),tt=k.searchParams.get("sn"),Z=M(F);if(!Z)return Q(c,404,{error:"Card not found"}),!0;let ut=E().resolve(Z.card_data,z,tt);if(!ut.ok&&ut.reason==="stale_reference")return Q(c,409,{error:"File reference is stale. Refresh and try again."}),!0;if(!ut.ok)return Q(c,404,{error:"File not found"}),!0;let ct=ut.file,Ft=m(F),dt=g(F),bt=`${Ft}/${ct.stored_name}`,At=dt.files?dt.files.getBytes(bt):null;if(!At)return Q(c,404,{error:"File not found"}),!0;let Dt=ct.name||ct.stored_name,zt=ct.mime_type||"application/octet-stream";return c.writeHead(200,{"Content-Type":zt,"Content-Disposition":`attachment; filename="${Dt}"`,"Content-Length":At.length}),c.end(At),!0}return !1}catch(I){let p=I?.statusCode||500;return Q(c,p,{error:String(I?.message||I)}),true}}return {get apiBasePath(){return e},get corsHeaders(){return n},handleRuntimeApi:se,buildPublishedRuntimePayload:Ct,clearChatRecords:H,reportSourceFetched(a,c){let d=C[0];return d?d.board.sourceDataFetched({params:{token:a,ref:c}}):{status:"fail",error:"no board context"}},reportSourceFetchFailure(a,c){let d=C[0];return d?d.board.sourceDataFetchFailure({params:{token:a,reason:c}}):{status:"fail",error:"no board context"}},get cardStore(){return C[0]?.cardStore??{set(){return {status:"fail",error:"no board context"}}}}}}function Pr(t){let e=String(t.apiBasePath||"/api/boards").replace(/\/$/,""),n={...Ye,...t.corsHeaders||{}},r=t.serverMetaStore,o=t.boardRuntimeFactory,s=new Map,i="boards-config.json";function u(){let v=r.getText(i);if(!v)return {boards:[{id:"default",label:"Default Board"}]};try{return JSON.parse(v)}catch{return {boards:[{id:"default",label:"Default Board"}]}}}function f(v){r.putText(i,JSON.stringify(v,null,2));}function x(v){let E=String(v||"").replace(/[^a-zA-Z0-9_-]/g,"_").replace(/^_+|_+$/g,"");return E.length>0&&E.length<=64?E:null}function D(v){if(s.has(v))return s.get(v);let m=u().boards.find(B=>B.id===v)||{},A=o(v,m);return s.set(v,A),A}function C(v,E,m){let A=JSON.stringify(m),B=typeof Buffer<"u"?Buffer.byteLength(A):new TextEncoder().encode(A).length;v.writeHead(E,{...n,"Content-Type":"application/json; charset=utf-8","Content-Length":B}),v.end(A);}async function j(v,E,m){let A=v.method||"GET",B=m.pathname;if(A==="GET"&&B===e)return C(E,200,{ok:true,boards:u().boards}),true;if(A==="POST"&&B===e){let q=[];for await(let X of v)q.push(X);let G=typeof Buffer<"u"?Buffer.concat(q).toString("utf-8").trim():new TextDecoder().decode(Gn(q)).trim(),T={};try{T=G?JSON.parse(G):{};}catch{T={};}let N=x(T.id);if(!N)return C(E,400,{error:"board id must be 1-64 alphanumeric/dash/underscore characters"}),true;let U=u();if(U.boards.some(X=>X.id===N))return C(E,409,{error:`Board "${N}" is already registered`}),true;let M=typeof T.label=="string"&&T.label.trim()?T.label.trim():N,K={id:N,label:M};for(let[X,W]of Object.entries(T))X==="id"||X==="label"||W!=null&&(K[X]=W);return U.boards.push(K),f(U),C(E,200,{ok:true,board:K}),true}return  false}async function w(v,E,m){let B=m.pathname.match(new RegExp(`^${_t(e)}/([^/]+)(/|$)`));if(!B)return  false;let q=x(decodeURIComponent(B[1]));return q?u().boards.some(N=>N.id===q)?!!await D(q).handleRuntimeApi(v,E,m):(C(E,404,{error:`Board "${q}" not registered. POST ${e} with {id} to register it first.`}),true):(C(E,400,{error:"Invalid board id"}),true)}async function g(v,E,m){return !!(await j(v,E,m)||await w(v,E,m))}function y(v){if(!u().boards.some(m=>m.id===v))throw Object.assign(new Error(`Board "${v}" not registered`),{statusCode:404});return {service:D(v)}}return {get apiBasePath(){return e},get corsHeaders(){return n},handleApi:g,requireBoardService:y}}function _t(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Gn(t){let e=t.reduce((o,s)=>o+s.length,0),n=new Uint8Array(e),r=0;for(let o of t)n.set(o,r),r+=o.length;return n}export{Pr as createMultiBoardServerRuntime,Br as createSingleBoardServerRuntime};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/lib/step-machine/index.d.cts

@@ -0,0 +1,64 @@
+export { S as StepMachine, c as createStepMachine, l as loadStepFlow, p as parseStepFlowYaml, v as validateStepFlowConfig } from '../loader-CuuLjxVA.cjs';
+import { e as StepFlowConfig, k as StepMachineState, n as StepResult, m as StepReducerResult } from '../types-DQ1bKuB1.cjs';
+export { C as CircuitBreakerConfig, R as RetryConfig, S as StepConfig, a as StepContext, b as StepEvent, c as StepEventListener, d as StepEventType, f as StepFlowSettings, g as StepHandler, h as StepInput, i as StepMachineOptions, j as StepMachineResult, l as StepMachineStore, T as TerminalStateConfig } from '../types-DQ1bKuB1.cjs';
+
+/**
+ * Step Machine Reducer — Pure Functions
+ *
+ * currentState + stepResult → newState
+ * No I/O, no side effects, deterministic.
+ */
+
+/**
+ * Apply a step result to the current state and compute the next state.
+ * Pure function: no side effects.
+ */
+declare function applyStepResult(flow: StepFlowConfig, state: StepMachineState, stepName: string, stepResult: StepResult): StepReducerResult;
+/**
+ * Check circuit breaker for a step. Returns the redirected step if broken.
+ * Pure function.
+ */
+declare function checkCircuitBreaker(flow: StepFlowConfig, state: StepMachineState, stepName: string): {
+    broken: boolean;
+    redirectStep?: string;
+    newState: StepMachineState;
+};
+/**
+ * Compute what a step needs as input. Pure function.
+ */
+declare function computeStepInput(flow: StepFlowConfig, stepName: string, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Extract return data from terminal state. Pure function.
+ */
+declare function extractReturnData(returnArtifacts: string | string[] | false | undefined, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create initial state for a new run. Pure function.
+ */
+declare function createInitialState(flow: StepFlowConfig, runId: string): StepMachineState;
+
+/**
+ * schema-validator — Full JSON Schema validation for StepFlow configs.
+ *
+ * Uses AJV to validate against the published flow.schema.json.
+ * For a lightweight sync check without AJV, use `validateStepFlowConfig()` instead.
+ *
+ * @example
+ * ```typescript
+ * import { validateFlowSchema } from 'yaml-flow/step-machine';
+ *
+ * const result = validateFlowSchema(config);
+ * if (!result.ok) console.error(result.errors);
+ * ```
+ */
+interface SchemaValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+/**
+ * Validate a step-flow config against the full flow.schema.json (draft-07).
+ *
+ * Requires `ajv` and `ajv-formats` to be installed.
+ */
+declare function validateFlowSchema(config: unknown): SchemaValidationResult;
+
+export { StepFlowConfig, StepMachineState, StepReducerResult, StepResult, applyStepResult, checkCircuitBreaker, computeStepInput, createInitialState, extractReturnData, validateFlowSchema };

package/lib/step-machine/index.d.ts

@@ -0,0 +1,64 @@
+export { S as StepMachine, c as createStepMachine, l as loadStepFlow, p as parseStepFlowYaml, v as validateStepFlowConfig } from '../loader-Zborm2pq.js';
+import { e as StepFlowConfig, k as StepMachineState, n as StepResult, m as StepReducerResult } from '../types-DQ1bKuB1.js';
+export { C as CircuitBreakerConfig, R as RetryConfig, S as StepConfig, a as StepContext, b as StepEvent, c as StepEventListener, d as StepEventType, f as StepFlowSettings, g as StepHandler, h as StepInput, i as StepMachineOptions, j as StepMachineResult, l as StepMachineStore, T as TerminalStateConfig } from '../types-DQ1bKuB1.js';
+
+/**
+ * Step Machine Reducer — Pure Functions
+ *
+ * currentState + stepResult → newState
+ * No I/O, no side effects, deterministic.
+ */
+
+/**
+ * Apply a step result to the current state and compute the next state.
+ * Pure function: no side effects.
+ */
+declare function applyStepResult(flow: StepFlowConfig, state: StepMachineState, stepName: string, stepResult: StepResult): StepReducerResult;
+/**
+ * Check circuit breaker for a step. Returns the redirected step if broken.
+ * Pure function.
+ */
+declare function checkCircuitBreaker(flow: StepFlowConfig, state: StepMachineState, stepName: string): {
+    broken: boolean;
+    redirectStep?: string;
+    newState: StepMachineState;
+};
+/**
+ * Compute what a step needs as input. Pure function.
+ */
+declare function computeStepInput(flow: StepFlowConfig, stepName: string, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Extract return data from terminal state. Pure function.
+ */
+declare function extractReturnData(returnArtifacts: string | string[] | false | undefined, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create initial state for a new run. Pure function.
+ */
+declare function createInitialState(flow: StepFlowConfig, runId: string): StepMachineState;
+
+/**
+ * schema-validator — Full JSON Schema validation for StepFlow configs.
+ *
+ * Uses AJV to validate against the published flow.schema.json.
+ * For a lightweight sync check without AJV, use `validateStepFlowConfig()` instead.
+ *
+ * @example
+ * ```typescript
+ * import { validateFlowSchema } from 'yaml-flow/step-machine';
+ *
+ * const result = validateFlowSchema(config);
+ * if (!result.ok) console.error(result.errors);
+ * ```
+ */
+interface SchemaValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+/**
+ * Validate a step-flow config against the full flow.schema.json (draft-07).
+ *
+ * Requires `ajv` and `ajv-formats` to be installed.
+ */
+declare function validateFlowSchema(config: unknown): SchemaValidationResult;
+
+export { StepFlowConfig, StepMachineState, StepReducerResult, StepResult, applyStepResult, checkCircuitBreaker, computeStepInput, createInitialState, extractReturnData, validateFlowSchema };

package/lib/step-machine-public/index.cjs

@@ -0,0 +1,5 @@
+'use strict';require('ajv-formats');var module$1=require('module'),url=require('url'),path=require('path'),fs=require('fs');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;function R(r,t,e,n){let s=r.steps[e];if(!s)throw new Error(`Step "${e}" not found in flow configuration`);if(n.result==="failure"&&s.retry){let a=t.retryCounts[e]??0;if(a<s.retry.max_attempts)return {newState:{...t,retryCounts:{...t.retryCounts,[e]:a+1},updatedAt:Date.now()},nextStep:e,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 "${e}"`);let i=!!r.terminal_states[o];return {newState:{...t,currentStep:o,stepHistory:[...t.stepHistory,e],retryCounts:{...t.retryCounts,[e]:0},updatedAt:Date.now()},nextStep:o,isTerminal:i,isCircuitBroken:false,shouldRetry:false}}function b(r,t,e){let n=r.steps[e];if(!n?.circuit_breaker)return {broken:false,newState:{...t,iterationCounts:{...t.iterationCounts,[e]:(t.iterationCounts[e]??0)+1},updatedAt:Date.now()}};let s=t.iterationCounts[e]??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,[e]:s+1},updatedAt:Date.now()}}}function j(r,t,e){let n=r.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]=e[o];return s}return {...e}}function E(r,t){if(r===false||r===void 0)return {};if(typeof r=="string")return {[r]:t[r]};if(Array.isArray(r)){let e={};for(let n of r)e[n]=t[n];return e}return {}}function $(r,t){let e=Date.now();return {runId:t,flowId:r.id??"unnamed",currentStep:r.settings.start_step,status:"running",stepHistory:[],iterationCounts:{},retryCounts:{},startedAt:e,updatedAt:e}}var S=class{runs=new Map;data=new Map;async saveRunState(t,e){this.runs.set(t,{...e});}async loadRunState(t){let e=this.runs.get(t);return e?{...e}:null}async deleteRunState(t){this.runs.delete(t),this.data.delete(t);}async setData(t,e,n){this.data.has(t)||this.data.set(t,{});let s=this.data.get(t);s[e]=n;}async getData(t,e){return this.data.get(t)?.[e]}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 tt(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,r=>{let t=Math.random()*16|0;return (r==="x"?t:t&3|8).toString(16)})}var x=class{flow;handlers;store;components;options;listeners=new Map;aborted=false;constructor(t,e,n={}){this.flow=t,this.handlers=new Map(Object.entries(e)),this.store=n.store??new S,this.components=n.components??{},this.options=n,n.signal&&n.signal.addEventListener("abort",()=>{this.aborted=true;}),this.validateFlow();}validateFlow(){let{settings:t,steps:e,terminal_states:n}=this.flow;if(!t?.start_step)throw new Error("Flow must have settings.start_step defined");if(!e||Object.keys(e).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(!e[t.start_step]&&!n[t.start_step])throw new Error(`Start step "${t.start_step}" not found`);for(let[s,o]of Object.entries(e)){for(let[i,a]of Object.entries(o.transitions))if(!e[a]&&!n[a])throw new Error(`Step "${s}" transition "${i}" points to unknown step "${a}"`);if(o.failure_transitions){for(let[i,a]of Object.entries(o.failure_transitions))if(!e[a]&&!n[a])throw new Error(`Step "${s}" failure_transition "${i}" points to unknown step "${a}"`)}}}on(t,e){this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(e);}off(t,e){this.listeners.get(t)?.delete(e);}emit(t){let e=this.listeners.get(t.type);if(e)for(let n of e)try{n(t);}catch{}}sleep(t){return new Promise(e=>setTimeout(e,t))}async run(t){let e=tt(),n=$(this.flow,e);if(await this.store.saveRunState(e,n),t)for(let[s,o]of Object.entries(t))await this.store.setData(e,s,o);this.emit({type:"flow:start",runId:e,timestamp:n.startedAt,data:{initialData:t??{}}});try{return await this.executeLoop(e,n)}catch(s){let o=s instanceof Error?s:new Error(String(s));return this.emit({type:"flow:error",runId:e,timestamp:Date.now(),data:{error:o.message}}),this.options.onError?.(o),n={...n,status:"failed",updatedAt:Date.now()},await this.store.saveRunState(e,n),{runId:e,status:"failed",data:await this.store.getAllData(e),finalStep:n.currentStep,stepHistory:n.stepHistory,durationMs:Date.now()-n.startedAt,error:o}}}async resume(t){let e=await this.store.loadRunState(t);if(!e)throw new Error(`No run found with ID: ${t}`);if(e.status==="completed"||e.status==="failed")throw new Error(`Cannot resume a ${e.status} run`);let n={...e,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 e=await this.store.loadRunState(t);if(!e)throw new Error(`No run found with ID: ${t}`);let n={...e,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,e){let n=this.flow.settings.max_total_steps??100,s=this.flow.settings.timeout_ms,o=e,i=0;for(;i<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 a=o.currentStep,c=this.flow.terminal_states[a];if(c){o={...o,status:"completed",updatedAt:Date.now()},await this.store.saveRunState(t,o);let p=await this.store.getAllData(t),u={runId:t,status:"completed",intent:c.return_intent,data:E(c.return_artifacts,p),finalStep:a,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt};return this.emit({type:"flow:complete",runId:t,timestamp:Date.now(),data:{...u}}),this.options.onComplete?.(u),u}let d=b(this.flow,o,a);if(d.broken){o=d.newState,await this.store.saveRunState(t,o),i++;continue}o=d.newState;let f=await this.store.getAllData(t),l=j(this.flow,a,f),m={runId:t,stepName:a,components:this.components,store:this.store,signal:this.options.signal,emit:(p,u)=>{this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{event:p,payload:u}});}};this.emit({type:"step:start",runId:t,timestamp:Date.now(),data:{step:a,input:l}});let g;try{let p=this.handlers.get(a);if(!p)throw new Error(`No handler registered for step "${a}"`);g=await p(l,m);}catch(p){let u=p instanceof Error?p:new Error(String(p));this.emit({type:"step:error",runId:t,timestamp:Date.now(),data:{step:a,error:u.message}}),g={result:"failure",data:{error:u.message}};}if(g.data)for(let[p,u]of Object.entries(g.data))await this.store.setData(t,p,u);this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{step:a,result:g.result}}),this.options.onStep?.(a,g);let w=R(this.flow,o,a,g);if(o=w.newState,w.shouldRetry){await this.store.saveRunState(t,o);let p=this.flow.steps[a];if(p.retry?.delay_ms){let u=o.retryCounts[a]??0,h=p.retry.backoff_multiplier?p.retry.delay_ms*Math.pow(p.retry.backoff_multiplier,u-1):p.retry.delay_ms;await this.sleep(h);}i++;continue}await this.store.saveRunState(t,o),this.emit({type:"transition",runId:t,timestamp:Date.now(),data:{from:a,to:o.currentStep,result:g.result}}),this.options.onTransition?.(a,o.currentStep),i++;}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 H(r,t,e){return new x(r,t,e)}async function C(r){return (await import('yaml')).parse(r)}async function et(r){let t=await fetch(r);if(!t.ok)throw new Error(`Failed to load flow from ${r}: ${t.statusText}`);let e=t.headers.get("content-type")??"",n=await t.text();return e.includes("json")||r.endsWith(".json")?JSON.parse(n):C(n)}async function rt(r){let e=await(await import('fs/promises')).readFile(r,"utf-8");return r.endsWith(".json")?JSON.parse(e):C(e)}function M(r){let t=[];if(!r||typeof r!="object")return ["Flow must be an object"];let e=r;if(!e.settings||typeof e.settings!="object"?t.push('Flow must have a "settings" object'):typeof e.settings.start_step!="string"&&t.push("settings.start_step must be a string"),!e.steps||typeof e.steps!="object")t.push('Flow must have a "steps" object');else {let n=e.steps;for(let[s,o]of Object.entries(n)){if(!o||typeof o!="object"){t.push(`Step "${s}" must be an object`);continue}let i=o;(!i.transitions||typeof i.transitions!="object")&&t.push(`Step "${s}" must have a "transitions" object`),i.failure_transitions!==void 0&&typeof i.failure_transitions!="object"&&t.push(`Step "${s}" failure_transitions must be an object when provided`);}}if(!e.terminal_states||typeof e.terminal_states!="object")t.push('Flow must have a "terminal_states" object');else {let n=e.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 D(r){let t;typeof r=="string"?r.startsWith("http://")||r.startsWith("https://")?t=await et(r):r.includes("{")?t=JSON.parse(r):t=await rt(r):t=r;let e=M(t);if(e.length>0)throw new Error(`Invalid step flow configuration:
+- ${e.join(`
+- `)}`);return t}function A(r){return btoa(r).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function P(r){return atob(r.replace(/-/g,"+").replace(/_/g,"/"))}var F=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${A(t)}`}dataPrefix(t){return `data_${A(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${A(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,n){this.kv.write(this.dataKey(t,e),n);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),n={};for(let s of this.kv.listKeys(e))n[P(s.slice(e.length))]=this.kv.read(s);return n}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>P(t.slice(6)))}};var J=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),it=module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));function pt(){let r=path.resolve(J,"./jsonata-sync.cjs");return fs.existsSync(r)?r:path.resolve(J,"../card-compute/jsonata-sync.cjs")}var v=it(pt());function K(r,t){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${t}" returned a non-object result.`);let e=r,n=e.result??e.status;if(typeof n=="string"&&n.trim().length>0){let s=e.data&&typeof e.data=="object"&&!Array.isArray(e.data)?{...e.data}:{},o=typeof e.error=="string"?e.error:void 0;return o&&!("error"in s)&&(s.error=o),{result:n,data:s,...o?{error:o}:{}}}return {result:"success",data:{...e}}}function B(r,t){if(!t||t.length===0)return r;let e={};for(let n of t)Object.prototype.hasOwnProperty.call(r,n)&&(e[n]=r[n]);return e}function _(r,t){return async(e,n)=>{let s=await r(e,n),o=K(s,n?.stepName??"unknown");return {result:o.result,data:B(o.data,t),...o.error?{error:o.error}:{}}}}function z(r,t,e){if(!t||t.length===0)return null;for(let n of t)try{if(!v(n).evaluate(r))return {result:"failure",data:{error:`[${e}] input validation failed: ${n}`}}}catch(s){let o=s instanceof Error?s.message:String(s);return {result:"failure",data:{error:`[${e}] input validation error on "${n}": ${o}`}}}return null}function T(r,t,e){return !t||t.length===0?r:async(n,s)=>{let o=z(n,t,e);return o||r(n,s)}}var L=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),dt=module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));function gt(){let r=path.resolve(L,"./jsonata-sync.cjs");return fs.existsSync(r)?r:path.resolve(L,"../../card-compute/jsonata-sync.cjs")}var k=dt(gt());function N(r,t,e){if(!r||typeof r!="object")return t;let n={output:t},s=t.result,o=t.data,i=t.error;if(typeof r.resultExpr=="string")try{let a=k(r.resultExpr).evaluate(n);if(typeof a!="string"||!a.trim())throw new Error(`resultExpr did not produce a non-empty string (got ${JSON.stringify(a)})`);s=a;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.resultExpr failed: ${c}`)}if(typeof r.dataTemplate=="string")try{let a=k(r.dataTemplate).evaluate(n);if(!a||typeof a!="object"||Array.isArray(a))throw new Error(`dataTemplate did not produce an object (got ${JSON.stringify(a)})`);o=a;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.dataTemplate failed: ${c}`)}if(typeof r.errorExpr=="string")try{let a=k(r.errorExpr).evaluate(n);i=a!=null?String(a):void 0;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.errorExpr failed: ${c}`)}return i!==void 0?{result:s,data:o,error:i}:{result:s,data:o}}var mt="b64:";function wt(r){let t=new TextEncoder().encode(r),e=globalThis.Buffer,n;if(e)n=e.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 U(r){return `${mt}${wt(JSON.stringify(r))}`}function W(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function q(r){if(!r||typeof r!="object")return  false;let t=r;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 e=t.whatToRun;return typeof e.kind=="string"&&typeof e.value=="string"}return  false}function ht(r){if(typeof r=="string"){let t=r.indexOf("=");if(t<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,t).trim(),expr:r.slice(t+1).trim()}}if(r&&typeof r=="object"&&typeof r.bindTo=="string"&&typeof r.expr=="string")return r;throw new Error(`[step-machine-public] Invalid compute step: ${JSON.stringify(r)}`)}function yt(r,t,e){let n=t.split("."),s=r;for(let o=0;o<n.length-1;o++){let i=n[o];(s[i]==null||typeof s[i]!="object")&&(s[i]={}),s=s[i];}s[n[n.length-1]]=e;}function I(r,t,e){let n=r.expr.map(ht);return async s=>{let o=s&&typeof s=="object"&&!Array.isArray(s)?{...s}:{},i={},a={expects_data:o,data:i,...e?{config:e}:{}},c,d;for(let f of n)try{let l=v(f.expr).evaluate(a);if(f.bindTo==="result")c=l!=null?String(l):"success";else if(f.bindTo==="error")d=l!=null?String(l):void 0;else if(f.bindTo.startsWith("data."))yt(i,f.bindTo.slice(5),l);else return {result:"failure",data:{},error:`[${t}] invalid bindTo "${f.bindTo}": must be "result", "error", or start with "data."`}}catch(l){let m=l instanceof Error?l.message:String(l);return {result:"failure",data:{},error:`[${t}] compute "${f.bindTo}" failed: ${m}`}}return c===void 0?{result:"failure",data:{},error:`[${t}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:d?{result:c,data:i,error:d}:{result:c,data:i}}}function Y(r,t,e,n){let{type:s,...o}=r,i={...o,whatToRun:typeof o.whatToRun=="object"?U(o.whatToRun):o.whatToRun};return async a=>{let c=a&&typeof a=="object"&&!Array.isArray(a)?{...a}:{};n&&(c.config=n);try{let d=await e(i,c);if(!r.outputTransforms)return d;try{return N(r.outputTransforms,d,t)}catch(f){let l=f instanceof Error?f.message:String(f);return {result:"failure",data:{},error:l}}}catch(d){let f=d instanceof Error?d.message:String(d);return {result:"failure",data:{error:`[step-machine-public] step "${t}" invoke threw: ${f}`}}}}}function X(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function St(r,t,e){return async(n,s)=>{let o=n?.[t.items];if(!Array.isArray(o))return {result:"failure",data:{},error:`[${e}] forEach: "${t.items}" is not an array (got ${typeof o})`};let i=o,a=t.collectAs??`${t.items}_results`;if(i.length===0)return {result:"success",data:{[a]:[]}};let{[t.items]:c,...d}=n,f=Math.max(1,t.concurrency??1),l=new Array(i.length),m=0,g=0,w=0;return await new Promise(p=>{function u(){for(;m<f&&g<i.length;){let h=g++;m++;let Q={...d,[t.as]:i[h]};r(Q,s).then(y=>{l[h]=y;}).catch(y=>{let Z=y instanceof Error?y.message:String(y);l[h]={result:"failure",data:{},error:Z};}).finally(()=>{m--,l[h]?.result==="failure"&&w++,g>=i.length&&m===0?p():u();});}m===0&&g>=i.length&&p();}u();}),w>0?{result:"failure",data:{errors:l.filter(u=>u.result==="failure").map(u=>u.error)},error:`[${e}] forEach: ${w}/${i.length} items failed`}:{result:"success",data:{[a]:l.map(p=>p.data)}}}}function G(r,t,e){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,i=t?.handler,a;return W(i)?a=I(i,r,o):q(i)?a=Y(i,r,e.invoke,o):a=X(),t?.forEach&&(a=St(a,t.forEach,r)),T(_(a,n),s,r)}function vt(r,t){let e={};for(let[n,s]of Object.entries(r.steps??{}))e[n]=G(n,s,t);return e}
+exports.KVStorageStore=F;exports.MemoryStore=S;exports.buildStepHandlersForFlow=vt;exports.createComputeJsonataHandler=I;exports.createPassthroughHandler=X;exports.createRefStepHandler=Y;exports.createStepMachine=H;exports.filterProducedData=B;exports.isComputeJsonataSpec=W;exports.isRefSpec=q;exports.jsonata=v;exports.loadStepFlow=D;exports.normalizeHandlerResult=K;exports.resolveStepHandler=G;exports.runInputValidations=z;exports.wrapWithInputValidations=T;exports.wrapWithOutputFiltering=_;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/{dist → lib}/step-machine-public/index.d.cts

@@ -1,4 +1,9 @@
+export { c as createStepMachine, l as loadStepFlow } from '../loader-CuuLjxVA.cjs';
+export { l as StepMachineStore } from '../types-DQ1bKuB1.cjs';
+export { MemoryStore } from '../stores/memory.cjs';
+export { KVStorageStore } from '../stores/kv.cjs';
 import { ExecutionRef } from '../execution-refs.cjs';
+import '../storage-interface-BhAON-gW.cjs';
 
 /**
  * step-machine-public — types
@@ -43,6 +48,13 @@ interface ComputeJsonataSpec {
  *
  * The engine never invokes refs directly — invocation is delegated to an
  * `InvokeFn` adapter (e.g. Node spawn, HTTP, Azure Function).
+ *
+ * `whatToRun` may be either:
+ *   - a `b64:<base64url(json)>` wire string (programmatically generated)
+ *   - a plain `{ kind, value }` object (human-authored flow files)
+ *
+ * The handler factory normalizes the object form via `serializeRef` before
+ * dispatching, so downstream adapters always receive the string form.
  */
 interface RefSpec extends ExecutionRef {
     type: 'ref';
@@ -54,7 +66,8 @@ type HandlerSpec = ComputeJsonataSpec | RefSpec;
  * actually invoke the ref and normalizes the outcome to {result, data, error?}.
  *
  * `args` is the flat flow context for the step. The adapter is responsible
- * for honoring `ref.argsMassaging` (cmdTemplate / urlTemplate / bodyTemplate)
+ * for honoring `ref.argsMassaging` (cmdTemplate / stdinTemplate for local,
+ * urlTemplate / headerTemplate / bodyTemplate for HTTP)
  * before performing the transport.
  *
  * May return synchronously (sync transports) or as a Promise (async transports).
@@ -82,6 +95,13 @@ interface StepConfigForFactory {
     produces_data?: string[];
     input_validations?: string[];
     config?: Record<string, unknown>;
+    forEach?: ForEachConfig;
+}
+interface ForEachConfig {
+    items: string;
+    as: string;
+    concurrency?: number;
+    collectAs?: string;
 }
 
 /**

package/{dist → lib}/step-machine-public/index.d.ts

@@ -1,4 +1,9 @@
+export { c as createStepMachine, l as loadStepFlow } from '../loader-Zborm2pq.js';
+export { l as StepMachineStore } from '../types-DQ1bKuB1.js';
+export { MemoryStore } from '../stores/memory.js';
+export { KVStorageStore } from '../stores/kv.js';
 import { ExecutionRef } from '../execution-refs.js';
+import '../storage-interface-BhAON-gW.js';
 
 /**
  * step-machine-public — types
@@ -43,6 +48,13 @@ interface ComputeJsonataSpec {
  *
  * The engine never invokes refs directly — invocation is delegated to an
  * `InvokeFn` adapter (e.g. Node spawn, HTTP, Azure Function).
+ *
+ * `whatToRun` may be either:
+ *   - a `b64:<base64url(json)>` wire string (programmatically generated)
+ *   - a plain `{ kind, value }` object (human-authored flow files)
+ *
+ * The handler factory normalizes the object form via `serializeRef` before
+ * dispatching, so downstream adapters always receive the string form.
  */
 interface RefSpec extends ExecutionRef {
     type: 'ref';
@@ -54,7 +66,8 @@ type HandlerSpec = ComputeJsonataSpec | RefSpec;
  * actually invoke the ref and normalizes the outcome to {result, data, error?}.
  *
  * `args` is the flat flow context for the step. The adapter is responsible
- * for honoring `ref.argsMassaging` (cmdTemplate / urlTemplate / bodyTemplate)
+ * for honoring `ref.argsMassaging` (cmdTemplate / stdinTemplate for local,
+ * urlTemplate / headerTemplate / bodyTemplate for HTTP)
  * before performing the transport.
  *
  * May return synchronously (sync transports) or as a Promise (async transports).
@@ -82,6 +95,13 @@ interface StepConfigForFactory {
     produces_data?: string[];
     input_validations?: string[];
     config?: Record<string, unknown>;
+    forEach?: ForEachConfig;
+}
+interface ForEachConfig {
+    items: string;
+    as: string;
+    concurrency?: number;
+    collectAs?: string;
 }
 
 /**

package/lib/step-machine-public/index.js

@@ -0,0 +1,5 @@
+import'ajv-formats';import {createRequire}from'module';import {fileURLToPath}from'url';import {dirname,resolve}from'path';import {existsSync}from'fs';function R(r,t,e,n){let s=r.steps[e];if(!s)throw new Error(`Step "${e}" not found in flow configuration`);if(n.result==="failure"&&s.retry){let a=t.retryCounts[e]??0;if(a<s.retry.max_attempts)return {newState:{...t,retryCounts:{...t.retryCounts,[e]:a+1},updatedAt:Date.now()},nextStep:e,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 "${e}"`);let i=!!r.terminal_states[o];return {newState:{...t,currentStep:o,stepHistory:[...t.stepHistory,e],retryCounts:{...t.retryCounts,[e]:0},updatedAt:Date.now()},nextStep:o,isTerminal:i,isCircuitBroken:false,shouldRetry:false}}function b(r,t,e){let n=r.steps[e];if(!n?.circuit_breaker)return {broken:false,newState:{...t,iterationCounts:{...t.iterationCounts,[e]:(t.iterationCounts[e]??0)+1},updatedAt:Date.now()}};let s=t.iterationCounts[e]??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,[e]:s+1},updatedAt:Date.now()}}}function j(r,t,e){let n=r.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]=e[o];return s}return {...e}}function E(r,t){if(r===false||r===void 0)return {};if(typeof r=="string")return {[r]:t[r]};if(Array.isArray(r)){let e={};for(let n of r)e[n]=t[n];return e}return {}}function $(r,t){let e=Date.now();return {runId:t,flowId:r.id??"unnamed",currentStep:r.settings.start_step,status:"running",stepHistory:[],iterationCounts:{},retryCounts:{},startedAt:e,updatedAt:e}}var S=class{runs=new Map;data=new Map;async saveRunState(t,e){this.runs.set(t,{...e});}async loadRunState(t){let e=this.runs.get(t);return e?{...e}:null}async deleteRunState(t){this.runs.delete(t),this.data.delete(t);}async setData(t,e,n){this.data.has(t)||this.data.set(t,{});let s=this.data.get(t);s[e]=n;}async getData(t,e){return this.data.get(t)?.[e]}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 tt(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,r=>{let t=Math.random()*16|0;return (r==="x"?t:t&3|8).toString(16)})}var x=class{flow;handlers;store;components;options;listeners=new Map;aborted=false;constructor(t,e,n={}){this.flow=t,this.handlers=new Map(Object.entries(e)),this.store=n.store??new S,this.components=n.components??{},this.options=n,n.signal&&n.signal.addEventListener("abort",()=>{this.aborted=true;}),this.validateFlow();}validateFlow(){let{settings:t,steps:e,terminal_states:n}=this.flow;if(!t?.start_step)throw new Error("Flow must have settings.start_step defined");if(!e||Object.keys(e).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(!e[t.start_step]&&!n[t.start_step])throw new Error(`Start step "${t.start_step}" not found`);for(let[s,o]of Object.entries(e)){for(let[i,a]of Object.entries(o.transitions))if(!e[a]&&!n[a])throw new Error(`Step "${s}" transition "${i}" points to unknown step "${a}"`);if(o.failure_transitions){for(let[i,a]of Object.entries(o.failure_transitions))if(!e[a]&&!n[a])throw new Error(`Step "${s}" failure_transition "${i}" points to unknown step "${a}"`)}}}on(t,e){this.listeners.has(t)||this.listeners.set(t,new Set),this.listeners.get(t).add(e);}off(t,e){this.listeners.get(t)?.delete(e);}emit(t){let e=this.listeners.get(t.type);if(e)for(let n of e)try{n(t);}catch{}}sleep(t){return new Promise(e=>setTimeout(e,t))}async run(t){let e=tt(),n=$(this.flow,e);if(await this.store.saveRunState(e,n),t)for(let[s,o]of Object.entries(t))await this.store.setData(e,s,o);this.emit({type:"flow:start",runId:e,timestamp:n.startedAt,data:{initialData:t??{}}});try{return await this.executeLoop(e,n)}catch(s){let o=s instanceof Error?s:new Error(String(s));return this.emit({type:"flow:error",runId:e,timestamp:Date.now(),data:{error:o.message}}),this.options.onError?.(o),n={...n,status:"failed",updatedAt:Date.now()},await this.store.saveRunState(e,n),{runId:e,status:"failed",data:await this.store.getAllData(e),finalStep:n.currentStep,stepHistory:n.stepHistory,durationMs:Date.now()-n.startedAt,error:o}}}async resume(t){let e=await this.store.loadRunState(t);if(!e)throw new Error(`No run found with ID: ${t}`);if(e.status==="completed"||e.status==="failed")throw new Error(`Cannot resume a ${e.status} run`);let n={...e,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 e=await this.store.loadRunState(t);if(!e)throw new Error(`No run found with ID: ${t}`);let n={...e,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,e){let n=this.flow.settings.max_total_steps??100,s=this.flow.settings.timeout_ms,o=e,i=0;for(;i<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 a=o.currentStep,c=this.flow.terminal_states[a];if(c){o={...o,status:"completed",updatedAt:Date.now()},await this.store.saveRunState(t,o);let p=await this.store.getAllData(t),u={runId:t,status:"completed",intent:c.return_intent,data:E(c.return_artifacts,p),finalStep:a,stepHistory:o.stepHistory,durationMs:Date.now()-o.startedAt};return this.emit({type:"flow:complete",runId:t,timestamp:Date.now(),data:{...u}}),this.options.onComplete?.(u),u}let d=b(this.flow,o,a);if(d.broken){o=d.newState,await this.store.saveRunState(t,o),i++;continue}o=d.newState;let f=await this.store.getAllData(t),l=j(this.flow,a,f),m={runId:t,stepName:a,components:this.components,store:this.store,signal:this.options.signal,emit:(p,u)=>{this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{event:p,payload:u}});}};this.emit({type:"step:start",runId:t,timestamp:Date.now(),data:{step:a,input:l}});let g;try{let p=this.handlers.get(a);if(!p)throw new Error(`No handler registered for step "${a}"`);g=await p(l,m);}catch(p){let u=p instanceof Error?p:new Error(String(p));this.emit({type:"step:error",runId:t,timestamp:Date.now(),data:{step:a,error:u.message}}),g={result:"failure",data:{error:u.message}};}if(g.data)for(let[p,u]of Object.entries(g.data))await this.store.setData(t,p,u);this.emit({type:"step:complete",runId:t,timestamp:Date.now(),data:{step:a,result:g.result}}),this.options.onStep?.(a,g);let w=R(this.flow,o,a,g);if(o=w.newState,w.shouldRetry){await this.store.saveRunState(t,o);let p=this.flow.steps[a];if(p.retry?.delay_ms){let u=o.retryCounts[a]??0,h=p.retry.backoff_multiplier?p.retry.delay_ms*Math.pow(p.retry.backoff_multiplier,u-1):p.retry.delay_ms;await this.sleep(h);}i++;continue}await this.store.saveRunState(t,o),this.emit({type:"transition",runId:t,timestamp:Date.now(),data:{from:a,to:o.currentStep,result:g.result}}),this.options.onTransition?.(a,o.currentStep),i++;}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 H(r,t,e){return new x(r,t,e)}async function C(r){return (await import('yaml')).parse(r)}async function et(r){let t=await fetch(r);if(!t.ok)throw new Error(`Failed to load flow from ${r}: ${t.statusText}`);let e=t.headers.get("content-type")??"",n=await t.text();return e.includes("json")||r.endsWith(".json")?JSON.parse(n):C(n)}async function rt(r){let e=await(await import('fs/promises')).readFile(r,"utf-8");return r.endsWith(".json")?JSON.parse(e):C(e)}function M(r){let t=[];if(!r||typeof r!="object")return ["Flow must be an object"];let e=r;if(!e.settings||typeof e.settings!="object"?t.push('Flow must have a "settings" object'):typeof e.settings.start_step!="string"&&t.push("settings.start_step must be a string"),!e.steps||typeof e.steps!="object")t.push('Flow must have a "steps" object');else {let n=e.steps;for(let[s,o]of Object.entries(n)){if(!o||typeof o!="object"){t.push(`Step "${s}" must be an object`);continue}let i=o;(!i.transitions||typeof i.transitions!="object")&&t.push(`Step "${s}" must have a "transitions" object`),i.failure_transitions!==void 0&&typeof i.failure_transitions!="object"&&t.push(`Step "${s}" failure_transitions must be an object when provided`);}}if(!e.terminal_states||typeof e.terminal_states!="object")t.push('Flow must have a "terminal_states" object');else {let n=e.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 D(r){let t;typeof r=="string"?r.startsWith("http://")||r.startsWith("https://")?t=await et(r):r.includes("{")?t=JSON.parse(r):t=await rt(r):t=r;let e=M(t);if(e.length>0)throw new Error(`Invalid step flow configuration:
+- ${e.join(`
+- `)}`);return t}function A(r){return btoa(r).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function P(r){return atob(r.replace(/-/g,"+").replace(/_/g,"/"))}var F=class{constructor(t){this.kv=t;}kv;stateKey(t){return `state_${A(t)}`}dataPrefix(t){return `data_${A(t)}_`}dataKey(t,e){return `${this.dataPrefix(t)}${A(e)}`}async saveRunState(t,e){this.kv.write(this.stateKey(t),e);}async loadRunState(t){let e=this.kv.read(this.stateKey(t));return e!=null&&typeof e=="object"?e:null}async deleteRunState(t){this.kv.delete(this.stateKey(t));for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async setData(t,e,n){this.kv.write(this.dataKey(t,e),n);}async getData(t,e){return this.kv.read(this.dataKey(t,e))}async getAllData(t){let e=this.dataPrefix(t),n={};for(let s of this.kv.listKeys(e))n[P(s.slice(e.length))]=this.kv.read(s);return n}async clearData(t){for(let e of this.kv.listKeys(this.dataPrefix(t)))this.kv.delete(e);}async listRuns(){return this.kv.listKeys("state_").map(t=>P(t.slice(6)))}};var J=dirname(fileURLToPath(import.meta.url)),it=createRequire(import.meta.url);function pt(){let r=resolve(J,"./jsonata-sync.cjs");return existsSync(r)?r:resolve(J,"../card-compute/jsonata-sync.cjs")}var v=it(pt());function K(r,t){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${t}" returned a non-object result.`);let e=r,n=e.result??e.status;if(typeof n=="string"&&n.trim().length>0){let s=e.data&&typeof e.data=="object"&&!Array.isArray(e.data)?{...e.data}:{},o=typeof e.error=="string"?e.error:void 0;return o&&!("error"in s)&&(s.error=o),{result:n,data:s,...o?{error:o}:{}}}return {result:"success",data:{...e}}}function B(r,t){if(!t||t.length===0)return r;let e={};for(let n of t)Object.prototype.hasOwnProperty.call(r,n)&&(e[n]=r[n]);return e}function _(r,t){return async(e,n)=>{let s=await r(e,n),o=K(s,n?.stepName??"unknown");return {result:o.result,data:B(o.data,t),...o.error?{error:o.error}:{}}}}function z(r,t,e){if(!t||t.length===0)return null;for(let n of t)try{if(!v(n).evaluate(r))return {result:"failure",data:{error:`[${e}] input validation failed: ${n}`}}}catch(s){let o=s instanceof Error?s.message:String(s);return {result:"failure",data:{error:`[${e}] input validation error on "${n}": ${o}`}}}return null}function T(r,t,e){return !t||t.length===0?r:async(n,s)=>{let o=z(n,t,e);return o||r(n,s)}}var L=dirname(fileURLToPath(import.meta.url)),dt=createRequire(import.meta.url);function gt(){let r=resolve(L,"./jsonata-sync.cjs");return existsSync(r)?r:resolve(L,"../../card-compute/jsonata-sync.cjs")}var k=dt(gt());function N(r,t,e){if(!r||typeof r!="object")return t;let n={output:t},s=t.result,o=t.data,i=t.error;if(typeof r.resultExpr=="string")try{let a=k(r.resultExpr).evaluate(n);if(typeof a!="string"||!a.trim())throw new Error(`resultExpr did not produce a non-empty string (got ${JSON.stringify(a)})`);s=a;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.resultExpr failed: ${c}`)}if(typeof r.dataTemplate=="string")try{let a=k(r.dataTemplate).evaluate(n);if(!a||typeof a!="object"||Array.isArray(a))throw new Error(`dataTemplate did not produce an object (got ${JSON.stringify(a)})`);o=a;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.dataTemplate failed: ${c}`)}if(typeof r.errorExpr=="string")try{let a=k(r.errorExpr).evaluate(n);i=a!=null?String(a):void 0;}catch(a){let c=a instanceof Error?a.message:String(a);throw new Error(`[${e}] outputTransforms.errorExpr failed: ${c}`)}return i!==void 0?{result:s,data:o,error:i}:{result:s,data:o}}var mt="b64:";function wt(r){let t=new TextEncoder().encode(r),e=globalThis.Buffer,n;if(e)n=e.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 U(r){return `${mt}${wt(JSON.stringify(r))}`}function W(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function q(r){if(!r||typeof r!="object")return  false;let t=r;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 e=t.whatToRun;return typeof e.kind=="string"&&typeof e.value=="string"}return  false}function ht(r){if(typeof r=="string"){let t=r.indexOf("=");if(t<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,t).trim(),expr:r.slice(t+1).trim()}}if(r&&typeof r=="object"&&typeof r.bindTo=="string"&&typeof r.expr=="string")return r;throw new Error(`[step-machine-public] Invalid compute step: ${JSON.stringify(r)}`)}function yt(r,t,e){let n=t.split("."),s=r;for(let o=0;o<n.length-1;o++){let i=n[o];(s[i]==null||typeof s[i]!="object")&&(s[i]={}),s=s[i];}s[n[n.length-1]]=e;}function I(r,t,e){let n=r.expr.map(ht);return async s=>{let o=s&&typeof s=="object"&&!Array.isArray(s)?{...s}:{},i={},a={expects_data:o,data:i,...e?{config:e}:{}},c,d;for(let f of n)try{let l=v(f.expr).evaluate(a);if(f.bindTo==="result")c=l!=null?String(l):"success";else if(f.bindTo==="error")d=l!=null?String(l):void 0;else if(f.bindTo.startsWith("data."))yt(i,f.bindTo.slice(5),l);else return {result:"failure",data:{},error:`[${t}] invalid bindTo "${f.bindTo}": must be "result", "error", or start with "data."`}}catch(l){let m=l instanceof Error?l.message:String(l);return {result:"failure",data:{},error:`[${t}] compute "${f.bindTo}" failed: ${m}`}}return c===void 0?{result:"failure",data:{},error:`[${t}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:d?{result:c,data:i,error:d}:{result:c,data:i}}}function Y(r,t,e,n){let{type:s,...o}=r,i={...o,whatToRun:typeof o.whatToRun=="object"?U(o.whatToRun):o.whatToRun};return async a=>{let c=a&&typeof a=="object"&&!Array.isArray(a)?{...a}:{};n&&(c.config=n);try{let d=await e(i,c);if(!r.outputTransforms)return d;try{return N(r.outputTransforms,d,t)}catch(f){let l=f instanceof Error?f.message:String(f);return {result:"failure",data:{},error:l}}}catch(d){let f=d instanceof Error?d.message:String(d);return {result:"failure",data:{error:`[step-machine-public] step "${t}" invoke threw: ${f}`}}}}}function X(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function St(r,t,e){return async(n,s)=>{let o=n?.[t.items];if(!Array.isArray(o))return {result:"failure",data:{},error:`[${e}] forEach: "${t.items}" is not an array (got ${typeof o})`};let i=o,a=t.collectAs??`${t.items}_results`;if(i.length===0)return {result:"success",data:{[a]:[]}};let{[t.items]:c,...d}=n,f=Math.max(1,t.concurrency??1),l=new Array(i.length),m=0,g=0,w=0;return await new Promise(p=>{function u(){for(;m<f&&g<i.length;){let h=g++;m++;let Q={...d,[t.as]:i[h]};r(Q,s).then(y=>{l[h]=y;}).catch(y=>{let Z=y instanceof Error?y.message:String(y);l[h]={result:"failure",data:{},error:Z};}).finally(()=>{m--,l[h]?.result==="failure"&&w++,g>=i.length&&m===0?p():u();});}m===0&&g>=i.length&&p();}u();}),w>0?{result:"failure",data:{errors:l.filter(u=>u.result==="failure").map(u=>u.error)},error:`[${e}] forEach: ${w}/${i.length} items failed`}:{result:"success",data:{[a]:l.map(p=>p.data)}}}}function G(r,t,e){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,i=t?.handler,a;return W(i)?a=I(i,r,o):q(i)?a=Y(i,r,e.invoke,o):a=X(),t?.forEach&&(a=St(a,t.forEach,r)),T(_(a,n),s,r)}function vt(r,t){let e={};for(let[n,s]of Object.entries(r.steps??{}))e[n]=G(n,s,t);return e}
+export{F as KVStorageStore,S as MemoryStore,vt as buildStepHandlersForFlow,I as createComputeJsonataHandler,X as createPassthroughHandler,Y as createRefStepHandler,H as createStepMachine,B as filterProducedData,W as isComputeJsonataSpec,q as isRefSpec,v as jsonata,D as loadStepFlow,K as normalizeHandlerResult,G as resolveStepHandler,z as runInputValidations,T as wrapWithInputValidations,_ as wrapWithOutputFiltering};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/lib/storage-interface-BhAON-gW.d.cts

@@ -0,0 +1,84 @@
+/**
+ * storage-interface.ts
+ *
+ * Three minimal storage primitives that together cover all persistence needs
+ * of the board-live-cards system. Any backend (Node fs, CosmosDB, Azure Blob,
+ * browser localStorage, in-memory test double) implements these three interfaces.
+ *
+ * The pure-logic stores in board-live-cards-all-stores.ts depend only on these
+ * interfaces — never on Node built-ins.
+ *
+ *  Blob    — raw string content at a logical, backend-neutral key
+ *  Journal — append-only log with cursor-based reads
+ *  KV      — key-value store with list/delete
+ *
+ * Mapping to existing storage adapters:
+ *
+ *   CardStorageAdapter
+ *     inventory (cardId → { blobRef, checksum, fileMetadata? })  → KV
+ *     card JSON files                                             → Blob
+ *     source output files                                         → Blob
+ *
+ *   JournalStorageAdapter     → Journal (board-journal.jsonl)
+ *
+ *   ExecutionRequestStore → KV (keyed by journalId, via createFsKvStorage)
+ *
+ *   StateSnapshotStorageAdapter
+ *     board-graph.json (packed single JSON, written atomically)   → Blob
+ *     per-card sidecars (cards/<id>/runtime, fetched-sources-manifest) → KV
+ */
+interface BlobStat {
+    key: string;
+    size: number;
+    updatedAt?: string;
+    contentType?: string;
+}
+interface BlobStorage {
+    /** Returns raw content string, or null if the blob does not exist. */
+    read(key: string): string | null;
+    /** Write content at key. Implementations should be atomic (write-rename). */
+    write(key: string, content: string): void;
+    /** Returns true if a blob exists at key. */
+    exists(key: string): boolean;
+    /** Delete the blob at key. No-op if it does not exist. */
+    remove(key: string): void;
+    /** Optional binary read for file-like artifacts. */
+    readBytes?(key: string): Uint8Array | null;
+    /** Optional binary write for file-like artifacts. */
+    writeBytes?(key: string, content: Uint8Array): void;
+    /** Optional key listing by prefix. */
+    listKeys?(prefix?: string): string[];
+    /** Optional metadata lookup. */
+    stat?(key: string): BlobStat | null;
+}
+interface KindValueRef {
+    readonly kind: string;
+    readonly value: string;
+}
+/** Serialize a KindValueRef to the wire format: b64:<base64url(json)> */
+declare function serializeRef(ref: KindValueRef): string;
+/** Parse a wire-format ref string (b64:<base64url(json)>) into a KindValueRef. */
+declare function parseRef(s: string): KindValueRef;
+interface KVStorage {
+    /** Returns the stored value, or null if the key does not exist. */
+    read(key: string): unknown | null;
+    /** Write value at key. Overwrites any existing value. */
+    write(key: string, value: unknown): void;
+    /** Delete the key. No-op if it does not exist. */
+    delete(key: string): void;
+    /**
+     * List all keys, optionally filtered to those starting with prefix.
+     * Order is implementation-defined.
+     */
+    listKeys(prefix?: string): string[];
+}
+interface AtomicRelayLock {
+    /**
+     * Attempt to acquire the lock without blocking.
+     * Returns a `release` function if successful, or `null` if the lock is
+     * already held by another actor (relay: that actor will complete the work).
+     */
+    tryAcquire(): (() => void) | null;
+}
+
+export { type AtomicRelayLock as A, type BlobStorage as B, type KVStorage as K, type KindValueRef as a, parseRef as p, serializeRef as s };