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
58
59
60
61

"""
AutoGen v0.4+ integration for a1.

Uses the autogen_core `FunctionTool` API for agentchat.
Requires: ``pip install autogen-agentchat autogen-core``
"""

from __future__ import annotations

import functools
from typing import Any, Callable, Dict, Optional, TypeVar

from autogen_core.tools import FunctionTool
from .client import A1Client

F = TypeVar("F", bound=Callable[..., Any])


def build_a1_function_tool(
    fn: F,
    chain: Any,
    executor_pk_hex: str,
    intent_name: str,
    intent_params: Optional[Dict[str, str]] = None,
    gateway_url: Optional[str] = None,
    name: Optional[str] = None,
    description: Optional[str] = None,
) -> FunctionTool:
    """
    Build an AutoGen v0.4 FunctionTool with a a1 authorization gate.

    Args:
        fn:              The underlying tool function to execute.
        chain:           The serialized delegation chain (``SignedChain`` dict or JSON).
        executor_pk_hex: Hex-encoded Ed25519 public key of the executing agent.
        intent_name:     The intent action name to verify (e.g. ``"trade.equity"``).
        intent_params:   Optional intent parameter bindings.
        gateway_url:     Gateway base URL (default: ``A1_GATEWAY_URL`` env).
        name:            Optional tool name override.
        description:     Optional tool description override.

    Returns:
        An ``autogen_core.tools.FunctionTool`` instance ready for agent registration.
    """
    client = A1Client(gateway_url)

    @functools.wraps(fn)
    def wrapper(*args: Any, **kwargs: Any) -> Any:
        client.authorize(
            chain=chain,
            intent_name=intent_name,
            executor_pk_hex=executor_pk_hex,
            intent_params=intent_params,
        )
        return fn(*args, **kwargs)

    return FunctionTool(
        wrapper,
        name=name or fn.__name__,
        description=description or fn.__doc__ or "Authorized tool",
    )