retab 0.1.0

data/lib/retab/workflow_runs/error_terminal.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class ErrorTerminal < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      status: :status,
+      message: :message,
+      stage: :stage,
+      category: :category,
+      details: :details,
+      failing_step_id: :failing_step_id
+    }.freeze
+
+    attr_accessor \
+      :status,
+      :message,
+      :stage,
+      :category,
+      :details,
+      :failing_step_id
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @status = hash[:status]
+      @message = hash[:message]
+      @stage = hash[:stage]
+      @category = hash[:category]
+      @details = hash[:details] ? Retab::ErrorDetails.new(hash[:details]) : nil
+      @failing_step_id = hash[:failing_step_id]
+    end
+  end
+end

data/lib/retab/workflow_runs/manual_trigger.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class ManualTrigger < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      type: :type,
+      user_id: :user_id
+    }.freeze
+
+    attr_accessor \
+      :type,
+      :user_id
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @type = hash[:type]
+      @user_id = hash[:user_id]
+    end
+  end
+end

data/lib/retab/workflow_runs/pending_run.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class PendingRun < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      status: :status
+    }.freeze
+
+    attr_accessor :status
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @status = hash[:status]
+    end
+  end
+end

data/lib/retab/workflow_runs/restart_trigger.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class RestartTrigger < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      type: :type,
+      parent_run_id: :parent_run_id
+    }.freeze
+
+    attr_accessor \
+      :type,
+      :parent_run_id
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @type = hash[:type]
+      @parent_run_id = hash[:parent_run_id]
+    end
+  end
+end

data/lib/retab/workflow_runs/run_inputs.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class RunInputs < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      documents: :documents,
+      json_data: :json_data
+    }.freeze
+
+    attr_accessor \
+      :documents,
+      :json_data
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @documents = hash[:documents] || {}
+      @json_data = hash[:json_data] || {}
+    end
+  end
+end

data/lib/retab/workflow_runs/run_timing.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class RunTiming < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      created_at: :created_at,
+      started_at: :started_at,
+      completed_at: :completed_at,
+      review_waiting_started_at: :review_waiting_started_at,
+      accumulated_review_waiting_ms: :accumulated_review_waiting_ms,
+      duration_ms: :duration_ms
+    }.freeze
+
+    attr_accessor \
+      :created_at,
+      :started_at,
+      :completed_at,
+      :review_waiting_started_at,
+      :accumulated_review_waiting_ms,
+      :duration_ms
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @created_at = hash[:created_at]
+      @started_at = hash[:started_at]
+      @completed_at = hash[:completed_at]
+      @review_waiting_started_at = hash[:review_waiting_started_at]
+      @accumulated_review_waiting_ms = hash[:accumulated_review_waiting_ms]
+      @duration_ms = hash[:duration_ms]
+    end
+  end
+end

data/lib/retab/workflow_runs/running_run.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class RunningRun < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      status: :status
+    }.freeze
+
+    attr_accessor :status
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @status = hash[:status]
+    end
+  end
+end

data/lib/retab/workflow_runs/schedule_trigger.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class ScheduleTrigger < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      type: :type,
+      schedule_id: :schedule_id
+    }.freeze
+
+    attr_accessor \
+      :type,
+      :schedule_id
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @type = hash[:type]
+      @schedule_id = hash[:schedule_id]
+    end
+  end
+end

data/lib/retab/workflow_runs/webhook_trigger.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class WebhookTrigger < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      type: :type,
+      webhook_id: :webhook_id
+    }.freeze
+
+    attr_accessor \
+      :type,
+      :webhook_id
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @type = hash[:type]
+      @webhook_id = hash[:webhook_id]
+    end
+  end
+end

data/lib/retab/workflow_runs/workflow_export_payload_request.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class WorkflowExportPayloadRequest < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      workflow_id: :workflow_id,
+      block_id: :block_id,
+      export_source: :export_source,
+      selected_run_ids: :selected_run_ids,
+      selected_doc_types: :selected_doc_types,
+      status: :status,
+      exclude_status: :exclude_status,
+      from_date: :from_date,
+      to_date: :to_date,
+      trigger_types: :trigger_types,
+      preferred_columns: :preferred_columns,
+      delimiter: :delimiter,
+      line_delimiter: :line_delimiter,
+      quote: :quote
+    }.freeze
+
+    attr_accessor \
+      :workflow_id,
+      :block_id,
+      :export_source,
+      :selected_run_ids,
+      :selected_doc_types,
+      :status,
+      :exclude_status,
+      :from_date,
+      :to_date,
+      :trigger_types,
+      :preferred_columns,
+      :delimiter,
+      :line_delimiter,
+      :quote
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @workflow_id = hash[:workflow_id]
+      @block_id = hash[:block_id]
+      @export_source = hash[:export_source]
+      @selected_run_ids = (hash[:selected_run_ids] || [])
+      @selected_doc_types = (hash[:selected_doc_types] || [])
+      @status = hash[:status]
+      @exclude_status = hash[:exclude_status]
+      @from_date = hash[:from_date]
+      @to_date = hash[:to_date]
+      @trigger_types = (hash[:trigger_types] || [])
+      @preferred_columns = (hash[:preferred_columns] || [])
+      @delimiter = hash[:delimiter]
+      @line_delimiter = hash[:line_delimiter]
+      @quote = hash[:quote]
+    end
+  end
+end

data/lib/retab/workflow_runs/workflow_export_payload_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class WorkflowExportPayloadResponse < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      csv_data: :csv_data,
+      rows: :rows,
+      columns: :columns
+    }.freeze
+
+    attr_accessor \
+      :csv_data,
+      :rows,
+      :columns
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @csv_data = hash[:csv_data]
+      @rows = hash[:rows]
+      @columns = hash[:columns]
+    end
+  end
+end

data/lib/retab/workflow_runs/workflow_run.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class WorkflowRun < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      id: :id,
+      workflow: :workflow,
+      trigger: :trigger,
+      lifecycle: :lifecycle,
+      timing: :timing,
+      inputs: :inputs
+    }.freeze
+
+    attr_accessor \
+      :id,
+      :workflow,
+      :trigger,
+      :lifecycle,
+      :timing,
+      :inputs
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @id = hash[:id]
+      @workflow = hash[:workflow] ? Retab::WorkflowSnapshotRef.new(hash[:workflow]) : nil
+      @trigger = hash[:trigger] ? (case hash[:trigger][:type] when "api" then Retab::ApiTrigger.new(hash[:trigger]) when "email" then Retab::EmailTrigger.new(hash[:trigger]) when "manual" then Retab::ManualTrigger.new(hash[:trigger]) when "restart" then Retab::RestartTrigger.new(hash[:trigger]) when "schedule" then Retab::ScheduleTrigger.new(hash[:trigger]) when "webhook" then Retab::WebhookTrigger.new(hash[:trigger]) else hash[:trigger] end) : nil
+      @lifecycle = hash[:lifecycle] ? (case hash[:lifecycle][:status] when "awaiting_review" then Retab::AwaitingReviewRun.new(hash[:lifecycle]) when "cancelled" then Retab::CancelledTerminal.new(hash[:lifecycle]) when "completed" then Retab::CompletedTerminal.new(hash[:lifecycle]) when "error" then Retab::ErrorTerminal.new(hash[:lifecycle]) when "pending" then Retab::PendingRun.new(hash[:lifecycle]) when "running" then Retab::RunningRun.new(hash[:lifecycle]) else hash[:lifecycle] end) : nil
+      @timing = hash[:timing] ? Retab::RunTiming.new(hash[:timing]) : nil
+      @inputs = hash[:inputs] ? Retab::RunInputs.new(hash[:inputs]) : nil
+    end
+  end
+end

data/lib/retab/workflow_runs/workflow_snapshot_ref.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class WorkflowSnapshotRef < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      workflow_id: :workflow_id,
+      version_id: :version_id,
+      name_at_run_time: :name_at_run_time,
+      requested_version: :requested_version
+    }.freeze
+
+    attr_accessor \
+      :workflow_id,
+      :version_id,
+      :name_at_run_time,
+      :requested_version
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @workflow_id = hash[:workflow_id]
+      @version_id = hash[:version_id]
+      @name_at_run_time = hash[:name_at_run_time]
+      @requested_version = hash[:requested_version]
+    end
+  end
+end

data/lib/retab/workflow_runs.rb

@@ -0,0 +1,243 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+require 'json'
+
+module Retab
+  class WorkflowRuns
+    def initialize(client)
+      @client = client
+    end
+
+    # List Workflow Runs
+    # @param workflow_id [String, nil] Filter by workflow ID
+    # @param status [Retab::Types::WorkflowRunsStatus, nil] Filter by single run status (deprecated, use 'statuses')
+    # @param statuses [String, nil] Filter by multiple statuses (comma-separated: pending,queued,running,completed,error,failed,awaiting_review,cancelled)
+    # @param exclude_status [Retab::Types::WorkflowRunsExcludeStatus, nil] Exclude runs with this status
+    # @param trigger_type [Retab::Types::WorkflowRunsTriggerType, nil] Filter by single trigger type (deprecated, use 'trigger_types')
+    # @param trigger_types [String, nil] Filter by multiple trigger types (comma-separated: manual,api,schedule,webhook,email,restart)
+    # @param from_date [String, nil] Filter runs created on or after this date (YYYY-MM-DD)
+    # @param to_date [String, nil] Filter runs created on or before this date (YYYY-MM-DD)
+    # @param min_duration_ms [Integer, nil] Filter runs with duration >= this value in milliseconds
+    # @param max_duration_ms [Integer, nil] Filter runs with duration <= this value in milliseconds
+    # @param search [String, nil] Search by run ID (partial match)
+    # @param before [String, nil]
+    # @param after [String, nil]
+    # @param limit [Integer, nil] Items per page
+    # @param order [Retab::Types::WorkflowRunsOrder, nil]
+    # @param sort_by [String, nil]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Types::ListStruct<Retab::WorkflowRun>]
+    def list(
+      workflow_id: nil,
+      status: nil,
+      statuses: nil,
+      exclude_status: nil,
+      trigger_type: nil,
+      trigger_types: nil,
+      from_date: nil,
+      to_date: nil,
+      min_duration_ms: nil,
+      max_duration_ms: nil,
+      search: nil,
+      before: nil,
+      after: nil,
+      limit: 20,
+      order: 'desc',
+      sort_by: 'timing.created_at',
+      request_options: {}
+    )
+      params = {
+        'workflow_id' => workflow_id,
+        'status' => status,
+        'statuses' => statuses,
+        'exclude_status' => exclude_status,
+        'trigger_type' => trigger_type,
+        'trigger_types' => trigger_types,
+        'from_date' => from_date,
+        'to_date' => to_date,
+        'min_duration_ms' => min_duration_ms,
+        'max_duration_ms' => max_duration_ms,
+        'search' => search,
+        'before' => before,
+        'after' => after,
+        'limit' => limit,
+        'order' => order,
+        'sort_by' => sort_by
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: '/v1/workflows/runs',
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      fetch_next = ->(cursor) {
+        list(
+          workflow_id: workflow_id,
+          status: status,
+          statuses: statuses,
+          exclude_status: exclude_status,
+          trigger_type: trigger_type,
+          trigger_types: trigger_types,
+          from_date: from_date,
+          to_date: to_date,
+          min_duration_ms: min_duration_ms,
+          max_duration_ms: max_duration_ms,
+          search: search,
+          before: before,
+          after: cursor,
+          limit: limit,
+          order: order,
+          sort_by: sort_by,
+          request_options: request_options
+        )
+      }
+      Retab::Types::ListStruct.from_response(
+        response,
+        model: Retab::WorkflowRun,
+        filters: { workflow_id: workflow_id, status: status, statuses: statuses, exclude_status: exclude_status, trigger_type: trigger_type, trigger_types: trigger_types, from_date: from_date, to_date: to_date, min_duration_ms: min_duration_ms, max_duration_ms: max_duration_ms, search: search, before: before, limit: limit, order: order, sort_by: sort_by },
+        fetch_next: fetch_next
+      )
+    end
+
+    # Create Workflow Run Route
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::WorkflowRun]
+    def create(request_options: {})
+      response = @client.request(
+        method: :post,
+        path: '/v1/workflows/runs',
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::WorkflowRun.new(response.body)
+      result.last_response = Retab::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Get Workflow Export Payload
+    # @param workflow_id [String] Workflow ID to export
+    # @param block_id [String] Block ID to export
+    # @param export_source [Retab::Types::WorkflowExportPayloadRequestExportSource, nil] Use block outputs or inputs
+    # @param selected_run_ids [Array<String>, nil] Run IDs filter (null means all runs)
+    # @param selected_doc_types [Array<String>, nil] Doc type filter (null/empty means all)
+    # @param status [Retab::Types::WorkflowExportPayloadRequestStatus, nil] Optional status filter (intersects with completed-only export scope)
+    # @param exclude_status [Retab::Types::WorkflowExportPayloadRequestExcludeStatus, nil] Optional status exclusion filter (intersects with completed-only export scope)
+    # @param from_date [String, nil] Optional start date filter (YYYY-MM-DD)
+    # @param to_date [String, nil] Optional end date filter (YYYY-MM-DD)
+    # @param trigger_types [Array<Retab::Types::WorkflowExportPayloadRequestTriggerTypes>, nil] Optional trigger type filters
+    # @param preferred_columns [Array<String>, nil] Preferred data column order
+    # @param delimiter [String, nil] CSV field delimiter. Default is ';' (Excel-EU locale default); pass ',' for RFC 4180 / pandas compatibility. Cell values are always quoted when they contain the delimiter, the line terminator, or the quote character, with embedded quotes doubled per RFC 4180.
+    # @param line_delimiter [String, nil] CSV line delimiter
+    # @param quote [String, nil] CSV quote character
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::WorkflowExportPayloadResponse]
+    def export(
+      workflow_id:,
+      block_id:,
+      export_source: nil,
+      selected_run_ids: nil,
+      selected_doc_types: nil,
+      status: nil,
+      exclude_status: nil,
+      from_date: nil,
+      to_date: nil,
+      trigger_types: nil,
+      preferred_columns: nil,
+      delimiter: nil,
+      line_delimiter: nil,
+      quote: nil,
+      request_options: {}
+    )
+      body = {
+        'workflow_id' => workflow_id,
+        'block_id' => block_id,
+        'export_source' => export_source,
+        'selected_run_ids' => selected_run_ids,
+        'selected_doc_types' => selected_doc_types,
+        'status' => status,
+        'exclude_status' => exclude_status,
+        'from_date' => from_date,
+        'to_date' => to_date,
+        'trigger_types' => trigger_types,
+        'preferred_columns' => preferred_columns,
+        'delimiter' => delimiter,
+        'line_delimiter' => line_delimiter,
+        'quote' => quote
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/workflows/runs/export',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Retab::WorkflowExportPayloadResponse.new(response.body)
+      result.last_response = Retab::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Get Workflow Run
+    # @param run_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::WorkflowRun]
+    def get(
+      run_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :get,
+        path: "/v1/workflows/runs/#{Retab::Util.encode_path(run_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::WorkflowRun.new(response.body)
+      result.last_response = Retab::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Delete Workflow Run
+    # @param run_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [void]
+    def delete(
+      run_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :delete,
+        path: "/v1/workflows/runs/#{Retab::Util.encode_path(run_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      nil
+    end
+
+    # Cancel Workflow Run
+    # @param run_id [String]
+    # @param command_id [String, nil] Optional idempotency key for deduplicating cancel commands
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::CancelWorkflowResponse]
+    def cancel(
+      run_id:,
+      command_id: nil,
+      request_options: {}
+    )
+      body = {
+        'command_id' => command_id
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: "/v1/workflows/runs/#{Retab::Util.encode_path(run_id)}/cancel",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Retab::CancelWorkflowResponse.new(response.body)
+      result.last_response = Retab::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+  end
+end

data/lib/retab/workflow_specs/declarative_apply_response.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class DeclarativeApplyResponse < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      workflow_id: :workflow_id,
+      action: :action,
+      created: :created,
+      block_count: :block_count,
+      edge_count: :edge_count,
+      diagnostics: :diagnostics,
+      format_version: :format_version,
+      summary: :summary,
+      resource_changes: :resource_changes,
+      rendered_plan: :rendered_plan
+    }.freeze
+
+    attr_accessor \
+      :workflow_id,
+      :action,
+      :created,
+      :block_count,
+      :edge_count,
+      :diagnostics,
+      :format_version,
+      :summary,
+      :resource_changes,
+      :rendered_plan
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @workflow_id = hash[:workflow_id]
+      @action = hash[:action]
+      @created = hash[:created]
+      @block_count = hash[:block_count]
+      @edge_count = hash[:edge_count]
+      @diagnostics = hash[:diagnostics] || {}
+      @format_version = hash[:format_version]
+      @summary = hash[:summary] ? Retab::DeclarativePlanSummary.new(hash[:summary]) : nil
+      @resource_changes = (hash[:resource_changes] || []).map { |item| item ? Retab::DeclarativePlanResourceChange.new(item) : nil }
+      @rendered_plan = hash[:rendered_plan]
+    end
+  end
+end