kl-mcp-client 2.1.3__py3-none-any.whl → 2.1.7__py3-none-any.whl

kl_mcp_client/asyncio/tools.py

@@ -319,3 +319,35 @@ class MCPTools:
                 "key": key,
             },
         )
+    
+    # ======================================================
+    # BROWSER RUNTIME (NO SESSION)
+    # ======================================================
+
+    async def create_browser(
+        self,
+        payload: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        """
+        Start browser runtime (idempotent).
+        - KHÔNG tạo session
+        - Dùng cho warm-up / admin / scheduler
+
+        payload: ThirdPartyOpenRequest (optional)
+        """
+        res = await self.client.call_tool(
+            "create_browser",
+            payload or {},
+        )
+        return res.get("structuredContent", {})
+
+    async def release_browser(self) -> Dict[str, Any]:
+        """
+        Release / stop browser runtime.
+        - KHÔNG cần payload
+        """
+        res = await self.client.call_tool(
+            "release_browser",
+            {},
+        )
+        return res.get("structuredContent", {})

kl_mcp_client/tools.py

@@ -422,3 +422,166 @@ class MCPTools:
             offset += chunkSize
 
         return items
+
+    @_ensure_client
+    def wait_for_selector(
+        self, sessionId: str, selector: str, timeoutMs: Optional[int] = None
+    ) -> Dict[str, Any]:
+        args = {
+            "sessionId": sessionId,
+            "selector": selector,
+        }
+        if timeoutMs is not None:
+            args["timeout"] = int(timeoutMs)
+
+        return self.client.call_tool("waitForSelector", args).get(
+            "structuredContent", {}
+        )
+
+    @_ensure_client
+    def send_keys(
+        self, sessionId: str, key: str, interval: int = 100
+    ) -> Dict[str, Any]:
+        """
+        Gửi phím: enter, tab, esc, ctrl+c, ctrl+shift+tab, ...
+        """
+        return self.client.call_tool(
+            "sendKeys",
+            {"sessionId": sessionId, "text": key, "interval": interval},
+        ).get("structuredContent", {})
+
+    @_ensure_client
+    def perform(
+        self,
+        sessionId: str,
+        action: str,
+        target: Optional[str] = None,
+        value: Optional[str] = None,
+        x: Optional[float] = None,
+        y: Optional[float] = None,
+        from_point: Optional[dict] = None,
+        to_point: Optional[dict] = None,
+    ) -> Dict[str, Any]:
+        """
+        action:
+        - click (x,y)
+        - move / hover (x,y)
+        - drag (from -> to)
+        - type (target, value)
+        """
+        args = {
+            "sessionId": sessionId,
+            "action": action,
+        }
+
+        if target is not None:
+            args["target"] = target
+        if value is not None:
+            args["value"] = value
+        if x is not None:
+            args["x"] = float(x)
+        if y is not None:
+            args["y"] = float(y)
+        if from_point is not None:
+            args["from"] = from_point
+        if to_point is not None:
+            args["to"] = to_point
+
+        return self.client.call_tool("perform", args).get("structuredContent", {})
+
+    @_ensure_client
+    def drag_and_drop(
+        self,
+        sessionId: str,
+        from_x: float,
+        from_y: float,
+        to_x: float,
+        to_y: float,
+    ):
+        return self.perform(
+            sessionId=sessionId,
+            action="drag",
+            from_point={"x": from_x, "y": from_y},
+            to_point={"x": to_x, "y": to_y},
+        )
+
+    def hover(self, sessionId: str, x: float, y: float):
+        return self.perform(
+            sessionId=sessionId,
+            action="hover",
+            x=x,
+            y=y,
+        )
+
+    @_ensure_client
+    def scroll(
+        self,
+        sessionId: str,
+        *,
+        x: Optional[float] = None,
+        y: Optional[float] = None,
+        selector: Optional[str] = None,
+        position: Optional[str] = None,  # "top" | "bottom"
+    ) -> Dict[str, Any]:
+        """
+        Scroll trang web.
+
+        Cách dùng:
+        - Scroll theo pixel:
+            scroll(sessionId, y=500)
+        - Scroll tới element:
+            scroll(sessionId, selector="#footer")
+        - Scroll top / bottom:
+            scroll(sessionId, position="top")
+            scroll(sessionId, position="bottom")
+        """
+
+        args: Dict[str, Any] = {
+            "sessionId": sessionId,
+        }
+
+        if x is not None:
+            args["x"] = float(x)
+        if y is not None:
+            args["y"] = float(y)
+        if selector is not None:
+            args["selector"] = selector
+        if position is not None:
+            args["position"] = position
+
+        if len(args) == 1:
+            return {
+                "ok": False,
+                "error": "scroll requires x/y or selector or position",
+            }
+
+        return self.client.call_tool(
+            "scroll",
+            args,
+        ).get("structuredContent", {})
+        # ======================================================
+    # BROWSER RUNTIME (NO SESSION)
+    # ======================================================
+    @_ensure_client
+    def create_browser(self, payload: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """
+        Start browser runtime (idempotent).
+        Không tạo session, chỉ đảm bảo browser đang RUNNING.
+
+        payload: map cho ThirdPartyOpenRequest
+        """
+        return self.client.call_tool(
+            "create_browser",
+            payload or {},
+        ).get("structuredContent", {})
+
+    @_ensure_client
+    def release_browser(self) -> Dict[str, Any]:
+        """
+        Release / stop browser runtime.
+        Không cần payload.
+        """
+        return self.client.call_tool(
+            "release_browser",
+            {},
+        ).get("structuredContent", {})

{kl_mcp_client-2.1.3.dist-info → kl_mcp_client-2.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kl-mcp-client
-Version: 2.1.3
+Version: 2.1.7
 Summary: MCP Client for Python
 Author-email: Kyle <hngan.it@gmail.com>
 License: MIT

kl_mcp_client-2.1.7.dist-info/RECORD

@@ -0,0 +1,11 @@
+kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
+kl_mcp_client/__version__.py,sha256=CCYQUt19bi0kfo0Q8q8snnwgw_c9F3s6FFxTMsX1yDE,22
+kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
+kl_mcp_client/tools.py,sha256=kEkeG75SUUostCR5gRjLIjJzHg6-iWzXakjf3nvgXKk,18733
+kl_mcp_client/asyncio/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
+kl_mcp_client/asyncio/client.py,sha256=5CpPf1YGOTzYfbG1mAK9s-vhKQULjdlSJnhXm3Th-1s,4413
+kl_mcp_client/asyncio/tools.py,sha256=ayOqGYoiQ0q15xXz_7sKFq9UzUAqaOG0Uscy6uyvErM,11992
+kl_mcp_client-2.1.7.dist-info/METADATA,sha256=llO4qCoOWzHHF-n2opsj-bRUfdoiIDcbl1Nlb9qGkdw,4443
+kl_mcp_client-2.1.7.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+kl_mcp_client-2.1.7.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
+kl_mcp_client-2.1.7.dist-info/RECORD,,

{kl_mcp_client-2.1.3.dist-info → kl_mcp_client-2.1.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

kl_mcp_client-2.1.3.dist-info/RECORD

@@ -1,11 +0,0 @@
-kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
-kl_mcp_client/__version__.py,sha256=CCYQUt19bi0kfo0Q8q8snnwgw_c9F3s6FFxTMsX1yDE,22
-kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
-kl_mcp_client/tools.py,sha256=SRt4Ypi6izGOEl2BJiY4l4DW_Yd2GJjbjOXa-vBRKhw,14137
-kl_mcp_client/asyncio/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
-kl_mcp_client/asyncio/client.py,sha256=5CpPf1YGOTzYfbG1mAK9s-vhKQULjdlSJnhXm3Th-1s,4413
-kl_mcp_client/asyncio/tools.py,sha256=2rXnmVVCgqRyM30ULN-7tCUARwHg9rbuTyrR-p5O4_Y,11055
-kl_mcp_client-2.1.3.dist-info/METADATA,sha256=WzjSU7IGTITVAQ9ri7LnIGPF6sJTLmm3LGJ0CyytD8g,4443
-kl_mcp_client-2.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kl_mcp_client-2.1.3.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
-kl_mcp_client-2.1.3.dist-info/RECORD,,