@iqai/adk 0.6.3 → 0.6.5

package/dist/constants.js

@@ -0,0 +1,289 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/telemetry/constants.ts
+var constants_exports = {};
+__export(constants_exports, {
+  ADK_ATTRS: () => ADK_ATTRS,
+  ADK_SYSTEM_NAME: () => ADK_SYSTEM_NAME,
+  DEFAULTS: () => DEFAULTS,
+  ENV_VARS: () => ENV_VARS,
+  METRICS: () => METRICS,
+  OPERATIONS: () => OPERATIONS,
+  SEMCONV: () => SEMCONV,
+  SPAN_STATUS: () => SPAN_STATUS
+});
+module.exports = __toCommonJS(constants_exports);
+var SEMCONV = {
+  // System identification (REQUIRED)
+  GEN_AI_PROVIDER_NAME: "gen_ai.provider.name",
+  // e.g., "openai", "anthropic", "aws.bedrock"
+  // Operation names (REQUIRED)
+  GEN_AI_OPERATION_NAME: "gen_ai.operation.name",
+  // Agent attributes
+  GEN_AI_AGENT_ID: "gen_ai.agent.id",
+  // Unique agent identifier
+  GEN_AI_AGENT_NAME: "gen_ai.agent.name",
+  GEN_AI_AGENT_DESCRIPTION: "gen_ai.agent.description",
+  GEN_AI_CONVERSATION_ID: "gen_ai.conversation.id",
+  // Tool attributes
+  GEN_AI_TOOL_NAME: "gen_ai.tool.name",
+  GEN_AI_TOOL_DESCRIPTION: "gen_ai.tool.description",
+  GEN_AI_TOOL_TYPE: "gen_ai.tool.type",
+  GEN_AI_TOOL_CALL_ID: "gen_ai.tool.call.id",
+  GEN_AI_TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments",
+  // Structured tool input (opt-in)
+  GEN_AI_TOOL_CALL_RESULT: "gen_ai.tool.call.result",
+  // Structured tool output (opt-in)
+  GEN_AI_TOOL_DEFINITIONS: "gen_ai.tool.definitions",
+  // Tool schemas (opt-in)
+  // LLM request attributes
+  GEN_AI_REQUEST_MODEL: "gen_ai.request.model",
+  // Conditionally required
+  GEN_AI_REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens",
+  GEN_AI_REQUEST_TEMPERATURE: "gen_ai.request.temperature",
+  GEN_AI_REQUEST_TOP_P: "gen_ai.request.top_p",
+  GEN_AI_REQUEST_TOP_K: "gen_ai.request.top_k",
+  GEN_AI_REQUEST_FREQUENCY_PENALTY: "gen_ai.request.frequency_penalty",
+  GEN_AI_REQUEST_PRESENCE_PENALTY: "gen_ai.request.presence_penalty",
+  GEN_AI_REQUEST_STOP_SEQUENCES: "gen_ai.request.stop_sequences",
+  GEN_AI_REQUEST_CHOICE_COUNT: "gen_ai.request.choice.count",
+  // Conditionally required (if !=1)
+  GEN_AI_REQUEST_SEED: "gen_ai.request.seed",
+  // Conditionally required
+  // LLM response attributes
+  GEN_AI_RESPONSE_ID: "gen_ai.response.id",
+  // Recommended - completion ID
+  GEN_AI_RESPONSE_MODEL: "gen_ai.response.model",
+  // Recommended - actual model name returned
+  GEN_AI_RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons",
+  GEN_AI_OUTPUT_TYPE: "gen_ai.output.type",
+  // Conditionally required - "text", "json", "image", "speech"
+  // Token usage (input/output only; total is computed client-side)
+  GEN_AI_USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+  GEN_AI_USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+  // Content attributes (opt-in, large/PII)
+  GEN_AI_SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions",
+  // System prompt
+  GEN_AI_INPUT_MESSAGES: "gen_ai.input.messages",
+  // Full chat history input
+  GEN_AI_OUTPUT_MESSAGES: "gen_ai.output.messages",
+  // Model output messages
+  // Server attributes (Recommended)
+  SERVER_ADDRESS: "server.address",
+  // GenAI server host
+  SERVER_PORT: "server.port",
+  // Conditionally required if server.address is set
+  // Error attributes (Conditionally required on error)
+  ERROR_TYPE: "error.type",
+  // Low-cardinality error identifier
+  // Data source (for RAG/knowledge base)
+  GEN_AI_DATA_SOURCE_ID: "gen_ai.data_source.id",
+  // Embeddings (for future support)
+  GEN_AI_EMBEDDINGS_DIMENSION_COUNT: "gen_ai.embeddings.dimension.count",
+  GEN_AI_REQUEST_ENCODING_FORMATS: "gen_ai.request.encoding_formats",
+  // ============================================
+  // DEPRECATED ATTRIBUTES (kept for backward compatibility)
+  // These will be removed in a future release
+  // ============================================
+  /**
+   * @deprecated Use GEN_AI_PROVIDER_NAME instead
+   */
+  GEN_AI_SYSTEM: "gen_ai.system",
+  /**
+   * @deprecated Total tokens should be computed client-side from input + output
+   */
+  GEN_AI_USAGE_TOTAL_TOKENS: "gen_ai.usage.total_tokens",
+  /**
+   * @deprecated Use GEN_AI_INPUT_MESSAGES or structured events instead
+   */
+  GEN_AI_CONTENT_PROMPT: "gen_ai.content.prompt",
+  /**
+   * @deprecated Use GEN_AI_OUTPUT_MESSAGES or structured events instead
+   */
+  GEN_AI_CONTENT_COMPLETION: "gen_ai.content.completion"
+};
+var ADK_ATTRS = {
+  // ============================================
+  // TIER 1: Always Present (Core Identity)
+  // ============================================
+  // System identification
+  SYSTEM_NAME: "adk.system.name",
+  SYSTEM_VERSION: "adk.system.version",
+  // Session and context
+  SESSION_ID: "adk.session.id",
+  USER_ID: "adk.user.id",
+  INVOCATION_ID: "adk.invocation.id",
+  EVENT_ID: "adk.event.id",
+  // Environment
+  ENVIRONMENT: "adk.environment",
+  // ============================================
+  // TIER 2: Operation-Specific (Standard)
+  // ============================================
+  // Agent attributes
+  AGENT_NAME: "adk.agent.name",
+  AGENT_DESCRIPTION: "adk.agent.description",
+  // Transfer attributes (for multi-agent)
+  TRANSFER_SOURCE_AGENT: "adk.transfer.source_agent",
+  TRANSFER_TARGET_AGENT: "adk.transfer.target_agent",
+  TRANSFER_CHAIN: "adk.transfer.chain",
+  TRANSFER_DEPTH: "adk.transfer.depth",
+  TRANSFER_ROOT_AGENT: "adk.transfer.root_agent",
+  TRANSFER_REASON: "adk.transfer.reason",
+  // Tool attributes
+  TOOL_NAME: "adk.tool.name",
+  TOOL_ARGS: "adk.tool.args",
+  TOOL_RESPONSE: "adk.tool.response",
+  TOOL_EXECUTION_ORDER: "adk.tool.execution_order",
+  TOOL_PARALLEL_GROUP: "adk.tool.parallel_group",
+  TOOL_RETRY_COUNT: "adk.tool.retry_count",
+  TOOL_IS_CALLBACK_OVERRIDE: "adk.tool.is_callback_override",
+  // LLM attributes
+  LLM_MODEL: "adk.llm.model",
+  LLM_REQUEST: "adk.llm.request",
+  LLM_RESPONSE: "adk.llm.response",
+  LLM_STREAMING: "adk.llm.streaming",
+  LLM_TIME_TO_FIRST_TOKEN: "adk.llm.time_to_first_token_ms",
+  LLM_CHUNK_COUNT: "adk.llm.chunk_count",
+  LLM_CACHED_TOKENS: "adk.llm.cached_tokens",
+  LLM_CONTEXT_WINDOW_USED_PCT: "adk.llm.context_window_used_pct",
+  // Callback attributes
+  CALLBACK_TYPE: "adk.callback.type",
+  CALLBACK_NAME: "adk.callback.name",
+  CALLBACK_INDEX: "adk.callback.index",
+  // ============================================
+  // Error Categorization
+  // ============================================
+  ERROR_CATEGORY: "adk.error.category",
+  ERROR_RECOVERABLE: "adk.error.recoverable",
+  ERROR_RETRY_RECOMMENDED: "adk.error.retry_recommended",
+  // ============================================
+  // Memory & Session
+  // ============================================
+  MEMORY_QUERY: "adk.memory.query",
+  MEMORY_RESULTS_COUNT: "adk.memory.results_count",
+  // Plugin
+  PLUGIN_NAME: "adk.plugin.name",
+  PLUGIN_HOOK: "adk.plugin.hook"
+};
+var OPERATIONS = {
+  // ============================================
+  // Standard OpenTelemetry GenAI operations
+  // ============================================
+  CHAT: "chat",
+  // Chat completion (most common)
+  TEXT_COMPLETION: "text_completion",
+  // Legacy text completion
+  GENERATE_CONTENT: "generate_content",
+  // Generic content generation
+  // Agent operations
+  INVOKE_AGENT: "invoke_agent",
+  CREATE_AGENT: "create_agent",
+  // Tool operations
+  EXECUTE_TOOL: "execute_tool",
+  // ============================================
+  // ADK-specific operations (framework extensions)
+  // These are non-standard but useful for the ADK framework
+  // ============================================
+  TRANSFER_AGENT: "transfer_agent",
+  // Multi-agent transfer
+  EXECUTE_CALLBACK: "execute_callback",
+  // Callback execution
+  // Service operations
+  SEARCH_MEMORY: "search_memory",
+  // Memory search
+  INSERT_MEMORY: "insert_memory",
+  // Memory insert
+  EXECUTE_PLUGIN: "execute_plugin",
+  // Plugin execution
+  // ============================================
+  // DEPRECATED OPERATIONS (kept for backward compatibility)
+  // ============================================
+  /**
+   * @deprecated Use CHAT, TEXT_COMPLETION, or GENERATE_CONTENT instead
+   */
+  CALL_LLM: "call_llm"
+};
+var ADK_SYSTEM_NAME = "iqai-adk";
+var ENV_VARS = {
+  // Privacy control
+  CAPTURE_MESSAGE_CONTENT: "ADK_CAPTURE_MESSAGE_CONTENT",
+  // OpenTelemetry standard env vars
+  OTEL_SERVICE_NAME: "OTEL_SERVICE_NAME",
+  OTEL_RESOURCE_ATTRIBUTES: "OTEL_RESOURCE_ATTRIBUTES",
+  OTEL_EXPORTER_OTLP_ENDPOINT: "OTEL_EXPORTER_OTLP_ENDPOINT",
+  OTEL_EXPORTER_OTLP_HEADERS: "OTEL_EXPORTER_OTLP_HEADERS",
+  // Node environment
+  NODE_ENV: "NODE_ENV"
+};
+var METRICS = {
+  // ============================================
+  // Standard OpenTelemetry GenAI Metrics
+  // Reference: https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-metrics/
+  // ============================================
+  // Required: Client operation duration (Histogram, seconds)
+  GEN_AI_CLIENT_OPERATION_DURATION: "gen_ai.client.operation.duration",
+  // Recommended: Token usage (Histogram, tokens)
+  // Use with gen_ai.token.type attribute: "input" or "output"
+  GEN_AI_CLIENT_TOKEN_USAGE: "gen_ai.client.token.usage",
+  // Server-side metrics (if hosting GenAI service)
+  GEN_AI_SERVER_REQUEST_DURATION: "gen_ai.server.request.duration",
+  GEN_AI_SERVER_TIME_TO_FIRST_TOKEN: "gen_ai.server.time_to_first_token",
+  GEN_AI_SERVER_TIME_PER_OUTPUT_TOKEN: "gen_ai.server.time_per_output_token",
+  // ============================================
+  // ADK-specific Metrics (framework extensions)
+  // ============================================
+  // Counters
+  AGENT_INVOCATIONS: "adk.agent.invocations",
+  TOOL_EXECUTIONS: "adk.tool.executions",
+  LLM_CALLS: "adk.llm.calls",
+  ERRORS: "adk.errors",
+  // Histograms
+  AGENT_DURATION: "adk.agent.duration",
+  TOOL_DURATION: "adk.tool.duration",
+  LLM_DURATION: "adk.llm.duration",
+  LLM_TOKENS: "adk.llm.tokens",
+  LLM_INPUT_TOKENS: "adk.llm.tokens.input",
+  LLM_OUTPUT_TOKENS: "adk.llm.tokens.output"
+};
+var SPAN_STATUS = {
+  UNSET: 0,
+  OK: 1,
+  ERROR: 2
+};
+var DEFAULTS = {
+  SAMPLING_RATIO: 1,
+  METRIC_EXPORT_INTERVAL_MS: 6e4,
+  // 1 minute
+  SHUTDOWN_TIMEOUT_MS: 5e3,
+  CAPTURE_MESSAGE_CONTENT: true,
+  ENABLE_TRACING: true,
+  ENABLE_METRICS: true,
+  ENABLE_AUTO_INSTRUMENTATION: false
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ADK_ATTRS,
+  ADK_SYSTEM_NAME,
+  DEFAULTS,
+  ENV_VARS,
+  METRICS,
+  OPERATIONS,
+  SEMCONV,
+  SPAN_STATUS
+});

package/dist/constants.mjs

@@ -0,0 +1,258 @@
+// src/telemetry/constants.ts
+var SEMCONV = {
+  // System identification (REQUIRED)
+  GEN_AI_PROVIDER_NAME: "gen_ai.provider.name",
+  // e.g., "openai", "anthropic", "aws.bedrock"
+  // Operation names (REQUIRED)
+  GEN_AI_OPERATION_NAME: "gen_ai.operation.name",
+  // Agent attributes
+  GEN_AI_AGENT_ID: "gen_ai.agent.id",
+  // Unique agent identifier
+  GEN_AI_AGENT_NAME: "gen_ai.agent.name",
+  GEN_AI_AGENT_DESCRIPTION: "gen_ai.agent.description",
+  GEN_AI_CONVERSATION_ID: "gen_ai.conversation.id",
+  // Tool attributes
+  GEN_AI_TOOL_NAME: "gen_ai.tool.name",
+  GEN_AI_TOOL_DESCRIPTION: "gen_ai.tool.description",
+  GEN_AI_TOOL_TYPE: "gen_ai.tool.type",
+  GEN_AI_TOOL_CALL_ID: "gen_ai.tool.call.id",
+  GEN_AI_TOOL_CALL_ARGUMENTS: "gen_ai.tool.call.arguments",
+  // Structured tool input (opt-in)
+  GEN_AI_TOOL_CALL_RESULT: "gen_ai.tool.call.result",
+  // Structured tool output (opt-in)
+  GEN_AI_TOOL_DEFINITIONS: "gen_ai.tool.definitions",
+  // Tool schemas (opt-in)
+  // LLM request attributes
+  GEN_AI_REQUEST_MODEL: "gen_ai.request.model",
+  // Conditionally required
+  GEN_AI_REQUEST_MAX_TOKENS: "gen_ai.request.max_tokens",
+  GEN_AI_REQUEST_TEMPERATURE: "gen_ai.request.temperature",
+  GEN_AI_REQUEST_TOP_P: "gen_ai.request.top_p",
+  GEN_AI_REQUEST_TOP_K: "gen_ai.request.top_k",
+  GEN_AI_REQUEST_FREQUENCY_PENALTY: "gen_ai.request.frequency_penalty",
+  GEN_AI_REQUEST_PRESENCE_PENALTY: "gen_ai.request.presence_penalty",
+  GEN_AI_REQUEST_STOP_SEQUENCES: "gen_ai.request.stop_sequences",
+  GEN_AI_REQUEST_CHOICE_COUNT: "gen_ai.request.choice.count",
+  // Conditionally required (if !=1)
+  GEN_AI_REQUEST_SEED: "gen_ai.request.seed",
+  // Conditionally required
+  // LLM response attributes
+  GEN_AI_RESPONSE_ID: "gen_ai.response.id",
+  // Recommended - completion ID
+  GEN_AI_RESPONSE_MODEL: "gen_ai.response.model",
+  // Recommended - actual model name returned
+  GEN_AI_RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons",
+  GEN_AI_OUTPUT_TYPE: "gen_ai.output.type",
+  // Conditionally required - "text", "json", "image", "speech"
+  // Token usage (input/output only; total is computed client-side)
+  GEN_AI_USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+  GEN_AI_USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+  // Content attributes (opt-in, large/PII)
+  GEN_AI_SYSTEM_INSTRUCTIONS: "gen_ai.system_instructions",
+  // System prompt
+  GEN_AI_INPUT_MESSAGES: "gen_ai.input.messages",
+  // Full chat history input
+  GEN_AI_OUTPUT_MESSAGES: "gen_ai.output.messages",
+  // Model output messages
+  // Server attributes (Recommended)
+  SERVER_ADDRESS: "server.address",
+  // GenAI server host
+  SERVER_PORT: "server.port",
+  // Conditionally required if server.address is set
+  // Error attributes (Conditionally required on error)
+  ERROR_TYPE: "error.type",
+  // Low-cardinality error identifier
+  // Data source (for RAG/knowledge base)
+  GEN_AI_DATA_SOURCE_ID: "gen_ai.data_source.id",
+  // Embeddings (for future support)
+  GEN_AI_EMBEDDINGS_DIMENSION_COUNT: "gen_ai.embeddings.dimension.count",
+  GEN_AI_REQUEST_ENCODING_FORMATS: "gen_ai.request.encoding_formats",
+  // ============================================
+  // DEPRECATED ATTRIBUTES (kept for backward compatibility)
+  // These will be removed in a future release
+  // ============================================
+  /**
+   * @deprecated Use GEN_AI_PROVIDER_NAME instead
+   */
+  GEN_AI_SYSTEM: "gen_ai.system",
+  /**
+   * @deprecated Total tokens should be computed client-side from input + output
+   */
+  GEN_AI_USAGE_TOTAL_TOKENS: "gen_ai.usage.total_tokens",
+  /**
+   * @deprecated Use GEN_AI_INPUT_MESSAGES or structured events instead
+   */
+  GEN_AI_CONTENT_PROMPT: "gen_ai.content.prompt",
+  /**
+   * @deprecated Use GEN_AI_OUTPUT_MESSAGES or structured events instead
+   */
+  GEN_AI_CONTENT_COMPLETION: "gen_ai.content.completion"
+};
+var ADK_ATTRS = {
+  // ============================================
+  // TIER 1: Always Present (Core Identity)
+  // ============================================
+  // System identification
+  SYSTEM_NAME: "adk.system.name",
+  SYSTEM_VERSION: "adk.system.version",
+  // Session and context
+  SESSION_ID: "adk.session.id",
+  USER_ID: "adk.user.id",
+  INVOCATION_ID: "adk.invocation.id",
+  EVENT_ID: "adk.event.id",
+  // Environment
+  ENVIRONMENT: "adk.environment",
+  // ============================================
+  // TIER 2: Operation-Specific (Standard)
+  // ============================================
+  // Agent attributes
+  AGENT_NAME: "adk.agent.name",
+  AGENT_DESCRIPTION: "adk.agent.description",
+  // Transfer attributes (for multi-agent)
+  TRANSFER_SOURCE_AGENT: "adk.transfer.source_agent",
+  TRANSFER_TARGET_AGENT: "adk.transfer.target_agent",
+  TRANSFER_CHAIN: "adk.transfer.chain",
+  TRANSFER_DEPTH: "adk.transfer.depth",
+  TRANSFER_ROOT_AGENT: "adk.transfer.root_agent",
+  TRANSFER_REASON: "adk.transfer.reason",
+  // Tool attributes
+  TOOL_NAME: "adk.tool.name",
+  TOOL_ARGS: "adk.tool.args",
+  TOOL_RESPONSE: "adk.tool.response",
+  TOOL_EXECUTION_ORDER: "adk.tool.execution_order",
+  TOOL_PARALLEL_GROUP: "adk.tool.parallel_group",
+  TOOL_RETRY_COUNT: "adk.tool.retry_count",
+  TOOL_IS_CALLBACK_OVERRIDE: "adk.tool.is_callback_override",
+  // LLM attributes
+  LLM_MODEL: "adk.llm.model",
+  LLM_REQUEST: "adk.llm.request",
+  LLM_RESPONSE: "adk.llm.response",
+  LLM_STREAMING: "adk.llm.streaming",
+  LLM_TIME_TO_FIRST_TOKEN: "adk.llm.time_to_first_token_ms",
+  LLM_CHUNK_COUNT: "adk.llm.chunk_count",
+  LLM_CACHED_TOKENS: "adk.llm.cached_tokens",
+  LLM_CONTEXT_WINDOW_USED_PCT: "adk.llm.context_window_used_pct",
+  // Callback attributes
+  CALLBACK_TYPE: "adk.callback.type",
+  CALLBACK_NAME: "adk.callback.name",
+  CALLBACK_INDEX: "adk.callback.index",
+  // ============================================
+  // Error Categorization
+  // ============================================
+  ERROR_CATEGORY: "adk.error.category",
+  ERROR_RECOVERABLE: "adk.error.recoverable",
+  ERROR_RETRY_RECOMMENDED: "adk.error.retry_recommended",
+  // ============================================
+  // Memory & Session
+  // ============================================
+  MEMORY_QUERY: "adk.memory.query",
+  MEMORY_RESULTS_COUNT: "adk.memory.results_count",
+  // Plugin
+  PLUGIN_NAME: "adk.plugin.name",
+  PLUGIN_HOOK: "adk.plugin.hook"
+};
+var OPERATIONS = {
+  // ============================================
+  // Standard OpenTelemetry GenAI operations
+  // ============================================
+  CHAT: "chat",
+  // Chat completion (most common)
+  TEXT_COMPLETION: "text_completion",
+  // Legacy text completion
+  GENERATE_CONTENT: "generate_content",
+  // Generic content generation
+  // Agent operations
+  INVOKE_AGENT: "invoke_agent",
+  CREATE_AGENT: "create_agent",
+  // Tool operations
+  EXECUTE_TOOL: "execute_tool",
+  // ============================================
+  // ADK-specific operations (framework extensions)
+  // These are non-standard but useful for the ADK framework
+  // ============================================
+  TRANSFER_AGENT: "transfer_agent",
+  // Multi-agent transfer
+  EXECUTE_CALLBACK: "execute_callback",
+  // Callback execution
+  // Service operations
+  SEARCH_MEMORY: "search_memory",
+  // Memory search
+  INSERT_MEMORY: "insert_memory",
+  // Memory insert
+  EXECUTE_PLUGIN: "execute_plugin",
+  // Plugin execution
+  // ============================================
+  // DEPRECATED OPERATIONS (kept for backward compatibility)
+  // ============================================
+  /**
+   * @deprecated Use CHAT, TEXT_COMPLETION, or GENERATE_CONTENT instead
+   */
+  CALL_LLM: "call_llm"
+};
+var ADK_SYSTEM_NAME = "iqai-adk";
+var ENV_VARS = {
+  // Privacy control
+  CAPTURE_MESSAGE_CONTENT: "ADK_CAPTURE_MESSAGE_CONTENT",
+  // OpenTelemetry standard env vars
+  OTEL_SERVICE_NAME: "OTEL_SERVICE_NAME",
+  OTEL_RESOURCE_ATTRIBUTES: "OTEL_RESOURCE_ATTRIBUTES",
+  OTEL_EXPORTER_OTLP_ENDPOINT: "OTEL_EXPORTER_OTLP_ENDPOINT",
+  OTEL_EXPORTER_OTLP_HEADERS: "OTEL_EXPORTER_OTLP_HEADERS",
+  // Node environment
+  NODE_ENV: "NODE_ENV"
+};
+var METRICS = {
+  // ============================================
+  // Standard OpenTelemetry GenAI Metrics
+  // Reference: https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-metrics/
+  // ============================================
+  // Required: Client operation duration (Histogram, seconds)
+  GEN_AI_CLIENT_OPERATION_DURATION: "gen_ai.client.operation.duration",
+  // Recommended: Token usage (Histogram, tokens)
+  // Use with gen_ai.token.type attribute: "input" or "output"
+  GEN_AI_CLIENT_TOKEN_USAGE: "gen_ai.client.token.usage",
+  // Server-side metrics (if hosting GenAI service)
+  GEN_AI_SERVER_REQUEST_DURATION: "gen_ai.server.request.duration",
+  GEN_AI_SERVER_TIME_TO_FIRST_TOKEN: "gen_ai.server.time_to_first_token",
+  GEN_AI_SERVER_TIME_PER_OUTPUT_TOKEN: "gen_ai.server.time_per_output_token",
+  // ============================================
+  // ADK-specific Metrics (framework extensions)
+  // ============================================
+  // Counters
+  AGENT_INVOCATIONS: "adk.agent.invocations",
+  TOOL_EXECUTIONS: "adk.tool.executions",
+  LLM_CALLS: "adk.llm.calls",
+  ERRORS: "adk.errors",
+  // Histograms
+  AGENT_DURATION: "adk.agent.duration",
+  TOOL_DURATION: "adk.tool.duration",
+  LLM_DURATION: "adk.llm.duration",
+  LLM_TOKENS: "adk.llm.tokens",
+  LLM_INPUT_TOKENS: "adk.llm.tokens.input",
+  LLM_OUTPUT_TOKENS: "adk.llm.tokens.output"
+};
+var SPAN_STATUS = {
+  UNSET: 0,
+  OK: 1,
+  ERROR: 2
+};
+var DEFAULTS = {
+  SAMPLING_RATIO: 1,
+  METRIC_EXPORT_INTERVAL_MS: 6e4,
+  // 1 minute
+  SHUTDOWN_TIMEOUT_MS: 5e3,
+  CAPTURE_MESSAGE_CONTENT: true,
+  ENABLE_TRACING: true,
+  ENABLE_METRICS: true,
+  ENABLE_AUTO_INSTRUMENTATION: false
+};
+export {
+  ADK_ATTRS,
+  ADK_SYSTEM_NAME,
+  DEFAULTS,
+  ENV_VARS,
+  METRICS,
+  OPERATIONS,
+  SEMCONV,
+  SPAN_STATUS
+};