yaml-flow 8.2.4 → 8.3.0

package/cli/{board-live-cards-lib-Iq_XAC09.d.ts → board-live-cards-lib-tjYsPt5U.d.ts}

@@ -318,4 +318,4 @@ interface BoardStatusObject {
 }
 declare const EMPTY_CONFIG: GraphConfig;
 
-export { BOARD_GRAPH_KEY as B, type CardAdminStore as C, EMPTY_CONFIG as E, type JournalStorageAdapter as J, type LiveCard as L, type OutputStoreEvent as O, SNAPSHOT_SCHEMA_VERSION_V1 as S, type BoardStatusObject as a, createCardStore as c };
+export { type BoardStatusObject as B, type CardAdminStore as C, EMPTY_CONFIG as E, type JournalStorageAdapter as J, type LiveCard as L, type OutputStoreEvent as O, SNAPSHOT_SCHEMA_VERSION_V1 as S, BOARD_GRAPH_KEY as a, createCardStore as c };

package/cli/browser-api/board-live-cards-browser-adapter.d.ts

@@ -1,6 +1,6 @@
-import { B as BoardPlatformAdapter, N as NotificationTransport, C as ChatStorage } from '../types--rXGWbSR.js';
-import { E as ExecutionRef } from '../execution-interface-ftO1W7Po.js';
-import '../board-live-cards-lib-Iq_XAC09.js';
+import { B as BoardPlatformAdapter, N as NotificationTransport, C as ChatStorage } from '../types-PUfPBxc_.js';
+import { E as ExecutionRef } from '../execution-interface-CrG5gzAx.js';
+import '../board-live-cards-lib-tjYsPt5U.js';
 
 declare function createLocalStorageChatStorage(namespace: string): ChatStorage;
 interface InMemoryBus {

package/cli/browser-api/card-store-browser-api.d.ts

@@ -1,4 +1,4 @@
-import { L as LiveCard } from '../board-live-cards-lib-Iq_XAC09.js';
+import { L as LiveCard } from '../board-live-cards-lib-tjYsPt5U.js';
 
 /**
  * card-store-browser-api.ts

package/cli/browser-api/card-store-browser-api.js

@@ -1,2 +1,2 @@
-import {createRequire}from'module';import'ajv-formats';var C=createRequire(import.meta.url);C("./jsonata-sync.cjs");var v=createRequire(import.meta.url);v("./jsonata-sync.cjs");function y(n,o){function e(){return n.readIndex()??{}}function r(t,s,i){let a=String(s||"").split(".").filter(Boolean);if(a.length===0)return i&&typeof i=="object"&&!Array.isArray(i)?i:{value:i};let u={...t},c=u;for(let d=0;d<a.length-1;d++){let l=a[d],f=c[l],m=f&&typeof f=="object"&&!Array.isArray(f)?{...f}:{};c[l]=m,c=m;}return c[a[a.length-1]]=i,u}return {readCard(t){let s=e()[t];return !s||!n.cardExists(s.key)?null:n.readCard(s.key)},readCardKey(t){return e()[t]?.key??null},readAllCards(){let t=[];for(let[s,i]of Object.entries(e())){if(!n.cardExists(i.key))continue;let a=n.readCard(i.key);a?t.push(a):o?.(`[card-store] could not read card "${s}" at key "${i.key}"`);}return t},readChecksumIndex(){let t={};for(let[s,i]of Object.entries(e()))t[s]=i.checksum;return t},changedSince(t){let s=e(),i=[];for(let[a,u]of Object.entries(s))t[a]!==u.checksum&&i.push(a);for(let a of Object.keys(t))s[a]||i.push(a);return i},validateUpsert(t,s){let i=e(),a=i[t],u=Object.entries(i).find(([,c])=>c.key===s);return a&&a.key!==s?{ok:false,error:`Card id "${t}" is already mapped to key "${a.key}", cannot remap to "${s}"`}:u&&u[0]!==t?{ok:false,error:`Key "${s}" is already mapped to card id "${u[0]}", cannot remap to "${t}"`}:{ok:true}},writeCard(t,s,i){let a=e(),u=i??a[t]?.key??n.defaultCardKey(t),c=n.writeCard(u,s);a[t]={key:u,checksum:c,updatedAt:new Date().toISOString()},n.writeIndex(a);},patchCard(t,s,i){let a=e(),u=a[t];if(!u||!n.cardExists(u.key))throw new Error(`card "${t}" not found`);let c=n.readCard(u.key);if(!c||typeof c!="object"||Array.isArray(c))throw new Error(`card "${t}" is not patchable`);let d=r(c,s,i),l=n.writeCard(u.key,d);a[t]={key:u.key,checksum:l,updatedAt:new Date().toISOString()},n.writeIndex(a);},removeCard(t){let s=e();s[t]&&(delete s[t],n.writeIndex(s));},readIndex(){return e()}}}function p(n){if(n==null||typeof n!="object")return JSON.stringify(n);if(Array.isArray(n))return `[${n.map(p).join(",")}]`;let o=n;return `{${Object.keys(o).sort().map(r=>`${JSON.stringify(r)}:${p(o[r])}`).join(",")}}`}function g(n,o){let e=o>>>0;for(let r=0;r<n.length;r++)e^=n.charCodeAt(r),e=Math.imul(e,16777619)>>>0;return e}function E(n){let o=p(n),e=g(o,2166136261),r=g(o,3735928559),t=g(o,19088743),s=g(o,4277009102);return [e,r,t,s].map(i=>i.toString(16).padStart(8,"0")).join("")}function A(n){function o(e){return `${n}:kv:${e}`}return {read(e){let r=globalThis.localStorage.getItem(o(e));if(r===null)return null;try{return JSON.parse(r)}catch{return null}},write(e,r){globalThis.localStorage.setItem(o(e),JSON.stringify(r));},delete(e){globalThis.localStorage.removeItem(o(e));},listKeys(e){let r=o(e??""),t=[];for(let s=0;s<globalThis.localStorage.length;s++){let i=globalThis.localStorage.key(s);i!==null&&i.startsWith(r)&&t.push(i.slice(o("").length));}return t}}}function h(n,o){let e={...n};for(let[r,t]of Object.entries(o))t!==null&&typeof t=="object"&&!Array.isArray(t)&&e[r]!==null&&typeof e[r]=="object"&&!Array.isArray(e[r])?e[r]=h(e[r],t):e[r]=t;return e}function k(n,o,e){if(o.length===0)return n;let[r,...t]=o;if(t.length===0)return {...n,[r]:e};let s=n[r]!==null&&typeof n[r]=="object"&&!Array.isArray(n[r])?n[r]:{};return {...n,[r]:k(s,t,e)}}function _(n){let o=A(n);return {read:e=>o.read(e),get(e,r){let t=o.read(e);if(t===null)return null;let s=t;for(let i of r.split(".").filter(Boolean)){if(s===null||typeof s!="object"||Array.isArray(s))return null;s=s[i]??null;}return s??null},write:(e,r)=>o.write(e,r),delete:e=>o.delete(e),listKeys:e=>o.listKeys(e),shallowMerge(e,r){let t=o.read(e)??{};o.write(e,{...t,...r});},deepMerge(e,r){let t=o.read(e)??{};o.write(e,h(t,r));},patch(e,r,t){let s=o.read(e)??{},i=r.split(".").filter(Boolean);o.write(e,k(s,i,t));}}}function S(n){let o=_(n);return {readIndex(){return o.read("_index")},writeIndex(e){o.write("_index",e);},readCard(e){return o.read(e)},writeCard(e,r){return o.write(e,r),E(r)},cardExists(e){return o.read(e)!==null},defaultCardKey(e){return e}}}function he(n){let o=S(n),e=y(o);return {getCard(r){return e.readCard(r)},getAllCards(){return e.readAllCards()},upsertCard(r){let t=o.defaultCardKey(r.id);e.writeCard(r.id,r,t);},removeCard(r){e.removeCard(r);}}}export{he as createBrowserCardStoreApi};//# sourceMappingURL=card-store-browser-api.js.map
+import {createRequire}from'module';import'ajv-formats';var x=createRequire(import.meta.url);x("./jsonata-sync.cjs");var v=createRequire(import.meta.url);v("./jsonata-sync.cjs");function y(n,o){function e(){return n.readIndex()??{}}function r(t,s,i){let a=String(s||"").split(".").filter(Boolean);if(a.length===0)return i&&typeof i=="object"&&!Array.isArray(i)?i:{value:i};let u={...t},c=u;for(let d=0;d<a.length-1;d++){let l=a[d],f=c[l],m=f&&typeof f=="object"&&!Array.isArray(f)?{...f}:{};c[l]=m,c=m;}return c[a[a.length-1]]=i,u}return {readCard(t){let s=e()[t];return !s||!n.cardExists(s.key)?null:n.readCard(s.key)},readCardKey(t){return e()[t]?.key??null},readAllCards(){let t=[];for(let[s,i]of Object.entries(e())){if(!n.cardExists(i.key))continue;let a=n.readCard(i.key);a?t.push(a):o?.(`[card-store] could not read card "${s}" at key "${i.key}"`);}return t},readChecksumIndex(){let t={};for(let[s,i]of Object.entries(e()))t[s]=i.checksum;return t},changedSince(t){let s=e(),i=[];for(let[a,u]of Object.entries(s))t[a]!==u.checksum&&i.push(a);for(let a of Object.keys(t))s[a]||i.push(a);return i},validateUpsert(t,s){let i=e(),a=i[t],u=Object.entries(i).find(([,c])=>c.key===s);return a&&a.key!==s?{ok:false,error:`Card id "${t}" is already mapped to key "${a.key}", cannot remap to "${s}"`}:u&&u[0]!==t?{ok:false,error:`Key "${s}" is already mapped to card id "${u[0]}", cannot remap to "${t}"`}:{ok:true}},writeCard(t,s,i){let a=e(),u=i??a[t]?.key??n.defaultCardKey(t),c=n.writeCard(u,s);a[t]={key:u,checksum:c,updatedAt:new Date().toISOString()},n.writeIndex(a);},patchCard(t,s,i){let a=e(),u=a[t];if(!u||!n.cardExists(u.key))throw new Error(`card "${t}" not found`);let c=n.readCard(u.key);if(!c||typeof c!="object"||Array.isArray(c))throw new Error(`card "${t}" is not patchable`);let d=r(c,s,i),l=n.writeCard(u.key,d);a[t]={key:u.key,checksum:l,updatedAt:new Date().toISOString()},n.writeIndex(a);},removeCard(t){let s=e();s[t]&&(delete s[t],n.writeIndex(s));},readIndex(){return e()}}}function g(n){if(n==null||typeof n!="object")return JSON.stringify(n);if(Array.isArray(n))return `[${n.map(g).join(",")}]`;let o=n;return `{${Object.keys(o).sort().map(r=>`${JSON.stringify(r)}:${g(o[r])}`).join(",")}}`}function p(n,o){let e=o>>>0;for(let r=0;r<n.length;r++)e^=n.charCodeAt(r),e=Math.imul(e,16777619)>>>0;return e}function E(n){let o=g(n),e=p(o,2166136261),r=p(o,3735928559),t=p(o,19088743),s=p(o,4277009102);return [e,r,t,s].map(i=>i.toString(16).padStart(8,"0")).join("")}function T(n){function o(e){return `${n}:kv:${e}`}return {read(e){let r=globalThis.localStorage.getItem(o(e));if(r===null)return null;try{return JSON.parse(r)}catch{return null}},write(e,r){globalThis.localStorage.setItem(o(e),JSON.stringify(r));},delete(e){globalThis.localStorage.removeItem(o(e));},listKeys(e){let r=o(e??""),t=[];for(let s=0;s<globalThis.localStorage.length;s++){let i=globalThis.localStorage.key(s);i!==null&&i.startsWith(r)&&t.push(i.slice(o("").length));}return t}}}function h(n,o){let e={...n};for(let[r,t]of Object.entries(o))t!==null&&typeof t=="object"&&!Array.isArray(t)&&e[r]!==null&&typeof e[r]=="object"&&!Array.isArray(e[r])?e[r]=h(e[r],t):e[r]=t;return e}function k(n,o,e){if(o.length===0)return n;let[r,...t]=o;if(t.length===0)return {...n,[r]:e};let s=n[r]!==null&&typeof n[r]=="object"&&!Array.isArray(n[r])?n[r]:{};return {...n,[r]:k(s,t,e)}}function _(n){let o=T(n);return {read:e=>o.read(e),get(e,r){let t=o.read(e);if(t===null)return null;let s=t;for(let i of r.split(".").filter(Boolean)){if(s===null||typeof s!="object"||Array.isArray(s))return null;s=s[i]??null;}return s??null},write:(e,r)=>o.write(e,r),delete:e=>o.delete(e),listKeys:e=>o.listKeys(e),shallowMerge(e,r){let t=o.read(e)??{};o.write(e,{...t,...r});},deepMerge(e,r){let t=o.read(e)??{};o.write(e,h(t,r));},patch(e,r,t){let s=o.read(e)??{},i=r.split(".").filter(Boolean);o.write(e,k(s,i,t));}}}function S(n){let o=_(n);return {readIndex(){return o.read("_index")},writeIndex(e){o.write("_index",e);},readCard(e){return o.read(e)},writeCard(e,r){return o.write(e,r),E(r)},cardExists(e){return o.read(e)!==null},defaultCardKey(e){return e}}}function he(n){let o=S(n),e=y(o);return {getCard(r){return e.readCard(r)},getAllCards(){return e.readAllCards()},upsertCard(r){let t=o.defaultCardKey(r.id);e.writeCard(r.id,r,t);},removeCard(r){e.removeCard(r);}}}export{he as createBrowserCardStoreApi};//# sourceMappingURL=card-store-browser-api.js.map
 //# sourceMappingURL=card-store-browser-api.js.map

package/cli/{execution-interface-ftO1W7Po.d.ts → execution-interface-CrG5gzAx.d.ts}

@@ -1,3 +1,108 @@
+/**
+ * storage-interface.ts
+ *
+ * Three minimal storage primitives that together cover all persistence needs
+ * of the board-live-cards system. Any backend (Node fs, CosmosDB, Azure Blob,
+ * browser localStorage, in-memory test double) implements these three interfaces.
+ *
+ * The pure-logic stores in board-live-cards-all-stores.ts depend only on these
+ * interfaces — never on Node built-ins.
+ *
+ *  Blob    — raw string content at a logical, backend-neutral key
+ *  Journal — append-only log with cursor-based reads
+ *  KV      — key-value store with list/delete
+ *
+ * Mapping to existing storage adapters:
+ *
+ *   CardStorageAdapter
+ *     inventory (cardId → { blobRef, checksum, fileMetadata? })  → KV
+ *     card JSON files                                             → Blob
+ *     source output files                                         → Blob
+ *
+ *   JournalStorageAdapter     → Journal (board-journal.jsonl)
+ *
+ *   ExecutionRequestStore → KV (keyed by journalId, via createFsKvStorage)
+ *
+ *   StateSnapshotStorageAdapter
+ *     board-graph.json (packed single JSON, written atomically)   → Blob
+ *     per-card sidecars (cards/<id>/runtime, fetched-sources-manifest) → KV
+ */
+interface BlobStat {
+    key: string;
+    size: number;
+    updatedAt?: string;
+    contentType?: string;
+}
+interface BlobStorage {
+    /** Returns raw content string, or null if the blob does not exist. */
+    read(key: string): string | null;
+    /** Write content at key. Implementations should be atomic (write-rename). */
+    write(key: string, content: string): void;
+    /** Returns true if a blob exists at key. */
+    exists(key: string): boolean;
+    /** Delete the blob at key. No-op if it does not exist. */
+    remove(key: string): void;
+    /** Optional binary read for file-like artifacts. */
+    readBytes?(key: string): Uint8Array | null;
+    /** Optional binary write for file-like artifacts. */
+    writeBytes?(key: string, content: Uint8Array): void;
+    /** List all keys that start with the given prefix. */
+    listKeys(prefix?: string): string[];
+    /** Optional metadata lookup. */
+    stat?(key: string): BlobStat | null;
+}
+interface KindValueRef {
+    readonly kind: string;
+    readonly value: string;
+}
+/** Serialize a KindValueRef to the wire format: b64:<base64url(json)> */
+declare function serializeRef(ref: KindValueRef): string;
+/** Parse a wire-format ref string (b64:<base64url(json)>) into a KindValueRef. */
+declare function parseRef(s: string): KindValueRef;
+interface JournalEntry {
+    id: string;
+    payload: unknown;
+}
+interface JournalReadResult {
+    entries: JournalEntry[];
+    /** The id of the last entry returned, suitable for use as the next cursor. */
+    newCursor: string | null;
+}
+interface JournalStorage {
+    /** Append an entry. The storage layer assigns the id. */
+    append(payload: unknown): JournalEntry;
+    /** Read ALL entries (for index rebuilds, full replay). */
+    readAll(): JournalEntry[];
+    /**
+     * Read entries appended after the given cursor id.
+     * If cursor is null/empty, returns all entries from the beginning.
+     */
+    readAfter(cursor: string | null): JournalReadResult;
+    /** Truncate all entries. Optional — not all backends support it. */
+    clear?(): void;
+}
+interface KVStorage {
+    /** Returns the stored value, or null if the key does not exist. */
+    read(key: string): unknown | null;
+    /** Write value at key. Overwrites any existing value. */
+    write(key: string, value: unknown): void;
+    /** Delete the key. No-op if it does not exist. */
+    delete(key: string): void;
+    /**
+     * List all keys, optionally filtered to those starting with prefix.
+     * Order is implementation-defined.
+     */
+    listKeys(prefix?: string): string[];
+}
+interface AtomicRelayLock {
+    /**
+     * Attempt to acquire the lock without blocking.
+     * Returns a `release` function if successful, or `null` if the lock is
+     * already held by another actor (relay: that actor will complete the work).
+     */
+    tryAcquire(): (() => void) | null;
+}
+
 /**
  * execution-interface.ts
  *
@@ -77,6 +182,13 @@
  *    whatToRun: 'b64:<base64url({"kind":"fs-path","value":"/path/to/my-executor.js"})>',
  *  };
  *
+ *  // Packaged yaml-flow CLI entrypoint resolved by the Node adapter:
+ *  const yamlFlowCli: ExecutionRef = {
+ *    meta: 'chat-handler',
+ *    howToRun: 'local-node',
+ *    whatToRun: 'b64:<base64url({"kind":"yaml-flow-cli","value":"chat-store-cli.js"})>',
+ *  };
+ *
  *  // Azure Function task executor with custom arg mapping:
  *  const azureFn: ExecutionRef = {
  *    meta: 'task-executor',
@@ -204,7 +316,9 @@ interface ExecutionRef {
       * Address of the artifact to run. Two valid forms:
       *   - string:  must be KindValueRef wire form `b64:<base64url(json)>` (programmatically generated via serializeRef)
       *   - object:  `{ kind: string; value: string }` plain object (human-authored flow files — normalized by the handler factory)
-      * @example 'b64:<base64url({"kind":"fs-path","value":"/dist/cli/source-cli-task-executor.js"})>'
+      * Prefer `kind: 'yaml-flow-cli'` when targeting a packaged public yaml-flow CLI entrypoint.
+      * Use `kind: 'fs-path'` for external scripts or non-packaged local executables.
+      * @example 'b64:<base64url({"kind":"yaml-flow-cli","value":"chat-store-cli.js"})>'
       * @example { kind: 'http-url', value: '/api/workiq/ask' }
       * @example { kind: 'fs-path', value: './my-handler.js' }
      */
@@ -283,4 +397,4 @@ declare function serializeExecutionRef(ref: ExecutionRef): string;
  */
 declare function parseExecutionRef(s: string): ExecutionRef;
 
-export { type ArgsMassaging as A, type ExecutionRef as E, type ExecutionResult as a, executionRefFromScriptPath as e, parseExecutionRef as p, serializeExecutionRef as s };
+export { type ArgsMassaging as A, type BlobStorage as B, type ExecutionRef as E, type JournalStorage as J, type KindValueRef as K, type ExecutionResult as a, type KVStorage as b, type AtomicRelayLock as c, parseRef as d, executionRefFromScriptPath as e, serializeRef as f, parseExecutionRef as p, serializeExecutionRef as s };

package/cli/node/batch-runner-cli.d.ts

@@ -1 +1,4 @@
 #!/usr/bin/env node
+declare function cli(args: any): Promise<void>;
+
+export { cli };

package/cli/node/batch-runner-cli.js

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-import*as h from'fs';import*as s from'path';import {fileURLToPath}from'url';import {spawnSync}from'child_process';var u=s.dirname(fileURLToPath(import.meta.url)),m=s.join(u,"..","..","..","src","cli","node","batch-runner-cli.ts"),S=s.join(u,"..","..","..","node_modules","tsx","dist","cli.mjs");if(h.existsSync(m)){let e=spawnSync(process.execPath,[S,m,...process.argv.slice(2)],{stdio:"inherit",shell:false,windowsHide:true});e.error&&(console.error(`[batch-runner-cli] Failed to launch dev fallback: ${e.error.message}`),process.exit(1)),process.exit(e.status??0);}var v=s.join(u,"..","..","lib","index.js"),E=s.join(u,"..","..","lib","step-machine-public","index.js"),A=s.join(u,"..","..","lib","batch","index.js"),O=s.join(u,"execution-adapter.js"),{loadStepFlow:J,createStepMachine:M,MemoryStore:N}=await import(p(v).href),{buildStepHandlersForFlow:P}=await import(p(E).href),{batch:R}=await import(p(A).href),{invokeRefSync:$}=await import(p(O).href);function p(e){let r=s.resolve(e).replace(/\\/g,"/");return new URL(`file:///${r.startsWith("/")?r.slice(1):r}`)}async function F(){let e=process.argv.slice(2),r=k(e);(r.help||e.length===0)&&(U(),process.exit(e.length===0?1:0));let{flowArg:i,itemsArg:o,concurrency:t}=r;if(!i)throw new Error("[batch-runner-cli] Flow path is required.");if(!o)throw new Error("[batch-runner-cli] --items <json-file-or-inline> is required.");let c=d(i),a=s.dirname(c),w=I(o),f=await J(c),l=await R(w,{concurrency:t,processor:async(n,W)=>{let b=P(f,{invoke:(y,g)=>$(T(y),g,{cliDir:a,cwd:a})});return M(f,b,{store:new N}).run(n)},onProgress:n=>{process.stderr.write(`\r[batch] ${n.completed+n.failed}/${n.total} (${n.percent}%) \u2014 ${n.active} active`);}});process.stderr.write("\r"+" ".repeat(80)+"\r"),console.log(JSON.stringify({completed:l.completed,failed:l.failed,total:l.total,durationMs:l.durationMs,items:l.items.map(n=>({index:n.index,status:n.status,durationMs:n.durationMs,...n.status==="completed"?{intent:n.result?.intent,data:n.result?.data}:{error:n.error?.message}}))},null,2)),l.failed>0&&process.exit(1);}function k(e){let r={},i=[],o=false;for(let t=0;t<e.length;t++){let c=e[t];if(c==="-h"||c==="--help"){o=true;continue}if(c==="--items"){let a=e[t+1];if(!a||a.startsWith("--"))throw new Error("[batch-runner-cli] Missing value for --items.");r["--items"]=a,t++;continue}if(c==="--concurrency"){let a=e[t+1];if(!a||a.startsWith("--"))throw new Error("[batch-runner-cli] Missing value for --concurrency.");r["--concurrency"]=a,t++;continue}if(c.startsWith("--"))throw new Error(`[batch-runner-cli] Unknown flag: ${c}`);i.push(c);}return {help:o,flowArg:i[0],itemsArg:r["--items"],concurrency:r["--concurrency"]?parseInt(r["--concurrency"],10):5}}function d(e){return s.isAbsolute(e)?e:s.resolve(process.cwd(),e)}function I(e){let r=d(e),i;h.existsSync(r)?i=h.readFileSync(r,"utf-8"):i=e;let o;try{o=JSON.parse(i);}catch(t){let c=t instanceof Error?t.message:String(t);throw new Error(`[batch-runner-cli] Failed to parse items JSON: ${c}`)}if(!Array.isArray(o))throw new Error("[batch-runner-cli] Items must be a JSON array of objects.");for(let t=0;t<o.length;t++)if(!o[t]||typeof o[t]!="object"||Array.isArray(o[t]))throw new Error(`[batch-runner-cli] Item at index ${t} is not a JSON object.`);return o}function T(e){if(!e||typeof e!="object"||typeof e.whatToRun!="string"||!e.whatToRun.startsWith("b64:"))return e;try{let r=e.whatToRun.slice(4),i=r+"=".repeat((4-r.length%4)%4),o=Buffer.from(i.replace(/-/g,"+").replace(/_/g,"/"),"base64").toString("utf8"),t=JSON.parse(o);return !t||typeof t!="object"||typeof t.value!="string"?e:{...e,whatToRun:t}}catch{return e}}function U(){console.error("Usage: batch-runner-cli <step-flow.yaml> --items <items.json> [--concurrency <n>]"),console.error(""),console.error("Run a step-machine flow for each item in a JSON array, with concurrency control."),console.error(""),console.error("Options:"),console.error("  --items <path|json>       JSON file or inline JSON array of input objects"),console.error("  --concurrency <n>         Max concurrent flows (default: 5)"),console.error("  -h, --help                Show this help"),console.error(""),console.error("Example:"),console.error("  batch-runner-cli flow.yaml --items items.json --concurrency 3"),console.error(`  batch-runner-cli flow.yaml --items '[{"a":1,"b":2},{"a":3,"b":4}]'`);}F().catch(e=>{let r=e instanceof Error?e.stack??e.message:String(e);console.error(r),process.exit(1);});//# sourceMappingURL=batch-runner-cli.js.map
+import*as f from'fs';import*as s from'path';import {fileURLToPath}from'url';import*as y from'os';import'net';import'child_process';import'crypto';function m(...e){return s.resolve(...e)}s.join(y.tmpdir(),".board-live-cards-git-bash-cache.json");var p=s.dirname(fileURLToPath(import.meta.url)),E=s.join(p,"..","..","lib","index.js"),A=s.join(p,"..","..","lib","step-machine-public","index.js"),P=s.join(p,"..","..","lib","batch","index.js"),R=s.join(p,"execution-adapter.js"),{loadStepFlow:$,createStepMachine:C,MemoryStore:O}=await import(g(E).href),{buildStepHandlersForFlow:B}=await import(g(A).href),{batch:J}=await import(g(P).href),{invokeRefSync:M}=await import(g(R).href);function g(e){let n=s.resolve(e).replace(/\\/g,"/");return new URL(`file:///${n.startsWith("/")?n.slice(1):n}`)}async function I(e){let n=F(e);(n.help||e.length===0)&&(U(),process.exit(e.length===0?1:0));let{flowArg:a,itemsArg:r,concurrency:t}=n;if(!a)throw new Error("[batch-runner-cli] Flow path is required.");if(!r)throw new Error("[batch-runner-cli] --items <json-file-or-inline> is required.");let i=w(a),c=s.dirname(i),v=L(r),h=await $(i),l=await J(v,{concurrency:t,processor:async(o,_)=>{let b=B(h,{invoke:(x,S)=>M(T(x),S,{cliDir:c,cwd:c})});return C(h,b,{store:new O}).run(o)},onProgress:o=>{process.stderr.write(`\r[batch] ${o.completed+o.failed}/${o.total} (${o.percent}%) \u2014 ${o.active} active`);}});process.stderr.write("\r"+" ".repeat(80)+"\r"),console.log(JSON.stringify({completed:l.completed,failed:l.failed,total:l.total,durationMs:l.durationMs,items:l.items.map(o=>({index:o.index,status:o.status,durationMs:o.durationMs,...o.status==="completed"?{intent:o.result?.intent,data:o.result?.data}:{error:o.error?.message}}))},null,2)),l.failed>0&&process.exit(1);}function F(e){let n={},a=[],r=false;for(let t=0;t<e.length;t++){let i=e[t];if(i==="-h"||i==="--help"){r=true;continue}if(i==="--items"){let c=e[t+1];if(!c||c.startsWith("--"))throw new Error("[batch-runner-cli] Missing value for --items.");n["--items"]=c,t++;continue}if(i==="--concurrency"){let c=e[t+1];if(!c||c.startsWith("--"))throw new Error("[batch-runner-cli] Missing value for --concurrency.");n["--concurrency"]=c,t++;continue}if(i.startsWith("--"))throw new Error(`[batch-runner-cli] Unknown flag: ${i}`);a.push(i);}return {help:r,flowArg:a[0],itemsArg:n["--items"],concurrency:n["--concurrency"]?parseInt(n["--concurrency"],10):5}}function w(e){return s.isAbsolute(e)?e:s.resolve(process.cwd(),e)}function L(e){let n=w(e),a;f.existsSync(n)?a=f.readFileSync(n,"utf-8"):a=e;let r;try{r=JSON.parse(a);}catch(t){let i=t instanceof Error?t.message:String(t);throw new Error(`[batch-runner-cli] Failed to parse items JSON: ${i}`)}if(!Array.isArray(r))throw new Error("[batch-runner-cli] Items must be a JSON array of objects.");for(let t=0;t<r.length;t++)if(!r[t]||typeof r[t]!="object"||Array.isArray(r[t]))throw new Error(`[batch-runner-cli] Item at index ${t} is not a JSON object.`);return r}function T(e){if(!e||typeof e!="object"||typeof e.whatToRun!="string"||!e.whatToRun.startsWith("b64:"))return e;try{let n=e.whatToRun.slice(4),a=n+"=".repeat((4-n.length%4)%4),r=Buffer.from(a.replace(/-/g,"+").replace(/_/g,"/"),"base64").toString("utf8"),t=JSON.parse(r);return !t||typeof t!="object"||typeof t.value!="string"?e:{...e,whatToRun:t}}catch{return e}}function U(){console.error("Usage: batch-runner-cli <step-flow.yaml> --items <items.json> [--concurrency <n>]"),console.error(""),console.error("Run a step-machine flow for each item in a JSON array, with concurrency control."),console.error(""),console.error("Options:"),console.error("  --items <path|json>       JSON file or inline JSON array of input objects"),console.error("  --concurrency <n>         Max concurrent flows (default: 5)"),console.error("  -h, --help                Show this help"),console.error(""),console.error("Example:"),console.error("  batch-runner-cli flow.yaml --items items.json --concurrency 3"),console.error(`  batch-runner-cli flow.yaml --items '[{"a":1,"b":2},{"a":3,"b":4}]'`);}var N=process.argv[1]&&m(process.argv[1])===m(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/,"$1"));N&&I(process.argv.slice(2)).catch(e=>{let n=e instanceof Error?e.stack??e.message:String(e);console.error(n),process.exit(1);});
+export{I as cli};//# sourceMappingURL=batch-runner-cli.js.map
 //# sourceMappingURL=batch-runner-cli.js.map