cred-semantic-kernel 1.0.0__py3-none-any.whl

cred_semantic_kernel/__init__.py

@@ -0,0 +1,5 @@
+"""Cred Semantic Kernel integration."""
+
+from .plugin import CredPlugin
+
+__all__ = ["CredPlugin"]

cred_semantic_kernel/plugin.py

@@ -0,0 +1,88 @@
+"""Cred Semantic Kernel Plugin.
+
+Provides a kernel function that delegates OAuth credentials for AI agents.
+The plugin is pre-configured with agent identity and app context at construction.
+At runtime, the agent provides ``service`` and ``scopes`` as function parameters.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Annotated, Optional
+
+from semantic_kernel.functions import kernel_function
+
+from cred import Cred
+
+
+class CredPlugin:
+    """Semantic Kernel plugin for Cred credential delegation.
+
+    Pre-configured at construction with the agent token, user ID, and
+    app client ID. Exposes a single ``delegate`` kernel function.
+
+    Example::
+
+        from cred_semantic_kernel import CredPlugin
+        import semantic_kernel as sk
+
+        kernel = sk.Kernel()
+        plugin = CredPlugin(
+            agent_token=os.environ["CRED_AGENT_TOKEN"],
+            user_id="user_123",
+            app_client_id="my_app",
+        )
+        kernel.add_plugin(plugin, plugin_name="cred")
+
+    Raises:
+        ConsentRequiredError: (from delegate at runtime) when the user hasn't
+            connected the requested service. The error message includes
+            ``consent_url`` so the caller can redirect the user.
+    """
+
+    def __init__(
+        self,
+        agent_token: str,
+        user_id: str,
+        app_client_id: str,
+        base_url: str = "https://api.cred.ninja",
+    ) -> None:
+        self._cred = Cred(agent_token=agent_token, base_url=base_url)
+        self._user_id = user_id
+        self._app_client_id = app_client_id
+
+    @kernel_function(
+        name="delegate",
+        description=(
+            "Get a delegated OAuth access token for a third-party service "
+            "on behalf of the current user. "
+            "Returns JSON with access_token, token_type, expires_in, service, scopes, "
+            "and delegation_id. "
+            "Raises an error with consent_url if the user hasn't connected the service."
+        ),
+    )
+    def delegate(
+        self,
+        service: Annotated[str, "Service slug to get a token for (e.g. 'google', 'github', 'google-calendar')."],
+        scopes: Annotated[str, "Comma-separated OAuth scopes to request (e.g. 'calendar.readonly,calendar.events'). Pass empty string to use all consented scopes."],
+    ) -> str:
+        """Delegate credentials and return JSON result."""
+        scope_list: Optional[list[str]] = None
+        if scopes:
+            scope_list = [s.strip() for s in scopes.split(",") if s.strip()]
+
+        result = self._cred.delegate(
+            service=service,
+            user_id=self._user_id,
+            app_client_id=self._app_client_id,
+            scopes=scope_list if scope_list else None,
+        )
+
+        return json.dumps({
+            "access_token": result.access_token,
+            "token_type": result.token_type,
+            "expires_in": result.expires_in,
+            "service": result.service,
+            "scopes": result.scopes,
+            "delegation_id": result.delegation_id,
+        })

cred_semantic_kernel-1.0.0.dist-info/METADATA

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: cred-semantic-kernel
+Version: 1.0.0
+Summary: Cred Semantic Kernel integration — credential delegation plugin for Microsoft Semantic Kernel agents
+Author-email: Cred <hello@cred.ninja>
+License: Apache-2.0
+Keywords: ai-agents,cred,delegation,microsoft,oauth,semantic-kernel
+Requires-Python: >=3.9
+Requires-Dist: cred-auth>=0.1.0
+Requires-Dist: semantic-kernel>=1.0
+Provides-Extra: dev
+Requires-Dist: hatchling; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cred-semantic-kernel
+
+Microsoft Semantic Kernel integration for Cred. OAuth2 credential delegation for AI agents.
+
+## Install
+
+```bash
+pip install cred-semantic-kernel
+```
+
+## Quick Start
+
+```python
+import os
+import semantic_kernel as sk
+from cred_semantic_kernel import CredPlugin
+
+kernel = sk.Kernel()
+
+plugin = CredPlugin(
+    agent_token=os.environ["CRED_AGENT_TOKEN"],
+    user_id="user_123",
+    app_client_id="my_app_client_id",
+)
+
+kernel.add_plugin(plugin, plugin_name="cred")
+```
+
+## Plugin Functions
+
+The `cred` plugin exposes one kernel function:
+
+### `delegate`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `service` | `string` | Service slug (e.g. `google`, `github`) |
+| `scopes` | `string` | Comma-separated OAuth scopes to request |
+
+`user_id` and `app_client_id` are pre-configured at construction time, not agent-controlled.
+
+Returns a JSON string with `access_token`, `token_type`, `expires_in`, `service`, `scopes`, and `delegation_id`.
+
+## Handling Consent
+
+When the user hasn't connected the service, the `delegate` function raises `ConsentRequiredError`.
+The error's `consent_url` attribute contains the URL to redirect the user.
+
+```python
+from cred import ConsentRequiredError
+
+try:
+    result = plugin.delegate(service="google", scopes="calendar.readonly")
+except ConsentRequiredError as e:
+    print(f"Redirect user to: {e.consent_url}")
+```
+
+## Cred Cloud (Coming Soon)
+
+Managed cloud delegation is coming. [Join the waitlist](https://cred.ninja/waitlist).

cred_semantic_kernel-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+cred_semantic_kernel/__init__.py,sha256=ejIyOJMMuOMUxxOs6izztuLre4Y4wLlVk1sjg0kiQaQ,98
+cred_semantic_kernel/plugin.py,sha256=Hr7hd7DTCpuxlMgLNgJm-XuqZkoqxPNV-DlYbm3VnmQ,3038
+cred_semantic_kernel-1.0.0.dist-info/METADATA,sha256=QVaF8E4FfQr-U3yUAkAOjIBQqbhPAyYbjHj8uRRlZgY,2105
+cred_semantic_kernel-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+cred_semantic_kernel-1.0.0.dist-info/RECORD,,

cred_semantic_kernel-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any