retab 0.1.0

data/lib/retab/splits.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+require 'json'
+
+module Retab
+  class Splits
+    def initialize(client)
+      @client = client
+    end
+
+    # List Splits
+    # @param before [String, nil]
+    # @param after [String, nil]
+    # @param limit [Integer, nil]
+    # @param order [Retab::Types::SplitsOrder, nil]
+    # @param filename [String, nil]
+    # @param from_date [String, nil]
+    # @param to_date [String, nil]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Types::ListStruct<Retab::Split>]
+    def list(
+      before: nil,
+      after: nil,
+      limit: 10,
+      order: 'desc',
+      filename: nil,
+      from_date: nil,
+      to_date: nil,
+      request_options: {}
+    )
+      params = {
+        'before' => before,
+        'after' => after,
+        'limit' => limit,
+        'order' => order,
+        'filename' => filename,
+        'from_date' => from_date,
+        'to_date' => to_date
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: '/v1/splits',
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      fetch_next = ->(cursor) {
+        list(
+          before: before,
+          after: cursor,
+          limit: limit,
+          order: order,
+          filename: filename,
+          from_date: from_date,
+          to_date: to_date,
+          request_options: request_options
+        )
+      }
+      Retab::Types::ListStruct.from_response(
+        response,
+        model: Retab::Split,
+        filters: { before: before, limit: limit, order: order, filename: filename, from_date: from_date, to_date: to_date },
+        fetch_next: fetch_next
+      )
+    end
+
+    # Create Split
+    # @param document [Retab::MimeData, Pathname, IO, String, Hash] The document to split
+    # @param subdocuments [Array<Retab::Subdocument>] The subdocuments to split the document into
+    # @param model [String, nil] The model to use to split the document
+    # @param instructions [String, nil] Free-form instructions appended to the system prompt to steer the split.
+    # @param n_consensus [Integer, nil] Number of consensus split runs to perform. Uses deterministic single-pass when set to 1.
+    # @param bust_cache [Boolean, nil] If true, skip the LLM cache and force a fresh completion
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Split]
+    def create(
+      document:,
+      subdocuments:,
+      model: nil,
+      instructions: nil,
+      n_consensus: nil,
+      bust_cache: nil,
+      request_options: {}
+    )
+      document = Retab::MimeData.coerce(document) unless document.nil?
+      body = {
+        'document' => document,
+        'subdocuments' => subdocuments,
+        'model' => model,
+        'instructions' => instructions,
+        'n_consensus' => n_consensus,
+        'bust_cache' => bust_cache
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: '/v1/splits',
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Retab::Split.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 Split
+    # @param split_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Split]
+    def get(
+      split_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :get,
+        path: "/v1/splits/#{Retab::Util.encode_path(split_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::Split.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 Split
+    # @param split_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [void]
+    def delete(
+      split_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :delete,
+        path: "/v1/splits/#{Retab::Util.encode_path(split_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      nil
+    end
+  end
+end

data/lib/retab/types/actor_kind.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ActorKind
+      MODEL = 'model'
+      AGENT = 'agent'
+      HUMAN = 'human'
+      ALL = [MODEL, AGENT, HUMAN].freeze
+    end
+  end
+end

data/lib/retab/types/api_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# @oagen-ignore-file
+#
+# Hand-maintained ApiResponse wrapper. Resource methods attach this to
+# every returned model via `result.last_response = ...`.
+
+module Retab
+  module Types
+    class ApiResponse
+      attr_reader :http_status, :http_headers, :request_id
+
+      def initialize(http_status:, http_headers: {}, request_id: nil)
+        @http_status = http_status
+        @http_headers = http_headers
+        @request_id = request_id
+      end
+    end
+  end
+end

data/lib/retab/types/assertion_drift_status.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class AssertionDriftStatus
+      VALID = 'valid'
+      DRIFTED = 'drifted'
+      BROKEN = 'broken'
+      ALL = [VALID, DRIFTED, BROKEN].freeze
+    end
+  end
+end

data/lib/retab/types/assertion_outcome.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class AssertionOutcome
+      PASSED = 'passed'
+      FAILED = 'failed'
+      BLOCKED = 'blocked'
+      ALL = [PASSED, FAILED, BLOCKED].freeze
+    end
+  end
+end

data/lib/retab/types/base_model.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# @oagen-ignore-file
+#
+# Hand-maintained BaseModel. All spec-derived model classes extend this:
+#
+#   module Retab
+#     class Extraction < Retab::Types::BaseModel
+#       HASH_ATTRS = { id: :id, ... }.freeze
+#       attr_accessor :id, ...
+#       def initialize(json) = ... end
+#     end
+#   end
+#
+# Provides:
+#   - `self.normalize(json)` — parse `String` JSON or accept a Hash, return
+#     symbol-keyed Hash for `initialize(json)` field assignment.
+#   - `to_h` / `to_json` / `inspect` — driven by the subclass's HASH_ATTRS.
+#   - `last_response` — the API response wrapper attached by resource methods.
+
+require 'json'
+
+module Retab
+  module Types
+    class BaseModel
+      attr_accessor :last_response
+
+      # Normalize incoming `json` into a Hash with symbol keys. The
+      # spec-derived `initialize` body reads `hash[:foo]` directly.
+      def self.normalize(json)
+        return {} if json.nil?
+        return json.transform_keys(&:to_sym) if json.is_a?(Hash)
+        return JSON.parse(json, symbolize_names: true) if json.is_a?(String)
+        raise ArgumentError, "cannot normalize #{json.class} into a model hash"
+      end
+
+      def to_h
+        hash_attrs = self.class.const_defined?(:HASH_ATTRS) ? self.class.const_get(:HASH_ATTRS) : {}
+        out = {}
+        hash_attrs.each do |wire_key, attr|
+          value = instance_variable_get("@#{attr}")
+          out[wire_key] = serialize(value)
+        end
+        out
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+
+      def inspect
+        attrs = to_h.map { |k, v| "#{k}=#{v.inspect}" }.join(' ')
+        "#<#{self.class.name} #{attrs}>"
+      end
+
+      private
+
+      def serialize(value)
+        case value
+        when BaseModel then value.to_h
+        when Array then value.map { |v| serialize(v) }
+        when Hash then value.transform_values { |v| serialize(v) }
+        else value
+        end
+      end
+    end
+  end
+end

data/lib/retab/types/cancel_workflow_response_cancellation_status.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class CancelWorkflowResponseCancellationStatus
+      CANCELLED = 'cancelled'
+      CANCELLATION_REQUESTED = 'cancellation_requested'
+      CANCELLATION_FAILED = 'cancellation_failed'
+      ALL = [CANCELLED, CANCELLATION_REQUESTED, CANCELLATION_FAILED].freeze
+    end
+  end
+end

data/lib/retab/types/classifications_order.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ClassificationsOrder
+      ASC = 'asc'
+      DESC = 'desc'
+      ALL = [ASC, DESC].freeze
+    end
+  end
+end

data/lib/retab/types/condition_evaluation_details_logical_operator.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ConditionEvaluationDetailsLogicalOperator
+      AND = 'and'
+      OR = 'or'
+      ALL = [AND, OR].freeze
+    end
+  end
+end

data/lib/retab/types/condition_evaluation_result_logical_operator.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ConditionEvaluationResultLogicalOperator = ConditionEvaluationDetailsLogicalOperator
+  end
+end

data/lib/retab/types/create_experiment_request_n_consensus.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class CreateExperimentRequestNConsensus
+      VALUE_3 = '3'
+      VALUE_5 = '5'
+      VALUE_7 = '7'
+      ALL = [VALUE_3, VALUE_5, VALUE_7].freeze
+    end
+  end
+end

data/lib/retab/types/create_job_request_endpoint.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class CreateJobRequestEndpoint
+      V_1_EXTRACTIONS = '/v1/extractions'
+      V_1_PARSES = '/v1/parses'
+      V_1_SPLITS = '/v1/splits'
+      V_1_PARTITIONS = '/v1/partitions'
+      V_1_CLASSIFICATIONS = '/v1/classifications'
+      V_1_SCHEMAS_GENERATE = '/v1/schemas/generate'
+      V_1_EDITS = '/v1/edits'
+      V_1_EDITS_TEMPLATES_GENERATE = '/v1/edits/templates/generate'
+      V_1_EVALS_EXTRACT_PROCESS = '/v1/evals/extract/process'
+      V_1_EVALS_EXTRACT_EXTRACT = '/v1/evals/extract/extract'
+      V_1_EVALS_EXTRACT_SPLIT = '/v1/evals/extract/split'
+      ALL = [V_1_EXTRACTIONS, V_1_PARSES, V_1_SPLITS, V_1_PARTITIONS, V_1_CLASSIFICATIONS, V_1_SCHEMAS_GENERATE, V_1_EDITS, V_1_EDITS_TEMPLATES_GENERATE, V_1_EVALS_EXTRACT_PROCESS, V_1_EVALS_EXTRACT_EXTRACT, V_1_EVALS_EXTRACT_SPLIT].freeze
+    end
+  end
+end

data/lib/retab/types/declarative_apply_response_action.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class DeclarativeApplyResponseAction
+      CREATE = 'create'
+      UPDATE = 'update'
+      NOOP = 'noop'
+      ALL = [CREATE, UPDATE, NOOP].freeze
+    end
+  end
+end

data/lib/retab/types/declarative_plan_field_change_action.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class DeclarativePlanFieldChangeAction
+      CREATE = 'create'
+      UPDATE = 'update'
+      DELETE = 'delete'
+      ALL = [CREATE, UPDATE, DELETE].freeze
+    end
+  end
+end

data/lib/retab/types/declarative_plan_resource_change_actions.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    DeclarativePlanResourceChangeActions = DeclarativePlanFieldChangeAction
+  end
+end

data/lib/retab/types/declarative_plan_resource_change_target.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class DeclarativePlanResourceChangeTarget
+      WORKFLOW = 'workflow'
+      BLOCK = 'block'
+      EDGE = 'edge'
+      ALL = [WORKFLOW, BLOCK, EDGE].freeze
+    end
+  end
+end

data/lib/retab/types/declarative_plan_resource_change_type.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class DeclarativePlanResourceChangeType
+      WORKFLOW = 'workflow'
+      EDGE = 'edge'
+      START_DOCUMENT = 'start_document'
+      START_JSON = 'start_json'
+      NOTE = 'note'
+      PARSE = 'parse'
+      EDIT = 'edit'
+      EXTRACT = 'extract'
+      SPLIT = 'split'
+      CLASSIFIER = 'classifier'
+      CONDITIONAL = 'conditional'
+      API_CALL = 'api_call'
+      REVIEW = 'review'
+      FUNCTION = 'function'
+      WHILE_LOOP = 'while_loop'
+      FOR_EACH = 'for_each'
+      MERGE_DICTS = 'merge_dicts'
+      WHILE_LOOP_SENTINEL_START = 'while_loop_sentinel_start'
+      WHILE_LOOP_SENTINEL_END = 'while_loop_sentinel_end'
+      FOR_EACH_SENTINEL_START = 'for_each_sentinel_start'
+      FOR_EACH_SENTINEL_END = 'for_each_sentinel_end'
+      ALL = [WORKFLOW, EDGE, START_DOCUMENT, START_JSON, NOTE, PARSE, EDIT, EXTRACT, SPLIT, CLASSIFIER, CONDITIONAL, API_CALL, REVIEW, FUNCTION, WHILE_LOOP, FOR_EACH, MERGE_DICTS, WHILE_LOOP_SENTINEL_START, WHILE_LOOP_SENTINEL_END, FOR_EACH_SENTINEL_START, FOR_EACH_SENTINEL_END].freeze
+    end
+  end
+end

data/lib/retab/types/declarative_plan_response_action.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    DeclarativePlanResponseAction = DeclarativeApplyResponseAction
+  end
+end

data/lib/retab/types/edit_templates_order.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    EditTemplatesOrder = ClassificationsOrder
+  end
+end

data/lib/retab/types/edits_order.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    EditsOrder = ClassificationsOrder
+  end
+end

data/lib/retab/types/error_step_lifecycle_category.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ErrorStepLifecycleCategory
+      TRANSIENT = 'transient'
+      PERMANENT = 'permanent'
+      QUOTA = 'quota'
+      ALL = [TRANSIENT, PERMANENT, QUOTA].freeze
+    end
+  end
+end

data/lib/retab/types/error_step_lifecycle_stage.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ErrorStepLifecycleStage
+      INPUT_COLLECTION = 'input_collection'
+      REGISTRY_LOOKUP = 'registry_lookup'
+      DOCUMENT_FETCH = 'document_fetch'
+      EXECUTION = 'execution'
+      OUTPUT_STORAGE = 'output_storage'
+      ROUTING = 'routing'
+      HISTORY_PAYLOAD = 'history_payload'
+      ALL = [INPUT_COLLECTION, REGISTRY_LOOKUP, DOCUMENT_FETCH, EXECUTION, OUTPUT_STORAGE, ROUTING, HISTORY_PAYLOAD].freeze
+    end
+  end
+end

data/lib/retab/types/error_terminal_category.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ErrorTerminalCategory = ErrorStepLifecycleCategory
+  end
+end

data/lib/retab/types/error_terminal_stage.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ErrorTerminalStage = ErrorStepLifecycleStage
+  end
+end

data/lib/retab/types/experiment_block_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ExperimentBlockType
+      EXTRACT = 'extract'
+      CLASSIFIER = 'classifier'
+      SPLIT = 'split'
+      FOR_EACH = 'for_each'
+      ALL = [EXTRACT, CLASSIFIER, SPLIT, FOR_EACH].freeze
+    end
+  end
+end

data/lib/retab/types/experiment_public_status.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ExperimentPublicStatus
+      DRAFT = 'draft'
+      PROCESSING = 'processing'
+      COMPLETED = 'completed'
+      FAILED = 'failed'
+      CANCELLED = 'cancelled'
+      ALL = [DRAFT, PROCESSING, COMPLETED, FAILED, CANCELLED].freeze
+    end
+  end
+end

data/lib/retab/types/experiment_result_block_type.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ExperimentResultBlockType = ExperimentBlockType
+  end
+end

data/lib/retab/types/experiment_run_block_type.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ExperimentRunBlockType = ExperimentBlockType
+  end
+end

data/lib/retab/types/experiment_run_metrics_view.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ExperimentRunMetricsView
+      SUMMARY = 'summary'
+      BY_DOCUMENT = 'by_document'
+      BY_TARGET = 'by_target'
+      VOTES = 'votes'
+      ALL = [SUMMARY, BY_DOCUMENT, BY_TARGET, VOTES].freeze
+    end
+  end
+end

data/lib/retab/types/experiment_run_n_consensus.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ExperimentRunNConsensus = CreateExperimentRequestNConsensus
+  end
+end

data/lib/retab/types/experiment_runs_order.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ExperimentRunsOrder = ClassificationsOrder
+  end
+end

data/lib/retab/types/experiment_schema_drift_status.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    class ExperimentSchemaDriftStatus
+      NONE = 'none'
+      PARTIAL = 'partial'
+      DRIFTED = 'drifted'
+      UNKNOWN = 'unknown'
+      ALL = [NONE, PARTIAL, DRIFTED, UNKNOWN].freeze
+    end
+  end
+end

data/lib/retab/types/experiment_summary_metrics_response_block_type.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  module Types
+    ExperimentSummaryMetricsResponseBlockType = ExperimentBlockType
+  end
+end