octaspace 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9dd2b5c9ae96cbc0bef9e36fd492b2a1dbdcf53af596a82193986039ff8a4da9
-  data.tar.gz: b0f0a7a1a3301be4f3d1dbe33f60652fc5c9e4b36e709779076d374fb0e16ff4
+  metadata.gz: 1826290acf7155b153139f322c170ad14e369808d22f1333fa08571dd8ee3d60
+  data.tar.gz: cb3beab9b8e3a29f01cde3049f19cbd20e37103b32b62e52bde63482ef4a0a3b
 SHA512:
-  metadata.gz: 59cb1140ec7e34939b2535857d4d7afd395b8b25d45ac69df2c14c524bd1e14503f969704299fe6aa3d51021fa2491a8f00d0cf4dee3a3d848308a9aa9fb577d
-  data.tar.gz: 6b4353b1524bae1e594ef4109a93a371e539d48b157dcdd4e165a1283c60e4a86e719818f62276d3cac2628e4bf9cd419b651f5a4633302d391e3d5fc41f476d
+  metadata.gz: 2f158f5d579814e26c153776b24dfb29b273a2ff583dc64c2d806dd91616e8a7141465620c38f010a4efccacff50f07452d072af96e3135590d1a1c6a6654549
+  data.tar.gz: 588659f9b8449eaed8565bd61d01190be13c5223009e5cfe5aafa6ea949d0834a5ae264c5d2b191f0cad1d9e7b051e653c1721f54ff2ec411d124a1742c9a547

data/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-04-16
+
+### Added
+
+- Support for `client.services.session(uuid).logs(recent: true)` for finished-session log retrieval.
+- `OctaSpace::ProvisionRejectedError` for MR create requests that are transport-successful but rejected by the API payload contract.
+- `OctaSpace::PayloadHelpers` with targeted helpers for stringified app port lists and marketplace bandwidth normalization.
+- Diagnostics preset and manual runner support for recent session logs.
+- Live-shaped fixtures for recent sessions and render marketplace responses.
+
+### Changed
+
+- `services.mr.list`, `services.render.list`, and `services.vpn.list` are now documented and tested as marketplace catalog endpoints rather than session collections.
+- `services.mr.create` now forwards optional `organization_id` and `project_id`.
+- Playground Services now presents marketplace-oriented summaries with normalized bandwidth display.
+- Playground and README copy now reflect live API quirks for app ports, recent sessions, and finished-session logs.
+- Publishing guidance now uses an explicit manual release flow, and the local `rake release` helper is disabled to avoid accidental RubyGems publication.
+
+### Fixed
+
+- Corrected the Ruby public API gap for recent finished-session logs.
+- Corrected MR create handling for `HTTP 200` batch-style rejection responses.
+- Corrected fixtures and tests that modeled `/services/mr` and `/services/vpn` as session lists.
+- Corrected logs fixtures and tests to match the live `{system, container}` payload shape.
+- Corrected the playground Apps page so port counts work when the live API returns stringified JSON arrays.
+- Corrected test coverage for `sessions?recent=true` by using live-shaped string telemetry fields.
+
 ## [0.1.0] - 2026-04-12
 
 ### Added
@@ -19,4 +46,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Rails integration with automatic client sharing and graceful shutdown.
 - Interactive Playground app for manual testing and diagnostics.
 
-[0.1.0]: https://github.com/octaspace/ruby-sdk/compare/v0.1.0...HEAD
+[0.2.0]: https://github.com/octaspace/ruby-sdk/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/octaspace/ruby-sdk/releases/tag/v0.1.0

data/README.md

@@ -62,17 +62,18 @@ client.sessions.list                                   # GET /sessions
 session = client.services.session("uuid-here")
 session.info                    # GET /services/:uuid/info
 session.logs                    # GET /services/:uuid/logs
+session.logs(recent: true)      # GET /services/:uuid/logs?recent=true for finished sessions
 session.stop(score: 5)          # POST /services/:uuid/stop
 
 # Services
-client.services.mr.list                                # GET /services/mr
+client.services.mr.list                                # GET /services/mr (marketplace machine catalog)
 client.services.mr.create(
   node_id: 1,
   disk_size: 10,
   image: "ubuntu:24.04",
   app: "249b4cb3-3db1-4c06-98a4-772ba88cd81c"
 )                                                     # POST /services/mr
-client.services.vpn.list                               # GET /services/vpn
+client.services.vpn.list                               # GET /services/vpn (VPN relay catalog)
 client.services.vpn.create(node_id: 1, subkind: "wg") # POST /services/vpn
 client.services.render.list                            # GET /services/render
 client.services.render.create(node_id: 1, disk_size: 100) # POST /services/render
@@ -80,6 +81,9 @@ client.services.render.create(node_id: 1, disk_size: 100) # POST /services/rende
 # Apps
 client.apps.list                                       # GET /apps
 
+# Note: live API may serialize app port lists as JSON strings
+# (for example "[]"). The raw response is preserved by the SDK.
+
 # Network
 client.network.info                                    # GET /network
 
@@ -269,9 +273,9 @@ Pages:
 |---|---|
 | `/playground/account` | Profile + balance |
 | `/playground/nodes` | Node list with state badges |
-| `/playground/sessions` | Active sessions |
-| `/playground/services` | Machine Rentals + VPN sessions |
-| `/playground/diagnostics` | Transport mode, pool stats, URL rotator state (auto-refresh every 5s) |
+| `/playground/sessions` | Current + recent sessions, including live-format quirks |
+| `/playground/services` | Marketplace catalogs for MR, Render, and VPN |
+| `/playground/diagnostics` | Direct SDK method runner for contracts, payloads, transport mode, and pool stats |
 
 ## Development
 
@@ -288,7 +292,7 @@ bundle exec rake test   # tests only
 You can verify the gem in a clean Ruby environment without Rails:
 
 1. Build the gem: `gem build octaspace.gemspec`
-2. Install it locally: `gem install ./octaspace-0.1.0.gem`
+2. Install it locally: `gem install ./octaspace-0.2.0.gem`
 3. Test in IRB:
 
 ```ruby
@@ -310,7 +314,7 @@ bundle exec appraisal rails-8-0 rake test
 
 ### Dummy Application (Playground)
 
-The repository includes a Rails "Dummy" application for manual testing and UI prototyping. It is located in `test/dummy`.`.
+The repository includes a Rails "Dummy" application for manual testing and UI prototyping. It is located in `test/dummy`.
 
 To run the dummy app:
 

data/lib/octaspace/errors.rb

@@ -24,6 +24,32 @@ module OctaSpace
   # API-level errors (HTTP response received, but indicates failure)
   class ApiError < Error; end
 
+  # Domain-level rejection where transport succeeded but the provision request
+  # was rejected by the API payload contract.
+  class ProvisionRejectedError < Error
+    attr_reader :rejections
+
+    def initialize(message = nil, response: nil, rejections: [])
+      @rejections = Array(rejections)
+      super(message || build_message(@rejections), response: response)
+    end
+
+    private
+
+    def build_message(rejections)
+      first_reason =
+        rejections.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          item["reason"] || item[:reason]
+        end.first
+
+      return "Provision request rejected" if first_reason.to_s.empty?
+
+      "Provision request rejected: #{first_reason}"
+    end
+  end
+
   # 401 Unauthorized
   class AuthenticationError < ApiError; end
 

data/lib/octaspace/payload_helpers.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "json"
+
+module OctaSpace
+  module PayloadHelpers
+    module_function
+
+    def parse_port_list(value)
+      case value
+      when nil
+        []
+      when Array
+        value
+      when String
+        parse_stringified_port_list(value)
+      else
+        Array(value)
+      end
+    end
+
+    def normalize_marketplace_bandwidth(value)
+      numeric =
+        case value
+        when nil
+          return nil
+        when Numeric
+          value.to_f
+        when String
+          Float(value)
+        else
+          return value
+        end
+
+      return numeric unless numeric > 100_000
+
+      numeric / 125_000.0
+    rescue ArgumentError, TypeError
+      value
+    end
+
+    def parse_stringified_port_list(value)
+      stripped = value.strip
+      return [] if stripped.empty?
+
+      parsed = JSON.parse(stripped)
+      parsed.is_a?(Array) ? parsed : []
+    rescue JSON::ParserError
+      []
+    end
+    private_class_method :parse_stringified_port_list
+  end
+end

data/lib/octaspace/resources/services/machine_rental.rb

@@ -14,7 +14,7 @@ module OctaSpace
       #     app: "249b4cb3-3db1-4c06-98a4-772ba88cd81c"
       #   )
       class MachineRental < Base
-        # List available / active machine rentals
+        # List available marketplace machines for rent
         # GET /services/mr
         # @param params [Hash] optional filter params
         # @return [OctaSpace::Response]
@@ -40,7 +40,37 @@ module OctaSpace
             entrypoint: attrs[:entrypoint].to_s
           }
 
-          post("/services/mr", body: [item])
+          item[:organization_id] = attrs[:organization_id] if attrs.key?(:organization_id)
+          item[:project_id] = attrs[:project_id] if attrs.key?(:project_id)
+
+          response = post("/services/mr", body: [item])
+          raise_if_rejected!(response)
+          response
+        end
+
+        private
+
+        def raise_if_rejected!(response)
+          rejections = extract_rejections(response.data)
+          return if rejections.empty?
+
+          raise OctaSpace::ProvisionRejectedError.new(response: response, rejections: rejections)
+        end
+
+        def extract_rejections(data)
+          return [] unless data.is_a?(Array)
+
+          data.filter_map do |item|
+            next unless item.is_a?(Hash)
+
+            reason = item["reason"] || item[:reason]
+            status = item["status"] || item[:status]
+            uuid = item["uuid"] || item[:uuid]
+            next if uuid
+            next unless reason || status.to_i.positive?
+
+            item
+          end
         end
       end
     end

data/lib/octaspace/resources/services/session_proxy.rb

@@ -31,9 +31,14 @@ module OctaSpace
 
         # Fetch session logs
         # GET /services/:uuid/logs
+        # @param recent [Boolean, nil] use the recent logs branch for finished sessions
         # @return [OctaSpace::Response]
-        def logs
-          @transport.get("/services/#{@uuid}/logs")
+        def logs(recent: nil)
+          params = {}
+          params[:recent] = true if recent
+          return @transport.get("/services/#{@uuid}/logs") if params.empty?
+
+          @transport.get("/services/#{@uuid}/logs", params:)
         end
 
         # Stop the session

data/lib/octaspace/resources/services/vpn.rb

@@ -9,7 +9,7 @@ module OctaSpace
       #   client.services.vpn.list
       #   client.services.vpn.create(node_id: 123)
       class Vpn < Base
-        # List active VPN sessions
+        # List available VPN relay nodes
         # GET /services/vpn
         # @param params [Hash] optional filter params
         # @return [OctaSpace::Response]

data/lib/octaspace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OctaSpace
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/octaspace.rb

@@ -2,6 +2,7 @@
 
 require "octaspace/version"
 require "octaspace/errors"
+require "octaspace/payload_helpers"
 require "octaspace/response"
 require "octaspace/configuration"
 require "octaspace/middleware/url_rotator"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octaspace
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - OctaSpace Team
@@ -53,6 +53,7 @@ files:
 - lib/octaspace/configuration.rb
 - lib/octaspace/errors.rb
 - lib/octaspace/middleware/url_rotator.rb
+- lib/octaspace/payload_helpers.rb
 - lib/octaspace/railtie.rb
 - lib/octaspace/resources/accounts.rb
 - lib/octaspace/resources/apps.rb