Skip to content

Release Notes v0.7.0

Release Date: June 20, 2026

Highlights

  • New ax package providing Agent Experience (AX) metadata for programmatic error handling, retry decisions, and request validation
  • AX error code integration with the SDK's APIError type

Added

AX Package

The new ax package enables AI agents to handle errors intelligently and make informed retry decisions:

import "github.com/plexusone/opik-go/ax"

Features:

  • 19 domain-specific error codes for LLM observability operations
  • 201 operations mapped with retry safety policies
  • 67 operations with required field definitions
  • 7 capability types for operation introspection

Example usage:

import (
    "github.com/plexusone/opik-go"
    "github.com/plexusone/opik-go/ax"
)

trace, err := client.GetTrace(ctx, traceID)
if err != nil {
    code, ok := opik.GetAXErrorCode(err)
    if !ok {
        return nil, err
    }

    switch code {
    case ax.ErrTraceNotFound:
        return client.CreateTrace(ctx, &Trace{ID: traceID})
    case ax.ErrRateLimited:
        time.Sleep(time.Second)
        return client.GetTrace(ctx, traceID)
    }
}

APIError AX Integration

New helper methods on APIError for extracting and checking AX error codes:

  • APIError.AXErrorCode() - extract AX code from API error
  • APIError.HasAXCode() - check for specific AX code
  • IsAXError() - check any error for AX code
  • GetAXErrorCode() - extract AX code from any error
  • GetAXErrorInfo() - get metadata about error code

Fixed

  • Linter warning for strconv usage

Dependencies

  • Upgraded github.com/plexusone/omnillm from v0.13.0 to v0.16.1
  • Upgraded github.com/plexusone/omniobserve from v0.7.0 to v0.11.0
  • Upgraded github.com/ogen-go/ogen from v1.20.1 to v1.22.0
  • Upgraded go.opentelemetry.io/otel/trace from v1.40.0 to v1.44.0
  • Upgraded go.opentelemetry.io/otel/metric from v1.40.0 to v1.44.0
  • Updated github.com/invopop/jsonschema to v0.14.0 (resolves ordered-map conflict with anthropic-sdk-go)

Documentation

  • Added AX package documentation (overview, error codes, retry policies, capabilities)
  • Added AX integration case study
  • Applied PlexusOne unified theme to MkDocs site