yaml-flow 5.4.0 → 6.0.0

package/dist/continuous-event-graph/index.d.cts

@@ -2,11 +2,9 @@ import { L as LiveGraph, N as NodeInfo, b as LiveGraphSnapshot, D as DownstreamR
 export { B as BlockedTask, P as PendingTask, S as ScheduleResult, d as UnresolvedDependency } from '../types-CHSdoAAA.cjs';
 import { T as TaskConfig, f as GraphEvent, G as GraphConfig } from '../types-BBhqYGhE.cjs';
 export { c as ExecutionState, e as GraphEngineStore, g as GraphSettings } from '../types-BBhqYGhE.cjs';
-export { s as schedule } from '../schedule-qWNL0RQh.cjs';
-import { R as ReactiveGraph, e as TaskHandlerInput, T as TaskHandlerFn } from '../live-cards-bridge-x5XREkXm.cjs';
-export { L as LiveBoard, a as LiveCard, b as LiveCardsToReactiveOptions, c as LiveCardsToReactiveResult, d as ReactiveGraphOptions, f as TaskHandlerReturn, h as computeDataHash, g as createReactiveGraph, l as liveCardsToReactiveGraph } from '../live-cards-bridge-x5XREkXm.cjs';
+import { R as ReactiveGraph, e as TaskHandlerInput, T as TaskHandlerFn } from '../live-cards-bridge-BXbVTsna.cjs';
+export { L as LiveBoard, a as LiveCard, b as LiveCardsToReactiveOptions, c as LiveCardsToReactiveResult, d as ReactiveGraphOptions, f as TaskHandlerReturn, h as computeDataHash, g as createReactiveGraph, l as liveCardsToReactiveGraph, s as schedule } from '../live-cards-bridge-BXbVTsna.cjs';
 import { a as GraphValidationResult } from '../validate-Dbu7ygys.cjs';
-export { J as Journal, M as MemoryJournal } from '../journal-B-JCfQnh.cjs';
 
 /**
  * Continuous Event Graph — Core
@@ -327,6 +325,29 @@ declare function mutateGraph(live: LiveGraph, mutations: GraphMutation[]): LiveG
 interface ResolveCallbackFn {
     (callbackToken: string, data: Record<string, unknown>, errors?: string[]): void;
 }
+/**
+ * Structured command specification for process-based handlers.
+ *
+ * Use this everywhere instead of raw command strings:
+ * - command: the executable name or path (no embedded args)
+ * - args:    explicit argument array (no shell quoting needed)
+ *
+ * JSON config format:
+ *   Old: { "command": "node path/to/exec.js --flag" }  ← parsed for compat by parseCommandSpec
+ *   New: { "command": "node", "args": ["path/to/exec.js", "--flag"] }
+ */
+interface CommandSpec {
+    /** Executable name or path. No embedded args. */
+    command: string;
+    /** Explicit argument list. No shell quoting needed. */
+    args?: string[];
+    /** Working directory. */
+    cwd?: string;
+    /** Additional environment variables merged over process.env. */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+}
 /**
  * Wrap a plain async function as a TaskHandlerFn.
  *
@@ -401,6 +422,36 @@ interface ShellHandlerOptions {
  * ```
  */
 declare function createShellHandler(options: ShellHandlerOptions): TaskHandlerFn;
+interface ProcessHandlerOptions extends CommandSpec {
+    /** Map exit codes to result keys (default: 0 → success, non-zero → error) */
+    exitCodeMap?: Record<number, string>;
+    /** If true, include stdout/stderr/exitCode in the data payload */
+    captureOutput?: boolean;
+    /** Lazy getter for the resolveCallback function */
+    getResolve: () => ResolveCallbackFn;
+}
+/**
+ * Create a TaskHandlerFn that spawns a process using structured command + args.
+ *
+ * Unlike createShellHandler, this uses execFile — no ambient shell, no quoting
+ * issues, safe on Windows and Linux. ${taskName} is substituted in both the
+ * command and each arg string.
+ *
+ * Prefer this over createShellHandler for all programmatic invocations
+ * (task-executors, source fetchers, inference adapters).
+ *
+ * @example
+ * ```ts
+ * const handler = createProcessHandler({
+ *   command: 'node',
+ *   args: ['scripts/fetch.js', '--task', '${taskName}'],
+ *   cwd: '/app',
+ *   captureOutput: true,
+ *   getResolve: () => graph.resolveCallback.bind(graph),
+ * });
+ * ```
+ */
+declare function createProcessHandler(options: ProcessHandlerOptions): TaskHandlerFn;
 interface ScriptHandlerOptions {
     /** Path to the script file */
     scriptPath: string;
@@ -474,4 +525,29 @@ declare function createWebhookHandler(options: WebhookHandlerOptions): TaskHandl
  */
 declare function createNoopHandler(getResolve: () => ResolveCallbackFn, staticData?: Record<string, unknown>): TaskHandlerFn;
 
-export { DownstreamResult, GraphConfig, GraphEvent, type GraphMutation, LiveGraph, LiveGraphHealth, LiveGraphSnapshot, NodeInfo, ReactiveGraph, type ReactiveGraphValidationInput, type ResolveCallbackFn, type ScriptHandlerOptions, type ShellHandlerOptions, TaskConfig, TaskHandlerFn, TaskHandlerInput, UnreachableNodesResult, UnreachableTokensResult, UpstreamResult, type WebhookHandlerOptions, addNode, addProvides, addRequires, applyEvent, applyEvents, createCallbackHandler, createFireAndForgetHandler, createLiveGraph, createNoopHandler, createScriptHandler, createShellHandler, createWebhookHandler, disableNode, drainTokens, enableNode, getDownstream, getNode, getUnreachableNodes, getUnreachableTokens, getUpstream, injectTokens, inspect, mutateGraph, removeNode, removeProvides, removeRequires, resetNode, restore, snapshot, validateLiveGraph, validateReactiveGraph };
+/**
+ * Continuous Event Graph — Journal
+ *
+ * Append-only event log for the reactive layer.
+ * Handlers append events here; drain() reads and clears atomically.
+ *
+ * Adapter:
+ *   - MemoryJournal: in-process array (default)
+ */
+
+interface Journal {
+    /** Append an event to the journal. Safe to call from concurrent callbacks. */
+    append(event: GraphEvent): void;
+    /** Read all pending events and clear the journal atomically. */
+    drain(): GraphEvent[];
+    /** Number of pending events (for observability). */
+    readonly size: number;
+}
+declare class MemoryJournal implements Journal {
+    private buffer;
+    append(event: GraphEvent): void;
+    drain(): GraphEvent[];
+    get size(): number;
+}
+
+export { type CommandSpec, DownstreamResult, GraphConfig, GraphEvent, type GraphMutation, type Journal, LiveGraph, LiveGraphHealth, LiveGraphSnapshot, MemoryJournal, NodeInfo, type ProcessHandlerOptions, ReactiveGraph, type ReactiveGraphValidationInput, type ResolveCallbackFn, type ScriptHandlerOptions, type ShellHandlerOptions, TaskConfig, TaskHandlerFn, TaskHandlerInput, UnreachableNodesResult, UnreachableTokensResult, UpstreamResult, type WebhookHandlerOptions, addNode, addProvides, addRequires, applyEvent, applyEvents, createCallbackHandler, createFireAndForgetHandler, createLiveGraph, createNoopHandler, createProcessHandler, createScriptHandler, createShellHandler, createWebhookHandler, disableNode, drainTokens, enableNode, getDownstream, getNode, getUnreachableNodes, getUnreachableTokens, getUpstream, injectTokens, inspect, mutateGraph, removeNode, removeProvides, removeRequires, resetNode, restore, snapshot, validateLiveGraph, validateReactiveGraph };

package/dist/continuous-event-graph/index.d.ts

@@ -2,11 +2,9 @@ import { L as LiveGraph, N as NodeInfo, b as LiveGraphSnapshot, D as DownstreamR
 export { B as BlockedTask, P as PendingTask, S as ScheduleResult, d as UnresolvedDependency } from '../types-CoW0gQl3.js';
 import { T as TaskConfig, f as GraphEvent, G as GraphConfig } from '../types-BBhqYGhE.js';
 export { c as ExecutionState, e as GraphEngineStore, g as GraphSettings } from '../types-BBhqYGhE.js';
-export { s as schedule } from '../schedule-Cszq9LYY.js';
-import { R as ReactiveGraph, e as TaskHandlerInput, T as TaskHandlerFn } from '../live-cards-bridge-EQjytzI_.js';
-export { L as LiveBoard, a as LiveCard, b as LiveCardsToReactiveOptions, c as LiveCardsToReactiveResult, d as ReactiveGraphOptions, f as TaskHandlerReturn, h as computeDataHash, g as createReactiveGraph, l as liveCardsToReactiveGraph } from '../live-cards-bridge-EQjytzI_.js';
+import { R as ReactiveGraph, e as TaskHandlerInput, T as TaskHandlerFn } from '../live-cards-bridge-Ds28XR15.js';
+export { L as LiveBoard, a as LiveCard, b as LiveCardsToReactiveOptions, c as LiveCardsToReactiveResult, d as ReactiveGraphOptions, f as TaskHandlerReturn, h as computeDataHash, g as createReactiveGraph, l as liveCardsToReactiveGraph, s as schedule } from '../live-cards-bridge-Ds28XR15.js';
 import { a as GraphValidationResult } from '../validate-BAVzUJWa.js';
-export { J as Journal, M as MemoryJournal } from '../journal-9HEgs7dU.js';
 
 /**
  * Continuous Event Graph — Core
@@ -327,6 +325,29 @@ declare function mutateGraph(live: LiveGraph, mutations: GraphMutation[]): LiveG
 interface ResolveCallbackFn {
     (callbackToken: string, data: Record<string, unknown>, errors?: string[]): void;
 }
+/**
+ * Structured command specification for process-based handlers.
+ *
+ * Use this everywhere instead of raw command strings:
+ * - command: the executable name or path (no embedded args)
+ * - args:    explicit argument array (no shell quoting needed)
+ *
+ * JSON config format:
+ *   Old: { "command": "node path/to/exec.js --flag" }  ← parsed for compat by parseCommandSpec
+ *   New: { "command": "node", "args": ["path/to/exec.js", "--flag"] }
+ */
+interface CommandSpec {
+    /** Executable name or path. No embedded args. */
+    command: string;
+    /** Explicit argument list. No shell quoting needed. */
+    args?: string[];
+    /** Working directory. */
+    cwd?: string;
+    /** Additional environment variables merged over process.env. */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+}
 /**
  * Wrap a plain async function as a TaskHandlerFn.
  *
@@ -401,6 +422,36 @@ interface ShellHandlerOptions {
  * ```
  */
 declare function createShellHandler(options: ShellHandlerOptions): TaskHandlerFn;
+interface ProcessHandlerOptions extends CommandSpec {
+    /** Map exit codes to result keys (default: 0 → success, non-zero → error) */
+    exitCodeMap?: Record<number, string>;
+    /** If true, include stdout/stderr/exitCode in the data payload */
+    captureOutput?: boolean;
+    /** Lazy getter for the resolveCallback function */
+    getResolve: () => ResolveCallbackFn;
+}
+/**
+ * Create a TaskHandlerFn that spawns a process using structured command + args.
+ *
+ * Unlike createShellHandler, this uses execFile — no ambient shell, no quoting
+ * issues, safe on Windows and Linux. ${taskName} is substituted in both the
+ * command and each arg string.
+ *
+ * Prefer this over createShellHandler for all programmatic invocations
+ * (task-executors, source fetchers, inference adapters).
+ *
+ * @example
+ * ```ts
+ * const handler = createProcessHandler({
+ *   command: 'node',
+ *   args: ['scripts/fetch.js', '--task', '${taskName}'],
+ *   cwd: '/app',
+ *   captureOutput: true,
+ *   getResolve: () => graph.resolveCallback.bind(graph),
+ * });
+ * ```
+ */
+declare function createProcessHandler(options: ProcessHandlerOptions): TaskHandlerFn;
 interface ScriptHandlerOptions {
     /** Path to the script file */
     scriptPath: string;
@@ -474,4 +525,29 @@ declare function createWebhookHandler(options: WebhookHandlerOptions): TaskHandl
  */
 declare function createNoopHandler(getResolve: () => ResolveCallbackFn, staticData?: Record<string, unknown>): TaskHandlerFn;
 
-export { DownstreamResult, GraphConfig, GraphEvent, type GraphMutation, LiveGraph, LiveGraphHealth, LiveGraphSnapshot, NodeInfo, ReactiveGraph, type ReactiveGraphValidationInput, type ResolveCallbackFn, type ScriptHandlerOptions, type ShellHandlerOptions, TaskConfig, TaskHandlerFn, TaskHandlerInput, UnreachableNodesResult, UnreachableTokensResult, UpstreamResult, type WebhookHandlerOptions, addNode, addProvides, addRequires, applyEvent, applyEvents, createCallbackHandler, createFireAndForgetHandler, createLiveGraph, createNoopHandler, createScriptHandler, createShellHandler, createWebhookHandler, disableNode, drainTokens, enableNode, getDownstream, getNode, getUnreachableNodes, getUnreachableTokens, getUpstream, injectTokens, inspect, mutateGraph, removeNode, removeProvides, removeRequires, resetNode, restore, snapshot, validateLiveGraph, validateReactiveGraph };
+/**
+ * Continuous Event Graph — Journal
+ *
+ * Append-only event log for the reactive layer.
+ * Handlers append events here; drain() reads and clears atomically.
+ *
+ * Adapter:
+ *   - MemoryJournal: in-process array (default)
+ */
+
+interface Journal {
+    /** Append an event to the journal. Safe to call from concurrent callbacks. */
+    append(event: GraphEvent): void;
+    /** Read all pending events and clear the journal atomically. */
+    drain(): GraphEvent[];
+    /** Number of pending events (for observability). */
+    readonly size: number;
+}
+declare class MemoryJournal implements Journal {
+    private buffer;
+    append(event: GraphEvent): void;
+    drain(): GraphEvent[];
+    get size(): number;
+}
+
+export { type CommandSpec, DownstreamResult, GraphConfig, GraphEvent, type GraphMutation, type Journal, LiveGraph, LiveGraphHealth, LiveGraphSnapshot, MemoryJournal, NodeInfo, type ProcessHandlerOptions, ReactiveGraph, type ReactiveGraphValidationInput, type ResolveCallbackFn, type ScriptHandlerOptions, type ShellHandlerOptions, TaskConfig, TaskHandlerFn, TaskHandlerInput, UnreachableNodesResult, UnreachableTokensResult, UpstreamResult, type WebhookHandlerOptions, addNode, addProvides, addRequires, applyEvent, applyEvents, createCallbackHandler, createFireAndForgetHandler, createLiveGraph, createNoopHandler, createProcessHandler, createScriptHandler, createShellHandler, createWebhookHandler, disableNode, drainTokens, enableNode, getDownstream, getNode, getUnreachableNodes, getUnreachableTokens, getUpstream, injectTokens, inspect, mutateGraph, removeNode, removeProvides, removeRequires, resetNode, restore, snapshot, validateLiveGraph, validateReactiveGraph };