yaml-flow 3.1.1 → 5.0.0

package/examples/{batch → npm-libs/batch}/batch-step-machine.ts

@@ -7,7 +7,7 @@
  *  - Progress tracking
  *  - Mixed success/failure handling
  *
- * Run with: npx tsx examples/batch/batch-step-machine.ts
+ * Run with: npx tsx examples/npm-libs/batch/batch-step-machine.ts
  */
 
 import { batch } from '../../src/batch/index.js';

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/live-cards-board.ts

@@ -16,7 +16,7 @@
  *  - LiveBoard overload — board.id, board.settings forwarded to GraphConfig
  *  - validateReactiveGraph on the resulting graph
  *
- * Run with: npx tsx examples/continuous-event-graph/live-cards-board.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/live-cards-board.ts
  */
 
 import {
@@ -36,31 +36,31 @@ const cards: LiveCard[] = [
     id: 'market-feed',
     type: 'source',
     meta: { title: 'Live Market Prices' },
-    state: { prices: [142.5, 305.8, 89.2, 211.0, 178.3] },
-    source: { kind: 'static', bindTo: 'state.prices' },
+    card_data: { prices: [142.5, 305.8, 89.2, 211.0, 178.3] },
+    source: { kind: 'static', bindTo: 'card_data.prices' },
   },
   {
     id: 'stats',
     type: 'card',
     meta: { title: 'Price Statistics' },
-    state: {},
+    card_data: {},
     data: { requires: ['market-feed'] },
     compute: {
-      total: { fn: 'sum', input: 'state.market-feed.prices' },
-      avg: { fn: 'avg', input: 'state.market-feed.prices' },
-      count: { fn: 'count', input: 'state.market-feed.prices' },
+      total: { fn: 'sum', input: 'sources.market-feed.prices' },
+      avg: { fn: 'avg', input: 'sources.market-feed.prices' },
+      count: { fn: 'count', input: 'sources.market-feed.prices' },
     },
   },
   {
     id: 'summary',
     type: 'card',
     meta: { title: 'Summary Label' },
-    state: {},
+    card_data: {},
     data: { requires: ['stats'] },
     compute: {
       label: {
         fn: 'template',
-        input: 'state.stats',
+        input: 'computed_values.stats',
         format: '{{count}} stocks — total ${{total}}, avg ${{avg}}',
       },
     },
@@ -115,37 +115,37 @@ const board: LiveBoard = {
       id: 'equity-feed',
       type: 'source',
       meta: { title: 'Equity Prices' },
-      state: {},
-      source: { kind: 'api', bindTo: 'state.raw', url_template: 'https://api.example.com/equity' },
+      card_data: {},
+      source: { kind: 'api', bindTo: 'card_data.raw', url_template: 'https://api.example.com/equity' },
     },
     {
       id: 'bond-feed',
       type: 'source',
       meta: { title: 'Bond Yields' },
-      state: { yields: [3.2, 4.1, 2.8, 5.0] },
-      source: { kind: 'static', bindTo: 'state.yields' },
+      card_data: { yields: [3.2, 4.1, 2.8, 5.0] },
+      source: { kind: 'static', bindTo: 'card_data.yields' },
     },
     {
       id: 'portfolio-mix',
       type: 'card',
       meta: { title: 'Portfolio Mix Calculator' },
-      state: {},
+      card_data: {},
       data: { requires: ['equity-feed', 'bond-feed'] },
       compute: {
-        equity_total: { fn: 'sum', input: 'state.equity-feed.prices' },
-        bond_total: { fn: 'sum', input: 'state.bond-feed.yields' },
+        equity_total: { fn: 'sum', input: 'sources.equity-feed.prices' },
+        bond_total: { fn: 'sum', input: 'sources.bond-feed.yields' },
       },
     },
     {
       id: 'risk-summary',
       type: 'card',
       meta: { title: 'Risk Summary' },
-      state: {},
+      card_data: {},
       data: { requires: ['portfolio-mix'] },
       compute: {
         label: {
           fn: 'template',
-          input: 'state.portfolio-mix',
+          input: 'computed_values.portfolio-mix',
           format: 'Equities: ${{equity_total}} | Bonds: {{bond_total}}%',
         },
       },

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/live-portfolio-dashboard.ts

@@ -22,7 +22,7 @@
  * Dynamically added: allocation-chart, risk-score, daily-pnl,
  *   value-alert, summary, correlation, combined-view
  *
- * Run with: npx tsx examples/continuous-event-graph/live-portfolio-dashboard.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/live-portfolio-dashboard.ts
  */
 
 import * as fs from 'node:fs';
@@ -69,8 +69,8 @@ const cards: LiveCard[] = [
   {
     id: 'holdings', type: 'source',
     meta: { title: 'Portfolio Holdings' },
-    data: { provides: { holdings: 'state.holdings' } },
-    state: {
+    data: { provides: { holdings: 'card_data.holdings' } },
+    card_data: {
       holdings: [
         { symbol: 'AAPL', shares: 50, sector: 'tech' },
         { symbol: 'MSFT', shares: 30, sector: 'tech' },
@@ -83,13 +83,13 @@ const cards: LiveCard[] = [
   {
     id: 'price-feed', type: 'source',
     meta: { title: 'Live Price Feed' },
-    data: { provides: { prices: 'state.prices' } },
-    state: { prices: { AAPL: 195.50, MSFT: 420.10, GOOG: 176.30, JPM: 198.20, JNJ: 155.80 } },
+    data: { provides: { prices: 'card_data.prices' } },
+    card_data: { prices: { AAPL: 195.50, MSFT: 420.10, GOOG: 176.30, JPM: 198.20, JNJ: 155.80 } },
   },
   {
     id: 'news-feed', type: 'source',
     meta: { title: 'Market News Feed' },
-    state: {
+    card_data: {
       headlines: [
         { symbol: 'AAPL', headline: 'Apple beats Q4 estimates', sentiment: 0.8 },
         { symbol: 'JPM', headline: 'JPMorgan raises dividend', sentiment: 0.6 },
@@ -100,32 +100,32 @@ const cards: LiveCard[] = [
   {
     id: 'benchmark', type: 'source',
     meta: { title: 'S&P 500 Benchmark' },
-    state: { index: 'SPY', value: 5280.50, dailyReturn: 0.45 },
+    card_data: { index: 'SPY', value: 5280.50, dailyReturn: 0.45 },
   },
   // Compute cards
   {
     id: 'valuator', type: 'card',
     meta: { title: 'Position Valuator' },
     data: { requires: ['holdings', 'price-feed'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'portfolio-value', type: 'card',
     meta: { title: 'Total Portfolio Value' },
     data: { requires: ['valuator'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'sector-breakdown', type: 'card',
     meta: { title: 'Sector Breakdown' },
     data: { requires: ['valuator'] },
-    state: {},
+    card_data: {},
   },
   {
     id: 'sentiment', type: 'card',
     meta: { title: 'News Sentiment Score' },
     data: { requires: ['news-feed'] },
-    state: {},
+    card_data: {},
   },
 ];
 
@@ -144,7 +144,7 @@ function makeHandler(
     const result = computeFn(graphRef!.getState());
     try {
       const diskCard = readCard(dir, id);
-      diskCard.state = { ...diskCard.state, ...result };
+      diskCard.card_data = { ...diskCard.card_data, ...result };
       writeCard(dir, diskCard);
     } catch { /* card may not exist yet */ }
     graphRef!.resolveCallback(input.callbackToken, result);
@@ -225,7 +225,7 @@ async function main() {
           if (taskState.data && Object.keys(taskState.data).length > 0) {
             try {
               const diskCard = readCard(tmpDir, taskName);
-              diskCard.state = { ...diskCard.state, ...taskState.data };
+              diskCard.card_data = { ...diskCard.card_data, ...taskState.data };
               writeCard(tmpDir, diskCard);
             } catch { /* not on disk yet */ }
           }
@@ -251,7 +251,7 @@ async function main() {
   log('PHASE 2', 'Adding 7 dynamic cards → 15 total');
 
   addDynamicCard(rg, tmpDir, {
-    id: 'allocation-chart', type: 'card', data: { requires: ['valuator', 'portfolio-value'] }, state: {},
+    id: 'allocation-chart', type: 'card', data: { requires: ['valuator', 'portfolio-value'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const tot = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
@@ -259,7 +259,7 @@ async function main() {
   }, { requires: ['valuator', 'portfolio-value'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'risk-score', type: 'card', data: { requires: ['valuator'] }, state: {},
+    id: 'risk-score', type: 'card', data: { requires: ['valuator'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const vals = pos.map((p: any) => p.value);
@@ -269,7 +269,7 @@ async function main() {
   }, { requires: ['valuator'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'daily-pnl', type: 'card', data: { requires: ['portfolio-value', 'benchmark'] }, state: {},
+    id: 'daily-pnl', type: 'card', data: { requires: ['portfolio-value', 'benchmark'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     const benchReturn = (e.state.tasks.benchmark?.data as any)?.dailyReturn ?? 0;
@@ -278,14 +278,14 @@ async function main() {
   }, { requires: ['portfolio-value', 'benchmark'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'value-alert', type: 'card', data: { requires: ['portfolio-value'] }, state: {},
+    id: 'value-alert', type: 'card', data: { requires: ['portfolio-value'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     return { triggered: tv > 25000, threshold: 25000, currentValue: tv };
   }, { requires: ['portfolio-value'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'summary', type: 'card', data: { requires: ['portfolio-value', 'sentiment'] }, state: {},
+    id: 'summary', type: 'card', data: { requires: ['portfolio-value', 'sentiment'] }, card_data: {},
   }, (e) => {
     const tv = (e.state.tasks['portfolio-value']?.data as any)?.totalValue ?? 0;
     const mood = (e.state.tasks.sentiment?.data as any)?.bullish ? 'bullish' : 'bearish';
@@ -293,7 +293,7 @@ async function main() {
   }, { requires: ['portfolio-value', 'sentiment'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'correlation', type: 'card', data: { requires: ['valuator', 'benchmark'] }, state: {},
+    id: 'correlation', type: 'card', data: { requires: ['valuator', 'benchmark'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const techVal = pos.filter((p: any) => p.sector === 'tech').reduce((s: number, p: any) => s + p.value, 0);
@@ -302,7 +302,7 @@ async function main() {
   }, { requires: ['valuator', 'benchmark'] });
 
   addDynamicCard(rg, tmpDir, {
-    id: 'combined-view', type: 'card', data: { requires: ['summary', 'sector-breakdown', 'risk-score'] }, state: {},
+    id: 'combined-view', type: 'card', data: { requires: ['summary', 'sector-breakdown', 'risk-score'] }, card_data: {},
   }, (e) => ({
     summaryMood: (e.state.tasks.summary?.data as any)?.mood ?? '?',
     sectors: (e.state.tasks['sector-breakdown']?.data as any)?.sectorCount ?? 0,
@@ -326,7 +326,7 @@ async function main() {
   console.log('  benchmark provides:', rg.getState().config.tasks.benchmark.provides);
 
   addDynamicCard(rg, tmpDir, {
-    id: 'market-context', type: 'card', data: { requires: ['market-data'] }, state: {},
+    id: 'market-context', type: 'card', data: { requires: ['market-data'] }, card_data: {},
   }, (e) => {
     const bench = e.state.tasks.benchmark?.data as any ?? {};
     return { indexValue: bench.value ?? 0, context: 'provided via market-data token' };
@@ -409,7 +409,7 @@ async function main() {
   console.log('  combined-view requires:', rg.getState().config.tasks['combined-view'].requires);
 
   addDynamicCard(rg, tmpDir, {
-    id: 'allocation-chart', type: 'card', data: { requires: ['valuator'] }, state: {},
+    id: 'allocation-chart', type: 'card', data: { requires: ['valuator'] }, card_data: {},
   }, (e) => {
     const pos = (e.state.tasks.valuator?.data as any)?.positions ?? [];
     const total = pos.reduce((s: number, p: any) => s + p.value, 0);
@@ -436,7 +436,7 @@ async function main() {
     id: 'watchlist', type: 'source',
     meta: { title: 'Watchlist (User Input)' },
     data: { provides: { watchlist: 'state.symbols' } },
-    state: { symbols: ['NVDA', 'AMD', 'AMZN'] },
+    card_data: { symbols: ['NVDA', 'AMD', 'AMZN'] },
   };
   writeCard(tmpDir, watchlistCard);
   rg.registerHandler('watchlist', makeHandler('watchlist', (engine) => {
@@ -463,7 +463,7 @@ async function main() {
   addDynamicCard(rg, tmpDir, {
     id: 'watchlist-prices', type: 'card',
     meta: { title: 'Watchlist Latest Prices' },
-    data: { requires: ['watchlist', 'price-feed'] }, state: {},
+    data: { requires: ['watchlist', 'price-feed'] }, card_data: {},
   }, (engine) => {
     const symbols: string[] = (engine.state.tasks.watchlist?.data as any)?.symbols ?? [];
     const allPrices: Record<string, number> = (engine.state.tasks['price-feed']?.data as any)?.prices ?? {};

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/portfolio-tracker.ts

@@ -29,7 +29,7 @@
  *   T3: Force price refresh without form change → retrigger('price-fetch')
  *   T4: Quiescent
  *
- * Run with: npx tsx examples/continuous-event-graph/portfolio-tracker.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/portfolio-tracker.ts
  */
 
 import type { GraphConfig } from '../../src/event-graph/types.js';

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/reactive-monitoring.ts

@@ -15,7 +15,7 @@
  * Scenario: A monitoring system that collects metrics, evaluates alerts,
  * and dynamically adds notification channels at runtime.
  *
- * Run with: npx tsx examples/continuous-event-graph/reactive-monitoring.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/reactive-monitoring.ts
  */
 
 import {

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/reactive-pipeline.ts

@@ -9,7 +9,7 @@
  *  - validateLiveGraph for runtime state-consistency checks
  *  - validateReactiveGraph for handler/dispatch checks
  *
- * Run with: npx tsx examples/continuous-event-graph/reactive-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/reactive-pipeline.ts
  */
 
 import {

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/soc-incident-board.ts

@@ -31,7 +31,7 @@
  *   T1: New intel arrives → retrigger threat-intel → data-changed cascade
  *       create-ticket skipped (once) — slack re-fires
  *
- * Run with: npx tsx examples/continuous-event-graph/soc-incident-board.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/soc-incident-board.ts
  */
 
 import type { GraphConfig } from '../../src/event-graph/types.js';

package/examples/{continuous-event-graph → npm-libs/continuous-event-graph}/stock-dashboard.ts

@@ -10,7 +10,7 @@
  *  - Scheduling adapts as the graph evolves
  *  - Snapshots allow persistence and restore
  *
- * Run with: npx tsx examples/continuous-event-graph/stock-dashboard.ts
+ * Run with: npx tsx examples/npm-libs/continuous-event-graph/stock-dashboard.ts
  */
 
 import {

package/examples/{event-graph → npm-libs/event-graph}/ci-cd-pipeline.ts

@@ -8,7 +8,7 @@
  *  - Retry configuration
  *  - Stuck detection
  *
- * Run with: npx tsx examples/event-graph/ci-cd-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/event-graph/ci-cd-pipeline.ts
  */
 
 import {

package/examples/{event-graph → npm-libs/event-graph}/executor-diamond.ts

@@ -12,7 +12,7 @@
  *          |
  *        report
  *
- * Run with: npx tsx examples/event-graph/executor-diamond.ts
+ * Run with: npx tsx examples/npm-libs/event-graph/executor-diamond.ts
  */
 
 import {

package/examples/{event-graph → npm-libs/event-graph}/executor-pipeline.ts

@@ -11,7 +11,7 @@
  *
  * Contrast with reactive-pipeline.ts where the graph drives itself.
  *
- * Run with: npx tsx examples/event-graph/executor-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/event-graph/executor-pipeline.ts
  */
 
 import {

package/examples/{event-graph → npm-libs/event-graph}/research-pipeline.ts

@@ -6,7 +6,7 @@
  *  - Goal-based completion
  *  - The standard next() / apply() driver loop
  *
- * Run with: npx tsx examples/event-graph/research-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/event-graph/research-pipeline.ts
  */
 
 import {

package/examples/{graph-of-graphs → npm-libs/graph-of-graphs}/multi-stage-etl.ts

@@ -21,7 +21,7 @@
  * Inner transform flow (step-machine, per record):
  *   parse → validate → normalize → enrich → (accept | reject)
  *
- * Run with: npx tsx examples/graph-of-graphs/multi-stage-etl.ts
+ * Run with: npx tsx examples/npm-libs/graph-of-graphs/multi-stage-etl.ts
  */
 
 import {

package/examples/{graph-of-graphs → npm-libs/graph-of-graphs}/url-processing-pipeline.ts

@@ -19,7 +19,7 @@
  *  - resolveConfigTemplates() for DRY task configs
  *  - Parallel fan-out inside inner graph
  *
- * Run with: npx tsx examples/graph-of-graphs/url-processing-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/graph-of-graphs/url-processing-pipeline.ts
  */
 
 import {

package/examples/{inference → npm-libs/inference}/azure-deployment.ts

@@ -5,7 +5,7 @@
  * The graph has 3 checkpoints. After deployment, the LLM analyzes
  * logs and determines what's complete.
  *
- * Run with: npx tsx examples/inference/azure-deployment.ts
+ * Run with: npx tsx examples/npm-libs/inference/azure-deployment.ts
  */
 
 import {

package/examples/{inference → npm-libs/inference}/copilot-cli.ts

@@ -8,7 +8,7 @@
  *   - GitHub Copilot CLI installed (comes with VS Code / GitHub Copilot extension)
  *   - `copilot` available on PATH
  *
- * Run with: npx tsx examples/inference/copilot-cli.ts
+ * Run with: npx tsx examples/npm-libs/inference/copilot-cli.ts
  */
 
 import { createLiveGraph, schedule } from '../../src/continuous-event-graph/index.js';

package/examples/{inference → npm-libs/inference}/data-pipeline.ts

@@ -4,7 +4,7 @@
  * Demonstrates iterative inference — run the LLM multiple times as
  * new evidence arrives. Each round may unlock more tasks.
  *
- * Run with: npx tsx examples/inference/data-pipeline.ts
+ * Run with: npx tsx examples/npm-libs/inference/data-pipeline.ts
  */
 
 import {

package/examples/{inference → npm-libs/inference}/pluggable-adapters.ts

@@ -4,7 +4,7 @@
  * Shows how to create adapters for different LLM providers.
  * Each adapter implements InferenceAdapter.analyze(prompt) → string.
  *
- * Run with: npx tsx examples/inference/pluggable-adapters.ts
+ * Run with: npx tsx examples/npm-libs/inference/pluggable-adapters.ts
  */
 
 import {

package/examples/{node → npm-libs/node}/ai-conversation.ts

@@ -7,7 +7,7 @@
  * - Circuit breakers
  * - Event handling
  * 
- * Run with: npx ts-node examples/node/ai-conversation.ts
+ * Run with: npx ts-node examples/npm-libs/node/ai-conversation.ts
  */
 
 import { createEngine, loadFlow, MemoryStore } from '../../src/index.js';

package/examples/{node → npm-libs/node}/simple-greeting.ts

@@ -3,8 +3,8 @@
  * 
  * Demonstrates basic usage with file-based persistence.
  * 
- * Run with: npx ts-node examples/node/simple-greeting.ts
- * Or after build: node examples/node/simple-greeting.js
+ * Run with: npx ts-node examples/npm-libs/node/simple-greeting.ts
+ * Or after build: node examples/npm-libs/node/simple-greeting.js
  */
 
 import { createEngine, loadFlow, FileStore } from '../../src/index.js';

package/examples/step-machine-cli/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/step-machine-cli/portfolio-tracker/cards/portfolio-form.json

@@ -0,0 +1,43 @@
+{
+  "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
+      },
+      {
+        "symbol": "GOOG",
+        "qty": 100
+      }
+    ]
+  },
+  "view": {
+    "elements": [
+      {
+        "kind": "table",
+        "label": "Holdings",
+        "data": {
+          "bind": "card_data.holdings",
+          "columns": [
+            "symbol",
+            "qty"
+          ]
+        }
+      }
+    ]
+  }
+}

package/examples/step-machine-cli/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/step-machine-cli/portfolio-tracker/cards/price-fetch.json

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

package/examples/step-machine-cli/portfolio-tracker/fetch-prices.js

@@ -0,0 +1,48 @@
+/**
+ * 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';
+
+function getArgValue(flagName) {
+  const idx = process.argv.indexOf(flagName);
+  if (idx < 0) return undefined;
+  return process.argv[idx + 1];
+}
+
+const envBoardDir = (process.env.BOARD_DIR ?? '').trim();
+const tmpFileName = String(getArgValue('--tmp-file-name') ?? process.env.TMP_FILE_NAME ?? 'tmp_file1').trim();
+const tmpFilePath = envBoardDir ? path.join(envBoardDir, tmpFileName) : '';
+
+if (!tmpFilePath) {
+  console.error('BOARD_DIR environment variable is required for fetch-prices.js');
+  process.exit(1);
+}
+
+function getReadableTmpFile() {
+  if (!fs.existsSync(tmpFilePath)) return undefined;
+  const content = fs.readFileSync(tmpFilePath, 'utf-8').trim();
+  if (!content) return undefined;
+  return { tmpFile: tmpFilePath, content };
+}
+
+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();