@google/adk 2.1.0 → 2.2.0

package/dist/types/utils/client_labels.d.ts

@@ -3,6 +3,12 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * The header shapes that `fetch` accepts. This matches the DOM library's
+ * `HeadersInit`, which is not used by name because the lint configuration
+ * defines only Node globals and its `no-undef` rule rejects it.
+ */
+type HeadersInput = Headers | Array<[string, string]> | Record<string, string>;
 export declare function parseUserAgent(userAgent: string): string;
 /**
  * Runs the given callback within a context that has the specified client label.
@@ -17,3 +23,30 @@ export declare function runWithClientLabel<R>(clientLabel: string, callback: ()
  * Returns the current list of client labels that can be added to HTTP Headers.
  */
 export declare function getClientLabels(): string[];
+/**
+ * Returns the HTTP headers that identify a request as coming from ADK.
+ *
+ * Both headers carry the current client labels, including a label set with
+ * {@link runWithClientLabel} when called inside that context.
+ */
+export declare function getTrackingHeaders(): Record<string, string>;
+/**
+ * Returns a copy of `headers` with the ADK tracking headers merged in.
+ *
+ * HTTP header names are case-insensitive, so a caller's `User-Agent` or
+ * `X-Goog-Api-Client` in any casing is folded onto the lower-case name and the
+ * header is sent once. For each tracking header, the ADK tokens come first,
+ * followed by every caller token that is not already present. Caller values
+ * are split on whitespace and empty tokens are dropped; adk-python splits on a
+ * single space, so the two differ only for values with repeated or non-space
+ * whitespace. Commas are not treated as separators, so a `Headers` object that
+ * joined two values of one header with `, ` keeps the comma on the first
+ * token. All other headers keep the caller's name and value.
+ *
+ * The input is never mutated.
+ *
+ * @param headers The caller's headers, in any `HeadersInit` shape.
+ * @return A new plain object with the merged headers.
+ */
+export declare function mergeTrackingHeaders(headers?: HeadersInput): Record<string, string>;
+export {};

package/dist/types/utils/gemini_schema_util.d.ts

@@ -10,4 +10,17 @@ type MCPToolSchema = {
     required?: string[];
 };
 export declare function toGeminiSchema(mcpSchema?: MCPToolSchema): Schema | undefined;
+/**
+ * Converts an OpenAPI schema to a Gemini `Schema`.
+ *
+ * This is the counterpart of `toGeminiSchema` for an arbitrary OpenAPI schema
+ * rather than an MCP tool input schema. An OpenAPI document may carry any key
+ * it likes, so a key the Gemini `Schema` does not declare is dropped instead of
+ * being forwarded to a backend that rejects it.
+ *
+ * @param openApiSchema The OpenAPI schema, which may be any value.
+ * @returns The converted schema, or `undefined` when there is no input.
+ * @throws {TypeError} If the input is neither an object nor nullish.
+ */
+export declare function openApiSchemaToGeminiSchema(openApiSchema?: unknown): Schema | undefined;
 export {};

package/dist/types/utils/hash_utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Serializes `value` to JSON with the keys of every object sorted, so two
+ * structurally equal values stringify identically whatever order their
+ * properties were assigned in.
+ *
+ * Array order is meaningful and is preserved. A value JSON cannot represent at
+ * the top level, such as `undefined` or a function, stringifies to
+ * `'undefined'`, because `JSON.stringify` returns no string for it and callers
+ * need one.
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Returns a short lowercase hex digest of `value`, computed with FNV-1a over
+ * {@link stableStringify}.
+ *
+ * This is not a cryptographic hash and must not be used as one. It exists to
+ * keep distinct values in distinct cache slots, which is the same job
+ * adk-python gives the builtin `hash()`.
+ */
+export declare function stableHash(value: unknown): string;

package/dist/types/utils/logger.d.ts

@@ -33,7 +33,11 @@ export declare const CONSOLE_METHOD: {
  */
 export declare function setLogger(customLogger: Logger | null): void;
 /**
- * Gets the current logger instance.
+ * Gets the logger instance that is currently installed.
+ *
+ * The result is a snapshot. A later {@link setLogger} call swaps the instance,
+ * and this reference keeps writing to the old one. The {@link logger} facade
+ * resolves the installed instance on every call.
  */
 export declare function getLogger(): Logger;
 /**
@@ -55,6 +59,10 @@ export declare function resetLogger(): void;
  */
 export declare function setLogLevel(level: LogLevel): void;
 /**
- * The logger instance for ADK.
+ * The ADK logger.
+ *
+ * Every method forwards to the instance installed by {@link setLogger} at call
+ * time, so this object is safe to capture at module scope, including across a
+ * {@link setLogger} call with `null` to disable logging.
  */
 export declare const logger: Logger;

package/dist/types/utils/model_name.d.ts

@@ -33,10 +33,38 @@ export declare function isGemini1Model(modelString: string): boolean;
  */
 export declare function isGemini2OrAbove(modelString: string): boolean;
 /**
- * Check if the model is a Gemini 3.x Flash Live model.
+ * Check if the model is a Gemini 3.x Live model.
+ *
+ * Matches the whole `gemini-3.N-*live*` family, not just the `-flash-live`
+ * spelling: ids such as `gemini-3.8-live` and `gemini-3.5-transcribe-live` are
+ * Live models too, and they need the same realtime handling. Non-live 3.x
+ * models such as `gemini-3.0-flash` are still excluded. Gemini 3.5 Live
+ * Translate ids are excluded as well, mirroring adk-python's
+ * `_is_gemini_3_x_live`, which handles them through a dedicated translate
+ * branch instead.
+ *
+ * @param modelString Either a simple model name or path-based model name
+ * @return true if it's a Gemini 3.x Live model, false otherwise.
+ */
+export declare function isGemini3xLive(modelString: string | undefined): boolean;
+/**
+ * Check if the model is a Gemini 3.5 Live Translate model.
+ *
+ * Live Translate ids contain "-live" but are translation endpoints rather
+ * than conversational Live models, so they must not take the Gemini 3.x Live
+ * conversational path. Mirrors adk-python's `is_gemini_3_5_live_translate`.
+ *
+ * @param modelString Either a simple model name or path-based model name
+ * @return true if it's a Gemini 3.5 Live Translate model, false otherwise.
+ */
+export declare function isGemini35LiveTranslate(modelString: string | undefined): boolean;
+/**
+ * Check if the model is a Gemini 3.x Live model.
  *
  * @param modelString Either a simple model name or path-based model name
- * @return true if it's a Gemini 3.x Flash Live model, false otherwise.
+ * @return true if it's a Gemini 3.x Live model, false otherwise.
+ * @deprecated Renamed to {@link isGemini3xLive}, which covers every Gemini 3.x
+ *   Live id rather than only those spelled `-flash-live`.
  */
 export declare function isGemini3xFlashLive(modelString: string | undefined): boolean;
 /**

package/dist/types/version.d.ts

@@ -3,4 +3,4 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-export declare const version = "2.1.0";
+export declare const version = "2.2.0";