Skip to main content

SDK v1.0.1 — TypeScript

Released: June 2026 Bug fixes:
  • Fixed API key prefix validation warning (now expects zsp_ prefix)
  • Minor internal reliability improvements

SDK v1.0.0

Released: June 2026 Initial public release of the Zespan SDK (TypeScript and Python).

TypeScript SDK (@zespan/sdk)

  • zespan.init() singleton initialization
  • wrapOpenAI(), wrapAnthropic(), wrapGoogle() provider wrappers
  • wrapOpenRouter(), wrapBedrock(), wrapMistral(), wrapGroq(), wrapLiteLLM()
  • withZespanContext() — async context propagation
  • withAgent() — multi-agent tracing with plan, tool, and handoff spans
  • startSpan() — manual span API with eval score attachment
  • ZespanCallbackHandler for LangChain
  • wrapADKAgent() and wrapADKRunner() for Google ADK
  • PromptClient — fetch, compile, create, and manage versioned prompts
  • GuardrailBlockedError with phase and results properties
  • PII redaction with configurable key list
  • OpenTelemetry dual-export via enableOTel + otelEndpoint

Python SDK (zespan)

  • zespan.init() with autopatch for OpenAI, Anthropic, Gemini, Bedrock, Mistral, Groq
  • wrap_openai(), wrap_anthropic(), wrap_google() explicit wrappers
  • ZespanCallbackHandler for LangChain (sync + async)
  • ZespanADKTracer for Google ADK
  • with_agent() context manager for multi-agent tracing
  • PromptClient with same API as TypeScript version
  • @zespan.trace decorator for sync and async functions
  • FastAPI and Flask middleware
  • Python parity: all TypeScript features available in Python

Middleware v1.0.0

Released: June 2026
  • zespan-autogen — observability middleware for Microsoft AutoGen (agentchat + legacy pyautogen)
  • zespan-crewai — observability listener for CrewAI agents
  • zespan-fastapi — FastAPI middleware for automatic request/response tracing
  • zespan-flask — Flask middleware for automatic request/response tracing