@google/adk 1.6.0 → 2.1.0

package/dist/esm/tools/openapi_tool/auth/auth_helpers.js

@@ -1,11 +1,17 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import {
+  AuthCredentialTypes
+} from "../../../auth/auth_credential.js";
 function applyCredential(url, headers, credential, authScheme) {
+  var _a;
   if (!credential) return url;
   if (credential.apiKey) {
     let inLocation;
@@ -23,11 +29,19 @@ function applyCredential(url, headers, credential, authScheme) {
     } else {
       headers["Authorization"] = credential.apiKey;
     }
-  } else if (credential.http && credential.http.credentials && credential.http.credentials.token) {
-    headers["Authorization"] = `Bearer ${credential.http.credentials.token}`;
+  } else if (credential.authType === AuthCredentialTypes.HTTP || credential.http) {
+    const httpCredentials = (_a = credential.http) == null ? void 0 : _a.credentials;
+    if (httpCredentials == null ? void 0 : httpCredentials.token) {
+      headers["Authorization"] = `Bearer ${httpCredentials.token}`;
+    } else if ((httpCredentials == null ? void 0 : httpCredentials.username) || (httpCredentials == null ? void 0 : httpCredentials.password)) {
+      throw new Error("Basic Authentication is not supported.");
+    } else {
+      throw new Error("Invalid HTTP auth credentials");
+    }
   }
   return url;
 }
+__name(applyCredential, "applyCredential");
 function createApiKeyScheme(name, inLocation) {
   return {
     type: "apiKey",
@@ -35,12 +49,14 @@ function createApiKeyScheme(name, inLocation) {
     in: inLocation
   };
 }
+__name(createApiKeyScheme, "createApiKeyScheme");
 function createBearerScheme() {
   return {
     type: "http",
     scheme: "bearer"
   };
 }
+__name(createBearerScheme, "createBearerScheme");
 export {
   applyCredential,
   createApiKeyScheme,

package/dist/esm/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -49,6 +50,7 @@ let AutoAuthCredentialExchanger = class {
     return exchanger.exchange({ authScheme, authCredential });
   }
 };
+__name(AutoAuthCredentialExchanger, "AutoAuthCredentialExchanger");
 __decorateClass([
   experimental
 ], AutoAuthCredentialExchanger.prototype, "exchange", 1);

package/dist/esm/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -100,6 +101,7 @@ let ServiceAccountCredentialExchanger = class {
     }
   }
 };
+__name(ServiceAccountCredentialExchanger, "ServiceAccountCredentialExchanger");
 __decorateClass([
   experimental
 ], ServiceAccountCredentialExchanger.prototype, "exchange", 1);

package/dist/esm/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -39,6 +40,7 @@ let OpenApiSpecParser = class {
     });
   }
 };
+__name(OpenApiSpecParser, "OpenApiSpecParser");
 __decorateClass([
   experimental
 ], OpenApiSpecParser.prototype, "parse", 1);
@@ -48,7 +50,7 @@ OpenApiSpecParser = __decorateClass([
 function resolveReferences(spec) {
   const resolvedCache = /* @__PURE__ */ new Map();
   const specCopy = JSON.parse(JSON.stringify(spec));
-  const recursiveResolve = (obj, currentDoc, seenRefs = /* @__PURE__ */ new Set()) => {
+  const recursiveResolve = /* @__PURE__ */ __name((obj, currentDoc, seenRefs = /* @__PURE__ */ new Set()) => {
     if (typeof obj !== "object" || obj === null) {
       return obj;
     }
@@ -81,9 +83,10 @@ function resolveReferences(spec) {
       newDict[key] = recursiveResolve(value, currentDoc, seenRefs);
     }
     return newDict;
-  };
+  }, "recursiveResolve");
   return recursiveResolve(specCopy, specCopy);
 }
+__name(resolveReferences, "resolveReferences");
 function resolveRef(refString, currentDoc) {
   const parts = refString.split("/");
   if (parts[0] !== "#") {
@@ -99,9 +102,10 @@ function resolveRef(refString, currentDoc) {
   }
   return current;
 }
+__name(resolveRef, "resolveRef");
 function sanitizeSchemaTypes(openapiSpec) {
   const specCopy = JSON.parse(JSON.stringify(openapiSpec));
-  const sanitizeTypeField = (schemaDict) => {
+  const sanitizeTypeField = /* @__PURE__ */ __name((schemaDict) => {
     if (!("type" in schemaDict)) return;
     const typeValue = schemaDict["type"];
     if (typeof typeValue === "string") {
@@ -128,8 +132,8 @@ function sanitizeSchemaTypes(openapiSpec) {
         delete schemaDict["type"];
       }
     }
-  };
-  const sanitizeRecursive = (obj, inSchema) => {
+  }, "sanitizeTypeField");
+  const sanitizeRecursive = /* @__PURE__ */ __name((obj, inSchema) => {
     if (typeof obj !== "object" || obj === null) {
       return obj;
     }
@@ -145,20 +149,36 @@ function sanitizeSchemaTypes(openapiSpec) {
       objRecord[key] = sanitizeRecursive(value, inSchema || isSchemaContainer);
     }
     return objRecord;
-  };
+  }, "sanitizeRecursive");
   return sanitizeRecursive(specCopy, false);
 }
+__name(sanitizeSchemaTypes, "sanitizeSchemaTypes");
+function resolveServerUrl(server) {
+  return server.url.replace(/\{([^{}]+)\}/g, (_, name) => {
+    var _a, _b;
+    const variable = (_a = server.variables) == null ? void 0 : _a[name];
+    const value = (variable == null ? void 0 : variable.default) || ((_b = variable == null ? void 0 : variable.enum) == null ? void 0 : _b[0]);
+    if (!value) {
+      throw new Error(
+        `Unresolved server URL variable '${name}' in '${server.url}'. Declare a default under servers[].variables.`
+      );
+    }
+    return value;
+  });
+}
+__name(resolveServerUrl, "resolveServerUrl");
 function collectOperations(spec, options = {}) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c;
   const preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
   const operations = [];
-  const baseUrl = ((_c = (_b = spec.servers) == null ? void 0 : _b[0]) == null ? void 0 : _c.url) || "";
+  const server = (_b = spec.servers) == null ? void 0 : _b[0];
+  const baseUrl = server ? resolveServerUrl(server) : "";
   const globalSecurity = spec.security || [];
   let globalSchemeName;
   if (globalSecurity.length > 0) {
     globalSchemeName = Object.keys(globalSecurity[0])[0];
   }
-  const authSchemes = ((_d = spec.components) == null ? void 0 : _d.securitySchemes) || {};
+  const authSchemes = ((_c = spec.components) == null ? void 0 : _c.securitySchemes) || {};
   for (const [path, pathItem] of Object.entries(spec.paths || {})) {
     if (!pathItem) continue;
     const methods = [
@@ -201,6 +221,7 @@ function collectOperations(spec, options = {}) {
   }
   return operations;
 }
+__name(collectOperations, "collectOperations");
 export {
   OpenApiSpecParser
 };

package/dist/esm/tools/openapi_tool/openapi_spec_parser/operation_parser.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -163,7 +164,7 @@ let OperationParser = class {
     return {
       type: "object",
       properties,
-      required: required.length > 0 ? required : void 0,
+      required,
       title: `${this.operation.operationId || "unnamed"}_Arguments`
     };
   }
@@ -178,6 +179,7 @@ let OperationParser = class {
     return this.operation.description || this.operation.summary || "";
   }
 };
+__name(OperationParser, "OperationParser");
 __decorateClass([
   experimental
 ], OperationParser.prototype, "getParameters", 1);

package/dist/esm/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -17,7 +18,7 @@ var __decorateClass = (decorators, target, key, kind) => {
  */
 import { experimental } from "../../../utils/experimental.js";
 import { AutoAuthCredentialExchanger } from "../auth/credential_exchangers/auto_auth_credential_exchanger.js";
-class ToolContextCredentialStore {
+const _ToolContextCredentialStore = class _ToolContextCredentialStore {
   constructor(context) {
     this.context = context;
   }
@@ -32,7 +33,9 @@ class ToolContextCredentialStore {
   storeCredential(key, credential) {
     this.context.state.set(key, credential);
   }
-}
+};
+__name(_ToolContextCredentialStore, "ToolContextCredentialStore");
+let ToolContextCredentialStore = _ToolContextCredentialStore;
 let ToolAuthHandler = class {
   constructor(context, authScheme, authCredential, credentialKey) {
     this.context = context;
@@ -80,6 +83,7 @@ let ToolAuthHandler = class {
     return { state: "done", authCredential: result.credential };
   }
 };
+__name(ToolAuthHandler, "ToolAuthHandler");
 __decorateClass([
   experimental
 ], ToolAuthHandler.prototype, "prepareAuthCredentials", 1);

package/dist/esm/tools/openapi_tool/openapi_toolset.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -83,6 +84,7 @@ let OpenAPIToolset = class extends BaseToolset {
     return Promise.resolve();
   }
 };
+__name(OpenAPIToolset, "OpenAPIToolset");
 __decorateClass([
   experimental
 ], OpenAPIToolset.prototype, "getTools", 1);

package/dist/esm/tools/openapi_tool/rest_api_tool.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -116,6 +117,7 @@ let RestApiTool = class extends BaseTool {
     }
   }
 };
+__name(RestApiTool, "RestApiTool");
 __decorateClass([
   experimental
 ], RestApiTool.prototype, "configureAuthScheme", 1);
@@ -134,6 +136,15 @@ __decorateClass([
 RestApiTool = __decorateClass([
   experimental
 ], RestApiTool);
+function encodePathParamValue(name, value) {
+  if (value === "." || value === "..") {
+    throw new Error(
+      `Invalid value for path parameter '${name}': relative path segments ('.' and '..') are not allowed.`
+    );
+  }
+  return encodeURIComponent(value);
+}
+__name(encodePathParamValue, "encodePathParamValue");
 function prepareRequestParams(endpoint, parameters, args) {
   const headers = {};
   const queryParams = new URLSearchParams();
@@ -147,7 +158,10 @@ function prepareRequestParams(endpoint, parameters, args) {
     const originalName = param.originalName;
     const location = param.paramLocation;
     if (location === "path") {
-      pathParams[originalName] = String(argValue);
+      pathParams[originalName] = encodePathParamValue(
+        originalName,
+        String(argValue)
+      );
     } else if (location === "query") {
       queryParams.append(originalName, String(argValue));
     } else if (location === "header") {
@@ -160,10 +174,11 @@ function prepareRequestParams(endpoint, parameters, args) {
       }
     }
   }
-  let url = `${endpoint.baseUrl}${endpoint.path}`;
-  for (const [key, value] of Object.entries(pathParams)) {
-    url = url.replace(`{${key}}`, value);
-  }
+  const resolvedPath = endpoint.path.replace(
+    /\{([^{}]+)\}/g,
+    (placeholder, name) => Object.hasOwn(pathParams, name) ? pathParams[name] : placeholder
+  );
+  let url = `${endpoint.baseUrl}${resolvedPath}`;
   const urlParts = url.split("?");
   if (urlParts.length > 1) {
     const pathQueryParams = new URLSearchParams(urlParts[1]);
@@ -178,31 +193,30 @@ function prepareRequestParams(endpoint, parameters, args) {
   }
   return { url, headers, body, bodyData };
 }
+__name(prepareRequestParams, "prepareRequestParams");
 function prepareRequestBody(requestBody, body, bodyData, headers) {
   const finalData = body !== void 0 ? body : Object.keys(bodyData).length > 0 ? bodyData : void 0;
   if (requestBody && "content" in requestBody) {
     const content = requestBody.content;
-    for (const [mimeType, _mediaTypeObject] of Object.entries(content)) {
-      if (finalData !== void 0) {
-        if (mimeType === "application/json" || mimeType.endsWith("+json")) {
-          headers["Content-Type"] = mimeType;
-          return typeof finalData === "string" ? finalData : JSON.stringify(finalData);
-        } else if (mimeType === "application/x-www-form-urlencoded") {
-          return new URLSearchParams(finalData);
-        } else if (mimeType === "multipart/form-data") {
-          const formData = new FormData();
-          if (typeof finalData === "object" && finalData !== null) {
-            for (const [key, value] of Object.entries(finalData)) {
-              formData.append(key, String(value));
-            }
+    const mimeType = Object.keys(content)[0];
+    if (mimeType && finalData !== void 0) {
+      if (mimeType === "application/json" || mimeType.endsWith("+json")) {
+        headers["Content-Type"] = mimeType;
+        return typeof finalData === "string" ? finalData : JSON.stringify(finalData);
+      } else if (mimeType === "application/x-www-form-urlencoded") {
+        return new URLSearchParams(finalData);
+      } else if (mimeType === "multipart/form-data") {
+        const formData = new FormData();
+        if (typeof finalData === "object" && finalData !== null) {
+          for (const [key, value] of Object.entries(finalData)) {
+            formData.append(key, String(value));
           }
-          return formData;
-        } else if (mimeType === "text/plain") {
-          headers["Content-Type"] = mimeType;
-          return String(finalData);
         }
+        return formData;
+      } else if (mimeType === "text/plain") {
+        headers["Content-Type"] = mimeType;
+        return String(finalData);
       }
-      break;
     }
   } else if (finalData !== void 0) {
     headers["Content-Type"] = "application/json";
@@ -210,6 +224,7 @@ function prepareRequestBody(requestBody, body, bodyData, headers) {
   }
   return void 0;
 }
+__name(prepareRequestBody, "prepareRequestBody");
 function createRestApiTool(parsed, options = {}) {
   return new RestApiTool(
     parsed.name,
@@ -221,6 +236,7 @@ function createRestApiTool(parsed, options = {}) {
     options
   );
 }
+__name(createRestApiTool, "createRestApiTool");
 export {
   RestApiTool,
   createRestApiTool,

package/dist/esm/tools/preload_memory_tool.js

@@ -1,5 +1,7 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2026 Google LLC
@@ -10,11 +12,11 @@ import { logger } from "../utils/logger.js";
 import {
   BaseTool
 } from "./base_tool.js";
-class PreloadMemoryTool extends BaseTool {
+const _PreloadMemoryTool = class _PreloadMemoryTool extends BaseTool {
   constructor() {
     super({
       // Name and description are not used because this tool only
-      // changes llm_request.
+      // changes the LlmRequest.
       name: "preload_memory",
       description: "preload_memory"
     });
@@ -74,7 +76,9 @@ ${fullMemoryText}
 `;
     appendInstructions(request.llmRequest, [si]);
   }
-}
+};
+__name(_PreloadMemoryTool, "PreloadMemoryTool");
+let PreloadMemoryTool = _PreloadMemoryTool;
 const PRELOAD_MEMORY = new PreloadMemoryTool();
 export {
   PRELOAD_MEMORY,

package/dist/esm/tools/request_input_tool.js

@@ -1,25 +1,28 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
 import { z } from "zod";
+import { REQUEST_INPUT_FUNCTION_CALL_NAME } from "../agents/functions.js";
 import { LongRunningFunctionTool } from "./long_running_tool.js";
 const requestInputTool = new LongRunningFunctionTool({
-  name: "adk_request_input",
+  name: REQUEST_INPUT_FUNCTION_CALL_NAME,
   description: "Presents a custom message to the user and awaits unstructured or structured input.",
   parameters: z.object({
     message: z.string().describe("The prompt for the user."),
-    responseSchema: z.record(z.string(), z.unknown()).optional().describe("Expected schema of the response.")
+    response_schema: z.record(z.string(), z.unknown()).optional().describe("Expected schema of the response.")
   }),
-  execute: async (input, context) => {
+  execute: /* @__PURE__ */ __name(async (input, context) => {
     if (context) {
       context.actions.skipSummarization = true;
     }
     return null;
-  }
+  }, "execute")
 });
 export {
   requestInputTool

package/dist/esm/tools/retrieval/base_retrieval_tool.js

@@ -0,0 +1,33 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Type } from "@google/genai";
+import { BaseTool } from "../base_tool.js";
+const _BaseRetrievalTool = class _BaseRetrievalTool extends BaseTool {
+  _getDeclaration() {
+    return {
+      name: this.name,
+      description: this.description,
+      parameters: {
+        type: Type.OBJECT,
+        properties: {
+          query: {
+            type: Type.STRING,
+            description: "The query to retrieve."
+          }
+        }
+      }
+    };
+  }
+};
+__name(_BaseRetrievalTool, "BaseRetrievalTool");
+let BaseRetrievalTool = _BaseRetrievalTool;
+export {
+  BaseRetrievalTool
+};

package/dist/esm/tools/retrieval/files_retrieval.js

@@ -0,0 +1,81 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from "../../utils/logger.js";
+import {
+  LlamaIndexRetrieval
+} from "./llama_index_retrieval.js";
+const LLAMA_INDEX_MODULE = "llamaindex";
+const DIRECTORY_READER_MODULE = "@llamaindex/readers/directory";
+async function importOptional(specifier) {
+  try {
+    return await Promise.resolve().then(() => __toESM(require(specifier)));
+  } catch (cause) {
+    throw new Error(
+      `FilesRetrieval needs the optional package '${specifier}', which is not installed. Install '${LLAMA_INDEX_MODULE}' and '@llamaindex/readers', or build the retriever yourself and pass it to LlamaIndexRetrieval.`,
+      { cause }
+    );
+  }
+}
+__name(importOptional, "importOptional");
+const _FilesRetrieval = class _FilesRetrieval extends LlamaIndexRetrieval {
+  constructor(params) {
+    super({
+      name: params.name,
+      description: params.description,
+      retriever: params.retriever
+    });
+    this.inputDir = params.inputDir;
+  }
+  /**
+   * Indexes every file under `inputDir` and returns a tool that retrieves
+   * from it.
+   *
+   * Requires the optional `llamaindex` and `@llamaindex/readers` packages,
+   * and a configured LlamaIndex embedding model.
+   */
+  static async create(params) {
+    logger.info(`Loading data from ${params.inputDir}`);
+    const { SimpleDirectoryReader } = await importOptional(
+      DIRECTORY_READER_MODULE
+    );
+    const { VectorStoreIndex } = await importOptional(LLAMA_INDEX_MODULE);
+    const documents = await new SimpleDirectoryReader().loadData({
+      directoryPath: params.inputDir
+    });
+    const index = await VectorStoreIndex.fromDocuments(documents);
+    return new _FilesRetrieval({ ...params, retriever: index.asRetriever() });
+  }
+};
+__name(_FilesRetrieval, "FilesRetrieval");
+let FilesRetrieval = _FilesRetrieval;
+export {
+  FilesRetrieval
+};

package/dist/esm/tools/retrieval/llama_index_retrieval.js

@@ -0,0 +1,30 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseRetrievalTool } from "./base_retrieval_tool.js";
+const _LlamaIndexRetrieval = class _LlamaIndexRetrieval extends BaseRetrievalTool {
+  constructor(params) {
+    super({ name: params.name, description: params.description });
+    this.retriever = params.retriever;
+  }
+  async runAsync({ args }) {
+    var _a;
+    const nodes = await this.retriever.retrieve(String((_a = args["query"]) != null ? _a : ""));
+    const top = nodes[0];
+    if (!top) {
+      throw new Error(`${this.name} retrieved no results for the query.`);
+    }
+    return top.node.text;
+  }
+};
+__name(_LlamaIndexRetrieval, "LlamaIndexRetrieval");
+let LlamaIndexRetrieval = _LlamaIndexRetrieval;
+export {
+  LlamaIndexRetrieval
+};

package/dist/esm/tools/skill/list_skills_tool.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -42,6 +43,7 @@ let ListSkillsTool = class extends BaseTool {
     return formatSkillsAsXml(skills);
   }
 };
+__name(ListSkillsTool, "ListSkillsTool");
 ListSkillsTool = __decorateClass([
   experimental
 ], ListSkillsTool);

package/dist/esm/tools/skill/load_skill_resource_tool.js

@@ -2,6 +2,7 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -182,6 +183,7 @@ let LoadSkillResourceTool = class extends BaseTool {
     }
   }
 };
+__name(LoadSkillResourceTool, "LoadSkillResourceTool");
 LoadSkillResourceTool = __decorateClass([
   experimental
 ], LoadSkillResourceTool);