retab 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 892cc7d33cd77ee2992206da231970259f4f0cf3668c762671b114b78116d1ee
-  data.tar.gz: 17e6a78b1858ab551518b0b379b92b4d54980e25565ce0d567504b17c2f0294c
+  metadata.gz: 67452b4ad04cd58f0437012ee63e052194150a619474218838fe392949156eba
+  data.tar.gz: 51cca52e0f5df37488678232d8a41de500613b1ce709b54c98bf1dc4725a72af
 SHA512:
-  metadata.gz: 653dc2782eee8ec927931b08da074dff4bceb322e7605a74ba14f2629cc6c9a8dca82c66de8748bc13e72a5cfc38c256b2b147844298b0c82000ccfa84c8d33e
-  data.tar.gz: 04d599b812516886ac4b0a2f3336af22d96418a40340da1412b45ed43e2b98733d2cbdbee41e35d70af30b7b4ea38df5c7651ef40ece0fba3a1a065b12d74237
+  metadata.gz: 329580bdb99646157f8da23afc794d5252fcf925fd21eb988815ef30e61150b900f3a2f63e73eabbc96e5dda2471bd6a2561ed30345bb79ca2d4d7f91ea7580b
+  data.tar.gz: 9b8a20793769cf85431a7172bb8be1629f72e39c80f8fdaa6fafcccd32666b1bb6ecf159adec60dbcc88b89ffb869b905fe9d972260b21a30c8b5bc976a52bd2

data/lib/retab/base_client.rb

@@ -86,8 +86,15 @@ module Retab
       extra_headers = request_options[:headers] || request_options["headers"] || {}
       extra_headers.each { |k, v| req[k.to_s] = v.to_s }
       if body && %i[post put patch].include?(method.to_sym)
-        req["Content-Type"] = "application/json"
-        req.body = body.is_a?(String) ? body : JSON.generate(body)
+        if body.is_a?(Retab::Multipart)
+          # multipart/form-data (e.g. table create/replace). Let net/http build
+          # the multipart body and set the `Content-Type:
+          # multipart/form-data; boundary=...` header itself — never JSON.
+          req.set_form(body.to_form_parts, "multipart/form-data")
+        else
+          req["Content-Type"] = "application/json"
+          req.body = body.is_a?(String) ? body : JSON.generate(body)
+        end
       end
 
       req

data/lib/retab/client.rb

@@ -33,10 +33,18 @@ module Retab
       @schemas ||= Retab::Schemas.new(self)
     end
 
+    def secrets
+      @secrets ||= Retab::Secrets.new(self)
+    end
+
     def splits
       @splits ||= Retab::Splits.new(self)
     end
 
+    def tables
+      @tables ||= Retab::Tables.new(self)
+    end
+
     def workflows
       @workflows ||= Retab::Workflows.new(self)
     end

data/lib/retab/experiment_runs/experiment_run.rb

@@ -17,6 +17,9 @@ module Retab
       lifecycle: :lifecycle,
       timing: :timing,
       parent_run_id: :parent_run_id,
+      block_version_id: :block_version_id,
+      metrics_validity_fingerprint: :metrics_validity_fingerprint,
+      metrics_validity_fingerprint_version: :metrics_validity_fingerprint_version,
       definition_fingerprint: :definition_fingerprint,
       documents_fingerprint: :documents_fingerprint,
       score: :score,
@@ -38,6 +41,9 @@ module Retab
       :lifecycle,
       :timing,
       :parent_run_id,
+      :block_version_id,
+      :metrics_validity_fingerprint,
+      :metrics_validity_fingerprint_version,
       :definition_fingerprint,
       :documents_fingerprint,
       :score,
@@ -78,6 +84,9 @@ module Retab
       ) : nil
       @timing = hash[:timing] ? Retab::ExperimentRunTiming.new(hash[:timing]) : nil
       @parent_run_id = hash[:parent_run_id]
+      @block_version_id = hash[:block_version_id]
+      @metrics_validity_fingerprint = hash[:metrics_validity_fingerprint]
+      @metrics_validity_fingerprint_version = hash[:metrics_validity_fingerprint_version]
       @definition_fingerprint = hash[:definition_fingerprint]
       @documents_fingerprint = hash[:documents_fingerprint]
       @score = hash[:score]

data/lib/retab/files/create_file_blueprint_request.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class CreateFileBlueprintRequest < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      file_id: :file_id,
+      mode: :mode,
+      intent: :intent,
+      background: :background
+    }.freeze
+
+    attr_accessor(
+      :file_id,
+      :mode,
+      :intent,
+      :background
+    )
+
+    def initialize(json)
+      super()
+      hash = self.class.normalize(json)
+      @file_id = hash[:file_id]
+      @mode = hash[:mode]
+      @intent = hash[:intent]
+      @background = hash[:background].nil? ? false : hash[:background]
+    end
+  end
+end

data/lib/retab/files/file_blueprint.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class FileBlueprint < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      object: :object,
+      id: :id,
+      file: :file,
+      mode: :mode,
+      intent: :intent,
+      output: :output,
+      status: :status,
+      error: :error,
+      created_at: :created_at,
+      started_at: :started_at,
+      completed_at: :completed_at
+    }.freeze
+
+    attr_accessor(
+      :object,
+      :id,
+      :file,
+      :mode,
+      :intent,
+      :output,
+      :status,
+      :error,
+      :created_at,
+      :started_at,
+      :completed_at
+    )
+
+    def initialize(json)
+      super()
+      hash = self.class.normalize(json)
+      @object = hash[:object].nil? ? "file.blueprint" : hash[:object]
+      @id = hash[:id]
+      @file = hash[:file] ? Retab::FileRef.new(hash[:file]) : nil
+      @mode = hash[:mode]
+      @intent = hash[:intent]
+      @output = hash[:output] || {}
+      @status = hash[:status].nil? ? "pending" : hash[:status]
+      @error = hash[:error] ? Retab::PrimitiveError.new(hash[:error]) : nil
+      @created_at = hash[:created_at]
+      @started_at = hash[:started_at]
+      @completed_at = hash[:completed_at]
+    end
+  end
+end

data/lib/retab/files.rb

@@ -88,6 +88,94 @@ module Retab
       )
     end
 
+    # Create File Blueprint
+    # @param file_id [String] File id to analyze.
+    # @param mode [Retab::Types::CreateFileBlueprintRequestMode, nil] Optional analysis depth override. Omit to let Retab choose.
+    # @param intent [String, nil] Optional user intent used to guide the blueprint analysis.
+    # @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::FileBlueprint]
+    def create_blueprint(
+      file_id:,
+      mode: nil,
+      intent: nil,
+      background: nil,
+      request_options: {}
+    )
+      body = {
+        "file_id" => file_id,
+        "mode" => mode,
+        "intent" => intent,
+        "background" => background
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: "/v1/files/blueprints",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = Retab::FileBlueprint.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 File Blueprint
+    # @param blueprint_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::FileBlueprint]
+    def get_blueprint(
+      blueprint_id:,
+      include_output: true,
+      request_options: {}
+    )
+      params = {
+        "include_output" => include_output
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: "/v1/files/blueprints/#{Retab::Util.encode_path(blueprint_id)}",
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      result = Retab::FileBlueprint.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
+
+    # Cancel File Blueprint
+    # @param blueprint_id [String]
+    # @param request_options [Hash] (see Retab::Types::RequestOptions)
+    # @return [Retab::FileBlueprint]
+    def create_blueprint_cancel(
+      blueprint_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :post,
+        path: "/v1/files/blueprints/#{Retab::Util.encode_path(blueprint_id)}/cancel",
+        auth: true,
+        request_options: request_options
+      )
+      result = Retab::FileBlueprint.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
+
     # Upload File
     # @param filename [String] Filename to store
     # @param content_type [String, nil] MIME type the client will upload

data/lib/retab/multipart.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+# @oagen-ignore-file
+#
+# Hand-maintained multipart/form-data marker. Spec-derived resource methods
+# whose operation declares a `multipart/form-data` request body (e.g.
+# `tables.create` / `tables.replace`) build a `Retab::Multipart`
+# instead of a plain Hash. `BaseClient#build_request` detects it and calls
+# `Net::HTTP::Post#set_form(..., 'multipart/form-data')` so net/http emits the
+# boundary itself — never a JSON body. The gateway requires a real multipart
+# file upload for the binary part and rejects JSON ("Expected a
+# multipart/form-data file upload").
+
+require "stringio"
+
+module Retab
+  # A multipart/form-data request body. `fields` maps wire field name =>
+  # value, where each value is either a plain scalar (sent as a text part via
+  # `#to_s`) or a `FilePart` (sent as a binary file part).
+  class Multipart
+    attr_reader :fields
+
+    def initialize(fields = {})
+      @fields = fields
+    end
+
+    # Build the `[name, value]` pairs net/http's `#set_form` expects. Binary
+    # parts become `[name, io, { filename:, content_type: }]`; scalar parts
+    # become `[name, string]`.
+    def to_form_parts
+      @fields.map do |name, value|
+        if value.is_a?(FilePart)
+          [name.to_s, value.io, value.form_opts]
+        else
+          [name.to_s, value.to_s]
+        end
+      end
+    end
+
+    # A single binary file part. `content` may be a String of bytes, a
+    # `Pathname`, or any IO-like object (File/StringIO). Normalised to an IO
+    # so net/http streams it as a real file upload.
+    class FilePart
+      DEFAULT_CONTENT_TYPE = "application/octet-stream"
+
+      attr_reader :filename, :content_type
+
+      def initialize(content, filename: "file", content_type: DEFAULT_CONTENT_TYPE)
+        @content = content
+        @filename = filename
+        @content_type = content_type
+      end
+
+      # An IO net/http can read the bytes from. Strings are wrapped in a
+      # StringIO; Pathnames are opened in binary mode; existing IOs pass
+      # through unchanged.
+      def io
+        return @content if @content.respond_to?(:read)
+        if defined?(Pathname) && @content.is_a?(Pathname)
+          return @content.open("rb")
+        end
+
+        StringIO.new(@content.to_s)
+      end
+
+      def form_opts
+        {filename: @filename, content_type: @content_type}
+      end
+    end
+  end
+end

data/lib/retab/schemas/generate_schema_request.rb

@@ -10,7 +10,7 @@ module Retab
       model: :model,
       instructions: :instructions,
       image_resolution_dpi: :image_resolution_dpi,
-      stream: :stream
+      background: :background
     }.freeze
 
     attr_accessor(
@@ -18,7 +18,7 @@ module Retab
       :model,
       :instructions,
       :image_resolution_dpi,
-      :stream
+      :background
     )
 
     def initialize(json)
@@ -28,7 +28,7 @@ module Retab
       @model = hash[:model].nil? ? "retab-small" : hash[:model]
       @instructions = hash[:instructions]
       @image_resolution_dpi = hash[:image_resolution_dpi]
-      @stream = hash[:stream].nil? ? false : hash[:stream]
+      @background = hash[:background].nil? ? false : hash[:background]
     end
   end
 end

data/lib/retab/schemas/{partial_schema.rb → schema_generation.rb}

@@ -3,20 +3,26 @@
 # This file is auto-generated by oagen. Do not edit.
 
 module Retab
-  class PartialSchema < Retab::Types::BaseModel
+  class SchemaGeneration < Retab::Types::BaseModel
 
     HASH_ATTRS = {
       object: :object,
       created_at: :created_at,
       json_schema: :json_schema,
-      strict: :strict
+      strict: :strict,
+      id: :id,
+      status: :status,
+      error: :error
     }.freeze
 
     attr_accessor(
       :object,
       :created_at,
       :json_schema,
-      :strict
+      :strict,
+      :id,
+      :status,
+      :error
     )
 
     def initialize(json)
@@ -26,6 +32,9 @@ module Retab
       @created_at = hash[:created_at]
       @json_schema = hash[:json_schema] || {}
       @strict = hash[:strict].nil? ? true : hash[:strict]
+      @id = hash[:id]
+      @status = hash[:status].nil? ? "pending" : hash[:status]
+      @error = hash[:error] ? Retab::PrimitiveError.new(hash[:error]) : nil
     end
   end
 end

data/lib/retab/schemas.rb

@@ -15,15 +15,15 @@ module Retab
     # @param model [String, nil]
     # @param instructions [String, nil]
     # @param image_resolution_dpi [Integer, nil] Resolution of the image sent to the LLM
-    # @param stream [Boolean, nil]
+    # @param background [Boolean, nil] If true, run asynchronously: returns immediately with status 'queued'. Poll GET /v1/schemas/generate/{schema_generation_id} until status is terminal.
     # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::PartialSchema]
+    # @return [Retab::SchemaGeneration]
     def generate(
       documents:,
       model: nil,
       instructions: nil,
       image_resolution_dpi: nil,
-      stream: nil,
+      background: nil,
       request_options: {}
     )
       documents = documents.map { |d| Retab::MimeData.coerce(d) } unless documents.nil?
@@ -32,7 +32,7 @@ module Retab
         "model" => model,
         "instructions" => instructions,
         "image_resolution_dpi" => image_resolution_dpi,
-        "stream" => stream
+        "background" => background
       }.compact
       response = @client.request(
         method: :post,
@@ -41,7 +41,7 @@ module Retab
         body: body,
         request_options: request_options
       )
-      result = Retab::PartialSchema.new(response.body)
+      result = Retab::SchemaGeneration.new(response.body)
       result.last_response = Retab::Types::ApiResponse.new(
         http_status: response.code.to_i,
         http_headers: response.each_header.to_h,

data/lib/retab/secrets/create_secret_request.rb

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

data/lib/retab/secrets/secret.rb

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

data/lib/retab/secrets/secret_list_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module Retab
+  class SecretListResponse < Retab::Types::BaseModel
+
+    HASH_ATTRS = {
+      secrets: :secrets
+    }.freeze
+
+    attr_accessor :secrets
+
+    def initialize(json)
+      super()
+      hash = self.class.normalize(json)
+      @secrets = (hash[:secrets] || []).map { |item| item ? Retab::Secret.new(item) : nil }
+    end
+  end
+end

data/lib/retab/secrets/secret_response.rb

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

data/lib/retab/secrets/secret_value.rb

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

data/lib/retab/secrets/secret_value_response.rb

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

data/lib/retab/secrets/set_secret_request.rb

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