@iqai/adk 0.1.5 → 0.1.7

package/dist/index.js

@@ -674,6 +674,8 @@ __export(agents_exports, {
   RunConfig: () => RunConfig,
   SequentialAgent: () => SequentialAgent,
   StreamingMode: () => StreamingMode,
+  createBranchContextForSubAgent: () => createBranchContextForSubAgent,
+  mergeAgentRun: () => mergeAgentRun,
   newInvocationContextId: () => newInvocationContextId
 });
 
@@ -3698,6 +3700,7 @@ __export(tools_exports, {
   McpAbi: () => McpAbi,
   McpAtp: () => McpAtp,
   McpBamm: () => McpBamm,
+  McpCoinGecko: () => McpCoinGecko,
   McpError: () => McpError,
   McpErrorType: () => McpErrorType,
   McpFilesystem: () => McpFilesystem,
@@ -5470,6 +5473,14 @@ function McpTelegram(config = {}) {
   );
   return new McpToolset(mcpConfig);
 }
+function McpCoinGecko(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "CoinGecko MCP Client",
+    "@coingecko/coingecko-mcp",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
 function McpFilesystem(config = {}) {
   const mcpConfig = createMcpConfig(
     "Filesystem MCP Client",
@@ -8861,6 +8872,9 @@ var LangGraphAgent = (_class26 = class extends BaseAgent {
   }
 }, _class26);
 
+// src/agents/agent-builder.ts
+
+
 // src/runners.ts
 
 
@@ -9803,10 +9817,10 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
     return this;
   }
   /**
-   * Configure session management
+   * Configure session management with optional smart defaults
    * @param service Session service to use
-   * @param userId User identifier
-   * @param appName Application name
+   * @param userId User identifier (optional, defaults to agent-based ID)
+   * @param appName Application name (optional, defaults to agent-based name)
    * @param memoryService Optional memory service
    * @param artifactService Optional artifact service
    * @returns This builder instance for chaining
@@ -9814,17 +9828,18 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
   withSession(service, userId, appName, memoryService, artifactService) {
     this.sessionConfig = {
       service,
-      userId,
-      appName,
+      userId: userId || this.generateDefaultUserId(),
+      appName: appName || this.generateDefaultAppName(),
       memoryService,
       artifactService
     };
     return this;
   }
   /**
-   * Configure with an in-memory session (for quick setup)
-   * @param appName Application name
-   * @param userId User identifier
+   * Configure with an in-memory session with custom IDs
+   * Note: In-memory sessions are created automatically by default, use this only if you need custom appName/userId
+   * @param appName Application name (optional, defaults to agent-based name)
+   * @param userId User identifier (optional, defaults to agent-based ID)
    * @returns This builder instance for chaining
    */
   withQuickSession(appName, userId) {
@@ -9838,6 +9853,9 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
     const agent = this.createAgent();
     let runner;
     let session;
+    if (!this.sessionConfig) {
+      this.withQuickSession();
+    }
     if (this.sessionConfig) {
       session = await this.sessionConfig.service.createSession(
         this.sessionConfig.appName,
@@ -9846,49 +9864,26 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
       const runnerConfig = {
         appName: this.sessionConfig.appName,
         agent,
-        sessionService: this.sessionConfig.service
+        sessionService: this.sessionConfig.service,
+        memoryService: this.sessionConfig.memoryService,
+        artifactService: this.sessionConfig.artifactService
       };
-      if (this.sessionConfig.memoryService) {
-        runnerConfig.memoryService = this.sessionConfig.memoryService;
-      }
-      if (this.sessionConfig.artifactService) {
-        runnerConfig.artifactService = this.sessionConfig.artifactService;
-      }
-      runner = new Runner(runnerConfig);
+      const baseRunner = new Runner(runnerConfig);
+      runner = this.createEnhancedRunner(baseRunner, session);
     }
     return { agent, runner, session };
   }
   /**
    * Quick execution helper - build and run a message
-   * @param message Message to send to the agent
+   * @param message Message to send to the agent (string or full message object)
    * @returns Agent response
    */
   async ask(message) {
-    if (!this.sessionConfig) {
-      const userId = `user-${this.config.name}`;
-      const appName = `session-${this.config.name}`;
-      this.withQuickSession(appName, userId);
-    }
-    const { runner, session } = await this.build();
-    if (!runner || !session) {
-      throw new Error("Failed to create runner and session");
-    }
-    let response = "";
-    for await (const event of runner.runAsync({
-      userId: this.sessionConfig.userId,
-      sessionId: session.id,
-      newMessage: {
-        parts: [{ text: message }]
-      }
-    })) {
-      if (_optionalChain([event, 'access', _273 => _273.content, 'optionalAccess', _274 => _274.parts])) {
-        const content = event.content.parts.map((part) => part.text || "").join("");
-        if (content) {
-          response += content;
-        }
-      }
+    const { runner } = await this.build();
+    if (!runner) {
+      throw new Error("Failed to create runner");
     }
-    return response;
+    return runner.ask(message);
   }
   /**
    * Create the appropriate agent type based on configuration
@@ -9911,7 +9906,7 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
         });
       }
       case "sequential":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for sequential agent");
         }
         return new SequentialAgent({
@@ -9920,7 +9915,7 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
           subAgents: this.config.subAgents
         });
       case "parallel":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for parallel agent");
         }
         return new ParallelAgent({
@@ -9929,7 +9924,7 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
           subAgents: this.config.subAgents
         });
       case "loop":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for loop agent");
         }
         return new LoopAgent({
@@ -9939,7 +9934,7 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
           maxIterations: this.config.maxIterations || 3
         });
       case "langgraph":
-        if (!this.config.nodes || !this.config.rootNode) {
+        if (!this.config.nodes || !Array.isArray(this.config.nodes) || this.config.nodes.length === 0 || !this.config.rootNode || typeof this.config.rootNode !== "string") {
           throw new Error("Nodes and root node required for LangGraph agent");
         }
         return new LangGraphAgent({
@@ -9950,6 +9945,57 @@ var AgentBuilder = (_class31 = class _AgentBuilder {
         });
     }
   }
+  /**
+   * Generate default user ID based on agent name and id
+   * @returns Generated user ID
+   */
+  generateDefaultUserId() {
+    const id = _ai.generateId.call(void 0, );
+    return `user-${this.config.name}-${id}`;
+  }
+  /**
+   * Generate default app name based on agent name
+   * @returns Generated app name
+   */
+  generateDefaultAppName() {
+    return `app-${this.config.name}`;
+  }
+  /**
+   * Create enhanced runner with simplified API
+   * @param baseRunner The base runner instance
+   * @param session The session instance
+   * @returns Enhanced runner with simplified API
+   */
+  createEnhancedRunner(baseRunner, session) {
+    const sessionConfig = this.sessionConfig;
+    return {
+      async ask(message) {
+        const fullMessage = typeof message === "string" ? { parts: [{ text: message }] } : message;
+        let response = "";
+        if (!sessionConfig) {
+          throw new Error("Session configuration is required");
+        }
+        for await (const event of baseRunner.runAsync({
+          userId: sessionConfig.userId,
+          sessionId: session.id,
+          newMessage: fullMessage
+        })) {
+          if (_optionalChain([event, 'access', _273 => _273.content, 'optionalAccess', _274 => _274.parts]) && Array.isArray(event.content.parts)) {
+            const content = event.content.parts.map(
+              (part) => (part && typeof part === "object" && "text" in part ? part.text : "") || ""
+            ).join("");
+            if (content) {
+              response += content;
+            }
+          }
+        }
+        return response;
+      },
+      runAsync(params) {
+        return baseRunner.runAsync(params);
+      }
+    };
+  }
 }, _class31);
 
 // src/memory/index.ts
@@ -11083,4 +11129,8 @@ var VERSION = "0.1.0";
 
 
 
-exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.Agents = agents_exports; exports.AiSdkLlm = AiSdkLlm; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseCodeExecutor = BaseCodeExecutor; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInCodeExecutor = BuiltInCodeExecutor; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.CodeExecutionUtils = CodeExecutionUtils; exports.CodeExecutorContext = CodeExecutorContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LoopAgent = LoopAgent; exports.McpAbi = McpAbi; exports.McpAtp = McpAtp; exports.McpBamm = McpBamm; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpFilesystem = McpFilesystem; exports.McpFraxlend = McpFraxlend; exports.McpGeneric = McpGeneric; exports.McpIqWiki = McpIqWiki; exports.McpMemory = McpMemory; exports.McpNearAgent = McpNearAgent; exports.McpNearIntentSwaps = McpNearIntentSwaps; exports.McpOdos = McpOdos; exports.McpSamplingHandler = McpSamplingHandler; exports.McpTelegram = McpTelegram; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor2; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor3; exports.codeExecutionResponseProcessor = responseProcessor; exports.contentRequestProcessor = requestProcessor4; exports.createAuthToolArguments = createAuthToolArguments; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor5; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor6; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor7; exports.nlPlanningResponseProcessor = responseProcessor2; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;
+
+
+
+
+exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.Agents = agents_exports; exports.AiSdkLlm = AiSdkLlm; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseCodeExecutor = BaseCodeExecutor; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInCodeExecutor = BuiltInCodeExecutor; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.CodeExecutionUtils = CodeExecutionUtils; exports.CodeExecutorContext = CodeExecutorContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LoopAgent = LoopAgent; exports.McpAbi = McpAbi; exports.McpAtp = McpAtp; exports.McpBamm = McpBamm; exports.McpCoinGecko = McpCoinGecko; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpFilesystem = McpFilesystem; exports.McpFraxlend = McpFraxlend; exports.McpGeneric = McpGeneric; exports.McpIqWiki = McpIqWiki; exports.McpMemory = McpMemory; exports.McpNearAgent = McpNearAgent; exports.McpNearIntentSwaps = McpNearIntentSwaps; exports.McpOdos = McpOdos; exports.McpSamplingHandler = McpSamplingHandler; exports.McpTelegram = McpTelegram; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports._findFunctionCallEventIfLastEventIsFunctionResponse = _findFunctionCallEventIfLastEventIsFunctionResponse; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor2; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor3; exports.codeExecutionResponseProcessor = responseProcessor; exports.contentRequestProcessor = requestProcessor4; exports.createAuthToolArguments = createAuthToolArguments; exports.createBranchContextForSubAgent = createBranchContextForSubAgent; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor5; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor6; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeAgentRun = mergeAgentRun; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor7; exports.nlPlanningResponseProcessor = responseProcessor2; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;

package/dist/index.mjs

@@ -674,6 +674,8 @@ __export(agents_exports, {
   RunConfig: () => RunConfig,
   SequentialAgent: () => SequentialAgent,
   StreamingMode: () => StreamingMode,
+  createBranchContextForSubAgent: () => createBranchContextForSubAgent,
+  mergeAgentRun: () => mergeAgentRun,
   newInvocationContextId: () => newInvocationContextId
 });
 
@@ -3698,6 +3700,7 @@ __export(tools_exports, {
   McpAbi: () => McpAbi,
   McpAtp: () => McpAtp,
   McpBamm: () => McpBamm,
+  McpCoinGecko: () => McpCoinGecko,
   McpError: () => McpError,
   McpErrorType: () => McpErrorType,
   McpFilesystem: () => McpFilesystem,
@@ -5470,6 +5473,14 @@ function McpTelegram(config = {}) {
   );
   return new McpToolset(mcpConfig);
 }
+function McpCoinGecko(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "CoinGecko MCP Client",
+    "@coingecko/coingecko-mcp",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
 function McpFilesystem(config = {}) {
   const mcpConfig = createMcpConfig(
     "Filesystem MCP Client",
@@ -8861,6 +8872,9 @@ var LangGraphAgent = class extends BaseAgent {
   }
 };
 
+// src/agents/agent-builder.ts
+import { generateId } from "ai";
+
 // src/runners.ts
 import { SpanStatusCode } from "@opentelemetry/api";
 
@@ -9803,10 +9817,10 @@ var AgentBuilder = class _AgentBuilder {
     return this;
   }
   /**
-   * Configure session management
+   * Configure session management with optional smart defaults
    * @param service Session service to use
-   * @param userId User identifier
-   * @param appName Application name
+   * @param userId User identifier (optional, defaults to agent-based ID)
+   * @param appName Application name (optional, defaults to agent-based name)
    * @param memoryService Optional memory service
    * @param artifactService Optional artifact service
    * @returns This builder instance for chaining
@@ -9814,17 +9828,18 @@ var AgentBuilder = class _AgentBuilder {
   withSession(service, userId, appName, memoryService, artifactService) {
     this.sessionConfig = {
       service,
-      userId,
-      appName,
+      userId: userId || this.generateDefaultUserId(),
+      appName: appName || this.generateDefaultAppName(),
       memoryService,
       artifactService
     };
     return this;
   }
   /**
-   * Configure with an in-memory session (for quick setup)
-   * @param appName Application name
-   * @param userId User identifier
+   * Configure with an in-memory session with custom IDs
+   * Note: In-memory sessions are created automatically by default, use this only if you need custom appName/userId
+   * @param appName Application name (optional, defaults to agent-based name)
+   * @param userId User identifier (optional, defaults to agent-based ID)
    * @returns This builder instance for chaining
    */
   withQuickSession(appName, userId) {
@@ -9838,6 +9853,9 @@ var AgentBuilder = class _AgentBuilder {
     const agent = this.createAgent();
     let runner;
     let session;
+    if (!this.sessionConfig) {
+      this.withQuickSession();
+    }
     if (this.sessionConfig) {
       session = await this.sessionConfig.service.createSession(
         this.sessionConfig.appName,
@@ -9846,49 +9864,26 @@ var AgentBuilder = class _AgentBuilder {
       const runnerConfig = {
         appName: this.sessionConfig.appName,
         agent,
-        sessionService: this.sessionConfig.service
+        sessionService: this.sessionConfig.service,
+        memoryService: this.sessionConfig.memoryService,
+        artifactService: this.sessionConfig.artifactService
       };
-      if (this.sessionConfig.memoryService) {
-        runnerConfig.memoryService = this.sessionConfig.memoryService;
-      }
-      if (this.sessionConfig.artifactService) {
-        runnerConfig.artifactService = this.sessionConfig.artifactService;
-      }
-      runner = new Runner(runnerConfig);
+      const baseRunner = new Runner(runnerConfig);
+      runner = this.createEnhancedRunner(baseRunner, session);
     }
     return { agent, runner, session };
   }
   /**
    * Quick execution helper - build and run a message
-   * @param message Message to send to the agent
+   * @param message Message to send to the agent (string or full message object)
    * @returns Agent response
    */
   async ask(message) {
-    if (!this.sessionConfig) {
-      const userId = `user-${this.config.name}`;
-      const appName = `session-${this.config.name}`;
-      this.withQuickSession(appName, userId);
-    }
-    const { runner, session } = await this.build();
-    if (!runner || !session) {
-      throw new Error("Failed to create runner and session");
-    }
-    let response = "";
-    for await (const event of runner.runAsync({
-      userId: this.sessionConfig.userId,
-      sessionId: session.id,
-      newMessage: {
-        parts: [{ text: message }]
-      }
-    })) {
-      if (event.content?.parts) {
-        const content = event.content.parts.map((part) => part.text || "").join("");
-        if (content) {
-          response += content;
-        }
-      }
+    const { runner } = await this.build();
+    if (!runner) {
+      throw new Error("Failed to create runner");
     }
-    return response;
+    return runner.ask(message);
   }
   /**
    * Create the appropriate agent type based on configuration
@@ -9911,7 +9906,7 @@ var AgentBuilder = class _AgentBuilder {
         });
       }
       case "sequential":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for sequential agent");
         }
         return new SequentialAgent({
@@ -9920,7 +9915,7 @@ var AgentBuilder = class _AgentBuilder {
           subAgents: this.config.subAgents
         });
       case "parallel":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for parallel agent");
         }
         return new ParallelAgent({
@@ -9929,7 +9924,7 @@ var AgentBuilder = class _AgentBuilder {
           subAgents: this.config.subAgents
         });
       case "loop":
-        if (!this.config.subAgents) {
+        if (!this.config.subAgents || !Array.isArray(this.config.subAgents) || this.config.subAgents.length === 0) {
           throw new Error("Sub-agents required for loop agent");
         }
         return new LoopAgent({
@@ -9939,7 +9934,7 @@ var AgentBuilder = class _AgentBuilder {
           maxIterations: this.config.maxIterations || 3
         });
       case "langgraph":
-        if (!this.config.nodes || !this.config.rootNode) {
+        if (!this.config.nodes || !Array.isArray(this.config.nodes) || this.config.nodes.length === 0 || !this.config.rootNode || typeof this.config.rootNode !== "string") {
           throw new Error("Nodes and root node required for LangGraph agent");
         }
         return new LangGraphAgent({
@@ -9950,6 +9945,57 @@ var AgentBuilder = class _AgentBuilder {
         });
     }
   }
+  /**
+   * Generate default user ID based on agent name and id
+   * @returns Generated user ID
+   */
+  generateDefaultUserId() {
+    const id = generateId();
+    return `user-${this.config.name}-${id}`;
+  }
+  /**
+   * Generate default app name based on agent name
+   * @returns Generated app name
+   */
+  generateDefaultAppName() {
+    return `app-${this.config.name}`;
+  }
+  /**
+   * Create enhanced runner with simplified API
+   * @param baseRunner The base runner instance
+   * @param session The session instance
+   * @returns Enhanced runner with simplified API
+   */
+  createEnhancedRunner(baseRunner, session) {
+    const sessionConfig = this.sessionConfig;
+    return {
+      async ask(message) {
+        const fullMessage = typeof message === "string" ? { parts: [{ text: message }] } : message;
+        let response = "";
+        if (!sessionConfig) {
+          throw new Error("Session configuration is required");
+        }
+        for await (const event of baseRunner.runAsync({
+          userId: sessionConfig.userId,
+          sessionId: session.id,
+          newMessage: fullMessage
+        })) {
+          if (event.content?.parts && Array.isArray(event.content.parts)) {
+            const content = event.content.parts.map(
+              (part) => (part && typeof part === "object" && "text" in part ? part.text : "") || ""
+            ).join("");
+            if (content) {
+              response += content;
+            }
+          }
+        }
+        return response;
+      },
+      runAsync(params) {
+        return baseRunner.runAsync(params);
+      }
+    };
+  }
 };
 
 // src/memory/index.ts
@@ -11005,6 +11051,7 @@ export {
   McpAbi,
   McpAtp,
   McpBamm,
+  McpCoinGecko,
   McpError,
   McpErrorType,
   McpFilesystem,
@@ -11042,6 +11089,7 @@ export {
   UserInteractionTool,
   VERSION,
   VertexAiSessionService,
+  _findFunctionCallEventIfLastEventIsFunctionResponse,
   adkToMcpToolType,
   requestProcessor8 as agentTransferRequestProcessor,
   requestProcessor2 as basicRequestProcessor,
@@ -11050,6 +11098,7 @@ export {
   responseProcessor as codeExecutionResponseProcessor,
   requestProcessor4 as contentRequestProcessor,
   createAuthToolArguments,
+  createBranchContextForSubAgent,
   createDatabaseSessionService,
   createFunctionTool,
   createMysqlSessionService,
@@ -11069,6 +11118,7 @@ export {
   isEnhancedAuthConfig,
   jsonSchemaToDeclaration,
   mcpSchemaToParameters,
+  mergeAgentRun,
   mergeParallelFunctionResponseEvents,
   newInvocationContextId,
   requestProcessor7 as nlPlanningRequestProcessor,

package/package.json

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