Models

from vrin import Document

doc = Document(
    content="ACME Corp reported $50M revenue in Q4 2025.",
    title="ACME Financials",
    tags=["earnings", "2025"],
    source="sdk-upload",
    document_type="text",
)

from vrin import QueryResult

qr = QueryResult.from_dict(result_dict)
print(qr.content)
print(qr.score)
print(qr.title)      # from metadata
print(qr.tags)       # from metadata

from vrin import JobStatus

status = JobStatus.from_dict(client.get_job_status("job_abc123"))
print(status.status)         # "extracting"
print(status.progress)       # 65
print(status.is_completed)   # False
print(status.is_processing)  # True

from vrin import InsertResult

result = InsertResult.from_dict(raw_result)
print(result.facts_extracted)  # 12
print(result.job_id)

from vrin import UploadResult

result = UploadResult.from_dict(raw_result)
print(result.upload_id)
print(result.status)

from vrin import UserLimits

limits = UserLimits.from_dict(client.get_limits())
print(f"Plan: {limits.plan}")
print(f"Queries left: {limits.queries_remaining}")

from vrin import Conversation

for raw in client.list_conversations():
    conv = Conversation.from_dict(raw)
    print(f"{conv.session_id}: {conv.title} ({conv.turn_count} turns)")