yaml-flow 8.8.7 → 8.9.0

package/lib/server-runtime-core/index.d.ts

@@ -1,20 +1,22 @@
-import { d as BoardRuntimePlatformAdapter } from '../types-BsfXZyI3.js';
-export { A as Awaitable, B as BoardContextConfig, c as BoardRuntimeNonCorePublic, e as BoardRuntimePublic, f as BoardWorkerRequest, C as ChatHandlerFlowRunner, D as DescribeEnvelope, H as HostedBoardQueueLaneTuning, I as InvocationAdapter, a as MultiBoardRuntime, M as MultiBoardRuntimeOptions, N as NotificationTransport, Q as QueueLaneRuntimeTuning, R as RuntimeLogger, g as RuntimeRequest, h as RuntimeResponse, b as SingleBoardRuntime, S as SingleBoardRuntimeOptions } from '../types-BsfXZyI3.js';
+import { d as BoardRuntimePlatformAdapter } from '../types-BsqzUZNl.js';
+export { A as Awaitable, B as BoardContextConfig, c as BoardRuntimeNonCorePublic, e as BoardRuntimePublic, f as BoardWorkerRequest, C as ChatHandlerFlowRunner, D as DescribeEnvelope, H as HostedBoardQueueLaneTuning, I as InvocationAdapter, a as MultiBoardRuntime, M as MultiBoardRuntimeOptions, N as NotificationTransport, Q as QueueLaneRuntimeTuning, R as RuntimeLogger, g as RuntimeRequest, h as RuntimeResponse, b as SingleBoardRuntime, S as SingleBoardRuntimeOptions } from '../types-BsqzUZNl.js';
 export { HostedBoardQueueLaneRegistryOptions, createHostedBoardQueueLaneRegistry } from '../server-jobs-queue-runner/index.js';
 export { M as McpControlplaneRegistryDeps, a as McpFacadeForRegistry, b as McpWebhookFacadeForRegistry, T as ToolRegistry, c as createMcpControlplaneToolRegistry, d as createMcpToolRegistry, e as createMcpWebhookToolRegistry } from '../mcp-tool-registries-D3rWSppt.js';
 import { createBoardLiveCardsMcp, BoardLiveCardsMcpBoardDeps, BoardLiveCardsMcpNonCoreDeps, BoardLiveCardsMcpCardStoreDeps, BoardLiveCardsMcp } from '../board-live-cards-mcp.js';
-import { a as CommandResult } from '../board-live-cards-public-DSRamFm8.js';
-export { B as BoardChangeNotification, c as BoardLiveCardsPublic, d as BoardNonCorePlatformAdapter, e as BoardPlatformAdapter, f as ChatStorage, C as CommandInput } from '../board-live-cards-public-DSRamFm8.js';
-import { S as SseHub } from '../sse-hub-DM8bw-dO.js';
-import { C as CardFileMetadataStore } from '../artifacts-store-lib-D4qf7Q-7.js';
-import { A as AsyncBoardPlatformAdapter } from '../board-platform-adapter-async-JP9V-U5E.js';
+import { CommandResult, BoardSseOneShotPayload } from '../board-live-cards-public.js';
+export { BoardLiveCardsPublic, BoardNonCorePlatformAdapter, BoardPlatformAdapter, CommandInput } from '../board-live-cards-public.js';
+import { S as SseHub } from '../sse-hub-D_94fV87.js';
+import { C as CardFileMetadataStore } from '../artifacts-store-lib-D6Bo4yFN.js';
+import { A as AsyncBoardPlatformAdapter } from '../board-platform-adapter-async-ByBRFn1G.js';
 import { ExecutionRef } from '../execution-refs.js';
-export { A as AsyncBoardLiveCardsPublic } from '../board-live-cards-public-async-DlyC3PgC.js';
-export { B as BlobStorage, K as KVStorage, a as KindValueRef } from '../storage-interface-D-iEiTJA.js';
+export { A as AsyncBoardLiveCardsPublic } from '../board-live-cards-public-async-U98IXUBx.js';
+export { B as BlobStorage, K as KVStorage, a as KindValueRef } from '../storage-interface-DogVPooM.js';
+export { B as BoardChangeNotification } from '../board-live-cards-lib-iU8xOwNp.js';
+export { C as ChatStorage } from '../board-callback-transport-Bekq8Gp-.js';
 import '../queue-lane-registry-PaZuFpwp.js';
 import '../chat-store-public.js';
 import '../types-BBhqYGhE.js';
-import '../storage-async-interface-CG0bMqvE.js';
+import '../storage-async-interface-Cb-SULrI.js';
 
 /**
  * server-runtime/notifications.ts
@@ -98,11 +100,6 @@ interface McpFacadeBoardContextLike {
                 id: string;
             };
         }) => Promise<CommandResult>;
-        cardRefreshedNotify: (input: {
-            params: {
-                cardId: string;
-            };
-        }) => Promise<CommandResult>;
         upsertCard: (input: {
             params: {
                 cardId: string;
@@ -184,43 +181,25 @@ declare function createMcpFacadeModule(deps: McpFacadeDeps): McpFacadeModule;
  * index.ts.
  */
 
-/** Minimum surface of the kv-storage handle used to read persisted status. */
-interface KvStorageReader {
-    read(key: string): unknown | Promise<unknown>;
-}
-/** Minimum surface of the board-platform adapter consumed by readStatusSnapshot. */
-interface BoardAdapterForPayload {
-    kvStorageForRef(ref: string): KvStorageReader;
-}
 /** Minimum surface of the board-ops handle consumed by payload readers. */
 interface BoardOpsForPayload {
-    getAllOutputsComputedValues(input: Record<string, unknown>): {
-        status: string;
-        data?: unknown;
-    } | Promise<{
-        status: string;
-        data?: unknown;
-    }>;
-    getAllOutputsDataObjects(input: Record<string, unknown>): {
+    buildSseOneShotPayload(input: Record<string, unknown>): {
         status: string;
-        data?: unknown;
+        data?: BoardSseOneShotPayload;
     } | Promise<{
         status: string;
-        data?: unknown;
+        data?: BoardSseOneShotPayload;
     }>;
 }
 /** Subset of BoardContext consumed by runtime-payload readers. */
 interface RuntimePayloadBoardContext {
     boardOps: BoardOpsForPayload;
-    boardAdapter: BoardAdapterForPayload;
-    outputsStoreRef: string;
     notification: NotificationState;
 }
 interface RuntimePayloadDeps {
     boardId: string;
     /** Live reference to the runtime's board-contexts array (read on each call). */
     boardContexts: ReadonlyArray<RuntimePayloadBoardContext>;
-    readCardDefinitions: () => Promise<Array<Record<string, unknown>>>;
     readChatRecords: (cardId: string) => Promise<Array<Record<string, unknown>>>;
     getChatProcessing: (cardId: string) => Promise<boolean>;
 }
@@ -248,7 +227,7 @@ declare function createRuntimePayloadModule(deps: RuntimePayloadDeps): RuntimePa
 interface ControlplaneToolHandlersDeps {
     boardId: string;
     bootstrapBoard: () => Promise<void>;
-    sseHub: Pick<SseHub, 'has' | 'subscribeChat' | 'unsubscribeChat'>;
+    sseHub: Pick<SseHub, 'has' | 'subscribeChat' | 'unsubscribeChat' | 'subscribeChannel' | 'unsubscribeChannel'>;
     onChannelSubscribed?: (clientId: string, channelName: string, params: {
         cardId?: string;
     }) => void;

package/lib/server-runtime-core/index.js

@@ -1,2 +1,2 @@
-export{c as appendNotification,j as createCardFileOps,h as createControlplaneToolHandlers,m as createMcpControlplaneToolRegistry,n as createMcpFacadeModule,k as createMcpToolRegistry,l as createMcpWebhookToolRegistry,i as createRuntimePayloadModule,d as expectControlplaneSuccess,e as expectControlplaneSuccessAsync,f as getCardMetaKey,b as hasNonEmptyCardCountStatus,a as makeNotificationState,g as readCardMetaValue}from'../chunk-3MMTBEAO.js';export{b as getMcpArgNumber,c as getMcpArgRecord,a as getMcpArgString,e as getRequiredMcpArgNumber,d as getRequiredMcpArgRecord,f as parseMcpUploadBytes}from'../chunk-O7NOHKVR.js';export{b as extractMcpFailureMessage,a as invokeMcpTool}from'../chunk-ZJ5M5COT.js';export{a as createHostedBoardQueueLaneRegistry}from'../chunk-6OPXQPSC.js';export{d as concatUint8Arrays,c as escapeRegExp,b as executionWhatToRunValue,a as isAsyncBoardPlatformAdapter}from'../chunk-FOFGEABN.js';import'../chunk-RKKSVOP2.js';import'../chunk-NNSBBO5R.js';import'../chunk-ANKA7HEJ.js';import'../chunk-44L64VQ2.js';import'../chunk-35N7ONTH.js';import'../chunk-JMDHDY6M.js';import'../chunk-3KC6LBOG.js';import'../chunk-MNEOJWPS.js';import'../chunk-FW4363Y4.js';//# sourceMappingURL=index.js.map
+export{e as appendNotification,l as createCardFileOps,j as createControlplaneToolHandlers,o as createMcpControlplaneToolRegistry,p as createMcpFacadeModule,m as createMcpToolRegistry,n as createMcpWebhookToolRegistry,k as createRuntimePayloadModule,f as expectControlplaneSuccess,g as expectControlplaneSuccessAsync,h as getCardMetaKey,d as hasNonEmptyCardCountStatus,c as makeNotificationState,i as readCardMetaValue}from'../chunk-R4YASXSJ.js';export{a as createHostedBoardQueueLaneRegistry}from'../chunk-7UJQMFVS.js';export{d as concatUint8Arrays,c as escapeRegExp,b as executionWhatToRunValue,a as isAsyncBoardPlatformAdapter}from'../chunk-FOFGEABN.js';import'../chunk-RKKSVOP2.js';export{b as getMcpArgNumber,c as getMcpArgRecord,a as getMcpArgString,e as getRequiredMcpArgNumber,d as getRequiredMcpArgRecord,f as parseMcpUploadBytes}from'../chunk-O7NOHKVR.js';export{b as extractMcpFailureMessage,a as invokeMcpTool}from'../chunk-ZJ5M5COT.js';import'../chunk-6MD6FVE3.js';import'../chunk-ANKA7HEJ.js';import'../chunk-44L64VQ2.js';import'../chunk-VBYNMTWC.js';import'../chunk-JMDHDY6M.js';import'../chunk-3KC6LBOG.js';import'../chunk-MNEOJWPS.js';import'../chunk-FW4363Y4.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/lib/server-runtime-watchers/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkH22NK6KH_cjs=require('../chunk-H22NK6KH.cjs');require('../chunk-BQUQTOPB.cjs'),require('../chunk-VQCIOKJV.cjs'),require('../chunk-GNFE24S7.cjs');Object.defineProperty(exports,"createRoutesWatchers",{enumerable:true,get:function(){return chunkH22NK6KH_cjs.b}});Object.defineProperty(exports,"createSseHub",{enumerable:true,get:function(){return chunkH22NK6KH_cjs.a}});//# sourceMappingURL=index.cjs.map
+'use strict';var chunkLFVMX23W_cjs=require('../chunk-LFVMX23W.cjs');require('../chunk-BQUQTOPB.cjs'),require('../chunk-VQCIOKJV.cjs'),require('../chunk-2RIHC5TZ.cjs'),require('../chunk-GNFE24S7.cjs');Object.defineProperty(exports,"createRoutesWatchers",{enumerable:true,get:function(){return chunkLFVMX23W_cjs.b}});Object.defineProperty(exports,"createSseHub",{enumerable:true,get:function(){return chunkLFVMX23W_cjs.a}});//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/lib/server-runtime-watchers/index.d.cts

@@ -1,13 +1,15 @@
-import { h as RuntimeResponse, g as RuntimeRequest } from '../types-CPnYv7RC.cjs';
-import { S as SseHub } from '../sse-hub-BDjWI7JR.cjs';
-export { a as SseHubDeps, c as createSseHub } from '../sse-hub-BDjWI7JR.cjs';
-import '../board-live-cards-public-BT5HrgqZ.cjs';
-import '../storage-interface-D-iEiTJA.cjs';
+import { h as RuntimeResponse, g as RuntimeRequest } from '../types-DxhB6Toz.cjs';
+import { S as SseHub } from '../sse-hub-BRBvymHR.cjs';
+export { a as SseHubDeps, c as createSseHub } from '../sse-hub-BRBvymHR.cjs';
+import '../board-live-cards-public.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';
-import '../board-platform-adapter-async-BZIftm36.cjs';
-import '../storage-async-interface-CyO-zwVQ.cjs';
-import '../board-live-cards-public-async-CYjr4mgX.cjs';
+import '../board-platform-adapter-async-DjBwE0m9.cjs';
+import '../storage-async-interface-CLOXiqwC.cjs';
+import '../board-live-cards-public-async-Cl0M3j5P.cjs';
 
 /**
  * server-runtime/routes-sse.ts
@@ -48,6 +50,7 @@ interface RoutesSseDeps {
  */
 
 interface RoutesWatchersDeps extends RoutesSseDeps {
+    queueSseHub: SseHub;
     apiBasePath: string;
     readJsonBody: (req: RuntimeRequest) => Promise<Record<string, unknown>>;
     initBoardAndSetup: () => Promise<void>;

package/lib/server-runtime-watchers/index.d.ts

@@ -1,13 +1,15 @@
-import { h as RuntimeResponse, g as RuntimeRequest } from '../types-BsfXZyI3.js';
-import { S as SseHub } from '../sse-hub-DM8bw-dO.js';
-export { a as SseHubDeps, c as createSseHub } from '../sse-hub-DM8bw-dO.js';
-import '../board-live-cards-public-DSRamFm8.js';
-import '../storage-interface-D-iEiTJA.js';
+import { h as RuntimeResponse, g as RuntimeRequest } from '../types-BsqzUZNl.js';
+import { S as SseHub } from '../sse-hub-D_94fV87.js';
+export { a as SseHubDeps, c as createSseHub } from '../sse-hub-D_94fV87.js';
+import '../board-live-cards-public.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';
-import '../board-platform-adapter-async-JP9V-U5E.js';
-import '../storage-async-interface-CG0bMqvE.js';
-import '../board-live-cards-public-async-DlyC3PgC.js';
+import '../board-platform-adapter-async-ByBRFn1G.js';
+import '../storage-async-interface-Cb-SULrI.js';
+import '../board-live-cards-public-async-U98IXUBx.js';
 
 /**
  * server-runtime/routes-sse.ts
@@ -48,6 +50,7 @@ interface RoutesSseDeps {
  */
 
 interface RoutesWatchersDeps extends RoutesSseDeps {
+    queueSseHub: SseHub;
     apiBasePath: string;
     readJsonBody: (req: RuntimeRequest) => Promise<Record<string, unknown>>;
     initBoardAndSetup: () => Promise<void>;

package/lib/server-runtime-watchers/index.js

@@ -1,2 +1,2 @@
-export{b as createRoutesWatchers,a as createSseHub}from'../chunk-ABAVFLDP.js';import'../chunk-FOFGEABN.js';import'../chunk-44L64VQ2.js';import'../chunk-FW4363Y4.js';//# sourceMappingURL=index.js.map
+export{b as createRoutesWatchers,a as createSseHub}from'../chunk-JB4Q2W7I.js';import'../chunk-FOFGEABN.js';import'../chunk-44L64VQ2.js';import'../chunk-UGB7PC4P.js';import'../chunk-FW4363Y4.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/lib/server-runtime-webhooks/index.d.cts

@@ -1,12 +1,14 @@
-import { g as RuntimeRequest, h as RuntimeResponse } from '../types-CPnYv7RC.cjs';
+import { g as RuntimeRequest, h as RuntimeResponse } from '../types-DxhB6Toz.cjs';
 import { T as ToolRegistry } from '../mcp-tool-registries-CRtea2x4.cjs';
-import '../board-live-cards-public-BT5HrgqZ.cjs';
-import '../storage-interface-D-iEiTJA.cjs';
+import '../board-live-cards-public.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';
-import '../board-platform-adapter-async-BZIftm36.cjs';
-import '../storage-async-interface-CyO-zwVQ.cjs';
-import '../board-live-cards-public-async-CYjr4mgX.cjs';
+import '../board-platform-adapter-async-DjBwE0m9.cjs';
+import '../storage-async-interface-CLOXiqwC.cjs';
+import '../board-live-cards-public-async-Cl0M3j5P.cjs';
 import '../board-live-cards-mcp.cjs';
 import '../chat-store-public.cjs';
 

package/lib/server-runtime-webhooks/index.d.ts

@@ -1,12 +1,14 @@
-import { g as RuntimeRequest, h as RuntimeResponse } from '../types-BsfXZyI3.js';
+import { g as RuntimeRequest, h as RuntimeResponse } from '../types-BsqzUZNl.js';
 import { T as ToolRegistry } from '../mcp-tool-registries-D3rWSppt.js';
-import '../board-live-cards-public-DSRamFm8.js';
-import '../storage-interface-D-iEiTJA.js';
+import '../board-live-cards-public.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';
-import '../board-platform-adapter-async-JP9V-U5E.js';
-import '../storage-async-interface-CG0bMqvE.js';
-import '../board-live-cards-public-async-DlyC3PgC.js';
+import '../board-platform-adapter-async-ByBRFn1G.js';
+import '../storage-async-interface-Cb-SULrI.js';
+import '../board-live-cards-public-async-U98IXUBx.js';
 import '../board-live-cards-mcp.js';
 import '../chat-store-public.js';
 

package/lib/{sse-hub-DM8bw-dO.d.ts → sse-hub-BRBvymHR.d.cts}

@@ -1,4 +1,6 @@
-import { h as RuntimeResponse } from './types-BsfXZyI3.js';
+import { h as RuntimeResponse } from './types-DxhB6Toz.cjs';
+import { R as RuntimeNotification, d as RuntimeNotificationBatch } from './board-live-cards-lib-DVh3t9NT.cjs';
+import { CommandResult } from './board-live-cards-public.cjs';
 
 /**
  * server-runtime/sse-hub.ts
@@ -11,17 +13,17 @@ import { h as RuntimeResponse } from './types-BsfXZyI3.js';
  * State owned here:
  *   - sseClients (clientId -> { res, subscribedChatCardIds })
  *   - sseEventId monotonic counter
- *   - chat-subscription scan timer + per-card cursor/processing snapshots
  *
  * Dependencies passed in by the runtime:
- *   - chatStorage for tailing chat history
- *   - readChatRecords for building chat-scoped notifications
+ *   - chat-store one-shot builder for subscription hydration
  *   - optional host hooks (onSseClientDisconnected, etc.)
  */
 
 interface SseClientState {
     res: RuntimeResponse;
     subscribedChatCardIds: Set<string>;
+    subscribedChannelNames: Set<string>;
+    subscribedCardChannels: Map<string, Set<string>>;
 }
 interface SseHub {
     /** Number of currently-registered SSE clients. */
@@ -35,27 +37,28 @@ interface SseHub {
     /** Best-effort transport-level flush for the underlying response object. */
     flushTransport(res: RuntimeResponse): void;
     /** Register a fresh client. Any prior registration with the same id is disconnected first. */
-    register(clientId: string, res: RuntimeResponse, subscribedChatCardIds?: Set<string>): void;
+    register(clientId: string, res: RuntimeResponse, state?: {
+        subscribedChatCardIds?: Set<string>;
+        subscribedChannelNames?: Set<string>;
+        subscribedCardChannels?: Map<string, Set<string>>;
+    }): void;
     /** Drop a registered client. If expectedRes is supplied and does not match, no-op. */
     disconnect(clientId: string, expectedRes?: RuntimeResponse): void;
     /** Write an SSE frame to one client; transport errors disconnect that client. */
     writeFrame(clientId: string, payload: unknown): void;
-    /** Subscribe a client to a card's chat stream and prime its cursor. */
+    /** Subscribe a client to a card's chat stream and send one-shot hydration. */
     subscribeChat(clientId: string, cardId: string): Promise<boolean>;
     /** Unsubscribe a client from a card's chat stream. */
     unsubscribeChat(clientId: string, cardId: string): boolean;
+    /** Subscribe a client to a named board or card-scoped channel. */
+    subscribeChannel(clientId: string, channelName: string, cardId?: string): boolean;
+    /** Unsubscribe a client from a named board or card-scoped channel. */
+    unsubscribeChannel(clientId: string, channelName: string, cardId?: string): boolean;
     /** Broadcast a notification batch; chat-scoped notes are routed to chat-subscribed clients. */
-    broadcastNotificationBatch(notifications: unknown[]): void;
-    /** Push a fresh card-chats notification to every chat-subscribed client. */
-    broadcastCardChats(cardId: string, receiving?: boolean): Promise<void>;
+    broadcastNotificationBatch(notifications: RuntimeNotification[]): void;
 }
 interface SseHubDeps {
-    readChatRecords: (cardId: string) => Promise<Array<Record<string, unknown>>>;
-    readChatAfter: (cardId: string, cursor: string | null) => Promise<{
-        records: Array<Record<string, unknown>>;
-        cursor: string | null;
-    }>;
-    getChatProcessing: (cardId: string) => Promise<boolean>;
+    buildChatOneShotBatch: (cardId: string, receiving: boolean) => Promise<CommandResult<RuntimeNotificationBatch>>;
     onSseClientDisconnected?: (clientId: string) => void;
 }
 declare function createSseHub(deps: SseHubDeps): SseHub;

package/lib/{sse-hub-BDjWI7JR.d.cts → sse-hub-D_94fV87.d.ts}

@@ -1,4 +1,6 @@
-import { h as RuntimeResponse } from './types-CPnYv7RC.cjs';
+import { h as RuntimeResponse } from './types-BsqzUZNl.js';
+import { R as RuntimeNotification, d as RuntimeNotificationBatch } from './board-live-cards-lib-iU8xOwNp.js';
+import { CommandResult } from './board-live-cards-public.js';
 
 /**
  * server-runtime/sse-hub.ts
@@ -11,17 +13,17 @@ import { h as RuntimeResponse } from './types-CPnYv7RC.cjs';
  * State owned here:
  *   - sseClients (clientId -> { res, subscribedChatCardIds })
  *   - sseEventId monotonic counter
- *   - chat-subscription scan timer + per-card cursor/processing snapshots
  *
  * Dependencies passed in by the runtime:
- *   - chatStorage for tailing chat history
- *   - readChatRecords for building chat-scoped notifications
+ *   - chat-store one-shot builder for subscription hydration
  *   - optional host hooks (onSseClientDisconnected, etc.)
  */
 
 interface SseClientState {
     res: RuntimeResponse;
     subscribedChatCardIds: Set<string>;
+    subscribedChannelNames: Set<string>;
+    subscribedCardChannels: Map<string, Set<string>>;
 }
 interface SseHub {
     /** Number of currently-registered SSE clients. */
@@ -35,27 +37,28 @@ interface SseHub {
     /** Best-effort transport-level flush for the underlying response object. */
     flushTransport(res: RuntimeResponse): void;
     /** Register a fresh client. Any prior registration with the same id is disconnected first. */
-    register(clientId: string, res: RuntimeResponse, subscribedChatCardIds?: Set<string>): void;
+    register(clientId: string, res: RuntimeResponse, state?: {
+        subscribedChatCardIds?: Set<string>;
+        subscribedChannelNames?: Set<string>;
+        subscribedCardChannels?: Map<string, Set<string>>;
+    }): void;
     /** Drop a registered client. If expectedRes is supplied and does not match, no-op. */
     disconnect(clientId: string, expectedRes?: RuntimeResponse): void;
     /** Write an SSE frame to one client; transport errors disconnect that client. */
     writeFrame(clientId: string, payload: unknown): void;
-    /** Subscribe a client to a card's chat stream and prime its cursor. */
+    /** Subscribe a client to a card's chat stream and send one-shot hydration. */
     subscribeChat(clientId: string, cardId: string): Promise<boolean>;
     /** Unsubscribe a client from a card's chat stream. */
     unsubscribeChat(clientId: string, cardId: string): boolean;
+    /** Subscribe a client to a named board or card-scoped channel. */
+    subscribeChannel(clientId: string, channelName: string, cardId?: string): boolean;
+    /** Unsubscribe a client from a named board or card-scoped channel. */
+    unsubscribeChannel(clientId: string, channelName: string, cardId?: string): boolean;
     /** Broadcast a notification batch; chat-scoped notes are routed to chat-subscribed clients. */
-    broadcastNotificationBatch(notifications: unknown[]): void;
-    /** Push a fresh card-chats notification to every chat-subscribed client. */
-    broadcastCardChats(cardId: string, receiving?: boolean): Promise<void>;
+    broadcastNotificationBatch(notifications: RuntimeNotification[]): void;
 }
 interface SseHubDeps {
-    readChatRecords: (cardId: string) => Promise<Array<Record<string, unknown>>>;
-    readChatAfter: (cardId: string, cursor: string | null) => Promise<{
-        records: Array<Record<string, unknown>>;
-        cursor: string | null;
-    }>;
-    getChatProcessing: (cardId: string) => Promise<boolean>;
+    buildChatOneShotBatch: (cardId: string, receiving: boolean) => Promise<CommandResult<RuntimeNotificationBatch>>;
     onSseClientDisconnected?: (clientId: string) => void;
 }
 declare function createSseHub(deps: SseHubDeps): SseHub;

package/lib/step-machine-public/index.d.cts

@@ -3,7 +3,7 @@ import { l as StepMachineStore } from '../types-DjlwALZC.cjs';
 export { MemoryStore } from '../stores/memory.cjs';
 export { KVStorageStore } from '../stores/kv.cjs';
 import { ExecutionRef } from '../execution-refs.cjs';
-import '../storage-interface-D-iEiTJA.cjs';
+import '../storage-interface-DogVPooM.cjs';
 
 /**
  * The single normalized shape the engine consumes.

package/lib/step-machine-public/index.d.ts

@@ -3,7 +3,7 @@ import { l as StepMachineStore } from '../types-DjlwALZC.js';
 export { MemoryStore } from '../stores/memory.js';
 export { KVStorageStore } from '../stores/kv.js';
 import { ExecutionRef } from '../execution-refs.js';
-import '../storage-interface-D-iEiTJA.js';
+import '../storage-interface-DogVPooM.js';
 
 /**
  * The single normalized shape the engine consumes.

package/lib/{storage-async-interface-CyO-zwVQ.d.cts → storage-async-interface-CLOXiqwC.d.cts}

@@ -1,4 +1,4 @@
-import { b as BlobStat, a as KindValueRef, Q as QueueMessage, c as QueueLeasedMessage, d as QueueDeadLetterMessage, J as JournalEntry, e as JournalReadResult } from './storage-interface-D-iEiTJA.cjs';
+import { b as BlobStat, a as KindValueRef, c as QueueMessage, d as QueueLeasedMessage, e as QueueDeadLetterMessage, J as JournalEntry, f as JournalReadResult } from './storage-interface-DogVPooM.cjs';
 
 interface AsyncBlobStorage {
     read(key: string): Promise<string | null>;
@@ -97,4 +97,4 @@ interface AsyncAtomicRelayLock {
 }
 declare function withAsyncRelayLock(lock: AsyncAtomicRelayLock, work: () => Promise<void>, continuation?: () => Promise<void> | void): Promise<boolean>;
 
-export { type AsyncArchiveFactory as A, type AsyncBlobStorage as a, type AsyncJournalStorage as b, type AsyncKVStorage as c, type AsyncAtomicRelayLock as d, type AsyncQueueStorage as e, type AsyncScratchStorage as f, type AsyncJSONStorage as g, type AsyncStorageProvider as h, withAsyncRelayLock as w };
+export { type AsyncKVStorage as A, type AsyncBlobStorage as a, type AsyncQueueStorage as b, type AsyncScratchStorage as c, type AsyncArchiveFactory as d, type AsyncJournalStorage as e, type AsyncAtomicRelayLock as f, type AsyncJSONStorage as g, type AsyncStorageProvider as h, withAsyncRelayLock as w };

package/lib/{storage-async-interface-CG0bMqvE.d.ts → storage-async-interface-Cb-SULrI.d.ts}

@@ -1,4 +1,4 @@
-import { b as BlobStat, a as KindValueRef, Q as QueueMessage, c as QueueLeasedMessage, d as QueueDeadLetterMessage, J as JournalEntry, e as JournalReadResult } from './storage-interface-D-iEiTJA.js';
+import { b as BlobStat, a as KindValueRef, c as QueueMessage, d as QueueLeasedMessage, e as QueueDeadLetterMessage, J as JournalEntry, f as JournalReadResult } from './storage-interface-DogVPooM.js';
 
 interface AsyncBlobStorage {
     read(key: string): Promise<string | null>;
@@ -97,4 +97,4 @@ interface AsyncAtomicRelayLock {
 }
 declare function withAsyncRelayLock(lock: AsyncAtomicRelayLock, work: () => Promise<void>, continuation?: () => Promise<void> | void): Promise<boolean>;
 
-export { type AsyncArchiveFactory as A, type AsyncBlobStorage as a, type AsyncJournalStorage as b, type AsyncKVStorage as c, type AsyncAtomicRelayLock as d, type AsyncQueueStorage as e, type AsyncScratchStorage as f, type AsyncJSONStorage as g, type AsyncStorageProvider as h, withAsyncRelayLock as w };
+export { type AsyncKVStorage as A, type AsyncBlobStorage as a, type AsyncQueueStorage as b, type AsyncScratchStorage as c, type AsyncArchiveFactory as d, type AsyncJournalStorage as e, type AsyncAtomicRelayLock as f, type AsyncJSONStorage as g, type AsyncStorageProvider as h, withAsyncRelayLock as w };

package/lib/{storage-interface-D-iEiTJA.d.cts → storage-interface-DogVPooM.d.cts}

@@ -226,4 +226,4 @@ interface AtomicRelayLock {
     tryAcquire(): (() => void) | null;
 }
 
-export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueLeasedMessage as c, type QueueDeadLetterMessage as d, type JournalReadResult as e, type QueueStorage as f, type JournalStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };
+export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueStorage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueMessage as c, type QueueLeasedMessage as d, type QueueDeadLetterMessage as e, type JournalReadResult as f, type AtomicRelayLock as g, type JournalStorage as h, parseRef as p, serializeRef as s };

package/lib/{storage-interface-D-iEiTJA.d.ts → storage-interface-DogVPooM.d.ts}

@@ -226,4 +226,4 @@ interface AtomicRelayLock {
     tryAcquire(): (() => void) | null;
 }
 
-export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueMessage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueLeasedMessage as c, type QueueDeadLetterMessage as d, type JournalReadResult as e, type QueueStorage as f, type JournalStorage as g, type AtomicRelayLock as h, parseRef as p, serializeRef as s };
+export { type ArchiveFactory as A, type BlobStorage as B, type JournalEntry as J, type KVStorage as K, type QueueStorage as Q, type ScratchStorage as S, type KindValueRef as a, type BlobStat as b, type QueueMessage as c, type QueueLeasedMessage as d, type QueueDeadLetterMessage as e, type JournalReadResult as f, type AtomicRelayLock as g, type JournalStorage as h, parseRef as p, serializeRef as s };

package/lib/stores/index.d.cts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.cjs';
 export { KVStorageStore } from './kv.cjs';
 import '../types-DjlwALZC.cjs';
-import '../storage-interface-D-iEiTJA.cjs';
+import '../storage-interface-DogVPooM.cjs';

package/lib/stores/index.d.ts

@@ -1,4 +1,4 @@
 export { MemoryStore } from './memory.js';
 export { KVStorageStore } from './kv.js';
 import '../types-DjlwALZC.js';
-import '../storage-interface-D-iEiTJA.js';
+import '../storage-interface-DogVPooM.js';

package/lib/stores/kv.d.cts

@@ -1,5 +1,5 @@
 import { l as StepMachineStore, k as StepMachineState } from '../types-DjlwALZC.cjs';
-import { K as KVStorage } from '../storage-interface-D-iEiTJA.cjs';
+import { K as KVStorage } from '../storage-interface-DogVPooM.cjs';
 
 /**
  * yaml-flow - KVStorageStore

package/lib/stores/kv.d.ts

@@ -1,5 +1,5 @@
 import { l as StepMachineStore, k as StepMachineState } from '../types-DjlwALZC.js';
-import { K as KVStorage } from '../storage-interface-D-iEiTJA.js';
+import { K as KVStorage } from '../storage-interface-DogVPooM.js';
 
 /**
  * yaml-flow - KVStorageStore

package/lib/{types-BsfXZyI3.d.ts → types-BsqzUZNl.d.ts}

@@ -1,8 +1,9 @@
-import { l as BoardLiveCardsNonCorePublic, e as BoardPlatformAdapter, d as BoardNonCorePlatformAdapter, c as BoardLiveCardsPublic, a as CommandResult } from './board-live-cards-public-DSRamFm8.js';
+import { BoardLiveCardsNonCorePublic, BoardPlatformAdapter, BoardNonCorePlatformAdapter, BoardLiveCardsPublic, CommandResult } from './board-live-cards-public.js';
+import { R as RuntimeNotification, d as RuntimeNotificationBatch } from './board-live-cards-lib-iU8xOwNp.js';
 import { ExecutionRef } from './execution-refs.js';
-import { f as QueueStorage, a as KindValueRef } from './storage-interface-D-iEiTJA.js';
-import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-JP9V-U5E.js';
-import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-DlyC3PgC.js';
+import { Q as QueueStorage, a as KindValueRef } from './storage-interface-DogVPooM.js';
+import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-ByBRFn1G.js';
+import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-U98IXUBx.js';
 
 interface BoardWorkerRequest {
     boardId?: string;
@@ -224,6 +225,7 @@ interface SingleBoardRuntime {
             error?: string;
         }>;
     };
+    emitNotification(notification: RuntimeNotification | RuntimeNotificationBatch): void;
 }
 interface MultiBoardRuntime {
     readonly apiBasePath: string;

package/lib/{types-CPnYv7RC.d.cts → types-DxhB6Toz.d.cts}

@@ -1,8 +1,9 @@
-import { l as BoardLiveCardsNonCorePublic, e as BoardPlatformAdapter, d as BoardNonCorePlatformAdapter, c as BoardLiveCardsPublic, a as CommandResult } from './board-live-cards-public-BT5HrgqZ.cjs';
+import { BoardLiveCardsNonCorePublic, BoardPlatformAdapter, BoardNonCorePlatformAdapter, BoardLiveCardsPublic, CommandResult } from './board-live-cards-public.cjs';
+import { R as RuntimeNotification, d as RuntimeNotificationBatch } from './board-live-cards-lib-DVh3t9NT.cjs';
 import { ExecutionRef } from './execution-refs.cjs';
-import { f as QueueStorage, a as KindValueRef } from './storage-interface-D-iEiTJA.cjs';
-import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-BZIftm36.cjs';
-import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-CYjr4mgX.cjs';
+import { Q as QueueStorage, a as KindValueRef } from './storage-interface-DogVPooM.cjs';
+import { A as AsyncBoardPlatformAdapter } from './board-platform-adapter-async-DjBwE0m9.cjs';
+import { A as AsyncBoardLiveCardsPublic } from './board-live-cards-public-async-Cl0M3j5P.cjs';
 
 interface BoardWorkerRequest {
     boardId?: string;
@@ -224,6 +225,7 @@ interface SingleBoardRuntime {
             error?: string;
         }>;
     };
+    emitNotification(notification: RuntimeNotification | RuntimeNotificationBatch): void;
 }
 interface MultiBoardRuntime {
     readonly apiBasePath: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "8.8.7",
+  "version": "8.9.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
@@ -34,6 +34,11 @@
       "import": "./lib/card-store-public.js",
       "require": "./lib/card-store-public.cjs"
     },
+    "./queue-storage-public": {
+      "types": "./lib/queue-storage-public.d.ts",
+      "import": "./lib/queue-storage-public.js",
+      "require": "./lib/queue-storage-public.cjs"
+    },
     "./artifacts-store-public": {
       "types": "./lib/artifacts-store-public.d.ts",
       "import": "./lib/artifacts-store-public.js",
@@ -60,6 +65,16 @@
       "import": "./lib/compute-jsonata/index.js",
       "require": "./lib/compute-jsonata/index.cjs"
     },
+    "./notification-consumer": {
+      "types": "./lib/notification-consumer/index.d.ts",
+      "import": "./lib/notification-consumer/index.js",
+      "require": "./lib/notification-consumer/index.cjs"
+    },
+    "./board-state-reducer": {
+      "types": "./lib/board-state-reducer.d.ts",
+      "import": "./lib/board-state-reducer.js",
+      "require": "./lib/board-state-reducer.cjs"
+    },
     "./browser/compute-jsonata": "./browser/compute-jsonata.js",
     "./browser/compute-jsonata.js": "./browser/compute-jsonata.js",
     "./card-validation": {