@paean-ai/adk 0.2.18 → 0.2.20

package/dist/esm/utils/logger.js

@@ -0,0 +1,89 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  return LogLevel2;
+})(LogLevel || {});
+let logLevel = 1 /* INFO */;
+function setLogLevel(level) {
+  logLevel = level;
+}
+class SimpleLogger {
+  log(level, ...args) {
+    if (level < logLevel) {
+      return;
+    }
+    switch (level) {
+      case 0 /* DEBUG */:
+        this.debug(...args);
+        break;
+      case 1 /* INFO */:
+        this.info(...args);
+        break;
+      case 2 /* WARN */:
+        this.warn(...args);
+        break;
+      case 3 /* ERROR */:
+        this.error(...args);
+        break;
+      default:
+        throw new Error(`Unsupported log level: ${level}`);
+    }
+  }
+  debug(...args) {
+    if (logLevel > 0 /* DEBUG */) {
+      return;
+    }
+    console.debug(getColoredPrefix(0 /* DEBUG */), ...args);
+  }
+  info(...args) {
+    if (logLevel > 1 /* INFO */) {
+      return;
+    }
+    console.info(getColoredPrefix(1 /* INFO */), ...args);
+  }
+  warn(...args) {
+    if (logLevel > 2 /* WARN */) {
+      return;
+    }
+    console.warn(getColoredPrefix(2 /* WARN */), ...args);
+  }
+  error(...args) {
+    if (logLevel > 3 /* ERROR */) {
+      return;
+    }
+    console.error(getColoredPrefix(3 /* ERROR */), ...args);
+  }
+}
+const LOG_LEVEL_STR = {
+  [0 /* DEBUG */]: "DEBUG",
+  [1 /* INFO */]: "INFO",
+  [2 /* WARN */]: "WARN",
+  [3 /* ERROR */]: "ERROR"
+};
+const CONSOLE_COLOR_MAP = {
+  [0 /* DEBUG */]: "\x1B[34m",
+  // Blue
+  [1 /* INFO */]: "\x1B[32m",
+  // Green
+  [2 /* WARN */]: "\x1B[33m",
+  // Yellow
+  [3 /* ERROR */]: "\x1B[31m"
+  // Red
+};
+const RESET_COLOR = "\x1B[0m";
+function getColoredPrefix(level) {
+  return `${CONSOLE_COLOR_MAP[level]}[ADK ${LOG_LEVEL_STR[level]}]:${RESET_COLOR}`;
+}
+const logger = new SimpleLogger();
+export {
+  LogLevel,
+  logger,
+  setLogLevel
+};

package/dist/esm/utils/model_name.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const MODEL_NAME_PATTERN = "^projects/[^/]+/locations/[^/]+/publishers/[^/]+/models/(.+)$";
+function extractModelName(modelString) {
+  const match = modelString.match(MODEL_NAME_PATTERN);
+  if (match) {
+    return match[1];
+  }
+  return modelString;
+}
+function isGeminiModel(modelString) {
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-");
+}
+function isGemini1Model(modelString) {
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-1");
+}
+function isGemini2Model(modelString) {
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-2");
+}
+function isGemini3Model(modelString) {
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-3");
+}
+function isGemini3PreviewModel(modelString) {
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-3") && modelName.includes("preview");
+}
+export {
+  extractModelName,
+  isGemini1Model,
+  isGemini2Model,
+  isGemini3Model,
+  isGemini3PreviewModel,
+  isGeminiModel
+};

package/dist/esm/utils/simple_zod_to_json.js

@@ -0,0 +1,160 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Type } from "@google/genai";
+import { z } from "zod";
+function isZodObject(obj) {
+  var _a;
+  return obj !== null && typeof obj === "object" && ((_a = obj._def) == null ? void 0 : _a.typeName) === "ZodObject";
+}
+function parseZodType(zodType) {
+  const def = zodType._def;
+  if (!def) {
+    return {};
+  }
+  const description = def.description;
+  const result = {};
+  if (description) result.description = description;
+  const returnResult = (result2) => {
+    if (result2.description === void 0) {
+      delete result2.description;
+    }
+    return result2;
+  };
+  switch (def.typeName) {
+    case z.ZodFirstPartyTypeKind.ZodString:
+      result.type = Type.STRING;
+      for (const check of def.checks || []) {
+        if (check.kind === "min")
+          result.minLength = check.value.toString();
+        else if (check.kind === "max")
+          result.maxLength = check.value.toString();
+        else if (check.kind === "email")
+          result.format = "email";
+        else if (check.kind === "uuid")
+          result.format = "uuid";
+        else if (check.kind === "url")
+          result.format = "uri";
+        else if (check.kind === "regex")
+          result.pattern = check.regex.source;
+      }
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodNumber:
+      result.type = Type.NUMBER;
+      for (const check of def.checks || []) {
+        if (check.kind === "min")
+          result.minimum = check.value;
+        else if (check.kind === "max")
+          result.maximum = check.value;
+        else if (check.kind === "int")
+          result.type = Type.INTEGER;
+      }
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodBoolean:
+      result.type = Type.BOOLEAN;
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodArray:
+      result.type = Type.ARRAY;
+      result.items = parseZodType(def.type);
+      if (def.minLength) result.minItems = def.minLength.value.toString();
+      if (def.maxLength) result.maxItems = def.maxLength.value.toString();
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodObject: {
+      const nestedSchema = zodObjectToSchema(zodType);
+      return nestedSchema;
+    }
+    case z.ZodFirstPartyTypeKind.ZodLiteral:
+      const literalType = typeof def.value;
+      result.enum = [def.value.toString()];
+      if (literalType === "string") {
+        result.type = Type.STRING;
+      } else if (literalType === "number") {
+        result.type = Type.NUMBER;
+      } else if (literalType === "boolean") {
+        result.type = Type.BOOLEAN;
+      } else if (def.value === null) {
+        result.type = Type.NULL;
+      } else {
+        throw new Error(`Unsupported ZodLiteral value type: ${literalType}`);
+      }
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodEnum:
+      result.type = Type.STRING;
+      result.enum = def.values;
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodNativeEnum:
+      result.type = Type.STRING;
+      result.enum = Object.values(def.values);
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodUnion:
+      result.anyOf = def.options.map(parseZodType);
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodOptional:
+      return parseZodType(def.innerType);
+    case z.ZodFirstPartyTypeKind.ZodNullable:
+      const nullableInner = parseZodType(def.innerType);
+      return nullableInner ? returnResult({
+        anyOf: [nullableInner, { type: Type.NULL }],
+        ...description && { description }
+      }) : returnResult({ type: Type.NULL, ...description && { description } });
+    case z.ZodFirstPartyTypeKind.ZodDefault:
+      const defaultInner = parseZodType(def.innerType);
+      if (defaultInner) defaultInner.default = def.defaultValue();
+      return defaultInner;
+    case z.ZodFirstPartyTypeKind.ZodBranded:
+      return parseZodType(def.type);
+    case z.ZodFirstPartyTypeKind.ZodReadonly:
+      return parseZodType(def.innerType);
+    case z.ZodFirstPartyTypeKind.ZodNull:
+      result.type = Type.NULL;
+      return returnResult(result);
+    case z.ZodFirstPartyTypeKind.ZodAny:
+    case z.ZodFirstPartyTypeKind.ZodUnknown:
+      return returnResult({ ...description && { description } });
+    default:
+      throw new Error(`Unsupported Zod type: ${def.typeName}`);
+  }
+}
+function zodObjectToSchema(schema) {
+  if (schema._def.typeName !== z.ZodFirstPartyTypeKind.ZodObject) {
+    throw new Error("Expected a ZodObject");
+  }
+  const shape = schema.shape;
+  const properties = {};
+  const required = [];
+  for (const key in shape) {
+    const fieldSchema = shape[key];
+    const parsedField = parseZodType(fieldSchema);
+    if (parsedField) {
+      properties[key] = parsedField;
+    }
+    let currentSchema = fieldSchema;
+    let isOptional = false;
+    while (currentSchema._def.typeName === z.ZodFirstPartyTypeKind.ZodOptional || currentSchema._def.typeName === z.ZodFirstPartyTypeKind.ZodDefault) {
+      isOptional = true;
+      currentSchema = currentSchema._def.innerType;
+    }
+    if (!isOptional) {
+      required.push(key);
+    }
+  }
+  const catchall = schema._def.catchall;
+  let additionalProperties = false;
+  if (catchall && catchall._def.typeName !== z.ZodFirstPartyTypeKind.ZodNever) {
+    additionalProperties = parseZodType(catchall) || true;
+  } else {
+    additionalProperties = schema._def.unknownKeys === "passthrough";
+  }
+  return {
+    type: Type.OBJECT,
+    properties,
+    required: required.length > 0 ? required : [],
+    ...schema._def.description ? { description: schema._def.description } : {}
+  };
+}
+export {
+  isZodObject,
+  zodObjectToSchema
+};

package/dist/esm/utils/variant_utils.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var GoogleLLMVariant = /* @__PURE__ */ ((GoogleLLMVariant2) => {
+  GoogleLLMVariant2["VERTEX_AI"] = "VERTEX_AI";
+  GoogleLLMVariant2["GEMINI_API"] = "GEMINI_API";
+  return GoogleLLMVariant2;
+})(GoogleLLMVariant || {});
+function getGoogleLlmVariant() {
+  return getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI") ? "VERTEX_AI" /* VERTEX_AI */ : "GEMINI_API" /* GEMINI_API */;
+}
+function getBooleanEnvVar(envVar) {
+  if (!process.env) {
+    return false;
+  }
+  const envVarValue = (process.env[envVar] || "").toLowerCase();
+  return ["true", "1"].includes(envVar.toLowerCase());
+}
+export {
+  GoogleLLMVariant,
+  getGoogleLlmVariant
+};

package/dist/esm/version.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const version = "0.2.4";
+export {
+  version
+};

package/dist/types/models/google_llm.d.ts

@@ -60,13 +60,6 @@ export declare class Gemini extends BaseLlm {
     private readonly headers?;
     private readonly apiEndpoint?;
     private readonly isGemini3Preview;
-    /**
-     * Cached thoughtSignature from Gemini 3 thinking mode responses.
-     * Gemini 3 may not return a new signature for follow-up tool calls in the same turn,
-     * so we cache the signature from the first response and reuse it for subsequent calls.
-     * This is reset at the start of each new generateContentAsync call.
-     */
-    private cachedThoughtSignature?;
     /**
      * @param params The parameters for creating a Gemini instance.
      */

package/dist/web/agents/active_streaming_tool.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ActiveStreamingTool {
+  constructor(params = {}) {
+    this.task = params.task;
+    this.stream = params.stream;
+  }
+}
+export {
+  ActiveStreamingTool
+};

package/dist/web/agents/base_agent.js

@@ -0,0 +1,265 @@
+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 __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+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));
+var __await = function(promise, isYieldStar) {
+  this[0] = promise;
+  this[1] = isYieldStar;
+};
+var __asyncGenerator = (__this, __arguments, generator) => {
+  var resume = (k, v, yes, no) => {
+    try {
+      var x = generator[k](v), isAwait = (v = x.value) instanceof __await, done = x.done;
+      Promise.resolve(isAwait ? v[0] : v).then((y) => isAwait ? resume(k === "return" ? k : "next", v[1] ? { done: y.done, value: y.value } : y, yes, no) : yes({ value: y, done })).catch((e) => resume("throw", e, yes, no));
+    } catch (e) {
+      no(e);
+    }
+  }, method = (k) => it[k] = (x) => new Promise((yes, no) => resume(k, x, yes, no)), it = {};
+  return generator = generator.apply(__this, __arguments), it[__knownSymbol("asyncIterator")] = () => it, method("next"), method("throw"), method("return"), it;
+};
+var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { trace } from "@opentelemetry/api";
+import { createEvent } from "../events/event.js";
+import { CallbackContext } from "./callback_context.js";
+import { InvocationContext } from "./invocation_context.js";
+class BaseAgent {
+  constructor(config) {
+    this.name = validateAgentName(config.name);
+    this.description = config.description;
+    this.parentAgent = config.parentAgent;
+    this.subAgents = config.subAgents || [];
+    this.rootAgent = getRootAgent(this);
+    this.beforeAgentCallback = getCannonicalCallback(config.beforeAgentCallback);
+    this.afterAgentCallback = getCannonicalCallback(config.afterAgentCallback);
+    this.setParentAgentForSubAgents();
+  }
+  /**
+   * Entry method to run an agent via text-based conversation.
+   *
+   * @param parentContext The invocation context of the parent agent.
+   * @yields The events generated by the agent.
+   * @returns An AsyncGenerator that yields the events generated by the agent.
+   */
+  runAsync(parentContext) {
+    return __asyncGenerator(this, null, function* () {
+      const span = trace.getTracer("gcp.vertex.agent").startSpan("agent_run [".concat(this.name, "]"));
+      try {
+        const context = this.createInvocationContext(parentContext);
+        const beforeAgentCallbackEvent = yield new __await(this.handleBeforeAgentCallback(context));
+        if (beforeAgentCallbackEvent) {
+          yield beforeAgentCallbackEvent;
+        }
+        if (context.endInvocation) {
+          return;
+        }
+        try {
+          for (var iter = __forAwait(this.runAsyncImpl(context)), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+            const event = temp.value;
+            yield event;
+          }
+        } catch (temp) {
+          error = [temp];
+        } finally {
+          try {
+            more && (temp = iter.return) && (yield new __await(temp.call(iter)));
+          } finally {
+            if (error)
+              throw error[0];
+          }
+        }
+        if (context.endInvocation) {
+          return;
+        }
+        const afterAgentCallbackEvent = yield new __await(this.handleAfterAgentCallback(context));
+        if (afterAgentCallbackEvent) {
+          yield afterAgentCallbackEvent;
+        }
+      } finally {
+        span.end();
+      }
+    });
+  }
+  /**
+   * Entry method to run an agent via video/audio-based conversation.
+   *
+   * @param parentContext The invocation context of the parent agent.
+   * @yields The events generated by the agent.
+   * @returns An AsyncGenerator that yields the events generated by the agent.
+   */
+  runLive(parentContext) {
+    return __asyncGenerator(this, null, function* () {
+      const span = trace.getTracer("gcp.vertex.agent").startSpan("agent_run [".concat(this.name, "]"));
+      try {
+        throw new Error("Live mode is not implemented yet.");
+      } finally {
+        span.end();
+      }
+    });
+  }
+  /**
+   * Finds the agent with the given name in this agent and its descendants.
+   *
+   * @param name The name of the agent to find.
+   * @return The agent with the given name, or undefined if not found.
+   */
+  findAgent(name) {
+    if (this.name === name) {
+      return this;
+    }
+    return this.findSubAgent(name);
+  }
+  /**
+   * Finds the agent with the given name in this agent's descendants.
+   *
+   * @param name The name of the agent to find.
+   * @return The agent with the given name, or undefined if not found.
+   */
+  findSubAgent(name) {
+    for (const subAgent of this.subAgents) {
+      const result = subAgent.findAgent(name);
+      if (result) {
+        return result;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Creates an invocation context for this agent.
+   *
+   * @param parentContext The invocation context of the parent agent.
+   * @return The invocation context for this agent.
+   */
+  createInvocationContext(parentContext) {
+    return new InvocationContext(__spreadProps(__spreadValues({}, parentContext), {
+      agent: this
+    }));
+  }
+  /**
+   * Runs the before agent callback if it exists.
+   *
+   * @param invocationContext The invocation context of the agent.
+   * @return The event to return to the user, or undefined if no event is
+   *     generated.
+   */
+  async handleBeforeAgentCallback(invocationContext) {
+    if (this.beforeAgentCallback.length === 0) {
+      return void 0;
+    }
+    const callbackContext = new CallbackContext({ invocationContext });
+    for (const callback of this.beforeAgentCallback) {
+      const content = await callback(callbackContext);
+      if (content) {
+        invocationContext.endInvocation = true;
+        return createEvent({
+          invocationId: invocationContext.invocationId,
+          author: this.name,
+          branch: invocationContext.branch,
+          content,
+          actions: callbackContext.eventActions
+        });
+      }
+    }
+    if (callbackContext.state.hasDelta()) {
+      return createEvent({
+        invocationId: invocationContext.invocationId,
+        author: this.name,
+        branch: invocationContext.branch,
+        actions: callbackContext.eventActions
+      });
+    }
+    return void 0;
+  }
+  /**
+   * Runs the after agent callback if it exists.
+   *
+   * @param invocationContext The invocation context of the agent.
+   * @return The event to return to the user, or undefined if no event is
+   *     generated.
+   */
+  async handleAfterAgentCallback(invocationContext) {
+    if (this.afterAgentCallback.length === 0) {
+      return void 0;
+    }
+    const callbackContext = new CallbackContext({ invocationContext });
+    for (const callback of this.afterAgentCallback) {
+      const content = await callback(callbackContext);
+      if (content) {
+        return createEvent({
+          invocationId: invocationContext.invocationId,
+          author: this.name,
+          branch: invocationContext.branch,
+          content,
+          actions: callbackContext.eventActions
+        });
+      }
+    }
+    if (callbackContext.state.hasDelta()) {
+      return createEvent({
+        invocationId: invocationContext.invocationId,
+        author: this.name,
+        branch: invocationContext.branch,
+        actions: callbackContext.eventActions
+      });
+    }
+    return void 0;
+  }
+  setParentAgentForSubAgents() {
+    for (const subAgent of this.subAgents) {
+      if (subAgent.parentAgent) {
+        throw new Error('Agent "'.concat(subAgent.name, '" already has a parent agent, current parent: "').concat(subAgent.parentAgent.name, '", trying to add: "').concat(this.name, '"'));
+      }
+      subAgent.parentAgent = this;
+    }
+  }
+}
+function validateAgentName(name) {
+  if (!isIdentifier(name)) {
+    throw new Error('Found invalid agent name: "'.concat(name, '". Agent name must be a valid identifier. It should start with a letter (a-z, A-Z) or an underscore (_), and can only contain letters, digits (0-9), and underscores.'));
+  }
+  if (name === "user") {
+    throw new Error(
+      "Agent name cannot be 'user'. 'user' is reserved for end-user's input."
+    );
+  }
+  return name;
+}
+function isIdentifier(str) {
+  return new RegExp("^[\\p{ID_Start}$_][\\p{ID_Continue}$_]*$", "u").test(str);
+}
+function getRootAgent(rootAgent) {
+  while (rootAgent.parentAgent) {
+    rootAgent = rootAgent.parentAgent;
+  }
+  return rootAgent;
+}
+function getCannonicalCallback(callbacks) {
+  if (!callbacks) {
+    return [];
+  }
+  return Array.isArray(callbacks) ? callbacks : [callbacks];
+}
+export {
+  BaseAgent,
+  getCannonicalCallback
+};

package/dist/web/agents/base_llm_processor.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class BaseLlmRequestProcessor {
+}
+class BaseLlmResponseProcessor {
+}
+export {
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor
+};