typesafe-sdk-ruby 0.6.0.1 → 0.7.0

data/lib/typesafe/sdk/types.rb

@@ -13,7 +13,22 @@ module Typesafe
       end
     end
 
-    # Token usage for a request.
+    # An answer, keeping every field the API returned, including fields not modeled here.
+    class Answer
+      attr_reader :type
+
+      def initialize(data)
+        @data = data
+        @type = data["type"]
+      end
+
+      # The answer as the API returned it, with string keys.
+      def to_h
+        @data.dup
+      end
+    end
+
+    # Token usage for a request. Each count is `nil` when the API did not report it.
     class Usage
       attr_reader :input_tokens, :output_tokens
 
@@ -24,21 +39,21 @@ module Typesafe
     end
 
     # A yes/no answer.
-    class NoulResponse
-      attr_reader :type, :noul
+    class NoulResponse < Answer
+      attr_reader :noul
 
       def initialize(data)
-        @type = data["type"]
+        super
         @noul = data["noul"]
       end
     end
 
     # A selected label with its probabilities.
-    class ChoiceResponse
-      attr_reader :type, :choice, :confidence, :probabilities
+    class ChoiceResponse < Answer
+      attr_reader :choice, :confidence, :probabilities
 
       def initialize(data)
-        @type = data["type"]
+        super
         @choice = data["choice"]
         @confidence = data["confidence"]
         @probabilities = data["probabilities"]
@@ -46,11 +61,11 @@ module Typesafe
     end
 
     # An expected score with its rubric and probabilities.
-    class ScoreResponse
-      attr_reader :type, :score, :confidence, :legend, :probabilities
+    class ScoreResponse < Answer
+      attr_reader :score, :confidence, :legend, :probabilities
 
       def initialize(data)
-        @type = data["type"]
+        super
         @score = data["score"]
         @confidence = data["confidence"]
         @legend = data["legend"]
@@ -58,12 +73,44 @@ module Typesafe
       end
     end
 
+    # A box's edges as fractions of the image's height (`top`, `bottom`) and width
+    # (`left`, `right`), each from zero to one.
+    class BoxCoordinates
+      attr_reader :top, :bottom, :left, :right
+
+      def initialize(data)
+        @top = data["top"]
+        @bottom = data["bottom"]
+        @left = data["left"]
+        @right = data["right"]
+      end
+
+      def to_h
+        { "top" => top, "bottom" => bottom, "left" => left, "right" => right }
+      end
+    end
+
+    # The answer to a box question.
+    class BoxResponse < Answer
+      # Where the instructions' subject is in the image, or `nil` when absent.
+      attr_reader :box
+      # Confidence in the box, from zero to one, or `nil` when the API didn't report it.
+      attr_reader :confidence
+
+      def initialize(data)
+        super
+        @box = data["box"].is_a?(Hash) ? BoxCoordinates.new(data["box"]) : nil
+        @confidence = data["confidence"]
+      end
+    end
+
     # Builds the answer object matching the question type.
     module ResponseFactory
       CLASSES = {
         "noul" => NoulResponse,
         "choice" => ChoiceResponse,
-        "score" => ScoreResponse
+        "score" => ScoreResponse,
+        "box" => BoxResponse
       }.freeze
 
       module_function

data/lib/typesafe/sdk/version.rb

@@ -3,7 +3,7 @@
 module Typesafe
   module SDK
     # Ruby-only fixes use a fourth numeric component; the first three track upstream.
-    VERSION = "0.6.0.1"
-    UPSTREAM_VERSION = "0.6.0"
+    VERSION = "0.7.0"
+    UPSTREAM_VERSION = "0.7.0"
   end
 end

data/lib/typesafe-sdk-ruby.rb

@@ -5,6 +5,8 @@ require_relative "typesafe/sdk/env"
 require_relative "typesafe/sdk/logging"
 require_relative "typesafe/sdk/retry"
 require_relative "typesafe/sdk/errors"
+require_relative "typesafe/sdk/assets"
+require_relative "typesafe/sdk/compression"
 require_relative "typesafe/sdk/questions"
 require_relative "typesafe/sdk/http"
 require_relative "typesafe/sdk/types"
@@ -36,5 +38,33 @@ module Typesafe
     def choice(instructions, criteria)
       Questions.choice(instructions, criteria)
     end
+
+    # Create a box question. @see Questions.box
+    def box(instructions = nil)
+      Questions.box(instructions)
+    end
+
+    # Create a PNG or JPEG image asset from file bytes, a Pathname, or an IO.
+    # Use {Image.from_base64} for base64 text. @see Image#initialize
+    def image(data)
+      Image.new(data)
+    end
+
+    # Join text and images into text that carries its images, like JavaScript's `withAssets`
+    # tagged template. Other values are converted with `to_s`, as string interpolation does.
+    #
+    # @example
+    #   Typesafe::SDK.with_assets("Does ", photo, " show the product in ", listing, "?")
+    # @return [TextWithAssets]
+    def with_assets(*parts)
+      TextWithAssets.build(*parts)
+    end
+
+    # Join `values` with `separator` (default `","`, as in JavaScript's `withAssets.join`) into
+    # text that carries the images among them.
+    # @return [TextWithAssets]
+    def join_assets(values, separator = ",")
+      TextWithAssets.join(values, separator)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: typesafe-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 0.6.0.1
+  version: 0.7.0
 platform: ruby
 authors:
 - TypeSafe Ruby SDK Contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-21 00:00:00.000000000 Z
+date: 2026-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -32,8 +32,9 @@ dependencies:
         version: '3'
 description: |-
   Unofficial Ruby SDK for the TypeSafe AI API (Jev model). Ask named questions about
-  text or structured state and get typed answers: yes/no (noul), choice, and score
-  questions, with retries, timeouts, structured logging, and typed errors.
+  text, structured state, or images and get typed answers: yes/no (noul), choice, score,
+  and box questions, with retries, timeouts, request compression, structured logging, and
+  typed errors.
 email:
 executables: []
 extensions: []
@@ -46,7 +47,9 @@ files:
 - docs/RELEASING.md
 - docs/UPSTREAM_ISSUES.md
 - lib/typesafe-sdk-ruby.rb
+- lib/typesafe/sdk/assets.rb
 - lib/typesafe/sdk/client.rb
+- lib/typesafe/sdk/compression.rb
 - lib/typesafe/sdk/env.rb
 - lib/typesafe/sdk/errors.rb
 - lib/typesafe/sdk/http.rb