@tasker-systems/tasker 0.1.4 → 0.1.5

package/dist/runtime-interface-D940vUzy.d.ts

@@ -1,694 +0,0 @@
-/**
- * DTO for health check response
- */
-type ClientHealthResponseDto = {
-    status: string;
-    timestamp: string;
-};
-
-/**
- * DTO for pagination info in list responses
- */
-type ClientPaginationInfoDto = {
-    page: number;
-    per_page: number;
-    total_count: bigint;
-    total_pages: number;
-    has_next: boolean;
-    has_previous: boolean;
-};
-
-/**
- * DTO for client operation result wrapper (success/error envelope)
- *
- * All TypeScript client FFI functions return this envelope format.
- */
-type ClientResultDto = {
-    success: boolean;
-    data: unknown;
-    error: string | null;
-    recoverable: boolean | null;
-};
-
-/**
- * DTO for step audit history response (SOC2 compliance)
- */
-type ClientStepAuditResponseDto = {
-    audit_uuid: string;
-    workflow_step_uuid: string;
-    transition_uuid: string;
-    task_uuid: string;
-    recorded_at: string;
-    worker_uuid: string | null;
-    correlation_id: string | null;
-    success: boolean;
-    execution_time_ms: bigint | null;
-    result: Record<string, unknown> | null;
-    step_name: string;
-    from_state: string | null;
-    to_state: string;
-};
-
-/**
- * DTO for step readiness status (nested in task responses)
- */
-type ClientStepReadinessDto = {
-    workflow_step_uuid: string;
-    task_uuid: string;
-    named_step_uuid: string;
-    name: string;
-    current_state: string;
-    dependencies_satisfied: boolean;
-    retry_eligible: boolean;
-    ready_for_execution: boolean;
-    last_failure_at: string | null;
-    next_retry_at: string | null;
-    total_parents: number;
-    completed_parents: number;
-    attempts: number;
-    max_attempts: number;
-    backoff_request_seconds: number | null;
-    last_attempted_at: string | null;
-};
-
-/**
- * DTO for step response from the orchestration API
- */
-type ClientStepResponseDto = {
-    step_uuid: string;
-    task_uuid: string;
-    name: string;
-    created_at: string;
-    updated_at: string;
-    completed_at: string | null;
-    results: Record<string, unknown> | null;
-    current_state: string;
-    dependencies_satisfied: boolean;
-    retry_eligible: boolean;
-    ready_for_execution: boolean;
-    total_parents: number;
-    completed_parents: number;
-    attempts: number;
-    max_attempts: number;
-    last_failure_at: string | null;
-    next_retry_at: string | null;
-    last_attempted_at: string | null;
-};
-
-/**
- * DTO for task response from the orchestration API
- */
-type ClientTaskResponseDto = {
-    task_uuid: string;
-    name: string;
-    namespace: string;
-    version: string;
-    status: string;
-    created_at: string;
-    updated_at: string;
-    completed_at: string | null;
-    context: Record<string, unknown>;
-    initiator: string;
-    source_system: string;
-    reason: string;
-    priority: number | null;
-    tags: Array<string> | null;
-    correlation_id: string;
-    parent_correlation_id: string | null;
-    total_steps: bigint;
-    pending_steps: bigint;
-    in_progress_steps: bigint;
-    completed_steps: bigint;
-    failed_steps: bigint;
-    ready_steps: bigint;
-    execution_status: string;
-    recommended_action: string;
-    completion_percentage: number;
-    health_status: string;
-    steps: Array<ClientStepReadinessDto>;
-};
-
-/**
- * DTO for task list response with pagination
- */
-type ClientTaskListResponseDto = {
-    tasks: Array<ClientTaskResponseDto>;
-    pagination: ClientPaginationInfoDto;
-};
-
-/**
- * DTO for task creation request (input to client_create_task)
- */
-type ClientTaskRequestDto = {
-    name: string;
-    namespace: string;
-    version: string;
-    context: Record<string, unknown>;
-    initiator: string;
-    source_system: string;
-    reason: string;
-    tags: Array<string>;
-    requested_at: string;
-    options: Record<string, unknown> | null;
-    priority: number | null;
-    correlation_id: string;
-    parent_correlation_id: string | null;
-    idempotency_key: string | null;
-};
-
-/**
- * DTO for step execution errors
- */
-type StepExecutionErrorDto = {
-    message: string;
-    error_type: string | null;
-    retryable: boolean;
-    status_code: number | null;
-    backtrace: Array<string> | null;
-};
-
-/**
- * DTO for dependency step results
- */
-type DependencyResultDto = {
-    step_uuid: string;
-    success: boolean;
-    result: Record<string, unknown>;
-    status: string;
-    error: StepExecutionErrorDto | null;
-};
-
-/**
- * DTO for FFI dispatch metrics
- */
-type FfiDispatchMetricsDto = {
-    pending_count: number;
-    starvation_detected: boolean;
-    starving_event_count: number;
-    oldest_pending_age_ms: bigint | null;
-    newest_pending_age_ms: bigint | null;
-    oldest_event_id: string | null;
-};
-
-/**
- * DTO for HandlerDefinition
- *
- * TAS-93: Includes method dispatch and resolver hint fields for the
- * step handler router/resolver strategy pattern.
- */
-type HandlerDefinitionDto = {
-    callable: string;
-    /**
-     * The entry point method to invoke (defaults to "call")
-     */
-    method: string | null;
-    /**
-     * Resolution strategy hint (bypass chain and use this resolver)
-     */
-    resolver: string | null;
-    initialization: Record<string, unknown>;
-};
-
-/**
- * DTO for RetryConfiguration
- */
-type RetryConfigurationDto = {
-    retryable: boolean;
-    max_attempts: number;
-    backoff: string;
-    backoff_base_ms: bigint | null;
-    max_backoff_ms: bigint | null;
-};
-
-/**
- * DTO for StepDefinition (from task template)
- */
-type StepDefinitionDto = {
-    name: string;
-    description: string | null;
-    handler: HandlerDefinitionDto;
-    system_dependency: string | null;
-    dependencies: Array<string>;
-    timeout_seconds: bigint | null;
-    retry: RetryConfigurationDto;
-};
-
-/**
- * DTO for Task information
- */
-type TaskDto = {
-    task_uuid: string;
-    named_task_uuid: string;
-    name: string;
-    namespace: string;
-    version: string;
-    context: Record<string, unknown> | null;
-    correlation_id: string;
-    parent_correlation_id: string | null;
-    complete: boolean;
-    priority: number;
-    initiator: string | null;
-    source_system: string | null;
-    reason: string | null;
-    tags: Record<string, unknown> | null;
-    identity_hash: string;
-    created_at: string;
-    updated_at: string;
-    requested_at: string;
-};
-
-/**
- * DTO for WorkflowStep information (uses WorkflowStepWithName which has name fields)
- */
-type WorkflowStepDto = {
-    workflow_step_uuid: string;
-    task_uuid: string;
-    named_step_uuid: string;
-    name: string;
-    template_step_name: string;
-    retryable: boolean;
-    max_attempts: number;
-    attempts: number;
-    in_process: boolean;
-    processed: boolean;
-    inputs: Record<string, unknown> | null;
-    results: Record<string, unknown> | null;
-    backoff_request_seconds: number | null;
-    processed_at: string | null;
-    last_attempted_at: string | null;
-    created_at: string;
-    updated_at: string;
-    /**
-     * Handler-driven checkpoint data for batch processing resumability (TAS-125)
-     */
-    checkpoint: Record<string, unknown> | null;
-};
-
-/**
- * DTO for FfiStepEvent - the main event payload sent to TypeScript handlers
- */
-type FfiStepEventDto = {
-    event_id: string;
-    task_uuid: string;
-    step_uuid: string;
-    correlation_id: string;
-    trace_id: string | null;
-    span_id: string | null;
-    task_correlation_id: string;
-    parent_correlation_id: string | null;
-    task: TaskDto;
-    workflow_step: WorkflowStepDto;
-    step_definition: StepDefinitionDto;
-    dependency_results: {
-        [key in string]?: DependencyResultDto;
-    };
-};
-
-/**
- * FFI type definitions for TypeScript/JavaScript workers.
- *
- * These types are automatically generated from Rust DTOs using ts-rs.
- * Run `cargo make generate-bindings` to regenerate the base types.
- *
- * This file re-exports generated types with API-friendly names and adds
- * runtime-specific types that aren't part of the DTO layer.
- */
-
-type Task = TaskDto;
-type WorkflowStep = WorkflowStepDto;
-type HandlerDefinition = HandlerDefinitionDto;
-type RetryConfiguration = RetryConfigurationDto;
-type StepDefinition = StepDefinitionDto;
-type StepExecutionError = StepExecutionErrorDto;
-type DependencyResult = DependencyResultDto;
-type FfiStepEvent = FfiStepEventDto;
-type FfiDispatchMetrics = FfiDispatchMetricsDto;
-type ClientTaskRequest = ClientTaskRequestDto;
-type ClientTaskResponse = ClientTaskResponseDto;
-type ClientTaskListResponse = ClientTaskListResponseDto;
-type ClientStepResponse = ClientStepResponseDto;
-type ClientStepAuditResponse = ClientStepAuditResponseDto;
-type ClientStepReadiness = ClientStepReadinessDto;
-type ClientPaginationInfo = ClientPaginationInfoDto;
-type ClientHealthResponse = ClientHealthResponseDto;
-type ClientResult = ClientResultDto;
-
-/**
- * Bootstrap configuration for the worker
- */
-interface BootstrapConfig {
-    worker_id?: string;
-    log_level?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
-    database_url?: string;
-    [key: string]: unknown;
-}
-/**
- * Bootstrap result from Rust
- */
-interface BootstrapResult {
-    success: boolean;
-    status: 'started' | 'already_running' | 'error';
-    message: string;
-    worker_id?: string;
-    error?: string;
-}
-/**
- * Worker status from get_worker_status
- */
-interface WorkerStatus {
-    success: boolean;
-    running: boolean;
-    status?: 'stopped';
-    worker_id?: string;
-    environment?: string;
-    worker_core_status?: string;
-    web_api_enabled?: boolean;
-    supported_namespaces?: string[];
-    database_pool_size?: number;
-    database_pool_idle?: number;
-}
-/**
- * Stop result from stop_worker
- */
-interface StopResult {
-    success: boolean;
-    status: 'stopped' | 'not_running' | 'error';
-    message: string;
-    worker_id?: string;
-    error?: string;
-}
-/**
- * Step execution result to send back to Rust
- *
- * This structure matches tasker_shared::messaging::StepExecutionResult
- */
-interface StepExecutionResult {
-    step_uuid: string;
-    success: boolean;
-    result: Record<string, unknown>;
-    metadata: StepExecutionMetadata;
-    status: 'completed' | 'failed' | 'error';
-    error?: StepExecutionError;
-    orchestration_metadata?: OrchestrationMetadata;
-}
-/**
- * Metadata about step execution
- */
-interface StepExecutionMetadata {
-    execution_time_ms: number;
-    worker_id?: string;
-    handler_name?: string;
-    attempt_number?: number;
-    [key: string]: unknown;
-}
-/**
- * Orchestration metadata for routing
- */
-interface OrchestrationMetadata {
-    routing_context?: Record<string, unknown>;
-    next_steps?: string[];
-    [key: string]: unknown;
-}
-/**
- * Log fields for structured logging
- */
-interface LogFields {
-    [key: string]: string | number | boolean | null;
-}
-/**
- * Metadata attached to every domain event from FFI.
- */
-interface FfiDomainEventMetadata {
-    taskUuid: string;
-    stepUuid: string | null;
-    stepName: string | null;
-    namespace: string;
-    correlationId: string;
-    firedAt: string;
-    firedBy: string | null;
-}
-/**
- * Domain event from in-process event bus (fast path).
- *
- * Used for real-time notifications that don't require guaranteed delivery
- * (e.g., metrics updates, logging, notifications).
- */
-interface FfiDomainEvent {
-    eventId: string;
-    eventName: string;
-    eventVersion: string;
-    metadata: FfiDomainEventMetadata;
-    payload: Record<string, unknown>;
-}
-/**
- * Checkpoint yield data for batch processing handlers (TAS-125)
- *
- * Sent when a handler wants to persist progress and be re-dispatched.
- * The step remains in_process and will be re-executed with the checkpoint
- * data available.
- */
-interface CheckpointYieldData {
-    step_uuid: string;
-    cursor: unknown;
-    items_processed: number;
-    accumulated_results?: Record<string, unknown>;
-}
-
-/**
- * Runtime interface for FFI operations.
- *
- * This interface defines the contract that all runtime adapters must implement.
- * It provides strongly-typed access to the Rust FFI functions.
- */
-
-/**
- * Interface for runtime-specific FFI implementations.
- *
- * Each runtime (Node.js, Bun, Deno) implements this interface
- * using their native FFI mechanism.
- */
-interface TaskerRuntime {
-    /**
-     * Get the runtime name
-     */
-    readonly name: string;
-    /**
-     * Check if the FFI library is loaded
-     */
-    readonly isLoaded: boolean;
-    /**
-     * Load the native library from the given path
-     */
-    load(libraryPath: string): Promise<void>;
-    /**
-     * Unload the native library and release resources
-     */
-    unload(): void;
-    /**
-     * Get the version of the tasker-ts package
-     */
-    getVersion(): string;
-    /**
-     * Get detailed Rust library version
-     */
-    getRustVersion(): string;
-    /**
-     * Check if the FFI module is functional
-     */
-    healthCheck(): boolean;
-    /**
-     * Bootstrap the worker with optional configuration
-     */
-    bootstrapWorker(config?: BootstrapConfig): BootstrapResult;
-    /**
-     * Check if the worker is currently running
-     */
-    isWorkerRunning(): boolean;
-    /**
-     * Get current worker status
-     */
-    getWorkerStatus(): WorkerStatus;
-    /**
-     * Stop the worker gracefully
-     */
-    stopWorker(): StopResult;
-    /**
-     * Transition to graceful shutdown mode
-     */
-    transitionToGracefulShutdown(): StopResult;
-    /**
-     * Poll for pending step events (non-blocking)
-     *
-     * @returns Step event if available, null otherwise
-     */
-    pollStepEvents(): FfiStepEvent | null;
-    /**
-     * Poll for in-process domain events (fast path, non-blocking)
-     *
-     * Used for real-time notifications that don't require guaranteed delivery
-     * (e.g., metrics updates, logging, notifications).
-     *
-     * @returns Domain event if available, null otherwise
-     */
-    pollInProcessEvents(): FfiDomainEvent | null;
-    /**
-     * Complete a step event with the given result
-     *
-     * @param eventId The event ID to complete
-     * @param result The step execution result
-     * @returns true if successful, false otherwise
-     */
-    completeStepEvent(eventId: string, result: StepExecutionResult): boolean;
-    /**
-     * TAS-125: Submit a checkpoint yield for batch processing
-     *
-     * Called from batch processing handlers when they want to persist progress
-     * and be re-dispatched for continuation. Unlike completeStepEvent, this
-     * does NOT complete the step - instead it persists checkpoint data and
-     * re-dispatches the step for continued processing.
-     *
-     * @param eventId The event ID from the step event
-     * @param checkpointData The checkpoint data to persist
-     * @returns true if checkpoint persisted and step re-dispatched, false otherwise
-     */
-    checkpointYieldStepEvent(eventId: string, checkpointData: CheckpointYieldData): boolean;
-    /**
-     * Get FFI dispatch metrics
-     */
-    getFfiDispatchMetrics(): FfiDispatchMetrics;
-    /**
-     * Check for and log starvation warnings
-     */
-    checkStarvationWarnings(): void;
-    /**
-     * Cleanup timed-out events
-     */
-    cleanupTimeouts(): void;
-    /**
-     * Create a task via the orchestration API client
-     *
-     * @param requestJson JSON string of ClientTaskRequest
-     * @returns ClientResult containing ClientTaskResponse on success
-     */
-    clientCreateTask(requestJson: string): ClientResult;
-    /**
-     * Get a task by UUID
-     *
-     * @param taskUuid The task UUID
-     * @returns ClientResult containing ClientTaskResponse on success
-     */
-    clientGetTask(taskUuid: string): ClientResult;
-    /**
-     * List tasks with optional filters
-     *
-     * @param paramsJson JSON string with limit, offset, namespace, status
-     * @returns ClientResult containing ClientTaskListResponse on success
-     */
-    clientListTasks(paramsJson: string): ClientResult;
-    /**
-     * Cancel a task
-     *
-     * @param taskUuid The task UUID to cancel
-     * @returns ClientResult with cancellation status
-     */
-    clientCancelTask(taskUuid: string): ClientResult;
-    /**
-     * List workflow steps for a task
-     *
-     * @param taskUuid The task UUID
-     * @returns ClientResult containing step list on success
-     */
-    clientListTaskSteps(taskUuid: string): ClientResult;
-    /**
-     * Get a specific workflow step
-     *
-     * @param taskUuid The task UUID
-     * @param stepUuid The step UUID
-     * @returns ClientResult containing ClientStepResponse on success
-     */
-    clientGetStep(taskUuid: string, stepUuid: string): ClientResult;
-    /**
-     * Get audit history for a workflow step (SOC2 compliance)
-     *
-     * @param taskUuid The task UUID
-     * @param stepUuid The step UUID
-     * @returns ClientResult containing audit history on success
-     */
-    clientGetStepAuditHistory(taskUuid: string, stepUuid: string): ClientResult;
-    /**
-     * Health check against the orchestration API
-     *
-     * @returns ClientResult containing ClientHealthResponse on success
-     */
-    clientHealthCheck(): ClientResult;
-    /**
-     * Log an error message
-     */
-    logError(message: string, fields?: LogFields): void;
-    /**
-     * Log a warning message
-     */
-    logWarn(message: string, fields?: LogFields): void;
-    /**
-     * Log an info message
-     */
-    logInfo(message: string, fields?: LogFields): void;
-    /**
-     * Log a debug message
-     */
-    logDebug(message: string, fields?: LogFields): void;
-    /**
-     * Log a trace message
-     */
-    logTrace(message: string, fields?: LogFields): void;
-}
-/**
- * Base class with common functionality for all runtime implementations.
- *
- * Runtime-specific implementations extend this class and implement
- * the abstract methods using their native FFI mechanism.
- */
-declare abstract class BaseTaskerRuntime implements TaskerRuntime {
-    abstract readonly name: string;
-    abstract readonly isLoaded: boolean;
-    abstract load(libraryPath: string): Promise<void>;
-    abstract unload(): void;
-    abstract getVersion(): string;
-    abstract getRustVersion(): string;
-    abstract healthCheck(): boolean;
-    abstract bootstrapWorker(config?: BootstrapConfig): BootstrapResult;
-    abstract isWorkerRunning(): boolean;
-    abstract getWorkerStatus(): WorkerStatus;
-    abstract stopWorker(): StopResult;
-    abstract transitionToGracefulShutdown(): StopResult;
-    abstract pollStepEvents(): FfiStepEvent | null;
-    abstract pollInProcessEvents(): FfiDomainEvent | null;
-    abstract completeStepEvent(eventId: string, result: StepExecutionResult): boolean;
-    abstract checkpointYieldStepEvent(eventId: string, checkpointData: CheckpointYieldData): boolean;
-    abstract getFfiDispatchMetrics(): FfiDispatchMetrics;
-    abstract checkStarvationWarnings(): void;
-    abstract cleanupTimeouts(): void;
-    abstract clientCreateTask(requestJson: string): ClientResult;
-    abstract clientGetTask(taskUuid: string): ClientResult;
-    abstract clientListTasks(paramsJson: string): ClientResult;
-    abstract clientCancelTask(taskUuid: string): ClientResult;
-    abstract clientListTaskSteps(taskUuid: string): ClientResult;
-    abstract clientGetStep(taskUuid: string, stepUuid: string): ClientResult;
-    abstract clientGetStepAuditHistory(taskUuid: string, stepUuid: string): ClientResult;
-    abstract clientHealthCheck(): ClientResult;
-    abstract logError(message: string, fields?: LogFields): void;
-    abstract logWarn(message: string, fields?: LogFields): void;
-    abstract logInfo(message: string, fields?: LogFields): void;
-    abstract logDebug(message: string, fields?: LogFields): void;
-    abstract logTrace(message: string, fields?: LogFields): void;
-    /**
-     * Helper to parse JSON string from FFI
-     */
-    protected parseJson<T>(jsonStr: string | null): T | null;
-    /**
-     * Helper to stringify JSON for FFI
-     */
-    protected toJson(value: unknown): string;
-}
-
-export { BaseTaskerRuntime as B, type ClientTaskResponse as C, type DependencyResult as D, type FfiDomainEvent as F, type HandlerDefinitionDto as H, type LogFields as L, type OrchestrationMetadata as O, type RetryConfiguration as R, type StepDefinition as S, type TaskerRuntime as T, type WorkerStatus as W, type ClientTaskListResponse as a, type ClientStepResponse as b, type ClientStepAuditResponse as c, type ClientHealthResponse as d, type BootstrapConfig as e, type BootstrapResult as f, type ClientPaginationInfo as g, type ClientResult as h, type ClientStepReadiness as i, type ClientTaskRequest as j, type FfiDispatchMetrics as k, type FfiStepEvent as l, type HandlerDefinition as m, type StepExecutionError as n, type StepExecutionMetadata as o, type StepExecutionResult as p, type StopResult as q, type Task as r, type WorkflowStep as s, type CheckpointYieldData as t, type FfiDomainEventMetadata as u };