@ductape/sdk 0.0.4-v9 → 0.0.4-v90

package/dist/workflows/types/workflows.types.d.ts

@@ -0,0 +1,1037 @@
+/**
+ * Workflow Service Types
+ *
+ * Type definitions for the Ductape Workflows code-first API.
+ */
+import { IProductWorkflow, IProductWorkflowStep, IWorkflowOptions, IWorkflowSignal, IWorkflowQuery, IWorkflowEnv, IWorkflowStepOptions, IWorkflowStepRollback, WorkflowStepType, WorkflowRollbackStrategy, WorkflowStatus, IActionRequest, INotificationRequest, IDbActionRequest, IStorageRequest } from '../../types';
+/**
+ * Configuration options for WorkflowService initialization
+ */
+export interface IWorkflowServiceConfig {
+    /** Workspace ID */
+    workspace_id: string;
+    /** Public key for authentication */
+    public_key: string;
+    /** User ID */
+    user_id: string;
+    /** Authentication token */
+    token: string;
+    /** Environment type (staging, production, local) */
+    env_type: string;
+    /** Optional Redis client for caching */
+    redis_client?: any;
+}
+/**
+ * Workflow configuration for local registration
+ */
+export interface IWorkflowConfig {
+    /** Human-readable name */
+    name: string;
+    /** Unique workflow tag */
+    tag: string;
+    /** Description */
+    description?: string;
+    /** Input schema */
+    input?: Record<string, unknown>;
+    /** Output schema */
+    output?: Record<string, unknown>;
+    /** Workflow steps */
+    steps: IProductWorkflowStep[];
+    /** Signal definitions */
+    signals?: Record<string, IWorkflowSignal>;
+    /** Query definitions */
+    queries?: Record<string, IWorkflowQuery>;
+    /** Workflow options */
+    options?: IWorkflowOptions;
+    /** Environment configurations */
+    envs?: IWorkflowEnv[];
+}
+/**
+ * Additional context metadata for workflow execution
+ */
+export interface IWorkflowContextMeta {
+    /** Request ID */
+    request_id?: string;
+    /** Correlation ID */
+    correlation_id?: string;
+    /** Parent workflow ID (for child workflows) */
+    parent_workflow_id?: string;
+    /** Parent step tag (for child workflows) */
+    parent_step_tag?: string;
+    /** Custom metadata */
+    [key: string]: unknown;
+}
+/**
+ * Logger interface for workflow execution
+ */
+export interface IWorkflowLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Wait options for signals
+ */
+export interface IWaitOptions {
+    /** Timeout duration (ms or duration string like '1h', '30m') */
+    timeout?: number | string;
+}
+/**
+ * Child workflow options
+ */
+export interface IChildWorkflowOptions {
+    /** Timeout for child workflow */
+    timeout?: number | string;
+    /** Number of retries */
+    retries?: number;
+    /** How to handle parent cancellation */
+    parent_close_policy?: 'terminate' | 'abandon' | 'request_cancel';
+    /** Idempotency key */
+    idempotency_key?: string;
+}
+/**
+ * Rollback result
+ */
+export interface IRollbackResult {
+    /** Whether rollback was successful */
+    success: boolean;
+    /** Steps that were rolled back */
+    rolled_back_steps: string[];
+    /** Steps that failed to rollback */
+    failed_steps?: Array<{
+        tag: string;
+        error: string;
+    }>;
+    /** Reason for triggering rollback */
+    reason: string;
+}
+/**
+ * Action context for workflow steps
+ */
+export interface IWorkflowActionContext {
+    run<T>(options: {
+        app: string;
+        event: string;
+        input: IActionRequest;
+        retries?: number;
+        timeout?: number;
+    }): Promise<T>;
+}
+/**
+ * Database context for workflow steps
+ */
+export interface IWorkflowDatabaseContext {
+    execute<T>(options: {
+        database: string;
+        event: string;
+        input: IDbActionRequest;
+        retries?: number;
+        timeout?: number;
+    }): Promise<T>;
+    query<T>(options: {
+        database: string;
+        event: string;
+        params?: Record<string, unknown>;
+    }): Promise<T[]>;
+    insert<T>(options: {
+        database: string;
+        event: string;
+        data: Record<string, unknown>;
+    }): Promise<T>;
+    update<T>(options: {
+        database: string;
+        event: string;
+        data: Record<string, unknown>;
+        where: Record<string, unknown>;
+    }): Promise<T>;
+    delete(options: {
+        database: string;
+        event: string;
+        where: Record<string, unknown>;
+    }): Promise<boolean>;
+}
+/**
+ * Graph context for workflow steps
+ */
+export interface IWorkflowGraphContext {
+    execute<T>(options: {
+        graph: string;
+        action: string;
+        input: Record<string, unknown>;
+    }): Promise<T>;
+    createNode<T>(options: {
+        graph: string;
+        labels: string[];
+        properties: Record<string, unknown>;
+    }): Promise<T>;
+    updateNode<T>(options: {
+        graph: string;
+        id: string | number;
+        properties: Record<string, unknown>;
+    }): Promise<T>;
+    deleteNode(options: {
+        graph: string;
+        id: string | number;
+    }): Promise<void>;
+    createRelationship<T>(options: {
+        graph: string;
+        from: string;
+        to: string;
+        type: string;
+        properties?: Record<string, unknown>;
+    }): Promise<T>;
+    deleteRelationship(options: {
+        graph: string;
+        id: string | number;
+    }): Promise<void>;
+    query<T>(options: {
+        graph: string;
+        action: string;
+        params?: Record<string, unknown>;
+    }): Promise<T[]>;
+}
+/**
+ * Notification context for workflow steps
+ */
+export interface IWorkflowNotificationContext {
+    send(options: {
+        notification: string;
+        event: string;
+        input: INotificationRequest;
+        retries?: number;
+    }): Promise<void>;
+    email(options: {
+        notification: string;
+        event: string;
+        recipients: string[];
+        subject: Record<string, unknown>;
+        template: Record<string, unknown>;
+    }): Promise<void>;
+    push(options: {
+        notification: string;
+        event: string;
+        tokens: string[];
+        title: Record<string, unknown>;
+        body: Record<string, unknown>;
+        data?: Record<string, unknown>;
+    }): Promise<void>;
+    sms(options: {
+        notification: string;
+        event: string;
+        phones: string[];
+        message: Record<string, unknown>;
+    }): Promise<void>;
+}
+/**
+ * Storage context for workflow steps
+ */
+export interface IWorkflowStorageContext {
+    upload(options: {
+        storage: string;
+        event: string;
+        input: IStorageRequest;
+        retries?: number;
+    }): Promise<IFileUploadResult>;
+    download(options: {
+        storage: string;
+        event: string;
+        input: IStorageRequest;
+    }): Promise<IFileDownloadResult>;
+    delete(options: {
+        storage: string;
+        event: string;
+        input: {
+            file_key: string;
+        };
+    }): Promise<void>;
+}
+/**
+ * Publish context for workflow steps
+ */
+export interface IWorkflowPublishContext {
+    send(options: {
+        broker: string;
+        event: string;
+        input: {
+            message: Record<string, unknown>;
+        };
+        retries?: number;
+    }): Promise<void>;
+}
+/**
+ * Feature context for workflow steps
+ */
+export interface IWorkflowFeatureContext {
+    run<T>(options: {
+        feature: string;
+        input: Record<string, unknown>;
+        retries?: number;
+        timeout?: number;
+    }): Promise<T>;
+}
+/**
+ * Quota context for workflow steps
+ */
+export interface IWorkflowQuotaContext {
+    execute<T>(options: {
+        quota: string;
+        input: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
+}
+/**
+ * Fallback context for workflow steps
+ */
+export interface IWorkflowFallbackContext {
+    execute<T>(options: {
+        fallback: string;
+        input: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
+}
+/**
+ * Healthcheck context for workflow steps
+ */
+export interface IWorkflowHealthcheckContext {
+    getStatus(tag: string): Promise<{
+        status: 'available' | 'unavailable';
+        lastChecked?: string;
+        lastLatency?: number;
+    }>;
+}
+/**
+ * Transform context for data transformations
+ */
+export interface ITransformContext {
+    /** Get the number of keys in an object */
+    size(obj: Record<string, unknown>): number;
+    /** Get the length of an array or string */
+    length(arr: unknown[] | string): number;
+    /** Parse JSON string */
+    parseJson<T>(str: string): T;
+    /** Stringify to JSON */
+    stringify(obj: unknown): string;
+    /** Convert to uppercase */
+    upper(str: string): string;
+    /** Convert to lowercase */
+    lower(str: string): string;
+    /** Trim whitespace */
+    trim(str: string): string;
+    /** Split string */
+    split(str: string, separator: string): string[];
+    /** Join array */
+    join(arr: string[], separator: string): string;
+    /** Get current timestamp */
+    now(): number;
+    /** Format date */
+    formatDate(date: Date | number | string, format: string): string;
+}
+/**
+ * File upload result
+ */
+export interface IFileUploadResult {
+    file_key: string;
+    url?: string;
+    size?: number;
+    content_type?: string;
+}
+/**
+ * File download result
+ */
+export interface IFileDownloadResult {
+    content: Buffer | string;
+    content_type?: string;
+    size?: number;
+}
+/**
+ * Full workflow context interface
+ */
+export interface IWorkflowContext<TInput = Record<string, unknown>> {
+    /** Workflow input (read-only) */
+    readonly input: TInput;
+    /** Workflow metadata */
+    readonly workflow_id: string;
+    readonly workflow_tag: string;
+    readonly env: string;
+    readonly product: string;
+    readonly context: IWorkflowContextMeta;
+    /** Execution state */
+    readonly state: Record<string, unknown>;
+    readonly steps: Record<string, unknown>;
+    readonly completed_steps: string[];
+    readonly current_step: string | null;
+    /** Session token in format: session_tag:jwt_token */
+    readonly session?: string;
+    /** Step execution */
+    step<T>(tag: string, handler: () => Promise<T>, rollback?: ((result: T) => Promise<void>) | null, options?: IWorkflowStepOptions): Promise<T>;
+    /** Ductape components */
+    action: IWorkflowActionContext;
+    database: IWorkflowDatabaseContext;
+    graph: IWorkflowGraphContext;
+    notification: IWorkflowNotificationContext;
+    storage: IWorkflowStorageContext;
+    publish: IWorkflowPublishContext;
+    feature: IWorkflowFeatureContext;
+    /** Resilience components */
+    quota: IWorkflowQuotaContext;
+    fallback: IWorkflowFallbackContext;
+    healthcheck: IWorkflowHealthcheckContext;
+    /** Data transformations */
+    transform: ITransformContext;
+    /** Data references */
+    variable(app: string, key: string): unknown;
+    constant(app: string, key: string): unknown;
+    token(key: string): string;
+    auth: Record<string, unknown>;
+    default<T>(value: T | undefined, fallback: T): T;
+    /** Control flow */
+    sleep(duration: number | string): Promise<void>;
+    waitForSignal<T>(signal: string | string[], options?: IWaitOptions): Promise<T>;
+    checkpoint(name: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** State management */
+    setState(key: string, value: unknown): void;
+    getState<T>(key: string): T | undefined;
+    /** Logging */
+    log: IWorkflowLogger;
+    /** Child workflows */
+    workflow<TChildInput, TChildOutput>(childId: string, tag: string, input: TChildInput, options?: IChildWorkflowOptions): Promise<TChildOutput>;
+    /** Rollback control */
+    triggerRollback(reason: string): Promise<IRollbackResult>;
+}
+/**
+ * Workflow handler function type
+ */
+export type WorkflowHandler<TInput = Record<string, unknown>, TOutput = unknown> = (ctx: IWorkflowContext<TInput>) => Promise<TOutput>;
+/**
+ * Options for defining a workflow with code-first API
+ */
+export interface IDefineWorkflowOptions<TInput = Record<string, unknown>, TOutput = unknown> {
+    /** Target product (optional if using builder pattern) */
+    product?: string;
+    /** Unique workflow tag */
+    tag: string;
+    /** Human-readable name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Signal definitions */
+    signals?: Record<string, {
+        input?: Record<string, string>;
+    }>;
+    /** Query definitions */
+    queries?: Record<string, {
+        handler?: (ctx: IWorkflowContext<TInput>) => unknown;
+    }>;
+    /** Workflow options */
+    options?: IWorkflowOptions;
+    /** Environment configurations */
+    envs?: IWorkflowEnv[];
+    /** Workflow handler function */
+    handler: WorkflowHandler<TInput, TOutput>;
+}
+/**
+ * Options for executing a workflow
+ */
+export interface IExecuteWorkflowOptions {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow tag */
+    tag: string;
+    /** Workflow input */
+    input: Record<string, unknown>;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Idempotency key */
+    idempotency_key?: string;
+    /** Cache tag */
+    cache?: string;
+    /** Number of retries */
+    retries?: number;
+    /** Timeout in ms */
+    timeout?: number;
+}
+/**
+ * Workflow execution result
+ */
+export interface IWorkflowExecutionResult<T = unknown> {
+    /** Execution status */
+    status: WorkflowStatus;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Output data */
+    output?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Execution time in ms */
+    execution_time: number;
+    /** Completed steps */
+    completed_steps: string[];
+    /** Failed step (if any) */
+    failed_step?: string;
+    /** Rollback info (if rolled back) */
+    rollback_info?: {
+        triggered_by: string;
+        reason: string;
+        rolled_back_steps: string[];
+        failed_rollbacks?: Array<{
+            tag: string;
+            error: string;
+        }>;
+    };
+}
+/**
+ * Schedule configuration for dispatched workflows
+ */
+export interface IWorkflowSchedule {
+    /** Start time (timestamp or ISO string) */
+    start_at?: number | string;
+    /** Cron expression for recurring */
+    cron?: string;
+    /** Interval in ms for recurring */
+    every?: number;
+    /** Maximum number of executions */
+    limit?: number;
+    /** End date for recurring */
+    endDate?: number | string;
+    /** Timezone */
+    tz?: string;
+}
+/**
+ * Options for dispatching a workflow
+ */
+export interface IWorkflowDispatchInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow tag */
+    workflow: string;
+    /** Workflow input */
+    input: Record<string, unknown>;
+    /** Schedule configuration */
+    schedule?: IWorkflowSchedule;
+    /** Session token in format: session_tag:jwt_token */
+    session?: string;
+    /** Cache tag */
+    cache?: string;
+    /** Number of retries */
+    retries?: number;
+}
+/**
+ * Dispatch result
+ */
+export interface IWorkflowDispatchResult {
+    /** Job ID */
+    job_id: string;
+    /** Job status */
+    status: 'scheduled' | 'queued' | 'running';
+    /** Scheduled timestamp */
+    scheduled_at?: number;
+    /** Whether this is a recurring job */
+    recurring?: boolean;
+    /** Next run timestamp (for recurring) */
+    next_run_at?: number;
+}
+/**
+ * Options for sending a signal to a workflow
+ */
+export interface ISendSignalOptions {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Signal name */
+    signal: string;
+    /** Signal payload */
+    payload?: Record<string, unknown>;
+}
+/**
+ * Options for querying a workflow
+ */
+export interface IQueryWorkflowOptions {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Query name */
+    query: string;
+    /** Query parameters */
+    params?: Record<string, unknown>;
+}
+/**
+ * Step builder interface for fluent API
+ */
+export interface IStepBuilder {
+    /** Set as action step */
+    action(app: string, event: string): IStepBuilder;
+    /** Set as database step */
+    database(database: string, event: string): IStepBuilder;
+    /** Set as graph step */
+    graph(graph: string, action: string): IStepBuilder;
+    /** Set as notification step */
+    notification(notification: string, event: string): IStepBuilder;
+    /** Set as storage step */
+    storage(storage: string, event: string): IStepBuilder;
+    /** Set as publish step */
+    publish(broker: string, event: string): IStepBuilder;
+    /** Set as feature step */
+    feature(feature: string): IStepBuilder;
+    /** Set as quota step */
+    quota(quota: string): IStepBuilder;
+    /** Set as fallback step */
+    fallback(fallback: string): IStepBuilder;
+    /** Set as child workflow step */
+    workflow(workflow: string): IStepBuilder;
+    /** Set as sleep step */
+    sleep(duration: number | string): IStepBuilder;
+    /** Set as wait for signal step */
+    waitForSignal(signal: string, timeout?: number | string): IStepBuilder;
+    /** Set as checkpoint step */
+    checkpoint(): IStepBuilder;
+    /** Set step input */
+    input(input: Record<string, unknown>): IStepBuilder;
+    /** Set step dependencies */
+    dependsOn(steps: string[]): IStepBuilder;
+    /** Set step condition */
+    condition(condition: string): IStepBuilder;
+    /** Set step options */
+    options(options: IWorkflowStepOptions): IStepBuilder;
+    /** Mark as optional */
+    optional(): IStepBuilder;
+    /** Mark as critical */
+    critical(): IStepBuilder;
+    /** Mark as allow_fail */
+    allowFail(): IStepBuilder;
+    /** Set step name */
+    name(name: string): IStepBuilder;
+    /** Configure rollback */
+    rollback(): IRollbackBuilder;
+    /** Complete step definition and return to workflow builder */
+    done(): IWorkflowBuilder;
+}
+/**
+ * Rollback builder interface for fluent API
+ */
+export interface IRollbackBuilder {
+    /** Set as action rollback */
+    action(app: string, event: string): IRollbackBuilder;
+    /** Set as database rollback */
+    database(database: string, event: string): IRollbackBuilder;
+    /** Set as graph rollback */
+    graph(graph: string, action: string): IRollbackBuilder;
+    /** Set as notification rollback */
+    notification(notification: string, event: string): IRollbackBuilder;
+    /** Set as storage rollback */
+    storage(storage: string, event: string): IRollbackBuilder;
+    /** Set as publish rollback */
+    publish(broker: string, event: string): IRollbackBuilder;
+    /** Set rollback input */
+    input(input: Record<string, unknown>): IRollbackBuilder;
+    /** Complete rollback definition and return to step builder */
+    done(): IStepBuilder;
+}
+/**
+ * Workflow builder interface for fluent API
+ */
+export interface IWorkflowBuilder {
+    /** Set workflow name */
+    name(name: string): IWorkflowBuilder;
+    /** Set workflow description */
+    description(description: string): IWorkflowBuilder;
+    /** Set input schema */
+    input(input: Record<string, unknown>): IWorkflowBuilder;
+    /** Set output schema */
+    output(output: Record<string, unknown>): IWorkflowBuilder;
+    /** Set workflow options */
+    options(options: IWorkflowOptions): IWorkflowBuilder;
+    /** Add environment */
+    env(slug: string, active?: boolean): IWorkflowBuilder;
+    /** Add signal */
+    signal(name: string, input?: Record<string, string>): IWorkflowBuilder;
+    /** Add query */
+    query(name: string, handler?: string): IWorkflowBuilder;
+    /** Start defining a step */
+    step(tag: string): IStepBuilder;
+    /** Build the workflow schema */
+    build(): IProductWorkflow;
+    /** Get compiled JSON schema */
+    toSchema(): IProductWorkflow;
+}
+/**
+ * Options for replaying a workflow
+ */
+export interface IWorkflowReplayInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Original workflow ID to replay */
+    workflow_id: string;
+    /** Override options for the replay */
+    options?: Partial<IWorkflowOptions>;
+    /** Reason for replay (for audit) */
+    reason?: string;
+    /** Idempotency key */
+    idempotency_key?: string;
+}
+/**
+ * Result of replaying a workflow
+ */
+export interface IWorkflowReplayResult extends IWorkflowExecutionResult {
+    /** Original workflow ID that was replayed */
+    replayed_from: string;
+}
+/**
+ * Options for restarting a workflow
+ */
+export interface IWorkflowRestartInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Original workflow ID to restart */
+    workflow_id: string;
+    /** New input (replaces original) */
+    input?: Record<string, unknown>;
+    /** Partial input override (merged with original) */
+    input_override?: Record<string, unknown>;
+    /** Whether to merge input_override with original input */
+    merge_input?: boolean;
+    /** Reason for restart (for audit) */
+    reason?: string;
+    /** Override options */
+    options?: Partial<IWorkflowOptions>;
+}
+/**
+ * Result of restarting a workflow
+ */
+export interface IWorkflowRestartResult extends IWorkflowExecutionResult {
+    /** Original workflow ID that was restarted */
+    restarted_from: string;
+}
+/**
+ * Options for resuming a workflow
+ */
+export interface IWorkflowResumeInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID to resume */
+    workflow_id: string;
+    /** Resume from specific checkpoint */
+    from_checkpoint?: string;
+    /** Resume from specific step */
+    from_step?: string;
+    /** Steps to skip */
+    skip_steps?: string[];
+    /** Additional input for remaining steps */
+    input?: Record<string, unknown>;
+}
+/**
+ * Result of resuming a workflow
+ */
+export interface IWorkflowResumeResult extends IWorkflowExecutionResult {
+    /** Original workflow ID that was resumed */
+    resumed_from: string;
+    /** Checkpoint resumed from (if applicable) */
+    resumed_checkpoint?: string;
+}
+/**
+ * Options for replaying from a specific step
+ */
+export interface IWorkflowReplayFromStepInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Original workflow ID */
+    workflow_id: string;
+    /** Step to start from */
+    from_step: string;
+    /** Override outputs from previous steps */
+    step_outputs?: Record<string, unknown>;
+    /** Debug options */
+    debug?: {
+        enabled: boolean;
+        pause_after_step?: boolean;
+        log_level?: 'info' | 'verbose' | 'debug';
+    };
+}
+/**
+ * Options for getting workflow status
+ */
+export interface IWorkflowStatusInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+}
+/**
+ * Workflow status response
+ */
+export interface IWorkflowStatus {
+    /** Workflow ID */
+    workflow_id: string;
+    /** Workflow tag */
+    workflow_tag: string;
+    /** Current status */
+    status: WorkflowStatus;
+    /** Currently executing step */
+    current_step?: string;
+    /** Completed step tags */
+    completed_steps: string[];
+    /** Workflow state */
+    state: Record<string, unknown>;
+    /** Start timestamp */
+    started_at: number;
+    /** Last update timestamp */
+    updated_at: number;
+    /** Input data */
+    input?: Record<string, unknown>;
+    /** Output data (if completed) */
+    output?: unknown;
+    /** Error (if failed) */
+    error?: {
+        message: string;
+        step?: string;
+        code?: string;
+    };
+}
+/**
+ * Options for cancelling a workflow
+ */
+export interface IWorkflowCancelInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Reason for cancellation */
+    reason?: string;
+}
+/**
+ * Cancel result
+ */
+export interface IWorkflowCancelResult {
+    /** Whether cancellation was successful */
+    cancelled: boolean;
+    /** Steps that were rolled back */
+    rolled_back_steps: string[];
+    /** Steps that failed to rollback */
+    failed_rollbacks?: Array<{
+        tag: string;
+        error: string;
+    }>;
+}
+/**
+ * Options for getting workflow history
+ */
+export interface IWorkflowHistoryInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Include detailed step information */
+    include_step_details?: boolean;
+    /** Include rollback details */
+    include_rollback_details?: boolean;
+}
+/**
+ * Workflow event types
+ */
+export type WorkflowEventType = 'workflow_started' | 'workflow_completed' | 'workflow_failed' | 'workflow_cancelled' | 'workflow_rolled_back' | 'step_started' | 'step_completed' | 'step_failed' | 'step_skipped' | 'step_rolled_back' | 'checkpoint_created' | 'signal_received' | 'signal_timeout' | 'rollback_started' | 'rollback_completed' | 'rollback_failed';
+/**
+ * Workflow event
+ */
+export interface IWorkflowEvent {
+    /** Event type */
+    type: WorkflowEventType;
+    /** Timestamp */
+    timestamp: number;
+    /** Event data */
+    data: Record<string, unknown>;
+}
+/**
+ * Checkpoint info
+ */
+export interface ICheckpoint {
+    /** Checkpoint name */
+    name: string;
+    /** Checkpoint metadata */
+    metadata?: Record<string, unknown>;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Workflow history
+ */
+export interface IWorkflowHistory {
+    /** Workflow ID */
+    workflow_id: string;
+    /** Workflow tag */
+    workflow_tag: string;
+    /** Final status */
+    status: WorkflowStatus;
+    /** All events */
+    events: IWorkflowEvent[];
+    /** Checkpoints */
+    checkpoints: ICheckpoint[];
+    /** Replay IDs (if this workflow was replayed) */
+    replays?: string[];
+    /** Restart IDs (if this workflow was restarted) */
+    restarts?: string[];
+}
+/**
+ * Options for getting step details
+ */
+export interface IStepDetailInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+    /** Step tag */
+    step_tag: string;
+}
+/**
+ * Step status
+ */
+export type StepStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'rolled_back';
+/**
+ * Rollback status
+ */
+export type RollbackStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+/**
+ * Step error
+ */
+export interface IStepError {
+    /** Error message */
+    message: string;
+    /** Error code */
+    code?: string;
+    /** Stack trace */
+    stack?: string;
+}
+/**
+ * Step detail
+ */
+export interface IStepDetail {
+    /** Step tag */
+    tag: string;
+    /** Step name */
+    name?: string;
+    /** Step status */
+    status: StepStatus;
+    /** Step input */
+    input?: Record<string, unknown>;
+    /** Step output */
+    output?: Record<string, unknown>;
+    /** Step error (if failed) */
+    error?: IStepError;
+    /** Number of attempts */
+    attempts: number;
+    /** Start timestamp */
+    start_time?: number;
+    /** End timestamp */
+    end_time?: number;
+    /** Duration in ms */
+    duration?: number;
+    /** Rollback status */
+    rollback_status?: RollbackStatus;
+    /** Rollback error (if rollback failed) */
+    rollback_error?: string;
+}
+/**
+ * Options for listing related executions
+ */
+export interface IRelatedExecutionsInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow ID */
+    workflow_id: string;
+}
+/**
+ * Related execution entry
+ */
+export interface IRelatedExecution {
+    /** Workflow ID */
+    workflow_id: string;
+    /** Execution type */
+    type: 'original' | 'replay' | 'restart' | 'resume';
+    /** Status */
+    status: WorkflowStatus;
+    /** Created timestamp */
+    created_at: number;
+    /** Original workflow ID (for replays) */
+    replayed_from?: string;
+    /** Original workflow ID (for restarts) */
+    restarted_from?: string;
+    /** Original workflow ID (for resumes) */
+    resumed_from?: string;
+}
+/**
+ * Related executions response
+ */
+export interface IRelatedExecutions {
+    /** Original workflow ID */
+    original: string;
+    /** All related executions */
+    executions: IRelatedExecution[];
+}
+/**
+ * Options for comparing executions
+ */
+export interface ICompareExecutionsInput {
+    /** Product tag */
+    product: string;
+    /** Environment slug */
+    env: string;
+    /** Workflow IDs to compare */
+    workflow_ids: string[];
+}
+/**
+ * Step diff entry
+ */
+export interface IStepDiff {
+    /** Step tag */
+    step: string;
+    /** Status and output per workflow */
+    [workflow_id: string]: {
+        status: StepStatus;
+        output?: Record<string, unknown>;
+        error?: string;
+    } | string;
+}
+/**
+ * Execution comparison
+ */
+export interface IExecutionComparison {
+    /** Workflow IDs compared */
+    workflows: string[];
+    /** Input differences */
+    input_diff: Record<string, unknown[]>;
+    /** Step differences */
+    step_diffs: IStepDiff[];
+    /** Outcome differences */
+    outcome_diff: Record<string, {
+        status: WorkflowStatus;
+        output?: unknown;
+    }>;
+}
+export { IProductWorkflow, IProductWorkflowStep, IWorkflowOptions, IWorkflowSignal, IWorkflowQuery, IWorkflowEnv, IWorkflowStepOptions, IWorkflowStepRollback, WorkflowStepType, WorkflowRollbackStrategy, WorkflowStatus, };