feat: Add support for sync operations

[anubhav756]

Overview

This PR introduces asynchronous support for the ToolboxClient by proxying new AsyncToolboxClient and AsyncToolboxTool classes that provide purely asynchronous interfaces. ToolboxClient and ToolboxTool classes act as wrappers around AsyncToolboxClient and AsyncToolboxTool respectively, providing both synchronous and asynchronous methods.

The synchronous methods are implemented by utilizing a dedicated background event loop running in a separate thread. When a synchronous method is called, it delegates the operation to the underlying AsyncToolboxClient or AsyncToolboxtool, using asyncio.run_coroutine_threadsafe and blocks until the result is available. This approach allows existing synchronous code to seamlessly interact with the new asynchronous capabilities.

Key changes:

• AsyncToolboxClient: A fully asynchronous interface for toolbox operations. This class is similar to the ToolboxClient class before this change. It adds the new async interfaces aload_tool and aload_toolset.
• AsyncToolboxTool: A fully asynchronous interface for toolbox tool invocations and validations. This class is similar to the ToolboxTool class before this change and implements the _arun method of LangChain's BaseTool.
• ToolboxClient: A wrapper class exposing both synchronous and asynchronous methods, delegating to AsyncToolboxClient under the hood.
• ToolboxTool: A wrapper class exposing both synchronous and asynchronous methods, delegating to AsyncToolboxTool under the hood.

Benefit

This approach allows us to modernize the Toolbox LangChain SDK while ensuring backward compatibility and providing users with the flexibility to choose between synchronous and asynchronous methods.

Diagram

Note

README updates are done in #16.