a1-ai 2.8.0

A1 — The cryptographic identity and authorization layer that turns anonymous AI agents into accountable, verifiable entities. One Identity. Full Provenance.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

"""
a1 + LlamaIndex — research agent with cryptographic chain-of-custody.

Every tool call is authorized against a DyoloPassport before execution.
Run: python examples/integrations/llamaindex_example.py
"""

from __future__ import annotations

import asyncio
import json
from pathlib import Path

# Conditional imports so the example is readable without llama-index installed.
try:
    from llama_index.core.tools import FunctionTool
except ImportError:
    print("Install llama-index-core to run this example.")
    raise

from a1.llamaindex_tool import a1_llamaindex_guard


# 1. Define your research tool functions and guard them.

@a1_llamaindex_guard(passport_path="passport.json", capability="research.web_search")
async def web_search(query: str) -> str:
    """Search the web and return a summary."""
    return f"[authorized] Search results for: {query}"


@a1_llamaindex_guard(passport_path="passport.json", capability="research.summarize")
async def summarize_document(url: str) -> str:
    """Fetch and summarize a document at the given URL."""
    return f"[authorized] Summary of document at: {url}"


# 2. Wrap as LlamaIndex FunctionTools.

web_search_tool = FunctionTool.from_defaults(async_fn=web_search)
summarize_tool = FunctionTool.from_defaults(async_fn=summarize_document)


async def main() -> None:
    # 3. Use the tools in your agent.
    result = await web_search(query="AI agent security frameworks 2025")
    print(result)

    summary = await summarize_document(url="https://example.com/whitepaper.pdf")
    print(summary)


if __name__ == "__main__":
    asyncio.run(main())