@google/adk 0.2.4 → 0.3.0

package/dist/esm/utils/simple_zod_to_json.js

@@ -4,155 +4,116 @@
  * 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";
+import {
+  zodToJsonSchema as toJSONSchemaV3
+} from "zod-to-json-schema";
+import { toJSONSchema as toJSONSchemaV4 } from "zod/v4";
+function isZodSchema(obj) {
+  return obj !== null && typeof obj === "object" && "parse" in obj && typeof obj.parse === "function" && "safeParse" in obj && typeof obj.safeParse === "function";
+}
+function isZodV3Schema(obj) {
+  return isZodSchema(obj) && !("_zod" in obj);
+}
+function isZodV4Schema(obj) {
+  return isZodSchema(obj) && "_zod" in obj;
 }
-function parseZodType(zodType) {
-  const def = zodType._def;
-  if (!def) {
-    return {};
+function getZodTypeName(schema) {
+  var _a, _b;
+  const schemaAny = schema;
+  if ((_a = schemaAny._def) == null ? void 0 : _a.typeName) {
+    return schemaAny._def.typeName;
   }
-  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}`);
+  const zod4Type = (_b = schemaAny._def) == null ? void 0 : _b.type;
+  if (typeof zod4Type === "string" && zod4Type) {
+    return "Zod" + zod4Type.charAt(0).toUpperCase() + zod4Type.slice(1);
   }
+  return void 0;
+}
+function isZodObject(obj) {
+  return isZodSchema(obj) && getZodTypeName(obj) === "ZodObject";
 }
 function zodObjectToSchema(schema) {
-  if (schema._def.typeName !== z.ZodFirstPartyTypeKind.ZodObject) {
-    throw new Error("Expected a ZodObject");
+  if (!isZodObject(schema)) {
+    throw new Error("Expected a Zod Object");
   }
-  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);
-    }
+  if (isZodV4Schema(schema)) {
+    return toJSONSchemaV4(schema, {
+      target: "openapi-3.0",
+      io: "input",
+      override: (ctx) => {
+        var _a;
+        const { jsonSchema } = ctx;
+        if (jsonSchema.additionalProperties !== void 0) {
+          delete jsonSchema.additionalProperties;
+        }
+        if (jsonSchema.readOnly !== void 0) {
+          delete jsonSchema.readOnly;
+        }
+        if (jsonSchema.maxItems !== void 0) {
+          jsonSchema.maxItems = jsonSchema.maxItems.toString();
+        }
+        if (jsonSchema.format === "email" || jsonSchema.format === "uuid") {
+          delete jsonSchema.pattern;
+        }
+        if (jsonSchema.minItems !== void 0) {
+          jsonSchema.minItems = jsonSchema.minItems.toString();
+        }
+        if (jsonSchema.minLength !== void 0) {
+          jsonSchema.minLength = jsonSchema.minLength.toString();
+        }
+        if (jsonSchema.maxLength !== void 0) {
+          jsonSchema.maxLength = jsonSchema.maxLength.toString();
+        }
+        if (((_a = jsonSchema.enum) == null ? void 0 : _a.length) === 1 && jsonSchema.enum[0] === null) {
+          jsonSchema.type = Type.NULL;
+          delete jsonSchema.enum;
+        }
+        if (jsonSchema.type !== void 0) {
+          jsonSchema.type = jsonSchema.type.toUpperCase();
+        }
+      }
+    });
   }
-  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";
+  if (isZodV3Schema(schema)) {
+    return toJSONSchemaV3(schema, {
+      target: "openApi3",
+      emailStrategy: "format:email",
+      postProcess: (jsonSchema) => {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (!jsonSchema) {
+          return;
+        }
+        if (jsonSchema.additionalProperties !== void 0) {
+          delete jsonSchema.additionalProperties;
+        }
+        if (jsonSchema.maxItems !== void 0) {
+          jsonSchema.maxItems = (_a = jsonSchema.maxItems) == null ? void 0 : _a.toString();
+        }
+        if (jsonSchema.minItems !== void 0) {
+          jsonSchema.minItems = (_b = jsonSchema.minItems) == null ? void 0 : _b.toString();
+        }
+        if (jsonSchema.minLength !== void 0) {
+          jsonSchema.minLength = (_c = jsonSchema.minLength) == null ? void 0 : _c.toString();
+        }
+        if (jsonSchema.maxLength !== void 0) {
+          jsonSchema.maxLength = (_d = jsonSchema.maxLength) == null ? void 0 : _d.toString();
+        }
+        if (((_e = jsonSchema.enum) == null ? void 0 : _e.length) === 1 && jsonSchema.enum[0] === "null") {
+          jsonSchema.type = Type.NULL;
+          delete jsonSchema.enum;
+        }
+        if (jsonSchema.type === "integer" && jsonSchema.format !== "int64") {
+          (_f = jsonSchema.minimum) != null ? _f : jsonSchema.minimum = Number.MIN_SAFE_INTEGER;
+          (_g = jsonSchema.maximum) != null ? _g : jsonSchema.maximum = Number.MAX_SAFE_INTEGER;
+        }
+        if (jsonSchema.type !== void 0) {
+          jsonSchema.type = jsonSchema.type.toUpperCase();
+        }
+        return jsonSchema;
+      }
+    });
   }
-  return {
-    type: Type.OBJECT,
-    properties,
-    required: required.length > 0 ? required : [],
-    ...schema._def.description ? { description: schema._def.description } : {}
-  };
+  throw new Error("Unsupported Zod schema version.");
 }
 export {
   isZodObject,

package/dist/esm/utils/variant_utils.js

@@ -16,7 +16,7 @@ function getBooleanEnvVar(envVar) {
     return false;
   }
   const envVarValue = (process.env[envVar] || "").toLowerCase();
-  return ["true", "1"].includes(envVar.toLowerCase());
+  return ["true", "1"].includes(envVarValue);
 }
 export {
   GoogleLLMVariant,

package/dist/esm/version.js

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "0.2.4";
+const version = "0.3.0";
 export {
   version
 };

package/dist/types/agents/base_agent.d.ts

@@ -7,9 +7,20 @@ import { Content } from '@google/genai';
 import { Event } from '../events/event.js';
 import { CallbackContext } from './callback_context.js';
 import { InvocationContext } from './invocation_context.js';
-type SingleAgentCallback = (context: CallbackContext) => Promise<Content | undefined> | (Content | undefined);
-type BeforeAgentCallback = SingleAgentCallback | SingleAgentCallback[];
-type AfterAgentCallback = SingleAgentCallback | SingleAgentCallback[];
+/**
+ * A single callback function for an agent.
+ */
+export type SingleAgentCallback = (context: CallbackContext) => Promise<Content | undefined> | (Content | undefined);
+/**
+ * Type for before agent callbacks, which can be a single callback or
+ * an array of callbacks.
+ */
+export type BeforeAgentCallback = SingleAgentCallback | SingleAgentCallback[];
+/**
+ * Type for after agent callbacks, which can be a single callback or
+ * an array of callbacks.
+ */
+export type AfterAgentCallback = SingleAgentCallback | SingleAgentCallback[];
 /**
  * The config of a base agent.
  */
@@ -55,8 +66,9 @@ export declare abstract class BaseAgent {
     readonly description?: string;
     /**
      * Root agent of this agent.
+     * Computed dynamically by traversing up the parent chain.
      */
-    readonly rootAgent: BaseAgent;
+    get rootAgent(): BaseAgent;
     /**
      * The parent agent of this agent.
      *

package/dist/types/agents/callback_context.d.ts

@@ -14,7 +14,7 @@ import { ReadonlyContext } from './readonly_context.js';
 export declare class CallbackContext extends ReadonlyContext {
     private readonly _state;
     readonly eventActions: EventActions;
-    constructor({ invocationContext, eventActions }: {
+    constructor({ invocationContext, eventActions, }: {
         invocationContext: InvocationContext;
         eventActions?: EventActions;
     });

package/dist/types/agents/invocation_context.d.ts

@@ -15,7 +15,10 @@ import { BaseAgent } from './base_agent.js';
 import { LiveRequestQueue } from './live_request_queue.js';
 import { RunConfig } from './run_config.js';
 import { TranscriptionEntry } from './transcription_entry.js';
-interface InvocationContextParams {
+/**
+ * The parameters for creating an invocation context.
+ */
+export interface InvocationContextParams {
     artifactService?: BaseArtifactService;
     sessionService?: BaseSessionService;
     memoryService?: BaseMemoryService;
@@ -152,4 +155,3 @@ export declare class InvocationContext {
     incrementLlmCallCount(): void;
 }
 export declare function newInvocationContextId(): string;
-export {};

package/dist/types/agents/llm_agent.d.ts

@@ -24,8 +24,8 @@ export type InstructionProvider = (context: ReadonlyContext) => string | Promise
 /**
  * A callback that runs before a request is sent to the model.
  *
- * @param context The current callback context.
- * @param request The raw model request. Callback can mutate the request.
+ * @param params.context The current callback context.
+ * @param params.request The raw model request. Callback can mutate the request.
  * @returns The content to return to the user. When present, the model call
  *     will be skipped and the provided content will be returned to user.
  */
@@ -43,8 +43,8 @@ export type BeforeModelCallback = SingleBeforeModelCallback | SingleBeforeModelC
 /**
  * A callback that runs after a response is received from the model.
  *
- * @param context The current callback context.
- * @param response The actual model response.
+ * @param params.context The current callback context.
+ * @param params.response The actual model response.
  * @returns The content to return to the user. When present, the actual model
  *     response will be ignored and the provided content will be returned to
  *     user.
@@ -60,24 +60,20 @@ export type SingleAfterModelCallback = (params: {
  order they are listed until a callback does not return None.
  */
 export type AfterModelCallback = SingleAfterModelCallback | SingleAfterModelCallback[];
-/** A generic dictionary type. */
-export type Dict = {
-    [key: string]: unknown;
-};
 /**
  * A callback that runs before a tool is called.
  *
- * @param tool The tool to be called.
- * @param args The arguments to the tool.
- * @param tool_context: ToolContext,
+ * @param params.tool The tool to be called.
+ * @param params.args The arguments to the tool.
+ * @param params.context ToolContext for the tool call.
  * @returns The tool response. When present, the returned tool response will
  *     be used and the framework will skip calling the actual tool.
  */
 export type SingleBeforeToolCallback = (params: {
     tool: BaseTool;
-    args: Dict;
+    args: Record<string, unknown>;
     context: ToolContext;
-}) => Dict | undefined | Promise<Dict | undefined>;
+}) => Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined>;
 /**
  * A single callback or a list of callbacks.
  *
@@ -88,18 +84,18 @@ export type BeforeToolCallback = SingleBeforeToolCallback | SingleBeforeToolCall
 /**
  * A callback that runs after a tool is called.
  *
- * @param tool The tool to be called.
- * @param args The arguments to the tool.
- * @param tool_context: ToolContext,
- * @param tool_response: The response from the tool.
- * @returns When present, the returned dict will be used as tool result.
+ * @param params.tool The tool to be called.
+ * @param params.args The arguments to the tool.
+ * @param params.context ToolContext for the tool call.
+ * @param params.response The response from the tool.
+ * @returns When present, the returned record will be used as tool result.
  */
 export type SingleAfterToolCallback = (params: {
     tool: BaseTool;
-    args: Dict;
+    args: Record<string, unknown>;
     context: ToolContext;
-    response: Dict;
-}) => Dict | undefined | Promise<Dict | undefined>;
+    response: Record<string, unknown>;
+}) => Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined>;
 /**
  * A single callback or a list of callbacks.
  *
@@ -111,6 +107,9 @@ export type AfterToolCallback = SingleAfterToolCallback | SingleAfterToolCallbac
 export type ExamplesUnion = Example[] | BaseExampleProvider;
 /** A union of tool types that can be provided to an agent. */
 export type ToolUnion = BaseTool | BaseToolset;
+/**
+ * The configuration options for creating an LLM-based agent.
+ */
 export interface LlmAgentConfig extends BaseAgentConfig {
     /**
      * The model to use for the agent.
@@ -208,7 +207,7 @@ export interface LlmAgentConfig extends BaseAgentConfig {
 }
 declare class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
     /** Handles tool confirmation information to build the LLM request. */
-    runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
+    runAsync(invocationContext: InvocationContext): AsyncGenerator<Event, void, void>;
 }
 export declare const REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: RequestConfirmationLlmRequestProcessor;
 /**
@@ -228,10 +227,23 @@ declare class CodeExecutionResponseProcessor implements BaseLlmResponseProcessor
  * The exported response processor instance.
  */
 export declare const responseProcessor: CodeExecutionResponseProcessor;
+/**
+ * A unique symbol to identify ADK agent classes.
+ * Defined once and shared by all LlmAgent instances.
+ */
+declare const LLM_AGENT_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of LlmAgent.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of LlmAgent, false otherwise.
+ */
+export declare function isLlmAgent(obj: unknown): obj is LlmAgent;
 /**
  * An agent that uses a large language model to generate responses.
  */
 export declare class LlmAgent extends BaseAgent {
+    /** A unique symbol to identify ADK LLM agent class. */
+    readonly [LLM_AGENT_SIGNATURE_SYMBOL] = true;
     model?: string | BaseLlm;
     instruction: string | InstructionProvider;
     globalInstruction: string | InstructionProvider;
@@ -258,30 +270,30 @@ export declare class LlmAgent extends BaseAgent {
      */
     get canonicalModel(): BaseLlm;
     /**
-     * The resolved self.instruction field to construct instruction for this
+     * The resolved instruction field to construct instruction for this
      * agent.
      *
      * This method is only for use by Agent Development Kit.
      * @param context The context to retrieve the session state.
-     * @returns The resolved self.instruction field.
+     * @returns The resolved instruction field.
      */
     canonicalInstruction(context: ReadonlyContext): Promise<{
         instruction: string;
         requireStateInjection: boolean;
     }>;
     /**
-     * The resolved self.instruction field to construct global instruction.
+     * The resolved globalInstruction field to construct global instruction.
      *
      * This method is only for use by Agent Development Kit.
      * @param context The context to retrieve the session state.
-     * @returns The resolved self.global_instruction field.
+     * @returns The resolved globalInstruction field.
      */
     canonicalGlobalInstruction(context: ReadonlyContext): Promise<{
         instruction: string;
         requireStateInjection: boolean;
     }>;
     /**
-     * The resolved self.tools field as a list of BaseTool based on the context.
+     * The resolved tools field as a list of BaseTool based on the context.
      *
      * This method is only for use by Agent Development Kit.
      */
@@ -294,28 +306,28 @@ export declare class LlmAgent extends BaseAgent {
      */
     private static normalizeCallbackArray;
     /**
-     * The resolved self.before_model_callback field as a list of
+     * The resolved beforeModelCallback field as a list of
      * SingleBeforeModelCallback.
      *
      * This method is only for use by Agent Development Kit.
      */
     get canonicalBeforeModelCallbacks(): SingleBeforeModelCallback[];
     /**
-     * The resolved self.after_model_callback field as a list of
+     * The resolved afterModelCallback field as a list of
      * SingleAfterModelCallback.
      *
      * This method is only for use by Agent Development Kit.
      */
     get canonicalAfterModelCallbacks(): SingleAfterModelCallback[];
     /**
-     * The resolved self.before_tool_callback field as a list of
+     * The resolved beforeToolCallback field as a list of
      * BeforeToolCallback.
      *
      * This method is only for use by Agent Development Kit.
      */
     get canonicalBeforeToolCallbacks(): SingleBeforeToolCallback[];
     /**
-     * The resolved self.after_tool_callback field as a list of AfterToolCallback.
+     * The resolved afterToolCallback field as a list of AfterToolCallback.
      *
      * This method is only for use by Agent Development Kit.
      */

package/dist/types/agents/loop_agent.d.ts

@@ -17,6 +17,17 @@ export interface LoopAgentConfig extends BaseAgentConfig {
      */
     maxIterations?: number;
 }
+/**
+ * A unique symbol to identify ADK agent classes.
+ * Defined once and shared by all LoopAgent instances.
+ */
+declare const LOOP_AGENT_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of LoopAgent.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of LoopAgent, false otherwise.
+ */
+export declare function isLoopAgent(obj: unknown): obj is LoopAgent;
 /**
  * A shell agent that run its sub-agents in a loop.
  *
@@ -24,8 +35,13 @@ export interface LoopAgentConfig extends BaseAgentConfig {
  * reached, the loop agent will stop.
  */
 export declare class LoopAgent extends BaseAgent {
+    /**
+     * A unique symbol to identify ADK loop agent class.
+     */
+    readonly [LOOP_AGENT_SIGNATURE_SYMBOL] = true;
     private readonly maxIterations;
     constructor(config: LoopAgentConfig);
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
-    protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    protected runLiveImpl(_context: InvocationContext): AsyncGenerator<Event, void, void>;
 }
+export {};

package/dist/types/agents/parallel_agent.d.ts

@@ -6,6 +6,17 @@
 import { Event } from '../events/event.js';
 import { BaseAgent } from './base_agent.js';
 import { InvocationContext } from './invocation_context.js';
+/**
+ * A unique symbol to identify ADK agent classes.
+ * Defined once and shared by all ParallelAgent instances.
+ */
+declare const PARALLEL_AGENT_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of ParallelAgent.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of ParallelAgent, false otherwise.
+ */
+export declare function isParallelAgent(obj: unknown): obj is ParallelAgent;
 /**
  * A shell agent that run its sub-agents in parallel in isolated manner.
  *
@@ -16,6 +27,11 @@ import { InvocationContext } from './invocation_context.js';
  *  - Generating multiple responses for review by a subsequent evaluation agent.
  */
 export declare class ParallelAgent extends BaseAgent {
+    /**
+     * A unique symbol to identify ADK parallel agent class.
+     */
+    readonly [PARALLEL_AGENT_SIGNATURE_SYMBOL] = true;
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
-    protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    protected runLiveImpl(_context: InvocationContext): AsyncGenerator<Event, void, void>;
 }
+export {};

package/dist/types/agents/sequential_agent.d.ts

@@ -6,10 +6,25 @@
 import { Event } from '../events/event.js';
 import { BaseAgent } from './base_agent.js';
 import { InvocationContext } from './invocation_context.js';
+/**
+ * A unique symbol to identify ADK agent classes.
+ * Defined once and shared by all SequentialAgent instances.
+ */
+declare const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of SequentialAgent.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of SequentialAgent, false otherwise.
+ */
+export declare function isSequentialAgent(obj: unknown): obj is SequentialAgent;
 /**
  * A shell agent that runs its sub-agents in a sequential order.
  */
 export declare class SequentialAgent extends BaseAgent {
+    /**
+     * A unique symbol to identify ADK sequential agent class.
+     */
+    readonly [SEQUENTIAL_AGENT_SIGNATURE_SYMBOL] = true;
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
     /**
      * Implementation for live SequentialAgent.
@@ -20,7 +35,8 @@ export declare class SequentialAgent extends BaseAgent {
      * the model can call this function to signal that it's finished the task and
      * we can move on to the next agent.
      *
-     * @param context: The invocation context of the agent.
+     * @param context The invocation context of the agent.
      */
     protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
 }
+export {};

package/dist/types/artifacts/in_memory_artifact_service.d.ts

@@ -12,7 +12,7 @@ export declare class InMemoryArtifactService implements BaseArtifactService {
     private readonly artifacts;
     saveArtifact({ appName, userId, sessionId, filename, artifact, }: SaveArtifactRequest): Promise<number>;
     loadArtifact({ appName, userId, sessionId, filename, version, }: LoadArtifactRequest): Promise<Part | undefined>;
-    listArtifactKeys({ appName, userId, sessionId }: ListArtifactKeysRequest): Promise<string[]>;
-    deleteArtifact({ appName, userId, sessionId, filename }: DeleteArtifactRequest): Promise<void>;
-    listVersions({ appName, userId, sessionId, filename }: ListVersionsRequest): Promise<number[]>;
+    listArtifactKeys({ appName, userId, sessionId, }: ListArtifactKeysRequest): Promise<string[]>;
+    deleteArtifact({ appName, userId, sessionId, filename, }: DeleteArtifactRequest): Promise<void>;
+    listVersions({ appName, userId, sessionId, filename, }: ListVersionsRequest): Promise<number[]>;
 }

package/dist/types/auth/auth_schemes.d.ts

@@ -5,8 +5,11 @@
  */
 import { OpenAPIV3 } from 'openapi-types';
 type Oauth2Flow = OpenAPIV3.OAuth2SecurityScheme['flows'];
-export interface OpenIdConnectWithConfig extends OpenAPIV3
-    .OpenIdSecurityScheme {
+/**
+ * OpenIdConnectWithConfig extends OpenIdSecurityScheme with additional
+ * configuration options.
+ */
+export interface OpenIdConnectWithConfig extends OpenAPIV3.OpenIdSecurityScheme {
     authorizationEndpoint: string;
     tokenEndpoint: string;
     userinfoEndpoint?: string;