@google/adk 2.0.0 → 2.2.0

package/dist/esm/agents/processors/nl_planning_processor.js

@@ -0,0 +1,87 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { appendInstructions } from "../../models/llm_request.js";
+import { isBasePlanner } from "../../planners/base_planner.js";
+import { isBuiltInPlanner } from "../../planners/built_in_planner.js";
+import { Context } from "../context.js";
+import { isLlmAgent } from "../llm_agent.js";
+import { ReadonlyContext } from "../readonly_context.js";
+import {
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor
+} from "./base_llm_processor.js";
+function getPlanner(invocationContext) {
+  const agent = invocationContext.agent;
+  if (!isLlmAgent(agent) || !isBasePlanner(agent.planner)) {
+    return void 0;
+  }
+  return agent.planner;
+}
+__name(getPlanner, "getPlanner");
+function removeThought(part) {
+  const { thought: _thought, ...rest } = part;
+  return rest;
+}
+__name(removeThought, "removeThought");
+function removeThoughtFromContents(contents) {
+  return contents.map(
+    (content) => content.parts ? { ...content, parts: content.parts.map(removeThought) } : content
+  );
+}
+__name(removeThoughtFromContents, "removeThoughtFromContents");
+const _NlPlanningRequestProcessor = class _NlPlanningRequestProcessor extends BaseLlmRequestProcessor {
+  // eslint-disable-next-line require-yield -- this processor only mutates the request and has no event to emit
+  async *runAsync(invocationContext, llmRequest) {
+    const planner = getPlanner(invocationContext);
+    if (!planner) {
+      return;
+    }
+    if (isBuiltInPlanner(planner)) {
+      planner.applyThinkingConfig(llmRequest);
+    }
+    const planningInstruction = planner.buildPlanningInstruction(
+      new ReadonlyContext(invocationContext),
+      llmRequest
+    );
+    if (planningInstruction) {
+      appendInstructions(llmRequest, [planningInstruction]);
+    }
+    llmRequest.contents = removeThoughtFromContents(llmRequest.contents);
+  }
+};
+__name(_NlPlanningRequestProcessor, "NlPlanningRequestProcessor");
+let NlPlanningRequestProcessor = _NlPlanningRequestProcessor;
+const _NlPlanningResponseProcessor = class _NlPlanningResponseProcessor extends BaseLlmResponseProcessor {
+  // eslint-disable-next-line require-yield -- this processor only rewrites the response and has no event to emit
+  async *runAsync(invocationContext, llmResponse) {
+    var _a, _b;
+    const planner = getPlanner(invocationContext);
+    if (!planner || !((_b = (_a = llmResponse.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.length)) {
+      return;
+    }
+    const processedParts = planner.processPlanningResponse(
+      new Context({ invocationContext }),
+      llmResponse.content.parts
+    );
+    if (processedParts !== void 0) {
+      llmResponse.content = { ...llmResponse.content, parts: processedParts };
+    }
+  }
+};
+__name(_NlPlanningResponseProcessor, "NlPlanningResponseProcessor");
+let NlPlanningResponseProcessor = _NlPlanningResponseProcessor;
+const NL_PLANNING_REQUEST_PROCESSOR = new NlPlanningRequestProcessor();
+const NL_PLANNING_RESPONSE_PROCESSOR = new NlPlanningResponseProcessor();
+export {
+  NL_PLANNING_REQUEST_PROCESSOR,
+  NL_PLANNING_RESPONSE_PROCESSOR,
+  NlPlanningRequestProcessor,
+  NlPlanningResponseProcessor
+};

package/dist/esm/agents/processors/request_confirmation_llm_request_processor.js

@@ -55,7 +55,8 @@ const _RequestConfirmationLlmRequestProcessor = class _RequestConfirmationLlmReq
     }
     const approvals = collectApprovals(
       events,
-      (_a = runConfig == null ? void 0 : runConfig.plainTextToolConfirmation) != null ? _a : false
+      (_a = runConfig == null ? void 0 : runConfig.plainTextToolConfirmation) != null ? _a : false,
+      agent.name
     );
     if (approvals.size === 0) {
       return;
@@ -116,7 +117,7 @@ function eventsInScope(invocationContext) {
   );
 }
 __name(eventsInScope, "eventsInScope");
-function collectApprovals(events, allowPlainText) {
+function collectApprovals(events, allowPlainText, agentName) {
   const approvals = /* @__PURE__ */ new Map();
   const latestUserEvent = findLatestUserEvent(events);
   if (!latestUserEvent) {
@@ -135,7 +136,7 @@ function collectApprovals(events, allowPlainText) {
     );
   }
   if (approvals.size === 0 && allowPlainText) {
-    return mapPlainTextConfirmation(events);
+    return mapPlainTextConfirmation(events, agentName);
   }
   return approvals;
 }
@@ -167,6 +168,9 @@ function collectGateCandidates(events, approvals, agentName) {
             functionCallId: functionCall.id
           });
         }
+        logger.debug(
+          `Skipping tool confirmation from event ${event.id}: authored by ${event.author}, not by ${agentName}.`
+        );
         continue;
       }
       const pinned = pinnedCall(functionCall);
@@ -179,7 +183,7 @@ function collectGateCandidates(events, approvals, agentName) {
           functionCallId: functionCall.id
         });
       }
-      if (hasRespondedAfter(events, pinned.id, index)) {
+      if (hasRespondedAfter(events, pinned.id, index, agentName)) {
         continue;
       }
       candidates.push({ pinned, confirmation });
@@ -239,16 +243,16 @@ function agentAuthoredCalls(events, agentName) {
 }
 __name(agentAuthoredCalls, "agentAuthoredCalls");
 function dynamicallyRequestedCallIds(events, agentName) {
+  var _a;
   const requested = /* @__PURE__ */ new Set();
   for (const event of events) {
     if (event.author !== agentName) {
       continue;
     }
-    const confirmations = event.actions.requestedToolConfirmations;
-    for (const functionResponse of getFunctionResponses(event)) {
-      if (functionResponse.id && functionResponse.id in confirmations) {
-        requested.add(functionResponse.id);
-      }
+    for (const functionCallId of Object.keys(
+      (_a = event.actions.requestedToolConfirmations) != null ? _a : {}
+    )) {
+      requested.add(functionCallId);
     }
   }
   return requested;
@@ -266,9 +270,9 @@ function pinnedCall(functionCall) {
   return pinned;
 }
 __name(pinnedCall, "pinnedCall");
-function hasRespondedAfter(events, pinnedCallId, gateIndex) {
+function hasRespondedAfter(events, pinnedCallId, gateIndex, agentName) {
   return events.slice(gateIndex + 1).some(
-    (event) => getFunctionResponses(event).some(
+    (event) => event.author === agentName && getFunctionResponses(event).some(
       (functionResponse) => functionResponse.id === pinnedCallId
     )
   );
@@ -305,7 +309,7 @@ const NEGATIVE = /* @__PURE__ */ new Set([
   "cancel",
   "cancelled"
 ]);
-function mapPlainTextConfirmation(events) {
+function mapPlainTextConfirmation(events, agentName) {
   var _a, _b;
   const none = /* @__PURE__ */ new Map();
   let turnIndex = -1;
@@ -343,6 +347,9 @@ function mapPlainTextConfirmation(events) {
     if (event.author === "user") {
       break;
     }
+    if (event.author !== agentName) {
+      continue;
+    }
     for (const fc of getFunctionCalls(event)) {
       if (fc.name === REQUEST_CONFIRMATION_FUNCTION_CALL_NAME && fc.id && !answered.has(fc.id)) {
         pendingId = fc.id;

package/dist/esm/agents/processors/request_input_llm_request_processor.js

@@ -11,7 +11,6 @@ import {
   getFunctionCalls,
   getFunctionResponses
 } from "../../events/event.js";
-import { ToolConfirmation } from "../../tools/tool_confirmation.js";
 import { AsyncQueue } from "../../utils/async_queue.js";
 import { isNodeTool } from "../../workflow/nodes/node_tool.js";
 import {
@@ -70,12 +69,9 @@ const _RequestInputLlmRequestProcessor = class _RequestInputLlmRequestProcessor
     if (Object.keys(pending).length === 0) {
       return;
     }
-    const toolConfirmationDict = {};
+    const resumeInputsDict = {};
     for (const id of Object.keys(pending)) {
-      toolConfirmationDict[id] = new ToolConfirmation({
-        confirmed: true,
-        payload: resumeInputs
-      });
+      resumeInputsDict[id] = resumeInputs;
     }
     const eventQueue = new AsyncQueue();
     invocationContext.eventQueue = eventQueue;
@@ -88,7 +84,7 @@ const _RequestInputLlmRequestProcessor = class _RequestInputLlmRequestProcessor
           beforeToolCallbacks: agent.canonicalBeforeToolCallbacks,
           afterToolCallbacks: agent.canonicalAfterToolCallbacks,
           filters: new Set(Object.keys(pending)),
-          toolConfirmationDict
+          resumeInputsDict
         });
       } finally {
         eventQueue.close();

package/dist/esm/agents/readonly_context.js

@@ -52,6 +52,12 @@ const _ReadonlyContext = class _ReadonlyContext {
       {}
     );
   }
+  /**
+   * Request-level metadata passed from an incoming A2A request or caller.
+   */
+  get a2aMetadata() {
+    return this.invocationContext.a2aMetadata;
+  }
 };
 __name(_ReadonlyContext, "ReadonlyContext");
 let ReadonlyContext = _ReadonlyContext;

package/dist/esm/agents/routed_agent.js

@@ -10,7 +10,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 var _a, _b;
 import { BaseAgent } from "./base_agent.js";
 import { runWithRouting } from "../utils/failover_utils.js";
-const ROUTED_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.routedAgent");
+const ROUTED_AGENT_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.routedAgent");
 function isRoutedAgent(obj) {
   return typeof obj === "object" && obj !== null && ROUTED_AGENT_SIGNATURE_SYMBOL in obj && obj[ROUTED_AGENT_SIGNATURE_SYMBOL] === true;
 }

package/dist/esm/agents/sequential_agent.js

@@ -23,7 +23,7 @@ import { BaseAgent } from "./base_agent.js";
 import { isLlmAgent } from "./llm_agent.js";
 import { ReadonlyContext } from "./readonly_context.js";
 const TASK_COMPLETED_TOOL_NAME = "task_completed";
-const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = Symbol.for(
+const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
   "google.adk.sequentialAgent"
 );
 function isSequentialAgent(obj) {

package/dist/esm/apps/app.js

@@ -23,7 +23,7 @@ function validateAppName(name) {
   }
 }
 __name(validateAppName, "validateAppName");
-const APP_SIGNATURE_SYMBOL = Symbol.for("google.adk.app");
+const APP_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.app");
 function isApp(obj) {
   return typeof obj === "object" && obj !== null && APP_SIGNATURE_SYMBOL in obj && obj[APP_SIGNATURE_SYMBOL] === true;
 }

package/dist/esm/artifacts/file_artifact_service.js

@@ -474,10 +474,9 @@ async function* iterateArtifactDirs(dir) {
     );
     if (hasVersions) {
       yield dir;
-      return;
     }
     for (const entry of entries) {
-      if (entry.isDirectory()) {
+      if (entry.isDirectory() && entry.name !== "versions") {
         const subdir = path.join(dir, entry.name);
         for await (const foundDir of iterateArtifactDirs(subdir)) {
           yield foundDir;

package/dist/esm/artifacts/gcs_artifact_service.js

@@ -67,9 +67,7 @@ const _GcsArtifactService = class _GcsArtifactService {
         version
       })
     );
-    const customMetadata = {
-      ...request.customMetadata
-    };
+    const customMetadata = stringifyMetadataValues(request.customMetadata);
     if (request.artifact.inlineData) {
       if (request.artifact.inlineData.displayName) {
         customMetadata[GCS_DISPLAY_NAME_METADATA_KEY] = request.artifact.inlineData.displayName;
@@ -193,10 +191,9 @@ const _GcsArtifactService = class _GcsArtifactService {
     const [files] = await bucket.getFiles({ prefix: searchPrefix });
     const versions = [];
     for (const file of files) {
-      const version = file.name.split("/").pop();
-      const v = parseInt(version, 10);
-      if (!isNaN(v)) {
-        versions.push(v);
+      const suffix = file.name.slice(searchPrefix.length);
+      if (/^\d+$/.test(suffix)) {
+        versions.push(Number(suffix));
       }
     }
     return versions.sort((a, b) => a - b);
@@ -262,6 +259,15 @@ function getFileName({
   return version !== void 0 ? `${prefix}/${version}` : prefix;
 }
 __name(getFileName, "getFileName");
+function stringifyMetadataValues(customMetadata) {
+  return Object.fromEntries(
+    Object.entries(customMetadata != null ? customMetadata : {}).map(([key, value]) => [
+      key,
+      String(value)
+    ])
+  );
+}
+__name(stringifyMetadataValues, "stringifyMetadataValues");
 function extractArtifactKeys(files, fileNamePrefix, keyPrefix = "") {
   const keys = /* @__PURE__ */ new Set();
   for (const file of files) {

package/dist/esm/artifacts/scoped_artifact_service.js

@@ -7,12 +7,21 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const SESSION_ARTIFACT_SERVICE_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "google.adk.sessionArtifactService"
+);
+_a = SESSION_ARTIFACT_SERVICE_SIGNATURE_SYMBOL;
 const _ScopedArtifactService = class _ScopedArtifactService {
   constructor(delegate, appName, userId, sessionId) {
     this.delegate = delegate;
     this.appName = appName;
     this.userId = userId;
     this.sessionId = sessionId;
+    /**
+     * Brands this class as a session-scoped artifact service.
+     */
+    this[_a] = true;
   }
   async saveArtifact(request) {
     return this.delegate.saveArtifact({

package/dist/esm/artifacts/session_artifact_service.js

@@ -1,7 +1,19 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+const SESSION_ARTIFACT_SERVICE_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "google.adk.sessionArtifactService"
+);
+function isSessionArtifactService(service) {
+  return typeof service === "object" && service !== null && SESSION_ARTIFACT_SERVICE_SIGNATURE_SYMBOL in service && service[SESSION_ARTIFACT_SERVICE_SIGNATURE_SYMBOL] === true;
+}
+__name(isSessionArtifactService, "isSessionArtifactService");
+export {
+  isSessionArtifactService
+};

package/dist/esm/auth/auth_credential.js

@@ -1,5 +1,7 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -13,6 +15,14 @@ var AuthCredentialTypes = /* @__PURE__ */ ((AuthCredentialTypes2) => {
   AuthCredentialTypes2["SERVICE_ACCOUNT"] = "serviceAccount";
   return AuthCredentialTypes2;
 })(AuthCredentialTypes || {});
+const AUTH_CREDENTIAL_TYPES = new Set(
+  Object.values(AuthCredentialTypes)
+);
+function isAuthCredential(value) {
+  return typeof value === "object" && value !== null && "authType" in value && AUTH_CREDENTIAL_TYPES.has(value.authType);
+}
+__name(isAuthCredential, "isAuthCredential");
 export {
-  AuthCredentialTypes
+  AuthCredentialTypes,
+  isAuthCredential
 };

package/dist/esm/auth/auth_handler.js

@@ -9,6 +9,11 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  */
 import { randomUUID } from "../utils/env_aware_utils.js";
 import { OAuth2CredentialExchanger } from "./oauth2/oauth2_credential_exchanger.js";
+import {
+  createS256CodeChallenge,
+  generateCodeVerifier
+} from "./oauth2/oauth2_utils.js";
+const S256_CODE_CHALLENGE_METHOD = "S256";
 const _AuthHandler = class _AuthHandler {
   constructor(authConfig) {
     this.authConfig = authConfig;
@@ -17,7 +22,16 @@ const _AuthHandler = class _AuthHandler {
     const credentialKey = "temp:" + this.authConfig.credentialKey;
     return state.get(credentialKey);
   }
+  /**
+   * Stores the exchanged credential in the session state.
+   *
+   * @param state The session state to store the credential in.
+   * @throws Error: If the auth config has no credentialKey.
+   */
   async parseAndStoreAuthResponse(state) {
+    if (!this.authConfig.credentialKey) {
+      throw new Error("credentialKey is empty.");
+    }
     const credentialKey = "temp:" + this.authConfig.credentialKey;
     const authSchemeType = this.authConfig.authScheme.type;
     if (!["oauth2", "openIdConnect"].includes(authSchemeType)) {
@@ -73,9 +87,14 @@ const _AuthHandler = class _AuthHandler {
   /**
    * Generates an response containing the auth uri for user to sign in.
    *
+   * When the credential requests PKCE, the URI also carries the S256 code
+   * challenge derived from the credential's code verifier, and the returned
+   * credential carries the verifier the later token exchange must send.
+   *
    * @return An AuthCredential object containing the auth URI and state.
    * @throws Error: If the authorization endpoint is not configured in the
-   *     auth scheme.
+   *     auth scheme, or the credential requests a code challenge method other
+   *     than 'S256'.
    */
   generateAuthUri() {
     const authScheme = this.authConfig.authScheme;
@@ -83,6 +102,13 @@ const _AuthHandler = class _AuthHandler {
     if (!authCredential || !authCredential.oauth2) {
       return authCredential;
     }
+    const oauth2 = authCredential.oauth2;
+    const codeChallengeMethod = oauth2.codeChallengeMethod;
+    if (codeChallengeMethod && codeChallengeMethod !== S256_CODE_CHALLENGE_METHOD) {
+      throw new Error(
+        `Unsupported codeChallengeMethod: ${codeChallengeMethod}. Only '${S256_CODE_CHALLENGE_METHOD}' is supported.`
+      );
+    }
     let authorizationEndpoint = "";
     let scopes = [];
     if ("authorizationEndpoint" in authScheme) {
@@ -107,22 +133,35 @@ const _AuthHandler = class _AuthHandler {
     }
     const state = randomUUID();
     const url = new URL(authorizationEndpoint);
-    url.searchParams.set("client_id", authCredential.oauth2.clientId || "");
-    url.searchParams.set(
-      "redirect_uri",
-      authCredential.oauth2.redirectUri || ""
-    );
+    url.searchParams.set("client_id", oauth2.clientId || "");
+    url.searchParams.set("redirect_uri", oauth2.redirectUri || "");
     url.searchParams.set("response_type", "code");
     url.searchParams.set("scope", scopes.join(" "));
     url.searchParams.set("state", state);
     url.searchParams.set("access_type", "offline");
     url.searchParams.set("prompt", "consent");
+    if (oauth2.audience) {
+      url.searchParams.set("audience", oauth2.audience);
+    }
+    if (oauth2.nonce) {
+      url.searchParams.set("nonce", oauth2.nonce);
+    }
+    let codeVerifier = oauth2.codeVerifier;
+    if (codeChallengeMethod) {
+      codeVerifier != null ? codeVerifier : codeVerifier = generateCodeVerifier();
+      url.searchParams.set(
+        "code_challenge",
+        createS256CodeChallenge(codeVerifier)
+      );
+      url.searchParams.set("code_challenge_method", codeChallengeMethod);
+    }
     const exchangedAuthCredential = {
       ...authCredential,
       oauth2: {
-        ...authCredential.oauth2,
+        ...oauth2,
         authUri: url.toString(),
-        state
+        state,
+        codeVerifier
       }
     };
     return exchangedAuthCredential;

package/dist/esm/auth/oauth2/oauth2_credential_refresher.js

@@ -19,7 +19,7 @@ const _OAuth2CredentialRefresher = class _OAuth2CredentialRefresher {
    *
    * @param authCredential The OAuth2 credential to check.
    * @param authScheme The OAuth2 authentication scheme (optional).
-   * @returns True if the credential needs to be refreshed, False otherwise.
+   * @returns True if the credential needs to be refreshed, false otherwise.
    */
   async isRefreshNeeded(authCredential) {
     if (!authCredential.oauth2) {

package/dist/esm/auth/oauth2/oauth2_utils.js

@@ -7,8 +7,19 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { createHash, randomBytes } from "node:crypto";
 import { logger } from "../../utils/logger.js";
+import { redactUriPassword } from "../../utils/redact_uri.js";
 import { validateDiscoveryUrl } from "./oauth2_discovery.js";
+const CODE_VERIFIER_BYTES = 36;
+function generateCodeVerifier() {
+  return randomBytes(CODE_VERIFIER_BYTES).toString("base64url");
+}
+__name(generateCodeVerifier, "generateCodeVerifier");
+function createS256CodeChallenge(codeVerifier) {
+  return createHash("sha256").update(codeVerifier).digest("base64url");
+}
+__name(createS256CodeChallenge, "createS256CodeChallenge");
 function getTokenEndpoint(authScheme) {
   if (authScheme.type === "openIdConnect" && authScheme.tokenEndpoint) {
     return authScheme.tokenEndpoint;
@@ -63,8 +74,8 @@ function parseAuthorizationCode(uri) {
   try {
     const url = new URL(uri);
     return url.searchParams.get("code") || void 0;
-  } catch (e) {
-    logger.warn(`Failed to parse authorization URI ${uri}: ${e}`);
+  } catch {
+    logger.warn(`Failed to parse authorization URI ${redactUriPassword(uri)}`);
     return void 0;
   }
 }
@@ -98,7 +109,9 @@ function isTokenExpired(token, leeway = 60) {
 __name(isTokenExpired, "isTokenExpired");
 export {
   createOAuth2TokenRequestBody,
+  createS256CodeChallenge,
   fetchOAuth2Tokens,
+  generateCodeVerifier,
   getTokenEndpoint,
   isTokenExpired,
   parseAuthorizationCode

package/dist/esm/code_executors/base_code_executor.js

@@ -8,7 +8,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * SPDX-License-Identifier: Apache-2.0
  */
 var _a;
-const BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for(
+const BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
   "google.adk.baseCodeExecutor"
 );
 function isBaseCodeExecutor(obj) {

package/dist/esm/code_executors/built_in_code_executor.js

@@ -10,7 +10,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 var _a, _b;
 import { isGemini2OrAbove } from "../utils/model_name.js";
 import { BaseCodeExecutor } from "./base_code_executor.js";
-const BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for(
+const BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
   "google.adk.builtInCodeExecutor"
 );
 function isBuiltInCodeExecutor(obj) {

package/dist/esm/code_executors/code_execution_utils.js

@@ -38,7 +38,7 @@ function extractCodeAndTruncateContent(content, codeBlockDelimiters) {
     const part = content.parts[i];
     if (part.executableCode && (i === content.parts.length - 1 || !content.parts[i + 1].codeExecutionResult)) {
       content.parts = content.parts.slice(0, i + 1);
-      return part.executableCode.code;
+      return part.executableCode.code || "";
     }
   }
   const textParts = content.parts.filter((part) => part.text);
@@ -113,12 +113,12 @@ function convertCodeExecutionParts(content, codeBlockDelimiter, executionResultD
   const lastPart = content.parts[content.parts.length - 1];
   if (lastPart.executableCode) {
     content.parts[content.parts.length - 1] = {
-      text: codeBlockDelimiter[0] + lastPart.executableCode.code + codeBlockDelimiter[1]
+      text: codeBlockDelimiter[0] + (lastPart.executableCode.code || "") + codeBlockDelimiter[1]
     };
   } else if (content.parts.length == 1 && lastPart.codeExecutionResult) {
-    content.parts[content.parts.length - 1] = {
-      text: executionResultDelimiters[0] + lastPart.codeExecutionResult.output + executionResultDelimiters[1]
-    };
+    const output = lastPart.codeExecutionResult.output;
+    const text = output == null ? "" : executionResultDelimiters[0] + output + executionResultDelimiters[1];
+    content.parts[content.parts.length - 1] = { text };
     content.role = "user";
   }
 }