/ 
Claude-Agent-0.08

Changes for version 0.08 - 2026-01-11

  • Async Support
    • Async tool handlers: return Futures for non-blocking I/O
    • Async hooks: callbacks can return Futures for async validation
    • IO::Async::Loop passed to handlers/hooks for event-driven operations
    • Backward compatible: sync handlers/hooks still work unchanged
  • Debug Logging
    • Comprehensive operational logging (set CLAUDE_AGENT_DEBUG=1)
    • Message lifecycle: receive, queue, deliver, process
    • Socket lifecycle: connect, accept, close
    • Tool execution: start, complete, results
    • Hook execution: matchers, decisions, blocked tools
  • Examples
    • examples/12-async-tool.pl: async tool patterns
    • examples/13-async-hook.pl: async hook patterns

Modules

Claude::Agent
Perl SDK for the Claude Agent SDK
Claude::Agent::Client
Persistent session client for Claude Agent SDK
Claude::Agent::Content
Content block types for Claude Agent SDK
Claude::Agent::Content::Text
Text content block
Claude::Agent::Content::Thinking
Thinking content block
Claude::Agent::Content::ToolResult
Tool result content block
Claude::Agent::Content::ToolUse
Tool use content block
Claude::Agent::DryRun
Dry-run mode support for Claude Agent SDK
Claude::Agent::Error
Exception classes for Claude Agent SDK
Claude::Agent::Error::CLINotFound
CLI not found exception
Claude::Agent::Error::HookError
Hook execution exception
Claude::Agent::Error::JSONDecodeError
JSON parsing exception
Claude::Agent::Error::PermissionDenied
Permission denied exception
Claude::Agent::Error::ProcessError
Process execution exception
Claude::Agent::Error::TimeoutError
Timeout exception
Claude::Agent::Hook
Hook system for Claude Agent SDK
Claude::Agent::Hook::Context
Hook context for Claude Agent SDK
Claude::Agent::Hook::Executor
Executes Perl hooks for Claude Agent SDK
Claude::Agent::Hook::Matcher
Hook matcher for Claude Agent SDK
Claude::Agent::Hook::Result
Hook result factory for Claude Agent SDK
Claude::Agent::Logger
Configurable logging for Claude Agent SDK
Claude::Agent::MCP
MCP (Model Context Protocol) server integration
Claude::Agent::MCP::HTTPServer
HTTP MCP server configuration
Claude::Agent::MCP::HeaderUtils
Header sensitivity utilities for MCP servers
Claude::Agent::MCP::SDKRunner
MCP server runner for SDK tools
Claude::Agent::MCP::SDKServer
Socket-based MCP server for SDK tools
Claude::Agent::MCP::SSEServer
SSE MCP server configuration
Claude::Agent::MCP::Server
SDK MCP server configuration
Claude::Agent::MCP::StdioServer
Stdio MCP server configuration
Claude::Agent::MCP::ToolDefinition
MCP tool definition
Claude::Agent::Message
Message types for Claude Agent SDK
Claude::Agent::Message::Assistant
Assistant message type
Claude::Agent::Message::Base
Base class for message types
Claude::Agent::Message::Result
Result message type
Claude::Agent::Message::System
System message type
Claude::Agent::Message::User
User message type
Claude::Agent::Options
Configuration options for Claude Agent queries
Claude::Agent::Permission
Permission handling for Claude Agent SDK
Claude::Agent::Permission::Context
Permission context for Claude Agent SDK
Claude::Agent::Permission::Result
Base class for permission results
Claude::Agent::Permission::Result::Allow
Permission allow result
Claude::Agent::Permission::Result::Deny
Permission deny result
Claude::Agent::Query
Query iterator for Claude Agent SDK
Claude::Agent::Subagent
Subagent definitions for Claude Agent SDK

Examples

Other files