@google/adk 1.2.0 → 1.3.0

package/dist/esm/context/summarizers/llm_summarizer.js

@@ -11,10 +11,21 @@ import {
 import { stringifyContent } from "../../events/event.js";
 const DEFAULT_PROMPT = "The following is a conversation history between a user and an AI agent. Please summarize the conversation, focusing on key information and decisions made, as well as any unresolved questions or tasks. The summary should be concise and capture the essence of the interaction.";
 class LlmSummarizer {
+  /**
+   * @param options - Configuration specifying the LLM and optional prompt.
+   */
   constructor(options) {
     this.llm = options.llm;
     this.prompt = options.prompt || DEFAULT_PROMPT;
   }
+  /**
+   * Summarizes a list of events into a single {@link CompactedEvent} using the
+   * configured LLM.
+   *
+   * @param events - The events to summarize. Must be non-empty.
+   * @returns A promise resolving to the compacted representation.
+   * @throws {Error} If `events` is empty or the LLM returns no content.
+   */
   async summarize(events) {
     var _a, _b, _c, _d, _e, _f;
     if (events.length === 0) {

package/dist/esm/context/token_based_context_compactor.js

@@ -75,7 +75,7 @@ class TokenBasedContextCompactor {
       compactedEvent.actions = {
         stateDelta: {},
         artifactDelta: {},
-        requestedAuthConfigs: [],
+        requestedAuthConfigs: {},
         requestedToolConfirmations: {}
       };
     }

package/dist/esm/events/event.js

@@ -20,7 +20,7 @@ function createEvent(params = {}) {
   };
 }
 function isFinalResponse(event) {
-  if (event.actions.skipSummarization || event.longRunningToolIds && event.longRunningToolIds.length > 0) {
+  if (event.actions.skipSummarization || event.longRunningToolIds && event.longRunningToolIds.length > 0 || event.actions.requestedAuthConfigs && Object.keys(event.actions.requestedAuthConfigs).length > 0) {
     return true;
   }
   return getFunctionCalls(event).length === 0 && getFunctionResponses(event).length === 0 && !event.partial && !hasTrailingCodeExecutionResult(event);

package/dist/esm/integrations/agent_registry/agent_registry_mcp_toolset.js

@@ -12,6 +12,19 @@ import {
 import { MCPTool } from "../../tools/mcp/mcp_tool.js";
 import { GCP_MCP_SERVER_DESTINATION_ID } from "./types.js";
 class AgentRegistrySingleMCPToolset extends BaseToolset {
+  /**
+   * @param options - Configuration for the MCP toolset.
+   * @param options.destinationResourceId - Telemetry identifier injected as
+   *   `gcp.mcp.server.destination.id` into each resolved tool's custom metadata.
+   * @param options.connectionParams - HTTP connection parameters for the MCP server.
+   * @param options.toolFilter - Optional predicate or list of tool names to include.
+   *   When omitted, all tools from the server are returned.
+   * @param options.prefix - Optional prefix prepended to each tool name (e.g. `myServer_toolName`).
+   * @param options.headerProvider - Optional async function called immediately before each
+   *   {@link getTools} invocation to supply or refresh request headers (e.g. GCP auth tokens).
+   * @param options.authScheme - Optional auth scheme forwarded to each resolved tool.
+   * @param options.authCredential - Optional credential forwarded to each resolved tool.
+   */
   constructor(options) {
     super(options.toolFilter || [], options.prefix);
     this.destinationResourceId = options.destinationResourceId;
@@ -21,8 +34,14 @@ class AgentRegistrySingleMCPToolset extends BaseToolset {
     this.authCredential = options.authCredential;
   }
   /**
-   * Connects to the underlying MCP server, retrieves tool definitions, prefixes tool names,
-   * and injects destination telemetry metadata.
+   * Connects to the underlying MCP server, retrieves tool definitions, prefixes
+   * tool names, and injects destination telemetry metadata into each tool.
+   *
+   * The `headerProvider`, if configured, is invoked immediately before the
+   * connection is established so that tokens are always fresh.
+   *
+   * @param context - Optional readonly agent context passed to the header provider.
+   * @returns The resolved and optionally filtered list of {@link MCPTool} instances.
    */
   async getTools(context) {
     var _a, _b, _c;

package/dist/esm/models/gemini_llm_connection.js

@@ -2,13 +2,17 @@ import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 /**
  * @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.
@@ -27,9 +31,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");
@@ -56,10 +61,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
+        });
+      }
     }
   }
   /**
@@ -68,8 +79,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.
@@ -78,20 +117,24 @@ 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
   async *receive() {
-    throw new Error("Not Implemented.");
+    if (!this.messageQueue) {
+      throw new Error("Message queue is not initialized.");
+    }
+    const aggregator = new LiveResponseAggregator(this.modelVersion);
+    for await (const message of this.messageQueue) {
+      logger.debug("Got LLM Live message:", message);
+      for (const response of aggregator.processMessage(message)) {
+        yield response;
+      }
+    }
+    for (const response of aggregator.close()) {
+      yield response;
+    }
   }
   /**
    * Closes the llm server connection.

package/dist/esm/models/google_llm.js

@@ -12,6 +12,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";
@@ -143,10 +144,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;
   }
@@ -178,16 +188,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/esm/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/esm/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/esm/sessions/database_session_service.js

@@ -108,7 +108,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;
         }
       }
@@ -357,7 +357,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/esm/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/esm/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/esm/sessions/vertex_ai_session_service.js

@@ -22,7 +22,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;
@@ -83,11 +84,12 @@ 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/${reasoningEngineId}`,
       userId,
       config: {
-        ...state ? { sessionState: state } : {},
+        ...filteredState ? { sessionState: filteredState } : {},
         ...sessionId ? { sessionId } : {}
       }
     });

package/dist/esm/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/${name}`,
+      httpMethod: "GET",
+      httpOptions: { apiVersion: "v1beta1" }
+    });
+    const response = await httpResponse.json();
+    const zippedFilesystem = response.zippedFilesystem || response.zipped_filesystem;
+    if (!zippedFilesystem) {
+      throw new Error(`Skill '${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=${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/esm/skills/loader.js

@@ -5,6 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * 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";
@@ -236,9 +237,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 : `${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/esm/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
+ */