@iqai/adk 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @iqai/adk
 
+## 0.6.3
+
+### Patch Changes
+
+- ad1b38b: Improve tracing with sequential span indices for better observability.
+  - Add span counters to `InvocationContext` for tracking LLM, tool, and agent invocations
+  - Update trace span names to include indices (e.g., `agent_run [my-agent] #1`, `execute_tool [search] #1`, `llm_generate [gpt-4] #1`)
+  - Include app name in invocation span for better traceability
+  - Disable auto instrumentation by default to reduce trace noise
+  - Update telemetry documentation with new span naming conventions
+
 ## 0.6.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -3497,6 +3497,11 @@ declare class TranscriptionEntry {
     });
 }
 
+type SpanCounters = {
+    llm: number;
+    tool: number;
+    agent: number;
+};
 /**
  * Transfer context for multi-agent workflows
  * Tracks the chain of agent transfers for telemetry
@@ -3560,7 +3565,7 @@ declare function newInvocationContextId(): string;
  *     ┌─────────────────────── invocation ──────────────────────────┐
  *     ┌──────────── llm_agent_call_1 ────────────┐ ┌─ agent_call_2 ─┐
  *     ┌──── step_1 ────────┐ ┌───── step_2 ──────┐
- *     [call_llm] [call_tool] [call_llm] [transfer]
+ *     [llm_generate] [execute_tool] [llm_generate] [transfer]
  *
  */
 declare class InvocationContext {
@@ -3640,6 +3645,7 @@ declare class InvocationContext {
      * of this invocation.
      */
     private readonly _invocationCostManager;
+    private readonly _spanCounters;
     /**
      * Constructor for InvocationContext
      */
@@ -3660,6 +3666,7 @@ declare class InvocationContext {
         runConfig?: RunConfig;
         contextCacheConfig?: ContextCacheConfig;
         transferContext?: TransferContext;
+        spanCounters?: SpanCounters;
     });
     /**
      * App name from the session
@@ -3675,6 +3682,22 @@ declare class InvocationContext {
      * @throws {LlmCallsLimitExceededError} If number of llm calls made exceed the set threshold.
      */
     incrementLlmCallCount(): void;
+    /**
+     * Returns the next LLM span index for this invocation.
+     */
+    nextLlmSpanIndex(): number;
+    /**
+     * Returns the next tool span index for this invocation.
+     */
+    nextToolSpanIndex(): number;
+    /**
+     * Returns the next agent span index for this invocation.
+     */
+    nextAgentSpanIndex(): number;
+    /**
+     * Exposes shared span counters for child contexts.
+     */
+    getSpanCounters(): SpanCounters;
     /**
      * Creates a child invocation context for a sub-agent
      */
@@ -5115,6 +5138,7 @@ type index$5_SingleAfterToolCallback = SingleAfterToolCallback;
 type index$5_SingleAgentCallback = SingleAgentCallback;
 type index$5_SingleBeforeModelCallback = SingleBeforeModelCallback;
 type index$5_SingleBeforeToolCallback = SingleBeforeToolCallback;
+type index$5_SpanCounters = SpanCounters;
 type index$5_StreamingMode = StreamingMode;
 declare const index$5_StreamingMode: typeof StreamingMode;
 type index$5_ToolUnion = ToolUnion;
@@ -5124,7 +5148,7 @@ declare const index$5_createBranchContextForSubAgent: typeof createBranchContext
 declare const index$5_mergeAgentRun: typeof mergeAgentRun;
 declare const index$5_newInvocationContextId: typeof newInvocationContextId;
 declare namespace index$5 {
-  export { type index$5_AfterAgentCallback as AfterAgentCallback, type index$5_AfterModelCallback as AfterModelCallback, type index$5_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$5_AgentBuilder as AgentBuilder, type index$5_AgentBuilderConfig as AgentBuilderConfig, type index$5_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$5_AgentType as AgentType, index$5_BaseAgent as BaseAgent, type index$5_BeforeAgentCallback as BeforeAgentCallback, type index$5_BeforeModelCallback as BeforeModelCallback, type index$5_BeforeToolCallback as BeforeToolCallback, type index$5_BuiltAgent as BuiltAgent, index$5_CallbackContext as CallbackContext, index$5_ContextCacheConfig as ContextCacheConfig, type index$5_ContextCacheConfigProps as ContextCacheConfigProps, type index$5_EnhancedRunner as EnhancedRunner, type index$5_FullMessage as FullMessage, type index$5_InstructionProvider as InstructionProvider, index$5_InvocationContext as InvocationContext, index$5_LangGraphAgent as LangGraphAgent, type index$5_LangGraphAgentConfig as LangGraphAgentConfig, type index$5_LangGraphNode as LangGraphNode, index$5_LlmAgent as LlmAgent, type index$5_LlmAgentConfig as LlmAgentConfig, index$5_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$5_LoopAgent as LoopAgent, type index$5_LoopAgentConfig as LoopAgentConfig, type index$5_MessagePart as MessagePart, type index$5_MultiAgentResponse as MultiAgentResponse, index$5_ParallelAgent as ParallelAgent, type index$5_ParallelAgentConfig as ParallelAgentConfig, index$5_ReadonlyContext as ReadonlyContext, index$5_RunConfig as RunConfig, type index$5_RunnerAskReturn as RunnerAskReturn, index$5_SequentialAgent as SequentialAgent, type index$5_SequentialAgentConfig as SequentialAgentConfig, type index$5_SessionOptions as SessionOptions, type index$5_SingleAfterModelCallback as SingleAfterModelCallback, type index$5_SingleAfterToolCallback as SingleAfterToolCallback, type index$5_SingleAgentCallback as SingleAgentCallback, type index$5_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$5_SingleBeforeToolCallback as SingleBeforeToolCallback, index$5_StreamingMode as StreamingMode, type index$5_ToolUnion as ToolUnion, type index$5_TransferContext as TransferContext, index$5_contextCacheConfigSchema as contextCacheConfigSchema, index$5_createBranchContextForSubAgent as createBranchContextForSubAgent, index$5_mergeAgentRun as mergeAgentRun, index$5_newInvocationContextId as newInvocationContextId };
+  export { type index$5_AfterAgentCallback as AfterAgentCallback, type index$5_AfterModelCallback as AfterModelCallback, type index$5_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$5_AgentBuilder as AgentBuilder, type index$5_AgentBuilderConfig as AgentBuilderConfig, type index$5_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$5_AgentType as AgentType, index$5_BaseAgent as BaseAgent, type index$5_BeforeAgentCallback as BeforeAgentCallback, type index$5_BeforeModelCallback as BeforeModelCallback, type index$5_BeforeToolCallback as BeforeToolCallback, type index$5_BuiltAgent as BuiltAgent, index$5_CallbackContext as CallbackContext, index$5_ContextCacheConfig as ContextCacheConfig, type index$5_ContextCacheConfigProps as ContextCacheConfigProps, type index$5_EnhancedRunner as EnhancedRunner, type index$5_FullMessage as FullMessage, type index$5_InstructionProvider as InstructionProvider, index$5_InvocationContext as InvocationContext, index$5_LangGraphAgent as LangGraphAgent, type index$5_LangGraphAgentConfig as LangGraphAgentConfig, type index$5_LangGraphNode as LangGraphNode, index$5_LlmAgent as LlmAgent, type index$5_LlmAgentConfig as LlmAgentConfig, index$5_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$5_LoopAgent as LoopAgent, type index$5_LoopAgentConfig as LoopAgentConfig, type index$5_MessagePart as MessagePart, type index$5_MultiAgentResponse as MultiAgentResponse, index$5_ParallelAgent as ParallelAgent, type index$5_ParallelAgentConfig as ParallelAgentConfig, index$5_ReadonlyContext as ReadonlyContext, index$5_RunConfig as RunConfig, type index$5_RunnerAskReturn as RunnerAskReturn, index$5_SequentialAgent as SequentialAgent, type index$5_SequentialAgentConfig as SequentialAgentConfig, type index$5_SessionOptions as SessionOptions, type index$5_SingleAfterModelCallback as SingleAfterModelCallback, type index$5_SingleAfterToolCallback as SingleAfterToolCallback, type index$5_SingleAgentCallback as SingleAgentCallback, type index$5_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$5_SingleBeforeToolCallback as SingleBeforeToolCallback, type index$5_SpanCounters as SpanCounters, index$5_StreamingMode as StreamingMode, type index$5_ToolUnion as ToolUnion, type index$5_TransferContext as TransferContext, index$5_contextCacheConfigSchema as contextCacheConfigSchema, index$5_createBranchContextForSubAgent as createBranchContextForSubAgent, index$5_mergeAgentRun as mergeAgentRun, index$5_newInvocationContextId as newInvocationContextId };
 }
 
 interface ParsedArtifactUri {
@@ -6894,7 +6918,7 @@ declare const DEFAULTS: {
     readonly CAPTURE_MESSAGE_CONTENT: true;
     readonly ENABLE_TRACING: true;
     readonly ENABLE_METRICS: true;
-    readonly ENABLE_AUTO_INSTRUMENTATION: true;
+    readonly ENABLE_AUTO_INSTRUMENTATION: false;
 };
 
 /**
@@ -7087,4 +7111,4 @@ declare const recordLlmCall: (dimensions: LlmMetricDimensions) => void;
 
 declare const VERSION = "0.1.0";
 
-export { ADK_ATTRS, ADK_SYSTEM_NAME, AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DEFAULTS, DatabaseSessionService, ENV_VARS, EditTool, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$4 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$7 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$3 as Flows, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, METRICS, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$2 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OPERATIONS, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$1 as Plugins, PrebuiltMetrics, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, ReadTool, ReadonlyContext, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SEMCONV, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, type ToolSpanAttributes, type ToolUnion, index$8 as Tools, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, WebFetchTool, WebSearchTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, telemetryService, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };
+export { ADK_ATTRS, ADK_SYSTEM_NAME, AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DEFAULTS, DatabaseSessionService, ENV_VARS, EditTool, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$4 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$7 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$3 as Flows, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, METRICS, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$2 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OPERATIONS, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$1 as Plugins, PrebuiltMetrics, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, ReadTool, ReadonlyContext, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SEMCONV, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, type SpanCounters, State, StreamingMode, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, type ToolSpanAttributes, type ToolUnion, index$8 as Tools, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, WebFetchTool, WebSearchTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, telemetryService, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };

package/dist/index.d.ts

@@ -3497,6 +3497,11 @@ declare class TranscriptionEntry {
     });
 }
 
+type SpanCounters = {
+    llm: number;
+    tool: number;
+    agent: number;
+};
 /**
  * Transfer context for multi-agent workflows
  * Tracks the chain of agent transfers for telemetry
@@ -3560,7 +3565,7 @@ declare function newInvocationContextId(): string;
  *     ┌─────────────────────── invocation ──────────────────────────┐
  *     ┌──────────── llm_agent_call_1 ────────────┐ ┌─ agent_call_2 ─┐
  *     ┌──── step_1 ────────┐ ┌───── step_2 ──────┐
- *     [call_llm] [call_tool] [call_llm] [transfer]
+ *     [llm_generate] [execute_tool] [llm_generate] [transfer]
  *
  */
 declare class InvocationContext {
@@ -3640,6 +3645,7 @@ declare class InvocationContext {
      * of this invocation.
      */
     private readonly _invocationCostManager;
+    private readonly _spanCounters;
     /**
      * Constructor for InvocationContext
      */
@@ -3660,6 +3666,7 @@ declare class InvocationContext {
         runConfig?: RunConfig;
         contextCacheConfig?: ContextCacheConfig;
         transferContext?: TransferContext;
+        spanCounters?: SpanCounters;
     });
     /**
      * App name from the session
@@ -3675,6 +3682,22 @@ declare class InvocationContext {
      * @throws {LlmCallsLimitExceededError} If number of llm calls made exceed the set threshold.
      */
     incrementLlmCallCount(): void;
+    /**
+     * Returns the next LLM span index for this invocation.
+     */
+    nextLlmSpanIndex(): number;
+    /**
+     * Returns the next tool span index for this invocation.
+     */
+    nextToolSpanIndex(): number;
+    /**
+     * Returns the next agent span index for this invocation.
+     */
+    nextAgentSpanIndex(): number;
+    /**
+     * Exposes shared span counters for child contexts.
+     */
+    getSpanCounters(): SpanCounters;
     /**
      * Creates a child invocation context for a sub-agent
      */
@@ -5115,6 +5138,7 @@ type index$5_SingleAfterToolCallback = SingleAfterToolCallback;
 type index$5_SingleAgentCallback = SingleAgentCallback;
 type index$5_SingleBeforeModelCallback = SingleBeforeModelCallback;
 type index$5_SingleBeforeToolCallback = SingleBeforeToolCallback;
+type index$5_SpanCounters = SpanCounters;
 type index$5_StreamingMode = StreamingMode;
 declare const index$5_StreamingMode: typeof StreamingMode;
 type index$5_ToolUnion = ToolUnion;
@@ -5124,7 +5148,7 @@ declare const index$5_createBranchContextForSubAgent: typeof createBranchContext
 declare const index$5_mergeAgentRun: typeof mergeAgentRun;
 declare const index$5_newInvocationContextId: typeof newInvocationContextId;
 declare namespace index$5 {
-  export { type index$5_AfterAgentCallback as AfterAgentCallback, type index$5_AfterModelCallback as AfterModelCallback, type index$5_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$5_AgentBuilder as AgentBuilder, type index$5_AgentBuilderConfig as AgentBuilderConfig, type index$5_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$5_AgentType as AgentType, index$5_BaseAgent as BaseAgent, type index$5_BeforeAgentCallback as BeforeAgentCallback, type index$5_BeforeModelCallback as BeforeModelCallback, type index$5_BeforeToolCallback as BeforeToolCallback, type index$5_BuiltAgent as BuiltAgent, index$5_CallbackContext as CallbackContext, index$5_ContextCacheConfig as ContextCacheConfig, type index$5_ContextCacheConfigProps as ContextCacheConfigProps, type index$5_EnhancedRunner as EnhancedRunner, type index$5_FullMessage as FullMessage, type index$5_InstructionProvider as InstructionProvider, index$5_InvocationContext as InvocationContext, index$5_LangGraphAgent as LangGraphAgent, type index$5_LangGraphAgentConfig as LangGraphAgentConfig, type index$5_LangGraphNode as LangGraphNode, index$5_LlmAgent as LlmAgent, type index$5_LlmAgentConfig as LlmAgentConfig, index$5_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$5_LoopAgent as LoopAgent, type index$5_LoopAgentConfig as LoopAgentConfig, type index$5_MessagePart as MessagePart, type index$5_MultiAgentResponse as MultiAgentResponse, index$5_ParallelAgent as ParallelAgent, type index$5_ParallelAgentConfig as ParallelAgentConfig, index$5_ReadonlyContext as ReadonlyContext, index$5_RunConfig as RunConfig, type index$5_RunnerAskReturn as RunnerAskReturn, index$5_SequentialAgent as SequentialAgent, type index$5_SequentialAgentConfig as SequentialAgentConfig, type index$5_SessionOptions as SessionOptions, type index$5_SingleAfterModelCallback as SingleAfterModelCallback, type index$5_SingleAfterToolCallback as SingleAfterToolCallback, type index$5_SingleAgentCallback as SingleAgentCallback, type index$5_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$5_SingleBeforeToolCallback as SingleBeforeToolCallback, index$5_StreamingMode as StreamingMode, type index$5_ToolUnion as ToolUnion, type index$5_TransferContext as TransferContext, index$5_contextCacheConfigSchema as contextCacheConfigSchema, index$5_createBranchContextForSubAgent as createBranchContextForSubAgent, index$5_mergeAgentRun as mergeAgentRun, index$5_newInvocationContextId as newInvocationContextId };
+  export { type index$5_AfterAgentCallback as AfterAgentCallback, type index$5_AfterModelCallback as AfterModelCallback, type index$5_AfterToolCallback as AfterToolCallback, LlmAgent as Agent, index$5_AgentBuilder as AgentBuilder, type index$5_AgentBuilderConfig as AgentBuilderConfig, type index$5_AgentBuilderWithSchema as AgentBuilderWithSchema, type index$5_AgentType as AgentType, index$5_BaseAgent as BaseAgent, type index$5_BeforeAgentCallback as BeforeAgentCallback, type index$5_BeforeModelCallback as BeforeModelCallback, type index$5_BeforeToolCallback as BeforeToolCallback, type index$5_BuiltAgent as BuiltAgent, index$5_CallbackContext as CallbackContext, index$5_ContextCacheConfig as ContextCacheConfig, type index$5_ContextCacheConfigProps as ContextCacheConfigProps, type index$5_EnhancedRunner as EnhancedRunner, type index$5_FullMessage as FullMessage, type index$5_InstructionProvider as InstructionProvider, index$5_InvocationContext as InvocationContext, index$5_LangGraphAgent as LangGraphAgent, type index$5_LangGraphAgentConfig as LangGraphAgentConfig, type index$5_LangGraphNode as LangGraphNode, index$5_LlmAgent as LlmAgent, type index$5_LlmAgentConfig as LlmAgentConfig, index$5_LlmCallsLimitExceededError as LlmCallsLimitExceededError, index$5_LoopAgent as LoopAgent, type index$5_LoopAgentConfig as LoopAgentConfig, type index$5_MessagePart as MessagePart, type index$5_MultiAgentResponse as MultiAgentResponse, index$5_ParallelAgent as ParallelAgent, type index$5_ParallelAgentConfig as ParallelAgentConfig, index$5_ReadonlyContext as ReadonlyContext, index$5_RunConfig as RunConfig, type index$5_RunnerAskReturn as RunnerAskReturn, index$5_SequentialAgent as SequentialAgent, type index$5_SequentialAgentConfig as SequentialAgentConfig, type index$5_SessionOptions as SessionOptions, type index$5_SingleAfterModelCallback as SingleAfterModelCallback, type index$5_SingleAfterToolCallback as SingleAfterToolCallback, type index$5_SingleAgentCallback as SingleAgentCallback, type index$5_SingleBeforeModelCallback as SingleBeforeModelCallback, type index$5_SingleBeforeToolCallback as SingleBeforeToolCallback, type index$5_SpanCounters as SpanCounters, index$5_StreamingMode as StreamingMode, type index$5_ToolUnion as ToolUnion, type index$5_TransferContext as TransferContext, index$5_contextCacheConfigSchema as contextCacheConfigSchema, index$5_createBranchContextForSubAgent as createBranchContextForSubAgent, index$5_mergeAgentRun as mergeAgentRun, index$5_newInvocationContextId as newInvocationContextId };
 }
 
 interface ParsedArtifactUri {
@@ -6894,7 +6918,7 @@ declare const DEFAULTS: {
     readonly CAPTURE_MESSAGE_CONTENT: true;
     readonly ENABLE_TRACING: true;
     readonly ENABLE_METRICS: true;
-    readonly ENABLE_AUTO_INSTRUMENTATION: true;
+    readonly ENABLE_AUTO_INSTRUMENTATION: false;
 };
 
 /**
@@ -7087,4 +7111,4 @@ declare const recordLlmCall: (dimensions: LlmMetricDimensions) => void;
 
 declare const VERSION = "0.1.0";
 
-export { ADK_ATTRS, ADK_SYSTEM_NAME, AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DEFAULTS, DatabaseSessionService, ENV_VARS, EditTool, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$4 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$7 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$3 as Flows, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, METRICS, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$2 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OPERATIONS, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$1 as Plugins, PrebuiltMetrics, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, ReadTool, ReadonlyContext, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SEMCONV, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, type ToolSpanAttributes, type ToolUnion, index$8 as Tools, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, WebFetchTool, WebSearchTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, telemetryService, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };
+export { ADK_ATTRS, ADK_SYSTEM_NAME, AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, type AfterModelCallback, type AfterToolCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentBuilderWithSchema, AgentEvaluator, type AgentMetricDimensions, type AgentSpanAttributes, AgentTool, type AgentToolConfig, type AgentType, index$5 as Agents, AiSdkLlm, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, type BaseAgentType, BaseCodeExecutor, type BaseCodeExecutorConfig, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BasePlugin, BaseSessionService, BaseTool, BashTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BeforeModelCallback, type BeforeToolCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInCodeExecutor, BuiltInPlanner, CallbackContext, type CodeExecutionInput, type CodeExecutionResult, CodeExecutionUtils, CodeExecutorContext, ContextCacheConfig, type ContextCacheConfigProps, type ContextCacheManager, type CreateToolConfig, type CreateToolConfigWithSchema, type CreateToolConfigWithoutSchema, DEFAULTS, DatabaseSessionService, ENV_VARS, EditTool, EnhancedAuthConfig, type EnhancedLlmSpanAttributes, type EnhancedRunner, type EnhancedToolSpanAttributes, type ErrorSpanAttributes, type EvalCase, type EvalCaseResult, type EvalMetric, type EvalMetricResult, type EvalMetricResultPerInvocation, EvalResult, type EvalSet, type EvalSetResult, EvalStatus, type EvaluateConfig, index$4 as Evaluation, type EvaluationResult, Evaluator, Event, EventActions, type EventCompaction, index$7 as Events, type EventsCompactionConfig, type EventsSummarizer, ExitLoopTool, type File, FileOperationsTool, FinalResponseMatchV2Evaluator, index$3 as Flows, type FullMessage, FunctionTool, GcsArtifactService, GeminiContextCacheManager, type GetSessionConfig, GetUserChoiceTool, GlobTool, GoogleLlm, GoogleSearchTool, GrepTool, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, type IntermediateData, type Interval, type Invocation, InvocationContext, type JudgeModelOptions, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, LangfusePlugin, type LangfusePluginOptions, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmEventSummarizer, type LlmMetricDimensions, type LlmModel, type LlmModelConfig, LlmRequest, LlmResponse, type LlmSpanAttributes, LoadArtifactsTool, LoadMemoryTool, LocalEvalService, LoopAgent, type LoopAgentConfig, METRICS, McpAbi, McpAtp, McpBamm, McpCoinGecko, McpCoinGeckoPro, type McpConfig, McpDiscord, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntents, McpOdos, McpPolymarket, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, McpUpbit, index$2 as Memory, type MessagePart, type MetricInfo, type MetricValueInfo, index$6 as Models, type MultiAgentResponse, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OPERATIONS, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, type ParsedArtifactUri, type PerInvocationResult, type PerToolFailuresCounter, PlanReActPlanner, type PluginCallbackName, PluginManager, index$1 as Plugins, PrebuiltMetrics, REFLECT_AND_RETRY_RESPONSE_TYPE, REQUEST_EUC_FUNCTION_CALL_NAME, ReadTool, ReadonlyContext, ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, RougeEvaluator, RunConfig, Runner, type RunnerAskReturn, SEMCONV, SafetyEvaluatorV1, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionInput, type SessionOptions, index as Sessions, type SingleAfterModelCallback, type SingleAfterToolCallback, type SingleAgentCallback, type SingleBeforeModelCallback, type SingleBeforeToolCallback, SingleFlow, type SpanCounters, State, StreamingMode, type TelemetryConfig, TelemetryService, type TelemetryStats, type ThinkingConfig, type ToolConfig, ToolContext, type ToolFailureResponse, type ToolMetricDimensions, type ToolSpanAttributes, type ToolUnion, index$8 as Tools, type TraceAgentParams, type TraceAgentTransferParams, type TraceCallbackParams, type TraceLlmParams, type TraceMemoryParams, type TracePluginParams, type TraceSessionParams, type TraceToolParams, TrackingScope, TrajectoryEvaluator, type TransferContext, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiRagMemoryService, VertexAiSessionService, WebFetchTool, WebSearchTool, WriteTool, _findFunctionCallEventIfLastEventIsFunctionResponse, adkToMcpToolType, requestProcessor$6 as agentTransferRequestProcessor, requestProcessor$5 as basicRequestProcessor, buildFunctionDeclaration, buildLlmRequestForTrace, buildLlmResponseForTrace, requestProcessor$4 as codeExecutionRequestProcessor, responseProcessor$1 as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, contextCacheConfigSchema, convertMcpToolToBaseTool, createAuthToolArguments, createBranchContextForSubAgent, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, createTool, extractTextFromContent, formatSpanAttributes, generateAuthEvent, generateClientFunctionCallId, getArtifactUri, getEnvironment, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$2 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$1 as instructionsRequestProcessor, isArtifactRef, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeAgentRun, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor as nlPlanningRequestProcessor, responseProcessor as nlPlanningResponseProcessor, normalizeJsonSchema, parseArtifactUri, pluginCallbackNameSchema, populateClientFunctionCallId, recordAgentInvocation, recordLlmCall, recordToolExecution, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, runCompactionForSlidingWindow, safeJsonStringify, shouldCaptureContent, shutdownTelemetry, telemetryService, traceAgentInvocation, traceLlmCall, traceToolCall, tracer };

package/dist/index.js

@@ -997,6 +997,7 @@ var InvocationContext = (_class5 = class _InvocationContext {
    * of this invocation.
    */
   __init10() {this._invocationCostManager = new InvocationCostManager()}
+  
   /**
    * Constructor for InvocationContext
    */
@@ -1017,6 +1018,11 @@ var InvocationContext = (_class5 = class _InvocationContext {
     this.runConfig = options.runConfig;
     this.contextCacheConfig = options.contextCacheConfig;
     this.transferContext = options.transferContext;
+    this._spanCounters = _nullishCoalesce(options.spanCounters, () => ( {
+      llm: 0,
+      tool: 0,
+      agent: 0
+    }));
   }
   /**
    * App name from the session
@@ -1040,6 +1046,30 @@ var InvocationContext = (_class5 = class _InvocationContext {
       this.runConfig
     );
   }
+  /**
+   * Returns the next LLM span index for this invocation.
+   */
+  nextLlmSpanIndex() {
+    return ++this._spanCounters.llm;
+  }
+  /**
+   * Returns the next tool span index for this invocation.
+   */
+  nextToolSpanIndex() {
+    return ++this._spanCounters.tool;
+  }
+  /**
+   * Returns the next agent span index for this invocation.
+   */
+  nextAgentSpanIndex() {
+    return ++this._spanCounters.agent;
+  }
+  /**
+   * Exposes shared span counters for child contexts.
+   */
+  getSpanCounters() {
+    return this._spanCounters;
+  }
   /**
    * Creates a child invocation context for a sub-agent
    */
@@ -1064,8 +1094,9 @@ var InvocationContext = (_class5 = class _InvocationContext {
       transcriptionCache: this.transcriptionCache,
       runConfig: this.runConfig,
       contextCacheConfig: this.contextCacheConfig,
-      transferContext: this.transferContext
+      transferContext: this.transferContext,
       // Propagate transfer context
+      spanCounters: this._spanCounters
     });
   }
 }, _class5);
@@ -1828,7 +1859,7 @@ var DEFAULTS = {
   CAPTURE_MESSAGE_CONTENT: true,
   ENABLE_TRACING: true,
   ENABLE_METRICS: true,
-  ENABLE_AUTO_INSTRUMENTATION: true
+  ENABLE_AUTO_INSTRUMENTATION: false
 };
 
 // src/telemetry/metrics.ts
@@ -2311,8 +2342,9 @@ var SetupService = (_class8 = class {constructor() { _class8.prototype.__init22.
         }
       }
       this.isInitialized = true;
+      const versionLabel = config.appVersion ? ` v${config.appVersion}` : "";
       _api.diag.info(
-        `Telemetry initialized successfully for ${config.appName} v${config.appVersion || "unknown"}`
+        `Telemetry initialized successfully for ${config.appName}${versionLabel}`
       );
     } catch (error) {
       _api.diag.error("Error initializing telemetry:", error);
@@ -6180,9 +6212,12 @@ async function handleFunctionCallsAsync(invocationContext, functionCallEvent, to
       functionCall,
       toolsDict
     );
+    const toolSpanIndex = invocationContext.nextToolSpanIndex();
     const functionArgs = functionCall.args || {};
     const tracer2 = telemetryService.getTracer();
-    const span = tracer2.startSpan(`execute_tool [${tool.name}]`);
+    const span = tracer2.startSpan(
+      `execute_tool [${tool.name}] #${toolSpanIndex}`
+    );
     const spanContext = _api.trace.setSpan(_api.context.active(), span);
     const toolStartTime = Date.now();
     let toolStatus = "success";
@@ -6271,6 +6306,9 @@ async function handleFunctionCallsAsync(invocationContext, functionCallEvent, to
           // no retry
           wasOverridden
         );
+        telemetryService.setActiveSpanAttributes({
+          [SEMCONV.GEN_AI_TOOL_NAME]: `${tool.name} #${toolSpanIndex}`
+        });
         return { result, event: functionResponseEvent };
       });
       if (!functionResponse) {
@@ -7194,6 +7232,7 @@ var AgentTool = (_class18 = class extends BaseTool {
         pluginManager: parentInvocation.pluginManager,
         runConfig: parentInvocation.runConfig,
         contextCacheConfig: parentInvocation.contextCacheConfig,
+        spanCounters: parentInvocation.getSpanCounters(),
         userContent: {
           role: "user",
           parts: [{ text: String(input) }]
@@ -10497,6 +10536,7 @@ var BaseLlmFlow = (_class29 = class {constructor() { _class29.prototype.__init61
     });
     const llm = this.__getLlm(invocationContext);
     const isStreaming = invocationContext.runConfig.streamingMode === "sse" /* SSE */;
+    const llmSpanIndex = invocationContext.nextLlmSpanIndex();
     const generator = async function* () {
       for await (const llmResponse of this._callLlmAsync(
         invocationContext,
@@ -10515,7 +10555,7 @@ var BaseLlmFlow = (_class29 = class {constructor() { _class29.prototype.__init61
       }
     }.bind(this)();
     yield* telemetryService.traceAsyncGenerator(
-      isStreaming ? `llm_stream [${llm.model}]` : `llm_generate [${llm.model}]`,
+      isStreaming ? `llm_stream [${llm.model}] #${llmSpanIndex}` : `llm_generate [${llm.model}] #${llmSpanIndex}`,
       generator
     );
   }
@@ -12891,8 +12931,9 @@ var BaseAgent = (_class31 = class {
    * Entry method to run an agent via text-based conversation.
    */
   async *runAsync(parentContext) {
+    const agentSpanIndex = parentContext.nextAgentSpanIndex();
     yield* telemetryService.traceAsyncGenerator(
-      `agent_run [${this.name}]`,
+      `agent_run [${this.name}] #${agentSpanIndex}`,
       this.runAsyncInternal(parentContext)
     );
   }
@@ -12900,8 +12941,9 @@ var BaseAgent = (_class31 = class {
    * Entry method to run an agent via video/audio-based conversation.
    */
   async *runLive(parentContext) {
+    const agentSpanIndex = parentContext.nextAgentSpanIndex();
     yield* telemetryService.traceAsyncGenerator(
-      `agent_run_live [${this.name}]`,
+      `agent_run_live [${this.name}] #${agentSpanIndex}`,
       this.runLiveInternal(parentContext)
     );
   }
@@ -14520,7 +14562,7 @@ var Runner = (_class37 = class {
     newMessage,
     runConfig = new RunConfig()
   }) {
-    const span = tracer.startSpan("invocation");
+    const span = tracer.startSpan(`${this.appName}-invocation`);
     const spanContext = _api.trace.setSpan(_api.context.active(), span);
     const inputText = extractTextFromContent(newMessage);
     if (inputText && telemetryService.shouldCaptureContent()) {
@@ -15234,7 +15276,8 @@ function createBranchContextForSubAgent(agent, subAgent, invocationContext) {
     transcriptionCache: invocationContext.transcriptionCache,
     runConfig: invocationContext.runConfig,
     pluginManager: invocationContext.pluginManager,
-    contextCacheConfig: invocationContext.contextCacheConfig
+    contextCacheConfig: invocationContext.contextCacheConfig,
+    spanCounters: invocationContext.getSpanCounters()
   });
 }
 async function* mergeAgentRun(agentRuns) {

package/dist/index.mjs

@@ -997,6 +997,7 @@ var InvocationContext = class _InvocationContext {
    * of this invocation.
    */
   _invocationCostManager = new InvocationCostManager();
+  _spanCounters;
   /**
    * Constructor for InvocationContext
    */
@@ -1017,6 +1018,11 @@ var InvocationContext = class _InvocationContext {
     this.runConfig = options.runConfig;
     this.contextCacheConfig = options.contextCacheConfig;
     this.transferContext = options.transferContext;
+    this._spanCounters = options.spanCounters ?? {
+      llm: 0,
+      tool: 0,
+      agent: 0
+    };
   }
   /**
    * App name from the session
@@ -1040,6 +1046,30 @@ var InvocationContext = class _InvocationContext {
       this.runConfig
     );
   }
+  /**
+   * Returns the next LLM span index for this invocation.
+   */
+  nextLlmSpanIndex() {
+    return ++this._spanCounters.llm;
+  }
+  /**
+   * Returns the next tool span index for this invocation.
+   */
+  nextToolSpanIndex() {
+    return ++this._spanCounters.tool;
+  }
+  /**
+   * Returns the next agent span index for this invocation.
+   */
+  nextAgentSpanIndex() {
+    return ++this._spanCounters.agent;
+  }
+  /**
+   * Exposes shared span counters for child contexts.
+   */
+  getSpanCounters() {
+    return this._spanCounters;
+  }
   /**
    * Creates a child invocation context for a sub-agent
    */
@@ -1064,8 +1094,9 @@ var InvocationContext = class _InvocationContext {
       transcriptionCache: this.transcriptionCache,
       runConfig: this.runConfig,
       contextCacheConfig: this.contextCacheConfig,
-      transferContext: this.transferContext
+      transferContext: this.transferContext,
       // Propagate transfer context
+      spanCounters: this._spanCounters
     });
   }
 };
@@ -1828,7 +1859,7 @@ var DEFAULTS = {
   CAPTURE_MESSAGE_CONTENT: true,
   ENABLE_TRACING: true,
   ENABLE_METRICS: true,
-  ENABLE_AUTO_INSTRUMENTATION: true
+  ENABLE_AUTO_INSTRUMENTATION: false
 };
 
 // src/telemetry/metrics.ts
@@ -2311,8 +2342,9 @@ var SetupService = class {
         }
       }
       this.isInitialized = true;
+      const versionLabel = config.appVersion ? ` v${config.appVersion}` : "";
       diag.info(
-        `Telemetry initialized successfully for ${config.appName} v${config.appVersion || "unknown"}`
+        `Telemetry initialized successfully for ${config.appName}${versionLabel}`
       );
     } catch (error) {
       diag.error("Error initializing telemetry:", error);
@@ -6180,9 +6212,12 @@ async function handleFunctionCallsAsync(invocationContext, functionCallEvent, to
       functionCall,
       toolsDict
     );
+    const toolSpanIndex = invocationContext.nextToolSpanIndex();
     const functionArgs = functionCall.args || {};
     const tracer2 = telemetryService.getTracer();
-    const span = tracer2.startSpan(`execute_tool [${tool.name}]`);
+    const span = tracer2.startSpan(
+      `execute_tool [${tool.name}] #${toolSpanIndex}`
+    );
     const spanContext = trace3.setSpan(context2.active(), span);
     const toolStartTime = Date.now();
     let toolStatus = "success";
@@ -6271,6 +6306,9 @@ async function handleFunctionCallsAsync(invocationContext, functionCallEvent, to
           // no retry
           wasOverridden
         );
+        telemetryService.setActiveSpanAttributes({
+          [SEMCONV.GEN_AI_TOOL_NAME]: `${tool.name} #${toolSpanIndex}`
+        });
         return { result, event: functionResponseEvent };
       });
       if (!functionResponse) {
@@ -7194,6 +7232,7 @@ var AgentTool = class extends BaseTool {
         pluginManager: parentInvocation.pluginManager,
         runConfig: parentInvocation.runConfig,
         contextCacheConfig: parentInvocation.contextCacheConfig,
+        spanCounters: parentInvocation.getSpanCounters(),
         userContent: {
           role: "user",
           parts: [{ text: String(input) }]
@@ -10497,6 +10536,7 @@ var BaseLlmFlow = class {
     });
     const llm = this.__getLlm(invocationContext);
     const isStreaming = invocationContext.runConfig.streamingMode === "sse" /* SSE */;
+    const llmSpanIndex = invocationContext.nextLlmSpanIndex();
     const generator = async function* () {
       for await (const llmResponse of this._callLlmAsync(
         invocationContext,
@@ -10515,7 +10555,7 @@ var BaseLlmFlow = class {
       }
     }.bind(this)();
     yield* telemetryService.traceAsyncGenerator(
-      isStreaming ? `llm_stream [${llm.model}]` : `llm_generate [${llm.model}]`,
+      isStreaming ? `llm_stream [${llm.model}] #${llmSpanIndex}` : `llm_generate [${llm.model}] #${llmSpanIndex}`,
       generator
     );
   }
@@ -12891,8 +12931,9 @@ var BaseAgent = class {
    * Entry method to run an agent via text-based conversation.
    */
   async *runAsync(parentContext) {
+    const agentSpanIndex = parentContext.nextAgentSpanIndex();
     yield* telemetryService.traceAsyncGenerator(
-      `agent_run [${this.name}]`,
+      `agent_run [${this.name}] #${agentSpanIndex}`,
       this.runAsyncInternal(parentContext)
     );
   }
@@ -12900,8 +12941,9 @@ var BaseAgent = class {
    * Entry method to run an agent via video/audio-based conversation.
    */
   async *runLive(parentContext) {
+    const agentSpanIndex = parentContext.nextAgentSpanIndex();
     yield* telemetryService.traceAsyncGenerator(
-      `agent_run_live [${this.name}]`,
+      `agent_run_live [${this.name}] #${agentSpanIndex}`,
       this.runLiveInternal(parentContext)
     );
   }
@@ -14520,7 +14562,7 @@ var Runner = class {
     newMessage,
     runConfig = new RunConfig()
   }) {
-    const span = tracer.startSpan("invocation");
+    const span = tracer.startSpan(`${this.appName}-invocation`);
     const spanContext = trace4.setSpan(context3.active(), span);
     const inputText = extractTextFromContent(newMessage);
     if (inputText && telemetryService.shouldCaptureContent()) {
@@ -15234,7 +15276,8 @@ function createBranchContextForSubAgent(agent, subAgent, invocationContext) {
     transcriptionCache: invocationContext.transcriptionCache,
     runConfig: invocationContext.runConfig,
     pluginManager: invocationContext.pluginManager,
-    contextCacheConfig: invocationContext.contextCacheConfig
+    contextCacheConfig: invocationContext.contextCacheConfig,
+    spanCounters: invocationContext.getSpanCounters()
   });
 }
 async function* mergeAgentRun(agentRuns) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iqai/adk",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Agent Development Kit for TypeScript with multi-provider LLM support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",