@softactivate/adk 1.1.0

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

@@ -0,0 +1,192 @@
+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 * as path from "node:path";
+import { isLlmAgent } from "../../agents/llm_agent.js";
+import {
+  CodeExecutionLanguage
+} from "../../code_executors/code_execution_utils.js";
+import { experimental } from "../../utils/experimental.js";
+import {
+  getMimeTypeAndEncoding,
+  getScriptLanguageByExtension
+} from "../../utils/file_extension_utils.js";
+import { materializeFiles } from "../../utils/file_utils.js";
+import { BaseTool } from "../base_tool.js";
+let RunSkillScriptTool = class extends BaseTool {
+  constructor(toolset) {
+    super({
+      name: "run_skill_script",
+      description: "Executes a script from a skill's scripts/ directory."
+    });
+    this.toolset = toolset;
+  }
+  _getDeclaration() {
+    return {
+      name: this.name,
+      description: this.description,
+      parameters: {
+        type: Type.OBJECT,
+        properties: {
+          skill_name: {
+            type: Type.STRING,
+            description: "The name of the skill."
+          },
+          script_path: {
+            type: Type.STRING,
+            description: "The relative path to the script (e.g., 'scripts/setup.js')."
+          },
+          args: {
+            type: Type.OBJECT,
+            description: "Optional arguments to pass to the script as key-value pairs."
+          }
+        },
+        required: ["skill_name", "script_path"]
+      }
+    };
+  }
+  async runAsync({
+    args,
+    toolContext
+  }) {
+    var _a, _b, _c, _d;
+    const skillName = args["skill_name"];
+    const scriptPath = args["script_path"];
+    const scriptArgs = args["args"] || {};
+    if (!skillName) {
+      return {
+        error: "Skill name is required.",
+        errorCode: "MISSING_SKILL_NAME"
+      };
+    }
+    if (!scriptPath) {
+      return {
+        error: "Script path is required.",
+        errorCode: "MISSING_SCRIPT_PATH"
+      };
+    }
+    const skill = this.toolset.getSkill(skillName);
+    if (!skill) {
+      return {
+        error: `Skill '${skillName}' not found.`,
+        errorCode: "SKILL_NOT_FOUND"
+      };
+    }
+    const relScriptPath = scriptPath.startsWith("scripts/") ? scriptPath.substring("scripts/".length) : scriptPath;
+    let script = (_b = (_a = skill.resources) == null ? void 0 : _a.scripts) == null ? void 0 : _b[relScriptPath];
+    if (!script) {
+      script = (_d = (_c = skill.resources) == null ? void 0 : _c.scripts) == null ? void 0 : _d[scriptPath];
+    }
+    if (!script) {
+      return {
+        error: `Script '${scriptPath}' not found in skill '${skillName}'.`,
+        errorCode: "SCRIPT_NOT_FOUND"
+      };
+    }
+    let codeExecutor = this.toolset.codeExecutor;
+    if (!codeExecutor) {
+      const agent = toolContext.invocationContext.agent;
+      if (isLlmAgent(agent)) {
+        codeExecutor = agent.codeExecutor;
+      }
+    }
+    if (!codeExecutor) {
+      return {
+        error: "No code executor configured.",
+        errorCode: "NO_CODE_EXECUTOR"
+      };
+    }
+    try {
+      const language = getScriptLanguageByExtension(path.extname(scriptPath));
+      const result = await codeExecutor.executeCode({
+        invocationContext: toolContext.invocationContext,
+        codeExecutionInput: {
+          code: buildWrapperCode(scriptPath, language),
+          inputFiles: getSkillResourceFiles(skill),
+          language,
+          args: scriptArgs
+        }
+      });
+      result.outputFiles = await materializeFiles(result.outputFiles);
+      return result;
+    } catch (e) {
+      return {
+        error: `Failed to execute script '${scriptPath}': ${e.message}`,
+        errorCode: "EXECUTION_ERROR"
+      };
+    }
+  }
+};
+RunSkillScriptTool = __decorateClass([
+  experimental
+], RunSkillScriptTool);
+function buildWrapperCode(scriptPath, language) {
+  switch (language) {
+    case CodeExecutionLanguage.JAVASCRIPT:
+      return `require('./${scriptPath}');`;
+    case CodeExecutionLanguage.TYPESCRIPT:
+      return `require('ts-node/register');
+require('./${scriptPath}');`;
+    case CodeExecutionLanguage.PYTHON:
+      return `import runpy
+runpy.run_path('./${scriptPath}', run_name='__main__')`;
+    case CodeExecutionLanguage.SHELL:
+      return `source ./${scriptPath} "$@"`;
+    case CodeExecutionLanguage.POWERSHELL:
+      return `& .\\${scriptPath.replace(/\//g, "\\\\")} $args`;
+    case CodeExecutionLanguage.WINDOWS_CMD:
+      return `call .\\${scriptPath.replace(/\//g, "\\\\")} %*`;
+    default:
+      throw new Error(`Unsupported wrapper language: ${language}`);
+  }
+}
+function getSkillResourceFiles(skill) {
+  var _a, _b, _c;
+  const files = [];
+  for (const resourceType of ["references", "assets", "scripts"]) {
+    const resources = (_b = (_a = skill.resources) == null ? void 0 : _a[resourceType]) != null ? _b : {};
+    for (const resourceName of Object.keys(resources)) {
+      const content = (_c = resources[resourceName]) != null ? _c : void 0;
+      if (content === void 0) {
+        continue;
+      }
+      let fileContent = void 0;
+      if (typeof content === "string" || Buffer.isBuffer(content)) {
+        fileContent = content;
+      } else if (typeof content === "object" && content !== null && "src" in content && typeof content.src === "string") {
+        fileContent = content.src;
+      }
+      if (fileContent === void 0) {
+        continue;
+      }
+      const ext = path.extname(resourceName).toLowerCase();
+      const { encoding, mimeType } = getMimeTypeAndEncoding(ext);
+      files.push({
+        name: `${resourceType}/${resourceName}`,
+        content: Buffer.from(fileContent).toString(encoding),
+        contentEncoding: encoding,
+        mimeType
+      });
+    }
+  }
+  return files;
+}
+export {
+  RunSkillScriptTool,
+  getSkillResourceFiles
+};

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

@@ -0,0 +1,21 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ToolConfirmation {
+  constructor({
+    hint,
+    confirmed,
+    payload
+  }) {
+    this.hint = hint != null ? hint : "";
+    this.confirmed = confirmed;
+    this.payload = payload;
+  }
+}
+export {
+  ToolConfirmation
+};

package/dist/esm/tools/url_context_tool.js

@@ -0,0 +1,44 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isGemini2OrAbove, isGeminiModel } from "../utils/model_name.js";
+import { BaseTool } from "./base_tool.js";
+class UrlContextTool extends BaseTool {
+  constructor() {
+    super({ name: "url_context", description: "URL Context Tool" });
+  }
+  runAsync() {
+    return Promise.resolve();
+  }
+  async processLlmRequest({
+    llmRequest
+  }) {
+    if (!llmRequest.model) {
+      return;
+    }
+    if (!isGeminiModel(llmRequest.model)) {
+      throw new Error(
+        `URL context tool is not supported for model ${llmRequest.model}`
+      );
+    }
+    if (!isGemini2OrAbove(llmRequest.model)) {
+      throw new Error(
+        `URL context tool requires Gemini 2 or above, but got ${llmRequest.model}`
+      );
+    }
+    llmRequest.config = llmRequest.config || {};
+    llmRequest.config.tools = llmRequest.config.tools || [];
+    llmRequest.config.tools.push({
+      urlContext: {}
+    });
+  }
+}
+const URL_CONTEXT = new UrlContextTool();
+export {
+  URL_CONTEXT,
+  UrlContextTool
+};

package/dist/esm/tools/vertex_ai_search_tool.js

@@ -0,0 +1,103 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getLogger } from "../utils/logger.js";
+import {
+  isGemini1Model,
+  isGeminiModel,
+  isGeminiModelIdCheckDisabled
+} from "../utils/model_name.js";
+import { BaseTool } from "./base_tool.js";
+const logger = getLogger();
+class VertexAiSearchTool extends BaseTool {
+  constructor(params) {
+    super({ name: "vertex_ai_search", description: "vertex_ai_search" });
+    const {
+      dataStoreId,
+      dataStoreSpecs,
+      searchEngineId,
+      filter,
+      maxResults,
+      bypassMultiToolsLimit = false
+    } = params;
+    if (dataStoreId === void 0 && searchEngineId === void 0 || dataStoreId !== void 0 && searchEngineId !== void 0) {
+      throw new Error(
+        "Either dataStoreId or searchEngineId must be specified."
+      );
+    }
+    if (dataStoreSpecs !== void 0 && searchEngineId === void 0) {
+      throw new Error(
+        "searchEngineId must be specified if dataStoreSpecs is specified."
+      );
+    }
+    this.dataStoreId = dataStoreId;
+    this.dataStoreSpecs = dataStoreSpecs;
+    this.searchEngineId = searchEngineId;
+    this.filter = filter;
+    this.maxResults = maxResults;
+    this.bypassMultiToolsLimit = bypassMultiToolsLimit;
+  }
+  runAsync() {
+    return Promise.resolve();
+  }
+  /**
+   * Builds the VertexAISearch configuration.
+   *
+   * Override this method in a subclass to dynamically customize the search
+   * configuration based on the context (e.g., set filter based on session
+   * state).
+   */
+  buildVertexAiSearchConfig(_readonlyContext) {
+    return {
+      datastore: this.dataStoreId,
+      dataStoreSpecs: this.dataStoreSpecs,
+      engine: this.searchEngineId,
+      filter: this.filter,
+      maxResults: this.maxResults
+    };
+  }
+  async processLlmRequest({
+    toolContext,
+    llmRequest
+  }) {
+    if (!llmRequest.model) {
+      return;
+    }
+    const modelCheckDisabled = isGeminiModelIdCheckDisabled();
+    llmRequest.config = llmRequest.config || {};
+    llmRequest.config.tools = llmRequest.config.tools || [];
+    if (!isGeminiModel(llmRequest.model) && !modelCheckDisabled) {
+      throw new Error(
+        `Vertex AI search tool is not supported for model ${llmRequest.model}`
+      );
+    }
+    if (isGemini1Model(llmRequest.model) && llmRequest.config.tools.length > 0 && !this.bypassMultiToolsLimit) {
+      throw new Error(
+        "Vertex AI search tool cannot be used with other tools in Gemini 1.x."
+      );
+    }
+    const vertexAiSearchConfig = this.buildVertexAiSearchConfig(toolContext);
+    let specsInfo;
+    if (vertexAiSearchConfig.dataStoreSpecs) {
+      const specIds = vertexAiSearchConfig.dataStoreSpecs.map(
+        (spec) => spec.dataStore ? spec.dataStore.split("/").pop() : "unnamed"
+      );
+      specsInfo = `${vertexAiSearchConfig.dataStoreSpecs.length} spec(s): [${specIds.join(", ")}]`;
+    }
+    logger.debug(
+      `Adding Vertex AI Search tool config to LLM request: datastore=${vertexAiSearchConfig.datastore}, engine=${vertexAiSearchConfig.engine}, filter=${vertexAiSearchConfig.filter}, maxResults=${vertexAiSearchConfig.maxResults}, dataStoreSpecs=${specsInfo}`
+    );
+    llmRequest.config.tools.push({
+      retrieval: {
+        vertexAiSearch: vertexAiSearchConfig
+      }
+    });
+  }
+}
+export {
+  VertexAiSearchTool
+};

package/dist/esm/tools/vertex_rag_retrieval_tool.js

@@ -0,0 +1,36 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool } from "./base_tool.js";
+class VertexRagRetrievalTool extends BaseTool {
+  constructor(config) {
+    super({
+      name: "vertex_rag_retrieval",
+      description: "Vertex AI RAG Retrieval Tool"
+    });
+    this.vertexRagStore = config;
+  }
+  /**
+   * This tool is executed server-side by the Vertex AI RAG Engine.
+   * Local execution is not required.
+   */
+  runAsync() {
+    return Promise.resolve();
+  }
+  async processLlmRequest({
+    llmRequest
+  }) {
+    llmRequest.config = llmRequest.config || {};
+    llmRequest.config.tools = llmRequest.config.tools || [];
+    llmRequest.config.tools.push({
+      retrieval: { vertexRagStore: this.vertexRagStore }
+    });
+  }
+}
+export {
+  VertexRagRetrievalTool
+};

package/dist/esm/utils/client_labels.js

@@ -0,0 +1,28 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { version } from "../version.js";
+import { isBrowser } from "./env_aware_utils.js";
+const ADK_LABEL = "google-adk";
+const LANGUAGE_LABEL = "gl-typescript";
+const AGENT_ENGINE_TELEMETRY_TAG = "remote_reasoning_engine";
+const AGENT_ENGINE_TELEMETRY_ENV_VARIABLE_NAME = "GOOGLE_CLOUD_AGENT_ENGINE_ID";
+function _getDefaultLabels() {
+  let frameworkLabel = `${ADK_LABEL}/${version}`;
+  if (!isBrowser() && process.env[AGENT_ENGINE_TELEMETRY_ENV_VARIABLE_NAME]) {
+    frameworkLabel = `${frameworkLabel}+${AGENT_ENGINE_TELEMETRY_TAG}`;
+  }
+  const languageLabel = `${LANGUAGE_LABEL}/${isBrowser() ? window.navigator.userAgent : process.version}`;
+  return [frameworkLabel, languageLabel];
+}
+function getClientLabels() {
+  const labels = _getDefaultLabels();
+  return labels;
+}
+export {
+  getClientLabels
+};

package/dist/esm/utils/env_aware_utils.js

@@ -0,0 +1,59 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+const UUID_MASK = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx";
+function randomUUID() {
+  let uuid = "";
+  for (let i = 0; i < UUID_MASK.length; i++) {
+    const randomValue = Math.random() * 16 | 0;
+    if (UUID_MASK[i] === "x") {
+      uuid += randomValue.toString(16);
+    } else if (UUID_MASK[i] === "y") {
+      uuid += (randomValue & 3 | 8).toString(16);
+    } else {
+      uuid += UUID_MASK[i];
+    }
+  }
+  return uuid;
+}
+function base64Encode(data) {
+  if (isBrowser()) {
+    return window.btoa(data);
+  }
+  return Buffer.from(data).toString("base64");
+}
+function base64Decode(data) {
+  if (isBrowser()) {
+    return window.atob(data);
+  }
+  return Buffer.from(data, "base64").toString();
+}
+function isBase64Encoded(data) {
+  try {
+    return base64Encode(base64Decode(data)) === data;
+  } catch (_e) {
+    return false;
+  }
+}
+function getBooleanEnvVar(envVar) {
+  if (!process.env) {
+    return false;
+  }
+  const envVarValue = (process.env[envVar] || "").toLowerCase();
+  return ["true", "1"].includes(envVarValue);
+}
+export {
+  base64Decode,
+  base64Encode,
+  getBooleanEnvVar,
+  isBase64Encoded,
+  isBrowser,
+  randomUUID
+};

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
+};