@zhivex-ai/core 1.5.0 → 1.6.0

package/dist/observability.d.ts

@@ -1,50 +1,97 @@
 import type { AgentTelemetryObserver, LanguageModelMiddleware, ProviderOptions } from "./types.js";
-type PrimitiveSpanAttribute = string | number | boolean | null;
-type SpanAttributeValue = PrimitiveSpanAttribute | PrimitiveSpanAttribute[];
+type PrimitiveAttribute = string | number | boolean;
+type OTelAttributeValue = PrimitiveAttribute | string[] | number[] | boolean[];
+type OTelAttributes = Record<string, OTelAttributeValue>;
+interface OTelSpanOptionsLike {
+    attributes?: OTelAttributes;
+    kind?: number;
+    startTime?: number;
+}
 export interface OTelSpanLike {
-    setAttribute?(key: string, value: SpanAttributeValue): unknown;
-    addEvent?(name: string, attributes?: Record<string, SpanAttributeValue>): unknown;
+    setAttribute?(key: string, value: OTelAttributeValue): unknown;
+    addEvent?(name: string, attributes?: OTelAttributes): unknown;
     recordException?(error: Error): unknown;
     setStatus?(status: unknown): unknown;
-    end(): unknown;
+    end(endTime?: number): unknown;
 }
 export interface OTelTracerLike {
-    startSpan(name: string, options?: {
-        attributes?: Record<string, SpanAttributeValue>;
-    }): OTelSpanLike;
+    startSpan(name: string, options?: OTelSpanOptionsLike, context?: unknown): OTelSpanLike;
+}
+export interface OTelTracerProviderLike {
+    getTracer(name: string, version?: string): OTelTracerLike;
+}
+export interface OTelHistogramLike {
+    record(value: number, attributes?: OTelAttributes): unknown;
+}
+export interface OTelMeterLike {
+    createHistogram(name: string, options?: {
+        unit?: string;
+        description?: string;
+        advice?: {
+            explicitBucketBoundaries?: number[];
+        };
+    }): OTelHistogramLike;
+}
+export interface OTelMeterProviderLike {
+    getMeter(name: string, version?: string): OTelMeterLike;
 }
+/** Zhivex's stable, privacy-first mapping contract for GenAI telemetry. */
+export declare const OTEL_GENAI_CONTRACT_VERSION: 1;
+/** Upstream Development revision used to audit the v1 mapping. */
+export declare const OTEL_GENAI_SEMCONV_REVISION = "a685613a207a580163353b8e48a7ad88967e7b42";
 export declare class OTelSpanHandle {
     readonly span: OTelSpanLike;
     private readonly statusSetter?;
+    private endPromise?;
     constructor(span: OTelSpanLike, statusSetter?: ((span: OTelSpanLike, error: Error) => Promise<void> | void) | undefined);
+    get ended(): boolean;
     end(options?: {
         attributes?: Record<string, unknown>;
         error?: Error;
+        endTime?: number;
     }): Promise<void>;
+    private finish;
 }
 export declare class OTelObserver {
     private readonly tracer;
     private readonly statusSetter?;
-    constructor(tracer: OTelTracerLike, statusSetter?: ((span: OTelSpanLike, error: Error) => Promise<void> | void) | undefined);
-    startSpan(name: string, attributes?: Record<string, unknown>): OTelSpanHandle;
+    private readonly contextFor?;
+    private readonly spanKindFor?;
+    private readonly runWithSpan?;
+    constructor(tracer: OTelTracerLike, statusSetter?: ((span: OTelSpanLike, error: Error) => Promise<void> | void) | undefined, contextFor?: ((parent?: OTelSpanLike) => unknown) | undefined, spanKindFor?: ((kind: "internal" | "client") => number) | undefined, runWithSpan?: (<T>(span: OTelSpanLike, callback: () => T | Promise<T>) => T | Promise<T>) | undefined);
+    startSpan(name: string, attributes?: Record<string, unknown>, options?: {
+        parent?: OTelSpanHandle;
+        kind?: "internal" | "client";
+        startTime?: number;
+    }): OTelSpanHandle;
+    withSpan<T>(handle: OTelSpanHandle, callback: () => T | Promise<T>): Promise<T>;
 }
 export declare const createOtelObserver: (options?: {
     tracer?: OTelTracerLike;
+    tracerProvider?: OTelTracerProviderLike;
     tracerName?: string;
     version?: string;
 }) => Promise<OTelObserver>;
 export declare const createOtelAgentObserver: (options?: {
     observer?: OTelObserver;
     tracer?: OTelTracerLike;
+    tracerProvider?: OTelTracerProviderLike;
     tracerName?: string;
     version?: string;
+    meter?: OTelMeterLike;
+    meterProvider?: OTelMeterProviderLike;
+    meterName?: string;
     spanNamePrefix?: string;
 }) => Promise<AgentTelemetryObserver>;
 export declare const createOtelTelemetryMiddleware: <TProviderOptions extends ProviderOptions = ProviderOptions>(options?: {
     observer?: OTelObserver;
     tracer?: OTelTracerLike;
+    tracerProvider?: OTelTracerProviderLike;
     tracerName?: string;
     version?: string;
+    meter?: OTelMeterLike;
+    meterProvider?: OTelMeterProviderLike;
+    meterName?: string;
     spanNamePrefix?: string;
 }) => Promise<LanguageModelMiddleware<TProviderOptions>>;
 export {};

package/dist/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACtB,uBAAuB,EAEvB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,KAAK,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC/D,KAAK,kBAAkB,GAAG,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAC/D,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAAC;IAClF,eAAe,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IACxC,SAAS,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,GAAG,IAAI,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;KAAE,GAAG,YAAY,CAAC;CACtG;AAyDD,qBAAa,cAAc;IAEvB,QAAQ,CAAC,IAAI,EAAE,YAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBADrB,IAAI,EAAE,YAAY,EACV,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,aAAA;IAGtF,GAAG,CAAC,OAAO,GAAE;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,CAAC,EAAE,KAAK,CAAC;KACV;CAQP;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBADb,MAAM,EAAE,cAAc,EACtB,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,aAAA;IAG5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;CAM9E;AAeD,eAAO,MAAM,kBAAkB,GAAU,UAAS;IAChD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,KAAG,OAAO,CAAC,YAAY,CAe5B,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAU,UAAS;IACrD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,sBAAsB,CA6HtC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAU,gBAAgB,SAAS,eAAe,GAAG,eAAe,EAAE,UAAS;IACvH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAuFzD,CAAC"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"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"}