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

package/dist/esm/a365/constants.js

@@ -0,0 +1,116 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { MICROSOFT_OPENTELEMETRY_VERSION } from "../types.js";
+/**
+ * OpenTelemetry constants for A365 observability.
+ *
+ * Attribute keys follow OTel gen-ai semantic conventions plus
+ * Microsoft-specific extensions under the `microsoft.*` namespace.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/constants.ts
+ */
+export class OpenTelemetryConstants {
+    // ── Span operation names ──────────────────────────────────────────
+    static INVOKE_AGENT_OPERATION_NAME = "invoke_agent";
+    static EXECUTE_TOOL_OPERATION_NAME = "execute_tool";
+    static OUTPUT_MESSAGES_OPERATION_NAME = "output_messages";
+    static CHAT_OPERATION_NAME = "chat";
+    // ── Standard OTel semantic conventions ────────────────────────────
+    static ERROR_TYPE_KEY = "error.type";
+    static ERROR_TYPE_CANCELLED = "TaskCanceledException";
+    static ERROR_MESSAGE_KEY = "error.message";
+    static AZ_NAMESPACE_KEY = "az.namespace";
+    static SERVER_ADDRESS_KEY = "server.address";
+    static SERVER_PORT_KEY = "server.port";
+    static AZURE_RP_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
+    // ── Source / SDK identity ─────────────────────────────────────────
+    static SOURCE_NAME = "Agent365Sdk";
+    // ── Feature flags / env var names ─────────────────────────────────
+    static ENABLE_OPENTELEMETRY_SWITCH = "Azure.Experimental.EnableActivitySource";
+    static TRACE_CONTENTS_SWITCH = "Azure.Experimental.TraceGenAIMessageContent";
+    static TRACE_CONTENTS_ENVIRONMENT_VARIABLE = "AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED";
+    static ENABLE_OBSERVABILITY = "ENABLE_OBSERVABILITY";
+    static ENABLE_A365_OBSERVABILITY_EXPORTER = "ENABLE_A365_OBSERVABILITY_EXPORTER";
+    static ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY";
+    static ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT = "ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT";
+    // ── GenAI core attributes ────────────────────────────────────────
+    static GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    static GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    static GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
+    static GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
+    static GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    static GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    static GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
+    static GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p";
+    static GEN_AI_CHOICE = "gen_ai.choice";
+    // ── GenAI metrics ────────────────────────────────────────────────
+    static GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration";
+    static GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
+    // ── GenAI usage ──────────────────────────────────────────────────
+    static GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
+    static GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens";
+    // ── GenAI message attributes ─────────────────────────────────────
+    static GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions";
+    static GEN_AI_INPUT_MESSAGES_KEY = "gen_ai.input.messages";
+    static GEN_AI_OUTPUT_MESSAGES_KEY = "gen_ai.output.messages";
+    static A365_MESSAGES_SCHEMA_VERSION_KEY = "microsoft.a365.messages.schema_version";
+    // ── GenAI agent attributes ───────────────────────────────────────
+    static GEN_AI_AGENT_ID_KEY = "gen_ai.agent.id";
+    static GEN_AI_AGENT_NAME_KEY = "gen_ai.agent.name";
+    static GEN_AI_AGENT_DESCRIPTION_KEY = "gen_ai.agent.description";
+    static GEN_AI_AGENT_VERSION_KEY = "gen_ai.agent.version";
+    static GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id";
+    static GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process";
+    static GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    static AGENT_ID_KEY = "gen_ai.agent.id";
+    // ── GenAI conversation / session ─────────────────────────────────
+    static GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
+    static GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link";
+    static SESSION_ID_KEY = "microsoft.session.id";
+    static SESSION_DESCRIPTION_KEY = "microsoft.session.description";
+    // ── GenAI tool attributes ────────────────────────────────────────
+    static GEN_AI_TOOL_CALL_ID_KEY = "gen_ai.tool.call.id";
+    static GEN_AI_TOOL_NAME_KEY = "gen_ai.tool.name";
+    static GEN_AI_TOOL_DESCRIPTION_KEY = "gen_ai.tool.description";
+    static GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.call.arguments";
+    static GEN_AI_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result";
+    static GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type";
+    // ── Tenant ───────────────────────────────────────────────────────
+    static TENANT_ID_KEY = "microsoft.tenant.id";
+    // ── Human caller dimensions (OTel user.* namespace) ──────────────
+    static USER_ID_KEY = "user.id";
+    static USER_NAME_KEY = "user.name";
+    static USER_EMAIL_KEY = "user.email";
+    static GEN_AI_CALLER_CLIENT_IP_KEY = "client.address";
+    // ── Agent-to-Agent caller dimensions ─────────────────────────────
+    static GEN_AI_CALLER_AGENT_USER_ID_KEY = "microsoft.a365.caller.agent.user.id";
+    static GEN_AI_CALLER_AGENT_EMAIL_KEY = "microsoft.a365.caller.agent.user.email";
+    static GEN_AI_CALLER_AGENT_NAME_KEY = "microsoft.a365.caller.agent.name";
+    static GEN_AI_CALLER_AGENT_ID_KEY = "microsoft.a365.caller.agent.id";
+    static GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "microsoft.a365.caller.agent.blueprint.id";
+    static GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY = "microsoft.a365.caller.agent.platform.id";
+    static GEN_AI_CALLER_AGENT_VERSION_KEY = "microsoft.a365.caller.agent.version";
+    // ── Baggage keys ─────────────────────────────────────────────────
+    static GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id";
+    static GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email";
+    static GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id";
+    // ── Execution context ────────────────────────────────────────────
+    static GEN_AI_TASK_ID_KEY = "gen_ai.task.id";
+    static GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload";
+    // ── Channel dimensions ───────────────────────────────────────────
+    static CHANNEL_NAME_KEY = "microsoft.channel.name";
+    static CHANNEL_LINK_KEY = "microsoft.channel.link";
+    // ── Custom parent / span name ────────────────────────────────────
+    static CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id";
+    static CUSTOM_SPAN_NAME_KEY = "custom.span.name";
+    // ── Service attributes ───────────────────────────────────────────
+    static SERVICE_NAME_KEY = "service.name";
+    // ── Telemetry SDK attributes ─────────────────────────────────────
+    static TELEMETRY_SDK_NAME_KEY = "telemetry.sdk.name";
+    static TELEMETRY_SDK_LANGUAGE_KEY = "telemetry.sdk.language";
+    static TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version";
+    static TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK";
+    static TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
+    static TELEMETRY_SDK_VERSION_VALUE = MICROSOFT_OPENTELEMETRY_VERSION;
+}
+//# sourceMappingURL=constants.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { Context } from "@opentelemetry/api";
+/**
+ * Run a function within a Context that carries the per-request export token.
+ * This keeps the token only in OTel Context (ALS), never in any registry.
+ *
+ * The token can be updated later via `updateExportToken()` before the trace
+ * is flushed — useful when the callback is long-running and the original
+ * token may expire before export.
+ */
+export declare function runWithExportToken<T>(token: string, fn: () => T): T;
+/**
+ * Update the export token in the active OTel Context.
+ * Call this to refresh the token before ending the root span when the
+ * original token may have expired during a long-running request.
+ *
+ * Must be called within the same async context created by `runWithExportToken`.
+ * @param token The fresh token to use for export.
+ * @returns true if the token was updated successfully, false if no token holder was found.
+ */
+export declare function updateExportToken(token: string): boolean;
+/**
+ * Retrieve the per-request export token from a given OTel Context (or the active one).
+ */
+export declare function getExportToken(ctx?: Context): string | undefined;
+//# sourceMappingURL=tokenContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenContext.d.ts","sourceRoot":"","sources":["../../../../src/a365/context/tokenContext.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAclD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,OAA0B,GAAG,MAAM,GAAG,SAAS,CAUlF"}

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

@@ -0,0 +1,62 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Per-request export token context propagation.
+ *
+ * Uses OpenTelemetry Context (backed by AsyncLocalStorage) to carry and
+ * refresh a per-request bearer token that the PerRequestSpanProcessor
+ * restores at export time.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/context/token-context.ts
+ */
+import { context, createContextKey } from "@opentelemetry/api";
+import { Logger } from "../../shared/logging/index.js";
+const EXPORT_TOKEN_KEY = createContextKey("a365_export_token");
+/**
+ * Run a function within a Context that carries the per-request export token.
+ * This keeps the token only in OTel Context (ALS), never in any registry.
+ *
+ * The token can be updated later via `updateExportToken()` before the trace
+ * is flushed — useful when the callback is long-running and the original
+ * token may expire before export.
+ */
+export function runWithExportToken(token, fn) {
+    const holder = { token };
+    const ctxWithToken = context.active().setValue(EXPORT_TOKEN_KEY, holder);
+    Logger.getInstance().info("[TokenContext] Running function with export token in context.");
+    return context.with(ctxWithToken, fn);
+}
+/**
+ * Update the export token in the active OTel Context.
+ * Call this to refresh the token before ending the root span when the
+ * original token may have expired during a long-running request.
+ *
+ * Must be called within the same async context created by `runWithExportToken`.
+ * @param token The fresh token to use for export.
+ * @returns true if the token was updated successfully, false if no token holder was found.
+ */
+export function updateExportToken(token) {
+    const value = context.active().getValue(EXPORT_TOKEN_KEY);
+    if (value && typeof value === "object" && "token" in value) {
+        value.token = token;
+        Logger.getInstance().info("[TokenContext] Export token updated in context.");
+        return true;
+    }
+    Logger.getInstance().warn("[TokenContext] updateExportToken called but no token holder found in active context. Was runWithExportToken called?");
+    return false;
+}
+/**
+ * Retrieve the per-request export token from a given OTel Context (or the active one).
+ */
+export function getExportToken(ctx = context.active()) {
+    const value = ctx.getValue(EXPORT_TOKEN_KEY);
+    if (value && typeof value === "object" && "token" in value) {
+        return value.token;
+    }
+    // Backward compat: support raw string values from older callers
+    if (typeof value === "string") {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=tokenContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenContext.js","sourceRoot":"","sources":["../../../../src/a365/context/tokenContext.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;AAW/D;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAI,KAAa,EAAE,EAAW;IAC9D,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC1D,KAAqB,CAAC,KAAK,GAAG,KAAK,CAAC;QACrC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CACvB,qHAAqH,CACtH,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe,OAAO,CAAC,MAAM,EAAE;IAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,OAAQ,KAAqB,CAAC,KAAK,CAAC;IACtC,CAAC;IACD,gEAAgE;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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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"}