chore(api): regenerate Python SDK for functions and annotations

[koxudaxi]

TL;DR

Added API client support for annotations and functions endpoints.

What changed?

• Added new annotations module with client classes for managing annotations:

  • AnnotationsClient and AsyncAnnotationsClient for synchronous and asynchronous operations
  • Support for CRUD operations: list, create, get, update, and delete annotations
  • Added response types for all annotation operations

• Added new functions module with client classes for managing functions:

  • FunctionsClient and AsyncFunctionsClient for synchronous and asynchronous operations
  • Support for listing, registering, and retrieving functions
  • Added request and response types for all function operations

• Added utility type NumberFromString for handling numeric parameters passed as strings

How to test?

Test the new API clients by making requests to the annotations and functions endpoints:

from mirascope.api._generated import Mirascope

# Test annotations
client = Mirascope()
annotations = client.annotations.list()
annotation = client.annotations.create(
    span_id="span123",
    trace_id="trace456",
    label="Test annotation"
)

# Test functions
functions = client.functions.list()
function = client.functions.get("function-id")

For async usage:

import asyncio
from mirascope.api._generated import AsyncMirascope

async def test():
    client = AsyncMirascope()
    annotations = await client.annotations.list()
    functions = await client.functions.list()

asyncio.run(test())

Why make this change?

This change adds client support for two important API endpoints - annotations and functions. Annotations allow users to add metadata to traces and spans for better observability, while the functions API enables registering and managing functions. These additions complete the API client implementation, providing a comprehensive interface for interacting with the Mirascope platform.

[graphite-app]

Merge activity

• Jan 6, 3:38 AM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.
• Jan 6, 3:41 AM UTC: @willbakst merged this pull request with Graphite.