agentic-fabriq-sdk 0.1.4__tar.gz → 0.1.6__tar.gz

{agentic_fabriq_sdk-0.1.4 → agentic_fabriq_sdk-0.1.6}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: agentic-fabriq-sdk
-Version: 0.1.4
-Summary: Fabriq/Agentic Fabric Python SDK: high-level client, DX helpers, auth
+Version: 0.1.6
+Summary: Agentic Fabriq SDK: high-level client, CLI tool, DX helpers, and auth for AI agents
 License: Apache-2.0
-Keywords: fabriq,agentic-fabric,sdk,ai,agents
-Author: Agentic Fabric Contributors
-Author-email: contributors@agentic-fabric.org
+Keywords: fabriq,agentic-fabriq,sdk,ai,agents,agentic,fabric,cli
+Author: Agentic Fabriq Contributors
+Author-email: contributors@agentic-fabriq.org
 Requires-Python: >=3.11,<3.13
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -17,23 +17,28 @@ Classifier: Typing :: Typed
 Requires-Dist: PyJWT (>=2.8.0)
 Requires-Dist: aiohttp (>=3.9.0)
 Requires-Dist: httpx (>=0.25)
+Requires-Dist: keyring (>=25.0.0)
 Requires-Dist: nats-py (>=2.4.0)
 Requires-Dist: opentelemetry-api (>=1.20.0)
 Requires-Dist: opentelemetry-instrumentation-httpx (>=0.41b0)
 Requires-Dist: pydantic (>=2.4)
+Requires-Dist: rich (>=13.7.0)
 Requires-Dist: stevedore (>=5.1.0)
+Requires-Dist: typer (>=0.9.0)
 Requires-Dist: typing-extensions
 Project-URL: Documentation, https://docs.agentic-fabric.org
 Project-URL: Homepage, https://github.com/agentic-fabric/agentic-fabric
 Project-URL: Repository, https://github.com/agentic-fabric/agentic-fabric
 Description-Content-Type: text/markdown
 
-# Agentic Fabric SDK (Fabriq)
+# Agentic Fabriq SDK
 
-`agentic-fabriq-sdk` provides a Python SDK for interacting with Fabriq/Agentic Fabric.
+`agentic-fabriq-sdk` provides a Python SDK and CLI tool for interacting with Agentic Fabriq.
 
-- High-level client: `af_sdk.FabriqClient`
-- DX layer: `af_sdk.dx` (`ToolFabric`, `AgentFabric`, `MCPServer`, `Agent`, and `tool`)
+**What's included:**
+- 🐍 **Python SDK**: High-level client (`af_sdk.FabriqClient`) and DX layer
+- 🛠️ **CLI Tool**: `afctl` command for authentication and management
+- 🔐 **OAuth2/PKCE**: Secure browser-based authentication with token storage
 
 ## Install
 
@@ -41,13 +46,38 @@ Description-Content-Type: text/markdown
 pip install agentic-fabriq-sdk
 ```
 
+This installs both the Python library and the `afctl` CLI tool.
+
 ## Quickstart
 
+### CLI Tool
+
+Authenticate and manage your Agentic Fabriq resources:
+
+```bash
+# Login with OAuth2 (browser opens automatically)
+afctl auth login
+
+# Check authentication status
+afctl auth status
+
+# List available tools
+afctl tools list
+
+# List agents
+afctl agents list
+
+# Get help
+afctl --help
+```
+
+### Python SDK
+
 ```python
 from af_sdk.fabriq_client import FabriqClient
 
 TOKEN = "..."  # Bearer JWT for the Fabriq Gateway
-BASE = "http://localhost:8000"
+BASE = "https://dashboard.agenticfabriq.com"
 
 async def main():
     async with FabriqClient(base_url=BASE, auth_token=TOKEN) as af:

{agentic_fabriq_sdk-0.1.4 → agentic_fabriq_sdk-0.1.6}/README.md

@@ -1,9 +1,11 @@
-# Agentic Fabric SDK (Fabriq)
+# Agentic Fabriq SDK
 
-`agentic-fabriq-sdk` provides a Python SDK for interacting with Fabriq/Agentic Fabric.
+`agentic-fabriq-sdk` provides a Python SDK and CLI tool for interacting with Agentic Fabriq.
 
-- High-level client: `af_sdk.FabriqClient`
-- DX layer: `af_sdk.dx` (`ToolFabric`, `AgentFabric`, `MCPServer`, `Agent`, and `tool`)
+**What's included:**
+- 🐍 **Python SDK**: High-level client (`af_sdk.FabriqClient`) and DX layer
+- 🛠️ **CLI Tool**: `afctl` command for authentication and management
+- 🔐 **OAuth2/PKCE**: Secure browser-based authentication with token storage
 
 ## Install
 
@@ -11,13 +13,38 @@
 pip install agentic-fabriq-sdk
 ```
 
+This installs both the Python library and the `afctl` CLI tool.
+
 ## Quickstart
 
+### CLI Tool
+
+Authenticate and manage your Agentic Fabriq resources:
+
+```bash
+# Login with OAuth2 (browser opens automatically)
+afctl auth login
+
+# Check authentication status
+afctl auth status
+
+# List available tools
+afctl tools list
+
+# List agents
+afctl agents list
+
+# Get help
+afctl --help
+```
+
+### Python SDK
+
 ```python
 from af_sdk.fabriq_client import FabriqClient
 
 TOKEN = "..."  # Bearer JWT for the Fabriq Gateway
-BASE = "http://localhost:8000"
+BASE = "https://dashboard.agenticfabriq.com"
 
 async def main():
     async with FabriqClient(base_url=BASE, auth_token=TOKEN) as af:

agentic_fabriq_sdk-0.1.6/af_cli/__init__.py

@@ -0,0 +1,8 @@
+"""
+Agentic Fabric CLI Tool
+
+A command-line interface for managing Agentic Fabric resources including
+agents, tools, MCP servers, and administrative operations.
+"""
+
+__version__ = "1.0.0" 

agentic_fabriq_sdk-0.1.6/af_cli/commands/__init__.py

@@ -0,0 +1,3 @@
+"""
+CLI commands for the Agentic Fabric CLI.
+""" 

agentic_fabriq_sdk-0.1.6/af_cli/commands/agents.py

@@ -0,0 +1,238 @@
+"""
+Agent management commands for the Agentic Fabric CLI.
+"""
+
+from typing import Optional
+
+import typer
+
+from af_cli.core.client import get_client
+from af_cli.core.output import error, info, print_output, success, warning, prompt_confirm
+
+app = typer.Typer(help="Agent management commands")
+
+
+@app.command()
+def list(
+    page: int = typer.Option(1, "--page", "-p", help="Page number"),
+    page_size: int = typer.Option(20, "--page-size", "-s", help="Page size"),
+    search: Optional[str] = typer.Option(None, "--search", "-q", help="Search query"),
+    format: str = typer.Option("table", "--format", "-f", help="Output format"),
+):
+    """List agents."""
+    try:
+        with get_client() as client:
+            params = {
+                "page": page,
+                "page_size": page_size,
+            }
+            
+            if search:
+                params["search"] = search
+            
+            response = client.get("/api/v1/agents", params=params)
+
+            # Support both new (items/total) and legacy (agents/total) shapes
+            if isinstance(response, dict):
+                if "items" in response:
+                    agents = response.get("items", [])
+                    total = response.get("total", len(agents))
+                elif "agents" in response:
+                    agents = response.get("agents", [])
+                    total = response.get("total", len(agents))
+                else:
+                    agents = []
+                    total = 0
+            elif isinstance(response, list):
+                agents = response
+                total = len(agents)
+            else:
+                agents = []
+                total = 0
+            
+            if not agents:
+                warning("No agents found")
+                return
+            
+            # Format agent data for display
+            display_data = []
+            for agent in agents:
+                display_data.append({
+                    "id": agent.get("id"),
+                    "name": agent.get("name"),
+                    "version": agent.get("version"),
+                    "protocol": agent.get("protocol"),
+                    "endpoint_url": agent.get("endpoint_url"),
+                    "auth_method": agent.get("auth_method"),
+                    "created_at": (agent.get("created_at") or "")[:19],  # Trim microseconds if present
+                })
+            
+            print_output(
+                display_data,
+                format_type=format,
+                columns=["id", "name", "version", "protocol", "endpoint_url", "auth_method", "created_at"],
+                title=f"Agents ({len(agents)}/{total})"
+            )
+            
+    except Exception as e:
+        error(f"Failed to list agents: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def get(
+    agent_id: str = typer.Argument(..., help="Agent ID"),
+    format: str = typer.Option("table", "--format", "-f", help="Output format"),
+):
+    """Get agent details."""
+    try:
+        with get_client() as client:
+            agent = client.get(f"/api/v1/agents/{agent_id}")
+            
+            print_output(
+                agent,
+                format_type=format,
+                title=f"Agent {agent_id}"
+            )
+            
+    except Exception as e:
+        error(f"Failed to get agent: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def create(
+    name: str = typer.Option(..., "--name", "-n", help="Agent name"),
+    description: Optional[str] = typer.Option(None, "--description", "-d", help="Agent description"),
+    version: str = typer.Option("1.0.0", "--version", "-v", help="Agent version"),
+    protocol: str = typer.Option("HTTP", "--protocol", help="Agent protocol"),
+    endpoint_url: str = typer.Option(..., "--endpoint-url", "-u", help="Agent endpoint URL"),
+    auth_method: str = typer.Option("OAUTH2", "--auth-method", "-a", help="Authentication method"),
+):
+    """Create a new agent."""
+    try:
+        with get_client() as client:
+            data = {
+                "name": name,
+                "description": description,
+                "version": version,
+                "protocol": protocol,
+                "endpoint_url": endpoint_url,
+                "auth_method": auth_method,
+            }
+            
+            agent = client.post("/api/v1/agents", data)
+            
+            success(f"Agent created: {agent['id']}")
+            info(f"Name: {agent['name']}")
+            info(f"Endpoint: {agent['endpoint_url']}")
+            
+    except Exception as e:
+        error(f"Failed to create agent: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def update(
+    agent_id: str = typer.Argument(..., help="Agent ID"),
+    name: Optional[str] = typer.Option(None, "--name", "-n", help="Agent name"),
+    description: Optional[str] = typer.Option(None, "--description", "-d", help="Agent description"),
+    version: Optional[str] = typer.Option(None, "--version", "-v", help="Agent version"),
+    protocol: Optional[str] = typer.Option(None, "--protocol", help="Agent protocol"),
+    endpoint_url: Optional[str] = typer.Option(None, "--endpoint-url", "-u", help="Agent endpoint URL"),
+    auth_method: Optional[str] = typer.Option(None, "--auth-method", "-a", help="Authentication method"),
+):
+    """Update an agent."""
+    try:
+        with get_client() as client:
+            data = {}
+            
+            if name is not None:
+                data["name"] = name
+            if description is not None:
+                data["description"] = description
+            if version is not None:
+                data["version"] = version
+            if protocol is not None:
+                data["protocol"] = protocol
+            if endpoint_url is not None:
+                data["endpoint_url"] = endpoint_url
+            if auth_method is not None:
+                data["auth_method"] = auth_method
+            
+            if not data:
+                error("No update data provided")
+                raise typer.Exit(1)
+            
+            agent = client.put(f"/api/v1/agents/{agent_id}", data)
+            
+            success(f"Agent updated: {agent['id']}")
+            info(f"Name: {agent['name']}")
+            info(f"Endpoint: {agent['endpoint_url']}")
+            
+    except Exception as e:
+        error(f"Failed to update agent: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def delete(
+    agent_id: str = typer.Argument(..., help="Agent ID"),
+    force: bool = typer.Option(False, "--force", "-f", help="Force deletion without confirmation"),
+):
+    """Delete an agent."""
+    try:
+        if not force:
+            if not prompt_confirm(f"Are you sure you want to delete agent {agent_id}?"):
+                info("Deletion cancelled")
+                return
+        
+        with get_client() as client:
+            client.delete(f"/api/v1/agents/{agent_id}")
+            
+            success(f"Agent deleted: {agent_id}")
+            
+    except Exception as e:
+        error(f"Failed to delete agent: {e}")
+        raise typer.Exit(1)
+
+
+@app.command()
+def invoke(
+    agent_id: str = typer.Argument(..., help="Agent ID"),
+    input_text: str = typer.Option(..., "--input", "-i", help="Input message for the agent"),
+    format: str = typer.Option("table", "--format", "-f", help="Output format"),
+):
+    """Invoke an agent."""
+    try:
+        with get_client() as client:
+            data = {
+                "input": input_text,
+                "parameters": {},
+                "context": {},
+            }
+            
+            info(f"Invoking agent {agent_id}...")
+            response = client.post(f"/api/v1/agents/{agent_id}/invoke", data)
+            
+            success("Agent invoked successfully")
+            
+            # Display response
+            if format == "table":
+                info("Response:")
+                print(response["output"])
+                
+                if response.get("metadata"):
+                    info("\nMetadata:")
+                    print_output(response["metadata"], format_type="yaml")
+                
+                if response.get("logs"):
+                    info("\nLogs:")
+                    for log in response["logs"]:
+                        print(f"  {log}")
+            else:
+                print_output(response, format_type=format)
+            
+    except Exception as e:
+        error(f"Failed to invoke agent: {e}")
+        raise typer.Exit(1)