@google/adk 2.2.1 → 2.4.0

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

@@ -38,7 +38,7 @@ function removeClientFunctionCallId(content) {
   }
 }
 __name(removeClientFunctionCallId, "removeClientFunctionCallId");
-function getContents(events, agentName, currentBranch, currentIsolationScope) {
+function getContents(events, agentName, currentBranch, currentIsolationScope, preserveFunctionCallIds = false) {
   const filteredEvents = [];
   for (const event of events) {
     if (!isEventVisibleInIsolationScope(event, currentIsolationScope)) {
@@ -51,16 +51,23 @@ function getContents(events, agentName, currentBranch, currentIsolationScope) {
     if (!shouldIncludeEventInContext(event, currentBranch, currentIsolationScope)) {
       continue;
     }
-    filteredEvents.push(
-      isEventFromAnotherAgent(agentName, event) ? convertForeignEvent(event) : event
-    );
+    if (isEventFromAnotherAgent(agentName, event)) {
+      const converted = convertForeignEvent(event);
+      if (converted) {
+        filteredEvents.push(converted);
+      }
+    } else {
+      filteredEvents.push(event);
+    }
   }
   let resultEvents = rearrangeEventsForLatestFunctionResponse(filteredEvents);
   resultEvents = rearrangeEventsForAsyncFunctionResponsesInHistory(resultEvents);
   const contents = [];
   for (const event of resultEvents) {
     const content = cloneDeep(event.content);
-    removeClientFunctionCallId(content);
+    if (!preserveFunctionCallIds) {
+      removeClientFunctionCallId(content);
+    }
     contents.push(content);
   }
   return contents;
@@ -93,18 +100,20 @@ function isRequestInputEvent(event) {
   return false;
 }
 __name(isRequestInputEvent, "isRequestInputEvent");
-function getCurrentTurnContents(events, agentName, currentBranch, currentIsolationScope) {
+function getCurrentTurnContents(events, agentName, currentBranch, currentIsolationScope, preserveFunctionCallIds = false) {
+  var _a;
   for (let i = events.length - 1; i >= 0; i--) {
     const event = events[i];
     if (!shouldIncludeEventInContext(event, currentBranch, currentIsolationScope)) {
       continue;
     }
-    if (event.author === "user" || isEventFromAnotherAgent(agentName, event)) {
+    if (event.author === "user" || isEventFromAnotherAgent(agentName, event) && ((_a = event.content.parts) == null ? void 0 : _a.some(isVisibleForeignPart))) {
       return getContents(
         events.slice(turnStart(events, i)),
         agentName,
         currentBranch,
-        currentIsolationScope
+        currentIsolationScope,
+        preserveFunctionCallIds
       );
     }
   }
@@ -169,6 +178,13 @@ function isEventFromAnotherAgent(agentName, event) {
   return !!agentName && event.author !== agentName && event.author !== "user";
 }
 __name(isEventFromAnotherAgent, "isEventFromAnotherAgent");
+function isVisibleForeignPart(part) {
+  if (part.functionCall || part.functionResponse) {
+    return true;
+  }
+  return !part.thought && part.text !== "";
+}
+__name(isVisibleForeignPart, "isVisibleForeignPart");
 function convertForeignEvent(event) {
   var _a, _b, _c, _d, _e, _f;
   if (!((_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.length)) {
@@ -183,7 +199,10 @@ function convertForeignEvent(event) {
     ]
   };
   for (const part of event.content.parts) {
-    if (part.text && !part.thought) {
+    if (!isVisibleForeignPart(part)) {
+      continue;
+    }
+    if (part.text) {
       (_c = content.parts) == null ? void 0 : _c.push({
         text: `[${event.author}] said: ${part.text}`
       });
@@ -200,9 +219,18 @@ function convertForeignEvent(event) {
         )}`
       });
     } else {
-      (_f = content.parts) == null ? void 0 : _f.push(cloneDeep(part));
+      const {
+        thought: _thought,
+        thoughtSignature: _thoughtSignature,
+        ...rest
+      } = part;
+      (_f = content.parts) == null ? void 0 : _f.push(cloneDeep(rest));
     }
   }
+  const preambleOnly = content.parts.length === 1;
+  if (preambleOnly) {
+    return void 0;
+  }
   return createEvent({
     invocationId: event.invocationId,
     author: "user",

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

@@ -8,11 +8,37 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * SPDX-License-Identifier: Apache-2.0
  */
 import { getActiveEvents } from "../../context/compaction_utils.js";
+import { isBaseLlm } from "../../models/base_llm.js";
 import { isLlmAgent } from "../llm_agent.js";
 import {
   getContents,
   getCurrentTurnContents
 } from "./content_processor_utils.js";
+const CLAUDE_MODEL_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.claudeModel");
+const CLAUDE_MODEL_NAME_PATTERN = /^claude-/i;
+function isClaudeModelInstance(model) {
+  return CLAUDE_MODEL_SYMBOL in model && model[CLAUDE_MODEL_SYMBOL] === true || CLAUDE_MODEL_NAME_PATTERN.test(model.model);
+}
+__name(isClaudeModelInstance, "isClaudeModelInstance");
+function shouldPreserveFunctionCallIds(agent, llmRequest) {
+  if (llmRequest.model && CLAUDE_MODEL_NAME_PATTERN.test(llmRequest.model)) {
+    return true;
+  }
+  let current = agent;
+  while (current) {
+    if (isLlmAgent(current)) {
+      if (isBaseLlm(current.model)) {
+        return isClaudeModelInstance(current.model);
+      }
+      if (typeof current.model === "string" && current.model.length > 0) {
+        return CLAUDE_MODEL_NAME_PATTERN.test(current.model);
+      }
+    }
+    current = current.parentAgent;
+  }
+  return false;
+}
+__name(shouldPreserveFunctionCallIds, "shouldPreserveFunctionCallIds");
 const _ContentRequestProcessor = class _ContentRequestProcessor {
   /**
    * Fills {@link LlmRequest.contents} based on the session event history and
@@ -31,19 +57,25 @@ const _ContentRequestProcessor = class _ContentRequestProcessor {
       invocationContext.session.events,
       invocationContext.isolationScope
     );
+    const preserveFunctionCallIds = shouldPreserveFunctionCallIds(
+      agent,
+      llmRequest
+    );
     if (agent.includeContents === "default") {
       llmRequest.contents = getContents(
         events,
         agent.name,
         invocationContext.branch,
-        invocationContext.isolationScope
+        invocationContext.isolationScope,
+        preserveFunctionCallIds
       );
     } else {
       llmRequest.contents = getCurrentTurnContents(
         events,
         agent.name,
         invocationContext.branch,
-        invocationContext.isolationScope
+        invocationContext.isolationScope,
+        preserveFunctionCallIds
       );
     }
     return;

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

@@ -51,7 +51,7 @@ const _InstructionsLlmRequestProcessor = class _InstructionsLlmRequestProcessor
       }
       appendInstructions(llmRequest, [instructionWithState]);
     }
-    if (agent.outputSchema && ((_a = agent.tools) == null ? void 0 : _a.length) && !canUseOutputSchemaWithTools(agent.canonicalModel.model)) {
+    if (agent.outputSchema && ((_a = agent.tools) == null ? void 0 : _a.length) && !canUseOutputSchemaWithTools(agent.canonicalModel)) {
       appendInstructions(llmRequest, [
         'To output the final result, you must call the "set_model_response" function with the appropriate values. Do not output anything else.'
       ]);

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

@@ -7,6 +7,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { createEvent } from "../../events/event.js";
 import { appendInstructions } from "../../models/llm_request.js";
 import { isBasePlanner } from "../../planners/base_planner.js";
 import { isBuiltInPlanner } from "../../planners/built_in_planner.js";
@@ -59,20 +60,28 @@ const _NlPlanningRequestProcessor = class _NlPlanningRequestProcessor extends Ba
 __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;
+    var _a, _b, _c;
     const planner = getPlanner(invocationContext);
     if (!planner || !((_b = (_a = llmResponse.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.length)) {
       return;
     }
+    const callbackContext = new Context({ invocationContext });
     const processedParts = planner.processPlanningResponse(
-      new Context({ invocationContext }),
+      callbackContext,
       llmResponse.content.parts
     );
     if (processedParts !== void 0) {
       llmResponse.content = { ...llmResponse.content, parts: processedParts };
     }
+    if (callbackContext.state.hasDelta()) {
+      yield createEvent({
+        invocationId: invocationContext.invocationId,
+        author: (_c = invocationContext.agent) == null ? void 0 : _c.name,
+        branch: invocationContext.branch,
+        actions: callbackContext.eventActions
+      });
+    }
   }
 };
 __name(_NlPlanningResponseProcessor, "NlPlanningResponseProcessor");

package/dist/esm/artifacts/in_memory_artifact_service.js

@@ -36,6 +36,13 @@ const _InMemoryArtifactService = class _InMemoryArtifactService {
     const version = this.artifacts[path].length;
     const metadata = {
       version,
+      canonicalUri: getCanonicalUri(
+        appName,
+        userId,
+        sessionId,
+        filename,
+        version
+      ),
       customMetadata
     };
     if (!artifact.inlineData && artifact.text === void 0) {
@@ -162,6 +169,13 @@ function artifactPrefix(scope, ...parts) {
   return `${[scope, ...parts].map(encodeURIComponent).join("/")}/`;
 }
 __name(artifactPrefix, "artifactPrefix");
+function getCanonicalUri(appName, userId, sessionId, filename, version) {
+  if (fileHasUserNamespace(filename)) {
+    return `memory://apps/${appName}/users/${userId}/artifacts/${filename}/versions/${version}`;
+  }
+  return `memory://apps/${appName}/users/${userId}/sessions/${sessionId}/artifacts/${filename}/versions/${version}`;
+}
+__name(getCanonicalUri, "getCanonicalUri");
 function fileHasUserNamespace(filename) {
   return filename.startsWith("user:");
 }

package/dist/esm/auth/auth_handler.js

@@ -7,6 +7,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { cloneDeep } from "lodash-es";
 import { randomUUID } from "../utils/env_aware_utils.js";
 import { OAuth2CredentialExchanger } from "./oauth2/oauth2_credential_exchanger.js";
 import {
@@ -15,6 +16,11 @@ import {
 } from "./oauth2/oauth2_utils.js";
 const S256_CODE_CHALLENGE_METHOD = "S256";
 const _AuthHandler = class _AuthHandler {
+  /**
+   * @param authConfig The auth config this handler reads. It stays readable
+   *     and replaceable after construction; each method reads the current
+   *     value.
+   */
   constructor(authConfig) {
     this.authConfig = authConfig;
   }
@@ -47,14 +53,32 @@ const _AuthHandler = class _AuthHandler {
       state.set(credentialKey, exchangedCredential.credential);
     }
   }
+  /**
+   * Builds the auth request to send to the client.
+   *
+   * The result is always a new object, and its `exchangedAuthCredential` is
+   * never an object held by {@link authConfig}. A caller that fills in the
+   * response, for example `exchangedAuthCredential.oauth2.authResponseUri`,
+   * therefore leaves the handler's credentials unchanged.
+   *
+   * When the config is returned as is, because the scheme is not OAuth2 or
+   * OpenID Connect or the exchanged credential already has an auth URI, the
+   * result is a deep copy of the whole config. In the other branches only the
+   * exchanged credential is guaranteed independent: `authScheme` and
+   * `rawAuthCredential` are the handler's own objects.
+   *
+   * @return The auth config to request from the client.
+   * @throws Error: If an OAuth2 or OpenID Connect scheme has no raw
+   *     credential, no `oauth2` on it, or no client ID and secret.
+   */
   generateAuthRequest() {
     var _a, _b;
     const authSchemeType = this.authConfig.authScheme.type;
     if (!["oauth2", "openIdConnect"].includes(authSchemeType)) {
-      return this.authConfig;
+      return cloneDeep(this.authConfig);
     }
     if ((_b = (_a = this.authConfig.exchangedAuthCredential) == null ? void 0 : _a.oauth2) == null ? void 0 : _b.authUri) {
-      return this.authConfig;
+      return cloneDeep(this.authConfig);
     }
     if (!this.authConfig.rawAuthCredential) {
       throw new Error(`Auth Scheme ${authSchemeType} requires authCredential.`);
@@ -69,7 +93,7 @@ const _AuthHandler = class _AuthHandler {
         credentialKey: this.authConfig.credentialKey,
         authScheme: this.authConfig.authScheme,
         rawAuthCredential: this.authConfig.rawAuthCredential,
-        exchangedAuthCredential: this.authConfig.rawAuthCredential
+        exchangedAuthCredential: cloneDeep(this.authConfig.rawAuthCredential)
       };
     }
     if (!this.authConfig.rawAuthCredential.oauth2.clientId || !this.authConfig.rawAuthCredential.oauth2.clientSecret) {
@@ -91,6 +115,10 @@ const _AuthHandler = class _AuthHandler {
    * challenge derived from the credential's code verifier, and the returned
    * credential carries the verifier the later token exchange must send.
    *
+   * The URI leaves out `redirect_uri` when the credential has no
+   * `redirectUri`, so the provider uses the redirect registered for the
+   * client, and leaves out `scope` when the scheme lists no scopes.
+   *
    * @return An AuthCredential object containing the auth URI and state.
    * @throws Error: If the authorization endpoint is not configured in the
    *     auth scheme, or the credential requests a code challenge method other
@@ -134,9 +162,13 @@ const _AuthHandler = class _AuthHandler {
     const state = randomUUID();
     const url = new URL(authorizationEndpoint);
     url.searchParams.set("client_id", oauth2.clientId || "");
-    url.searchParams.set("redirect_uri", oauth2.redirectUri || "");
+    if (oauth2.redirectUri) {
+      url.searchParams.set("redirect_uri", oauth2.redirectUri);
+    }
     url.searchParams.set("response_type", "code");
-    url.searchParams.set("scope", scopes.join(" "));
+    if (scopes.length > 0) {
+      url.searchParams.set("scope", scopes.join(" "));
+    }
     url.searchParams.set("state", state);
     url.searchParams.set("access_type", "offline");
     url.searchParams.set("prompt", "consent");

package/dist/esm/auth/auth_schemes.js

@@ -7,6 +7,13 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var AuthSchemeType = /* @__PURE__ */ ((AuthSchemeType2) => {
+  AuthSchemeType2["API_KEY"] = "apiKey";
+  AuthSchemeType2["HTTP"] = "http";
+  AuthSchemeType2["OAUTH2"] = "oauth2";
+  AuthSchemeType2["OPEN_ID_CONNECT"] = "openIdConnect";
+  return AuthSchemeType2;
+})(AuthSchemeType || {});
 var OAuthGrantType = /* @__PURE__ */ ((OAuthGrantType2) => {
   OAuthGrantType2["CLIENT_CREDENTIALS"] = "client_credentials";
   OAuthGrantType2["AUTHORIZATION_CODE"] = "authorization_code";
@@ -31,6 +38,7 @@ function getOAuthGrantTypeFromFlow(flow) {
 }
 __name(getOAuthGrantTypeFromFlow, "getOAuthGrantTypeFromFlow");
 export {
+  AuthSchemeType,
   OAuthGrantType,
   getOAuthGrantTypeFromFlow
 };