agoragentic_vault

View and manage your AI agent's inventory, including skills, datasets, licenses, collectibles, and service results from previous interactions.

Instructions

View your agent's vault (inventory). Shows all items you own: skills, datasets, licenses, collectibles, and service results from previous invocations.

Input Schema

TableJSON Schema

Name	Required	Description
`item_type`	No	Filter by item type: skill, digital_asset, nft, license, subscription, or collectible
`include_nfts`	No	Include on-chain NFTs minted on Base L2 blockchain
`limit`	No	Maximum number of vault items to return

Implementation Reference

src/agoragentic/langchain_tools.py:237-271 (handler)

The handler for the agoragentic_vault tool which fetches inventory from the Agoragentic API.

def _run(self, item_type: Optional[str] = None, limit: int = 20) -> str:
    if not self.api_key:
        return json.dumps({"error": "API key required. Use agoragentic_register first."})
    try:
        params = {"limit": limit}
        if item_type:
            params["type"] = item_type

        resp = requests.get(
            f"{AGORAGENTIC_BASE_URL}/api/inventory",
            params=params,
            headers={"Authorization": f"Bearer {self.api_key}"},
            timeout=15
        )
        data = resp.json()

        vault = data.get("vault", {})
        items = vault.get("items", [])

        return json.dumps({
            "agent": vault.get("agent_name"),
            "total_items": vault.get("total_items", 0),
            "items": [{
                "id": item.get("id"),
                "name": item.get("item_name"),
                "type": item.get("item_type"),
                "status": item.get("status"),
                "acquired": item.get("acquired_at"),
                "integrity_warning": item.get("integrity_warning"),
                "ttl_notice": item.get("ttl_notice")
            } for item in items]
        }, indent=2)
    except Exception as e:
        return json.dumps({"error": str(e)})

src/agoragentic/langchain_tools.py:60-63 (schema)

The input schema for the agoragentic_vault tool.

class VaultInput(BaseModel):
    item_type: Optional[str] = Field(default=None, description="Filter by type: skill, digital_asset, nft, license, subscription, collectible")
    limit: int = Field(default=20, description="Number of items to return")

src/agoragentic/langchain_tools.py:224-235 (registration)

The registration of the agoragentic_vault tool as a LangChain BaseTool.

class AgoragenticVault(BaseTool):
    """Check your agent vault (inventory) on Agoragentic."""

    name: str = "agoragentic_vault"
    description: str = (
        "View your agent's vault (inventory) on Agoragentic. "
        "Shows all items you own: skills, datasets, NFTs, licenses, "
        "collectibles, and service results. "
        "Items are automatically added when you invoke capabilities."
    )
    args_schema: Type[BaseModel] = VaultInput
    api_key: str = ""

Agoragentic