yaml-flow 8.2.5 → 8.4.0

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

@@ -1,13 +1,17 @@
-import { c as ChatStorage, I as InvocationAdapter } from './types-Bztd1KoK.cjs';
-export { f as ChatConfig, g as ChatRecord, D as DescribeEnvelope, h as createChatStorage, i as createInMemoryChatStorage } from './types-Bztd1KoK.cjs';
-import { a as KindValueRef } from './storage-interface-B6ecOulj.cjs';
-export { p as parseRef, s as serializeRef } from './storage-interface-B6ecOulj.cjs';
-import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-BLXbcBNk.cjs';
-export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, C as CommandInput, a 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-BLXbcBNk.cjs';
+import { a as ArtifactsStore } from './artifacts-store-lib-zsGFbBV8.cjs';
+export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-zsGFbBV8.cjs';
+import { I as InvocationAdapter } from './types-Dszjwfud.cjs';
+export { D as DescribeEnvelope } from './types-Dszjwfud.cjs';
+import { a as KindValueRef } from './storage-interface-B-7pDHwD.cjs';
+export { p as parseRef, s as serializeRef } from './storage-interface-B-7pDHwD.cjs';
+import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-BM6jCEIa.cjs';
+export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, C as CommandInput, a 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-BM6jCEIa.cjs';
+import { c as ChatStorage } from './chat-storage-lib-OX0Q_Ttf.cjs';
+export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-OX0Q_Ttf.cjs';
 import { ExecutionRef, ArgsMassaging } from './execution-refs.cjs';
 export { executionRefFromScriptPath, parseExecutionRef, serializeExecutionRef } from './execution-refs.cjs';
 export { createCardStorePublic } from './card-store-public.cjs';
-export { c as createArtifactsStore, a as createArtifactsStorePublic, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-public-C5UL5tyG.cjs';
+export { createArtifactsStorePublic } from './artifacts-store-public.cjs';
 import './types-BBhqYGhE.cjs';
 
 /**
@@ -80,6 +84,24 @@ interface MassagedArgs {
  *  If argsMassaging is absent, the adapter uses its default mapping.
  */
 
+declare function resolveYamlFlowCliPath(cliFileName: string): string;
+declare function resolveWhatToRunValue(whatToRun: string | KindValueRef): string;
+/**
+ * Resolve an ExecutionRef to its base { command, baseArgs } for local transports.
+ *
+ * Exported for callers that need to stay synchronous (e.g. validate-source-def,
+ * describe-capabilities) and build their own final argv.
+ * Does NOT evaluate argsMassaging — append custom argv after baseArgs.
+ *
+ * @example
+ *   const { command, baseArgs } = buildLocalBaseSpec(teRef, cliDir);
+ *   executor.executeSync(command, [...baseArgs, 'describe-capabilities'], { timeout: 10_000 });
+ */
+declare function buildLocalBaseSpec(ref: ExecutionRef, cliDir: string): {
+    command: string;
+    baseArgs: string[];
+};
+
 /** Normalized envelope returned by invokeRefSync. */
 interface InvokeRefResult {
     /** Outcome key — drives transitions in the step machine ('success' | 'failure' | custom). */
@@ -136,18 +158,6 @@ declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOp
  */
 declare function invokeRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeRefSyncOptions): InvokeRefResult;
 
-/**
- * fs-board-adapter.ts
- *
- * Wires Node.js / FS platform adapters into BoardPlatformAdapter and
- * BoardNonCorePlatformAdapter, and provides FS-specific board utility functions.
- *
- * Everything in the board-live-cards system that is platform-free lives in
- * src/cli/common/. All FS / Node.js / process concerns live here.
- *
- * Re-exports the full public API so consumers only need to import from this file.
- */
-
 /**
  * Creates an InvocationAdapter backed by Node.js `spawn`/`spawnSync`.
  *
@@ -169,11 +179,22 @@ type FsBoardNonCoreAdapterOpts = {
 };
 declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardAdapterOpts, maybeOpts?: FsBoardAdapterOpts): BoardPlatformAdapter;
 declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardNonCoreAdapterOpts, maybeOpts?: FsBoardNonCoreAdapterOpts): BoardNonCorePlatformAdapter;
-declare function createFsBoardChatStorage(boardDir: string): ChatStorage;
+interface FsBoardChatStorageOptions {
+    /** Subdirectory under boardDir for per-card jsonl files. Default: 'chats'. Pass '' to write directly under boardDir. */
+    chatsSubdir?: string;
+    /** Subdirectory under boardDir for chat KV (processing flags + config). Default: '.kv'. Pass '' to root at boardDir. */
+    kvSubdir?: string;
+}
+declare function createFsBoardChatStorage(boardDir: string, opts?: FsBoardChatStorageOptions): ChatStorage;
+interface FsBoardFileArtifactsStoreOptions {
+    /** Subdirectory under baseDir for file uploads. Default: 'files'. Pass '' to root at baseDir. */
+    filesSubdir?: string;
+}
+declare function createFsBoardFileArtifactsStore(baseDir: string, opts?: FsBoardFileArtifactsStoreOptions): ArtifactsStore;
 /**
  * Extract the serialized board ref from a source token (which has a `br` field).
  * Returns null for callback tokens (which don't carry a board ref).
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync };
+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 };

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

@@ -1,13 +1,17 @@
-import { c as ChatStorage, I as InvocationAdapter } from './types-D-xVWPdY.js';
-export { f as ChatConfig, g as ChatRecord, D as DescribeEnvelope, h as createChatStorage, i as createInMemoryChatStorage } from './types-D-xVWPdY.js';
-import { a as KindValueRef } from './storage-interface-B6ecOulj.js';
-export { p as parseRef, s as serializeRef } from './storage-interface-B6ecOulj.js';
-import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-BZaNb2mi.js';
-export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, C as CommandInput, a 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-BZaNb2mi.js';
+import { a as ArtifactsStore } from './artifacts-store-lib-454TAuov.js';
+export { c as createArtifactsStore, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-454TAuov.js';
+import { I as InvocationAdapter } from './types-Cn0b8G-i.js';
+export { D as DescribeEnvelope } from './types-Cn0b8G-i.js';
+import { a as KindValueRef } from './storage-interface-B-7pDHwD.js';
+export { p as parseRef, s as serializeRef } from './storage-interface-B-7pDHwD.js';
+import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-Bz07XKRK.js';
+export { f as BOARD_GRAPH_KEY, g as BoardLiveCardsNonCorePublic, c as BoardLiveCardsPublic, C as CommandInput, a 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-Bz07XKRK.js';
+import { c as ChatStorage } from './chat-storage-lib-DGaKrjVe.js';
+export { b as ChatConfig, C as ChatRecord, d as createChatStorage, e as createInMemoryChatStorage } from './chat-storage-lib-DGaKrjVe.js';
 import { ExecutionRef, ArgsMassaging } from './execution-refs.js';
 export { executionRefFromScriptPath, parseExecutionRef, serializeExecutionRef } from './execution-refs.js';
 export { createCardStorePublic } from './card-store-public.js';
-export { c as createArtifactsStore, a as createArtifactsStorePublic, b as createCardFileMetadataStore, d as createFileArtifactsStore } from './artifacts-store-lib-public-GD4H-fFp.js';
+export { createArtifactsStorePublic } from './artifacts-store-public.js';
 import './types-BBhqYGhE.js';
 
 /**
@@ -80,6 +84,24 @@ interface MassagedArgs {
  *  If argsMassaging is absent, the adapter uses its default mapping.
  */
 
+declare function resolveYamlFlowCliPath(cliFileName: string): string;
+declare function resolveWhatToRunValue(whatToRun: string | KindValueRef): string;
+/**
+ * Resolve an ExecutionRef to its base { command, baseArgs } for local transports.
+ *
+ * Exported for callers that need to stay synchronous (e.g. validate-source-def,
+ * describe-capabilities) and build their own final argv.
+ * Does NOT evaluate argsMassaging — append custom argv after baseArgs.
+ *
+ * @example
+ *   const { command, baseArgs } = buildLocalBaseSpec(teRef, cliDir);
+ *   executor.executeSync(command, [...baseArgs, 'describe-capabilities'], { timeout: 10_000 });
+ */
+declare function buildLocalBaseSpec(ref: ExecutionRef, cliDir: string): {
+    command: string;
+    baseArgs: string[];
+};
+
 /** Normalized envelope returned by invokeRefSync. */
 interface InvokeRefResult {
     /** Outcome key — drives transitions in the step machine ('success' | 'failure' | custom). */
@@ -136,18 +158,6 @@ declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOp
  */
 declare function invokeRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeRefSyncOptions): InvokeRefResult;
 
-/**
- * fs-board-adapter.ts
- *
- * Wires Node.js / FS platform adapters into BoardPlatformAdapter and
- * BoardNonCorePlatformAdapter, and provides FS-specific board utility functions.
- *
- * Everything in the board-live-cards system that is platform-free lives in
- * src/cli/common/. All FS / Node.js / process concerns live here.
- *
- * Re-exports the full public API so consumers only need to import from this file.
- */
-
 /**
  * Creates an InvocationAdapter backed by Node.js `spawn`/`spawnSync`.
  *
@@ -169,11 +179,22 @@ type FsBoardNonCoreAdapterOpts = {
 };
 declare function createFsBoardPlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardAdapterOpts, maybeOpts?: FsBoardAdapterOpts): BoardPlatformAdapter;
 declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliDirOrOpts?: string | FsBoardNonCoreAdapterOpts, maybeOpts?: FsBoardNonCoreAdapterOpts): BoardNonCorePlatformAdapter;
-declare function createFsBoardChatStorage(boardDir: string): ChatStorage;
+interface FsBoardChatStorageOptions {
+    /** Subdirectory under boardDir for per-card jsonl files. Default: 'chats'. Pass '' to write directly under boardDir. */
+    chatsSubdir?: string;
+    /** Subdirectory under boardDir for chat KV (processing flags + config). Default: '.kv'. Pass '' to root at boardDir. */
+    kvSubdir?: string;
+}
+declare function createFsBoardChatStorage(boardDir: string, opts?: FsBoardChatStorageOptions): ChatStorage;
+interface FsBoardFileArtifactsStoreOptions {
+    /** Subdirectory under baseDir for file uploads. Default: 'files'. Pass '' to root at baseDir. */
+    filesSubdir?: string;
+}
+declare function createFsBoardFileArtifactsStore(baseDir: string, opts?: FsBoardFileArtifactsStoreOptions): ArtifactsStore;
 /**
  * Extract the serialized board ref from a source token (which has a `br` field).
  * Returns null for callback tokens (which don't carry a board ref).
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ChatStorage, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, createExecutionRefInvoker, createFsBoardChatStorage, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync };
+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 };