librefang-sdk 0.5.4__tar.gz

librefang_sdk-0.5.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LibreFang Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

librefang_sdk-0.5.4/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: librefang-sdk
+Version: 0.5.4
+Summary: Official Python client and SDK for the LibreFang Agent OS
+Author-email: LibreFang Team <team@librefang.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://librefang.ai
+Project-URL: Repository, https://github.com/librefang/librefang
+Project-URL: Issues, https://github.com/librefang/librefang/issues
+Keywords: librefang,agent,ai,llm,autonomous-agent,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+Dynamic: requires-python
+
+# LibreFang Python SDK
+
+Official Python client and SDK for the LibreFang Agent OS.
+
+## Installation
+
+```bash
+pip install librefang
+```
+
+## Two Packages
+
+This package provides two different interfaces:
+
+### 1. REST API Client (`librefang.client`)
+
+Control LibreFang remotely via its REST API.
+
+```python
+from librefang import Client
+
+client = Client("http://localhost:4545")
+
+# Create an agent
+agent = client.agents.create(template="assistant")
+print(f"Agent created: {agent['id']}")
+
+# Send a message
+reply = client.agents.message(agent["id"], "Hello!")
+print(reply)
+
+# Stream a response
+for event in client.agents.stream(agent["id"], "Tell me a story"):
+    if event.get("type") == "text_delta":
+        print(event["delta"], end="", flush=True)
+```
+
+### 2. Agent SDK (`librefang.sdk`)
+
+Write Python agents that run inside LibreFang.
+
+```python
+from librefang import Agent
+
+agent = Agent()
+
+@agent.on_message
+def handle(message: str, context: dict) -> str:
+    return f"You said: {message}"
+
+agent.run()
+```
+
+Or use the simple input/output functions:
+
+```python
+from librefang import read_input, respond
+
+data = read_input()
+result = f"Echo: {data['message']}"
+respond(result)
+```
+
+## Examples
+
+See the `examples/` directory for more examples:
+
+### Client Examples
+- `client_basic.py` - Basic REST API usage
+- `client_streaming.py` - Streaming responses
+
+### SDK Examples
+- `echo_agent.py` - Simple echo agent
+
+## Requirements
+
+- Python 3.8+
+
+## License
+
+MIT

librefang_sdk-0.5.4/README.md

@@ -0,0 +1,81 @@
+# LibreFang Python SDK
+
+Official Python client and SDK for the LibreFang Agent OS.
+
+## Installation
+
+```bash
+pip install librefang
+```
+
+## Two Packages
+
+This package provides two different interfaces:
+
+### 1. REST API Client (`librefang.client`)
+
+Control LibreFang remotely via its REST API.
+
+```python
+from librefang import Client
+
+client = Client("http://localhost:4545")
+
+# Create an agent
+agent = client.agents.create(template="assistant")
+print(f"Agent created: {agent['id']}")
+
+# Send a message
+reply = client.agents.message(agent["id"], "Hello!")
+print(reply)
+
+# Stream a response
+for event in client.agents.stream(agent["id"], "Tell me a story"):
+    if event.get("type") == "text_delta":
+        print(event["delta"], end="", flush=True)
+```
+
+### 2. Agent SDK (`librefang.sdk`)
+
+Write Python agents that run inside LibreFang.
+
+```python
+from librefang import Agent
+
+agent = Agent()
+
+@agent.on_message
+def handle(message: str, context: dict) -> str:
+    return f"You said: {message}"
+
+agent.run()
+```
+
+Or use the simple input/output functions:
+
+```python
+from librefang import read_input, respond
+
+data = read_input()
+result = f"Echo: {data['message']}"
+respond(result)
+```
+
+## Examples
+
+See the `examples/` directory for more examples:
+
+### Client Examples
+- `client_basic.py` - Basic REST API usage
+- `client_streaming.py` - Streaming responses
+
+### SDK Examples
+- `echo_agent.py` - Simple echo agent
+
+## Requirements
+
+- Python 3.8+
+
+## License
+
+MIT

librefang_sdk-0.5.4/librefang/__init__.py

@@ -0,0 +1,14 @@
+"""
+LibreFang Python SDK and Client.
+
+Two packages:
+- librefang.client: REST API client for controlling LibreFang remotely
+- librefang.sdk: Helper library for writing Python agents that run inside LibreFang
+"""
+
+from librefang.librefang_client import LibreFang as Client
+from librefang.librefang_sdk import Agent, read_input, respond, log
+
+__version__ = "0.5.2"
+
+__all__ = ["Client", "Agent", "read_input", "respond", "log"]

librefang_sdk-0.5.4/librefang/librefang_client.py

@@ -0,0 +1,367 @@
+"""
+LibreFang Python Client — REST API client for controlling LibreFang remotely.
+
+Usage:
+
+    from librefang_client import LibreFang
+
+    client = LibreFang("http://localhost:4545")
+
+    # Create an agent
+    agent = client.agents.create(template="assistant")
+    print(agent["id"])
+
+    # Send a message
+    reply = client.agents.message(agent["id"], "Hello!")
+    print(reply)
+
+    # Stream a response
+    for event in client.agents.stream(agent["id"], "Tell me a joke"):
+        if event.get("type") == "text_delta":
+            print(event["delta"], end="", flush=True)
+
+Note: This is the REST API *client* library.
+      For writing Python agents that run inside LibreFang, see librefang_sdk.py instead.
+"""
+
+import json
+from typing import Any, Dict, Generator, Optional
+from urllib.request import urlopen, Request
+from urllib.error import HTTPError
+from urllib.parse import urlencode, quote
+
+
+class LibreFangError(Exception):
+    def __init__(self, message: str, status: int = 0, body: str = ""):
+        super().__init__(message)
+        self.status = status
+        self.body = body
+
+
+class _Resource:
+    def __init__(self, client: "LibreFang"):
+        self._c = client
+
+
+class LibreFang:
+    """LibreFang REST API client. Zero dependencies — uses only stdlib urllib."""
+
+    def __init__(self, base_url: str, headers: Optional[Dict[str, str]] = None):
+        self.base_url = base_url.rstrip("/")
+        self._headers = {"Content-Type": "application/json"}
+        if headers:
+            self._headers.update(headers)
+
+        self.agents = _AgentResource(self)
+        self.sessions = _SessionResource(self)
+        self.workflows = _WorkflowResource(self)
+        self.skills = _SkillResource(self)
+        self.channels = _ChannelResource(self)
+        self.tools = _ToolResource(self)
+        self.models = _ModelResource(self)
+        self.providers = _ProviderResource(self)
+        self.memory = _MemoryResource(self)
+        self.triggers = _TriggerResource(self)
+        self.schedules = _ScheduleResource(self)
+
+    def _request(self, method: str, path: str, body: Any = None) -> Any:
+        url = self.base_url + path
+        data = json.dumps(body).encode() if body is not None else None
+        req = Request(url, data=data, headers=self._headers, method=method)
+        try:
+            with urlopen(req) as resp:
+                ct = resp.headers.get("content-type", "")
+                text = resp.read().decode()
+                if "application/json" in ct:
+                    return json.loads(text)
+                return text
+        except HTTPError as e:
+            body_text = e.read().decode() if e.fp else ""
+            raise LibreFangError(f"HTTP {e.code}: {body_text}", e.code, body_text) from e
+
+    def _stream(self, method: str, path: str, body: Any = None) -> Generator[Dict, None, None]:
+        """SSE streaming. Yields parsed JSON events."""
+        url = self.base_url + path
+        data = json.dumps(body).encode() if body is not None else None
+        headers = dict(self._headers)
+        headers["Accept"] = "text/event-stream"
+        req = Request(url, data=data, headers=headers, method=method)
+        try:
+            resp = urlopen(req)
+        except HTTPError as e:
+            body_text = e.read().decode() if e.fp else ""
+            raise LibreFangError(f"HTTP {e.code}: {body_text}", e.code, body_text) from e
+
+        buffer = ""
+        while True:
+            chunk = resp.read(4096)
+            if not chunk:
+                break
+            buffer += chunk.decode()
+            lines = buffer.split("\n")
+            buffer = lines.pop()
+            for line in lines:
+                line = line.strip()
+                if line.startswith("data: "):
+                    data_str = line[6:]
+                    if data_str == "[DONE]":
+                        return
+                    try:
+                        yield json.loads(data_str)
+                    except json.JSONDecodeError:
+                        yield {"raw": data_str}
+        resp.close()
+
+    def health(self) -> Any:
+        return self._request("GET", "/api/health")
+
+    def health_detail(self) -> Any:
+        return self._request("GET", "/api/health/detail")
+
+    def status(self) -> Any:
+        return self._request("GET", "/api/status")
+
+    def version(self) -> Any:
+        return self._request("GET", "/api/version")
+
+    def metrics(self) -> str:
+        return self._request("GET", "/api/metrics")
+
+    def usage(self) -> Any:
+        return self._request("GET", "/api/usage")
+
+    def config(self) -> Any:
+        return self._request("GET", "/api/config")
+
+
+# ── Agent Resource ──────────────────────────────────────────────
+
+class _AgentResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/agents")
+
+    def get(self, agent_id: str):
+        return self._c._request("GET", f"/api/agents/{agent_id}")
+
+    def create(self, **kwargs):
+        return self._c._request("POST", "/api/agents", kwargs)
+
+    def delete(self, agent_id: str):
+        return self._c._request("DELETE", f"/api/agents/{agent_id}")
+
+    def stop(self, agent_id: str):
+        return self._c._request("POST", f"/api/agents/{agent_id}/stop")
+
+    def clone(self, agent_id: str):
+        return self._c._request("POST", f"/api/agents/{agent_id}/clone")
+
+    def update(self, agent_id: str, **data):
+        return self._c._request("PUT", f"/api/agents/{agent_id}/update", data)
+
+    def set_mode(self, agent_id: str, mode: str):
+        return self._c._request("PUT", f"/api/agents/{agent_id}/mode", {"mode": mode})
+
+    def set_model(self, agent_id: str, model: str):
+        return self._c._request("PUT", f"/api/agents/{agent_id}/model", {"model": model})
+
+    def message(self, agent_id: str, text: str, **opts):
+        body = {"message": text, **opts}
+        return self._c._request("POST", f"/api/agents/{agent_id}/message", body)
+
+    def stream(self, agent_id: str, text: str, **opts) -> Generator[Dict, None, None]:
+        """Stream response events. Usage:
+            for event in client.agents.stream(id, "Hello"):
+                if event.get("type") == "text_delta":
+                    print(event["delta"], end="")
+        """
+        body = {"message": text, **opts}
+        return self._c._stream("POST", f"/api/agents/{agent_id}/message/stream", body)
+
+    def session(self, agent_id: str):
+        return self._c._request("GET", f"/api/agents/{agent_id}/session")
+
+    def reset_session(self, agent_id: str):
+        return self._c._request("POST", f"/api/agents/{agent_id}/session/reset")
+
+    def compact_session(self, agent_id: str):
+        return self._c._request("POST", f"/api/agents/{agent_id}/session/compact")
+
+    def list_sessions(self, agent_id: str):
+        return self._c._request("GET", f"/api/agents/{agent_id}/sessions")
+
+    def create_session(self, agent_id: str, label: Optional[str] = None):
+        return self._c._request("POST", f"/api/agents/{agent_id}/sessions", {"label": label})
+
+    def switch_session(self, agent_id: str, session_id: str):
+        return self._c._request("POST", f"/api/agents/{agent_id}/sessions/{session_id}/switch")
+
+    def get_skills(self, agent_id: str):
+        return self._c._request("GET", f"/api/agents/{agent_id}/skills")
+
+    def set_skills(self, agent_id: str, skills):
+        return self._c._request("PUT", f"/api/agents/{agent_id}/skills", skills)
+
+    def set_identity(self, agent_id: str, **identity):
+        return self._c._request("PATCH", f"/api/agents/{agent_id}/identity", identity)
+
+    def patch_config(self, agent_id: str, **config):
+        return self._c._request("PATCH", f"/api/agents/{agent_id}/config", config)
+
+
+# ── Session Resource ────────────────────────────────────────────
+
+class _SessionResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/sessions")
+
+    def delete(self, session_id: str):
+        return self._c._request("DELETE", f"/api/sessions/{session_id}")
+
+    def set_label(self, session_id: str, label: str):
+        return self._c._request("PUT", f"/api/sessions/{session_id}/label", {"label": label})
+
+
+# ── Workflow Resource ───────────────────────────────────────────
+
+class _WorkflowResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/workflows")
+
+    def create(self, **workflow):
+        return self._c._request("POST", "/api/workflows", workflow)
+
+    def run(self, workflow_id: str, input_data=None):
+        return self._c._request("POST", f"/api/workflows/{workflow_id}/run", input_data)
+
+    def runs(self, workflow_id: str):
+        return self._c._request("GET", f"/api/workflows/{workflow_id}/runs")
+
+
+# ── Skill Resource ──────────────────────────────────────────────
+
+class _SkillResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/skills")
+
+    def install(self, **skill):
+        return self._c._request("POST", "/api/skills/install", skill)
+
+    def uninstall(self, **skill):
+        return self._c._request("POST", "/api/skills/uninstall", skill)
+
+    def search(self, query: str):
+        return self._c._request("GET", f"/api/marketplace/search?q={quote(query)}")
+
+
+# ── Channel Resource ────────────────────────────────────────────
+
+class _ChannelResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/channels")
+
+    def configure(self, name: str, **config):
+        return self._c._request("POST", f"/api/channels/{name}/configure", config)
+
+    def remove(self, name: str):
+        return self._c._request("DELETE", f"/api/channels/{name}/configure")
+
+    def test(self, name: str):
+        return self._c._request("POST", f"/api/channels/{name}/test")
+
+
+# ── Tool Resource ───────────────────────────────────────────────
+
+class _ToolResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/tools")
+
+
+# ── Model Resource ──────────────────────────────────────────────
+
+class _ModelResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/models")
+
+    def get(self, model_id: str):
+        return self._c._request("GET", f"/api/models/{model_id}")
+
+    def aliases(self):
+        return self._c._request("GET", "/api/models/aliases")
+
+
+# ── Provider Resource ───────────────────────────────────────────
+
+class _ProviderResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/providers")
+
+    def set_key(self, name: str, key: str):
+        return self._c._request("POST", f"/api/providers/{name}/key", {"key": key})
+
+    def delete_key(self, name: str):
+        return self._c._request("DELETE", f"/api/providers/{name}/key")
+
+    def test(self, name: str):
+        return self._c._request("POST", f"/api/providers/{name}/test")
+
+
+# ── Memory Resource ─────────────────────────────────────────────
+
+class _MemoryResource(_Resource):
+
+    def get_all(self, agent_id: str):
+        return self._c._request("GET", f"/api/memory/agents/{agent_id}/kv")
+
+    def get(self, agent_id: str, key: str):
+        return self._c._request("GET", f"/api/memory/agents/{agent_id}/kv/{key}")
+
+    def set(self, agent_id: str, key: str, value):
+        return self._c._request("PUT", f"/api/memory/agents/{agent_id}/kv/{key}", {"value": value})
+
+    def delete(self, agent_id: str, key: str):
+        return self._c._request("DELETE", f"/api/memory/agents/{agent_id}/kv/{key}")
+
+
+# ── Trigger Resource ────────────────────────────────────────────
+
+class _TriggerResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/triggers")
+
+    def create(self, **trigger):
+        return self._c._request("POST", "/api/triggers", trigger)
+
+    def update(self, trigger_id: str, **trigger):
+        return self._c._request("PUT", f"/api/triggers/{trigger_id}", trigger)
+
+    def delete(self, trigger_id: str):
+        return self._c._request("DELETE", f"/api/triggers/{trigger_id}")
+
+
+# ── Schedule Resource ───────────────────────────────────────────
+
+class _ScheduleResource(_Resource):
+
+    def list(self):
+        return self._c._request("GET", "/api/schedules")
+
+    def create(self, **schedule):
+        return self._c._request("POST", "/api/schedules", schedule)
+
+    def update(self, schedule_id: str, **schedule):
+        return self._c._request("PUT", f"/api/schedules/{schedule_id}", schedule)
+
+    def delete(self, schedule_id: str):
+        return self._c._request("DELETE", f"/api/schedules/{schedule_id}")
+
+    def run(self, schedule_id: str):
+        return self._c._request("POST", f"/api/schedules/{schedule_id}/run")

librefang_sdk-0.5.4/librefang/librefang_sdk.py

@@ -0,0 +1,147 @@
+"""
+LibreFang Python SDK — helper library for writing Python agents.
+
+Usage:
+
+    from librefang_sdk import Agent
+
+    agent = Agent()
+
+    @agent.on_message
+    def handle(message: str, context: dict) -> str:
+        return f"You said: {message}"
+
+    agent.run()
+
+Or for simple scripts without the decorator pattern:
+
+    from librefang_sdk import read_input, respond
+
+    data = read_input()
+    result = f"Echo: {data['message']}"
+    respond(result)
+"""
+
+import json
+import os
+import sys
+from typing import Callable, Optional, Dict, Any
+
+
+def read_input() -> Dict[str, Any]:
+    """Read the input JSON from stdin (sent by the LibreFang kernel)."""
+    line = sys.stdin.readline().strip()
+    if not line:
+        # Fallback: check environment variables
+        agent_id = os.environ.get("LIBREFANG_AGENT_ID", "")
+        message = os.environ.get("LIBREFANG_MESSAGE", "")
+        return {
+            "type": "message",
+            "agent_id": agent_id,
+            "message": message,
+            "context": {},
+        }
+    return json.loads(line)
+
+
+def respond(text: str, metadata: Optional[Dict[str, Any]] = None) -> None:
+    """Send a response back to the LibreFang kernel via stdout."""
+    response = {"type": "response", "text": text}
+    if metadata:
+        response["metadata"] = metadata
+    print(json.dumps(response), flush=True)
+
+
+def log(message: str, level: str = "info") -> None:
+    """Log a message to stderr (visible in LibreFang daemon logs)."""
+    print(f"[{level.upper()}] {message}", file=sys.stderr, flush=True)
+
+
+class Agent:
+    """Decorator-based Python agent framework.
+
+    Example:
+
+        agent = Agent()
+
+        @agent.on_message
+        def handle(message: str, context: dict) -> str:
+            return f"Hello! You said: {message}"
+
+        agent.run()
+    """
+
+    def __init__(self):
+        self._handler: Optional[Callable] = None
+        self._setup: Optional[Callable] = None
+        self._teardown: Optional[Callable] = None
+
+    def on_message(self, func: Callable) -> Callable:
+        """Register a message handler function.
+
+        The function should accept (message: str, context: dict) and return str.
+        """
+        self._handler = func
+        return func
+
+    def on_setup(self, func: Callable) -> Callable:
+        """Register a setup function called once before message handling."""
+        self._setup = func
+        return func
+
+    def on_teardown(self, func: Callable) -> Callable:
+        """Register a teardown function called once after message handling."""
+        self._teardown = func
+        return func
+
+    def run(self) -> None:
+        """Run the agent, reading input and producing output."""
+        if self._handler is None:
+            log("No message handler registered", "error")
+            sys.exit(1)
+
+        try:
+            if self._setup:
+                self._setup()
+
+            data = read_input()
+            message = data.get("message", "")
+            context = data.get("context", {})
+
+            result = self._handler(message, context)
+
+            if isinstance(result, str):
+                respond(result)
+            elif isinstance(result, dict):
+                respond(result.get("text", str(result)), result.get("metadata"))
+            else:
+                respond(str(result))
+
+        except Exception as e:
+            log(f"Agent error: {e}", "error")
+            respond(f"Error: {e}")
+            sys.exit(1)
+        finally:
+            if self._teardown:
+                try:
+                    self._teardown()
+                except Exception as e:
+                    log(f"Teardown error: {e}", "error")
+
+
+# Convenience: if this file is run directly, show usage
+if __name__ == "__main__":
+    print("LibreFang Python SDK")
+    print("====================")
+    print()
+    print("Import this module in your agent scripts:")
+    print()
+    print("  from librefang_sdk import Agent")
+    print()
+    print("  agent = Agent()")
+    print()
+    print("  @agent.on_message")
+    print("  def handle(message, context):")
+    print("      return f'You said: {message}'")
+    print()
+    print("  agent.run()")

librefang_sdk-0.5.4/librefang_sdk.egg-info/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: librefang-sdk
+Version: 0.5.4
+Summary: Official Python client and SDK for the LibreFang Agent OS
+Author-email: LibreFang Team <team@librefang.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://librefang.ai
+Project-URL: Repository, https://github.com/librefang/librefang
+Project-URL: Issues, https://github.com/librefang/librefang/issues
+Keywords: librefang,agent,ai,llm,autonomous-agent,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+Dynamic: requires-python
+
+# LibreFang Python SDK
+
+Official Python client and SDK for the LibreFang Agent OS.
+
+## Installation
+
+```bash
+pip install librefang
+```
+
+## Two Packages
+
+This package provides two different interfaces:
+
+### 1. REST API Client (`librefang.client`)
+
+Control LibreFang remotely via its REST API.
+
+```python
+from librefang import Client
+
+client = Client("http://localhost:4545")
+
+# Create an agent
+agent = client.agents.create(template="assistant")
+print(f"Agent created: {agent['id']}")
+
+# Send a message
+reply = client.agents.message(agent["id"], "Hello!")
+print(reply)
+
+# Stream a response
+for event in client.agents.stream(agent["id"], "Tell me a story"):
+    if event.get("type") == "text_delta":
+        print(event["delta"], end="", flush=True)
+```
+
+### 2. Agent SDK (`librefang.sdk`)
+
+Write Python agents that run inside LibreFang.
+
+```python
+from librefang import Agent
+
+agent = Agent()
+
+@agent.on_message
+def handle(message: str, context: dict) -> str:
+    return f"You said: {message}"
+
+agent.run()
+```
+
+Or use the simple input/output functions:
+
+```python
+from librefang import read_input, respond
+
+data = read_input()
+result = f"Echo: {data['message']}"
+respond(result)
+```
+
+## Examples
+
+See the `examples/` directory for more examples:
+
+### Client Examples
+- `client_basic.py` - Basic REST API usage
+- `client_streaming.py` - Streaming responses
+
+### SDK Examples
+- `echo_agent.py` - Simple echo agent
+
+## Requirements
+
+- Python 3.8+
+
+## License
+
+MIT

librefang_sdk-0.5.4/librefang_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+librefang/__init__.py
+librefang/librefang_client.py
+librefang/librefang_sdk.py
+librefang_sdk.egg-info/PKG-INFO
+librefang_sdk.egg-info/SOURCES.txt
+librefang_sdk.egg-info/dependency_links.txt
+librefang_sdk.egg-info/requires.txt
+librefang_sdk.egg-info/top_level.txt

librefang_sdk-0.5.4/librefang_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

librefang_sdk-0.5.4/librefang_sdk.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest
+pytest-asyncio

librefang_sdk-0.5.4/librefang_sdk.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+librefang
+librefang_client
+librefang_sdk

librefang_sdk-0.5.4/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "librefang-sdk"
+version = "0.5.4"
+description = "Official Python client and SDK for the LibreFang Agent OS"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "LibreFang Team", email = "team@librefang.ai" }
+]
+keywords = ["librefang", "agent", "ai", "llm", "autonomous-agent", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-asyncio",
+]
+
+[project.urls]
+Homepage = "https://librefang.ai"
+Repository = "https://github.com/librefang/librefang"
+Issues = "https://github.com/librefang/librefang/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["librefang*"]
+exclude = ["examples*"]
+
+[tool.setuptools.package-data]
+librefang = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["examples"]
+python_files = ["*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]

librefang_sdk-0.5.4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

librefang_sdk-0.5.4/setup.py

@@ -0,0 +1,14 @@
+from setuptools import setup
+
+setup(
+    name="librefang",
+    version="0.5.4-20260317",
+    description="Official Python client for the LibreFang Agent OS REST API",
+    py_modules=["librefang_sdk", "librefang_client"],
+    python_requires=">=3.8",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)