retab 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c542985f50a483d9a91c531778ba8191d63626f5bacba64fa84605c79c661c0
-  data.tar.gz: d3e600d82b2469642c113976fba5b51ce8cba536dca9bec2280a4a1fb67f2cc0
+  metadata.gz: 892cc7d33cd77ee2992206da231970259f4f0cf3668c762671b114b78116d1ee
+  data.tar.gz: 17e6a78b1858ab551518b0b379b92b4d54980e25565ce0d567504b17c2f0294c
 SHA512:
-  metadata.gz: 4a22060ef5516694422576b8fc30af4ea499c9c25e05ae0f3236f2f32958edc25812b0998eea94e438d58baa21380d28bb03ed7a4e8a07212067f507a85f26c7
-  data.tar.gz: 6680c041a7c42ad9c22d1406ca81800255a68f812bc54a025430191106b9a91e2aaf38733dca5ddc2bd6b6daf0d60de8420afea5fc24c4c0178ba20c19c21b01
+  metadata.gz: 653dc2782eee8ec927931b08da074dff4bceb322e7605a74ba14f2629cc6c9a8dca82c66de8748bc13e72a5cfc38c256b2b147844298b0c82000ccfa84c8d33e
+  data.tar.gz: 04d599b812516886ac4b0a2f3336af22d96418a40340da1412b45ed43e2b98733d2cbdbee41e35d70af30b7b4ea38df5c7651ef40ece0fba3a1a065b12d74237

data/lib/retab/classifications/category.rb

@@ -22,7 +22,7 @@ module Retab
       hash = self.class.normalize(json)
       @name = hash[:name]
       @handle_key = hash[:handle_key]
-      @description = hash[:description]
+      @description = hash[:description].nil? ? "" : hash[:description]
     end
   end
 end

data/lib/retab/classifications/classification.rb

@@ -13,6 +13,8 @@ module Retab
       n_consensus: :n_consensus,
       instructions: :instructions,
       output: :output,
+      status: :status,
+      error: :error,
       consensus: :consensus,
       usage: :usage,
       created_at: :created_at
@@ -26,6 +28,8 @@ module Retab
       :n_consensus,
       :instructions,
       :output,
+      :status,
+      :error,
       :consensus,
       :usage,
       :created_at
@@ -41,6 +45,8 @@ module Retab
       @n_consensus = hash[:n_consensus]
       @instructions = hash[:instructions]
       @output = hash[:output] ? Retab::ClassificationDecision.new(hash[:output]) : nil
+      @status = hash[:status].nil? ? "pending" : hash[:status]
+      @error = hash[:error] ? Retab::PrimitiveError.new(hash[:error]) : nil
       @consensus = hash[:consensus] ? Retab::ClassificationConsensus.new(hash[:consensus]) : nil
       @usage = hash[:usage] ? Retab::RetabUsage.new(hash[:usage]) : nil
       @created_at = hash[:created_at]

data/lib/retab/classifications/classification_request.rb

@@ -12,7 +12,8 @@ module Retab
       first_n_pages: :first_n_pages,
       instructions: :instructions,
       n_consensus: :n_consensus,
-      bust_cache: :bust_cache
+      bust_cache: :bust_cache,
+      background: :background
     }.freeze
 
     attr_accessor(
@@ -22,7 +23,8 @@ module Retab
       :first_n_pages,
       :instructions,
       :n_consensus,
-      :bust_cache
+      :bust_cache,
+      :background
     )
 
     def initialize(json)
@@ -30,11 +32,12 @@ module Retab
       hash = self.class.normalize(json)
       @document = hash[:document] ? Retab::MimeData.new(hash[:document]) : nil
       @categories = (hash[:categories] || []).map { |item| item ? Retab::Category.new(item) : nil }
-      @model = hash[:model]
+      @model = hash[:model].nil? ? "retab-small" : hash[:model]
       @first_n_pages = hash[:first_n_pages]
       @instructions = hash[:instructions]
       @n_consensus = hash[:n_consensus]
-      @bust_cache = hash[:bust_cache]
+      @bust_cache = hash[:bust_cache].nil? ? false : hash[:bust_cache]
+      @background = hash[:background].nil? ? false : hash[:background]
     end
   end
 end

data/lib/retab/{jobs/job_error.rb → classifications/primitive_error.rb}

@@ -3,7 +3,7 @@
 # This file is auto-generated by oagen. Do not edit.
 
 module Retab
-  class JobError < Retab::Types::BaseModel
+  class PrimitiveError < Retab::Types::BaseModel
 
     HASH_ATTRS = {
       code: :code,

data/lib/retab/classifications.rb

@@ -16,6 +16,7 @@ module Retab
     # @param limit [Integer, nil]
     # @param order [Retab::Types::ClassificationsOrder, nil]
     # @param filename [String, nil]
+    # @param status [Retab::Types::ClassificationsStatus, nil]
     # @param from_date [String, nil]
     # @param to_date [String, nil]
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
@@ -26,6 +27,7 @@ module Retab
       limit: 10,
       order: "desc",
       filename: nil,
+      status: nil,
       from_date: nil,
       to_date: nil,
       request_options: {}
@@ -36,6 +38,7 @@ module Retab
         "limit" => limit,
         "order" => order,
         "filename" => filename,
+        "status" => status,
         "from_date" => from_date,
         "to_date" => to_date
       }.compact
@@ -53,6 +56,7 @@ module Retab
           limit: limit,
           order: order,
           filename: filename,
+          status: status,
           from_date: from_date,
           to_date: to_date,
           request_options: request_options
@@ -66,6 +70,7 @@ module Retab
           limit: limit,
           order: order,
           filename: filename,
+          status: status,
           from_date: from_date,
           to_date: to_date
         },
@@ -81,6 +86,7 @@ module Retab
     # @param instructions [String, nil] Free-form instructions appended to the system prompt to steer the classification.
     # @param n_consensus [Integer, nil] Number of classification runs to use for consensus voting. 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 background [Boolean, nil] If true, run asynchronously: returns immediately with status 'queued' and an empty output. Poll GET /v1/<primitive>/{id} until status is terminal. Mutually exclusive with stream.
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
     # @return [Retab::Classification]
     def create(
@@ -91,6 +97,7 @@ module Retab
       instructions: nil,
       n_consensus: nil,
       bust_cache: nil,
+      background: nil,
       request_options: {}
     )
       document = Retab::MimeData.coerce(document) unless document.nil?
@@ -101,7 +108,8 @@ module Retab
         "first_n_pages" => first_n_pages,
         "instructions" => instructions,
         "n_consensus" => n_consensus,
-        "bust_cache" => bust_cache
+        "bust_cache" => bust_cache,
+        "background" => background
       }.compact
       response = @client.request(
         method: :post,
@@ -121,16 +129,22 @@ module Retab
 
     # Get Classification
     # @param classification_id [String]
+    # @param include_output [Boolean, nil] When false, returns a cheap status-only projection (no output), served from cache for in-flight background runs.
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
     # @return [Retab::Classification]
     def get(
       classification_id:,
+      include_output: true,
       request_options: {}
     )
+      params = {
+        "include_output" => include_output
+      }.compact
       response = @client.request(
         method: :get,
         path: "/v1/classifications/#{Retab::Util.encode_path(classification_id)}",
         auth: true,
+        params: params,
         request_options: request_options
       )
       result = Retab::Classification.new(response.body)
@@ -158,5 +172,28 @@ module Retab
       )
       nil
     end
+
+    # Cancel Classification
+    # @param classification_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Classification]
+    def create_classification_cancel(
+      classification_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :post,
+        path: "/v1/classifications/#{Retab::Util.encode_path(classification_id)}/cancel",
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::Classification.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/client.rb

@@ -5,16 +5,20 @@
 module Retab
   class Client < BaseClient
 
-    def schemas
-      @schemas ||= Retab::Schemas.new(self)
+    def classifications
+      @classifications ||= Retab::Classifications.new(self)
+    end
+
+    def edits
+      @edits ||= Retab::Edits.new(self)
     end
 
     def extractions
       @extractions ||= Retab::Extractions.new(self)
     end
 
-    def classifications
-      @classifications ||= Retab::Classifications.new(self)
+    def files
+      @files ||= Retab::Files.new(self)
     end
 
     def parses
@@ -25,24 +29,16 @@ module Retab
       @partitions ||= Retab::Partitions.new(self)
     end
 
-    def splits
-      @splits ||= Retab::Splits.new(self)
+    def schemas
+      @schemas ||= Retab::Schemas.new(self)
     end
 
-    def files
-      @files ||= Retab::Files.new(self)
+    def splits
+      @splits ||= Retab::Splits.new(self)
     end
 
     def workflows
       @workflows ||= Retab::Workflows.new(self)
     end
-
-    def edits
-      @edits ||= Retab::Edits.new(self)
-    end
-
-    def jobs
-      @jobs ||= Retab::Jobs.new(self)
-    end
   end
 end

data/lib/retab/edits/edit.rb

@@ -13,6 +13,8 @@ module Retab
       config: :config,
       template_id: :template_id,
       output: :output,
+      status: :status,
+      error: :error,
       filled_document_ref: :filled_document_ref,
       usage: :usage,
       created_at: :created_at
@@ -26,6 +28,8 @@ module Retab
       :config,
       :template_id,
       :output,
+      :status,
+      :error,
       :filled_document_ref,
       :usage,
       :created_at
@@ -41,6 +45,8 @@ module Retab
       @config = hash[:config] ? Retab::EditConfig.new(hash[:config]) : nil
       @template_id = hash[:template_id]
       @output = hash[:output] ? Retab::EditResult.new(hash[:output]) : nil
+      @status = hash[:status].nil? ? "pending" : hash[:status]
+      @error = hash[:error] ? Retab::PrimitiveError.new(hash[:error]) : nil
       @filled_document_ref = hash[:filled_document_ref] ? Retab::FileRef.new(hash[:filled_document_ref]) : nil
       @usage = hash[:usage] ? Retab::RetabUsage.new(hash[:usage]) : nil
       @created_at = hash[:created_at]

data/lib/retab/{workflow_artifacts → edits}/edit_config.rb

@@ -14,7 +14,7 @@ module Retab
     def initialize(json)
       super()
       hash = self.class.normalize(json)
-      @color = hash[:color]
+      @color = hash[:color].nil? ? "#000080" : hash[:color]
     end
   end
 end

data/lib/retab/edits/edit_request.rb

@@ -11,7 +11,8 @@ module Retab
       template_id: :template_id,
       model: :model,
       config: :config,
-      bust_cache: :bust_cache
+      bust_cache: :bust_cache,
+      background: :background
     }.freeze
 
     attr_accessor(
@@ -20,7 +21,8 @@ module Retab
       :template_id,
       :model,
       :config,
-      :bust_cache
+      :bust_cache,
+      :background
     )
 
     def initialize(json)
@@ -29,9 +31,10 @@ module Retab
       @instructions = hash[:instructions]
       @document = hash[:document] ? Retab::MimeData.new(hash[:document]) : nil
       @template_id = hash[:template_id]
-      @model = hash[:model]
+      @model = hash[:model].nil? ? "retab-small" : hash[:model]
       @config = hash[:config] ? Retab::EditConfig.new(hash[:config]) : nil
-      @bust_cache = hash[:bust_cache]
+      @bust_cache = hash[:bust_cache].nil? ? false : hash[:bust_cache]
+      @background = hash[:background].nil? ? false : hash[:background]
     end
   end
 end

data/lib/retab/edits.rb

@@ -21,6 +21,7 @@ module Retab
     # @param order [Retab::Types::EditsOrder, nil]
     # @param filename [String, nil]
     # @param template_id [String, nil]
+    # @param status [Retab::Types::EditsStatus, nil]
     # @param from_date [String, nil]
     # @param to_date [String, nil]
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
@@ -32,6 +33,7 @@ module Retab
       order: "desc",
       filename: nil,
       template_id: nil,
+      status: nil,
       from_date: nil,
       to_date: nil,
       request_options: {}
@@ -43,6 +45,7 @@ module Retab
         "order" => order,
         "filename" => filename,
         "template_id" => template_id,
+        "status" => status,
         "from_date" => from_date,
         "to_date" => to_date
       }.compact
@@ -61,6 +64,7 @@ module Retab
           order: order,
           filename: filename,
           template_id: template_id,
+          status: status,
           from_date: from_date,
           to_date: to_date,
           request_options: request_options
@@ -75,6 +79,7 @@ module Retab
           order: order,
           filename: filename,
           template_id: template_id,
+          status: status,
           from_date: from_date,
           to_date: to_date
         },
@@ -89,6 +94,7 @@ module Retab
     # @param model [String, nil] The model to use for edit inference.
     # @param config [Retab::EditConfig, nil] Edit configuration (rendering options).
     # @param bust_cache [Boolean, nil] If true, skip the LLM cache and force a fresh completion.
+    # @param background [Boolean, nil] If true, run asynchronously: returns immediately with status 'queued' and an empty output. Poll GET /v1/<primitive>/{id} until status is terminal. Mutually exclusive with stream.
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
     # @return [Retab::Edit]
     def create(
@@ -98,6 +104,7 @@ module Retab
       model: nil,
       config: nil,
       bust_cache: nil,
+      background: nil,
       request_options: {}
     )
       document = Retab::MimeData.coerce(document) unless document.nil?
@@ -107,7 +114,8 @@ module Retab
         "template_id" => template_id,
         "model" => model,
         "config" => config,
-        "bust_cache" => bust_cache
+        "bust_cache" => bust_cache,
+        "background" => background
       }.compact
       response = @client.request(
         method: :post,
@@ -127,16 +135,22 @@ module Retab
 
     # Get Edit
     # @param edit_id [String]
+    # @param include_output [Boolean, nil] When false, returns a cheap status-only projection (no output), served from cache for in-flight background runs.
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
     # @return [Retab::Edit]
     def get(
       edit_id:,
+      include_output: true,
       request_options: {}
     )
+      params = {
+        "include_output" => include_output
+      }.compact
       response = @client.request(
         method: :get,
         path: "/v1/edits/#{Retab::Util.encode_path(edit_id)}",
         auth: true,
+        params: params,
         request_options: request_options
       )
       result = Retab::Edit.new(response.body)
@@ -164,5 +178,28 @@ module Retab
       )
       nil
     end
+
+    # Cancel Edit
+    # @param edit_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::Edit]
+    def create_edit_cancel(
+      edit_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :post,
+        path: "/v1/edits/#{Retab::Util.encode_path(edit_id)}/cancel",
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::Edit.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/experiment_run_metrics/experiment_by_document_metrics_response.rb

@@ -31,8 +31,8 @@ module Retab
       super()
       hash = self.class.normalize(json)
       @run_id = hash[:run_id]
-      @kind = hash[:kind]
-      @view = hash[:view]
+      @kind = hash[:kind].nil? ? "by_document" : hash[:kind]
+      @view = hash[:view].nil? ? "by_document" : hash[:view]
       @document = hash[:document] ? Retab::ExperimentMetricDocumentRef.new(hash[:document]) : nil
       @score = hash[:score]
       @prior_score = hash[:prior_score]

data/lib/retab/experiment_run_metrics/experiment_by_target_metrics_response.rb

@@ -31,8 +31,8 @@ module Retab
       super()
       hash = self.class.normalize(json)
       @run_id = hash[:run_id]
-      @kind = hash[:kind]
-      @view = hash[:view]
+      @kind = hash[:kind].nil? ? "by_target" : hash[:kind]
+      @view = hash[:view].nil? ? "by_target" : hash[:view]
       @target = hash[:target]
       @score = hash[:score]
       @prior_score = hash[:prior_score]

data/lib/retab/experiment_run_metrics/experiment_metrics_missing_error.rb

@@ -22,8 +22,8 @@ module Retab
     def initialize(json)
       super()
       hash = self.class.normalize(json)
-      @kind = hash[:kind]
-      @error = hash[:error]
+      @kind = hash[:kind].nil? ? "no_metrics" : hash[:kind]
+      @error = hash[:error].nil? ? "no_metrics" : hash[:error]
       @experiment_id = hash[:experiment_id]
       @message = hash[:message]
     end

data/lib/retab/experiment_run_metrics/experiment_metrics_stale_error.rb

@@ -28,8 +28,8 @@ module Retab
     def initialize(json)
       super()
       hash = self.class.normalize(json)
-      @kind = hash[:kind]
-      @error = hash[:error]
+      @kind = hash[:kind].nil? ? "stale_metrics" : hash[:kind]
+      @error = hash[:error].nil? ? "stale_metrics" : hash[:error]
       @experiment_id = hash[:experiment_id]
       @stale_reasons = (hash[:stale_reasons] || [])
       @last_run = hash[:last_run] ? Retab::MetricsStaleErrorLastRun.new(hash[:last_run]) : nil

data/lib/retab/experiment_run_metrics/experiment_summary_metrics_response.rb

@@ -38,8 +38,8 @@ module Retab
       hash = self.class.normalize(json)
       @experiment_id = hash[:experiment_id]
       @run_id = hash[:run_id]
-      @kind = hash[:kind]
-      @view = hash[:view]
+      @kind = hash[:kind].nil? ? "summary" : hash[:kind]
+      @view = hash[:view].nil? ? "summary" : hash[:view]
       @definition_fingerprint = hash[:definition_fingerprint]
       @block_type = hash[:block_type]
       @score = hash[:score]

data/lib/retab/experiment_run_metrics/experiment_votes_metrics_response.rb

@@ -31,8 +31,8 @@ module Retab
       super()
       hash = self.class.normalize(json)
       @run_id = hash[:run_id]
-      @kind = hash[:kind]
-      @view = hash[:view]
+      @kind = hash[:kind].nil? ? "votes" : hash[:kind]
+      @view = hash[:view].nil? ? "votes" : hash[:view]
       @document = hash[:document] ? Retab::ExperimentVotesMetricDocument.new(hash[:document]) : nil
       @target = hash[:target]
       @score = hash[:score]

data/lib/retab/experiment_run_results/error_workflow_experiment_result.rb

@@ -20,8 +20,8 @@ module Retab
     def initialize(json)
       super()
       hash = self.class.normalize(json)
-      @status = hash[:status]
-      @message = hash[:message]
+      @status = hash[:status].nil? ? "error" : hash[:status]
+      @message = hash[:message].nil? ? "(no message)" : hash[:message]
       @details = hash[:details] ? Retab::ErrorDetails.new(hash[:details]) : nil
     end
   end

data/lib/retab/experiment_run_results/experiment_result.rb

@@ -15,8 +15,7 @@ module Retab
       block_type: :block_type,
       handle_inputs: :handle_inputs,
       artifact: :artifact,
-      attempt: :attempt,
-      is_placeholder: :is_placeholder
+      attempt: :attempt
     }.freeze
 
     attr_accessor(
@@ -29,8 +28,7 @@ module Retab
       :block_type,
       :handle_inputs,
       :artifact,
-      :attempt,
-      :is_placeholder
+      :attempt
     )
 
     def initialize(json)
@@ -63,7 +61,6 @@ module Retab
       @handle_inputs = hash[:handle_inputs] || {}
       @artifact = hash[:artifact] ? Retab::StepArtifactRef.new(hash[:artifact]) : nil
       @attempt = hash[:attempt]
-      @is_placeholder = hash[:is_placeholder]
     end
   end
 end

data/lib/retab/experiment_runs/experiment_run.rb

@@ -7,7 +7,8 @@ module Retab
 
     HASH_ATTRS = {
       id: :id,
-      workflow: :workflow,
+      workflow_id: :workflow_id,
+      workflow_version_id: :workflow_version_id,
       trigger: :trigger,
       experiment_id: :experiment_id,
       block_id: :block_id,
@@ -27,7 +28,8 @@ module Retab
 
     attr_accessor(
       :id,
-      :workflow,
+      :workflow_id,
+      :workflow_version_id,
       :trigger,
       :experiment_id,
       :block_id,
@@ -49,7 +51,8 @@ module Retab
       super()
       hash = self.class.normalize(json)
       @id = hash[:id]
-      @workflow = hash[:workflow] ? Retab::WorkflowSnapshotRef.new(hash[:workflow]) : nil
+      @workflow_id = hash[:workflow_id]
+      @workflow_version_id = hash[:workflow_version_id]
       @trigger = hash[:trigger] ? Retab::ExperimentRunTrigger.new(hash[:trigger]) : nil
       @experiment_id = hash[:experiment_id]
       @block_id = hash[:block_id]

data/lib/retab/experiment_runs.rb

@@ -15,10 +15,8 @@ module Retab
     # @param experiment_id [String, nil]
     # @param block_id [String, nil]
     # @param status [Retab::Types::WorkflowExperimentsStatus, nil]
-    # @param statuses [String, nil]
     # @param exclude_status [Retab::Types::WorkflowExperimentsExcludeStatus, nil]
     # @param trigger_type [String, nil]
-    # @param trigger_types [String, nil]
     # @param from_date [String, nil]
     # @param to_date [String, nil]
     # @param sort_by [String, nil]
@@ -33,10 +31,8 @@ module Retab
       experiment_id: nil,
       block_id: nil,
       status: nil,
-      statuses: nil,
       exclude_status: nil,
       trigger_type: nil,
-      trigger_types: nil,
       from_date: nil,
       to_date: nil,
       sort_by: "created_at",
@@ -51,10 +47,8 @@ module Retab
         "experiment_id" => experiment_id,
         "block_id" => block_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,
         "sort_by" => sort_by,
@@ -76,10 +70,8 @@ module Retab
           experiment_id: experiment_id,
           block_id: block_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,
           sort_by: sort_by,
@@ -98,10 +90,8 @@ module Retab
           experiment_id: experiment_id,
           block_id: block_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,
           sort_by: sort_by,

data/lib/retab/extractions/extraction.rb

@@ -14,6 +14,8 @@ module Retab
       image_resolution_dpi: :image_resolution_dpi,
       instructions: :instructions,
       output: :output,
+      status: :status,
+      error: :error,
       consensus: :consensus,
       metadata: :metadata,
       usage: :usage,
@@ -29,6 +31,8 @@ module Retab
       :image_resolution_dpi,
       :instructions,
       :output,
+      :status,
+      :error,
       :consensus,
       :metadata,
       :usage,
@@ -46,6 +50,8 @@ module Retab
       @image_resolution_dpi = hash[:image_resolution_dpi]
       @instructions = hash[:instructions]
       @output = hash[:output] || {}
+      @status = hash[:status].nil? ? "pending" : hash[:status]
+      @error = hash[:error] ? Retab::PrimitiveError.new(hash[:error]) : nil
       @consensus = hash[:consensus] ? Retab::ExtractionConsensus.new(hash[:consensus]) : nil
       @metadata = hash[:metadata] || {}
       @usage = hash[:usage] ? Retab::RetabUsage.new(hash[:usage]) : nil