claude-code-sdk-ruby 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 154889ea495b7743bded0f1cf1ab96b74da5adc93bf19f1e226d6fd9f949dee1
-  data.tar.gz: 77039484cf7d9acbd273334aad182db014b8a5d471d41019d3565828479716a8
+  metadata.gz: 566de0e8ca470f448ccefffcc346d91ae504fc6b3e7bb963d1adf5ff2898de68
+  data.tar.gz: ee8e8fe3255480eaf6c4561502dd97ac8440170e0fed6c129781d59d002488b9
 SHA512:
-  metadata.gz: 73ad8a8341c21ef6cbac699ee4ce211619a853676632c6072374821b08737ccacbe8007dd9de0971dacdf3b6bc9e4b69d21275dc2e4b13e7106a1b7f8a8d34e9
-  data.tar.gz: fc9e88788b6783fd4a335b4553fb6c3607b65083ff1fe898756c4cbb5ee4566012562748107e748ab08f1a1c3dc712eab7bb1e91032bb8ca3818539b6755a1d7
+  metadata.gz: 14a4b7ce2e81a50ffa22f8f480ca4a18fdd55673b85e6b3459a640d235e433bb839f3e4d57c4d4454a2f07c8c01bd12205060b231d093454bd9a629f92d57cc0
+  data.tar.gz: 4f5511cc26a590d5f6d5cbb675149547e6a935b949d3dd8d2ad30cfcba2cd507f4b02fcd5c3d38ce2dc76c6ec1ec07687252ea3a827c605e2248db164db79af2

data/CHANGELOG.md

@@ -7,13 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Changed
-- Removed unused `async-process` dependency
+## [0.1.2] - 2025-07-16
 
-## [0.0.1] - 2024-07-14
+### Added
+- Support for `--session-id` argument to specify a session ID (UUID) for conversations
+  - Added `session_id` parameter to `ClaudeCodeOptions`
+  - CLI command now includes `--session-id` when session ID is provided
+
+## [0.1.1] - 2025-07-15
+
+### Fixed
+- Fixed permission mode conversion to use camelCase format for CLI compatibility
+  - `:bypass_permissions` now correctly converts to `"bypassPermissions"`
+  - `:accept_edits` now correctly converts to `"acceptEdits"`
+  - This ensures the SDK properly passes permission modes to the Claude CLI
+
+## [0.1.0] - 2025-07-15
 
 ### Added
-- Initial release of claude-sdk-ruby
+- Initial release of claude-code-sdk-ruby
 - Core SDK functionality for interacting with Claude Code CLI
 - Support for async query processing
 - Message types: User, Assistant, System, and Result
@@ -39,5 +51,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - simplecov (~> 0.22)
 - yard (~> 0.9)
 
-[Unreleased]: https://github.com/anthropics/claude-code-sdk-ruby/compare/v0.0.1...HEAD
-[0.0.1]: https://github.com/anthropics/claude-code-sdk-ruby/releases/tag/v0.0.1
+[Unreleased]: https://github.com/parruda/claude-code-sdk-ruby/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/parruda/claude-code-sdk-ruby/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/parruda/claude-code-sdk-ruby/releases/tag/v0.1.0

data/README.md

@@ -1,6 +1,6 @@
-# Claude SDK Ruby
+# Claude Code SDK Ruby
 
-[![Gem Version](https://badge.fury.io/rb/claude-sdk-ruby.svg)](https://badge.fury.io/rb/claude-sdk-ruby)
+[![Gem Version](https://badge.fury.io/rb/claude-code-sdk-ruby.svg)](https://badge.fury.io/rb/claude-code-sdk-ruby)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Official Ruby SDK for interacting with Claude Code CLI. This gem provides a Ruby-idiomatic interface to Claude Code with full async support, proper error handling, and comprehensive type definitions.
@@ -10,7 +10,7 @@ Official Ruby SDK for interacting with Claude Code CLI. This gem provides a Ruby
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'claude-sdk-ruby'
+gem 'claude-code-sdk-ruby'
 ```
 
 And then execute:
@@ -22,7 +22,7 @@ bundle install
 Or install it yourself as:
 
 ```bash
-gem install claude-sdk-ruby
+gem install claude-code-sdk-ruby
 ```
 
 ## Prerequisites
@@ -203,17 +203,17 @@ bundle exec rspec
 COVERAGE=true bundle exec rspec
 
 # Build the gem
-gem build claude-sdk-ruby.gemspec
+gem build claude-code-sdk-ruby.gemspec
 
 # Install locally
-gem install ./claude-sdk-ruby-0.1.0.gem
+gem install ./claude-code-sdk-ruby-0.1.0.gem
 ```
 
 To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/anthropics/claude-code-sdk-ruby.
+Bug reports and pull requests are welcome on GitHub at https://github.com/parruda/claude-code-sdk-ruby.
 
 ## License
 

data/examples/bypass_permissions.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "claude_sdk"
+
+# Example showing how to use bypass permissions mode
+# This will pass --permission-mode bypassPermissions to the CLI
+
+options = ClaudeSDK::ClaudeCodeOptions.new(
+  permission_mode: :bypass_permissions,
+)
+
+client = ClaudeSDK::Client.new(options)
+
+begin
+  response = client.query("List the files in the current directory")
+
+  response.each do |message|
+    if message["type"] == "user"
+      puts "User: #{message["content"]}"
+    elsif message["type"] == "assistant"
+      message["content"].each do |block|
+        if block["type"] == "text"
+          puts "Assistant: #{block["text"]}"
+        end
+      end
+    end
+  end
+rescue ClaudeSDK::CLINotFoundError => e
+  puts "Error: #{e.message}"
+  puts "Please install Claude Code CLI first"
+rescue StandardError => e
+  puts "Error: #{e.message}"
+end

data/lib/claude_sdk/internal/transport/subprocess_cli.rb

@@ -334,12 +334,14 @@ module ClaudeSDK
           cmd.push("--permission-prompt-tool", @options.permission_prompt_tool_name)
         end
 
-        cmd.push("--permission-mode", @options.permission_mode.to_s) if @options.permission_mode
+        cmd.push("--permission-mode", format_permission_mode(@options.permission_mode)) if @options.permission_mode
 
         cmd.push("--continue") if @options.continue_conversation
 
         cmd.push("--resume", @options.resume) if @options.resume
 
+        cmd.push("--session-id", @options.session_id) if @options.session_id
+
         if @options.mcp_servers && !@options.mcp_servers.empty?
           mcp_config = { "mcpServers" => serialize_mcp_servers }
           cmd.push("--mcp-config", JSON.generate(mcp_config))
@@ -357,6 +359,23 @@ module ClaudeSDK
           server.respond_to?(:to_h) ? server.to_h : server
         end
       end
+
+      # Convert permission mode from Ruby symbol format to CLI camelCase format
+      #
+      # @param mode [Symbol] the permission mode symbol
+      # @return [String] the camelCase formatted mode
+      def format_permission_mode(mode)
+        case mode
+        when :default
+          "default"
+        when :accept_edits
+          "acceptEdits"
+        when :bypass_permissions
+          "bypassPermissions"
+        else
+          mode.to_s
+        end
+      end
     end
   end
 end

data/lib/claude_sdk/types.rb

@@ -336,7 +336,8 @@ module ClaudeSDK
       :disallowed_tools,
       :model,
       :permission_prompt_tool_name,
-      :cwd
+      :cwd,
+      :session_id
 
     # Initialize with default values
     #
@@ -354,6 +355,7 @@ module ClaudeSDK
     # @param model [String, nil] model name
     # @param permission_prompt_tool_name [String, nil] permission tool
     # @param cwd [String, Pathname, nil] working directory
+    # @param session_id [String, nil] session ID (must be a valid UUID)
     def initialize(allowed_tools: [],
       max_thinking_tokens: 8000,
       system_prompt: nil,
@@ -367,7 +369,8 @@ module ClaudeSDK
       disallowed_tools: [],
       model: nil,
       permission_prompt_tool_name: nil,
-      cwd: nil)
+      cwd: nil,
+      session_id: nil)
       @allowed_tools = allowed_tools
       @max_thinking_tokens = max_thinking_tokens
       @system_prompt = system_prompt
@@ -382,6 +385,7 @@ module ClaudeSDK
       @model = model
       @permission_prompt_tool_name = permission_prompt_tool_name
       @cwd = cwd
+      @session_id = session_id
 
       validate_permission_mode! if permission_mode
     end
@@ -405,6 +409,7 @@ module ClaudeSDK
       hash[:model] = model if model
       hash[:permission_prompt_tool_name] = permission_prompt_tool_name if permission_prompt_tool_name
       hash[:cwd] = cwd.to_s if cwd
+      hash[:session_id] = session_id if session_id
       hash
     end
 

data/lib/claude_sdk/version.rb

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

data/ruby-sdk-maintenance-swarm.yml

@@ -47,8 +47,8 @@ swarm:
         
     python_sdk_guide:
       description: "Python SDK consultant providing implementation guidance and best practices"
-      directory: .
-      model: sonnet
+      directory: ~/src/github.com/anthropics/claude-code-sdk-python
+      model: opus
       vibe: true
       prompt: |
         You are a Python SDK consultant specializing in the Claude Code Python SDK. Your role is to:
@@ -59,9 +59,9 @@ swarm:
         - Help maintain consistency between SDKs while respecting language idioms
         - Read and understand Python SDK code to inform Ruby development
         
-        You primarily use Read and WebFetch tools to analyze the Python SDK and provide 
+        You explore and analyze the Python SDK codebase and provide 
         implementation guidance. Focus on reading the Python SDK codebase to understand 
         patterns and suggest how they should be adapted for Ruby.
         
         For maximum efficiency, whenever you need to perform multiple independent operations, 
-        invoke all relevant tools simultaneously rather than sequentially.
+        invoke all relevant tools simultaneously rather than sequentially.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude-code-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: exe
 cert_chain: []
-date: 2025-07-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -55,6 +55,7 @@ files:
 - claude-code-sdk-ruby.gemspec
 - examples/async_multiple_queries.rb
 - examples/basic_usage.rb
+- examples/bypass_permissions.rb
 - examples/enumerator_usage.rb
 - examples/error_handling.rb
 - examples/mcp_servers.rb
@@ -89,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby SDK for Claude Code
 test_files: []