activecollab-mcp 1.9.0__py3-none-any.whl

activecollab_mcp/__init__.py

@@ -0,0 +1,10 @@
+"""ActiveCollab MCP server."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("activecollab-mcp")
+except PackageNotFoundError:  # editable installs without metadata
+    __version__ = "0.0.0+local"
+
+__all__ = ["__version__"]

activecollab_mcp/__main__.py

@@ -0,0 +1,4 @@
+from activecollab_mcp.cli import main
+
+if __name__ == "__main__":
+    main()

activecollab_mcp/auth.py

@@ -0,0 +1,134 @@
+"""ActiveCollab token issuance.
+
+Implements the `POST /issue-token` flow described at
+https://developers.activecollab.com/api-documentation/v1/authentication.html
+
+Given a base URL + email + password, returns a long-lived API token that can be
+used in subsequent requests via the `X-Angie-AuthApiToken` header.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from urllib.parse import urlparse, urlunparse
+
+import httpx
+
+from activecollab_mcp.credentials import Credentials, write_credentials
+
+
+class AuthError(Exception):
+    """Raised when token issuance fails."""
+
+
+CLIENT_NAME = "ActiveCollab MCP"
+CLIENT_VENDOR = "activecollab-mcp"
+
+
+def normalize_base_url(raw: str, *, append_api_v1: bool = True) -> str:
+    """Normalize an ActiveCollab base URL the same way config does.
+
+    Duplicated here (not imported from config) to keep this module
+    free of pydantic at call time.
+    """
+    if not raw or not raw.strip():
+        raise AuthError("Base URL is required.")
+
+    url = raw.strip()
+    if not url.endswith("/"):
+        url = url + "/"
+
+    parsed = urlparse(url)
+    if not parsed.scheme or not parsed.netloc:
+        raise AuthError(f"Invalid base URL: {raw}")
+
+    if append_api_v1:
+        path = parsed.path.rstrip("/")
+        if path == "":
+            parsed = parsed._replace(path="/api/v1/")
+
+    final = urlunparse(parsed)
+    return final if final.endswith("/") else final + "/"
+
+
+def issue_token(
+    base_url: str,
+    email: str,
+    password: str,
+    *,
+    verify: bool = True,
+    timeout: float = 20.0,
+) -> str:
+    """Call POST /issue-token. Returns the token on success.
+
+    Raises AuthError with a clear message on failure.
+    """
+    if not email or not password:
+        raise AuthError("Email and password are required.")
+
+    url = base_url.rstrip("/") + "/issue-token"
+    payload = {
+        "username": email,
+        "password": password,
+        "client_name": CLIENT_NAME,
+        "client_vendor": CLIENT_VENDOR,
+    }
+
+    try:
+        response = httpx.post(
+            url,
+            json=payload,
+            timeout=timeout,
+            verify=verify,
+            headers={
+                "Accept": "application/json",
+                "User-Agent": "activecollab-mcp/python",
+            },
+        )
+    except httpx.TimeoutException as exc:
+        raise AuthError(f"Token request timed out after {timeout}s") from exc
+    except httpx.HTTPError as exc:
+        raise AuthError(f"Token request failed: {exc}") from exc
+
+    body: object = None
+    if response.headers.get("content-type", "").startswith("application/json"):
+        try:
+            body = response.json()
+        except ValueError:
+            body = None
+
+    if response.is_error:
+        # ActiveCollab returns 500 with a typed message for known auth failures.
+        if isinstance(body, dict) and body.get("message"):
+            raise AuthError(str(body["message"]))
+        raise AuthError(
+            f"Token request failed with status {response.status_code}: {response.text[:300]}"
+        )
+
+    if not isinstance(body, dict) or not body.get("is_ok") or not body.get("token"):
+        raise AuthError(
+            f"Unexpected response from /issue-token: {response.text[:300]}"
+        )
+
+    return str(body["token"])
+
+
+def issue_and_store(
+    base_url_raw: str,
+    email: str,
+    password: str,
+    *,
+    verify: bool = True,
+    append_api_v1: bool = True,
+) -> Credentials:
+    """Issue a token and persist it to the credentials file."""
+    normalized = normalize_base_url(base_url_raw, append_api_v1=append_api_v1)
+    token = issue_token(normalized, email, password, verify=verify)
+    creds = Credentials(
+        base_url=normalized,
+        api_key=token,
+        issued_at=datetime.now(timezone.utc).isoformat(),
+        issued_for=email,
+    )
+    write_credentials(creds)
+    return creds