Usage

from reygrid import ReyGrid

client = ReyGrid(api_key="your-api-key")

reply = client.chat(
    "{AgentId}",
    "Check my current subscription",
    user_id="user-42",
    tools=[{
        "type": "function",
        "function": {
            "name": "check_subscription",
            "instructions": "Opens the customer's current plan, renewal date, and payment status.",
            "parameters": {
                "type": "object",
                "properties": {"userId": {"type": "string", "description": "The customer user id"}},
                "required": ["userId"],
            },
        },
    }],
)

print(reply.output.reply.content)
print(reply.output.finish_reason, reply.messageId, reply.conversationId)
print(reply.usage.credits)

import json

reply = client.chat(
    "{AgentId}",
    "What is the status of my account?",
    user_id="user-42",
    tools=[check_subscription_tool],
    results=[{
        "toolCallId": "call_xyz",
        "output": json.dumps({"plan": "pro", "status": "active"}),
    }],
)

res = client.list_conversations("{AgentId}", page=1, size=20)
for c in res.conversations:
    print(c.conversationId, c.userId, c.messagesCount, c.createdAt)
print(res.pagination.hasNextPage, res.pagination.totalConversations)

res = client.delete_conversation("{AgentId}", "user-42")
print(res.deletedMessages.count)

res = client.list_messages("{AgentId}", "user-42", page=1, size=50)
for m in res.messages:
    print(m.role, m.content)
    for call in m.tool_calls or []:
        print("  tool call:", call.id, call.function.name, call.status)

res = client.delete_message("{AgentId}", "user-42", "MESSAGE_ID", cascade=True)
print(res.deletedMessages.count)

res = client.cancel_tool_call("{AgentId}", "user-42", "call_xyz")
print(res.canceled)

agents = client.list_agents().agents  # the agents this key can use
agent = client.get_agent("{AgentId}").agent
print(agent.sources, agent.storage.used, agent.storage.limit)

client.update_agent("{AgentId}", instructions="Answer in a friendly tone.")

client.add_text_source("{AgentId}", "Refund policy", "…")
client.add_qa_source("{AgentId}", "Do you ship abroad?", "…")
client.upload_file("{AgentId}", "handbook.pdf")
print(client.crawl_website("{AgentId}", "https://docs.example.com").pagesCrawled)

sources = client.list_sources("{AgentId}", type="text", search="refund").sources
client.delete_source("{AgentId}", sources[0].id)

results = client.search("{AgentId}", "How do I get a refund?", limit=3).results

client.rate_message("{AgentId}", "user-42", "msg_abc123", "up")

models = client.list_models().models
report = client.get_usage_report(days=7)  # balance, totals, daily, agents
print(report.period.from_)  # "from" is exposed as from_

for page in client.paginate_conversations("{AgentId}", size=50):
    for convo in page.data:
        print(convo.conversationId, convo.messagesCount)

for page in client.paginate_messages("{AgentId}", "user-42"):
    for msg in page.data:
        print(msg.role, msg.content)

async for page in client.async_paginate_conversations("{AgentId}"):
    for convo in page.data:
        print(convo.conversationId)

import asyncio
from reygrid import ReyGrid

async def main():
    async with ReyGrid(api_key="your-api-key") as client:
        reply = await client.async_chat("{AgentId}", "Hello!", user_id="user-42")
        print(reply.output.reply.content)

asyncio.run(main())