@google/adk 0.2.4 → 0.3.0

package/dist/esm/agents/loop_agent.js

@@ -3,12 +3,21 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { BaseAgent } from "./base_agent.js";
-class LoopAgent extends BaseAgent {
+const LOOP_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.loopAgent");
+function isLoopAgent(obj) {
+  return typeof obj === "object" && obj !== null && LOOP_AGENT_SIGNATURE_SYMBOL in obj && obj[LOOP_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class LoopAgent extends (_b = BaseAgent, _a = LOOP_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
-    var _a;
+    var _a2;
     super(config);
-    this.maxIterations = (_a = config.maxIterations) != null ? _a : Number.MAX_SAFE_INTEGER;
+    /**
+     * A unique symbol to identify ADK loop agent class.
+     */
+    this[_a] = true;
+    this.maxIterations = (_a2 = config.maxIterations) != null ? _a2 : Number.MAX_SAFE_INTEGER;
   }
   async *runAsyncImpl(context) {
     let iteration = 0;
@@ -29,10 +38,12 @@ class LoopAgent extends BaseAgent {
     }
     return;
   }
-  async *runLiveImpl(context) {
+  // eslint-disable-next-line require-yield
+  async *runLiveImpl(_context) {
     throw new Error("This is not supported yet for LoopAgent.");
   }
 }
 export {
-  LoopAgent
+  LoopAgent,
+  isLoopAgent
 };

package/dist/esm/agents/parallel_agent.js

@@ -3,20 +3,31 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { BaseAgent } from "./base_agent.js";
 import { InvocationContext } from "./invocation_context.js";
-class ParallelAgent extends BaseAgent {
+const PARALLEL_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.parallelAgent");
+function isParallelAgent(obj) {
+  return typeof obj === "object" && obj !== null && PARALLEL_AGENT_SIGNATURE_SYMBOL in obj && obj[PARALLEL_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class ParallelAgent extends (_b = BaseAgent, _a = PARALLEL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK parallel agent class.
+     */
+    this[_a] = true;
+  }
   async *runAsyncImpl(context) {
     const agentRuns = this.subAgents.map(
-      (subAgent) => subAgent.runAsync(
-        createBranchCtxForSubAgent(this, subAgent, context)
-      )
+      (subAgent) => subAgent.runAsync(createBranchCtxForSubAgent(this, subAgent, context))
     );
     for await (const event of mergeAgentRuns(agentRuns)) {
       yield event;
     }
   }
-  async *runLiveImpl(context) {
+  // eslint-disable-next-line require-yield
+  async *runLiveImpl(_context) {
     throw new Error("This is not supported yet for ParallelAgent.");
   }
 }
@@ -44,5 +55,6 @@ async function* mergeAgentRuns(agentRuns) {
   }
 }
 export {
-  ParallelAgent
+  ParallelAgent,
+  isParallelAgent
 };

package/dist/esm/agents/readonly_context.js

@@ -30,7 +30,10 @@ class ReadonlyContext {
    * The state of the current session.
    */
   get state() {
-    return new State(this.invocationContext.session.state, {});
+    return new State(
+      this.invocationContext.session.state,
+      {}
+    );
   }
 }
 export {

package/dist/esm/agents/sequential_agent.js

@@ -3,12 +3,26 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { FunctionTool } from "../tools/function_tool.js";
 import { BaseAgent } from "./base_agent.js";
-import { LlmAgent } from "./llm_agent.js";
+import { isLlmAgent } from "./llm_agent.js";
 import { ReadonlyContext } from "./readonly_context.js";
 const TASK_COMPLETED_TOOL_NAME = "task_completed";
-class SequentialAgent extends BaseAgent {
+const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.sequentialAgent"
+);
+function isSequentialAgent(obj) {
+  return typeof obj === "object" && obj !== null && SEQUENTIAL_AGENT_SIGNATURE_SYMBOL in obj && obj[SEQUENTIAL_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class SequentialAgent extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK sequential agent class.
+     */
+    this[_a] = true;
+  }
   async *runAsyncImpl(context) {
     for (const subAgent of this.subAgents) {
       for await (const event of subAgent.runAsync(context)) {
@@ -25,19 +39,25 @@ class SequentialAgent extends BaseAgent {
    * the model can call this function to signal that it's finished the task and
    * we can move on to the next agent.
    *
-   * @param context: The invocation context of the agent.
+   * @param context The invocation context of the agent.
    */
   async *runLiveImpl(context) {
     for (const subAgent of this.subAgents) {
-      if (subAgent instanceof LlmAgent) {
-        const agentTools = await subAgent.canonicalTools(new ReadonlyContext(context));
-        const taskCompletedToolAlreadyAdded = agentTools.some((tool) => tool.name === TASK_COMPLETED_TOOL_NAME);
+      if (isLlmAgent(subAgent)) {
+        const agentTools = await subAgent.canonicalTools(
+          new ReadonlyContext(context)
+        );
+        const taskCompletedToolAlreadyAdded = agentTools.some(
+          (tool) => tool.name === TASK_COMPLETED_TOOL_NAME
+        );
         if (!taskCompletedToolAlreadyAdded) {
-          subAgent.tools.push(new FunctionTool({
-            name: TASK_COMPLETED_TOOL_NAME,
-            description: `Signals that the model has successfully completed the user's question or task.`,
-            execute: () => "Task completion signaled."
-          }));
+          subAgent.tools.push(
+            new FunctionTool({
+              name: TASK_COMPLETED_TOOL_NAME,
+              description: `Signals that the model has successfully completed the user's question or task.`,
+              execute: () => "Task completion signaled."
+            })
+          );
           subAgent.instruction += `If you finished the user's request according to its description, call the ${TASK_COMPLETED_TOOL_NAME} function to exit so the next agents can take over. When calling this function, do not generate any text other than the function call.`;
         }
       }
@@ -50,5 +70,6 @@ class SequentialAgent extends BaseAgent {
   }
 }
 export {
-  SequentialAgent
+  SequentialAgent,
+  isSequentialAgent
 };

package/dist/esm/artifacts/gcs_artifact_service.js

@@ -12,10 +12,12 @@ class GcsArtifactService {
   async saveArtifact(request) {
     const versions = await this.listVersions(request);
     const version = versions.length > 0 ? Math.max(...versions) + 1 : 0;
-    const file = this.bucket.file(getFileName({
-      ...request,
-      version
-    }));
+    const file = this.bucket.file(
+      getFileName({
+        ...request,
+        version
+      })
+    );
     if (request.artifact.inlineData) {
       await file.save(JSON.stringify(request.artifact.inlineData.data), {
         contentType: request.artifact.inlineData.mimeType
@@ -39,11 +41,16 @@ class GcsArtifactService {
       }
       version = Math.max(...versions);
     }
-    const file = this.bucket.file(getFileName({
-      ...request,
-      version
-    }));
-    const [[metadata], [rawDataBuffer]] = await Promise.all([file.getMetadata(), file.download()]);
+    const file = this.bucket.file(
+      getFileName({
+        ...request,
+        version
+      })
+    );
+    const [[metadata], [rawDataBuffer]] = await Promise.all([
+      file.getMetadata(),
+      file.download()
+    ]);
     if (metadata.contentType === "text/plain") {
       return createPartFromText(rawDataBuffer.toString("utf-8"));
     }
@@ -56,10 +63,7 @@ class GcsArtifactService {
     const fileNames = [];
     const sessionPrefix = `${request.appName}/${request.userId}/${request.sessionId}/`;
     const usernamePrefix = `${request.appName}/${request.userId}/user/`;
-    const [
-      [sessionFiles],
-      [userSessionFiles]
-    ] = await Promise.all([
+    const [[sessionFiles], [userSessionFiles]] = await Promise.all([
       this.bucket.getFiles({ prefix: sessionPrefix }),
       this.bucket.getFiles({ prefix: usernamePrefix })
     ]);
@@ -73,13 +77,17 @@ class GcsArtifactService {
   }
   async deleteArtifact(request) {
     const versions = await this.listVersions(request);
-    await Promise.all(versions.map((version) => {
-      const file = this.bucket.file(getFileName({
-        ...request,
-        version
-      }));
-      return file.delete();
-    }));
+    await Promise.all(
+      versions.map((version) => {
+        const file = this.bucket.file(
+          getFileName({
+            ...request,
+            version
+          })
+        );
+        return file.delete();
+      })
+    );
     return;
   }
   async listVersions(request) {

package/dist/esm/artifacts/in_memory_artifact_service.js

@@ -39,7 +39,11 @@ class InMemoryArtifactService {
     }
     return Promise.resolve(versions[version]);
   }
-  listArtifactKeys({ appName, userId, sessionId }) {
+  listArtifactKeys({
+    appName,
+    userId,
+    sessionId
+  }) {
     const sessionPrefix = `${appName}/${userId}/${sessionId}/`;
     const usernamespacePrefix = `${appName}/${userId}/user/`;
     const filenames = [];
@@ -54,7 +58,12 @@ class InMemoryArtifactService {
     }
     return Promise.resolve(filenames.sort());
   }
-  deleteArtifact({ appName, userId, sessionId, filename }) {
+  deleteArtifact({
+    appName,
+    userId,
+    sessionId,
+    filename
+  }) {
     const path = artifactPath(appName, userId, sessionId, filename);
     if (!this.artifacts[path]) {
       return Promise.resolve();
@@ -62,13 +71,18 @@ class InMemoryArtifactService {
     delete this.artifacts[path];
     return Promise.resolve();
   }
-  listVersions({ appName, userId, sessionId, filename }) {
+  listVersions({
+    appName,
+    userId,
+    sessionId,
+    filename
+  }) {
     const path = artifactPath(appName, userId, sessionId, filename);
     const artifacts = this.artifacts[path];
     if (!artifacts) {
       return Promise.resolve([]);
     }
-    let versions = [];
+    const versions = [];
     for (let i = 0; i < artifacts.length; i++) {
       versions.push(i);
     }

package/dist/esm/auth/auth_handler.js

@@ -37,7 +37,9 @@ class AuthHandler {
       };
     }
     if (!this.authConfig.rawAuthCredential.oauth2.clientId || !this.authConfig.rawAuthCredential.oauth2.clientSecret) {
-      throw new Error(`Auth Scheme ${authSchemeType} requires both clientId and clientSecret in authCredential.oauth2.`);
+      throw new Error(
+        `Auth Scheme ${authSchemeType} requires both clientId and clientSecret in authCredential.oauth2.`
+      );
     }
     return {
       credentialKey: this.authConfig.credentialKey,

package/dist/esm/code_executors/base_code_executor.js

@@ -3,8 +3,18 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.baseCodeExecutor"
+);
+function isBaseCodeExecutor(obj) {
+  return typeof obj === "object" && obj !== null && BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL in obj && obj[BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL] === true;
+}
+_a = BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL;
 class BaseCodeExecutor {
   constructor() {
+    /** A unique symbol to identify BaseCodeExecutor class. */
+    this[_a] = true;
     /**
      * If true, extract and process data files from the model request
      * and attach them to the code executor.
@@ -42,5 +52,6 @@ class BaseCodeExecutor {
   }
 }
 export {
-  BaseCodeExecutor
+  BaseCodeExecutor,
+  isBaseCodeExecutor
 };

package/dist/esm/code_executors/built_in_code_executor.js

@@ -3,10 +3,22 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { isGemini2OrAbove } from "../utils/model_name.js";
 import { BaseCodeExecutor } from "./base_code_executor.js";
-class BuiltInCodeExecutor extends BaseCodeExecutor {
-  executeCode(params) {
+const BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.builtInCodeExecutor"
+);
+function isBuiltInCodeExecutor(obj) {
+  return typeof obj === "object" && obj !== null && BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL in obj && obj[BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL] === true;
+}
+class BuiltInCodeExecutor extends (_b = BaseCodeExecutor, _a = BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /** A unique symbol to identify BuiltInCodeExecutor class. */
+    this[_a] = true;
+  }
+  executeCode(_params) {
     return Promise.resolve({
       stdout: "",
       stderr: "",
@@ -20,9 +32,12 @@ class BuiltInCodeExecutor extends BaseCodeExecutor {
       llmRequest.config.tools.push({ codeExecution: {} });
       return;
     }
-    throw new Error(`Gemini code execution tool is not supported for model ${llmRequest.model}`);
+    throw new Error(
+      `Gemini code execution tool is not supported for model ${llmRequest.model}`
+    );
   }
 }
 export {
-  BuiltInCodeExecutor
+  BuiltInCodeExecutor,
+  isBuiltInCodeExecutor
 };

package/dist/esm/code_executors/code_executor_context.js

@@ -142,7 +142,9 @@ class CodeExecutorContext {
     if (!(CODE_EXECUTION_RESULTS_KEY in this.sessionState)) {
       this.sessionState.set(CODE_EXECUTION_RESULTS_KEY, {});
     }
-    const codeExecutionResults = this.sessionState.get(CODE_EXECUTION_RESULTS_KEY);
+    const codeExecutionResults = this.sessionState.get(
+      CODE_EXECUTION_RESULTS_KEY
+    );
     if (!(invocationId in codeExecutionResults)) {
       codeExecutionResults[invocationId] = [];
     }
@@ -154,12 +156,10 @@ class CodeExecutorContext {
     });
   }
   /**
-   * Gets the code executor context from the session state.
-   * @param invocationId The session state to get the code executor context
-   *     from.
+   * Gets the code execution context from the session state.
    * @return The code execution context for the given invocation ID.
    */
-  getCodeExecutionContext(invocationId) {
+  getCodeExecutionContext() {
     return this.sessionState.get(CONTEXT_KEY) || {};
   }
 }

package/dist/esm/common.js

@@ -3,20 +3,39 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ActiveStreamingTool } from "./agents/active_streaming_tool.js";
 import { BaseAgent, isBaseAgent } from "./agents/base_agent.js";
+import {
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor
+} from "./agents/base_llm_processor.js";
 import { CallbackContext } from "./agents/callback_context.js";
 import { functionsExportedForTestingOnly } from "./agents/functions.js";
 import { InvocationContext } from "./agents/invocation_context.js";
 import { LiveRequestQueue } from "./agents/live_request_queue.js";
-import { LlmAgent } from "./agents/llm_agent.js";
-import { LoopAgent } from "./agents/loop_agent.js";
-import { ParallelAgent } from "./agents/parallel_agent.js";
+import { LlmAgent, isLlmAgent } from "./agents/llm_agent.js";
+import { LoopAgent, isLoopAgent } from "./agents/loop_agent.js";
+import { ParallelAgent, isParallelAgent } from "./agents/parallel_agent.js";
+import { ReadonlyContext } from "./agents/readonly_context.js";
 import { StreamingMode } from "./agents/run_config.js";
-import { SequentialAgent } from "./agents/sequential_agent.js";
+import { SequentialAgent, isSequentialAgent } from "./agents/sequential_agent.js";
 import { InMemoryArtifactService } from "./artifacts/in_memory_artifact_service.js";
+import { AuthCredentialTypes } from "./auth/auth_credential.js";
+import { BaseCodeExecutor } from "./code_executors/base_code_executor.js";
 import { BuiltInCodeExecutor } from "./code_executors/built_in_code_executor.js";
-import { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent } from "./events/event.js";
+import {
+  createEvent,
+  getFunctionCalls,
+  getFunctionResponses,
+  hasTrailingCodeExecutionResult,
+  isFinalResponse,
+  stringifyContent
+} from "./events/event.js";
 import { createEventActions } from "./events/event_actions.js";
+import {
+  BaseExampleProvider,
+  isBaseExampleProvider
+} from "./examples/base_example_provider.js";
 import { InMemoryMemoryService } from "./memory/in_memory_memory_service.js";
 import { BaseLlm, isBaseLlm } from "./models/base_llm.js";
 import { Gemini } from "./models/google_llm.js";
@@ -24,32 +43,45 @@ import { LLMRegistry } from "./models/registry.js";
 import { BasePlugin } from "./plugins/base_plugin.js";
 import { LoggingPlugin } from "./plugins/logging_plugin.js";
 import { PluginManager } from "./plugins/plugin_manager.js";
-import { getAskUserConfirmationFunctionCalls, InMemoryPolicyEngine, PolicyOutcome, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, SecurityPlugin } from "./plugins/security_plugin.js";
+import {
+  InMemoryPolicyEngine,
+  PolicyOutcome,
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  SecurityPlugin,
+  getAskUserConfirmationFunctionCalls
+} from "./plugins/security_plugin.js";
 import { InMemoryRunner } from "./runner/in_memory_runner.js";
 import { Runner } from "./runner/runner.js";
 import { InMemorySessionService } from "./sessions/in_memory_session_service.js";
 import { createSession } from "./sessions/session.js";
 import { State } from "./sessions/state.js";
-import { AgentTool } from "./tools/agent_tool.js";
-import { BaseTool } from "./tools/base_tool.js";
+import { AgentTool, isAgentTool } from "./tools/agent_tool.js";
+import { BaseTool, isBaseTool } from "./tools/base_tool.js";
 import { BaseToolset } from "./tools/base_toolset.js";
-import { FunctionTool } from "./tools/function_tool.js";
-import { GOOGLE_SEARCH } from "./tools/google_search_tool.js";
+import { FunctionTool, isFunctionTool } from "./tools/function_tool.js";
+import { GOOGLE_SEARCH, GoogleSearchTool } from "./tools/google_search_tool.js";
 import { LongRunningFunctionTool } from "./tools/long_running_tool.js";
 import { ToolConfirmation } from "./tools/tool_confirmation.js";
 import { ToolContext } from "./tools/tool_context.js";
-import { LogLevel, setLogLevel } from "./utils/logger.js";
+import { LogLevel, getLogger, setLogLevel, setLogger } from "./utils/logger.js";
 import { isGemini2OrAbove } from "./utils/model_name.js";
 import { zodObjectToSchema } from "./utils/simple_zod_to_json.js";
+import { GoogleLLMVariant } from "./utils/variant_utils.js";
 import { version } from "./version.js";
 export * from "./artifacts/base_artifact_service.js";
 export * from "./memory/base_memory_service.js";
 export * from "./sessions/base_session_service.js";
 export * from "./tools/base_tool.js";
 export {
+  ActiveStreamingTool,
   AgentTool,
+  AuthCredentialTypes,
   BaseAgent,
+  BaseCodeExecutor,
+  BaseExampleProvider,
   BaseLlm,
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor,
   BasePlugin,
   BaseTool,
   BaseToolset,
@@ -58,6 +90,8 @@ export {
   FunctionTool,
   GOOGLE_SEARCH,
   Gemini,
+  GoogleLLMVariant,
+  GoogleSearchTool,
   InMemoryArtifactService,
   InMemoryMemoryService,
   InMemoryPolicyEngine,
@@ -75,6 +109,7 @@ export {
   PluginManager,
   PolicyOutcome,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  ReadonlyContext,
   Runner,
   SecurityPlugin,
   SequentialAgent,
@@ -89,12 +124,22 @@ export {
   getAskUserConfirmationFunctionCalls,
   getFunctionCalls,
   getFunctionResponses,
+  getLogger,
   hasTrailingCodeExecutionResult,
+  isAgentTool,
   isBaseAgent,
+  isBaseExampleProvider,
   isBaseLlm,
+  isBaseTool,
   isFinalResponse,
+  isFunctionTool,
   isGemini2OrAbove,
+  isLlmAgent,
+  isLoopAgent,
+  isParallelAgent,
+  isSequentialAgent,
   setLogLevel,
+  setLogger,
   stringifyContent,
   version,
   zodObjectToSchema

package/dist/esm/events/event.js

@@ -66,9 +66,7 @@ const ASCII_LETTERS_AND_NUMBERS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRS
 function createNewEventId() {
   let id = "";
   for (let i = 0; i < 8; i++) {
-    id += ASCII_LETTERS_AND_NUMBERS[Math.floor(
-      Math.random() * ASCII_LETTERS_AND_NUMBERS.length
-    )];
+    id += ASCII_LETTERS_AND_NUMBERS[Math.floor(Math.random() * ASCII_LETTERS_AND_NUMBERS.length)];
   }
   return id;
 }

package/dist/esm/examples/base_example_provider.js

@@ -3,8 +3,23 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.baseExampleProvider"
+);
+function isBaseExampleProvider(obj) {
+  return typeof obj === "object" && obj !== null && BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL in obj && obj[BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL] === true;
+}
+_a = BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL;
 class BaseExampleProvider {
+  constructor() {
+    /**
+     * A unique symbol to identify ADK example provider classes.
+     */
+    this[_a] = true;
+  }
 }
 export {
-  BaseExampleProvider
+  BaseExampleProvider,
+  isBaseExampleProvider
 };

package/dist/esm/examples/example_util.js

@@ -3,7 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BaseExampleProvider } from "./base_example_provider.js";
+import {
+  isBaseExampleProvider
+} from "./base_example_provider.js";
 const EXAMPLES_INTRO = "<EXAMPLES>\nBegin few-shot\nThe following are examples of user queries and model responses using the available tools.\n\n";
 const EXAMPLES_END = "End few-shot\n<EXAMPLES>";
 const EXAMPLE_START = "EXAMPLE {}:\nBegin example\n";
@@ -65,7 +67,7 @@ function buildExampleSi(examples, query, model) {
   if (Array.isArray(examples)) {
     return convertExamplesToText(examples, model);
   }
-  if (examples instanceof BaseExampleProvider) {
+  if (isBaseExampleProvider(examples)) {
     return convertExamplesToText(examples.getExamples(query), model);
   }
   throw new Error("Invalid example configuration");