@softactivate/adk 1.1.0

package/dist/esm/tools/preload_memory_tool.js

@@ -0,0 +1,82 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { appendInstructions } from "../models/llm_request.js";
+import { logger } from "../utils/logger.js";
+import {
+  BaseTool
+} from "./base_tool.js";
+class PreloadMemoryTool extends BaseTool {
+  constructor() {
+    super({
+      // Name and description are not used because this tool only
+      // changes llm_request.
+      name: "preload_memory",
+      description: "preload_memory"
+    });
+  }
+  async runAsync({
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    args,
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    toolContext
+  }) {
+    throw new Error("PreloadMemoryTool should not be called by model");
+  }
+  async processLlmRequest(request) {
+    var _a, _b, _c;
+    await super.processLlmRequest(request);
+    const userContent = request.toolContext.userContent;
+    if (!userContent || !userContent.parts || !((_a = userContent.parts[0]) == null ? void 0 : _a.text)) {
+      return;
+    }
+    const userQuery = userContent.parts[0].text;
+    let response;
+    try {
+      if (!request.toolContext.invocationContext.memoryService) {
+        return;
+      }
+      response = await request.toolContext.searchMemory(userQuery);
+    } catch (_) {
+      logger.warn(`Failed to preload memory for query: ${userQuery}`);
+      return;
+    }
+    if (!response.memories || response.memories.length === 0) {
+      return;
+    }
+    const memoryTextLines = [];
+    for (const memory of response.memories) {
+      const timeStr = memory.timestamp ? `Time: ${memory.timestamp}` : "";
+      if (timeStr) memoryTextLines.push(timeStr);
+      const memoryText = (_c = (_b = memory.content.parts) == null ? void 0 : _b.map((p) => {
+        var _a2;
+        return (_a2 = p.text) != null ? _a2 : "";
+      }).join(" ")) != null ? _c : "";
+      if (memoryText) {
+        memoryTextLines.push(
+          memory.author ? `${memory.author}: ${memoryText}` : memoryText
+        );
+      }
+    }
+    if (memoryTextLines.length === 0) {
+      return;
+    }
+    const fullMemoryText = memoryTextLines.join("\n");
+    const si = `The following content is from your previous conversations with the user.
+They may be useful for answering the user's current query.
+<PAST_CONVERSATIONS>
+${fullMemoryText}
+</PAST_CONVERSATIONS>
+`;
+    appendInstructions(request.llmRequest, [si]);
+  }
+}
+const PRELOAD_MEMORY = new PreloadMemoryTool();
+export {
+  PRELOAD_MEMORY,
+  PreloadMemoryTool
+};

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

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

@@ -0,0 +1,191 @@
+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 path from "node:path";
+import { experimental } from "../../utils/experimental.js";
+import {
+  BaseTool
+} from "../base_tool.js";
+const BINARY_FILE_DETECTED_MSG = "Binary file detected. The content has been injected into the conversation history for you to analyze.";
+const EXTENSION_TO_MIME_TYPE = {
+  "pdf": "application/pdf",
+  "jpg": "image/jpeg",
+  "jpeg": "image/jpeg",
+  "png": "image/png",
+  "gif": "image/gif",
+  "csv": "text/csv",
+  "json": "application/json",
+  "xml": "application/xml",
+  "sh": "text/x-shellscript",
+  "bash": "text/x-shellscript",
+  "py": "text/x-python",
+  "js": "text/javascript",
+  "cjs": "text/javascript",
+  "mjs": "text/javascript",
+  "ts": "text/javascript",
+  "cts": "text/javascript",
+  "mts": "text/javascript"
+};
+function guessMimeType(filePath) {
+  var _a;
+  const ext = ((_a = filePath.split(".").pop()) == null ? void 0 : _a.toLowerCase()) || "";
+  return EXTENSION_TO_MIME_TYPE[ext] || "application/octet-stream";
+}
+let LoadSkillResourceTool = class extends BaseTool {
+  constructor(toolset) {
+    super({
+      name: "load_skill_resource",
+      description: "Loads a resource file (from references/, assets/, or scripts/) from within a skill."
+    });
+    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."
+          },
+          path: {
+            type: Type.STRING,
+            description: "The relative path to the resource (e.g., 'references/my_doc.md', 'assets/template.txt', or 'scripts/setup.sh')."
+          }
+        },
+        required: ["skill_name", "path"]
+      }
+    };
+  }
+  async runAsync({ args }) {
+    var _a, _b, _c;
+    const skillName = args["skill_name"];
+    let resourcePath = args["path"];
+    if (!skillName) {
+      return {
+        error: "Skill name is required.",
+        error_code: "MISSING_SKILL_NAME"
+      };
+    }
+    if (!resourcePath) {
+      return {
+        error: "Resource path is required.",
+        error_code: "MISSING_RESOURCE_PATH"
+      };
+    }
+    resourcePath = path.posix.normalize(resourcePath);
+    const skill = this.toolset.getSkill(skillName);
+    if (!skill) {
+      return {
+        error: `Skill '${skillName}' not found.`,
+        error_code: "SKILL_NOT_FOUND"
+      };
+    }
+    let content;
+    const skillResources = skill.resources || {};
+    if (resourcePath.startsWith("references/")) {
+      const refName = resourcePath.substring("references/".length);
+      content = (_a = skillResources.references) == null ? void 0 : _a[refName];
+    } else if (resourcePath.startsWith("assets/")) {
+      const assetName = resourcePath.substring("assets/".length);
+      content = (_b = skillResources.assets) == null ? void 0 : _b[assetName];
+    } else if (resourcePath.startsWith("scripts/")) {
+      const scriptName = resourcePath.substring("scripts/".length);
+      const script = (_c = skillResources.scripts) == null ? void 0 : _c[scriptName];
+      if (script) {
+        content = script.src;
+      }
+    } else {
+      return {
+        error: "Path must start with 'references/', 'assets/', or 'scripts/'.",
+        error_code: "INVALID_RESOURCE_PATH"
+      };
+    }
+    if (content === void 0) {
+      return {
+        error: `Resource '${resourcePath}' not found in skill '${skillName}'.`,
+        error_code: "RESOURCE_NOT_FOUND"
+      };
+    }
+    if (Buffer.isBuffer(content)) {
+      return {
+        skill_name: skillName,
+        path: resourcePath,
+        status: BINARY_FILE_DETECTED_MSG
+      };
+    }
+    return {
+      skill_name: skillName,
+      path: resourcePath,
+      content
+    };
+  }
+  async processLlmRequest(request) {
+    var _a, _b;
+    await super.processLlmRequest(request);
+    const llmRequest = request.llmRequest;
+    if (!llmRequest.contents || llmRequest.contents.length === 0) {
+      return;
+    }
+    const lastContent = llmRequest.contents[llmRequest.contents.length - 1];
+    if (lastContent.role !== "user" || !lastContent.parts) {
+      return;
+    }
+    for (const part of lastContent.parts) {
+      if (part.functionResponse && part.functionResponse.name === this.name) {
+        const response = part.functionResponse.response || {};
+        if (response["status"] === BINARY_FILE_DETECTED_MSG) {
+          const skillName = response["skill_name"];
+          const resourcePath = response["path"];
+          const skill = this.toolset.getSkill(skillName);
+          if (!skill) continue;
+          const skillResources = skill.resources || {};
+          let content;
+          if (resourcePath.startsWith("references/")) {
+            content = (_a = skillResources.references) == null ? void 0 : _a[resourcePath.substring("references/".length)];
+          } else if (resourcePath.startsWith("assets/")) {
+            content = (_b = skillResources.assets) == null ? void 0 : _b[resourcePath.substring("assets/".length)];
+          }
+          if (Buffer.isBuffer(content)) {
+            const mimeType = guessMimeType(resourcePath);
+            llmRequest.contents.push({
+              role: "user",
+              parts: [
+                { text: `The content of binary file '${resourcePath}' is:` },
+                {
+                  inlineData: {
+                    data: content.toString("base64"),
+                    mimeType
+                  }
+                }
+              ]
+            });
+          }
+        }
+      }
+    }
+  }
+};
+LoadSkillResourceTool = __decorateClass([
+  experimental
+], LoadSkillResourceTool);
+export {
+  LoadSkillResourceTool
+};

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

@@ -0,0 +1,82 @@
+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 { experimental } from "../../utils/experimental.js";
+import { BaseTool } from "../base_tool.js";
+let LoadSkillTool = class extends BaseTool {
+  constructor(toolset) {
+    super({
+      name: "load_skill",
+      description: "Loads the SKILL.md instructions for a given skill."
+    });
+    this.toolset = toolset;
+  }
+  _getDeclaration() {
+    return {
+      name: this.name,
+      description: this.description,
+      parameters: {
+        type: Type.OBJECT,
+        properties: {
+          name: {
+            type: Type.STRING,
+            description: "The name of the skill to load."
+          }
+        },
+        required: ["name"]
+      }
+    };
+  }
+  async runAsync({
+    args,
+    toolContext
+  }) {
+    const skillName = args["name"];
+    if (!skillName) {
+      return {
+        error: "Skill name is required.",
+        error_code: "MISSING_SKILL_NAME"
+      };
+    }
+    const skill = this.toolset.getSkill(skillName);
+    if (!skill) {
+      return {
+        error: `Skill '${skillName}' not found.`,
+        error_code: "SKILL_NOT_FOUND"
+      };
+    }
+    const agentName = toolContext.invocationContext.agent.name;
+    const stateKey = `_adk_activated_skill_${agentName}`;
+    const currentActivated = toolContext.state.get(stateKey) || [];
+    if (!currentActivated.includes(skillName)) {
+      toolContext.state.set(stateKey, [...currentActivated, skillName]);
+    }
+    return {
+      skill_name: skillName,
+      instructions: skill.instructions,
+      frontmatter: skill.frontmatter,
+      resources: skill.resources
+    };
+  }
+};
+LoadSkillTool = __decorateClass([
+  experimental
+], LoadSkillTool);
+export {
+  LoadSkillTool
+};

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

@@ -0,0 +1,120 @@
+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 { isLlmAgent } from "../../agents/llm_agent.js";
+import { CodeExecutionLanguage } from "../../code_executors/code_execution_utils.js";
+import { experimental } from "../../utils/experimental.js";
+import { materializeFiles } from "../../utils/file_utils.js";
+import { BaseTool } from "../base_tool.js";
+let RunSkillInlineScriptTool = class extends BaseTool {
+  constructor(toolset) {
+    super({
+      name: "run_skill_inline_script",
+      description: "Executes an inline script provided directly in the request."
+    });
+    this.toolset = toolset;
+  }
+  _getDeclaration() {
+    return {
+      name: this.name,
+      description: this.description,
+      parameters: {
+        type: Type.OBJECT,
+        properties: {
+          script_content: {
+            type: Type.STRING,
+            description: "The content of the script to execute."
+          },
+          language: {
+            type: Type.STRING,
+            description: "The language/type of the script.",
+            enum: Object.values(CodeExecutionLanguage).filter(
+              (l) => l !== CodeExecutionLanguage.UNSPECIFIED
+            )
+          },
+          args: {
+            anyOf: [
+              { type: Type.OBJECT },
+              { type: Type.ARRAY, items: { type: Type.STRING } }
+            ],
+            description: "Optional arguments to pass to the script as key-value pairs or an array of strings."
+          }
+        },
+        required: ["script_content", "language"]
+      }
+    };
+  }
+  async runAsync({
+    args,
+    toolContext
+  }) {
+    var _a;
+    const inlineScriptContent = args["script_content"];
+    const language = args["language"];
+    const scriptArgs = args["args"];
+    if (!inlineScriptContent) {
+      return {
+        error: "Script content is required.",
+        errorCode: "MISSING_SCRIPT_CONTENT"
+      };
+    }
+    if (!language) {
+      return {
+        error: "Language is required.",
+        errorCode: "MISSING_LANGUAGE"
+      };
+    }
+    let codeExecutor = (_a = this.toolset) == null ? void 0 : _a.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 result = await codeExecutor.executeCode({
+        invocationContext: toolContext.invocationContext,
+        codeExecutionInput: {
+          code: inlineScriptContent,
+          inputFiles: [],
+          language,
+          args: scriptArgs
+        }
+      });
+      result.outputFiles = await materializeFiles(result.outputFiles);
+      return result;
+    } catch (e) {
+      return {
+        error: `Failed to execute inline script: ${e.message}`,
+        errorCode: "EXECUTION_ERROR"
+      };
+    }
+  }
+};
+RunSkillInlineScriptTool = __decorateClass([
+  experimental
+], RunSkillInlineScriptTool);
+export {
+  RunSkillInlineScriptTool
+};