runapi-core 0.2.15 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f91d61d251ad17e65d85bdc82c70abe8c6b9aa607b668667ccf63369434ab1f
-  data.tar.gz: '08055ced6c024b4e543a95907dd57c196fa05ade62772e090492ea8f019ceefa'
+  metadata.gz: 9a0bc423a77bb7770c6db1e3a6fa10ae1679ef58f7762231b02c28e86f85b4e3
+  data.tar.gz: fce5aa1e8e03dfc0c3c873a6f499bd5c51b173b87f91b75a74955413f59b19e2
 SHA512:
-  metadata.gz: 777f30e49b6cc9d82084ad707577008002e983ef129d643da5e26849bb816af7c33bb35cd9087897d475f389d1a33c35bc5be694e4990f08366f50bcc36163f2
-  data.tar.gz: 5c7355e6c06a8867addb06233e0eecb644bd740c90d5f552ad422e77c6cb4a9088b1d7b8c0eea1a9e6bc401b4eb96f2234ca805ab5a6bcf166867491e6bb699e
+  metadata.gz: fc56fca2936974941318607a19905d77542bf56f529fdf68577a7da9b18bc186cdbe4a3ea45f367b1d64d8f48622f384cfc8ef089503a1fdf87df399ed6dc84f
+  data.tar.gz: 548078f4a0b851f5a15f3f76fbadfd5164a122100c0842921bf9e6efa572049b3b715fbfdec7f82a8b7cdfe7773d0565a46ae648772cc75304c1f9a06c348838

data/README.md

@@ -12,10 +12,36 @@ 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.
 
+Task-creation calls also accept an optional opaque `Idempotency-Key` up to 512 characters. Generate one value per logical task and reuse it only with identical input after an unknown result. Reusing the value with different input returns `409 Conflict`; do not derive it from `X-Client-Request-Id`.
+
 High-level Ruby Provider Client resource methods accept per-request options and keep response headers on the returned model object. This example uses the Suno Provider Client; install `runapi-suno` to run it.
 
 ```ruby
@@ -23,7 +49,10 @@ require "runapi/suno"
 
 client = RunApi::Suno::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY"))
 options = RunApi::Core::RequestOptions.new(
-  headers: {"X-Client-Request-Id" => "order-123"}
+  headers: {
+    "X-Client-Request-Id" => "order-123",
+    "Idempotency-Key" => "opaque-logical-task-123"
+  }
 )
 
 response = client.text_to_music.create(

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,13 +13,22 @@ 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)
         client_options = Core::ClientOptions.new(api_key: @api_key, **options)
+        @owns_http_client = client_options.http_client.nil?
         @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.
+      def close
+        @http.close if @owns_http_client
       end
 
       protected

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?
@@ -60,6 +64,12 @@ module RunApi
         close_multipart_files(req)
       end
 
+      def close
+        @pool.shutdown do |http|
+          http.finish if http.started?
+        end
+      end
+
       # PUT bytes straight to a pre-authorized upload URL with the exact headers
       # issued for it. Skips the base URL, auth, and retries: the URL is single-use
       # and the body is not safe to replay.
@@ -100,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.15"
+    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.15
+  version: 0.3.0
 platform: ruby
 authors:
 - RunAPI
@@ -13,16 +13,22 @@ dependencies:
   name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
 description: The RunAPI Core Ruby SDK provides shared authentication, HTTP, retry,
   error, and polling primitives for RunAPI model gems. Install `runapi-core` only
   when you are building SDK infrastructure or shared Ruby tooling; application code
@@ -49,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