pipeops-rexec 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa120cedebd032e6487ad85157b0a7c98721af37fbd656d3b61c7cd1d521af0c
-  data.tar.gz: 3dc1adfaddc9e08ca5579d151e4d61b1d6c4cf98aef4cab25e347728be4980e4
+  metadata.gz: e7ba59743a1e821530bd403adb43dcba9aff15c995197741c9f2c309325b1599
+  data.tar.gz: 902155d9d6f68d257668356fb6854b8b3470271f2f23f9b1905cef0822d5c7cd
 SHA512:
-  metadata.gz: f48cc1ddd4444fdb469dfb0d111a3a4af1e55ad36168b1003598c94695831eb89f08c1d50903afb81683956bc0109602db49f2421eeae28bfcd84e960d7562fb
-  data.tar.gz: 7fa9c5990e393c28900d04978f4ce66b9cd52458d51a7598de769114b16f9fbe5df9fa3fdaec1e48f02d311593fcf96b8b786274b8d9296a417edf68e37e4f2a
+  metadata.gz: 5f22905b095e20c123f27b0b4958881f9020e25569856b9112c1d16725fb6bca8acf2b7b9c20a4b1389d17ea57d3a27f75122669df06ff2fd1e8cb7b091f1c56
+  data.tar.gz: 32d3ec942eac748f79adad09d21cc9d004ea85d0050846656b70b35981286e3884b8783f5ee4b7a56569e2f1bac3a090234dd3a9784c4621ff986cef1942bc70

data/README.md

@@ -25,7 +25,7 @@ client = Rexec::Client.new("https://your-instance.com", "your-token")
 
 # Create a container
 container = client.containers.create(
-  image: "ubuntu:24.04",
+  image: "ubuntu",
   name: "my-sandbox"
 )
 puts "Created container: #{container.id}"
@@ -74,7 +74,7 @@ container = client.containers.get("container-id")
 
 # Create a container
 container = client.containers.create(
-  image: "ubuntu:24.04",
+  image: "ubuntu",
   name: "my-container",
   environment: { "MY_VAR" => "value" },
   labels: { "project" => "demo" }
@@ -176,7 +176,7 @@ def create_batch(client, count)
   futures = (0...count).map do |i|
     Concurrent::Future.execute do
       client.containers.create(
-        image: "ubuntu:24.04",
+        image: "ubuntu",
         name: "worker-#{i}"
       )
     end

data/lib/rexec/client.rb

@@ -7,11 +7,18 @@ module Rexec
   # Main client for interacting with Rexec API.
   #
   # @example
-  #   client = Rexec::Client.new("https://your-instance.com", "your-token")
-  #   containers = client.containers.list
+  #   client = Rexec::Client.new("https://rexec.sh", "your-token")
+  #   sandboxes = client.sandboxes.list
+  #   # Legacy: client.containers is the same service
   #
   class Client
-    attr_reader :base_url, :containers, :files, :terminal
+    attr_reader :base_url, :sandboxes, :files, :terminal
+
+    # Deprecated alias for {#sandboxes}.
+    # @return [SandboxService]
+    def containers
+      sandboxes
+    end
 
     # Initialize a new Rexec client.
     #
@@ -32,7 +39,7 @@ module Rexec
         f.headers["Accept"] = "application/json"
       end
 
-      @containers = ContainerService.new(self)
+      @sandboxes = SandboxService.new(self)
       @files = FileService.new(self)
       @terminal = TerminalService.new(self)
     end

data/lib/rexec/container.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 module Rexec
-  # Represents a Rexec container/sandbox.
-  class Container
+  # Represents a Rexec sandbox (isolated Linux environment).
+  class Sandbox
     attr_reader :id, :name, :image, :status, :created_at, :started_at, :labels, :environment
 
     def initialize(data)
@@ -25,42 +25,45 @@ module Rexec
     end
   end
 
-  # Service for managing containers.
-  class ContainerService
+  # @deprecated Use {Sandbox}
+  Container = Sandbox
+
+  # Service for managing sandboxes. HTTP paths remain /api/containers.
+  class SandboxService
     def initialize(client)
       @client = client
     end
 
-    # List all containers.
+    # List all sandboxes.
     #
-    # @return [Array<Container>]
+    # @return [Array<Sandbox>]
     def list
       data = @client.request(:get, "/api/containers")
       # API returns { "containers" => [...], "count" => N, "limit" => M }
       items = data.is_a?(Array) ? data : (data && data["containers"]) || []
-      items.map { |c| Container.new(c) }
+      items.map { |c| Sandbox.new(c) }
     end
 
-    # Get a container by ID.
+    # Get a sandbox by ID.
     #
-    # @param id [String] Container ID
-    # @return [Container]
+    # @param id [String] Sandbox ID
+    # @return [Sandbox]
     def get(id)
       data = @client.request(:get, "/api/containers/#{id}")
-      Container.new(data)
+      Sandbox.new(data)
     end
 
-    # Create a new container.
+    # Create a new sandbox.
     #
-    # @param image [String] Docker image to use
-    # @param name [String, nil] Optional container name
+    # @param image [String] Image alias (e.g. "ubuntu")
+    # @param name [String, nil] Optional sandbox name
     # @param environment [Hash] Environment variables
-    # @param labels [Hash] Container labels
-    # @return [Container]
+    # @param labels [Hash] Labels
+    # @return [Sandbox]
     #
     # @example
-    #   container = client.containers.create(
-    #     image: "ubuntu:24.04",
+    #   sandbox = client.sandboxes.create(
+    #     image: "ubuntu",
     #     name: "my-sandbox",
     #     environment: { "MY_VAR" => "value" }
     #   )
@@ -71,31 +74,34 @@ module Rexec
       body[:labels] = labels unless labels.empty?
 
       data = @client.request(:post, "/api/containers", body: body)
-      Container.new(data)
+      Sandbox.new(data)
     end
 
-    # Delete a container.
+    # Delete a sandbox.
     #
-    # @param id [String] Container ID
+    # @param id [String] Sandbox ID
     def delete(id)
       @client.request(:delete, "/api/containers/#{id}")
       nil
     end
 
-    # Start a container.
+    # Start a sandbox.
     #
-    # @param id [String] Container ID
+    # @param id [String] Sandbox ID
     def start(id)
       @client.request(:post, "/api/containers/#{id}/start")
       nil
     end
 
-    # Stop a container.
+    # Stop a sandbox.
     #
-    # @param id [String] Container ID
+    # @param id [String] Sandbox ID
     def stop(id)
       @client.request(:post, "/api/containers/#{id}/stop")
       nil
     end
   end
+
+  # @deprecated Use {SandboxService}
+  ContainerService = SandboxService
 end

data/lib/rexec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rexec
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/lib/rexec.rb

@@ -7,19 +7,20 @@ require_relative "rexec/container"
 require_relative "rexec/file_service"
 require_relative "rexec/terminal"
 
-# Rexec Ruby SDK - Official SDK for Rexec Terminal as a Service.
+# Rexec Ruby SDK — official client for AI-native sandboxes.
 #
 # @example Basic usage
 #   client = Rexec::Client.new("https://your-instance.com", "your-token")
-#   
-#   container = client.containers.create(image: "ubuntu:24.04")
-#   puts "Created: #{container.id}"
-#   
-#   terminal = client.terminal.connect(container.id)
+#
+#   sandbox = client.sandboxes.create(image: "ubuntu")
+#   puts "Created: #{sandbox.id}"
+#
+#   terminal = client.terminal.connect(sandbox.id)
 #   terminal.write("echo hello\n")
 #   terminal.on_data { |data| puts data }
-#   
-#   client.containers.delete(container.id)
+#
+#   client.sandboxes.delete(sandbox.id)
+#   # Legacy: client.containers is the same service
 #
 module Rexec
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pipeops-rexec
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - PipeOpsHQ
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-01 00:00:00.000000000 Z
+date: 2026-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday