cuenca 2.2.1__tar.gz → 2.2.2__tar.gz

{cuenca-2.2.1 → cuenca-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca
-Version: 2.2.1
+Version: 2.2.2
 Summary: Cuenca API Client
 Home-page: https://github.com/cuenca-mx/cuenca-python
 Author: Cuenca

{cuenca-2.2.1 → cuenca-2.2.2}/cuenca/__init__.py

@@ -1,5 +1,7 @@
 __all__ = [
     '__version__',
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -53,6 +55,8 @@ __all__ = [
 from . import http
 from .resources import (
     Account,
+    Agent,
+    AgentVerification,
     ApiKey,
     Arpc,
     BalanceEntry,

{cuenca-2.2.1 → cuenca-2.2.2}/cuenca/resources/__init__.py

@@ -1,4 +1,6 @@
 __all__ = [
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -47,6 +49,8 @@ __all__ = [
 ]
 
 from .accounts import Account
+from .agent_verifications import AgentVerification
+from .agents import Agent
 from .api_keys import ApiKey
 from .arpc import Arpc
 from .balance_entries import BalanceEntry
@@ -96,6 +100,8 @@ from .whatsapp_transfers import WhatsappTransfer
 
 # avoid circular imports
 resource_classes = [
+    Agent,
+    AgentVerification,
     ApiKey,
     Account,
     Arpc,

cuenca-2.2.2/cuenca/resources/agent_verifications.py

@@ -0,0 +1,37 @@
+import datetime as dt
+from typing import ClassVar
+
+from cuenca_validations.types.identities import PhoneNumber
+from pydantic import ConfigDict
+
+from ..http import Session, session as global_session
+from .base import Creatable
+
+
+class AgentVerification(Creatable):
+    _resource: ClassVar = 'agent_verifications'
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    phone_number: PhoneNumber
+    pairing_code: str
+    deactivated_at: dt.datetime
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AVjTtPH1mhT65GEgOeomJ4DQ',
+                'created_at': '2026-06-25T22:50:08.495768',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'phone_number': '+525512345678',
+                'pairing_code': 'OJC37W',
+                'deactivated_at': '2026-06-25T22:55:08.495779',
+            }
+        }
+    )
+
+    @classmethod
+    def create(cls, session: Session = global_session) -> 'AgentVerification':
+        return cls._create(session=session)

cuenca-2.2.2/cuenca/resources/agents.py

@@ -0,0 +1,52 @@
+import datetime as dt
+from typing import ClassVar, Optional
+
+from cuenca_validations.types import AgentQuery, AgentRequest, PhoneNumber
+from cuenca_validations.typing import DictStrAny
+from pydantic import ConfigDict, Field
+
+from ..http import Session, session as global_session
+from .base import Creatable, Queryable
+
+
+class Agent(Creatable, Queryable):
+    _resource: ClassVar = 'agents'
+    _query_params: ClassVar = AgentQuery
+
+    created_at: dt.datetime
+    user_id: str
+    platform_id: str
+    agent_verification_id: str
+    session_id: str
+    device_info: DictStrAny = Field(default_factory=dict)
+    deactivated_at: Optional[dt.datetime] = None
+
+    model_config = ConfigDict(
+        json_schema_extra={
+            'example': {
+                'id': 'AG1G6Bm0oGQOCRjTDaeFSsyA',
+                'created_at': '2026-06-27T01:56:42.613781',
+                'user_id': 'USMP3EPgI4T4CPFyVmXUPi8A',
+                'platform_id': 'PTZbBlk__kQt-wfwzP5nwA9A',
+                'agent_verification_id': 'AV7A1FLC7MSnqKcb7oAkiQxA',
+                'session_id': 'SSH0M5yteyRHas-PmfT9pu9w',
+                'device_info': {'client': 'cursor', 'os': 'macOS'},
+            }
+        }
+    )
+
+    @classmethod
+    def create(
+        cls,
+        pairing_code: str,
+        phone_number: PhoneNumber,
+        device_info: Optional[DictStrAny] = None,
+        *,
+        session: Session = global_session,
+    ) -> 'Agent':
+        req = AgentRequest(
+            pairing_code=pairing_code,
+            phone_number=phone_number,
+            device_info=device_info or {},
+        )
+        return cls._create(session=session, **req.model_dump())

{cuenca-2.2.1 → cuenca-2.2.2}/cuenca/version.py

@@ -1,3 +1,3 @@
-__version__ = '2.2.1'
+__version__ = '2.2.2'
 CLIENT_VERSION = __version__
 API_VERSION = '2020-03-19'

{cuenca-2.2.1 → cuenca-2.2.2}/cuenca.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cuenca
-Version: 2.2.1
+Version: 2.2.2
 Summary: Cuenca API Client
 Home-page: https://github.com/cuenca-mx/cuenca-python
 Author: Cuenca

{cuenca-2.2.1 → cuenca-2.2.2}/cuenca.egg-info/SOURCES.txt

@@ -16,6 +16,8 @@ cuenca/http/__init__.py
 cuenca/http/client.py
 cuenca/resources/__init__.py
 cuenca/resources/accounts.py
+cuenca/resources/agent_verifications.py
+cuenca/resources/agents.py
 cuenca/resources/api_keys.py
 cuenca/resources/arpc.py
 cuenca/resources/balance_entries.py
@@ -72,6 +74,7 @@ tests/http/conftest.py
 tests/http/test_client.py
 tests/resources/__init__.py
 tests/resources/test_accounts.py
+tests/resources/test_agents.py
 tests/resources/test_api_keys.py
 tests/resources/test_arpc.py
 tests/resources/test_balance_entries.py

cuenca-2.2.2/tests/resources/test_agents.py

@@ -0,0 +1,22 @@
+import pytest
+
+from cuenca.http.client import Session
+from cuenca.resources import Agent, AgentVerification
+
+
+@pytest.mark.vcr
+def test_agent_create():
+    verification = AgentVerification.create()  # Created by user in APP
+    agent_session = Session()
+    agent_session.configure(sandbox=True)
+    agent = Agent.create(
+        pairing_code=verification.pairing_code,
+        phone_number=verification.phone_number,
+        device_info={'client': 'cursor', 'os': 'macOS'},
+        session=agent_session,
+    )
+    assert agent.id
+    assert agent.agent_verification_id == verification.id
+    assert agent.session_id
+    assert agent.user_id
+    assert agent.platform_id