lybic-guiagents 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

gui_agents/tools/tools_config_cn.json

@@ -0,0 +1,101 @@
+{
+  "tools": [
+    {
+      "tool_name": "websearch",
+      "provider": "bocha",
+      "model_name": ""
+    },
+    {
+      "tool_name": "context_fusion",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "subtask_planner",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-250615"
+    },
+    {
+      "tool_name": "traj_reflector",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-250615"
+    },
+    {
+      "tool_name": "memory_retrival",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "grounding",
+      "provider": "doubao",
+      "model_name": "doubao-1-5-ui-tars-250428"
+    },
+    {
+      "tool_name": "evaluator",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "action_generator",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-250615",
+      "enable_search": false,
+      "search_provider": "bocha",
+      "search_model": ""
+    },
+    {
+      "tool_name": "action_generator_with_takeover",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-250615",
+      "enable_search": false,
+      "search_provider": "bocha",
+      "search_model": ""
+    },
+    {
+      "tool_name": "fast_action_generator",
+      "provider": "doubao",
+      "model_name": "doubao-1-5-ui-tars-250428",
+      "enable_search": false,
+      "search_provider": "bocha",
+      "search_model": ""
+    },
+    {
+      "tool_name": "fast_action_generator_with_takeover",
+      "provider": "doubao",
+      "model_name": "doubao-1-5-ui-tars-250428",
+      "enable_search": false,
+      "search_provider": "bocha",
+      "search_model": ""
+    },
+    {
+      "tool_name": "dag_translator",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-250615"
+    },
+    {
+      "tool_name": "embedding",
+      "provider": "doubao",
+      "model_name": "doubao-embedding-text-240715"
+    },
+    {
+      "tool_name": "query_formulator",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "narrative_summarization",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "text_span",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    },
+    {
+      "tool_name": "episode_summarization",
+      "provider": "doubao",
+      "model_name": "doubao-seed-1-6-flash-250615"
+    }
+  ]
+} 

gui_agents/tools/tools_config_en.json

@@ -0,0 +1,101 @@
+{
+  "tools": [
+    {
+      "tool_name": "websearch",
+      "provider": "exa",
+      "model_name": "exa-research"
+    },
+    {
+      "tool_name": "context_fusion",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "subtask_planner",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "traj_reflector",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "memory_retrival",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "grounding",
+      "provider": "doubao",
+      "model_name": "doubao-1-5-ui-tars-250428"
+    },
+    {
+      "tool_name": "evaluator",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "action_generator",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro",
+      "enable_search": false,
+      "search_provider": "exa",
+      "search_model": "exa-research"
+    },
+    {
+      "tool_name": "action_generator_with_takeover",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro",
+      "enable_search": false,
+      "search_provider": "exa",
+      "search_model": "exa-research"
+    },
+    {
+      "tool_name": "fast_action_generator",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro",
+      "enable_search": false,
+      "search_provider": "exa",
+      "search_model": "exa-research"
+    },
+    {
+      "tool_name": "fast_action_generator_with_takeover",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro",
+      "enable_search": false,
+      "search_provider": "exa",
+      "search_model": "exa-research"
+    },
+    {
+      "tool_name": "dag_translator",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "embedding",
+      "provider": "gemini",
+      "model_name": "text-embedding-004"
+    },
+    {
+      "tool_name": "query_formulator",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "narrative_summarization",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "text_span",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    },
+    {
+      "tool_name": "episode_summarization",
+      "provider": "gemini",
+      "model_name": "gemini-2.5-pro"
+    }
+  ]
+} 

{lybic_guiagents-0.2.2.dist-info → lybic_guiagents-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lybic-guiagents
-Version: 0.2.2
+Version: 0.2.3
 Summary: An open-source agentic framework that enables AI to use computers like humans and can provide a multi-agent runtime environment as an infrastructure capability
 Author: Lybic Development Team
 Author-email: Lybic Development Team <lybic@tingyutech.com>
@@ -23,13 +23,21 @@ Requires-Dist: boto3
 Requires-Dist: scikit-learn
 Requires-Dist: tiktoken
 Requires-Dist: pydantic
-Requires-Dist: lybic>=0.7.3
+Requires-Dist: lybic<1.0.0,>=0.8.0b2
+Requires-Dist: grpcio
+Requires-Dist: grpcio-tools>=1.71.2
 Requires-Dist: pyobjc; platform_system == "Darwin"
 Requires-Dist: oa_atomacos; platform_system == "Darwin"
 Requires-Dist: pywinauto; platform_system == "Windows"
 Requires-Dist: pywin32; platform_system == "Windows"
+Requires-Dist: pytest>=8.4.2
+Requires-Dist: protobuf>=5.29.5
+Requires-Dist: googleapis-common-protos>=1.70.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
+Provides-Extra: grpc
+Requires-Dist: grpcio; extra == "grpc"
+Requires-Dist: grpcio-tools>=1.71.2; extra == "grpc"
 Provides-Extra: vmware-and-evaluation
 Requires-Dist: python-pptx; extra == "vmware-and-evaluation"
 Requires-Dist: odfpy; extra == "vmware-and-evaluation"
@@ -148,6 +156,8 @@ Requires-Dist: pyobjc; platform_system == "Darwin" and extra == "all"
 Requires-Dist: oa_atomacos; platform_system == "Darwin" and extra == "all"
 Requires-Dist: pywinauto; platform_system == "Windows" and extra == "all"
 Requires-Dist: pywin32; platform_system == "Windows" and extra == "all"
+Requires-Dist: grpcio; extra == "all"
+Requires-Dist: grpcio-tools>=1.71.2; extra == "all"
 Dynamic: author
 Dynamic: license-file
 Dynamic: requires-python
@@ -372,6 +382,13 @@ python gui_agents/cli_app.py --backend pyautogui --mode fast
 > [!WARNING]
 > The agent will directly control your computer with `--backend pyautogui`. Please use with care.
 
+### Docker
+You can also run Lybic GUI Agent using Docker. This is an example of how to run it with the `lybic` backend:
+```sh
+docker run --rm -it --env-file gui_agents/.env agenticlybic/guiagent --backend lybic
+```
+> **Note**: This command starts the agent in interactive mode. The `--env-file` flag points to the environment file. Please ensure the path is correct.
+
 ### Lybic Sandbox Configuration
 
 The simplest way to configure Lybic Sandbox is still to edit the `.env` file and add your API keys, as mentioned in the [API Key Configuration](#api-key-configuration) section.
@@ -392,15 +409,19 @@ LYBIC_MAX_LIFE_SECONDS=3600
 
 ### Use as a service
 
-After installing lybic-guiagents, you can run it as a service.
+You can interact with the agent programmatically either by importing it as a Python library or by running it as a gRPC service.
+
+#### As a Python Library
+
+After installing `lybic-guiagents`, you can import and use its components directly in your Python code.
 
 Main Components:
-- AgentService: High-level service interface (recommended for most users)
-- AgentS2, AgentSFast: Core agent implementations  
-- HardwareInterface: Hardware abstraction layer
-- ServiceConfig: Configuration management
+- `AgentService`: High-level service interface (recommended for most users).
+- `AgentS2`, `AgentSFast`: Core agent implementations.
+- `HardwareInterface`: Hardware abstraction layer for controlling the GUI.
+- `ServiceConfig`: Configuration management.
 
-Quick Start:
+**Quick Start:**
 
 ```python
 from gui_agents import AgentService
@@ -409,6 +430,63 @@ result = service.execute_task("Take a screenshot")
 print(f"Task completed: {result.status}")
 ```
 
+#### As a gRPC Service
+
+You can also run the agent as a standalone gRPC service, which is ideal for distributed architectures or integrating with applications written in other languages.
+
+**1. Running the gRPC Server**
+
+First, run the gRPC server using Docker. This command overrides the default CLI entrypoint and starts the gRPC service on port 50051.
+
+```sh
+docker run --rm -it -p 50051:50051 --env-file gui_agents/.env agenticlybic/guiagent /app/.venv/bin/lybic-guiagent-grpc
+```
+> **Note**: The `-p 50051:50051` flag maps the container's gRPC port to your host machine.
+
+**2. Python Client Example**
+
+Once the service is running, you can interact with it using a gRPC client. Here is a Python example of how to send an instruction to the agent and stream its progress.
+
+First, ensure you have the necessary gRPC libraries and generated protobuf stubs:
+```sh
+# Install gRPC tools
+pip install grpcio grpcio-tools
+
+# Generate stubs from the .proto file
+python -m grpc_tools.protoc -Igui_agents/proto --python_out=gui_agents/proto/pb --grpc_python_out=gui_agents/proto/pb --pyi_out=gui_agents/proto/pb gui_agents/proto/agent.proto
+```
+
+Then, you can use the following script to communicate with the agent:
+
+```python
+import asyncio
+import grpc
+from gui_agents.proto.pb import agent_pb2, agent_pb2_grpc
+
+async def run_agent_instruction():
+    # Connect to the gRPC server
+    async with grpc.aio.insecure_channel('localhost:50051') as channel:
+        # Create a stub for the Agent service
+        stub = agent_pb2_grpc.AgentStub(channel)
+
+        # Create a request to run an instruction
+        request = agent_pb2.RunAgentInstructionRequest(
+            instruction="Open a calculator and compute 1 + 1"
+        )
+
+        print(f"Sending instruction: '{request.instruction}'")
+
+        # Call the RunAgentInstruction RPC and iterate over the stream of responses
+        try:
+            async for response in stub.RunAgentInstruction(request):
+                print(f"[{response.stage}] {response.message}")
+        except grpc.aio.AioRpcError as e:
+            print(f"An error occurred: {e.details()}")
+
+if __name__ == '__main__':
+    asyncio.run(run_agent_instruction())
+```
+
 ### VMware Configuration
 
 To use PyAutoGUI with VMware, you need to install [VMware Workstation Pro](https://www.vmware.com/products/desktop-hypervisor/workstation-and-fusion) (on Windows) and create a virtual machine. 

{lybic_guiagents-0.2.2.dist-info → lybic_guiagents-0.2.3.dist-info}/RECORD

@@ -51,31 +51,33 @@ desktop_env/providers/virtualbox/provider.py,sha256=kSWLSddLpn8IfeyAPyMEy_p5SOap
 desktop_env/providers/vmware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 desktop_env/providers/vmware/manager.py,sha256=pFqJwF6BAijmD-LbSei68-DU7ILCTONRj7e0At5iKIg,18893
 desktop_env/providers/vmware/provider.py,sha256=88ERND67KQIxG74b10sAXJ04o5FhNpx0d9pRTi8bHrA,4080
-gui_agents/__init__.py,sha256=lbM57x5ZeJ51oDtCLVie760uT3UUJAInHdeKksYQZ4c,1603
-gui_agents/cli_app.py,sha256=M8zO24xPTD4WDuLgnSqSjJ6VA3SFq0-qyLncizh6D04,29046
+gui_agents/__init__.py,sha256=Gv3YvOee6_8RentnSfQawXZWy2h9XaYFPtbhfSVJjgI,1603
+gui_agents/cli_app.py,sha256=Zwf8H9gl31Q-IwKFMKzDTudsCOtmDK7VVIVSFqIAPh8,30289
+gui_agents/grpc_app.py,sha256=j_TPshxIzIA1PMbkBKH_7VfTjbg4hLquGGMjB0dmEec,37088
 gui_agents/agents/Action.py,sha256=aEqkrNtb5TWn5i5nkMBWTN56_9tbfRPEGw2SgkFYKeY,6197
 gui_agents/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gui_agents/agents/agent_s.py,sha256=LUxLENjuHRrgycfzKjYmyZXmd5Xv3XHPAWy6g9_BvoE,34322
+gui_agents/agents/agent_s.py,sha256=VwrkISbQcKGp9joDTb4BW2MDK810WfUFZSmpZJjaeEc,45795
 gui_agents/agents/global_state.py,sha256=BS6tUeK9Z3CdUIeU0gcEjzVnc_s7naeKQsCoIQLp23g,22314
-gui_agents/agents/grounding.py,sha256=9BGp_emVAODZgberH2IqgjVCCNDx-eUNbe1mdnUt7ZA,22764
+gui_agents/agents/grounding.py,sha256=bOy9V19Z_SO-hbUqg5h6Ru7E4k9YDGiXsQ_RArGuolg,25262
 gui_agents/agents/hardware_interface.py,sha256=32auvpVwJ-DimTTCDguM49DEBR4JeFCeHx41Bgv3Svg,5332
-gui_agents/agents/manager.py,sha256=I00ycDd8cBwXm6tJAzkTEccDE0P_R04ZAjn0uXGySY0,24030
+gui_agents/agents/manager.py,sha256=44E5fTELymcSMBBUUzG7y2ntcT-DL5yA0OoZnTIq2v8,28861
+gui_agents/agents/stream_manager.py,sha256=FxkM5GtTI4mFRd5rmuvoLSaC2NINVsSfhhREw3VlmUA,6704
 gui_agents/agents/translator.py,sha256=WwWY1ffs2OQuh65DSVjWpfpettJVdmmCI-w92K0JeHg,5171
-gui_agents/agents/worker.py,sha256=QO8pPh7YtGYZc8E5I1ACGHXzRELNnchpusK6tVNAxWA,15297
+gui_agents/agents/worker.py,sha256=OTvrnnV_b28DmmIp3E9s8hZ6o3LlWcsV19FLSddTl08,17962
 gui_agents/agents/Backend/ADBBackend.py,sha256=J8WeFFLEPh05FmFKuGz72wgcKdKQT9kLUCHyEb8mRkk,2151
 gui_agents/agents/Backend/Backend.py,sha256=Aou3gBfur0AqL_bMn9FFeLTBM4CfL5aiIRivjqaB6zk,978
-gui_agents/agents/Backend/LybicBackend.py,sha256=A5QG4P3QAcAQO-MM7jmKU4zr5s98KReysCuQIHUU7Ec,13166
+gui_agents/agents/Backend/LybicBackend.py,sha256=mDjvP3Rx1cjuWkFN0X9QiWWeqBnfepUHGwDIsCmI_As,14069
 gui_agents/agents/Backend/PyAutoGUIBackend.py,sha256=KX6_cB0sW_sNAcqYhnzQ6ksMJ1cDPK1OWRXet26qg_8,6064
 gui_agents/agents/Backend/PyAutoGUIVMwareBackend.py,sha256=_AEKf4qU5EiKIDOD64bicEwiGnjp-wsX5Q14v9e79M4,9910
 gui_agents/agents/Backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gui_agents/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gui_agents/core/engine.py,sha256=_KbY4BkJ_CsAaIDSUkGK8JQ7hLG3GZ2Cn-pT5xzIPj0,54561
-gui_agents/core/knowledge.py,sha256=vAyp3JZz2bWKCN6leWDO5FjF1pdLHgXp5EDxuUSjVro,18181
+gui_agents/core/knowledge.py,sha256=PpAf09E1N3fIFK2dPkM-XnxdcxKAhyvezvMYHsjDbXE,19879
 gui_agents/core/mllm.py,sha256=k3BIILmb7eaNBu_pXQaD5cRpVBGkrLVQqkxQzzseZdo,21191
-gui_agents/lybic_client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gui_agents/lybic_client/lybic_client.py,sha256=E9_TRtQChEkFGe74J4HrkapVaFCG0TkjxeW9z0Je--s,2994
 gui_agents/prompts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gui_agents/prompts/prompts.py,sha256=w9ZP4FhuBDzWP7J0Urn69woLhas9AIWTtNfC1tys59c,67050
+gui_agents/proto/__init__.py,sha256=_PORrnlylDiijb0s_soqgb1REm1eqXOtSmo0Oah4KRM,85
+gui_agents/proto/pb/__init__.py,sha256=UbJYRSLmdZrc2F6ou4dkvgGb4Y0YDObcwftmJCE3fC0,96
 gui_agents/service/__init__.py,sha256=5WsJ0Mx3e5BAP9qQMhoVimhOgTIndGeVcasGNoo1s-c,518
 gui_agents/service/agent_service.py,sha256=ZAPQjO76GRP7P0n_prU76NK5d7fzHk1pqLJ7a9rHt-Q,20969
 gui_agents/service/api_models.py,sha256=06iFyaV6ttROsNiS2GnAAaB4kR1XNpSRuUHD2W60L8o,3949
@@ -84,7 +86,11 @@ gui_agents/service/exceptions.py,sha256=Tk3U4eycX-wuAqR0B-TthBESKyu8KuwH5Ksng0v4
 gui_agents/store/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gui_agents/store/registry.py,sha256=KWySYUlRA5SGubqqCgOu5Lk7PvBIQQ4cEZmHoNwKzVQ,615
 gui_agents/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gui_agents/tools/tools.py,sha256=vv6jlgUUXyop86GwiVzQYxccTCaH7ErQcjDXX3-l5yM,27555
+gui_agents/tools/model.md,sha256=xeEuG3sBFu5j614V6alVk7l7JZmEewLniEg1hh7qA6Y,5553
+gui_agents/tools/tools.py,sha256=mPWed16cbGvje49M405qi0WVHh1qNxQkW5ojLz9Ac9Y,30785
+gui_agents/tools/tools_config.json,sha256=cXhrCMvj-ktI77CAblkX_5dujVg29p2rZovjTW2zvx8,2552
+gui_agents/tools/tools_config_cn.json,sha256=ChRIbIK-QF4QLeOR2b8hO_VwRVvTWAC-T2RhzPy45cA,2546
+gui_agents/tools/tools_config_en.json,sha256=2jjQFGJAOdn9qjddcfwAtyDkaj2pOtOtF4LuNWn_F60,2426
 gui_agents/unit_test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gui_agents/unit_test/run_tests.py,sha256=HuByLtSZ1TXbn_QWduA51L4BYcv_oM6ctGcyWcoqPq8,1773
 gui_agents/unit_test/test_manager.py,sha256=Tj_jPtjL4xtEA37Cjn-48qBPqdj0K2Gup0tW17kdGeY,13539
@@ -95,8 +101,9 @@ gui_agents/utils/common_utils.py,sha256=lfWg7SrGfEnu9ZS9AWP3GKhbeTbaSZ6F9oh6U_qC
 gui_agents/utils/display_viewer.py,sha256=hL6Pf-wpoQrrYeOi6eaGnCorkAvGWNzkLIuM9yIudnk,8731
 gui_agents/utils/embedding_manager.py,sha256=7QFITe9l0z8OKHT-yqx-BGwVMj4BRL2iJ13PgJ2-Yak,2117
 gui_agents/utils/image_axis_utils.py,sha256=z21cVAE2ZOK1DR7wK10JHg8aZapkX2oGI6D93pKZEao,878
-lybic_guiagents-0.2.2.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
-lybic_guiagents-0.2.2.dist-info/METADATA,sha256=ZVhQC9zXiTIR0rNRRoz2Gr8RyPcvs8fDjvyFYiEA2HU,20655
-lybic_guiagents-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lybic_guiagents-0.2.2.dist-info/top_level.txt,sha256=NFP1jNNbbEGUexavwh7g0z_23hahrdgEV_9AjdynSw0,23
-lybic_guiagents-0.2.2.dist-info/RECORD,,
+lybic_guiagents-0.2.3.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+lybic_guiagents-0.2.3.dist-info/METADATA,sha256=lza969_FxsoPQ5n6JWVI6ZOeIPt_kgVGnr6qhS5qXjk,23821
+lybic_guiagents-0.2.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lybic_guiagents-0.2.3.dist-info/entry_points.txt,sha256=n8OTYmXL0QPhSFUz-StUmhf0cpdL7Qcaeg5BWe7MiL4,106
+lybic_guiagents-0.2.3.dist-info/top_level.txt,sha256=NFP1jNNbbEGUexavwh7g0z_23hahrdgEV_9AjdynSw0,23
+lybic_guiagents-0.2.3.dist-info/RECORD,,

lybic_guiagents-0.2.3.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+lybic-guiagent = gui_agents.cli_app:main
+lybic-guiagent-grpc = gui_agents.grpc_app:main

gui_agents/lybic_client/lybic_client.py

@@ -1,88 +0,0 @@
-import httpx
-from typing import Optional, Dict, Any
-
-class LybicClient:
-    """Light-weight async wrapper for Lybic REST API."""
-
-    # ---------- life-cycle ----------
-    def __init__(self, api_key: str, base_url: str, org_id: str) -> None:
-        self.base     = base_url.rstrip("/")
-        self.org_id   = org_id
-        self.http     = httpx.AsyncClient(
-            headers={"X-Api-Key": api_key, "Content-Type": "application/json"},
-            timeout=30,
-        )
-
-        # runtime cache (set by create_sandbox)
-        self.sandbox: Optional[Dict[str, Any]] = None
-        # self.connect_details: Optional[Dict[str, Any]] = None
-
-    async def close(self) -> None:
-        await self.http.aclose()
-
-    # ---------- low-level ----------
-    async def _req(self, path: str, method: str = "GET", json: Any = None):
-        r = await self.http.request(method, f"{self.base}{path}", json=json)
-        # ▶ 打印调试信息
-        req = r.request                        # httpx.Request 对象
-        print(
-            "[HTTP]", req.method, req.url,     # 完整 URL（含 querystring）
-            "json=",   json,
-            "status=", r.status_code,
-        )
-
-        r.raise_for_status()
-        return r.json()
-
-    # ---------- high-level ----------
-    async def create_sandbox(self, **opts) -> Dict[str, Any]:
-        """
-        Create a new sandbox and cache its metadata / connectDetails.
-        Returns the full response dict.
-        """
-        resp = await self._req(
-            f"/api/orgs/{self.org_id}/sandboxes", "POST", opts or {}
-        )
-
-        # cache
-        self.sandbox          = resp
-        # self.connect_details  = resp.get("connectDetails")
-        return resp
-
-    def _require_sandbox_id(self, sid: Optional[str]) -> str:
-        if sid:
-            return sid
-        if self.sandbox:
-            return self.sandbox["id"]
-        raise RuntimeError("No sandbox_id specified and none cached — "
-                           "call create_sandbox() first.")
-
-    async def preview(self, sid: Optional[str] = None):
-        sid = self._require_sandbox_id(sid)
-        return await self._req(
-            f"/api/orgs/{self.org_id}/sandboxes/{sid}/preview", "POST"
-        )
-
-    async def exec_action(self, action: dict, sid: Optional[str] = None):
-        """
-        Execute a single GUI action. `sid` optional if sandbox already cached.
-        """
-        sid = self._require_sandbox_id(sid)
-        return await self._req(
-            f"/api/orgs/{self.org_id}/sandboxes/{sid}/actions/computer-use",
-            "POST",
-            {"action": action},
-        )
-
-    async def parse_nl(self, text: str, model: str = "ui-tars"):
-        return await self._req(
-            "/api/computer-use/parse",
-            "POST",
-            {"model": model, "textContent": text},
-        )
-
-    # ---------- helpers ----------
-    @property
-    def sandbox_id(self) -> Optional[str]:
-        return self.sandbox["id"] if self.sandbox else None
-