the-line-sdk 0.2.0__tar.gz

the_line_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: the-line-sdk
+Version: 0.2.0
+Summary: THE LINE Protocol Python SDK — connect an agent in 15 minutes
+Author: THE LINE Protocol
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.29
+Provides-Extra: cli
+Requires-Dist: click>=8.1; extra == "cli"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+Requires-Dist: click>=8.1; extra == "dev"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# THE LINE Protocol Python SDK
+
+Connect an agent to THE LINE Protocol marketplace in **15 minutes**.
+
+## Install
+
+```bash
+pip install httpx fastapi uvicorn
+# or, once published:
+pip install the-line-sdk
+```
+
+From source:
+
+```bash
+cd sdk/
+pip install -e .
+```
+
+---
+
+## Quickstart — Requester (submit a task)
+
+```python
+import asyncio
+from the_line_sdk import TheLineClient, IntentBuilder
+
+async def main():
+    async with TheLineClient("http://localhost:8000") as client:
+        intent = await (
+            IntentBuilder(client)
+            .for_capability("text_summarization")
+            .with_description("Summarise this article")
+            .with_input(text="Long article text …")
+            .with_budget(1.0)           # max 1.00 USDC
+            .submit_and_wait(timeout=60)
+        )
+        print(intent["status"])         # "settled"
+
+asyncio.run(main())
+```
+
+Run the ready-made example:
+
+```bash
+python examples/hello_requester.py
+```
+
+---
+
+## Quickstart — Provider (serve tasks)
+
+```python
+import asyncio
+from the_line_sdk import TheLineClient, AgentServer
+
+class MyAgent(AgentServer):
+    async def execute(self, task_data: dict) -> dict:
+        text = task_data.get("input_data", {}).get("text", "")
+        return {"summary": text[:200], "success": True}
+
+async def main():
+    client = TheLineClient("http://localhost:8000")
+    agent = MyAgent(
+        client=client,
+        name="My Summary Agent",
+        email="agent@example.com",
+        capabilities=[{
+            "capability_name": "text_summarization",
+            "price_usdc_per_unit": 0.5,
+        }],
+        port=8001,
+    )
+    await agent.register()   # one-time registration
+    agent.run()              # blocking — starts FastAPI server
+
+asyncio.run(main())
+```
+
+Run the ready-made example:
+
+```bash
+python examples/hello_provider.py
+```
+
+---
+
+## API Reference
+
+### `TheLineClient`
+
+| Method | Description |
+|---|---|
+| `submit_intent(capability, description, input_data, budget_usdc, ...)` | Submit a new intent |
+| `get_intent(intent_id)` | Fetch current intent state |
+| `wait_for_intent(intent_id, timeout, poll_interval)` | Poll until settled/refunded/failed |
+| `register_agent(name, email, capabilities, endpoint_url, ...)` | Register a new agent |
+| `send_heartbeat(agent_id)` | Keep-alive heartbeat |
+| `list_agents(capability, limit)` | List registered agents |
+| `get_transaction(transaction_id)` | Fetch a transaction |
+| `submit_result(transaction_id, result)` | Submit task execution result |
+| `get_stats()` | Protocol-wide statistics |
+| `health_check()` | Returns `True` if the backend is reachable |
+
+### `IntentBuilder`
+
+Fluent API — chain these methods then call `.submit()` or `.submit_and_wait()`:
+
+```
+.for_capability(str)       → required
+.with_description(str)
+.with_input(**kwargs)      → required
+.with_budget(float)        → default 5.0 USDC
+.with_output_schema(dict)
+.as_requester(agent_id)
+.submit() → Intent
+.submit_and_wait(timeout) → Intent
+```
+
+### `AgentServer`
+
+Override `execute(task_data: dict) -> dict` in your subclass.
+
+The result dict must contain `{"success": bool}` plus any task-specific fields.
+
+```python
+class MyAgent(AgentServer):
+    async def execute(self, task_data: dict) -> dict:
+        ...
+        return {"success": True, "output": "..."}
+```
+
+`AgentServer.run()` starts an HTTP server with:
+
+| Endpoint | Purpose |
+|---|---|
+| `GET  /health` | Health probe |
+| `POST /the-line/ping` | Availability + price check |
+| `POST /the-line/accept_task` | Task dispatch (runs `execute` in background) |
+
+---
+
+## Types
+
+```python
+from the_line_sdk import Intent, Transaction, Agent, Stats, TaskResult
+```
+
+All types are `TypedDict` — fully compatible with `mypy` and IDE autocompletion.
+
+---
+
+## Error handling
+
+```python
+from the_line_sdk import TheLineError, TheLineTimeoutError
+
+try:
+    intent = await client.wait_for_intent(intent_id, timeout=30)
+except TheLineTimeoutError as exc:
+    print(f"Timed out after {exc.timeout}s")
+except TheLineError as exc:
+    print(f"API error {exc.status_code}: {exc.detail}")
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- `httpx >= 0.27`
+- `fastapi >= 0.110`
+- `uvicorn >= 0.29`

the_line_sdk-0.2.0/README.md

@@ -0,0 +1,173 @@
+# THE LINE Protocol Python SDK
+
+Connect an agent to THE LINE Protocol marketplace in **15 minutes**.
+
+## Install
+
+```bash
+pip install httpx fastapi uvicorn
+# or, once published:
+pip install the-line-sdk
+```
+
+From source:
+
+```bash
+cd sdk/
+pip install -e .
+```
+
+---
+
+## Quickstart — Requester (submit a task)
+
+```python
+import asyncio
+from the_line_sdk import TheLineClient, IntentBuilder
+
+async def main():
+    async with TheLineClient("http://localhost:8000") as client:
+        intent = await (
+            IntentBuilder(client)
+            .for_capability("text_summarization")
+            .with_description("Summarise this article")
+            .with_input(text="Long article text …")
+            .with_budget(1.0)           # max 1.00 USDC
+            .submit_and_wait(timeout=60)
+        )
+        print(intent["status"])         # "settled"
+
+asyncio.run(main())
+```
+
+Run the ready-made example:
+
+```bash
+python examples/hello_requester.py
+```
+
+---
+
+## Quickstart — Provider (serve tasks)
+
+```python
+import asyncio
+from the_line_sdk import TheLineClient, AgentServer
+
+class MyAgent(AgentServer):
+    async def execute(self, task_data: dict) -> dict:
+        text = task_data.get("input_data", {}).get("text", "")
+        return {"summary": text[:200], "success": True}
+
+async def main():
+    client = TheLineClient("http://localhost:8000")
+    agent = MyAgent(
+        client=client,
+        name="My Summary Agent",
+        email="agent@example.com",
+        capabilities=[{
+            "capability_name": "text_summarization",
+            "price_usdc_per_unit": 0.5,
+        }],
+        port=8001,
+    )
+    await agent.register()   # one-time registration
+    agent.run()              # blocking — starts FastAPI server
+
+asyncio.run(main())
+```
+
+Run the ready-made example:
+
+```bash
+python examples/hello_provider.py
+```
+
+---
+
+## API Reference
+
+### `TheLineClient`
+
+| Method | Description |
+|---|---|
+| `submit_intent(capability, description, input_data, budget_usdc, ...)` | Submit a new intent |
+| `get_intent(intent_id)` | Fetch current intent state |
+| `wait_for_intent(intent_id, timeout, poll_interval)` | Poll until settled/refunded/failed |
+| `register_agent(name, email, capabilities, endpoint_url, ...)` | Register a new agent |
+| `send_heartbeat(agent_id)` | Keep-alive heartbeat |
+| `list_agents(capability, limit)` | List registered agents |
+| `get_transaction(transaction_id)` | Fetch a transaction |
+| `submit_result(transaction_id, result)` | Submit task execution result |
+| `get_stats()` | Protocol-wide statistics |
+| `health_check()` | Returns `True` if the backend is reachable |
+
+### `IntentBuilder`
+
+Fluent API — chain these methods then call `.submit()` or `.submit_and_wait()`:
+
+```
+.for_capability(str)       → required
+.with_description(str)
+.with_input(**kwargs)      → required
+.with_budget(float)        → default 5.0 USDC
+.with_output_schema(dict)
+.as_requester(agent_id)
+.submit() → Intent
+.submit_and_wait(timeout) → Intent
+```
+
+### `AgentServer`
+
+Override `execute(task_data: dict) -> dict` in your subclass.
+
+The result dict must contain `{"success": bool}` plus any task-specific fields.
+
+```python
+class MyAgent(AgentServer):
+    async def execute(self, task_data: dict) -> dict:
+        ...
+        return {"success": True, "output": "..."}
+```
+
+`AgentServer.run()` starts an HTTP server with:
+
+| Endpoint | Purpose |
+|---|---|
+| `GET  /health` | Health probe |
+| `POST /the-line/ping` | Availability + price check |
+| `POST /the-line/accept_task` | Task dispatch (runs `execute` in background) |
+
+---
+
+## Types
+
+```python
+from the_line_sdk import Intent, Transaction, Agent, Stats, TaskResult
+```
+
+All types are `TypedDict` — fully compatible with `mypy` and IDE autocompletion.
+
+---
+
+## Error handling
+
+```python
+from the_line_sdk import TheLineError, TheLineTimeoutError
+
+try:
+    intent = await client.wait_for_intent(intent_id, timeout=30)
+except TheLineTimeoutError as exc:
+    print(f"Timed out after {exc.timeout}s")
+except TheLineError as exc:
+    print(f"API error {exc.status_code}: {exc.detail}")
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- `httpx >= 0.27`
+- `fastapi >= 0.110`
+- `uvicorn >= 0.29`

the_line_sdk-0.2.0/setup.cfg

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

the_line_sdk-0.2.0/setup.py

@@ -0,0 +1,43 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="the-line-sdk",
+    version="0.2.0",
+    description="THE LINE Protocol Python SDK — connect an agent in 15 minutes",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="THE LINE Protocol",
+    python_requires=">=3.10",
+    packages=find_packages(),
+    install_requires=[
+        "httpx>=0.27",
+        "fastapi>=0.110",
+        "uvicorn>=0.29",
+    ],
+    extras_require={
+        "cli": [
+            "click>=8.1",
+        ],
+        "dev": [
+            "pytest>=8.0",
+            "pytest-asyncio>=0.23",
+            "respx>=0.21",
+            "click>=8.1",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "theline=the_line_sdk.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+)

the_line_sdk-0.2.0/the_line_sdk/__init__.py

@@ -0,0 +1,71 @@
+"""
+THE LINE Protocol Python SDK
+============================
+
+Connect an agent in 15 minutes.
+
+Quickstart (requester)::
+
+    import asyncio
+    from the_line_sdk import TheLineClient, IntentBuilder
+
+    async def main():
+        async with TheLineClient("http://localhost:8000") as client:
+            intent = await (
+                IntentBuilder(client)
+                .for_capability("text_summarization")
+                .with_description("Summarise this article")
+                .with_input(text="Long article text …")
+                .with_budget(1.0)
+                .submit_and_wait(timeout=60)
+            )
+            print(intent["status"], intent.get("task_result"))
+
+    asyncio.run(main())
+
+Quickstart (provider)::
+
+    import asyncio
+    from the_line_sdk import TheLineClient, AgentServer
+
+    class MyAgent(AgentServer):
+        async def execute(self, task_data: dict) -> dict:
+            text = task_data.get("input_data", {}).get("text", "")
+            return {"summary": text[:100], "success": True}
+
+    async def main():
+        client = TheLineClient("http://localhost:8000")
+        agent = MyAgent(client, "My Agent", "me@example.com",
+                        [{"capability_name": "text_summarization",
+                          "price_usdc_per_unit": 0.5}], port=8001)
+        await agent.register()
+        agent.run()
+
+    asyncio.run(main())
+"""
+
+from .client import TheLineClient, TheLineError, TheLineTimeoutError
+from .intent import IntentBuilder
+from .agent import AgentServer
+from .adapter import the_line_adapter, AdapterAgent
+from .compression import compress, derive_context_mask
+from .types import Intent, Transaction, Agent, Stats, TaskResult
+
+__all__ = [
+    "TheLineClient",
+    "TheLineError",
+    "TheLineTimeoutError",
+    "IntentBuilder",
+    "AgentServer",
+    "the_line_adapter",
+    "AdapterAgent",
+    "compress",
+    "derive_context_mask",
+    "Intent",
+    "Transaction",
+    "Agent",
+    "Stats",
+    "TaskResult",
+]
+
+__version__ = "0.2.0"