claude_code 0.0.16 → 0.0.18

data/examples/irb_helpers.rb

@@ -7,6 +7,7 @@ require_relative '../lib/claude_code'
 def ninja_test(prompt)
   ClaudeCode.quick_mcp_query(
     prompt,
+    model: 'sonnet',
     server_name: 'ninja',
     server_url: 'https://mcp-creator-ninja-v1-4-0.mcp.soy/',
     tools: 'about'
@@ -43,18 +44,16 @@ def quick_claude(prompt, model: nil)
     model: model,
     max_turns: 1
   )
-  
+
   ClaudeCode.query(
     prompt: prompt,
     options: options,
-    cli_path: "/Users/admin/.claude/local/claude"
+    cli_path: '/Users/admin/.claude/local/claude'
   ).each do |msg|
-    if msg.is_a?(ClaudeCode::AssistantMessage)
-      msg.content.each do |block|
-        if block.is_a?(ClaudeCode::TextBlock)
-          puts block.text
-        end
-      end
+    next unless msg.is_a?(ClaudeCode::AssistantMessage)
+
+    msg.content.each do |block|
+      puts block.text if block.is_a?(ClaudeCode::TextBlock)
     end
   end
 end
@@ -65,15 +64,13 @@ def stream_claude(prompt, model: nil)
   ClaudeCode.stream_query(
     prompt: prompt,
     options: ClaudeCode::ClaudeCodeOptions.new(model: model, max_turns: 1),
-    cli_path: "/Users/admin/.claude/local/claude"
+    cli_path: '/Users/admin/.claude/local/claude'
   ) do |msg, index|
     timestamp = Time.now - start_time
     case msg
     when ClaudeCode::AssistantMessage
       msg.content.each do |block|
-        if block.is_a?(ClaudeCode::TextBlock)
-          puts "[#{format('%.2f', timestamp)}s] #{block.text}"
-        end
+        puts "[#{format('%.2f', timestamp)}s] #{block.text}" if block.is_a?(ClaudeCode::TextBlock)
       end
     when ClaudeCode::ResultMessage
       puts "[#{format('%.2f', timestamp)}s] 💰 $#{format('%.6f', msg.total_cost_usd || 0)}"
@@ -86,21 +83,19 @@ def auto_stream(prompt, model: nil)
   ClaudeCode.stream_query(
     prompt: prompt,
     options: ClaudeCode::ClaudeCodeOptions.new(model: model, max_turns: 1),
-    cli_path: "/Users/admin/.claude/local/claude"
+    cli_path: '/Users/admin/.claude/local/claude'
   )
 end
 
 # Continue the most recent conversation
 def continue_chat(prompt = nil)
   last_session_id = nil
-  
+
   ClaudeCode.continue_conversation(prompt) do |msg|
     case msg
     when ClaudeCode::AssistantMessage
       msg.content.each do |block|
-        if block.is_a?(ClaudeCode::TextBlock)
-          puts "💬 #{block.text}"
-        end
+        puts "💬 #{block.text}" if block.is_a?(ClaudeCode::TextBlock)
       end
     when ClaudeCode::ResultMessage
       last_session_id = msg.session_id
@@ -108,7 +103,7 @@ def continue_chat(prompt = nil)
       puts "💰 $#{format('%.6f', msg.total_cost_usd || 0)}"
     end
   end
-  
+
   last_session_id
 end
 
@@ -118,9 +113,7 @@ def resume_chat(session_id, prompt = nil)
     case msg
     when ClaudeCode::AssistantMessage
       msg.content.each do |block|
-        if block.is_a?(ClaudeCode::TextBlock)
-          puts "💬 #{block.text}"
-        end
+        puts "💬 #{block.text}" if block.is_a?(ClaudeCode::TextBlock)
       end
     when ClaudeCode::ResultMessage
       puts "📋 Session: #{msg.session_id}"
@@ -141,28 +134,28 @@ def resume_last(prompt = nil)
   if $last_session_id
     resume_chat($last_session_id, prompt)
   else
-    puts "❌ No saved session ID. Use save_session(id) first."
+    puts '❌ No saved session ID. Use save_session(id) first.'
   end
 end
 
-puts "🚀 Ruby Claude Code SDK with MCP, Streaming, and Conversation helpers loaded!"
+puts '🚀 Ruby Claude Code SDK with MCP, Streaming, and Conversation helpers loaded!'
 puts
-puts "Basic commands:"
+puts 'Basic commands:'
 puts "  quick_claude('What is Ruby?')"
 puts "  ninja_test('Tell me about yourself')"
 puts
-puts "Streaming commands:"
+puts 'Streaming commands:'
 puts "  stream_claude('Explain Ruby blocks')"
 puts "  auto_stream('Count to 5')"
 puts
-puts "Conversation commands:"
+puts 'Conversation commands:'
 puts "  continue_chat('Follow up question')"
 puts "  resume_chat('session-id', 'New prompt')"
 puts "  save_session('session-id')"
 puts "  resume_last('New prompt')"
 puts
-puts "Advanced:"
+puts 'Advanced:'
 puts "  quick_claude('Explain arrays', model: 'sonnet')"
 puts "  test_mcp('prompt', 'server_name', 'server_url', 'tool_name')"
 puts
-puts "💡 Remember to set ANTHROPIC_API_KEY environment variable!"
+puts '💡 Remember to set ANTHROPIC_API_KEY environment variable!'

data/lib/claude_code/client.rb

@@ -10,42 +10,38 @@ module ClaudeCode
       # Client setup
     end
 
-    def process_query(prompt: nil, messages: nil, options:, cli_path: nil, mcp_servers: {})
+    def process_query(options:, prompt: nil, messages: nil, cli_path: nil, mcp_servers: {})
       if messages
         # Handle streaming JSON input
-        transport = SubprocessCLITransport.new(prompt: "", options: options, cli_path: cli_path)
+        transport = SubprocessCLITransport.new(prompt: '', options: options, cli_path: cli_path)
         transport.connect
-        
+
         # Send messages
         transport.send_messages(messages)
-        
+
         # Return enumerator for responses
         return Enumerator.new do |yielder|
-          begin
-            transport.receive_messages do |data|
-              message = parse_message(data)
-              yielder << message if message
-            end
-          ensure
-            transport.disconnect
+          transport.receive_messages do |data|
+            message = parse_message(data)
+            yielder << message if message
           end
+        ensure
+          transport.disconnect
         end
       end
-      
+
       transport = SubprocessCLITransport.new(prompt: prompt, options: options, cli_path: cli_path)
-      
+
       transport.connect
-      
+
       # Return lazy enumerator that streams messages as they arrive
       Enumerator.new do |yielder|
-        begin
-          transport.receive_messages do |data|
-            message = parse_message(data)
-            yielder << message if message
-          end
-        ensure
-          transport.disconnect
+        transport.receive_messages do |data|
+          message = parse_message(data)
+          yielder << message if message
         end
+      ensure
+        transport.disconnect
       end
     end
 
@@ -110,7 +106,7 @@ module ClaudeCode
   end
 
   class SubprocessCLITransport
-    MAX_BUFFER_SIZE = 1024 * 1024 # 1MB
+    MAX_BUFFER_SIZE = 1024 * 1024 * 50 # 50MB
 
     def initialize(prompt:, options:, cli_path: nil)
       @prompt = prompt
@@ -127,9 +123,10 @@ module ClaudeCode
       # Use provided CLI path if valid
       if cli_path
         return cli_path if File.executable?(cli_path)
+
         raise CLINotFoundError.new("CLI not found at specified path: #{cli_path}", cli_path: cli_path)
       end
-      
+
       # Try PATH first using cross-platform which
       cli = which('claude')
       return cli if cli
@@ -198,25 +195,19 @@ module ClaudeCode
     def build_environment
       # Start with current environment
       env = ENV.to_h
-      
+
       # Set SDK entrypoint identifier
       env['CLAUDE_CODE_ENTRYPOINT'] = 'sdk-ruby'
-      
+
       # Ensure ANTHROPIC_API_KEY is available if set
       # This allows the CLI to authenticate with Anthropic's API
-      if ENV['ANTHROPIC_API_KEY']
-        env['ANTHROPIC_API_KEY'] = ENV['ANTHROPIC_API_KEY']
-      end
-      
+      env['ANTHROPIC_API_KEY'] = ENV['ANTHROPIC_API_KEY'] if ENV['ANTHROPIC_API_KEY']
+
       # Support for other authentication methods
-      if ENV['CLAUDE_CODE_USE_BEDROCK']
-        env['CLAUDE_CODE_USE_BEDROCK'] = ENV['CLAUDE_CODE_USE_BEDROCK']
-      end
-      
-      if ENV['CLAUDE_CODE_USE_VERTEX']
-        env['CLAUDE_CODE_USE_VERTEX'] = ENV['CLAUDE_CODE_USE_VERTEX']
-      end
-      
+      env['CLAUDE_CODE_USE_BEDROCK'] = ENV['CLAUDE_CODE_USE_BEDROCK'] if ENV['CLAUDE_CODE_USE_BEDROCK']
+
+      env['CLAUDE_CODE_USE_VERTEX'] = ENV['CLAUDE_CODE_USE_VERTEX'] if ENV['CLAUDE_CODE_USE_VERTEX']
+
       env
     end
 
@@ -234,26 +225,24 @@ module ClaudeCode
       cmd.concat(['--max-turns', @options.max_turns.to_s]) if @options.max_turns
       cmd.concat(['--disallowedTools', @options.disallowed_tools.join(',')]) unless @options.disallowed_tools.empty?
       cmd.concat(['--model', @options.model]) if @options.model
-      cmd.concat(['--permission-prompt-tool', @options.permission_prompt_tool_name]) if @options.permission_prompt_tool_name
+      if @options.permission_prompt_tool_name
+        cmd.concat(['--permission-prompt-tool',
+                    @options.permission_prompt_tool_name])
+      end
       cmd.concat(['--permission-mode', @options.permission_mode]) if @options.permission_mode
       cmd << '--continue' if @options.continue_conversation
       cmd.concat(['--resume', @options.resume]) if @options.resume
 
       unless @options.mcp_servers.empty?
-        mcp_config = { 'mcpServers' => @options.mcp_servers.transform_values { |config| 
-          config.respond_to?(:to_h) ? config.to_h : config 
-        } }
+        mcp_config = { 'mcpServers' => @options.mcp_servers.transform_values do |config|
+          config.respond_to?(:to_h) ? config.to_h : config
+        end }
         cmd.concat(['--mcp-config', JSON.generate(mcp_config)])
       end
 
-      # For streaming JSON input, we use --print mode and send JSON via stdin
-      # For regular input, we use --print with the prompt
-      if @options.input_format == 'stream-json'
-        cmd << '--print'
-      else
-        cmd.concat(['--print', @prompt])
-      end
-      
+      # Always use --print flag (prompt will be sent via stdin)
+      cmd << '--print'
+
       cmd
     end
 
@@ -262,36 +251,39 @@ module ClaudeCode
 
       # Find CLI if not already set
       @cli_path ||= find_cli
-      
+
       cmd = build_command
       puts "Debug: Connecting with command: #{cmd.join(' ')}" if ENV['DEBUG_CLAUDE_SDK']
-      
+
       begin
         env = build_environment
-        
+
         if @cwd
           @stdin, @stdout, @stderr, @process = Open3.popen3(env, *cmd, chdir: @cwd)
         else
           @stdin, @stdout, @stderr, @process = Open3.popen3(env, *cmd)
         end
-        
+
         # Handle different input modes
         if @options.input_format == 'stream-json'
           # Keep stdin open for streaming JSON input
-          puts "Debug: Keeping stdin open for streaming JSON input" if ENV['DEBUG_CLAUDE_SDK']
+          puts 'Debug: Keeping stdin open for streaming JSON input' if ENV['DEBUG_CLAUDE_SDK']
         else
-          # Close stdin for regular prompt mode
+          # Write prompt to stdin and close
+          if @prompt && !@prompt.empty?
+            puts "Debug: Writing prompt to stdin (#{@prompt.length} chars)" if ENV['DEBUG_CLAUDE_SDK']
+            @stdin.write(@prompt)
+            @stdin.flush
+          end
           @stdin.close
         end
-        
+
         puts "Debug: Process started with PID #{@process.pid}" if ENV['DEBUG_CLAUDE_SDK']
-        
       rescue Errno::ENOENT => e
-        if @cwd && !Dir.exist?(@cwd)
-          raise CLIConnectionError.new("Working directory does not exist: #{@cwd}")
-        end
+        raise CLIConnectionError.new("Working directory does not exist: #{@cwd}") if @cwd && !Dir.exist?(@cwd)
+
         raise CLINotFoundError.new("Claude Code not found at: #{@cli_path}")
-      rescue => e
+      rescue StandardError => e
         raise CLIConnectionError.new("Failed to start Claude Code: #{e.class} - #{e.message}")
       end
     end
@@ -303,7 +295,7 @@ module ClaudeCode
         # Try to terminate gracefully
         if @process.alive?
           Process.kill('INT', @process.pid)
-          
+
           # Wait for process to exit with timeout
           begin
             require 'timeout'
@@ -314,7 +306,11 @@ module ClaudeCode
             # Force kill if it doesn't exit gracefully
             begin
               Process.kill('KILL', @process.pid) if @process.alive?
-              @process.join rescue nil
+              begin
+                @process.join
+              rescue StandardError
+                nil
+              end
             rescue Errno::ESRCH
               # Process already gone
             end
@@ -323,9 +319,21 @@ module ClaudeCode
       rescue Errno::ESRCH, Errno::ECHILD
         # Process already gone
       ensure
-        @stdin&.close rescue nil
-        @stdout&.close rescue nil
-        @stderr&.close rescue nil
+        begin
+          @stdin&.close
+        rescue StandardError
+          nil
+        end
+        begin
+          @stdout&.close
+        rescue StandardError
+          nil
+        end
+        begin
+          @stderr&.close
+        rescue StandardError
+          nil
+        end
         @stdin = nil
         @stdout = nil
         @stderr = nil
@@ -334,17 +342,17 @@ module ClaudeCode
     end
 
     def receive_messages
-      raise CLIConnectionError.new("Not connected") unless @process && @stdout
+      raise CLIConnectionError.new('Not connected') unless @process && @stdout
+
+      json_buffer = ''
 
-      json_buffer = ""
-      
       begin
         @stdout.each_line do |line|
           line = line.strip
           next if line.empty?
 
           json_lines = line.split("\n")
-          
+
           json_lines.each do |json_line|
             json_line = json_line.strip
             next if json_line.empty?
@@ -352,7 +360,7 @@ module ClaudeCode
             json_buffer += json_line
 
             if json_buffer.length > MAX_BUFFER_SIZE
-              json_buffer = ""
+              json_buffer = ''
               raise CLIJSONDecodeError.new(
                 "JSON message exceeded maximum buffer size of #{MAX_BUFFER_SIZE} bytes",
                 StandardError.new("Buffer size #{json_buffer.length} exceeds limit #{MAX_BUFFER_SIZE}")
@@ -361,13 +369,12 @@ module ClaudeCode
 
             begin
               data = JSON.parse(json_buffer)
-              json_buffer = ""
+              json_buffer = ''
               yield data
             rescue JSON::ParserError => e
               # For single-line JSON, if parsing fails, it's an error
-              if json_buffer.include?("\n") || json_buffer.length > 1000
-                raise CLIJSONDecodeError.new(json_buffer, e)
-              end
+              raise CLIJSONDecodeError.new(json_buffer, e) if json_buffer.include?("\n") || json_buffer.length > 10_000
+
               # Otherwise continue accumulating
               next
             end
@@ -384,21 +391,44 @@ module ClaudeCode
           data = JSON.parse(json_buffer)
           yield data
         rescue JSON::ParserError => e
-          raise CLIJSONDecodeError.new(json_buffer, StandardError.new("Incomplete JSON at end of stream"))
+          raise CLIJSONDecodeError.new(json_buffer, StandardError.new('Incomplete JSON at end of stream'))
         end
       end
 
       # Check for errors
       exit_code = @process.value.exitstatus if @process
       stderr_output = @stderr.read if @stderr
+
+      return unless exit_code && exit_code != 0
+
+      # Build helpful error message
+      error_message = "Command failed with exit code #{exit_code}"
       
-      if exit_code && exit_code != 0
-        raise ProcessError.new(
-          "Command failed with exit code #{exit_code}",
-          exit_code: exit_code,
-          stderr: stderr_output
-        )
+      if stderr_output.nil? || stderr_output.strip.empty?
+        error_message += "\n\nNo error output from Claude CLI. Common causes:"
+        error_message += "\n- Invalid or missing ANTHROPIC_API_KEY"
+        error_message += "\n- MCP server connection failed"
+        error_message += "\n- Network connectivity issues"
+        error_message += "\n- Invalid model name or options"
+        
+        # Include debug info if available
+        if ENV['DEBUG_CLAUDE_SDK']
+          error_message += "\n\nDebug info:"
+          error_message += "\n- CLI path: #{@cli_path}"
+          error_message += "\n- Working directory: #{@cwd || 'current'}"
+          error_message += "\n- JSON buffer (last #{[json_buffer.length, 200].min} chars): #{json_buffer[-200..-1]}" if json_buffer && !json_buffer.empty?
+        end
+        
+        error_message += "\n\nTry enabling debug mode with ENV['DEBUG_CLAUDE_SDK'] = '1' for more details"
+      else
+        error_message += "\nError output: #{stderr_output}"
       end
+
+      raise ProcessError.new(
+        error_message,
+        exit_code: exit_code,
+        stderr: stderr_output
+      )
     end
 
     def connected?
@@ -407,31 +437,31 @@ module ClaudeCode
 
     # Send a JSON message via stdin for streaming input mode
     def send_message(message)
-      raise CLIConnectionError.new("Not connected to CLI") unless @stdin
-      
+      raise CLIConnectionError.new('Not connected to CLI') unless @stdin
+
       json_line = message.to_json + "\n"
       puts "Debug: Sending JSON message: #{json_line.strip}" if ENV['DEBUG_CLAUDE_SDK']
-      
+
       begin
         @stdin.write(json_line)
         @stdin.flush
       rescue Errno::EPIPE
         # Pipe is broken, process has terminated
-        raise CLIConnectionError.new("CLI process terminated unexpectedly")
+        raise CLIConnectionError.new('CLI process terminated unexpectedly')
       end
     end
 
     # Send multiple messages and close stdin to signal end of input
     def send_messages(messages)
-      raise CLIConnectionError.new("Not connected to CLI") unless @stdin
-      
+      raise CLIConnectionError.new('Not connected to CLI') unless @stdin
+
       messages.each do |message|
         send_message(message)
       end
-      
+
       # Close stdin to signal end of input stream
       @stdin.close
       @stdin = nil
     end
   end
-end
+end

data/lib/claude_code/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeCode
-  VERSION = "0.0.16"
+  VERSION = "0.0.18"
 end

data/lib/claude_code.rb

@@ -10,6 +10,11 @@ require_relative 'claude_code/errors'
 require_relative 'claude_code/client'
 
 module ClaudeCode
+  # Check if API key is configured
+  def self.api_key_configured?
+    !ENV['ANTHROPIC_API_KEY'].nil? && !ENV['ANTHROPIC_API_KEY'].strip.empty?
+  end
+
   # Main query method - supports both positional and keyword arguments
   def self.query(prompt_or_args = nil, prompt: nil, options: nil, cli_path: nil, mcp_servers: {}, &block)
     # Handle positional argument for backward compatibility

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_code
 version: !ruby/object:Gem::Version
-  version: 0.0.16
+  version: 0.0.18
 platform: ruby
 authors:
 - Your Name
@@ -168,6 +168,7 @@ files:
 - README.md
 - Rakefile
 - USAGE_EXAMPLES.md
+- claude_code-0.0.16.gem
 - claude_code.gemspec
 - docs/README.md
 - docs/mcp_integration.md