@uploadista/core 0.0.20-beta.7 → 0.0.20-beta.9

package/dist/{index-DjhpgW08.d.cts → index-DMqaf28W.d.cts}

@@ -3520,6 +3520,534 @@ declare const imageDescriptionOutputSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ImageDescriptionOutput = z.infer<typeof imageDescriptionOutputSchema>;
 //#endregion
+//#region src/flow/types/dead-letter-item.d.ts
+/**
+ * Dead Letter Queue item types and definitions.
+ *
+ * A DeadLetterItem represents a failed flow job that has been captured
+ * for later retry, debugging, or manual intervention.
+ *
+ * @module flow/types/dead-letter-item
+ * @see {@link DeadLetterQueueService} for DLQ operations
+ */
+/**
+ * Status of a Dead Letter Queue item.
+ *
+ * Item lifecycle: pending → retrying → (pending | exhausted | resolved)
+ *
+ * - `pending`: Awaiting retry (either scheduled or manual)
+ * - `retrying`: Currently being retried
+ * - `exhausted`: Max retries reached, requires manual intervention
+ * - `resolved`: Successfully retried or manually resolved
+ */
+type DeadLetterItemStatus = "pending" | "retrying" | "exhausted" | "resolved";
+/**
+ * Error details captured when a flow job fails.
+ *
+ * Contains comprehensive error information for debugging and retry decisions.
+ *
+ * @property code - Error code (e.g., "FLOW_NODE_ERROR", "VALIDATION_ERROR")
+ * @property message - Human-readable error message
+ * @property nodeId - ID of the node that failed (if applicable)
+ * @property stack - Stack trace (included in development mode)
+ */
+interface DeadLetterError {
+  /** Error code for categorization and retry filtering */
+  code: string;
+  /** Human-readable error message */
+  message: string;
+  /** Node that failed (if applicable) */
+  nodeId?: string;
+  /** Stack trace (in dev mode only) */
+  stack?: string;
+}
+/**
+ * Record of a single retry attempt.
+ *
+ * @property attemptedAt - When the retry was attempted
+ * @property error - Error message if the retry failed
+ * @property durationMs - How long the retry took
+ */
+interface DeadLetterRetryAttempt {
+  /** When the retry was attempted */
+  attemptedAt: Date;
+  /** Error message if the retry failed */
+  error: string;
+  /** Duration of the retry attempt in milliseconds */
+  durationMs: number;
+}
+/**
+ * Represents a failed flow job captured in the Dead Letter Queue.
+ *
+ * Contains all information needed to debug, retry, or manually resolve
+ * a failed flow execution.
+ *
+ * @property id - Unique DLQ item identifier
+ * @property jobId - Original flow job ID that failed
+ * @property flowId - Flow definition that was being executed
+ * @property storageId - Target storage for the flow
+ * @property clientId - Client who initiated the job
+ * @property error - Comprehensive error details
+ * @property inputs - Original inputs passed to the flow
+ * @property nodeResults - Partial results from nodes that completed before failure
+ * @property failedAtNodeId - Node where execution failed (if applicable)
+ * @property retryCount - Number of retry attempts made
+ * @property maxRetries - Maximum retries allowed from retry policy
+ * @property nextRetryAt - Scheduled time for next automatic retry
+ * @property retryHistory - History of all retry attempts
+ * @property createdAt - When the item was added to DLQ
+ * @property updatedAt - When the item was last modified
+ * @property expiresAt - TTL for automatic cleanup
+ * @property status - Current status of the DLQ item
+ *
+ * @example
+ * ```typescript
+ * const dlqItem: DeadLetterItem = {
+ *   id: "dlq_abc123",
+ *   jobId: "job_xyz789",
+ *   flowId: "image-resize-pipeline",
+ *   storageId: "s3-production",
+ *   clientId: "client_456",
+ *   error: {
+ *     code: "FLOW_NODE_ERROR",
+ *     message: "External service timeout",
+ *     nodeId: "resize-node"
+ *   },
+ *   inputs: { input: { uploadId: "upload_123" } },
+ *   nodeResults: { "input-node": { file: {...} } },
+ *   failedAtNodeId: "resize-node",
+ *   retryCount: 2,
+ *   maxRetries: 3,
+ *   nextRetryAt: new Date("2024-01-15T10:35:00Z"),
+ *   retryHistory: [
+ *     { attemptedAt: new Date("2024-01-15T10:30:00Z"), error: "Timeout", durationMs: 5000 },
+ *     { attemptedAt: new Date("2024-01-15T10:32:00Z"), error: "Timeout", durationMs: 5000 }
+ *   ],
+ *   createdAt: new Date("2024-01-15T10:30:00Z"),
+ *   updatedAt: new Date("2024-01-15T10:32:00Z"),
+ *   expiresAt: new Date("2024-01-22T10:30:00Z"),
+ *   status: "pending"
+ * };
+ * ```
+ */
+interface DeadLetterItem {
+  /** Unique DLQ item identifier */
+  id: string;
+  /** Original flow job ID that failed */
+  jobId: string;
+  /** Flow definition ID that was being executed */
+  flowId: string;
+  /** Target storage for the flow */
+  storageId: string;
+  /** Client who initiated the job (null for anonymous) */
+  clientId: string | null;
+  /** Comprehensive error details */
+  error: DeadLetterError;
+  /** Original inputs passed to the flow */
+  inputs: Record<string, unknown>;
+  /** Partial results from nodes that completed before failure */
+  nodeResults: Record<string, unknown>;
+  /** Node where execution failed (if applicable) */
+  failedAtNodeId?: string;
+  /** Number of retry attempts made */
+  retryCount: number;
+  /** Maximum retries allowed from retry policy */
+  maxRetries: number;
+  /** Scheduled time for next automatic retry */
+  nextRetryAt?: Date;
+  /** History of all retry attempts */
+  retryHistory: DeadLetterRetryAttempt[];
+  /** When the item was added to DLQ */
+  createdAt: Date;
+  /** When the item was last modified */
+  updatedAt: Date;
+  /** TTL for automatic cleanup */
+  expiresAt?: Date;
+  /** Current status of the DLQ item */
+  status: DeadLetterItemStatus;
+}
+/**
+ * Statistics about the Dead Letter Queue.
+ *
+ * Provides aggregate information for monitoring and alerting.
+ *
+ * @property totalItems - Total number of items in the DLQ
+ * @property byStatus - Count of items by status
+ * @property byFlow - Count of items by flow ID
+ * @property oldestItem - Timestamp of the oldest item
+ * @property averageRetryCount - Average number of retries across all items
+ */
+interface DeadLetterQueueStats {
+  /** Total number of items in the DLQ */
+  totalItems: number;
+  /** Count of items by status */
+  byStatus: Record<DeadLetterItemStatus, number>;
+  /** Count of items by flow ID */
+  byFlow: Record<string, number>;
+  /** Timestamp of the oldest item */
+  oldestItem?: Date;
+  /** Average number of retries across all items */
+  averageRetryCount: number;
+}
+/**
+ * Options for listing DLQ items.
+ *
+ * @property status - Filter by status
+ * @property flowId - Filter by flow ID
+ * @property clientId - Filter by client ID
+ * @property limit - Maximum items to return (default: 50)
+ * @property offset - Number of items to skip (default: 0)
+ */
+interface DeadLetterListOptions {
+  /** Filter by status */
+  status?: DeadLetterItemStatus;
+  /** Filter by flow ID */
+  flowId?: string;
+  /** Filter by client ID */
+  clientId?: string;
+  /** Maximum items to return (default: 50) */
+  limit?: number;
+  /** Number of items to skip for pagination (default: 0) */
+  offset?: number;
+}
+/**
+ * Result of a batch retry operation.
+ *
+ * @property retried - Number of items that were retried
+ * @property succeeded - Number of retries that succeeded
+ * @property failed - Number of retries that failed
+ */
+interface DeadLetterRetryAllResult {
+  /** Number of items that were retried */
+  retried: number;
+  /** Number of retries that succeeded */
+  succeeded: number;
+  /** Number of retries that failed */
+  failed: number;
+}
+/**
+ * Result of a cleanup operation.
+ *
+ * @property deleted - Number of items that were deleted
+ */
+interface DeadLetterCleanupResult {
+  /** Number of items that were deleted */
+  deleted: number;
+}
+/**
+ * Options for cleanup operation.
+ *
+ * @property olderThan - Delete items older than this date
+ * @property status - Only delete items with this status
+ */
+interface DeadLetterCleanupOptions {
+  /** Delete items older than this date */
+  olderThan?: Date;
+  /** Only delete items with this status */
+  status?: "exhausted" | "resolved";
+}
+/**
+ * Result of processing scheduled retries.
+ *
+ * @property processed - Total items processed
+ * @property succeeded - Number that succeeded
+ * @property failed - Number that failed
+ */
+interface DeadLetterProcessResult {
+  /** Total items processed */
+  processed: number;
+  /** Number of successful retries */
+  succeeded: number;
+  /** Number of failed retries */
+  failed: number;
+}
+//#endregion
+//#region src/flow/types/flow-job.d.ts
+/**
+ * Status of an individual node within a flow job.
+ *
+ * Node tasks follow this lifecycle:
+ * started → pending → running → (completed | paused | failed)
+ */
+type FlowJobTaskStatus = "started" | "pending" | "running" | "completed" | "paused" | "failed";
+/**
+ * Represents a single node's execution within a flow job.
+ *
+ * Tasks track individual node execution, storing results, errors, and retry information.
+ * They allow monitoring of which nodes have completed and accessing intermediate results.
+ *
+ * @property nodeId - Unique identifier of the node this task represents
+ * @property status - Current execution status of the node
+ * @property result - Node execution result data (can be partial data if paused, or complete data if finished)
+ * @property error - Error message if the node failed
+ * @property retryCount - Number of retry attempts made before success or final failure
+ * @property createdAt - When the task was created
+ * @property updatedAt - When the task was last updated
+ *
+ * @remarks
+ * The result field can contain:
+ * - Partial/intermediate data when status is "paused" (unknown type)
+ * - Complete data when status is "completed" (could be TypedOutput for output nodes)
+ * - undefined when status is "pending", "running", "started", or "failed"
+ *
+ * For type-safe access to final outputs, use FlowJob.result instead, which contains
+ * the array of TypedOutput from all output nodes.
+ */
+type FlowJobTask = {
+  nodeId: string;
+  status: FlowJobTaskStatus;
+  result?: unknown;
+  error?: string;
+  retryCount?: number;
+  createdAt: Date;
+  updatedAt: Date;
+};
+/**
+ * Represents a flow execution job with full state tracking.
+ *
+ * Jobs are created when a flow is executed and track the entire execution lifecycle.
+ * They store node results, handle paused states, and manage cleanup of intermediate files.
+ *
+ * @property id - Unique job identifier (UUID)
+ * @property flowId - The flow being executed
+ * @property storageId - Storage location for file outputs
+ * @property clientId - Client that initiated the job (for authorization)
+ * @property status - Overall job status
+ * @property createdAt - When the job was created
+ * @property updatedAt - When the job was last updated
+ * @property tasks - Array of node execution tasks
+ * @property error - Error message if the job failed
+ * @property endedAt - When the job completed or failed
+ * @property result - Array of typed outputs from all output nodes (only set when completed)
+ * @property pausedAt - Node ID where execution is paused (if applicable)
+ * @property executionState - State needed to resume a paused flow
+ * @property intermediateFiles - File IDs to cleanup after completion
+ *
+ * @remarks
+ * - Jobs can be paused at nodes that return `{ type: "waiting" }`
+ * - Paused jobs store execution state and can be resumed with new data
+ * - Intermediate files from non-output nodes are automatically cleaned up
+ * - Tasks are updated as nodes progress through their lifecycle
+ * - The result field now contains an array of TypedOutput for all output nodes
+ *
+ * @example
+ * ```typescript
+ * // Create and monitor a job
+ * const job = yield* flowServer.runFlow({
+ *   flowId: "image-pipeline",
+ *   storageId: "storage-1",
+ *   inputs: { input: myFile }
+ * });
+ *
+ * // Poll for status
+ * const status = yield* flowServer.getJobStatus(job.id);
+ * if (status.status === "completed") {
+ *   // Access typed outputs
+ *   console.log("Outputs:", status.result);
+ *   for (const output of status.result || []) {
+ *     console.log(`${output.nodeId} (${output.nodeType}):`, output.data);
+ *   }
+ * } else if (status.status === "paused") {
+ *   // Resume with additional data
+ *   yield* flowServer.resumeFlow({
+ *     jobId: job.id,
+ *     nodeId: status.pausedAt,
+ *     newData: additionalChunk
+ *   });
+ * }
+ * ```
+ */
+/**
+ * Trace context for distributed tracing.
+ * Allows flow operations to be linked under a single trace.
+ */
+type FlowJobTraceContext = {
+  /** 128-bit trace identifier (32 hex characters) */
+  traceId: string;
+  /** 64-bit span identifier (16 hex characters) */
+  spanId: string;
+  /** Trace flags (1 = sampled) */
+  traceFlags: number;
+};
+type FlowJob = {
+  id: string;
+  flowId: string;
+  storageId: string;
+  clientId: string | null;
+  status: FlowJobStatus;
+  createdAt: Date;
+  updatedAt: Date;
+  tasks: FlowJobTask[];
+  error?: string;
+  endedAt?: Date;
+  result?: TypedOutput[];
+  pausedAt?: string;
+  executionState?: {
+    executionOrder: string[];
+    currentIndex: number;
+    inputs: Record<string, unknown>;
+  };
+  intermediateFiles?: string[];
+  /**
+   * OpenTelemetry trace context for distributed tracing.
+   * When set, all flow operations (node executions, uploads) will be
+   * linked as children of this trace context. Enables end-to-end tracing
+   * of flow executions in observability tools like Grafana Tempo.
+   */
+  traceContext?: FlowJobTraceContext;
+};
+/**
+ * Overall status of a flow job.
+ *
+ * Job lifecycle: started → running → (completed | failed | cancelled)
+ * Or with pauses: started → running → paused → running → (completed | failed | cancelled)
+ * User actions: running → paused (via pauseFlow) or running → cancelled (via cancelFlow)
+ */
+type FlowJobStatus = "pending" | "running" | "completed" | "failed" | "started" | "paused" | "cancelled";
+//#endregion
+//#region src/flow/dead-letter-queue.d.ts
+/**
+ * Shape of the Dead Letter Queue service.
+ *
+ * Provides all operations for managing failed flow jobs including
+ * adding items, querying, retrying, and cleanup.
+ */
+interface DeadLetterQueueServiceShape {
+  /**
+   * Add a failed job to the DLQ with full failure context.
+   *
+   * @param job - The failed flow job
+   * @param error - The error that caused the failure
+   * @param retryPolicy - Optional retry policy (uses default if not provided)
+   * @returns The created DLQ item
+   */
+  add(job: FlowJob, error: UploadistaError, retryPolicy?: RetryPolicy): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Get a specific DLQ item by ID.
+   *
+   * @param itemId - The DLQ item ID
+   * @returns The DLQ item
+   */
+  get(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Get a DLQ item by ID, returning None if not found.
+   *
+   * @param itemId - The DLQ item ID
+   * @returns Option of the DLQ item
+   */
+  getOption(itemId: string): Effect.Effect<Option.Option<DeadLetterItem>, UploadistaError>;
+  /**
+   * Delete a DLQ item.
+   *
+   * @param itemId - The DLQ item ID to delete
+   */
+  delete(itemId: string): Effect.Effect<void, UploadistaError>;
+  /**
+   * List DLQ items with optional filtering and pagination.
+   *
+   * @param options - Filter and pagination options
+   * @returns List of items and total count
+   */
+  list(options?: DeadLetterListOptions): Effect.Effect<{
+    items: DeadLetterItem[];
+    total: number;
+  }, UploadistaError>;
+  /**
+   * Update a DLQ item.
+   *
+   * @param itemId - The DLQ item ID
+   * @param updates - Partial updates to apply
+   * @returns The updated item
+   */
+  update(itemId: string, updates: Partial<DeadLetterItem>): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Mark a DLQ item as being retried.
+   *
+   * @param itemId - The DLQ item ID
+   * @returns The updated item with status "retrying"
+   */
+  markRetrying(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Record a failed retry attempt.
+   *
+   * @param itemId - The DLQ item ID
+   * @param error - Error message from the failed retry
+   * @param durationMs - Duration of the retry attempt
+   * @returns The updated item
+   */
+  recordRetryFailure(itemId: string, error: string, durationMs: number): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Mark a DLQ item as resolved (successfully retried or manually resolved).
+   *
+   * @param itemId - The DLQ item ID
+   * @returns The updated item with status "resolved"
+   */
+  markResolved(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
+  /**
+   * Get items that are due for scheduled retry.
+   *
+   * @param limit - Maximum number of items to return
+   * @returns List of items ready for retry
+   */
+  getScheduledRetries(limit?: number): Effect.Effect<DeadLetterItem[], UploadistaError>;
+  /**
+   * Cleanup old DLQ items based on options.
+   *
+   * @param options - Cleanup criteria
+   * @returns Number of items deleted
+   */
+  cleanup(options?: DeadLetterCleanupOptions): Effect.Effect<DeadLetterCleanupResult, UploadistaError>;
+  /**
+   * Get DLQ statistics.
+   *
+   * @returns Aggregate statistics about the DLQ
+   */
+  getStats(): Effect.Effect<DeadLetterQueueStats, UploadistaError>;
+}
+declare const DeadLetterQueueService_base: Context.TagClass<DeadLetterQueueService, "DeadLetterQueueService", DeadLetterQueueServiceShape>;
+/**
+ * Effect-TS context tag for the Dead Letter Queue service.
+ *
+ * @example
+ * ```typescript
+ * const effect = Effect.gen(function* () {
+ *   const dlq = yield* DeadLetterQueueService;
+ *   const stats = yield* dlq.getStats();
+ *   console.log(`DLQ has ${stats.totalItems} items`);
+ * });
+ * ```
+ */
+declare class DeadLetterQueueService extends DeadLetterQueueService_base {
+  /**
+   * Access the DLQ service optionally (for integration in FlowServer).
+   * Returns Option.none if the service is not provided.
+   */
+  static optional: Effect.Effect<Option.Option<DeadLetterQueueServiceShape>, never, never>;
+}
+/**
+ * Creates the Dead Letter Queue service implementation.
+ *
+ * @returns Effect that creates the DLQ service
+ */
+declare function createDeadLetterQueueService(): Effect.Effect<DeadLetterQueueServiceShape, never, DeadLetterQueueKVStore>;
+/**
+ * Effect Layer that creates the DeadLetterQueueService.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const dlq = yield* DeadLetterQueueService;
+ *   const stats = yield* dlq.getStats();
+ *   return stats;
+ * }).pipe(
+ *   Effect.provide(deadLetterQueueService),
+ *   Effect.provide(deadLetterQueueKvStore),
+ *   Effect.provide(baseStoreLayer)
+ * );
+ * ```
+ */
+declare const deadLetterQueueService: Layer.Layer<DeadLetterQueueService, never, DeadLetterQueueKVStore>;
+//#endregion
 //#region src/types/event-broadcaster.d.ts
 /**
  * Event broadcaster interface for pub/sub messaging across distributed instances.
@@ -4496,9 +5024,9 @@ declare const detectMimeType: (buffer: Uint8Array, filename?: string) => string;
  */
 declare function compareMimeTypes(declared: string, detected: string): boolean;
 //#endregion
-//#region src/upload/upload-server.d.ts
+//#region src/upload/upload-engine.d.ts
 /**
- * Legacy configuration options for UploadServer.
+ * Legacy configuration options for UploadEngine.
  *
  * @deprecated Use Effect Layers instead of this configuration object.
  * This type is kept for backward compatibility.
@@ -4510,7 +5038,7 @@ declare function compareMimeTypes(declared: string, detected: string): boolean;
  * @property middlewares - Optional request middlewares
  * @property withTracing - Enable Effect tracing for debugging
  */
-type UploadServerOptions = {
+type UploadEngineOptions = {
   dataStore: ((storageId: string) => Promise<DataStore<UploadFile>>) | DataStore<UploadFile>;
   kvStore: KvStore<UploadFile>;
   eventEmitter: EventEmitter<UploadEvent>;
@@ -4519,7 +5047,7 @@ type UploadServerOptions = {
   withTracing?: boolean;
 };
 /**
- * UploadServer service interface.
+ * UploadEngine service interface.
  *
  * This is the core upload handling service that provides all file upload operations.
  * It manages upload lifecycle, resumable uploads, progress tracking, and storage integration.
@@ -4541,7 +5069,7 @@ type UploadServerOptions = {
  * ```typescript
  * // Basic upload flow
  * const program = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *
  *   // 1. Create upload
  *   const inputFile: InputFile = {
@@ -4564,7 +5092,7 @@ type UploadServerOptions = {
  *
  * // Upload with WebSocket progress tracking
  * const uploadWithProgress = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *
  *   // Subscribe to progress events
  *   yield* server.subscribeToUploadEvents(uploadId, websocket);
@@ -4580,7 +5108,7 @@ type UploadServerOptions = {
  *
  * // Upload from URL
  * const urlUpload = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *
  *   const inputFile: InputFile = {
  *     storageId: "s3-production",
@@ -4599,7 +5127,7 @@ type UploadServerOptions = {
  * });
  * ```
  */
-type UploadServerShape = {
+type UploadEngineShape = {
   createUpload: (inputFile: InputFile, clientId: string | null) => Effect.Effect<UploadFile, UploadistaError>;
   uploadChunk: (uploadId: string, clientId: string | null, chunk: ReadableStream) => Effect.Effect<UploadFile, UploadistaError>;
   getCapabilities: (storageId: string, clientId: string | null) => Effect.Effect<DataStoreCapabilities, UploadistaError>;
@@ -4622,7 +5150,7 @@ type UploadServerShape = {
    *
    * @example
    * ```typescript
-   * const server = yield* UploadServer;
+   * const server = yield* UploadEngine;
    * const stream = yield* server.readStream(uploadId, clientId, { chunkSize: 65536 });
    * // Process stream chunk by chunk with bounded memory
    * yield* Stream.runForEach(stream, (chunk) => processChunk(chunk));
@@ -4644,7 +5172,7 @@ type UploadServerShape = {
    *
    * @example
    * ```typescript
-   * const server = yield* UploadServer;
+   * const server = yield* UploadEngine;
    * const result = yield* server.uploadStream(
    *   {
    *     storageId: "s3-production",
@@ -4666,38 +5194,38 @@ type UploadServerShape = {
   subscribeToUploadEvents: (uploadId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError>;
   unsubscribeFromUploadEvents: (uploadId: string) => Effect.Effect<void, UploadistaError>;
 };
-declare const UploadServer_base: Context.TagClass<UploadServer, "UploadServer", UploadServerShape>;
+declare const UploadEngine_base: Context.TagClass<UploadEngine, "UploadEngine", UploadEngineShape>;
 /**
- * Effect-TS context tag for the UploadServer service.
+ * Effect-TS context tag for the UploadEngine service.
  *
- * Use this tag to access the UploadServer in an Effect context.
+ * Use this tag to access the UploadEngine in an Effect context.
  * The server must be provided via a Layer or dependency injection.
  *
  * @example
  * ```typescript
- * // Access UploadServer in an Effect
+ * // Access UploadEngine in an Effect
  * const uploadEffect = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *   const upload = yield* server.createUpload(inputFile, clientId);
  *   return upload;
  * });
  *
- * // Provide UploadServer layer
+ * // Provide UploadEngine layer
  * const program = uploadEffect.pipe(
- *   Effect.provide(uploadServer),
+ *   Effect.provide(uploadEngine),
  *   Effect.provide(uploadFileKvStore),
  *   Effect.provide(dataStoreLayer),
  *   Effect.provide(eventEmitterLayer)
  * );
  * ```
  */
-declare class UploadServer extends UploadServer_base {}
+declare class UploadEngine extends UploadEngine_base {}
 /**
- * Creates the UploadServer implementation.
+ * Creates the UploadEngine implementation.
  *
- * This function constructs the UploadServer service by composing all required
+ * This function constructs the UploadEngine service by composing all required
  * dependencies (KV store, data stores, event emitter, ID generator). It implements
- * all upload operations defined in UploadServerShape.
+ * all upload operations defined in UploadEngineShape.
  *
  * The server automatically handles:
  * - Upload lifecycle management (create, resume, complete)
@@ -4705,24 +5233,24 @@ declare class UploadServer extends UploadServer_base {}
  * - Storage backend routing based on storageId
  * - Error handling with proper UploadistaError types
  *
- * @returns An Effect that yields the UploadServerShape implementation
+ * @returns An Effect that yields the UploadEngineShape implementation
  *
  * @example
  * ```typescript
- * // Create a custom UploadServer layer
- * const myUploadServer = Layer.effect(
- *   UploadServer,
- *   createUploadServer()
+ * // Create a custom UploadEngine layer
+ * const myUploadEngine = Layer.effect(
+ *   UploadEngine,
+ *   createUploadEngine()
  * );
  *
  * // Use in a program
  * const program = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *   // Use server operations...
- * }).pipe(Effect.provide(myUploadServer));
+ * }).pipe(Effect.provide(myUploadEngine));
  * ```
  */
-declare function createUploadServer(): Effect.Effect<{
+declare function createUploadEngine(): Effect.Effect<{
   upload: (inputFile: InputFile, clientId: string | null, stream: ReadableStream) => Effect.Effect<UploadFile, UploadistaError, never>;
   uploadFromUrl: (inputFile: InputFile, clientId: string | null, url: string) => Effect.Effect<UploadFile, UploadistaError, never>;
   createUpload: (inputFile: InputFile, clientId: string | null) => Effect.Effect<UploadFile, UploadistaError, never>;
@@ -4740,9 +5268,9 @@ declare function createUploadServer(): Effect.Effect<{
   unsubscribeFromUploadEvents: (uploadId: string) => Effect.Effect<void, UploadistaError, never>;
 }, never, GenerateId | UploadFileDataStores | UploadFileKVStore | UploadEventEmitter>;
 /**
- * Pre-built UploadServer Effect Layer.
+ * Pre-built UploadEngine Effect Layer.
  *
- * This layer provides a ready-to-use UploadServer implementation that can be
+ * This layer provides a ready-to-use UploadEngine implementation that can be
  * composed with other layers to build a complete upload system.
  *
  * Required dependencies:
@@ -4755,7 +5283,7 @@ declare function createUploadServer(): Effect.Effect<{
  * ```typescript
  * // Compose a complete upload system
  * const fullUploadSystem = Layer.mergeAll(
- *   uploadServer,
+ *   uploadEngine,
  *   uploadFileKvStore,
  *   dataStoreLayer,
  *   uploadEventEmitter,
@@ -4764,12 +5292,12 @@ declare function createUploadServer(): Effect.Effect<{
  *
  * // Use in application
  * const app = Effect.gen(function* () {
- *   const server = yield* UploadServer;
+ *   const server = yield* UploadEngine;
  *   // Perform uploads...
  * }).pipe(Effect.provide(fullUploadSystem));
  * ```
  */
-declare const uploadServer: Layer.Layer<UploadServer, never, GenerateId | UploadFileDataStores | UploadFileKVStore | UploadEventEmitter>;
+declare const uploadEngine: Layer.Layer<UploadEngine, never, GenerateId | UploadFileDataStores | UploadFileKVStore | UploadEventEmitter>;
 //#endregion
 //#region src/upload/upload-strategy-negotiator.d.ts
 /**
@@ -4796,273 +5324,130 @@ type UploadStrategyOptions = {
  * @property parallelUploads - The negotiated number of parallel uploads
  * @property reasoning - Array of reasoning strings explaining the decisions
  * @property warnings - Array of warning messages about adjustments made
- */
-type NegotiatedStrategy = {
-  strategy: UploadStrategy;
-  chunkSize: number;
-  parallelUploads: number;
-  reasoning: string[];
-  warnings: string[];
-};
-/**
- * Negotiates the optimal upload strategy based on data store capabilities and file characteristics.
- *
- * This class analyzes data store capabilities, file size, and user preferences to determine
- * the best upload strategy (single, parallel, resumable) and optimal parameters like chunk size
- * and parallel connection count.
- *
- * The negotiator considers:
- * - Data store capabilities (parallel uploads, resumable uploads, concatenation)
- * - File size and chunk size constraints
- * - User preferences and requirements
- * - Performance optimization opportunities
- *
- * @example
- * ```typescript
- * // Create negotiator for S3 data store
- * const negotiator = new UploadStrategyNegotiator(
- *   s3Capabilities,
- *   (strategy) => s3Capabilities.supportsStrategy(strategy)
- * );
- *
- * // Negotiate strategy for large file
- * const result = negotiator.negotiateStrategy({
- *   fileSize: 100_000_000, // 100MB
- *   preferredStrategy: "parallel",
- *   preferredChunkSize: 5_000_000, // 5MB chunks
- *   parallelUploads: 4
- * });
- *
- * console.log(result.strategy); // "parallel"
- * console.log(result.chunkSize); // 5_000_000
- * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
- * ```
- */
-declare class UploadStrategyNegotiator {
-  private capabilities;
-  private validateUploadStrategy;
-  /**
-   * Creates a new upload strategy negotiator.
-   *
-   * @param capabilities - Data store capabilities and constraints
-   * @param validateUploadStrategy - Function to validate if a strategy is supported
-   */
-  constructor(capabilities: DataStoreCapabilities, validateUploadStrategy: (strategy: UploadStrategy) => boolean);
-  /**
-   * Negotiates the optimal upload strategy based on options and data store capabilities.
-   *
-   * This method analyzes the provided options and data store capabilities to determine
-   * the best upload strategy, chunk size, and parallel upload settings. It considers
-   * user preferences, file size, and data store constraints to make optimal decisions.
-   *
-   * The negotiation process:
-   * 1. Validates preferred strategy against data store capabilities
-   * 2. Automatically selects strategy based on file size and capabilities
-   * 3. Adjusts chunk size to fit within data store constraints
-   * 4. Validates parallel upload settings
-   * 5. Ensures final strategy is supported by the data store
-   *
-   * @param options - Upload strategy options including file size and preferences
-   * @returns Negotiated strategy with reasoning and warnings
-   *
-   * @example
-   * ```typescript
-   * const result = negotiator.negotiateStrategy({
-   *   fileSize: 50_000_000, // 50MB
-   *   preferredStrategy: "parallel",
-   *   preferredChunkSize: 5_000_000, // 5MB
-   *   parallelUploads: 3
-   * });
-   *
-   * console.log(result.strategy); // "parallel"
-   * console.log(result.chunkSize); // 5_000_000
-   * console.log(result.parallelUploads); // 3
-   * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
-   * console.log(result.warnings); // [] (no warnings)
-   * ```
-   */
-  negotiateStrategy(options: UploadStrategyOptions): NegotiatedStrategy;
-  /**
-   * Gets the data store capabilities used by this negotiator.
-   *
-   * @returns The data store capabilities and constraints
-   */
-  getDataStoreCapabilities(): DataStoreCapabilities;
-  /**
-   * Validates upload strategy configuration against data store capabilities.
-   *
-   * This method checks if the provided configuration is valid for the current
-   * data store capabilities without performing the actual negotiation. It's
-   * useful for pre-validation before attempting to negotiate a strategy.
-   *
-   * @param options - Upload strategy options to validate
-   * @returns Validation result with validity flag and error messages
-   *
-   * @example
-   * ```typescript
-   * const validation = negotiator.validateConfiguration({
-   *   fileSize: 10_000_000,
-   *   preferredStrategy: "parallel",
-   *   preferredChunkSize: 1_000_000,
-   *   parallelUploads: 5
-   * });
-   *
-   * if (!validation.valid) {
-   *   console.log("Configuration errors:", validation.errors);
-   *   // Handle validation errors
-   * }
-   * ```
-   */
-  validateConfiguration(options: UploadStrategyOptions): {
-    valid: boolean;
-    errors: string[];
-  };
-}
-//#endregion
-//#region src/flow/types/flow-job.d.ts
-/**
- * Status of an individual node within a flow job.
- *
- * Node tasks follow this lifecycle:
- * started → pending → running → (completed | paused | failed)
- */
-type FlowJobTaskStatus = "started" | "pending" | "running" | "completed" | "paused" | "failed";
-/**
- * Represents a single node's execution within a flow job.
- *
- * Tasks track individual node execution, storing results, errors, and retry information.
- * They allow monitoring of which nodes have completed and accessing intermediate results.
- *
- * @property nodeId - Unique identifier of the node this task represents
- * @property status - Current execution status of the node
- * @property result - Node execution result data (can be partial data if paused, or complete data if finished)
- * @property error - Error message if the node failed
- * @property retryCount - Number of retry attempts made before success or final failure
- * @property createdAt - When the task was created
- * @property updatedAt - When the task was last updated
- *
- * @remarks
- * The result field can contain:
- * - Partial/intermediate data when status is "paused" (unknown type)
- * - Complete data when status is "completed" (could be TypedOutput for output nodes)
- * - undefined when status is "pending", "running", "started", or "failed"
- *
- * For type-safe access to final outputs, use FlowJob.result instead, which contains
- * the array of TypedOutput from all output nodes.
- */
-type FlowJobTask = {
-  nodeId: string;
-  status: FlowJobTaskStatus;
-  result?: unknown;
-  error?: string;
-  retryCount?: number;
-  createdAt: Date;
-  updatedAt: Date;
-};
-/**
- * Represents a flow execution job with full state tracking.
- *
- * Jobs are created when a flow is executed and track the entire execution lifecycle.
- * They store node results, handle paused states, and manage cleanup of intermediate files.
- *
- * @property id - Unique job identifier (UUID)
- * @property flowId - The flow being executed
- * @property storageId - Storage location for file outputs
- * @property clientId - Client that initiated the job (for authorization)
- * @property status - Overall job status
- * @property createdAt - When the job was created
- * @property updatedAt - When the job was last updated
- * @property tasks - Array of node execution tasks
- * @property error - Error message if the job failed
- * @property endedAt - When the job completed or failed
- * @property result - Array of typed outputs from all output nodes (only set when completed)
- * @property pausedAt - Node ID where execution is paused (if applicable)
- * @property executionState - State needed to resume a paused flow
- * @property intermediateFiles - File IDs to cleanup after completion
- *
- * @remarks
- * - Jobs can be paused at nodes that return `{ type: "waiting" }`
- * - Paused jobs store execution state and can be resumed with new data
- * - Intermediate files from non-output nodes are automatically cleaned up
- * - Tasks are updated as nodes progress through their lifecycle
- * - The result field now contains an array of TypedOutput for all output nodes
- *
- * @example
- * ```typescript
- * // Create and monitor a job
- * const job = yield* flowServer.runFlow({
- *   flowId: "image-pipeline",
- *   storageId: "storage-1",
- *   inputs: { input: myFile }
- * });
- *
- * // Poll for status
- * const status = yield* flowServer.getJobStatus(job.id);
- * if (status.status === "completed") {
- *   // Access typed outputs
- *   console.log("Outputs:", status.result);
- *   for (const output of status.result || []) {
- *     console.log(`${output.nodeId} (${output.nodeType}):`, output.data);
- *   }
- * } else if (status.status === "paused") {
- *   // Resume with additional data
- *   yield* flowServer.resumeFlow({
- *     jobId: job.id,
- *     nodeId: status.pausedAt,
- *     newData: additionalChunk
- *   });
- * }
- * ```
- */
-/**
- * Trace context for distributed tracing.
- * Allows flow operations to be linked under a single trace.
- */
-type FlowJobTraceContext = {
-  /** 128-bit trace identifier (32 hex characters) */
-  traceId: string;
-  /** 64-bit span identifier (16 hex characters) */
-  spanId: string;
-  /** Trace flags (1 = sampled) */
-  traceFlags: number;
-};
-type FlowJob = {
-  id: string;
-  flowId: string;
-  storageId: string;
-  clientId: string | null;
-  status: FlowJobStatus;
-  createdAt: Date;
-  updatedAt: Date;
-  tasks: FlowJobTask[];
-  error?: string;
-  endedAt?: Date;
-  result?: TypedOutput[];
-  pausedAt?: string;
-  executionState?: {
-    executionOrder: string[];
-    currentIndex: number;
-    inputs: Record<string, unknown>;
-  };
-  intermediateFiles?: string[];
-  /**
-   * OpenTelemetry trace context for distributed tracing.
-   * When set, all flow operations (node executions, uploads) will be
-   * linked as children of this trace context. Enables end-to-end tracing
-   * of flow executions in observability tools like Grafana Tempo.
-   */
-  traceContext?: FlowJobTraceContext;
+ */
+type NegotiatedStrategy = {
+  strategy: UploadStrategy;
+  chunkSize: number;
+  parallelUploads: number;
+  reasoning: string[];
+  warnings: string[];
 };
 /**
- * Overall status of a flow job.
+ * Negotiates the optimal upload strategy based on data store capabilities and file characteristics.
  *
- * Job lifecycle: started → running → (completed | failed | cancelled)
- * Or with pauses: started → running → paused → running → (completed | failed | cancelled)
- * User actions: running → paused (via pauseFlow) or running → cancelled (via cancelFlow)
+ * This class analyzes data store capabilities, file size, and user preferences to determine
+ * the best upload strategy (single, parallel, resumable) and optimal parameters like chunk size
+ * and parallel connection count.
+ *
+ * The negotiator considers:
+ * - Data store capabilities (parallel uploads, resumable uploads, concatenation)
+ * - File size and chunk size constraints
+ * - User preferences and requirements
+ * - Performance optimization opportunities
+ *
+ * @example
+ * ```typescript
+ * // Create negotiator for S3 data store
+ * const negotiator = new UploadStrategyNegotiator(
+ *   s3Capabilities,
+ *   (strategy) => s3Capabilities.supportsStrategy(strategy)
+ * );
+ *
+ * // Negotiate strategy for large file
+ * const result = negotiator.negotiateStrategy({
+ *   fileSize: 100_000_000, // 100MB
+ *   preferredStrategy: "parallel",
+ *   preferredChunkSize: 5_000_000, // 5MB chunks
+ *   parallelUploads: 4
+ * });
+ *
+ * console.log(result.strategy); // "parallel"
+ * console.log(result.chunkSize); // 5_000_000
+ * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
+ * ```
  */
-type FlowJobStatus = "pending" | "running" | "completed" | "failed" | "started" | "paused" | "cancelled";
+declare class UploadStrategyNegotiator {
+  private capabilities;
+  private validateUploadStrategy;
+  /**
+   * Creates a new upload strategy negotiator.
+   *
+   * @param capabilities - Data store capabilities and constraints
+   * @param validateUploadStrategy - Function to validate if a strategy is supported
+   */
+  constructor(capabilities: DataStoreCapabilities, validateUploadStrategy: (strategy: UploadStrategy) => boolean);
+  /**
+   * Negotiates the optimal upload strategy based on options and data store capabilities.
+   *
+   * This method analyzes the provided options and data store capabilities to determine
+   * the best upload strategy, chunk size, and parallel upload settings. It considers
+   * user preferences, file size, and data store constraints to make optimal decisions.
+   *
+   * The negotiation process:
+   * 1. Validates preferred strategy against data store capabilities
+   * 2. Automatically selects strategy based on file size and capabilities
+   * 3. Adjusts chunk size to fit within data store constraints
+   * 4. Validates parallel upload settings
+   * 5. Ensures final strategy is supported by the data store
+   *
+   * @param options - Upload strategy options including file size and preferences
+   * @returns Negotiated strategy with reasoning and warnings
+   *
+   * @example
+   * ```typescript
+   * const result = negotiator.negotiateStrategy({
+   *   fileSize: 50_000_000, // 50MB
+   *   preferredStrategy: "parallel",
+   *   preferredChunkSize: 5_000_000, // 5MB
+   *   parallelUploads: 3
+   * });
+   *
+   * console.log(result.strategy); // "parallel"
+   * console.log(result.chunkSize); // 5_000_000
+   * console.log(result.parallelUploads); // 3
+   * console.log(result.reasoning); // ["Using preferred strategy: parallel", ...]
+   * console.log(result.warnings); // [] (no warnings)
+   * ```
+   */
+  negotiateStrategy(options: UploadStrategyOptions): NegotiatedStrategy;
+  /**
+   * Gets the data store capabilities used by this negotiator.
+   *
+   * @returns The data store capabilities and constraints
+   */
+  getDataStoreCapabilities(): DataStoreCapabilities;
+  /**
+   * Validates upload strategy configuration against data store capabilities.
+   *
+   * This method checks if the provided configuration is valid for the current
+   * data store capabilities without performing the actual negotiation. It's
+   * useful for pre-validation before attempting to negotiate a strategy.
+   *
+   * @param options - Upload strategy options to validate
+   * @returns Validation result with validity flag and error messages
+   *
+   * @example
+   * ```typescript
+   * const validation = negotiator.validateConfiguration({
+   *   fileSize: 10_000_000,
+   *   preferredStrategy: "parallel",
+   *   preferredChunkSize: 1_000_000,
+   *   parallelUploads: 5
+   * });
+   *
+   * if (!validation.valid) {
+   *   console.log("Configuration errors:", validation.errors);
+   *   // Handle validation errors
+   * }
+   * ```
+   */
+  validateConfiguration(options: UploadStrategyOptions): {
+    valid: boolean;
+    errors: string[];
+  };
+}
 //#endregion
-//#region src/flow/flow-server.d.ts
+//#region src/flow/flow-engine.d.ts
 /**
  * WaitUntil callback type for keeping background tasks alive.
  * Used in serverless environments like Cloudflare Workers to prevent
@@ -5095,7 +5480,7 @@ declare class FlowWaitUntil extends FlowWaitUntil_base {
 /**
  * Flow provider interface that applications must implement.
  *
- * This interface defines how the FlowServer retrieves flow definitions.
+ * This interface defines how the FlowEngine retrieves flow definitions.
  * Applications provide their own implementation to load flows from a database,
  * configuration files, or any other source.
  *
@@ -5123,7 +5508,7 @@ declare class FlowWaitUntil extends FlowWaitUntil_base {
  *   })
  * };
  *
- * // Provide to FlowServer
+ * // Provide to FlowEngine
  * const flowProviderLayer = Layer.succeed(FlowProvider, dbFlowProvider);
  * ```
  */
@@ -5135,7 +5520,7 @@ declare const FlowProvider_base: Context.TagClass<FlowProvider, "FlowProvider",
  * Effect-TS context tag for the FlowProvider service.
  *
  * Applications must provide an implementation of FlowProviderShape
- * to enable the FlowServer to retrieve flow definitions.
+ * to enable the FlowEngine to retrieve flow definitions.
  *
  * @example
  * ```typescript
@@ -5171,7 +5556,7 @@ declare class FlowProvider extends FlowProvider_base {}
  * ```typescript
  * // Execute a flow
  * const program = Effect.gen(function* () {
- *   const server = yield* FlowServer;
+ *   const server = yield* FlowEngine;
  *
  *   // Start flow execution (returns immediately)
  *   const job = yield* server.runFlow({
@@ -5198,7 +5583,7 @@ declare class FlowProvider extends FlowProvider_base {}
  *
  * // Resume a paused flow
  * const resume = Effect.gen(function* () {
- *   const server = yield* FlowServer;
+ *   const server = yield* FlowEngine;
  *
  *   // Flow paused waiting for user input at node "approval_1"
  *   const job = yield* server.resumeFlow({
@@ -5213,7 +5598,7 @@ declare class FlowProvider extends FlowProvider_base {}
  *
  * // Cancel a flow
  * const cancel = Effect.gen(function* () {
- *   const server = yield* FlowServer;
+ *   const server = yield* FlowEngine;
  *
  *   // Cancel flow and cleanup intermediate files
  *   const job = yield* server.cancelFlow("job123", "client123");
@@ -5223,7 +5608,7 @@ declare class FlowProvider extends FlowProvider_base {}
  *
  * // Check flow structure before execution
  * const inspect = Effect.gen(function* () {
- *   const server = yield* FlowServer;
+ *   const server = yield* FlowEngine;
  *
  *   const flowData = yield* server.getFlowData("resize-optimize", "client123");
  *   console.log("Nodes:", flowData.nodes);
@@ -5233,7 +5618,7 @@ declare class FlowProvider extends FlowProvider_base {}
  * });
  * ```
  */
-type FlowServerShape = {
+type FlowEngineShape = {
   getFlow: <TRequirements>(flowId: string, clientId: string | null) => Effect.Effect<Flow<any, any, TRequirements>, UploadistaError>;
   getFlowData: (flowId: string, clientId: string | null) => Effect.Effect<FlowData, UploadistaError>;
   runFlow: <TRequirements>({
@@ -5264,18 +5649,18 @@ type FlowServerShape = {
   subscribeToFlowEvents: (jobId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError>;
   unsubscribeFromFlowEvents: (jobId: string) => Effect.Effect<void, UploadistaError>;
 };
-declare const FlowServer_base: Context.TagClass<FlowServer, "FlowServer", FlowServerShape>;
+declare const FlowEngine_base: Context.TagClass<FlowEngine, "FlowEngine", FlowEngineShape>;
 /**
- * Effect-TS context tag for the FlowServer service.
+ * Effect-TS context tag for the FlowEngine service.
  *
- * Use this tag to access the FlowServer in an Effect context.
+ * Use this tag to access the FlowEngine in an Effect context.
  * The server must be provided via a Layer or dependency injection.
  *
  * @example
  * ```typescript
- * // Access FlowServer in an Effect
+ * // Access FlowEngine in an Effect
  * const flowEffect = Effect.gen(function* () {
- *   const server = yield* FlowServer;
+ *   const server = yield* FlowEngine;
  *   const job = yield* server.runFlow({
  *     flowId: "my-flow",
  *     storageId: "s3",
@@ -5285,7 +5670,7 @@ declare const FlowServer_base: Context.TagClass<FlowServer, "FlowServer", FlowSe
  *   return job;
  * });
  *
- * // Provide FlowServer layer
+ * // Provide FlowEngine layer
  * const program = flowEffect.pipe(
  *   Effect.provide(flowServer),
  *   Effect.provide(flowProviderLayer),
@@ -5293,9 +5678,9 @@ declare const FlowServer_base: Context.TagClass<FlowServer, "FlowServer", FlowSe
  * );
  * ```
  */
-declare class FlowServer extends FlowServer_base {}
+declare class FlowEngine extends FlowEngine_base {}
 /**
- * Legacy configuration options for FlowServer.
+ * Legacy configuration options for FlowEngine.
  *
  * @deprecated Use Effect Layers and FlowProvider instead.
  * This type is kept for backward compatibility.
@@ -5303,7 +5688,7 @@ declare class FlowServer extends FlowServer_base {}
  * @property getFlow - Function to retrieve flow definitions
  * @property kvStore - KV store for flow job metadata
  */
-type FlowServerOptions = {
+type FlowEngineOptions = {
   getFlow: <TRequirements>({
     flowId,
     storageId
@@ -5313,7 +5698,7 @@ type FlowServerOptions = {
   }) => Promise<Flow<any, any, TRequirements>>;
   kvStore: KvStore<FlowJob>;
 };
-declare function createFlowServer(): Effect.Effect<{
+declare function createFlowEngine(): Effect.Effect<{
   getFlow: <TRequirements>(flowId: string, clientId: string | null) => Effect.Effect<Flow<any, any, any>, UploadistaError, never>;
   getFlowData: (flowId: string, clientId: string | null) => Effect.Effect<FlowData, UploadistaError, never>;
   runFlow: ({
@@ -5343,9 +5728,9 @@ declare function createFlowServer(): Effect.Effect<{
   cancelFlow: (jobId: string, clientId: string | null) => Effect.Effect<FlowJob, UploadistaError, never>;
   subscribeToFlowEvents: (jobId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError, never>;
   unsubscribeFromFlowEvents: (jobId: string) => Effect.Effect<void, UploadistaError, never>;
-}, never, UploadServer | FlowProvider | FlowJobKVStore | FlowEventEmitter>;
-declare const flowServer: Layer.Layer<FlowServer, never, UploadServer | FlowProvider | FlowJobKVStore | FlowEventEmitter>;
-type FlowServerLayer = typeof flowServer;
+}, never, UploadEngine | FlowEventEmitter | FlowJobKVStore | FlowProvider>;
+declare const flowEngine: Layer.Layer<FlowEngine, never, UploadEngine | FlowEventEmitter | FlowJobKVStore | FlowProvider>;
+type FlowEngineLayer = typeof flowEngine;
 //#endregion
 //#region src/flow/nodes/input-node.d.ts
 /**
@@ -5473,7 +5858,7 @@ declare function createInputNode(id: string, params?: InputNodeParams, options?:
   circuitBreaker?: FlowCircuitBreakerConfig;
 } & {
   type: NodeType.input;
-}, UploadistaError, UploadServer>;
+}, UploadistaError, UploadEngine>;
 //#endregion
 //#region src/flow/types/flow-file.d.ts
 /**
@@ -5865,7 +6250,7 @@ declare function createTransformNode({
   circuitBreaker?: FlowCircuitBreakerConfig;
 } & {
   type: NodeType;
-}, UploadistaError, UploadServer>;
+}, UploadistaError, UploadEngine>;
 //#endregion
 //#region src/flow/parallel-scheduler.d.ts
 /**
@@ -6375,8 +6760,8 @@ type ImageAiPluginLayer = Layer.Layer<ImageAiPlugin, never, never>;
 declare const optimizeParamsSchema: z.ZodObject<{
   quality: z.ZodNumber;
   format: z.ZodEnum<{
-    webp: "webp";
     jpeg: "jpeg";
+    webp: "webp";
     png: "png";
     avif: "avif";
   }>;
@@ -7123,1354 +7508,959 @@ type VideoPluginShape = {
   /**
    * Resizes a video using streaming for memory-efficient processing of large files.
    *
-   * This method outputs the resized video as a stream, reducing peak memory usage.
-   * For input, it accepts either a buffered Uint8Array or a Stream. Streaming input
-   * is only supported for MPEG-TS format; other formats will be buffered internally.
-   *
-   * @param input - The input video as Uint8Array or Stream (MPEG-TS only for streaming)
-   * @param options - Resize parameters including width, height, and aspect ratio
-   * @param streamOptions - Optional streaming configuration including input format hint
-   * @returns An Effect that resolves to a Stream of the resized video bytes
-   * @throws {UploadistaError} When video resizing fails
-   *
-   * @example
-   * ```typescript
-   * const program = Effect.gen(function* () {
-   *   const videoPlugin = yield* VideoPlugin;
-   *   const inputStream = yield* dataStore.readStream(fileId);
-   *   const outputStream = yield* videoPlugin.resizeStream(inputStream, {
-   *     width: 1280,
-   *     height: 720,
-   *     aspectRatio: "keep"
-   *   });
-   *   return outputStream;
-   * });
-   * ```
-   */
-  resizeStream?: (input: VideoStreamInput, options: ResizeVideoParams, streamOptions?: VideoStreamOptions) => Effect.Effect<Stream.Stream<Uint8Array, UploadistaError>, UploadistaError>;
-  /**
-   * Trims a video using streaming for memory-efficient processing of large files.
-   *
-   * This method outputs the trimmed video as a stream, reducing peak memory usage.
-   * For input, it accepts either a buffered Uint8Array or a Stream. Streaming input
-   * is only supported for MPEG-TS format; other formats will be buffered internally.
-   *
-   * @param input - The input video as Uint8Array or Stream (MPEG-TS only for streaming)
-   * @param options - Trim parameters including start time and end time/duration
-   * @param streamOptions - Optional streaming configuration including input format hint
-   * @returns An Effect that resolves to a Stream of the trimmed video bytes
-   * @throws {UploadistaError} When video trimming fails
-   *
-   * @example
-   * ```typescript
-   * const program = Effect.gen(function* () {
-   *   const videoPlugin = yield* VideoPlugin;
-   *   const inputStream = yield* dataStore.readStream(fileId);
-   *   const outputStream = yield* videoPlugin.trimStream(inputStream, {
-   *     startTime: 10,
-   *     endTime: 30
-   *   });
-   *   return outputStream;
-   * });
-   * ```
-   */
-  trimStream?: (input: VideoStreamInput, options: TrimVideoParams, streamOptions?: VideoStreamOptions) => Effect.Effect<Stream.Stream<Uint8Array, UploadistaError>, UploadistaError>;
-  /**
-   * Indicates whether this plugin supports streaming operations.
-   * Returns true if streaming methods are available and functional.
-   */
-  supportsStreaming?: boolean;
-};
-declare const VideoPlugin_base: Context.TagClass<VideoPlugin, "VideoPlugin", VideoPluginShape>;
-/**
- * Context tag for the Video Plugin.
- *
- * This tag provides a type-safe way to access video processing functionality
- * throughout the application using Effect's dependency injection system.
- *
- * @example
- * ```typescript
- * import { VideoPlugin } from "@uploadista/core/flow/plugins";
- *
- * // In your flow node
- * const program = Effect.gen(function* () {
- *   const videoPlugin = yield* VideoPlugin;
- *   const transcoded = yield* videoPlugin.transcode(videoData, { format: "webm", codec: "vp9" });
- *   const resized = yield* videoPlugin.resize(transcoded, { width: 1280, height: 720, aspectRatio: "keep" });
- *   return resized;
- * });
- * ```
- */
-declare class VideoPlugin extends VideoPlugin_base {}
-type VideoPluginLayer = Layer.Layer<VideoPlugin, never, never>;
-//#endregion
-//#region src/flow/plugins/virus-scan-plugin.d.ts
-/**
- * Result of a virus scan operation.
- */
-type ScanResult = {
-  /**
-   * Whether the file is clean (no viruses detected)
-   */
-  isClean: boolean;
-  /**
-   * Array of detected virus/malware names (empty if clean)
-   */
-  detectedViruses: string[];
-};
-/**
- * Comprehensive metadata about a virus scan operation.
- */
-type ScanMetadata = {
-  /**
-   * Whether the file was scanned
-   */
-  scanned: boolean;
-  /**
-   * Whether the file is clean (no viruses detected)
-   */
-  isClean: boolean;
-  /**
-   * Array of detected virus/malware names (empty if clean)
-   */
-  detectedViruses: string[];
-  /**
-   * ISO 8601 timestamp of when the scan was performed
-   */
-  scanDate: string;
-  /**
-   * Version of the antivirus engine used
-   */
-  engineVersion: string;
-  /**
-   * ISO 8601 timestamp of when virus definitions were last updated
-   */
-  definitionsDate: string;
-};
-/**
- * Shape definition for the Virus Scan Plugin interface.
- * Defines the contract that all virus scanning implementations must follow.
- */
-type VirusScanPluginShape = {
-  /**
-   * Scans a file for viruses and malware.
+   * This method outputs the resized video as a stream, reducing peak memory usage.
+   * For input, it accepts either a buffered Uint8Array or a Stream. Streaming input
+   * is only supported for MPEG-TS format; other formats will be buffered internally.
    *
-   * @param input - The input file as a Uint8Array
-   * @returns An Effect that resolves to ScanResult with detection information
-   * @throws {UploadistaError} When virus scanning fails or ClamAV is unavailable
+   * @param input - The input video as Uint8Array or Stream (MPEG-TS only for streaming)
+   * @param options - Resize parameters including width, height, and aspect ratio
+   * @param streamOptions - Optional streaming configuration including input format hint
+   * @returns An Effect that resolves to a Stream of the resized video bytes
+   * @throws {UploadistaError} When video resizing fails
    *
    * @example
    * ```typescript
    * const program = Effect.gen(function* () {
-   *   const virusScanPlugin = yield* VirusScanPlugin;
-   *   const result = yield* virusScanPlugin.scan(fileData);
-   *   if (!result.isClean) {
-   *     console.log('Viruses detected:', result.detectedViruses);
-   *   }
+   *   const videoPlugin = yield* VideoPlugin;
+   *   const inputStream = yield* dataStore.readStream(fileId);
+   *   const outputStream = yield* videoPlugin.resizeStream(inputStream, {
+   *     width: 1280,
+   *     height: 720,
+   *     aspectRatio: "keep"
+   *   });
+   *   return outputStream;
    * });
    * ```
    */
-  scan: (input: Uint8Array) => Effect.Effect<ScanResult, UploadistaError>;
+  resizeStream?: (input: VideoStreamInput, options: ResizeVideoParams, streamOptions?: VideoStreamOptions) => Effect.Effect<Stream.Stream<Uint8Array, UploadistaError>, UploadistaError>;
   /**
-   * Retrieves the version of the antivirus engine.
+   * Trims a video using streaming for memory-efficient processing of large files.
    *
-   * @returns An Effect that resolves to the engine version string
-   * @throws {UploadistaError} When version retrieval fails
+   * This method outputs the trimmed video as a stream, reducing peak memory usage.
+   * For input, it accepts either a buffered Uint8Array or a Stream. Streaming input
+   * is only supported for MPEG-TS format; other formats will be buffered internally.
+   *
+   * @param input - The input video as Uint8Array or Stream (MPEG-TS only for streaming)
+   * @param options - Trim parameters including start time and end time/duration
+   * @param streamOptions - Optional streaming configuration including input format hint
+   * @returns An Effect that resolves to a Stream of the trimmed video bytes
+   * @throws {UploadistaError} When video trimming fails
    *
    * @example
    * ```typescript
    * const program = Effect.gen(function* () {
-   *   const virusScanPlugin = yield* VirusScanPlugin;
-   *   const version = yield* virusScanPlugin.getVersion();
-   *   console.log('ClamAV version:', version);
+   *   const videoPlugin = yield* VideoPlugin;
+   *   const inputStream = yield* dataStore.readStream(fileId);
+   *   const outputStream = yield* videoPlugin.trimStream(inputStream, {
+   *     startTime: 10,
+   *     endTime: 30
+   *   });
+   *   return outputStream;
    * });
    * ```
    */
-  getVersion: () => Effect.Effect<string, UploadistaError>;
-};
-declare const VirusScanPlugin_base: Context.TagClass<VirusScanPlugin, "VirusScanPlugin", VirusScanPluginShape>;
-/**
- * Context tag for the Virus Scan Plugin.
- *
- * This tag provides a type-safe way to access virus scanning functionality
- * throughout the application using Effect's dependency injection system.
- *
- * @example
- * ```typescript
- * import { VirusScanPlugin } from "@uploadista/core/flow/plugins";
- *
- * // In your flow node
- * const program = Effect.gen(function* () {
- *   const virusScanPlugin = yield* VirusScanPlugin;
- *   const result = yield* virusScanPlugin.scan(fileData);
- *
- *   if (!result.isClean) {
- *     // Handle infected file
- *     return Effect.fail(new UploadistaError({
- *       code: "VIRUS_DETECTED",
- *       message: `Viruses detected: ${result.detectedViruses.join(', ')}`
- *     }));
- *   }
- *
- *   return fileData;
- * });
- * ```
- */
-declare class VirusScanPlugin extends VirusScanPlugin_base {}
-type VirusScanPluginLayer = Layer.Layer<VirusScanPlugin, never, never>;
-//#endregion
-//#region src/flow/plugins/zip-plugin.d.ts
-/**
- * Parameters for creating a ZIP archive.
- */
-type ZipParams = {
-  /** Name of the ZIP file to create */
-  zipName: string;
-  /** Whether to include file metadata in the ZIP archive */
-  includeMetadata: boolean;
-};
-/**
- * Input data structure for ZIP operations.
- * Represents a single file to be included in the ZIP archive.
- */
-type ZipInput = {
-  /** Unique identifier for the file */
-  id: string;
-  /** Binary data of the file */
-  data: Uint8Array;
-  /** File metadata including name, size, type, etc. */
-  metadata: UploadFile["metadata"];
-};
-/**
- * Shape definition for the ZIP Plugin interface.
- * Defines the contract that all ZIP implementations must follow.
- */
-type ZipPluginShape = {
+  trimStream?: (input: VideoStreamInput, options: TrimVideoParams, streamOptions?: VideoStreamOptions) => Effect.Effect<Stream.Stream<Uint8Array, UploadistaError>, UploadistaError>;
   /**
-   * Creates a ZIP archive from multiple input files.
-   *
-   * @param inputs - Array of files to include in the ZIP archive
-   * @param options - Configuration options for the ZIP creation
-   * @returns An Effect that resolves to the ZIP file as a Uint8Array
-   * @throws {UploadistaError} When ZIP creation fails
+   * Indicates whether this plugin supports streaming operations.
+   * Returns true if streaming methods are available and functional.
    */
-  zip: (inputs: ZipInput[], options: ZipParams) => Effect.Effect<Uint8Array, UploadistaError>;
-};
-declare const ZipPlugin_base: Context.TagClass<ZipPlugin, "ZipPlugin", ZipPluginShape>;
-/**
- * Context tag for the ZIP Plugin.
- *
- * This tag provides a type-safe way to access ZIP functionality
- * throughout the application using Effect's dependency injection system.
- *
- * @example
- * ```typescript
- * import { ZipPlugin } from "@uploadista/core/flow/plugins";
- *
- * // In your flow node
- * const program = Effect.gen(function* () {
- *   const zipPlugin = yield* ZipPlugin;
- *   const zipData = yield* zipPlugin.zip(files, { zipName: "archive.zip", includeMetadata: true });
- *   return zipData;
- * });
- * ```
- */
-declare class ZipPlugin extends ZipPlugin_base {}
-type ZipPluginLayer = Layer.Layer<ZipPlugin, never, never>;
-//#endregion
-//#region src/flow/plugins/plugins.d.ts
-type Plugin = ImagePlugin | ImageAiPlugin | VideoPlugin | DocumentPlugin | DocumentAiPlugin | VirusScanPlugin | CredentialProvider | ZipPlugin;
-type PluginLayer = ImagePluginLayer | ImageAiPluginLayer | VideoPluginLayer | DocumentPluginLayer | DocumentAiPluginLayer | VirusScanPluginLayer | CredentialProviderLayer | ZipPluginLayer;
-//#endregion
-//#region src/flow/plugins/types/describe-image-node.d.ts
-/**
- * Zod schema for validating describe image node parameters.
- * Defines the structure and validation rules for image description requests.
- */
-declare const describeImageParamsSchema: z.ZodObject<{
-  serviceType: z.ZodOptional<z.ZodEnum<{
-    replicate: "replicate";
-  }>>;
-}, z.core.$strip>;
-/**
- * Parameters for the describe image node.
- * Controls which AI service to use for generating image descriptions.
- */
-type DescribeImageParams = z.infer<typeof describeImageParamsSchema>;
-//#endregion
-//#region src/flow/plugins/types/remove-background-node.d.ts
-/**
- * Zod schema for validating remove background node parameters.
- * Defines the structure and validation rules for background removal requests.
- */
-declare const removeBackgroundParamsSchema: z.ZodObject<{
-  serviceType: z.ZodOptional<z.ZodEnum<{
-    replicate: "replicate";
-  }>>;
-}, z.core.$strip>;
-/**
- * Parameters for the remove background node.
- * Controls which AI service to use for background removal processing.
- */
-type RemoveBackgroundParams = z.infer<typeof removeBackgroundParamsSchema>;
-//#endregion
-//#region src/flow/type-guards.d.ts
-/**
- * A narrowed typed output with a specific node type and data type.
- * Unlike TypedOutput<T>, this type has a required nodeType field and
- * excludes BuiltInTypedOutput from the union, providing better type narrowing.
- *
- * @template T - The TypeScript type of the output data
- * @template TNodeType - The literal string type of the node type ID
- */
-type NarrowedTypedOutput<T, TNodeType extends string = string> = {
-  nodeType: TNodeType;
-  data: T;
-  nodeId: string;
-  timestamp: string;
+  supportsStreaming?: boolean;
 };
+declare const VideoPlugin_base: Context.TagClass<VideoPlugin, "VideoPlugin", VideoPluginShape>;
 /**
- * Factory function to create type guards for specific node types.
- *
- * Creates a TypeScript type guard that validates both the type tag and
- * the data structure against the registered schema. This enables type-safe
- * narrowing of TypedOutput objects in TypeScript.
- *
- * @template T - The expected TypeScript type after narrowing
- * @template TNodeType - The literal string type of the node type ID
- * @param typeId - The registered type ID to check against (e.g., "storage-output-v1")
- * @returns A type guard function that narrows TypedOutput to NarrowedTypedOutput<T, TNodeType>
- *
- * @example
- * ```typescript
- * import { createTypeGuard } from "@uploadista/core/flow";
- * import { z } from "zod";
- *
- * const descriptionSchema = z.object({
- *   description: z.string(),
- *   confidence: z.number(),
- * });
- *
- * type DescriptionOutput = z.infer<typeof descriptionSchema>;
- *
- * const isDescriptionOutput = createTypeGuard<DescriptionOutput>(
- *   "description-output-v1"
- * );
- *
- * // Use in code
- * if (isDescriptionOutput(output)) {
- *   // output.data is typed as DescriptionOutput
- *   console.log(output.data.description);
- * }
- * ```
- */
-declare function createTypeGuard<T, TNodeType extends string = string>(typeId: TNodeType): (output: TypedOutput) => output is NarrowedTypedOutput<T, TNodeType>;
-/**
- * Type guard for UploadFile objects.
- *
- * Validates that a value is a valid UploadFile by checking its structure against the schema.
- * This is useful for determining if a node result is an UploadFile, which affects
- * auto-persistence and intermediate file tracking.
- *
- * @param value - The value to check
- * @returns True if the value is a valid UploadFile
- *
- * @example
- * ```typescript
- * import { isUploadFile } from "@uploadista/core/flow";
- *
- * if (isUploadFile(nodeResult)) {
- *   // nodeResult is typed as UploadFile
- *   console.log("File ID:", nodeResult.id);
- *   console.log("Storage:", nodeResult.storage.id);
- * }
- * ```
- */
-declare function isUploadFile(value: unknown): value is UploadFile;
-/**
- * Type guard for storage output nodes.
- *
- * Validates that an output is from a storage node and contains valid UploadFile data.
+ * Context tag for the Video Plugin.
  *
- * @param output - The output to check
- * @returns True if the output is a storage output with valid UploadFile data
+ * This tag provides a type-safe way to access video processing functionality
+ * throughout the application using Effect's dependency injection system.
  *
  * @example
  * ```typescript
- * import { isStorageOutput } from "@uploadista/core/flow";
+ * import { VideoPlugin } from "@uploadista/core/flow/plugins";
  *
- * if (isStorageOutput(output)) {
- *   // output.data is typed as UploadFile
- *   console.log("File URL:", output.data.url);
- *   console.log("File size:", output.data.size);
- * }
+ * // In your flow node
+ * const program = Effect.gen(function* () {
+ *   const videoPlugin = yield* VideoPlugin;
+ *   const transcoded = yield* videoPlugin.transcode(videoData, { format: "webm", codec: "vp9" });
+ *   const resized = yield* videoPlugin.resize(transcoded, { width: 1280, height: 720, aspectRatio: "keep" });
+ *   return resized;
+ * });
  * ```
  */
-declare const isStorageOutput: (output: TypedOutput) => output is NarrowedTypedOutput<UploadFile, string>;
+declare class VideoPlugin extends VideoPlugin_base {}
+type VideoPluginLayer = Layer.Layer<VideoPlugin, never, never>;
+//#endregion
+//#region src/flow/plugins/virus-scan-plugin.d.ts
 /**
- * Type guard for OCR output nodes.
- *
- * Validates that an output is from an OCR node and contains valid structured OCR data.
- *
- * @param output - The output to check
- * @returns True if the output is an OCR output with valid structured text data
- *
- * @example
- * ```typescript
- * import { isOcrOutput } from "@uploadista/core/flow";
- *
- * if (isOcrOutput(output)) {
- *   // output.data is typed as OcrOutput
- *   console.log("Extracted text:", output.data.extractedText);
- *   console.log("Format:", output.data.format);
- *   console.log("Task type:", output.data.taskType);
- * }
- * ```
+ * Result of a virus scan operation.
  */
-declare const isOcrOutput: (output: TypedOutput) => output is NarrowedTypedOutput<{
-  extractedText: string;
-  format: "markdown" | "plain" | "structured";
-  taskType: "convertToMarkdown" | "freeOcr" | "parseFigure" | "locateObject";
-  confidence?: number | undefined;
-}, string>;
+type ScanResult = {
+  /**
+   * Whether the file is clean (no viruses detected)
+   */
+  isClean: boolean;
+  /**
+   * Array of detected virus/malware names (empty if clean)
+   */
+  detectedViruses: string[];
+};
 /**
- * Type guard for image description output nodes.
- *
- * Validates that an output is from an image description node and contains valid description data.
- *
- * @param output - The output to check
- * @returns True if the output is an image description output with valid description data
- *
- * @example
- * ```typescript
- * import { isImageDescriptionOutput } from "@uploadista/core/flow";
- *
- * if (isImageDescriptionOutput(output)) {
- *   // output.data is typed as ImageDescriptionOutput
- *   console.log("Description:", output.data.description);
- *   console.log("Confidence:", output.data.confidence);
- * }
- * ```
+ * Comprehensive metadata about a virus scan operation.
  */
-declare const isImageDescriptionOutput: (output: TypedOutput) => output is NarrowedTypedOutput<{
-  description: string;
-  confidence?: number | undefined;
-  metadata?: Record<string, unknown> | undefined;
-}, string>;
+type ScanMetadata = {
+  /**
+   * Whether the file was scanned
+   */
+  scanned: boolean;
+  /**
+   * Whether the file is clean (no viruses detected)
+   */
+  isClean: boolean;
+  /**
+   * Array of detected virus/malware names (empty if clean)
+   */
+  detectedViruses: string[];
+  /**
+   * ISO 8601 timestamp of when the scan was performed
+   */
+  scanDate: string;
+  /**
+   * Version of the antivirus engine used
+   */
+  engineVersion: string;
+  /**
+   * ISO 8601 timestamp of when virus definitions were last updated
+   */
+  definitionsDate: string;
+};
 /**
- * Filter an array of outputs to only those matching a specific type.
- *
- * This helper function filters outputs using a type guard and returns a
- * properly typed array of results. It's useful for extracting specific
- * output types from multi-output flows.
- *
- * @template TOutput - The expected narrowed output type
- * @param outputs - Array of typed outputs to filter
- * @param typeGuard - Type guard function to use for filtering
- * @returns Array of outputs that match the type guard, properly typed
- *
- * @example
- * ```typescript
- * import { filterOutputsByType, isStorageOutput } from "@uploadista/core/flow";
- *
- * // Get all storage outputs from a multi-output flow
- * const storageOutputs = filterOutputsByType(
- *   flowResult.outputs,
- *   isStorageOutput
- * );
- *
- * for (const output of storageOutputs) {
- *   // Each output.data is typed as UploadFile
- *   console.log("Saved file:", output.data.url);
- * }
- * ```
+ * Shape definition for the Virus Scan Plugin interface.
+ * Defines the contract that all virus scanning implementations must follow.
  */
-declare function filterOutputsByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): TOutput[];
+type VirusScanPluginShape = {
+  /**
+   * Scans a file for viruses and malware.
+   *
+   * @param input - The input file as a Uint8Array
+   * @returns An Effect that resolves to ScanResult with detection information
+   * @throws {UploadistaError} When virus scanning fails or ClamAV is unavailable
+   *
+   * @example
+   * ```typescript
+   * const program = Effect.gen(function* () {
+   *   const virusScanPlugin = yield* VirusScanPlugin;
+   *   const result = yield* virusScanPlugin.scan(fileData);
+   *   if (!result.isClean) {
+   *     console.log('Viruses detected:', result.detectedViruses);
+   *   }
+   * });
+   * ```
+   */
+  scan: (input: Uint8Array) => Effect.Effect<ScanResult, UploadistaError>;
+  /**
+   * Retrieves the version of the antivirus engine.
+   *
+   * @returns An Effect that resolves to the engine version string
+   * @throws {UploadistaError} When version retrieval fails
+   *
+   * @example
+   * ```typescript
+   * const program = Effect.gen(function* () {
+   *   const virusScanPlugin = yield* VirusScanPlugin;
+   *   const version = yield* virusScanPlugin.getVersion();
+   *   console.log('ClamAV version:', version);
+   * });
+   * ```
+   */
+  getVersion: () => Effect.Effect<string, UploadistaError>;
+};
+declare const VirusScanPlugin_base: Context.TagClass<VirusScanPlugin, "VirusScanPlugin", VirusScanPluginShape>;
 /**
- * Get a single output of a specific type from an array of outputs.
- *
- * This helper function finds exactly one output matching the type guard.
- * It throws an error if no outputs match or if multiple outputs match,
- * ensuring the caller receives exactly the expected result.
+ * Context tag for the Virus Scan Plugin.
  *
- * @template TOutput - The expected narrowed output type
- * @param outputs - Array of typed outputs to search
- * @param typeGuard - Type guard function to use for matching
- * @returns The single matching output, properly typed
- * @throws {UploadistaError} If no outputs match (OUTPUT_NOT_FOUND)
- * @throws {UploadistaError} If multiple outputs match (MULTIPLE_OUTPUTS_FOUND)
+ * This tag provides a type-safe way to access virus scanning functionality
+ * throughout the application using Effect's dependency injection system.
  *
  * @example
  * ```typescript
- * import { getSingleOutputByType, isStorageOutput } from "@uploadista/core/flow";
+ * import { VirusScanPlugin } from "@uploadista/core/flow/plugins";
  *
- * try {
- *   const storageOutput = getSingleOutputByType(
- *     flowResult.outputs,
- *     isStorageOutput
- *   );
- *   // storageOutput.data is typed as UploadFile
- *   console.log("File saved at:", storageOutput.data.url);
- * } catch (error) {
- *   if (error.code === "OUTPUT_NOT_FOUND") {
- *     console.error("No storage output found");
- *   } else if (error.code === "MULTIPLE_OUTPUTS_FOUND") {
- *     console.error("Multiple storage outputs found, expected one");
+ * // In your flow node
+ * const program = Effect.gen(function* () {
+ *   const virusScanPlugin = yield* VirusScanPlugin;
+ *   const result = yield* virusScanPlugin.scan(fileData);
+ *
+ *   if (!result.isClean) {
+ *     // Handle infected file
+ *     return Effect.fail(new UploadistaError({
+ *       code: "VIRUS_DETECTED",
+ *       message: `Viruses detected: ${result.detectedViruses.join(', ')}`
+ *     }));
  *   }
- * }
+ *
+ *   return fileData;
+ * });
  * ```
  */
-declare function getSingleOutputByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): Effect.Effect<TOutput, UploadistaError>;
+declare class VirusScanPlugin extends VirusScanPlugin_base {}
+type VirusScanPluginLayer = Layer.Layer<VirusScanPlugin, never, never>;
+//#endregion
+//#region src/flow/plugins/zip-plugin.d.ts
+/**
+ * Parameters for creating a ZIP archive.
+ */
+type ZipParams = {
+  /** Name of the ZIP file to create */
+  zipName: string;
+  /** Whether to include file metadata in the ZIP archive */
+  includeMetadata: boolean;
+};
+/**
+ * Input data structure for ZIP operations.
+ * Represents a single file to be included in the ZIP archive.
+ */
+type ZipInput = {
+  /** Unique identifier for the file */
+  id: string;
+  /** Binary data of the file */
+  data: Uint8Array;
+  /** File metadata including name, size, type, etc. */
+  metadata: UploadFile["metadata"];
+};
+/**
+ * Shape definition for the ZIP Plugin interface.
+ * Defines the contract that all ZIP implementations must follow.
+ */
+type ZipPluginShape = {
+  /**
+   * Creates a ZIP archive from multiple input files.
+   *
+   * @param inputs - Array of files to include in the ZIP archive
+   * @param options - Configuration options for the ZIP creation
+   * @returns An Effect that resolves to the ZIP file as a Uint8Array
+   * @throws {UploadistaError} When ZIP creation fails
+   */
+  zip: (inputs: ZipInput[], options: ZipParams) => Effect.Effect<Uint8Array, UploadistaError>;
+};
+declare const ZipPlugin_base: Context.TagClass<ZipPlugin, "ZipPlugin", ZipPluginShape>;
 /**
- * Get the first output of a specific type, if any exists.
- *
- * Unlike getSingleOutputByType, this function returns undefined if no outputs
- * match, and returns the first match if multiple outputs exist. This is useful
- * when you want a more lenient matching strategy.
+ * Context tag for the ZIP Plugin.
  *
- * @template TOutput - The expected narrowed output type
- * @param outputs - Array of typed outputs to search
- * @param typeGuard - Type guard function to use for matching
- * @returns The first matching output, or undefined if none match
+ * This tag provides a type-safe way to access ZIP functionality
+ * throughout the application using Effect's dependency injection system.
  *
  * @example
  * ```typescript
- * import { getFirstOutputByType, isStorageOutput } from "@uploadista/core/flow";
- *
- * const storageOutput = getFirstOutputByType(
- *   flowResult.outputs,
- *   isStorageOutput
- * );
+ * import { ZipPlugin } from "@uploadista/core/flow/plugins";
  *
- * if (storageOutput) {
- *   console.log("First storage output:", storageOutput.data.url);
- * } else {
- *   console.log("No storage outputs found");
- * }
+ * // In your flow node
+ * const program = Effect.gen(function* () {
+ *   const zipPlugin = yield* ZipPlugin;
+ *   const zipData = yield* zipPlugin.zip(files, { zipName: "archive.zip", includeMetadata: true });
+ *   return zipData;
+ * });
  * ```
  */
-declare function getFirstOutputByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): TOutput | undefined;
+declare class ZipPlugin extends ZipPlugin_base {}
+type ZipPluginLayer = Layer.Layer<ZipPlugin, never, never>;
+//#endregion
+//#region src/flow/plugins/plugins.d.ts
+type Plugin = ImagePlugin | ImageAiPlugin | VideoPlugin | DocumentPlugin | DocumentAiPlugin | VirusScanPlugin | CredentialProvider | ZipPlugin;
+type PluginLayer = ImagePluginLayer | ImageAiPluginLayer | VideoPluginLayer | DocumentPluginLayer | DocumentAiPluginLayer | VirusScanPluginLayer | CredentialProviderLayer | ZipPluginLayer;
+//#endregion
+//#region src/flow/plugins/types/describe-image-node.d.ts
 /**
- * Get an output by its node ID.
- *
- * This helper finds an output produced by a specific node instance,
- * regardless of its type. Useful when you know the specific node ID
- * you're looking for.
- *
- * @param outputs - Array of typed outputs to search
- * @param nodeId - The node ID to match
- * @returns The output from the specified node, or undefined if not found
- *
- * @example
- * ```typescript
- * import { getOutputByNodeId } from "@uploadista/core/flow";
- *
- * const cdnOutput = getOutputByNodeId(flowResult.outputs, "cdn-storage");
- * if (cdnOutput) {
- *   console.log("CDN output:", cdnOutput.data);
- * }
- * ```
+ * Zod schema for validating describe image node parameters.
+ * Defines the structure and validation rules for image description requests.
  */
-declare function getOutputByNodeId(outputs: TypedOutput[], nodeId: string): TypedOutput | undefined;
+declare const describeImageParamsSchema: z.ZodObject<{
+  serviceType: z.ZodOptional<z.ZodEnum<{
+    replicate: "replicate";
+  }>>;
+}, z.core.$strip>;
 /**
- * Check if any outputs match a specific type.
- *
- * Simple predicate function to check if at least one output of a given
- * type exists in the results.
- *
- * @template TOutput - The expected narrowed output type
- * @param outputs - Array of typed outputs to check
- * @param typeGuard - Type guard function to use for checking
- * @returns True if at least one output matches the type guard
- *
- * @example
- * ```typescript
- * import { hasOutputOfType, isStorageOutput } from "@uploadista/core/flow";
- *
- * if (hasOutputOfType(flowResult.outputs, isStorageOutput)) {
- *   console.log("Flow produced at least one storage output");
- * } else {
- *   console.log("No storage outputs in this flow");
- * }
- * ```
+ * Parameters for the describe image node.
+ * Controls which AI service to use for generating image descriptions.
  */
-declare function hasOutputOfType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): boolean;
+type DescribeImageParams = z.infer<typeof describeImageParamsSchema>;
+//#endregion
+//#region src/flow/plugins/types/remove-background-node.d.ts
 /**
- * Type guard for init operation (streaming file upload initialization).
- *
- * Checks if the input data is an init operation that starts a streaming
- * file upload session.
- *
- * @param data - Input data to check
- * @returns True if data is an init operation
- *
- * @example
- * ```typescript
- * if (isInitOperation(inputData)) {
- *   console.log("Storage ID:", inputData.storageId);
- *   console.log("Metadata:", inputData.metadata);
- * }
- * ```
+ * Zod schema for validating remove background node parameters.
+ * Defines the structure and validation rules for background removal requests.
  */
-declare function isInitOperation(data: InputData): data is Extract<InputData, {
-  operation: "init";
-}>;
+declare const removeBackgroundParamsSchema: z.ZodObject<{
+  serviceType: z.ZodOptional<z.ZodEnum<{
+    replicate: "replicate";
+  }>>;
+}, z.core.$strip>;
 /**
- * Type guard for finalize operation (complete streaming upload).
- *
- * Checks if the input data is a finalize operation that completes a
- * previously initialized streaming upload.
- *
- * @param data - Input data to check
- * @returns True if data is a finalize operation
+ * Parameters for the remove background node.
+ * Controls which AI service to use for background removal processing.
+ */
+type RemoveBackgroundParams = z.infer<typeof removeBackgroundParamsSchema>;
+//#endregion
+//#region src/flow/type-guards.d.ts
+/**
+ * A narrowed typed output with a specific node type and data type.
+ * Unlike TypedOutput<T>, this type has a required nodeType field and
+ * excludes BuiltInTypedOutput from the union, providing better type narrowing.
  *
- * @example
- * ```typescript
- * if (isFinalizeOperation(inputData)) {
- *   console.log("Upload ID:", inputData.uploadId);
- * }
- * ```
+ * @template T - The TypeScript type of the output data
+ * @template TNodeType - The literal string type of the node type ID
  */
-declare function isFinalizeOperation(data: InputData): data is Extract<InputData, {
-  operation: "finalize";
-}>;
+type NarrowedTypedOutput<T, TNodeType extends string = string> = {
+  nodeType: TNodeType;
+  data: T;
+  nodeId: string;
+  timestamp: string;
+};
 /**
- * Type guard for URL operation (direct file fetch from URL).
+ * Factory function to create type guards for specific node types.
  *
- * Checks if the input data is a URL operation that fetches a file
- * directly from an external URL.
+ * Creates a TypeScript type guard that validates both the type tag and
+ * the data structure against the registered schema. This enables type-safe
+ * narrowing of TypedOutput objects in TypeScript.
  *
- * @param data - Input data to check
- * @returns True if data is a URL operation
+ * @template T - The expected TypeScript type after narrowing
+ * @template TNodeType - The literal string type of the node type ID
+ * @param typeId - The registered type ID to check against (e.g., "storage-output-v1")
+ * @returns A type guard function that narrows TypedOutput to NarrowedTypedOutput<T, TNodeType>
  *
  * @example
  * ```typescript
- * if (isUrlOperation(inputData)) {
- *   console.log("Fetching from:", inputData.url);
- *   console.log("Optional storage:", inputData.storageId);
- * }
- * ```
- */
-declare function isUrlOperation(data: InputData): data is Extract<InputData, {
-  operation: "url";
-}>;
-/**
- * Type guard for upload operations (init or url).
+ * import { createTypeGuard } from "@uploadista/core/flow";
+ * import { z } from "zod";
  *
- * Checks if the input data is either an init or URL operation (i.e., operations
- * that trigger new uploads, as opposed to finalize which completes an existing upload).
+ * const descriptionSchema = z.object({
+ *   description: z.string(),
+ *   confidence: z.number(),
+ * });
  *
- * @param data - Input data to check
- * @returns True if data is an init or URL operation
+ * type DescriptionOutput = z.infer<typeof descriptionSchema>;
  *
- * @example
- * ```typescript
- * if (isUploadOperation(inputData)) {
- *   // This is a new upload, not a finalization
- *   if (isInitOperation(inputData)) {
- *     console.log("Streaming upload");
- *   } else {
- *     console.log("URL fetch");
- *   }
+ * const isDescriptionOutput = createTypeGuard<DescriptionOutput>(
+ *   "description-output-v1"
+ * );
+ *
+ * // Use in code
+ * if (isDescriptionOutput(output)) {
+ *   // output.data is typed as DescriptionOutput
+ *   console.log(output.data.description);
  * }
  * ```
  */
-declare function isUploadOperation(data: InputData): data is Extract<InputData, {
-  operation: "init" | "url";
-}>;
-//#endregion
-//#region src/flow/typed-flow.d.ts
+declare function createTypeGuard<T, TNodeType extends string = string>(typeId: TNodeType): (output: TypedOutput) => output is NarrowedTypedOutput<T, TNodeType>;
 /**
- * Defines a node that can be used in a typed flow.
- *
- * A node definition can be either:
- * - A plain FlowNode object
- * - An Effect that resolves to a FlowNode (for nodes requiring dependencies)
+ * Type guard for UploadFile objects.
  *
- * @template TNodeError - The error types that the node can produce
- * @template TNodeRequirements - The services/dependencies the node requires
- */
-type NodeDefinition<TNodeError = never, TNodeRequirements = never> = FlowNode<any, any, UploadistaError> | Effect.Effect<FlowNode<any, any, UploadistaError>, TNodeError, TNodeRequirements>;
-/**
- * A record mapping node IDs to their definitions.
+ * Validates that a value is a valid UploadFile by checking its structure against the schema.
+ * This is useful for determining if a node result is an UploadFile, which affects
+ * auto-persistence and intermediate file tracking.
  *
- * This is the primary type used for defining the nodes in a typed flow,
- * allowing TypeScript to infer input/output schemas and requirements.
+ * @param value - The value to check
+ * @returns True if the value is a valid UploadFile
  *
  * @example
  * ```typescript
- * const nodes = {
- *   input: fileInputNode,
- *   resize: Effect.succeed(imageResizeNode),
- *   output: s3OutputNode
- * } satisfies NodeDefinitionsRecord;
- * ```
- */
-type NodeDefinitionsRecord = Record<string, NodeDefinition<any, any>>;
-/**
- * Extracts the error type from a NodeDefinition.
- *
- * If the node is an Effect, extracts its error type.
- * If the node is a plain FlowNode, returns never (no errors).
- */
-type NodeDefinitionError<T> = T extends Effect.Effect<FlowNode<any, any, UploadistaError>, infer TError, any> ? TError : never;
-/**
- * Extracts the requirements (dependencies) from a NodeDefinition.
+ * import { isUploadFile } from "@uploadista/core/flow";
  *
- * Uses the shared ExtractEffectRequirements utility for consistency.
+ * if (isUploadFile(nodeResult)) {
+ *   // nodeResult is typed as UploadFile
+ *   console.log("File ID:", nodeResult.id);
+ *   console.log("Storage:", nodeResult.storage.id);
+ * }
+ * ```
  */
-type NodeDefinitionRequirements<T> = ExtractEffectRequirements<T>;
+declare function isUploadFile(value: unknown): value is UploadFile;
 /**
- * Extracts all possible errors from all nodes in a flow as a union.
+ * Type guard for storage output nodes.
  *
- * This iterates through all nodes in the record and combines their
- * error types into a single union type.
+ * Validates that an output is from a storage node and contains valid UploadFile data.
+ *
+ * @param output - The output to check
+ * @returns True if the output is a storage output with valid UploadFile data
+ *
+ * @example
+ * ```typescript
+ * import { isStorageOutput } from "@uploadista/core/flow";
+ *
+ * if (isStorageOutput(output)) {
+ *   // output.data is typed as UploadFile
+ *   console.log("File URL:", output.data.url);
+ *   console.log("File size:", output.data.size);
+ * }
+ * ```
  */
-type NodesErrorUnion<TNodes extends NodeDefinitionsRecord> = { [K in keyof TNodes]: NodeDefinitionError<TNodes[K]> }[keyof TNodes];
+declare const isStorageOutput: (output: TypedOutput) => output is NarrowedTypedOutput<UploadFile, string>;
 /**
- * Extracts all service requirements from all nodes in a flow as a union.
+ * Type guard for OCR output nodes.
  *
- * This iterates through all nodes in the record and combines their
- * requirement types into a single union type representing all services
- * needed by the flow.
+ * Validates that an output is from an OCR node and contains valid structured OCR data.
  *
- * @template TNodes - The record of node definitions
+ * @param output - The output to check
+ * @returns True if the output is an OCR output with valid structured text data
  *
  * @example
  * ```typescript
- * const nodes = {
- *   resize: imageResizeNode, // requires ImagePlugin
- *   zip: zipNode,           // requires ZipPlugin
- * };
- * type Requirements = NodesRequirementsUnion<typeof nodes>;
- * // Requirements = ImagePlugin | ZipPlugin
+ * import { isOcrOutput } from "@uploadista/core/flow";
+ *
+ * if (isOcrOutput(output)) {
+ *   // output.data is typed as OcrOutput
+ *   console.log("Extracted text:", output.data.extractedText);
+ *   console.log("Format:", output.data.format);
+ *   console.log("Task type:", output.data.taskType);
+ * }
  * ```
  */
-type NodesRequirementsUnion<TNodes extends NodeDefinitionsRecord> = { [K in keyof TNodes]: NodeDefinitionRequirements<TNodes[K]> }[keyof TNodes];
+declare const isOcrOutput: (output: TypedOutput) => output is NarrowedTypedOutput<{
+  extractedText: string;
+  format: "markdown" | "plain" | "structured";
+  taskType: "convertToMarkdown" | "freeOcr" | "parseFigure" | "locateObject";
+  confidence?: number | undefined;
+}, string>;
 /**
- * Extracts all service requirements from a flow's nodes.
+ * Type guard for image description output nodes.
  *
- * This includes all services required by any node in the flow,
- * including UploadServer (which is provided by the runtime).
+ * Validates that an output is from an image description node and contains valid description data.
  *
- * @template TNodes - The record of node definitions
+ * @param output - The output to check
+ * @returns True if the output is an image description output with valid description data
  *
  * @example
  * ```typescript
- * const myFlow = createFlow({
- *   nodes: {
- *     input: fileInputNode,
- *     process: imageProcessNode, // requires ImagePlugin
- *   },
- *   edges: [...]
- * });
- * type AllRequirements = FlowRequirements<typeof myFlow.nodes>;
- * // AllRequirements = ImagePlugin | UploadServer
+ * import { isImageDescriptionOutput } from "@uploadista/core/flow";
+ *
+ * if (isImageDescriptionOutput(output)) {
+ *   // output.data is typed as ImageDescriptionOutput
+ *   console.log("Description:", output.data.description);
+ *   console.log("Confidence:", output.data.confidence);
+ * }
  * ```
  */
-type FlowRequirements<TNodes extends NodeDefinitionsRecord> = NodesRequirementsUnion<TNodes>;
+declare const isImageDescriptionOutput: (output: TypedOutput) => output is NarrowedTypedOutput<{
+  description: string;
+  confidence?: number | undefined;
+  metadata?: Record<string, unknown> | undefined;
+}, string>;
 /**
- * Extracts plugin service requirements from a flow, excluding UploadServer.
+ * Filter an array of outputs to only those matching a specific type.
  *
- * This type is useful for determining which plugin layers need to be
- * provided when creating a server, as UploadServer is automatically
- * provided by the runtime.
+ * This helper function filters outputs using a type guard and returns a
+ * properly typed array of results. It's useful for extracting specific
+ * output types from multi-output flows.
  *
- * @template TNodes - The record of node definitions
+ * @template TOutput - The expected narrowed output type
+ * @param outputs - Array of typed outputs to filter
+ * @param typeGuard - Type guard function to use for filtering
+ * @returns Array of outputs that match the type guard, properly typed
  *
  * @example
  * ```typescript
- * const myFlow = createFlow({
- *   nodes: {
- *     resize: imageResizeNode, // requires ImagePlugin
- *     upload: s3OutputNode,   // requires UploadServer
- *   },
- *   edges: [...]
- * });
- * type PluginRequirements = FlowPluginRequirements<typeof myFlow.nodes>;
- * // PluginRequirements = ImagePlugin (UploadServer excluded)
+ * import { filterOutputsByType, isStorageOutput } from "@uploadista/core/flow";
+ *
+ * // Get all storage outputs from a multi-output flow
+ * const storageOutputs = filterOutputsByType(
+ *   flowResult.outputs,
+ *   isStorageOutput
+ * );
+ *
+ * for (const output of storageOutputs) {
+ *   // Each output.data is typed as UploadFile
+ *   console.log("Saved file:", output.data.url);
+ * }
  * ```
  */
-type FlowPluginRequirements<TNodes extends NodeDefinitionsRecord> = Exclude<FlowRequirements<TNodes>, UploadServer>;
+declare function filterOutputsByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): TOutput[];
 /**
- * Infers the concrete FlowNode type from a NodeDefinition.
+ * Get a single output of a specific type from an array of outputs.
  *
- * If the definition is already a FlowNode, returns it as-is.
- * If the definition is an Effect, extracts the FlowNode from the Effect's success type.
+ * This helper function finds exactly one output matching the type guard.
+ * It throws an error if no outputs match or if multiple outputs match,
+ * ensuring the caller receives exactly the expected result.
  *
- * Uses the shared ResolveEffect utility for consistency.
+ * @template TOutput - The expected narrowed output type
+ * @param outputs - Array of typed outputs to search
+ * @param typeGuard - Type guard function to use for matching
+ * @returns The single matching output, properly typed
+ * @throws {UploadistaError} If no outputs match (OUTPUT_NOT_FOUND)
+ * @throws {UploadistaError} If multiple outputs match (MULTIPLE_OUTPUTS_FOUND)
+ *
+ * @example
+ * ```typescript
+ * import { getSingleOutputByType, isStorageOutput } from "@uploadista/core/flow";
+ *
+ * try {
+ *   const storageOutput = getSingleOutputByType(
+ *     flowResult.outputs,
+ *     isStorageOutput
+ *   );
+ *   // storageOutput.data is typed as UploadFile
+ *   console.log("File saved at:", storageOutput.data.url);
+ * } catch (error) {
+ *   if (error.code === "OUTPUT_NOT_FOUND") {
+ *     console.error("No storage output found");
+ *   } else if (error.code === "MULTIPLE_OUTPUTS_FOUND") {
+ *     console.error("Multiple storage outputs found, expected one");
+ *   }
+ * }
+ * ```
  */
-type InferNode<T> = T extends FlowNode<any, any, UploadistaError> ? T : ResolveEffect<T> extends FlowNode<any, any, UploadistaError> ? ResolveEffect<T> : never;
-type ExtractKeysByNodeType<TNodes extends NodeDefinitionsRecord, TType extends NodeType> = { [K in keyof TNodes]: InferNode<TNodes[K]>["type"] extends TType ? K : never }[keyof TNodes];
-type SchemaInfer<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
-type FlowInputMap<TNodes extends NodeDefinitionsRecord> = { [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]> };
-type FlowOutputMap<TNodes extends NodeDefinitionsRecord> = { [K in Extract<keyof TNodes, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]> };
-type FlowInputUnion<TNodes extends NodeDefinitionsRecord> = { [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]> }[Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>];
-type FlowOutputUnion<TNodes extends NodeDefinitionsRecord> = { [K in Extract<keyof TNodes, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]> }[Extract<keyof TNodes, string>];
-type NodeKey<TNodes extends NodeDefinitionsRecord> = Extract<keyof TNodes, string>;
-type TypedFlowEdge<TNodes extends NodeDefinitionsRecord> = {
-  source: NodeKey<TNodes>;
-  target: NodeKey<TNodes>;
-  sourcePort?: string;
-  targetPort?: string;
-};
-type TypedFlowConfig<TNodes extends NodeDefinitionsRecord> = {
-  flowId: string;
-  name: string;
-  nodes: TNodes;
-  edges: Array<TypedFlowEdge<TNodes>>;
-  typeChecker?: TypeCompatibilityChecker;
-  onEvent?: (event: FlowEvent) => Effect.Effect<{
-    eventId: string | null;
-  }, UploadistaError>;
-  parallelExecution?: {
-    enabled?: boolean;
-    maxConcurrency?: number;
-  };
-  inputSchema?: z.ZodTypeAny;
-  outputSchema?: z.ZodTypeAny;
-  hooks?: {
-    /**
-     * Called when a sink node (terminal node with no outgoing edges) produces an output.
-     * This hook runs after auto-persistence for UploadFile outputs.
-     *
-     * Use this hook to perform additional post-processing such as:
-     * - Saving output metadata to a database
-     * - Tracking outputs in external systems
-     * - Adding custom metadata to outputs
-     * - Triggering downstream workflows
-     *
-     * **Important**: The hook must not have any service requirements (Effect requirements must be `never`).
-     * All necessary services should be captured in the closure when defining the hook.
-     *
-     * @example
-     * ```typescript
-     * // Using Promise (simpler for most users)
-     * hooks: {
-     *   onNodeOutput: async ({ output }) => {
-     *     await db.save(output);
-     *     return output;
-     *   }
-     * }
-     * ```
-     */
-    onNodeOutput?: <TOutput>(context: {
-      output: TOutput;
-      nodeId: string;
-      flowId: string;
-      jobId: string;
-      storageId: string;
-      clientId: string | null;
-    }) => Effect.Effect<TOutput, UploadistaError, never> | Promise<TOutput>;
-  };
-  /**
-   * Circuit breaker configuration for resilience against external service failures.
-   *
-   * @example
-   * ```typescript
-   * circuitBreaker: {
-   *   defaults: { enabled: false },
-   *   nodeTypeOverrides: {
-   *     "Describe Image": {
-   *       enabled: true,
-   *       failureThreshold: 5,
-   *       resetTimeout: 60000,
-   *       fallback: { type: "skip", passThrough: true }
-   *     }
-   *   }
-   * }
-   * ```
-   */
-  circuitBreaker?: {
-    /** Default circuit breaker config for all nodes */
-    defaults?: FlowCircuitBreakerConfig;
-    /** Override circuit breaker config per node type (node name) */
-    nodeTypeOverrides?: Record<string, FlowCircuitBreakerConfig>;
-  };
-};
-declare const typedFlowInputsSymbol: unique symbol;
-declare const typedFlowOutputsSymbol: unique symbol;
-declare const typedFlowPluginsSymbol: unique symbol;
+declare function getSingleOutputByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): Effect.Effect<TOutput, UploadistaError>;
 /**
- * A type-safe Flow that infers input/output types and requirements from its nodes.
- *
- * TypedFlow extends the base Flow type with additional type information that
- * allows TypeScript to verify inputs, outputs, and plugin requirements at compile time.
+ * Get the first output of a specific type, if any exists.
  *
- * The phantom type properties (using unique symbols) enable type-level metadata
- * without affecting runtime behavior, allowing other type utilities to extract
- * this information for validation purposes.
+ * Unlike getSingleOutputByType, this function returns undefined if no outputs
+ * match, and returns the first match if multiple outputs exist. This is useful
+ * when you want a more lenient matching strategy.
  *
- * @template TNodes - Record of node definitions used in the flow
- * @template TInputSchema - Zod schema for flow inputs (inferred from input nodes)
- * @template TOutputSchema - Zod schema for flow outputs (inferred from output nodes)
+ * @template TOutput - The expected narrowed output type
+ * @param outputs - Array of typed outputs to search
+ * @param typeGuard - Type guard function to use for matching
+ * @returns The first matching output, or undefined if none match
  *
  * @example
  * ```typescript
- * const myFlow = createFlow({
- *   nodes: {
- *     input: fileInputNode,
- *     resize: imageResizeNode,
- *     output: s3OutputNode
- *   },
- *   edges: [
- *     { source: 'input', target: 'resize' },
- *     { source: 'resize', target: 'output' }
- *   ]
- * });
+ * import { getFirstOutputByType, isStorageOutput } from "@uploadista/core/flow";
  *
- * // TypeScript infers:
- * // - Input types from fileInputNode.inputSchema
- * // - Output types from s3OutputNode.outputSchema
- * // - Requirements: ImagePlugin (from resize node)
+ * const storageOutput = getFirstOutputByType(
+ *   flowResult.outputs,
+ *   isStorageOutput
+ * );
+ *
+ * if (storageOutput) {
+ *   console.log("First storage output:", storageOutput.data.url);
+ * } else {
+ *   console.log("No storage outputs found");
+ * }
  * ```
  */
-type TypedFlow<TNodes extends NodeDefinitionsRecord, TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny> = Flow<TInputSchema, TOutputSchema, FlowRequirements<TNodes>> & {
-  run: (args: {
-    inputs?: Partial<FlowInputMap<TNodes>>;
-    storageId: string;
-    jobId: string;
-  }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, UploadistaError, FlowRequirements<TNodes>>;
-  resume: (args: {
-    jobId: string;
-    storageId: string;
-    nodeResults: Record<string, unknown>;
-    executionState: {
-      executionOrder: string[];
-      currentIndex: number;
-      inputs: Partial<FlowInputMap<TNodes>>;
-    };
-  }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, UploadistaError, FlowRequirements<TNodes>>;
-  readonly [typedFlowInputsSymbol]?: FlowInputMap<TNodes>;
-  readonly [typedFlowOutputsSymbol]?: FlowOutputMap<TNodes>;
-  readonly [typedFlowPluginsSymbol]?: FlowPluginRequirements<TNodes>;
-};
-declare function createFlow<TNodes extends NodeDefinitionsRecord>(config: TypedFlowConfig<TNodes>): Effect.Effect<TypedFlow<TNodes, z.ZodType<FlowInputUnion<TNodes>>, z.ZodType<FlowOutputUnion<TNodes>>>, NodesErrorUnion<TNodes> | UploadistaError, FlowRequirements<TNodes>>;
-//#endregion
-//#region src/flow/types/run-args.d.ts
+declare function getFirstOutputByType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): TOutput | undefined;
 /**
- * Zod schema for validating flow run arguments.
+ * Get an output by its node ID.
  *
- * @property inputs - Record mapping input node IDs to their input data
+ * This helper finds an output produced by a specific node instance,
+ * regardless of its type. Useful when you know the specific node ID
+ * you're looking for.
+ *
+ * @param outputs - Array of typed outputs to search
+ * @param nodeId - The node ID to match
+ * @returns The output from the specified node, or undefined if not found
  *
  * @example
  * ```typescript
- * const args = {
- *   inputs: {
- *     "input-node-1": { file: myFile, metadata: { ... } },
- *     "input-node-2": { file: anotherFile }
- *   }
- * };
+ * import { getOutputByNodeId } from "@uploadista/core/flow";
  *
- * // Validate before running
- * const validated = runArgsSchema.parse(args);
+ * const cdnOutput = getOutputByNodeId(flowResult.outputs, "cdn-storage");
+ * if (cdnOutput) {
+ *   console.log("CDN output:", cdnOutput.data);
+ * }
  * ```
  */
-declare const runArgsSchema: z.ZodObject<{
-  inputs: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip>;
-/**
- * Type representing validated flow run arguments.
- *
- * This type is inferred from the runArgsSchema and ensures type safety
- * when passing inputs to flow execution.
- */
-type RunArgs = z.infer<typeof runArgsSchema>;
-//#endregion
-//#region src/flow/types/dead-letter-item.d.ts
+declare function getOutputByNodeId(outputs: TypedOutput[], nodeId: string): TypedOutput | undefined;
 /**
- * Dead Letter Queue item types and definitions.
+ * Check if any outputs match a specific type.
  *
- * A DeadLetterItem represents a failed flow job that has been captured
- * for later retry, debugging, or manual intervention.
+ * Simple predicate function to check if at least one output of a given
+ * type exists in the results.
  *
- * @module flow/types/dead-letter-item
- * @see {@link DeadLetterQueueService} for DLQ operations
- */
-/**
- * Status of a Dead Letter Queue item.
+ * @template TOutput - The expected narrowed output type
+ * @param outputs - Array of typed outputs to check
+ * @param typeGuard - Type guard function to use for checking
+ * @returns True if at least one output matches the type guard
  *
- * Item lifecycle: pending → retrying → (pending | exhausted | resolved)
+ * @example
+ * ```typescript
+ * import { hasOutputOfType, isStorageOutput } from "@uploadista/core/flow";
  *
- * - `pending`: Awaiting retry (either scheduled or manual)
- * - `retrying`: Currently being retried
- * - `exhausted`: Max retries reached, requires manual intervention
- * - `resolved`: Successfully retried or manually resolved
+ * if (hasOutputOfType(flowResult.outputs, isStorageOutput)) {
+ *   console.log("Flow produced at least one storage output");
+ * } else {
+ *   console.log("No storage outputs in this flow");
+ * }
+ * ```
  */
-type DeadLetterItemStatus = "pending" | "retrying" | "exhausted" | "resolved";
+declare function hasOutputOfType<TOutput extends TypedOutput>(outputs: TypedOutput[], typeGuard: (output: TypedOutput) => output is TOutput): boolean;
 /**
- * Error details captured when a flow job fails.
+ * Type guard for init operation (streaming file upload initialization).
  *
- * Contains comprehensive error information for debugging and retry decisions.
+ * Checks if the input data is an init operation that starts a streaming
+ * file upload session.
  *
- * @property code - Error code (e.g., "FLOW_NODE_ERROR", "VALIDATION_ERROR")
- * @property message - Human-readable error message
- * @property nodeId - ID of the node that failed (if applicable)
- * @property stack - Stack trace (included in development mode)
- */
-interface DeadLetterError {
-  /** Error code for categorization and retry filtering */
-  code: string;
-  /** Human-readable error message */
-  message: string;
-  /** Node that failed (if applicable) */
-  nodeId?: string;
-  /** Stack trace (in dev mode only) */
-  stack?: string;
-}
-/**
- * Record of a single retry attempt.
+ * @param data - Input data to check
+ * @returns True if data is an init operation
  *
- * @property attemptedAt - When the retry was attempted
- * @property error - Error message if the retry failed
- * @property durationMs - How long the retry took
+ * @example
+ * ```typescript
+ * if (isInitOperation(inputData)) {
+ *   console.log("Storage ID:", inputData.storageId);
+ *   console.log("Metadata:", inputData.metadata);
+ * }
+ * ```
  */
-interface DeadLetterRetryAttempt {
-  /** When the retry was attempted */
-  attemptedAt: Date;
-  /** Error message if the retry failed */
-  error: string;
-  /** Duration of the retry attempt in milliseconds */
-  durationMs: number;
-}
+declare function isInitOperation(data: InputData): data is Extract<InputData, {
+  operation: "init";
+}>;
 /**
- * Represents a failed flow job captured in the Dead Letter Queue.
+ * Type guard for finalize operation (complete streaming upload).
  *
- * Contains all information needed to debug, retry, or manually resolve
- * a failed flow execution.
+ * Checks if the input data is a finalize operation that completes a
+ * previously initialized streaming upload.
  *
- * @property id - Unique DLQ item identifier
- * @property jobId - Original flow job ID that failed
- * @property flowId - Flow definition that was being executed
- * @property storageId - Target storage for the flow
- * @property clientId - Client who initiated the job
- * @property error - Comprehensive error details
- * @property inputs - Original inputs passed to the flow
- * @property nodeResults - Partial results from nodes that completed before failure
- * @property failedAtNodeId - Node where execution failed (if applicable)
- * @property retryCount - Number of retry attempts made
- * @property maxRetries - Maximum retries allowed from retry policy
- * @property nextRetryAt - Scheduled time for next automatic retry
- * @property retryHistory - History of all retry attempts
- * @property createdAt - When the item was added to DLQ
- * @property updatedAt - When the item was last modified
- * @property expiresAt - TTL for automatic cleanup
- * @property status - Current status of the DLQ item
+ * @param data - Input data to check
+ * @returns True if data is a finalize operation
  *
  * @example
  * ```typescript
- * const dlqItem: DeadLetterItem = {
- *   id: "dlq_abc123",
- *   jobId: "job_xyz789",
- *   flowId: "image-resize-pipeline",
- *   storageId: "s3-production",
- *   clientId: "client_456",
- *   error: {
- *     code: "FLOW_NODE_ERROR",
- *     message: "External service timeout",
- *     nodeId: "resize-node"
- *   },
- *   inputs: { input: { uploadId: "upload_123" } },
- *   nodeResults: { "input-node": { file: {...} } },
- *   failedAtNodeId: "resize-node",
- *   retryCount: 2,
- *   maxRetries: 3,
- *   nextRetryAt: new Date("2024-01-15T10:35:00Z"),
- *   retryHistory: [
- *     { attemptedAt: new Date("2024-01-15T10:30:00Z"), error: "Timeout", durationMs: 5000 },
- *     { attemptedAt: new Date("2024-01-15T10:32:00Z"), error: "Timeout", durationMs: 5000 }
- *   ],
- *   createdAt: new Date("2024-01-15T10:30:00Z"),
- *   updatedAt: new Date("2024-01-15T10:32:00Z"),
- *   expiresAt: new Date("2024-01-22T10:30:00Z"),
- *   status: "pending"
- * };
+ * if (isFinalizeOperation(inputData)) {
+ *   console.log("Upload ID:", inputData.uploadId);
+ * }
  * ```
  */
-interface DeadLetterItem {
-  /** Unique DLQ item identifier */
-  id: string;
-  /** Original flow job ID that failed */
-  jobId: string;
-  /** Flow definition ID that was being executed */
-  flowId: string;
-  /** Target storage for the flow */
-  storageId: string;
-  /** Client who initiated the job (null for anonymous) */
-  clientId: string | null;
-  /** Comprehensive error details */
-  error: DeadLetterError;
-  /** Original inputs passed to the flow */
-  inputs: Record<string, unknown>;
-  /** Partial results from nodes that completed before failure */
-  nodeResults: Record<string, unknown>;
-  /** Node where execution failed (if applicable) */
-  failedAtNodeId?: string;
-  /** Number of retry attempts made */
-  retryCount: number;
-  /** Maximum retries allowed from retry policy */
-  maxRetries: number;
-  /** Scheduled time for next automatic retry */
-  nextRetryAt?: Date;
-  /** History of all retry attempts */
-  retryHistory: DeadLetterRetryAttempt[];
-  /** When the item was added to DLQ */
-  createdAt: Date;
-  /** When the item was last modified */
-  updatedAt: Date;
-  /** TTL for automatic cleanup */
-  expiresAt?: Date;
-  /** Current status of the DLQ item */
-  status: DeadLetterItemStatus;
-}
+declare function isFinalizeOperation(data: InputData): data is Extract<InputData, {
+  operation: "finalize";
+}>;
 /**
- * Statistics about the Dead Letter Queue.
+ * Type guard for URL operation (direct file fetch from URL).
  *
- * Provides aggregate information for monitoring and alerting.
+ * Checks if the input data is a URL operation that fetches a file
+ * directly from an external URL.
  *
- * @property totalItems - Total number of items in the DLQ
- * @property byStatus - Count of items by status
- * @property byFlow - Count of items by flow ID
- * @property oldestItem - Timestamp of the oldest item
- * @property averageRetryCount - Average number of retries across all items
+ * @param data - Input data to check
+ * @returns True if data is a URL operation
+ *
+ * @example
+ * ```typescript
+ * if (isUrlOperation(inputData)) {
+ *   console.log("Fetching from:", inputData.url);
+ *   console.log("Optional storage:", inputData.storageId);
+ * }
+ * ```
  */
-interface DeadLetterQueueStats {
-  /** Total number of items in the DLQ */
-  totalItems: number;
-  /** Count of items by status */
-  byStatus: Record<DeadLetterItemStatus, number>;
-  /** Count of items by flow ID */
-  byFlow: Record<string, number>;
-  /** Timestamp of the oldest item */
-  oldestItem?: Date;
-  /** Average number of retries across all items */
-  averageRetryCount: number;
-}
+declare function isUrlOperation(data: InputData): data is Extract<InputData, {
+  operation: "url";
+}>;
 /**
- * Options for listing DLQ items.
+ * Type guard for upload operations (init or url).
  *
- * @property status - Filter by status
- * @property flowId - Filter by flow ID
- * @property clientId - Filter by client ID
- * @property limit - Maximum items to return (default: 50)
- * @property offset - Number of items to skip (default: 0)
+ * Checks if the input data is either an init or URL operation (i.e., operations
+ * that trigger new uploads, as opposed to finalize which completes an existing upload).
+ *
+ * @param data - Input data to check
+ * @returns True if data is an init or URL operation
+ *
+ * @example
+ * ```typescript
+ * if (isUploadOperation(inputData)) {
+ *   // This is a new upload, not a finalization
+ *   if (isInitOperation(inputData)) {
+ *     console.log("Streaming upload");
+ *   } else {
+ *     console.log("URL fetch");
+ *   }
+ * }
+ * ```
  */
-interface DeadLetterListOptions {
-  /** Filter by status */
-  status?: DeadLetterItemStatus;
-  /** Filter by flow ID */
-  flowId?: string;
-  /** Filter by client ID */
-  clientId?: string;
-  /** Maximum items to return (default: 50) */
-  limit?: number;
-  /** Number of items to skip for pagination (default: 0) */
-  offset?: number;
-}
+declare function isUploadOperation(data: InputData): data is Extract<InputData, {
+  operation: "init" | "url";
+}>;
+//#endregion
+//#region src/flow/typed-flow.d.ts
 /**
- * Result of a batch retry operation.
+ * Defines a node that can be used in a typed flow.
  *
- * @property retried - Number of items that were retried
- * @property succeeded - Number of retries that succeeded
- * @property failed - Number of retries that failed
+ * A node definition can be either:
+ * - A plain FlowNode object
+ * - An Effect that resolves to a FlowNode (for nodes requiring dependencies)
+ *
+ * @template TNodeError - The error types that the node can produce
+ * @template TNodeRequirements - The services/dependencies the node requires
  */
-interface DeadLetterRetryAllResult {
-  /** Number of items that were retried */
-  retried: number;
-  /** Number of retries that succeeded */
-  succeeded: number;
-  /** Number of retries that failed */
-  failed: number;
-}
+type NodeDefinition<TNodeError = never, TNodeRequirements = never> = FlowNode<any, any, UploadistaError> | Effect.Effect<FlowNode<any, any, UploadistaError>, TNodeError, TNodeRequirements>;
 /**
- * Result of a cleanup operation.
+ * A record mapping node IDs to their definitions.
  *
- * @property deleted - Number of items that were deleted
+ * This is the primary type used for defining the nodes in a typed flow,
+ * allowing TypeScript to infer input/output schemas and requirements.
+ *
+ * @example
+ * ```typescript
+ * const nodes = {
+ *   input: fileInputNode,
+ *   resize: Effect.succeed(imageResizeNode),
+ *   output: s3OutputNode
+ * } satisfies NodeDefinitionsRecord;
+ * ```
  */
-interface DeadLetterCleanupResult {
-  /** Number of items that were deleted */
-  deleted: number;
-}
+type NodeDefinitionsRecord = Record<string, NodeDefinition<any, any>>;
 /**
- * Options for cleanup operation.
+ * Extracts the error type from a NodeDefinition.
  *
- * @property olderThan - Delete items older than this date
- * @property status - Only delete items with this status
+ * If the node is an Effect, extracts its error type.
+ * If the node is a plain FlowNode, returns never (no errors).
  */
-interface DeadLetterCleanupOptions {
-  /** Delete items older than this date */
-  olderThan?: Date;
-  /** Only delete items with this status */
-  status?: "exhausted" | "resolved";
-}
+type NodeDefinitionError<T> = T extends Effect.Effect<FlowNode<any, any, UploadistaError>, infer TError, any> ? TError : never;
 /**
- * Result of processing scheduled retries.
+ * Extracts the requirements (dependencies) from a NodeDefinition.
  *
- * @property processed - Total items processed
- * @property succeeded - Number that succeeded
- * @property failed - Number that failed
+ * Uses the shared ExtractEffectRequirements utility for consistency.
  */
-interface DeadLetterProcessResult {
-  /** Total items processed */
-  processed: number;
-  /** Number of successful retries */
-  succeeded: number;
-  /** Number of failed retries */
-  failed: number;
-}
-//#endregion
-//#region src/flow/dead-letter-queue.d.ts
+type NodeDefinitionRequirements<T> = ExtractEffectRequirements<T>;
 /**
- * Shape of the Dead Letter Queue service.
+ * Extracts all possible errors from all nodes in a flow as a union.
  *
- * Provides all operations for managing failed flow jobs including
- * adding items, querying, retrying, and cleanup.
+ * This iterates through all nodes in the record and combines their
+ * error types into a single union type.
  */
-interface DeadLetterQueueServiceShape {
-  /**
-   * Add a failed job to the DLQ with full failure context.
-   *
-   * @param job - The failed flow job
-   * @param error - The error that caused the failure
-   * @param retryPolicy - Optional retry policy (uses default if not provided)
-   * @returns The created DLQ item
-   */
-  add(job: FlowJob, error: UploadistaError, retryPolicy?: RetryPolicy): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Get a specific DLQ item by ID.
-   *
-   * @param itemId - The DLQ item ID
-   * @returns The DLQ item
-   */
-  get(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Get a DLQ item by ID, returning None if not found.
-   *
-   * @param itemId - The DLQ item ID
-   * @returns Option of the DLQ item
-   */
-  getOption(itemId: string): Effect.Effect<Option.Option<DeadLetterItem>, UploadistaError>;
-  /**
-   * Delete a DLQ item.
-   *
-   * @param itemId - The DLQ item ID to delete
-   */
-  delete(itemId: string): Effect.Effect<void, UploadistaError>;
-  /**
-   * List DLQ items with optional filtering and pagination.
-   *
-   * @param options - Filter and pagination options
-   * @returns List of items and total count
-   */
-  list(options?: DeadLetterListOptions): Effect.Effect<{
-    items: DeadLetterItem[];
-    total: number;
-  }, UploadistaError>;
-  /**
-   * Update a DLQ item.
-   *
-   * @param itemId - The DLQ item ID
-   * @param updates - Partial updates to apply
-   * @returns The updated item
-   */
-  update(itemId: string, updates: Partial<DeadLetterItem>): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Mark a DLQ item as being retried.
-   *
-   * @param itemId - The DLQ item ID
-   * @returns The updated item with status "retrying"
-   */
-  markRetrying(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Record a failed retry attempt.
-   *
-   * @param itemId - The DLQ item ID
-   * @param error - Error message from the failed retry
-   * @param durationMs - Duration of the retry attempt
-   * @returns The updated item
-   */
-  recordRetryFailure(itemId: string, error: string, durationMs: number): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Mark a DLQ item as resolved (successfully retried or manually resolved).
-   *
-   * @param itemId - The DLQ item ID
-   * @returns The updated item with status "resolved"
-   */
-  markResolved(itemId: string): Effect.Effect<DeadLetterItem, UploadistaError>;
-  /**
-   * Get items that are due for scheduled retry.
-   *
-   * @param limit - Maximum number of items to return
-   * @returns List of items ready for retry
-   */
-  getScheduledRetries(limit?: number): Effect.Effect<DeadLetterItem[], UploadistaError>;
-  /**
-   * Cleanup old DLQ items based on options.
-   *
-   * @param options - Cleanup criteria
-   * @returns Number of items deleted
-   */
-  cleanup(options?: DeadLetterCleanupOptions): Effect.Effect<DeadLetterCleanupResult, UploadistaError>;
-  /**
-   * Get DLQ statistics.
-   *
-   * @returns Aggregate statistics about the DLQ
-   */
-  getStats(): Effect.Effect<DeadLetterQueueStats, UploadistaError>;
-}
-declare const DeadLetterQueueService_base: Context.TagClass<DeadLetterQueueService, "DeadLetterQueueService", DeadLetterQueueServiceShape>;
+type NodesErrorUnion<TNodes extends NodeDefinitionsRecord> = { [K in keyof TNodes]: NodeDefinitionError<TNodes[K]> }[keyof TNodes];
+/**
+ * Extracts all service requirements from all nodes in a flow as a union.
+ *
+ * This iterates through all nodes in the record and combines their
+ * requirement types into a single union type representing all services
+ * needed by the flow.
+ *
+ * @template TNodes - The record of node definitions
+ *
+ * @example
+ * ```typescript
+ * const nodes = {
+ *   resize: imageResizeNode, // requires ImagePlugin
+ *   zip: zipNode,           // requires ZipPlugin
+ * };
+ * type Requirements = NodesRequirementsUnion<typeof nodes>;
+ * // Requirements = ImagePlugin | ZipPlugin
+ * ```
+ */
+type NodesRequirementsUnion<TNodes extends NodeDefinitionsRecord> = { [K in keyof TNodes]: NodeDefinitionRequirements<TNodes[K]> }[keyof TNodes];
 /**
- * Effect-TS context tag for the Dead Letter Queue service.
+ * Extracts all service requirements from a flow's nodes.
+ *
+ * This includes all services required by any node in the flow,
+ * including UploadEngine (which is provided by the runtime).
+ *
+ * @template TNodes - The record of node definitions
  *
  * @example
  * ```typescript
- * const effect = Effect.gen(function* () {
- *   const dlq = yield* DeadLetterQueueService;
- *   const stats = yield* dlq.getStats();
- *   console.log(`DLQ has ${stats.totalItems} items`);
+ * const myFlow = createFlow({
+ *   nodes: {
+ *     input: fileInputNode,
+ *     process: imageProcessNode, // requires ImagePlugin
+ *   },
+ *   edges: [...]
  * });
+ * type AllRequirements = FlowRequirements<typeof myFlow.nodes>;
+ * // AllRequirements = ImagePlugin | UploadEngine
  * ```
  */
-declare class DeadLetterQueueService extends DeadLetterQueueService_base {
+type FlowRequirements<TNodes extends NodeDefinitionsRecord> = NodesRequirementsUnion<TNodes>;
+/**
+ * Extracts plugin service requirements from a flow, excluding UploadEngine.
+ *
+ * This type is useful for determining which plugin layers need to be
+ * provided when creating a server, as UploadEngine is automatically
+ * provided by the runtime.
+ *
+ * @template TNodes - The record of node definitions
+ *
+ * @example
+ * ```typescript
+ * const myFlow = createFlow({
+ *   nodes: {
+ *     resize: imageResizeNode, // requires ImagePlugin
+ *     upload: s3OutputNode,   // requires UploadEngine
+ *   },
+ *   edges: [...]
+ * });
+ * type PluginRequirements = FlowPluginRequirements<typeof myFlow.nodes>;
+ * // PluginRequirements = ImagePlugin (UploadEngine excluded)
+ * ```
+ */
+type FlowPluginRequirements<TNodes extends NodeDefinitionsRecord> = Exclude<FlowRequirements<TNodes>, UploadEngine>;
+/**
+ * Infers the concrete FlowNode type from a NodeDefinition.
+ *
+ * If the definition is already a FlowNode, returns it as-is.
+ * If the definition is an Effect, extracts the FlowNode from the Effect's success type.
+ *
+ * Uses the shared ResolveEffect utility for consistency.
+ */
+type InferNode<T> = T extends FlowNode<any, any, UploadistaError> ? T : ResolveEffect<T> extends FlowNode<any, any, UploadistaError> ? ResolveEffect<T> : never;
+type ExtractKeysByNodeType<TNodes extends NodeDefinitionsRecord, TType extends NodeType> = { [K in keyof TNodes]: InferNode<TNodes[K]>["type"] extends TType ? K : never }[keyof TNodes];
+type SchemaInfer<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+type FlowInputMap<TNodes extends NodeDefinitionsRecord> = { [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]> };
+type FlowOutputMap<TNodes extends NodeDefinitionsRecord> = { [K in Extract<keyof TNodes, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]> };
+type FlowInputUnion<TNodes extends NodeDefinitionsRecord> = { [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]> }[Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>];
+type FlowOutputUnion<TNodes extends NodeDefinitionsRecord> = { [K in Extract<keyof TNodes, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]> }[Extract<keyof TNodes, string>];
+type NodeKey<TNodes extends NodeDefinitionsRecord> = Extract<keyof TNodes, string>;
+type TypedFlowEdge<TNodes extends NodeDefinitionsRecord> = {
+  source: NodeKey<TNodes>;
+  target: NodeKey<TNodes>;
+  sourcePort?: string;
+  targetPort?: string;
+};
+type TypedFlowConfig<TNodes extends NodeDefinitionsRecord> = {
+  flowId: string;
+  name: string;
+  nodes: TNodes;
+  edges: Array<TypedFlowEdge<TNodes>>;
+  typeChecker?: TypeCompatibilityChecker;
+  onEvent?: (event: FlowEvent) => Effect.Effect<{
+    eventId: string | null;
+  }, UploadistaError>;
+  parallelExecution?: {
+    enabled?: boolean;
+    maxConcurrency?: number;
+  };
+  inputSchema?: z.ZodTypeAny;
+  outputSchema?: z.ZodTypeAny;
+  hooks?: {
+    /**
+     * Called when a sink node (terminal node with no outgoing edges) produces an output.
+     * This hook runs after auto-persistence for UploadFile outputs.
+     *
+     * Use this hook to perform additional post-processing such as:
+     * - Saving output metadata to a database
+     * - Tracking outputs in external systems
+     * - Adding custom metadata to outputs
+     * - Triggering downstream workflows
+     *
+     * **Important**: The hook must not have any service requirements (Effect requirements must be `never`).
+     * All necessary services should be captured in the closure when defining the hook.
+     *
+     * @example
+     * ```typescript
+     * // Using Promise (simpler for most users)
+     * hooks: {
+     *   onNodeOutput: async ({ output }) => {
+     *     await db.save(output);
+     *     return output;
+     *   }
+     * }
+     * ```
+     */
+    onNodeOutput?: <TOutput>(context: {
+      output: TOutput;
+      nodeId: string;
+      flowId: string;
+      jobId: string;
+      storageId: string;
+      clientId: string | null;
+    }) => Effect.Effect<TOutput, UploadistaError, never> | Promise<TOutput>;
+  };
   /**
-   * Access the DLQ service optionally (for integration in FlowServer).
-   * Returns Option.none if the service is not provided.
+   * Circuit breaker configuration for resilience against external service failures.
+   *
+   * @example
+   * ```typescript
+   * circuitBreaker: {
+   *   defaults: { enabled: false },
+   *   nodeTypeOverrides: {
+   *     "Describe Image": {
+   *       enabled: true,
+   *       failureThreshold: 5,
+   *       resetTimeout: 60000,
+   *       fallback: { type: "skip", passThrough: true }
+   *     }
+   *   }
+   * }
+   * ```
    */
-  static optional: Effect.Effect<Option.Option<DeadLetterQueueServiceShape>, never, never>;
-}
+  circuitBreaker?: {
+    /** Default circuit breaker config for all nodes */
+    defaults?: FlowCircuitBreakerConfig;
+    /** Override circuit breaker config per node type (node name) */
+    nodeTypeOverrides?: Record<string, FlowCircuitBreakerConfig>;
+  };
+};
+declare const typedFlowInputsSymbol: unique symbol;
+declare const typedFlowOutputsSymbol: unique symbol;
+declare const typedFlowPluginsSymbol: unique symbol;
 /**
- * Creates the Dead Letter Queue service implementation.
+ * A type-safe Flow that infers input/output types and requirements from its nodes.
  *
- * @returns Effect that creates the DLQ service
+ * TypedFlow extends the base Flow type with additional type information that
+ * allows TypeScript to verify inputs, outputs, and plugin requirements at compile time.
+ *
+ * The phantom type properties (using unique symbols) enable type-level metadata
+ * without affecting runtime behavior, allowing other type utilities to extract
+ * this information for validation purposes.
+ *
+ * @template TNodes - Record of node definitions used in the flow
+ * @template TInputSchema - Zod schema for flow inputs (inferred from input nodes)
+ * @template TOutputSchema - Zod schema for flow outputs (inferred from output nodes)
+ *
+ * @example
+ * ```typescript
+ * const myFlow = createFlow({
+ *   nodes: {
+ *     input: fileInputNode,
+ *     resize: imageResizeNode,
+ *     output: s3OutputNode
+ *   },
+ *   edges: [
+ *     { source: 'input', target: 'resize' },
+ *     { source: 'resize', target: 'output' }
+ *   ]
+ * });
+ *
+ * // TypeScript infers:
+ * // - Input types from fileInputNode.inputSchema
+ * // - Output types from s3OutputNode.outputSchema
+ * // - Requirements: ImagePlugin (from resize node)
+ * ```
  */
-declare function createDeadLetterQueueService(): Effect.Effect<DeadLetterQueueServiceShape, never, DeadLetterQueueKVStore>;
+type TypedFlow<TNodes extends NodeDefinitionsRecord, TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny> = Flow<TInputSchema, TOutputSchema, FlowRequirements<TNodes>> & {
+  run: (args: {
+    inputs?: Partial<FlowInputMap<TNodes>>;
+    storageId: string;
+    jobId: string;
+  }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, UploadistaError, FlowRequirements<TNodes>>;
+  resume: (args: {
+    jobId: string;
+    storageId: string;
+    nodeResults: Record<string, unknown>;
+    executionState: {
+      executionOrder: string[];
+      currentIndex: number;
+      inputs: Partial<FlowInputMap<TNodes>>;
+    };
+  }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, UploadistaError, FlowRequirements<TNodes>>;
+  readonly [typedFlowInputsSymbol]?: FlowInputMap<TNodes>;
+  readonly [typedFlowOutputsSymbol]?: FlowOutputMap<TNodes>;
+  readonly [typedFlowPluginsSymbol]?: FlowPluginRequirements<TNodes>;
+};
+declare function createFlow<TNodes extends NodeDefinitionsRecord>(config: TypedFlowConfig<TNodes>): Effect.Effect<TypedFlow<TNodes, z.ZodType<FlowInputUnion<TNodes>>, z.ZodType<FlowOutputUnion<TNodes>>>, NodesErrorUnion<TNodes> | UploadistaError, FlowRequirements<TNodes>>;
+//#endregion
+//#region src/flow/types/run-args.d.ts
 /**
- * Effect Layer that creates the DeadLetterQueueService.
+ * Zod schema for validating flow run arguments.
+ *
+ * @property inputs - Record mapping input node IDs to their input data
  *
  * @example
  * ```typescript
- * const program = Effect.gen(function* () {
- *   const dlq = yield* DeadLetterQueueService;
- *   const stats = yield* dlq.getStats();
- *   return stats;
- * }).pipe(
- *   Effect.provide(deadLetterQueueService),
- *   Effect.provide(deadLetterQueueKvStore),
- *   Effect.provide(baseStoreLayer)
- * );
+ * const args = {
+ *   inputs: {
+ *     "input-node-1": { file: myFile, metadata: { ... } },
+ *     "input-node-2": { file: anotherFile }
+ *   }
+ * };
+ *
+ * // Validate before running
+ * const validated = runArgsSchema.parse(args);
  * ```
  */
-declare const deadLetterQueueService: Layer.Layer<DeadLetterQueueService, never, DeadLetterQueueKVStore>;
-//#endregion
-//#region src/flow/utils/resolve-upload-metadata.d.ts
-type FileMetadata = UploadFile["metadata"];
-type ResolvedUploadMetadata = {
-  type: string;
-  fileName: string;
-  metadata: FileMetadata;
-  metadataJson: string | undefined;
-};
-declare function resolveUploadMetadata(metadata: FileMetadata): ResolvedUploadMetadata;
+declare const runArgsSchema: z.ZodObject<{
+  inputs: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+/**
+ * Type representing validated flow run arguments.
+ *
+ * This type is inferred from the runArgsSchema and ensures type safety
+ * when passing inputs to flow execution.
+ */
+type RunArgs = z.infer<typeof runArgsSchema>;
 //#endregion
 //#region src/flow/utils/file-naming.d.ts
 /**
@@ -8669,5 +8659,15 @@ declare const AVAILABLE_TEMPLATE_VARIABLES: readonly [{
   readonly example: "1";
 }];
 //#endregion
-export { DescribeImageParams as $, memoryCircuitBreakerStoreLayer as $a, FlowDeadLetterQueueConfig as $i, FlowProviderShape as $n, UploadEvent as $r, resizeTransformSchema as $t, NodeDefinition as A, FlowEventFlowError as Aa, DataStore as Ai, CredentialProvider as An, CircuitBreakerHealthSummary as Ar, ImagePluginShape as At, getOutputByNodeId as B, FlowEventNodeStart as Ba, UploadStrategy as Bi, createTransformNode as Bn, getHealthResponseFormat as Br, SepiaTransform as Bt, DeadLetterRetryAttempt as C, FlowEventDlqItemExhausted as Ca, FlowData as Ci, DocumentAiPlugin as Cn, CircuitBreakerEventHandler as Co, Middleware as Cr, resizeVideoParamsSchema as Ct, FlowOutputMap as D, FlowEventDlqRetrySuccess as Da, BufferedUploadFileDataStore as Di, OcrResolution as Dn, MiddlewareServiceLive as Dr, describeVideoMetadataSchema as Dt, FlowInputMap as E, FlowEventDlqRetryStart as Ea, getFlowData as Ei, OcrParams as En, DEFAULT_CIRCUIT_BREAKER_CONFIG as Eo, MiddlewareService as Er, DescribeVideoMetadata as Et, createFlow as F, FlowEventNodeEnd as Fa, StreamWriteResult as Fi, ParallelSchedulerConfig as Fn, HealthComponents as Fr, GrayscaleTransform as Ft, isInitOperation as G, createFlowNode as Ga, AutoNamingSuffixGenerator as Gi, ResolveEffect as Gn, TypedEventEmitter as Gr, TransformationType as Gt, hasOutputOfType as H, ConditionOperator as Ha, isDataStore as Hi, ExtractEffectRequirements as Hn, BaseEventEmitterService as Hr, TextTransform as Ht, NarrowedTypedOutput as I, FlowEventNodeError as Ia, StreamingConfig as Ii, StreamingTransformFn as In, HealthResponse as Ir, LogoTransform as It, isUploadFile as J, DistributedCircuitBreaker as Ja, FileNamingConfig as Ji, InputNodeParams as Jn, flowEventEmitter as Jr, brightnessTransformSchema as Jt, isOcrOutput as K, getNodeData as Ka, BuiltInTypedOutput as Ki, FlowCondition as Kn, UploadEventEmitter as Kr, WatermarkTransform as Kt, createTypeGuard as L, FlowEventNodePause as La, UploadFileDataStore as Li, StreamingTransformResult as Ln, HealthResponseFormat as Lr, OverlayPosition as Lt, TypedFlow as M, FlowEventFlowStart as Ma, DataStoreConfig as Mi, CredentialProviderShape as Mn, DEFAULT_HEALTH_CHECK_CONFIG as Mr, BrightnessTransform as Mt, TypedFlowConfig as N, FlowEventJobEnd as Na, DataStoreWriteOptions as Ni, ExecutionLevel as Nn, DlqHealthSummary as Nr, ContrastTransform as Nt, FlowPluginRequirements as O, FlowEventFlowCancel as Oa, DEFAULT_MULTIPART_PART_SIZE as Oi, OcrResult as On, InputFile as Or, ImagePlugin as Ot, TypedFlowEdge as P, FlowEventJobStart as Pa, StreamWriteOptions as Pi, ParallelScheduler as Pn, HealthCheckConfig as Pr, FlipTransform as Pt, removeBackgroundParamsSchema as Q, makeMemoryCircuitBreakerStore as Qa, FlowConfig as Qi, FlowProvider as Qn, webSocketMessageSchema as Qr, logoTransformSchema as Qt, filterOutputsByType as R, FlowEventNodeResponse as Ra, UploadFileDataStores as Ri, TransformMode as Rn, HealthStatus as Rr, ResizeTransform as Rt, DeadLetterRetryAllResult as S, FlowEventDlqItemAdded as Sa, Flow as Si, DocumentAiContext as Sn, CircuitBreakerEvent as So, detectMimeType as Sr, ResizeVideoParams as St, runArgsSchema as T, FlowEventDlqRetryFailed as Ta, createFlowWithSchema as Ti, DocumentAiPluginShape as Tn, CircuitBreakerState as To, MiddlewareNext as Tr, extractFrameVideoParamsSchema as Tt, isFinalizeOperation as U, ConditionValue as Ua, FlowEdge as Ui, ExtractLayerService as Un, EventEmitter as Ur, TransformImageParams as Ut, getSingleOutputByType as V, ConditionField as Va, createDataStoreLayer as Vi, ExtractEffectError as Vn, BaseEventEmitter as Vr, SharpenTransform as Vt, isImageDescriptionOutput as W, NodeType as Wa, createFlowEdge as Wi, ExtractLayerServices as Wn, FlowEventEmitter as Wr, Transformation as Wt, isUrlOperation as X, kvCircuitBreakerStoreLayer as Xa, FlowCircuitBreakerConfig as Xi, inputDataSchema as Xn, WebSocketConnection as Xr, flipTransformSchema as Xt, isUploadOperation as Y, DistributedCircuitBreakerRegistry as Ya, FileNamingFunction as Yi, createInputNode as Yn, uploadEventEmitter as Yr, contrastTransformSchema as Yt, RemoveBackgroundParams as Z, makeKvCircuitBreakerStore as Za, FlowCircuitBreakerFallback as Zi, inputNodeParamsSchema as Zn, WebSocketMessage as Zr, grayscaleTransformSchema as Zt, DeadLetterItem as _, calculateExpirationDate as _a, InputTypeDefinition as _i, DocumentPluginLayer as _n, UploadFile as _o, UploadServerOptions as _r, VideoStreamOptions as _t, getExtension as a, NodeTypeMap as aa, ImageDescriptionOutput as ai, transformationSchema as an, createInitialCircuitBreakerState as ao, WaitUntilCallback as ar, ZipPlugin as at, DeadLetterProcessResult as b, EventType as ba, inputTypeRegistry as bi, SplitPdfParams as bn, uploadFileSchema as bo, uploadServer as br, TranscodeVideoParams as bt, ResolvedUploadMetadata as c, completeNodeExecution as ca, STORAGE_OUTPUT_TYPE_ID as ci, resizeParamsSchema as cn, DeadLetterQueueKVStore as co, FlowJob as cr, ScanMetadata as ct, DeadLetterQueueServiceShape as d, DEFAULT_RETRY_POLICY as da, ocrOutputSchema as di, ImageAiContext as dn, TypedKvStore as do, FlowJobTaskStatus as dr, VirusScanPluginLayer as dt, FlowNode as ea, UploadEventType as ei, rotateTransformSchema as en, CircuitBreakerStateData as eo, FlowServer as er, describeImageParamsSchema as et, createDeadLetterQueueService as f, ExponentialBackoff as fa, OutputTypeDefinition as fi, ImageAiPlugin as fn, UploadFileKVStore as fo, FlowJobTraceContext as fr, VirusScanPluginShape as ft, DeadLetterError as g, calculateBackoffDelay as ga, validateFlowOutput as gi, DocumentPlugin as gn, uploadFileKvStore as go, UploadServer as gr, VideoStreamInput as gt, DeadLetterCleanupResult as h, RetryPolicy as ha, outputTypeRegistry as hi, DocumentMetadata as hn, jsonSerializer as ho, UploadStrategyOptions as hr, VideoPluginShape as ht, getBaseName as i, NodeExecutionResult as ia, IMAGE_DESCRIPTION_OUTPUT_TYPE_ID as ii, transformImageParamsSchema as in, CircuitBreakerStoreService as io, FlowWaitUntil as ir, ZipParams as it, NodeDefinitionsRecord as j, FlowEventFlowPause as ja, DataStoreCapabilities as ji, CredentialProviderLayer as jn, ComponentHealth as jr, BlurTransform as jt, FlowRequirements as k, FlowEventFlowEnd as ka, DEFAULT_STREAMING_CONFIG as ki, OcrTaskType as kn, inputFileSchema as kr, ImagePluginLayer as kt, resolveUploadMetadata as l, waitingNodeExecution as la, STREAMING_INPUT_TYPE_ID as li, OptimizeParams as ln, FlowJobKVStore as lo, FlowJobStatus as lr, ScanResult as lt, DeadLetterCleanupOptions as m, ImmediateBackoff as ma, OutputValidationResult as mi, ImageAiPluginShape as mn, flowJobKvStore as mo, UploadStrategyNegotiator as mr, VideoPluginLayer as mt, applyFileNaming as n, NamingContext as na, EventBroadcaster as ni, sharpenTransformSchema as nn, CircuitBreakerStats as no, FlowServerOptions as nr, PluginLayer as nt, interpolateFileName as o, TypeCompatibilityChecker as oa, OCR_OUTPUT_TYPE_ID as oi, watermarkTransformSchema as on, BaseKvStore as oo, createFlowServer as or, ZipPluginLayer as ot, deadLetterQueueService as p, FixedBackoff as pa, OutputTypeRegistry as pi, ImageAiPluginLayer as pn, deadLetterQueueKvStore as po, NegotiatedStrategy as pr, VideoPlugin as pt, isStorageOutput as q, AllowRequestResult as qa, CustomTypedOutput as qi, InputData as qn, eventToMessageSerializer as qr, blurTransformSchema as qt, buildNamingContext as r, NodeConnectionValidator as ra, EventBroadcasterService as ri, textTransformSchema as rn, CircuitBreakerStore as ro, FlowServerShape as rr, ZipInput as rt, validatePattern as s, TypedOutput as sa, OcrOutput as si, ResizeParams as sn, BaseKvStoreService as so, flowServer as sr, ZipPluginShape as st, AVAILABLE_TEMPLATE_VARIABLES as t, FlowNodeData as ta, uploadEventSchema as ti, sepiaTransformSchema as tn, CircuitBreakerStateValue as to, FlowServerLayer as tr, Plugin as tt, DeadLetterQueueService as u, BackoffStrategy as ua, imageDescriptionOutputSchema as ui, optimizeParamsSchema as un, KvStore as uo, FlowJobTask as ur, VirusScanPlugin as ut, DeadLetterItemStatus as v, isErrorRetryable as va, InputTypeRegistry as vi, DocumentPluginShape as vn, UploadFileTraceContext as vo, UploadServerShape as vr, TrimVideoParams as vt, RunArgs as w, FlowEventDlqItemResolved as wa, FlowExecutionResult as wi, DocumentAiPluginLayer as wn, CircuitBreakerFallback as wo, MiddlewareContext as wr, ExtractFrameVideoParams as wt, DeadLetterQueueStats as x, FlowEvent as xa, validateFlowInput as xi, SplitPdfResult as xn, CircuitBreakerConfig as xo, compareMimeTypes as xr, transcodeVideoParamsSchema as xt, DeadLetterListOptions as y, DlqEvent as ya, InputValidationResult as yi, MergePdfParams as yn, traceContextSchema as yo, createUploadServer as yr, trimVideoParamsSchema as yt, getFirstOutputByType as z, FlowEventNodeResume as za, UploadFileDataStoresShape as zi, TransformNodeConfig as zn, formatHealthAsText as zr, RotateTransform as zt };
-//# sourceMappingURL=index-DjhpgW08.d.cts.map
+//#region src/flow/utils/resolve-upload-metadata.d.ts
+type FileMetadata = UploadFile["metadata"];
+type ResolvedUploadMetadata = {
+  type: string;
+  fileName: string;
+  metadata: FileMetadata;
+  metadataJson: string | undefined;
+};
+declare function resolveUploadMetadata(metadata: FileMetadata): ResolvedUploadMetadata;
+//#endregion
+export { VideoPlugin as $, memoryCircuitBreakerStoreLayer as $a, FlowDeadLetterQueueConfig as $i, UploadEngineShape as $n, DeadLetterListOptions as $r, ImageAiPluginLayer as $t, isImageDescriptionOutput as A, FlowEventFlowError as Aa, DataStore as Ai, ExtractLayerServices as An, uploadEventEmitter as Ar, Transformation as At, describeImageParamsSchema as B, FlowEventNodeStart as Ba, UploadStrategy as Bi, FlowEngineOptions as Bn, DeadLetterQueueServiceShape as Br, rotateTransformSchema as Bt, createTypeGuard as C, FlowEventDlqItemExhausted as Ca, FlowData as Ci, StreamingTransformResult as Cn, CircuitBreakerEventHandler as Co, BaseEventEmitterService as Cr, OverlayPosition as Ct, getSingleOutputByType as D, FlowEventDlqRetrySuccess as Da, BufferedUploadFileDataStore as Di, ExtractEffectError as Dn, UploadEventEmitter as Dr, SharpenTransform as Dt, getOutputByNodeId as E, FlowEventDlqRetryStart as Ea, getFlowData as Ei, createTransformNode as En, DEFAULT_CIRCUIT_BREAKER_CONFIG as Eo, TypedEventEmitter as Er, SepiaTransform as Et, isUploadOperation as F, FlowEventNodeEnd as Fa, StreamWriteResult as Fi, createInputNode as Fn, UploadEventType as Fr, contrastTransformSchema as Ft, ZipPlugin as G, createFlowNode as Ga, AutoNamingSuffixGenerator as Gi, WaitUntilCallback as Gn, FlowJobTask as Gr, transformationSchema as Gt, PluginLayer as H, ConditionOperator as Ha, isDataStore as Hi, FlowProvider as Hn, deadLetterQueueService as Hr, sharpenTransformSchema as Ht, isUrlOperation as I, FlowEventNodeError as Ia, StreamingConfig as Ii, inputDataSchema as In, uploadEventSchema as Ir, flipTransformSchema as It, ScanMetadata as J, DistributedCircuitBreaker as Ja, FileNamingConfig as Ji, NegotiatedStrategy as Jn, DeadLetterCleanupOptions as Jr, resizeParamsSchema as Jt, ZipPluginLayer as K, getNodeData as Ka, BuiltInTypedOutput as Ki, createFlowEngine as Kn, FlowJobTaskStatus as Kr, watermarkTransformSchema as Kt, RemoveBackgroundParams as L, FlowEventNodePause as La, UploadFileDataStore as Li, inputNodeParamsSchema as Ln, EventBroadcaster as Lr, grayscaleTransformSchema as Lt, isOcrOutput as M, FlowEventFlowStart as Ma, DataStoreConfig as Mi, FlowCondition as Mn, WebSocketMessage as Mr, WatermarkTransform as Mt, isStorageOutput as N, FlowEventJobEnd as Na, DataStoreWriteOptions as Ni, InputData as Nn, webSocketMessageSchema as Nr, blurTransformSchema as Nt, hasOutputOfType as O, FlowEventFlowCancel as Oa, DEFAULT_MULTIPART_PART_SIZE as Oi, ExtractEffectRequirements as On, eventToMessageSerializer as Or, TextTransform as Ot, isUploadFile as P, FlowEventJobStart as Pa, StreamWriteOptions as Pi, InputNodeParams as Pn, UploadEvent as Pr, brightnessTransformSchema as Pt, VirusScanPluginShape as Q, makeMemoryCircuitBreakerStore as Qa, FlowConfig as Qi, UploadEngineOptions as Qn, DeadLetterItemStatus as Qr, ImageAiPlugin as Qt, removeBackgroundParamsSchema as R, FlowEventNodeResponse as Ra, UploadFileDataStores as Ri, FlowEngine as Rn, EventBroadcasterService as Rr, logoTransformSchema as Rt, NarrowedTypedOutput as S, FlowEventDlqItemAdded as Sa, Flow as Si, StreamingTransformFn as Sn, CircuitBreakerEvent as So, BaseEventEmitter as Sr, LogoTransform as St, getFirstOutputByType as T, FlowEventDlqRetryFailed as Ta, createFlowWithSchema as Ti, TransformNodeConfig as Tn, CircuitBreakerState as To, FlowEventEmitter as Tr, RotateTransform as Tt, ZipInput as U, ConditionValue as Ua, FlowEdge as Ui, FlowProviderShape as Un, FlowJob as Ur, textTransformSchema as Ut, Plugin as V, ConditionField as Va, createDataStoreLayer as Vi, FlowEngineShape as Vn, createDeadLetterQueueService as Vr, sepiaTransformSchema as Vt, ZipParams as W, NodeType as Wa, createFlowEdge as Wi, FlowWaitUntil as Wn, FlowJobStatus as Wr, transformImageParamsSchema as Wt, VirusScanPlugin as X, kvCircuitBreakerStoreLayer as Xa, FlowCircuitBreakerConfig as Xi, UploadStrategyOptions as Xn, DeadLetterError as Xr, optimizeParamsSchema as Xt, ScanResult as Y, DistributedCircuitBreakerRegistry as Ya, FileNamingFunction as Yi, UploadStrategyNegotiator as Yn, DeadLetterCleanupResult as Yr, OptimizeParams as Yt, VirusScanPluginLayer as Z, makeKvCircuitBreakerStore as Za, FlowCircuitBreakerFallback as Zi, UploadEngine as Zn, DeadLetterItem as Zr, ImageAiContext as Zt, NodeDefinitionsRecord as _, calculateExpirationDate as _a, InputTypeDefinition as _i, CredentialProviderLayer as _n, UploadFile as _o, HealthResponse as _r, BlurTransform as _t, buildNamingContext as a, NodeTypeMap as aa, ImageDescriptionOutput as ai, MergePdfParams as an, createInitialCircuitBreakerState as ao, MiddlewareContext as ar, trimVideoParamsSchema as at, TypedFlowEdge as b, EventType as ba, inputTypeRegistry as bi, ParallelScheduler as bn, uploadFileSchema as bo, formatHealthAsText as br, FlipTransform as bt, interpolateFileName as c, completeNodeExecution as ca, STORAGE_OUTPUT_TYPE_ID as ci, DocumentAiContext as cn, DeadLetterQueueKVStore as co, MiddlewareServiceLive as cr, ResizeVideoParams as ct, runArgsSchema as d, DEFAULT_RETRY_POLICY as da, ocrOutputSchema as di, DocumentAiPluginShape as dn, TypedKvStore as do, CircuitBreakerHealthSummary as dr, extractFrameVideoParamsSchema as dt, FlowNode as ea, DeadLetterProcessResult as ei, ImageAiPluginShape as en, CircuitBreakerStateData as eo, createUploadEngine as er, VideoPluginLayer as et, FlowInputMap as f, ExponentialBackoff as fa, OutputTypeDefinition as fi, OcrParams as fn, UploadFileKVStore as fo, ComponentHealth as fr, DescribeVideoMetadata as ft, NodeDefinition as g, calculateBackoffDelay as ga, validateFlowOutput as gi, CredentialProvider as gn, uploadFileKvStore as go, HealthComponents as gr, ImagePluginShape as gt, FlowRequirements as h, RetryPolicy as ha, outputTypeRegistry as hi, OcrTaskType as hn, jsonSerializer as ho, HealthCheckConfig as hr, ImagePluginLayer as ht, applyFileNaming as i, NodeExecutionResult as ia, IMAGE_DESCRIPTION_OUTPUT_TYPE_ID as ii, DocumentPluginShape as in, CircuitBreakerStoreService as io, Middleware as ir, TrimVideoParams as it, isInitOperation as j, FlowEventFlowPause as ja, DataStoreCapabilities as ji, ResolveEffect as jn, WebSocketConnection as jr, TransformationType as jt, isFinalizeOperation as k, FlowEventFlowEnd as ka, DEFAULT_STREAMING_CONFIG as ki, ExtractLayerService as kn, flowEventEmitter as kr, TransformImageParams as kt, validatePattern as l, waitingNodeExecution as la, STREAMING_INPUT_TYPE_ID as li, DocumentAiPlugin as ln, FlowJobKVStore as lo, InputFile as lr, resizeVideoParamsSchema as lt, FlowPluginRequirements as m, ImmediateBackoff as ma, OutputValidationResult as mi, OcrResult as mn, flowJobKvStore as mo, DlqHealthSummary as mr, ImagePlugin as mt, resolveUploadMetadata as n, NamingContext as na, DeadLetterRetryAllResult as ni, DocumentPlugin as nn, CircuitBreakerStats as no, compareMimeTypes as nr, VideoStreamInput as nt, getBaseName as o, TypeCompatibilityChecker as oa, OCR_OUTPUT_TYPE_ID as oi, SplitPdfParams as on, BaseKvStore as oo, MiddlewareNext as or, TranscodeVideoParams as ot, FlowOutputMap as p, FixedBackoff as pa, OutputTypeRegistry as pi, OcrResolution as pn, deadLetterQueueKvStore as po, DEFAULT_HEALTH_CHECK_CONFIG as pr, describeVideoMetadataSchema as pt, ZipPluginShape as q, AllowRequestResult as qa, CustomTypedOutput as qi, flowEngine as qn, FlowJobTraceContext as qr, ResizeParams as qt, AVAILABLE_TEMPLATE_VARIABLES as r, NodeConnectionValidator as ra, DeadLetterRetryAttempt as ri, DocumentPluginLayer as rn, CircuitBreakerStore as ro, detectMimeType as rr, VideoStreamOptions as rt, getExtension as s, TypedOutput as sa, OcrOutput as si, SplitPdfResult as sn, BaseKvStoreService as so, MiddlewareService as sr, transcodeVideoParamsSchema as st, ResolvedUploadMetadata as t, FlowNodeData as ta, DeadLetterQueueStats as ti, DocumentMetadata as tn, CircuitBreakerStateValue as to, uploadEngine as tr, VideoPluginShape as tt, RunArgs as u, BackoffStrategy as ua, imageDescriptionOutputSchema as ui, DocumentAiPluginLayer as un, KvStore as uo, inputFileSchema as ur, ExtractFrameVideoParams as ut, TypedFlow as v, isErrorRetryable as va, InputTypeRegistry as vi, CredentialProviderShape as vn, UploadFileTraceContext as vo, HealthResponseFormat as vr, BrightnessTransform as vt, filterOutputsByType as w, FlowEventDlqItemResolved as wa, FlowExecutionResult as wi, TransformMode as wn, CircuitBreakerFallback as wo, EventEmitter as wr, ResizeTransform as wt, createFlow as x, FlowEvent as xa, validateFlowInput as xi, ParallelSchedulerConfig as xn, CircuitBreakerConfig as xo, getHealthResponseFormat as xr, GrayscaleTransform as xt, TypedFlowConfig as y, DlqEvent as ya, InputValidationResult as yi, ExecutionLevel as yn, traceContextSchema as yo, HealthStatus as yr, ContrastTransform as yt, DescribeImageParams as z, FlowEventNodeResume as za, UploadFileDataStoresShape as zi, FlowEngineLayer as zn, DeadLetterQueueService as zr, resizeTransformSchema as zt };
+//# sourceMappingURL=index-DMqaf28W.d.cts.map