@google/adk 2.4.0 → 2.5.0

package/dist/esm/telemetry/setup.js

@@ -1,88 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { metrics } from "@opentelemetry/api";
-import { logs } from "@opentelemetry/api-logs";
-import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
-import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { detectResources } from "@opentelemetry/resources";
-import {
-  BatchLogRecordProcessor,
-  LoggerProvider
-} from "@opentelemetry/sdk-logs";
-import {
-  MeterProvider,
-  PeriodicExportingMetricReader
-} from "@opentelemetry/sdk-metrics";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-function maybeSetOtelProviders(otelHooksToSetup = [], otelResource) {
-  const resource = otelResource || getOtelResource();
-  const allHooks = [...otelHooksToSetup, getOtelExporters()];
-  const spanProcessors = allHooks.flatMap(
-    (hooks) => hooks.spanProcessors || []
-  );
-  const metricReaders = allHooks.flatMap((hooks) => hooks.metricReaders || []);
-  const logRecordProcessors = allHooks.flatMap(
-    (hooks) => hooks.logRecordProcessors || []
-  );
-  if (spanProcessors.length > 0) {
-    const tracerProvider = new NodeTracerProvider({
-      resource,
-      spanProcessors
-    });
-    tracerProvider.register();
-  }
-  if (metricReaders.length > 0) {
-    const meterProvider = new MeterProvider({
-      readers: metricReaders,
-      resource
-    });
-    metrics.setGlobalMeterProvider(meterProvider);
-  }
-  if (logRecordProcessors.length > 0) {
-    const loggerProvider = new LoggerProvider({
-      resource,
-      processors: logRecordProcessors
-    });
-    logs.setGlobalLoggerProvider(loggerProvider);
-  }
-}
-__name(maybeSetOtelProviders, "maybeSetOtelProviders");
-function getOtelResource() {
-  return detectResources({
-    detectors: []
-  });
-}
-__name(getOtelResource, "getOtelResource");
-function getOtelExportersConfig() {
-  return {
-    enableTracing: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT),
-    enableMetrics: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT),
-    enableLogging: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT)
-  };
-}
-__name(getOtelExportersConfig, "getOtelExportersConfig");
-function getOtelExporters(config = getOtelExportersConfig()) {
-  const { enableTracing, enableMetrics, enableLogging } = config;
-  return {
-    spanProcessors: enableTracing ? [new BatchSpanProcessor(new OTLPTraceExporter())] : [],
-    metricReaders: enableMetrics ? [
-      new PeriodicExportingMetricReader({
-        exporter: new OTLPMetricExporter()
-      })
-    ] : [],
-    logRecordProcessors: enableLogging ? [new BatchLogRecordProcessor({ exporter: new OTLPLogExporter() })] : []
-  };
-}
-__name(getOtelExporters, "getOtelExporters");
-export {
-  maybeSetOtelProviders
-};

package/dist/esm/telemetry/tracing.js

@@ -1,361 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { ApiError } from "@google/genai";
-import {
-  context,
-  SpanStatusCode,
-  trace
-} from "@opentelemetry/api";
-import { version } from "../version.js";
-var GenAiAttr = /* @__PURE__ */ ((GenAiAttr2) => {
-  GenAiAttr2["AGENT_DESCRIPTION"] = "gen_ai.agent.description";
-  GenAiAttr2["AGENT_NAME"] = "gen_ai.agent.name";
-  GenAiAttr2["CONVERSATION_ID"] = "gen_ai.conversation.id";
-  GenAiAttr2["OPERATION_NAME"] = "gen_ai.operation.name";
-  GenAiAttr2["SYSTEM"] = "gen_ai.system";
-  GenAiAttr2["TOOL_CALL_ID"] = "gen_ai.tool.call.id";
-  GenAiAttr2["TOOL_DESCRIPTION"] = "gen_ai.tool.description";
-  GenAiAttr2["TOOL_NAME"] = "gen_ai.tool.name";
-  GenAiAttr2["TOOL_TYPE"] = "gen_ai.tool.type";
-  GenAiAttr2["REQUEST_MODEL"] = "gen_ai.request.model";
-  GenAiAttr2["REQUEST_TOP_P"] = "gen_ai.request.top_p";
-  GenAiAttr2["REQUEST_MAX_TOKENS"] = "gen_ai.request.max_tokens";
-  GenAiAttr2["USAGE_INPUT_TOKENS"] = "gen_ai.usage.input_tokens";
-  GenAiAttr2["USAGE_OUTPUT_TOKENS"] = "gen_ai.usage.output_tokens";
-  GenAiAttr2["RESPONSE_FINISH_REASONS"] = "gen_ai.response.finish_reasons";
-  return GenAiAttr2;
-})(GenAiAttr || {});
-var AdkAttr = /* @__PURE__ */ ((AdkAttr2) => {
-  AdkAttr2["WORKFLOW_NAME"] = "adk.workflow.name";
-  AdkAttr2["NODE_PATH"] = "adk.node.path";
-  AdkAttr2["NODE_RUN_ID"] = "adk.node.run_id";
-  AdkAttr2["NODE_ATTEMPT"] = "adk.node.attempt";
-  AdkAttr2["NODE_STATUS"] = "adk.node.status";
-  AdkAttr2["NODE_INTERRUPT_COUNT"] = "adk.node.interrupt_count";
-  return AdkAttr2;
-})(AdkAttr || {});
-var GcpAttr = /* @__PURE__ */ ((GcpAttr2) => {
-  GcpAttr2["INVOCATION_ID"] = "gcp.vertex.agent.invocation_id";
-  GcpAttr2["SESSION_ID"] = "gcp.vertex.agent.session_id";
-  GcpAttr2["EVENT_ID"] = "gcp.vertex.agent.event_id";
-  GcpAttr2["LLM_REQUEST"] = "gcp.vertex.agent.llm_request";
-  GcpAttr2["LLM_RESPONSE"] = "gcp.vertex.agent.llm_response";
-  GcpAttr2["TOOL_CALL_ARGS"] = "gcp.vertex.agent.tool_call_args";
-  GcpAttr2["TOOL_RESPONSE"] = "gcp.vertex.agent.tool_response";
-  GcpAttr2["DATA"] = "gcp.vertex.agent.data";
-  return GcpAttr2;
-})(GcpAttr || {});
-const GEN_AI_SYSTEM_VALUE = "gcp.vertex.agent";
-const tracer = trace.getTracer(GEN_AI_SYSTEM_VALUE, version);
-function safeJsonSerialize(obj) {
-  try {
-    return JSON.stringify(obj);
-  } catch (_e) {
-    return "<not serializable>";
-  }
-}
-__name(safeJsonSerialize, "safeJsonSerialize");
-function traceAgentInvocation({
-  agent,
-  invocationContext
-}) {
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gen_ai.operation.name" /* OPERATION_NAME */]: "invoke_agent",
-    // Conditionally Required
-    ["gen_ai.agent.description" /* AGENT_DESCRIPTION */]: agent.description,
-    ["gen_ai.agent.name" /* AGENT_NAME */]: agent.name,
-    ["gen_ai.conversation.id" /* CONVERSATION_ID */]: invocationContext.session.id
-  });
-}
-__name(traceAgentInvocation, "traceAgentInvocation");
-function traceWorkflowInvocation({
-  workflowName,
-  nodePath,
-  sessionId
-}) {
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gen_ai.operation.name" /* OPERATION_NAME */]: "invoke_workflow",
-    ["gen_ai.conversation.id" /* CONVERSATION_ID */]: sessionId,
-    ["adk.workflow.name" /* WORKFLOW_NAME */]: workflowName,
-    ["adk.node.path" /* NODE_PATH */]: nodePath
-  });
-}
-__name(traceWorkflowInvocation, "traceWorkflowInvocation");
-function traceNodeExecution({
-  nodePath,
-  runId,
-  attempt,
-  status,
-  interruptCount
-}) {
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gen_ai.operation.name" /* OPERATION_NAME */]: "execute_node",
-    ["adk.node.path" /* NODE_PATH */]: nodePath,
-    ["adk.node.run_id" /* NODE_RUN_ID */]: runId,
-    ["adk.node.attempt" /* NODE_ATTEMPT */]: attempt,
-    ["adk.node.status" /* NODE_STATUS */]: status,
-    ["adk.node.interrupt_count" /* NODE_INTERRUPT_COUNT */]: interruptCount
-  });
-}
-__name(traceNodeExecution, "traceNodeExecution");
-function resolveErrorType(error) {
-  var _a, _b;
-  if (error !== null && (typeof error === "object" || typeof error === "function")) {
-    try {
-      const errorObject = error;
-      const customErrorType = (_a = errorObject.errorType) != null ? _a : errorObject.error_type;
-      if (typeof customErrorType === "string" || typeof customErrorType === "number") {
-        return String(customErrorType);
-      }
-      if (error instanceof ApiError) {
-        return String(error.status);
-      }
-      const constructorName = (_b = errorObject.constructor) == null ? void 0 : _b.name;
-      if (typeof constructorName === "string" && constructorName.length > 0) {
-        return constructorName;
-      }
-    } catch {
-    }
-  }
-  return typeof error;
-}
-__name(resolveErrorType, "resolveErrorType");
-function traceToolCall(params) {
-  var _a, _b, _c;
-  const {
-    tool,
-    args,
-    functionResponseEvent,
-    invocationContext,
-    error,
-    errorType
-  } = params;
-  const span = (_a = params.span) != null ? _a : trace.getActiveSpan();
-  if (!span) return;
-  const hasError = Object.hasOwn(params, "error");
-  const failureType = hasError ? resolveErrorType(error) : errorType;
-  if (hasError) {
-    let exception;
-    try {
-      exception = error instanceof Error ? error : resolveErrorType(error);
-    } catch {
-      exception = resolveErrorType(error);
-    }
-    span.recordException(exception);
-  }
-  if (failureType !== void 0) {
-    span.setAttribute("error.type", failureType);
-    span.setStatus({ code: SpanStatusCode.ERROR, message: failureType });
-  }
-  span.setAttributes({
-    ["gen_ai.operation.name" /* OPERATION_NAME */]: "execute_tool",
-    ["gen_ai.system" /* SYSTEM */]: GEN_AI_SYSTEM_VALUE,
-    ["gen_ai.tool.description" /* TOOL_DESCRIPTION */]: tool.description || "",
-    ["gen_ai.tool.name" /* TOOL_NAME */]: tool.name,
-    // e.g. FunctionTool
-    ["gen_ai.tool.type" /* TOOL_TYPE */]: tool.constructor.name,
-    ["gcp.vertex.agent.invocation_id" /* INVOCATION_ID */]: invocationContext.invocationId,
-    // Setting empty llm request and response (as UI expect these) while not
-    // applicable for tool_response.
-    ["gcp.vertex.agent.llm_request" /* LLM_REQUEST */]: "{}",
-    ["gcp.vertex.agent.llm_response" /* LLM_RESPONSE */]: "{}",
-    ["gcp.vertex.agent.tool_call_args" /* TOOL_CALL_ARGS */]: shouldAddRequestResponseToSpans() ? safeJsonSerialize(args) : "{}"
-  });
-  let toolCallId = "<not specified>";
-  let toolResponse = "<not specified>";
-  if ((_b = functionResponseEvent == null ? void 0 : functionResponseEvent.content) == null ? void 0 : _b.parts) {
-    const responseParts = functionResponseEvent.content.parts;
-    const functionResponse = (_c = responseParts[0]) == null ? void 0 : _c.functionResponse;
-    if (functionResponse == null ? void 0 : functionResponse.id) {
-      toolCallId = functionResponse.id;
-    }
-    if (functionResponse == null ? void 0 : functionResponse.response) {
-      toolResponse = functionResponse.response;
-    }
-  }
-  if (typeof toolResponse !== "object" || toolResponse === null) {
-    toolResponse = { result: toolResponse };
-  }
-  span.setAttributes({
-    ["gen_ai.tool.call.id" /* TOOL_CALL_ID */]: toolCallId,
-    ...functionResponseEvent ? { ["gcp.vertex.agent.event_id" /* EVENT_ID */]: functionResponseEvent.id } : {},
-    ["gcp.vertex.agent.tool_response" /* TOOL_RESPONSE */]: shouldAddRequestResponseToSpans() ? safeJsonSerialize(toolResponse) : "{}"
-  });
-}
-__name(traceToolCall, "traceToolCall");
-function traceMergedToolCalls({
-  responseEventId,
-  functionResponseEvent,
-  invocationContext
-}) {
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gen_ai.operation.name" /* OPERATION_NAME */]: "execute_tool",
-    ["gen_ai.system" /* SYSTEM */]: GEN_AI_SYSTEM_VALUE,
-    ["gen_ai.tool.name" /* TOOL_NAME */]: "(merged tools)",
-    ["gen_ai.tool.description" /* TOOL_DESCRIPTION */]: "(merged tools)",
-    ["gen_ai.tool.call.id" /* TOOL_CALL_ID */]: responseEventId,
-    ["gcp.vertex.agent.invocation_id" /* INVOCATION_ID */]: invocationContext.invocationId,
-    ["gcp.vertex.agent.tool_call_args" /* TOOL_CALL_ARGS */]: "N/A",
-    ["gcp.vertex.agent.event_id" /* EVENT_ID */]: responseEventId,
-    // Setting empty llm request and response (as UI expect these) while not
-    // applicable for tool_response.
-    ["gcp.vertex.agent.llm_request" /* LLM_REQUEST */]: "{}",
-    ["gcp.vertex.agent.llm_response" /* LLM_RESPONSE */]: "{}"
-  });
-  span.setAttribute(
-    "gcp.vertex.agent.tool_response" /* TOOL_RESPONSE */,
-    shouldAddRequestResponseToSpans() ? safeJsonSerialize(functionResponseEvent) : "{}"
-  );
-}
-__name(traceMergedToolCalls, "traceMergedToolCalls");
-function traceCallLlm({
-  invocationContext,
-  eventId,
-  llmRequest,
-  llmResponse
-}) {
-  var _a, _b, _c, _d;
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gen_ai.system" /* SYSTEM */]: GEN_AI_SYSTEM_VALUE,
-    ["gen_ai.request.model" /* REQUEST_MODEL */]: llmRequest.model,
-    ...((_a = invocationContext.agent) == null ? void 0 : _a.name) ? { ["gen_ai.agent.name" /* AGENT_NAME */]: invocationContext.agent.name } : {},
-    ["gcp.vertex.agent.invocation_id" /* INVOCATION_ID */]: invocationContext.invocationId,
-    ["gcp.vertex.agent.session_id" /* SESSION_ID */]: invocationContext.session.id,
-    ["gcp.vertex.agent.event_id" /* EVENT_ID */]: eventId,
-    // Consider removing once GenAI SDK provides a way to record this info.
-    ["gcp.vertex.agent.llm_request" /* LLM_REQUEST */]: shouldAddRequestResponseToSpans() ? safeJsonSerialize(buildLlmRequestForTrace(llmRequest)) : "{}"
-  });
-  if ((_b = llmRequest.config) == null ? void 0 : _b.topP) {
-    span.setAttribute("gen_ai.request.top_p" /* REQUEST_TOP_P */, llmRequest.config.topP);
-  }
-  if (((_c = llmRequest.config) == null ? void 0 : _c.maxOutputTokens) !== void 0) {
-    span.setAttribute(
-      "gen_ai.request.max_tokens" /* REQUEST_MAX_TOKENS */,
-      llmRequest.config.maxOutputTokens
-    );
-  }
-  span.setAttribute(
-    "gcp.vertex.agent.llm_response" /* LLM_RESPONSE */,
-    shouldAddRequestResponseToSpans() ? safeJsonSerialize(llmResponse) : "{}"
-  );
-  if (llmResponse.usageMetadata) {
-    span.setAttribute(
-      "gen_ai.usage.input_tokens" /* USAGE_INPUT_TOKENS */,
-      llmResponse.usageMetadata.promptTokenCount || 0
-    );
-  }
-  if ((_d = llmResponse.usageMetadata) == null ? void 0 : _d.candidatesTokenCount) {
-    span.setAttribute(
-      "gen_ai.usage.output_tokens" /* USAGE_OUTPUT_TOKENS */,
-      llmResponse.usageMetadata.candidatesTokenCount
-    );
-  }
-  if (llmResponse.finishReason) {
-    const finishReasonValue = typeof llmResponse.finishReason === "string" ? llmResponse.finishReason.toLowerCase() : String(llmResponse.finishReason).toLowerCase();
-    span.setAttribute("gen_ai.response.finish_reasons" /* RESPONSE_FINISH_REASONS */, [finishReasonValue]);
-  }
-}
-__name(traceCallLlm, "traceCallLlm");
-function traceSendData({
-  invocationContext,
-  eventId,
-  data
-}) {
-  const span = trace.getActiveSpan();
-  if (!span) return;
-  span.setAttributes({
-    ["gcp.vertex.agent.invocation_id" /* INVOCATION_ID */]: invocationContext.invocationId,
-    ["gcp.vertex.agent.event_id" /* EVENT_ID */]: eventId
-  });
-  span.setAttribute(
-    "gcp.vertex.agent.data" /* DATA */,
-    shouldAddRequestResponseToSpans() ? safeJsonSerialize(data) : "{}"
-  );
-}
-__name(traceSendData, "traceSendData");
-function redactHttpOptions(httpOptions) {
-  const redacted = { ...httpOptions };
-  delete redacted.headers;
-  delete redacted.extraBody;
-  return redacted;
-}
-__name(redactHttpOptions, "redactHttpOptions");
-function buildLlmRequestForTrace(llmRequest) {
-  const result = {
-    model: llmRequest.model,
-    contents: []
-  };
-  if (llmRequest.config) {
-    const { responseSchema: _responseSchema, ...cleanConfig } = llmRequest.config;
-    if (cleanConfig.httpOptions) {
-      cleanConfig.httpOptions = redactHttpOptions(cleanConfig.httpOptions);
-    }
-    result.config = cleanConfig;
-  }
-  result.contents = llmRequest.contents.map((content) => {
-    var _a;
-    return {
-      role: content.role,
-      parts: ((_a = content.parts) == null ? void 0 : _a.filter((part) => !part.inlineData)) || []
-    };
-  });
-  return result;
-}
-__name(buildLlmRequestForTrace, "buildLlmRequestForTrace");
-function bindOtelContextToAsyncGenerator(ctx, generator) {
-  return {
-    // Bind the next() method to execute within the provided context
-    next: context.bind(ctx, generator.next.bind(generator)),
-    // Bind the return() method to execute within the provided context
-    return: context.bind(ctx, generator.return.bind(generator)),
-    // Bind the throw() method to execute within the provided context
-    throw: context.bind(ctx, generator.throw.bind(generator)),
-    // Ensure the async iterator symbol also returns a context-bound generator
-    [Symbol.asyncIterator]() {
-      return bindOtelContextToAsyncGenerator(
-        ctx,
-        generator[Symbol.asyncIterator]()
-      );
-    }
-  };
-}
-__name(bindOtelContextToAsyncGenerator, "bindOtelContextToAsyncGenerator");
-function runAsyncGeneratorWithOtelContext(otelContext, generatorFnContext, generatorFn) {
-  const generator = generatorFn.call(generatorFnContext);
-  return bindOtelContextToAsyncGenerator(otelContext, generator);
-}
-__name(runAsyncGeneratorWithOtelContext, "runAsyncGeneratorWithOtelContext");
-function shouldAddRequestResponseToSpans() {
-  const envValue = process.env.ADK_CAPTURE_MESSAGE_CONTENT_IN_SPANS || "true";
-  return envValue === "true" || envValue === "1";
-}
-__name(shouldAddRequestResponseToSpans, "shouldAddRequestResponseToSpans");
-export {
-  resolveErrorType,
-  runAsyncGeneratorWithOtelContext,
-  traceAgentInvocation,
-  traceCallLlm,
-  traceMergedToolCalls,
-  traceNodeExecution,
-  traceSendData,
-  traceToolCall,
-  traceWorkflowInvocation,
-  tracer
-};

package/dist/types/telemetry/google_cloud.d.ts

@@ -1,9 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { Resource } from '@opentelemetry/resources';
-import { OtelExportersConfig, OTelHooks } from './setup.js';
-export declare function getGcpExporters(config?: OtelExportersConfig): Promise<OTelHooks>;
-export declare function getGcpResource(): Resource;

package/dist/types/telemetry/tracing.d.ts

@@ -1,143 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * NOTE:
- *
- *    We expect that the underlying GenAI SDK will provide a certain
- *    level of tracing and logging telemetry aligned with Open Telemetry
- *    Semantic Conventions (such as logging prompts, responses,
- *    request properties, etc.) and so the information that is recorded by the
- *    Agent Development Kit should be focused on the higher-level
- *    constructs of the framework that are not observable by the SDK.
- */
-import { Content } from '@google/genai';
-import { Context, Span } from '@opentelemetry/api';
-import { BaseAgent } from '../agents/base_agent.js';
-import { InvocationContext } from '../agents/invocation_context.js';
-import { Event } from '../events/event.js';
-import { LlmRequest } from '../models/llm_request.js';
-import { LlmResponse } from '../models/llm_response.js';
-import { BaseTool } from '../tools/base_tool.js';
-export declare const tracer: import("@opentelemetry/api").Tracer;
-export interface TraceAgentInvocationParams {
-    agent: BaseAgent;
-    invocationContext: InvocationContext;
-}
-/**
- * Sets span attributes immediately available on agent invocation according to OTEL semconv version 1.37.
- *
- * @param params The parameters object containing agent and invocation context.
- *
- * Inference related fields are not set, due to their planned removal from invoke_agent span:
- * https://github.com/open-telemetry/semantic-conventions/issues/2632
- *
- * `gen_ai.agent.id` is not set because currently it's unclear what attributes this field should have, specifically:
- * - In which scope should it be unique (globally, given project, given agentic flow, given deployment).
- * - Should it be unchanging between deployments, and how this should this be achieved.
- *
- * `gen_ai.data_source.id` is not set because it's not available.
- * Closest type which could contain this information is types.GroundingMetadata, which does not have an ID.
- *
- * `server.*` attributes are not set pending confirmation from aabmass.
- */
-export declare function traceAgentInvocation({ agent, invocationContext, }: TraceAgentInvocationParams): void;
-export interface TraceWorkflowInvocationParams {
-    workflowName: string;
-    nodePath: string;
-    sessionId: string;
-}
-export declare function traceWorkflowInvocation({ workflowName, nodePath, sessionId, }: TraceWorkflowInvocationParams): void;
-export type NodeExecutionStatus = 'completed' | 'waiting' | 'failed';
-export interface TraceNodeExecutionParams {
-    nodePath: string;
-    runId: string;
-    attempt: number;
-    status: NodeExecutionStatus;
-    interruptCount: number;
-}
-export declare function traceNodeExecution({ nodePath, runId, attempt, status, interruptCount, }: TraceNodeExecutionParams): void;
-export interface TraceToolCallParams {
-    tool: BaseTool;
-    args: Record<string, unknown>;
-    functionResponseEvent?: Event;
-    /** The exception raised while executing the tool, if any. */
-    error?: unknown;
-    /** An error type reported by a tool response instead of a thrown error. */
-    errorType?: string;
-    /** The tool execution span. Defaults to the active span when omitted. */
-    span?: Span;
-    invocationContext: InvocationContext;
-}
-/**
- * Resolves a stable error classification suitable for the OpenTelemetry
- * `error.type` attribute without using the potentially sensitive error message.
- *
- * @param error The thrown value.
- * @returns The explicit ADK error type, GenAI API status, or error class name.
- */
-export declare function resolveErrorType(error: unknown): string;
-/**
- * Traces tool call.
- *
- * @param params The parameters object containing tool, args, and function response event.
- */
-export declare function traceToolCall(params: TraceToolCallParams): void;
-export interface TraceMergedToolCallsParams {
-    responseEventId: string;
-    functionResponseEvent: Event;
-    invocationContext: InvocationContext;
-}
-/**
- * Traces merged tool call events.
- *
- * Calling this function is not needed for telemetry purposes. This is provided
- * for preventing /debug/trace requests (typically sent by web UI).
- *
- * @param params The parameters object containing response event ID and function response event.
- */
-export declare function traceMergedToolCalls({ responseEventId, functionResponseEvent, invocationContext, }: TraceMergedToolCallsParams): void;
-export interface TraceCallLlmParams {
-    invocationContext: InvocationContext;
-    eventId: string;
-    llmRequest: LlmRequest;
-    llmResponse: LlmResponse;
-}
-/**
- * Traces a call to the LLM.
- *
- * This function records details about the LLM request and response as
- * attributes on the current OpenTelemetry span.
- *
- * @param params The parameters object containing invocationContext, eventId, llmRequest, and llmResponse.
- */
-export declare function traceCallLlm({ invocationContext, eventId, llmRequest, llmResponse, }: TraceCallLlmParams): void;
-export interface TraceSendDataParams {
-    /** The invocation context for the current agent run. */
-    invocationContext: InvocationContext;
-    /** The ID of the event. */
-    eventId: string;
-    /** A list of content objects. */
-    data: Content[];
-}
-/**
- * Traces the sending of data to the agent.
- *
- * This function records details about the data sent to the agent as
- * attributes on the current OpenTelemetry span.
- *
- * @param params The parameters object containing invocationContext, eventId, and data.
- */
-export declare function traceSendData({ invocationContext, eventId, data, }: TraceSendDataParams): void;
-/**
- * Runs an async generator function with both OTEL context and JavaScript 'this' context.
- *
- * @param otelContext - The OpenTelemetry context to bind the generator to
- * @param generatorFnContext - The 'this' context to bind to the generator function
- * @param generatorFn - The generator function to execute
- *
- * @returns A new async generator that executes within both contexts
- */
-export declare function runAsyncGeneratorWithOtelContext<TThis, T>(otelContext: Context, generatorFnContext: TThis, generatorFn: (this: TThis) => AsyncGenerator<T, void, void>): AsyncGenerator<T, void, void>;