6. SDK Clients¶

The SW4RM SDKs expose gRPC clients for each protocol service. This section documents the client layer APIs and the most common usage patterns across Python, Rust, and JavaScript/TypeScript.

6.1. Conventions¶

• Python clients accept a gRPC channel and require generated protobuf stubs.

• JavaScript/TypeScript clients accept ClientOptions with a address string and handle metadata, deadlines, and retries internally.

• Rust clients are async and return Result<T> for all calls.

6.2. Documented Clients¶

• Router Client
• Registry Client
• Scheduler Client
• Activity Client
• Connector Client
• Reasoning Client
• Scheduler Policy Client
• Logging Client
• Handoff Client
• HITL Client
• Negotiation Client
• Negotiation Room Client
• Tool Client
• Workflow Client
• Workflow Engine
• Worktree Client
• Policy Store
• Shared Context Manager

6.3. Error Handling¶

• Exceptions Reference - Complete exception hierarchy and error codes
• Error Handling Patterns - Client-specific error handling strategies