@google/adk 0.1.0

package/dist/cjs/common.js

@@ -0,0 +1,161 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var common_exports = {};
+__export(common_exports, {
+  AgentTool: () => import_agent_tool.AgentTool,
+  BaseAgent: () => import_base_agent.BaseAgent,
+  BaseLlm: () => import_base_llm.BaseLlm,
+  BasePlugin: () => import_base_plugin.BasePlugin,
+  BaseTool: () => import_base_tool.BaseTool,
+  BaseToolset: () => import_base_toolset.BaseToolset,
+  CallbackContext: () => import_callback_context.CallbackContext,
+  FunctionTool: () => import_function_tool.FunctionTool,
+  GOOGLE_SEARCH: () => import_google_search_tool.GOOGLE_SEARCH,
+  InMemoryArtifactService: () => import_in_memory_artifact_service.InMemoryArtifactService,
+  InMemoryMemoryService: () => import_in_memory_memory_service.InMemoryMemoryService,
+  InMemoryPolicyEngine: () => import_security_plugin.InMemoryPolicyEngine,
+  InMemoryRunner: () => import_in_memory_runner.InMemoryRunner,
+  InMemorySessionService: () => import_in_memory_session_service.InMemorySessionService,
+  InvocationContext: () => import_invocation_context.InvocationContext,
+  LiveRequestQueue: () => import_live_request_queue.LiveRequestQueue,
+  LlmAgent: () => import_llm_agent.LlmAgent,
+  LogLevel: () => import_logger.LogLevel,
+  LoggingPlugin: () => import_logging_plugin.LoggingPlugin,
+  LongRunningFunctionTool: () => import_long_running_tool.LongRunningFunctionTool,
+  LoopAgent: () => import_loop_agent.LoopAgent,
+  ParallelAgent: () => import_parallel_agent.ParallelAgent,
+  PluginManager: () => import_plugin_manager.PluginManager,
+  PolicyOutcome: () => import_security_plugin.PolicyOutcome,
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: () => import_security_plugin.REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  RunConfig: () => import_run_config.RunConfig,
+  Runner: () => import_runner.Runner,
+  SecurityPlugin: () => import_security_plugin.SecurityPlugin,
+  SequentialAgent: () => import_sequential_agent.SequentialAgent,
+  StreamingMode: () => import_run_config.StreamingMode,
+  ToolConfirmation: () => import_tool_confirmation.ToolConfirmation,
+  ToolContext: () => import_tool_context.ToolContext,
+  createEvent: () => import_event.createEvent,
+  createSession: () => import_session.createSession,
+  functionsExportedForTestingOnly: () => import_functions.functionsExportedForTestingOnly,
+  getAskUserConfirmationFunctionCalls: () => import_security_plugin.getAskUserConfirmationFunctionCalls,
+  getFunctionCalls: () => import_event.getFunctionCalls,
+  getFunctionResponses: () => import_event.getFunctionResponses,
+  hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
+  isFinalResponse: () => import_event.isFinalResponse,
+  setLogLevel: () => import_logger.setLogLevel,
+  zodObjectToSchema: () => import_simple_zod_to_json.zodObjectToSchema
+});
+module.exports = __toCommonJS(common_exports);
+var import_base_agent = require("./agents/base_agent.js");
+var import_callback_context = require("./agents/callback_context.js");
+var import_functions = require("./agents/functions.js");
+var import_invocation_context = require("./agents/invocation_context.js");
+var import_live_request_queue = require("./agents/live_request_queue.js");
+var import_llm_agent = require("./agents/llm_agent.js");
+var import_loop_agent = require("./agents/loop_agent.js");
+var import_parallel_agent = require("./agents/parallel_agent.js");
+var import_run_config = require("./agents/run_config.js");
+var import_sequential_agent = require("./agents/sequential_agent.js");
+var import_in_memory_artifact_service = require("./artifacts/in_memory_artifact_service.js");
+var import_event = require("./events/event.js");
+var import_in_memory_memory_service = require("./memory/in_memory_memory_service.js");
+var import_base_llm = require("./models/base_llm.js");
+var import_base_plugin = require("./plugins/base_plugin.js");
+var import_logging_plugin = require("./plugins/logging_plugin.js");
+var import_plugin_manager = require("./plugins/plugin_manager.js");
+var import_security_plugin = require("./plugins/security_plugin.js");
+var import_in_memory_runner = require("./runner/in_memory_runner.js");
+var import_runner = require("./runner/runner.js");
+var import_in_memory_session_service = require("./sessions/in_memory_session_service.js");
+var import_session = require("./sessions/session.js");
+var import_agent_tool = require("./tools/agent_tool.js");
+var import_base_tool = require("./tools/base_tool.js");
+var import_base_toolset = require("./tools/base_toolset.js");
+var import_function_tool = require("./tools/function_tool.js");
+var import_google_search_tool = require("./tools/google_search_tool.js");
+var import_long_running_tool = require("./tools/long_running_tool.js");
+var import_tool_confirmation = require("./tools/tool_confirmation.js");
+var import_tool_context = require("./tools/tool_context.js");
+var import_logger = require("./utils/logger.js");
+var import_simple_zod_to_json = require("./utils/simple_zod_to_json.js");
+__reExport(common_exports, require("./artifacts/base_artifact_service.js"), module.exports);
+__reExport(common_exports, require("./memory/base_memory_service.js"), module.exports);
+__reExport(common_exports, require("./sessions/base_session_service.js"), module.exports);
+__reExport(common_exports, require("./tools/base_tool.js"), module.exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentTool,
+  BaseAgent,
+  BaseLlm,
+  BasePlugin,
+  BaseTool,
+  BaseToolset,
+  CallbackContext,
+  FunctionTool,
+  GOOGLE_SEARCH,
+  InMemoryArtifactService,
+  InMemoryMemoryService,
+  InMemoryPolicyEngine,
+  InMemoryRunner,
+  InMemorySessionService,
+  InvocationContext,
+  LiveRequestQueue,
+  LlmAgent,
+  LogLevel,
+  LoggingPlugin,
+  LongRunningFunctionTool,
+  LoopAgent,
+  ParallelAgent,
+  PluginManager,
+  PolicyOutcome,
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  RunConfig,
+  Runner,
+  SecurityPlugin,
+  SequentialAgent,
+  StreamingMode,
+  ToolConfirmation,
+  ToolContext,
+  createEvent,
+  createSession,
+  functionsExportedForTestingOnly,
+  getAskUserConfirmationFunctionCalls,
+  getFunctionCalls,
+  getFunctionResponses,
+  hasTrailingCodeExecutionResult,
+  isFinalResponse,
+  setLogLevel,
+  zodObjectToSchema,
+  ...require("./artifacts/base_artifact_service.js"),
+  ...require("./memory/base_memory_service.js"),
+  ...require("./sessions/base_session_service.js"),
+  ...require("./tools/base_tool.js")
+});

package/dist/cjs/events/event.js

@@ -0,0 +1,107 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var event_exports = {};
+__export(event_exports, {
+  createEvent: () => createEvent,
+  createNewEventId: () => createNewEventId,
+  getFunctionCalls: () => getFunctionCalls,
+  getFunctionResponses: () => getFunctionResponses,
+  hasTrailingCodeExecutionResult: () => hasTrailingCodeExecutionResult,
+  isFinalResponse: () => isFinalResponse
+});
+module.exports = __toCommonJS(event_exports);
+var import_event_actions = require("./event_actions.js");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function createEvent(params = {}) {
+  return {
+    ...params,
+    id: params.id || createNewEventId(),
+    invocationId: params.invocationId || "",
+    author: params.author,
+    actions: params.actions || (0, import_event_actions.createEventActions)(),
+    longRunningToolIds: params.longRunningToolIds || [],
+    branch: params.branch,
+    timestamp: params.timestamp || Date.now()
+  };
+}
+function isFinalResponse(event) {
+  if (event.actions.skipSummarization || event.longRunningToolIds && event.longRunningToolIds.length > 0) {
+    return true;
+  }
+  return getFunctionCalls(event).length === 0 && getFunctionResponses(event).length === 0 && !event.partial && !hasTrailingCodeExecutionResult(event);
+}
+function getFunctionCalls(event) {
+  const funcCalls = [];
+  if (event.content && event.content.parts) {
+    for (const part of event.content.parts) {
+      if (part.functionCall) {
+        funcCalls.push(part.functionCall);
+      }
+    }
+  }
+  return funcCalls;
+}
+function getFunctionResponses(event) {
+  const funcResponses = [];
+  if (event.content && event.content.parts) {
+    for (const part of event.content.parts) {
+      if (part.functionResponse) {
+        funcResponses.push(part.functionResponse);
+      }
+    }
+  }
+  return funcResponses;
+}
+function hasTrailingCodeExecutionResult(event) {
+  var _a;
+  if (event.content && ((_a = event.content.parts) == null ? void 0 : _a.length)) {
+    const lastPart = event.content.parts[event.content.parts.length - 1];
+    return lastPart.codeExecutionResult !== void 0;
+  }
+  return false;
+}
+const ASCII_LETTERS_AND_NUMBERS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+function createNewEventId() {
+  let id = "";
+  for (let i = 0; i < 8; i++) {
+    id += ASCII_LETTERS_AND_NUMBERS[Math.floor(
+      Math.random() * ASCII_LETTERS_AND_NUMBERS.length
+    )];
+  }
+  return id;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEvent,
+  createNewEventId,
+  getFunctionCalls,
+  getFunctionResponses,
+  hasTrailingCodeExecutionResult,
+  isFinalResponse
+});

package/dist/cjs/events/event_actions.js

@@ -0,0 +1,83 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var event_actions_exports = {};
+__export(event_actions_exports, {
+  createEventActions: () => createEventActions,
+  mergeEventActions: () => mergeEventActions
+});
+module.exports = __toCommonJS(event_actions_exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function createEventActions(state = {}) {
+  return {
+    stateDelta: {},
+    artifactDelta: {},
+    requestedAuthConfigs: {},
+    requestedToolConfirmations: {},
+    ...state
+  };
+}
+function mergeEventActions(sources, target) {
+  const result = createEventActions();
+  if (target) {
+    Object.assign(result, target);
+  }
+  for (const source of sources) {
+    if (!source) continue;
+    if (source.stateDelta) {
+      Object.assign(result.stateDelta, source.stateDelta);
+    }
+    if (source.artifactDelta) {
+      Object.assign(result.artifactDelta, source.artifactDelta);
+    }
+    if (source.requestedAuthConfigs) {
+      Object.assign(result.requestedAuthConfigs, source.requestedAuthConfigs);
+    }
+    if (source.requestedToolConfirmations) {
+      Object.assign(
+        result.requestedToolConfirmations,
+        source.requestedToolConfirmations
+      );
+    }
+    if (source.skipSummarization !== void 0) {
+      result.skipSummarization = source.skipSummarization;
+    }
+    if (source.transferToAgent !== void 0) {
+      result.transferToAgent = source.transferToAgent;
+    }
+    if (source.escalate !== void 0) {
+      result.escalate = source.escalate;
+    }
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEventActions,
+  mergeEventActions
+});

package/dist/cjs/examples/base_example_provider.js

@@ -0,0 +1,40 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_example_provider_exports = {};
+__export(base_example_provider_exports, {
+  BaseExampleProvider: () => BaseExampleProvider
+});
+module.exports = __toCommonJS(base_example_provider_exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class BaseExampleProvider {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseExampleProvider
+});

package/dist/cjs/examples/example.js

@@ -0,0 +1,27 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var example_exports = {};
+module.exports = __toCommonJS(example_exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/cjs/examples/example_util.js

@@ -0,0 +1,107 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var example_util_exports = {};
+__export(example_util_exports, {
+  buildExampleSi: () => buildExampleSi,
+  convertExamplesToText: () => convertExamplesToText
+});
+module.exports = __toCommonJS(example_util_exports);
+var import_base_example_provider = require("./base_example_provider.js");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const EXAMPLES_INTRO = "<EXAMPLES>\nBegin few-shot\nThe following are examples of user queries and model responses using the available tools.\n\n";
+const EXAMPLES_END = "End few-shot\n<EXAMPLES>";
+const EXAMPLE_START = "EXAMPLE {}:\nBegin example\n";
+const EXAMPLE_END = "End example\n\n";
+const USER_PREFIX = "[user]\n";
+const MODEL_PREFIX = "[model]\n";
+const FUNCTION_PREFIX = "```\n";
+const FUNCTION_CALL_PREFIX = "```tool_code\n";
+const FUNCTION_CALL_SUFFIX = "\n```\n";
+const FUNCTION_RESPONSE_PREFIX = "```tool_outputs\n";
+const FUNCTION_RESPONSE_SUFFIX = "\n```\n";
+function convertExamplesToText(examples, model) {
+  var _a;
+  let examplesStr = "";
+  for (const [exampleNum, example] of examples.entries()) {
+    let output = `${EXAMPLE_START.replace("{}", String(exampleNum + 1))}${USER_PREFIX}`;
+    if ((_a = example.input) == null ? void 0 : _a.parts) {
+      output += example.input.parts.filter((part) => part.text).map((part) => part.text).join("\n") + "\n";
+    }
+    const gemini2 = !model || model.includes("gemini-2");
+    let previousRole;
+    for (const content of example.output) {
+      const role = content.role === "model" ? MODEL_PREFIX : USER_PREFIX;
+      if (role !== previousRole) {
+        output += role;
+      }
+      previousRole = role;
+      for (const part of content.parts || []) {
+        if (part.functionCall) {
+          const prefix = gemini2 ? FUNCTION_PREFIX : FUNCTION_CALL_PREFIX;
+          const functionCall = part.functionCall;
+          const args = [];
+          if (functionCall.args) {
+            for (const [k, v] of Object.entries(functionCall.args)) {
+              if (typeof v === "string") {
+                args.push(`${k}='${v}'`);
+              } else {
+                args.push(`${k}=${v}`);
+              }
+            }
+          }
+          const functionCallString = `${functionCall.name}(${args.join(", ")})`;
+          output += `${prefix}${functionCallString}${FUNCTION_CALL_SUFFIX}`;
+        } else if (part.functionResponse) {
+          const prefix = gemini2 ? FUNCTION_PREFIX : FUNCTION_RESPONSE_PREFIX;
+          output += `${prefix}${JSON.stringify(part.functionResponse)}${FUNCTION_RESPONSE_SUFFIX}`;
+        } else if (part.text) {
+          output += `${part.text}
+`;
+        }
+      }
+    }
+    output += EXAMPLE_END;
+    examplesStr += output;
+  }
+  return `${EXAMPLES_INTRO}${examplesStr}${EXAMPLES_END}`;
+}
+function buildExampleSi(examples, query, model) {
+  if (Array.isArray(examples)) {
+    return convertExamplesToText(examples, model);
+  }
+  if (examples instanceof import_base_example_provider.BaseExampleProvider) {
+    return convertExamplesToText(examples.getExamples(query), model);
+  }
+  throw new Error("Invalid example configuration");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildExampleSi,
+  convertExamplesToText
+});