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
55
56
57

"""
a1 + LangGraph — stateful agent graph with per-node authorization.

Each graph node that modifies state is guarded by a a1 passport check.
Run: python examples/integrations/langgraph_example.py
"""

from __future__ import annotations

import asyncio
from typing import TypedDict

from a1.langgraph_tool import a1_node


class TradingState(TypedDict):
    symbol: str
    quantity: int
    authorized: bool
    result: str


# 1. Guard individual nodes.

@a1_node(passport_path="passport.json", capability="trade.equity")
async def execute_trade_node(state: TradingState) -> dict:  # type: ignore[type-arg]
    """Execute a trade — only runs after a1 authorization."""
    return {
        **state,
        "authorized": True,
        "result": f"Traded {state['quantity']} shares of {state['symbol']}",
    }


@a1_node(passport_path="passport.json", capability="portfolio.read")
async def read_portfolio_node(state: TradingState) -> dict:  # type: ignore[type-arg]
    """Read portfolio — authorized separately from the trade node."""
    return {**state, "result": "Portfolio: [...]"}


async def main() -> None:
    state: TradingState = {
        "symbol": "ACME",
        "quantity": 100,
        "authorized": False,
        "result": "",
    }

    state = await execute_trade_node(state)  # type: ignore[assignment]
    print(state["result"])

    state = await read_portfolio_node(state)  # type: ignore[assignment]
    print(state["result"])


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