attp-client 0.0.1__py3-none-any.whl

attp_client-0.0.1.dist-info/METADATA

@@ -0,0 +1,278 @@
+Metadata-Version: 2.3
+Name: attp-client
+Version: 0.0.1
+Summary: A python-sdk client for interacting with AgentHub's ATTP protocol (Agent Tool Transport Protocol)
+License: MIT
+Author: Ascender Team
+Requires-Python: >=3.11,<3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: ascender-framework (>=2.0rc7,<3.0)
+Requires-Dist: attp-core (==0.1.10)
+Requires-Dist: msgpack (>=1.1.1,<2.0.0)
+Requires-Dist: pydantic (>=2.11.7,<3.0.0)
+Description-Content-Type: text/markdown
+
+# ATTP Client
+
+A Python SDK client for interacting with AgentHub's ATTP (Agent Tool Transport Protocol).
+
+## Overview
+
+The ATTP Client provides a comprehensive Python interface for connecting to and interacting with AgentHub's ATTP protocol. It enables real-time communication with AI agents, tool management, and inference operations through a high-performance async/await interface.
+
+## Features
+
+- **Async/Await Support**: Built with modern Python async patterns for optimal performance
+- **Agent Communication**: Direct communication with AI agents through the ATTP protocol
+- **Tool Management**: Register, unregister, and manage tools in organized catalogs
+- **Inference API**: Invoke AI agent inference with configurable parameters
+- **Real-time Messaging**: Stream responses and handle real-time agent interactions
+- **Event Handling**: Register custom event handlers for connect/disconnect and custom routes
+- **Authentication**: Secure token-based authentication with organization support
+
+## Installation
+
+```bash
+pip install attp-client
+```
+
+Or with Poetry:
+
+```bash
+poetry add attp-client
+```
+
+## Quick Start
+
+### Basic Connection
+
+```python
+import asyncio
+from attp_client.client import ATTPClient
+
+async def main():
+    # Initialize the client
+    client = ATTPClient(
+        agt_token="your_agent_token_here",
+        organization_id=1,
+        connection_url="attp://localhost:6563"  # Optional, defaults to localhost
+    )
+    
+    # Connect to AgentHub
+    await client.connect()
+    
+    # Your code here...
+    
+    # Close the connection
+    await client.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### Agent Inference
+
+```python
+from attp_client.interfaces.inference.message import IMessageDTOV2
+from attp_client.interfaces.inference.enums.message_type import MessageTypeEnum
+from uuid import UUID
+
+# Invoke inference by agent ID
+response = await client.inference.invoke_inference(
+    agent_id=17,
+    input_configuration={},
+    messages=[
+        IMessageDTOV2(
+            content="Hello, how can you help me?",
+            message_type=MessageTypeEnum.USER_MESSAGE,
+            chat_id=UUID("your-chat-id-here")
+        )
+    ],
+    stream=False,
+    timeout=30
+)
+
+print("Agent response:", response)
+```
+
+### Tool Management
+
+```python
+# Register a tool
+tool_id = await client.tools.register(
+    catalog_name="my_catalog",
+    name="example_tool",
+    description="An example tool for demonstration",
+    schema_id="tool_schema_v1",
+    return_direct=False,
+    timeout_ms=20000
+)
+
+# Access a specific catalog
+catalog = await client.catalog("my_catalog")
+
+# Unregister a tool
+await client.tools.unregister("my_catalog", str(tool_id))
+```
+
+### Event Handling
+
+```python
+def on_connect():
+    print("Connected to AgentHub!")
+
+def on_disconnect():
+    print("Disconnected from AgentHub!")
+
+def handle_custom_event(data):
+    print(f"Received custom event: {data}")
+
+# Register event handlers
+client.add_event_handler("", "connect", on_connect)
+client.add_event_handler("", "disconnect", on_disconnect)
+client.add_event_handler("custom:pattern", "custom", handle_custom_event)
+```
+
+## Configuration
+
+### Client Parameters
+
+- `agt_token` (str): Your AgentHub authentication token
+- `organization_id` (int): Your organization ID
+- `connection_url` (str, optional): ATTP server URL (default: "attp://localhost:6563")
+- `max_retries` (int, optional): Maximum connection retry attempts (default: 20)
+- `limits` (Limits, optional): Connection limits configuration
+- `logger` (Logger, optional): Custom logger instance
+
+### Connection Limits
+
+```python
+from attp_core.rs_api import Limits
+
+limits = Limits(max_payload_size=50000)
+client = ATTPClient(
+    agt_token="...",
+    organization_id=1,
+    limits=limits
+)
+```
+
+## API Reference
+
+### ATTPClient
+
+The main client class for ATTP communication.
+
+#### Methods
+
+- `connect()`: Establish connection to AgentHub
+- `close()`: Close the connection
+- `catalog(catalog_name: str)`: Access a specific tool catalog
+- `add_event_handler(pattern: str, route_type: RouteType, callback: Callable)`: Register event handlers
+
+#### Properties
+
+- `inference`: Access to the inference API
+- `tools`: Access to the tools manager
+- `router`: Access to the low-level router
+
+### AttpInferenceAPI
+
+Handles AI agent inference operations.
+
+#### Methods
+
+- `invoke_inference()`: Invoke inference for a specific agent
+- `invoke_chat_inference()`: Invoke inference for a chat session
+
+### ToolsManager
+
+Manages tool registration and organization.
+
+#### Methods
+
+- `register()`: Register a new tool
+- `unregister()`: Remove tool registration
+
+## Error Handling
+
+The client includes comprehensive error handling:
+
+```python
+from attp_client.errors import (
+    AttpException,
+    DeadSessionError,
+    NotFoundError,
+    SerializationError,
+    UnauthenticatedError
+)
+
+try:
+    await client.connect()
+except UnauthenticatedError:
+    print("Authentication failed - check your token")
+except DeadSessionError:
+    print("Session has died - reconnection required")
+except AttpException as e:
+    print(f"ATTP error: {e}")
+```
+
+## Requirements
+
+- Python 3.11 - 3.13
+- Dependencies:
+  - `pydantic` (>=2.11.7,<3.0.0)
+  - `attp-core` (==0.1.10)
+  - `msgpack` (>=1.1.1,<2.0.0)
+  - `ascender-framework` (>=2.0rc7,<3.0)
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/AscenderTeam/attp-client.git
+cd attp-client
+
+# Install dependencies
+poetry install
+
+# Run tests
+python -m pytest tests/
+```
+
+### Project Structure
+
+```
+src/
+├── attp_client/           # Main package
+│   ├── client.py         # Main client class
+│   ├── inference.py      # AI inference API
+│   ├── tools.py          # Tool management
+│   ├── catalog.py        # Catalog operations
+│   ├── router.py         # Message routing
+│   ├── session.py        # Session management
+│   ├── errors/           # Exception classes
+│   ├── interfaces/       # Protocol interfaces
+│   ├── misc/             # Utilities
+│   ├── types/            # Type definitions
+│   └── utils/            # Helper utilities
+└── tests/                # Test suite
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please use the GitHub Issues page or contact the Ascender Team.

attp_client-0.0.1.dist-info/RECORD

@@ -0,0 +1,33 @@
+attp_client/catalog.py,sha256=rStW3wveo09hiQOpq7XGlZtqd7dEjc96yowh1VCN78c,1799
+attp_client/client.py,sha256=aSjDaH1pHkmPsVZBwIrSIMX8QXDtbDfGpVBXR5KgnF4,3989
+attp_client/consts.py,sha256=6UZyqWddycOp-TKW5yvb0JW2fdfcS-J2xFVVNfuJQbU,18
+attp_client/errors/attp_exception.py,sha256=HePYyYMknS4t6tMrwU-p9L_LPdj1i7chntrlM53ueK4,347
+attp_client/errors/correlated_rpc_exception.py,sha256=GivYlF0rC4zxbEt5sMxc1cO-iGxIuiEjTy7knN_iur4,591
+attp_client/errors/dead_session.py,sha256=BI-EuTqxVP7j23wcD0GfhteyPsKR2xqUsMNm9SWXxNs,306
+attp_client/errors/not_found.py,sha256=Y-Y_Mki1hQYihJttvO0ugHFu9-73--1wqwdOomp2IEM,39
+attp_client/errors/serialization_error.py,sha256=Pa8PRzFJrrikA1Ikj0q-0euvXVUMb_qj-NRIp55SfOk,198
+attp_client/errors/unauthenticated_error.py,sha256=F0V1FjO0qVLMl6Y120y3AXKZnwb5iDD17c4GEMbL5aI,46
+attp_client/inference.py,sha256=wZ-iF-O8eWDn_YosW234ClnXFa7Gw7I73eD2ugmXvfU,4626
+attp_client/interfaces/catalogs/catalog.py,sha256=3PxlRwR3y2tbQVfXAkhDIv07AJPraMfH0c_pyi7Y6z8,146
+attp_client/interfaces/error.py,sha256=fIrk5XlAhMs6mbYQ5PzgwS0v-LIbtne3OlQue4CjWXs,139
+attp_client/interfaces/handshake/auth.py,sha256=lCbu4Mz50N7-XC5szQKht6xnw-d8pPQMeBviSPfRB2U,337
+attp_client/interfaces/handshake/hello.py,sha256=hlwWcvSpRebtnbS3lLBYmBm7AfHE4n6dp0ILgfqMUFU,680
+attp_client/interfaces/handshake/ready.py,sha256=0gEqwbvgRHkHb3FIn4YEyJ8LuzzP260ZMjRUCs2xFV0,446
+attp_client/interfaces/inference/enums/message_data_type.py,sha256=v68IW8DMyb-ezGnyR6T5kPE70FPDZ14AvCP2mI-iLPo,397
+attp_client/interfaces/inference/enums/message_emergency_type.py,sha256=8s6PONMUdNzrxVLM5aTAicdKSk6BsRFLujVUsm5jopM,149
+attp_client/interfaces/inference/enums/message_type.py,sha256=joo6t9vLDeupEtfE1II_-oW6Y_c9zSAGe0bl32TqAlA,508
+attp_client/interfaces/inference/message.py,sha256=IDaSVJOXzpjf26U4fQGVRvqPSlj2gKgIy_i4OIG7QAs,1589
+attp_client/interfaces/inference/tool.py,sha256=Oabb7w0HJtpyO-AcezmojdsJMGuLH4JHXft7h4mlyX8,134
+attp_client/interfaces/route_mappings.py,sha256=j6hEdkCP5xPpHS16EWmlkdTlnHa7z6e8ukbY-NolKcQ,416
+attp_client/misc/fixed_basemodel.py,sha256=0MTVmlTrA75Oxv0pVfLdXFTSp5AmBzgiNwvDiLFGF_w,1853
+attp_client/misc/serializable.py,sha256=tU08TsjiLiafAhU1jKd5BxajlHdEDcdKeEiKPqhMSTI,2102
+attp_client/router.py,sha256=UDHU2xsvTjgSIzMtV0jkPvOYK9R7GFjKfIrjjBHws-Q,4575
+attp_client/session.py,sha256=YDrd1KYmwKsZW6Xdkt6UprXZzGz6pFFSkk6O7XS6ZsA,11409
+attp_client/tools.py,sha256=stKrT8cAIIdIpiE8LhH3YPSGa7OsDux-mTeNsT294ng,1765
+attp_client/types/route_mapping.py,sha256=Kb9ZX88lqihRZr8IryfH1Vg_YAobW699Yjl6Raz1rdg,375
+attp_client/utils/context_awaiter.py,sha256=oCptu5g8mY43j5cr-W4fOe85OCCaqQI9r_Pn92NgZSY,1035
+attp_client/utils/route_mapper.py,sha256=uJNhKp6ipCSUxoiZS0Liix2lHOgUAnJM0kfgXWAh9RQ,554
+attp_client/utils/serializer.py,sha256=O1tWYbQS9jC9aus-ISKtliKCgGmOEIb9hxykVrmMKGY,636
+attp_client-0.0.1.dist-info/METADATA,sha256=3b74iG5sWjaUpDqeJwjrjJ-8meMF0YOcWGJpEhOiEOI,7137
+attp_client-0.0.1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+attp_client-0.0.1.dist-info/RECORD,,

attp_client-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.1.3
+Root-Is-Purelib: true
+Tag: py3-none-any