yaml-flow 2.4.0 → 2.6.0

package/dist/types-C2lOwquM.d.cts

@@ -0,0 +1,135 @@
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, l as TaskState } from './types-DAI_a2as.cjs';
+
+/**
+ * Continuous Event Graph — Types
+ *
+ * A long-lived, evolving event-graph where both config and state
+ * mutate over time. The single `LiveGraph` type bundles them.
+ *
+ * Events are shared with event-graph (task-started, task-completed, etc.).
+ * Graph mutations (addNode, removeNode, etc.) are unique to this mode.
+ */
+
+/**
+ * The single evolving object for a continuous-mode graph.
+ * Bundles config + state so they can't get out of sync.
+ */
+interface LiveGraph {
+    /** The current graph configuration (evolves as nodes are added/removed) */
+    config: GraphConfig;
+    /** The current execution state (evolves as events arrive) */
+    state: ExecutionState;
+}
+interface ScheduleResult {
+    /** Tasks ready to dispatch now — all requires satisfied */
+    eligible: string[];
+    /** Tasks waiting on tokens that some producer will eventually provide (normal) */
+    pending: PendingTask[];
+    /** Tasks waiting on tokens that NO task can produce (caller's problem) */
+    unresolved: UnresolvedDependency[];
+    /** Tasks waiting on tokens whose producer FAILED (caller's problem) */
+    blocked: BlockedTask[];
+    /** Token conflicts: multiple tasks produce the same token */
+    conflicts: Record<string, string[]>;
+}
+interface PendingTask {
+    taskName: string;
+    /** Tokens this task needs that haven't been produced yet but have a viable producer */
+    waitingOn: string[];
+}
+interface UnresolvedDependency {
+    taskName: string;
+    /** Tokens this task needs that no task in the graph can produce */
+    missingTokens: string[];
+}
+interface BlockedTask {
+    taskName: string;
+    /** Tokens this task needs whose only producer has failed */
+    failedTokens: string[];
+    /** The tasks that failed and would have produced those tokens */
+    failedProducers: string[];
+}
+interface LiveGraphHealth {
+    /** Total number of tasks in the graph */
+    totalNodes: number;
+    /** Task counts by status */
+    running: number;
+    completed: number;
+    failed: number;
+    waiting: number;
+    notStarted: number;
+    /** Number of disabled (inactivated) nodes */
+    disabled: number;
+    /** Number of tasks with unresolvable dependencies */
+    unresolvedCount: number;
+    /** Number of tasks whose producer has failed */
+    blockedCount: number;
+    /** Tokens that no task produces (open dependencies) */
+    openDependencies: string[];
+    /** Cycles detected in the current graph (if any) */
+    cycles: string[][];
+    /** Tokens produced by multiple tasks */
+    conflictTokens: string[];
+}
+interface NodeInfo {
+    /** Node name */
+    name: string;
+    /** The task configuration */
+    config: TaskConfig;
+    /** The current runtime state */
+    state: TaskState;
+}
+interface LiveGraphSnapshot {
+    /** Schema version for forward compatibility */
+    version: number;
+    /** The graph config at snapshot time */
+    config: GraphConfig;
+    /** The execution state at snapshot time */
+    state: ExecutionState;
+    /** ISO timestamp of when the snapshot was taken */
+    snapshotAt: string;
+}
+interface UnreachableTokensResult {
+    tokens: {
+        /** The token that cannot be produced */
+        token: string;
+        /** Why it's unreachable */
+        reason: 'no-producer' | 'all-producers-failed' | 'transitive';
+        /** Tasks that could produce it (but are themselves unreachable/failed) */
+        producers: string[];
+    }[];
+}
+interface UnreachableNodesResult {
+    nodes: {
+        /** The node that can never become eligible */
+        nodeName: string;
+        /** Unreachable tokens this node requires (empty if the node itself is failed/disabled) */
+        missingTokens: string[];
+    }[];
+}
+interface UpstreamResult {
+    /** The target node being inspected */
+    nodeName: string;
+    /** All upstream nodes that transitively feed into the target */
+    nodes: {
+        nodeName: string;
+        /** Tokens this node provides that are in the dependency chain */
+        providesTokens: string[];
+    }[];
+    /** All tokens in the upstream dependency chain */
+    tokens: string[];
+}
+interface DownstreamResult {
+    /** The target node being inspected */
+    nodeName: string;
+    /** All downstream nodes that transitively depend on the target */
+    nodes: {
+        nodeName: string;
+        /** Tokens this node requires that are in the dependency chain */
+        requiresTokens: string[];
+    }[];
+    /** All tokens in the downstream dependency chain */
+    tokens: string[];
+}
+
+export type { BlockedTask as B, DownstreamResult as D, LiveGraph as L, NodeInfo as N, PendingTask as P, ScheduleResult as S, UnreachableNodesResult as U, LiveGraphHealth as a, LiveGraphSnapshot as b, UnreachableTokensResult as c, UnresolvedDependency as d, UpstreamResult as e };

package/dist/{types-CTu8RqY0.d.cts → types-DAI_a2as.d.cts}

@@ -52,6 +52,17 @@ interface TaskConfig {
     circuit_breaker?: TaskCircuitBreakerConfig;
     /** Description */
     description?: string;
+    /** LLM inference hints — opt-in metadata for AI-assisted completion detection */
+    inference?: {
+        /** Human-readable completion criteria */
+        criteria?: string;
+        /** Keywords to help the LLM understand the domain */
+        keywords?: string[];
+        /** Suggested checks for verification */
+        suggestedChecks?: string[];
+        /** Whether the LLM should attempt to auto-detect completion (default: false) */
+        autoDetectable?: boolean;
+    };
 }
 interface TaskRetryConfig {
     max_attempts: number;

package/dist/{types-CTu8RqY0.d.ts → types-DAI_a2as.d.ts}

@@ -52,6 +52,17 @@ interface TaskConfig {
     circuit_breaker?: TaskCircuitBreakerConfig;
     /** Description */
     description?: string;
+    /** LLM inference hints — opt-in metadata for AI-assisted completion detection */
+    inference?: {
+        /** Human-readable completion criteria */
+        criteria?: string;
+        /** Keywords to help the LLM understand the domain */
+        keywords?: string[];
+        /** Suggested checks for verification */
+        suggestedChecks?: string[];
+        /** Whether the LLM should attempt to auto-detect completion (default: false) */
+        autoDetectable?: boolean;
+    };
 }
 interface TaskRetryConfig {
     max_attempts: number;

package/dist/types-mS_pPftm.d.ts

@@ -0,0 +1,135 @@
+import { G as GraphConfig, c as ExecutionState, T as TaskConfig, l as TaskState } from './types-DAI_a2as.js';
+
+/**
+ * Continuous Event Graph — Types
+ *
+ * A long-lived, evolving event-graph where both config and state
+ * mutate over time. The single `LiveGraph` type bundles them.
+ *
+ * Events are shared with event-graph (task-started, task-completed, etc.).
+ * Graph mutations (addNode, removeNode, etc.) are unique to this mode.
+ */
+
+/**
+ * The single evolving object for a continuous-mode graph.
+ * Bundles config + state so they can't get out of sync.
+ */
+interface LiveGraph {
+    /** The current graph configuration (evolves as nodes are added/removed) */
+    config: GraphConfig;
+    /** The current execution state (evolves as events arrive) */
+    state: ExecutionState;
+}
+interface ScheduleResult {
+    /** Tasks ready to dispatch now — all requires satisfied */
+    eligible: string[];
+    /** Tasks waiting on tokens that some producer will eventually provide (normal) */
+    pending: PendingTask[];
+    /** Tasks waiting on tokens that NO task can produce (caller's problem) */
+    unresolved: UnresolvedDependency[];
+    /** Tasks waiting on tokens whose producer FAILED (caller's problem) */
+    blocked: BlockedTask[];
+    /** Token conflicts: multiple tasks produce the same token */
+    conflicts: Record<string, string[]>;
+}
+interface PendingTask {
+    taskName: string;
+    /** Tokens this task needs that haven't been produced yet but have a viable producer */
+    waitingOn: string[];
+}
+interface UnresolvedDependency {
+    taskName: string;
+    /** Tokens this task needs that no task in the graph can produce */
+    missingTokens: string[];
+}
+interface BlockedTask {
+    taskName: string;
+    /** Tokens this task needs whose only producer has failed */
+    failedTokens: string[];
+    /** The tasks that failed and would have produced those tokens */
+    failedProducers: string[];
+}
+interface LiveGraphHealth {
+    /** Total number of tasks in the graph */
+    totalNodes: number;
+    /** Task counts by status */
+    running: number;
+    completed: number;
+    failed: number;
+    waiting: number;
+    notStarted: number;
+    /** Number of disabled (inactivated) nodes */
+    disabled: number;
+    /** Number of tasks with unresolvable dependencies */
+    unresolvedCount: number;
+    /** Number of tasks whose producer has failed */
+    blockedCount: number;
+    /** Tokens that no task produces (open dependencies) */
+    openDependencies: string[];
+    /** Cycles detected in the current graph (if any) */
+    cycles: string[][];
+    /** Tokens produced by multiple tasks */
+    conflictTokens: string[];
+}
+interface NodeInfo {
+    /** Node name */
+    name: string;
+    /** The task configuration */
+    config: TaskConfig;
+    /** The current runtime state */
+    state: TaskState;
+}
+interface LiveGraphSnapshot {
+    /** Schema version for forward compatibility */
+    version: number;
+    /** The graph config at snapshot time */
+    config: GraphConfig;
+    /** The execution state at snapshot time */
+    state: ExecutionState;
+    /** ISO timestamp of when the snapshot was taken */
+    snapshotAt: string;
+}
+interface UnreachableTokensResult {
+    tokens: {
+        /** The token that cannot be produced */
+        token: string;
+        /** Why it's unreachable */
+        reason: 'no-producer' | 'all-producers-failed' | 'transitive';
+        /** Tasks that could produce it (but are themselves unreachable/failed) */
+        producers: string[];
+    }[];
+}
+interface UnreachableNodesResult {
+    nodes: {
+        /** The node that can never become eligible */
+        nodeName: string;
+        /** Unreachable tokens this node requires (empty if the node itself is failed/disabled) */
+        missingTokens: string[];
+    }[];
+}
+interface UpstreamResult {
+    /** The target node being inspected */
+    nodeName: string;
+    /** All upstream nodes that transitively feed into the target */
+    nodes: {
+        nodeName: string;
+        /** Tokens this node provides that are in the dependency chain */
+        providesTokens: string[];
+    }[];
+    /** All tokens in the upstream dependency chain */
+    tokens: string[];
+}
+interface DownstreamResult {
+    /** The target node being inspected */
+    nodeName: string;
+    /** All downstream nodes that transitively depend on the target */
+    nodes: {
+        nodeName: string;
+        /** Tokens this node requires that are in the dependency chain */
+        requiresTokens: string[];
+    }[];
+    /** All tokens in the downstream dependency chain */
+    tokens: string[];
+}
+
+export type { BlockedTask as B, DownstreamResult as D, LiveGraph as L, NodeInfo as N, PendingTask as P, ScheduleResult as S, UnreachableNodesResult as U, LiveGraphHealth as a, LiveGraphSnapshot as b, UnreachableTokensResult as c, UnresolvedDependency as d, UpstreamResult as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
@@ -58,6 +58,16 @@
       "types": "./dist/continuous-event-graph/index.d.ts",
       "import": "./dist/continuous-event-graph/index.js",
       "require": "./dist/continuous-event-graph/index.cjs"
+    },
+    "./inference": {
+      "types": "./dist/inference/index.d.ts",
+      "import": "./dist/inference/index.js",
+      "require": "./dist/inference/index.cjs"
+    },
+    "./card-compute": {
+      "types": "./dist/card-compute/index.d.ts",
+      "import": "./dist/card-compute/index.js",
+      "require": "./dist/card-compute/index.cjs"
     }
   },
   "browser": {
@@ -65,7 +75,8 @@
   },
   "files": [
     "dist",
-    "schema"
+    "schema",
+    "browser"
   ],
   "scripts": {
     "build": "tsup",