@microsoft/opentelemetry 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/esm/a365/context.d.ts

@@ -0,0 +1,31 @@
+import type { Context } from "@opentelemetry/api";
+import type { ParentSpanRef } from "./contracts.js";
+/** Type guard to distinguish a ParentSpanRef from an OTel Context. */
+export declare function isParentSpanRef(value: unknown): value is ParentSpanRef;
+/**
+ * Creates a new Context with an explicit parent span reference.
+ * This allows child spans to be correctly parented even when async context is broken.
+ */
+export declare function createContextWithParentSpanRef(base: Context, parent: ParentSpanRef): Context;
+/**
+ * Runs a callback within a context that has an explicit parent span reference.
+ */
+export declare function runWithParentSpanRef<T>(parent: ParentSpanRef, callback: () => T): T;
+/** Carrier type for HTTP headers. */
+export type HeadersCarrier = Record<string, string | string[] | undefined>;
+/**
+ * Injects the current trace context (`traceparent`/`tracestate` headers) into
+ * the provided headers object using the globally registered W3C propagator.
+ */
+export declare function injectContextToHeaders(headers: Record<string, string>, ctx?: Context): Record<string, string>;
+/**
+ * Extracts trace context from incoming HTTP headers using the globally
+ * registered W3C propagator.
+ */
+export declare function extractContextFromHeaders(headers: HeadersCarrier, baseCtx?: Context): Context;
+/**
+ * Extracts trace context from incoming HTTP headers and runs the callback
+ * within that context.
+ */
+export declare function runWithExtractedTraceContext<T>(headers: HeadersCarrier, callback: () => T): T;
+//# sourceMappingURL=context.d.ts.map

package/dist/esm/a365/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/a365/context.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAmBpD,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAmBtE;AAMD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CA0B5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAGnF;AAMD,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,GAAG,CAAC,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAE7F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7F"}

package/dist/esm/a365/context.js

@@ -0,0 +1,101 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Context propagation utilities for A365 observability.
+ *
+ * Provides:
+ * - `ParentSpanRef` for explicit parent-child linking across async boundaries
+ * - `createContextWithParentSpanRef` / `runWithParentSpanRef` helpers
+ * - `isParentSpanRef` type guard
+ * - W3C traceparent inject/extract helpers
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/context/
+ */
+import { context, trace, propagation } from "@opentelemetry/api";
+import { TraceFlags } from "@opentelemetry/api";
+import { Logger } from "../shared/logging/index.js";
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+function isValidTraceId(traceId) {
+    return /^[0-9a-f]{32}$/i.test(traceId) && traceId !== "00000000000000000000000000000000";
+}
+function isValidSpanId(spanId) {
+    return /^[0-9a-f]{16}$/i.test(spanId) && spanId !== "0000000000000000";
+}
+// ---------------------------------------------------------------------------
+// Type guard
+// ---------------------------------------------------------------------------
+/** Type guard to distinguish a ParentSpanRef from an OTel Context. */
+export function isParentSpanRef(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const maybeCtx = value;
+    if (typeof maybeCtx.getValue === "function" &&
+        typeof maybeCtx.setValue === "function" &&
+        typeof maybeCtx.deleteValue === "function") {
+        return false;
+    }
+    const maybeRef = value;
+    return ("traceId" in maybeRef &&
+        typeof maybeRef.traceId === "string" &&
+        "spanId" in maybeRef &&
+        typeof maybeRef.spanId === "string");
+}
+// ---------------------------------------------------------------------------
+// Parent span context
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new Context with an explicit parent span reference.
+ * This allows child spans to be correctly parented even when async context is broken.
+ */
+export function createContextWithParentSpanRef(base, parent) {
+    const logger = Logger.getInstance();
+    if (!isValidTraceId(parent.traceId) || !isValidSpanId(parent.spanId)) {
+        logger.warn(`[A365] Invalid parent span reference; returning base context. traceId=${parent.traceId}, spanId=${parent.spanId}`);
+        return base;
+    }
+    const activeCtx = trace.getSpan(base)?.spanContext();
+    const traceFlags = parent.traceFlags ??
+        (activeCtx?.traceId === parent.traceId ? activeCtx.traceFlags : undefined) ??
+        TraceFlags.SAMPLED;
+    const parentSpanContext = {
+        traceId: parent.traceId,
+        spanId: parent.spanId,
+        traceFlags,
+        traceState: parent.traceState,
+        isRemote: parent.isRemote ?? true,
+    };
+    const parentSpan = trace.wrapSpanContext(parentSpanContext);
+    return trace.setSpan(base, parentSpan);
+}
+/**
+ * Runs a callback within a context that has an explicit parent span reference.
+ */
+export function runWithParentSpanRef(parent, callback) {
+    const contextWithParent = createContextWithParentSpanRef(context.active(), parent);
+    return context.with(contextWithParent, callback);
+}
+/**
+ * Injects the current trace context (`traceparent`/`tracestate` headers) into
+ * the provided headers object using the globally registered W3C propagator.
+ */
+export function injectContextToHeaders(headers, ctx) {
+    propagation.inject(ctx ?? context.active(), headers);
+    return headers;
+}
+/**
+ * Extracts trace context from incoming HTTP headers using the globally
+ * registered W3C propagator.
+ */
+export function extractContextFromHeaders(headers, baseCtx) {
+    return propagation.extract(baseCtx ?? context.active(), headers);
+}
+/**
+ * Extracts trace context from incoming HTTP headers and runs the callback
+ * within that context.
+ */
+export function runWithExtractedTraceContext(headers, callback) {
+    return context.with(extractContextFromHeaders(headers), callback);
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/a365/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/a365/context.ts"],"names":[],"mappings":"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"}

package/dist/esm/a365/contracts.d.ts

@@ -0,0 +1,250 @@
+/**
+ * A365 observability contracts — types for scopes, messages, and telemetry details.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/contracts.ts
+ * following OTel gen-ai semantic conventions.
+ */
+import type { SpanKind, TimeInput, Link, Context, TraceState } from "@opentelemetry/api";
+export declare const A365_MESSAGE_SCHEMA_VERSION: "0.1.0";
+/** Role of a message participant per OTEL gen-ai semantic conventions. */
+export declare enum MessageRole {
+    SYSTEM = "system",
+    USER = "user",
+    ASSISTANT = "assistant",
+    TOOL = "tool"
+}
+/** Reason a model stopped generating per OTEL gen-ai semantic conventions. */
+export declare enum FinishReason {
+    STOP = "stop",
+    LENGTH = "length",
+    CONTENT_FILTER = "content_filter",
+    TOOL_CALL = "tool_call",
+    ERROR = "error"
+}
+/** Media modality for blob, file, and URI parts. */
+export declare enum Modality {
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio"
+}
+/** Represents different roles that can invoke an agent. */
+export declare enum InvocationRole {
+    Human = "Human",
+    Agent = "Agent",
+    Event = "Event",
+    Unknown = "Unknown"
+}
+/** Represents different operation types for model inference. */
+export declare enum InferenceOperationType {
+    CHAT = "Chat",
+    TEXT_COMPLETION = "TextCompletion",
+    GENERATE_CONTENT = "GenerateContent"
+}
+/** Plain text content. */
+export interface TextPart {
+    type: "text";
+    content: string;
+}
+/** A tool call requested by the model. */
+export interface ToolCallRequestPart {
+    type: "tool_call";
+    name: string;
+    id?: string;
+    arguments?: Record<string, unknown> | unknown[];
+}
+/** Result of a tool call. */
+export interface ToolCallResponsePart {
+    type: "tool_call_response";
+    id?: string;
+    response?: unknown;
+}
+/** Model reasoning / chain-of-thought content. */
+export interface ReasoningPart {
+    type: "reasoning";
+    content: string;
+}
+/** Inline binary data (base64-encoded). */
+export interface BlobPart {
+    type: "blob";
+    modality: Modality | string;
+    mime_type?: string;
+    content: string;
+}
+/** Reference to a pre-uploaded file. */
+export interface FilePart {
+    type: "file";
+    modality: Modality | string;
+    mime_type?: string;
+    file_id: string;
+}
+/** External URI reference. */
+export interface UriPart {
+    type: "uri";
+    modality: Modality | string;
+    mime_type?: string;
+    uri: string;
+}
+/** Extensible server tool call details. */
+export interface GenericServerToolCall {
+    type: string;
+    [key: string]: unknown;
+}
+/** Extensible server tool call response. */
+export interface GenericServerToolCallResponse {
+    type: string;
+    [key: string]: unknown;
+}
+/** Server-side tool invocation. */
+export interface ServerToolCallPart {
+    type: "server_tool_call";
+    name: string;
+    id?: string;
+    server_tool_call: GenericServerToolCall;
+}
+/** Server-side tool response. */
+export interface ServerToolCallResponsePart {
+    type: "server_tool_call_response";
+    id?: string;
+    server_tool_call_response: GenericServerToolCallResponse;
+}
+/** Extensible part for custom / future types. */
+export interface GenericPart {
+    type: string;
+    [key: string]: unknown;
+}
+/** Union of all message part types per OTEL gen-ai semantic conventions. */
+export type MessagePart = TextPart | ToolCallRequestPart | ToolCallResponsePart | ReasoningPart | BlobPart | FilePart | UriPart | ServerToolCallPart | ServerToolCallResponsePart | GenericPart;
+/** An input message sent to a model (OTEL gen-ai semantic conventions). */
+export interface ChatMessage {
+    role: MessageRole | string;
+    parts: MessagePart[];
+    name?: string;
+}
+/** Versioned wrapper for input messages. */
+export interface InputMessages {
+    version: typeof A365_MESSAGE_SCHEMA_VERSION;
+    messages: ChatMessage[];
+}
+/** An output message produced by a model (OTEL gen-ai semantic conventions). */
+export interface OutputMessage extends ChatMessage {
+    finish_reason?: FinishReason | string;
+}
+/** Versioned wrapper for output messages. */
+export interface OutputMessages {
+    version: typeof A365_MESSAGE_SCHEMA_VERSION;
+    messages: OutputMessage[];
+}
+/** Accepted input for `recordInputMessages`. */
+export type InputMessagesParam = string | string[] | InputMessages;
+/** Accepted input for `recordOutputMessages`. */
+export type OutputMessagesParam = string | string[] | OutputMessages;
+/** Accepted input for `OutputResponse.messages`. */
+export type ResponseMessagesParam = OutputMessagesParam | Record<string, unknown>;
+/** Represents a channel for an invocation. */
+export interface Channel {
+    id?: string;
+    name?: string;
+    iconUri?: string;
+    role?: InvocationRole;
+    description?: string;
+}
+/** Represents a request with telemetry context. */
+export interface Request {
+    content?: InputMessagesParam;
+    sessionId?: string;
+    channel?: Channel;
+    conversationId?: string;
+}
+/** Details about an AI agent. */
+export interface AgentDetails {
+    agentId: string;
+    agentName?: string;
+    agentDescription?: string;
+    iconUri?: string;
+    platformId?: string;
+    agentAUID?: string;
+    agentEmail?: string;
+    agentBlueprintId?: string;
+    tenantId?: string;
+    providerName?: string;
+    agentVersion?: string;
+}
+/** Details about the human user caller. */
+export interface UserDetails {
+    userId?: string;
+    userEmail?: string;
+    userName?: string;
+    tenantId?: string;
+    callerClientIp?: string;
+}
+/**
+ * Caller details for scope creation.
+ * Supports human callers, agent callers, or both (A2A with a human in the chain).
+ */
+export interface CallerDetails {
+    userDetails?: UserDetails;
+    callerAgentDetails?: AgentDetails;
+}
+/** Represents an endpoint for agent invocation. */
+export interface ServiceEndpoint {
+    host: string;
+    port?: number;
+    protocol?: string;
+}
+/** Details for invoking agent scope. */
+export interface InvokeAgentScopeDetails {
+    endpoint?: ServiceEndpoint;
+}
+/** Details of a tool call made by an agent. */
+export interface ToolCallDetails {
+    toolName: string;
+    arguments?: Record<string, unknown> | string;
+    toolCallId?: string;
+    description?: string;
+    toolType?: string;
+    endpoint?: ServiceEndpoint;
+}
+/** Details for an inference call. */
+export interface InferenceDetails {
+    operationName: InferenceOperationType;
+    model: string;
+    providerName?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    finishReasons?: string[];
+    thoughtProcess?: string;
+    endpoint?: ServiceEndpoint;
+}
+/** Details for recording the response from an inference call. */
+export interface InferenceResponse {
+    content: string;
+    responseId?: string;
+    finishReason?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+/** Represents a response containing output messages from an agent. */
+export interface OutputResponse {
+    messages: ResponseMessagesParam;
+}
+/** Parent context — either an OTel Context or a manual ParentSpanRef. */
+export type ParentContext = Context | ParentSpanRef;
+/** Manual parent span reference for cross-async-boundary tracing. */
+export interface ParentSpanRef {
+    traceId: string;
+    spanId: string;
+    traceFlags?: number;
+    traceState?: TraceState;
+    isRemote?: boolean;
+}
+/**
+ * Span configuration details for scope creation.
+ */
+export interface SpanDetails {
+    parentContext?: ParentContext;
+    startTime?: TimeInput;
+    endTime?: TimeInput;
+    spanKind?: SpanKind;
+    spanLinks?: Link[];
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/esm/a365/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":"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"}

package/dist/esm/a365/contracts.js

@@ -0,0 +1,49 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// ---------------------------------------------------------------------------
+// Message schema version
+// ---------------------------------------------------------------------------
+export const A365_MESSAGE_SCHEMA_VERSION = "0.1.0";
+// ---------------------------------------------------------------------------
+// Enums
+// ---------------------------------------------------------------------------
+/** Role of a message participant per OTEL gen-ai semantic conventions. */
+export var MessageRole;
+(function (MessageRole) {
+    MessageRole["SYSTEM"] = "system";
+    MessageRole["USER"] = "user";
+    MessageRole["ASSISTANT"] = "assistant";
+    MessageRole["TOOL"] = "tool";
+})(MessageRole || (MessageRole = {}));
+/** Reason a model stopped generating per OTEL gen-ai semantic conventions. */
+export var FinishReason;
+(function (FinishReason) {
+    FinishReason["STOP"] = "stop";
+    FinishReason["LENGTH"] = "length";
+    FinishReason["CONTENT_FILTER"] = "content_filter";
+    FinishReason["TOOL_CALL"] = "tool_call";
+    FinishReason["ERROR"] = "error";
+})(FinishReason || (FinishReason = {}));
+/** Media modality for blob, file, and URI parts. */
+export var Modality;
+(function (Modality) {
+    Modality["IMAGE"] = "image";
+    Modality["VIDEO"] = "video";
+    Modality["AUDIO"] = "audio";
+})(Modality || (Modality = {}));
+/** Represents different roles that can invoke an agent. */
+export var InvocationRole;
+(function (InvocationRole) {
+    InvocationRole["Human"] = "Human";
+    InvocationRole["Agent"] = "Agent";
+    InvocationRole["Event"] = "Event";
+    InvocationRole["Unknown"] = "Unknown";
+})(InvocationRole || (InvocationRole = {}));
+/** Represents different operation types for model inference. */
+export var InferenceOperationType;
+(function (InferenceOperationType) {
+    InferenceOperationType["CHAT"] = "Chat";
+    InferenceOperationType["TEXT_COMPLETION"] = "TextCompletion";
+    InferenceOperationType["GENERATE_CONTENT"] = "GenerateContent";
+})(InferenceOperationType || (InferenceOperationType = {}));
+//# sourceMappingURL=contracts.js.map

package/dist/esm/a365/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAWlC,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAgB,CAAC;AAE5D,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,0EAA0E;AAC1E,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,4BAAa,CAAA;AACf,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,8EAA8E;AAC9E,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,iDAAiC,CAAA;IACjC,uCAAuB,CAAA;IACvB,+BAAe,CAAA;AACjB,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,oDAAoD;AACpD,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,2DAA2D;AAC3D,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,qCAAmB,CAAA;AACrB,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED,gEAAgE;AAChE,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,4DAAkC,CAAA;IAClC,8DAAoC,CAAA;AACtC,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC"}

package/dist/esm/a365/exporter/Agent365Exporter.d.ts

@@ -0,0 +1,25 @@
+import type { ExportResult } from "@opentelemetry/core";
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import type { Agent365ExporterOptions } from "./Agent365ExporterOptions.js";
+/**
+ * Agent365 span exporter.
+ *
+ * Implements `SpanExporter` from `@opentelemetry/sdk-trace-base`.
+ * Partitions spans by (tenantId, agentId), builds OTLP-like JSON payloads,
+ * and POSTs them to the Agent365 observability service with Bearer auth.
+ */
+export declare class Agent365Exporter implements SpanExporter {
+    private closed;
+    private readonly options;
+    private readonly logger;
+    constructor(options?: Agent365ExporterOptions);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): Promise<void>;
+    private exportGroup;
+    private resolveToken;
+    private postWithRetries;
+    private buildExportRequest;
+    private mapSpan;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=Agent365Exporter.d.ts.map

package/dist/esm/a365/exporter/Agent365Exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AA+D5E;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,OAAO,CAAC,EAAE,uBAAuB;IAIvC,MAAM,CACV,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,OAAO,CAAC,IAAI,CAAC;YAoCF,WAAW;YAmCX,YAAY;YAMZ,eAAe;IA0D7B,OAAO,CAAC,kBAAkB;IAwC1B,OAAO,CAAC,OAAO;IAwDT,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}