yaml-flow 8.5.3 → 8.6.2

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

@@ -1,18 +1,19 @@
-import { a as ArtifactsStore } from './artifacts-store-lib-CVgtQrNZ.cjs';
-export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-CVgtQrNZ.cjs';
-import { I as InvocationAdapter } from './types-CIgsh56O.cjs';
-export { D as DescribeEnvelope } from './types-CIgsh56O.cjs';
-import { a as KindValueRef } from './storage-interface-B2WD9D5n.cjs';
-export { p as parseRef, s as serializeRef } from './storage-interface-B2WD9D5n.cjs';
-import { d as BoardNonCorePlatformAdapter, e as BoardPlatformAdapter } from './board-live-cards-public-B13InXhC.cjs';
-export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, a as CommandInput, C as CommandResult, E as EMPTY_CONFIG, L as LiveCard, S as SNAPSHOT_SCHEMA_VERSION_V1, h as createBoardLiveCardsNonCorePublic, i as createBoardLiveCardsPublic, j as createCardStore } from './board-live-cards-public-B13InXhC.cjs';
-import { c as ChatStorage } from './chat-storage-lib-0imhRX3l.cjs';
-export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-0imhRX3l.cjs';
+import { a as ArtifactsStore } from './artifacts-store-lib-BR-Samty.cjs';
+export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-BR-Samty.cjs';
+import { h as QueueLaneLease, i as QueueLaneDescriptor, Q as QueueLaneRegistry, I as InvocationAdapter } from './queue-lane-registry-BPKWWgd4.cjs';
+export { D as DescribeEnvelope, j as createQueueLaneRegistry } from './queue-lane-registry-BPKWWgd4.cjs';
+import { a as KindValueRef, g as QueueStorage } from './storage-interface-BFiD3kyB.cjs';
+export { p as parseRef, s as serializeRef } from './storage-interface-BFiD3kyB.cjs';
+import { l as BoardWorkerStore, B as BoardWorkerRequest, g as BoardCallbackTransport, e as BoardNonCorePlatformAdapter, f as BoardPlatformAdapter } from './board-live-cards-public-wkNmBIRC.cjs';
+export { m as BOARD_GRAPH_KEY, n as BoardLiveCardsNonCorePublic, d as BoardLiveCardsPublic, o as BoardWorkerDeadLetterRequest, p as BoardWorkerLeasedRequest, q as BoardWorkerQueuedRequest, a as CommandInput, C as CommandResult, E as EMPTY_CONFIG, L as LiveCard, r as SNAPSHOT_SCHEMA_VERSION_V1, s as createBoardLiveCardsNonCorePublic, t as createBoardLiveCardsPublic, u as createBoardWorkerStore, v as createCardStore, w as createHttpBoardCallbackTransport, x as createInProcessBoardCallbackTransport, y as createLocalNodeBoardCallbackTransport } from './board-live-cards-public-wkNmBIRC.cjs';
+import { c as ChatStorage } from './chat-storage-lib-BIUbE-fM.cjs';
+export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-BIUbE-fM.cjs';
 export { BoardLiveCardsMcp, BoardLiveCardsMcpBoardStatusResult, BoardLiveCardsMcpDeps, BoardLiveCardsMcpDiscoverSourceKindsResult, BoardLiveCardsMcpFileDownloadDescriptor, BoardLiveCardsMcpInspectCardDefinitionAndRuntimeResult, BoardLiveCardsMcpInspectChatMessagesResult, BoardLiveCardsMcpManageUpsertCardResult, createBoardLiveCardsMcp } from './board-live-cards-mcp.cjs';
 import { ExecutionRef, ArgsMassaging } from './execution-refs.cjs';
 export { executionRefFromScriptPath, parseExecutionRef, serializeExecutionRef } from './execution-refs.cjs';
 export { createCardStorePublic } from './card-store-public.cjs';
 export { createArtifactsStorePublic } from './artifacts-store-public.cjs';
+import './board-live-cards-public-async-dMWNbWq6.cjs';
 import './types-BBhqYGhE.cjs';
 import './chat-store-public.cjs';
 
@@ -112,6 +113,8 @@ interface InvokeRefResult {
     data: Record<string, unknown>;
     /** Optional human-readable error detail. */
     error?: string;
+    /** Optional response headers for HTTP transports. */
+    headers?: Record<string, string>;
 }
 interface InvokeRefSyncOptions {
     /** Directory used to resolve `built-in` refs (defaults to ref's cwd / process cwd). */
@@ -130,6 +133,9 @@ interface InvokeExecutionRefOptions extends InvokeRefSyncOptions {
     syncTransports?: Record<string, SyncTransportInvoker>;
 }
 type TransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult>;
+type InProcessExecutionHandler = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult> | InvokeRefResult;
+declare function registerInProcessExecutionHandler(key: string, handler: InProcessExecutionHandler): void;
+declare function unregisterInProcessExecutionHandler(key: string): void;
 type SyncTransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => InvokeRefResult;
 interface CreateExecutionRefInvokerOptions extends InvokeExecutionRefOptions {
 }
@@ -160,14 +166,44 @@ declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOp
  */
 declare function invokeRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeRefSyncOptions): InvokeRefResult;
 
+declare function createFsQueueStorage(rootDir: string): QueueStorage;
+
+interface CreateBoardWorkerQueueLaneOptions {
+    id?: string;
+    workerStore: BoardWorkerStore;
+    handleRequest(args: Record<string, unknown>, request: BoardWorkerRequest): Promise<void>;
+    pollIntervalMs?: number;
+    visibilityMs?: number;
+    concurrency?: number;
+    maxAttempts?: number;
+    onError?: (error: unknown, lease: QueueLaneLease<BoardWorkerRequest>) => void;
+}
+interface CreateQueueStorageLaneOptions<TMessage> {
+    id: string;
+    queueStorage: QueueStorage;
+    handleMessage(message: TMessage, lease: QueueLaneLease<TMessage>): Promise<void>;
+    pollIntervalMs?: number;
+    visibilityMs?: number;
+    concurrency?: number;
+    maxAttempts?: number;
+    onError?: (error: unknown, lease: QueueLaneLease<TMessage>) => void;
+}
+declare function createBoardWorkerQueueLane(opts: CreateBoardWorkerQueueLaneOptions): QueueLaneDescriptor<BoardWorkerRequest>;
+declare function createQueueStorageLane<TMessage>(opts: CreateQueueStorageLaneOptions<TMessage>): QueueLaneDescriptor<TMessage>;
+declare function startQueueLaneRunner<TMessage>(lane: QueueLaneDescriptor<TMessage>): () => void;
+declare function drainQueueLaneToIdle<TMessage>(lane: QueueLaneDescriptor<TMessage>, opts?: {
+    maxPasses?: number;
+}): Promise<number>;
+declare function startQueueLaneRunners(registryOrLanes: QueueLaneRegistry | QueueLaneDescriptor[]): () => void;
+
 /**
- * Creates an InvocationAdapter backed by Node.js `spawn`/`spawnSync`.
+ * Creates a Node host InvocationAdapter backed by `spawn`/`spawnSync`.
  *
  * Supports howToRun: 'local-node'
- *   → spawns the script as a detached Node.js child process (fire-and-forget).
+ *   → the Node host adapter spawns the script as a detached child process.
  *
  * Pass to createSingleBoardServerRuntime / createMultiBoardServerRuntime as
- * the `invocationAdapter` option. This is the reference Node.js implementation;
+ * the `invocationAdapter` option. This is the reference Node host implementation;
  * replace with your own for Azure Functions, Lambda, etc.
  */
 declare function createNodeSpawnInvocationAdapter(): InvocationAdapter;
@@ -175,9 +211,11 @@ type FsBoardAdapterOpts = {
     onWarn?: (msg: string) => void;
     suppressSpawn?: boolean;
     notifyChannel?: string;
+    callbackTransport?: BoardCallbackTransport;
 };
 type FsBoardNonCoreAdapterOpts = {
     onWarn?: (msg: string) => void;
+    callbackTransport?: BoardCallbackTransport;
 };
 declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardAdapterOpts, maybeOpts?: FsBoardAdapterOpts): BoardPlatformAdapter;
 declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardNonCoreAdapterOpts, maybeOpts?: FsBoardNonCoreAdapterOpts): BoardNonCorePlatformAdapter;
@@ -199,4 +237,4 @@ declare function createFsBoardFileArtifactsStore(baseDir: string, opts?: FsBoard
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, type FsBoardChatStorageOptions, type FsBoardFileArtifactsStoreOptions, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, buildLocalBaseSpec, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync, resolveWhatToRunValue, resolveYamlFlowCliPath };
+export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, BoardWorkerRequest, BoardWorkerStore, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, type FsBoardChatStorageOptions, type FsBoardFileArtifactsStoreOptions, type InProcessExecutionHandler, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, QueueLaneDescriptor, QueueLaneLease, QueueLaneRegistry, type SyncTransportInvoker, type TransportInvoker, buildLocalBaseSpec, createBoardWorkerQueueLane, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createFsQueueStorage, createNodeSpawnInvocationAdapter, createQueueStorageLane, decodeBoardRefFromToken, drainQueueLaneToIdle, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync, registerInProcessExecutionHandler, resolveWhatToRunValue, resolveYamlFlowCliPath, startQueueLaneRunner, startQueueLaneRunners, unregisterInProcessExecutionHandler };

package/lib/board-live-cards-node.d.ts

@@ -1,18 +1,19 @@
-import { a as ArtifactsStore } from './artifacts-store-lib-D-k-E8Vy.js';
-export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-D-k-E8Vy.js';
-import { I as InvocationAdapter } from './types-30R357js.js';
-export { D as DescribeEnvelope } from './types-30R357js.js';
-import { a as KindValueRef } from './storage-interface-B2WD9D5n.js';
-export { p as parseRef, s as serializeRef } from './storage-interface-B2WD9D5n.js';
-import { d as BoardNonCorePlatformAdapter, e as BoardPlatformAdapter } from './board-live-cards-public-BGS22cMb.js';
-export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, a as CommandInput, C as CommandResult, E as EMPTY_CONFIG, L as LiveCard, S as SNAPSHOT_SCHEMA_VERSION_V1, h as createBoardLiveCardsNonCorePublic, i as createBoardLiveCardsPublic, j as createCardStore } from './board-live-cards-public-BGS22cMb.js';
-import { c as ChatStorage } from './chat-storage-lib-CJn7a6OH.js';
-export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-CJn7a6OH.js';
+import { a as ArtifactsStore } from './artifacts-store-lib-DT7XlWUL.js';
+export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-DT7XlWUL.js';
+import { h as QueueLaneLease, i as QueueLaneDescriptor, Q as QueueLaneRegistry, I as InvocationAdapter } from './queue-lane-registry-Be6c0ftj.js';
+export { D as DescribeEnvelope, j as createQueueLaneRegistry } from './queue-lane-registry-Be6c0ftj.js';
+import { a as KindValueRef, g as QueueStorage } from './storage-interface-BFiD3kyB.js';
+export { p as parseRef, s as serializeRef } from './storage-interface-BFiD3kyB.js';
+import { l as BoardWorkerStore, B as BoardWorkerRequest, g as BoardCallbackTransport, e as BoardNonCorePlatformAdapter, f as BoardPlatformAdapter } from './board-live-cards-public-BMUIPOrc.js';
+export { m as BOARD_GRAPH_KEY, n as BoardLiveCardsNonCorePublic, d as BoardLiveCardsPublic, o as BoardWorkerDeadLetterRequest, p as BoardWorkerLeasedRequest, q as BoardWorkerQueuedRequest, a as CommandInput, C as CommandResult, E as EMPTY_CONFIG, L as LiveCard, r as SNAPSHOT_SCHEMA_VERSION_V1, s as createBoardLiveCardsNonCorePublic, t as createBoardLiveCardsPublic, u as createBoardWorkerStore, v as createCardStore, w as createHttpBoardCallbackTransport, x as createInProcessBoardCallbackTransport, y as createLocalNodeBoardCallbackTransport } from './board-live-cards-public-BMUIPOrc.js';
+import { c as ChatStorage } from './chat-storage-lib-BlG-sobS.js';
+export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-BlG-sobS.js';
 export { BoardLiveCardsMcp, BoardLiveCardsMcpBoardStatusResult, BoardLiveCardsMcpDeps, BoardLiveCardsMcpDiscoverSourceKindsResult, BoardLiveCardsMcpFileDownloadDescriptor, BoardLiveCardsMcpInspectCardDefinitionAndRuntimeResult, BoardLiveCardsMcpInspectChatMessagesResult, BoardLiveCardsMcpManageUpsertCardResult, createBoardLiveCardsMcp } from './board-live-cards-mcp.js';
 import { ExecutionRef, ArgsMassaging } from './execution-refs.js';
 export { executionRefFromScriptPath, parseExecutionRef, serializeExecutionRef } from './execution-refs.js';
 export { createCardStorePublic } from './card-store-public.js';
 export { createArtifactsStorePublic } from './artifacts-store-public.js';
+import './board-live-cards-public-async-DKZqbJVU.js';
 import './types-BBhqYGhE.js';
 import './chat-store-public.js';
 
@@ -112,6 +113,8 @@ interface InvokeRefResult {
     data: Record<string, unknown>;
     /** Optional human-readable error detail. */
     error?: string;
+    /** Optional response headers for HTTP transports. */
+    headers?: Record<string, string>;
 }
 interface InvokeRefSyncOptions {
     /** Directory used to resolve `built-in` refs (defaults to ref's cwd / process cwd). */
@@ -130,6 +133,9 @@ interface InvokeExecutionRefOptions extends InvokeRefSyncOptions {
     syncTransports?: Record<string, SyncTransportInvoker>;
 }
 type TransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult>;
+type InProcessExecutionHandler = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult> | InvokeRefResult;
+declare function registerInProcessExecutionHandler(key: string, handler: InProcessExecutionHandler): void;
+declare function unregisterInProcessExecutionHandler(key: string): void;
 type SyncTransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => InvokeRefResult;
 interface CreateExecutionRefInvokerOptions extends InvokeExecutionRefOptions {
 }
@@ -160,14 +166,44 @@ declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOp
  */
 declare function invokeRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeRefSyncOptions): InvokeRefResult;
 
+declare function createFsQueueStorage(rootDir: string): QueueStorage;
+
+interface CreateBoardWorkerQueueLaneOptions {
+    id?: string;
+    workerStore: BoardWorkerStore;
+    handleRequest(args: Record<string, unknown>, request: BoardWorkerRequest): Promise<void>;
+    pollIntervalMs?: number;
+    visibilityMs?: number;
+    concurrency?: number;
+    maxAttempts?: number;
+    onError?: (error: unknown, lease: QueueLaneLease<BoardWorkerRequest>) => void;
+}
+interface CreateQueueStorageLaneOptions<TMessage> {
+    id: string;
+    queueStorage: QueueStorage;
+    handleMessage(message: TMessage, lease: QueueLaneLease<TMessage>): Promise<void>;
+    pollIntervalMs?: number;
+    visibilityMs?: number;
+    concurrency?: number;
+    maxAttempts?: number;
+    onError?: (error: unknown, lease: QueueLaneLease<TMessage>) => void;
+}
+declare function createBoardWorkerQueueLane(opts: CreateBoardWorkerQueueLaneOptions): QueueLaneDescriptor<BoardWorkerRequest>;
+declare function createQueueStorageLane<TMessage>(opts: CreateQueueStorageLaneOptions<TMessage>): QueueLaneDescriptor<TMessage>;
+declare function startQueueLaneRunner<TMessage>(lane: QueueLaneDescriptor<TMessage>): () => void;
+declare function drainQueueLaneToIdle<TMessage>(lane: QueueLaneDescriptor<TMessage>, opts?: {
+    maxPasses?: number;
+}): Promise<number>;
+declare function startQueueLaneRunners(registryOrLanes: QueueLaneRegistry | QueueLaneDescriptor[]): () => void;
+
 /**
- * Creates an InvocationAdapter backed by Node.js `spawn`/`spawnSync`.
+ * Creates a Node host InvocationAdapter backed by `spawn`/`spawnSync`.
  *
  * Supports howToRun: 'local-node'
- *   → spawns the script as a detached Node.js child process (fire-and-forget).
+ *   → the Node host adapter spawns the script as a detached child process.
  *
  * Pass to createSingleBoardServerRuntime / createMultiBoardServerRuntime as
- * the `invocationAdapter` option. This is the reference Node.js implementation;
+ * the `invocationAdapter` option. This is the reference Node host implementation;
  * replace with your own for Azure Functions, Lambda, etc.
  */
 declare function createNodeSpawnInvocationAdapter(): InvocationAdapter;
@@ -175,9 +211,11 @@ type FsBoardAdapterOpts = {
     onWarn?: (msg: string) => void;
     suppressSpawn?: boolean;
     notifyChannel?: string;
+    callbackTransport?: BoardCallbackTransport;
 };
 type FsBoardNonCoreAdapterOpts = {
     onWarn?: (msg: string) => void;
+    callbackTransport?: BoardCallbackTransport;
 };
 declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardAdapterOpts, maybeOpts?: FsBoardAdapterOpts): BoardPlatformAdapter;
 declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardNonCoreAdapterOpts, maybeOpts?: FsBoardNonCoreAdapterOpts): BoardNonCorePlatformAdapter;
@@ -199,4 +237,4 @@ declare function createFsBoardFileArtifactsStore(baseDir: string, opts?: FsBoard
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, type FsBoardChatStorageOptions, type FsBoardFileArtifactsStoreOptions, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, buildLocalBaseSpec, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync, resolveWhatToRunValue, resolveYamlFlowCliPath };
+export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, BoardWorkerRequest, BoardWorkerStore, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, type FsBoardChatStorageOptions, type FsBoardFileArtifactsStoreOptions, type InProcessExecutionHandler, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, QueueLaneDescriptor, QueueLaneLease, QueueLaneRegistry, type SyncTransportInvoker, type TransportInvoker, buildLocalBaseSpec, createBoardWorkerQueueLane, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardFileArtifactsStore, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createFsQueueStorage, createNodeSpawnInvocationAdapter, createQueueStorageLane, decodeBoardRefFromToken, drainQueueLaneToIdle, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync, registerInProcessExecutionHandler, resolveWhatToRunValue, resolveYamlFlowCliPath, startQueueLaneRunner, startQueueLaneRunners, unregisterInProcessExecutionHandler };