@google/adk 0.6.1 → 1.0.0

package/dist/esm/skills/loader.js

@@ -0,0 +1,244 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import yaml from "js-yaml";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { logger } from "../utils/logger.js";
+import {
+  FrontmatterSchema
+} from "./skill.js";
+const ALLOWED_FRONTMATTER_KEYS = /* @__PURE__ */ new Set([
+  "name",
+  "description",
+  "license",
+  "allowed-tools",
+  "metadata",
+  "compatibility"
+]);
+const IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([
+  "__pycache__",
+  ".pytest_cache",
+  ".mypy_cache",
+  ".ruff_cache",
+  "node_modules",
+  "coverage",
+  "venv",
+  ".venv",
+  "env",
+  ".env",
+  ".git",
+  ".vscode",
+  ".idea"
+]);
+const IGNORED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".pyc",
+  ".pyo",
+  ".pyd",
+  ".tsbuildinfo",
+  ".DS_Store"
+]);
+async function loadDir(directoryPath) {
+  const files = {};
+  async function walk(dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (IGNORED_DIRECTORIES.has(entry.name)) {
+          continue;
+        }
+        await walk(fullPath);
+      } else if (entry.isFile()) {
+        const relativePath = path.relative(directoryPath, fullPath);
+        if (IGNORED_EXTENSIONS.has(path.extname(entry.name))) {
+          continue;
+        }
+        const fileData = await fs.readFile(fullPath);
+        try {
+          files[relativePath] = fileData.toString("utf-8");
+        } catch (_e) {
+          files[relativePath] = fileData;
+        }
+      }
+    }
+  }
+  try {
+    const stats = await fs.stat(directoryPath);
+    if (stats.isDirectory()) {
+      await walk(directoryPath);
+    }
+  } catch (e) {
+    logger.warn(
+      `Failed to load directory '${directoryPath}': ${e.message}`
+    );
+  }
+  return files;
+}
+function parseSkillMdContent(content) {
+  if (!content.startsWith("---")) {
+    throw new Error("SKILL.md must start with YAML frontmatter (---)");
+  }
+  const parts = content.split("---", 3);
+  if (parts.length < 3) {
+    throw new Error("SKILL.md frontmatter not properly closed with ---");
+  }
+  const frontmatterStr = parts[1];
+  const body = parts[2].trim();
+  try {
+    const parsed = yaml.load(frontmatterStr);
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new Error("SKILL.md frontmatter must be a YAML mapping");
+    }
+    const frontmatter = FrontmatterSchema.parse(parsed);
+    return { frontmatter, body };
+  } catch (e) {
+    throw new Error(`Invalid YAML in frontmatter: ${e.message}`);
+  }
+}
+async function loadSkillFromDir(skillDir) {
+  const resolvedDir = path.resolve(skillDir);
+  const skill = await loadSkillFile(skillDir);
+  const referencesDir = path.join(resolvedDir, "references");
+  const assetsDir = path.join(resolvedDir, "assets");
+  const scriptsDir = path.join(resolvedDir, "scripts");
+  const [references, assets, rawScripts] = await Promise.all([
+    loadDir(referencesDir),
+    loadDir(assetsDir),
+    loadDir(scriptsDir)
+  ]);
+  const scripts = {};
+  for (const [name, src] of Object.entries(rawScripts)) {
+    if (typeof src === "string") {
+      scripts[name] = { src };
+    }
+  }
+  const resources = { references, assets, scripts };
+  return {
+    ...skill,
+    resources
+  };
+}
+async function validateSkillDir(skillDir) {
+  const problems = [];
+  const resolvedDir = path.resolve(skillDir);
+  let skill;
+  try {
+    skill = await loadSkillFile(resolvedDir);
+  } catch (e) {
+    return [e.message];
+  }
+  try {
+    const keys = Object.keys(skill.frontmatter);
+    const unknown = keys.filter((k) => !ALLOWED_FRONTMATTER_KEYS.has(k));
+    if (unknown.length > 0) {
+      problems.push(
+        `Unknown frontmatter fields: [${unknown.sort().join(", ")}]`
+      );
+    }
+    const dirName = path.basename(resolvedDir);
+    if (dirName !== skill.frontmatter.name) {
+      problems.push(
+        `Skill name '${skill.frontmatter.name}' does not match directory name '${dirName}'.`
+      );
+    }
+  } catch (e) {
+    problems.push(e.message);
+  }
+  return problems;
+}
+async function loadSkillFile(skillDir) {
+  const resolvedDir = path.resolve(skillDir);
+  let skillMdPath = "";
+  let content = "";
+  try {
+    const entries = await fs.readdir(resolvedDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name.toLowerCase() === "skill.md") {
+        const p = path.join(resolvedDir, entry.name);
+        try {
+          content = await fs.readFile(p, "utf-8");
+          skillMdPath = p;
+          break;
+        } catch (_e) {
+        }
+      }
+    }
+  } catch (e) {
+    logger.warn(
+      `Failed to load directory '${skillDir}': ${e.message}`
+    );
+  }
+  if (!skillMdPath) {
+    throw new Error(
+      `SKILL.md (or any case variation like skill.md) not found in '${skillDir}'.`
+    );
+  }
+  const { frontmatter: parsed, body } = parseSkillMdContent(content);
+  const frontmatter = FrontmatterSchema.parse(parsed);
+  const dirName = path.basename(resolvedDir);
+  if (dirName !== frontmatter.name) {
+    throw new Error(
+      `Skill name '${frontmatter.name}' does not match directory name '${dirName}'.`
+    );
+  }
+  return {
+    frontmatter,
+    instructions: body
+  };
+}
+async function loadAllSkillsInDir(skillsBasePath) {
+  const resolvedPath = path.resolve(skillsBasePath);
+  const skills = {};
+  async function scanDir(currentDir) {
+    let entries;
+    try {
+      entries = await fs.readdir(currentDir, { withFileTypes: true });
+    } catch (_e) {
+      return;
+    }
+    let isSkillDir = false;
+    if (currentDir !== resolvedPath) {
+      for (const entry of entries) {
+        if (entry.isFile() && entry.name.toLowerCase() === "skill.md") {
+          isSkillDir = true;
+          break;
+        }
+      }
+    }
+    if (isSkillDir) {
+      try {
+        const skill = await loadSkillFromDir(currentDir);
+        skills[skill.frontmatter.name] = skill;
+      } catch (e) {
+        logger.warn(`Skipping invalid skill in '${currentDir}':`, e);
+      }
+    } else {
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          if (IGNORED_DIRECTORIES.has(entry.name)) {
+            continue;
+          }
+          await scanDir(path.join(currentDir, entry.name));
+        }
+      }
+    }
+  }
+  try {
+    await fs.readdir(resolvedPath);
+    await scanDir(resolvedPath);
+  } catch (e) {
+    logger.warn(`Skills base path '${skillsBasePath}' is not a directory.`, e);
+  }
+  return skills;
+}
+export {
+  loadAllSkillsInDir,
+  loadSkillFromDir,
+  parseSkillMdContent,
+  validateSkillDir
+};

package/dist/esm/skills/prompt.js

@@ -0,0 +1,30 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function escapeHtml(unsafe) {
+  return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function formatSkillsAsXml(skills) {
+  if (!skills || skills.length === 0) {
+    return "<available_skills>\n</available_skills>";
+  }
+  const lines = ["<available_skills>"];
+  for (const item of skills) {
+    const frontmatter = "frontmatter" in item ? item.frontmatter : item;
+    lines.push("  <skill>");
+    lines.push(`    <name>${escapeHtml(frontmatter.name)}</name>`);
+    lines.push(
+      `    <description>${escapeHtml(frontmatter.description)}</description>`
+    );
+    lines.push("  </skill>");
+  }
+  lines.push("</available_skills>");
+  return lines.join("\n");
+}
+export {
+  formatSkillsAsXml
+};

package/dist/esm/skills/skill.js

@@ -0,0 +1,49 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+const SNAKE_OR_KEBAB_NAME_PATTERN = /^([a-z0-9]+(-[a-z0-9]+)*|[a-z0-9]+(_[a-z0-9]+)*)$/;
+const FrontmatterSchema = z.preprocess(
+  (data) => {
+    if (typeof data === "object" && data !== null) {
+      const obj = data;
+      if ("allowed-tools" in obj && !("allowedTools" in obj)) {
+        return {
+          ...obj,
+          allowedTools: obj["allowed-tools"]
+        };
+      }
+    }
+    return data;
+  },
+  z.object({
+    name: z.string().regex(SNAKE_OR_KEBAB_NAME_PATTERN, {
+      message: "name must be lowercase kebab-case (a-z, 0-9, hyphens) or snake_case (a-z, 0-9, underscores), with no leading, trailing, or consecutive delimiters. Mixing hyphens and underscores is not allowed."
+    }).max(64),
+    description: z.string().min(1).max(1024),
+    license: z.string().optional(),
+    compatibility: z.string().max(500).optional(),
+    "allowed-tools": z.string().optional(),
+    metadata: z.record(z.string(), z.any()).default({}).refine(
+      (data) => {
+        if ("adk_additional_tools" in data) {
+          return Array.isArray(data.adk_additional_tools) && data.adk_additional_tools.every(
+            (item) => typeof item === "string"
+          );
+        }
+        return true;
+      },
+      {
+        message: "adk_additional_tools must be a list of strings"
+      }
+    )
+  }).loose()
+);
+export {
+  FrontmatterSchema,
+  SNAKE_OR_KEBAB_NAME_PATTERN
+};

package/dist/esm/telemetry/google_cloud.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/telemetry/setup.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/telemetry/tracing.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/tools/agent_tool.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -63,7 +65,7 @@ class AgentTool extends (_b = BaseTool, _a = AGENT_TOOL_SIGNATURE_SYMBOL, _b) {
     args,
     toolContext
   }) {
-    var _a2, _b2, _c, _d;
+    var _a2, _b2, _c, _d, _e, _f;
     if (this.skipSummarization) {
       toolContext.actions.skipSummarization = true;
     }
@@ -92,18 +94,25 @@ class AgentTool extends (_b = BaseTool, _a = AGENT_TOOL_SIGNATURE_SYMBOL, _b) {
       sessionId: toolContext.invocationContext.session.id,
       state: toolContext.state.toRecord()
     });
+    if ((_c = toolContext.abortSignal) == null ? void 0 : _c.aborted) {
+      return "";
+    }
     let lastEvent;
     for await (const event of runner.runAsync({
       userId: session.userId,
       sessionId: session.id,
-      newMessage: content
+      newMessage: content,
+      abortSignal: toolContext.abortSignal
     })) {
+      if ((_d = toolContext.abortSignal) == null ? void 0 : _d.aborted) {
+        return;
+      }
       if (event.actions.stateDelta) {
         toolContext.state.update(event.actions.stateDelta);
       }
       lastEvent = event;
     }
-    if (!((_d = (_c = lastEvent == null ? void 0 : lastEvent.content) == null ? void 0 : _c.parts) == null ? void 0 : _d.length)) {
+    if (!((_f = (_e = lastEvent == null ? void 0 : lastEvent.content) == null ? void 0 : _e.parts) == null ? void 0 : _f.length)) {
       return "";
     }
     const hasOutputSchema = isLlmAgent(this.agent) && this.agent.outputSchema;

package/dist/esm/tools/base_tool.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/tools/base_toolset.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/tools/exit_loop_tool.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/tools/forwarding_artifact_service.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/tools/function_tool.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/tools/google_search_tool.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/tools/load_artifacts_tool.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/tools/load_memory_tool.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/tools/long_running_tool.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/tools/mcp/mcp_session_manager.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/tools/mcp/mcp_tool.js

@@ -1,3 +1,5 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -25,7 +27,10 @@ class MCPTool extends BaseTool {
     const session = await this.mcpSessionManager.createSession();
     const callRequest = {};
     callRequest.params = { name: this.mcpTool.name, arguments: request.args };
-    return await session.callTool(callRequest.params);
+    const result = await session.callTool(callRequest.params, void 0, {
+      signal: request.toolContext.abortSignal
+    });
+    return result;
   }
 }
 export {

package/dist/esm/tools/mcp/mcp_toolset.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/tools/preload_memory_tool.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/tools/skill/list_skills_tool.js

@@ -0,0 +1,50 @@
+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 { Type } from "@google/genai";
+import { formatSkillsAsXml } from "../../skills/prompt.js";
+import { experimental } from "../../utils/experimental.js";
+import { BaseTool } from "../base_tool.js";
+let ListSkillsTool = class extends BaseTool {
+  constructor(toolset) {
+    super({
+      name: "list_skills",
+      description: "Lists all available skills with their names and descriptions."
+    });
+    this.toolset = toolset;
+  }
+  _getDeclaration() {
+    return {
+      name: this.name,
+      description: this.description,
+      parameters: {
+        type: Type.OBJECT,
+        properties: {}
+      }
+    };
+  }
+  async runAsync(_request) {
+    const skills = Object.values(this.toolset.skills);
+    return formatSkillsAsXml(skills);
+  }
+};
+ListSkillsTool = __decorateClass([
+  experimental
+], ListSkillsTool);
+export {
+  ListSkillsTool
+};