yaml-flow 8.8.7 → 8.9.0

package/examples/board/test/server-http-test.js

@@ -331,28 +331,32 @@ function waitForFirstSsePayload(sseUrl, timeoutMs = 15_000) {
 
 function captureChatEvents(payload, cardId) {
   if (!payload || payload.kind !== 'notification-batch' || !Array.isArray(payload.notifications)) return;
+  const latestByCardId = new Map();
+  for (const existing of NS.allChatNotifications) {
+    if (existing && existing.cardId) latestByCardId.set(existing.cardId, existing);
+  }
   for (const n of payload.notifications) {
-    if (n && n.kind === 'card_chats' && n.cardId) {
-      const messages = Array.isArray(n.messages) ? n.messages : [];
-      NS.allChatNotifications.push({
-        at: Date.now(),
-        cardId: n.cardId,
-        processing: !!n.processing,
-        receiving: !!n.receiving,
-        messageCount: messages.length,
-        messages,
-      });
-    }
-    if (n && n.kind === 'card_chats' && n.cardId === cardId) {
-      const messages = Array.isArray(n.messages) ? n.messages : [];
-      NS.chatEvents.push({
-        at: Date.now(),
-        cardId: n.cardId,
-        processing: !!n.processing,
-        receiving: !!n.receiving,
-        messageCount: messages.length,
-        messages,
-      });
+    if (!n || !n.cardId) continue;
+    if (n.kind !== 'card_chats' && n.kind !== 'chat_messages' && n.kind !== 'chat_processing') continue;
+    const previous = latestByCardId.get(n.cardId) || {
+      cardId: n.cardId,
+      processing: false,
+      receiving: false,
+      messageCount: 0,
+      messages: [],
+    };
+    const next = {
+      at: Date.now(),
+      cardId: n.cardId,
+      processing: n.kind === 'chat_processing' ? !!n.active : ('processing' in n ? !!n.processing : !!previous.processing),
+      receiving: 'receiving' in n ? !!n.receiving : !!previous.receiving,
+      messageCount: Array.isArray(n.messages) ? n.messages.length : previous.messageCount,
+      messages: Array.isArray(n.messages) ? n.messages : previous.messages,
+    };
+    latestByCardId.set(n.cardId, next);
+    NS.allChatNotifications.push(next);
+    if (n.cardId === cardId) {
+      NS.chatEvents.push(next);
     }
   }
 }
@@ -585,31 +589,36 @@ const waitForChatPredicate = (predicate, ms, label) =>
 
 function deriveProbeLifecycleMilestones(events, opts) {
   const milestones = [];
-  let prevMessageCount = Number(opts.beforeCount || 0);
   let prevProcessing = Boolean(opts.beforeProcessing);
   const prompt = String(opts.prompt || '');
   const assistantText = opts.assistantText == null ? `Echo: ${prompt}` : String(opts.assistantText);
   const inProgressText = String(opts.inProgressText || PROBE_IN_PROGRESS_TEXT);
+  const seenRelevantMessages = new Set();
 
   for (const event of events) {
     const messages = Array.isArray(event?.messages) ? event.messages : [];
-    const nextMessageCount = Number(event?.messageCount || messages.length || 0);
-    const newMessages = nextMessageCount > prevMessageCount
-      ? messages.slice(prevMessageCount, nextMessageCount)
-      : [];
-
-    for (const message of newMessages) {
+    for (const message of messages) {
       const role = String(message?.role || '');
       const text = String(message?.text || '');
-      if (role === 'user' && text.includes(prompt)) milestones.push('user');
-      else if (role === 'system' && text.trim().toLowerCase() === inProgressText) milestones.push('in-progress');
-      else if (role === 'assistant' && text.includes(assistantText)) milestones.push('assistant');
+      const turn = typeof message?.turn === 'string' ? message.turn : '';
+      const signature = `${turn}|${role}|${text}`;
+      if (seenRelevantMessages.has(signature)) continue;
+
+      if (role === 'user' && text.includes(prompt)) {
+        milestones.push('user');
+        seenRelevantMessages.add(signature);
+      } else if (role === 'system' && text.trim().toLowerCase() === inProgressText) {
+        milestones.push('in-progress');
+        seenRelevantMessages.add(signature);
+      } else if (role === 'assistant' && text.includes(assistantText)) {
+        milestones.push('assistant');
+        seenRelevantMessages.add(signature);
+      }
     }
 
     const processing = Boolean(event?.processing);
     if (processing !== prevProcessing) milestones.push(processing ? 'processing-true' : 'processing-false');
 
-    prevMessageCount = nextMessageCount;
     prevProcessing = processing;
   }
 
@@ -1163,9 +1172,9 @@ try {
     const t2aAssistant = await waitForChatPredicate((events) => {
       for (let i = events.length - 1; i >= 0; i -= 1) {
         const e = events[i];
-        if (e.messageCount < t2aBeforeCount + 2) continue;
-        const last = e.messages[e.messages.length - 1];
-        if (last?.role === 'assistant' && /paris/i.test(String(last.text || ''))) return e;
+        const messages = Array.isArray(e?.messages) ? e.messages : [];
+        const assistant = [...messages].reverse().find((message) => message?.role === 'assistant');
+        if (assistant?.role === 'assistant' && /paris/i.test(String(assistant.text || ''))) return e;
       }
       return false;
     }, 240_000, 'T3a assistant response with paris');

package/lib/{artifacts-store-lib-C6qBpMfU.d.cts → artifacts-store-lib-CqkJEgbx.d.cts}

@@ -1,4 +1,4 @@
-import { B as BlobStorage } from './storage-interface-D-iEiTJA.cjs';
+import { B as BlobStorage } from './storage-interface-DogVPooM.cjs';
 
 /**
  * artifacts-store-lib.ts

package/lib/{artifacts-store-lib-D4qf7Q-7.d.ts → artifacts-store-lib-D6Bo4yFN.d.ts}

@@ -1,4 +1,4 @@
-import { B as BlobStorage } from './storage-interface-D-iEiTJA.js';
+import { B as BlobStorage } from './storage-interface-DogVPooM.js';
 
 /**
  * artifacts-store-lib.ts

package/lib/artifacts-store-public.d.cts

@@ -1,7 +1,9 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-BT5HrgqZ.cjs';
-import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-C6qBpMfU.cjs';
-import './storage-interface-D-iEiTJA.cjs';
+import { CommandInput, CommandResult } from './board-live-cards-public.cjs';
+import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-CqkJEgbx.cjs';
+import './storage-interface-DogVPooM.cjs';
+import './board-callback-transport-kP0K6UMq.cjs';
 import './execution-refs.cjs';
+import './board-live-cards-lib-DVh3t9NT.cjs';
 import './types-BBhqYGhE.cjs';
 
 /**

package/lib/artifacts-store-public.d.ts

@@ -1,7 +1,9 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-DSRamFm8.js';
-import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-D4qf7Q-7.js';
-import './storage-interface-D-iEiTJA.js';
+import { CommandInput, CommandResult } from './board-live-cards-public.js';
+import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-D6Bo4yFN.js';
+import './storage-interface-DogVPooM.js';
+import './board-callback-transport-Bekq8Gp-.js';
 import './execution-refs.js';
+import './board-live-cards-lib-iU8xOwNp.js';
 import './types-BBhqYGhE.js';
 
 /**

package/lib/board-callback-transport-Bekq8Gp-.d.ts

@@ -0,0 +1,71 @@
+import { h as JournalStorage, K as KVStorage } from './storage-interface-DogVPooM.js';
+import { ExecutionRef } from './execution-refs.js';
+
+/**
+ * chat-storage-lib.ts
+ *
+ * ChatStorage interface + factories backed by JournalStorage (history) and
+ * KVStorage (processing state and config).
+ *
+ * Platform-free — no node:fs or node:crypto imports.
+ */
+
+type Awaitable<T> = T | Promise<T>;
+interface ChatRecord {
+    /** Journal entry id — also used as SSE cursor. */
+    id: string;
+    role: string;
+    text: string;
+    files: unknown[];
+    turn: string;
+    updated_at: string;
+}
+interface ChatConfig {
+    systemPrompt?: string;
+}
+interface ChatReadAfterResult {
+    records: ChatRecord[];
+    /** Pass as cursor on the next call. Null when the journal is empty. */
+    cursor: string | null;
+}
+interface ChatStorage {
+    /** Append a message; returns the new entry id (usable as a cursor). */
+    append(cardId: string, role: string, text: string, files?: unknown[], turn?: string): Awaitable<string>;
+    /** Read all messages in insertion order. */
+    readAll(cardId: string): Awaitable<ChatRecord[]>;
+    /**
+     * Read messages appended after cursor.
+     * Pass null to read from the beginning.
+     */
+    readAfter(cardId: string, cursor: string | null): Awaitable<ChatReadAfterResult>;
+    /** Remove all messages for this card. */
+    clear(cardId: string): Awaitable<void>;
+    setProcessing(cardId: string, active: boolean): Awaitable<void>;
+    isProcessing(cardId: string): Awaitable<boolean>;
+    getConfig(cardId: string): Awaitable<ChatConfig>;
+    setConfig(cardId: string, patch: Partial<ChatConfig>): Awaitable<void>;
+}
+/**
+ * Create a ChatStorage backed by:
+ *  - journalFactory(cardId) → JournalStorage  (one per-card journal for history)
+ *  - kv                     → KVStorage       (shared processing flags + config)
+ */
+declare function createChatStorage(journalFactory: (cardId: string) => JournalStorage, kv: KVStorage): ChatStorage;
+declare function createInMemoryChatStorage(): ChatStorage;
+
+interface BoardTaskCallback {
+    token: string;
+    via: ExecutionRef;
+}
+interface BoardCallbackTransport {
+    createCallback(token: string): BoardTaskCallback;
+}
+declare function createHttpBoardCallbackTransport(baseUrl: string): BoardCallbackTransport;
+declare function createInProcessBoardCallbackTransport(handlerKey: string): BoardCallbackTransport;
+declare function createLocalNodeBoardCallbackTransport(opts?: string | {
+    notifyChannel?: string;
+    boardRuntimeStoreRef?: string;
+    queueStoreRef?: string;
+}): BoardCallbackTransport;
+
+export { type BoardCallbackTransport as B, type ChatStorage as C, type ChatRecord as a, type ChatReadAfterResult as b, type ChatConfig as c, createChatStorage as d, createHttpBoardCallbackTransport as e, createInMemoryChatStorage as f, createInProcessBoardCallbackTransport as g, createLocalNodeBoardCallbackTransport as h };

package/lib/board-callback-transport-kP0K6UMq.d.cts

@@ -0,0 +1,71 @@
+import { h as JournalStorage, K as KVStorage } from './storage-interface-DogVPooM.cjs';
+import { ExecutionRef } from './execution-refs.cjs';
+
+/**
+ * chat-storage-lib.ts
+ *
+ * ChatStorage interface + factories backed by JournalStorage (history) and
+ * KVStorage (processing state and config).
+ *
+ * Platform-free — no node:fs or node:crypto imports.
+ */
+
+type Awaitable<T> = T | Promise<T>;
+interface ChatRecord {
+    /** Journal entry id — also used as SSE cursor. */
+    id: string;
+    role: string;
+    text: string;
+    files: unknown[];
+    turn: string;
+    updated_at: string;
+}
+interface ChatConfig {
+    systemPrompt?: string;
+}
+interface ChatReadAfterResult {
+    records: ChatRecord[];
+    /** Pass as cursor on the next call. Null when the journal is empty. */
+    cursor: string | null;
+}
+interface ChatStorage {
+    /** Append a message; returns the new entry id (usable as a cursor). */
+    append(cardId: string, role: string, text: string, files?: unknown[], turn?: string): Awaitable<string>;
+    /** Read all messages in insertion order. */
+    readAll(cardId: string): Awaitable<ChatRecord[]>;
+    /**
+     * Read messages appended after cursor.
+     * Pass null to read from the beginning.
+     */
+    readAfter(cardId: string, cursor: string | null): Awaitable<ChatReadAfterResult>;
+    /** Remove all messages for this card. */
+    clear(cardId: string): Awaitable<void>;
+    setProcessing(cardId: string, active: boolean): Awaitable<void>;
+    isProcessing(cardId: string): Awaitable<boolean>;
+    getConfig(cardId: string): Awaitable<ChatConfig>;
+    setConfig(cardId: string, patch: Partial<ChatConfig>): Awaitable<void>;
+}
+/**
+ * Create a ChatStorage backed by:
+ *  - journalFactory(cardId) → JournalStorage  (one per-card journal for history)
+ *  - kv                     → KVStorage       (shared processing flags + config)
+ */
+declare function createChatStorage(journalFactory: (cardId: string) => JournalStorage, kv: KVStorage): ChatStorage;
+declare function createInMemoryChatStorage(): ChatStorage;
+
+interface BoardTaskCallback {
+    token: string;
+    via: ExecutionRef;
+}
+interface BoardCallbackTransport {
+    createCallback(token: string): BoardTaskCallback;
+}
+declare function createHttpBoardCallbackTransport(baseUrl: string): BoardCallbackTransport;
+declare function createInProcessBoardCallbackTransport(handlerKey: string): BoardCallbackTransport;
+declare function createLocalNodeBoardCallbackTransport(opts?: string | {
+    notifyChannel?: string;
+    boardRuntimeStoreRef?: string;
+    queueStoreRef?: string;
+}): BoardCallbackTransport;
+
+export { type BoardCallbackTransport as B, type ChatStorage as C, type ChatRecord as a, type ChatReadAfterResult as b, type ChatConfig as c, createChatStorage as d, createHttpBoardCallbackTransport as e, createInMemoryChatStorage as f, createInProcessBoardCallbackTransport as g, createLocalNodeBoardCallbackTransport as h };

package/lib/board-live-cards-lib-DVh3t9NT.d.cts

@@ -0,0 +1,222 @@
+import { f as GraphEvent, G as GraphConfig } from './types-BBhqYGhE.cjs';
+import { c as QueueMessage } from './storage-interface-DogVPooM.cjs';
+
+/**
+ * notification-interface.ts
+ *
+ * Neutral shared notification contracts used by board/public/runtime layers.
+ * This file defines shapes only. It does not own routing, transport, or
+ * persistence semantics.
+ */
+
+type NotificationCategory = 'board-output' | 'card-store' | 'chat-store' | 'hosted-runtime' | 'queue-storage' | 'batch';
+interface NotificationChatMessage {
+    role: string;
+    text: string;
+    files?: unknown[];
+    turn?: string;
+}
+type BoardOutputNotification = {
+    category?: 'board-output';
+    kind: 'computed_values';
+    cardId: string;
+    values: Record<string, unknown>;
+} | {
+    category?: 'board-output';
+    kind: 'data_object';
+    key: string;
+    payload: unknown;
+} | {
+    category?: 'board-output';
+    kind: 'status';
+    status: unknown;
+};
+type CardStoreNotification = {
+    category?: 'card-store';
+    kind: 'card_refreshed';
+    cardId: string;
+    card: LiveCard;
+} | {
+    category?: 'card-store';
+    kind: 'card_removed';
+    cardId: string;
+};
+type ChatStoreNotification = {
+    category?: 'chat-store';
+    kind: 'card_chats';
+    cardId: string;
+    sentAt?: string;
+    sentAtMs?: number;
+    messages: NotificationChatMessage[];
+    receiving: boolean;
+    processing?: boolean;
+} | {
+    category?: 'chat-store';
+    kind: 'chat_messages';
+    cardId: string;
+    messages: NotificationChatMessage[];
+};
+type HostedRuntimeNotification = {
+    category?: 'hosted-runtime';
+    kind: 'chat_processing';
+    cardId: string;
+    active: boolean;
+    sentAtMs?: number;
+} | {
+    category?: 'hosted-runtime';
+    kind: 'card_watchparty';
+    cardId: string;
+    channel: string;
+    payload: unknown;
+    clear?: boolean;
+    replace?: boolean;
+    sentAtMs?: number;
+};
+type QueueStorageNotification = {
+    category?: 'queue-storage';
+    kind: 'message_enqueued';
+    lane?: string;
+    message: QueueMessage<unknown>;
+};
+type BoardChangeNotification = BoardOutputNotification | CardStoreNotification;
+type RuntimeNotification = BoardOutputNotification | CardStoreNotification | ChatStoreNotification | HostedRuntimeNotification | QueueStorageNotification;
+type RuntimeNotificationBatch = {
+    category?: 'batch';
+    kind: 'notification-batch';
+    notifications: RuntimeNotification[];
+};
+type NotificationEmitter = (notification: RuntimeNotification | RuntimeNotificationBatch) => void | Promise<void>;
+declare function isRuntimeNotificationBatch(value: unknown): value is RuntimeNotificationBatch;
+declare function isBoardChangeNotification(notification: RuntimeNotification): notification is BoardChangeNotification;
+declare function isChatScopedRuntimeNotification(notification: RuntimeNotification): notification is ChatStoreNotification | HostedRuntimeNotification;
+declare function notificationCategoryForKind(kind: RuntimeNotification['kind']): Exclude<NotificationCategory, 'batch'>;
+declare function withRuntimeNotificationCategories<T extends RuntimeNotification[]>(notifications: T): T;
+declare function withRuntimeNotificationBatchCategories(batch: RuntimeNotificationBatch): RuntimeNotificationBatch;
+
+/**
+ * board-live-cards-lib — Pure logic library for the board-live-cards CLI.
+ *
+ * Merged from:
+ *   board-live-cards-all-stores.ts
+ *   board-live-cards-lib-types.ts
+ *   board-live-cards-lib-board-status.ts
+ *   board-live-cards-lib-card-handler.ts
+ *   board-live-cards-cli-board-commands.ts
+ *   board-live-cards-cli-card-commands.ts
+ *   board-live-cards-cli-callbacks.ts
+ *
+ * Zero platform imports. All storage is injected via adapter interfaces.
+ * Safe for Node, browser, and neutral (V8/PyMiniRacer) bundles.
+ */
+
+interface LiveCard {
+    id: string;
+    [key: string]: unknown;
+}
+interface CardIndexEntry {
+    /** Storage-specific address (file path, Cosmos doc id, localStorage key). */
+    key: string;
+    /** Checksum of card content — computed by the adapter at write time. */
+    checksum: string;
+    updatedAt: string;
+}
+type CardIndex = Record<string, CardIndexEntry>;
+type CardChecksumIndex = Record<string, string>;
+interface CardStorageAdapter {
+    readIndex(): CardIndex | null;
+    writeIndex(index: CardIndex): void;
+    readCard(key: string): LiveCard | null;
+    /** Write card content; returns checksum of what was written. */
+    writeCard(key: string, card: LiveCard): string;
+    removeCard(key: string): void;
+    cardExists(key: string): boolean;
+    defaultCardKey(cardId: string): string;
+}
+interface CardStore {
+    readCard(id: string): LiveCard | null;
+    readCardKey(id: string): string | null;
+    readAllCards(): LiveCard[];
+    readChecksumIndex(): CardChecksumIndex;
+    changedSince(snapshotChecksumIndex: CardChecksumIndex): string[];
+}
+interface CardUpsertValidation {
+    ok: boolean;
+    error?: string;
+}
+interface CardAdminStore extends CardStore {
+    validateUpsert(id: string, cardKey: string): CardUpsertValidation;
+    writeCard(id: string, card: LiveCard, cardKey?: string): void;
+    patchCard(id: string, jsonPath: string, value: unknown): void;
+    removeCard(id: string): void;
+    readIndex(): CardIndex;
+}
+declare function createCardStore(adapter: CardStorageAdapter, onWarn?: (msg: string) => void): CardAdminStore;
+interface JournalEntry {
+    id: string;
+    event: GraphEvent;
+}
+interface JournalStorageAdapter {
+    readAllEntries(): JournalEntry[];
+    appendEntry(entry: JournalEntry): void;
+    generateId(): string;
+}
+declare const SNAPSHOT_SCHEMA_VERSION_V1 = "v1";
+declare const BOARD_GRAPH_KEY = "board/graph";
+interface StateSnapshotReadView {
+    version: string | null;
+    values: Record<string, unknown>;
+}
+interface BoardStatusCard {
+    name: string;
+    status: string;
+    error?: {
+        message: string;
+        code?: string;
+        at?: string;
+        source?: 'task-runtime' | 'source-fetch' | 'timeout' | 'unknown';
+    };
+    requires: string[];
+    requires_satisfied: string[];
+    requires_missing: string[];
+    provides_declared: string[];
+    provides_runtime: string[];
+    blocked_by: string[];
+    unblocks: string[];
+    runtime: {
+        attempt_count: number;
+        restart_count: number;
+        in_progress_since: string | null;
+        last_transition_at: string | null;
+        last_completed_at: string | null;
+        last_restarted_at: string | null;
+        status_age_ms: number | null;
+    };
+}
+interface BoardStatusObject {
+    schema_version: 'v1';
+    meta: {
+        board: {
+            path: string;
+        };
+    };
+    summary: {
+        card_count: number;
+        completed: number;
+        eligible: number;
+        pending: number;
+        blocked: number;
+        unresolved: number;
+        failed?: number;
+        in_progress?: number;
+        orphan_cards?: number;
+        topology?: {
+            edge_count: number;
+            max_fan_out_card: string | null;
+            max_fan_out: number;
+        };
+    };
+    cards: BoardStatusCard[];
+}
+declare const EMPTY_CONFIG: GraphConfig;
+
+export { type BoardChangeNotification as B, type CardStoreNotification as C, EMPTY_CONFIG as E, type HostedRuntimeNotification as H, type JournalStorageAdapter as J, type LiveCard as L, type NotificationCategory as N, type RuntimeNotification as R, SNAPSHOT_SCHEMA_VERSION_V1 as S, type BoardOutputNotification as a, type ChatStoreNotification as b, type NotificationChatMessage as c, type RuntimeNotificationBatch as d, isChatScopedRuntimeNotification as e, isRuntimeNotificationBatch as f, withRuntimeNotificationCategories as g, type NotificationEmitter as h, isBoardChangeNotification as i, type CardAdminStore as j, type BoardStatusObject as k, BOARD_GRAPH_KEY as l, type CardChecksumIndex as m, notificationCategoryForKind as n, type CardUpsertValidation as o, type CardIndex as p, type StateSnapshotReadView as q, createCardStore as r, withRuntimeNotificationBatchCategories as w };