yaml-flow 5.1.0 → 5.2.1

package/dist/cli/board-live-cards-cli.d.cts

@@ -1,7 +1,7 @@
-import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-BzLD8bjb.cjs';
-import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-vGJ6tMzN.cjs';
-import { f as GraphEvent, T as TaskConfig } from '../types-CMFSIjpc.cjs';
-import { J as Journal } from '../journal-DRfJiheM.cjs';
+import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-CHSdoAAA.cjs';
+import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-z_rJCSbi.cjs';
+import { f as GraphEvent, T as TaskConfig } from '../types-BBhqYGhE.cjs';
+import { J as Journal } from '../journal-B-JCfQnh.cjs';
 
 /**
  * Board Live Cards — Disk persistence + CLI for ReactiveGraph.
@@ -64,6 +64,8 @@ interface SourceTokenPayload {
     b: string;
     /** sources[].outputFile (relative to boardDir) */
     d: string;
+    /** Per-source invocation checksum */
+    cs?: string;
 }
 declare function encodeSourceToken(payload: SourceTokenPayload): string;
 declare function decodeSourceToken(token: string): SourceTokenPayload | null;
@@ -71,9 +73,35 @@ interface SourceRuntimeEntry {
     lastRequestedAt?: string;
     lastFetchedAt?: string;
     lastError?: string;
+    /** Timestamp of the most recent card-handler dispatch — updated on every fresh invocation.
+     * Replaces checksum-based gating: a source fetch is needed whenever
+     * lastFetchedAt is absent or older than queueRequestedAt. */
+    queueRequestedAt?: string;
 }
+interface InferenceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
+    queueRequestedAt?: string;
+}
+type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
+declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
+/**
+ * Decide what to do with a source/inference fetch given the current runtime entry
+ * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
+ *
+ * - 'dispatch' : fetch not yet started for this run, or previous fetch predates the request
+ * - 'in-flight': fetch is already running for this run — update queueRequestedAt and wait
+ * - 'idle'     : fetch already completed for this run — nothing to do
+ */
+declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
+declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
+declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
 interface CardRuntimeState {
     _sources: Record<string, SourceRuntimeEntry>;
+    _inferenceEntry?: InferenceRuntimeEntry;
+    _lastExecutionCount?: number;
 }
 /**
  * Append a raw event to the journal file. No lock, no file read.
@@ -202,4 +230,4 @@ interface BoardStatusObject {
 }
 declare function cli(argv: string[]): Promise<void>;
 
-export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };
+export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };

package/dist/cli/board-live-cards-cli.d.ts

@@ -1,7 +1,7 @@
-import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-C2eJ7DAV.js';
-import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-Or7fdEJV.js';
-import { f as GraphEvent, T as TaskConfig } from '../types-CMFSIjpc.js';
-import { J as Journal } from '../journal-NLYuqege.js';
+import { b as LiveGraphSnapshot, L as LiveGraph } from '../types-CoW0gQl3.js';
+import { a as LiveCard, R as ReactiveGraph } from '../live-cards-bridge-CeNxiVcm.js';
+import { f as GraphEvent, T as TaskConfig } from '../types-BBhqYGhE.js';
+import { J as Journal } from '../journal-9HEgs7dU.js';
 
 /**
  * Board Live Cards — Disk persistence + CLI for ReactiveGraph.
@@ -64,6 +64,8 @@ interface SourceTokenPayload {
     b: string;
     /** sources[].outputFile (relative to boardDir) */
     d: string;
+    /** Per-source invocation checksum */
+    cs?: string;
 }
 declare function encodeSourceToken(payload: SourceTokenPayload): string;
 declare function decodeSourceToken(token: string): SourceTokenPayload | null;
@@ -71,9 +73,35 @@ interface SourceRuntimeEntry {
     lastRequestedAt?: string;
     lastFetchedAt?: string;
     lastError?: string;
+    /** Timestamp of the most recent card-handler dispatch — updated on every fresh invocation.
+     * Replaces checksum-based gating: a source fetch is needed whenever
+     * lastFetchedAt is absent or older than queueRequestedAt. */
+    queueRequestedAt?: string;
 }
+interface InferenceRuntimeEntry {
+    lastRequestedAt?: string;
+    lastFetchedAt?: string;
+    lastError?: string;
+    /** Same semantics as SourceRuntimeEntry.queueRequestedAt. */
+    queueRequestedAt?: string;
+}
+type FetchRuntimeEntry = SourceRuntimeEntry | InferenceRuntimeEntry;
+declare function isSourceInFlight(entry: FetchRuntimeEntry | undefined): boolean;
+/**
+ * Decide what to do with a source/inference fetch given the current runtime entry
+ * and the timestamp of the latest card-handler dispatch (queueRequestedAt).
+ *
+ * - 'dispatch' : fetch not yet started for this run, or previous fetch predates the request
+ * - 'in-flight': fetch is already running for this run — update queueRequestedAt and wait
+ * - 'idle'     : fetch already completed for this run — nothing to do
+ */
+declare function decideSourceAction(entry: FetchRuntimeEntry | undefined, queueRequestedAt: string): 'dispatch' | 'in-flight' | 'idle';
+declare function nextEntryAfterFetchDelivery<T extends FetchRuntimeEntry>(entry: T, fetchedAt: string): T;
+declare function nextEntryAfterFetchFailure<T extends FetchRuntimeEntry>(entry: T, reason: string): T;
 interface CardRuntimeState {
     _sources: Record<string, SourceRuntimeEntry>;
+    _inferenceEntry?: InferenceRuntimeEntry;
+    _lastExecutionCount?: number;
 }
 /**
  * Append a raw event to the journal file. No lock, no file read.
@@ -202,4 +230,4 @@ interface BoardStatusObject {
 }
 declare function cli(argv: string[]): Promise<void>;
 
-export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };
+export { type BoardEnvelope, BoardJournal, type BoardLiveCard, type BoardReactiveGraph, type BoardStatusCard, type BoardStatusObject, type CardInventoryEntry, type CardInventoryIndex, type CardRuntimeState, type InferenceRuntimeEntry, type JournalEntry, type SourceRuntimeEntry, type SourceTokenPayload, appendCardInventory, appendEventToJournal, buildCardInventoryIndex, cli, createBoardReactiveGraph, decideSourceAction, decodeSourceToken, encodeSourceToken, getUndrainedEntries, initBoard, isSourceInFlight, liveCardToTaskConfig, loadBoard, loadBoardEnvelope, lookupCardPath, nextEntryAfterFetchDelivery, nextEntryAfterFetchFailure, processAccumulatedEvents, processAccumulatedEventsForced, processAccumulatedEventsInfinitePass, readCardInventory, saveBoard, withBoardLock };