yaml-flow 3.1.1 → 5.0.0

package/dist/stores/file.d.cts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.cjs';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.cjs';
 
 /**
  * yaml-flow - File Store

package/dist/stores/file.d.ts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.js';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.js';
 
 /**
  * yaml-flow - File Store

package/dist/stores/index.d.cts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.cjs';
 export { LocalStorageStore } from './localStorage.cjs';
 export { FileStore } from './file.cjs';
-import '../types-FZ_eyErS.cjs';
+import '../types-ycun84cq.cjs';

package/dist/stores/index.d.ts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.js';
 export { LocalStorageStore } from './localStorage.js';
 export { FileStore } from './file.js';
-import '../types-FZ_eyErS.js';
+import '../types-ycun84cq.js';

package/dist/stores/localStorage.d.cts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.cjs';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.cjs';
 
 /**
  * yaml-flow - LocalStorage Store

package/dist/stores/localStorage.d.ts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.js';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.js';
 
 /**
  * yaml-flow - LocalStorage Store

package/dist/stores/memory.d.cts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.cjs';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.cjs';
 
 /**
  * yaml-flow - Memory Store

package/dist/stores/memory.d.ts

@@ -1,4 +1,4 @@
-import { l as StepMachineStore, k as StepMachineState } from '../types-FZ_eyErS.js';
+import { l as StepMachineStore, k as StepMachineState } from '../types-ycun84cq.js';
 
 /**
  * yaml-flow - Memory Store

package/dist/{types-BwvgvlOO.d.cts → types-BzLD8bjb.d.cts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-DEj7OakX.cjs';
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-CMFSIjpc.cjs';
 
 /**
  * Continuous Event Graph — Types

package/dist/{types-ClRA8hzC.d.ts → types-C2eJ7DAV.d.ts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-DEj7OakX.js';
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, e as GraphEngineStore } from './types-CMFSIjpc.js';
 
 /**
  * Continuous Event Graph — Types

package/dist/{types-DEj7OakX.d.cts → types-CMFSIjpc.d.cts}

@@ -134,7 +134,7 @@ interface StuckDetection {
     outputs_unresolvable: string[];
     tasks_blocked: string[];
 }
-type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskUpsertEvent | TaskRemovalEvent | NodeRequiresAddEvent | NodeRequiresRemoveEvent | NodeProvidesAddEvent | NodeProvidesRemoveEvent;
 interface TaskStartedEvent {
     type: 'task-started';
     taskName: string;
@@ -165,6 +165,12 @@ interface TaskProgressEvent {
     taskName: string;
     message?: string;
     progress?: number;
+    /**
+     * Arbitrary update payload — used by source delivery to carry
+     * { bindTo, fetchedAt, dest } or { bindTo, failure, reason }.
+     * card-handler receives this via TaskHandlerInput.update.
+     */
+    update?: Record<string, unknown>;
     timestamp: string;
     executionId?: string;
 }
@@ -185,12 +191,41 @@ interface AgentActionEvent {
     timestamp: string;
     config?: Partial<ExecutionConfig>;
 }
-interface TaskCreationEvent {
-    type: 'task-creation';
+interface TaskUpsertEvent {
+    type: 'task-upsert';
     taskName: string;
     taskConfig: TaskConfig;
     timestamp: string;
 }
+interface TaskRemovalEvent {
+    type: 'task-removal';
+    taskName: string;
+    timestamp: string;
+}
+interface NodeRequiresAddEvent {
+    type: 'node-requires-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeRequiresRemoveEvent {
+    type: 'node-requires-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesAddEvent {
+    type: 'node-provides-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesRemoveEvent {
+    type: 'node-provides-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
 interface SchedulerResult {
     /** Tasks eligible for execution */
     eligibleTasks: string[];
@@ -214,4 +249,4 @@ type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
 type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
 type RefreshStrategy = 'data-changed' | 'epoch-changed' | 'time-based' | 'manual' | 'once';
 
-export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskCreationEvent as j, TaskFailedEvent as k, TaskStartedEvent as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRestartEvent as q, TaskRetryConfig as r };
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskStatus as l, TaskCircuitBreakerConfig as m, TaskMessage as n, TaskProgressEvent as o, TaskRestartEvent as p, TaskRetryConfig as q };

package/dist/{types-DEj7OakX.d.ts → types-CMFSIjpc.d.ts}

@@ -134,7 +134,7 @@ interface StuckDetection {
     outputs_unresolvable: string[];
     tasks_blocked: string[];
 }
-type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | TaskRestartEvent | InjectTokensEvent | AgentActionEvent | TaskUpsertEvent | TaskRemovalEvent | NodeRequiresAddEvent | NodeRequiresRemoveEvent | NodeProvidesAddEvent | NodeProvidesRemoveEvent;
 interface TaskStartedEvent {
     type: 'task-started';
     taskName: string;
@@ -165,6 +165,12 @@ interface TaskProgressEvent {
     taskName: string;
     message?: string;
     progress?: number;
+    /**
+     * Arbitrary update payload — used by source delivery to carry
+     * { bindTo, fetchedAt, dest } or { bindTo, failure, reason }.
+     * card-handler receives this via TaskHandlerInput.update.
+     */
+    update?: Record<string, unknown>;
     timestamp: string;
     executionId?: string;
 }
@@ -185,12 +191,41 @@ interface AgentActionEvent {
     timestamp: string;
     config?: Partial<ExecutionConfig>;
 }
-interface TaskCreationEvent {
-    type: 'task-creation';
+interface TaskUpsertEvent {
+    type: 'task-upsert';
     taskName: string;
     taskConfig: TaskConfig;
     timestamp: string;
 }
+interface TaskRemovalEvent {
+    type: 'task-removal';
+    taskName: string;
+    timestamp: string;
+}
+interface NodeRequiresAddEvent {
+    type: 'node-requires-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeRequiresRemoveEvent {
+    type: 'node-requires-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesAddEvent {
+    type: 'node-provides-add';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
+interface NodeProvidesRemoveEvent {
+    type: 'node-provides-remove';
+    nodeName: string;
+    tokens: string[];
+    timestamp: string;
+}
 interface SchedulerResult {
     /** Tasks eligible for execution */
     eligibleTasks: string[];
@@ -214,4 +249,4 @@ type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
 type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
 type RefreshStrategy = 'data-changed' | 'epoch-changed' | 'time-based' | 'manual' | 'once';
 
-export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskCreationEvent as j, TaskFailedEvent as k, TaskStartedEvent as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRestartEvent as q, TaskRetryConfig as r };
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RefreshStrategy as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEngineStore as e, GraphEvent as f, GraphSettings as g, StuckDetection as h, TaskCompletedEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskStatus as l, TaskCircuitBreakerConfig as m, TaskMessage as n, TaskProgressEvent as o, TaskRestartEvent as p, TaskRetryConfig as q };

package/dist/{types-FZ_eyErS.d.cts → types-ycun84cq.d.cts}

@@ -21,6 +21,7 @@ interface StepConfig {
     expects_data?: string[];
     produces_data?: string[];
     transitions: Record<string, string>;
+    failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
 }

package/dist/{types-FZ_eyErS.d.ts → types-ycun84cq.d.ts}

@@ -21,6 +21,7 @@ interface StepConfig {
     expects_data?: string[];
     produces_data?: string[];
     transitions: Record<string, string>;
+    failure_transitions?: Record<string, string>;
     retry?: RetryConfig;
     circuit_breaker?: CircuitBreakerConfig;
 }

package/dist/{validate-DEZ2Ymdb.d.ts → validate-DJQTQ6bP.d.ts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig } from './types-DEj7OakX.js';
+import { G as GraphConfig } from './types-CMFSIjpc.js';
 
 /**
  * Event Graph — Semantic Graph Validation

package/dist/{validate-DqKTZg_o.d.cts → validate-ke92Cleg.d.cts}

@@ -1,4 +1,4 @@
-import { G as GraphConfig } from './types-DEj7OakX.cjs';
+import { G as GraphConfig } from './types-CMFSIjpc.cjs';
 
 /**
  * Event Graph — Semantic Graph Validation

package/examples/browser/boards/portfolio-tracker/cards/holdings-table.json

@@ -0,0 +1,22 @@
+{
+  "id": "holdings-table",
+  "meta": { "title": "Holdings Table" },
+  "requires": ["holdings", "prices"],
+  "provides": [{ "bindTo": "table", "src": "computed_values.table" }],
+  "card_data": {},
+  "compute": [
+    {
+      "bindTo": "table",
+      "expr": "{ \"rows\": $map(requires.holdings, function($h) { { \"symbol\": $h.symbol, \"qty\": $h.qty, \"price\": $lookup(requires.prices, $h.symbol), \"value\": $h.qty * $lookup(requires.prices, $h.symbol) } }) }"
+    }
+  ],
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Portfolio Positions",
+        "data": { "bind": "computed_values.table.rows", "columns": ["symbol", "qty", "price", "value"] }
+      }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-form.json

@@ -0,0 +1,16 @@
+{
+  "id": "portfolio-form",
+  "meta": { "title": "Portfolio Holdings Form" },
+  "provides": [{ "bindTo": "holdings", "src": "card_data.holdings" }],
+  "card_data": {
+    "holdings": [
+      { "symbol": "AAPL", "qty": 50 },
+      { "symbol": "MSFT", "qty": 30 }
+    ]
+  },
+  "view": {
+    "elements": [
+      { "kind": "table", "label": "Holdings", "data": { "bind": "card_data.holdings", "columns": ["symbol", "qty"] } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/portfolio-value.json

@@ -0,0 +1,15 @@
+{
+  "id": "portfolio-value",
+  "meta": { "title": "Portfolio Total Value" },
+  "requires": ["table"],
+  "provides": [{ "bindTo": "totalValue", "src": "computed_values.totalValue" }],
+  "card_data": {},
+  "compute": [
+    { "bindTo": "totalValue", "expr": "$sum(requires.table.rows.value)" }
+  ],
+  "view": {
+    "elements": [
+      { "kind": "metric", "label": "Total Portfolio Value", "data": { "bind": "computed_values.totalValue" } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/cards/price-fetch.json

@@ -0,0 +1,15 @@
+{
+  "id": "price-fetch",
+  "meta": { "title": "Fetch Market Prices" },
+  "requires": ["holdings"],
+  "provides": [{ "bindTo": "prices", "src": "fetched_sources.prices" }],
+  "card_data": {},
+  "sources": [
+    { "cli": "node ../fetch-prices.js", "bindTo": "prices", "outputFile": "prices.json" }
+  ],
+  "view": {
+    "elements": [
+      { "kind": "table", "label": "Market Prices", "data": { "bind": "fetched_sources.prices" } }
+    ]
+  }
+}

package/examples/browser/boards/portfolio-tracker/fetch-prices.js

@@ -0,0 +1,43 @@
+/**
+ * fetch-prices.js
+ * Polls for tmp_file1 payload and outputs JSON to stdout once available.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+const envBoardDir = (process.env.BOARD_DIR ?? '').trim();
+const tmpFileCandidates = [
+  envBoardDir ? path.join(envBoardDir, 'tmp_file1') : '',
+  path.join(process.cwd(), 'tmp_file1'),
+  path.join(process.cwd(), 'board-runtime', 'tmp_file1'),
+  path.join(process.cwd(), '..', 'board-runtime', 'tmp_file1'),
+].filter(Boolean);
+
+function getReadableTmpFile() {
+  for (const tmpFile of tmpFileCandidates) {
+    if (!fs.existsSync(tmpFile)) continue;
+    const content = fs.readFileSync(tmpFile, 'utf-8').trim();
+    if (content) return { tmpFile, content };
+  }
+  return undefined;
+}
+
+function waitForFile(timeoutMs = 120000) {
+  const started = Date.now();
+  const interval = setInterval(() => {
+    if (Date.now() - started > timeoutMs) {
+      clearInterval(interval);
+      console.error('Timed out waiting for tmp_file1 market prices input.');
+      process.exit(1);
+    }
+
+    const ready = getReadableTmpFile();
+    if (!ready) return;
+
+    clearInterval(interval);
+    fs.writeFileSync(ready.tmpFile, '', 'utf-8');
+    process.stdout.write(`${ready.content}\n`);
+  }, 250);
+}
+
+waitForFile();

package/examples/browser/boards/portfolio-tracker/portfolio-tracker-task-executor.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * Portfolio Tracker Task-Executor
+ * 
+ * Implements the run-source-fetch protocol for board-live-cards.
+ * This script acts as an external task-executor that can be registered via .task-executor file.
+ * 
+ * Contract:
+ *   portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>
+ * 
+ * Input (--in file):
+ *   JSON source definition with { cli: "...", bindTo: "...", outputFile: "...", ... }
+ * 
+ * Output (on success):
+ *   --out file contains the execution result
+ *   Exit code: 0
+ * 
+ * Output (on error):
+ *   --err file contains error message
+ *   Exit code: 1
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+let subcommand = '';
+let inFile = '';
+let outFile = '';
+let errFile = '';
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === 'run-source-fetch') {
+    subcommand = 'run-source-fetch';
+  } else if (args[i] === '--in' && i + 1 < args.length) {
+    inFile = args[i + 1];
+  } else if (args[i] === '--out' && i + 1 < args.length) {
+    outFile = args[i + 1];
+  } else if (args[i] === '--err' && i + 1 < args.length) {
+    errFile = args[i + 1];
+  }
+}
+
+if (subcommand !== 'run-source-fetch' || !inFile || !outFile || !errFile) {
+  console.error('Usage: portfolio-tracker-task-executor.js run-source-fetch --in <defFile> --out <resultFile> --err <errFile>');
+  process.exit(1);
+}
+
+try {
+  // 1. Read source definition from --in file
+  console.log(`[portfolio-tracker-task-executor] Reading source definition from ${inFile}`);
+  const sourceDefStr = fs.readFileSync(inFile, 'utf-8');
+  const sourceDef = JSON.parse(sourceDefStr);
+  
+  // 2. Extract cli command from source definition
+  const { cli: sourceCliCommand } = sourceDef;
+  if (!sourceCliCommand) {
+    throw new Error('cli is required in source definition');
+  }
+  
+  console.log(`[portfolio-tracker-task-executor] Executing: ${sourceCliCommand}`);
+  
+  // 3. Execute source.cli synchronously and capture output
+  let output;
+  try {
+    output = execSync(sourceCliCommand, {
+      encoding: 'utf-8',
+      timeout: (sourceDef.timeout ?? 120) * 1000,  // Convert to ms
+      cwd: sourceDef.cwd,
+      shell: true,
+      stdio: ['pipe', 'pipe', 'pipe'],  // Capture stdout/stderr
+    });
+  } catch (execErr) {
+    // Even on error, try to use what output we got
+    output = execErr.stdout || '';
+    if (!output) {
+      throw new Error(`Command execution failed: ${execErr.message}`);
+    }
+  }
+  
+  // 4. Write output to --out file
+  console.log(`[portfolio-tracker-task-executor] Writing result to ${outFile}`);
+  fs.writeFileSync(outFile, output.trim(), 'utf-8');
+  
+  console.log(`[portfolio-tracker-task-executor] Success`);
+  process.exit(0);
+} catch (error) {
+  // 3a. On error: write error message to --err file and exit non-zero
+  const errorMsg = error instanceof Error ? error.message : String(error);
+  console.error(`[portfolio-tracker-task-executor] Error:`, errorMsg);
+  
+  fs.writeFileSync(errFile, errorMsg, 'utf-8');
+  process.exit(1);
+}

package/examples/browser/boards/portfolio-tracker/portfolio-tracker.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+
+set "BOARD_LIVE_CARDS_NO_SPAWN=1"
+node "%~dp0portfolio-tracker.js"
+
+endlocal