Metadata-Version: 2.1
Name: llama-index-tools-zambo
Version: 0.1.3
Summary: Zambo tools for LlamaIndex: tools behind one MCP endpoint (https://zambo.dev/mcp), a verifiable AER-1 receipt for every job, and HANDOVER continuity across AIs.
License: Apache-2.0
Project-URL: Homepage, https://zambo.dev
Project-URL: Add Zambo to your AI, https://zambo.dev/add/
Project-URL: AER-1 standard, https://zambo.dev/aer1/
Project-URL: IETF Draft, https://datatracker.ietf.org/doc/draft-zambo-aer1/26/
Project-URL: Repository, https://gitlab.com/rambozambodotdev/zambo
Project-URL: Issues, https://gitlab.com/rambozambodotdev/zambo/-/issues
Keywords: llama-index,llamahub,zambo,aer-1,mcp,ai-agents,verifiable-receipt,verifiable-receipts,handover,agent-continuity
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: llama-index-core >=0.10.0

# llama-index-tools-zambo

**Zambo: [zambo.dev](https://zambo.dev) | Add Zambo to your AI: [zambo.dev/add/](https://zambo.dev/add/) | AER-1: [zambo.dev/aer1](https://zambo.dev/aer1/)**

Zambo is the verifiable work layer for AI. This package is the LlamaHub native tool integration for LlamaIndex: it wraps the Zambo MCP endpoint and offline AER-1 receipt verification in the standard `BaseToolSpec` idiom, so any LlamaIndex agent can call Zambo tools and check verifiable receipts without leaving the framework.

## What Zambo gives a LlamaIndex agent

- Tools behind one MCP endpoint, https://zambo.dev/mcp.
- HANDOVER, the flagship: wrap up a session in one AI and pick it up in another, with the work, memory, and context carried across.
- A verifiable receipt for every job. A receipt proves the saved result was not changed after the fact. It does not prove the answer was right.
- Offline receipt verification against AER-1, the IETF draft at draft-zambo-aer1-26. The conformance corpus lives at https://zambo.dev/aer1/corpus.json (143 vectors, 146 checks).

Free tier: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. Day Pass: $0.99 for unlimited use for 24 hours. No account and no API key are needed for the free tier.

For one-line AER-1 receipts collected from a running LlamaIndex agent, see the companion package [aer1-llamaindex](https://pypi.org/project/aer1-llamaindex/).

## Install

```bash
pip install llama-index-tools-zambo
```

## Use it

```python
from llama_index.tools.zambo import ZamboToolSpec

spec = ZamboToolSpec()
tools = spec.to_tool_list()

for tool in tools:
    print(tool.metadata.name)
```

The tool spec exposes three functions:

- `list_tools`: list the tools the Zambo MCP endpoint offers.
- `call_tool(tool_name, arguments_json)`: call any Zambo tool by name through the MCP endpoint. Every call returns a verifiable receipt for the job.
- `verify_receipt(receipt_json)`: verify an AER-1 workflow receipt offline. The Merkle root is recomputed from the receipt's own steps and the required fields are checked locally, with no network call and no trust in any server.

## Example: verify a receipt offline

```python
import json
from llama_index.tools.zambo import ZamboToolSpec, merkle_root

steps = [
    {"seq": 1, "receipt_id": "11111111-1111-4111-8111-111111111111", "tool": "search"},
    {"seq": 2, "receipt_id": "22222222-2222-4222-8222-222222222222", "tool": "summarize"},
]
receipt = {
    "type": "verifiable-workflow-receipt",
    "workflow_id": "33333333-3333-4333-8333-333333333333",
    "receipt_id": "44444444-4444-4444-8444-444444444444",
    "merkle_root": merkle_root([s["receipt_id"] for s in steps]),
    "steps": steps,
}

spec = ZamboToolSpec()
print(spec.verify_receipt(json.dumps(receipt)))
# verified: AER-1 workflow receipt 44444444-4444-4444-8444-444444444444 ...
```

## Links

- Zambo: https://zambo.dev
- Add Zambo to your AI: https://zambo.dev/add/
- AER-1 standard: https://zambo.dev/aer1/
- IETF draft: https://datatracker.ietf.org/doc/draft-zambo-aer1/26/
- Verify a receipt: https://zambo.dev/verify/

License: Apache-2.0

## Where these receipts run live: Zambo

llama-index-tools-zambo brings Zambo tools to LlamaIndex agents, every job returning a verifiable AER-1 receipt, and it has been downloaded 663 times on PyPI. The live home of those receipts is Zambo, the verifiable work layer for AI. Connect any AI to the live endpoint at https://zambo.dev/mcp or add Zambo to your AI in one step at https://zambo.dev/add/

Free tier: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. The Day Pass is $0.99 for 24 hours, unlimited.

Install:

    pip install llama-index-tools-zambo
