Verbara.Sdk 2.1.2

Verbara.Sdk

Core abstractions for the Verbara.Sdk ecosystem — shared interfaces, base types, telemetry catalogs, and source-generator attributes consumed by every other package in the family. Native AOT, zero reflection, MIT licensed.

What it does

This package is referenced (transitively) by every other Verbara.Sdk.* package. Most consumers do not install it directly — they install Verbara.Sdk.Hosting or one of the protocol-specific packages (Verbara.Sdk.Ami, Verbara.Sdk.Ari, Verbara.Sdk.Agi) and pick this one up automatically. Install it explicitly only when building a custom package that needs the abstractions without the protocol implementations.

Public surface

• AMI core types — IAmiConnection, IAmiConnectionFactory, ManagerAction, ManagerEvent, ManagerResponse, IEventListener and the protocol-defined enums consumed by source generators in Verbara.Sdk.Ami.
• AGI / ARI base types — protocol-shared enums and base records mirrored across Verbara.Sdk.Agi and Verbara.Sdk.Ari.
• AsteriskSemanticConventions — public static catalog of 60 const strings across 14 nested classes (Resource, Channel, Bridge, Calls, Dialplan, Sip, Media, Queues, Agent, VoiceAi, Events, Tenant, Event, Node). Use these as Activity.SetTag(...) keys instead of hard-coded strings so dashboards survive SDK version bumps. Pinned by 14+ unit tests.
• AsteriskTelemetry — runtime-discoverable lists of every ActivitySourceName (9) and MeterName (15) shipped by the SDK family. Plug into OpenTelemetry with one call: tracerBuilder.AddSource([.. AsteriskTelemetry.ActivitySourceNames]).
• Source-generator attributes — [ManagerActionAttribute], [ManagerEventAttribute], [JsonSerializable(typeof(...))] markers that drive the four Roslyn source generators in Verbara.Sdk.Ami.SourceGenerators. Replace runtime reflection entirely.

Install

dotnet add package Verbara.Sdk

Most consumers will instead want:

dotnet add package Verbara.Sdk.Hosting   # meta-package: Sdk + Ami + Agi + Ari + Live + Activities + Sessions + Config + DI

OpenTelemetry one-liner

using Verbara.Sdk;          // AsteriskTelemetry
using OpenTelemetry.Metrics;
using OpenTelemetry.Trace;

builder.Services.AddOpenTelemetry()
    .WithTracing(t => t.AddSource([.. AsteriskTelemetry.ActivitySourceNames]).AddOtlpExporter())
    .WithMetrics(m => m.AddMeter([.. AsteriskTelemetry.MeterNames]).AddOtlpExporter());

For the batteries-included variant (Console + OTLP + Prometheus exporters wired automatically):

dotnet add package Verbara.Sdk.OpenTelemetry

builder.Services.AddAsteriskOpenTelemetry().WithAllSources();

Native AOT

Zero runtime reflection. All serialization paths use Roslyn source generators (ActionSerializerGenerator, EventDeserializerGenerator, EventRegistryGenerator, ResponseDeserializerGenerator). Trim-safe (<IsTrimmable>true</IsTrimmable>); 0 trim warnings across the package family. See ADR-0001 and ADR-0003 for design rationale.

License

MIT. Part of the Verbara.Sdk project.