runapi-core 0.2.16 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f199f45d065827bb1931ab5faff8dd945fd62b3cb0a5260b268fdfee41875a45
-  data.tar.gz: 6d2c40ffded8406818798c40bfddca448e1a7149981fd0b012dc5c0f4d17e02e
+  metadata.gz: 9a0bc423a77bb7770c6db1e3a6fa10ae1679ef58f7762231b02c28e86f85b4e3
+  data.tar.gz: fce5aa1e8e03dfc0c3c873a6f499bd5c51b173b87f91b75a74955413f59b19e2
 SHA512:
-  metadata.gz: 17e79439f00b8b10fbbbbcf00b3d074cfd9e3cf9d70c4b20b91743aee12cba2e122c9da364a66c0c21844d5e2153083102acacfb639871e1a24377899b3bda41
-  data.tar.gz: 707cadac8b31ca82c31fa191cb017e58192eb7c6b4da7bd15aba8fe40209f783537ee2452bc4846538c123ddc0843c31c7b24a86158a766f7740ec309e269d38
+  metadata.gz: fc56fca2936974941318607a19905d77542bf56f529fdf68577a7da9b18bc186cdbe4a3ea45f367b1d64d8f48622f384cfc8ef089503a1fdf87df399ed6dc84f
+  data.tar.gz: 548078f4a0b851f5a15f3f76fbadfd5164a122100c0842921bf9e6efa572049b3b715fbfdec7f82a8b7cdfe7773d0565a46ae648772cc75304c1f9a06c348838

data/README.md

@@ -12,6 +12,30 @@ gem install runapi-core
 
 Use the core gem for common client options, error classes, request helpers, and task polling behavior that Provider Clients share. Public SDK docs live at https://runapi.ai/docs#runapi-sdks and the model catalog lives at https://runapi.ai/models.
 
+## Live Pricing
+
+Every Provider Client exposes `pricing`. Schedule lookup and quotes use the live API response and do not retain a local price cache.
+
+```ruby
+schedules = client.pricing.list(service: "suno")
+quote = client.pricing.quote(
+  service: "suno",
+  action: "convert_audio",
+  params: {}
+)
+```
+
+Public schedule lookup and quotes that use only public parameters work without an API key. Pass a standard API key when a quote references an account-owned source Task.
+
+Use `PricingClient` when pricing is the only capability needed:
+
+```ruby
+require "runapi/core"
+
+pricing = RunApi::Core::PricingClient.new
+schedules = pricing.list(service: "suno")
+```
+
 ## Request Identifiers
 
 RunAPI accepts an optional `X-Client-Request-Id` header on public API calls. Use printable ASCII values up to 512 characters. Accepted values are echoed in the response and stored with the RunAPI task for support and reconciliation.

data/lib/runapi/core/auth.rb

@@ -19,15 +19,20 @@ module RunApi
       # @param explicit [String, nil] API key passed directly to a client constructor.
       # @return [String] the resolved API key
       def self.resolve_api_key(explicit = nil)
-        resolved = normalize(explicit) ||
-          normalize(RunApi.respond_to?(:api_key) ? RunApi.api_key : nil) ||
-          normalize(ENV[ENV_VAR_NAME])
+        resolved = resolve_optional_api_key(explicit)
 
         raise AuthenticationError, MISSING_KEY_MESSAGE unless resolved
 
         resolved
       end
 
+      # Resolve an API key when present without requiring one for public resources.
+      def self.resolve_optional_api_key(explicit = nil)
+        normalize(explicit) ||
+          normalize(RunApi.respond_to?(:api_key) ? RunApi.api_key : nil) ||
+          normalize(ENV[ENV_VAR_NAME])
+      end
+
       def self.normalize(value)
         return nil unless value.is_a?(String)
 

data/lib/runapi/core/client.rb

@@ -3,7 +3,7 @@
 module RunApi
   module Core
     # Base class for every RunAPI client. Resolves the API key, builds the shared
-    # HTTP client, and exposes the Universal Resources (file upload, account) that
+    # HTTP client, and exposes the Universal Resources (file upload, account, pricing) that
     # are available on any client regardless of which model gem was required.
     #
     # Provider clients inherit from this and build their model resources from the
@@ -13,6 +13,8 @@ module RunApi
       attr_reader :files
       # @return [Account] Account info and balance operations.
       attr_reader :account
+      # @return [Pricing] Live Price Schedule lookup and Price Quote operations.
+      attr_reader :pricing
 
       def initialize(api_key: nil, **options)
         @api_key = Core::Auth.resolve_api_key(api_key)
@@ -21,6 +23,7 @@ module RunApi
         @http = client_options.http_client || Core::HttpClient.new(client_options)
         @files = Files.new(@http)
         @account = Account.new(@http)
+        @pricing = Pricing.new(@http)
       end
 
       # Closes the SDK-created HTTP client. Injected clients remain caller-owned.

data/lib/runapi/core/http_client.rb

@@ -37,6 +37,10 @@ module RunApi
             raise NetworkError, e.message
           end
 
+          if response.is_a?(Net::HTTPNotModified) && options&.allow_not_modified
+            return Response.new(body: {"not_modified" => true}, headers: response_headers(response))
+          end
+
           if response.is_a?(Net::HTTPSuccess)
             body = parse_body(response.body)
             return nil if body.nil?
@@ -106,7 +110,7 @@ module RunApi
         klass = Net::HTTP.const_get(method.to_s.capitalize)
         req = klass.new(uri.request_uri)
 
-        req["Authorization"] = "Bearer #{@options.api_key}"
+        req["Authorization"] = "Bearer #{@options.api_key}" if @options.api_key
         req["Accept"] = "application/json"
         req["User-Agent"] = Constants::SDK_USER_AGENT
 

data/lib/runapi/core/pricing.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Core
+    class Pricing
+      include RunApi::Core::ResourceHelpers
+
+      SCHEDULES_ENDPOINT = "/api/v1/price_schedules"
+      QUOTES_ENDPOINT = "/api/v1/price_quotes"
+
+      class Schedule < RunApi::Core::BaseModel
+        required :service, String
+        required :action, String
+        optional :model, String
+        required :pricing_status, String
+        required :catalog_status, String
+        required :currency, String
+        required :billing_unit, String
+        required :billing_strategy, String
+        optional :unit_price_cents, Numeric
+        optional :input_price_per_1m_cents, Numeric
+        optional :output_price_per_1m_cents, Numeric
+        optional :cache_read_price_per_1m_cents, Numeric
+        optional :cache_write_5m_price_per_1m_cents, Numeric
+        optional :cache_write_1h_price_per_1m_cents, Numeric
+        required :billing_config, Hash
+      end
+
+      class ScheduleListResponse < RunApi::Core::BaseModel
+        required :as_of, String
+        required :price_schedules, [Schedule]
+      end
+
+      class ScheduleNotModifiedResponse < RunApi::Core::BaseModel
+        required :not_modified, TrueClass
+      end
+
+      class QuoteResponse < RunApi::Core::BaseModel
+        required :service, String
+        required :action, String
+        optional :model, String
+        required :pricing_status, String
+        required :currency, String
+        required :reservation_amount_cents, Numeric
+        required :estimate_basis, String
+        required :as_of, String
+      end
+
+      class QuoteEnvelope < RunApi::Core::BaseModel
+        required :price_quote, QuoteResponse
+      end
+
+      def initialize(http)
+        @http = http
+      end
+
+      def list(service: nil, action: nil, model: nil, options: nil)
+        query = URI.encode_www_form(compact_params(service:, action:, model:))
+        path = query.empty? ? SCHEDULES_ENDPOINT : "#{SCHEDULES_ENDPOINT}?#{query}"
+        request_options = (options || RequestOptions.new).dup
+        request_options.allow_not_modified = true
+        response = @http.request(:get, path, options: request_options)
+        payload = response.is_a?(Core::Response) ? response.body : response
+        response_class = payload["not_modified"] ? ScheduleNotModifiedResponse : ScheduleListResponse
+        result = RunApi::Core::BaseModel.coerce(payload, as: response_class)
+        result.with_response_headers(response.response_headers) if response.is_a?(Core::Response)
+        result
+      end
+
+      def quote(service:, action:, model: nil, params: {}, options: nil)
+        response = request(
+          :post,
+          QUOTES_ENDPOINT,
+          body: compact_params(service:, action:, model:, params:),
+          options:,
+          response_class: QuoteEnvelope
+        )
+        response.price_quote
+      end
+    end
+
+    # Standalone live Pricing client with optional API authentication.
+    class PricingClient < Pricing
+      def initialize(api_key: nil, **options)
+        client_options = Core::ClientOptions.new(
+          api_key: Core::Auth.resolve_optional_api_key(api_key),
+          **options
+        )
+        @owns_http_client = client_options.http_client.nil?
+        super(client_options.http_client || Core::HttpClient.new(client_options))
+      end
+
+      # Closes the SDK-created HTTP client. Injected clients remain caller-owned.
+      def close
+        @http.close if @owns_http_client
+      end
+    end
+  end
+end

data/lib/runapi/core/types.rb

@@ -22,7 +22,7 @@ module RunApi
     #   )
     #
     # @!attribute [rw] api_key
-    #   @return [String] API key for authentication. Required.
+    #   @return [String, nil] API key for authenticated resources and protected Price Quotes.
     # @!attribute [rw] base_url
     #   @return [String] Base URL for API requests. Defaults to RunApi.base_url.
     # @!attribute [rw] timeout
@@ -78,6 +78,7 @@ module RunApi
       :headers,
       :timeout,
       :max_retries,
+      :allow_not_modified,
       keyword_init: true
     )
 
@@ -100,6 +101,25 @@ module RunApi
       end
     end
 
+    class TaskReservation < BaseModel
+      required :amount_cents, Numeric
+    end
+
+    class TaskSettlement < BaseModel
+      required :charged_amount_cents, Numeric
+      required :amount_micro_cents, Numeric
+    end
+
+    class TaskRefund < BaseModel
+      required :refunded_at, String
+    end
+
+    class TaskBillingFacts < BaseModel
+      optional :reservation, TaskReservation
+      optional :settlement, TaskSettlement
+      optional :refund, TaskRefund
+    end
+
     # Typed response structure for async task operations.
     # Additional API-specific fields are preserved and exposed via dot notation.
     #
@@ -122,6 +142,7 @@ module RunApi
       optional :id, String
       optional :status, String
       optional :error, String
+      optional :billing, TaskBillingFacts
     end
   end
 end

data/lib/runapi/core/version.rb

@@ -2,7 +2,7 @@
 
 module RunApi
   module Core
-    VERSION = "0.2.16"
+    VERSION = "0.3.0"
   end
 
   VERSION = Core::VERSION

data/lib/runapi/core.rb

@@ -21,4 +21,5 @@ require_relative "core/polling"
 require_relative "core/resource_helpers"
 require_relative "core/files"
 require_relative "core/account"
+require_relative "core/pricing"
 require_relative "core/client"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-core
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.3.0
 platform: ruby
 authors:
 - RunAPI
@@ -55,6 +55,7 @@ files:
 - lib/runapi/core/http_client.rb
 - lib/runapi/core/multipart_body.rb
 - lib/runapi/core/polling.rb
+- lib/runapi/core/pricing.rb
 - lib/runapi/core/resource_helpers.rb
 - lib/runapi/core/response.rb
 - lib/runapi/core/types.rb