@google/adk 1.6.0 → 2.1.0

package/dist/web/skills/loader.js

@@ -1,360 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import AdmZip from "adm-zip";
-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",
-  // Camel-case alias: FrontmatterSchema's preprocessor derives `allowedTools`
-  // from `allowed-tools`, and `.loose()` passes either spelling through.
-  "allowedTools",
-  "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 '".concat(directoryPath, "': ").concat(e.message)
-    );
-  }
-  return files;
-}
-function parseFrontmatterYaml(content) {
-  if (!content.startsWith("---")) {
-    throw new Error("SKILL.md must start with YAML frontmatter (---)");
-  }
-  const parts = content.split("---");
-  if (parts.length < 3) {
-    throw new Error("SKILL.md frontmatter not properly closed with ---");
-  }
-  const frontmatterStr = parts[1];
-  const body = parts.filter((_, i) => i >= 2).join("---").trim();
-  try {
-    const parsed = yaml.load(frontmatterStr);
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-      throw new Error("SKILL.md frontmatter must be a YAML mapping");
-    }
-    return { raw: parsed, body };
-  } catch (e) {
-    throw new Error("Invalid YAML in frontmatter: ".concat(e.message));
-  }
-}
-function validateFrontmatter(raw) {
-  try {
-    return FrontmatterSchema.parse(raw);
-  } catch (e) {
-    throw new Error("Invalid YAML in frontmatter: ".concat(e.message));
-  }
-}
-function parseSkillMdContent(content) {
-  const { raw, body } = parseFrontmatterYaml(content);
-  return { frontmatter: validateFrontmatter(raw), body };
-}
-function isDangerousZipEntryName(entryName) {
-  if (path.posix.isAbsolute(entryName) || path.win32.isAbsolute(entryName)) {
-    return true;
-  }
-  return entryName.split(/[/\\]/).some((segment) => segment === "..");
-}
-function isBareSkillName(name) {
-  return name !== "." && name !== ".." && path.basename(name) === name;
-}
-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 __spreadProps(__spreadValues({}, 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: [".concat(unknown.sort().join(", "), "]")
-      );
-    }
-    const dirName = path.basename(resolvedDir);
-    if (dirName !== skill.frontmatter.name) {
-      problems.push(
-        "Skill name '".concat(skill.frontmatter.name, "' does not match directory name '").concat(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 '".concat(skillDir, "': ").concat(e.message)
-    );
-  }
-  if (!skillMdPath) {
-    throw new Error(
-      "SKILL.md (or any case variation like skill.md) not found in '".concat(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 '".concat(frontmatter.name, "' does not match directory name '").concat(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 '".concat(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 '".concat(skillsBasePath, "' is not a directory."), e);
-  }
-  return skills;
-}
-function loadSkillFromZipBuffer(zipBuffer) {
-  const zip = new AdmZip(zipBuffer);
-  const entries = zip.getEntries();
-  for (const entry of entries) {
-    if (isDangerousZipEntryName(entry.entryName)) {
-      throw new Error("Dangerous zip entry ignored: ".concat(entry.entryName));
-    }
-  }
-  let skillMdContent = "";
-  for (const entry of entries) {
-    if (entry.isDirectory) continue;
-    if (entry.entryName.toLowerCase() === "skill.md") {
-      skillMdContent = entry.getData().toString("utf-8");
-      break;
-    }
-  }
-  if (!skillMdContent) {
-    throw new Error("SKILL.md not found in zipped filesystem.");
-  }
-  const { raw, body } = parseFrontmatterYaml(skillMdContent);
-  const skillName = raw["name"];
-  if (!skillName) {
-    throw new Error("SKILL.md frontmatter must contain 'name'");
-  }
-  if (typeof skillName !== "string" || !isBareSkillName(skillName)) {
-    throw new Error("Invalid skill name in SKILL.md: ".concat(String(skillName)));
-  }
-  const frontmatter = validateFrontmatter(raw);
-  const references = {};
-  const assets = {};
-  const scripts = {};
-  function loadZipDir(prefix) {
-    const res = {};
-    const normPrefix = prefix.endsWith("/") ? prefix : "".concat(prefix, "/");
-    for (const entry of entries) {
-      if (entry.isDirectory) continue;
-      if (entry.entryName.startsWith(normPrefix)) {
-        if (entry.entryName.includes("__pycache__")) continue;
-        const relativePath = entry.entryName.substring(normPrefix.length);
-        if (!relativePath) continue;
-        const data = entry.getData();
-        try {
-          res[relativePath] = data.toString("utf-8");
-        } catch (_e) {
-          res[relativePath] = data;
-        }
-      }
-    }
-    return res;
-  }
-  const refFiles = loadZipDir("references");
-  for (const [key, val] of Object.entries(refFiles)) {
-    references[key] = val;
-  }
-  const assetFiles = loadZipDir("assets");
-  for (const [key, val] of Object.entries(assetFiles)) {
-    assets[key] = val;
-  }
-  const rawScripts = loadZipDir("scripts");
-  for (const [key, val] of Object.entries(rawScripts)) {
-    if (typeof val === "string") {
-      scripts[key] = { src: val };
-    }
-  }
-  return {
-    frontmatter,
-    instructions: body,
-    resources: {
-      references,
-      assets,
-      scripts
-    }
-  };
-}
-export {
-  loadAllSkillsInDir,
-  loadSkillFromDir,
-  loadSkillFromZipBuffer,
-  parseSkillMdContent,
-  validateSkillDir
-};

package/dist/web/skills/prompt.js

@@ -1,30 +0,0 @@
-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>".concat(escapeHtml(frontmatter.name), "</name>"));
-    lines.push(
-      "    <description>".concat(escapeHtml(frontmatter.description), "</description>")
-    );
-    lines.push("  </skill>");
-  }
-  lines.push("</available_skills>");
-  return lines.join("\n");
-}
-export {
-  formatSkillsAsXml
-};

package/dist/web/skills/skill.js

@@ -1,67 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-/**
- * @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 __spreadProps(__spreadValues({}, 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/web/skills/skill_registry.js

@@ -1,7 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */

package/dist/web/telemetry/google_cloud.js

@@ -1,54 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { MetricExporter } from "@google-cloud/opentelemetry-cloud-monitoring-exporter";
-import { TraceExporter } from "@google-cloud/opentelemetry-cloud-trace-exporter";
-import { gcpDetector } from "@opentelemetry/resource-detector-gcp";
-import { detectResources } from "@opentelemetry/resources";
-import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { GoogleAuth } from "google-auth-library";
-import { logger } from "../utils/logger.js";
-const GCP_PROJECT_ERROR_MESSAGE = "Cannot determine GCP Project. OTel GCP Exporters cannot be set up. Please make sure to log into correct GCP Project.";
-async function getGcpProjectId() {
-  try {
-    const auth = new GoogleAuth();
-    const projectId = await auth.getProjectId();
-    return projectId || void 0;
-  } catch (_e) {
-    return void 0;
-  }
-}
-async function getGcpExporters(config = {}) {
-  const {
-    enableTracing = false,
-    enableMetrics = false
-    // enableCloudLogging = false,
-  } = config;
-  const projectId = await getGcpProjectId();
-  if (!projectId) {
-    logger.warn(GCP_PROJECT_ERROR_MESSAGE);
-    return {};
-  }
-  return {
-    spanProcessors: enableTracing ? [new BatchSpanProcessor(new TraceExporter({ projectId }))] : [],
-    metricReaders: enableMetrics ? [
-      new PeriodicExportingMetricReader({
-        exporter: new MetricExporter({ projectId }),
-        exportIntervalMillis: 5e3
-      })
-    ] : [],
-    logRecordProcessors: []
-  };
-}
-function getGcpResource() {
-  return detectResources({ detectors: [gcpDetector] });
-}
-export {
-  getGcpExporters,
-  getGcpResource
-};

package/dist/web/telemetry/setup.js

@@ -1,83 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { metrics, trace } from "@opentelemetry/api";
-import { logs } from "@opentelemetry/api-logs";
-import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
-import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { detectResources } from "@opentelemetry/resources";
-import {
-  BatchLogRecordProcessor,
-  LoggerProvider
-} from "@opentelemetry/sdk-logs";
-import {
-  MeterProvider,
-  PeriodicExportingMetricReader
-} from "@opentelemetry/sdk-metrics";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-function maybeSetOtelProviders(otelHooksToSetup = [], otelResource) {
-  const resource = otelResource || getOtelResource();
-  const allHooks = [...otelHooksToSetup, getOtelExporters()];
-  const spanProcessors = allHooks.flatMap(
-    (hooks) => hooks.spanProcessors || []
-  );
-  const metricReaders = allHooks.flatMap((hooks) => hooks.metricReaders || []);
-  const logRecordProcessors = allHooks.flatMap(
-    (hooks) => hooks.logRecordProcessors || []
-  );
-  if (spanProcessors.length > 0) {
-    const tracerProvider = new NodeTracerProvider({
-      resource,
-      spanProcessors
-    });
-    tracerProvider.register();
-    trace.setGlobalTracerProvider(tracerProvider);
-  }
-  if (metricReaders.length > 0) {
-    const meterProvider = new MeterProvider({
-      readers: metricReaders,
-      resource
-    });
-    metrics.setGlobalMeterProvider(meterProvider);
-  }
-  if (logRecordProcessors.length > 0) {
-    const loggerProvider = new LoggerProvider({
-      resource,
-      processors: logRecordProcessors
-    });
-    logs.setGlobalLoggerProvider(loggerProvider);
-  }
-}
-function getOtelResource() {
-  return detectResources({
-    detectors: []
-  });
-}
-function getOtelExportersConfig() {
-  return {
-    enableTracing: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT),
-    enableMetrics: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT),
-    enableLogging: !!(process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT)
-  };
-}
-function getOtelExporters(config = getOtelExportersConfig()) {
-  const { enableTracing, enableMetrics, enableLogging } = config;
-  return {
-    spanProcessors: enableTracing ? [new BatchSpanProcessor(new OTLPTraceExporter())] : [],
-    metricReaders: enableMetrics ? [
-      new PeriodicExportingMetricReader({
-        exporter: new OTLPMetricExporter()
-      })
-    ] : [],
-    logRecordProcessors: enableLogging ? [new BatchLogRecordProcessor(new OTLPLogExporter())] : []
-  };
-}
-export {
-  maybeSetOtelProviders
-};