Skip to content

Release Notes v0.9.0

Release Date: May 2026

Highlights

  • TypeScript SDK: New @omniobserve/core package providing TypeScript interfaces that mirror the Go implementation for cross-language observability consistency
  • User Journey Semantic Conventions: New semconv/journey package with OpenTelemetry semantic conventions for product analytics, session tracking, and UX observability

New Features

TypeScript SDK (typescript/packages/core)

A new TypeScript SDK that mirrors the Go implementation, enabling cross-language observability with consistent types and semantic conventions.

import type { Trace, Span, Provider } from '@omniobserve/core';
import { semconv } from '@omniobserve/core';

// Use semantic convention constants
console.log(semconv.agent.TaskID);      // 'gen_ai.agent.task.id'
console.log(semconv.journey.SessionID); // 'session.id'

Features:

  • Core Types: Trace, Span, Workflow, Task, Handoff, ToolInvocation
  • Provider Interfaces: Tracer, Evaluator, DatasetManager, PromptManager
  • Semantic Conventions: Mirrors semconv/agent and semconv/journey Go packages
  • Tree-shaking: Direct exports for optimal bundle sizes

Package structure:

typescript/
├── packages/core/
│   └── src/
│       ├── types.ts           # Core interfaces
│       ├── semconv/
│       │   ├── agent.ts       # Agent semantic conventions
│       │   └── journey.ts     # Journey semantic conventions
│       └── index.ts           # Main exports
└── package.json               # pnpm monorepo

User Journey Semantic Conventions (semconv/journey)

New OpenTelemetry semantic conventions for user journey observability, designed for ProductGraph integration while following OTel patterns.

import "github.com/plexusone/omniobserve/semconv/journey"

// Journey tracking
attrs := map[string]string{
    journey.JourneyID:   "checkout-flow",
    journey.StepID:      "add-to-cart",
    journey.SessionID:   "sess-abc123",
    journey.PagePath:    "/products/widget-123",
    journey.UIAction:    journey.UIActionClick,
}

Attribute namespaces:

Namespace Purpose
gen_ai.journey.* Journey definitions and steps
session.* User session attributes
page.* Page navigation attributes
ui.* UI interaction attributes
snapshot.* Visual capture attributes
performance.* Web Vitals metrics
error.* Error tracking

Event types:

  • page.view, page.leave - Page navigation
  • ui.click, ui.input, ui.scroll - User interactions
  • state.change - Application state changes
  • journey.step, journey.conversion - Journey progression
  • api.request, api.response - Frontend API calls

Added

  • typescript/ package with @omniobserve/core TypeScript SDK (9e5aa46)
  • semconv/journey/ package with user journey semantic conventions (a12c942)
  • PlexusOne unified navigation and MkDocs theme (16cfd3b)

Documentation

  • README.md shields updated (2c8b272)
  • MkDocs index.md cleanup (0ca5e0c)

Build

  • Update copyright years in LICENSE (fd45ba5)

Dependencies

  • Upgraded github.com/plexusone/omnillm to v0.15.3
  • Upgraded github.com/grokify/mogo to v0.74.4
  • Upgraded OpenTelemetry exporters to v1.43.0
  • Upgraded entgo.io/ent to v0.14.6
  • Upgraded github.com/lib/pq to v1.12.3