yaml-flow 8.7.1 → 8.8.0

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

@@ -1,2 +1,2 @@
-'use strict';var chunkPMUSJQSR_cjs=require('../chunk-PMUSJQSR.cjs'),chunkQ6H7NINN_cjs=require('../chunk-Q6H7NINN.cjs'),chunkH5KD3JPY_cjs=require('../chunk-H5KD3JPY.cjs'),chunkKHJABJ45_cjs=require('../chunk-KHJABJ45.cjs'),chunkSFVO2LB2_cjs=require('../chunk-SFVO2LB2.cjs');require('../chunk-UJ7ZTV4J.cjs'),require('../chunk-GNFE24S7.cjs');var module$1=require('module'),url=require('url'),path=require('path'),fs=require('fs');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var C=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)))),K=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 L(){let r=path.resolve(C,"./jsonata-sync.cjs");return fs.existsSync(r)?r:path.resolve(C,"../card-compute/jsonata-sync.cjs")}var h=K(L());function T(r,e){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${e}" returned a non-object result.`);let t=r,n=t.result??t.status;if(typeof n=="string"&&n.trim().length>0){let o=t.data&&typeof t.data=="object"&&!Array.isArray(t.data)?{...t.data}:{},a=typeof t.error=="string"?t.error:void 0;return a&&!("error"in o)&&(o.error=a),{result:n,data:o,...a?{error:a}:{}}}return {result:"success",data:{...t}}}function $(r,e){if(!e||e.length===0)return r;let t={};for(let n of e)Object.prototype.hasOwnProperty.call(r,n)&&(t[n]=r[n]);return t}function x(r,e){return async(t,n)=>{let o=await r(t,n),a=T(o,n?.stepName??"unknown");return {result:a.result,data:$(a.data,e),...a.error?{error:a.error}:{}}}}function M(r,e,t){if(!e||e.length===0)return null;for(let n of e)try{if(!h(n).evaluate(r))return {result:"failure",data:{error:`[${t}] input validation failed: ${n}`}}}catch(o){let a=o instanceof Error?o.message:String(o);return {result:"failure",data:{error:`[${t}] input validation error on "${n}": ${a}`}}}return null}function F(r,e,t){return !e||e.length===0?r:async(n,o)=>{let a=M(n,e,t);return a||r(n,o)}}function A(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function O(r){if(!r||typeof r!="object")return  false;let e=r;if(e.type!=="ref"||typeof e.howToRun!="string")return  false;if(typeof e.whatToRun=="string")return  true;if(e.whatToRun&&typeof e.whatToRun=="object"){let t=e.whatToRun;return typeof t.kind=="string"&&typeof t.value=="string"}return  false}function U(r){if(typeof r=="string"){let e=r.indexOf("=");if(e<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,e).trim(),expr:r.slice(e+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 G(r,e,t){let n=e.split("."),o=r;for(let a=0;a<n.length-1;a++){let s=n[a];(o[s]==null||typeof o[s]!="object")&&(o[s]={}),o=o[s];}o[n[n.length-1]]=t;}function I(r,e,t){let n=r.expr.map(U);return async o=>{let a=o&&typeof o=="object"&&!Array.isArray(o)?{...o}:{},s={},l={expects_data:a,data:s,...t?{config:t}:{}},p,i;for(let u of n)try{let c=h(u.expr).evaluate(l);if(u.bindTo==="result")p=c!=null?String(c):"success";else if(u.bindTo==="error")i=c!=null?String(c):void 0;else if(u.bindTo.startsWith("data."))G(s,u.bindTo.slice(5),c);else return {result:"failure",data:{},error:`[${e}] invalid bindTo "${u.bindTo}": must be "result", "error", or start with "data."`}}catch(c){let d=c instanceof Error?c.message:String(c);return {result:"failure",data:{},error:`[${e}] compute "${u.bindTo}" failed: ${d}`}}return p===void 0?{result:"failure",data:{},error:`[${e}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:i?{result:p,data:s,error:i}:{result:p,data:s}}}function E(r,e,t,n){let{type:o,...a}=r,s={...a,whatToRun:typeof a.whatToRun=="object"?chunkSFVO2LB2_cjs.a(a.whatToRun):a.whatToRun};return async l=>{let p=l&&typeof l=="object"&&!Array.isArray(l)?{...l}:{};n&&(p.config=n);try{let i=await t(s,p);if(!r.outputTransforms)return i;if(i&&i.result!=="success"){let u=i.data&&typeof i.data.error=="string"?String(i.data.error):void 0;return u&&!i.error?{...i,error:u}:i}try{return chunkPMUSJQSR_cjs.b(r.outputTransforms,i,e)}catch(u){let c=u instanceof Error?u.message:String(u);return {result:"failure",data:{},error:c}}}catch(i){let u=i instanceof Error?i.message:String(i);return {result:"failure",data:{error:`[step-machine-public] step "${e}" invoke threw: ${u}`}}}}}function z(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function Q(r,e,t){return async(n,o)=>{let a=n?.[e.items];if(!Array.isArray(a))return {result:"failure",data:{},error:`[${t}] forEach: "${e.items}" is not an array (got ${typeof a})`};let s=a,l=e.collectAs??`${e.items}_results`;if(s.length===0)return {result:"success",data:{[l]:[]}};let{[e.items]:p,...i}=n,u=Math.max(1,e.concurrency??1),c=new Array(s.length),d=0,w=0,S=0;return await new Promise(g=>{function f(){for(;d<u&&w<s.length;){let y=w++;d++;let _={...i,[e.as]:s[y]};r(_,o).then(m=>{c[y]=m;}).catch(m=>{let P=m instanceof Error?m.message:String(m);c[y]={result:"failure",data:{},error:P};}).finally(()=>{d--,c[y]?.result==="failure"&&S++,w>=s.length&&d===0?g():f();});}d===0&&w>=s.length&&g();}f();}),S>0?{result:"failure",data:{errors:c.filter(f=>f.result==="failure").map(f=>f.error)},error:`[${t}] forEach: ${S}/${s.length} items failed`}:{result:"success",data:{[l]:c.map(g=>g.data)}}}}function J(r,e,t){let n=Array.isArray(e?.produces_data)?e?.produces_data:void 0,o=Array.isArray(e?.input_validations)?e?.input_validations:void 0,a=e?.config??void 0,s=e?.handler,l;return A(s)?l=I(s,r,a):O(s)?l=E(s,r,t.invoke,a):l=z(),e?.forEach&&(l=Q(l,e.forEach,r)),F(x(l,n),o,r)}function H(r,e){let t={};for(let[n,o]of Object.entries(r.steps??{}))t[n]=J(n,o,e);return t}function X(r){let e=r.storeFactory||(()=>new chunkH5KD3JPY_cjs.a);return {async run(t,n){try{let o=H(t,{invoke:r.invokeRef}),s=await chunkQ6H7NINN_cjs.g(t,o,{store:e()}).run(n);return s.status!=="completed"?{dispatched:!1,error:s.error?.message||s.status}:{dispatched:!0}}catch(o){return {dispatched:false,error:o instanceof Error?o.message:String(o)}}}}}Object.defineProperty(exports,"createStepMachine",{enumerable:true,get:function(){return chunkQ6H7NINN_cjs.g}});Object.defineProperty(exports,"loadStepFlow",{enumerable:true,get:function(){return chunkQ6H7NINN_cjs.j}});Object.defineProperty(exports,"MemoryStore",{enumerable:true,get:function(){return chunkH5KD3JPY_cjs.a}});Object.defineProperty(exports,"KVStorageStore",{enumerable:true,get:function(){return chunkKHJABJ45_cjs.a}});exports.buildStepHandlersForFlow=H;exports.createComputeJsonataHandler=I;exports.createPassthroughHandler=z;exports.createRefStepHandler=E;exports.createStepMachineChatFlowRunner=X;exports.filterProducedData=$;exports.isComputeJsonataSpec=A;exports.isRefSpec=O;exports.jsonata=h;exports.normalizeHandlerResult=T;exports.resolveStepHandler=J;exports.runInputValidations=M;exports.wrapWithInputValidations=F;exports.wrapWithOutputFiltering=x;//# sourceMappingURL=index.cjs.map
+'use strict';var chunk3CZCGNY4_cjs=require('../chunk-3CZCGNY4.cjs'),chunkQ6H7NINN_cjs=require('../chunk-Q6H7NINN.cjs'),chunkH5KD3JPY_cjs=require('../chunk-H5KD3JPY.cjs'),chunkKHJABJ45_cjs=require('../chunk-KHJABJ45.cjs'),chunkVQCIOKJV_cjs=require('../chunk-VQCIOKJV.cjs');require('../chunk-UJ7ZTV4J.cjs'),require('../chunk-GNFE24S7.cjs');var module$1=require('module'),url=require('url'),path=require('path'),fs=require('fs');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var C=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)))),K=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 L(){let r=path.resolve(C,"./jsonata-sync.cjs");return fs.existsSync(r)?r:path.resolve(C,"../card-compute/jsonata-sync.cjs")}var h=K(L());function T(r,e){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${e}" returned a non-object result.`);let t=r,n=t.result??t.status;if(typeof n=="string"&&n.trim().length>0){let o=t.data&&typeof t.data=="object"&&!Array.isArray(t.data)?{...t.data}:{},a=typeof t.error=="string"?t.error:void 0;return a&&!("error"in o)&&(o.error=a),{result:n,data:o,...a?{error:a}:{}}}return {result:"success",data:{...t}}}function $(r,e){if(!e||e.length===0)return r;let t={};for(let n of e)Object.prototype.hasOwnProperty.call(r,n)&&(t[n]=r[n]);return t}function x(r,e){return async(t,n)=>{let o=await r(t,n),a=T(o,n?.stepName??"unknown");return {result:a.result,data:$(a.data,e),...a.error?{error:a.error}:{}}}}function M(r,e,t){if(!e||e.length===0)return null;for(let n of e)try{if(!h(n).evaluate(r))return {result:"failure",data:{error:`[${t}] input validation failed: ${n}`}}}catch(o){let a=o instanceof Error?o.message:String(o);return {result:"failure",data:{error:`[${t}] input validation error on "${n}": ${a}`}}}return null}function F(r,e,t){return !e||e.length===0?r:async(n,o)=>{let a=M(n,e,t);return a||r(n,o)}}function A(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function O(r){if(!r||typeof r!="object")return  false;let e=r;if(e.type!=="ref"||typeof e.howToRun!="string")return  false;if(typeof e.whatToRun=="string")return  true;if(e.whatToRun&&typeof e.whatToRun=="object"){let t=e.whatToRun;return typeof t.kind=="string"&&typeof t.value=="string"}return  false}function U(r){if(typeof r=="string"){let e=r.indexOf("=");if(e<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,e).trim(),expr:r.slice(e+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 G(r,e,t){let n=e.split("."),o=r;for(let a=0;a<n.length-1;a++){let s=n[a];(o[s]==null||typeof o[s]!="object")&&(o[s]={}),o=o[s];}o[n[n.length-1]]=t;}function I(r,e,t){let n=r.expr.map(U);return async o=>{let a=o&&typeof o=="object"&&!Array.isArray(o)?{...o}:{},s={},l={expects_data:a,data:s,...t?{config:t}:{}},p,i;for(let u of n)try{let c=h(u.expr).evaluate(l);if(u.bindTo==="result")p=c!=null?String(c):"success";else if(u.bindTo==="error")i=c!=null?String(c):void 0;else if(u.bindTo.startsWith("data."))G(s,u.bindTo.slice(5),c);else return {result:"failure",data:{},error:`[${e}] invalid bindTo "${u.bindTo}": must be "result", "error", or start with "data."`}}catch(c){let d=c instanceof Error?c.message:String(c);return {result:"failure",data:{},error:`[${e}] compute "${u.bindTo}" failed: ${d}`}}return p===void 0?{result:"failure",data:{},error:`[${e}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:i?{result:p,data:s,error:i}:{result:p,data:s}}}function E(r,e,t,n){let{type:o,...a}=r,s={...a,whatToRun:typeof a.whatToRun=="object"?chunkVQCIOKJV_cjs.a(a.whatToRun):a.whatToRun};return async l=>{let p=l&&typeof l=="object"&&!Array.isArray(l)?{...l}:{};n&&(p.config=n);try{let i=await t(s,p);if(!r.outputTransforms)return i;if(i&&i.result!=="success"){let u=i.data&&typeof i.data.error=="string"?String(i.data.error):void 0;return u&&!i.error?{...i,error:u}:i}try{return chunk3CZCGNY4_cjs.b(r.outputTransforms,i,e)}catch(u){let c=u instanceof Error?u.message:String(u);return {result:"failure",data:{},error:c}}}catch(i){let u=i instanceof Error?i.message:String(i);return {result:"failure",data:{error:`[step-machine-public] step "${e}" invoke threw: ${u}`}}}}}function z(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function Q(r,e,t){return async(n,o)=>{let a=n?.[e.items];if(!Array.isArray(a))return {result:"failure",data:{},error:`[${t}] forEach: "${e.items}" is not an array (got ${typeof a})`};let s=a,l=e.collectAs??`${e.items}_results`;if(s.length===0)return {result:"success",data:{[l]:[]}};let{[e.items]:p,...i}=n,u=Math.max(1,e.concurrency??1),c=new Array(s.length),d=0,w=0,S=0;return await new Promise(g=>{function f(){for(;d<u&&w<s.length;){let y=w++;d++;let _={...i,[e.as]:s[y]};r(_,o).then(m=>{c[y]=m;}).catch(m=>{let P=m instanceof Error?m.message:String(m);c[y]={result:"failure",data:{},error:P};}).finally(()=>{d--,c[y]?.result==="failure"&&S++,w>=s.length&&d===0?g():f();});}d===0&&w>=s.length&&g();}f();}),S>0?{result:"failure",data:{errors:c.filter(f=>f.result==="failure").map(f=>f.error)},error:`[${t}] forEach: ${S}/${s.length} items failed`}:{result:"success",data:{[l]:c.map(g=>g.data)}}}}function J(r,e,t){let n=Array.isArray(e?.produces_data)?e?.produces_data:void 0,o=Array.isArray(e?.input_validations)?e?.input_validations:void 0,a=e?.config??void 0,s=e?.handler,l;return A(s)?l=I(s,r,a):O(s)?l=E(s,r,t.invoke,a):l=z(),e?.forEach&&(l=Q(l,e.forEach,r)),F(x(l,n),o,r)}function H(r,e){let t={};for(let[n,o]of Object.entries(r.steps??{}))t[n]=J(n,o,e);return t}function X(r){let e=r.storeFactory||(()=>new chunkH5KD3JPY_cjs.a);return {async run(t,n){try{let o=H(t,{invoke:r.invokeRef}),s=await chunkQ6H7NINN_cjs.g(t,o,{store:e()}).run(n);return s.status!=="completed"?{dispatched:!1,error:s.error?.message||s.status}:{dispatched:!0}}catch(o){return {dispatched:false,error:o instanceof Error?o.message:String(o)}}}}}Object.defineProperty(exports,"createStepMachine",{enumerable:true,get:function(){return chunkQ6H7NINN_cjs.g}});Object.defineProperty(exports,"loadStepFlow",{enumerable:true,get:function(){return chunkQ6H7NINN_cjs.j}});Object.defineProperty(exports,"MemoryStore",{enumerable:true,get:function(){return chunkH5KD3JPY_cjs.a}});Object.defineProperty(exports,"KVStorageStore",{enumerable:true,get:function(){return chunkKHJABJ45_cjs.a}});exports.buildStepHandlersForFlow=H;exports.createComputeJsonataHandler=I;exports.createPassthroughHandler=z;exports.createRefStepHandler=E;exports.createStepMachineChatFlowRunner=X;exports.filterProducedData=$;exports.isComputeJsonataSpec=A;exports.isRefSpec=O;exports.jsonata=h;exports.normalizeHandlerResult=T;exports.resolveStepHandler=J;exports.runInputValidations=M;exports.wrapWithInputValidations=F;exports.wrapWithOutputFiltering=x;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -3,7 +3,7 @@ import { l as StepMachineStore } from '../types-DjlwALZC.cjs';
 export { MemoryStore } from '../stores/memory.cjs';
 export { KVStorageStore } from '../stores/kv.cjs';
 import { ExecutionRef } from '../execution-refs.cjs';
-import '../storage-interface-BFiD3kyB.cjs';
+import '../storage-interface-D-iEiTJA.cjs';
 
 /**
  * The single normalized shape the engine consumes.

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

@@ -3,7 +3,7 @@ import { l as StepMachineStore } from '../types-DjlwALZC.js';
 export { MemoryStore } from '../stores/memory.js';
 export { KVStorageStore } from '../stores/kv.js';
 import { ExecutionRef } from '../execution-refs.js';
-import '../storage-interface-BFiD3kyB.js';
+import '../storage-interface-D-iEiTJA.js';
 
 /**
  * The single normalized shape the engine consumes.

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

@@ -1,2 +1,2 @@
-import {b}from'../chunk-CIAJNUR4.js';import {g}from'../chunk-QWBNDVUA.js';export{g as createStepMachine,j as loadStepFlow}from'../chunk-QWBNDVUA.js';import {a as a$1}from'../chunk-JM5EKT57.js';export{a as MemoryStore}from'../chunk-JM5EKT57.js';export{a as KVStorageStore}from'../chunk-FZ2SBU5M.js';import {a}from'../chunk-BQS3EIEK.js';import'../chunk-MNEOJWPS.js';import'../chunk-FW4363Y4.js';import {createRequire}from'module';import {fileURLToPath}from'url';import {dirname,resolve}from'path';import {existsSync}from'fs';var C=dirname(fileURLToPath(import.meta.url)),K=createRequire(import.meta.url);function L(){let r=resolve(C,"./jsonata-sync.cjs");return existsSync(r)?r:resolve(C,"../card-compute/jsonata-sync.cjs")}var h=K(L());function T(r,e){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${e}" returned a non-object result.`);let t=r,n=t.result??t.status;if(typeof n=="string"&&n.trim().length>0){let o=t.data&&typeof t.data=="object"&&!Array.isArray(t.data)?{...t.data}:{},a=typeof t.error=="string"?t.error:void 0;return a&&!("error"in o)&&(o.error=a),{result:n,data:o,...a?{error:a}:{}}}return {result:"success",data:{...t}}}function $(r,e){if(!e||e.length===0)return r;let t={};for(let n of e)Object.prototype.hasOwnProperty.call(r,n)&&(t[n]=r[n]);return t}function x(r,e){return async(t,n)=>{let o=await r(t,n),a=T(o,n?.stepName??"unknown");return {result:a.result,data:$(a.data,e),...a.error?{error:a.error}:{}}}}function M(r,e,t){if(!e||e.length===0)return null;for(let n of e)try{if(!h(n).evaluate(r))return {result:"failure",data:{error:`[${t}] input validation failed: ${n}`}}}catch(o){let a=o instanceof Error?o.message:String(o);return {result:"failure",data:{error:`[${t}] input validation error on "${n}": ${a}`}}}return null}function F(r,e,t){return !e||e.length===0?r:async(n,o)=>{let a=M(n,e,t);return a||r(n,o)}}function A(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function O(r){if(!r||typeof r!="object")return  false;let e=r;if(e.type!=="ref"||typeof e.howToRun!="string")return  false;if(typeof e.whatToRun=="string")return  true;if(e.whatToRun&&typeof e.whatToRun=="object"){let t=e.whatToRun;return typeof t.kind=="string"&&typeof t.value=="string"}return  false}function U(r){if(typeof r=="string"){let e=r.indexOf("=");if(e<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,e).trim(),expr:r.slice(e+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 G(r,e,t){let n=e.split("."),o=r;for(let a=0;a<n.length-1;a++){let s=n[a];(o[s]==null||typeof o[s]!="object")&&(o[s]={}),o=o[s];}o[n[n.length-1]]=t;}function I(r,e,t){let n=r.expr.map(U);return async o=>{let a=o&&typeof o=="object"&&!Array.isArray(o)?{...o}:{},s={},l={expects_data:a,data:s,...t?{config:t}:{}},p,i;for(let u of n)try{let c=h(u.expr).evaluate(l);if(u.bindTo==="result")p=c!=null?String(c):"success";else if(u.bindTo==="error")i=c!=null?String(c):void 0;else if(u.bindTo.startsWith("data."))G(s,u.bindTo.slice(5),c);else return {result:"failure",data:{},error:`[${e}] invalid bindTo "${u.bindTo}": must be "result", "error", or start with "data."`}}catch(c){let d=c instanceof Error?c.message:String(c);return {result:"failure",data:{},error:`[${e}] compute "${u.bindTo}" failed: ${d}`}}return p===void 0?{result:"failure",data:{},error:`[${e}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:i?{result:p,data:s,error:i}:{result:p,data:s}}}function E(r,e,t,n){let{type:o,...a$1}=r,s={...a$1,whatToRun:typeof a$1.whatToRun=="object"?a(a$1.whatToRun):a$1.whatToRun};return async l=>{let p=l&&typeof l=="object"&&!Array.isArray(l)?{...l}:{};n&&(p.config=n);try{let i=await t(s,p);if(!r.outputTransforms)return i;if(i&&i.result!=="success"){let u=i.data&&typeof i.data.error=="string"?String(i.data.error):void 0;return u&&!i.error?{...i,error:u}:i}try{return b(r.outputTransforms,i,e)}catch(u){let c=u instanceof Error?u.message:String(u);return {result:"failure",data:{},error:c}}}catch(i){let u=i instanceof Error?i.message:String(i);return {result:"failure",data:{error:`[step-machine-public] step "${e}" invoke threw: ${u}`}}}}}function z(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function Q(r,e,t){return async(n,o)=>{let a=n?.[e.items];if(!Array.isArray(a))return {result:"failure",data:{},error:`[${t}] forEach: "${e.items}" is not an array (got ${typeof a})`};let s=a,l=e.collectAs??`${e.items}_results`;if(s.length===0)return {result:"success",data:{[l]:[]}};let{[e.items]:p,...i}=n,u=Math.max(1,e.concurrency??1),c=new Array(s.length),d=0,w=0,S=0;return await new Promise(g=>{function f(){for(;d<u&&w<s.length;){let y=w++;d++;let _={...i,[e.as]:s[y]};r(_,o).then(m=>{c[y]=m;}).catch(m=>{let P=m instanceof Error?m.message:String(m);c[y]={result:"failure",data:{},error:P};}).finally(()=>{d--,c[y]?.result==="failure"&&S++,w>=s.length&&d===0?g():f();});}d===0&&w>=s.length&&g();}f();}),S>0?{result:"failure",data:{errors:c.filter(f=>f.result==="failure").map(f=>f.error)},error:`[${t}] forEach: ${S}/${s.length} items failed`}:{result:"success",data:{[l]:c.map(g=>g.data)}}}}function J(r,e,t){let n=Array.isArray(e?.produces_data)?e?.produces_data:void 0,o=Array.isArray(e?.input_validations)?e?.input_validations:void 0,a=e?.config??void 0,s=e?.handler,l;return A(s)?l=I(s,r,a):O(s)?l=E(s,r,t.invoke,a):l=z(),e?.forEach&&(l=Q(l,e.forEach,r)),F(x(l,n),o,r)}function H(r,e){let t={};for(let[n,o]of Object.entries(r.steps??{}))t[n]=J(n,o,e);return t}function X(r){let e=r.storeFactory||(()=>new a$1);return {async run(t,n){try{let o=H(t,{invoke:r.invokeRef}),s=await g(t,o,{store:e()}).run(n);return s.status!=="completed"?{dispatched:!1,error:s.error?.message||s.status}:{dispatched:!0}}catch(o){return {dispatched:false,error:o instanceof Error?o.message:String(o)}}}}}export{H as buildStepHandlersForFlow,I as createComputeJsonataHandler,z as createPassthroughHandler,E as createRefStepHandler,X as createStepMachineChatFlowRunner,$ as filterProducedData,A as isComputeJsonataSpec,O as isRefSpec,h as jsonata,T as normalizeHandlerResult,J as resolveStepHandler,M as runInputValidations,F as wrapWithInputValidations,x as wrapWithOutputFiltering};//# sourceMappingURL=index.js.map
+import {b}from'../chunk-VGDLSS2H.js';import {g}from'../chunk-QWBNDVUA.js';export{g as createStepMachine,j as loadStepFlow}from'../chunk-QWBNDVUA.js';import {a as a$1}from'../chunk-JM5EKT57.js';export{a as MemoryStore}from'../chunk-JM5EKT57.js';export{a as KVStorageStore}from'../chunk-FZ2SBU5M.js';import {a}from'../chunk-44L64VQ2.js';import'../chunk-MNEOJWPS.js';import'../chunk-FW4363Y4.js';import {createRequire}from'module';import {fileURLToPath}from'url';import {dirname,resolve}from'path';import {existsSync}from'fs';var C=dirname(fileURLToPath(import.meta.url)),K=createRequire(import.meta.url);function L(){let r=resolve(C,"./jsonata-sync.cjs");return existsSync(r)?r:resolve(C,"../card-compute/jsonata-sync.cjs")}var h=K(L());function T(r,e){if(!r||typeof r!="object")throw new Error(`[step-machine-public] Step "${e}" returned a non-object result.`);let t=r,n=t.result??t.status;if(typeof n=="string"&&n.trim().length>0){let o=t.data&&typeof t.data=="object"&&!Array.isArray(t.data)?{...t.data}:{},a=typeof t.error=="string"?t.error:void 0;return a&&!("error"in o)&&(o.error=a),{result:n,data:o,...a?{error:a}:{}}}return {result:"success",data:{...t}}}function $(r,e){if(!e||e.length===0)return r;let t={};for(let n of e)Object.prototype.hasOwnProperty.call(r,n)&&(t[n]=r[n]);return t}function x(r,e){return async(t,n)=>{let o=await r(t,n),a=T(o,n?.stepName??"unknown");return {result:a.result,data:$(a.data,e),...a.error?{error:a.error}:{}}}}function M(r,e,t){if(!e||e.length===0)return null;for(let n of e)try{if(!h(n).evaluate(r))return {result:"failure",data:{error:`[${t}] input validation failed: ${n}`}}}catch(o){let a=o instanceof Error?o.message:String(o);return {result:"failure",data:{error:`[${t}] input validation error on "${n}": ${a}`}}}return null}function F(r,e,t){return !e||e.length===0?r:async(n,o)=>{let a=M(n,e,t);return a||r(n,o)}}function A(r){return !!r&&typeof r=="object"&&r.type==="compute-jsonata"&&Array.isArray(r.expr)&&r.expr.length>0}function O(r){if(!r||typeof r!="object")return  false;let e=r;if(e.type!=="ref"||typeof e.howToRun!="string")return  false;if(typeof e.whatToRun=="string")return  true;if(e.whatToRun&&typeof e.whatToRun=="object"){let t=e.whatToRun;return typeof t.kind=="string"&&typeof t.value=="string"}return  false}function U(r){if(typeof r=="string"){let e=r.indexOf("=");if(e<1)throw new Error(`[step-machine-public] Invalid compute expression (missing "="): "${r}"`);return {bindTo:r.slice(0,e).trim(),expr:r.slice(e+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 G(r,e,t){let n=e.split("."),o=r;for(let a=0;a<n.length-1;a++){let s=n[a];(o[s]==null||typeof o[s]!="object")&&(o[s]={}),o=o[s];}o[n[n.length-1]]=t;}function I(r,e,t){let n=r.expr.map(U);return async o=>{let a=o&&typeof o=="object"&&!Array.isArray(o)?{...o}:{},s={},l={expects_data:a,data:s,...t?{config:t}:{}},p,i;for(let u of n)try{let c=h(u.expr).evaluate(l);if(u.bindTo==="result")p=c!=null?String(c):"success";else if(u.bindTo==="error")i=c!=null?String(c):void 0;else if(u.bindTo.startsWith("data."))G(s,u.bindTo.slice(5),c);else return {result:"failure",data:{},error:`[${e}] invalid bindTo "${u.bindTo}": must be "result", "error", or start with "data."`}}catch(c){let d=c instanceof Error?c.message:String(c);return {result:"failure",data:{},error:`[${e}] compute "${u.bindTo}" failed: ${d}`}}return p===void 0?{result:"failure",data:{},error:`[${e}] compute-jsonata: no "result" binding declared \u2014 add '- result = "success"' to expr`}:i?{result:p,data:s,error:i}:{result:p,data:s}}}function E(r,e,t,n){let{type:o,...a$1}=r,s={...a$1,whatToRun:typeof a$1.whatToRun=="object"?a(a$1.whatToRun):a$1.whatToRun};return async l=>{let p=l&&typeof l=="object"&&!Array.isArray(l)?{...l}:{};n&&(p.config=n);try{let i=await t(s,p);if(!r.outputTransforms)return i;if(i&&i.result!=="success"){let u=i.data&&typeof i.data.error=="string"?String(i.data.error):void 0;return u&&!i.error?{...i,error:u}:i}try{return b(r.outputTransforms,i,e)}catch(u){let c=u instanceof Error?u.message:String(u);return {result:"failure",data:{},error:c}}}catch(i){let u=i instanceof Error?i.message:String(i);return {result:"failure",data:{error:`[step-machine-public] step "${e}" invoke threw: ${u}`}}}}}function z(){return async r=>({result:"success",data:r&&typeof r=="object"&&!Array.isArray(r)?r:{}})}function Q(r,e,t){return async(n,o)=>{let a=n?.[e.items];if(!Array.isArray(a))return {result:"failure",data:{},error:`[${t}] forEach: "${e.items}" is not an array (got ${typeof a})`};let s=a,l=e.collectAs??`${e.items}_results`;if(s.length===0)return {result:"success",data:{[l]:[]}};let{[e.items]:p,...i}=n,u=Math.max(1,e.concurrency??1),c=new Array(s.length),d=0,w=0,S=0;return await new Promise(g=>{function f(){for(;d<u&&w<s.length;){let y=w++;d++;let _={...i,[e.as]:s[y]};r(_,o).then(m=>{c[y]=m;}).catch(m=>{let P=m instanceof Error?m.message:String(m);c[y]={result:"failure",data:{},error:P};}).finally(()=>{d--,c[y]?.result==="failure"&&S++,w>=s.length&&d===0?g():f();});}d===0&&w>=s.length&&g();}f();}),S>0?{result:"failure",data:{errors:c.filter(f=>f.result==="failure").map(f=>f.error)},error:`[${t}] forEach: ${S}/${s.length} items failed`}:{result:"success",data:{[l]:c.map(g=>g.data)}}}}function J(r,e,t){let n=Array.isArray(e?.produces_data)?e?.produces_data:void 0,o=Array.isArray(e?.input_validations)?e?.input_validations:void 0,a=e?.config??void 0,s=e?.handler,l;return A(s)?l=I(s,r,a):O(s)?l=E(s,r,t.invoke,a):l=z(),e?.forEach&&(l=Q(l,e.forEach,r)),F(x(l,n),o,r)}function H(r,e){let t={};for(let[n,o]of Object.entries(r.steps??{}))t[n]=J(n,o,e);return t}function X(r){let e=r.storeFactory||(()=>new a$1);return {async run(t,n){try{let o=H(t,{invoke:r.invokeRef}),s=await g(t,o,{store:e()}).run(n);return s.status!=="completed"?{dispatched:!1,error:s.error?.message||s.status}:{dispatched:!0}}catch(o){return {dispatched:false,error:o instanceof Error?o.message:String(o)}}}}}export{H as buildStepHandlersForFlow,I as createComputeJsonataHandler,z as createPassthroughHandler,E as createRefStepHandler,X as createStepMachineChatFlowRunner,$ as filterProducedData,A as isComputeJsonataSpec,O as isRefSpec,h as jsonata,T as normalizeHandlerResult,J as resolveStepHandler,M as runInputValidations,F as wrapWithInputValidations,x as wrapWithOutputFiltering};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/lib/{storage-async-interface-BRR4eBjx.d.cts → storage-async-interface-CG0bMqvE.d.ts}

@@ -1,4 +1,4 @@
-import { b as BlobStat, a as KindValueRef, c as JournalEntry, d as JournalReadResult, Q as QueueMessage, e as QueueLeasedMessage, f as QueueDeadLetterMessage } from './storage-interface-BFiD3kyB.cjs';
+import { b as BlobStat, a as KindValueRef, Q as QueueMessage, c as QueueLeasedMessage, d as QueueDeadLetterMessage, J as JournalEntry, e as JournalReadResult } from './storage-interface-D-iEiTJA.js';
 
 interface AsyncBlobStorage {
     read(key: string): Promise<string | null>;
@@ -10,6 +10,13 @@ interface AsyncBlobStorage {
     listKeys(prefix?: string): Promise<string[]>;
     stat?(key: string): Promise<BlobStat | null>;
     keyRef?(key: string): Promise<KindValueRef> | KindValueRef;
+    /**
+     * Atomically move content from `from` to `to`, replacing any existing value at `to`.
+     * Returns true on success, false if `from` does not exist.
+     * If the underlying adapter does not support a first-class rename operation,
+     * implement a simple fallback: read `from`, write `to`, then delete `from`.
+     */
+    renameKey(from: string, to: string): Promise<boolean>;
 }
 interface AsyncJournalStorage {
     append(payload: unknown): Promise<JournalEntry>;
@@ -19,6 +26,8 @@ interface AsyncJournalStorage {
 }
 interface AsyncQueueStorage {
     enqueue<T>(body: T): Promise<QueueMessage<T>>;
+    /** See QueueStorage.enqueueMany. */
+    enqueueMany<T>(bodies: T[]): Promise<QueueMessage<T>[]>;
     /** See QueueStorage.enqueueIfAbsent. Optional on adapters that cannot cheaply dedup. */
     enqueueIfAbsent?<T>(body: T, dedupKey: string): Promise<QueueMessage<T> | null>;
     lease<T>(opts?: {
@@ -32,6 +41,16 @@ interface AsyncQueueStorage {
     }): Promise<boolean>;
     peekActive<T>(prefix?: string): Promise<QueueMessage<T>[]>;
     peekDeadLetter<T>(prefix?: string): Promise<QueueDeadLetterMessage<T>[]>;
+    /** See QueueStorage.stage. */
+    stage<T>(body: T, opts?: {
+        dedupKey?: string;
+    }): Promise<QueueMessage<T> | null>;
+    /** See QueueStorage.commitStaged. */
+    commitStaged(messageId: string): Promise<boolean>;
+    /** See QueueStorage.discardStaged. */
+    discardStaged(messageId: string, reason?: string): Promise<boolean>;
+    /** See QueueStorage.peekStaged. */
+    peekStaged<T>(prefix?: string): Promise<QueueMessage<T>[]>;
 }
 interface AsyncKVStorage {
     read(key: string): Promise<unknown | null>;

package/lib/{storage-async-interface-DhlOVPSp.d.ts → storage-async-interface-CyO-zwVQ.d.cts}

@@ -1,4 +1,4 @@
-import { b as BlobStat, a as KindValueRef, c as JournalEntry, d as JournalReadResult, Q as QueueMessage, e as QueueLeasedMessage, f as QueueDeadLetterMessage } from './storage-interface-BFiD3kyB.js';
+import { b as BlobStat, a as KindValueRef, Q as QueueMessage, c as QueueLeasedMessage, d as QueueDeadLetterMessage, J as JournalEntry, e as JournalReadResult } from './storage-interface-D-iEiTJA.cjs';
 
 interface AsyncBlobStorage {
     read(key: string): Promise<string | null>;
@@ -10,6 +10,13 @@ interface AsyncBlobStorage {
     listKeys(prefix?: string): Promise<string[]>;
     stat?(key: string): Promise<BlobStat | null>;
     keyRef?(key: string): Promise<KindValueRef> | KindValueRef;
+    /**
+     * Atomically move content from `from` to `to`, replacing any existing value at `to`.
+     * Returns true on success, false if `from` does not exist.
+     * If the underlying adapter does not support a first-class rename operation,
+     * implement a simple fallback: read `from`, write `to`, then delete `from`.
+     */
+    renameKey(from: string, to: string): Promise<boolean>;
 }
 interface AsyncJournalStorage {
     append(payload: unknown): Promise<JournalEntry>;
@@ -19,6 +26,8 @@ interface AsyncJournalStorage {
 }
 interface AsyncQueueStorage {
     enqueue<T>(body: T): Promise<QueueMessage<T>>;
+    /** See QueueStorage.enqueueMany. */
+    enqueueMany<T>(bodies: T[]): Promise<QueueMessage<T>[]>;
     /** See QueueStorage.enqueueIfAbsent. Optional on adapters that cannot cheaply dedup. */
     enqueueIfAbsent?<T>(body: T, dedupKey: string): Promise<QueueMessage<T> | null>;
     lease<T>(opts?: {
@@ -32,6 +41,16 @@ interface AsyncQueueStorage {
     }): Promise<boolean>;
     peekActive<T>(prefix?: string): Promise<QueueMessage<T>[]>;
     peekDeadLetter<T>(prefix?: string): Promise<QueueDeadLetterMessage<T>[]>;
+    /** See QueueStorage.stage. */
+    stage<T>(body: T, opts?: {
+        dedupKey?: string;
+    }): Promise<QueueMessage<T> | null>;
+    /** See QueueStorage.commitStaged. */
+    commitStaged(messageId: string): Promise<boolean>;
+    /** See QueueStorage.discardStaged. */
+    discardStaged(messageId: string, reason?: string): Promise<boolean>;
+    /** See QueueStorage.peekStaged. */
+    peekStaged<T>(prefix?: string): Promise<QueueMessage<T>[]>;
 }
 interface AsyncKVStorage {
     read(key: string): Promise<unknown | null>;

package/lib/{storage-interface-BFiD3kyB.d.ts → storage-interface-D-iEiTJA.d.cts}

@@ -57,6 +57,13 @@ interface BlobStorage {
      *   Other backends: backend-specific ref
      */
     keyRef?(key: string): KindValueRef;
+    /**
+     * Atomically move content from `from` to `to`, replacing any existing value at `to`.
+     * Returns true on success, false if `from` does not exist.
+     * If the underlying adapter does not support a first-class rename operation,
+     * implement a simple fallback: read `from`, write `to`, then delete `from`.
+     */
+    renameKey(from: string, to: string): boolean;
 }
 interface KindValueRef {
     readonly kind: string;
@@ -103,6 +110,11 @@ interface QueueDeadLetterMessage<T = unknown> extends QueueMessage<T> {
 }
 interface QueueStorage {
     enqueue<T>(body: T): QueueMessage<T>;
+    /**
+     * Enqueue multiple messages. Adapters may implement this as a native batch
+     * write or as a simple loop over `enqueue`.
+     */
+    enqueueMany<T>(bodies: T[]): QueueMessage<T>[];
     /**
      * Enqueue only if no active or leased message with the same dedupKey exists.
      * Returns the new message, or null if a pending message with that key is
@@ -124,6 +136,38 @@ interface QueueStorage {
     }): boolean;
     peekActive<T>(prefix?: string): QueueMessage<T>[];
     peekDeadLetter<T>(prefix?: string): QueueDeadLetterMessage<T>[];
+    /**
+     * Stage a message in a pending, uncommitted state. Staged messages are
+     * invisible to `lease` and `peekActive`, do not consume a lease, and have no
+     * automatic transition out of the staged state — they remain until
+     * `commitStaged` or `discardStaged` is called for them.
+     *
+     * If `opts.dedupKey` is supplied, the same dedup contract used by
+     * `enqueueIfAbsent` applies: the key is reserved while the message is staged,
+     * active, or leased, and a concurrent `enqueueIfAbsent`/`stage` with the same
+     * key returns null.
+     *
+     * Backends that cannot keep an "invisible" message in their native queue
+     * (e.g. Azure Storage Queue, SQS) should store staged records in a sibling
+     * key-value table and only `enqueue` into the underlying queue on commit.
+     */
+    stage<T>(body: T, opts?: {
+        dedupKey?: string;
+    }): QueueMessage<T> | null;
+    /**
+     * Promote a staged message to active so it can be leased.
+     * Sets `enqueuedAt` to the commit time and `attempt` to 0.
+     * Returns false if no staged message with that id exists.
+     */
+    commitStaged(messageId: string): boolean;
+    /**
+     * Move a staged message directly to the dead-letter store with the given
+     * reason. The message never becomes leasable.
+     * Returns false if no staged message with that id exists.
+     */
+    discardStaged(messageId: string, reason?: string): boolean;
+    /** Inspect staged messages. Order is implementation-defined. */
+    peekStaged<T>(prefix?: string): QueueMessage<T>[];
 }
 interface KVStorage {
     /** Returns the stored value, or null if the key does not exist. */
@@ -182,4 +226,4 @@ interface AtomicRelayLock {
     tryAcquire(): (() => void) | null;
 }
 
-export { type ArchiveFactory as A, type BlobStorage as B, type JournalStorage as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type JournalEntry as c, type JournalReadResult as d, type QueueLeasedMessage as e, type QueueDeadLetterMessage as f, type QueueStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };
+export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueLeasedMessage as c, type QueueDeadLetterMessage as d, type JournalReadResult as e, type QueueStorage as f, type JournalStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };

package/lib/{storage-interface-BFiD3kyB.d.cts → storage-interface-D-iEiTJA.d.ts}

@@ -57,6 +57,13 @@ interface BlobStorage {
      *   Other backends: backend-specific ref
      */
     keyRef?(key: string): KindValueRef;
+    /**
+     * Atomically move content from `from` to `to`, replacing any existing value at `to`.
+     * Returns true on success, false if `from` does not exist.
+     * If the underlying adapter does not support a first-class rename operation,
+     * implement a simple fallback: read `from`, write `to`, then delete `from`.
+     */
+    renameKey(from: string, to: string): boolean;
 }
 interface KindValueRef {
     readonly kind: string;
@@ -103,6 +110,11 @@ interface QueueDeadLetterMessage<T = unknown> extends QueueMessage<T> {
 }
 interface QueueStorage {
     enqueue<T>(body: T): QueueMessage<T>;
+    /**
+     * Enqueue multiple messages. Adapters may implement this as a native batch
+     * write or as a simple loop over `enqueue`.
+     */
+    enqueueMany<T>(bodies: T[]): QueueMessage<T>[];
     /**
      * Enqueue only if no active or leased message with the same dedupKey exists.
      * Returns the new message, or null if a pending message with that key is
@@ -124,6 +136,38 @@ interface QueueStorage {
     }): boolean;
     peekActive<T>(prefix?: string): QueueMessage<T>[];
     peekDeadLetter<T>(prefix?: string): QueueDeadLetterMessage<T>[];
+    /**
+     * Stage a message in a pending, uncommitted state. Staged messages are
+     * invisible to `lease` and `peekActive`, do not consume a lease, and have no
+     * automatic transition out of the staged state — they remain until
+     * `commitStaged` or `discardStaged` is called for them.
+     *
+     * If `opts.dedupKey` is supplied, the same dedup contract used by
+     * `enqueueIfAbsent` applies: the key is reserved while the message is staged,
+     * active, or leased, and a concurrent `enqueueIfAbsent`/`stage` with the same
+     * key returns null.
+     *
+     * Backends that cannot keep an "invisible" message in their native queue
+     * (e.g. Azure Storage Queue, SQS) should store staged records in a sibling
+     * key-value table and only `enqueue` into the underlying queue on commit.
+     */
+    stage<T>(body: T, opts?: {
+        dedupKey?: string;
+    }): QueueMessage<T> | null;
+    /**
+     * Promote a staged message to active so it can be leased.
+     * Sets `enqueuedAt` to the commit time and `attempt` to 0.
+     * Returns false if no staged message with that id exists.
+     */
+    commitStaged(messageId: string): boolean;
+    /**
+     * Move a staged message directly to the dead-letter store with the given
+     * reason. The message never becomes leasable.
+     * Returns false if no staged message with that id exists.
+     */
+    discardStaged(messageId: string, reason?: string): boolean;
+    /** Inspect staged messages. Order is implementation-defined. */
+    peekStaged<T>(prefix?: string): QueueMessage<T>[];
 }
 interface KVStorage {
     /** Returns the stored value, or null if the key does not exist. */
@@ -182,4 +226,4 @@ interface AtomicRelayLock {
     tryAcquire(): (() => void) | null;
 }
 
-export { type ArchiveFactory as A, type BlobStorage as B, type JournalStorage as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type JournalEntry as c, type JournalReadResult as d, type QueueLeasedMessage as e, type QueueDeadLetterMessage as f, type QueueStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };
+export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueLeasedMessage as c, type QueueDeadLetterMessage as d, type JournalReadResult as e, type QueueStorage as f, type JournalStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };

package/lib/stores/index.d.cts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.cjs';
 export { KVStorageStore } from './kv.cjs';
 import '../types-DjlwALZC.cjs';
-import '../storage-interface-BFiD3kyB.cjs';
+import '../storage-interface-D-iEiTJA.cjs';

package/lib/stores/index.d.ts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.js';
 export { KVStorageStore } from './kv.js';
 import '../types-DjlwALZC.js';
-import '../storage-interface-BFiD3kyB.js';
+import '../storage-interface-D-iEiTJA.js';

package/lib/stores/kv.d.cts

@@ -1,5 +1,5 @@
 import { l as StepMachineStore, k as StepMachineState } from '../types-DjlwALZC.cjs';
-import { K as KVStorage } from '../storage-interface-BFiD3kyB.cjs';
+import { K as KVStorage } from '../storage-interface-D-iEiTJA.cjs';
 
 /**
  * yaml-flow - KVStorageStore

package/lib/stores/kv.d.ts

@@ -1,5 +1,5 @@
 import { l as StepMachineStore, k as StepMachineState } from '../types-DjlwALZC.js';
-import { K as KVStorage } from '../storage-interface-BFiD3kyB.js';
+import { K as KVStorage } from '../storage-interface-D-iEiTJA.js';
 
 /**
  * yaml-flow - KVStorageStore

package/lib/{types-SO5OZm4s.d.ts → types-BtH3scgE.d.ts}

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

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

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