shadowob-sdk 1.1.3.dev271__tar.gz → 1.1.4__tar.gz

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shadowob-sdk
-Version: 1.1.3.dev271
+Version: 1.1.4
 Summary: Shadow SDK — Python client for Shadow server REST API and Socket.IO real-time events
 License-Expression: MIT
 Requires-Python: >=3.10

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "shadowob-sdk"
-version = "1.1.3.dev271"
+version = "1.1.4"
 description = "Shadow SDK — Python client for Shadow server REST API and Socket.IO real-time events"
 readme = "README.md"
 license = "MIT"

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/shadowob_sdk/__init__.py

@@ -20,6 +20,7 @@ from shadowob_sdk.types import (
     ShadowModelProxyBilling,
     ShadowModelProxyModel,
     ShadowModelProxyModelsResponse,
+    ShadowServerAppTokenIntrospection,
     ShadowServerAccess,
     ShadowShop,
     ShadowUser,
@@ -47,6 +48,7 @@ __all__ = [
     "ShadowModelProxyBilling",
     "ShadowModelProxyModel",
     "ShadowModelProxyModelsResponse",
+    "ShadowServerAppTokenIntrospection",
     "ShadowServerAccess",
     "ShadowShop",
     "ShadowSocket",

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/shadowob_sdk/client.py

@@ -248,9 +248,23 @@ class ShadowClient:
     def list_oauth_accounts(self) -> list[dict[str, Any]]:
         return self._get("/api/auth/oauth/accounts")
 
+    def create_oauth_connect_url(
+        self, provider: str, *, redirect: str | None = None
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        if redirect is not None:
+            payload["redirect"] = redirect
+        return self._post(f"/api/auth/oauth/{provider}/link", json=payload)
+
     def unlink_oauth_account(self, account_id: str) -> dict[str, Any]:
         return self._delete(f"/api/auth/oauth/accounts/{account_id}")
 
+    def list_auth_sessions(self) -> list[dict[str, Any]]:
+        return self._get("/api/auth/sessions")
+
+    def revoke_auth_session(self, session_id: str) -> dict[str, Any]:
+        return self._delete(f"/api/auth/sessions/{session_id}")
+
     # ── Agents ───────────────────────────────────────────────────────────
 
     def list_agents(self, *, include_rentals: bool = False) -> list[dict[str, Any]]:
@@ -404,6 +418,123 @@ class ShadowClient:
     def get_server_access(self, server_id_or_slug: str) -> dict[str, Any]:
         return self._get(f"/api/servers/{server_id_or_slug}/access")
 
+    def list_server_apps(self, server_id_or_slug: str) -> list[dict[str, Any]]:
+        return self._get(f"/api/servers/{server_id_or_slug}/apps")
+
+    def list_server_app_catalog(self, server_id_or_slug: str) -> list[dict[str, Any]]:
+        return self._get(f"/api/servers/{server_id_or_slug}/apps/catalog")
+
+    def discover_server_app(
+        self,
+        server_id_or_slug: str,
+        *,
+        manifest_url: str | None = None,
+        manifest: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        if manifest_url:
+            payload["manifestUrl"] = manifest_url
+        if manifest is not None:
+            payload["manifest"] = manifest
+        return self._post(f"/api/servers/{server_id_or_slug}/apps/discover", json=payload)
+
+    def install_server_app(
+        self,
+        server_id_or_slug: str,
+        *,
+        manifest_url: str | None = None,
+        manifest: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        if manifest_url:
+            payload["manifestUrl"] = manifest_url
+        if manifest is not None:
+            payload["manifest"] = manifest
+        return self._post(f"/api/servers/{server_id_or_slug}/apps", json=payload)
+
+    def install_server_app_from_catalog(
+        self,
+        server_id_or_slug: str,
+        catalog_entry_id: str,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {}
+        return self._post(
+            f"/api/servers/{server_id_or_slug}/apps/catalog/{catalog_entry_id}/install",
+            json=payload,
+        )
+
+    def get_server_app(self, server_id_or_slug: str, app_key: str) -> dict[str, Any]:
+        return self._get(f"/api/servers/{server_id_or_slug}/apps/{app_key}")
+
+    def delete_server_app(self, server_id_or_slug: str, app_key: str) -> dict[str, Any]:
+        return self._delete(f"/api/servers/{server_id_or_slug}/apps/{app_key}")
+
+    def grant_server_app_to_buddy(
+        self,
+        server_id_or_slug: str,
+        app_key: str,
+        *,
+        buddy_agent_id: str,
+        permissions: list[str],
+        resource_rules: dict[str, Any] | None = None,
+        approval_mode: str = "none",
+        expires_at: str | None = None,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {
+            "buddyAgentId": buddy_agent_id,
+            "permissions": permissions,
+            "approvalMode": approval_mode,
+        }
+        if resource_rules is not None:
+            payload["resourceRules"] = resource_rules
+        if expires_at:
+            payload["expiresAt"] = expires_at
+        return self._post(
+            f"/api/servers/{server_id_or_slug}/apps/{app_key}/grants",
+            json=payload,
+        )
+
+    def get_server_app_skills(
+        self, server_id_or_slug: str, app_key: str
+    ) -> dict[str, Any]:
+        return self._get(f"/api/servers/{server_id_or_slug}/apps/{app_key}/skills")
+
+    def create_server_app_launch(
+        self, server_id_or_slug: str, app_key: str
+    ) -> dict[str, Any]:
+        return self._post(f"/api/servers/{server_id_or_slug}/apps/{app_key}/launch")
+
+    def introspect_server_app_token(
+        self, server_id_or_slug: str, app_key: str, token: str
+    ) -> dict[str, Any]:
+        response = self._http.post(
+            f"/api/servers/{server_id_or_slug}/apps/{app_key}/oauth/introspect",
+            headers={
+                "Authorization": f"Bearer {token}",
+                "Content-Type": "application/json",
+            },
+            json={"token": token},
+        )
+        response.raise_for_status()
+        return response.json()
+
+    def call_server_app_command(
+        self,
+        server_id_or_slug: str,
+        app_key: str,
+        command_name: str,
+        *,
+        input: Any | None = None,
+        channel_id: str | None = None,
+    ) -> dict[str, Any]:
+        payload: dict[str, Any] = {"input": input if input is not None else {}}
+        if channel_id:
+            payload["channelId"] = channel_id
+        return self._post(
+            f"/api/servers/{server_id_or_slug}/apps/{app_key}/commands/{command_name}",
+            json=payload,
+        )
+
     def update_server(self, server_id: str, **kwargs: Any) -> dict[str, Any]:
         return self._patch(f"/api/servers/{server_id}", json=kwargs)
 
@@ -474,6 +605,17 @@ class ShadowClient:
     def get_channel(self, channel_id: str) -> dict[str, Any]:
         return self._get(f"/api/channels/{channel_id}")
 
+    def get_channel_bootstrap(
+        self,
+        channel_id: str,
+        *,
+        messages_limit: int | None = None,
+    ) -> dict[str, Any]:
+        params: dict[str, Any] = {}
+        if messages_limit is not None:
+            params["messagesLimit"] = messages_limit
+        return self._get(f"/api/channels/{channel_id}/bootstrap", params=params or None)
+
     def get_channel_access(self, channel_id: str) -> dict[str, Any]:
         return self._get(f"/api/channels/{channel_id}/access")
 
@@ -858,9 +1000,13 @@ class ShadowClient:
         attachment_id: str,
         *,
         disposition: str = "inline",
+        variant: str | None = None,
     ) -> dict[str, Any]:
         path = f"/api/attachments/{attachment_id}/media-url"
-        return self._get(path, params={"disposition": disposition})
+        params: dict[str, Any] = {"disposition": disposition}
+        if variant:
+            params["variant"] = variant
+        return self._get(path, params=params)
 
     def resolve_workspace_media_url(
         self,

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/shadowob_sdk/types.py

@@ -114,7 +114,6 @@ class ShadowServer:
     description: str | None = None
     icon_url: str | None = None
     banner_url: str | None = None
-    homepage_html: str | None = None
     is_public: bool = False
 
 
@@ -171,6 +170,20 @@ class ShadowSignedMediaUrl:
     expires_at: str
 
 
+@dataclass
+class ShadowServerAppTokenIntrospection:
+    active: bool
+    token_type: str | None = None
+    iss: str | None = None
+    aud: str | None = None
+    sub: str | None = None
+    scope: str | None = None
+    client_id: str | None = None
+    exp: int | None = None
+    iat: int | None = None
+    shadow: dict[str, Any] | None = None
+
+
 @dataclass
 class ShadowMessageMention:
     kind: str
@@ -184,6 +197,10 @@ class ShadowMessageMention:
     server_name: str | None = None
     channel_id: str | None = None
     channel_name: str | None = None
+    app_id: str | None = None
+    app_key: str | None = None
+    app_name: str | None = None
+    icon_url: str | None = None
     user_id: str | None = None
     username: str | None = None
     display_name: str | None = None
@@ -205,6 +222,10 @@ class ShadowMentionSuggestion:
     server_name: str | None = None
     channel_id: str | None = None
     channel_name: str | None = None
+    app_id: str | None = None
+    app_key: str | None = None
+    app_name: str | None = None
+    icon_url: str | None = None
     user_id: str | None = None
     username: str | None = None
     display_name: str | None = None

{shadowob_sdk-1.1.3.dev271 → shadowob_sdk-1.1.4}/tests/test_client.py

@@ -129,6 +129,61 @@ def test_get_wallet_transactions_with_display_filters(monkeypatch):
     client.close()
 
 
+def test_resolve_attachment_media_url_accepts_variant(monkeypatch):
+    client = ShadowClient("https://example.com", "test-token")
+    captured = {}
+
+    def fake_get(path, *, params=None):
+        captured["path"] = path
+        captured["params"] = params
+        return {
+            "url": "/api/media/signed/token",
+            "expiresAt": "2026-05-13T04:00:00.000Z",
+        }
+
+    monkeypatch.setattr(client, "_get", fake_get)
+
+    result = client.resolve_attachment_media_url(
+        "attachment-1", disposition="inline", variant="preview"
+    )
+
+    assert captured == {
+        "path": "/api/attachments/attachment-1/media-url",
+        "params": {"disposition": "inline", "variant": "preview"},
+    }
+    assert result["url"] == "/api/media/signed/token"
+    client.close()
+
+
+def test_get_channel_bootstrap_uses_message_limit(monkeypatch):
+    client = ShadowClient("https://example.com", "test-token")
+    captured = {}
+
+    def fake_get(path, *, params=None):
+        captured["path"] = path
+        captured["params"] = params
+        return {
+            "access": {"canAccess": True},
+            "channel": {"id": "channel-1"},
+            "server": None,
+            "channels": [],
+            "members": [],
+            "messages": {"messages": [], "hasMore": False},
+            "slashCommands": {"commands": []},
+        }
+
+    monkeypatch.setattr(client, "_get", fake_get)
+
+    result = client.get_channel_bootstrap("channel-1", messages_limit=50)
+
+    assert captured == {
+        "path": "/api/channels/channel-1/bootstrap",
+        "params": {"messagesLimit": 50},
+    }
+    assert result["messages"]["hasMore"] is False
+    client.close()
+
+
 def test_socket_creation():
     sock = ShadowSocket("https://example.com", "test-token")
     assert sock.connected is False