yaml-flow 2.2.0 → 2.4.0

package/dist/types-CTu8RqY0.d.cts

@@ -0,0 +1,187 @@
+/**
+ * Event Graph — Core Types
+ *
+ * Type definitions for the stateless event-graph engine.
+ * Pure: f(state, event) → newState
+ */
+interface GraphConfig {
+    id?: string;
+    settings: GraphSettings;
+    tasks: Record<string, TaskConfig>;
+}
+interface GraphSettings {
+    /** Completion strategy */
+    completion: CompletionStrategy;
+    /** Conflict resolution strategy */
+    conflict_strategy?: ConflictStrategy;
+    /** Execution mode */
+    execution_mode?: ExecutionMode;
+    /** Goal outputs — used with 'goal-reached' completion */
+    goal?: string[];
+    /** Max total scheduler iterations (safety limit, default: 1000) */
+    max_iterations?: number;
+    /** Timeout in ms (declared for drivers, not enforced by pure engine) */
+    timeout_ms?: number;
+}
+interface TaskConfig {
+    /** What this task needs to become eligible */
+    requires?: string[];
+    /** What this task produces on successful completion */
+    provides: string[];
+    /** Conditional provides based on handler result */
+    on?: Record<string, string[]>;
+    /** Tokens to inject into available outputs on failure */
+    on_failure?: string[];
+    /** Task execution method (informational — driver concern) */
+    method?: string;
+    /** Arbitrary task configuration (driver concern) */
+    config?: Record<string, unknown>;
+    /** Task priority (higher = preferred in conflict resolution) */
+    priority?: number;
+    /** Estimated duration in ms (used by duration-first strategy) */
+    estimatedDuration?: number;
+    /** Estimated cost (used by cost-optimized strategy) */
+    estimatedCost?: number;
+    /** Resource requirements (used by resource-aware strategy) */
+    estimatedResources?: Record<string, number>;
+    /** Retry configuration */
+    retry?: TaskRetryConfig;
+    /** Repeatable task configuration */
+    repeatable?: boolean | RepeatableConfig;
+    /** Circuit breaker: max executions before breaking */
+    circuit_breaker?: TaskCircuitBreakerConfig;
+    /** Description */
+    description?: string;
+}
+interface TaskRetryConfig {
+    max_attempts: number;
+    delay_ms?: number;
+    backoff_multiplier?: number;
+}
+interface RepeatableConfig {
+    /** Max times this task can repeat (undefined = unlimited) */
+    max?: number;
+}
+interface TaskCircuitBreakerConfig {
+    /** Max executions before injecting break tokens */
+    max_executions: number;
+    /** Tokens to inject when breaker trips */
+    on_break: string[];
+}
+interface ExecutionState {
+    /** Current status of the execution */
+    status: ExecutionStatus;
+    /** Task states keyed by task name */
+    tasks: Record<string, TaskState>;
+    /** Tokens currently available in the system */
+    availableOutputs: string[];
+    /** Stuck detection result */
+    stuckDetection: StuckDetection;
+    /** Last update timestamp */
+    lastUpdated: string;
+    /** Execution ID for this run */
+    executionId: string | null;
+    /** Execution configuration */
+    executionConfig: ExecutionConfig;
+}
+interface ExecutionConfig {
+    executionMode: ExecutionMode;
+    conflictStrategy: ConflictStrategy;
+    completionStrategy: CompletionStrategy;
+}
+interface TaskState {
+    status: TaskStatus;
+    executionCount: number;
+    retryCount: number;
+    lastEpoch: number;
+    startedAt?: string;
+    completedAt?: string;
+    failedAt?: string;
+    lastUpdated?: string;
+    error?: string;
+    messages?: TaskMessage[];
+    progress?: number | null;
+}
+interface TaskMessage {
+    message: string;
+    timestamp: string;
+    status: string;
+}
+interface StuckDetection {
+    is_stuck: boolean;
+    stuck_description: string | null;
+    outputs_unresolvable: string[];
+    tasks_blocked: string[];
+}
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+interface TaskStartedEvent {
+    type: 'task-started';
+    taskName: string;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskCompletedEvent {
+    type: 'task-completed';
+    taskName: string;
+    /** Handler result key — used for conditional routing via `on` */
+    result?: string;
+    /** Data payload from task execution */
+    data?: Record<string, unknown>;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskFailedEvent {
+    type: 'task-failed';
+    taskName: string;
+    error: string;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskProgressEvent {
+    type: 'task-progress';
+    taskName: string;
+    message?: string;
+    progress?: number;
+    timestamp: string;
+    executionId?: string;
+}
+interface InjectTokensEvent {
+    type: 'inject-tokens';
+    tokens: string[];
+    timestamp: string;
+}
+interface AgentActionEvent {
+    type: 'agent-action';
+    action: 'start' | 'stop' | 'pause' | 'resume';
+    timestamp: string;
+    config?: Partial<ExecutionConfig>;
+}
+interface TaskCreationEvent {
+    type: 'task-creation';
+    taskName: string;
+    taskConfig: TaskConfig;
+    timestamp: string;
+}
+interface SchedulerResult {
+    /** Tasks eligible for execution */
+    eligibleTasks: string[];
+    /** Whether the graph execution is complete */
+    isComplete: boolean;
+    /** Stuck detection result */
+    stuckDetection: StuckDetection;
+    /** Whether conflicts were detected */
+    hasConflicts: boolean;
+    /** Conflict groups: output → competing task names */
+    conflicts: Record<string, string[]>;
+    /** Strategy used for conflict resolution */
+    strategy: ConflictStrategy;
+    /** Processing log for diagnostics */
+    processingLog: string[];
+}
+type TaskStatus = 'not-started' | 'running' | 'completed' | 'failed' | 'inactivated';
+type ExecutionStatus = 'created' | 'running' | 'paused' | 'stopped' | 'completed' | 'failed';
+type CompletionStrategy = 'all-tasks-done' | 'all-outputs-done' | 'only-resolved' | 'goal-reached' | 'manual';
+type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
+type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
+
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RepeatableConfig as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEvent as e, GraphSettings as f, StuckDetection as g, TaskCompletedEvent as h, TaskCreationEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskState as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRetryConfig as q };

package/dist/types-CTu8RqY0.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Event Graph — Core Types
+ *
+ * Type definitions for the stateless event-graph engine.
+ * Pure: f(state, event) → newState
+ */
+interface GraphConfig {
+    id?: string;
+    settings: GraphSettings;
+    tasks: Record<string, TaskConfig>;
+}
+interface GraphSettings {
+    /** Completion strategy */
+    completion: CompletionStrategy;
+    /** Conflict resolution strategy */
+    conflict_strategy?: ConflictStrategy;
+    /** Execution mode */
+    execution_mode?: ExecutionMode;
+    /** Goal outputs — used with 'goal-reached' completion */
+    goal?: string[];
+    /** Max total scheduler iterations (safety limit, default: 1000) */
+    max_iterations?: number;
+    /** Timeout in ms (declared for drivers, not enforced by pure engine) */
+    timeout_ms?: number;
+}
+interface TaskConfig {
+    /** What this task needs to become eligible */
+    requires?: string[];
+    /** What this task produces on successful completion */
+    provides: string[];
+    /** Conditional provides based on handler result */
+    on?: Record<string, string[]>;
+    /** Tokens to inject into available outputs on failure */
+    on_failure?: string[];
+    /** Task execution method (informational — driver concern) */
+    method?: string;
+    /** Arbitrary task configuration (driver concern) */
+    config?: Record<string, unknown>;
+    /** Task priority (higher = preferred in conflict resolution) */
+    priority?: number;
+    /** Estimated duration in ms (used by duration-first strategy) */
+    estimatedDuration?: number;
+    /** Estimated cost (used by cost-optimized strategy) */
+    estimatedCost?: number;
+    /** Resource requirements (used by resource-aware strategy) */
+    estimatedResources?: Record<string, number>;
+    /** Retry configuration */
+    retry?: TaskRetryConfig;
+    /** Repeatable task configuration */
+    repeatable?: boolean | RepeatableConfig;
+    /** Circuit breaker: max executions before breaking */
+    circuit_breaker?: TaskCircuitBreakerConfig;
+    /** Description */
+    description?: string;
+}
+interface TaskRetryConfig {
+    max_attempts: number;
+    delay_ms?: number;
+    backoff_multiplier?: number;
+}
+interface RepeatableConfig {
+    /** Max times this task can repeat (undefined = unlimited) */
+    max?: number;
+}
+interface TaskCircuitBreakerConfig {
+    /** Max executions before injecting break tokens */
+    max_executions: number;
+    /** Tokens to inject when breaker trips */
+    on_break: string[];
+}
+interface ExecutionState {
+    /** Current status of the execution */
+    status: ExecutionStatus;
+    /** Task states keyed by task name */
+    tasks: Record<string, TaskState>;
+    /** Tokens currently available in the system */
+    availableOutputs: string[];
+    /** Stuck detection result */
+    stuckDetection: StuckDetection;
+    /** Last update timestamp */
+    lastUpdated: string;
+    /** Execution ID for this run */
+    executionId: string | null;
+    /** Execution configuration */
+    executionConfig: ExecutionConfig;
+}
+interface ExecutionConfig {
+    executionMode: ExecutionMode;
+    conflictStrategy: ConflictStrategy;
+    completionStrategy: CompletionStrategy;
+}
+interface TaskState {
+    status: TaskStatus;
+    executionCount: number;
+    retryCount: number;
+    lastEpoch: number;
+    startedAt?: string;
+    completedAt?: string;
+    failedAt?: string;
+    lastUpdated?: string;
+    error?: string;
+    messages?: TaskMessage[];
+    progress?: number | null;
+}
+interface TaskMessage {
+    message: string;
+    timestamp: string;
+    status: string;
+}
+interface StuckDetection {
+    is_stuck: boolean;
+    stuck_description: string | null;
+    outputs_unresolvable: string[];
+    tasks_blocked: string[];
+}
+type GraphEvent = TaskStartedEvent | TaskCompletedEvent | TaskFailedEvent | TaskProgressEvent | InjectTokensEvent | AgentActionEvent | TaskCreationEvent;
+interface TaskStartedEvent {
+    type: 'task-started';
+    taskName: string;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskCompletedEvent {
+    type: 'task-completed';
+    taskName: string;
+    /** Handler result key — used for conditional routing via `on` */
+    result?: string;
+    /** Data payload from task execution */
+    data?: Record<string, unknown>;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskFailedEvent {
+    type: 'task-failed';
+    taskName: string;
+    error: string;
+    timestamp: string;
+    executionId?: string;
+}
+interface TaskProgressEvent {
+    type: 'task-progress';
+    taskName: string;
+    message?: string;
+    progress?: number;
+    timestamp: string;
+    executionId?: string;
+}
+interface InjectTokensEvent {
+    type: 'inject-tokens';
+    tokens: string[];
+    timestamp: string;
+}
+interface AgentActionEvent {
+    type: 'agent-action';
+    action: 'start' | 'stop' | 'pause' | 'resume';
+    timestamp: string;
+    config?: Partial<ExecutionConfig>;
+}
+interface TaskCreationEvent {
+    type: 'task-creation';
+    taskName: string;
+    taskConfig: TaskConfig;
+    timestamp: string;
+}
+interface SchedulerResult {
+    /** Tasks eligible for execution */
+    eligibleTasks: string[];
+    /** Whether the graph execution is complete */
+    isComplete: boolean;
+    /** Stuck detection result */
+    stuckDetection: StuckDetection;
+    /** Whether conflicts were detected */
+    hasConflicts: boolean;
+    /** Conflict groups: output → competing task names */
+    conflicts: Record<string, string[]>;
+    /** Strategy used for conflict resolution */
+    strategy: ConflictStrategy;
+    /** Processing log for diagnostics */
+    processingLog: string[];
+}
+type TaskStatus = 'not-started' | 'running' | 'completed' | 'failed' | 'inactivated';
+type ExecutionStatus = 'created' | 'running' | 'paused' | 'stopped' | 'completed' | 'failed';
+type CompletionStrategy = 'all-tasks-done' | 'all-outputs-done' | 'only-resolved' | 'goal-reached' | 'manual';
+type ExecutionMode = 'dependency-mode' | 'eligibility-mode';
+type ConflictStrategy = 'alphabetical' | 'priority-first' | 'duration-first' | 'cost-optimized' | 'resource-aware' | 'random-select' | 'user-choice' | 'parallel-all' | 'skip-conflicts' | 'round-robin';
+
+export type { AgentActionEvent as A, CompletionStrategy as C, ExecutionConfig as E, GraphConfig as G, InjectTokensEvent as I, RepeatableConfig as R, SchedulerResult as S, TaskConfig as T, ConflictStrategy as a, ExecutionMode as b, ExecutionState as c, ExecutionStatus as d, GraphEvent as e, GraphSettings as f, StuckDetection as g, TaskCompletedEvent as h, TaskCreationEvent as i, TaskFailedEvent as j, TaskStartedEvent as k, TaskState as l, TaskStatus as m, TaskCircuitBreakerConfig as n, TaskMessage as o, TaskProgressEvent as p, TaskRetryConfig as q };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaml-flow",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Unified workflow engine: step-machine (sequential) + event-graph (stateless DAG) with pluggable storage",
   "author": "",
   "license": "MIT",
@@ -53,6 +53,11 @@
       "types": "./dist/config/index.d.ts",
       "import": "./dist/config/index.js",
       "require": "./dist/config/index.cjs"
+    },
+    "./continuous-event-graph": {
+      "types": "./dist/continuous-event-graph/index.d.ts",
+      "import": "./dist/continuous-event-graph/index.js",
+      "require": "./dist/continuous-event-graph/index.cjs"
     }
   },
   "browser": {