Claude SDK Adapter

1
import asyncio
2
import logging
3
import os
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import ClaudeSDKAdapter
7
from thenvoi.config import load_agent_config
8
9
logging.basicConfig(level=logging.INFO)
10
logger = logging.getLogger(__name__)
11
12
async def main():
13
    load_dotenv()
14
15
    # Load agent credentials
16
    agent_id, api_key = load_agent_config("my_agent")
17
18
    # Create adapter with Claude SDK
19
    adapter = ClaudeSDKAdapter(
20
        model="claude-sonnet-4-5-20250929",
21
    )
22
23
    # Create and run the agent
24
    agent = Agent.create(
25
        adapter=adapter,
26
        agent_id=agent_id,
27
        api_key=api_key,
28
        ws_url=os.getenv("THENVOI_WS_URL"),
29
        rest_url=os.getenv("THENVOI_REST_URL"),
30
    )
31
32
    logger.info("Agent is running! Press Ctrl+C to stop.")
33
    await agent.run()
34
35
if __name__ == "__main__":
36
    asyncio.run(main())

1
# Claude Sonnet (recommended for most use cases)
2
adapter = ClaudeSDKAdapter(model="claude-sonnet-4-5-20250929")
3
4
# Claude Opus (most capable)
5
adapter = ClaudeSDKAdapter(model="claude-opus-4-5-20251215")
6
7
# Claude Haiku (fastest)
8
adapter = ClaudeSDKAdapter(model="claude-3-5-haiku-20241022")

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    custom_section="""
4
    You are a helpful assistant that specializes in answering
5
    questions about Python programming. Be concise and include
6
    code examples when helpful.
7
    """,
8
)

1
adapter = ClaudeSDKAdapter(
2
    # Model to use
3
    model="claude-sonnet-4-5-20250929",
4
5
    # Custom instructions to append to the system prompt
6
    custom_section="You are a helpful assistant.",
7
8
    # Enable extended thinking (chain of thought)
9
    max_thinking_tokens=10000,
10
11
    # Permission mode for tool execution
12
    permission_mode="acceptEdits",  # or "plan", "bypassPermissions"
13
14
    # Enable visibility into tool calls and thinking
15
    enable_execution_reporting=False,
16
)

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    max_thinking_tokens=10000,
4
)

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    enable_execution_reporting=True,
4
)

1
import asyncio
2
import logging
3
import os
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import ClaudeSDKAdapter
7
from thenvoi.config import load_agent_config
8
9
logging.basicConfig(level=logging.INFO)
10
logger = logging.getLogger(__name__)
11
12
async def main():
13
    load_dotenv()
14
    agent_id, api_key = load_agent_config("my_agent")
15
16
    adapter = ClaudeSDKAdapter(
17
        model="claude-sonnet-4-5-20250929",
18
        custom_section="""
19
        You are a helpful data analysis expert. When users ask questions:
20
        1. Think through the problem carefully
21
        2. Provide clear, step-by-step explanations
22
        3. Include code examples in Python when relevant
23
        4. Offer to help with follow-up questions
24
        """,
25
        max_thinking_tokens=5000,
26
        enable_execution_reporting=True,
27
    )
28
29
    agent = Agent.create(
30
        adapter=adapter,
31
        agent_id=agent_id,
32
        api_key=api_key,
33
        ws_url=os.getenv("THENVOI_WS_URL"),
34
        rest_url=os.getenv("THENVOI_REST_URL"),
35
    )
36
37
    logger.info("Data analysis agent is running! Press Ctrl+C to stop.")
38
    await agent.run()
39
40
if __name__ == "__main__":
41
    asyncio.run(main())

1
import asyncio
2
import os
3
import logging
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import ClaudeSDKAdapter
7
from thenvoi.config import load_agent_config
8
9
# Enable debug logging for the SDK
10
logging.basicConfig(
11
    level=logging.WARNING,
12
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
13
    datefmt="%Y-%m-%d %H:%M:%S",
14
)
15
logging.getLogger("thenvoi").setLevel(logging.DEBUG)
16
logger = logging.getLogger(__name__)
17
18
async def main():
19
    load_dotenv()
20
    agent_id, api_key = load_agent_config("my_agent")
21
22
    adapter = ClaudeSDKAdapter(
23
        model="claude-sonnet-4-5-20250929",
24
    )
25
26
    agent = Agent.create(
27
        adapter=adapter,
28
        agent_id=agent_id,
29
        api_key=api_key,
30
        ws_url=os.getenv("THENVOI_WS_URL"),
31
        rest_url=os.getenv("THENVOI_REST_URL"),
32
    )
33
34
    logger.info("Agent running with DEBUG logging. Press Ctrl+C to stop.")
35
    await agent.run()
36
37
if __name__ == "__main__":
38
    asyncio.run(main())

1
from claude_agent_sdk import tool
2
3
@tool("my_tool", "Description of what this tool does", {"param": str})
4
async def my_tool(args: dict) -> dict:
5
    result = args["param"].upper()
6
    return {"content": [{"type": "text", "text": result}]}

1
from .example_tools import calculator, get_time, random_number, my_tool
2
3
TOOL_REGISTRY = {
4
    "calculator": calculator,
5
    "get_time": get_time,
6
    "random_number": random_number,
7
    "my_tool": my_tool,
8
}