anywhere-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anywhere-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Local runtime connector for Agents Anywhere
 Requires-Python: >=3.12
 Requires-Dist: claude-agent-sdk
@@ -10,6 +10,7 @@ Requires-Dist: pexpect>=4.9.0; sys_platform != 'win32'
 Requires-Dist: ptyprocess>=0.7.0; sys_platform != 'win32'
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyte>=0.8.2
+Requires-Dist: python-socks>=2.8.1
 Requires-Dist: pywinpty>=2.0.13; sys_platform == 'win32'
 Requires-Dist: websockets>=16.0
 Description-Content-Type: text/markdown

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/connector/cli.py

@@ -6,6 +6,7 @@ import os
 import sys
 import time
 from pathlib import Path
+from urllib.parse import urlparse
 
 import httpx
 
@@ -16,21 +17,41 @@ def main(argv: list[str] | None = None) -> None:
     parser = _build_parser()
     args = parser.parse_args(argv)
     try:
-        if args.command == "login":
-            asyncio.run(_login(args))
+        if args.command in {"pair", "login"}:
+            asyncio.run(_pair(args))
         elif args.command == "configure":
             _configure(args)
         elif args.command == "start":
             asyncio.run(_start(args))
         else:
             parser.print_help()
+    except CliError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        raise SystemExit(2) from None
+    except httpx.TimeoutException as exc:
+        print(f"error: request timed out: {exc.request.url if exc.request else exc}", file=sys.stderr)
+        raise SystemExit(2) from None
+    except httpx.HTTPStatusError as exc:
+        detail = _response_detail(exc.response)
+        print(f"error: server returned HTTP {exc.response.status_code}: {detail}", file=sys.stderr)
+        raise SystemExit(2) from None
+    except httpx.RequestError as exc:
+        print(f"error: cannot reach server: {exc}", file=sys.stderr)
+        raise SystemExit(2) from None
+    except (TimeoutError, RuntimeError, ValueError) as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        raise SystemExit(2) from None
     except KeyboardInterrupt:
         raise SystemExit(130) from None
 
 
+class CliError(RuntimeError):
+    pass
+
+
 def _build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(prog="anywhere-cli", description="Agent Server Codex connector CLI")
-    subparsers = parser.add_subparsers(dest="command")
+    subparsers = parser.add_subparsers(dest="command", metavar="{start,pair,configure}")
 
     start = subparsers.add_parser("start", help="start the connector")
     _add_config_args(start)
@@ -38,12 +59,12 @@ def _build_parser() -> argparse.ArgumentParser:
     start.add_argument("--connector-id", help="connector id")
     start.add_argument("--connector-token", help="connector token")
 
-    login = subparsers.add_parser("login", help="pair with a backend, save credentials, and start the connector")
-    _add_config_args(login)
-    login.add_argument("--server-url", required=True, help="backend server URL")
-    login.add_argument("--poll-interval", type=float, default=2, help="seconds between pairing polls")
-    login.add_argument("--timeout", type=float, default=600, help="pairing timeout in seconds")
-    login.add_argument("--no-start", action="store_true", help="save credentials without starting the connector")
+    pair = subparsers.add_parser(
+        "pair",
+        aliases=["login"],
+        help="pair with a backend, save credentials, and start the connector",
+    )
+    _add_pair_args(pair)
 
     configure = subparsers.add_parser("configure", help="save connector credentials to local JSON")
     _add_config_args(configure)
@@ -61,13 +82,22 @@ def _add_config_args(parser: argparse.ArgumentParser) -> None:
     )
 
 
+def _add_pair_args(parser: argparse.ArgumentParser) -> None:
+    _add_config_args(parser)
+    parser.add_argument("server", nargs="?", help="backend server URL, for example anywhere.com or https://api.anywhere.com")
+    parser.add_argument("--server-url", help="backend server URL (deprecated; use positional server)")
+    parser.add_argument("--poll-interval", type=float, default=2, help="seconds between pairing polls")
+    parser.add_argument("--timeout", type=float, default=600, help="pairing timeout in seconds")
+    parser.add_argument("--no-start", action="store_true", help="save credentials without starting the connector")
+
+
 async def _start(args: argparse.Namespace) -> None:
     config = _resolve_config(args)
     await BackendRpcClient(config).run_forever()
 
 
-async def _login(args: argparse.Namespace) -> None:
-    server_url = args.server_url.rstrip("/")
+async def _pair(args: argparse.Namespace) -> None:
+    server_url = await _resolve_server_url_for_pair(args.server or args.server_url, timeout=10)
     async with httpx.AsyncClient(timeout=30) as client:
         start_response = await client.post(
             f"{server_url}/pairing/start",
@@ -109,6 +139,35 @@ async def _login(args: argparse.Namespace) -> None:
     raise TimeoutError("pairing timed out")
 
 
+async def _resolve_server_url_for_pair(value: str | None, *, timeout: float = 10) -> str:
+    if not value:
+        raise CliError("missing server address. Usage: anywhere-cli pair <server>")
+    normalized = value.strip().rstrip("/")
+    if not normalized:
+        raise CliError("missing server address. Usage: anywhere-cli pair <server>")
+
+    parsed = urlparse(normalized)
+    if parsed.scheme:
+        if parsed.scheme in {"http", "https"}:
+            return normalized
+        if "://" in normalized:
+            raise CliError("server URL must use http or https")
+
+    candidates = [f"https://{normalized}", f"http://{normalized}"]
+    errors: list[str] = []
+    for candidate in candidates:
+        try:
+            async with httpx.AsyncClient(timeout=timeout) as client:
+                response = await client.get(f"{candidate}/health")
+                if response.status_code < 500:
+                    return candidate
+                errors.append(f"{candidate}: HTTP {response.status_code}")
+        except httpx.RequestError as exc:
+            errors.append(f"{candidate}: {exc}")
+    joined = "; ".join(errors)
+    raise CliError(f"could not reach server over https or http ({joined})")
+
+
 def _configure(args: argparse.Namespace) -> None:
     config = ConnectorConfig(
         server_url=args.server_url.rstrip("/"),
@@ -142,7 +201,19 @@ def _resolve_config(args: argparse.Namespace) -> ConnectorConfig:
     if not connector_token:
         missing.append("--connector-token")
     missing.append(f"or config file {config_path}")
-    raise SystemExit("missing connector credentials: " + ", ".join(missing))
+    raise CliError("missing connector credentials: " + ", ".join(missing))
+
+
+def _response_detail(response: httpx.Response) -> str:
+    try:
+        payload = response.json()
+    except ValueError:
+        text = response.text.strip()
+        return text[:300] if text else response.reason_phrase
+    if isinstance(payload, dict):
+        detail = payload.get("detail") or payload.get("message") or payload
+        return str(detail)
+    return str(payload)
 
 
 if __name__ == "__main__":

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anywhere-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Local runtime connector for Agents Anywhere"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -12,6 +12,7 @@ dependencies = [
     "ptyprocess>=0.7.0; sys_platform != 'win32'",
     "pydantic>=2.0.0",
     "pyte>=0.8.2",
+    "python-socks>=2.8.1",
     "pywinpty>=2.0.13; sys_platform == 'win32'",
     "websockets>=16.0",
 ]

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/tests/test_claude_sdk_adapter.py

@@ -414,7 +414,6 @@ async def test_claude_sdk_adapter_streams_timeline_and_updates_external_session(
             "mediaType": "text/plain",
             "size": 12,
             "sha256": "abc",
-            "downloadUrl": "/sessions/sess_1/attachments/file_1",
         }
     ]
     assert timeline[2]["id"].startswith("claude_msg_")

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/tests/test_connector_cli.py

@@ -46,6 +46,30 @@ class FakeHttpClient:
         raise AssertionError(f"unexpected url: {url}")
 
 
+class FakeProbeResponse:
+    def __init__(self, status_code: int) -> None:
+        self.status_code = status_code
+
+
+class FakeFallbackHttpClient:
+    calls: list[str] = []
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        return None
+
+    async def __aenter__(self) -> FakeFallbackHttpClient:
+        return self
+
+    async def __aexit__(self, *args: Any) -> None:
+        return None
+
+    async def get(self, url: str) -> FakeProbeResponse:
+        self.calls.append(url)
+        if url.startswith("https://"):
+            raise cli_module.httpx.ConnectError("tls failed")
+        return FakeProbeResponse(200)
+
+
 class FakeBackendRpcClient:
     started_configs: list[ConnectorConfig] = []
 
@@ -56,7 +80,7 @@ class FakeBackendRpcClient:
         self.started_configs.append(self.config)
 
 
-def test_login_starts_connector_after_saving_credentials(monkeypatch, tmp_path) -> None:
+def test_pair_starts_connector_after_saving_credentials(monkeypatch, tmp_path) -> None:
     config_path = tmp_path / "connector.json"
     FakeBackendRpcClient.started_configs = []
     monkeypatch.setattr(cli_module.httpx, "AsyncClient", FakeHttpClient)
@@ -64,8 +88,7 @@ def test_login_starts_connector_after_saving_credentials(monkeypatch, tmp_path)
 
     args = cli_module._build_parser().parse_args(
         [
-            "login",
-            "--server-url",
+            "pair",
             "http://127.0.0.1:8000",
             "--config",
             str(config_path),
@@ -73,14 +96,14 @@ def test_login_starts_connector_after_saving_credentials(monkeypatch, tmp_path)
             "0",
         ]
     )
-    asyncio.run(cli_module._login(args))
+    asyncio.run(cli_module._pair(args))
 
     loaded = ConnectorConfig.load(config_path)
     assert loaded.connector_id == "conn_1"
     assert [config.connector_id for config in FakeBackendRpcClient.started_configs] == ["conn_1"]
 
 
-def test_login_no_start_only_saves_credentials(monkeypatch, tmp_path) -> None:
+def test_pair_no_start_only_saves_credentials(monkeypatch, tmp_path) -> None:
     config_path = tmp_path / "connector.json"
     FakeBackendRpcClient.started_configs = []
     monkeypatch.setattr(cli_module.httpx, "AsyncClient", FakeHttpClient)
@@ -88,8 +111,7 @@ def test_login_no_start_only_saves_credentials(monkeypatch, tmp_path) -> None:
 
     args = cli_module._build_parser().parse_args(
         [
-            "login",
-            "--server-url",
+            "pair",
             "http://127.0.0.1:8000",
             "--config",
             str(config_path),
@@ -98,7 +120,51 @@ def test_login_no_start_only_saves_credentials(monkeypatch, tmp_path) -> None:
             "--no-start",
         ]
     )
-    asyncio.run(cli_module._login(args))
+    asyncio.run(cli_module._pair(args))
 
     assert ConnectorConfig.load(config_path).connector_token == "cxt_secret"
     assert FakeBackendRpcClient.started_configs == []
+
+
+def test_pair_accepts_legacy_server_url_flag(monkeypatch, tmp_path) -> None:
+    config_path = tmp_path / "connector.json"
+    FakeBackendRpcClient.started_configs = []
+    monkeypatch.setattr(cli_module.httpx, "AsyncClient", FakeHttpClient)
+    monkeypatch.setattr(cli_module, "BackendRpcClient", FakeBackendRpcClient)
+
+    args = cli_module._build_parser().parse_args(
+        [
+            "pair",
+            "--server-url",
+            "http://127.0.0.1:8000",
+            "--config",
+            str(config_path),
+            "--poll-interval",
+            "0",
+            "--no-start",
+        ]
+    )
+    asyncio.run(cli_module._pair(args))
+
+    assert ConnectorConfig.load(config_path).connector_id == "conn_1"
+
+
+def test_login_alias_is_still_accepted() -> None:
+    args = cli_module._build_parser().parse_args(["login", "http://127.0.0.1:8000", "--no-start"])
+
+    assert args.command == "login"
+    assert args.server == "http://127.0.0.1:8000"
+    assert args.no_start is True
+
+
+def test_pair_server_without_scheme_falls_back_to_http(monkeypatch) -> None:
+    FakeFallbackHttpClient.calls = []
+    monkeypatch.setattr(cli_module.httpx, "AsyncClient", FakeFallbackHttpClient)
+
+    resolved = asyncio.run(cli_module._resolve_server_url_for_pair("anywhere.test:6664", timeout=0.1))
+
+    assert resolved == "http://anywhere.test:6664"
+    assert FakeFallbackHttpClient.calls == [
+        "https://anywhere.test:6664/health",
+        "http://anywhere.test:6664/health",
+    ]

{anywhere_cli-0.1.0 → anywhere_cli-0.1.2}/uv.lock

@@ -26,7 +26,7 @@ wheels = [
 
 [[package]]
 name = "anywhere-cli"
-version = "0.1.0"
+version = "0.1.2"
 source = { editable = "." }
 dependencies = [
     { name = "claude-agent-sdk" },
@@ -36,6 +36,7 @@ dependencies = [
     { name = "ptyprocess", marker = "sys_platform != 'win32'" },
     { name = "pydantic" },
     { name = "pyte" },
+    { name = "python-socks" },
     { name = "pywinpty", marker = "sys_platform == 'win32'" },
     { name = "websockets" },
 ]
@@ -55,6 +56,7 @@ requires-dist = [
     { name = "ptyprocess", marker = "sys_platform != 'win32'", specifier = ">=0.7.0" },
     { name = "pydantic", specifier = ">=2.0.0" },
     { name = "pyte", specifier = ">=0.8.2" },
+    { name = "python-socks", specifier = ">=2.8.1" },
     { name = "pywinpty", marker = "sys_platform == 'win32'", specifier = ">=2.0.13" },
     { name = "websockets", specifier = ">=16.0" },
 ]
@@ -582,6 +584,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e1/04/e8135ebd1ad02c56ec633277529b2602ff99ff634be76cdba5744cf554fd/python_multipart-0.0.32-py3-none-any.whl", hash = "sha256:ff6d3f776f16878c894e52e107296ffc890e913c611b1a4ec6c44e2821fe2e23", size = 30042, upload-time = "2026-06-04T16:18:57.319Z" },
 ]
 
+[[package]]
+name = "python-socks"
+version = "2.8.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/36/0b/cd77011c1bc01b76404f7aba07fca18aca02a19c7626e329b40201217624/python_socks-2.8.1.tar.gz", hash = "sha256:698daa9616d46dddaffe65b87db222f2902177a2d2b2c0b9a9361df607ab3687", size = 38909, upload-time = "2026-02-16T05:24:00.745Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/15/fe/9a58cb6eec633ff6afae150ca53c16f8cc8b65862ccb3d088051efdfceb7/python_socks-2.8.1-py3-none-any.whl", hash = "sha256:28232739c4988064e725cdbcd15be194743dd23f1c910f784163365b9d7be035", size = 55087, upload-time = "2026-02-16T05:23:59.147Z" },
+]
+
 [[package]]
 name = "pywin32"
 version = "312"