typesafe-sdk 0.2.0

data/lib/typesafe/sdk/system_one_response.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Typesafe
+  module SDK
+    class SystemOneResponse
+      attr_reader :model, :usage, :answers, :nouls, :choices, :scores, :http_response
+
+      class << self
+        def from_body(body, request_logger: RequestLogger.new(nil), http_response: nil)
+          root = FieldReader.object(body, path: "")
+          new(
+            model: FieldReader.string(hash: root, key: "model", path: ""),
+            usage: Usage.from_hash(FieldReader.object(FieldReader.fetch(hash: root, key: "usage", path: ""), path: "usage")),
+            answers: AnswerParser.new(request_logger).parse(FieldReader.fetch(hash: root, key: "answers", path: "")),
+            http_response: http_response
+          )
+        end
+      end
+
+      def initialize(model:, usage:, answers:, http_response: nil)
+        @model = model
+        @usage = usage
+        @answers = answers.freeze
+        @nouls = select_answers(NoulAnswer)
+        @choices = select_answers(ChoiceAnswer)
+        @scores = select_answers(ScoreAnswer)
+        @http_response = http_response
+        freeze
+      end
+
+      def [](name)
+        answers[name.to_s]
+      end
+
+      def request_id
+        return unless http_response
+
+        http_response.headers[REQUEST_ID_HEADER]
+      end
+
+      private
+
+      def select_answers(answer_class)
+        answers.select { |_name, answer| answer.is_a?(answer_class) }.freeze
+      end
+    end
+  end
+end

data/lib/typesafe/sdk/usage.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Typesafe
+  module SDK
+    class Usage
+      attr_reader :input_tokens, :output_tokens
+
+      class << self
+        def from_hash(hash, path: "usage")
+          new(
+            input_tokens: FieldReader.optional_integer(hash: hash, key: "input_tokens", path: path),
+            output_tokens: FieldReader.optional_integer(hash: hash, key: "output_tokens", path: path)
+          )
+        end
+      end
+
+      def initialize(input_tokens: nil, output_tokens: nil)
+        @input_tokens = input_tokens
+        @output_tokens = output_tokens
+        freeze
+      end
+
+      def to_h
+        { input_tokens: input_tokens, output_tokens: output_tokens }
+      end
+
+      def ==(other)
+        other.is_a?(self.class) && other.to_h == to_h
+      end
+      alias eql? ==
+
+      def hash
+        [self.class, to_h].hash
+      end
+    end
+  end
+end

data/lib/typesafe/sdk/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Typesafe
+  module SDK
+    VERSION = "0.2.0"
+  end
+end

data/lib/typesafe/sdk.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "openssl"
+require "time"
+require "uri"
+require "zlib"
+require "zeitwerk"
+
+module Typesafe
+end
+
+loader = Zeitwerk::Loader.for_gem_extension(Typesafe)
+loader.inflector.inflect(
+  "sdk" => "SDK",
+  "api_error" => "APIError",
+  "api_error_factory" => "APIErrorFactory",
+  "api_response_validation_error" => "APIResponseValidationError",
+  "api_timeout_error" => "APITimeoutError",
+  "http_request" => "HTTPRequest",
+  "http_response" => "HTTPResponse"
+)
+loader.setup
+
+module Typesafe
+  module SDK
+    DEFAULT_BASE_URL = "https://api.typesafe.ai"
+    DEFAULT_MODEL = "jev-latest"
+    DEFAULT_TIMEOUT = 10.0
+    SYSTEM_ONE_PATH = "/v1/systemone"
+    MODELS_PATH = "/v1/models"
+    SDK_NAME = "typesafe-sdk-ruby"
+    DEFAULT_USER_AGENT = "#{SDK_NAME}/#{VERSION}"
+    REQUEST_ID_HEADER = "x-typesafe-request-id"
+    RETRY_COUNT_HEADER = "X-TypeSafe-Retry-Count"
+
+    class Error < StandardError; end
+    class APIConnectionError < Error; end
+    class BadRequestError < APIError; end
+    class AuthenticationError < APIError; end
+    class PermissionDeniedError < APIError; end
+    class NotFoundError < APIError; end
+    class UnprocessableEntityError < APIError; end
+    class InternalServerError < APIError; end
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: typesafe-sdk
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Josh
+bindir: bin
+cert_chain: []
+date: 2026-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+description: Ask TypeSafe models typed Noul, Choice, and Score questions about text
+  or structured state and get calibrated, structured answers back. Built on the Ruby
+  standard library, with Zeitwerk for loading.
+email:
+- git@josh.mn
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/typesafe/sdk.rb
+- lib/typesafe/sdk/answer_parser.rb
+- lib/typesafe/sdk/api_error.rb
+- lib/typesafe/sdk/api_error_factory.rb
+- lib/typesafe/sdk/api_response_validation_error.rb
+- lib/typesafe/sdk/api_timeout_error.rb
+- lib/typesafe/sdk/body_decoder.rb
+- lib/typesafe/sdk/choice.rb
+- lib/typesafe/sdk/choice_answer.rb
+- lib/typesafe/sdk/client.rb
+- lib/typesafe/sdk/configuration.rb
+- lib/typesafe/sdk/connection_pool.rb
+- lib/typesafe/sdk/error_message.rb
+- lib/typesafe/sdk/field_reader.rb
+- lib/typesafe/sdk/http_request.rb
+- lib/typesafe/sdk/http_response.rb
+- lib/typesafe/sdk/invalid_response_field.rb
+- lib/typesafe/sdk/json_value.rb
+- lib/typesafe/sdk/list_models_response.rb
+- lib/typesafe/sdk/model_metadata.rb
+- lib/typesafe/sdk/models.rb
+- lib/typesafe/sdk/net_http_transport.rb
+- lib/typesafe/sdk/noul.rb
+- lib/typesafe/sdk/noul_answer.rb
+- lib/typesafe/sdk/question_set.rb
+- lib/typesafe/sdk/rate_limit_error.rb
+- lib/typesafe/sdk/request_builder.rb
+- lib/typesafe/sdk/request_logger.rb
+- lib/typesafe/sdk/requester.rb
+- lib/typesafe/sdk/retry_after.rb
+- lib/typesafe/sdk/retry_policy.rb
+- lib/typesafe/sdk/score.rb
+- lib/typesafe/sdk/score_answer.rb
+- lib/typesafe/sdk/stderr_logger.rb
+- lib/typesafe/sdk/system_one_response.rb
+- lib/typesafe/sdk/usage.rb
+- lib/typesafe/sdk/version.rb
+homepage: https://github.com/joshmn/typesafe-sdk
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/joshmn/typesafe-sdk
+  source_code_uri: https://github.com/joshmn/typesafe-sdk
+  changelog_uri: https://github.com/joshmn/typesafe-sdk/blob/main/CHANGELOG.md
+  documentation_uri: https://docs.typesafe.ai/
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Ruby client for the TypeSafe System One API
+test_files: []