@google/adk 1.2.0 → 1.3.0

package/dist/web/models/gemini_llm_connection.js

@@ -16,15 +16,20 @@ var __asyncGenerator = (__this, __arguments, generator) => {
   }, method = (k) => it[k] = (x) => new Promise((yes, no) => resume(k, x, yes, no)), it = {};
   return generator = generator.apply(__this, __arguments), it[__knownSymbol("asyncIterator")] = () => it, method("next"), method("throw"), method("return"), it;
 };
+var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
 /**
  * @license
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { LiveResponseAggregator } from "../utils/live_connection_utils.js";
 import { logger } from "../utils/logger.js";
+import { isGemini3xFlashLive } from "../utils/model_name.js";
 class GeminiLlmConnection {
-  constructor(geminiSession) {
+  constructor(geminiSession, modelVersion, messageQueue) {
     this.geminiSession = geminiSession;
+    this.modelVersion = modelVersion;
+    this.messageQueue = messageQueue;
   }
   /**
    * Sends the conversation history to the gemini model.
@@ -43,9 +48,10 @@ class GeminiLlmConnection {
       }
     );
     if (contents.length > 0) {
+      const isGemini3x = isGemini3xFlashLive(this.modelVersion);
       this.geminiSession.sendClientContent({
         turns: contents,
-        turnComplete: contents[contents.length - 1].role === "user"
+        turnComplete: isGemini3x ? true : contents[contents.length - 1].role === "user"
       });
     } else {
       logger.info("no content is sent");
@@ -72,10 +78,16 @@ class GeminiLlmConnection {
       });
     } else {
       logger.debug("Sending LLM new content", content);
-      this.geminiSession.sendClientContent({
-        turns: [content],
-        turnComplete: true
-      });
+      const isGemini3x = isGemini3xFlashLive(this.modelVersion);
+      if (isGemini3x && content.parts.length === 1 && content.parts[0].text) {
+        logger.debug("Using sendRealtimeInput for Gemini 3.x text input");
+        this.geminiSession.sendRealtimeInput({ text: content.parts[0].text });
+      } else {
+        this.geminiSession.sendClientContent({
+          turns: [content],
+          turnComplete: true
+        });
+      }
     }
   }
   /**
@@ -84,8 +96,36 @@ class GeminiLlmConnection {
    * @param blob The blob to send to the model.
    */
   async sendRealtime(blob) {
+    var _a, _b, _c;
     logger.debug("Sending LLM Blob:", blob);
-    this.geminiSession.sendRealtimeInput({ media: blob });
+    const isGemini3x = isGemini3xFlashLive(this.modelVersion);
+    const isNativeAudio = (_a = this.modelVersion) == null ? void 0 : _a.includes("native-audio");
+    if (isGemini3x || isNativeAudio) {
+      if ((_b = blob.mimeType) == null ? void 0 : _b.startsWith("audio/")) {
+        this.geminiSession.sendRealtimeInput({ audio: blob });
+      } else if ((_c = blob.mimeType) == null ? void 0 : _c.startsWith("image/")) {
+        this.geminiSession.sendRealtimeInput({ video: blob });
+      } else {
+        logger.warn(
+          "Blob not sent. Unknown or empty mime type for sendRealtimeInput:",
+          blob.mimeType
+        );
+      }
+    } else {
+      this.geminiSession.sendRealtimeInput({ media: blob });
+    }
+  }
+  /**
+   * Sends an activity start signal to the model.
+   */
+  async sendActivityStart() {
+    this.geminiSession.sendRealtimeInput({ activityStart: {} });
+  }
+  /**
+   * Sends an activity end signal to the model.
+   */
+  async sendActivityEnd() {
+    this.geminiSession.sendRealtimeInput({ activityEnd: {} });
   }
   /**
    * Builds a full text response.
@@ -94,21 +134,37 @@ class GeminiLlmConnection {
    * partial.
    *
    * @param text The text to be included in the response.
+   * @param isThought Whether the text is a thought.
+   * @param groundingMetadata The grounding metadata to include.
    * @returns An LlmResponse containing the full text.
    */
-  buildFullTextResponse(text) {
-    return {
-      content: {
-        role: "model",
-        parts: [{ text }]
-      }
-    };
-  }
-  // TODO(b/425992518): GenAI SDK inconsistent API, missing methods.
-  // eslint-disable-next-line require-yield
   receive() {
     return __asyncGenerator(this, null, function* () {
-      throw new Error("Not Implemented.");
+      if (!this.messageQueue) {
+        throw new Error("Message queue is not initialized.");
+      }
+      const aggregator = new LiveResponseAggregator(this.modelVersion);
+      try {
+        for (var iter = __forAwait(this.messageQueue), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+          const message = temp.value;
+          logger.debug("Got LLM Live message:", message);
+          for (const response of aggregator.processMessage(message)) {
+            yield response;
+          }
+        }
+      } catch (temp) {
+        error = [temp];
+      } finally {
+        try {
+          more && (temp = iter.return) && (yield new __await(temp.call(iter)));
+        } finally {
+          if (error)
+            throw error[0];
+        }
+      }
+      for (const response of aggregator.close()) {
+        yield response;
+      }
     });
   }
   /**

package/dist/web/models/google_llm.js

@@ -45,6 +45,7 @@ import {
 import { getBooleanEnvVar, isBrowser } from "../utils/env_aware_utils.js";
 import { logger } from "../utils/logger.js";
 import { GoogleLLMVariant } from "../utils/variant_utils.js";
+import { AsyncQueue } from "../utils/async_queue.js";
 import { StreamingResponseAggregator } from "../utils/streaming_utils.js";
 import { BaseLlm } from "./base_llm.js";
 import { GeminiLlmConnection } from "./gemini_llm_connection.js";
@@ -199,10 +200,19 @@ class Gemini extends BaseLlm {
   }
   get liveApiClient() {
     if (!this._liveApiClient) {
-      this._liveApiClient = new GoogleGenAI({
-        apiKey: this.apiKey,
-        httpOptions: this.getLiveHttpOptions()
-      });
+      if (this.vertexai) {
+        this._liveApiClient = new GoogleGenAI({
+          vertexai: this.vertexai,
+          project: this.project,
+          location: this.location || "global",
+          httpOptions: this.getLiveHttpOptions()
+        });
+      } else {
+        this._liveApiClient = new GoogleGenAI({
+          apiKey: this.apiKey,
+          httpOptions: this.getLiveHttpOptions()
+        });
+      }
     }
     return this._liveApiClient;
   }
@@ -234,16 +244,24 @@ class Gemini extends BaseLlm {
       };
     }
     llmRequest.liveConnectConfig.tools = (_c = llmRequest.config) == null ? void 0 : _c.tools;
+    const modelVersion = (_d = llmRequest.model) != null ? _d : this.model;
+    const messageQueue = new AsyncQueue();
     const liveSession = await this.liveApiClient.live.connect({
-      model: (_d = llmRequest.model) != null ? _d : this.model,
+      model: modelVersion,
       config: llmRequest.liveConnectConfig,
       callbacks: {
-        // TODO - b/425992518: GenAI SDK inconsistent API, missing methods.
-        onmessage: () => {
+        onmessage: (message) => {
+          messageQueue.push(message);
+        },
+        onerror: (error) => {
+          messageQueue.error(error);
+        },
+        onclose: () => {
+          messageQueue.close();
         }
       }
     });
-    return new GeminiLlmConnection(liveSession);
+    return new GeminiLlmConnection(liveSession, modelVersion, messageQueue);
   }
   preprocessRequest(llmRequest) {
     if (this.apiBackend === GoogleLLMVariant.GEMINI_API) {

package/dist/web/plugins/security_plugin.js

@@ -16,6 +16,11 @@ var PolicyOutcome = /* @__PURE__ */ ((PolicyOutcome2) => {
   return PolicyOutcome2;
 })(PolicyOutcome || {});
 class InMemoryPolicyEngine {
+  /**
+   * Always returns {@link PolicyOutcome.ALLOW} for every tool call.
+   *
+   * @returns A promise resolving to an ALLOW result.
+   */
   async evaluate() {
     return Promise.resolve({
       outcome: "ALLOW" /* ALLOW */,
@@ -24,11 +29,22 @@ class InMemoryPolicyEngine {
   }
 }
 class SecurityPlugin extends BasePlugin {
+  /**
+   * @param params - Optional configuration. Defaults to {@link InMemoryPolicyEngine}
+   *   when no policy engine is provided.
+   */
   constructor(params) {
     var _a;
     super("security_plugin");
     this.policyEngine = (_a = params == null ? void 0 : params.policyEngine) != null ? _a : new InMemoryPolicyEngine();
   }
+  /**
+   * Intercepts tool calls, evaluating them against the policy engine before
+   * execution and handling confirmation flows for calls that require it.
+   *
+   * @returns A partial or error response object if the call is blocked or
+   *   awaiting confirmation, or `undefined` to allow execution to proceed.
+   */
   async beforeToolCallback({
     tool,
     toolArgs,

package/dist/web/sessions/base_session_service.js

@@ -74,6 +74,15 @@ function trimTempDeltaState(event) {
   event.actions.stateDelta = filteredStateDelta;
   return event;
 }
+function trimTempState(state) {
+  const filteredState = {};
+  for (const [key, value] of Object.entries(state)) {
+    if (!key.startsWith(State.TEMP_PREFIX)) {
+      filteredState[key] = value;
+    }
+  }
+  return filteredState;
+}
 function mergeStates(appState = {}, userState = {}, sessionState = {}) {
   const merged = cloneDeep(sessionState);
   for (const [k, v] of Object.entries(appState)) {
@@ -87,5 +96,6 @@ function mergeStates(appState = {}, userState = {}, sessionState = {}) {
 export {
   BaseSessionService,
   mergeStates,
-  trimTempDeltaState
+  trimTempDeltaState,
+  trimTempState
 };

package/dist/web/sessions/database_session_service.js

@@ -126,7 +126,7 @@ class DatabaseSessionService extends BaseSessionService {
           appStateDelta[key.replace(State.APP_PREFIX, "")] = value;
         } else if (key.startsWith(State.USER_PREFIX)) {
           userStateDelta[key.replace(State.USER_PREFIX, "")] = value;
-        } else {
+        } else if (!key.startsWith(State.TEMP_PREFIX)) {
           sessionState[key] = value;
         }
       }
@@ -375,7 +375,7 @@ class DatabaseSessionService extends BaseSessionService {
             appDelta[key.replace(State.APP_PREFIX, "")] = value;
           } else if (key.startsWith(State.USER_PREFIX)) {
             userDelta[key.replace(State.USER_PREFIX, "")] = value;
-          } else {
+          } else if (!key.startsWith(State.TEMP_PREFIX)) {
             sessionDelta[key] = value;
           }
         }

package/dist/web/sessions/db/schema.js

@@ -22,6 +22,7 @@ import {
 } from "../../events/event.js";
 const SCHEMA_VERSION_KEY = "schema_version";
 const SCHEMA_VERSION_1_JSON = "1";
+const STORAGE_KEY_COLUMN_LENGTH = 191;
 class CamelCaseToSnakeCaseJsonType extends JsonType {
   convertToDatabaseValue(value) {
     return JSON.stringify(transformToSnakeCaseEvent(value));
@@ -50,7 +51,11 @@ let StorageAppState = class {
   }
 };
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "app_name" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "app_name",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageAppState.prototype, "appName", 2);
 __decorateClass([
   Property({ type: "json" })
@@ -73,10 +78,18 @@ let StorageUserState = class {
   }
 };
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "app_name" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "app_name",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageUserState.prototype, "appName", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "user_id" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "user_id",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageUserState.prototype, "userId", 2);
 __decorateClass([
   Property({ type: "json" })
@@ -100,13 +113,21 @@ let StorageSession = class {
   }
 };
 __decorateClass([
-  PrimaryKey({ type: "string" })
+  PrimaryKey({ type: "string", length: STORAGE_KEY_COLUMN_LENGTH })
 ], StorageSession.prototype, "id", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "app_name" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "app_name",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageSession.prototype, "appName", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "user_id" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "user_id",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageSession.prototype, "userId", 2);
 __decorateClass([
   Property({ type: "json" })
@@ -132,16 +153,28 @@ PrimaryKey.name;
 let StorageEvent = class {
 };
 __decorateClass([
-  PrimaryKey({ type: "string" })
+  PrimaryKey({ type: "string", length: STORAGE_KEY_COLUMN_LENGTH })
 ], StorageEvent.prototype, "id", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "app_name" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "app_name",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageEvent.prototype, "appName", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "user_id" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "user_id",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageEvent.prototype, "userId", 2);
 __decorateClass([
-  PrimaryKey({ type: "string", fieldName: "session_id" })
+  PrimaryKey({
+    type: "string",
+    fieldName: "session_id",
+    length: STORAGE_KEY_COLUMN_LENGTH
+  })
 ], StorageEvent.prototype, "sessionId", 2);
 __decorateClass([
   Property({ type: "string", fieldName: "invocation_id" })
@@ -166,6 +199,7 @@ export {
   ENTITIES,
   SCHEMA_VERSION_1_JSON,
   SCHEMA_VERSION_KEY,
+  STORAGE_KEY_COLUMN_LENGTH,
   StorageAppState,
   StorageEvent,
   StorageMetadata,

package/dist/web/sessions/in_memory_session_service.js

@@ -10,7 +10,8 @@ import { randomUUID } from "../utils/env_aware_utils.js";
 import { logger } from "../utils/logger.js";
 import {
   BaseSessionService,
-  mergeStates
+  mergeStates,
+  trimTempState
 } from "./base_session_service.js";
 import { createSession } from "./session.js";
 import { State } from "./state.js";
@@ -41,11 +42,12 @@ class InMemorySessionService extends BaseSessionService {
     sessionId
   }) {
     var _a;
+    const filteredState = state ? trimTempState(state) : void 0;
     const session = createSession({
       id: sessionId || randomUUID(),
       appName,
       userId,
-      state,
+      state: filteredState,
       events: [],
       lastUpdateTime: Date.now()
     });

package/dist/web/sessions/vertex_ai_session_service.js

@@ -40,7 +40,8 @@ import { logger } from "../utils/logger.js";
 import { getExpressModeApiKey } from "../utils/vertex_ai_utils.js";
 import { partialCopy } from "../utils/partial_copy.js";
 import {
-  BaseSessionService
+  BaseSessionService,
+  trimTempState
 } from "./base_session_service.js";
 import { createSession } from "./session.js";
 const DEFAULT_MAX_ATTEMPTS = 30;
@@ -101,10 +102,11 @@ let VertexAiSessionService = class extends BaseSessionService {
   }) {
     var _a;
     const reasoningEngineId = this.getReasoningEngineId(appName);
+    const filteredState = state ? trimTempState(state) : void 0;
     let apiResponse = await this.sessions.createInternal({
       name: "reasoningEngines/".concat(reasoningEngineId),
       userId,
-      config: __spreadValues(__spreadValues({}, state ? { sessionState: state } : {}), sessionId ? { sessionId } : {})
+      config: __spreadValues(__spreadValues({}, filteredState ? { sessionState: filteredState } : {}), sessionId ? { sessionId } : {})
     });
     const operationName = apiResponse.name;
     let attempts = 0;

package/dist/web/skills/gcp_skill_registry.js

@@ -0,0 +1,78 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Client } from "@google-cloud/vertexai";
+import { experimental } from "../utils/experimental.js";
+import { loadSkillFromZipBuffer } from "./loader.js";
+let GCPSkillRegistry = class {
+  constructor(options = {}) {
+    this.projectId = options.projectId || process.env.GOOGLE_CLOUD_PROJECT;
+    this.location = options.location || process.env.GOOGLE_CLOUD_LOCATION;
+    this.client = options.client || new Client({
+      project: this.projectId,
+      location: this.location
+    });
+  }
+  async getSkill(name) {
+    const apiClient = this.client.apiClient;
+    const httpResponse = await apiClient.request({
+      path: "skills/".concat(name),
+      httpMethod: "GET",
+      httpOptions: { apiVersion: "v1beta1" }
+    });
+    const response = await httpResponse.json();
+    const zippedFilesystem = response.zippedFilesystem || response.zipped_filesystem;
+    if (!zippedFilesystem) {
+      throw new Error("Skill '".concat(name, "' does not contain zipped filesystem."));
+    }
+    const zipBuffer = Buffer.from(zippedFilesystem, "base64");
+    return loadSkillFromZipBuffer(zipBuffer);
+  }
+  async searchSkills(query) {
+    const apiClient = this.client.apiClient;
+    const trimmedQuery = query.trim();
+    const isSearch = trimmedQuery.length > 0;
+    const path = isSearch ? "skills:retrieve?query=".concat(encodeURIComponent(trimmedQuery)) : "skills";
+    const httpResponse = await apiClient.request({
+      path,
+      httpMethod: "GET",
+      httpOptions: { apiVersion: "v1beta1" }
+    });
+    const response = await httpResponse.json();
+    const skillsList = isSearch ? response.retrievedSkills || response.retrieved_skills : response.skills;
+    const results = [];
+    if (skillsList && Array.isArray(skillsList)) {
+      for (const s of skillsList) {
+        const skillNameStr = s.skillName || s.skill_name || s.name || "";
+        const descriptionStr = s.description || "";
+        const parts = skillNameStr.split("/");
+        const name = skillNameStr ? parts[parts.length - 1] : "";
+        results.push({
+          name,
+          description: descriptionStr
+        });
+      }
+    }
+    return results;
+  }
+};
+GCPSkillRegistry = __decorateClass([
+  experimental
+], GCPSkillRegistry);
+export {
+  GCPSkillRegistry
+};

package/dist/web/skills/loader.js

@@ -24,6 +24,7 @@ var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import AdmZip from "adm-zip";
 import yaml from "js-yaml";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
@@ -254,9 +255,72 @@ async function loadAllSkillsInDir(skillsBasePath) {
   }
   return skills;
 }
+function loadSkillFromZipBuffer(zipBuffer) {
+  const zip = new AdmZip(zipBuffer);
+  const entries = zip.getEntries();
+  let skillMdContent = "";
+  for (const entry of entries) {
+    if (entry.isDirectory) continue;
+    if (entry.entryName.toLowerCase() === "skill.md") {
+      skillMdContent = entry.getData().toString("utf-8");
+      break;
+    }
+  }
+  if (!skillMdContent) {
+    throw new Error("SKILL.md not found in zipped filesystem.");
+  }
+  const { frontmatter: parsed, body } = parseSkillMdContent(skillMdContent);
+  const frontmatter = FrontmatterSchema.parse(parsed);
+  const references = {};
+  const assets = {};
+  const scripts = {};
+  function loadZipDir(prefix) {
+    const res = {};
+    const normPrefix = prefix.endsWith("/") ? prefix : "".concat(prefix, "/");
+    for (const entry of entries) {
+      if (entry.isDirectory) continue;
+      if (entry.entryName.startsWith(normPrefix)) {
+        if (entry.entryName.includes("__pycache__")) continue;
+        const relativePath = entry.entryName.substring(normPrefix.length);
+        if (!relativePath) continue;
+        const data = entry.getData();
+        try {
+          res[relativePath] = data.toString("utf-8");
+        } catch (_e) {
+          res[relativePath] = data;
+        }
+      }
+    }
+    return res;
+  }
+  const refFiles = loadZipDir("references");
+  for (const [key, val] of Object.entries(refFiles)) {
+    references[key] = val;
+  }
+  const assetFiles = loadZipDir("assets");
+  for (const [key, val] of Object.entries(assetFiles)) {
+    assets[key] = val;
+  }
+  const rawScripts = loadZipDir("scripts");
+  for (const [key, val] of Object.entries(rawScripts)) {
+    if (typeof val === "string") {
+      scripts[key] = { src: val };
+    }
+  }
+  return {
+    frontmatter,
+    instructions: body,
+    resources: {
+      references,
+      assets,
+      scripts
+    }
+  };
+}
 export {
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
   parseSkillMdContent,
   validateSkillDir
 };

package/dist/web/skills/skill_registry.js

@@ -0,0 +1,7 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */