yaml-flow 8.0.0 → 8.0.3

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

@@ -4,12 +4,38 @@ import { a as KindValueRef } from './storage-interface-BhAON-gW.cjs';
 export { p as parseRef, s as serializeRef } from './storage-interface-BhAON-gW.cjs';
 import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-BnmRAbQV.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-BnmRAbQV.cjs';
-import { ExecutionRef } from './execution-refs.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 createChatArtifactsStore, e as createFileArtifactsStore } from './artifacts-store-lib-public-DGa8BpJT.cjs';
 import './types-BBhqYGhE.cjs';
 
+/**
+ * cli/common/args-massaging — JSONata-based mapping from logical args to
+ * transport-specific shape.
+ *
+ * `argsMassaging` is a property of `ExecutionRef`, so honoring it is the job
+ * of every adapter (Node spawn, HTTP, Azure Function, etc.). This helper is
+ * the shared pure-JSONata implementation reused by all adapters.
+ *
+ * Adapters call this as the first step inside their `invokeRefSync` /
+ * `dispatchExecution` implementation, then perform their transport using
+ * `cmdArgs` / `body` / `url`.
+ */
+
+interface MassagedArgs {
+    /** Resolved argv tail for local transports. */
+    cmdArgs?: string[];
+    /** Resolved stdin payload for local transports. */
+    stdin?: unknown;
+    /** Resolved final URL string for http transports. */
+    url?: string;
+    /** Resolved request headers for http transports. */
+    headers?: Record<string, string>;
+    /** Resolved request body for http transports. */
+    body?: unknown;
+}
+
 /**
  * execution-adapter.ts
  *
@@ -73,6 +99,24 @@ interface InvokeRefSyncOptions {
     /** Label used in error messages (default: 'invokeRefSync'). */
     label?: string;
 }
+interface InvokeExecutionRefOptions extends InvokeRefSyncOptions {
+    /** Extra async transport handlers keyed by `ExecutionRef.howToRun`. */
+    transports?: Record<string, TransportInvoker>;
+    /** Extra synchronous transport handlers keyed by `ExecutionRef.howToRun`. */
+    syncTransports?: Record<string, SyncTransportInvoker>;
+}
+type TransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult>;
+type SyncTransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => InvokeRefResult;
+interface CreateExecutionRefInvokerOptions extends InvokeExecutionRefOptions {
+}
+interface ExecutionRefInvoker {
+    invoke(ref: ExecutionRef, args: Record<string, unknown>): Promise<InvokeRefResult>;
+    invokeSync(ref: ExecutionRef, args: Record<string, unknown>): InvokeRefResult;
+}
+declare function evaluateArgsMassaging(argsMassaging: ArgsMassaging | undefined, args: Record<string, unknown>, label?: string): MassagedArgs;
+declare function invokeExecutionRef(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): Promise<InvokeRefResult>;
+declare function invokeExecutionRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): InvokeRefResult;
+declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOptions): ExecutionRefInvoker;
 /**
  * Invoke an ExecutionRef synchronously with a request/reply contract.
  *
@@ -131,4 +175,4 @@ declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliD
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ExecutionRef, InvocationAdapter, KindValueRef, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, invokeRefSync };
+export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, createExecutionRefInvoker, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync };

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

@@ -4,12 +4,38 @@ import { a as KindValueRef } from './storage-interface-BhAON-gW.js';
 export { p as parseRef, s as serializeRef } from './storage-interface-BhAON-gW.js';
 import { e as BoardNonCorePlatformAdapter, d as BoardPlatformAdapter } from './board-live-cards-public-CsmYrvpd.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-CsmYrvpd.js';
-import { ExecutionRef } from './execution-refs.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 createChatArtifactsStore, e as createFileArtifactsStore } from './artifacts-store-lib-public-BABrgFkV.js';
 import './types-BBhqYGhE.js';
 
+/**
+ * cli/common/args-massaging — JSONata-based mapping from logical args to
+ * transport-specific shape.
+ *
+ * `argsMassaging` is a property of `ExecutionRef`, so honoring it is the job
+ * of every adapter (Node spawn, HTTP, Azure Function, etc.). This helper is
+ * the shared pure-JSONata implementation reused by all adapters.
+ *
+ * Adapters call this as the first step inside their `invokeRefSync` /
+ * `dispatchExecution` implementation, then perform their transport using
+ * `cmdArgs` / `body` / `url`.
+ */
+
+interface MassagedArgs {
+    /** Resolved argv tail for local transports. */
+    cmdArgs?: string[];
+    /** Resolved stdin payload for local transports. */
+    stdin?: unknown;
+    /** Resolved final URL string for http transports. */
+    url?: string;
+    /** Resolved request headers for http transports. */
+    headers?: Record<string, string>;
+    /** Resolved request body for http transports. */
+    body?: unknown;
+}
+
 /**
  * execution-adapter.ts
  *
@@ -73,6 +99,24 @@ interface InvokeRefSyncOptions {
     /** Label used in error messages (default: 'invokeRefSync'). */
     label?: string;
 }
+interface InvokeExecutionRefOptions extends InvokeRefSyncOptions {
+    /** Extra async transport handlers keyed by `ExecutionRef.howToRun`. */
+    transports?: Record<string, TransportInvoker>;
+    /** Extra synchronous transport handlers keyed by `ExecutionRef.howToRun`. */
+    syncTransports?: Record<string, SyncTransportInvoker>;
+}
+type TransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => Promise<InvokeRefResult>;
+type SyncTransportInvoker = (ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions) => InvokeRefResult;
+interface CreateExecutionRefInvokerOptions extends InvokeExecutionRefOptions {
+}
+interface ExecutionRefInvoker {
+    invoke(ref: ExecutionRef, args: Record<string, unknown>): Promise<InvokeRefResult>;
+    invokeSync(ref: ExecutionRef, args: Record<string, unknown>): InvokeRefResult;
+}
+declare function evaluateArgsMassaging(argsMassaging: ArgsMassaging | undefined, args: Record<string, unknown>, label?: string): MassagedArgs;
+declare function invokeExecutionRef(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): Promise<InvokeRefResult>;
+declare function invokeExecutionRefSync(ref: ExecutionRef, args: Record<string, unknown>, options?: InvokeExecutionRefOptions): InvokeRefResult;
+declare function createExecutionRefInvoker(options?: CreateExecutionRefInvokerOptions): ExecutionRefInvoker;
 /**
  * Invoke an ExecutionRef synchronously with a request/reply contract.
  *
@@ -131,4 +175,4 @@ declare function createFsBoardNonCorePlatformAdapter(baseRef: KindValueRef, cliD
  */
 declare function decodeBoardRefFromToken(token: string): string | null;
 
-export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, ExecutionRef, InvocationAdapter, KindValueRef, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, invokeRefSync };
+export { BoardNonCorePlatformAdapter, BoardPlatformAdapter, type CreateExecutionRefInvokerOptions, ExecutionRef, type ExecutionRefInvoker, InvocationAdapter, type InvokeExecutionRefOptions, type InvokeRefResult, KindValueRef, type SyncTransportInvoker, type TransportInvoker, createExecutionRefInvoker, createFsBoardNonCorePlatformAdapter, createFsBoardPlatformAdapter, createNodeSpawnInvocationAdapter, decodeBoardRefFromToken, evaluateArgsMassaging, invokeExecutionRef, invokeExecutionRefSync, invokeRefSync };