@google/adk 0.6.1 → 1.0.0

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

@@ -0,0 +1,137 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+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--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { appendInstructions } from "../../models/llm_request.js";
+import { formatSkillsAsXml } from "../../skills/prompt.js";
+import { experimental } from "../../utils/experimental.js";
+import { BaseTool } from "../base_tool.js";
+import { BaseToolset } from "../base_toolset.js";
+import { ListSkillsTool } from "./list_skills_tool.js";
+import { LoadSkillResourceTool } from "./load_skill_resource_tool.js";
+import { LoadSkillTool } from "./load_skill_tool.js";
+import { RunSkillInlineScriptTool } from "./run_skill_inline_script_tool.js";
+import { RunSkillScriptTool } from "./run_skill_script_tool.js";
+const DEFAULT_SKILL_SYSTEM_INSTRUCTION = `You can use specialized 'skills' to help you with complex tasks. You MUST use the skill tools to interact with these skills.
+
+Skills are folders of instructions and resources that extend your capabilities for specialized tasks. Each skill folder contains:
+- **SKILL.md** (required): The main instruction file with skill metadata and detailed markdown instructions.
+- **references/** (Optional): Additional documentation or examples for skill usage.
+- **assets/** (Optional): Templates, scripts or other resources used by the skill.
+- **scripts/** (Optional): Executable scripts that can be run via bash.
+
+This is very important:
+
+1. If a skill seems relevant to the current user query, you MUST use the \`load_skill\` tool with \`name="<SKILL_NAME>"\` to read its full instructions before proceeding.
+2. Once you have read the instructions, follow them exactly as documented before replying to the user. For example, If the instruction lists multiple steps, please make sure you complete all of them in order.
+3. The \`load_skill_resource\` tool is for viewing files within a skill's directory (e.g., \`references/*\`, \`assets/*\`, \`scripts/*\`). Do NOT use other tools to access these files.
+4. Use \`run_skill_script\` to run scripts from a skill's \`scripts/\` directory. Use \`load_skill_resource\` to view script content first if needed.
+`;
+let SkillToolset = class extends BaseToolset {
+  constructor(skills, options = {}) {
+    super([], "adk_skill_toolset");
+    this.toolCache = /* @__PURE__ */ new Map();
+    this.skills = Array.isArray(skills) ? Object.fromEntries(skills.map((s) => [s.frontmatter.name, s])) : skills;
+    this.codeExecutor = options.codeExecutor;
+    this.additionalTools = options.additionalTools || [];
+    this.tools = [
+      new ListSkillsTool(this),
+      new LoadSkillTool(this),
+      new LoadSkillResourceTool(this),
+      new RunSkillScriptTool(this),
+      new RunSkillInlineScriptTool(this)
+    ];
+  }
+  async getTools(context) {
+    const dynamicTools = await this.resolveAdditionalTools(context);
+    return [...this.tools, ...dynamicTools];
+  }
+  async close() {
+  }
+  getSkill(name) {
+    return this.skills[name];
+  }
+  async processLlmRequest(toolContext, llmRequest) {
+    await super.processLlmRequest(toolContext, llmRequest);
+    const skills = Object.values(this.skills);
+    const skillsXml = formatSkillsAsXml(skills);
+    appendInstructions(llmRequest, [
+      DEFAULT_SKILL_SYSTEM_INSTRUCTION,
+      skillsXml
+    ]);
+  }
+  async resolveAdditionalTools(context) {
+    if (!context) return [];
+    const agentName = context.agentName;
+    const stateKey = `_adk_activated_skill_${agentName}`;
+    const activatedSkills = context.state.get(stateKey) || [];
+    if (activatedSkills.length === 0) return [];
+    const cacheKey = `${agentName}:${activatedSkills.join(",")}`;
+    if (this.toolCache.has(cacheKey)) {
+      return this.toolCache.get(cacheKey);
+    }
+    const additionalToolNames = /* @__PURE__ */ new Set();
+    for (const skillName of activatedSkills) {
+      const skill = this.skills[skillName];
+      if (skill && skill.frontmatter.metadata) {
+        const tools = skill.frontmatter.metadata["adk_additional_tools"];
+        if (tools) {
+          tools.forEach((t) => additionalToolNames.add(t));
+        }
+      }
+    }
+    if (additionalToolNames.size === 0) {
+      this.toolCache.set(cacheKey, []);
+      return [];
+    }
+    const candidateTools = {};
+    for (const toolUnion of this.additionalTools) {
+      if (toolUnion instanceof BaseTool) {
+        if (candidateTools[toolUnion.name]) {
+          throw new Error(`Duplicate tool name: ${toolUnion.name}`);
+        }
+        candidateTools[toolUnion.name] = toolUnion;
+      } else if (toolUnion instanceof BaseToolset) {
+        const tsTools = await toolUnion.getTools(context);
+        for (const t of tsTools) {
+          if (candidateTools[t.name]) {
+            throw new Error(`Duplicate tool name: ${t.name}`);
+          }
+          candidateTools[t.name] = t;
+        }
+      }
+    }
+    const resolvedTools = [];
+    const existingNames = new Set(this.tools.map((t) => t.name));
+    for (const name of additionalToolNames) {
+      if (candidateTools[name]) {
+        const tool = candidateTools[name];
+        if (!existingNames.has(tool.name)) {
+          resolvedTools.push(tool);
+          existingNames.add(tool.name);
+        }
+      }
+    }
+    this.toolCache.set(cacheKey, resolvedTools);
+    return resolvedTools;
+  }
+};
+SkillToolset = __decorateClass([
+  experimental
+], SkillToolset);
+export {
+  SkillToolset
+};

package/dist/esm/tools/tool_confirmation.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/client_labels.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/env_aware_utils.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/experimental.js

@@ -0,0 +1,46 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from "./logger.js";
+const warnedItems = /* @__PURE__ */ new Set();
+function experimental(target, propertyKey, descriptor) {
+  if (propertyKey === void 0) {
+    const className = target.name;
+    const newConstructor = class extends target {
+      constructor(...args) {
+        if (!warnedItems.has(className)) {
+          logger.warn(
+            `Class ${className} is experimental and may change in the future.`
+          );
+          warnedItems.add(className);
+        }
+        super(...args);
+      }
+    };
+    return newConstructor;
+  }
+  if (propertyKey !== void 0 && descriptor !== void 0) {
+    const className = typeof target === "function" ? target.name : target.constructor.name;
+    const methodName = String(propertyKey);
+    const identifier = `${className}.${methodName}`;
+    const originalMethod = descriptor.value;
+    descriptor.value = function(...args) {
+      if (!warnedItems.has(identifier)) {
+        logger.warn(
+          `Method ${identifier} is experimental and may change in the future.`
+        );
+        warnedItems.add(identifier);
+      }
+      return originalMethod.apply(this, args);
+    };
+    return descriptor;
+  }
+  throw new Error("Invalid decorator usage");
+}
+export {
+  experimental
+};

package/dist/esm/utils/failover_utils.js

@@ -0,0 +1,65 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from "./logger.js";
+async function* runWithRouting(items, context, router, runFn) {
+  const initialKey = await router(items, context);
+  if (!initialKey) {
+    throw new Error("Initial routing failed, no item selected.");
+  }
+  let selectedKey = initialKey;
+  logger.debug(`Router selected initial key: ${selectedKey}`);
+  let selectedItem = items[selectedKey];
+  if (!selectedItem) {
+    throw new Error(`Item not found for key: ${selectedKey}`);
+  }
+  const triedKeys = /* @__PURE__ */ new Set([selectedKey]);
+  while (true) {
+    const generatorOrPromise = runFn(selectedItem);
+    let firstYielded = false;
+    try {
+      if (isAsyncGenerator(generatorOrPromise)) {
+        for await (const result2 of generatorOrPromise) {
+          yield result2;
+          firstYielded = true;
+        }
+        return;
+      }
+      const result = await generatorOrPromise;
+      yield result;
+      return;
+    } catch (error) {
+      if (!firstYielded) {
+        const nextKey = await router(items, context, {
+          failedKeys: triedKeys,
+          lastError: error
+        });
+        logger.debug(`Router selected next key: ${nextKey}`);
+        if (nextKey === void 0) {
+          throw error;
+        }
+        if (triedKeys.has(nextKey)) {
+          throw error;
+        }
+        selectedKey = nextKey;
+        selectedItem = items[selectedKey];
+        if (!selectedItem) {
+          throw new Error(`Item not found for key: ${selectedKey}`);
+        }
+        triedKeys.add(selectedKey);
+      } else {
+        throw error;
+      }
+    }
+  }
+}
+function isAsyncGenerator(obj) {
+  return typeof obj === "object" && typeof obj[Symbol.asyncIterator] === "function";
+}
+export {
+  runWithRouting
+};

package/dist/esm/utils/file_extension_utils.js

@@ -0,0 +1,51 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  CodeExecutionLanguage,
+  FileContentEncoding
+} from "../code_executors/code_execution_utils.js";
+const MIME_TYPE_MAP = {
+  ".js": { mimeType: "text/javascript", encoding: FileContentEncoding.UTF8 },
+  ".py": { mimeType: "text/x-python", encoding: FileContentEncoding.UTF8 },
+  ".md": { mimeType: "text/markdown", encoding: FileContentEncoding.UTF8 },
+  ".txt": { mimeType: "text/plain", encoding: FileContentEncoding.UTF8 },
+  ".html": { mimeType: "text/html", encoding: FileContentEncoding.UTF8 },
+  ".css": { mimeType: "text/css", encoding: FileContentEncoding.UTF8 },
+  ".json": { mimeType: "application/json", encoding: FileContentEncoding.UTF8 },
+  ".csv": { mimeType: "text/csv", encoding: FileContentEncoding.UTF8 },
+  ".svg": { mimeType: "image/svg+xml", encoding: FileContentEncoding.UTF8 },
+  ".xml": { mimeType: "application/xml", encoding: FileContentEncoding.UTF8 },
+  ".yaml": { mimeType: "text/yaml", encoding: FileContentEncoding.UTF8 },
+  ".yml": { mimeType: "text/yaml", encoding: FileContentEncoding.UTF8 },
+  ".png": { mimeType: "image/png", encoding: FileContentEncoding.BASE64 },
+  ".jpg": { mimeType: "image/jpeg", encoding: FileContentEncoding.BASE64 },
+  ".jpeg": { mimeType: "image/jpeg", encoding: FileContentEncoding.BASE64 },
+  ".pdf": { mimeType: "application/pdf", encoding: FileContentEncoding.BASE64 }
+};
+const EXTENSION_TO_LANGUAGE = {
+  ".js": CodeExecutionLanguage.JAVASCRIPT,
+  ".ts": CodeExecutionLanguage.TYPESCRIPT,
+  ".py": CodeExecutionLanguage.PYTHON,
+  ".bat": CodeExecutionLanguage.WINDOWS_CMD,
+  ".cmd": CodeExecutionLanguage.WINDOWS_CMD,
+  ".ps1": CodeExecutionLanguage.POWERSHELL,
+  ".sh": CodeExecutionLanguage.SHELL
+};
+function getMimeTypeAndEncoding(ext) {
+  return MIME_TYPE_MAP[ext.toLowerCase()] || {
+    mimeType: "application/octet-stream",
+    encoding: FileContentEncoding.BASE64
+  };
+}
+function getScriptLanguageByExtension(ext) {
+  return EXTENSION_TO_LANGUAGE[ext.toLowerCase()] || CodeExecutionLanguage.UNSPECIFIED;
+}
+export {
+  getMimeTypeAndEncoding,
+  getScriptLanguageByExtension
+};

package/dist/esm/utils/file_utils.js

@@ -0,0 +1,56 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+async function materializeFiles(files, dir = process.cwd()) {
+  const resolvedBaseDir = path.resolve(dir);
+  const createdFiles = [];
+  for (const file of files) {
+    const fullPath = path.resolve(dir, file.name);
+    if (!fullPath.startsWith(resolvedBaseDir)) {
+      throw new Error(
+        `Path traversal detected: ${file.name} resolves outside of ${dir}`
+      );
+    }
+    const ext = path.extname(fullPath);
+    const dirName = path.dirname(fullPath);
+    const base = path.basename(fullPath, ext);
+    let finalPath = fullPath;
+    let counter = 2;
+    while (true) {
+      try {
+        await fs.access(finalPath);
+        const newName = `${base}_${counter}${ext}`;
+        finalPath = path.join(dirName, newName);
+        const originalDir = path.dirname(file.name);
+        file.name = originalDir === "." ? newName : path.join(originalDir, newName);
+        counter++;
+      } catch {
+        break;
+      }
+    }
+    if (!finalPath.startsWith(resolvedBaseDir)) {
+      throw new Error(
+        `Path traversal detected: ${file.name} resolves outside of ${dir}`
+      );
+    }
+    await fs.mkdir(path.dirname(finalPath), { recursive: true });
+    await fs.writeFile(
+      finalPath,
+      Buffer.from(file.content, file.contentEncoding)
+    );
+    createdFiles.push({
+      ...file,
+      name: path.relative(dir, finalPath)
+    });
+  }
+  return createdFiles;
+}
+export {
+  materializeFiles
+};

package/dist/esm/utils/gemini_schema_util.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/logger.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/model_name.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC

package/dist/esm/utils/object_notation_utils.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2026 Google LLC

package/dist/esm/utils/simple_zod_to_json.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC