@google/adk 2.0.0 → 2.2.0

package/dist/cjs/models/chrome_prompt_utils.js

@@ -0,0 +1,281 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var chrome_prompt_utils_exports = {};
+__export(chrome_prompt_utils_exports, {
+  TRUNCATED_REPLY: () => TRUNCATED_REPLY,
+  buildToolChoiceSchema: () => buildToolChoiceSchema,
+  collectFunctionDeclarations: () => collectFunctionDeclarations,
+  contentsToMessages: () => contentsToMessages,
+  errorResponse: () => errorResponse,
+  extractSystemInstruction: () => extractSystemInstruction,
+  finalText: () => finalText,
+  isAbortError: () => isAbortError,
+  isRecord: () => isRecord,
+  looksLikeEnvelope: () => looksLikeEnvelope,
+  renderToolInstructions: () => renderToolInstructions,
+  renderToolResult: () => renderToolResult,
+  salvageFinalText: () => salvageFinalText,
+  stripAdkIdentityPreamble: () => stripAdkIdentityPreamble
+});
+module.exports = __toCommonJS(chrome_prompt_utils_exports);
+var import_genai_schema_to_json = require("../utils/genai_schema_to_json.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function argumentSchema(declaration) {
+  if (isRecord(declaration.parametersJsonSchema)) {
+    return declaration.parametersJsonSchema;
+  }
+  if (declaration.parameters) {
+    return (0, import_genai_schema_to_json.genaiSchemaToJsonSchema)(declaration.parameters);
+  }
+  return { type: "object", properties: {} };
+}
+__name(argumentSchema, "argumentSchema");
+function collectFunctionDeclarations(llmRequest) {
+  var _a, _b;
+  const declarations = [];
+  for (const tool of (_b = (_a = llmRequest.config) == null ? void 0 : _a.tools) != null ? _b : []) {
+    if (isRecord(tool) && Array.isArray(tool["functionDeclarations"])) {
+      declarations.push(
+        ...tool["functionDeclarations"]
+      );
+    }
+  }
+  return declarations;
+}
+__name(collectFunctionDeclarations, "collectFunctionDeclarations");
+function buildToolChoiceSchema(declarations) {
+  const branches = [
+    {
+      type: "object",
+      properties: {
+        kind: { type: "string", enum: ["final"] },
+        text: { type: "string" }
+      },
+      required: ["kind", "text"],
+      additionalProperties: false
+    }
+  ];
+  for (const declaration of declarations) {
+    if (!declaration.name) continue;
+    branches.push({
+      type: "object",
+      properties: {
+        kind: { type: "string", enum: ["tool"] },
+        name: { type: "string", enum: [declaration.name] },
+        args: argumentSchema(declaration)
+      },
+      required: ["kind", "name", "args"],
+      additionalProperties: false
+    });
+  }
+  return branches.length === 1 ? branches[0] : { anyOf: branches };
+}
+__name(buildToolChoiceSchema, "buildToolChoiceSchema");
+function renderToolInstructions(declarations) {
+  if (!declarations.length) return "";
+  const lines = declarations.map(
+    (declaration) => {
+      var _a;
+      return `- ${declaration.name}: ${(_a = declaration.description) != null ? _a : ""}
+  arguments: ${JSON.stringify(argumentSchema(declaration))}`;
+    }
+  );
+  return [
+    "You can call these tools:",
+    ...lines,
+    "",
+    'Reply with JSON only. To call a tool use {"kind":"tool","name":<tool>,"args":{...}}.',
+    'When you have the answer use {"kind":"final","text":<answer>}.'
+  ].join("\n");
+}
+__name(renderToolInstructions, "renderToolInstructions");
+function renderToolResult(response) {
+  if (response == null) return "{}";
+  let value = response;
+  if (isRecord(value) && Object.keys(value).length === 1 && "result" in value) {
+    value = value["result"];
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+      try {
+        return JSON.stringify(JSON.parse(trimmed));
+      } catch {
+        return trimmed;
+      }
+    }
+    return trimmed;
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+__name(renderToolResult, "renderToolResult");
+function contentsToMessages(contents) {
+  var _a, _b;
+  const messages = [];
+  for (const content of contents != null ? contents : []) {
+    const role = content.role === "model" ? "assistant" : "user";
+    const chunks = [];
+    for (const part of (_a = content.parts) != null ? _a : []) {
+      if (part.text) chunks.push(part.text);
+      if (part.functionCall) {
+        const args = JSON.stringify((_b = part.functionCall.args) != null ? _b : {});
+        chunks.push(`[tool_call] ${part.functionCall.name}(${args})`);
+      }
+      if (part.functionResponse) {
+        const rendered = renderToolResult(part.functionResponse.response);
+        chunks.push(
+          `[tool_result] ${part.functionResponse.name} -> ${rendered}`
+        );
+      }
+    }
+    if (chunks.length) {
+      messages.push({ role, content: chunks.join("\n") });
+    }
+  }
+  return messages;
+}
+__name(contentsToMessages, "contentsToMessages");
+function extractSystemInstruction(llmRequest) {
+  var _a;
+  const instruction = (_a = llmRequest.config) == null ? void 0 : _a.systemInstruction;
+  if (!instruction) return "";
+  if (typeof instruction === "string") return instruction;
+  if (Array.isArray(instruction)) {
+    return instruction.map(
+      (entry) => {
+        var _a2;
+        return typeof entry === "string" ? entry : (_a2 = entry == null ? void 0 : entry.text) != null ? _a2 : "";
+      }
+    ).filter(Boolean).join("\n");
+  }
+  if (isRecord(instruction) && Array.isArray(instruction["parts"])) {
+    return instruction["parts"].map((part) => {
+      var _a2;
+      return (_a2 = part.text) != null ? _a2 : "";
+    }).filter(Boolean).join("\n");
+  }
+  return String(instruction);
+}
+__name(extractSystemInstruction, "extractSystemInstruction");
+function stripAdkIdentityPreamble(systemPrompt) {
+  return systemPrompt.replace(/^You are an agent\. Your internal name is "[^"]*"\.\s*/m, "").replace(/^The description about you is "[^"]*"\s*/m, "").trimStart();
+}
+__name(stripAdkIdentityPreamble, "stripAdkIdentityPreamble");
+function isAbortError(error) {
+  return isRecord(error) && error["name"] === "AbortError";
+}
+__name(isAbortError, "isAbortError");
+function finalText(text) {
+  return { content: { role: "model", parts: [{ text }] }, turnComplete: true };
+}
+__name(finalText, "finalText");
+function errorResponse(error) {
+  const details = isRecord(error) ? error : {};
+  const name = typeof details["name"] === "string" ? details["name"] : "UnknownError";
+  const message = typeof details["message"] === "string" ? details["message"] : String(error);
+  if (name === "QuotaExceededError") {
+    return {
+      errorCode: name,
+      errorMessage: `Prompt exceeded the context window (requested ${details["requested"]} of ${details["quota"]} tokens).`,
+      turnComplete: true
+    };
+  }
+  return { errorCode: name, errorMessage: message, turnComplete: true };
+}
+__name(errorResponse, "errorResponse");
+const TRUNCATED_REPLY = "The model started an answer and did not finish it. Ask again.";
+function looksLikeEnvelope(raw) {
+  return /^\s*[[{]/.test(raw) || /"kind"\s*:/.test(raw);
+}
+__name(looksLikeEnvelope, "looksLikeEnvelope");
+function salvageFinalText(raw) {
+  var _a;
+  const key = raw.match(/"text"\s*:\s*"/);
+  if ((key == null ? void 0 : key.index) === void 0) return void 0;
+  const escapes = {
+    n: "\n",
+    t: "	",
+    r: "\r",
+    b: "\b",
+    f: "\f",
+    '"': '"',
+    "\\": "\\",
+    "/": "/"
+  };
+  let out = "";
+  for (let i = key.index + key[0].length; i < raw.length; i++) {
+    const char = raw[i];
+    if (char === '"') break;
+    if (char !== "\\") {
+      out += char;
+      continue;
+    }
+    const next = raw[i + 1];
+    if (next === void 0) break;
+    if (next === "u") {
+      const hex = raw.slice(i + 2, i + 6);
+      if (/^[0-9a-fA-F]{4}$/.test(hex)) {
+        out += String.fromCharCode(parseInt(hex, 16));
+        i += 5;
+        continue;
+      }
+    }
+    out += (_a = escapes[next]) != null ? _a : next;
+    i++;
+  }
+  const text = out.trim();
+  return text.length ? text : void 0;
+}
+__name(salvageFinalText, "salvageFinalText");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TRUNCATED_REPLY,
+  buildToolChoiceSchema,
+  collectFunctionDeclarations,
+  contentsToMessages,
+  errorResponse,
+  extractSystemInstruction,
+  finalText,
+  isAbortError,
+  isRecord,
+  looksLikeEnvelope,
+  renderToolInstructions,
+  renderToolResult,
+  salvageFinalText,
+  stripAdkIdentityPreamble
+});

package/dist/cjs/models/gemini_llm_connection.js

@@ -59,7 +59,7 @@ const _GeminiLlmConnection = class _GeminiLlmConnection {
       }
     );
     if (contents.length > 0) {
-      const isGemini3x = (0, import_model_name.isGemini3xFlashLive)(this.modelVersion);
+      const isGemini3x = (0, import_model_name.isGemini3xLive)(this.modelVersion);
       this.geminiSession.sendClientContent({
         turns: contents,
         turnComplete: isGemini3x ? true : contents[contents.length - 1].role === "user"
@@ -89,7 +89,7 @@ const _GeminiLlmConnection = class _GeminiLlmConnection {
       });
     } else {
       import_logger.logger.debug("Sending LLM new content", content);
-      const isGemini3x = (0, import_model_name.isGemini3xFlashLive)(this.modelVersion);
+      const isGemini3x = (0, import_model_name.isGemini3xLive)(this.modelVersion);
       if (isGemini3x && content.parts.length === 1 && content.parts[0].text) {
         import_logger.logger.debug("Using sendRealtimeInput for Gemini 3.x text input");
         this.geminiSession.sendRealtimeInput({ text: content.parts[0].text });
@@ -109,9 +109,10 @@ const _GeminiLlmConnection = class _GeminiLlmConnection {
   async sendRealtime(blob) {
     var _a, _b, _c;
     import_logger.logger.debug("Sending LLM Blob:", blob);
-    const isGemini3x = (0, import_model_name.isGemini3xFlashLive)(this.modelVersion);
+    const isGemini3x = (0, import_model_name.isGemini3xLive)(this.modelVersion);
     const isNativeAudio = (_a = this.modelVersion) == null ? void 0 : _a.includes("native-audio");
-    if (isGemini3x || isNativeAudio) {
+    const isLiveTranslate = (0, import_model_name.isGemini35LiveTranslate)(this.modelVersion);
+    if (isGemini3x || isNativeAudio || isLiveTranslate) {
       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/")) {

package/dist/cjs/models/google_llm.js

@@ -46,7 +46,7 @@ var import_llm_response = require("./llm_response.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 var _a, _b;
-const GEMINI_MODEL_SYMBOL = Symbol.for("google.adk.geminiModel");
+const GEMINI_MODEL_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.geminiModel");
 function isGemini(obj) {
   return typeof obj === "object" && obj !== null && GEMINI_MODEL_SYMBOL in obj && obj[GEMINI_MODEL_SYMBOL] === true;
 }
@@ -91,9 +91,14 @@ const _Gemini = class _Gemini extends (_b = import_base_llm.BaseLlm, _a = GEMINI
   /**
    * Sends a request to the Gemini model.
    *
-   * @param llmRequest LlmRequest, the request to send to the Gemini model.
-   * @param stream bool = false, whether to do streaming call.
-   * @yields LlmResponse: The model response.
+   * @param llmRequest The request to send to the Gemini model.
+   * @param stream Whether to make a streaming call. Defaults to `false`.
+   * @yields Each {@link LlmResponse} produced by the model. A non-streaming
+   *     call yields exactly one; a streaming call yields the partial responses
+   *     as they arrive, then a final aggregated response whenever the stream
+   *     carried either content or usage/grounding/citation metadata. A
+   *     metadata-only stream therefore still ends with one, holding the
+   *     metadata and no `content`; only a stream with neither ends silently.
    */
   async *generateContentAsync(llmRequest, stream = false, abortSignal) {
     var _a2, _b2, _c;

package/dist/cjs/models/interactions_utils.js

@@ -695,13 +695,12 @@ async function* generateContentViaInteractions(apiClient, llmRequest, stream) {
     });
     const aggregatedParts = [];
     for await (const event of responses) {
-      const sseEvent = event;
-      const interactionId = extractStreamInteractionId(sseEvent);
+      const interactionId = extractStreamInteractionId(event);
       if (interactionId) {
         currentInteractionId = interactionId;
       }
       const llmResponse = convertInteractionEventToLlmResponse(
-        sseEvent,
+        event,
         aggregatedParts,
         currentInteractionId
       );

package/dist/cjs/models/registry.js

@@ -30,6 +30,7 @@ __export(registry_exports, {
 module.exports = __toCommonJS(registry_exports);
 var import_logger = require("../utils/logger.js");
 var import_apigee_llm = require("./apigee_llm.js");
+var import_chrome_prompt_llm = require("./chrome_prompt_llm.js");
 var import_google_llm = require("./google_llm.js");
 /**
  * @license
@@ -121,6 +122,7 @@ _LLMRegistry.resolveCache = new LRUCache(32);
 let LLMRegistry = _LLMRegistry;
 LLMRegistry.register(import_google_llm.Gemini);
 LLMRegistry.register(import_apigee_llm.ApigeeLlm);
+LLMRegistry.register(import_chrome_prompt_llm.ChromeBuiltInLlm);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LLMRegistry

package/dist/cjs/planners/base_planner.js

@@ -0,0 +1,56 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_planner_exports = {};
+__export(base_planner_exports, {
+  BasePlanner: () => BasePlanner,
+  isBasePlanner: () => isBasePlanner
+});
+module.exports = __toCommonJS(base_planner_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a;
+const BASE_PLANNER_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.basePlanner");
+function isBasePlanner(obj) {
+  return typeof obj === "object" && obj !== null && BASE_PLANNER_SIGNATURE_SYMBOL in obj && obj[BASE_PLANNER_SIGNATURE_SYMBOL] === true;
+}
+__name(isBasePlanner, "isBasePlanner");
+_a = BASE_PLANNER_SIGNATURE_SYMBOL;
+const _BasePlanner = class _BasePlanner {
+  constructor() {
+    /** A unique symbol to identify ADK base planner class. */
+    this[_a] = true;
+  }
+};
+__name(_BasePlanner, "BasePlanner");
+let BasePlanner = _BasePlanner;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BasePlanner,
+  isBasePlanner
+});

package/dist/cjs/planners/built_in_planner.js

@@ -0,0 +1,85 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var built_in_planner_exports = {};
+__export(built_in_planner_exports, {
+  BuiltInPlanner: () => BuiltInPlanner,
+  isBuiltInPlanner: () => isBuiltInPlanner
+});
+module.exports = __toCommonJS(built_in_planner_exports);
+var import_base_planner = require("./base_planner.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a, _b;
+const BUILT_IN_PLANNER_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "google.adk.builtInPlanner"
+);
+function isBuiltInPlanner(obj) {
+  return typeof obj === "object" && obj !== null && BUILT_IN_PLANNER_SIGNATURE_SYMBOL in obj && obj[BUILT_IN_PLANNER_SIGNATURE_SYMBOL] === true;
+}
+__name(isBuiltInPlanner, "isBuiltInPlanner");
+const _BuiltInPlanner = class _BuiltInPlanner extends (_b = import_base_planner.BasePlanner, _a = BUILT_IN_PLANNER_SIGNATURE_SYMBOL, _b) {
+  /**
+   * Initializes the built-in planner.
+   *
+   * @param options.thinkingConfig Config for model built-in thinking features.
+   *     An error will be returned if this field is set for models that don't
+   *     support thinking.
+   */
+  constructor(options) {
+    super();
+    /** A unique symbol to identify ADK built-in planner class. */
+    this[_a] = true;
+    this.thinkingConfig = options.thinkingConfig;
+  }
+  /**
+   * Applies the thinking config to the LLM request.
+   *
+   * @param llmRequest The LLM request to apply the thinking config to.
+   */
+  applyThinkingConfig(llmRequest) {
+    var _a2;
+    if (this.thinkingConfig) {
+      llmRequest.config = (_a2 = llmRequest.config) != null ? _a2 : {};
+      llmRequest.config.thinkingConfig = this.thinkingConfig;
+    }
+  }
+  buildPlanningInstruction(_readonlyContext, _llmRequest) {
+    return void 0;
+  }
+  processPlanningResponse(_callbackContext, _responseParts) {
+    return void 0;
+  }
+};
+__name(_BuiltInPlanner, "BuiltInPlanner");
+let BuiltInPlanner = _BuiltInPlanner;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BuiltInPlanner,
+  isBuiltInPlanner
+});

package/dist/cjs/planners/plan_re_act_planner.js

@@ -0,0 +1,172 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plan_re_act_planner_exports = {};
+__export(plan_re_act_planner_exports, {
+  PlanReActPlanner: () => PlanReActPlanner
+});
+module.exports = __toCommonJS(plan_re_act_planner_exports);
+var import_base_planner = require("./base_planner.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const PLANNING_TAG = "/*PLANNING*/";
+const REPLANNING_TAG = "/*REPLANNING*/";
+const REASONING_TAG = "/*REASONING*/";
+const ACTION_TAG = "/*ACTION*/";
+const FINAL_ANSWER_TAG = "/*FINAL_ANSWER*/";
+const THOUGHT_PREFIX_TAGS = [
+  PLANNING_TAG,
+  REASONING_TAG,
+  ACTION_TAG,
+  REPLANNING_TAG
+];
+const _PlanReActPlanner = class _PlanReActPlanner extends import_base_planner.BasePlanner {
+  buildPlanningInstruction(_readonlyContext, _llmRequest) {
+    return buildNlPlannerInstruction();
+  }
+  processPlanningResponse(_callbackContext, responseParts) {
+    if (!responseParts || responseParts.length === 0) {
+      return void 0;
+    }
+    const preservedParts = [];
+    let firstFcPartIndex = -1;
+    for (let i = 0; i < responseParts.length; i++) {
+      const part = responseParts[i];
+      if (part.functionCall) {
+        if (!part.functionCall.name) {
+          continue;
+        }
+        preservedParts.push(part);
+        firstFcPartIndex = i;
+        break;
+      }
+      handleNonFunctionCallPart(part, preservedParts);
+    }
+    if (firstFcPartIndex > 0) {
+      for (let j = firstFcPartIndex + 1; j < responseParts.length; j++) {
+        if (!responseParts[j].functionCall) {
+          break;
+        }
+        preservedParts.push(responseParts[j]);
+      }
+    }
+    return preservedParts;
+  }
+};
+__name(_PlanReActPlanner, "PlanReActPlanner");
+let PlanReActPlanner = _PlanReActPlanner;
+function splitByLastPattern(text, separator) {
+  const index = text.lastIndexOf(separator);
+  if (index === -1) {
+    return [text, ""];
+  }
+  const end = index + separator.length;
+  return [text.slice(0, end), text.slice(end)];
+}
+__name(splitByLastPattern, "splitByLastPattern");
+function handleNonFunctionCallPart(responsePart, preservedParts) {
+  var _a;
+  if (responsePart.text && responsePart.text.includes(FINAL_ANSWER_TAG)) {
+    const [reasoningText, finalAnswerText] = splitByLastPattern(
+      responsePart.text,
+      FINAL_ANSWER_TAG
+    );
+    if (reasoningText) {
+      preservedParts.push(markAsThought({ text: reasoningText }));
+    }
+    if (finalAnswerText) {
+      preservedParts.push({ text: finalAnswerText });
+    }
+    return;
+  }
+  const responseText = (_a = responsePart.text) != null ? _a : "";
+  if (responseText && THOUGHT_PREFIX_TAGS.some((tag) => responseText.startsWith(tag))) {
+    preservedParts.push(markAsThought(responsePart));
+    return;
+  }
+  preservedParts.push(responsePart);
+}
+__name(handleNonFunctionCallPart, "handleNonFunctionCallPart");
+function markAsThought(responsePart) {
+  if (responsePart.text) {
+    return { ...responsePart, thought: true };
+  }
+  return responsePart;
+}
+__name(markAsThought, "markAsThought");
+function buildNlPlannerInstruction() {
+  const highLevelPreamble = `
+When answering the question, try to leverage the available tools to gather the information instead of your memorized knowledge.
+
+Follow this process when answering the question: (1) first come up with a plan in natural language text format; (2) Then use tools to execute the plan and provide reasoning between tool code snippets to make a summary of current state and next step. Tool code snippets and reasoning should be interleaved with each other. (3) In the end, return one final answer.
+
+Follow this format when answering the question: (1) The planning part should be under ${PLANNING_TAG}. (2) The tool code snippets should be under ${ACTION_TAG}, and the reasoning parts should be under ${REASONING_TAG}. (3) The final answer part should be under ${FINAL_ANSWER_TAG}.
+`;
+  const planningPreamble = `
+Below are the requirements for the planning:
+The plan is made to answer the user query if following the plan. The plan is coherent and covers all aspects of information from user query, and only involves the tools that are accessible by the agent. The plan contains the decomposed steps as a numbered list where each step should use one or multiple available tools. By reading the plan, you can intuitively know which tools to trigger or what actions to take.
+If the initial plan cannot be successfully executed, you should learn from previous execution results and revise your plan. The revised plan should be be under ${REPLANNING_TAG}. Then use tools to follow the new plan.
+`;
+  const reasoningPreamble = `
+Below are the requirements for the reasoning:
+The reasoning makes a summary of the current trajectory based on the user query and tool outputs. Based on the tool outputs and plan, the reasoning also comes up with instructions to the next steps, making the trajectory closer to the final answer.
+`;
+  const finalAnswerPreamble = `
+Below are the requirements for the final answer:
+The final answer should be precise and follow query formatting requirements. Some queries may not be answerable with the available tools and information. In those cases, inform the user why you cannot process their query and ask for more information.
+`;
+  const toolCodeWithoutPythonLibrariesPreamble = `
+Below are the requirements for the tool code:
+
+**Custom Tools:** The available tools are described in the context and can be directly used.
+- Code must be valid self-contained Python snippets with no imports and no references to tools or Python libraries that are not in the context.
+- You cannot use any parameters or fields that are not explicitly defined in the APIs in the context.
+- The code snippets should be readable, efficient, and directly relevant to the user query and reasoning steps.
+- When using the tools, you should use the library name together with the function name, e.g., vertex_search.search().
+- If Python libraries are not provided in the context, NEVER write your own code other than the function calls using the provided tools.
+`;
+  const userInputPreamble = `
+VERY IMPORTANT instruction that you MUST follow in addition to the above instructions:
+
+You should ask for clarification if you need more information to answer the question.
+You should prefer using the information available in the context instead of repeated tool use.
+`;
+  return [
+    highLevelPreamble,
+    planningPreamble,
+    reasoningPreamble,
+    finalAnswerPreamble,
+    toolCodeWithoutPythonLibrariesPreamble,
+    userInputPreamble
+  ].join("\n\n");
+}
+__name(buildNlPlannerInstruction, "buildNlPlannerInstruction");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PlanReActPlanner
+});