yaml-flow 7.1.0 → 8.0.1

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

@@ -1,4 +1,30 @@
-import { ExecutionRef, ExecutionResult } from '../../execution-refs.js';
+import { E as ExecutionRef, A as ArgsMassaging, a as ExecutionResult } from '../execution-interface-ftO1W7Po.js';
+
+/**
+ * cli/common/args-massaging — JSONata-based mapping from logical args to
+ * transport-specific shape.
+ *
+ * `argsMassaging` is a property of `ExecutionRef`, so honoring it is the job
+ * of every adapter (Node spawn, HTTP, Azure Function, etc.). This helper is
+ * the shared pure-JSONata implementation reused by all adapters.
+ *
+ * Adapters call this as the first step inside their `invokeRefSync` /
+ * `dispatchExecution` implementation, then perform their transport using
+ * `cmdArgs` / `body` / `url`.
+ */
+
+interface MassagedArgs {
+    /** Resolved argv tail for local transports. */
+    cmdArgs?: string[];
+    /** Resolved stdin payload for local transports. */
+    stdin?: unknown;
+    /** Resolved final URL string for http transports. */
+    url?: string;
+    /** Resolved request headers for http transports. */
+    headers?: Record<string, string>;
+    /** Resolved request body for http transports. */
+    body?: unknown;
+}
 
 /**
  * execution-adapter.ts
@@ -89,6 +115,7 @@ declare function buildLocalBaseSpec(ref: ExecutionRef, cliDir: string): {
     command: string;
     baseArgs: string[];
 };
+
 /** Normalized envelope returned by invokeRefSync. */
 interface InvokeRefResult {
     /** Outcome key — drives transitions in the step machine ('success' | 'failure' | custom). */
@@ -108,6 +135,24 @@ interface InvokeRefSyncOptions {
     /** Label used in error messages (default: 'invokeRefSync'). */
     label?: string;
 }
+interface InvokeExecutionRefOptions extends InvokeRefSyncOptions {
+    /** Extra async transport handlers keyed by `ExecutionRef.howToRun`. */
+    transports?: Record<string, TransportInvoker>;
+    /** Extra synchronous transport handlers keyed by `ExecutionRef.howToRun`. */
+    syncTransports?: Record<string, SyncTransportInvoker>;
+}
+type TransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult>;
+type SyncTransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => InvokeRefResult;
+interface CreateExecutionRefInvokerOptions extends InvokeExecutionRefOptions {
+}
+interface ExecutionRefInvoker {
+    invoke(ref: ExecutionRef, args: Record<string, unknown>): Promise<InvokeRefResult>;
+    invokeSync(ref: ExecutionRef, args: Record<string, unknown>): InvokeRefResult;
+}
+declare function evaluateArgsMassaging(argsMassaging: ArgsMassaging | undefined, args: Record<string, unknown>, label?: string): MassagedArgs;
+declare function invokeExecutionRef(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): Promise<InvokeRefResult>;
+declare function invokeExecutionRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): InvokeRefResult;
+declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOptions): ExecutionRefInvoker;
 /**
  * Invoke an ExecutionRef synchronously with a request/reply contract.
  *
@@ -116,9 +161,9 @@ interface InvokeRefSyncOptions {
  *   - any utility that needs sync request/reply against an ExecutionRef
  *
  * Behavior:
- *   1. Resolve `ref.argsMassaging` against `args` to get cmdArgs / body.
+ *   1. Resolve `ref.argsMassaging` against `args` to get cmdArgs / stdin / body.
  *   2. Build the local base spec (node/python/process + script path).
- *   3. Spawn synchronously with `JSON.stringify(body ?? args)` on stdin.
+ *   3. Spawn synchronously with `JSON.stringify(stdin ?? args)` on stdin.
  *   4. Map exit code into envelope:
  *        exit 0 → { result: 'success', data: parsed-stdout-or-{stdout: raw} }
  *        non-0  → { result: 'failure', data: { error: stderr-or-exit-detail } }
@@ -171,4 +216,4 @@ declare function localNodeExecutorRef(scriptPath: string): ExecutionRef;
  */
 declare function dispatchTaskExecutorDetached(ref: ExecutionRef, args: TaskExecutorArgs, cliDir: string): void;
 
-export { type BoardCliCallbackArgs, type ExecutionAdapter, type ExecutionAdapterOptions, type InvokeRefResult, type InvokeRefSyncOptions, type TaskExecutorArgs, buildLocalBaseSpec, builtInBoardCliRef, builtInSourceCliExecutorRef, createExecutionAdapter, dispatchTaskExecutorDetached, invokeRefSync, localNodeExecutorRef };
+export { type BoardCliCallbackArgs, type CreateExecutionRefInvokerOptions, type ExecutionAdapter, type ExecutionAdapterOptions, type ExecutionRefInvoker, type InvokeExecutionRefOptions, type InvokeRefResult, type InvokeRefSyncOptions, type SyncTransportInvoker, type TaskExecutorArgs, type TransportInvoker, buildLocalBaseSpec, builtInBoardCliRef, builtInSourceCliExecutorRef, createExecutionAdapter, createExecutionRefInvoker, dispatchTaskExecutorDetached, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync, localNodeExecutorRef };

package/cli/node/execution-adapter.js

@@ -0,0 +1,3 @@
+import*as m from'fs';import {existsSync}from'fs';import*as g 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 P=dirname(fileURLToPath(import.meta.url)),Z=createRequire(import.meta.url);function tt(){let t=resolve(P,"./jsonata-sync.cjs");return existsSync(t)?t:resolve(P,"../../card-compute/jsonata-sync.cjs")}var p=Z(tt());var k="b64:";function et(t){let n=new TextEncoder().encode(t),e=globalThis.Buffer,o;if(e)o=e.from(n).toString("base64");else if(typeof btoa=="function"){let r="";for(let s of n)r+=String.fromCharCode(s);o=btoa(r);}else throw new Error("No base64 encoder available in this runtime");return o.replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/g,"")}function nt(t){let n=t.replace(/-/g,"+").replace(/_/g,"/")+"=".repeat((4-t.length%4)%4),e=globalThis.Buffer;if(e)return e.from(n,"base64").toString("utf8");if(typeof atob=="function"){let o=atob(n),r=new Uint8Array(o.length);for(let s=0;s<o.length;s+=1)r[s]=o.charCodeAt(s);return new TextDecoder().decode(r)}throw new Error("No base64 decoder available in this runtime")}function R(t){return `${k}${et(JSON.stringify(t))}`}function y(t){if(!t.startsWith(k))throw new Error(`Invalid ref format (expected ${k}<base64url(json)>): ${t}`);let n;try{n=JSON.parse(nt(t.slice(k.length)));}catch{throw new Error(`Invalid ref format (malformed base64url/json): ${t}`)}if(!n||typeof n!="object")throw new Error(`Invalid ref format (expected object payload): ${t}`);let e=n;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 it(t){if(typeof t=="object"&&t!==null){let{command:e,args:o=[],...r}=t,s=O(e,o);return {...r,command:s.command,args:s.args}}let n=J(t);if(n.length===0)throw new Error(`Empty command spec: ${JSON.stringify(t)}`);return O(n[0],n.slice(1))}function O(t,n){return /^(node|node\.exe)$/i.test(t)?{command:process.execPath,args:n}:/\.m?js$/i.test(t)?{command:process.execPath,args:[t,...n]}:{command:t,args:n}}function J(t){let n=[],e="",o=null;for(let r of t.trim()){if(o){r===o?o=null:e+=r;continue}if(r==='"'||r==="'"){o=r;continue}if(/\s/.test(r)){e&&(n.push(e),e="");continue}e+=r;}if(o)throw new Error(`Unterminated quote in command: ${t}`);return e&&n.push(e),n}function b(t){return process.platform==="win32"&&/\.(cmd|bat)$/i.test(t)}function S(t,n){let{command:e,args:o=[],cwd:r,env:s,timeoutMs:i}=t;return execFileSync(e,o,{shell:b(e),timeout:i,encoding:n?.encoding??"utf-8",cwd:r,windowsHide:true,env:s?{...process.env,...s}:void 0,input:n?.input})}function at(t,n){let{command:e,args:o=[],cwd:r,env:s,timeoutMs:i=3e4}=t;execFile(e,o,{shell:b(e),encoding:"utf8",windowsHide:true,timeout:i,maxBuffer:10*1024*1024,cwd:r,env:s?{...process.env,...s}:void 0},(a,d,c)=>n(a??null,d,c));}g.join(B.tmpdir(),".board-live-cards-git-bash-cache.json");function T(t){let{command:n,args:e=[]}=t;if(process.platform==="win32"){spawn(n,e,{detached:true,stdio:"ignore",windowsHide:true,shell:b(n)}).unref();return}spawn(n,e,{detached:true,stdio:"ignore"}).unref();}function A(t,n,e){let o=g.join(t,"board-live-cards-cli.js");if(m.existsSync(o))return {cmd:process.execPath,args:[o,n,...e]};let r=g.join(t,"board-live-cards-cli.ts"),s=g.join(t,"..","..","node_modules","tsx","dist","cli.mjs"),i=g.join(t,"..","..","node_modules",".bin","tsx"),a=m.existsSync(s)?s:i;return m.existsSync(r)&&m.existsSync(a)?{cmd:process.execPath,args:[a,r,n,...e]}:{cmd:process.platform==="win32"?"npx.cmd":"npx",args:["tsx",r,n,...e]}}function M(){return {executeSync(t,n,e){return S({command:t,args:n,cwd:e?.cwd,timeoutMs:e?.timeout,env:e?.env},{encoding:e?.encoding,input:e?.input})},executeAsync(t,n,e){at({command:t,args:n},e);},resolveInvocation(t,n){let e=it({command:t,args:n});return {cmd:e.command,args:e.args??[]}},splitCommand:J,spawnDetached(t,n){T({command:t,args:n});}}}function j(t,n,e){if(!t||typeof t!="object")return {};let o={};if(Array.isArray(t.cmdTemplate)){let r=[];for(let s of t.cmdTemplate)try{r.push(String(p(s).evaluate(n)));}catch(i){let a=i instanceof Error?i.message:String(i);throw new Error(`[${e}] argsMassaging.cmdTemplate failed on "${s}": ${a}`)}o.cmdArgs=r;}if(typeof t.stdinTemplate=="string")try{o.stdin=p(t.stdinTemplate).evaluate(n);}catch(r){let s=r instanceof Error?r.message:String(r);throw new Error(`[${e}] argsMassaging.stdinTemplate failed: ${s}`)}if(typeof t.urlTemplate=="string")try{o.url=String(p(t.urlTemplate).evaluate(n));}catch(r){let s=r instanceof Error?r.message:String(r);throw new Error(`[${e}] argsMassaging.urlTemplate failed: ${s}`)}if(typeof t.headerTemplate=="string")try{let r=p(t.headerTemplate).evaluate(n);if(typeof r!="object"||r===null)throw new Error(`headerTemplate must produce an object, got: ${JSON.stringify(r)}`);o.headers=r;}catch(r){let s=r instanceof Error?r.message:String(r);throw new Error(`[${e}] argsMassaging.headerTemplate failed: ${s}`)}if(typeof t.bodyTemplate=="string")try{o.body=p(t.bodyTemplate).evaluate(n);}catch(r){let s=r instanceof Error?r.message:String(r);throw new Error(`[${e}] argsMassaging.bodyTemplate failed: ${s}`)}return o}async function ct(t,n){return p(t).evaluate(n)}async function ut(t,n){let e=await ct(t,n);if(typeof e!="string")throw new Error(`argsMassaging expression did not produce a string: ${t} \u2192 ${JSON.stringify(e)}`);return e}function dt(t,n){let e=typeof t=="object"?t.value:y(t).value;switch(e){case "source-cli-task-executor":{let o=g.join(n,"source-cli-task-executor.js");if(m.existsSync(o))return {command:process.execPath,args:[o]};let r=g.join(n,"source-cli-task-executor.ts"),s=g.join(n,"..","..","node_modules","tsx","dist","cli.mjs"),i=g.join(n,"..","..","node_modules",".bin","tsx"),a=m.existsSync(s)?s:i;return m.existsSync(r)&&m.existsSync(a)?{command:process.execPath,args:[a,r]}:{command:process.execPath,args:[o]}}case "board-live-cards":{let{cmd:o,args:r}=A(n,"_",[]);return {command:o,args:r}}default:throw new Error(`resolveBuiltIn: unknown built-in name "${e}". Supported: source-cli-task-executor, board-live-cards`)}}function E(t,n){if(t.howToRun==="built-in"){let{command:o,args:r}=dt(t.whatToRun,n);return {command:o,baseArgs:r}}let e=typeof t.whatToRun=="object"?t.whatToRun.value:y(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 L(t,n){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),n&&e.push("--extra",Buffer.from(JSON.stringify(n)).toString("base64")),e}function lt(t,n){return {subcommand:t.subcommand,...t.inRef?{inRef:t.inRef}:{},...t.outRef?{outRef:t.outRef}:{},...t.errRef?{errRef:t.errRef}:{},...n?{extra:n}:{}}}function ft(t,n){return E(t,n)}function _(t){let n=t.trim();if(!n)throw new Error("empty stdout");try{return JSON.parse(n)}catch{let e=n.split(/\r?\n/).filter(Boolean),o=e[e.length-1];return JSON.parse(o)}}function F(t){let n=t.whatToRun;return typeof n=="object"?n.value:y(n).value}function U(t,n){return {...n,whatToRun:F(t),...t.extra?{extra:t.extra}:{}}}function q(t,n,e="invokeExecutionRef"){return j(t,n,e)}function G(t){return t&&typeof t=="object"&&!Array.isArray(t)&&typeof t.result=="string"&&t.data&&typeof t.data=="object"&&!Array.isArray(t.data)?t:{result:"success",data:t&&typeof t=="object"&&!Array.isArray(t)?t:{stdout:t}}}function x(t){return {result:"failure",data:{error:t}}}function h(t,n,e){let o=e?.label??"invokeExecutionRefSync",r=e?.cliDir??e?.cwd??process.cwd(),s;try{s=q(t.argsMassaging,U(t,n),o);}catch(u){let f=u instanceof Error?u.message:String(u);return x(f)}let i;try{i=ft(t,r);}catch(u){let f=u instanceof Error?u.message:String(u);return x(`[${o}] ref resolution failed: ${f}`)}let a=[...i.baseArgs,...s.cmdArgs??[]],d=JSON.stringify(s.stdin??n),c=M(),l;try{l=c.executeSync(i.command,a,{timeout:e?.timeoutMs??3e4,encoding:"utf-8",cwd:e?.cwd,input:d});}catch(u){let f=u,K=(f.stderr?String(f.stderr):"").trim(),V=typeof f.status=="number"?f.status:"unknown",$=K||f.message;return x(`[${o}] ref exited with status ${V}${$?`: ${$}`:""}`)}try{return G(_(l))}catch{return {result:"success",data:{stdout:l.trim()}}}}async function H(t,n,e){let o=e?.label??"invokeExecutionRef",r;try{r=q(t.argsMassaging,U(t,n),o);}catch(c){let l=c instanceof Error?c.message:String(c);return x(l)}let s=F(t),i=r.headers?{"Content-Type":"application/json",...r.headers}:{"Content-Type":"application/json"},a=r.url??s,d;if(t.howToRun==="http:get"){let c=r.body&&typeof r.body=="object"&&!Array.isArray(r.body)?r.body:n,l=new URLSearchParams(Object.entries(c).filter(([,u])=>u!=null).map(([u,f])=>[u,String(f)]));l.size>0&&(a=`${a}${a.includes("?")?"&":"?"}${l.toString()}`);}else d=JSON.stringify(r.body??n);try{let c=await fetch(a,{method:t.howToRun==="http:get"?"GET":"POST",headers:i,body:d});if(!c.ok){let u=await c.text().catch(()=>"");return x(`[${o}] HTTP ${c.status}${u?`: ${u}`:""}`)}let l=await c.text();if(!l.trim())return {result:"success",data:{}};try{return G(_(l))}catch{return {result:"success",data:{stdout:l.trim()}}}}catch(c){let l=c instanceof Error?c.message:String(c);return x(`[${o}] ${l}`)}}var gt={"local-node":async(t,n,e)=>h(t,n,e),"local-python":async(t,n,e)=>h(t,n,e),"local-process":async(t,n,e)=>h(t,n,e),"built-in":async(t,n,e)=>h(t,n,e),"http:post":H,"http:get":H},pt={"local-node":h,"local-python":h,"local-process":h,"built-in":h};async function mt(t,n,e){let o=e?.transports?.[t.howToRun]??gt[t.howToRun];return o?o(t,n,e):x(`[${e?.label??"invokeExecutionRef"}] unsupported howToRun: ${t.howToRun}`)}function D(t,n,e){let o=e?.syncTransports?.[t.howToRun]??pt[t.howToRun];return o?o(t,n,e):x(`[${e?.label??"invokeExecutionRefSync"}] unsupported sync howToRun: ${t.howToRun}`)}function Lt(t){return {invoke(n,e){return mt(n,e,t)},invokeSync(n,e){return D(n,e,t)}}}function _t(t,n,e){return D(t,n,e)}function Ft(t){let{cliDir:n}=t;return {async invokeTaskExecutor(e,o){if(e.howToRun==="http:post"||e.howToRun==="http:get")return z(e,o);let{command:s,baseArgs:i}=E(e,n),a;if(e.argsMassaging?.cmdTemplate){let c={...o,whatToRun:e.whatToRun};a=await Promise.all(e.argsMassaging.cmdTemplate.map(u=>ut(u,c)));}else a=L(o,e.extra);let d=[...i,...a];try{return S({command:s,args:d}),{status:"success"}}catch(c){return {status:"error",error:c instanceof Error?c.message:String(c)}}},invokeBoardCliCallback(e,o){let r,s;if(e.howToRun==="built-in"){let a=A(n,o.command,o.argv),d=spawnSync(a.cmd,a.args,{encoding:"utf-8",windowsHide:true});return d.status!==0?{status:"error",error:`board CLI exited ${d.status}: ${d.stderr?.trim()}`}:{status:"success"}}({command:r,baseArgs:s}=E(e,n));let i=spawnSync(r,[...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 z(t,n){let e={...n,whatToRun:t.whatToRun},o=j(t.argsMassaging,e,"_invokeTaskExecutorHttp"),r=o.url??(typeof t.whatToRun=="object"?t.whatToRun.value:y(t.whatToRun).value),s=o.body?o.body:lt(n,t.extra),i={"Content-Type":"application/json"},a=o.headers?{...i,...o.headers}:i,d=await fetch(r,{method:t.howToRun==="http:get"?"GET":"POST",headers:a,body:JSON.stringify(s)});if(!d.ok){let l=await d.text().catch(()=>"");return {status:"error",error:`HTTP ${d.status}: ${l}`}}let c=await d.json().catch(()=>null);return c&&typeof c.status=="string"?c:{status:"success"}}function Ut(){return {meta:"task-executor",howToRun:"built-in",whatToRun:R({kind:"built-in",value:"source-cli-task-executor"})}}function qt(){return {meta:"board-live-cards",howToRun:"built-in",whatToRun:R({kind:"built-in",value:"board-live-cards"})}}function Gt(t){return {meta:"task-executor",howToRun:"local-node",whatToRun:R({kind:"fs-path",value:t})}}function Dt(t,n,e){if(t.howToRun==="http:post"||t.howToRun==="http:get"){z(t,n).catch(a=>{console.error(`[dispatchTaskExecutorDetached] HTTP dispatch failed: ${a.message}`);});return}let{command:r,baseArgs:s}=E(t,e),i=L(n,t.extra);T({command:r,args:[...s,...i]});}
+export{ft as buildLocalBaseSpec,qt as builtInBoardCliRef,Ut as builtInSourceCliExecutorRef,Ft as createExecutionAdapter,Lt as createExecutionRefInvoker,Dt as dispatchTaskExecutorDetached,q as evaluateArgsMassaging,mt as invokeExecutionRef,D as invokeExecutionRefSync,_t as invokeRefSync,Gt 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-C2YQXFwo.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-C2YQXFwo.js';
+export { E as ExecutionRef, e as executionRefFromScriptPath, p as parseExecutionRef, s as serializeExecutionRef } from '../execution-interface-ftO1W7Po.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 { CreateExecutionRefInvokerOptions, ExecutionRefInvoker, InvokeExecutionRefOptions, InvokeRefResult, SyncTransportInvoker, TransportInvoker, createExecutionRefInvoker, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, 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 };