yaml-flow 7.1.0 → 8.0.0

package/cli/node/execution-adapter.js

@@ -0,0 +1,3 @@
+import*as p from'fs';import {existsSync}from'fs';import*as f from'path';import {dirname,resolve}from'path';import {spawnSync,execFileSync,spawn,execFile}from'child_process';import {createRequire}from'module';import {fileURLToPath}from'url';import*as B from'os';import'net';import'crypto';var $=dirname(fileURLToPath(import.meta.url)),U=createRequire(import.meta.url);function D(){let t=resolve($,"./jsonata-sync.cjs");return existsSync(t)?t:resolve($,"../../card-compute/jsonata-sync.cjs")}var g=U(D());var w="b64:";function K(t){let r=new TextEncoder().encode(t),e=globalThis.Buffer,o;if(e)o=e.from(r).toString("base64");else if(typeof btoa=="function"){let n="";for(let s of r)n+=String.fromCharCode(s);o=btoa(n);}else throw new Error("No base64 encoder available in this runtime");return o.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}function z(t){let r=t.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-t.length%4)%4),e=globalThis.Buffer;if(e)return e.from(r,"base64").toString("utf8");if(typeof atob=="function"){let o=atob(r),n=new Uint8Array(o.length);for(let s=0;s<o.length;s+=1)n[s]=o.charCodeAt(s);return new TextDecoder().decode(n)}throw new Error("No base64 decoder available in this runtime")}function h(t){return `${w}${K(JSON.stringify(t))}`}function v(t){if(!t.startsWith(w))throw new Error(`Invalid ref format (expected ${w}<base64url(json)>): ${t}`);let r;try{r=JSON.parse(z(t.slice(w.length)));}catch{throw new Error(`Invalid ref format (malformed base64url/json): ${t}`)}if(!r||typeof r!="object")throw new Error(`Invalid ref format (expected object payload): ${t}`);let e=r;if(typeof e.kind!="string"||typeof e.value!="string")throw new Error(`Invalid ref format (payload must contain string kind/value): ${t}`);return {kind:e.kind,value:e.value}}function Q(t){if(typeof t=="object"&&t!==null){let{command:e,args:o=[],...n}=t,s=C(e,o);return {...n,command:s.command,args:s.args}}let r=O(t);if(r.length===0)throw new Error(`Empty command spec: ${JSON.stringify(t)}`);return C(r[0],r.slice(1))}function C(t,r){return /^(node|node\.exe)$/i.test(t)?{command:process.execPath,args:r}:/\.m?js$/i.test(t)?{command:process.execPath,args:[t,...r]}:{command:t,args:r}}function O(t){let r=[],e="",o=null;for(let n of t.trim()){if(o){n===o?o=null:e+=n;continue}if(n==='"'||n==="'"){o=n;continue}if(/\s/.test(n)){e&&(r.push(e),e="");continue}e+=n;}if(o)throw new Error(`Unterminated quote in command: ${t}`);return e&&r.push(e),r}function b(t){return process.platform==="win32"&&/\.(cmd|bat)$/i.test(t)}function k(t,r){let{command:e,args:o=[],cwd:n,env:s,timeoutMs:i}=t;return execFileSync(e,o,{shell:b(e),timeout:i,encoding:r?.encoding??"utf-8",cwd:n,windowsHide:true,env:s?{...process.env,...s}:void 0,input:r?.input})}function Y(t,r){let{command:e,args:o=[],cwd:n,env:s,timeoutMs:i=3e4}=t;execFile(e,o,{shell:b(e),encoding:"utf8",windowsHide:true,timeout:i,maxBuffer:10*1024*1024,cwd:n,env:s?{...process.env,...s}:void 0},(a,u,d)=>r(a??null,u,d));}f.join(B.tmpdir(),".board-live-cards-git-bash-cache.json");function E(t){let{command:r,args:e=[]}=t;if(process.platform==="win32"){spawn(r,e,{detached:true,stdio:"ignore",windowsHide:true,shell:b(r)}).unref();return}spawn(r,e,{detached:true,stdio:"ignore"}).unref();}function S(t,r,e){let o=f.join(t,"board-live-cards-cli.js");if(p.existsSync(o))return {cmd:process.execPath,args:[o,r,...e]};let n=f.join(t,"board-live-cards-cli.ts"),s=f.join(t,"..","..","node_modules","tsx","dist","cli.mjs"),i=f.join(t,"..","..","node_modules",".bin","tsx"),a=p.existsSync(s)?s:i;return p.existsSync(n)&&p.existsSync(a)?{cmd:process.execPath,args:[a,n,r,...e]}:{cmd:process.platform==="win32"?"npx.cmd":"npx",args:["tsx",n,r,...e]}}function J(){return {executeSync(t,r,e){return k({command:t,args:r,cwd:e?.cwd,timeoutMs:e?.timeout,env:e?.env},{encoding:e?.encoding,input:e?.input})},executeAsync(t,r,e){Y({command:t,args:r},e);},resolveInvocation(t,r){let e=Q({command:t,args:r});return {cmd:e.command,args:e.args??[]}},splitCommand:O,spawnDetached(t,r){E({command:t,args:r});}}}function T(t,r,e){if(!t||typeof t!="object")return {};let o={};if(Array.isArray(t.cmdTemplate)){let n=[];for(let s of t.cmdTemplate)try{n.push(String(g(s).evaluate(r)));}catch(i){let a=i instanceof Error?i.message:String(i);throw new Error(`[${e}] argsMassaging.cmdTemplate failed on "${s}": ${a}`)}o.cmdArgs=n;}if(typeof t.stdinTemplate=="string")try{o.stdin=g(t.stdinTemplate).evaluate(r);}catch(n){let s=n instanceof Error?n.message:String(n);throw new Error(`[${e}] argsMassaging.stdinTemplate failed: ${s}`)}if(typeof t.urlTemplate=="string")try{o.url=String(g(t.urlTemplate).evaluate(r));}catch(n){let s=n instanceof Error?n.message:String(n);throw new Error(`[${e}] argsMassaging.urlTemplate failed: ${s}`)}if(typeof t.headerTemplate=="string")try{let n=g(t.headerTemplate).evaluate(r);if(typeof n!="object"||n===null)throw new Error(`headerTemplate must produce an object, got: ${JSON.stringify(n)}`);o.headers=n;}catch(n){let s=n instanceof Error?n.message:String(n);throw new Error(`[${e}] argsMassaging.headerTemplate failed: ${s}`)}if(typeof t.bodyTemplate=="string")try{o.body=g(t.bodyTemplate).evaluate(r);}catch(n){let s=n instanceof Error?n.message:String(n);throw new Error(`[${e}] argsMassaging.bodyTemplate failed: ${s}`)}return o}async function Z(t,r){return g(t).evaluate(r)}async function tt(t,r){let e=await Z(t,r);if(typeof e!="string")throw new Error(`argsMassaging expression did not produce a string: ${t} \u2192 ${JSON.stringify(e)}`);return e}function et(t,r){let e=typeof t=="object"?t.value:v(t).value;switch(e){case "source-cli-task-executor":{let o=f.join(r,"source-cli-task-executor.js");if(p.existsSync(o))return {command:process.execPath,args:[o]};let n=f.join(r,"source-cli-task-executor.ts"),s=f.join(r,"..","..","node_modules","tsx","dist","cli.mjs"),i=f.join(r,"..","..","node_modules",".bin","tsx"),a=p.existsSync(s)?s:i;return p.existsSync(n)&&p.existsSync(a)?{command:process.execPath,args:[a,n]}:{command:process.execPath,args:[o]}}case "board-live-cards":{let{cmd:o,args:n}=S(r,"_",[]);return {command:o,args:n}}default:throw new Error(`resolveBuiltIn: unknown built-in name "${e}". Supported: source-cli-task-executor, board-live-cards`)}}function R(t,r){if(t.howToRun==="built-in"){let{command:o,args:n}=et(t.whatToRun,r);return {command:o,baseArgs:n}}let e=typeof t.whatToRun=="object"?t.whatToRun.value:v(t.whatToRun).value;switch(t.howToRun){case "local-node":return {command:process.execPath,baseArgs:[e]};case "local-python":return {command:process.platform==="win32"?"python":"python3",baseArgs:[e]};case "local-process":return {command:e,baseArgs:[]};default:throw new Error(`resolveBaseInvocation: howToRun "${t.howToRun}" is not a local transport`)}}function M(t,r){let e=[t.subcommand];return t.inRef&&e.push("--in-ref",t.inRef),t.outRef&&e.push("--out-ref",t.outRef),t.errRef&&e.push("--err-ref",t.errRef),r&&e.push("--extra",Buffer.from(JSON.stringify(r)).toString("base64")),e}function rt(t,r){return {subcommand:t.subcommand,...t.inRef?{inRef:t.inRef}:{},...t.outRef?{outRef:t.outRef}:{},...t.errRef?{errRef:t.errRef}:{},...r?{extra:r}:{}}}function nt(t,r){return R(t,r)}function ot(t){let r=t.trim();if(!r)throw new Error("empty stdout");try{return JSON.parse(r)}catch{let e=r.split(/\r?\n/).filter(Boolean),o=e[e.length-1];return JSON.parse(o)}}function jt(t,r,e){let o=e?.label??"invokeRefSync",n=e?.cliDir??e?.cwd??process.cwd(),s;try{s=T(t.argsMassaging,r,o);}catch(c){return {result:"failure",data:{error:c instanceof Error?c.message:String(c)}}}let i;try{i=nt(t,n);}catch(c){let l=c instanceof Error?c.message:String(c);return {result:"failure",data:{error:`[${o}] ref resolution failed: ${l}`}}}let a=[...i.baseArgs,...s.cmdArgs??[]],u=JSON.stringify(s.stdin??r),d=J(),m;try{m=d.executeSync(i.command,a,{timeout:e?.timeoutMs??3e4,encoding:"utf-8",cwd:e?.cwd,input:u});}catch(c){let l=c,_=(l.stderr?String(l.stderr):"").trim(),H=typeof l.status=="number"?l.status:"unknown",A=_||l.message;return {result:"failure",data:{error:`[${o}] ref exited with status ${H}${A?`: ${A}`:""}`}}}try{let c=ot(m);return {result:"success",data:c&&typeof c=="object"&&!Array.isArray(c)?c:{stdout:c}}}catch{return {result:"success",data:{stdout:m.trim()}}}}function $t(t){let{cliDir:r}=t;return {async invokeTaskExecutor(e,o){if(e.howToRun==="http:post"||e.howToRun==="http:get")return N(e,o);let{command:s,baseArgs:i}=R(e,r),a;if(e.argsMassaging?.cmdTemplate){let d={...o,whatToRun:e.whatToRun};a=await Promise.all(e.argsMassaging.cmdTemplate.map(c=>tt(c,d)));}else a=M(o,e.extra);let u=[...i,...a];try{return k({command:s,args:u}),{status:"success"}}catch(d){return {status:"error",error:d instanceof Error?d.message:String(d)}}},invokeBoardCliCallback(e,o){let n,s;if(e.howToRun==="built-in"){let a=S(r,o.command,o.argv),u=spawnSync(a.cmd,a.args,{encoding:"utf-8",windowsHide:true});return u.status!==0?{status:"error",error:`board CLI exited ${u.status}: ${u.stderr?.trim()}`}:{status:"success"}}({command:n,baseArgs:s}=R(e,r));let i=spawnSync(n,[...s,o.command,...o.argv],{encoding:"utf-8",windowsHide:true});return i.status!==0?{status:"error",error:`board CLI exited ${i.status}: ${i.stderr?.trim()}`}:{status:"success"}}}}async function N(t,r){let e={...r,whatToRun:t.whatToRun},o=T(t.argsMassaging,e,"_invokeTaskExecutorHttp"),n=o.url??(typeof t.whatToRun=="object"?t.whatToRun.value:v(t.whatToRun).value),s=o.body?o.body:rt(r,t.extra),i={"Content-Type":"application/json"},a=o.headers?{...i,...o.headers}:i,u=await fetch(n,{method:t.howToRun==="http:get"?"GET":"POST",headers:a,body:JSON.stringify(s)});if(!u.ok){let m=await u.text().catch(()=>"");return {status:"error",error:`HTTP ${u.status}: ${m}`}}let d=await u.json().catch(()=>null);return d&&typeof d.status=="string"?d:{status:"success"}}function Pt(){return {meta:"task-executor",howToRun:"built-in",whatToRun:h({kind:"built-in",value:"source-cli-task-executor"})}}function Ct(){return {meta:"board-live-cards",howToRun:"built-in",whatToRun:h({kind:"built-in",value:"board-live-cards"})}}function Bt(t){return {meta:"task-executor",howToRun:"local-node",whatToRun:h({kind:"fs-path",value:t})}}function Ot(t,r,e){if(t.howToRun==="http:post"||t.howToRun==="http:get"){N(t,r).catch(a=>{console.error(`[dispatchTaskExecutorDetached] HTTP dispatch failed: ${a.message}`);});return}let{command:n,baseArgs:s}=R(t,e),i=M(r,t.extra);E({command:n,args:[...s,...i]});}
+export{nt as buildLocalBaseSpec,Ct as builtInBoardCliRef,Pt as builtInSourceCliExecutorRef,$t as createExecutionAdapter,Ot as dispatchTaskExecutorDetached,jt as invokeRefSync,Bt as localNodeExecutorRef};//# sourceMappingURL=execution-adapter.js.map
+//# sourceMappingURL=execution-adapter.js.map

package/{dist/cli → cli}/node/fs-board-adapter.d.ts

@@ -1,9 +1,9 @@
-import { C as CommandInput, d as CommandResult, a as BlobStorage, e as KindValueRef, f as BoardNonCorePlatformAdapter, B as BoardPlatformAdapter } from '../../board-live-cards-public-CK_J8uv0.js';
-export { g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, h as createBoardLiveCardsNonCorePublic, i as createBoardLiveCardsPublic, p as parseRef, s as serializeRef } from '../../board-live-cards-public-CK_J8uv0.js';
-import { C as CardAdminStore, L as LiveCard } from '../../board-live-cards-lib-jM2uYG1v.js';
-export { a as BOARD_GRAPH_KEY, E as EMPTY_CONFIG, S as SNAPSHOT_SCHEMA_VERSION_V1, c as createCardStore } from '../../board-live-cards-lib-jM2uYG1v.js';
-import '../../execution-refs.js';
-import '../../types-BBhqYGhE.js';
+import { C as CommandInput, a as CommandResult, b as BlobStorage, K as KindValueRef, c as BoardNonCorePlatformAdapter, B as BoardPlatformAdapter, I as InvocationAdapter } from '../types-CziUxkiv.js';
+export { d as BoardLiveCardsNonCorePublic, e as BoardLiveCardsPublic, D as DescribeEnvelope, f as createBoardLiveCardsNonCorePublic, g as createBoardLiveCardsPublic, p as parseRef, s as serializeRef } from '../types-CziUxkiv.js';
+export { E as ExecutionRef, e as executionRefFromScriptPath, p as parseExecutionRef, s as serializeExecutionRef } from '../execution-interface-C_A6WCiK.js';
+import { C as CardAdminStore, L as LiveCard } from '../board-live-cards-lib-tjYsPt5U.js';
+export { a as BOARD_GRAPH_KEY, E as EMPTY_CONFIG, S as SNAPSHOT_SCHEMA_VERSION_V1, c as createCardStore } from '../board-live-cards-lib-tjYsPt5U.js';
+export { invokeRefSync } from './execution-adapter.js';
 
 /**
  * card-store-lib-public.ts
@@ -187,18 +187,31 @@ declare function createArtifactsStorePublic(store: ArtifactsStore): ArtifactsSto
  * Re-exports the full public API so consumers only need to import from this file.
  */
 
-declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDir: string, opts?: {
+/**
+ * Creates an InvocationAdapter backed by Node.js `spawn`/`spawnSync`.
+ *
+ * Supports howToRun: 'local-node'
+ *   → spawns the script as a detached Node.js child process (fire-and-forget).
+ *
+ * Pass to createSingleBoardServerRuntime / createMultiBoardServerRuntime as
+ * the `invocationAdapter` option. This is the reference Node.js implementation;
+ * replace with your own for Azure Functions, Lambda, etc.
+ */
+declare function createNodeSpawnInvocationAdapter(): InvocationAdapter;
+type FsBoardAdapterOpts = {
     onWarn?: (msg: string) => void;
     suppressSpawn?: boolean;
     notifyChannel?: string;
-}): BoardPlatformAdapter;
-declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDir: string, opts?: {
+};
+type FsBoardNonCoreAdapterOpts = {
     onWarn?: (msg: string) => void;
-}): BoardNonCorePlatformAdapter;
+};
+declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardAdapterOpts, maybeOpts?: FsBoardAdapterOpts): BoardPlatformAdapter;
+declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardNonCoreAdapterOpts, maybeOpts?: FsBoardNonCoreAdapterOpts): BoardNonCorePlatformAdapter;
 /**
  * Extract the serialized board ref from a source token (which has a `br` field).
  * Returns null for callback tokens (which don't carry a board ref).
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, CommandInput, CommandResult, KindValueRef, LiveCard, createArtifactsStore, createArtifactsStorePublic, createCardFileMetadataStore, createCardStorePublic, createChatArtifactsStore, createFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, decodeBoardRefFromToken };
+export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, CommandInput, CommandResult, InvocationAdapter, KindValueRef, LiveCard, createArtifactsStore, createArtifactsStorePublic, createCardFileMetadataStore, createCardStorePublic, createChatArtifactsStore, createFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken };