fix(sdk): define tracing response types locally instead of importing from Fern client

[mmabrouk]

Summary

• Define AgentaNodeDto and AgentaNodesResponse locally in SDK
• Remove dependency on Fern-generated types that may not exist in future SDK generations

Changes

sdk/agenta/sdk/types.py: Added local definitions for AgentaNodeDto and AgentaNodesResponse, replacing the import from agenta.client.backend.types.

Why

These types are SDK-internal models used for inline trace responses. They were previously imported from Fern-generated client types, but:

1. Those types aren't actually exposed by any API endpoint (they're internal API models)
2. The current cloud API OpenAPI spec doesn't include these types
3. Future Fern SDK regenerations may not include them

Defining them locally makes the SDK self-contained and independent of Fern generation quirks.

Type Definitions

class AgentaNodeDto(BaseModel):
    """SDK-internal type for inline trace node representation."""
    model_config = ConfigDict(extra="allow")

class AgentaNodesResponse(BaseModel):
    """SDK-internal type for inline trace response."""
    version: str
    nodes: List[AgentaNodeDto] = []
    count: Optional[int] = None
    model_config = ConfigDict(extra="allow")

Testing

• Types are compatible with existing usage in sdk/agenta/sdk/tracing/inline.py and sdk/agenta/sdk/engines/tracing/inline.py
• Uses extra="allow" to accept arbitrary fields when constructed from span dictionaries

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
agenta-documentation	Ready	Preview, Comment	Jan 15, 2026 1:38pm