diff --git a/docs/api-reference/typescript/assets/hierarchy.js b/docs/api-reference/typescript/assets/hierarchy.js index 6314af95c..a1cedbb0b 100644 --- a/docs/api-reference/typescript/assets/hierarchy.js +++ b/docs/api-reference/typescript/assets/hierarchy.js @@ -1 +1 @@ -window.hierarchyData = "eJyVV8tu2zAQ/BeemdYi9fStNdKiQAIYcW9FDorMOERoMqWkoEbgf+9Ssg1SkUzqIgHxcGZntdzdfCCtVFOj5R+yIJhkOKMFjgucxxGOCKU4hzdNcnhkCSYxwTmJ4Zc0e8RIs2fBqoYrCQQfiGTmKcs9Q0v0vazZN93w57JqNky/84ohjF653KIlSVKMWi0AxmXDNGBY/XXkxJeXZi/gWCXKGiRQU29vDMXN5Zj58YWLrWYSPEQ5wSkpHo8YxcUgmHu2V/oQHoqDnxtIRogJIo8GQWxYXUO6hlFEJD9H0SmcQnDRkzH0f3ATQRcLE0BEUyuC+9X6t1LimuwJ4tEyzCn5zFyzJoAcUAH8uc3/s6qnimlE5zParwflP6zeHZNX7VxAc74M7e5XjhOa4aSIzEeCW2VJr0ohnsrqdaWgtP5dDWAAnVUgcZwYbQjH0r4Te6/rM8afUrBpcyv15ic/g/zskECLfV1qSAYTXgUHGKBS2Fd4w/62cIyXfp0B1K8EfctS+iX7/jOj6ieOBChniaV8+247G++PHSagJwI5dMIRW+PN+IqpsG58sZTRYfuHsvXdZYDMuUJZ2g0aeNmNiu255FebU4fwW4A5697MB1a/waT1zS4LOXdqQSF0Uysejq21aHdc+vLXo+aksCAER7BmGNXCKZQ7tQOunV/YAQaMFZAbqce1Erw63ErgCCpHGx8iSqjTRapW8+bgN+ciA4RgYxt+ujFn01tPkLGp7Qt8dksHielIjh9aKZkOyW6PDLGb2jPALxBE7HoCL/0itViMeArf58ZPBHh0J3Q3THxL3AUUQp/kg4rxsZ8x8/bRFBsn8ChO+XSGzpnTs0BasFnqaV+XoG1p/mhl97+Lz6+Nm7diRV07NW+ns8mdqUNoWqERTBwJ+Lqw5VnS5lDAWmnBfBLH439rV6Pa" \ No newline at end of file +window.hierarchyData = "eJyVV01v2zAM/S86q5sl27Kc2xZ0w4AVCJrdhh48R02FKnLnj2JBkf8+ym4CybUj+eJ8+ImPjyIp6g3VVdU2aPWbkhzTDGcpw0mOOWeY0IxjTjBJohgeNMI0hTcJ/IgJfcCoFo9KlK2sNBh4QzQzT10cBFqhr0UjvtStfCzKdivqV1kKhNGz1Du0osCBuloBTOpW1IARzeeJFZ+e2oOCZaUqGqBAbbO7MSZuLsvMyyepdrXQoIFwilnCHk4YJfnImTtxqOpjuCsOfqkjWZwbJzgZObEVTQPhGntBKD970TO8u+CiZ30Y/nADESepcYDEzPLgbr35VVXqGu07xMNlLDP60XIj2gDjgAqwz23738tmLpkmeD6i/XyQ/uPs3Qt9Vc4FtGRnYki4lKQ4TRPMIm42CarKol4XSv0pyud1Ban176oDI+iiBEnyyHCDOxb3T3Xwqj5j/CEFmbbtqnrxGz+DAqyniWV9U9QQDKG8DA7QzwJbZLFsxd8OlsnCzzOCBjAl9k780EP/WZD1M0sCmHO71G5fbWXT/bHHBPREMA6dcELWdDO+IiqsG18kZU5am0KFtPXVMkCWlFDG++qFD7tRiYPU8mpz6hF+CXDOupV5L5oXOGl9Z5eFXHpqQSL0pxYfB2+jur3UvvgNqCUhzFmGCWF9HOG70y32YGvvJ3aAAccKSbOJfNxUSpbHWw02gtLRxoeQMreLlF0t26NfnIsMIIKJbbx1U8rmp54gYXPTF8S2HzqoUxLnmN13Wos6JLoDMkAujKEWkZ8gyLCriQ5VbgaqCU3h89z0ihCN3D7n+sPEN8RdQAHmYbYfZYzP+hmzbB6F6wQogWtEPMQTrhMTvJ4B0oItYmd04IztvPzW6f7u4tNr45aNWCwaaFnkdDa9N3kITSvUg5klIbub29RmUcBYacF8FKfTfwL7pDY=" \ No newline at end of file diff --git a/docs/api-reference/typescript/assets/navigation.js b/docs/api-reference/typescript/assets/navigation.js index 787396cec..a872347a9 100644 --- a/docs/api-reference/typescript/assets/navigation.js +++ b/docs/api-reference/typescript/assets/navigation.js @@ -1 +1 @@ -window.navigationData = "eJydmdty2zYQht9F15m6cZu0zR3DSo6nkqVIcm86HQ9MrSjWJKACoMZKp+9ekBKPWCzg3tge7r8fTruLg//4Z6LhVU8+TeYincMJ8sm7yZHpg/kCvCzUTfP9u4MuKuNLxneTTz//+671XIk8S87LUieigLH7wOhmbLQEVmQ8XYidxRgY3YwoBa63QvSGkORMKVA3rWno/f627/+ZKaiFtn9r8vnP8wL3Ngaf7yov04zj7hebj7ABpTLBNyBPWQI4aajxEfHpbCwh3goc83k1UoyY5fkzS15iwesvFmckoFizkifaDBwfUd9KUe4SFUmd7VminbNsa0gimMjOEEr9nfK85wsohDx7O+QQhrAvP73kgSyEeykLU26CmsD2VSHUdck5SDfvYg8h+TIJ19Hkk0hYFWPOaLYkFG+enWANf5eg9NcSSqSPYwVJywtH6WsspLdIzRKlrgI2MNMcnlZrZMR0ujqENFscXUNsTJT/Il5dF3vBOEuxMLMkHh4+tqshwBctrZ2NIqyYNKUTcseMDMwkp15T54wMzBTHlbn+jN1AUspMn13BN7TTJJMrXGfMNSsjAcWqlsAk8T6TRZ3QNmysCKDhVaNnpBjR8Qh8Nz2Zjl+LQofKjLc0O0N1UrJkQ+jth4/jI5Nr++lREZ0PG0vYXSbbB7aUPrQpaWbCOCTDlRlhByof0rFPjpDENmkj8S1yRHTvkDawCpQqsQvlxHUSCmYmnOnmIEkFEyakwL9CDroNFIqMKv3ogD5jQgpcpwpKqi1e16iOL3xJ+gIKdDkrEmvbF9AgfR15XZpSB2woCgNSc26pKOQ8U7pZ+N/grCiwQ+vDXzvjRY904Vh1NL/wrMaEPvDvIIP6O9LR2Pbw6MC1dhKTFySlNXsh1JR1dhIj2C6ktiA6CnspwfEBkhfTizLHoZaKQppTT6TOPKnKMdVTROfBEmndWinEhp2C6jOiI7HAZHK4XtIorK0LxxIRhAlpcJ2gDlZtI931LhPd4YIo3KiSRldvZew5hy/b7SqwDcqFaqw+epqLwjW4xyfUXhuo0odeSWF8laeGoEoKHe2Nb/WUmDfPRx1Xn4/VIdhSjHjf//LT+w+3Y2YzSCeyL/ARP8NeSCC7iUjCqFRHbYWPaW6c7ji7QBGJj7oxd/sc/Gvl0r2BT02HQxZGD1hDp/AtLfgH8PZV3V/fVdT09Sikht1MyK3JLINb8vzcNXNiMquKh7rxuAxb/KHf2N1yeTefPm2m0Tr+gqEHAgK0nn59nG62T/HyYXa/XkTb++XD0+zxIa7/iKP5/OkhWkyxJgJdicaT+rozuhC0k3LTMw8hH3/EIdbVAGWh9wMEae1ZYxq6cQ1AKehIvTwqkP2Xi+YFroostLMBbnSjIS38D1yz0/uQrY7AHpjaSpblJtZjk8bTV0jKq+/gSNg1QHsQTWVqlnGW2weajj2SEDAF2v7PXwfqmSmIlmYU2f6ysePRP9YQuG9it3z+y2wWW7FJDlAwjGeJLOCf/wGmDv4Q" \ No newline at end of file +window.navigationData = "eJydmVFz4jYQx78LzzdNL+1d23vzUUgyhcABuZebTkYxi1GxLSrJTLhOv3tlYxvbWq2UviQZ739/klbS7tr59s9Iw6sefRrNRDKDE6Sjd6Mj03vzBPIiUzfN8x/2OiuNB55vR59+/fdd67kUKY/Pi0LHIoOhe8/oZqy1BJbxPJmLrcXoGd2MKIFcb4ToLCFOmVKgblpT3/v9bdf/M1NQCW3/1uTzn6UZ7m0MPt9lWiQ8x90vNh9hDUpxka9BnngMOKmv8RHxcDaWEG8FjnjWRooxZmn6wuLDWOTVE4szEFCsaZHH2iwcX1HXSlHuYhVJzXcs1s4o2xqSCOZkc4RSPac8H/I5ZEKevRNyCEPYl59eck8Wwr2khUluDjWB7apCqKsiz0G6eRd7CMl3k3AdTT6JmJVnzHmaLQnFm/ETrODvApT+UkCBzHGoIGlp5kh9jYX0ns1XkHCl5RkBXI0kQyRmmxNXEuyZaU6elPtsxPSVdwhptji6wtSYKP/5eFkfmDnLWYIdVUvi4eFrqw0Bvmh6vtoowpJJk34hdUSkZyY51Z46I9IzUxzX7fff+jXEheT67Dp8fTtNMvct15y5ojIQUKxyC0wi2HGZVUnBhg0VATQ883SMFCM6HiHfTk5m4nViuaK48ZamupTdliXrQ28/fBy2Xa4S1qEiOh92LGF7CbYPbCl9aJMWTcByiPs7M8D2VD6ko9YOkESptZF4mR0Q3VXWBpYHpbzYmXLirhIKZgLOdNOMUocJE1Lg3yEF3R4Uiowq/eiAOWNCClxdFZRUWbyuUXW+8C3pCijQpd8k9rYroEG6XnmVmhIHrC8KA1Ixt1QUcmbakWbj/4CzosAOrQ9fT8aLHujCsepofuG3GhP6wF9BBs13oKOxbQPqwLV2EpNmJKU1eyFUyK52EiPYNiS3IDoKu9CQTl6PQhqAIq4NoiOxG0jvhTjgF7q1UohLcRjvIT6Y+BQpvlxLRSFNPxapcx6XhYKKIaLzYInItVYKsWanoMqB6EgsMBnv61dQCmvrwrHE2caENLhKHQ5WZSPd9ZaLa9tDlBRUSaPLL4HsJYX7zWYZOAblQg1WNcXmFaY+3MPeuTMGqvShl1IYX+XJbqiSQkc741t+KE2bj2NXrj4fy/bcUgx4P/72y/sPt0Nms0gnsivwET/DTkggp4lIwqjURG2Fj2nehd3n7AJFJD7qmudJCv69cunewKfC4ZCF0QP20Cl8ywj+Bbx9V3f1Fx9VV9PtVMiNuVkGt8jTzlesE5O8TB7qxuPSH/Gn7mB3i8XdbPK8nkSr8T2G7gkI0Gry5Wmy3jyPF4/Th9U82jwsHp+nT4/j6o9xNJs9P0bzCTZEoCsxeFy9iA1eVdqg3HTMfcjHn3GI9dKCstA3FwRp1awhDS1cPVACOlKHJwWy+02l+TZYnix0sgFu9KAhI/wPXFPpfchWR2Pv4mPbeTqIXYkXZoYVhex+6BiyGgWB2jO1kYyn5g6OTXqZvEJc1GvqtapXNO1BDMXVlOcstRutK3sgIWAZO7+YE6nLft5U9xPfOqKKCgmwAm3/I/eK65gpiJYmPHx36WTw6z7UELjvYrt4+ctUx41Yx3vIGMazRBbwz/8AjZqfYw==" \ No newline at end of file diff --git a/docs/api-reference/typescript/assets/search.js b/docs/api-reference/typescript/assets/search.js index 1be50540c..22883ddbe 100644 --- a/docs/api-reference/typescript/assets/search.js +++ b/docs/api-reference/typescript/assets/search.js @@ -1 +1 @@ -window.searchData = "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"; \ No newline at end of file +window.searchData = "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"; \ No newline at end of file diff --git a/docs/api-reference/typescript/classes/AgentTool.html b/docs/api-reference/typescript/classes/AgentTool.html index 597bc054b..c5e9c4bd1 100644 --- a/docs/api-reference/typescript/classes/AgentTool.html +++ b/docs/api-reference/typescript/classes/AgentTool.html @@ -354,8 +354,8 @@ application. The agent's input schema is used to define the tool's input parameters, and the agent's output is returned as the tool's result.

The configuration of the agent tool.

-

Hierarchy (View Summary)

Constructors

Properties

description: string
isLongRunning: boolean
name: string

Accessors

  • get apiVariant(): GoogleLLMVariant

    The Google API LLM variant to use.

    -

    Returns GoogleLLMVariant

Methods

  • Gets the OpenAPI specification of this tool in the form of a +

Hierarchy (View Summary)

Constructors

Properties

description: string
isLongRunning: boolean
name: string

Accessors

  • get apiVariant(): GoogleLLMVariant

    The Google API LLM variant to use.

    +

    Returns GoogleLLMVariant

Methods

  • Gets the OpenAPI specification of this tool in the form of a FunctionDeclaration.

    NOTE

      @@ -366,14 +366,14 @@

    Returns FunctionDeclaration

    The FunctionDeclaration of this tool, or undefined if it doesn't need to be added to LlmRequest.config.

    -
  • Runs the tool with the given arguments and context.

    +

Returns Promise<void>

+
diff --git a/docs/api-reference/typescript/classes/BaseAgent.html b/docs/api-reference/typescript/classes/BaseAgent.html index 03cdb3a65..881012260 100644 --- a/docs/api-reference/typescript/classes/BaseAgent.html +++ b/docs/api-reference/typescript/classes/BaseAgent.html @@ -350,65 +350,65 @@ border-radius: 4px; margin-left: 4px; ">

Class BaseAgentAbstract

Base class for all agents in Agent Development Kit.

-

Hierarchy (View Summary)

Constructors

Properties

afterAgentCallback: SingleAgentCallback[]

Callback or list of callbacks to be invoked after the agent run.

+

Hierarchy (View Summary)

Constructors

Properties

afterAgentCallback: SingleAgentCallback[]

Callback or list of callbacks to be invoked after the agent run.

When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

MUST be named 'callbackContext' (enforced).

Content: The content to return to the user. When the content is present, the provided content will be used as agent response and appended to event history as agent response.

-
beforeAgentCallback: SingleAgentCallback[]

Callback or list of callbacks to be invoked before the agent run.

+
beforeAgentCallback: SingleAgentCallback[]

Callback or list of callbacks to be invoked before the agent run.

When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

MUST be named 'callbackContext' (enforced).

Content: The content to return to the user. When the content is present, the agent run will be skipped and the provided content will be returned to user.

-
description?: string

Description about the agent's capability.

+
description?: string

Description about the agent's capability.

The model uses this to determine whether to delegate control to the agent. One-line description is enough and preferred.

-
name: string

The agent's name. +

name: string

The agent's name. Agent name must be a JS identifier and unique within the agent tree. Agent name cannot be "user", since it's reserved for end-user's input.

-
parentAgent?: BaseAgent

The parent agent of this agent.

+
parentAgent?: BaseAgent

The parent agent of this agent.

Note that an agent can ONLY be added as sub-agent once.

If you want to add one agent twice as sub-agent, consider to create two agent instances with identical config, but with different name and add them to the agent tree.

The parent agent is the agent that created this agent.

-
rootAgent: BaseAgent

Root agent of this agent.

-
subAgents: BaseAgent[]

The sub-agents of this agent.

-

Methods

rootAgent: BaseAgent

Root agent of this agent.

+
subAgents: BaseAgent[]

The sub-agents of this agent.

+

Methods

  • Finds the agent with the given name in this agent and its descendants.

    Parameters

    • name: string

      The name of the agent to find.

    Returns BaseAgent | undefined

    The agent with the given name, or undefined if not found.

    -
  • Finds the agent with the given name in this agent's descendants.

    Parameters

    • name: string

      The name of the agent to find.

    Returns BaseAgent | undefined

    The agent with the given name, or undefined if not found.

    -
  • Entry method to run an agent via text-based conversation.

    Parameters

    Returns AsyncGenerator<Event, void, void>

    An AsyncGenerator that yields the events generated by the agent.

    The events generated by the agent.

    -
  • Core logic to run this agent via text-based conversation.

    Parameters

    Returns AsyncGenerator<Event, void, void>

    An AsyncGenerator that yields the events generated by the agent.

    The events generated by the agent.

    -
  • Entry method to run an agent via video/audio-based conversation.

    Parameters

    Returns AsyncGenerator<Event, void, void>

    An AsyncGenerator that yields the events generated by the agent.

    The events generated by the agent.

    -
  • Core logic to run this agent via video/audio-based conversation.

    Parameters

    Returns AsyncGenerator<Event, void, void>

    An AsyncGenerator that yields the events generated by the agent.

    The events generated by the agent.

    -
+
diff --git a/docs/api-reference/typescript/classes/BaseLlm.html b/docs/api-reference/typescript/classes/BaseLlm.html index 534867ad0..9d136b7d0 100644 --- a/docs/api-reference/typescript/classes/BaseLlm.html +++ b/docs/api-reference/typescript/classes/BaseLlm.html @@ -350,20 +350,19 @@ border-radius: 4px; margin-left: 4px; ">

Class BaseLlmAbstract

The BaseLLM class.

-

Hierarchy (View Summary)

Constructors

  • Creates an instance of BaseLLM.

    -

    Parameters

    • model: string

      The name of the LLM, e.g. gemini-1.5-flash or +

Hierarchy (View Summary)

Constructors

  • Creates an instance of BaseLLM.

    +

    Parameters

    • params: { model: string }

      The parameters for creating a BaseLlm instance.

      +
      • model: string

        The name of the LLM, e.g. gemini-1.5-flash or gemini-1.5-flash-001.

        -

    Returns BaseLlm

Properties

model: string

The name of the LLM, e.g. gemini-1.5-flash or -gemini-1.5-flash-001.

-
supportedModels: (string | RegExp)[] = []

List of supported models in regex for LlmRegistry.

-

Methods

Returns BaseLlm

Properties

model: string
supportedModels: (string | RegExp)[] = []

List of supported models in regex for LlmRegistry.

+

Methods

  • Generates one content from the given contents and tools.

    Parameters

    • llmRequest: LlmRequest

      LlmRequest, the request to send to the LLM.

    • Optionalstream: boolean

      whether to do streaming call. For non-streaming call, it will only yield one Content.

    Returns AsyncGenerator<LlmResponse, void>

    A generator of LlmResponse.

    -
+

Returns void

diff --git a/docs/api-reference/typescript/classes/BasePlugin.html b/docs/api-reference/typescript/classes/BasePlugin.html index 4e727f30d..f5d6202e1 100644 --- a/docs/api-reference/typescript/classes/BasePlugin.html +++ b/docs/api-reference/typescript/classes/BasePlugin.html @@ -382,28 +382,28 @@
class ToolLoggerPlugin extends BasePlugin {
constructor() {
super('tool_logger');
}

override async beforeToolCallback(
{tool, toolArgs, toolContext}: {
tool: BaseTool,
toolArgs: Record<string, unknown>,
toolContext: ToolContext,
},
): Promise<Record<string, unknown> | undefined> {
this.logger.info(
`[${this.name}] Calling tool '${tool.name}' with args:
${JSON.stringify( toolArgs,
)}`,
);
return;
}

override async afterToolCallback(
{tool, toolArgs, toolContext, result}: {
tool: BaseTool,
toolArgs: Record<string, unknown>,
toolContext: ToolContext,
result: Record<string, unknown>,
},
): Promise<Record<string, unknown> | undefined> {
this.logger.info(
`[${this.name}] Tool '${tool.name}' finished with result:
${JSON.stringify( result,
)}`,
);
return;
}
}

// Add the plugin to ADK Runner
// runner = new Runner({
// ...
// plugins: [new ToolLoggerPlugin(), new AgentPolicyPlugin()],
// });
-

Hierarchy (View Summary)

Constructors

  • Initializes the plugin.

    +

Hierarchy (View Summary)

Constructors

Properties

name: string

Methods

  • Callback executed after an agent's primary logic has completed.

    +

Returns BasePlugin

Properties

name: string

Methods

  • Callback executed after an agent's primary logic has completed.

    This callback can be used to inspect, log, or modify the agent's final result before it is returned.

    Parameters

    Returns Promise<Content | undefined>

    An optional Content object. If a value is returned, it will replace the agent's original result. Returning undefined uses the original, unmodified result.

    -
  • Callback executed after a response is received from the model.

    This is the ideal place to log model responses, collect metrics on token usage, or perform post-processing on the raw LlmResponse.

    Parameters

    Returns Promise<LlmResponse | undefined>

    An optional value. A non-undefined return may be used by the framework to modify or replace the response. Returning undefined allows the original response to be used.

    -
  • Callback executed after an ADK runner run has completed.

    This is the final callback in the ADK lifecycle, suitable for cleanup, final logging, or reporting tasks.

    Parameters

    • invocationContext: { invocationContext: InvocationContext }

      The context for the entire invocation.

    Returns Promise<void>

    undefined

    -
  • Callback executed after a tool has been called.

    +
  • Callback executed after a tool has been called.

    This callback allows for inspecting, logging, or modifying the result returned by a tool.

    Parameters

    • tool: {
          result: Record<string, unknown>;
          tool: BaseTool;
          toolArgs: Record<string, unknown>;
          toolContext: ToolContext;
      }

      The tool instance that has just been executed.

      @@ -411,14 +411,14 @@ replace the original result from the tool. This allows for post-processing or altering tool outputs. Returning undefined uses the original, unmodified result.

      -
  • Callback executed before an agent's primary logic is invoked.

    This callback can be used for logging, setup, or to short-circuit the agent's execution by returning a value.

    Parameters

    Returns Promise<Content | undefined>

    An optional Content object. If a value is returned, it will bypass the agent's callbacks and its execution, and return this value directly. Returning undefined allows the agent to proceed normally.

    -
  • Callback executed before a request is sent to the model.

    This provides an opportunity to inspect, log, or modify the LlmRequest object. It can also be used to implement caching by returning a cached LlmResponse, which would skip the actual model call.

    @@ -426,7 +426,7 @@

Returns Promise<LlmResponse | undefined>

An optional value. The interpretation of a non-undefined trigger an early exit and returns the response immediately. Returning undefined allows the LLM request to proceed normally.

-
  • Callback executed before the ADK runner runs.

    This is the first callback to be called in the lifecycle, ideal for global setup or initialization tasks.

    Parameters

    • invocationContext: { invocationContext: InvocationContext }

      The context for the entire invocation, containing @@ -434,35 +434,35 @@

    Returns Promise<Content | undefined>

    An optional Event to be returned to the ADK. Returning a value to halt execution of the runner and ends the runner with that event. Return undefined to proceed normally.

    -
  • Callback executed before a tool is called.

    +
  • Callback executed before a tool is called.

    This callback is useful for logging tool usage, input validation, or modifying the arguments before they are passed to the tool.

    Parameters

    • tool: { tool: BaseTool; toolArgs: Record<string, unknown>; toolContext: ToolContext }

      The tool instance that is about to be executed.

    Returns Promise<Record<string, unknown> | undefined>

    An optional dictionary. If a dictionary is returned, it will stop the tool execution and return this response immediately. Returning undefined uses the original, unmodified arguments.

    -
  • Callback executed after an event is yielded from runner.

    This is the ideal place to make modification to the event before the event is handled by the underlying agent app.

    Parameters

    • invocationContext: { event: Event; invocationContext: InvocationContext }

      The context for the entire invocation.

    Returns Promise<Event | undefined>

    An optional value. A non-undefined return may be used by the framework to modify or replace the response. Returning undefined allows the original response to be used.

    -
  • Callback executed when a model call encounters an error.

    This callback provides an opportunity to handle model errors gracefully, potentially providing alternative responses or recovery mechanisms.

    Parameters

    • callbackContext: { callbackContext: CallbackContext; error: Error; llmRequest: LlmRequest }

      The context for the current agent call.

    Returns Promise<LlmResponse | undefined>

    An optional LlmResponse. If an LlmResponse is returned, it will be used instead of propagating the error. Returning undefined allows the original error to be raised.

    -
  • Callback executed when a tool call encounters an error.

    +
  • Callback executed when a tool call encounters an error.

    This callback provides an opportunity to handle tool errors gracefully, potentially providing alternative responses or recovery mechanisms.

    Parameters

    • tool: {
          error: Error;
          tool: BaseTool;
          toolArgs: Record<string, unknown>;
          toolContext: ToolContext;
      }

      The tool instance that encountered an error.

    Returns Promise<Record<string, unknown> | undefined>

    An optional dictionary. If a dictionary is returned, it will be used as the tool response instead of propagating the error. Returning undefined allows the original error to be raised.

    -
  • Callback executed when a user message is received before an invocation +

  • Callback executed when a user message is received before an invocation starts.

    This callback helps logging and modifying the user message before the runner starts the invocation.

    @@ -470,4 +470,4 @@

Returns Promise<Content | undefined>

An optional Content to be returned to the ADK. Returning a value to replace the user message. Returning undefined to proceed normally.

-
+
diff --git a/docs/api-reference/typescript/classes/BaseSessionService.html b/docs/api-reference/typescript/classes/BaseSessionService.html index c5c314652..a5217b4ee 100644 --- a/docs/api-reference/typescript/classes/BaseSessionService.html +++ b/docs/api-reference/typescript/classes/BaseSessionService.html @@ -351,20 +351,20 @@ margin-left: 4px; ">

Class BaseSessionServiceAbstract

Base class for session services.

The service provides a set of methods for managing sessions and events.

-

Hierarchy (View Summary)

Constructors

Methods

Hierarchy (View Summary)

Constructors

Methods

+
diff --git a/docs/api-reference/typescript/classes/BaseTool.html b/docs/api-reference/typescript/classes/BaseTool.html index 35f2b7848..cac95c157 100644 --- a/docs/api-reference/typescript/classes/BaseTool.html +++ b/docs/api-reference/typescript/classes/BaseTool.html @@ -350,10 +350,10 @@ border-radius: 4px; margin-left: 4px; ">

Class BaseToolAbstract

The base class for all tools.

-

Hierarchy (View Summary)

Constructors

Hierarchy (View Summary)

Constructors

Properties

description: string
isLongRunning: boolean
name: string

Accessors

Methods

  • Gets the OpenAPI specification of this tool in the form of a +

Returns BaseTool

Properties

description: string
isLongRunning: boolean
name: string

Accessors

Methods

  • Gets the OpenAPI specification of this tool in the form of a FunctionDeclaration.

    NOTE

      @@ -364,14 +364,14 @@

    Returns FunctionDeclaration | undefined

    The FunctionDeclaration of this tool, or undefined if it doesn't need to be added to LlmRequest.config.

    -
  • Processes the outgoing LLM request for this tool.

    Use cases:

    • Most common use case is adding this tool to the LLM request.
    • Some tools may just preprocess the LLM request before it's sent out.

    Parameters

    Returns Promise<void>

  • Runs the tool with the given arguments and context.

    +

Returns Promise<void>

  • Runs the tool with the given arguments and context.

    NOTE

    • Required if this tool needs to run at the client side.
    • @@ -380,4 +380,4 @@

    Parameters

    Returns Promise<unknown>

    A promise that resolves to the tool response.

    -
+
diff --git a/docs/api-reference/typescript/classes/BaseToolset.html b/docs/api-reference/typescript/classes/BaseToolset.html index af53e4a8a..164813db0 100644 --- a/docs/api-reference/typescript/classes/BaseToolset.html +++ b/docs/api-reference/typescript/classes/BaseToolset.html @@ -351,21 +351,21 @@ margin-left: 4px; ">

Class BaseToolsetAbstract

Base class for toolset.

A toolset is a collection of tools that can be used by an agent.

-

Hierarchy (View Summary)

Constructors

Properties

toolFilter: string[] | ToolPredicate

Methods

  • Closes the toolset.

    +

Hierarchy (View Summary)

Constructors

Properties

toolFilter: string[] | ToolPredicate

Methods

  • Closes the toolset.

    NOTE: This method is invoked, for example, at the end of an agent server's lifecycle or when the toolset is no longer needed. Implementations should ensure that any open connections, files, or other managed resources are properly released to prevent leaks.

    Returns Promise<void>

    A Promise that resolves when the toolset is closed.

    -
  • Returns the tools that should be exposed to LLM.

    Parameters

    • Optionalcontext: ReadonlyContext

      Context used to filter tools available to the agent. If not defined, all tools in the toolset are returned.

    Returns Promise<BaseTool[]>

    A Promise that resolves to the list of tools.

    -
  • Returns whether the tool should be exposed to LLM.

    Parameters

    • tool: BaseTool

      The tool to check.

    • context: ReadonlyContext

      Context used to filter tools available to the agent.

    Returns boolean

    Whether the tool should be exposed to LLM.

    -
  • Processes the outgoing LLM request for this toolset. This method will be called before each tool processes the llm request.

    Use cases:

      @@ -375,4 +375,4 @@

    Parameters

    • toolContext: ToolContext

      The context of the tool.

    • llmRequest: LlmRequest

      The outgoing LLM request, mutable this method.

      -

    Returns Promise<void>

+

Returns Promise<void>

diff --git a/docs/api-reference/typescript/classes/CallbackContext.html b/docs/api-reference/typescript/classes/CallbackContext.html index 40ea49b66..c4077c7d3 100644 --- a/docs/api-reference/typescript/classes/CallbackContext.html +++ b/docs/api-reference/typescript/classes/CallbackContext.html @@ -350,17 +350,17 @@ border-radius: 4px; margin-left: 4px; ">

Class CallbackContext

The context of various callbacks within an agent run.

-

Hierarchy (View Summary)

Constructors

Properties

eventActions: EventActions
invocationContext: InvocationContext

Accessors

  • get userContent(): Content | undefined

    The user content that started this invocation.

    -

    Returns Content | undefined

Methods

  • Loads an artifact attached to the current session.

    +

Hierarchy (View Summary)

Constructors

Properties

eventActions: EventActions
invocationContext: InvocationContext

Accessors

  • get userContent(): Content | undefined

    The user content that started this invocation.

    +

    Returns Content | undefined

Methods

  • Loads an artifact attached to the current session.

    Parameters

    • filename: string

      The filename of the artifact.

    • Optionalversion: number

      The version of the artifact. If not provided, the latest version will be used.

    Returns Promise<Part | undefined>

    A promise that resolves to the loaded artifact.

    -
  • Saves an artifact attached to the current session.

    Parameters

    • filename: string

      The filename of the artifact.

    • artifact: Part

      The artifact to save.

    Returns Promise<number>

    A promise that resolves to the version of the saved artifact.

    -
+
diff --git a/docs/api-reference/typescript/classes/FunctionTool.html b/docs/api-reference/typescript/classes/FunctionTool.html index 29a2adcb0..4804569b8 100644 --- a/docs/api-reference/typescript/classes/FunctionTool.html +++ b/docs/api-reference/typescript/classes/FunctionTool.html @@ -350,16 +350,16 @@ border-radius: 4px; margin-left: 4px; ">

Class FunctionTool<TParameters>

The base class for all tools.

-

Type Parameters

  • TParameters extends ToolInputParameters = undefined

Hierarchy (View Summary)

Constructors

Type Parameters

  • TParameters extends ToolInputParameters = undefined

Hierarchy (View Summary)

Constructors

Properties

description: string
isLongRunning: boolean
name: string

Accessors

  • get apiVariant(): GoogleLLMVariant

    The Google API LLM variant to use.

    -

    Returns GoogleLLMVariant

Methods

  • Processes the outgoing LLM request for this tool.

    +

Returns FunctionTool<TParameters>

Properties

description: string
isLongRunning: boolean
name: string

Accessors

  • get apiVariant(): GoogleLLMVariant

    The Google API LLM variant to use.

    +

    Returns GoogleLLMVariant

Methods

+

Returns Promise<void>

diff --git a/docs/api-reference/typescript/classes/GcsArtifactService.html b/docs/api-reference/typescript/classes/GcsArtifactService.html index 59e4e9684..a96cc52fa 100644 --- a/docs/api-reference/typescript/classes/GcsArtifactService.html +++ b/docs/api-reference/typescript/classes/GcsArtifactService.html @@ -350,23 +350,23 @@ border-radius: 4px; margin-left: 4px; ">

Class GcsArtifactService

Interface for artifact services.

-

Implements

Constructors

Methods

Implements

Constructors

Methods

  • Saves an artifact to the artifact service storage.

    The artifact is a file identified by the app name, user ID, session ID, and filename. After saving the artifact, a revision ID is returned to identify the artifact version.

    @@ -374,4 +374,4 @@

Returns Promise<number>

A promise that resolves to The revision ID. The first version of the artifact has a revision ID of 0. This is incremented by 1 after each successful save.

-
+
diff --git a/docs/api-reference/typescript/classes/Gemini.html b/docs/api-reference/typescript/classes/Gemini.html index 503bd8a93..8c94f0222 100644 --- a/docs/api-reference/typescript/classes/Gemini.html +++ b/docs/api-reference/typescript/classes/Gemini.html @@ -350,18 +350,16 @@ border-radius: 4px; margin-left: 4px; ">

Class Gemini

Integration for Gemini models.

-

Hierarchy (View Summary)

Constructors

Properties

model: string

The name of the LLM, e.g. gemini-1.5-flash or -gemini-1.5-flash-001.

-
supportedModels: (string | RegExp)[] = ...

A list of model name patterns that are supported by this LLM.

+

Hierarchy (View Summary)

Constructors

Properties

model: string
supportedModels: (string | RegExp)[] = ...

A list of model name patterns that are supported by this LLM.

A list of supported models.

-

Accessors

Methods

Accessors

Methods

+

Returns void

diff --git a/docs/api-reference/typescript/classes/InMemoryArtifactService.html b/docs/api-reference/typescript/classes/InMemoryArtifactService.html index 9b3abcb22..b5bedc7cd 100644 --- a/docs/api-reference/typescript/classes/InMemoryArtifactService.html +++ b/docs/api-reference/typescript/classes/InMemoryArtifactService.html @@ -350,23 +350,23 @@ border-radius: 4px; margin-left: 4px; ">

Class InMemoryArtifactService

An in-memory implementation of the ArtifactService.

-

Implements

Constructors

Methods

Implements

Constructors

Methods

  • Saves an artifact to the artifact service storage.

    The artifact is a file identified by the app name, user ID, session ID, and filename. After saving the artifact, a revision ID is returned to identify the artifact version.

    @@ -374,4 +374,4 @@

Returns Promise<number>

A promise that resolves to The revision ID. The first version of the artifact has a revision ID of 0. This is incremented by 1 after each successful save.

-
+
diff --git a/docs/api-reference/typescript/classes/InMemoryMemoryService.html b/docs/api-reference/typescript/classes/InMemoryMemoryService.html index 347fe207a..33b8577af 100644 --- a/docs/api-reference/typescript/classes/InMemoryMemoryService.html +++ b/docs/api-reference/typescript/classes/InMemoryMemoryService.html @@ -351,10 +351,10 @@ margin-left: 4px; ">

Class InMemoryMemoryService

An in-memory memory service for prototyping purpose only.

Uses keyword matching instead of semantic search.

-

Implements

Constructors

Methods

  • Adds a session to the memory.

    +

Implements

Constructors

Methods

+
diff --git a/docs/api-reference/typescript/classes/InMemoryPolicyEngine.html b/docs/api-reference/typescript/classes/InMemoryPolicyEngine.html index 0ca35a6d1..633ec32c6 100644 --- a/docs/api-reference/typescript/classes/InMemoryPolicyEngine.html +++ b/docs/api-reference/typescript/classes/InMemoryPolicyEngine.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

Class InMemoryPolicyEngine

Implements

Constructors

Methods

+ ">

Class InMemoryPolicyEngine

Implements

Constructors

Methods

diff --git a/docs/api-reference/typescript/classes/InMemoryRunner.html b/docs/api-reference/typescript/classes/InMemoryRunner.html index 9e7af68b1..af3e10589 100644 --- a/docs/api-reference/typescript/classes/InMemoryRunner.html +++ b/docs/api-reference/typescript/classes/InMemoryRunner.html @@ -349,8 +349,8 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

Class InMemoryRunner

Hierarchy (View Summary)

Constructors

Properties

agent: BaseAgent
appName: string
artifactService?: BaseArtifactService
credentialService?: BaseCredentialService
memoryService?: BaseMemoryService
pluginManager: PluginManager
sessionService: BaseSessionService

Methods

diff --git a/docs/api-reference/typescript/classes/InMemorySessionService.html b/docs/api-reference/typescript/classes/InMemorySessionService.html index 2c8130c80..1b764c743 100644 --- a/docs/api-reference/typescript/classes/InMemorySessionService.html +++ b/docs/api-reference/typescript/classes/InMemorySessionService.html @@ -350,20 +350,20 @@ border-radius: 4px; margin-left: 4px; ">

Class InMemorySessionService

An in-memory implementation of the session service.

-

Hierarchy (View Summary)

Constructors

Methods

Hierarchy (View Summary)

Constructors

Methods

+
diff --git a/docs/api-reference/typescript/classes/InvocationContext.html b/docs/api-reference/typescript/classes/InvocationContext.html index 13d380938..fbd074488 100644 --- a/docs/api-reference/typescript/classes/InvocationContext.html +++ b/docs/api-reference/typescript/classes/InvocationContext.html @@ -379,25 +379,25 @@
   ┌─────────────────────── invocation ──────────────────────────┐
┌──────────── llm_agent_call_1 ────────────┐ ┌─ agent_call_2 ─┐
┌──── step_1 ────────┐ ┌───── step_2 ──────┐
[call_llm] [call_tool] [call_llm] [transfer]
-

Constructors

Properties

activeStreamingTools?: Record<string, ActiveStreamingTool>

The running streaming tools of this invocation.

-
agent: BaseAgent

The current agent of this invocation context.

-
artifactService?: BaseArtifactService
branch?: string

The branch of the invocation context.

+

Constructors

Properties

activeStreamingTools?: Record<string, ActiveStreamingTool>

The running streaming tools of this invocation.

+
agent: BaseAgent

The current agent of this invocation context.

+
artifactService?: BaseArtifactService
branch?: string

The branch of the invocation context.

The format is like agent_1.agent_2.agent_3, where agent_1 is the parent of agent_2, and agent_2 is the parent of agent_3.

Branch is used when multiple sub-agents shouldn't see their peer agents' conversation history.

-
credentialService?: BaseCredentialService
endInvocation: boolean

Whether to end this invocation. +

credentialService?: BaseCredentialService
endInvocation: boolean

Whether to end this invocation. Set to True in callbacks or tools to terminate this invocation.

-
invocationId: string

The id of this invocation context.

-
liveRequestQueue?: LiveRequestQueue

The queue to receive live requests.

-
memoryService?: BaseMemoryService
pluginManager: PluginManager

The manager for keeping track of plugins in this invocation.

-
runConfig?: RunConfig

Configurations for live agents under this invocation.

-
session: Session

The current session of this invocation context.

-
sessionService?: BaseSessionService
transcriptionCache?: TranscriptionEntry[]

Caches necessary, data audio or contents, that are needed by transcription.

-
userContent?: Content

The user content that started this invocation.

-

Accessors

Methods

invocationId: string

The id of this invocation context.

+
liveRequestQueue?: LiveRequestQueue

The queue to receive live requests.

+
memoryService?: BaseMemoryService
pluginManager: PluginManager

The manager for keeping track of plugins in this invocation.

+
runConfig?: RunConfig

Configurations for live agents under this invocation.

+
session: Session

The current session of this invocation context.

+
sessionService?: BaseSessionService
transcriptionCache?: TranscriptionEntry[]

Caches necessary, data audio or contents, that are needed by transcription.

+
userContent?: Content

The user content that started this invocation.

+

Accessors

Methods

+
diff --git a/docs/api-reference/typescript/classes/LLMRegistry.html b/docs/api-reference/typescript/classes/LLMRegistry.html new file mode 100644 index 000000000..993e429fe --- /dev/null +++ b/docs/api-reference/typescript/classes/LLMRegistry.html @@ -0,0 +1,362 @@ +LLMRegistry | ADK for TypeScript: API Reference
ADK for TypeScript: API Reference
    Preparing search index...

    Class LLMRegistry

    Registry for LLMs.

    +

    Constructors

    Methods

    • Registers a new LLM class.

      +

      Type Parameters

      Parameters

      • llmCls: new (params: { model: string }) => T & { supportedModels: (string | RegExp)[] }

        The class that implements the model.

        +

      Returns void

    • Resolves the model to a BaseLlm subclass.

      +

      Parameters

      • model: string

        The model name.

        +

      Returns BaseLlmType

      The BaseLlm subclass.

      +

      If the model is not found.

      +
    diff --git a/docs/api-reference/typescript/classes/LiveRequestQueue.html b/docs/api-reference/typescript/classes/LiveRequestQueue.html index f50988778..7cfddd3be 100644 --- a/docs/api-reference/typescript/classes/LiveRequestQueue.html +++ b/docs/api-reference/typescript/classes/LiveRequestQueue.html @@ -350,18 +350,18 @@ border-radius: 4px; margin-left: 4px; ">

    Class LiveRequestQueue

    Queue used to send LiveRequest in a live (bidirectional streaming) way.

    -

    Constructors

    Methods

    • Retrieves a request from the queue. If the queue is empty, it will +

    Constructors

    Methods

    • Sends a content object to the queue.

      +

    Returns void

    Returns void

    +

    Returns void

    diff --git a/docs/api-reference/typescript/classes/LlmAgent.html b/docs/api-reference/typescript/classes/LlmAgent.html index 41bed0b3a..0de91b768 100644 --- a/docs/api-reference/typescript/classes/LlmAgent.html +++ b/docs/api-reference/typescript/classes/LlmAgent.html @@ -350,89 +350,89 @@ border-radius: 4px; margin-left: 4px; ">

    Class LlmAgent

    An agent that uses a large language model to generate responses.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    +

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the provided content will be used as agent response and appended to event history as agent response.

    -
    afterModelCallback?: AfterModelCallback
    afterToolCallback?: AfterToolCallback
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    +
    afterModelCallback?: AfterModelCallback
    afterToolCallback?: AfterToolCallback
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the agent run will be skipped and the provided content will be returned to user.

    -
    beforeModelCallback?: BeforeModelCallback
    beforeToolCallback?: BeforeToolCallback
    description?: string

    Description about the agent's capability.

    +
    beforeModelCallback?: BeforeModelCallback
    beforeToolCallback?: BeforeToolCallback
    description?: string

    Description about the agent's capability.

    The model uses this to determine whether to delegate control to the agent. One-line description is enough and preferred.

    -
    disallowTransferToParent: boolean
    disallowTransferToPeers: boolean
    generateContentConfig?: GenerateContentConfig
    globalInstruction: string | InstructionProvider
    includeContents: "none" | "default"
    inputSchema?: Schema
    instruction: string | InstructionProvider
    model?: string | BaseLlm
    name: string

    The agent's name. +

    disallowTransferToParent: boolean
    disallowTransferToPeers: boolean
    generateContentConfig?: GenerateContentConfig
    globalInstruction: string | InstructionProvider
    includeContents: "none" | "default"
    inputSchema?: Schema
    instruction: string | InstructionProvider
    model?: string | BaseLlm
    name: string

    The agent's name. Agent name must be a JS identifier and unique within the agent tree. Agent name cannot be "user", since it's reserved for end-user's input.

    -
    outputKey?: string
    outputSchema?: Schema
    parentAgent?: BaseAgent

    The parent agent of this agent.

    +
    outputKey?: string
    outputSchema?: Schema
    parentAgent?: BaseAgent

    The parent agent of this agent.

    Note that an agent can ONLY be added as sub-agent once.

    If you want to add one agent twice as sub-agent, consider to create two agent instances with identical config, but with different name and add them to the agent tree.

    The parent agent is the agent that created this agent.

    -
    requestProcessors: BaseLlmRequestProcessor[]
    responseProcessors: BaseLlmResponseProcessor[]
    rootAgent: BaseAgent

    Root agent of this agent.

    -
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    -
    tools: ToolUnion[]

    Accessors

    requestProcessors: BaseLlmRequestProcessor[]
    responseProcessors: BaseLlmResponseProcessor[]
    rootAgent: BaseAgent

    Root agent of this agent.

    +
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    +
    tools: ToolUnion[]

    Accessors

    Methods

    • The resolved self.instruction field to construct global instruction.

      +

      Returns BaseLlm

    Methods

    • The resolved self.instruction field to construct global instruction.

      This method is only for use by Agent Development Kit.

      Parameters

      • context: ReadonlyContext

        The context to retrieve the session state.

      Returns Promise<{ instruction: string; requireStateInjection: boolean }>

      The resolved self.global_instruction field.

      -
    • The resolved self.instruction field to construct instruction for this +

    • The resolved self.instruction field to construct instruction for this agent.

      This method is only for use by Agent Development Kit.

      Parameters

      • context: ReadonlyContext

        The context to retrieve the session state.

      Returns Promise<{ instruction: string; requireStateInjection: boolean }>

      The resolved self.instruction field.

      -
    • The resolved self.tools field as a list of BaseTool based on the context.

      This method is only for use by Agent Development Kit.

      -

      Parameters

      • Optionalcontext: ReadonlyContext

      Returns Promise<BaseTool[]>

    +
    diff --git a/docs/api-reference/typescript/classes/LoggingPlugin.html b/docs/api-reference/typescript/classes/LoggingPlugin.html index 93458dd4d..61c777f45 100644 --- a/docs/api-reference/typescript/classes/LoggingPlugin.html +++ b/docs/api-reference/typescript/classes/LoggingPlugin.html @@ -367,28 +367,28 @@
    const loggingPlugin = new LoggingPlugin();
    const runner = new Runner({
    agents: [myAgent],
    // ...
    plugins: [loggingPlugin],
    });
    -

    Hierarchy (View Summary)

    Constructors

    • Initialize the logging plugin.

      +

    Hierarchy (View Summary)

    Constructors

    Properties

    name: string

    Methods

    • Callback executed after an agent's primary logic has completed.

      +

    Returns LoggingPlugin

    Properties

    name: string

    Methods

    • Callback executed after an agent's primary logic has completed.

      This callback can be used to inspect, log, or modify the agent's final result before it is returned.

      Parameters

      Returns Promise<Content | undefined>

      An optional Content object. If a value is returned, it will replace the agent's original result. Returning undefined uses the original, unmodified result.

      -
    • Callback executed after a response is received from the model.

      This is the ideal place to log model responses, collect metrics on token usage, or perform post-processing on the raw LlmResponse.

      Parameters

      Returns Promise<LlmResponse | undefined>

      An optional value. A non-undefined return may be used by the framework to modify or replace the response. Returning undefined allows the original response to be used.

      -
    • Callback executed after an ADK runner run has completed.

      This is the final callback in the ADK lifecycle, suitable for cleanup, final logging, or reporting tasks.

      Parameters

      • invocationContext: { invocationContext: InvocationContext }

        The context for the entire invocation.

      Returns Promise<void>

      undefined

      -
    • Callback executed after a tool has been called.

      This callback allows for inspecting, logging, or modifying the result returned by a tool.

      Parameters

      • tool: {
            result: Record<string, unknown>;
            tool: BaseTool;
            toolArgs: Record<string, unknown>;
            toolContext: ToolContext;
        }

        The tool instance that has just been executed.

        @@ -396,14 +396,14 @@ replace the original result from the tool. This allows for post-processing or altering tool outputs. Returning undefined uses the original, unmodified result.

        -
    • Callback executed before an agent's primary logic is invoked.

      This callback can be used for logging, setup, or to short-circuit the agent's execution by returning a value.

      Parameters

      Returns Promise<Content | undefined>

      An optional Content object. If a value is returned, it will bypass the agent's callbacks and its execution, and return this value directly. Returning undefined allows the agent to proceed normally.

      -
    • Callback executed before a request is sent to the model.

      This provides an opportunity to inspect, log, or modify the LlmRequest object. It can also be used to implement caching by returning a cached LlmResponse, which would skip the actual model call.

      @@ -411,7 +411,7 @@

    Returns Promise<LlmResponse | undefined>

    An optional value. The interpretation of a non-undefined trigger an early exit and returns the response immediately. Returning undefined allows the LLM request to proceed normally.

    -
    • Callback executed before the ADK runner runs.

      This is the first callback to be called in the lifecycle, ideal for global setup or initialization tasks.

      Parameters

      • invocationContext: { invocationContext: InvocationContext }

        The context for the entire invocation, containing @@ -419,35 +419,35 @@

      Returns Promise<Content | undefined>

      An optional Event to be returned to the ADK. Returning a value to halt execution of the runner and ends the runner with that event. Return undefined to proceed normally.

      -
    • Callback executed before a tool is called.

      This callback is useful for logging tool usage, input validation, or modifying the arguments before they are passed to the tool.

      Parameters

      • tool: { tool: BaseTool; toolArgs: Record<string, unknown>; toolContext: ToolContext }

        The tool instance that is about to be executed.

      Returns Promise<Record<string, unknown> | undefined>

      An optional dictionary. If a dictionary is returned, it will stop the tool execution and return this response immediately. Returning undefined uses the original, unmodified arguments.

      -
    • Callback executed after an event is yielded from runner.

      This is the ideal place to make modification to the event before the event is handled by the underlying agent app.

      Parameters

      • invocationContext: { event: Event; invocationContext: InvocationContext }

        The context for the entire invocation.

      Returns Promise<Event | undefined>

      An optional value. A non-undefined return may be used by the framework to modify or replace the response. Returning undefined allows the original response to be used.

      -
    • Callback executed when a model call encounters an error.

      This callback provides an opportunity to handle model errors gracefully, potentially providing alternative responses or recovery mechanisms.

      Parameters

      • callbackContext: { callbackContext: CallbackContext; error: Error; llmRequest: LlmRequest }

        The context for the current agent call.

      Returns Promise<LlmResponse | undefined>

      An optional LlmResponse. If an LlmResponse is returned, it will be used instead of propagating the error. Returning undefined allows the original error to be raised.

      -
    • Callback executed when a tool call encounters an error.

      This callback provides an opportunity to handle tool errors gracefully, potentially providing alternative responses or recovery mechanisms.

      Parameters

      • tool: {
            error: Error;
            tool: BaseTool;
            toolArgs: Record<string, unknown>;
            toolContext: ToolContext;
        }

        The tool instance that encountered an error.

      Returns Promise<Record<string, unknown> | undefined>

      An optional dictionary. If a dictionary is returned, it will be used as the tool response instead of propagating the error. Returning undefined allows the original error to be raised.

      -
    • Callback executed when a user message is received before an invocation starts.

      This callback helps logging and modifying the user message before the runner starts the invocation.

      @@ -455,4 +455,4 @@

    Returns Promise<Content | undefined>

    An optional Content to be returned to the ADK. Returning a value to replace the user message. Returning undefined to proceed normally.

    -
    +
    diff --git a/docs/api-reference/typescript/classes/LongRunningFunctionTool.html b/docs/api-reference/typescript/classes/LongRunningFunctionTool.html index 1ab7851a9..dc04691aa 100644 --- a/docs/api-reference/typescript/classes/LongRunningFunctionTool.html +++ b/docs/api-reference/typescript/classes/LongRunningFunctionTool.html @@ -350,16 +350,16 @@ border-radius: 4px; margin-left: 4px; ">

    Class LongRunningFunctionTool<TParameters>

    The base class for all tools.

    -

    Type Parameters

    • TParameters extends ToolInputParameters = undefined

    Hierarchy (View Summary)

    Constructors

    Type Parameters

    • TParameters extends ToolInputParameters = undefined

    Hierarchy (View Summary)

    Constructors

    Properties

    description: string
    isLongRunning: boolean
    name: string

    Accessors

    • get apiVariant(): GoogleLLMVariant

      The Google API LLM variant to use.

      -

      Returns GoogleLLMVariant

    Methods

    • Processes the outgoing LLM request for this tool.

      +

    Returns LongRunningFunctionTool<TParameters>

    Properties

    description: string
    isLongRunning: boolean
    name: string

    Accessors

    • get apiVariant(): GoogleLLMVariant

      The Google API LLM variant to use.

      +

      Returns GoogleLLMVariant

    Methods

    +

    Returns Promise<void>

    diff --git a/docs/api-reference/typescript/classes/LoopAgent.html b/docs/api-reference/typescript/classes/LoopAgent.html index 1393f20b2..29336a69f 100644 --- a/docs/api-reference/typescript/classes/LoopAgent.html +++ b/docs/api-reference/typescript/classes/LoopAgent.html @@ -352,65 +352,65 @@ ">

    Class LoopAgent

    A shell agent that run its sub-agents in a loop.

    When sub-agent generates an event with escalate or max_iterations are reached, the loop agent will stop.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    +

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the provided content will be used as agent response and appended to event history as agent response.

    -
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    +
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the agent run will be skipped and the provided content will be returned to user.

    -
    description?: string

    Description about the agent's capability.

    +
    description?: string

    Description about the agent's capability.

    The model uses this to determine whether to delegate control to the agent. One-line description is enough and preferred.

    -
    name: string

    The agent's name. +

    name: string

    The agent's name. Agent name must be a JS identifier and unique within the agent tree. Agent name cannot be "user", since it's reserved for end-user's input.

    -
    parentAgent?: BaseAgent

    The parent agent of this agent.

    +
    parentAgent?: BaseAgent

    The parent agent of this agent.

    Note that an agent can ONLY be added as sub-agent once.

    If you want to add one agent twice as sub-agent, consider to create two agent instances with identical config, but with different name and add them to the agent tree.

    The parent agent is the agent that created this agent.

    -
    rootAgent: BaseAgent

    Root agent of this agent.

    -
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    -

    Methods

    rootAgent: BaseAgent

    Root agent of this agent.

    +
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    +

    Methods

    +
    diff --git a/docs/api-reference/typescript/classes/MCPSessionManager.html b/docs/api-reference/typescript/classes/MCPSessionManager.html index 6d550c5b0..f5c335d18 100644 --- a/docs/api-reference/typescript/classes/MCPSessionManager.html +++ b/docs/api-reference/typescript/classes/MCPSessionManager.html @@ -358,4 +358,4 @@ session creation and connection handling, providing a simple interface for creating new MCP client instances that can be used to interact with remote tools.

    -

    Constructors

    Methods

    +

    Constructors

    Methods

    diff --git a/docs/api-reference/typescript/classes/MCPTool.html b/docs/api-reference/typescript/classes/MCPTool.html index dc2a4f973..100c21441 100644 --- a/docs/api-reference/typescript/classes/MCPTool.html +++ b/docs/api-reference/typescript/classes/MCPTool.html @@ -359,8 +359,8 @@ invoked, which in turn establishes an MCP session, sends a callTool request with the provided arguments, and returns the result from the remote tool.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    description: string
    isLongRunning: boolean
    name: string

    Accessors

    • get apiVariant(): GoogleLLMVariant

      The Google API LLM variant to use.

      -

      Returns GoogleLLMVariant

    Methods

    • Gets the OpenAPI specification of this tool in the form of a +

    Hierarchy (View Summary)

    Constructors

    Properties

    description: string
    isLongRunning: boolean
    name: string

    Accessors

    • get apiVariant(): GoogleLLMVariant

      The Google API LLM variant to use.

      +

      Returns GoogleLLMVariant

    Methods

    • Gets the OpenAPI specification of this tool in the form of a FunctionDeclaration.

      NOTE

        @@ -371,14 +371,14 @@

      Returns FunctionDeclaration

      The FunctionDeclaration of this tool, or undefined if it doesn't need to be added to LlmRequest.config.

      -
    • Runs the tool with the given arguments and context.

      +

    Returns Promise<void>

    +
    diff --git a/docs/api-reference/typescript/classes/MCPToolset.html b/docs/api-reference/typescript/classes/MCPToolset.html index 24de0ebc0..16342f928 100644 --- a/docs/api-reference/typescript/classes/MCPToolset.html +++ b/docs/api-reference/typescript/classes/MCPToolset.html @@ -365,21 +365,21 @@ });

    const mcpToolset = new MCPToolset(connectionParams); const tools = await mcpToolset.getTools();

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    toolFilter: string[] | ToolPredicate

    Methods

    • Closes the toolset.

      +

    Hierarchy (View Summary)

    Constructors

    Properties

    toolFilter: string[] | ToolPredicate

    Methods

    • Closes the toolset.

      NOTE: This method is invoked, for example, at the end of an agent server's lifecycle or when the toolset is no longer needed. Implementations should ensure that any open connections, files, or other managed resources are properly released to prevent leaks.

      Returns Promise<void>

      A Promise that resolves when the toolset is closed.

      -
    • Returns the tools that should be exposed to LLM.

      Parameters

      • Optionalcontext: ReadonlyContext

        Context used to filter tools available to the agent. If not defined, all tools in the toolset are returned.

      Returns Promise<BaseTool[]>

      A Promise that resolves to the list of tools.

      -
    • Returns whether the tool should be exposed to LLM.

      Parameters

      • tool: BaseTool

        The tool to check.

      • context: ReadonlyContext

        Context used to filter tools available to the agent.

      Returns boolean

      Whether the tool should be exposed to LLM.

      -
    +

    Returns Promise<void>

    diff --git a/docs/api-reference/typescript/classes/ParallelAgent.html b/docs/api-reference/typescript/classes/ParallelAgent.html index feba4d3f5..5e8203d7d 100644 --- a/docs/api-reference/typescript/classes/ParallelAgent.html +++ b/docs/api-reference/typescript/classes/ParallelAgent.html @@ -356,65 +356,65 @@
  • Running different algorithms simultaneously.
  • Generating multiple responses for review by a subsequent evaluation agent.
  • -

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    +

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the provided content will be used as agent response and appended to event history as agent response.

    -
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    +
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the agent run will be skipped and the provided content will be returned to user.

    -
    description?: string

    Description about the agent's capability.

    +
    description?: string

    Description about the agent's capability.

    The model uses this to determine whether to delegate control to the agent. One-line description is enough and preferred.

    -
    name: string

    The agent's name. +

    name: string

    The agent's name. Agent name must be a JS identifier and unique within the agent tree. Agent name cannot be "user", since it's reserved for end-user's input.

    -
    parentAgent?: BaseAgent

    The parent agent of this agent.

    +
    parentAgent?: BaseAgent

    The parent agent of this agent.

    Note that an agent can ONLY be added as sub-agent once.

    If you want to add one agent twice as sub-agent, consider to create two agent instances with identical config, but with different name and add them to the agent tree.

    The parent agent is the agent that created this agent.

    -
    rootAgent: BaseAgent

    Root agent of this agent.

    -
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    -

    Methods

    rootAgent: BaseAgent

    Root agent of this agent.

    +
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    +

    Methods

    +
    diff --git a/docs/api-reference/typescript/classes/PluginManager.html b/docs/api-reference/typescript/classes/PluginManager.html index 97d61eb94..b4af847c1 100644 --- a/docs/api-reference/typescript/classes/PluginManager.html +++ b/docs/api-reference/typescript/classes/PluginManager.html @@ -359,26 +359,26 @@ for that specific event is halted, and the returned value is propagated up the call stack. This allows plugins to short-circuit operations like agent runs, tool calls, or model requests.

    -

    Constructors

    Constructors

    Methods

    • Retrieves a registered plugin by its name.

      +

    Returns PluginManager

    Methods

    • Retrieves a registered plugin by its name.

      Parameters

      • pluginName: string

        The name of the plugin to retrieve.

      Returns BasePlugin | undefined

      The plugin instance if found, otherwise undefined.

      -
    • Runs the afterToolCallback for all plugins.

      -

      Parameters

      • __namedParameters: {
            result: Record<string, unknown>;
            tool: BaseTool;
            toolArgs: Record<string, unknown>;
            toolContext: ToolContext;
        }

      Returns Promise<Record<string, unknown> | undefined>

    • Runs the beforeToolCallback for all plugins.

      -

      Parameters

      • __namedParameters: { tool: BaseTool; toolArgs: Record<string, unknown>; toolContext: ToolContext }

      Returns Promise<Record<string, unknown> | undefined>

    • Runs the onToolErrorCallback for all plugins.

      -

      Parameters

      • __namedParameters: {
            error: Error;
            tool: BaseTool;
            toolArgs: Record<string, unknown>;
            toolContext: ToolContext;
        }

      Returns Promise<Record<string, unknown> | undefined>

    • Runs the onUserMessageCallback for all plugins.

      -

      Parameters

      Returns Promise<Content | undefined>

    +
    diff --git a/docs/api-reference/typescript/classes/Runner.html b/docs/api-reference/typescript/classes/Runner.html index 04095db0f..38729df24 100644 --- a/docs/api-reference/typescript/classes/Runner.html +++ b/docs/api-reference/typescript/classes/Runner.html @@ -349,8 +349,8 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

    Class Runner

    Hierarchy (View Summary)

    Constructors

    Properties

    agent: BaseAgent
    appName: string
    artifactService?: BaseArtifactService
    credentialService?: BaseCredentialService
    memoryService?: BaseMemoryService
    pluginManager: PluginManager
    sessionService: BaseSessionService

    Methods

    diff --git a/docs/api-reference/typescript/classes/SecurityPlugin.html b/docs/api-reference/typescript/classes/SecurityPlugin.html index 06f42cb3c..90bb89846 100644 --- a/docs/api-reference/typescript/classes/SecurityPlugin.html +++ b/docs/api-reference/typescript/classes/SecurityPlugin.html @@ -350,26 +350,26 @@ border-radius: 4px; margin-left: 4px; ">

    Class SecurityPlugin

    Security Plugin for running Orcas agents.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    name: string

    Methods

    • Callback executed after an agent's primary logic has completed.

      +

    Hierarchy (View Summary)

    Constructors

    Properties

    name: string

    Methods

    • Callback executed after an agent's primary logic has completed.

      This callback can be used to inspect, log, or modify the agent's final result before it is returned.

      Parameters

      Returns Promise<Content | undefined>

      An optional Content object. If a value is returned, it will replace the agent's original result. Returning undefined uses the original, unmodified result.

      -
    • Callback executed after a response is received from the model.

      This is the ideal place to log model responses, collect metrics on token usage, or perform post-processing on the raw LlmResponse.

      Parameters

      Returns Promise<LlmResponse | undefined>

      An optional value. A non-undefined return may be used by the framework to modify or replace the response. Returning undefined allows the original response to be used.

      -
    • Callback executed after an ADK runner run has completed.

      This is the final callback in the ADK lifecycle, suitable for cleanup, final logging, or reporting tasks.

      Parameters

      • invocationContext: { invocationContext: InvocationContext }

        The context for the entire invocation.

      Returns Promise<void>

      undefined

      -
    • Callback executed after a tool has been called.

      This callback allows for inspecting, logging, or modifying the result returned by a tool.

      Parameters

      • tool: {
            result: Record<string, unknown>;
            tool: BaseTool;
            toolArgs: Record<string, unknown>;
            toolContext: ToolContext;
        }

        The tool instance that has just been executed.

        @@ -377,14 +377,14 @@ replace the original result from the tool. This allows for post-processing or altering tool outputs. Returning undefined uses the original, unmodified result.

        -
    • Callback executed before an agent's primary logic is invoked.

      This callback can be used for logging, setup, or to short-circuit the agent's execution by returning a value.

      Parameters

      Returns Promise<Content | undefined>

      An optional Content object. If a value is returned, it will bypass the agent's callbacks and its execution, and return this value directly. Returning undefined allows the agent to proceed normally.

      -
    • Callback executed before a request is sent to the model.

      This provides an opportunity to inspect, log, or modify the LlmRequest object. It can also be used to implement caching by returning a cached LlmResponse, which would skip the actual model call.

      @@ -392,7 +392,7 @@

    Returns Promise<LlmResponse | undefined>

    An optional value. The interpretation of a non-undefined trigger an early exit and returns the response immediately. Returning undefined allows the LLM request to proceed normally.

    -

    Returns Promise<Content | undefined>

    An optional Content to be returned to the ADK. Returning a value to replace the user message. Returning undefined to proceed normally.

    -
    +
    diff --git a/docs/api-reference/typescript/classes/SequentialAgent.html b/docs/api-reference/typescript/classes/SequentialAgent.html index 1757e8a23..01da0dbc5 100644 --- a/docs/api-reference/typescript/classes/SequentialAgent.html +++ b/docs/api-reference/typescript/classes/SequentialAgent.html @@ -350,67 +350,67 @@ border-radius: 4px; margin-left: 4px; ">

    Class SequentialAgent

    A shell agent that runs its sub-agents in a sequential order.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    +

    Hierarchy (View Summary)

    Constructors

    Properties

    afterAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked after the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the provided content will be used as agent response and appended to event history as agent response.

    -
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    +
    beforeAgentCallback: SingleAgentCallback[]

    Callback or list of callbacks to be invoked before the agent run.

    When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return undefined.

    MUST be named 'callbackContext' (enforced).

    Content: The content to return to the user. When the content is present, the agent run will be skipped and the provided content will be returned to user.

    -
    description?: string

    Description about the agent's capability.

    +
    description?: string

    Description about the agent's capability.

    The model uses this to determine whether to delegate control to the agent. One-line description is enough and preferred.

    -
    name: string

    The agent's name. +

    name: string

    The agent's name. Agent name must be a JS identifier and unique within the agent tree. Agent name cannot be "user", since it's reserved for end-user's input.

    -
    parentAgent?: BaseAgent

    The parent agent of this agent.

    +
    parentAgent?: BaseAgent

    The parent agent of this agent.

    Note that an agent can ONLY be added as sub-agent once.

    If you want to add one agent twice as sub-agent, consider to create two agent instances with identical config, but with different name and add them to the agent tree.

    The parent agent is the agent that created this agent.

    -
    rootAgent: BaseAgent

    Root agent of this agent.

    -
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    -

    Methods

    rootAgent: BaseAgent

    Root agent of this agent.

    +
    subAgents: BaseAgent[]

    The sub-agents of this agent.

    +

    Methods

    • Implementation for live SequentialAgent.

      Compared to the non-live case, live agents process a continuous stream of audio or video, so there is no way to tell if it's finished and should pass to the next agent or not. So we introduce a task_completed() function so the model can call this function to signal that it's finished the task and we can move on to the next agent.

      -

      Parameters

      Returns AsyncGenerator<Event, void, void>

    +

    Parameters

    Returns AsyncGenerator<Event, void, void>

    diff --git a/docs/api-reference/typescript/classes/ToolConfirmation.html b/docs/api-reference/typescript/classes/ToolConfirmation.html index c3ce10da3..603e2ffe8 100644 --- a/docs/api-reference/typescript/classes/ToolConfirmation.html +++ b/docs/api-reference/typescript/classes/ToolConfirmation.html @@ -351,8 +351,8 @@ margin-left: 4px; ">

    Class ToolConfirmationExperimental

    Represents a tool confirmation configuration. (Experimental, subject to change)

    -

    Constructors

    Properties

    confirmed: boolean

    Whether the tool excution is confirmed.

    -
    hint: string

    The hint text for why the input is needed.

    -
    payload?: unknown

    The custom data payload needed from the user to continue the flow. +

    Constructors

    Properties

    confirmed: boolean

    Whether the tool excution is confirmed.

    +
    hint: string

    The hint text for why the input is needed.

    +
    payload?: unknown

    The custom data payload needed from the user to continue the flow. It should be JSON serializable.

    -
    +
    diff --git a/docs/api-reference/typescript/classes/ToolContext.html b/docs/api-reference/typescript/classes/ToolContext.html index 71cd335ea..8f531b61e 100644 --- a/docs/api-reference/typescript/classes/ToolContext.html +++ b/docs/api-reference/typescript/classes/ToolContext.html @@ -350,27 +350,27 @@ border-radius: 4px; margin-left: 4px; ">

    Class ToolContext

    The context of various callbacks within an agent run.

    -

    Hierarchy (View Summary)

    Constructors

    Properties

    eventActions: EventActions
    functionCallId?: string
    invocationContext: InvocationContext
    toolConfirmation?: ToolConfirmation

    Accessors

    • get userContent(): Content | undefined

      The user content that started this invocation.

      -

      Returns Content | undefined

    Methods

    • Gets the auth credential for the given auth config.

      +

    Hierarchy (View Summary)

    Constructors

    Properties

    eventActions: EventActions
    functionCallId?: string
    invocationContext: InvocationContext
    toolConfirmation?: ToolConfirmation

    Accessors

    • get userContent(): Content | undefined

      The user content that started this invocation.

      +

      Returns Content | undefined

    Methods

    • Gets the auth credential for the given auth config.

      Parameters

      • authConfig: AuthConfig

        The auth config to get the auth credential for.

      Returns AuthCredential | undefined

      The auth credential for the given auth config.

      -
    • Lists the filenames of the artifacts attached to the current session.

      Returns Promise<string[]>

      A promise that resolves to a list of artifact filenames.

      -
    • Loads an artifact attached to the current session.

      +
    • Loads an artifact attached to the current session.

      Parameters

      • filename: string

        The filename of the artifact.

      • Optionalversion: number

        The version of the artifact. If not provided, the latest version will be used.

      Returns Promise<Part | undefined>

      A promise that resolves to the loaded artifact.

      -
    • Requests confirmation for the current tool call.

      -

      Parameters

      • __namedParameters: { hint?: string; payload?: unknown }

      Returns void

    • Requests confirmation for the current tool call.

      +

      Parameters

      • __namedParameters: { hint?: string; payload?: unknown }

      Returns void

    • Saves an artifact attached to the current session.

      Parameters

      • filename: string

        The filename of the artifact.

      • artifact: Part

        The artifact to save.

      Returns Promise<number>

      A promise that resolves to the version of the saved artifact.

      -
    +
    diff --git a/docs/api-reference/typescript/enums/LogLevel.html b/docs/api-reference/typescript/enums/LogLevel.html index 0eb559c0e..31df0dab1 100644 --- a/docs/api-reference/typescript/enums/LogLevel.html +++ b/docs/api-reference/typescript/enums/LogLevel.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Enumeration LogLevel

    Log levels for the logger.

    -

    Enumeration Members

    DEBUG: 0
    ERROR: 3
    INFO: 1
    WARN: 2
    +

    Enumeration Members

    DEBUG: 0
    ERROR: 3
    INFO: 1
    WARN: 2
    diff --git a/docs/api-reference/typescript/enums/PolicyOutcome.html b/docs/api-reference/typescript/enums/PolicyOutcome.html index a25504288..65c4e27fa 100644 --- a/docs/api-reference/typescript/enums/PolicyOutcome.html +++ b/docs/api-reference/typescript/enums/PolicyOutcome.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Enumeration PolicyOutcome

    The outcome of a policy check.

    -

    Enumeration Members

    ALLOW: "ALLOW"
    CONFIRM: "CONFIRM"
    DENY: "DENY"
    +

    Enumeration Members

    ALLOW: "ALLOW"
    CONFIRM: "CONFIRM"
    DENY: "DENY"
    diff --git a/docs/api-reference/typescript/enums/StreamingMode.html b/docs/api-reference/typescript/enums/StreamingMode.html index f99c1bd21..abe578c34 100644 --- a/docs/api-reference/typescript/enums/StreamingMode.html +++ b/docs/api-reference/typescript/enums/StreamingMode.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Enumeration StreamingMode

    The streaming mode for the run config.

    -

    Enumeration Members

    BIDI: "bidi"
    NONE: "none"
    SSE: "sse"
    +

    Enumeration Members

    BIDI: "bidi"
    NONE: "none"
    SSE: "sse"
    diff --git a/docs/api-reference/typescript/functions/createEvent.html b/docs/api-reference/typescript/functions/createEvent.html index 701dade8c..117d4f23e 100644 --- a/docs/api-reference/typescript/functions/createEvent.html +++ b/docs/api-reference/typescript/functions/createEvent.html @@ -352,4 +352,4 @@ ">

    Function createEvent

    +
    diff --git a/docs/api-reference/typescript/functions/createEventActions.html b/docs/api-reference/typescript/functions/createEventActions.html index cee3747dc..81029b814 100644 --- a/docs/api-reference/typescript/functions/createEventActions.html +++ b/docs/api-reference/typescript/functions/createEventActions.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Function createEventActions

    +

    Parameters

    Returns EventActions

    diff --git a/docs/api-reference/typescript/functions/createSession.html b/docs/api-reference/typescript/functions/createSession.html index 747c54de1..ac9fe5003 100644 --- a/docs/api-reference/typescript/functions/createSession.html +++ b/docs/api-reference/typescript/functions/createSession.html @@ -352,4 +352,4 @@ ">

    Function createSession

    • Creates a session from a partial session.

      Parameters

      • params: Partial<Session> & { appName: string; id: string }

        The partial session to create the session from.

      Returns Session

      The session.

      -
    +
    diff --git a/docs/api-reference/typescript/functions/getAskUserConfirmationFunctionCalls.html b/docs/api-reference/typescript/functions/getAskUserConfirmationFunctionCalls.html index 55c48a61c..5eadb029c 100644 --- a/docs/api-reference/typescript/functions/getAskUserConfirmationFunctionCalls.html +++ b/docs/api-reference/typescript/functions/getAskUserConfirmationFunctionCalls.html @@ -352,4 +352,4 @@ ">

    Function getAskUserConfirmationFunctionCalls

    • Gets the ask user confirmation function calls from the event.

      Parameters

      • event: Event

        The event to get the function calls from.

      Returns FunctionCall[]

      The ask user confirmation function calls.

      -
    +
    diff --git a/docs/api-reference/typescript/functions/getFunctionCalls.html b/docs/api-reference/typescript/functions/getFunctionCalls.html index a0baaa29c..329c19299 100644 --- a/docs/api-reference/typescript/functions/getFunctionCalls.html +++ b/docs/api-reference/typescript/functions/getFunctionCalls.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Function getFunctionCalls

    +

    Parameters

    Returns FunctionCall[]

    diff --git a/docs/api-reference/typescript/functions/getFunctionResponses.html b/docs/api-reference/typescript/functions/getFunctionResponses.html index a4ce8f884..b0904398a 100644 --- a/docs/api-reference/typescript/functions/getFunctionResponses.html +++ b/docs/api-reference/typescript/functions/getFunctionResponses.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

    Function getFunctionResponses

    +

    Parameters

    Returns FunctionResponse[]

    diff --git a/docs/api-reference/typescript/functions/getGcpExporters.html b/docs/api-reference/typescript/functions/getGcpExporters.html new file mode 100644 index 000000000..a2742c36c --- /dev/null +++ b/docs/api-reference/typescript/functions/getGcpExporters.html @@ -0,0 +1,352 @@ +getGcpExporters | ADK for TypeScript: API Reference
    ADK for TypeScript: API Reference
      Preparing search index...

      Function getGcpExporters

      diff --git a/docs/api-reference/typescript/functions/getGcpResource.html b/docs/api-reference/typescript/functions/getGcpResource.html new file mode 100644 index 000000000..b9ce9674a --- /dev/null +++ b/docs/api-reference/typescript/functions/getGcpResource.html @@ -0,0 +1,352 @@ +getGcpResource | ADK for TypeScript: API Reference
      ADK for TypeScript: API Reference
        Preparing search index...

        Function getGcpResource

        diff --git a/docs/api-reference/typescript/functions/hasTrailingCodeExecutionResult.html b/docs/api-reference/typescript/functions/hasTrailingCodeExecutionResult.html index ee026c932..6a6510006 100644 --- a/docs/api-reference/typescript/functions/hasTrailingCodeExecutionResult.html +++ b/docs/api-reference/typescript/functions/hasTrailingCodeExecutionResult.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

        Function hasTrailingCodeExecutionResult

        • Returns whether the event has a trailing code execution result.

          -

          Parameters

          Returns boolean

        +

        Parameters

        Returns boolean

        diff --git a/docs/api-reference/typescript/functions/isFinalResponse.html b/docs/api-reference/typescript/functions/isFinalResponse.html index 241aefb4c..e3e61492c 100644 --- a/docs/api-reference/typescript/functions/isFinalResponse.html +++ b/docs/api-reference/typescript/functions/isFinalResponse.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

        Function isFinalResponse

        +

        Parameters

        Returns boolean

        diff --git a/docs/api-reference/typescript/functions/maybeSetOtelProviders.html b/docs/api-reference/typescript/functions/maybeSetOtelProviders.html new file mode 100644 index 000000000..f335b0a93 --- /dev/null +++ b/docs/api-reference/typescript/functions/maybeSetOtelProviders.html @@ -0,0 +1,368 @@ +maybeSetOtelProviders | ADK for TypeScript: API Reference
        ADK for TypeScript: API Reference
          Preparing search index...

          Function maybeSetOtelProviders

          • Experimental

            Sets up OTel providers if hooks for a given telemetry type were passed.

            +

            Additionally adds generic OTLP exporters based on following env variables: +OTEL_EXPORTER_OTLP_ENDPOINT +OTEL_EXPORTER_OTLP_TRACES_ENDPOINT +OTEL_EXPORTER_OTLP_METRICS_ENDPOINT +OTEL_EXPORTER_OTLP_LOGS_ENDPOINT +See https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/ +for how they are used.

            +

            If a provider for a specific telemetry type was already globally set - +this function will not override it or register more exporters.

            +

            (Experimental, subject to change)

            +

            Parameters

            • otelHooksToSetup: OTelHooks[] = []

              per-telemetry-type processors and readers to be added +to OTel providers. If no hooks for a specific telemetry type are passed - +provider will not be set.

              +
            • OptionalotelResource: Resource

              OTel resource to use in providers. +If empty - default OTel resource detection will be used.

              +

            Returns void

          diff --git a/docs/api-reference/typescript/functions/setLogLevel.html b/docs/api-reference/typescript/functions/setLogLevel.html index 6af37224e..f5ccfb4ef 100644 --- a/docs/api-reference/typescript/functions/setLogLevel.html +++ b/docs/api-reference/typescript/functions/setLogLevel.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

          Function setLogLevel

          +

          Parameters

          Returns void

          diff --git a/docs/api-reference/typescript/functions/stringifyContent.html b/docs/api-reference/typescript/functions/stringifyContent.html index c549297bb..30a180c30 100644 --- a/docs/api-reference/typescript/functions/stringifyContent.html +++ b/docs/api-reference/typescript/functions/stringifyContent.html @@ -352,4 +352,4 @@ ">

          Function stringifyContent

          • Extracts and concatenates all text from the parts of a Event object.

            Parameters

            • event: Event

              The Event object to process.

            Returns string

            A single string with the combined text.

            -
          +
          diff --git a/docs/api-reference/typescript/functions/zodObjectToSchema.html b/docs/api-reference/typescript/functions/zodObjectToSchema.html index 632308b7b..519ea78a9 100644 --- a/docs/api-reference/typescript/functions/zodObjectToSchema.html +++ b/docs/api-reference/typescript/functions/zodObjectToSchema.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

          Function zodObjectToSchema

          + ">

          Function zodObjectToSchema

          diff --git a/docs/api-reference/typescript/hierarchy.html b/docs/api-reference/typescript/hierarchy.html index ed7953307..0c7172542 100644 --- a/docs/api-reference/typescript/hierarchy.html +++ b/docs/api-reference/typescript/hierarchy.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

          ADK for TypeScript: API Reference

          Hierarchy Summary

          + ">

          ADK for TypeScript: API Reference

          Hierarchy Summary

          diff --git a/docs/api-reference/typescript/index.html b/docs/api-reference/typescript/index.html index aa7659d94..1b0e609a4 100644 --- a/docs/api-reference/typescript/index.html +++ b/docs/api-reference/typescript/index.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

          ADK for TypeScript: API Reference

          Enumerations

          LogLevel
          PolicyOutcome
          StreamingMode

          Classes

          AgentTool
          BaseAgent
          BaseLlm
          BasePlugin
          BaseSessionService
          BaseTool
          BaseToolset
          CallbackContext
          FunctionTool
          GcsArtifactService
          Gemini
          InMemoryArtifactService
          InMemoryMemoryService
          InMemoryPolicyEngine
          InMemoryRunner
          InMemorySessionService
          InvocationContext
          LiveRequestQueue
          LlmAgent
          LoggingPlugin
          LongRunningFunctionTool
          LoopAgent
          MCPSessionManager
          MCPTool
          MCPToolset
          ParallelAgent
          PluginManager
          Runner
          SecurityPlugin
          SequentialAgent
          ToolConfirmation
          ToolContext

          Interfaces

          AppendEventRequest
          BaseArtifactService
          BaseCredentialService
          BaseLlmConnection
          BaseMemoryService
          BasePolicyEngine
          BaseToolParams
          CreateSessionRequest
          DeleteArtifactRequest
          DeleteSessionRequest
          Event
          EventActions
          GeminiParams
          GetSessionConfig
          GetSessionRequest
          ListArtifactKeysRequest
          ListSessionsRequest
          ListSessionsResponse
          ListVersionsRequest
          LiveRequest
          LlmRequest
          LlmResponse
          LoadArtifactRequest
          PolicyCheckResult
          RunAsyncToolRequest
          RunConfig
          SaveArtifactRequest
          SearchMemoryRequest
          SearchMemoryResponse
          Session
          StdioConnectionParams
          StreamableHTTPConnectionParams
          ToolCallPolicyContext
          ToolProcessLlmRequest

          Type Aliases

          AfterModelCallback
          AfterToolCallback
          BeforeModelCallback
          BeforeToolCallback
          MCPConnectionParams
          SingleAfterModelCallback
          SingleAfterToolCallback
          SingleBeforeModelCallback
          SingleBeforeToolCallback

          Variables

          functionsExportedForTestingOnly
          REQUEST_CONFIRMATION_FUNCTION_CALL_NAME

          Functions

          createEvent
          createEventActions
          createSession
          getAskUserConfirmationFunctionCalls
          getFunctionCalls
          getFunctionResponses
          hasTrailingCodeExecutionResult
          isFinalResponse
          setLogLevel
          stringifyContent
          zodObjectToSchema
          + ">

          ADK for TypeScript: API Reference

          Enumerations

          LogLevel
          PolicyOutcome
          StreamingMode

          Classes

          AgentTool
          BaseAgent
          BaseLlm
          BasePlugin
          BaseSessionService
          BaseTool
          BaseToolset
          CallbackContext
          FunctionTool
          GcsArtifactService
          Gemini
          InMemoryArtifactService
          InMemoryMemoryService
          InMemoryPolicyEngine
          InMemoryRunner
          InMemorySessionService
          InvocationContext
          LiveRequestQueue
          LlmAgent
          LLMRegistry
          LoggingPlugin
          LongRunningFunctionTool
          LoopAgent
          MCPSessionManager
          MCPTool
          MCPToolset
          ParallelAgent
          PluginManager
          Runner
          SecurityPlugin
          SequentialAgent
          ToolConfirmation
          ToolContext

          Interfaces

          AppendEventRequest
          BaseArtifactService
          BaseCredentialService
          BaseLlmConnection
          BaseMemoryService
          BasePolicyEngine
          BaseToolParams
          CreateSessionRequest
          DeleteArtifactRequest
          DeleteSessionRequest
          Event
          EventActions
          GeminiParams
          GetSessionConfig
          GetSessionRequest
          ListArtifactKeysRequest
          ListSessionsRequest
          ListSessionsResponse
          ListVersionsRequest
          LiveRequest
          LlmRequest
          LlmResponse
          LoadArtifactRequest
          OtelExportersConfig
          OTelHooks
          PolicyCheckResult
          RunAsyncToolRequest
          RunConfig
          SaveArtifactRequest
          SearchMemoryRequest
          SearchMemoryResponse
          Session
          StdioConnectionParams
          StreamableHTTPConnectionParams
          ToolCallPolicyContext
          ToolProcessLlmRequest

          Type Aliases

          AfterModelCallback
          AfterToolCallback
          BeforeModelCallback
          BeforeToolCallback
          MCPConnectionParams
          SingleAfterModelCallback
          SingleAfterToolCallback
          SingleBeforeModelCallback
          SingleBeforeToolCallback

          Variables

          functionsExportedForTestingOnly
          REQUEST_CONFIRMATION_FUNCTION_CALL_NAME

          Functions

          createEvent
          createEventActions
          createSession
          getAskUserConfirmationFunctionCalls
          getFunctionCalls
          getFunctionResponses
          getGcpExporters
          getGcpResource
          hasTrailingCodeExecutionResult
          isFinalResponse
          maybeSetOtelProviders
          setLogLevel
          stringifyContent
          zodObjectToSchema
          diff --git a/docs/api-reference/typescript/interfaces/AppendEventRequest.html b/docs/api-reference/typescript/interfaces/AppendEventRequest.html index ad9dc4823..2de64ba46 100644 --- a/docs/api-reference/typescript/interfaces/AppendEventRequest.html +++ b/docs/api-reference/typescript/interfaces/AppendEventRequest.html @@ -350,6 +350,6 @@ border-radius: 4px; margin-left: 4px; ">

          Interface AppendEventRequest

          The parameters for appendEvent.

          -
          interface AppendEventRequest {
              event: Event;
              session: Session;
          }

          Properties

          event: Event

          The event to append.

          -
          session: Session

          The session to append the event to.

          -
          +
          interface AppendEventRequest {
              event: Event;
              session: Session;
          }

          Properties

          event: Event

          The event to append.

          +
          session: Session

          The session to append the event to.

          +
          diff --git a/docs/api-reference/typescript/interfaces/BaseArtifactService.html b/docs/api-reference/typescript/interfaces/BaseArtifactService.html index 7156f2115..d0e783abf 100644 --- a/docs/api-reference/typescript/interfaces/BaseArtifactService.html +++ b/docs/api-reference/typescript/interfaces/BaseArtifactService.html @@ -350,23 +350,23 @@ border-radius: 4px; margin-left: 4px; ">

          Interface BaseArtifactService

          Interface for artifact services.

          -
          interface BaseArtifactService {
              deleteArtifact(request: DeleteArtifactRequest): Promise<void>;
              listArtifactKeys(request: ListArtifactKeysRequest): Promise<string[]>;
              listVersions(request: ListVersionsRequest): Promise<number[]>;
              loadArtifact(request: LoadArtifactRequest): Promise<Part | undefined>;
              saveArtifact(request: SaveArtifactRequest): Promise<number>;
          }

          Implemented by

          Methods

          interface BaseArtifactService {
              deleteArtifact(request: DeleteArtifactRequest): Promise<void>;
              listArtifactKeys(request: ListArtifactKeysRequest): Promise<string[]>;
              listVersions(request: ListVersionsRequest): Promise<number[]>;
              loadArtifact(request: LoadArtifactRequest): Promise<Part | undefined>;
              saveArtifact(request: SaveArtifactRequest): Promise<number>;
          }

          Implemented by

          Methods

          • Gets an artifact from the artifact service storage.

            The artifact is a file identified by the app name, user ID, session ID, and filename.

            Parameters

            Returns Promise<Part | undefined>

            A promise that resolves to the artifact or undefined if not found.

            -
          • Saves an artifact to the artifact service storage.

            The artifact is a file identified by the app name, user ID, session ID, and filename. After saving the artifact, a revision ID is returned to identify the artifact version.

            @@ -374,4 +374,4 @@

          Returns Promise<number>

          A promise that resolves to The revision ID. The first version of the artifact has a revision ID of 0. This is incremented by 1 after each successful save.

          -
          +
          diff --git a/docs/api-reference/typescript/interfaces/BaseCredentialService.html b/docs/api-reference/typescript/interfaces/BaseCredentialService.html index 564c088a9..bf82eb25a 100644 --- a/docs/api-reference/typescript/interfaces/BaseCredentialService.html +++ b/docs/api-reference/typescript/interfaces/BaseCredentialService.html @@ -351,7 +351,7 @@ margin-left: 4px; ">

          Interface BaseCredentialService

          Abstract class for Service that loads / saves tool credentials from / to the backend credential store.

          -
          interface BaseCredentialService {
              loadCredential(
                  authConfig: AuthConfig,
                  toolContext: ToolContext,
              ): Promise<AuthCredential | undefined>;
              saveCredential(
                  authConfig: AuthConfig,
                  toolContext: ToolContext,
              ): Promise<void>;
          }

          Methods

          • Loads the credential by auth config and current tool context from the +

          interface BaseCredentialService {
              loadCredential(
                  authConfig: AuthConfig,
                  toolContext: ToolContext,
              ): Promise<AuthCredential | undefined>;
              saveCredential(
                  authConfig: AuthConfig,
                  toolContext: ToolContext,
              ): Promise<void>;
          }

          Methods

          • Loads the credential by auth config and current tool context from the backend credential store.

            Parameters

            • authConfig: AuthConfig

              The auth config which contains the auth scheme and auth credential information. auth_config.get_credential_key will be used to @@ -359,4 +359,4 @@

            • toolContext: ToolContext

              The context of the current invocation when the tool is trying to load the credential.

            Returns Promise<AuthCredential | undefined>

            A promise that resolves to the credential saved in the store.

            -
          +
          diff --git a/docs/api-reference/typescript/interfaces/BaseLlmConnection.html b/docs/api-reference/typescript/interfaces/BaseLlmConnection.html index c33b68583..25c24c4fb 100644 --- a/docs/api-reference/typescript/interfaces/BaseLlmConnection.html +++ b/docs/api-reference/typescript/interfaces/BaseLlmConnection.html @@ -350,21 +350,21 @@ border-radius: 4px; margin-left: 4px; ">

          Interface BaseLlmConnection

          The base class for a live model connection.

          -
          interface BaseLlmConnection {
              close(): Promise<void>;
              receive(): AsyncGenerator<LlmResponse, void, void>;
              sendContent(content: Content): Promise<void>;
              sendHistory(history: Content[]): Promise<void>;
              sendRealtime(blob: Blob_2): Promise<void>;
          }

          Methods

          • Receives the model response using the llm server connection.

            +
          interface BaseLlmConnection {
              close(): Promise<void>;
              receive(): AsyncGenerator<LlmResponse, void, void>;
              sendContent(content: Content): Promise<void>;
              sendHistory(history: Content[]): Promise<void>;
              sendRealtime(blob: Blob_2): Promise<void>;
          }

          Methods

          • Sends the content to the model.

            The model will respond immediately upon receiving the content. If you send function responses, all parts in the content should be function responses.

            Parameters

            • content: Content

              The content to send to the model.

              -

            Returns Promise<void>

          • Sends the conversation history to the model.

            +

          Returns Promise<void>

          Returns Promise<void>

          +

          Returns Promise<void>

          diff --git a/docs/api-reference/typescript/interfaces/BaseMemoryService.html b/docs/api-reference/typescript/interfaces/BaseMemoryService.html index 6a16d9d52..988c821b0 100644 --- a/docs/api-reference/typescript/interfaces/BaseMemoryService.html +++ b/docs/api-reference/typescript/interfaces/BaseMemoryService.html @@ -352,11 +352,11 @@ ">

          Interface BaseMemoryService

          Base interface for memory services.

          The service provides functionalities to ingest sessions into memory so that the memory can be used for user queries.

          -
          interface BaseMemoryService {
              addSessionToMemory(session: Session): Promise<void>;
              searchMemory(request: SearchMemoryRequest): Promise<SearchMemoryResponse>;
          }

          Implemented by

          Methods

          • Adds a session to the memory.

            +
          interface BaseMemoryService {
              addSessionToMemory(session: Session): Promise<void>;
              searchMemory(request: SearchMemoryRequest): Promise<SearchMemoryResponse>;
          }

          Implemented by

          Methods

          • Adds a session to the memory.

            Parameters

            • session: Session

              The session to add to the memory.

            Returns Promise<void>

            A promise that resolves when the session is added to the memory.

            -
          +
          diff --git a/docs/api-reference/typescript/interfaces/BasePolicyEngine.html b/docs/api-reference/typescript/interfaces/BasePolicyEngine.html index 6295a83a2..9a54504f0 100644 --- a/docs/api-reference/typescript/interfaces/BasePolicyEngine.html +++ b/docs/api-reference/typescript/interfaces/BasePolicyEngine.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

          Interface BasePolicyEngine

          interface BasePolicyEngine {
              evaluate(context: ToolCallPolicyContext): Promise<PolicyCheckResult>;
          }

          Implemented by

          Methods

          + ">

          Interface BasePolicyEngine

          interface BasePolicyEngine {
              evaluate(context: ToolCallPolicyContext): Promise<PolicyCheckResult>;
          }

          Implemented by

          Methods

          diff --git a/docs/api-reference/typescript/interfaces/BaseToolParams.html b/docs/api-reference/typescript/interfaces/BaseToolParams.html index ee038ba9f..0df6878ae 100644 --- a/docs/api-reference/typescript/interfaces/BaseToolParams.html +++ b/docs/api-reference/typescript/interfaces/BaseToolParams.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

          Interface BaseToolParams

          Parameters for the BaseTool constructor.

          -
          interface BaseToolParams {
              description: string;
              isLongRunning?: boolean;
              name: string;
          }

          Properties

          description: string
          isLongRunning?: boolean
          name: string
          +
          interface BaseToolParams {
              description: string;
              isLongRunning?: boolean;
              name: string;
          }

          Properties

          description: string
          isLongRunning?: boolean
          name: string
          diff --git a/docs/api-reference/typescript/interfaces/CreateSessionRequest.html b/docs/api-reference/typescript/interfaces/CreateSessionRequest.html index 0d01e0e79..98f0f0aef 100644 --- a/docs/api-reference/typescript/interfaces/CreateSessionRequest.html +++ b/docs/api-reference/typescript/interfaces/CreateSessionRequest.html @@ -350,8 +350,8 @@ border-radius: 4px; margin-left: 4px; ">

          Interface CreateSessionRequest

          The parameters for createSession.

          -
          interface CreateSessionRequest {
              appName: string;
              sessionId?: string;
              state?: Record<string, unknown>;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          -
          sessionId?: string

          The ID of the session. A new ID will be generated if not provided.

          -
          state?: Record<string, unknown>

          The initial state of the session.

          -
          userId: string

          The ID of the user.

          -
          +
          interface CreateSessionRequest {
              appName: string;
              sessionId?: string;
              state?: Record<string, unknown>;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          +
          sessionId?: string

          The ID of the session. A new ID will be generated if not provided.

          +
          state?: Record<string, unknown>

          The initial state of the session.

          +
          userId: string

          The ID of the user.

          +
          diff --git a/docs/api-reference/typescript/interfaces/DeleteArtifactRequest.html b/docs/api-reference/typescript/interfaces/DeleteArtifactRequest.html index f4003b14e..545c4cc28 100644 --- a/docs/api-reference/typescript/interfaces/DeleteArtifactRequest.html +++ b/docs/api-reference/typescript/interfaces/DeleteArtifactRequest.html @@ -350,8 +350,8 @@ border-radius: 4px; margin-left: 4px; ">

          Interface DeleteArtifactRequest

          The parameters for deleteArtifact.

          -
          interface DeleteArtifactRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          -
          filename: string

          The filename of the artifact.

          -
          sessionId: string

          The session ID.

          -
          userId: string

          The user ID.

          -
          +
          interface DeleteArtifactRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          +
          filename: string

          The filename of the artifact.

          +
          sessionId: string

          The session ID.

          +
          userId: string

          The user ID.

          +
          diff --git a/docs/api-reference/typescript/interfaces/DeleteSessionRequest.html b/docs/api-reference/typescript/interfaces/DeleteSessionRequest.html index 91ccd2f02..8b6d28449 100644 --- a/docs/api-reference/typescript/interfaces/DeleteSessionRequest.html +++ b/docs/api-reference/typescript/interfaces/DeleteSessionRequest.html @@ -350,7 +350,7 @@ border-radius: 4px; margin-left: 4px; ">

          Interface DeleteSessionRequest

          The parameters for deleteSession.

          -
          interface DeleteSessionRequest {
              appName: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          -
          sessionId: string

          The ID of the session.

          -
          userId: string

          The ID of the user.

          -
          +
          interface DeleteSessionRequest {
              appName: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          +
          sessionId: string

          The ID of the session.

          +
          userId: string

          The ID of the user.

          +
          diff --git a/docs/api-reference/typescript/interfaces/Event.html b/docs/api-reference/typescript/interfaces/Event.html index cdd47f0d0..ea838ab1b 100644 --- a/docs/api-reference/typescript/interfaces/Event.html +++ b/docs/api-reference/typescript/interfaces/Event.html @@ -352,38 +352,38 @@ ">

          Interface Event

          Represents an event in a conversation between agents and users.

          It is used to store the content of the conversation, as well as the actions taken by the agents like function calls, etc.

          -
          interface Event {
              actions: EventActions;
              author?: string;
              branch?: string;
              content?: Content;
              customMetadata?: { [key: string]: any };
              errorCode?: string;
              errorMessage?: string;
              finishReason?: FinishReason;
              groundingMetadata?: GroundingMetadata;
              id: string;
              inputTranscription?: Transcription;
              interrupted?: boolean;
              invocationId: string;
              liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate;
              longRunningToolIds?: string[];
              outputTranscription?: Transcription;
              partial?: boolean;
              timestamp: number;
              turnComplete?: boolean;
              usageMetadata?: GenerateContentResponseUsageMetadata;
          }

          Hierarchy (View Summary)

          Properties

          actions: EventActions

          The actions taken by the agent.

          -
          author?: string

          "user" or the name of the agent, indicating who appended the event to the +

          interface Event {
              actions: EventActions;
              author?: string;
              branch?: string;
              content?: Content;
              customMetadata?: { [key: string]: any };
              errorCode?: string;
              errorMessage?: string;
              finishReason?: FinishReason;
              groundingMetadata?: GroundingMetadata;
              id: string;
              inputTranscription?: Transcription;
              interrupted?: boolean;
              invocationId: string;
              liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate;
              longRunningToolIds?: string[];
              outputTranscription?: Transcription;
              partial?: boolean;
              timestamp: number;
              turnComplete?: boolean;
              usageMetadata?: GenerateContentResponseUsageMetadata;
          }

          Hierarchy (View Summary)

          Properties

          actions: EventActions

          The actions taken by the agent.

          +
          author?: string

          "user" or the name of the agent, indicating who appended the event to the session.

          -
          branch?: string

          The branch of the event. +

          branch?: string

          The branch of the event. The format is like agent_1.agent_2.agent_3, where agent_1 is the parent of agent_2, and agent_2 is the parent of agent_3.

          Branch is used when multiple sub-agent shouldn't see their peer agents' conversation history.

          -
          content?: Content

          The content of the response.

          -
          customMetadata?: { [key: string]: any }

          The custom metadata of the LlmResponse. +

          content?: Content

          The content of the response.

          +
          customMetadata?: { [key: string]: any }

          The custom metadata of the LlmResponse. An optional key-value pair to label an LlmResponse. NOTE: the entire object must be JSON serializable.

          -
          errorCode?: string

          Error code if the response is an error. Code varies by model.

          -
          errorMessage?: string

          Error message if the response is an error.

          -
          finishReason?: FinishReason

          The finish reason of the response.

          -
          groundingMetadata?: GroundingMetadata

          The grounding metadata of the response.

          -
          id: string

          The unique identifier of the event. +

          errorCode?: string

          Error code if the response is an error. Code varies by model.

          +
          errorMessage?: string

          Error message if the response is an error.

          +
          finishReason?: FinishReason

          The finish reason of the response.

          +
          groundingMetadata?: GroundingMetadata

          The grounding metadata of the response.

          +
          id: string

          The unique identifier of the event. Do not assign the ID. It will be assigned by the session.

          -
          inputTranscription?: Transcription

          Audio transcription of user input.

          -
          interrupted?: boolean

          Flag indicating that LLM was interrupted when generating the content. +

          inputTranscription?: Transcription

          Audio transcription of user input.

          +
          interrupted?: boolean

          Flag indicating that LLM was interrupted when generating the content. Usually it's due to user interruption during a bidi streaming.

          -
          invocationId: string

          The invocation ID of the event. Should be non-empty before appending to a +

          invocationId: string

          The invocation ID of the event. Should be non-empty before appending to a session.

          -
          liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate

          The session resumption update of the LlmResponse

          -
          longRunningToolIds?: string[]

          Set of ids of the long running function calls. Agent client will know from +

          liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate

          The session resumption update of the LlmResponse

          +
          longRunningToolIds?: string[]

          Set of ids of the long running function calls. Agent client will know from this field about which function call is long running. Only valid for function call event

          -
          outputTranscription?: Transcription

          Audio transcription of model output.

          -
          partial?: boolean

          Indicates whether the text content is part of a unfinished text stream. +

          outputTranscription?: Transcription

          Audio transcription of model output.

          +
          partial?: boolean

          Indicates whether the text content is part of a unfinished text stream. Only used for streaming mode and when the content is plain text.

          -
          timestamp: number

          The timestamp of the event.

          -
          turnComplete?: boolean

          Indicates whether the response from the model is complete. +

          timestamp: number

          The timestamp of the event.

          +
          turnComplete?: boolean

          Indicates whether the response from the model is complete. Only used for streaming mode.

          -
          usageMetadata?: GenerateContentResponseUsageMetadata

          The usage metadata of the LlmResponse.

          -
          +
          usageMetadata?: GenerateContentResponseUsageMetadata

          The usage metadata of the LlmResponse.

          +
          diff --git a/docs/api-reference/typescript/interfaces/EventActions.html b/docs/api-reference/typescript/interfaces/EventActions.html index 4fd5ed402..1f80eb9ec 100644 --- a/docs/api-reference/typescript/interfaces/EventActions.html +++ b/docs/api-reference/typescript/interfaces/EventActions.html @@ -350,10 +350,10 @@ border-radius: 4px; margin-left: 4px; ">

          Interface EventActions

          Represents the actions attached to an event.

          -
          interface EventActions {
              artifactDelta: { [key: string]: number };
              escalate?: boolean;
              requestedAuthConfigs: { [key: string]: any };
              requestedToolConfirmations: { [key: string]: ToolConfirmation };
              skipSummarization?: boolean;
              stateDelta: { [key: string]: unknown };
              transferToAgent?: string;
          }

          Properties

          artifactDelta: { [key: string]: number }

          Indicates that the event is updating an artifact. key is the filename, +

          interface EventActions {
              artifactDelta: { [key: string]: number };
              escalate?: boolean;
              requestedAuthConfigs: { [key: string]: any };
              requestedToolConfirmations: { [key: string]: ToolConfirmation };
              skipSummarization?: boolean;
              stateDelta: { [key: string]: unknown };
              transferToAgent?: string;
          }

          Properties

          artifactDelta: { [key: string]: number }

          Indicates that the event is updating an artifact. key is the filename, value is the version.

          -
          escalate?: boolean

          The agent is escalating to a higher level agent.

          -
          requestedAuthConfigs: { [key: string]: any }

          Authentication configurations requested by tool responses.

          +
          escalate?: boolean

          The agent is escalating to a higher level agent.

          +
          requestedAuthConfigs: { [key: string]: any }

          Authentication configurations requested by tool responses.

          This field will only be set by a tool response event indicating tool request auth credential.

            @@ -363,10 +363,10 @@ used to identify the function call.
          • Values: The requested auth config.
          -
          requestedToolConfirmations: { [key: string]: ToolConfirmation }

          A dict of tool confirmation requested by this event, keyed by the function +

          requestedToolConfirmations: { [key: string]: ToolConfirmation }

          A dict of tool confirmation requested by this event, keyed by the function call id.

          -
          skipSummarization?: boolean

          If true, it won't call model to summarize function response. +

          skipSummarization?: boolean

          If true, it won't call model to summarize function response. Only used for function_response event.

          -
          stateDelta: { [key: string]: unknown }

          Indicates that the event is updating the state with the given delta.

          -
          transferToAgent?: string

          If set, the event transfers to the specified agent.

          -
          +
          stateDelta: { [key: string]: unknown }

          Indicates that the event is updating the state with the given delta.

          +
          transferToAgent?: string

          If set, the event transfers to the specified agent.

          +
          diff --git a/docs/api-reference/typescript/interfaces/GeminiParams.html b/docs/api-reference/typescript/interfaces/GeminiParams.html index fdf6c7c82..bcda2e785 100644 --- a/docs/api-reference/typescript/interfaces/GeminiParams.html +++ b/docs/api-reference/typescript/interfaces/GeminiParams.html @@ -350,12 +350,12 @@ border-radius: 4px; margin-left: 4px; ">

          Interface GeminiParams

          The parameters for creating a Gemini instance.

          -
          interface GeminiParams {
              apiKey?: string;
              headers?: Record<string, string>;
              location?: string;
              model?: string;
              project?: string;
              vertexai?: boolean;
          }

          Properties

          apiKey?: string

          The API key to use for the Gemini API. If not provided, it will look for +

          interface GeminiParams {
              apiKey?: string;
              headers?: Record<string, string>;
              location?: string;
              model?: string;
              project?: string;
              vertexai?: boolean;
          }

          Properties

          apiKey?: string

          The API key to use for the Gemini API. If not provided, it will look for the GOOGLE_GENAI_API_KEY or GEMINI_API_KEY environment variable.

          -
          headers?: Record<string, string>

          Headers to merge with internally crafted headers.

          -
          location?: string

          The Vertex AI location. Required if vertexai is true.

          -
          model?: string

          The name of the model to use. Defaults to 'gemini-2.5-flash'.

          -
          project?: string

          The Vertex AI project ID. Required if vertexai is true.

          -
          vertexai?: boolean

          Whether to use Vertex AI. If true, project, location +

          headers?: Record<string, string>

          Headers to merge with internally crafted headers.

          +
          location?: string

          The Vertex AI location. Required if vertexai is true.

          +
          model?: string

          The name of the model to use. Defaults to 'gemini-2.5-flash'.

          +
          project?: string

          The Vertex AI project ID. Required if vertexai is true.

          +
          vertexai?: boolean

          Whether to use Vertex AI. If true, project, location should be provided.

          -
          +
          diff --git a/docs/api-reference/typescript/interfaces/GetSessionConfig.html b/docs/api-reference/typescript/interfaces/GetSessionConfig.html index e238c18c3..83b6de525 100644 --- a/docs/api-reference/typescript/interfaces/GetSessionConfig.html +++ b/docs/api-reference/typescript/interfaces/GetSessionConfig.html @@ -350,6 +350,6 @@ border-radius: 4px; margin-left: 4px; ">

          Interface GetSessionConfig

          The configuration of getting a session.

          -
          interface GetSessionConfig {
              afterTimestamp?: number;
              numRecentEvents?: number;
          }

          Properties

          afterTimestamp?: number

          Retrieve events after this timestamp.

          -
          numRecentEvents?: number

          The number of recent events to retrieve.

          -
          +
          interface GetSessionConfig {
              afterTimestamp?: number;
              numRecentEvents?: number;
          }

          Properties

          afterTimestamp?: number

          Retrieve events after this timestamp.

          +
          numRecentEvents?: number

          The number of recent events to retrieve.

          +
          diff --git a/docs/api-reference/typescript/interfaces/GetSessionRequest.html b/docs/api-reference/typescript/interfaces/GetSessionRequest.html index c88dd0e18..bf91af555 100644 --- a/docs/api-reference/typescript/interfaces/GetSessionRequest.html +++ b/docs/api-reference/typescript/interfaces/GetSessionRequest.html @@ -350,8 +350,8 @@ border-radius: 4px; margin-left: 4px; ">

          Interface GetSessionRequest

          The parameters for getSession.

          -
          interface GetSessionRequest {
              appName: string;
              config?: GetSessionConfig;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          -

          The configurations for getting the session.

          -
          sessionId: string

          The ID of the session.

          -
          userId: string

          The ID of the user.

          -
          +
          interface GetSessionRequest {
              appName: string;
              config?: GetSessionConfig;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          +

          The configurations for getting the session.

          +
          sessionId: string

          The ID of the session.

          +
          userId: string

          The ID of the user.

          +
          diff --git a/docs/api-reference/typescript/interfaces/ListArtifactKeysRequest.html b/docs/api-reference/typescript/interfaces/ListArtifactKeysRequest.html index 6d16bfa49..ad4e300a4 100644 --- a/docs/api-reference/typescript/interfaces/ListArtifactKeysRequest.html +++ b/docs/api-reference/typescript/interfaces/ListArtifactKeysRequest.html @@ -350,7 +350,7 @@ border-radius: 4px; margin-left: 4px; ">

          Interface ListArtifactKeysRequest

          The parameters for listArtifactKeys.

          -
          interface ListArtifactKeysRequest {
              appName: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          -
          sessionId: string

          The session ID.

          -
          userId: string

          The user ID.

          -
          +
          interface ListArtifactKeysRequest {
              appName: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          +
          sessionId: string

          The session ID.

          +
          userId: string

          The user ID.

          +
          diff --git a/docs/api-reference/typescript/interfaces/ListSessionsRequest.html b/docs/api-reference/typescript/interfaces/ListSessionsRequest.html index d717e949f..ca667daea 100644 --- a/docs/api-reference/typescript/interfaces/ListSessionsRequest.html +++ b/docs/api-reference/typescript/interfaces/ListSessionsRequest.html @@ -350,6 +350,6 @@ border-radius: 4px; margin-left: 4px; ">

          Interface ListSessionsRequest

          The parameters for listSessions.

          -
          interface ListSessionsRequest {
              appName: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          -
          userId: string

          The ID of the user.

          -
          +
          interface ListSessionsRequest {
              appName: string;
              userId: string;
          }

          Properties

          appName: string

          The name of the application.

          +
          userId: string

          The ID of the user.

          +
          diff --git a/docs/api-reference/typescript/interfaces/ListSessionsResponse.html b/docs/api-reference/typescript/interfaces/ListSessionsResponse.html index 47d9d3b35..effa6780a 100644 --- a/docs/api-reference/typescript/interfaces/ListSessionsResponse.html +++ b/docs/api-reference/typescript/interfaces/ListSessionsResponse.html @@ -351,5 +351,5 @@ margin-left: 4px; ">

          Interface ListSessionsResponse

          The response of listing sessions.

          The events and states are not set within each Session object.

          -
          interface ListSessionsResponse {
              sessions: Session[];
          }

          Properties

          sessions: Session[]

          A list of sessions.

          -
          +
          interface ListSessionsResponse {
              sessions: Session[];
          }

          Properties

          sessions: Session[]

          A list of sessions.

          +
          diff --git a/docs/api-reference/typescript/interfaces/ListVersionsRequest.html b/docs/api-reference/typescript/interfaces/ListVersionsRequest.html index 05f73d207..c3f68773b 100644 --- a/docs/api-reference/typescript/interfaces/ListVersionsRequest.html +++ b/docs/api-reference/typescript/interfaces/ListVersionsRequest.html @@ -350,8 +350,8 @@ border-radius: 4px; margin-left: 4px; ">

          Interface ListVersionsRequest

          The parameters for listVersions.

          -
          interface ListVersionsRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          -
          filename: string

          The filename of the artifact.

          -
          sessionId: string

          The session ID.

          -
          userId: string

          The user ID.

          -
          +
          interface ListVersionsRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
          }

          Properties

          appName: string

          The app name.

          +
          filename: string

          The filename of the artifact.

          +
          sessionId: string

          The session ID.

          +
          userId: string

          The user ID.

          +
          diff --git a/docs/api-reference/typescript/interfaces/LiveRequest.html b/docs/api-reference/typescript/interfaces/LiveRequest.html index a5e56b96d..6be12e410 100644 --- a/docs/api-reference/typescript/interfaces/LiveRequest.html +++ b/docs/api-reference/typescript/interfaces/LiveRequest.html @@ -350,9 +350,9 @@ border-radius: 4px; margin-left: 4px; ">

          Interface LiveRequest

          Request sent to live agents.

          -
          interface LiveRequest {
              activityEnd?: ActivityEnd;
              activityStart?: ActivityStart;
              blob?: Blob_2;
              close?: boolean;
              content?: Content;
          }

          Properties

          activityEnd?: ActivityEnd

          If set, signal the end of user activity to the model.

          -
          activityStart?: ActivityStart

          If set, signal the start of user activity to the model.

          -
          blob?: Blob_2

          If set, send the blob to the model in realtime mode.

          -
          close?: boolean

          If set, close the queue.

          -
          content?: Content

          If set, send the content to the model in turn-by-turn mode.

          -
          +
          interface LiveRequest {
              activityEnd?: ActivityEnd;
              activityStart?: ActivityStart;
              blob?: Blob_2;
              close?: boolean;
              content?: Content;
          }

          Properties

          activityEnd?: ActivityEnd

          If set, signal the end of user activity to the model.

          +
          activityStart?: ActivityStart

          If set, signal the start of user activity to the model.

          +
          blob?: Blob_2

          If set, send the blob to the model in realtime mode.

          +
          close?: boolean

          If set, close the queue.

          +
          content?: Content

          If set, send the content to the model in turn-by-turn mode.

          +
          diff --git a/docs/api-reference/typescript/interfaces/LlmRequest.html b/docs/api-reference/typescript/interfaces/LlmRequest.html index 8e39a7696..546554613 100644 --- a/docs/api-reference/typescript/interfaces/LlmRequest.html +++ b/docs/api-reference/typescript/interfaces/LlmRequest.html @@ -351,9 +351,9 @@ margin-left: 4px; ">

          Interface LlmRequest

          LLM request class that allows passing in tools, output schema and system instructions to the model.

          -
          interface LlmRequest {
              config?: GenerateContentConfig;
              contents: Content[];
              liveConnectConfig: LiveConnectConfig;
              model?: string;
              toolsDict: { [key: string]: BaseTool };
          }

          Properties

          config?: GenerateContentConfig

          Additional config for the generate content request. +

          interface LlmRequest {
              config?: GenerateContentConfig;
              contents: Content[];
              liveConnectConfig: LiveConnectConfig;
              model?: string;
              toolsDict: { [key: string]: BaseTool };
          }

          Properties

          config?: GenerateContentConfig

          Additional config for the generate content request. Tools in generateContentConfig should not be set directly; use appendTools.

          -
          contents: Content[]

          The contents to send to the model.

          -
          liveConnectConfig: LiveConnectConfig
          model?: string

          The model name.

          -
          toolsDict: { [key: string]: BaseTool }

          The tools dictionary. Excluded from JSON serialization.

          -
          +
          contents: Content[]

          The contents to send to the model.

          +
          liveConnectConfig: LiveConnectConfig
          model?: string

          The model name.

          +
          toolsDict: { [key: string]: BaseTool }

          The tools dictionary. Excluded from JSON serialization.

          +
          diff --git a/docs/api-reference/typescript/interfaces/LlmResponse.html b/docs/api-reference/typescript/interfaces/LlmResponse.html index 5620cf68e..c75b58d4d 100644 --- a/docs/api-reference/typescript/interfaces/LlmResponse.html +++ b/docs/api-reference/typescript/interfaces/LlmResponse.html @@ -351,22 +351,22 @@ margin-left: 4px; ">

          Interface LlmResponse

          LLM response class that provides the first candidate response from the model if available. Otherwise, returns error code and message.

          -
          interface LlmResponse {
              content?: Content;
              customMetadata?: { [key: string]: any };
              errorCode?: string;
              errorMessage?: string;
              finishReason?: FinishReason;
              groundingMetadata?: GroundingMetadata;
              inputTranscription?: Transcription;
              interrupted?: boolean;
              liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate;
              outputTranscription?: Transcription;
              partial?: boolean;
              turnComplete?: boolean;
              usageMetadata?: GenerateContentResponseUsageMetadata;
          }

          Hierarchy (View Summary)

          Properties

          content?: Content

          The content of the response.

          -
          customMetadata?: { [key: string]: any }

          The custom metadata of the LlmResponse. +

          interface LlmResponse {
              content?: Content;
              customMetadata?: { [key: string]: any };
              errorCode?: string;
              errorMessage?: string;
              finishReason?: FinishReason;
              groundingMetadata?: GroundingMetadata;
              inputTranscription?: Transcription;
              interrupted?: boolean;
              liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate;
              outputTranscription?: Transcription;
              partial?: boolean;
              turnComplete?: boolean;
              usageMetadata?: GenerateContentResponseUsageMetadata;
          }

          Hierarchy (View Summary)

          Properties

          content?: Content

          The content of the response.

          +
          customMetadata?: { [key: string]: any }

          The custom metadata of the LlmResponse. An optional key-value pair to label an LlmResponse. NOTE: the entire object must be JSON serializable.

          -
          errorCode?: string

          Error code if the response is an error. Code varies by model.

          -
          errorMessage?: string

          Error message if the response is an error.

          -
          finishReason?: FinishReason

          The finish reason of the response.

          -
          groundingMetadata?: GroundingMetadata

          The grounding metadata of the response.

          -
          inputTranscription?: Transcription

          Audio transcription of user input.

          -
          interrupted?: boolean

          Flag indicating that LLM was interrupted when generating the content. +

          errorCode?: string

          Error code if the response is an error. Code varies by model.

          +
          errorMessage?: string

          Error message if the response is an error.

          +
          finishReason?: FinishReason

          The finish reason of the response.

          +
          groundingMetadata?: GroundingMetadata

          The grounding metadata of the response.

          +
          inputTranscription?: Transcription

          Audio transcription of user input.

          +
          interrupted?: boolean

          Flag indicating that LLM was interrupted when generating the content. Usually it's due to user interruption during a bidi streaming.

          -
          liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate

          The session resumption update of the LlmResponse

          -
          outputTranscription?: Transcription

          Audio transcription of model output.

          -
          partial?: boolean

          Indicates whether the text content is part of a unfinished text stream. +

          liveSessionResumptionUpdate?: LiveServerSessionResumptionUpdate

          The session resumption update of the LlmResponse

          +
          outputTranscription?: Transcription

          Audio transcription of model output.

          +
          partial?: boolean

          Indicates whether the text content is part of a unfinished text stream. Only used for streaming mode and when the content is plain text.

          -
          turnComplete?: boolean

          Indicates whether the response from the model is complete. +

          turnComplete?: boolean

          Indicates whether the response from the model is complete. Only used for streaming mode.

          -
          usageMetadata?: GenerateContentResponseUsageMetadata

          The usage metadata of the LlmResponse.

          -
          +
          usageMetadata?: GenerateContentResponseUsageMetadata

          The usage metadata of the LlmResponse.

          +
          diff --git a/docs/api-reference/typescript/interfaces/LoadArtifactRequest.html b/docs/api-reference/typescript/interfaces/LoadArtifactRequest.html index b066ee028..cb3076608 100644 --- a/docs/api-reference/typescript/interfaces/LoadArtifactRequest.html +++ b/docs/api-reference/typescript/interfaces/LoadArtifactRequest.html @@ -350,10 +350,10 @@ border-radius: 4px; margin-left: 4px; ">

          Interface LoadArtifactRequest

          The parameters for loadArtifact.

          -
          interface LoadArtifactRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
              version?: number;
          }

          Properties

          appName: string

          The app name.

          -
          filename: string

          The filename of the artifact.

          -
          sessionId: string

          The session ID.

          -
          userId: string

          The user ID.

          -
          version?: number

          The version of the artifact to load. If not provided, the latest version +

          interface LoadArtifactRequest {
              appName: string;
              filename: string;
              sessionId: string;
              userId: string;
              version?: number;
          }

          Properties

          appName: string

          The app name.

          +
          filename: string

          The filename of the artifact.

          +
          sessionId: string

          The session ID.

          +
          userId: string

          The user ID.

          +
          version?: number

          The version of the artifact to load. If not provided, the latest version of the artifact is loaded.

          -
          +
          diff --git a/docs/api-reference/typescript/interfaces/OTelHooks.html b/docs/api-reference/typescript/interfaces/OTelHooks.html new file mode 100644 index 000000000..2e66754f6 --- /dev/null +++ b/docs/api-reference/typescript/interfaces/OTelHooks.html @@ -0,0 +1,355 @@ +OTelHooks | ADK for TypeScript: API Reference
          ADK for TypeScript: API Reference
            Preparing search index...

            Interface OTelHooks

            Configuration hooks for OpenTelemetry setup.

            +

            This interface defines the structure for configuring OpenTelemetry +components including span processors, metric readers, and log record processors.

            +
            interface OTelHooks {
                logRecordProcessors?: LogRecordProcessor[];
                metricReaders?: MetricReader[];
                spanProcessors?: SpanProcessor[];
            }

            Properties

            logRecordProcessors?: LogRecordProcessor[]
            metricReaders?: MetricReader[]
            spanProcessors?: SpanProcessor[]
            diff --git a/docs/api-reference/typescript/interfaces/OtelExportersConfig.html b/docs/api-reference/typescript/interfaces/OtelExportersConfig.html new file mode 100644 index 000000000..3fafa8797 --- /dev/null +++ b/docs/api-reference/typescript/interfaces/OtelExportersConfig.html @@ -0,0 +1,352 @@ +OtelExportersConfig | ADK for TypeScript: API Reference
            ADK for TypeScript: API Reference
              Preparing search index...

              Interface OtelExportersConfig

              interface OtelExportersConfig {
                  enableLogging?: boolean;
                  enableMetrics?: boolean;
                  enableTracing?: boolean;
              }

              Properties

              enableLogging?: boolean
              enableMetrics?: boolean
              enableTracing?: boolean
              diff --git a/docs/api-reference/typescript/interfaces/PolicyCheckResult.html b/docs/api-reference/typescript/interfaces/PolicyCheckResult.html index fe20f4f40..c6fa1e5ec 100644 --- a/docs/api-reference/typescript/interfaces/PolicyCheckResult.html +++ b/docs/api-reference/typescript/interfaces/PolicyCheckResult.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

              Interface PolicyCheckResult

              interface PolicyCheckResult {
                  outcome: string;
                  reason?: string;
              }

              Properties

              outcome: string
              reason?: string
              + ">

              Interface PolicyCheckResult

              interface PolicyCheckResult {
                  outcome: string;
                  reason?: string;
              }

              Properties

              outcome: string
              reason?: string
              diff --git a/docs/api-reference/typescript/interfaces/RunAsyncToolRequest.html b/docs/api-reference/typescript/interfaces/RunAsyncToolRequest.html index 363219f7f..4cd63f72b 100644 --- a/docs/api-reference/typescript/interfaces/RunAsyncToolRequest.html +++ b/docs/api-reference/typescript/interfaces/RunAsyncToolRequest.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

              Interface RunAsyncToolRequest

              The parameters for runAsync.

              -
              interface RunAsyncToolRequest {
                  args: Record<string, unknown>;
                  toolContext: ToolContext;
              }

              Properties

              args: Record<string, unknown>
              toolContext: ToolContext
              +
              interface RunAsyncToolRequest {
                  args: Record<string, unknown>;
                  toolContext: ToolContext;
              }

              Properties

              args: Record<string, unknown>
              toolContext: ToolContext
              diff --git a/docs/api-reference/typescript/interfaces/RunConfig.html b/docs/api-reference/typescript/interfaces/RunConfig.html index 61fe737c5..6e84b3484 100644 --- a/docs/api-reference/typescript/interfaces/RunConfig.html +++ b/docs/api-reference/typescript/interfaces/RunConfig.html @@ -350,27 +350,27 @@ border-radius: 4px; margin-left: 4px; ">

              Interface RunConfig

              Configs for runtime behavior of agents.

              -
              interface RunConfig {
                  enableAffectiveDialog?: boolean;
                  inputAudioTranscription?: AudioTranscriptionConfig;
                  maxLlmCalls?: number;
                  outputAudioTranscription?: AudioTranscriptionConfig;
                  proactivity?: ProactivityConfig;
                  realtimeInputConfig?: RealtimeInputConfig;
                  responseModalities?: Modality[];
                  saveInputBlobsAsArtifacts?: boolean;
                  speechConfig?: SpeechConfig;
                  streamingMode?: StreamingMode;
                  supportCfc?: boolean;
              }

              Properties

              enableAffectiveDialog?: boolean

              If enabled, the model will detect emotions and adapt its responses +

              interface RunConfig {
                  enableAffectiveDialog?: boolean;
                  inputAudioTranscription?: AudioTranscriptionConfig;
                  maxLlmCalls?: number;
                  outputAudioTranscription?: AudioTranscriptionConfig;
                  proactivity?: ProactivityConfig;
                  realtimeInputConfig?: RealtimeInputConfig;
                  responseModalities?: Modality[];
                  saveInputBlobsAsArtifacts?: boolean;
                  speechConfig?: SpeechConfig;
                  streamingMode?: StreamingMode;
                  supportCfc?: boolean;
              }

              Properties

              enableAffectiveDialog?: boolean

              If enabled, the model will detect emotions and adapt its responses accordingly.

              -
              inputAudioTranscription?: AudioTranscriptionConfig

              Input transcription for live agents with audio input from user.

              -
              maxLlmCalls?: number

              A limit on the total number of llm calls for a given run.

              +
              inputAudioTranscription?: AudioTranscriptionConfig

              Input transcription for live agents with audio input from user.

              +
              maxLlmCalls?: number

              A limit on the total number of llm calls for a given run.

              Valid Values:

              • More than 0 and less than sys.maxsize: The bound on the number of llm calls is enforced, if the value is set in this range.
              • Less than or equal to 0: This allows for unbounded number of llm calls.
              -
              outputAudioTranscription?: AudioTranscriptionConfig

              Output audio transcription config.

              -
              proactivity?: ProactivityConfig

              Configures the proactivity of the model. This allows the model to respond +

              outputAudioTranscription?: AudioTranscriptionConfig

              Output audio transcription config.

              +
              proactivity?: ProactivityConfig

              Configures the proactivity of the model. This allows the model to respond proactively to the input and to ignore irrelevant input.

              -
              realtimeInputConfig?: RealtimeInputConfig

              Realtime input config for live agents with audio input from user.

              -
              responseModalities?: Modality[]

              The output modalities. If not set, it's default to AUDIO.

              -
              saveInputBlobsAsArtifacts?: boolean

              Whether or not to save the input blobs as artifacts.

              -
              speechConfig?: SpeechConfig

              Speech configuration for the live agent.

              -
              streamingMode?: StreamingMode

              Streaming mode, None or StreamingMode.SSE or StreamingMode.BIDI.

              -
              supportCfc?: boolean

              Whether to support CFC (Compositional Function Calling). Only applicable +

              realtimeInputConfig?: RealtimeInputConfig

              Realtime input config for live agents with audio input from user.

              +
              responseModalities?: Modality[]

              The output modalities. If not set, it's default to AUDIO.

              +
              saveInputBlobsAsArtifacts?: boolean

              Whether or not to save the input blobs as artifacts.

              +
              speechConfig?: SpeechConfig

              Speech configuration for the live agent.

              +
              streamingMode?: StreamingMode

              Streaming mode, None or StreamingMode.SSE or StreamingMode.BIDI.

              +
              supportCfc?: boolean

              Whether to support CFC (Compositional Function Calling). Only applicable for StreamingMode.SSE. If it's true. the LIVE API will be invoked. Since only LIVE API supports CFC

              WARNING: This feature is experimental and its API or behavior may change in future releases.

              -
              +
              diff --git a/docs/api-reference/typescript/interfaces/SaveArtifactRequest.html b/docs/api-reference/typescript/interfaces/SaveArtifactRequest.html index 5e44c07a8..5f1ee4745 100644 --- a/docs/api-reference/typescript/interfaces/SaveArtifactRequest.html +++ b/docs/api-reference/typescript/interfaces/SaveArtifactRequest.html @@ -350,9 +350,9 @@ border-radius: 4px; margin-left: 4px; ">

              Interface SaveArtifactRequest

              The parameters for saveArtifact.

              -
              interface SaveArtifactRequest {
                  appName: string;
                  artifact: Part;
                  filename: string;
                  sessionId: string;
                  userId: string;
              }

              Properties

              appName: string

              The app name.

              -
              artifact: Part

              The artifact to save.

              -
              filename: string

              The filename of the artifact.

              -
              sessionId: string

              The session ID.

              -
              userId: string

              The user ID.

              -
              +
              interface SaveArtifactRequest {
                  appName: string;
                  artifact: Part;
                  filename: string;
                  sessionId: string;
                  userId: string;
              }

              Properties

              appName: string

              The app name.

              +
              artifact: Part

              The artifact to save.

              +
              filename: string

              The filename of the artifact.

              +
              sessionId: string

              The session ID.

              +
              userId: string

              The user ID.

              +
              diff --git a/docs/api-reference/typescript/interfaces/SearchMemoryRequest.html b/docs/api-reference/typescript/interfaces/SearchMemoryRequest.html index f72ab47cf..eaeac4485 100644 --- a/docs/api-reference/typescript/interfaces/SearchMemoryRequest.html +++ b/docs/api-reference/typescript/interfaces/SearchMemoryRequest.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

              Interface SearchMemoryRequest

              The parameters for searchMemory.

              -
              interface SearchMemoryRequest {
                  appName: string;
                  query: string;
                  userId: string;
              }

              Properties

              appName: string
              query: string
              userId: string
              +
              interface SearchMemoryRequest {
                  appName: string;
                  query: string;
                  userId: string;
              }

              Properties

              appName: string
              query: string
              userId: string
              diff --git a/docs/api-reference/typescript/interfaces/SearchMemoryResponse.html b/docs/api-reference/typescript/interfaces/SearchMemoryResponse.html index 89c2c5d6a..09ca2186f 100644 --- a/docs/api-reference/typescript/interfaces/SearchMemoryResponse.html +++ b/docs/api-reference/typescript/interfaces/SearchMemoryResponse.html @@ -350,5 +350,5 @@ border-radius: 4px; margin-left: 4px; ">

              Interface SearchMemoryResponse

              Represents the response from a memory search.

              -
              interface SearchMemoryResponse {
                  memories: MemoryEntry[];
              }

              Properties

              memories: MemoryEntry[]

              A list of memory entries that are related to the search query.

              -
              +
              interface SearchMemoryResponse {
                  memories: MemoryEntry[];
              }

              Properties

              memories: MemoryEntry[]

              A list of memory entries that are related to the search query.

              +
              diff --git a/docs/api-reference/typescript/interfaces/Session.html b/docs/api-reference/typescript/interfaces/Session.html index c54b7ad1a..5443e6393 100644 --- a/docs/api-reference/typescript/interfaces/Session.html +++ b/docs/api-reference/typescript/interfaces/Session.html @@ -350,11 +350,11 @@ border-radius: 4px; margin-left: 4px; ">

              Interface Session

              Represents a session in a conversation between agents and users.

              -
              interface Session {
                  appName: string;
                  events: Event[];
                  id: string;
                  lastUpdateTime: number;
                  state: Record<string, unknown>;
                  userId: string;
              }

              Properties

              appName: string

              The name of the app.

              -
              events: Event[]

              The events of the session, e.g. user input, model response, function +

              interface Session {
                  appName: string;
                  events: Event[];
                  id: string;
                  lastUpdateTime: number;
                  state: Record<string, unknown>;
                  userId: string;
              }

              Properties

              appName: string

              The name of the app.

              +
              events: Event[]

              The events of the session, e.g. user input, model response, function call/response, etc.

              -
              id: string

              The unique identifier of the session.

              -
              lastUpdateTime: number

              The last update time of the session.

              -
              state: Record<string, unknown>

              The state of the session.

              -
              userId: string

              The id of the user.

              -
              +
              id: string

              The unique identifier of the session.

              +
              lastUpdateTime: number

              The last update time of the session.

              +
              state: Record<string, unknown>

              The state of the session.

              +
              userId: string

              The id of the user.

              +
              diff --git a/docs/api-reference/typescript/interfaces/StdioConnectionParams.html b/docs/api-reference/typescript/interfaces/StdioConnectionParams.html index 30a4186c9..ef7cf917c 100644 --- a/docs/api-reference/typescript/interfaces/StdioConnectionParams.html +++ b/docs/api-reference/typescript/interfaces/StdioConnectionParams.html @@ -352,4 +352,4 @@ ">

              Interface StdioConnectionParams

              Defines the parameters for establishing a connection to an MCP server using standard input/output (stdio). This is typically used for running MCP servers as local child processes.

              -
              interface StdioConnectionParams {
                  serverParams: StdioServerParameters;
                  timeout?: Number;
                  type: "StdioConnectionParams";
              }

              Properties

              serverParams: StdioServerParameters
              timeout?: Number
              type: "StdioConnectionParams"
              +
              interface StdioConnectionParams {
                  serverParams: StdioServerParameters;
                  timeout?: Number;
                  type: "StdioConnectionParams";
              }

              Properties

              serverParams: StdioServerParameters
              timeout?: Number
              type: "StdioConnectionParams"
              diff --git a/docs/api-reference/typescript/interfaces/StreamableHTTPConnectionParams.html b/docs/api-reference/typescript/interfaces/StreamableHTTPConnectionParams.html index dcf7e93e7..e59782c6c 100644 --- a/docs/api-reference/typescript/interfaces/StreamableHTTPConnectionParams.html +++ b/docs/api-reference/typescript/interfaces/StreamableHTTPConnectionParams.html @@ -356,4 +356,4 @@ type: 'StreamableHTTPConnectionParams', url: 'http://localhost:8788/mcp' };

              -
              interface StreamableHTTPConnectionParams {
                  header?: Record<string, unknown>;
                  sseReadTimeout?: Number;
                  terminateOnClose?: boolean;
                  timeout?: Number;
                  type: "StreamableHTTPConnectionParams";
                  url: string;
              }

              Properties

              header?: Record<string, unknown>
              sseReadTimeout?: Number
              terminateOnClose?: boolean
              timeout?: Number
              type: "StreamableHTTPConnectionParams"
              url: string
              +
              interface StreamableHTTPConnectionParams {
                  header?: Record<string, unknown>;
                  sseReadTimeout?: Number;
                  terminateOnClose?: boolean;
                  timeout?: Number;
                  type: "StreamableHTTPConnectionParams";
                  url: string;
              }

              Properties

              header?: Record<string, unknown>
              sseReadTimeout?: Number
              terminateOnClose?: boolean
              timeout?: Number
              type: "StreamableHTTPConnectionParams"
              url: string
              diff --git a/docs/api-reference/typescript/interfaces/ToolCallPolicyContext.html b/docs/api-reference/typescript/interfaces/ToolCallPolicyContext.html index b629db7d9..690a34d19 100644 --- a/docs/api-reference/typescript/interfaces/ToolCallPolicyContext.html +++ b/docs/api-reference/typescript/interfaces/ToolCallPolicyContext.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

              Interface ToolCallPolicyContext

              interface ToolCallPolicyContext {
                  tool: BaseTool;
                  toolArgs: Record<string, unknown>;
              }

              Properties

              tool: BaseTool
              toolArgs: Record<string, unknown>
              + ">

              Interface ToolCallPolicyContext

              interface ToolCallPolicyContext {
                  tool: BaseTool;
                  toolArgs: Record<string, unknown>;
              }

              Properties

              tool: BaseTool
              toolArgs: Record<string, unknown>
              diff --git a/docs/api-reference/typescript/interfaces/ToolProcessLlmRequest.html b/docs/api-reference/typescript/interfaces/ToolProcessLlmRequest.html index 952a8f64b..f837ce040 100644 --- a/docs/api-reference/typescript/interfaces/ToolProcessLlmRequest.html +++ b/docs/api-reference/typescript/interfaces/ToolProcessLlmRequest.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

              Interface ToolProcessLlmRequest

              The parameters for processLlmRequest.

              -
              interface ToolProcessLlmRequest {
                  llmRequest: LlmRequest;
                  toolContext: ToolContext;
              }

              Properties

              llmRequest: LlmRequest
              toolContext: ToolContext
              +
              interface ToolProcessLlmRequest {
                  llmRequest: LlmRequest;
                  toolContext: ToolContext;
              }

              Properties

              llmRequest: LlmRequest
              toolContext: ToolContext
              diff --git a/docs/api-reference/typescript/types/AfterModelCallback.html b/docs/api-reference/typescript/types/AfterModelCallback.html index cf5e526df..34f8bc82e 100644 --- a/docs/api-reference/typescript/types/AfterModelCallback.html +++ b/docs/api-reference/typescript/types/AfterModelCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias AfterModelCallback

              A single callback or a list of callbacks.

              When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return None.

              -
              +
              diff --git a/docs/api-reference/typescript/types/AfterToolCallback.html b/docs/api-reference/typescript/types/AfterToolCallback.html index f0eb77fbf..6160f3f3d 100644 --- a/docs/api-reference/typescript/types/AfterToolCallback.html +++ b/docs/api-reference/typescript/types/AfterToolCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias AfterToolCallback

              A single callback or a list of callbacks.

              When a list of callbacks is provided, the callbacks will be called in the order they are listed until acallback does not return None.

              -
              +
              diff --git a/docs/api-reference/typescript/types/BeforeModelCallback.html b/docs/api-reference/typescript/types/BeforeModelCallback.html index f958c010d..fead5b04d 100644 --- a/docs/api-reference/typescript/types/BeforeModelCallback.html +++ b/docs/api-reference/typescript/types/BeforeModelCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias BeforeModelCallback

              A single callback or a list of callbacks.

              When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return None.

              -
              +
              diff --git a/docs/api-reference/typescript/types/BeforeToolCallback.html b/docs/api-reference/typescript/types/BeforeToolCallback.html index 3b0f82cdd..f83d1ca88 100644 --- a/docs/api-reference/typescript/types/BeforeToolCallback.html +++ b/docs/api-reference/typescript/types/BeforeToolCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias BeforeToolCallback

              A single callback or a list of callbacks.

              When a list of callbacks is provided, the callbacks will be called in the order they are listed until a callback does not return None.

              -
              +
              diff --git a/docs/api-reference/typescript/types/MCPConnectionParams.html b/docs/api-reference/typescript/types/MCPConnectionParams.html index d7f0a3c70..6508c99d5 100644 --- a/docs/api-reference/typescript/types/MCPConnectionParams.html +++ b/docs/api-reference/typescript/types/MCPConnectionParams.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

              Type Alias MCPConnectionParams

              A union of all supported MCP connection parameter types.

              -
              +
              diff --git a/docs/api-reference/typescript/types/SingleAfterModelCallback.html b/docs/api-reference/typescript/types/SingleAfterModelCallback.html index 479583c15..e0203f5e1 100644 --- a/docs/api-reference/typescript/types/SingleAfterModelCallback.html +++ b/docs/api-reference/typescript/types/SingleAfterModelCallback.html @@ -353,4 +353,4 @@

              Type Declaration

              +
              diff --git a/docs/api-reference/typescript/types/SingleAfterToolCallback.html b/docs/api-reference/typescript/types/SingleAfterToolCallback.html index b48d84345..7a4eae48f 100644 --- a/docs/api-reference/typescript/types/SingleAfterToolCallback.html +++ b/docs/api-reference/typescript/types/SingleAfterToolCallback.html @@ -351,4 +351,4 @@ margin-left: 4px; ">

              Type Alias SingleAfterToolCallback

              SingleAfterToolCallback: (
                  params: {
                      args: Dict;
                      context: ToolContext;
                      response: Dict;
                      tool: BaseTool;
                  },
              ) => Dict
              | undefined
              | Promise<Dict | undefined>

              A callback that runs after a tool is called.

              Type Declaration

                • (
                      params: {
                          args: Dict;
                          context: ToolContext;
                          response: Dict;
                          tool: BaseTool;
                      },
                  ): Dict
                  | undefined
                  | Promise<Dict | undefined>
                • Parameters

                  Returns Dict | undefined | Promise<Dict | undefined>

                  When present, the returned dict will be used as tool result.

                  -
              +
              diff --git a/docs/api-reference/typescript/types/SingleBeforeModelCallback.html b/docs/api-reference/typescript/types/SingleBeforeModelCallback.html index 4d4edc6da..1a70c2abc 100644 --- a/docs/api-reference/typescript/types/SingleBeforeModelCallback.html +++ b/docs/api-reference/typescript/types/SingleBeforeModelCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias SingleBeforeModelCallback

              SingleBeforeModelCallback: (
                  params: { context: CallbackContext; request: LlmRequest },
              ) => LlmResponse | undefined | Promise<LlmResponse | undefined>

              A callback that runs before a request is sent to the model.

              Type Declaration

              +
              diff --git a/docs/api-reference/typescript/types/SingleBeforeToolCallback.html b/docs/api-reference/typescript/types/SingleBeforeToolCallback.html index 6e26ab2c2..5f6e465ca 100644 --- a/docs/api-reference/typescript/types/SingleBeforeToolCallback.html +++ b/docs/api-reference/typescript/types/SingleBeforeToolCallback.html @@ -352,4 +352,4 @@ ">

              Type Alias SingleBeforeToolCallback

              SingleBeforeToolCallback: (
                  params: { args: Dict; context: ToolContext; tool: BaseTool },
              ) => Dict | undefined | Promise<Dict | undefined>

              A callback that runs before a tool is called.

              Type Declaration

                • (
                      params: { args: Dict; context: ToolContext; tool: BaseTool },
                  ): Dict | undefined | Promise<Dict | undefined>
                • Parameters

                  Returns Dict | undefined | Promise<Dict | undefined>

                  The tool response. When present, the returned tool response will be used and the framework will skip calling the actual tool.

                  -
              +
              diff --git a/docs/api-reference/typescript/variables/GOOGLE_SEARCH.html b/docs/api-reference/typescript/variables/GOOGLE_SEARCH.html index cf134f119..9665764fb 100644 --- a/docs/api-reference/typescript/variables/GOOGLE_SEARCH.html +++ b/docs/api-reference/typescript/variables/GOOGLE_SEARCH.html @@ -350,4 +350,4 @@ border-radius: 4px; margin-left: 4px; ">

              Variable GOOGLE_SEARCHConst

              GOOGLE_SEARCH: GoogleSearchTool = ...

              A global instance of GoogleSearchTool.

              -
              +
              diff --git a/docs/api-reference/typescript/variables/REQUEST_CONFIRMATION_FUNCTION_CALL_NAME.html b/docs/api-reference/typescript/variables/REQUEST_CONFIRMATION_FUNCTION_CALL_NAME.html index fb66ade1b..a2936e60f 100644 --- a/docs/api-reference/typescript/variables/REQUEST_CONFIRMATION_FUNCTION_CALL_NAME.html +++ b/docs/api-reference/typescript/variables/REQUEST_CONFIRMATION_FUNCTION_CALL_NAME.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

              Variable REQUEST_CONFIRMATION_FUNCTION_CALL_NAMEConst

              REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: "adk_request_confirmation" = 'adk_request_confirmation'
              + ">

              Variable REQUEST_CONFIRMATION_FUNCTION_CALL_NAMEConst

              REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: "adk_request_confirmation" = 'adk_request_confirmation'
              diff --git a/docs/api-reference/typescript/variables/functionsExportedForTestingOnly.html b/docs/api-reference/typescript/variables/functionsExportedForTestingOnly.html index 8c5a9b449..0c29d6891 100644 --- a/docs/api-reference/typescript/variables/functionsExportedForTestingOnly.html +++ b/docs/api-reference/typescript/variables/functionsExportedForTestingOnly.html @@ -349,4 +349,4 @@ border: 1px solid var(--color-background-active); border-radius: 4px; margin-left: 4px; - ">

              Variable functionsExportedForTestingOnlyConst

              functionsExportedForTestingOnly: {
                  handleFunctionCallList: (
                      __namedParameters: {
                          afterToolCallbacks: SingleAfterToolCallback[];
                          beforeToolCallbacks: SingleBeforeToolCallback[];
                          filters?: Set<string>;
                          functionCalls: FunctionCall[];
                          invocationContext: InvocationContext;
                          toolConfirmationDict?: Record<string, ToolConfirmation>;
                          toolsDict: Record<string, BaseTool>;
                      },
                  ) => Promise<Event | null>;
              } = ...

              Type Declaration

              • handleFunctionCallList: (
                    __namedParameters: {
                        afterToolCallbacks: SingleAfterToolCallback[];
                        beforeToolCallbacks: SingleBeforeToolCallback[];
                        filters?: Set<string>;
                        functionCalls: FunctionCall[];
                        invocationContext: InvocationContext;
                        toolConfirmationDict?: Record<string, ToolConfirmation>;
                        toolsDict: Record<string, BaseTool>;
                    },
                ) => Promise<Event | null>
              + ">

              Variable functionsExportedForTestingOnlyConst

              functionsExportedForTestingOnly: {
                  handleFunctionCallList: (
                      __namedParameters: {
                          afterToolCallbacks: SingleAfterToolCallback[];
                          beforeToolCallbacks: SingleBeforeToolCallback[];
                          filters?: Set<string>;
                          functionCalls: FunctionCall[];
                          invocationContext: InvocationContext;
                          toolConfirmationDict?: Record<string, ToolConfirmation>;
                          toolsDict: Record<string, BaseTool>;
                      },
                  ) => Promise<Event | null>;
              } = ...

              Type Declaration

              • handleFunctionCallList: (
                    __namedParameters: {
                        afterToolCallbacks: SingleAfterToolCallback[];
                        beforeToolCallbacks: SingleBeforeToolCallback[];
                        filters?: Set<string>;
                        functionCalls: FunctionCall[];
                        invocationContext: InvocationContext;
                        toolConfirmationDict?: Record<string, ToolConfirmation>;
                        toolsDict: Record<string, BaseTool>;
                    },
                ) => Promise<Event | null>