resources

Author: rogelioLpz

cuenca/__init__.py

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

cuenca/resources/__init__.py

@@ -1,4 +1,6 @@
 __all__ = [
+    'Agent',
+    'AgentVerification',
     'ApiKey',
     'Account',
     'Arpc',
@@ -47,6 +49,8 @@
 ]
 
 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 @@
 
 # avoid circular imports
 resource_classes = [
+    Agent,
+    AgentVerification,
     ApiKey,
     Account,
     Arpc,

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/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/version.py

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

requirements.txt

@@ -1,3 +1,3 @@
 requests==2.32.3
-cuenca-validations==2.1.34
+cuenca-validations==2.1.39.dev4
 pydantic-extra-types==2.10.2