No public description

PiperOrigin-RevId: 960531964

Author: MarkDaoust

src/gaos/models/interactions/function.ts

@@ -14,6 +14,10 @@
  * A tool that can be used by the model.
  */
 export type FunctionT = {
+  /**
+   * If true, the function's loading is deferred.
+   */
+  defer_loading?: boolean | undefined;
   /**
    * A description of the function.
    */
@@ -26,5 +30,12 @@ export type FunctionT = {
    * The JSON Schema for the function's parameters.
    */
   parameters?: any | undefined;
+  /**
+   * A brief description of the function, shown to the model as a
+   *
+   * @remarks
+   * short summary of functions with `defer_loading` set to true.
+   */
+  short_description?: string | undefined;
   type: "function";
 };

src/gaos/models/interactions/index.ts

@@ -136,6 +136,10 @@ export * from "./thought-summary-content.js";
 export * from "./thought-summary-delta.js";
 export * from "./tool-choice-config.js";
 export * from "./tool-choice-type.js";
+export * from "./tool-search-call-delta.js";
+export * from "./tool-search-call-step-arguments.js";
+export * from "./tool-search-result-delta.js";
+export * from "./tool-search.js";
 export * from "./tool.js";
 export * from "./transcription-config.js";
 export * from "./url-citation.js";

src/gaos/models/interactions/mcp-server.ts

@@ -20,6 +20,10 @@ export type MCPServer = {
    * The allowed tools.
    */
   allowed_tools?: Array<AllowedTools> | undefined;
+  /**
+   * If true, loading of tools on this MCP server is deferred.
+   */
+  defer_loading?: boolean | undefined;
   /**
    * Optional: Fields for authentication headers, timeouts, etc., if needed.
    */

src/gaos/models/interactions/step-delta-data.ts

@@ -31,6 +31,8 @@ import { TextAnnotationDelta } from "./text-annotation-delta.js";
 import { TextDelta } from "./text-delta.js";
 import { ThoughtSignatureDelta } from "./thought-signature-delta.js";
 import { ThoughtSummaryDelta } from "./thought-summary-delta.js";
+import { ToolSearchCallDelta } from "./tool-search-call-delta.js";
+import { ToolSearchResultDelta } from "./tool-search-result-delta.js";
 import { URLContextCallDelta } from "./url-context-call-delta.js";
 import { URLContextResultDelta } from "./url-context-result-delta.js";
 import { VideoDelta } from "./video-delta.js";
@@ -57,6 +59,8 @@ export type StepDeltaData =
   | TextDelta
   | ThoughtSignatureDelta
   | ThoughtSummaryDelta
+  | ToolSearchCallDelta
+  | ToolSearchResultDelta
   | URLContextCallDelta
   | URLContextResultDelta
   | VideoDelta;

src/gaos/models/interactions/tool-search-call-delta.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ToolSearchCallStepArguments } from "./tool-search-call-step-arguments.js";
+
+export type ToolSearchCallDelta = {
+  arguments?: ToolSearchCallStepArguments | undefined;
+  /**
+   * A signature hash for backend validation.
+   */
+  signature?: string | undefined;
+  type: "tool_search_call";
+};

src/gaos/models/interactions/tool-search-call-step-arguments.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export type ToolSearchCallStepArguments = {
+  /**
+   * List of function names to load explicitly.
+   */
+  function_names?: Array<string> | undefined;
+};

src/gaos/models/interactions/tool-search-result-delta.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { FunctionT } from "./function.js";
+
+export type ToolSearchResultDelta = {
+  result?: Array<FunctionT> | undefined;
+  /**
+   * A signature hash for backend validation.
+   */
+  signature?: string | undefined;
+  type: "tool_search_result";
+};

src/gaos/models/interactions/tool-search.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * g3-prettier-ignore-file
+ */
+
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/**
+ * The execution mode of the tool search.
+ */
+export type Execution = "server" | "client" | (string & {});
+
+/**
+ * A tool that allows the model to dynamically search for and load tools into
+ *
+ * @remarks
+ * the model’s context on demand. This allows clients to avoid loading all tool
+ * definitions up front and may help reduce overall token usage and cost.
+ */
+export type ToolSearch = {
+  /**
+   * A description of the function. To be set only for client-side execution.
+   */
+  description?: string | undefined;
+  /**
+   * The execution mode of the tool search.
+   */
+  execution?: Execution | undefined;
+  /**
+   * The name of the function. To be set only for client-side execution.
+   */
+  name?: string | undefined;
+  /**
+   * The JSON Schema for the function's parameters. To be set only for
+   *
+   * @remarks
+   * client-side execution.
+   */
+  parameters?: any | undefined;
+  type: "tool_search";
+};

src/gaos/models/interactions/tool.ts

@@ -18,6 +18,7 @@ import { GoogleMaps } from "./google-maps.js";
 import { GoogleSearch } from "./google-search.js";
 import { MCPServer } from "./mcp-server.js";
 import { Retrieval } from "./retrieval.js";
+import { ToolSearch } from "./tool-search.js";
 import { URLContext } from "./url-context.js";
 
 /**
@@ -32,4 +33,5 @@ export type Tool =
   | GoogleSearch
   | MCPServer
   | Retrieval
+  | ToolSearch
   | URLContext;

src/gaos/resources.ts

@@ -117,6 +117,9 @@ import type { ThoughtStep as ThoughtStep$Import } from "./models/interactions/th
 import type { ThoughtSummaryDelta as ThoughtSummaryDelta$Import } from "./models/interactions/thought-summary-delta.js";
 import type { ToolChoiceConfig as ToolChoiceConfig$Import } from "./models/interactions/tool-choice-config.js";
 import type { ToolChoiceType as ToolChoiceType$Import } from "./models/interactions/tool-choice-type.js";
+import type { ToolSearchCallDelta as ToolSearchCallDelta$Import } from "./models/interactions/tool-search-call-delta.js";
+import type { ToolSearchResultDelta as ToolSearchResultDelta$Import } from "./models/interactions/tool-search-result-delta.js";
+import type { ToolSearch as ToolSearch$Import } from "./models/interactions/tool-search.js";
 import type { Tool as Tool$Import } from "./models/interactions/tool.js";
 import type { TranscriptionConfig as TranscriptionConfig$Import } from "./models/interactions/transcription-config.js";
 import type { URLCitation as URLCitation$Import } from "./models/interactions/url-citation.js";
@@ -318,6 +321,8 @@ type Text$ = TextDelta$Import;
 type TextAnnotationDelta$ = TextAnnotationDelta$Import;
 type ThoughtSignature$ = ThoughtSignatureDelta$Import;
 type ThoughtSummary$ = ThoughtSummaryDelta$Import;
+type ToolSearchCall$ = ToolSearchCallDelta$Import;
+type ToolSearchResult$ = ToolSearchResultDelta$Import;
 type URLContextCall$ = URLContextCallDelta$Import;
 type URLContextResult$2 = URLContextResultDelta$Import;
 type Video$ = VideoDelta$Import;
@@ -328,6 +333,7 @@ type GoogleMaps$ = GoogleMaps$Import;
 type GoogleSearch$ = GoogleSearch$Import;
 type MCPServer$ = MCPServer$Import;
 type Retrieval$ = Retrieval$Import;
+type ToolSearch$ = ToolSearch$Import;
 type URLContext$ = URLContext$Import;
 type VertexAISearchConfig$ = VertexAISearchConfig$Import;
 type Arguments$5 = URLContextCallArguments$Import;
@@ -504,6 +510,9 @@ export type ThoughtSummary = ThoughtSummary$;
 export type Tool = Tool$;
 export type ToolChoiceConfig = ToolChoiceConfig$;
 export type ToolChoiceType = ToolChoiceType$;
+export type ToolSearch = ToolSearch$;
+export type ToolSearchCall = ToolSearchCall$;
+export type ToolSearchResult = ToolSearchResult$;
 export type ToolUseTokensByModality = ToolUseTokensByModality$;
 export type TranscriptionConfig = TranscriptionConfig$;
 export type Trigger = Trigger$;
@@ -741,6 +750,8 @@ export declare namespace Interactions {
     export type TextAnnotationDelta = TextAnnotationDelta$;
     export type ThoughtSignature = ThoughtSignature$;
     export type ThoughtSummary = ThoughtSummary$;
+    export type ToolSearchCall = ToolSearchCall$;
+    export type ToolSearchResult = ToolSearchResult$;
     export type URLContextCall = URLContextCall$;
     export type URLContextResult = URLContextResult$2;
     export type Video = Video$;
@@ -753,6 +764,7 @@ export declare namespace Interactions {
     export type GoogleSearch = GoogleSearch$;
     export type MCPServer = MCPServer$;
     export interface Retrieval extends Retrieval$ {}
+    export type ToolSearch = ToolSearch$;
     export type URLContext = URLContext$;
     export namespace Retrieval {
       export type VertexAISearchConfig = VertexAISearchConfig$;