olw-protocol 1.0.0__tar.gz

olw_protocol-1.0.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: olw-protocol
+Version: 1.0.0
+Summary: The routing protocol for AI agents
+Project-URL: Homepage, https://olw.io
+Project-URL: Repository, https://github.com/gabrielmartin/olw-protocol
+Author-email: Gabriel Martin <gabe@gtll.co>
+License: MIT
+Keywords: agents,ai,discovery,protocol,routing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# OLW — Open Language Wire
+
+The routing protocol for AI agents.
+
+```bash
+pip install olw
+```
+
+```python
+import olw
+
+# Find agents by capability
+agents = olw.query(domain="legal", soul_compatible=True, context_depth="deep")
+
+# Resolve an OLW address
+agent = olw.resolve("soul-guide@gtll.olw")
+
+# Register your agent
+my_agent = olw.Agent(
+    address="my-agent@example.olw",
+    name="My Agent",
+    description="What it does.",
+    endpoint="https://example.com/a2a",
+    fingerprint=olw.fingerprint(
+        domain="legal",
+        task_types=["contract_review"],
+        input_formats=["pdf", "text"],
+        output_formats=["json"],
+        context_depth="deep",
+        latency_class="standard",
+        trust_level="verified",
+        soul_compatible=True,
+    )
+)
+my_agent.register()
+```
+
+## The gap OLW fills
+
+From the A2A specification (verbatim):
+
+> "The current A2A specification does not prescribe a standard API for curated registries."
+
+OLW is that standard. MIT licensed.
+
+---
+*signal 777 · completion*

olw_protocol-1.0.0/README.md

@@ -0,0 +1,47 @@
+# OLW — Open Language Wire
+
+The routing protocol for AI agents.
+
+```bash
+pip install olw
+```
+
+```python
+import olw
+
+# Find agents by capability
+agents = olw.query(domain="legal", soul_compatible=True, context_depth="deep")
+
+# Resolve an OLW address
+agent = olw.resolve("soul-guide@gtll.olw")
+
+# Register your agent
+my_agent = olw.Agent(
+    address="my-agent@example.olw",
+    name="My Agent",
+    description="What it does.",
+    endpoint="https://example.com/a2a",
+    fingerprint=olw.fingerprint(
+        domain="legal",
+        task_types=["contract_review"],
+        input_formats=["pdf", "text"],
+        output_formats=["json"],
+        context_depth="deep",
+        latency_class="standard",
+        trust_level="verified",
+        soul_compatible=True,
+    )
+)
+my_agent.register()
+```
+
+## The gap OLW fills
+
+From the A2A specification (verbatim):
+
+> "The current A2A specification does not prescribe a standard API for curated registries."
+
+OLW is that standard. MIT licensed.
+
+---
+*signal 777 · completion*

olw_protocol-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "olw-protocol"
+version = "1.0.0"
+description = "The routing protocol for AI agents"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "Gabriel Martin", email = "gabe@gtll.co"}]
+keywords = ["ai", "agents", "routing", "protocol", "discovery"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.9"
+dependencies = ["httpx>=0.24.0"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/olw"]
+
+[project.urls]
+Homepage = "https://olw.io"
+Repository = "https://github.com/gabrielmartin/olw-protocol"

olw_protocol-1.0.0/src/olw/__init__.py

@@ -0,0 +1,57 @@
+"""OLW — Open Language Wire. The routing protocol for AI agents."""
+
+__version__ = "1.0.0"
+
+import httpx
+from typing import Optional, List
+
+LOCAL_INDEX = "http://localhost:3778"
+
+class Agent:
+    def __init__(self, address: str, name: str, description: str, endpoint: str,
+                 fingerprint: dict, well_known_url: Optional[str] = None):
+        self.address = address
+        self.name = name
+        self.description = description
+        self.endpoint = endpoint
+        self.fingerprint = fingerprint
+        self.well_known_url = well_known_url
+
+    def register(self, index_url: str = LOCAL_INDEX) -> dict:
+        r = httpx.post(f"{index_url}/register", json={
+            "address": self.address, "name": self.name,
+            "description": self.description, "endpoint": self.endpoint,
+            "fingerprint": self.fingerprint, "well_known_url": self.well_known_url,
+        })
+        return r.json()
+
+    def to_dict(self) -> dict:
+        return {"olw_version": "0.1", "address": self.address, "name": self.name,
+                "description": self.description, "endpoint": self.endpoint,
+                "fingerprint": self.fingerprint}
+
+
+def resolve(address: str, index_url: str = LOCAL_INDEX) -> Optional[dict]:
+    """Resolve an OLW address to agent details."""
+    r = httpx.get(f"{index_url}/resolve", params={"address": address})
+    return None if r.status_code == 404 else r.json()
+
+
+def query(index_url: str = LOCAL_INDEX, **axes) -> List[dict]:
+    """Find agents by capability axes. Example: olw.query(soul_compatible=True, domain='legal')"""
+    params = {k: str(v).lower() if isinstance(v, bool) else v for k, v in axes.items()}
+    r = httpx.get(f"{index_url}/query", params=params)
+    return r.json().get("agents", [])
+
+
+def fingerprint(domain: str, task_types: list, input_formats: list, output_formats: list,
+                context_depth: str = "medium", latency_class: str = "standard",
+                trust_level: str = "authenticated", soul_compatible: bool = False) -> dict:
+    """Build a valid OLW capability fingerprint."""
+    return {"domain": domain, "task_types": task_types,
+            "input_formats": input_formats, "output_formats": output_formats,
+            "context_depth": context_depth, "latency_class": latency_class,
+            "trust_level": trust_level, "soul_compatible": soul_compatible}
+
+
+__all__ = ["Agent", "resolve", "query", "fingerprint", "__version__"]