zambo-llamaindex 0.1.0__tar.gz

zambo_llamaindex-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zambo (zambo.dev)
+
+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.

zambo_llamaindex-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: zambo-llamaindex
+Version: 0.1.0
+Summary: Zambo's 100+ live tools as LlamaIndex FunctionTools. Every call mints a verifiable AER-1 execution receipt.
+Author-email: Zambo <brennanzambo@zambo.dev>
+License: MIT
+Project-URL: Homepage, https://zambo.dev
+Project-URL: Documentation, https://zambo.dev/aer-1/
+Project-URL: Repository, https://zambo.dev
+Keywords: llamaindex,llama-index,agents,ai-agents,zambo,mcp,receipts,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: llama-index-core>=0.10
+Dynamic: license-file
+
+# zambo-llamaindex
+
+Give your LlamaIndex agent Zambo's 100+ live tools. Every tool call is executed by Zambo and mints a **verifiable AER-1 receipt**: a public URL carrying the tool, its arguments, the observed result, a SHA-256 fingerprint, and machine-readable JSON-LD.
+
+```python
+from llama_index.core.agent.workflow import FunctionAgent
+from zambo_llamaindex import zambo_tools
+
+agent = FunctionAgent(
+    name="Zambo assistant",
+    description="Assistant with live Zambo tools.",
+    tools=zambo_tools(["live_price", "prompt_shield"]),
+)
+```
+
+Each `zambo_tool(name)` returns a real `llama_index.core.tools.FunctionTool`. Attach one or a batch to any LlamaIndex agent that accepts tools.
+
+No account. No API key. Free tier: 20 calls per tool per day.
+
+## What the receipt actually proves
+
+Each receipt page (for example `https://zambo.dev/run/<id>`) is Zambo's tamper-evident record that **Zambo executed the tool call itself**: the tool name, the exact arguments your agent sent, the observed result, a timestamp, and a SHA-256 fingerprint of the record, published as JSON-LD. Anyone can re-verify it with no account.
+
+Every tool's output ends with a `Verifiable receipt: <url>` line, so the agent sees the proof next to every call. You can also hook receipts programmatically:
+
+```python
+from zambo_llamaindex import zambo_tool
+
+def on_receipt(tool_name, receipt_url):
+    print(f"[receipt] {tool_name}: {receipt_url}")
+
+price_tool = zambo_tool("live_price", on_receipt=on_receipt)
+```
+
+## Install
+
+```bash
+pip install zambo-llamaindex
+```
+
+## One tool, custom schema
+
+```python
+from zambo_llamaindex import zambo_tool
+
+price_tool = zambo_tool(
+    "live_price",
+    params_json_schema={
+        "type": "object",
+        "properties": {"symbol": {"type": "string"}},
+        "required": ["symbol"],
+    },
+)
+```
+
+Browse the full catalog any time with `zambo_llamaindex.list_tools()`, or pick tools by use case through Zambo's `capability_search` tool.
+
+## Notes
+
+- Zambo calls need no key and no signup. Heavy agent runs (dozens of tool calls) will reach the free daily limit; the tool raises a clear error and the run continues with the other tools.
+- Receipts are public by design. Do not pass secrets as tool arguments.
+
+## Links
+
+- Zambo: https://zambo.dev
+- AER-1 receipt spec: https://zambo.dev/aer-1/
+
+MIT License.

zambo_llamaindex-0.1.0/README.md

@@ -0,0 +1,68 @@
+# zambo-llamaindex
+
+Give your LlamaIndex agent Zambo's 100+ live tools. Every tool call is executed by Zambo and mints a **verifiable AER-1 receipt**: a public URL carrying the tool, its arguments, the observed result, a SHA-256 fingerprint, and machine-readable JSON-LD.
+
+```python
+from llama_index.core.agent.workflow import FunctionAgent
+from zambo_llamaindex import zambo_tools
+
+agent = FunctionAgent(
+    name="Zambo assistant",
+    description="Assistant with live Zambo tools.",
+    tools=zambo_tools(["live_price", "prompt_shield"]),
+)
+```
+
+Each `zambo_tool(name)` returns a real `llama_index.core.tools.FunctionTool`. Attach one or a batch to any LlamaIndex agent that accepts tools.
+
+No account. No API key. Free tier: 20 calls per tool per day.
+
+## What the receipt actually proves
+
+Each receipt page (for example `https://zambo.dev/run/<id>`) is Zambo's tamper-evident record that **Zambo executed the tool call itself**: the tool name, the exact arguments your agent sent, the observed result, a timestamp, and a SHA-256 fingerprint of the record, published as JSON-LD. Anyone can re-verify it with no account.
+
+Every tool's output ends with a `Verifiable receipt: <url>` line, so the agent sees the proof next to every call. You can also hook receipts programmatically:
+
+```python
+from zambo_llamaindex import zambo_tool
+
+def on_receipt(tool_name, receipt_url):
+    print(f"[receipt] {tool_name}: {receipt_url}")
+
+price_tool = zambo_tool("live_price", on_receipt=on_receipt)
+```
+
+## Install
+
+```bash
+pip install zambo-llamaindex
+```
+
+## One tool, custom schema
+
+```python
+from zambo_llamaindex import zambo_tool
+
+price_tool = zambo_tool(
+    "live_price",
+    params_json_schema={
+        "type": "object",
+        "properties": {"symbol": {"type": "string"}},
+        "required": ["symbol"],
+    },
+)
+```
+
+Browse the full catalog any time with `zambo_llamaindex.list_tools()`, or pick tools by use case through Zambo's `capability_search` tool.
+
+## Notes
+
+- Zambo calls need no key and no signup. Heavy agent runs (dozens of tool calls) will reach the free daily limit; the tool raises a clear error and the run continues with the other tools.
+- Receipts are public by design. Do not pass secrets as tool arguments.
+
+## Links
+
+- Zambo: https://zambo.dev
+- AER-1 receipt spec: https://zambo.dev/aer-1/
+
+MIT License.

zambo_llamaindex-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zambo-llamaindex"
+version = "0.1.0"
+description = "Zambo's 100+ live tools as LlamaIndex FunctionTools. Every call mints a verifiable AER-1 execution receipt."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Zambo", email = "brennanzambo@zambo.dev" }]
+keywords = ["llamaindex", "llama-index", "agents", "ai-agents", "zambo", "mcp", "receipts", "verification"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "llama-index-core>=0.10",
+]
+optional-dependencies = {}
+
+[project.urls]
+Homepage = "https://zambo.dev"
+Documentation = "https://zambo.dev/aer-1/"
+Repository = "https://zambo.dev"
+
+[tool.setuptools.packages.find]
+where = ["src"]

zambo_llamaindex-0.1.0/setup.cfg

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

zambo_llamaindex-0.1.0/src/zambo_llamaindex/__init__.py

@@ -0,0 +1,21 @@
+"""Zambo's 100+ live tools as LlamaIndex FunctionTools.
+
+Every tool call is executed by Zambo (https://zambo.dev/api/mcp) and mints a
+verifiable AER-1 receipt: a public URL carrying the tool, its arguments, the
+observed result, a SHA-256 fingerprint, and machine-readable JSON-LD.
+"""
+
+from .client import ZamboReceipt, ZamboResult, call_tool, list_tools
+from .tools import lookup_receipt, zambo_tool, zambo_tools
+
+__all__ = [
+    "zambo_tool",
+    "zambo_tools",
+    "lookup_receipt",
+    "call_tool",
+    "list_tools",
+    "ZamboReceipt",
+    "ZamboResult",
+]
+
+__version__ = "0.1.0"

zambo_llamaindex-0.1.0/src/zambo_llamaindex/client.py

@@ -0,0 +1,109 @@
+"""Minimal Zambo MCP client over plain JSON-RPC.
+
+Pure stdlib (urllib), no third-party dependencies. Talks to the live
+https://zambo.dev/api/mcp endpoint: no auth, no account, free tier.
+"""
+
+from __future__ import annotations
+
+import json
+import http.client
+import time
+import urllib.error
+import urllib.request
+from dataclasses import dataclass, field
+
+MCP_URL = "https://zambo.dev/api/mcp"
+_TIMEOUT = 60
+_MAX_ATTEMPTS = 6
+
+
+@dataclass
+class ZamboReceipt:
+    """A verifiable AER-1 execution receipt minted by a Zambo tool call."""
+
+    id: str
+    url: str
+    status: str = ""
+    tool: str = ""
+
+
+@dataclass
+class ZamboResult:
+    text: str
+    receipt: ZamboReceipt | None = None
+    raw: dict = field(default_factory=dict)
+
+
+def _post(payload: dict) -> dict:
+    body = json.dumps(payload).encode("utf-8")
+    last_error: Exception | None = None
+    for attempt in range(_MAX_ATTEMPTS):
+        request = urllib.request.Request(
+            MCP_URL,
+            data=body,
+            headers={"Content-Type": "application/json", "Accept": "application/json"},
+            method="POST",
+        )
+        try:
+            with urllib.request.urlopen(request, timeout=_TIMEOUT) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except (
+            urllib.error.URLError,
+            ConnectionError,
+            TimeoutError,
+            json.JSONDecodeError,
+            http.client.IncompleteRead,
+            http.client.RemoteDisconnected,
+            http.client.BadStatusLine,
+        ) as exc:
+            last_error = exc
+            time.sleep(1.5 * (attempt + 1))
+    raise RuntimeError(f"Zambo API call failed after {_MAX_ATTEMPTS} attempts: {last_error}")
+
+
+def call_tool(tool_name: str, arguments: dict) -> ZamboResult:
+    """Call a Zambo MCP tool and return its result plus the receipt.
+
+    Every call mints a verifiable AER-1 receipt: a public URL carrying the
+    tool, arguments, observed result, SHA-256 fingerprint, and JSON-LD.
+    """
+    response = _post(
+        {
+            "jsonrpc": "2.0",
+            "id": f"zambo-llamaindex-{int(time.time() * 1000)}",
+            "method": "tools/call",
+            "params": {"name": tool_name, "arguments": arguments},
+        }
+    )
+    if "error" in response:
+        raise RuntimeError(f"Zambo tool '{tool_name}' error: {response['error']}")
+
+    result = response.get("result", {})
+    receipt_data = result.get("_receipt", {}) or {}
+
+    receipt = None
+    receipt_id = receipt_data.get("id")
+    if receipt_id:
+        receipt = ZamboReceipt(
+            id=receipt_id,
+            url=receipt_data.get("audit") or f"https://zambo.dev/run/{receipt_id}",
+            status=receipt_data.get("status", ""),
+            tool=receipt_data.get("tool", tool_name),
+        )
+
+    text_parts = []
+    for item in result.get("content", []) or []:
+        if isinstance(item, dict) and "text" in item:
+            text_parts.append(str(item["text"]))
+    text = "\n".join(text_parts).strip()
+
+    return ZamboResult(text=text, receipt=receipt, raw=result)
+
+
+def list_tools() -> list[dict]:
+    """Return the live Zambo tool catalog (name + description)."""
+    response = _post({"jsonrpc": "2.0", "id": "zambo-tools-list", "method": "tools/list", "params": {}})
+    if "error" in response:
+        raise RuntimeError(f"Zambo tools/list error: {response['error']}")
+    return response.get("result", {}).get("tools", []) or []

zambo_llamaindex-0.1.0/src/zambo_llamaindex/tools.py

@@ -0,0 +1,117 @@
+"""LlamaIndex FunctionTools backed by live Zambo execution.
+
+Each tool below is a real llama_index.core.tools.FunctionTool. When the agent
+invokes it, the call is executed by Zambo (https://zambo.dev/api/mcp) and
+mints a verifiable AER-1 receipt: public URL, tool, arguments, observed
+result, SHA-256 fingerprint, machine-readable JSON-LD.
+"""
+
+from __future__ import annotations
+
+import json
+import threading
+import time
+from typing import Any, Callable
+
+from . import client as _client
+
+# (tool_name, arguments_json) -> (receipt_url, finished_at). Written by the
+# tool wrapper on every invocation. Thread-safe.
+_invocation_registry: dict[tuple[str, str], tuple[str, float]] = {}
+_registry_lock = threading.Lock()
+
+
+def _record_invocation(tool_name: str, arguments_json: str, receipt_url: str) -> None:
+    with _registry_lock:
+        _invocation_registry[(tool_name, arguments_json)] = (receipt_url, time.time())
+
+
+def lookup_receipt(tool_name: str, arguments_json: str) -> str | None:
+    """Return the most recent receipt URL for a (tool, args) invocation."""
+    with _registry_lock:
+        entry = _invocation_registry.get((tool_name, arguments_json))
+    return entry[0] if entry else None
+
+
+_TYPE_MAP = {
+    "string": str,
+    "number": float,
+    "integer": int,
+    "boolean": bool,
+    "array": list,
+    "object": dict,
+}
+
+
+def _json_schema_to_model(tool_name: str, schema: dict):
+    """Build a pydantic model from a simple JSON object schema.
+
+    Maps property types via _TYPE_MAP; properties listed in `required` have
+    no default, all others default to None. Only object-type schemas are
+    supported; Zambo validates arguments server-side.
+    """
+    from pydantic import create_model
+
+    properties = schema.get("properties", {}) or {}
+    required = set(schema.get("required", []) or [])
+    fields: dict = {}
+    for prop, spec in properties.items():
+        spec = spec if isinstance(spec, dict) else {}
+        py_type = _TYPE_MAP.get(spec.get("type", "string"), str)
+        if prop in required:
+            fields[prop] = (py_type, ...)
+        else:
+            fields[prop] = (py_type | None, None)
+    return create_model(f"{tool_name}_args", **fields)  # type: ignore[call-overload]
+
+
+def zambo_tool(
+    tool_name: str,
+    description: str | None = None,
+    params_json_schema: dict | None = None,
+    on_receipt: Callable[[str, str], Any] | None = None,
+):
+    """Build a LlamaIndex FunctionTool backed by a Zambo MCP tool.
+
+    Args:
+        tool_name: Name of the Zambo tool (see client.list_tools(), e.g.
+            "live_price", "ghost_audit_site", "prompt_shield").
+        description: Override the tool description shown to the model.
+        params_json_schema: Override the JSON schema for the tool's arguments.
+            Defaults to a permissive object schema; Zambo validates server-side.
+        on_receipt: Optional callback invoked as on_receipt(tool_name,
+            receipt_url) after every successful invocation.
+    """
+    from llama_index.core.tools import FunctionTool  # local import: llama-index is a dependency
+
+    def _invoke(**kwargs: Any) -> str:
+        arguments = dict(kwargs)
+        result = _client.call_tool(tool_name, arguments)
+
+        receipt_url = result.receipt.url if result.receipt else ""
+        if receipt_url:
+            _record_invocation(tool_name, json.dumps(arguments, sort_keys=True), receipt_url)
+            if on_receipt is not None:
+                on_receipt(tool_name, receipt_url)
+
+        output = result.text or "(empty result)"
+        if receipt_url:
+            output += f"\n\nVerifiable receipt: {receipt_url}"
+        return output
+
+    fn_schema = None
+    if params_json_schema is not None:
+        fn_schema = _json_schema_to_model(tool_name, params_json_schema)
+
+    return FunctionTool.from_defaults(
+        fn=_invoke,
+        name=tool_name,
+        description=description
+        or f"Zambo tool '{tool_name}' (zambo.dev). Every call mints a verifiable execution receipt.",
+        fn_schema=fn_schema,
+    )
+
+
+def zambo_tools(tool_names: list[str], **kwargs: Any) -> list:
+    """Build several Zambo-backed FunctionTools at once."""
+    return [zambo_tool(name, **kwargs) for name in tool_names]

zambo_llamaindex-0.1.0/src/zambo_llamaindex.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: zambo-llamaindex
+Version: 0.1.0
+Summary: Zambo's 100+ live tools as LlamaIndex FunctionTools. Every call mints a verifiable AER-1 execution receipt.
+Author-email: Zambo <brennanzambo@zambo.dev>
+License: MIT
+Project-URL: Homepage, https://zambo.dev
+Project-URL: Documentation, https://zambo.dev/aer-1/
+Project-URL: Repository, https://zambo.dev
+Keywords: llamaindex,llama-index,agents,ai-agents,zambo,mcp,receipts,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: llama-index-core>=0.10
+Dynamic: license-file
+
+# zambo-llamaindex
+
+Give your LlamaIndex agent Zambo's 100+ live tools. Every tool call is executed by Zambo and mints a **verifiable AER-1 receipt**: a public URL carrying the tool, its arguments, the observed result, a SHA-256 fingerprint, and machine-readable JSON-LD.
+
+```python
+from llama_index.core.agent.workflow import FunctionAgent
+from zambo_llamaindex import zambo_tools
+
+agent = FunctionAgent(
+    name="Zambo assistant",
+    description="Assistant with live Zambo tools.",
+    tools=zambo_tools(["live_price", "prompt_shield"]),
+)
+```
+
+Each `zambo_tool(name)` returns a real `llama_index.core.tools.FunctionTool`. Attach one or a batch to any LlamaIndex agent that accepts tools.
+
+No account. No API key. Free tier: 20 calls per tool per day.
+
+## What the receipt actually proves
+
+Each receipt page (for example `https://zambo.dev/run/<id>`) is Zambo's tamper-evident record that **Zambo executed the tool call itself**: the tool name, the exact arguments your agent sent, the observed result, a timestamp, and a SHA-256 fingerprint of the record, published as JSON-LD. Anyone can re-verify it with no account.
+
+Every tool's output ends with a `Verifiable receipt: <url>` line, so the agent sees the proof next to every call. You can also hook receipts programmatically:
+
+```python
+from zambo_llamaindex import zambo_tool
+
+def on_receipt(tool_name, receipt_url):
+    print(f"[receipt] {tool_name}: {receipt_url}")
+
+price_tool = zambo_tool("live_price", on_receipt=on_receipt)
+```
+
+## Install
+
+```bash
+pip install zambo-llamaindex
+```
+
+## One tool, custom schema
+
+```python
+from zambo_llamaindex import zambo_tool
+
+price_tool = zambo_tool(
+    "live_price",
+    params_json_schema={
+        "type": "object",
+        "properties": {"symbol": {"type": "string"}},
+        "required": ["symbol"],
+    },
+)
+```
+
+Browse the full catalog any time with `zambo_llamaindex.list_tools()`, or pick tools by use case through Zambo's `capability_search` tool.
+
+## Notes
+
+- Zambo calls need no key and no signup. Heavy agent runs (dozens of tool calls) will reach the free daily limit; the tool raises a clear error and the run continues with the other tools.
+- Receipts are public by design. Do not pass secrets as tool arguments.
+
+## Links
+
+- Zambo: https://zambo.dev
+- AER-1 receipt spec: https://zambo.dev/aer-1/
+
+MIT License.

zambo_llamaindex-0.1.0/src/zambo_llamaindex.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/zambo_llamaindex/__init__.py
+src/zambo_llamaindex/client.py
+src/zambo_llamaindex/tools.py
+src/zambo_llamaindex.egg-info/PKG-INFO
+src/zambo_llamaindex.egg-info/SOURCES.txt
+src/zambo_llamaindex.egg-info/dependency_links.txt
+src/zambo_llamaindex.egg-info/requires.txt
+src/zambo_llamaindex.egg-info/top_level.txt

zambo_llamaindex-0.1.0/src/zambo_llamaindex.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zambo_llamaindex-0.1.0/src/zambo_llamaindex.egg-info/requires.txt

@@ -0,0 +1 @@
+llama-index-core>=0.10

zambo_llamaindex-0.1.0/src/zambo_llamaindex.egg-info/top_level.txt

@@ -0,0 +1 @@
+zambo_llamaindex