Class: ClaudeAgentSDK::ClaudeAgentOptions

Inherits:
Type
  • Object
show all
Defined in:
lib/claude_agent_sdk/types.rb

Overview

Claude Agent Options for configuring queries

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Type

#[], #[]=, from_hash, #to_h, wrap

Constructor Details

#initialize(attributes = {}) ⇒ ClaudeAgentOptions

Returns a new instance of ClaudeAgentOptions.



1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
 
# File 'lib/claude_agent_sdk/types.rb', line 1518

def initialize(attributes = {})
  self.fork_session = false
  self.continue_conversation = false
  self.include_partial_messages = false
  self.enable_file_checkpointing = false
  self.include_hook_events = false
  self.strict_mcp_config = false

  super(merge_with_defaults(attributes || {}))

  # Non-nil defaults for options that need them.
  self.env                 ||= {}
  self.extra_args          ||= {}
  self.mcp_servers         ||= {}
  self.add_dirs            ||= []
  self.observers           ||= []
  self.allowed_tools       ||= []
  self.disallowed_tools    ||= []
  self.session_store_flush ||= 'batched'
  # 0 is a valid (immediate) timeout, so only fill in the default for nil.
  self.load_timeout_ms = 60_000 if load_timeout_ms.nil?
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class ClaudeAgentSDK::Type

Instance Attribute Details

#add_dirs ⇒ Object

Returns the value of attribute add_dirs.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def add_dirs
  @add_dirs
end

#agents ⇒ Object

Returns the value of attribute agents.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def agents
  @agents
end

#allowed_tools ⇒ Object

Returns the value of attribute allowed_tools.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def allowed_tools
  @allowed_tools
end

#bare ⇒ Object

Returns the value of attribute bare.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def bare
  @bare
end

#betas ⇒ Object

Returns the value of attribute betas.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def betas
  @betas
end

#can_use_tool ⇒ Object

Returns the value of attribute can_use_tool.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def can_use_tool
  @can_use_tool
end

#cli_path ⇒ Object

Returns the value of attribute cli_path.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def cli_path
  @cli_path
end

#continue_conversation ⇒ Object

Returns the value of attribute continue_conversation.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def continue_conversation
  @continue_conversation
end

#cwd ⇒ Object

Returns the value of attribute cwd.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def cwd
  @cwd
end

#debug_stderr ⇒ Object

Returns the value of attribute debug_stderr.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def debug_stderr
  @debug_stderr
end

#disallowed_tools ⇒ Object

Returns the value of attribute disallowed_tools.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def disallowed_tools
  @disallowed_tools
end

#effort ⇒ Object

Returns the value of attribute effort.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def effort
  @effort
end

#enable_file_checkpointing ⇒ Object

Returns the value of attribute enable_file_checkpointing.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def enable_file_checkpointing
  @enable_file_checkpointing
end

#env ⇒ Object

Returns the value of attribute env.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def env
  @env
end

#extra_args ⇒ Object

Returns the value of attribute extra_args.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def extra_args
  @extra_args
end

#fallback_model ⇒ Object

Returns the value of attribute fallback_model.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def fallback_model
  @fallback_model
end

#fork_session ⇒ Object

Returns the value of attribute fork_session.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def fork_session
  @fork_session
end

#hooks ⇒ Object

Returns the value of attribute hooks.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def hooks
  @hooks
end

#include_hook_events ⇒ Object

Returns the value of attribute include_hook_events.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def include_hook_events
  @include_hook_events
end

#include_partial_messages ⇒ Object

Returns the value of attribute include_partial_messages.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def include_partial_messages
  @include_partial_messages
end

#load_timeout_ms ⇒ Object

Returns the value of attribute load_timeout_ms.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def load_timeout_ms
  @load_timeout_ms
end

#max_budget_usd ⇒ Object

Returns the value of attribute max_budget_usd.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def max_budget_usd
  @max_budget_usd
end

#max_buffer_size ⇒ Object

Returns the value of attribute max_buffer_size.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def max_buffer_size
  @max_buffer_size
end

#max_thinking_tokens ⇒ Object

Returns the value of attribute max_thinking_tokens.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def max_thinking_tokens
  @max_thinking_tokens
end

#max_turns ⇒ Object

Returns the value of attribute max_turns.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def max_turns
  @max_turns
end

#mcp_servers ⇒ Object

Returns the value of attribute mcp_servers.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def mcp_servers
  @mcp_servers
end

#model ⇒ Object

Returns the value of attribute model.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def model
  @model
end

#observers ⇒ Object

Returns the value of attribute observers.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def observers
  @observers
end

#output_format ⇒ Object

Returns the value of attribute output_format.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def output_format
  @output_format
end

#permission_mode ⇒ Object

Returns the value of attribute permission_mode.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def permission_mode
  @permission_mode
end

#permission_prompt_tool_name ⇒ Object

Returns the value of attribute permission_prompt_tool_name.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def permission_prompt_tool_name
  @permission_prompt_tool_name
end

#plugins ⇒ Object

Returns the value of attribute plugins.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def plugins
  @plugins
end

#resume ⇒ Object

Returns the value of attribute resume.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def resume
  @resume
end

#resume_session_at ⇒ Object

Returns the value of attribute resume_session_at.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def resume_session_at
  @resume_session_at
end

#sandbox ⇒ Object

Returns the value of attribute sandbox.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def sandbox
  @sandbox
end

#session_id ⇒ Object

Returns the value of attribute session_id.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def session_id
  @session_id
end

#session_store ⇒ Object

Returns the value of attribute session_store.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def session_store
  @session_store
end

#session_store_flush ⇒ Object

Returns the value of attribute session_store_flush.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def session_store_flush
  @session_store_flush
end

#setting_sources ⇒ Object

Returns the value of attribute setting_sources.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def setting_sources
  @setting_sources
end

#settings ⇒ Object

Returns the value of attribute settings.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def settings
  @settings
end

#skills ⇒ Object

Returns the value of attribute skills.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def skills
  @skills
end

#stderr ⇒ Object

Returns the value of attribute stderr.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def stderr
  @stderr
end

#strict_mcp_config ⇒ Object

Returns the value of attribute strict_mcp_config.



1514
1515
1516
 
# File 'lib/claude_agent_sdk/types.rb', line 1514

def strict_mcp_config
  @strict_mcp_config
end

#system_prompt ⇒ Object

Returns the value of attribute system_prompt.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def system_prompt
  @system_prompt
end

#task_budget ⇒ Object

Returns the value of attribute task_budget.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def task_budget
  @task_budget
end

#thinking ⇒ Object

Returns the value of attribute thinking.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def thinking
  @thinking
end

#tools ⇒ Object

Returns the value of attribute tools.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def tools
  @tools
end

#user ⇒ Object

Returns the value of attribute user.



1503
1504
1505
 
# File 'lib/claude_agent_sdk/types.rb', line 1503

def user
  @user
end

Instance Method Details

#bare? ⇒ Boolean

Returns:

  • (Boolean) 


1547
1548
1549
 
# File 'lib/claude_agent_sdk/types.rb', line 1547

def bare?
  !!bare
end

#continue_conversation? ⇒ Boolean

Returns:

  • (Boolean) 


1579
1580
1581
 
# File 'lib/claude_agent_sdk/types.rb', line 1579

def continue_conversation?
  !!continue_conversation
end

#dup_with(**changes) ⇒ Object 



1541
1542
1543
1544
1545
 
# File 'lib/claude_agent_sdk/types.rb', line 1541

def dup_with(**changes)
  new_options = self.dup
  changes.each { |key, value| new_options[key] = value }
  new_options
end

#enable_file_checkpointing? ⇒ Boolean

Returns:

  • (Boolean) 


1563
1564
1565
 
# File 'lib/claude_agent_sdk/types.rb', line 1563

def enable_file_checkpointing?
  !!enable_file_checkpointing
end

#fork_session? ⇒ Boolean

Returns:

  • (Boolean) 


1555
1556
1557
 
# File 'lib/claude_agent_sdk/types.rb', line 1555

def fork_session?
  !!fork_session
end

#include_hook_events? ⇒ Boolean

Returns:

  • (Boolean) 


1587
1588
1589
 
# File 'lib/claude_agent_sdk/types.rb', line 1587

def include_hook_events?
  !!include_hook_events
end

#include_partial_messages? ⇒ Boolean

Returns:

  • (Boolean) 


1571
1572
1573
 
# File 'lib/claude_agent_sdk/types.rb', line 1571

def include_partial_messages?
  !!include_partial_messages
end

#strict_mcp_config? ⇒ Boolean

Returns:

  • (Boolean) 


1595
1596
1597
 
# File 'lib/claude_agent_sdk/types.rb', line 1595

def strict_mcp_config?
  !!strict_mcp_config
end