claude-agent-sdk 0.35.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +74 -0
  3. data/README.md +17 -8
  4. data/docs/cli-installer.md +16 -2
  5. data/docs/client.md +44 -4
  6. data/docs/errors.md +15 -1
  7. data/docs/hooks-and-permissions.md +27 -3
  8. data/docs/mcp-servers.md +36 -7
  9. data/docs/rails.md +3 -4
  10. data/docs/sessions.md +149 -34
  11. data/docs/types.md +106 -4
  12. data/lib/claude_agent_sdk/cancellation_signal.rb +2 -1
  13. data/lib/claude_agent_sdk/cli_installer.rb +68 -11
  14. data/lib/claude_agent_sdk/command_builder.rb +109 -98
  15. data/lib/claude_agent_sdk/deprecation.rb +90 -0
  16. data/lib/claude_agent_sdk/errors.rb +8 -0
  17. data/lib/claude_agent_sdk/fiber_boundary.rb +113 -2
  18. data/lib/claude_agent_sdk/instrumentation/otel.rb +15 -7
  19. data/lib/claude_agent_sdk/message_parser.rb +23 -9
  20. data/lib/claude_agent_sdk/observer.rb +2 -1
  21. data/lib/claude_agent_sdk/option_warnings.rb +2 -2
  22. data/lib/claude_agent_sdk/query.rb +99 -51
  23. data/lib/claude_agent_sdk/railtie.rb +14 -3
  24. data/lib/claude_agent_sdk/sdk_mcp_server.rb +58 -38
  25. data/lib/claude_agent_sdk/session_mutations.rb +28 -16
  26. data/lib/claude_agent_sdk/session_resume.rb +39 -35
  27. data/lib/claude_agent_sdk/session_store.rb +35 -21
  28. data/lib/claude_agent_sdk/session_summary.rb +12 -5
  29. data/lib/claude_agent_sdk/sessions.rb +112 -24
  30. data/lib/claude_agent_sdk/streaming.rb +1 -1
  31. data/lib/claude_agent_sdk/subprocess_cli_transport.rb +75 -52
  32. data/lib/claude_agent_sdk/tasks/claude_agent_sdk.rake +12 -5
  33. data/lib/claude_agent_sdk/testing/session_store_conformance.rb +15 -11
  34. data/lib/claude_agent_sdk/transcript_mirror_batcher.rb +19 -1
  35. data/lib/claude_agent_sdk/types/attributes.rb +271 -0
  36. data/lib/claude_agent_sdk/types/base.rb +320 -0
  37. data/lib/claude_agent_sdk/types/content_blocks.rb +57 -0
  38. data/lib/claude_agent_sdk/types/hooks.rb +640 -0
  39. data/lib/claude_agent_sdk/types/mcp.rb +232 -0
  40. data/lib/claude_agent_sdk/types/messages.rb +614 -0
  41. data/lib/claude_agent_sdk/types/option_values.rb +302 -0
  42. data/lib/claude_agent_sdk/types/options.rb +352 -0
  43. data/lib/claude_agent_sdk/types/permissions.rb +107 -0
  44. data/lib/claude_agent_sdk/types/sessions.rb +10 -0
  45. data/lib/claude_agent_sdk/types.rb +13 -2534
  46. data/lib/claude_agent_sdk/version.rb +1 -1
  47. data/lib/claude_agent_sdk.rb +308 -73
  48. data/lib/generators/claude_agent_sdk/install/templates/claude_agent_sdk.rb.tt +3 -3
  49. metadata +12 -1
data/lib/generators/claude_agent_sdk/install/templates/claude_agent_sdk.rb.tt CHANGED
@@ -18,9 +18,9 @@ ClaudeAgentSDK.configure do |config|
18
18
  # 'bypassPermissions' (unattended jobs in a sandbox only), or 'auto'.
19
19
  # permission_mode: 'default',
20
20
 
21
- # The CLI is found in vendor/claude relative to the process cwd (Rails.root
22
- # under bin/rails, Puma and most job runners). Pin it for other launchers:
23
- # cli_path: Rails.root.join('vendor', 'claude', 'claude').to_s,
21
+ # The CLI is found in Rails.root/vendor/claude (bin/rails claude_agent_sdk:install_cli),
22
+ # whatever the process cwd. To run a binary from somewhere else instead:
23
+ # cli_path: '/usr/local/bin/claude',
24
24
 
25
25
  # OpenTelemetry tracing (Langfuse, Honeycomb, ...). A factory lambda gives
26
26
  # every query/session its own observer — safe under Puma and job threads.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: claude-agent-sdk
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.35.0
4
+ version: 0.37.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - ya-luotao
@@ -138,6 +138,7 @@ files:
138
138
  - lib/claude_agent_sdk/cli_installer.rb
139
139
  - lib/claude_agent_sdk/command_builder.rb
140
140
  - lib/claude_agent_sdk/configuration.rb
141
+ - lib/claude_agent_sdk/deprecation.rb
141
142
  - lib/claude_agent_sdk/errors.rb
142
143
  - lib/claude_agent_sdk/fiber_boundary.rb
143
144
  - lib/claude_agent_sdk/instrumentation.rb
@@ -161,6 +162,16 @@ files:
161
162
  - lib/claude_agent_sdk/transcript_mirror_batcher.rb
162
163
  - lib/claude_agent_sdk/transport.rb
163
164
  - lib/claude_agent_sdk/types.rb
165
+ - lib/claude_agent_sdk/types/attributes.rb
166
+ - lib/claude_agent_sdk/types/base.rb
167
+ - lib/claude_agent_sdk/types/content_blocks.rb
168
+ - lib/claude_agent_sdk/types/hooks.rb
169
+ - lib/claude_agent_sdk/types/mcp.rb
170
+ - lib/claude_agent_sdk/types/messages.rb
171
+ - lib/claude_agent_sdk/types/option_values.rb
172
+ - lib/claude_agent_sdk/types/options.rb
173
+ - lib/claude_agent_sdk/types/permissions.rb
174
+ - lib/claude_agent_sdk/types/sessions.rb
164
175
  - lib/claude_agent_sdk/version.rb
165
176
  - lib/generators/claude_agent_sdk/install/install_generator.rb
166
177
  - lib/generators/claude_agent_sdk/install/templates/claude_agent_sdk.rb.tt