retab 0.1.0 → 0.1.2

data/lib/retab/types/base_model.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# This file is auto-generated by oagen. Do not edit.
+
 # @oagen-ignore-file
 #
 # Hand-maintained BaseModel. All spec-derived model classes extend this:
@@ -18,22 +20,40 @@
 #   - `to_h` / `to_json` / `inspect` — driven by the subclass's HASH_ATTRS.
 #   - `last_response` — the API response wrapper attached by resource methods.
 
-require 'json'
+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.
+      # Normalize incoming `json` into a Hash with symbol keys (all the way
+      # down). The spec-derived `initialize` body reads `hash[:foo]` and
+      # passes nested values to other model constructors / discriminator
+      # `case ... when "api" then` dispatchers. The String branch already
+      # symbolizes deeply via `JSON.parse(..., symbolize_names: true)`; the
+      # Hash branch must match — otherwise list responses (which arrive as
+      # string-keyed Hashes from `ListStruct.from_response`'s `JSON.parse`)
+      # leave nested data unsymbolized and the discriminator falls through
+      # to the raw `else` branch instead of constructing the typed variant.
       def self.normalize(json)
         return {} if json.nil?
-        return json.transform_keys(&:to_sym) if json.is_a?(Hash)
+        return deep_symbolize(json) 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 self.deep_symbolize(value)
+        case value
+        when Hash
+          value.each_with_object({}) { |(k, v), h| h[k.to_sym] = deep_symbolize(v) }
+        when Array
+          value.map { |v| deep_symbolize(v) }
+        else
+          value
+        end
+      end
+
       def to_h
         hash_attrs = self.class.const_defined?(:HASH_ATTRS) ? self.class.const_get(:HASH_ATTRS) : {}
         out = {}
@@ -41,6 +61,7 @@ module Retab
           value = instance_variable_get("@#{attr}")
           out[wire_key] = serialize(value)
         end
+
         out
       end
 
@@ -49,7 +70,7 @@ module Retab
       end
 
       def inspect
-        attrs = to_h.map { |k, v| "#{k}=#{v.inspect}" }.join(' ')
+        attrs = to_h.map { |k, v| "#{k}=#{v.inspect}" }.join(" ")
         "#<#{self.class.name} #{attrs}>"
       end
 
@@ -57,10 +78,14 @@ module Retab
 
       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
+        when BaseModel
+          value.to_h
+        when Array
+          value.map { |v| serialize(v) }
+        when Hash
+          value.transform_values { |v| serialize(v) }
+        else
+          value
         end
       end
     end

data/lib/retab/types/cancel_workflow_response_cancellation_status.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class CancelWorkflowResponseCancellationStatus
-      CANCELLED = 'cancelled'
-      CANCELLATION_REQUESTED = 'cancellation_requested'
-      CANCELLATION_FAILED = 'cancellation_failed'
+      CANCELLED = "cancelled"
+      CANCELLATION_REQUESTED = "cancellation_requested"
+      CANCELLATION_FAILED = "cancellation_failed"
       ALL = [CANCELLED, CANCELLATION_REQUESTED, CANCELLATION_FAILED].freeze
     end
   end

data/lib/retab/types/classifications_order.rb

@@ -5,8 +5,8 @@
 module Retab
   module Types
     class ClassificationsOrder
-      ASC = 'asc'
-      DESC = 'desc'
+      ASC = "asc"
+      DESC = "desc"
       ALL = [ASC, DESC].freeze
     end
   end

data/lib/retab/types/condition_evaluation_details_logical_operator.rb

@@ -5,8 +5,8 @@
 module Retab
   module Types
     class ConditionEvaluationDetailsLogicalOperator
-      AND = 'and'
-      OR = 'or'
+      AND = "and"
+      OR = "or"
       ALL = [AND, OR].freeze
     end
   end

data/lib/retab/types/create_experiment_request_n_consensus.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class CreateExperimentRequestNConsensus
-      VALUE_3 = '3'
-      VALUE_5 = '5'
-      VALUE_7 = '7'
+      VALUE_3 = "3"
+      VALUE_5 = "5"
+      VALUE_7 = "7"
       ALL = [VALUE_3, VALUE_5, VALUE_7].freeze
     end
   end

data/lib/retab/types/create_job_request_endpoint.rb

@@ -5,18 +5,30 @@
 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
+      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

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class DeclarativeApplyResponseAction
-      CREATE = 'create'
-      UPDATE = 'update'
-      NOOP = 'noop'
+      CREATE = "create"
+      UPDATE = "update"
+      NOOP = "noop"
       ALL = [CREATE, UPDATE, NOOP].freeze
     end
   end

data/lib/retab/types/declarative_plan_field_change_action.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class DeclarativePlanFieldChangeAction
-      CREATE = 'create'
-      UPDATE = 'update'
-      DELETE = 'delete'
+      CREATE = "create"
+      UPDATE = "update"
+      DELETE = "delete"
       ALL = [CREATE, UPDATE, DELETE].freeze
     end
   end

data/lib/retab/types/declarative_plan_resource_change_target.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class DeclarativePlanResourceChangeTarget
-      WORKFLOW = 'workflow'
-      BLOCK = 'block'
-      EDGE = 'edge'
+      WORKFLOW = "workflow"
+      BLOCK = "block"
+      EDGE = "edge"
       ALL = [WORKFLOW, BLOCK, EDGE].freeze
     end
   end

data/lib/retab/types/declarative_plan_resource_change_type.rb

@@ -5,28 +5,50 @@
 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
+      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/error_step_lifecycle_category.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class ErrorStepLifecycleCategory
-      TRANSIENT = 'transient'
-      PERMANENT = 'permanent'
-      QUOTA = 'quota'
+      TRANSIENT = "transient"
+      PERMANENT = "permanent"
+      QUOTA = "quota"
       ALL = [TRANSIENT, PERMANENT, QUOTA].freeze
     end
   end

data/lib/retab/types/error_step_lifecycle_stage.rb

@@ -5,13 +5,13 @@
 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'
+      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

data/lib/retab/types/experiment_block_type.rb

@@ -5,10 +5,10 @@
 module Retab
   module Types
     class ExperimentBlockType
-      EXTRACT = 'extract'
-      CLASSIFIER = 'classifier'
-      SPLIT = 'split'
-      FOR_EACH = 'for_each'
+      EXTRACT = "extract"
+      CLASSIFIER = "classifier"
+      SPLIT = "split"
+      FOR_EACH = "for_each"
       ALL = [EXTRACT, CLASSIFIER, SPLIT, FOR_EACH].freeze
     end
   end

data/lib/retab/types/experiment_public_status.rb

@@ -5,11 +5,11 @@
 module Retab
   module Types
     class ExperimentPublicStatus
-      DRAFT = 'draft'
-      PROCESSING = 'processing'
-      COMPLETED = 'completed'
-      FAILED = 'failed'
-      CANCELLED = 'cancelled'
+      DRAFT = "draft"
+      PROCESSING = "processing"
+      COMPLETED = "completed"
+      FAILED = "failed"
+      CANCELLED = "cancelled"
       ALL = [DRAFT, PROCESSING, COMPLETED, FAILED, CANCELLED].freeze
     end
   end

data/lib/retab/types/experiment_run_metrics_view.rb

@@ -5,10 +5,10 @@
 module Retab
   module Types
     class ExperimentRunMetricsView
-      SUMMARY = 'summary'
-      BY_DOCUMENT = 'by_document'
-      BY_TARGET = 'by_target'
-      VOTES = 'votes'
+      SUMMARY = "summary"
+      BY_DOCUMENT = "by_document"
+      BY_TARGET = "by_target"
+      VOTES = "votes"
       ALL = [SUMMARY, BY_DOCUMENT, BY_TARGET, VOTES].freeze
     end
   end

data/lib/retab/types/experiment_run_results_order.rb

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

data/lib/retab/types/experiment_schema_drift_status.rb

@@ -5,10 +5,10 @@
 module Retab
   module Types
     class ExperimentSchemaDriftStatus
-      NONE = 'none'
-      PARTIAL = 'partial'
-      DRIFTED = 'drifted'
-      UNKNOWN = 'unknown'
+      NONE = "none"
+      PARTIAL = "partial"
+      DRIFTED = "drifted"
+      UNKNOWN = "unknown"
       ALL = [NONE, PARTIAL, DRIFTED, UNKNOWN].freeze
     end
   end

data/lib/retab/types/field_type.rb

@@ -5,8 +5,8 @@
 module Retab
   module Types
     class FieldType
-      TEXT = 'text'
-      CHECKBOX = 'checkbox'
+      TEXT = "text"
+      CHECKBOX = "checkbox"
       ALL = [TEXT, CHECKBOX].freeze
     end
   end

data/lib/retab/types/generate_schema_request_reasoning_effort.rb

@@ -5,12 +5,12 @@
 module Retab
   module Types
     class GenerateSchemaRequestReasoningEffort
-      NONE = 'none'
-      MINIMAL = 'minimal'
-      LOW = 'low'
-      MEDIUM = 'medium'
-      HIGH = 'high'
-      XHIGH = 'xhigh'
+      NONE = "none"
+      MINIMAL = "minimal"
+      LOW = "low"
+      MEDIUM = "medium"
+      HIGH = "high"
+      XHIGH = "xhigh"
       ALL = [NONE, MINIMAL, LOW, MEDIUM, HIGH, XHIGH].freeze
     end
   end

data/lib/retab/types/handle_payload_type.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class HandlePayloadType
-      FILE = 'file'
-      JSON = 'json'
-      JSON_REF = 'json_ref'
+      FILE = "file"
+      JSON = "json"
+      JSON_REF = "json_ref"
       ALL = [FILE, JSON, JSON_REF].freeze
     end
   end

data/lib/retab/types/job_status.rb

@@ -5,13 +5,13 @@
 module Retab
   module Types
     class JobStatus
-      VALIDATING = 'validating'
-      QUEUED = 'queued'
-      IN_PROGRESS = 'in_progress'
-      COMPLETED = 'completed'
-      FAILED = 'failed'
-      CANCELLED = 'cancelled'
-      EXPIRED = 'expired'
+      VALIDATING = "validating"
+      QUEUED = "queued"
+      IN_PROGRESS = "in_progress"
+      COMPLETED = "completed"
+      FAILED = "failed"
+      CANCELLED = "cancelled"
+      EXPIRED = "expired"
       ALL = [VALIDATING, QUEUED, IN_PROGRESS, COMPLETED, FAILED, CANCELLED, EXPIRED].freeze
     end
   end

data/lib/retab/types/jobs_source.rb

@@ -5,9 +5,9 @@
 module Retab
   module Types
     class JobsSource
-      API = 'api'
-      PROJECT = 'project'
-      WORKFLOW = 'workflow'
+      API = "api"
+      PROJECT = "project"
+      WORKFLOW = "workflow"
       ALL = [API, PROJECT, WORKFLOW].freeze
     end
   end

data/lib/retab/types/latest_block_test_run_summary_status.rb

@@ -5,12 +5,12 @@
 module Retab
   module Types
     class LatestBlockTestRunSummaryStatus
-      PENDING = 'pending'
-      QUEUED = 'queued'
-      RUNNING = 'running'
-      COMPLETED = 'completed'
-      ERROR = 'error'
-      CANCELLED = 'cancelled'
+      PENDING = "pending"
+      QUEUED = "queued"
+      RUNNING = "running"
+      COMPLETED = "completed"
+      ERROR = "error"
+      CANCELLED = "cancelled"
       ALL = [PENDING, QUEUED, RUNNING, COMPLETED, ERROR, CANCELLED].freeze
     end
   end

data/lib/retab/types/length_compare_condition_op.rb

@@ -5,12 +5,12 @@
 module Retab
   module Types
     class LengthCompareConditionOp
-      GT = 'gt'
-      GTE = 'gte'
-      LT = 'lt'
-      LTE = 'lte'
-      EQ = 'eq'
-      NEQ = 'neq'
+      GT = "gt"
+      GTE = "gte"
+      LT = "lt"
+      LTE = "lte"
+      EQ = "eq"
+      NEQ = "neq"
       ALL = [GT, GTE, LT, LTE, EQ, NEQ].freeze
     end
   end

data/lib/retab/types/list_struct.rb

@@ -1,59 +1,22 @@
 # frozen_string_literal: true
 
+# This file is auto-generated by oagen. Do not edit.
+
 # @oagen-ignore-file
 #
-# Hand-maintained pagination wrapper. Spec-derived resources that return a
-# `list_metadata` envelope call `ListStruct.from_response(response, model:, ...)`.
-
-require 'json'
+# Backwards-compatibility alias for `Retab::PaginatedList`.
+#
+# Older SDK versions exposed the page wrapper as `Retab::Types::ListStruct`.
+# Today every list method returns `Retab::PaginatedList` (see
+# `lib/retab/paginated_list.rb`); this alias keeps the historical type
+# name resolvable so existing consumer code (`assert_kind_of
+# Retab::Types::ListStruct, result`, etc.) continues to compile.
+#
+# New code should reference `Retab::PaginatedList` directly. The alias
+# itself can be retired in a future major.
 
 module Retab
   module Types
-    class ListStruct
-      include Enumerable
-
-      attr_reader :data, :list_metadata, :last_response
-
-      def initialize(data: [], list_metadata: {}, last_response: nil, fetch_next: nil)
-        @data = data
-        @list_metadata = list_metadata
-        @last_response = last_response
-        @fetch_next = fetch_next
-      end
-
-      def each(&block)
-        @data.each(&block)
-      end
-
-      def has_next?
-        cursor = @list_metadata.is_a?(Hash) ? (@list_metadata[:after] || @list_metadata['after']) : nil
-        !cursor.nil? && !cursor.to_s.empty?
-      end
-
-      def next_page
-        return nil unless has_next? && @fetch_next
-        cursor = @list_metadata[:after] || @list_metadata['after']
-        @fetch_next.call(cursor)
-      end
-
-      # Construct a ListStruct from an HTTP response with `{data: [...], list_metadata: {...}}`.
-      def self.from_response(response, model: nil, filters: {}, fetch_next: nil)
-        _ = filters
-        body = response.respond_to?(:body) ? response.body : response
-        parsed = body.is_a?(String) ? JSON.parse(body) : (body || {})
-        raw_items = parsed['data'] || parsed[:data] || []
-        items = raw_items.map { |item| model ? model.new(item) : item }
-        meta = parsed['list_metadata'] || parsed[:list_metadata] || {}
-        api_response =
-          if response.respond_to?(:code)
-            ApiResponse.new(
-              http_status: response.code.to_i,
-              http_headers: response.respond_to?(:each_header) ? response.each_header.to_h : {},
-              request_id: response.respond_to?(:[]) ? response['x-request-id'] : nil,
-            )
-          end
-        new(data: items, list_metadata: meta, last_response: api_response, fetch_next: fetch_next)
-      end
-    end
+    ListStruct = Retab::PaginatedList
   end
 end

data/lib/retab/types/parse_request_table_parsing_format.rb

@@ -5,10 +5,10 @@
 module Retab
   module Types
     class ParseRequestTableParsingFormat
-      MARKDOWN = 'markdown'
-      YAML = 'yaml'
-      HTML = 'html'
-      JSON = 'json'
+      MARKDOWN = "markdown"
+      YAML = "yaml"
+      HTML = "html"
+      JSON = "json"
       ALL = [MARKDOWN, YAML, HTML, JSON].freeze
     end
   end

data/lib/retab/types/request_options.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# This file is auto-generated by oagen. Do not edit.
+
 # @oagen-ignore-file
 #
 # Hand-maintained RequestOptions. Spec-derived methods accept

data/lib/retab/types/resume_status.rb

@@ -5,10 +5,11 @@
 module Retab
   module Types
     class ResumeStatus
-      RESUMED = 'resumed'
-      PENDING = 'pending'
-      SKIPPED = 'skipped'
-      ALL = [RESUMED, PENDING, SKIPPED].freeze
+      RESUMED = "resumed"
+      PENDING = "pending"
+      FAILED = "failed"
+      SKIPPED = "skipped"
+      ALL = [RESUMED, PENDING, FAILED, SKIPPED].freeze
     end
   end
 end