yaml-flow 5.4.2 → 6.0.0

package/dist/storage-refs.cjs

@@ -0,0 +1,10 @@
+'use strict';var i=require('fs'),c=require('path'),child_process=require('child_process');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var i__namespace=/*#__PURE__*/_interopNamespace(i);var c__namespace=/*#__PURE__*/_interopNamespace(c);function x(t){if(!t.startsWith("::"))throw new Error(`Invalid ref format (expected ::kind::value): ${t}`);let n=t.slice(2),r=n.indexOf("::");if(r===-1)throw new Error(`Invalid ref format (expected ::kind::value): ${t}`);return {kind:n.slice(0,r),value:n.slice(r+2)}}function h(t){return `::${t.kind}::${t.value}`}function R(){return {read(t){if(!i__namespace.existsSync(t))return null;try{return i__namespace.readFileSync(t,"utf-8")}catch{return null}},write(t,n){i__namespace.mkdirSync(c__namespace.dirname(t),{recursive:true}),i__namespace.writeFileSync(t,n,"utf-8");}}}function k(t){if(t.kind==="fs-path")return R();throw new Error(`Unsupported storage kind: "${t.kind}". Supported kinds: fs-path`)}function d(t){try{return x(t).value}catch{return t}}function g(t){let n=t.extra?.notifyChannel;return typeof n=="string"&&n.length>0?n:void 0}function w(t){if(!t.endsWith(".ts"))return {cmd:process.execPath,args:[t]};let n=c__namespace.dirname(t),r=[];for(let o=1;o<=5;o++){let s=c__namespace.join(n,...Array(o).fill(".."),"node_modules");r.push(c__namespace.join(s,"tsx","dist","cli.mjs")),r.push(c__namespace.join(s,".bin","tsx"));}let e=r.find(o=>i__namespace.existsSync(o));return e?{cmd:process.execPath,args:[e,t]}:{cmd:"npx",args:["tsx",t]}}function v(t,n){let{token:r,via:e}=t;if(e.howToRun==="local-node"||e.howToRun==="local-process"){let o=d(e.whatToRun),{cmd:s,args:l}=w(o),u=g(e),f=[...l,"source-data-fetched","--ref",h(n),"--token",r,...u?["--notify-channel",u]:[]],a=child_process.spawnSync(s,f,{encoding:"utf-8",windowsHide:true});if(a.status!==0)throw new Error(`reportComplete: board CLI exited ${a.status}: ${a.stderr?.trim()}`);return}if(e.howToRun==="http:post"){let o=d(e.whatToRun),s=JSON.stringify({status:"complete",ref:h(n),token:r});m(o,s);return}throw new Error(`reportComplete: unsupported via.howToRun "${e.howToRun}"`)}function T(t,n){let{token:r,via:e}=t;if(e.howToRun==="local-node"||e.howToRun==="local-process"){let o=d(e.whatToRun),{cmd:s,args:l}=w(o),u=g(e),f=[...l,"source-data-fetch-failure","--token",r,"--reason",n,...u?["--notify-channel",u]:[]],a=child_process.spawnSync(s,f,{encoding:"utf-8",windowsHide:true});if(a.status!==0)throw new Error(`reportFailed: board CLI exited ${a.status}: ${a.stderr?.trim()}`);return}if(e.howToRun==="http:post"){let o=d(e.whatToRun),s=JSON.stringify({status:"failed",reason:n,token:r});m(o,s);return}throw new Error(`reportFailed: unsupported via.howToRun "${e.howToRun}"`)}function m(t,n){let r=`
+    const {request} = require(new URL('${t}').protocol === 'https:' ? 'https' : 'http');
+    const h = ${JSON.stringify({"Content-Type":"application/json","Content-Length":Buffer.byteLength(n)})};
+    const u = new URL('${t}');
+    const req = request({hostname:u.hostname,port:u.port,path:u.pathname+u.search,method:'POST',headers:h});
+    req.on('error', e => { process.stderr.write(e.message); process.exit(1); });
+    req.write(${JSON.stringify(n)});
+    req.end();
+  `,e=child_process.spawnSync(process.execPath,["-e",r],{encoding:"utf-8",windowsHide:true});if(e.status!==0)throw new Error(`http-post failed: ${e.stderr?.trim()}`)}exports.blobStorageForRef=k;exports.parseRef=x;exports.reportComplete=v;exports.reportFailed=T;exports.serializeRef=h;//# sourceMappingURL=storage-refs.cjs.map
+//# sourceMappingURL=storage-refs.cjs.map

package/dist/storage-refs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/node/public-storage-adapter.ts"],"names":["parseRef","s","inner","idx","serializeRef","ref","createFsPathBlobStorage","key","i","content","c","blobStorageForRef","_parseWhatToRun","whatToRun","_notifyChannelFromVia","via","candidate","_resolveLocalNodeInvocation","scriptPath","dir","candidates","up","base","tsx","p","reportComplete","callback","outRef","token","cmd","args","notifyChannel","callbackArgs","result","spawnSync","url","body","_httpPostSync","reportFailed","reason","script"],"mappings":"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","file":"storage-refs.cjs","sourcesContent":["/**\n * public-storage-adapter.ts\n *\n * Standalone file — copy this to your task-executor project.\n * Zero dependencies on the rest of yaml-flow.\n *\n * Provides:\n *   - KindValueRef      wire format: ::kind::value\n *   - parseRef()        parse a ::kind::value string\n *   - serializeRef()    produce a ::kind::value string\n *   - BlobStorage       read/write interface\n *   - blobStorageForRef resolve a ref to its BlobStorage backend\n *   - ExecutionRef      portable invocation descriptor (inlined, stays standalone)\n *   - TaskCallback      how to report task completion back to the board\n *   - reportComplete()  call from executor on success\n *   - reportFailed()    call from executor on failure\n *\n * Supported storage kinds:\n *   fs-path   — ref.value is an absolute file path; reads/writes via node:fs\n *\n * Supported callback transports (via ExecutionRef.howToRun):\n *   local-node     — invoke board CLI as a child Node process\n *   http:post      — HTTP POST to a board endpoint\n *\n * Usage:\n *   import { parseRef, blobStorageForRef, reportComplete, reportFailed } from './public-storage-adapter.js';\n *\n *   const { source_def, callback } = JSON.parse(blobStorageForRef(inRef).read(inRef.value));\n *   // ... do work, write to outRef ...\n *   reportComplete(callback, outRef);\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { spawnSync } from 'node:child_process';\n\n// ============================================================================\n// KindValueRef\n// ============================================================================\n\nexport interface KindValueRef {\n  readonly kind: string;\n  readonly value: string;\n}\n\n/** Parse a wire-format ref string (::kind::value) into a KindValueRef. */\nexport function parseRef(s: string): KindValueRef {\n  if (!s.startsWith('::')) throw new Error(`Invalid ref format (expected ::kind::value): ${s}`);\n  const inner = s.slice(2);\n  const idx = inner.indexOf('::');\n  if (idx === -1) throw new Error(`Invalid ref format (expected ::kind::value): ${s}`);\n  return { kind: inner.slice(0, idx), value: inner.slice(idx + 2) };\n}\n\n/** Serialize a KindValueRef to the wire format: ::kind::value */\nexport function serializeRef(ref: KindValueRef): string {\n  return `::${ref.kind}::${ref.value}`;\n}\n\n// ============================================================================\n// BlobStorage\n// ============================================================================\n\nexport interface BlobStorage {\n  /** Returns content string, or null if not found. */\n  read(key: string): string | null;\n  /** Write content at key. */\n  write(key: string, content: string): void;\n}\n\n// ============================================================================\n// fs-path backend — key IS the absolute file path\n// ============================================================================\n\nfunction createFsPathBlobStorage(): BlobStorage {\n  return {\n    read(key: string): string | null {\n      if (!fs.existsSync(key)) return null;\n      try { return fs.readFileSync(key, 'utf-8'); } catch { return null; }\n    },\n    write(key: string, content: string): void {\n      fs.mkdirSync(path.dirname(key), { recursive: true });\n      fs.writeFileSync(key, content, 'utf-8');\n    },\n  };\n}\n\n// ============================================================================\n// blobStorageForRef\n// ============================================================================\n\n/**\n * Resolve a KindValueRef to its BlobStorage backend.\n * Throws a clear error for unrecognised kinds.\n */\nexport function blobStorageForRef(ref: KindValueRef): BlobStorage {\n  switch (ref.kind) {\n    case 'fs-path': return createFsPathBlobStorage();\n    default: throw new Error(`Unsupported storage kind: \"${ref.kind}\". Supported kinds: fs-path`);\n  }\n}\n\n// ============================================================================\n// TaskCallback — how a task-executor reports results back to the board\n// ============================================================================\n\n/**\n * Portable invocation descriptor for the board CLI back-channel.\n * Inlined here so this file stays standalone (zero deps on yaml-flow internals).\n * Shape matches ExecutionRef in execution-interface.ts — keep in sync.\n *\n * Supported howToRun values for TaskCallback.via:\n *   local-node   — invoke board CLI as: node [tsx?] <whatToRun.value> <cmd> [...argv]\n *   http:post    — POST to <whatToRun.value> with a JSON body\n */\nexport interface ExecutionRef {\n  /** Optional human-readable label. Not used for dispatch. */\n  meta?: string;\n  /** Transport / runtime kind. */\n  howToRun: 'local-node' | 'local-python' | 'local-process' | 'http:post' | 'http:get' | 'built-in';\n  /** Address of the target in ::kind::value wire form (e.g. ::fs-path::/path/to/cli.js). */\n  whatToRun: string;\n  /** Opaque executor config stored with the ref. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Describes how the board wants to receive task completion callbacks.\n * Baked into the inRef payload as { source_def, callback }.\n * The executor treats `token` as opaque and passes it back unchanged.\n */\nexport interface TaskCallback {\n  /** Opaque routing token — generated by the board, passed back unchanged. */\n  token: string;\n  /** Delivery mechanism — an ExecutionRef pointing at the board CLI or endpoint. */\n  via: ExecutionRef;\n}\n\n/**\n * Extract the path/url value from a whatToRun ::kind::value wire string.\n * Falls back to the raw string if it isn’t in ::kind::value form.\n */\nfunction _parseWhatToRun(whatToRun: string): string {\n  try { return parseRef(whatToRun).value; } catch { return whatToRun; }\n}\n\nfunction _notifyChannelFromVia(via: ExecutionRef): string | undefined {\n  const candidate = via.extra?.['notifyChannel'];\n  return typeof candidate === 'string' && candidate.length > 0 ? candidate : undefined;\n}\n\n/**\n * Resolve the Node invocation for a local board CLI script.\n * If the path ends in .ts (dev mode), attempts to locate tsx alongside it;\n * otherwise assumes it’s a compiled .js and invokes directly with node.\n */\nfunction _resolveLocalNodeInvocation(scriptPath: string): { cmd: string; args: string[] } {\n  if (!scriptPath.endsWith('.ts')) {\n    return { cmd: process.execPath, args: [scriptPath] };\n  }\n  // Dev path: look for tsx in node_modules relative to the script's package root.\n  // The .ts file may be at src/cli/node/<file>.ts — walk up until we find node_modules/tsx.\n  const dir = path.dirname(scriptPath);\n  const candidates: string[] = [];\n  for (let up = 1; up <= 5; up++) {\n    const base = path.join(dir, ...Array(up).fill('..'), 'node_modules');\n    candidates.push(path.join(base, 'tsx', 'dist', 'cli.mjs'));\n    candidates.push(path.join(base, '.bin', 'tsx'));\n  }\n  const tsx = candidates.find(p => fs.existsSync(p));\n  if (tsx) return { cmd: process.execPath, args: [tsx, scriptPath] };\n  return { cmd: 'npx', args: ['tsx', scriptPath] };\n}\n\n/**\n * Report successful task completion back to the board.\n * Call this from a task-executor after writing the result to outRef.\n */\nexport function reportComplete(callback: TaskCallback, outRef: KindValueRef): void {\n  const { token, via } = callback;\n  if (via.howToRun === 'local-node' || via.howToRun === 'local-process') {\n    const scriptPath = _parseWhatToRun(via.whatToRun);\n    const { cmd, args } = _resolveLocalNodeInvocation(scriptPath);\n    const notifyChannel = _notifyChannelFromVia(via);\n    const callbackArgs = [\n      ...args,\n      'source-data-fetched',\n      '--ref', serializeRef(outRef),\n      '--token', token,\n      ...(notifyChannel ? ['--notify-channel', notifyChannel] : []),\n    ];\n    const result = spawnSync(cmd, callbackArgs, { encoding: 'utf-8', windowsHide: true });\n    if (result.status !== 0) {\n      throw new Error(`reportComplete: board CLI exited ${result.status}: ${result.stderr?.trim()}`);\n    }\n    return;\n  }\n  if (via.howToRun === 'http:post') {\n    const url = _parseWhatToRun(via.whatToRun);\n    const body = JSON.stringify({ status: 'complete', ref: serializeRef(outRef), token });\n    _httpPostSync(url, body);\n    return;\n  }\n  throw new Error(`reportComplete: unsupported via.howToRun \"${via.howToRun}\"`);\n}\n\n/**\n * Report task failure back to the board.\n * Call this from a task-executor instead of writing to outRef.\n */\nexport function reportFailed(callback: TaskCallback, reason: string): void {\n  const { token, via } = callback;\n  if (via.howToRun === 'local-node' || via.howToRun === 'local-process') {\n    const scriptPath = _parseWhatToRun(via.whatToRun);\n    const { cmd, args } = _resolveLocalNodeInvocation(scriptPath);\n    const notifyChannel = _notifyChannelFromVia(via);\n    const callbackArgs = [\n      ...args,\n      'source-data-fetch-failure',\n      '--token', token,\n      '--reason', reason,\n      ...(notifyChannel ? ['--notify-channel', notifyChannel] : []),\n    ];\n    const result = spawnSync(cmd, callbackArgs, { encoding: 'utf-8', windowsHide: true });\n    if (result.status !== 0) {\n      throw new Error(`reportFailed: board CLI exited ${result.status}: ${result.stderr?.trim()}`);\n    }\n    return;\n  }\n  if (via.howToRun === 'http:post') {\n    const url = _parseWhatToRun(via.whatToRun);\n    const body = JSON.stringify({ status: 'failed', reason, token });\n    _httpPostSync(url, body);\n    return;\n  }\n  throw new Error(`reportFailed: unsupported via.howToRun \"${via.howToRun}\"`);\n}\n\n/** Synchronous HTTP POST using a child node process (keeps this file free of async). */\nfunction _httpPostSync(url: string, body: string): void {\n  const script = `\n    const {request} = require(new URL('${url}').protocol === 'https:' ? 'https' : 'http');\n    const h = ${JSON.stringify({ 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) })};\n    const u = new URL('${url}');\n    const req = request({hostname:u.hostname,port:u.port,path:u.pathname+u.search,method:'POST',headers:h});\n    req.on('error', e => { process.stderr.write(e.message); process.exit(1); });\n    req.write(${JSON.stringify(body)});\n    req.end();\n  `;\n  const result = spawnSync(process.execPath, ['-e', script], { encoding: 'utf-8', windowsHide: true });\n  if (result.status !== 0) throw new Error(`http-post failed: ${result.stderr?.trim()}`);\n}\n"]}

package/dist/storage-refs.d.cts

@@ -0,0 +1,92 @@
+/**
+ * public-storage-adapter.ts
+ *
+ * Standalone file — copy this to your task-executor project.
+ * Zero dependencies on the rest of yaml-flow.
+ *
+ * Provides:
+ *   - KindValueRef      wire format: ::kind::value
+ *   - parseRef()        parse a ::kind::value string
+ *   - serializeRef()    produce a ::kind::value string
+ *   - BlobStorage       read/write interface
+ *   - blobStorageForRef resolve a ref to its BlobStorage backend
+ *   - ExecutionRef      portable invocation descriptor (inlined, stays standalone)
+ *   - TaskCallback      how to report task completion back to the board
+ *   - reportComplete()  call from executor on success
+ *   - reportFailed()    call from executor on failure
+ *
+ * Supported storage kinds:
+ *   fs-path   — ref.value is an absolute file path; reads/writes via node:fs
+ *
+ * Supported callback transports (via ExecutionRef.howToRun):
+ *   local-node     — invoke board CLI as a child Node process
+ *   http:post      — HTTP POST to a board endpoint
+ *
+ * Usage:
+ *   import { parseRef, blobStorageForRef, reportComplete, reportFailed } from './public-storage-adapter.js';
+ *
+ *   const { source_def, callback } = JSON.parse(blobStorageForRef(inRef).read(inRef.value));
+ *   // ... do work, write to outRef ...
+ *   reportComplete(callback, outRef);
+ */
+interface KindValueRef {
+    readonly kind: string;
+    readonly value: string;
+}
+/** Parse a wire-format ref string (::kind::value) into a KindValueRef. */
+declare function parseRef(s: string): KindValueRef;
+/** Serialize a KindValueRef to the wire format: ::kind::value */
+declare function serializeRef(ref: KindValueRef): string;
+interface BlobStorage {
+    /** Returns content string, or null if not found. */
+    read(key: string): string | null;
+    /** Write content at key. */
+    write(key: string, content: string): void;
+}
+/**
+ * Resolve a KindValueRef to its BlobStorage backend.
+ * Throws a clear error for unrecognised kinds.
+ */
+declare function blobStorageForRef(ref: KindValueRef): BlobStorage;
+/**
+ * Portable invocation descriptor for the board CLI back-channel.
+ * Inlined here so this file stays standalone (zero deps on yaml-flow internals).
+ * Shape matches ExecutionRef in execution-interface.ts — keep in sync.
+ *
+ * Supported howToRun values for TaskCallback.via:
+ *   local-node   — invoke board CLI as: node [tsx?] <whatToRun.value> <cmd> [...argv]
+ *   http:post    — POST to <whatToRun.value> with a JSON body
+ */
+interface ExecutionRef {
+    /** Optional human-readable label. Not used for dispatch. */
+    meta?: string;
+    /** Transport / runtime kind. */
+    howToRun: 'local-node' | 'local-python' | 'local-process' | 'http:post' | 'http:get' | 'built-in';
+    /** Address of the target in ::kind::value wire form (e.g. ::fs-path::/path/to/cli.js). */
+    whatToRun: string;
+    /** Opaque executor config stored with the ref. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Describes how the board wants to receive task completion callbacks.
+ * Baked into the inRef payload as { source_def, callback }.
+ * The executor treats `token` as opaque and passes it back unchanged.
+ */
+interface TaskCallback {
+    /** Opaque routing token — generated by the board, passed back unchanged. */
+    token: string;
+    /** Delivery mechanism — an ExecutionRef pointing at the board CLI or endpoint. */
+    via: ExecutionRef;
+}
+/**
+ * Report successful task completion back to the board.
+ * Call this from a task-executor after writing the result to outRef.
+ */
+declare function reportComplete(callback: TaskCallback, outRef: KindValueRef): void;
+/**
+ * Report task failure back to the board.
+ * Call this from a task-executor instead of writing to outRef.
+ */
+declare function reportFailed(callback: TaskCallback, reason: string): void;
+
+export { type BlobStorage, type ExecutionRef, type KindValueRef, type TaskCallback, blobStorageForRef, parseRef, reportComplete, reportFailed, serializeRef };

package/dist/storage-refs.d.ts

@@ -0,0 +1,92 @@
+/**
+ * public-storage-adapter.ts
+ *
+ * Standalone file — copy this to your task-executor project.
+ * Zero dependencies on the rest of yaml-flow.
+ *
+ * Provides:
+ *   - KindValueRef      wire format: ::kind::value
+ *   - parseRef()        parse a ::kind::value string
+ *   - serializeRef()    produce a ::kind::value string
+ *   - BlobStorage       read/write interface
+ *   - blobStorageForRef resolve a ref to its BlobStorage backend
+ *   - ExecutionRef      portable invocation descriptor (inlined, stays standalone)
+ *   - TaskCallback      how to report task completion back to the board
+ *   - reportComplete()  call from executor on success
+ *   - reportFailed()    call from executor on failure
+ *
+ * Supported storage kinds:
+ *   fs-path   — ref.value is an absolute file path; reads/writes via node:fs
+ *
+ * Supported callback transports (via ExecutionRef.howToRun):
+ *   local-node     — invoke board CLI as a child Node process
+ *   http:post      — HTTP POST to a board endpoint
+ *
+ * Usage:
+ *   import { parseRef, blobStorageForRef, reportComplete, reportFailed } from './public-storage-adapter.js';
+ *
+ *   const { source_def, callback } = JSON.parse(blobStorageForRef(inRef).read(inRef.value));
+ *   // ... do work, write to outRef ...
+ *   reportComplete(callback, outRef);
+ */
+interface KindValueRef {
+    readonly kind: string;
+    readonly value: string;
+}
+/** Parse a wire-format ref string (::kind::value) into a KindValueRef. */
+declare function parseRef(s: string): KindValueRef;
+/** Serialize a KindValueRef to the wire format: ::kind::value */
+declare function serializeRef(ref: KindValueRef): string;
+interface BlobStorage {
+    /** Returns content string, or null if not found. */
+    read(key: string): string | null;
+    /** Write content at key. */
+    write(key: string, content: string): void;
+}
+/**
+ * Resolve a KindValueRef to its BlobStorage backend.
+ * Throws a clear error for unrecognised kinds.
+ */
+declare function blobStorageForRef(ref: KindValueRef): BlobStorage;
+/**
+ * Portable invocation descriptor for the board CLI back-channel.
+ * Inlined here so this file stays standalone (zero deps on yaml-flow internals).
+ * Shape matches ExecutionRef in execution-interface.ts — keep in sync.
+ *
+ * Supported howToRun values for TaskCallback.via:
+ *   local-node   — invoke board CLI as: node [tsx?] <whatToRun.value> <cmd> [...argv]
+ *   http:post    — POST to <whatToRun.value> with a JSON body
+ */
+interface ExecutionRef {
+    /** Optional human-readable label. Not used for dispatch. */
+    meta?: string;
+    /** Transport / runtime kind. */
+    howToRun: 'local-node' | 'local-python' | 'local-process' | 'http:post' | 'http:get' | 'built-in';
+    /** Address of the target in ::kind::value wire form (e.g. ::fs-path::/path/to/cli.js). */
+    whatToRun: string;
+    /** Opaque executor config stored with the ref. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Describes how the board wants to receive task completion callbacks.
+ * Baked into the inRef payload as { source_def, callback }.
+ * The executor treats `token` as opaque and passes it back unchanged.
+ */
+interface TaskCallback {
+    /** Opaque routing token — generated by the board, passed back unchanged. */
+    token: string;
+    /** Delivery mechanism — an ExecutionRef pointing at the board CLI or endpoint. */
+    via: ExecutionRef;
+}
+/**
+ * Report successful task completion back to the board.
+ * Call this from a task-executor after writing the result to outRef.
+ */
+declare function reportComplete(callback: TaskCallback, outRef: KindValueRef): void;
+/**
+ * Report task failure back to the board.
+ * Call this from a task-executor instead of writing to outRef.
+ */
+declare function reportFailed(callback: TaskCallback, reason: string): void;
+
+export { type BlobStorage, type ExecutionRef, type KindValueRef, type TaskCallback, blobStorageForRef, parseRef, reportComplete, reportFailed, serializeRef };

package/dist/storage-refs.js

@@ -0,0 +1,10 @@
+import*as i from'fs';import*as c from'path';import {spawnSync}from'child_process';function x(t){if(!t.startsWith("::"))throw new Error(`Invalid ref format (expected ::kind::value): ${t}`);let n=t.slice(2),r=n.indexOf("::");if(r===-1)throw new Error(`Invalid ref format (expected ::kind::value): ${t}`);return {kind:n.slice(0,r),value:n.slice(r+2)}}function h(t){return `::${t.kind}::${t.value}`}function R(){return {read(t){if(!i.existsSync(t))return null;try{return i.readFileSync(t,"utf-8")}catch{return null}},write(t,n){i.mkdirSync(c.dirname(t),{recursive:true}),i.writeFileSync(t,n,"utf-8");}}}function k(t){if(t.kind==="fs-path")return R();throw new Error(`Unsupported storage kind: "${t.kind}". Supported kinds: fs-path`)}function d(t){try{return x(t).value}catch{return t}}function g(t){let n=t.extra?.notifyChannel;return typeof n=="string"&&n.length>0?n:void 0}function w(t){if(!t.endsWith(".ts"))return {cmd:process.execPath,args:[t]};let n=c.dirname(t),r=[];for(let o=1;o<=5;o++){let s=c.join(n,...Array(o).fill(".."),"node_modules");r.push(c.join(s,"tsx","dist","cli.mjs")),r.push(c.join(s,".bin","tsx"));}let e=r.find(o=>i.existsSync(o));return e?{cmd:process.execPath,args:[e,t]}:{cmd:"npx",args:["tsx",t]}}function v(t,n){let{token:r,via:e}=t;if(e.howToRun==="local-node"||e.howToRun==="local-process"){let o=d(e.whatToRun),{cmd:s,args:l}=w(o),u=g(e),f=[...l,"source-data-fetched","--ref",h(n),"--token",r,...u?["--notify-channel",u]:[]],a=spawnSync(s,f,{encoding:"utf-8",windowsHide:true});if(a.status!==0)throw new Error(`reportComplete: board CLI exited ${a.status}: ${a.stderr?.trim()}`);return}if(e.howToRun==="http:post"){let o=d(e.whatToRun),s=JSON.stringify({status:"complete",ref:h(n),token:r});m(o,s);return}throw new Error(`reportComplete: unsupported via.howToRun "${e.howToRun}"`)}function T(t,n){let{token:r,via:e}=t;if(e.howToRun==="local-node"||e.howToRun==="local-process"){let o=d(e.whatToRun),{cmd:s,args:l}=w(o),u=g(e),f=[...l,"source-data-fetch-failure","--token",r,"--reason",n,...u?["--notify-channel",u]:[]],a=spawnSync(s,f,{encoding:"utf-8",windowsHide:true});if(a.status!==0)throw new Error(`reportFailed: board CLI exited ${a.status}: ${a.stderr?.trim()}`);return}if(e.howToRun==="http:post"){let o=d(e.whatToRun),s=JSON.stringify({status:"failed",reason:n,token:r});m(o,s);return}throw new Error(`reportFailed: unsupported via.howToRun "${e.howToRun}"`)}function m(t,n){let r=`
+    const {request} = require(new URL('${t}').protocol === 'https:' ? 'https' : 'http');
+    const h = ${JSON.stringify({"Content-Type":"application/json","Content-Length":Buffer.byteLength(n)})};
+    const u = new URL('${t}');
+    const req = request({hostname:u.hostname,port:u.port,path:u.pathname+u.search,method:'POST',headers:h});
+    req.on('error', e => { process.stderr.write(e.message); process.exit(1); });
+    req.write(${JSON.stringify(n)});
+    req.end();
+  `,e=spawnSync(process.execPath,["-e",r],{encoding:"utf-8",windowsHide:true});if(e.status!==0)throw new Error(`http-post failed: ${e.stderr?.trim()}`)}export{k as blobStorageForRef,x as parseRef,v as reportComplete,T as reportFailed,h as serializeRef};//# sourceMappingURL=storage-refs.js.map
+//# sourceMappingURL=storage-refs.js.map

package/dist/storage-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/node/public-storage-adapter.ts"],"names":["parseRef","s","inner","idx","serializeRef","ref","createFsPathBlobStorage","key","content","blobStorageForRef","_parseWhatToRun","whatToRun","_notifyChannelFromVia","via","candidate","_resolveLocalNodeInvocation","scriptPath","dir","candidates","up","base","tsx","p","reportComplete","callback","outRef","token","cmd","args","notifyChannel","callbackArgs","result","spawnSync","url","body","_httpPostSync","reportFailed","reason","script"],"mappings":"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","file":"storage-refs.js","sourcesContent":["/**\n * public-storage-adapter.ts\n *\n * Standalone file — copy this to your task-executor project.\n * Zero dependencies on the rest of yaml-flow.\n *\n * Provides:\n *   - KindValueRef      wire format: ::kind::value\n *   - parseRef()        parse a ::kind::value string\n *   - serializeRef()    produce a ::kind::value string\n *   - BlobStorage       read/write interface\n *   - blobStorageForRef resolve a ref to its BlobStorage backend\n *   - ExecutionRef      portable invocation descriptor (inlined, stays standalone)\n *   - TaskCallback      how to report task completion back to the board\n *   - reportComplete()  call from executor on success\n *   - reportFailed()    call from executor on failure\n *\n * Supported storage kinds:\n *   fs-path   — ref.value is an absolute file path; reads/writes via node:fs\n *\n * Supported callback transports (via ExecutionRef.howToRun):\n *   local-node     — invoke board CLI as a child Node process\n *   http:post      — HTTP POST to a board endpoint\n *\n * Usage:\n *   import { parseRef, blobStorageForRef, reportComplete, reportFailed } from './public-storage-adapter.js';\n *\n *   const { source_def, callback } = JSON.parse(blobStorageForRef(inRef).read(inRef.value));\n *   // ... do work, write to outRef ...\n *   reportComplete(callback, outRef);\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { spawnSync } from 'node:child_process';\n\n// ============================================================================\n// KindValueRef\n// ============================================================================\n\nexport interface KindValueRef {\n  readonly kind: string;\n  readonly value: string;\n}\n\n/** Parse a wire-format ref string (::kind::value) into a KindValueRef. */\nexport function parseRef(s: string): KindValueRef {\n  if (!s.startsWith('::')) throw new Error(`Invalid ref format (expected ::kind::value): ${s}`);\n  const inner = s.slice(2);\n  const idx = inner.indexOf('::');\n  if (idx === -1) throw new Error(`Invalid ref format (expected ::kind::value): ${s}`);\n  return { kind: inner.slice(0, idx), value: inner.slice(idx + 2) };\n}\n\n/** Serialize a KindValueRef to the wire format: ::kind::value */\nexport function serializeRef(ref: KindValueRef): string {\n  return `::${ref.kind}::${ref.value}`;\n}\n\n// ============================================================================\n// BlobStorage\n// ============================================================================\n\nexport interface BlobStorage {\n  /** Returns content string, or null if not found. */\n  read(key: string): string | null;\n  /** Write content at key. */\n  write(key: string, content: string): void;\n}\n\n// ============================================================================\n// fs-path backend — key IS the absolute file path\n// ============================================================================\n\nfunction createFsPathBlobStorage(): BlobStorage {\n  return {\n    read(key: string): string | null {\n      if (!fs.existsSync(key)) return null;\n      try { return fs.readFileSync(key, 'utf-8'); } catch { return null; }\n    },\n    write(key: string, content: string): void {\n      fs.mkdirSync(path.dirname(key), { recursive: true });\n      fs.writeFileSync(key, content, 'utf-8');\n    },\n  };\n}\n\n// ============================================================================\n// blobStorageForRef\n// ============================================================================\n\n/**\n * Resolve a KindValueRef to its BlobStorage backend.\n * Throws a clear error for unrecognised kinds.\n */\nexport function blobStorageForRef(ref: KindValueRef): BlobStorage {\n  switch (ref.kind) {\n    case 'fs-path': return createFsPathBlobStorage();\n    default: throw new Error(`Unsupported storage kind: \"${ref.kind}\". Supported kinds: fs-path`);\n  }\n}\n\n// ============================================================================\n// TaskCallback — how a task-executor reports results back to the board\n// ============================================================================\n\n/**\n * Portable invocation descriptor for the board CLI back-channel.\n * Inlined here so this file stays standalone (zero deps on yaml-flow internals).\n * Shape matches ExecutionRef in execution-interface.ts — keep in sync.\n *\n * Supported howToRun values for TaskCallback.via:\n *   local-node   — invoke board CLI as: node [tsx?] <whatToRun.value> <cmd> [...argv]\n *   http:post    — POST to <whatToRun.value> with a JSON body\n */\nexport interface ExecutionRef {\n  /** Optional human-readable label. Not used for dispatch. */\n  meta?: string;\n  /** Transport / runtime kind. */\n  howToRun: 'local-node' | 'local-python' | 'local-process' | 'http:post' | 'http:get' | 'built-in';\n  /** Address of the target in ::kind::value wire form (e.g. ::fs-path::/path/to/cli.js). */\n  whatToRun: string;\n  /** Opaque executor config stored with the ref. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Describes how the board wants to receive task completion callbacks.\n * Baked into the inRef payload as { source_def, callback }.\n * The executor treats `token` as opaque and passes it back unchanged.\n */\nexport interface TaskCallback {\n  /** Opaque routing token — generated by the board, passed back unchanged. */\n  token: string;\n  /** Delivery mechanism — an ExecutionRef pointing at the board CLI or endpoint. */\n  via: ExecutionRef;\n}\n\n/**\n * Extract the path/url value from a whatToRun ::kind::value wire string.\n * Falls back to the raw string if it isn’t in ::kind::value form.\n */\nfunction _parseWhatToRun(whatToRun: string): string {\n  try { return parseRef(whatToRun).value; } catch { return whatToRun; }\n}\n\nfunction _notifyChannelFromVia(via: ExecutionRef): string | undefined {\n  const candidate = via.extra?.['notifyChannel'];\n  return typeof candidate === 'string' && candidate.length > 0 ? candidate : undefined;\n}\n\n/**\n * Resolve the Node invocation for a local board CLI script.\n * If the path ends in .ts (dev mode), attempts to locate tsx alongside it;\n * otherwise assumes it’s a compiled .js and invokes directly with node.\n */\nfunction _resolveLocalNodeInvocation(scriptPath: string): { cmd: string; args: string[] } {\n  if (!scriptPath.endsWith('.ts')) {\n    return { cmd: process.execPath, args: [scriptPath] };\n  }\n  // Dev path: look for tsx in node_modules relative to the script's package root.\n  // The .ts file may be at src/cli/node/<file>.ts — walk up until we find node_modules/tsx.\n  const dir = path.dirname(scriptPath);\n  const candidates: string[] = [];\n  for (let up = 1; up <= 5; up++) {\n    const base = path.join(dir, ...Array(up).fill('..'), 'node_modules');\n    candidates.push(path.join(base, 'tsx', 'dist', 'cli.mjs'));\n    candidates.push(path.join(base, '.bin', 'tsx'));\n  }\n  const tsx = candidates.find(p => fs.existsSync(p));\n  if (tsx) return { cmd: process.execPath, args: [tsx, scriptPath] };\n  return { cmd: 'npx', args: ['tsx', scriptPath] };\n}\n\n/**\n * Report successful task completion back to the board.\n * Call this from a task-executor after writing the result to outRef.\n */\nexport function reportComplete(callback: TaskCallback, outRef: KindValueRef): void {\n  const { token, via } = callback;\n  if (via.howToRun === 'local-node' || via.howToRun === 'local-process') {\n    const scriptPath = _parseWhatToRun(via.whatToRun);\n    const { cmd, args } = _resolveLocalNodeInvocation(scriptPath);\n    const notifyChannel = _notifyChannelFromVia(via);\n    const callbackArgs = [\n      ...args,\n      'source-data-fetched',\n      '--ref', serializeRef(outRef),\n      '--token', token,\n      ...(notifyChannel ? ['--notify-channel', notifyChannel] : []),\n    ];\n    const result = spawnSync(cmd, callbackArgs, { encoding: 'utf-8', windowsHide: true });\n    if (result.status !== 0) {\n      throw new Error(`reportComplete: board CLI exited ${result.status}: ${result.stderr?.trim()}`);\n    }\n    return;\n  }\n  if (via.howToRun === 'http:post') {\n    const url = _parseWhatToRun(via.whatToRun);\n    const body = JSON.stringify({ status: 'complete', ref: serializeRef(outRef), token });\n    _httpPostSync(url, body);\n    return;\n  }\n  throw new Error(`reportComplete: unsupported via.howToRun \"${via.howToRun}\"`);\n}\n\n/**\n * Report task failure back to the board.\n * Call this from a task-executor instead of writing to outRef.\n */\nexport function reportFailed(callback: TaskCallback, reason: string): void {\n  const { token, via } = callback;\n  if (via.howToRun === 'local-node' || via.howToRun === 'local-process') {\n    const scriptPath = _parseWhatToRun(via.whatToRun);\n    const { cmd, args } = _resolveLocalNodeInvocation(scriptPath);\n    const notifyChannel = _notifyChannelFromVia(via);\n    const callbackArgs = [\n      ...args,\n      'source-data-fetch-failure',\n      '--token', token,\n      '--reason', reason,\n      ...(notifyChannel ? ['--notify-channel', notifyChannel] : []),\n    ];\n    const result = spawnSync(cmd, callbackArgs, { encoding: 'utf-8', windowsHide: true });\n    if (result.status !== 0) {\n      throw new Error(`reportFailed: board CLI exited ${result.status}: ${result.stderr?.trim()}`);\n    }\n    return;\n  }\n  if (via.howToRun === 'http:post') {\n    const url = _parseWhatToRun(via.whatToRun);\n    const body = JSON.stringify({ status: 'failed', reason, token });\n    _httpPostSync(url, body);\n    return;\n  }\n  throw new Error(`reportFailed: unsupported via.howToRun \"${via.howToRun}\"`);\n}\n\n/** Synchronous HTTP POST using a child node process (keeps this file free of async). */\nfunction _httpPostSync(url: string, body: string): void {\n  const script = `\n    const {request} = require(new URL('${url}').protocol === 'https:' ? 'https' : 'http');\n    const h = ${JSON.stringify({ 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) })};\n    const u = new URL('${url}');\n    const req = request({hostname:u.hostname,port:u.port,path:u.pathname+u.search,method:'POST',headers:h});\n    req.on('error', e => { process.stderr.write(e.message); process.exit(1); });\n    req.write(${JSON.stringify(body)});\n    req.end();\n  `;\n  const result = spawnSync(process.execPath, ['-e', script], { encoding: 'utf-8', windowsHide: true });\n  if (result.status !== 0) throw new Error(`http-post failed: ${result.stderr?.trim()}`);\n}\n"]}

package/dist/stores/file.cjs

@@ -1,115 +1,2 @@
-'use strict';
-
-// src/stores/file.ts
-var FileStore = class {
-  directory;
-  fs = null;
-  path = null;
-  constructor(options) {
-    this.directory = options.directory;
-  }
-  async ensureModules() {
-    if (!this.fs || !this.path) {
-      this.fs = await import('fs/promises');
-      this.path = await import('path');
-      await this.fs.mkdir(this.directory, { recursive: true });
-    }
-  }
-  runPath(runId) {
-    return this.path.join(this.directory, `${runId}.run.json`);
-  }
-  dataPath(runId) {
-    return this.path.join(this.directory, `${runId}.data.json`);
-  }
-  async saveRunState(runId, state) {
-    await this.ensureModules();
-    await this.fs.writeFile(
-      this.runPath(runId),
-      JSON.stringify(state, null, 2),
-      "utf-8"
-    );
-  }
-  async loadRunState(runId) {
-    await this.ensureModules();
-    try {
-      const raw = await this.fs.readFile(this.runPath(runId), "utf-8");
-      return JSON.parse(raw);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return null;
-      }
-      throw err;
-    }
-  }
-  async deleteRunState(runId) {
-    await this.ensureModules();
-    try {
-      await this.fs.unlink(this.runPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-    try {
-      await this.fs.unlink(this.dataPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  async setData(runId, key, value) {
-    await this.ensureModules();
-    const allData = await this.getAllData(runId);
-    allData[key] = value;
-    await this.fs.writeFile(
-      this.dataPath(runId),
-      JSON.stringify(allData, null, 2),
-      "utf-8"
-    );
-  }
-  async getData(runId, key) {
-    const allData = await this.getAllData(runId);
-    return allData[key];
-  }
-  async getAllData(runId) {
-    await this.ensureModules();
-    try {
-      const raw = await this.fs.readFile(this.dataPath(runId), "utf-8");
-      return JSON.parse(raw);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return {};
-      }
-      throw err;
-    }
-  }
-  async clearData(runId) {
-    await this.ensureModules();
-    try {
-      await this.fs.unlink(this.dataPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  async listRuns() {
-    await this.ensureModules();
-    try {
-      const files = await this.fs.readdir(this.directory);
-      return files.filter((f) => f.endsWith(".run.json")).map((f) => f.replace(".run.json", ""));
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return [];
-      }
-      throw err;
-    }
-  }
-  /**
-   * Clear all flow data from directory
-   */
-  async clearAll() {
-    await this.ensureModules();
-    const runs = await this.listRuns();
-    await Promise.all(runs.map((runId) => this.deleteRunState(runId)));
-  }
-};
-
-exports.FileStore = FileStore;
-//# sourceMappingURL=file.cjs.map
+'use strict';var a=class{directory;fs=null;path=null;constructor(i){this.directory=i.directory;}async ensureModules(){(!this.fs||!this.path)&&(this.fs=await import('fs/promises'),this.path=await import('path'),await this.fs.mkdir(this.directory,{recursive:true}));}runPath(i){return this.path.join(this.directory,`${i}.run.json`)}dataPath(i){return this.path.join(this.directory,`${i}.data.json`)}async saveRunState(i,t){await this.ensureModules(),await this.fs.writeFile(this.runPath(i),JSON.stringify(t,null,2),"utf-8");}async loadRunState(i){await this.ensureModules();try{let t=await this.fs.readFile(this.runPath(i),"utf-8");return JSON.parse(t)}catch(t){if(t.code==="ENOENT")return null;throw t}}async deleteRunState(i){await this.ensureModules();try{await this.fs.unlink(this.runPath(i));}catch(t){if(t.code!=="ENOENT")throw t}try{await this.fs.unlink(this.dataPath(i));}catch(t){if(t.code!=="ENOENT")throw t}}async setData(i,t,r){await this.ensureModules();let e=await this.getAllData(i);e[t]=r,await this.fs.writeFile(this.dataPath(i),JSON.stringify(e,null,2),"utf-8");}async getData(i,t){return (await this.getAllData(i))[t]}async getAllData(i){await this.ensureModules();try{let t=await this.fs.readFile(this.dataPath(i),"utf-8");return JSON.parse(t)}catch(t){if(t.code==="ENOENT")return {};throw t}}async clearData(i){await this.ensureModules();try{await this.fs.unlink(this.dataPath(i));}catch(t){if(t.code!=="ENOENT")throw t}}async listRuns(){await this.ensureModules();try{return (await this.fs.readdir(this.directory)).filter(t=>t.endsWith(".run.json")).map(t=>t.replace(".run.json",""))}catch(i){if(i.code==="ENOENT")return [];throw i}}async clearAll(){await this.ensureModules();let i=await this.listRuns();await Promise.all(i.map(t=>this.deleteRunState(t)));}};exports.FileStore=a;//# sourceMappingURL=file.cjs.map
 //# sourceMappingURL=file.cjs.map

package/dist/stores/file.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/file.ts"],"names":[],"mappings":"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","file":"file.cjs","sourcesContent":["/**\n * yaml-flow - File Store\n * \n * File-system based store for Node.js environments.\n * Stores each run as a JSON file in the specified directory.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport interface FileStoreOptions {\n  /** Directory path for storing flow data */\n  directory: string;\n}\n\nexport class FileStore implements StepMachineStore {\n  private directory: string;\n  private fs: typeof import('fs/promises') | null = null;\n  private path: typeof import('path') | null = null;\n\n  constructor(options: FileStoreOptions) {\n    this.directory = options.directory;\n  }\n\n  private async ensureModules(): Promise<void> {\n    if (!this.fs || !this.path) {\n      // Dynamic import for Node.js modules\n      this.fs = await import('fs/promises');\n      this.path = await import('path');\n      \n      // Ensure directory exists\n      await this.fs.mkdir(this.directory, { recursive: true });\n    }\n  }\n\n  private runPath(runId: string): string {\n    return this.path!.join(this.directory, `${runId}.run.json`);\n  }\n\n  private dataPath(runId: string): string {\n    return this.path!.join(this.directory, `${runId}.data.json`);\n  }\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    await this.ensureModules();\n    await this.fs!.writeFile(\n      this.runPath(runId),\n      JSON.stringify(state, null, 2),\n      'utf-8'\n    );\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    await this.ensureModules();\n    try {\n      const raw = await this.fs!.readFile(this.runPath(runId), 'utf-8');\n      return JSON.parse(raw);\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return null;\n      }\n      throw err;\n    }\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    await this.ensureModules();\n    try {\n      await this.fs!.unlink(this.runPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n    try {\n      await this.fs!.unlink(this.dataPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    await this.ensureModules();\n    const allData = await this.getAllData(runId);\n    allData[key] = value;\n    await this.fs!.writeFile(\n      this.dataPath(runId),\n      JSON.stringify(allData, null, 2),\n      'utf-8'\n    );\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    const allData = await this.getAllData(runId);\n    return allData[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    await this.ensureModules();\n    try {\n      const raw = await this.fs!.readFile(this.dataPath(runId), 'utf-8');\n      return JSON.parse(raw);\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return {};\n      }\n      throw err;\n    }\n  }\n\n  async clearData(runId: string): Promise<void> {\n    await this.ensureModules();\n    try {\n      await this.fs!.unlink(this.dataPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n  }\n\n  async listRuns(): Promise<string[]> {\n    await this.ensureModules();\n    try {\n      const files = await this.fs!.readdir(this.directory);\n      return files\n        .filter(f => f.endsWith('.run.json'))\n        .map(f => f.replace('.run.json', ''));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return [];\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Clear all flow data from directory\n   */\n  async clearAll(): Promise<void> {\n    await this.ensureModules();\n    const runs = await this.listRuns();\n    await Promise.all(runs.map(runId => this.deleteRunState(runId)));\n  }\n}\n"]}
+{"version":3,"sources":["../../src/stores/file.ts"],"names":["FileStore","options","runId","state","raw","err","key","value","allData","f","runs"],"mappings":"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","file":"file.cjs","sourcesContent":["/**\n * yaml-flow - File Store\n * \n * File-system based store for Node.js environments.\n * Stores each run as a JSON file in the specified directory.\n */\n\nimport type { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport interface FileStoreOptions {\n  /** Directory path for storing flow data */\n  directory: string;\n}\n\nexport class FileStore implements StepMachineStore {\n  private directory: string;\n  private fs: typeof import('fs/promises') | null = null;\n  private path: typeof import('path') | null = null;\n\n  constructor(options: FileStoreOptions) {\n    this.directory = options.directory;\n  }\n\n  private async ensureModules(): Promise<void> {\n    if (!this.fs || !this.path) {\n      // Dynamic import for Node.js modules\n      this.fs = await import('fs/promises');\n      this.path = await import('path');\n      \n      // Ensure directory exists\n      await this.fs.mkdir(this.directory, { recursive: true });\n    }\n  }\n\n  private runPath(runId: string): string {\n    return this.path!.join(this.directory, `${runId}.run.json`);\n  }\n\n  private dataPath(runId: string): string {\n    return this.path!.join(this.directory, `${runId}.data.json`);\n  }\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    await this.ensureModules();\n    await this.fs!.writeFile(\n      this.runPath(runId),\n      JSON.stringify(state, null, 2),\n      'utf-8'\n    );\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | null> {\n    await this.ensureModules();\n    try {\n      const raw = await this.fs!.readFile(this.runPath(runId), 'utf-8');\n      return JSON.parse(raw);\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return null;\n      }\n      throw err;\n    }\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    await this.ensureModules();\n    try {\n      await this.fs!.unlink(this.runPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n    try {\n      await this.fs!.unlink(this.dataPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    await this.ensureModules();\n    const allData = await this.getAllData(runId);\n    allData[key] = value;\n    await this.fs!.writeFile(\n      this.dataPath(runId),\n      JSON.stringify(allData, null, 2),\n      'utf-8'\n    );\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    const allData = await this.getAllData(runId);\n    return allData[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    await this.ensureModules();\n    try {\n      const raw = await this.fs!.readFile(this.dataPath(runId), 'utf-8');\n      return JSON.parse(raw);\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return {};\n      }\n      throw err;\n    }\n  }\n\n  async clearData(runId: string): Promise<void> {\n    await this.ensureModules();\n    try {\n      await this.fs!.unlink(this.dataPath(runId));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code !== 'ENOENT') throw err;\n    }\n  }\n\n  async listRuns(): Promise<string[]> {\n    await this.ensureModules();\n    try {\n      const files = await this.fs!.readdir(this.directory);\n      return files\n        .filter(f => f.endsWith('.run.json'))\n        .map(f => f.replace('.run.json', ''));\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return [];\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Clear all flow data from directory\n   */\n  async clearAll(): Promise<void> {\n    await this.ensureModules();\n    const runs = await this.listRuns();\n    await Promise.all(runs.map(runId => this.deleteRunState(runId)));\n  }\n}\n"]}

package/dist/stores/file.js

@@ -1,113 +1,2 @@
-// src/stores/file.ts
-var FileStore = class {
-  directory;
-  fs = null;
-  path = null;
-  constructor(options) {
-    this.directory = options.directory;
-  }
-  async ensureModules() {
-    if (!this.fs || !this.path) {
-      this.fs = await import('fs/promises');
-      this.path = await import('path');
-      await this.fs.mkdir(this.directory, { recursive: true });
-    }
-  }
-  runPath(runId) {
-    return this.path.join(this.directory, `${runId}.run.json`);
-  }
-  dataPath(runId) {
-    return this.path.join(this.directory, `${runId}.data.json`);
-  }
-  async saveRunState(runId, state) {
-    await this.ensureModules();
-    await this.fs.writeFile(
-      this.runPath(runId),
-      JSON.stringify(state, null, 2),
-      "utf-8"
-    );
-  }
-  async loadRunState(runId) {
-    await this.ensureModules();
-    try {
-      const raw = await this.fs.readFile(this.runPath(runId), "utf-8");
-      return JSON.parse(raw);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return null;
-      }
-      throw err;
-    }
-  }
-  async deleteRunState(runId) {
-    await this.ensureModules();
-    try {
-      await this.fs.unlink(this.runPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-    try {
-      await this.fs.unlink(this.dataPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  async setData(runId, key, value) {
-    await this.ensureModules();
-    const allData = await this.getAllData(runId);
-    allData[key] = value;
-    await this.fs.writeFile(
-      this.dataPath(runId),
-      JSON.stringify(allData, null, 2),
-      "utf-8"
-    );
-  }
-  async getData(runId, key) {
-    const allData = await this.getAllData(runId);
-    return allData[key];
-  }
-  async getAllData(runId) {
-    await this.ensureModules();
-    try {
-      const raw = await this.fs.readFile(this.dataPath(runId), "utf-8");
-      return JSON.parse(raw);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return {};
-      }
-      throw err;
-    }
-  }
-  async clearData(runId) {
-    await this.ensureModules();
-    try {
-      await this.fs.unlink(this.dataPath(runId));
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  async listRuns() {
-    await this.ensureModules();
-    try {
-      const files = await this.fs.readdir(this.directory);
-      return files.filter((f) => f.endsWith(".run.json")).map((f) => f.replace(".run.json", ""));
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        return [];
-      }
-      throw err;
-    }
-  }
-  /**
-   * Clear all flow data from directory
-   */
-  async clearAll() {
-    await this.ensureModules();
-    const runs = await this.listRuns();
-    await Promise.all(runs.map((runId) => this.deleteRunState(runId)));
-  }
-};
-
-export { FileStore };
-//# sourceMappingURL=file.js.map
+var a=class{directory;fs=null;path=null;constructor(i){this.directory=i.directory;}async ensureModules(){(!this.fs||!this.path)&&(this.fs=await import('fs/promises'),this.path=await import('path'),await this.fs.mkdir(this.directory,{recursive:true}));}runPath(i){return this.path.join(this.directory,`${i}.run.json`)}dataPath(i){return this.path.join(this.directory,`${i}.data.json`)}async saveRunState(i,t){await this.ensureModules(),await this.fs.writeFile(this.runPath(i),JSON.stringify(t,null,2),"utf-8");}async loadRunState(i){await this.ensureModules();try{let t=await this.fs.readFile(this.runPath(i),"utf-8");return JSON.parse(t)}catch(t){if(t.code==="ENOENT")return null;throw t}}async deleteRunState(i){await this.ensureModules();try{await this.fs.unlink(this.runPath(i));}catch(t){if(t.code!=="ENOENT")throw t}try{await this.fs.unlink(this.dataPath(i));}catch(t){if(t.code!=="ENOENT")throw t}}async setData(i,t,r){await this.ensureModules();let e=await this.getAllData(i);e[t]=r,await this.fs.writeFile(this.dataPath(i),JSON.stringify(e,null,2),"utf-8");}async getData(i,t){return (await this.getAllData(i))[t]}async getAllData(i){await this.ensureModules();try{let t=await this.fs.readFile(this.dataPath(i),"utf-8");return JSON.parse(t)}catch(t){if(t.code==="ENOENT")return {};throw t}}async clearData(i){await this.ensureModules();try{await this.fs.unlink(this.dataPath(i));}catch(t){if(t.code!=="ENOENT")throw t}}async listRuns(){await this.ensureModules();try{return (await this.fs.readdir(this.directory)).filter(t=>t.endsWith(".run.json")).map(t=>t.replace(".run.json",""))}catch(i){if(i.code==="ENOENT")return [];throw i}}async clearAll(){await this.ensureModules();let i=await this.listRuns();await Promise.all(i.map(t=>this.deleteRunState(t)));}};export{a as FileStore};//# sourceMappingURL=file.js.map
 //# sourceMappingURL=file.js.map