@google/adk 2.0.0 → 2.1.0

package/dist/web/context/summarizers/base_summarizer.js

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

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

@@ -1,91 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")]) ? it.call(obj) : (obj = obj[__knownSymbol("iterator")](), it = {}, method = (key, fn) => (fn = obj[key]) && (it[key] = (arg) => new Promise((yes, no, done) => (arg = fn.call(obj, arg), done = arg.done, Promise.resolve(arg.value).then((value) => yes({ value, done }), no)))), method("next"), method("return"), it);
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import {
-  createCompactedEvent
-} from "../../events/compacted_event.js";
-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.";
-const _LlmSummarizer = 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) {
-      throw new Error("Cannot summarize an empty list of events.");
-    }
-    const startTime = events[0].timestamp;
-    const endTime = events[events.length - 1].timestamp;
-    let formattedEvents = "";
-    for (let i = 0; i < events.length; i++) {
-      formattedEvents += "[Event ".concat(i + 1, " - Author: ").concat(events[i].author, "]\n");
-      formattedEvents += "".concat(stringifyContent(events[i]), "\n\n");
-    }
-    const fullPrompt = "".concat(this.prompt, "\n\n").concat(formattedEvents);
-    const request = {
-      contents: [{ role: "user", parts: [{ text: fullPrompt }] }],
-      toolsDict: {},
-      liveConnectConfig: {}
-    };
-    const responseGen = this.llm.generateContentAsync(request, false);
-    let compactedContent = "";
-    const firstResponse = await responseGen.next();
-    if (firstResponse.done || !((_c = (_b = (_a = firstResponse.value.content) == null ? void 0 : _a.parts) == null ? void 0 : _b[0]) == null ? void 0 : _c.text)) {
-      throw new Error("LLM failed to return a valid summary.");
-    }
-    compactedContent += firstResponse.value.content.parts[0].text;
-    try {
-      for (var iter = __forAwait(responseGen), more, temp, error; more = !(temp = await iter.next()).done; more = false) {
-        const chunk = temp.value;
-        if ((_f = (_e = (_d = chunk.content) == null ? void 0 : _d.parts) == null ? void 0 : _e[0]) == null ? void 0 : _f.text) {
-          compactedContent += chunk.content.parts[0].text;
-        }
-      }
-    } catch (temp) {
-      error = [temp];
-    } finally {
-      try {
-        more && (temp = iter.return) && await temp.call(iter);
-      } finally {
-        if (error)
-          throw error[0];
-      }
-    }
-    return createCompactedEvent({
-      author: "system",
-      content: {
-        role: "model",
-        parts: [{ text: compactedContent }]
-      },
-      startTime,
-      endTime,
-      compactedContent
-    });
-  }
-};
-__name(_LlmSummarizer, "LlmSummarizer");
-let LlmSummarizer = _LlmSummarizer;
-export {
-  LlmSummarizer
-};

package/dist/web/context/token_based_context_compactor.js

@@ -1,118 +0,0 @@
-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 { requireAgent } from "../agents/invocation_context.js";
-import { getContents } from "../agents/processors/content_processor_utils.js";
-import { isCompactedEvent } from "../events/compacted_event.js";
-import {
-  calculateRetainStartIndex,
-  getActiveEvents
-} from "./compaction_utils.js";
-const CHARS_PER_TOKEN = 4;
-const _TokenBasedContextCompactor = class _TokenBasedContextCompactor {
-  constructor(options) {
-    this.tokenThreshold = options.tokenThreshold;
-    this.eventRetentionSize = options.eventRetentionSize;
-    this.summarizer = options.summarizer;
-  }
-  shouldCompact(invocationContext) {
-    const events = invocationContext.session.events;
-    const activeEvents = getActiveEvents(events);
-    const rawEvents = activeEvents.filter((e) => !isCompactedEvent(e));
-    if (rawEvents.length <= this.eventRetentionSize) {
-      return false;
-    }
-    const retainStartIndex = calculateRetainStartIndex(
-      rawEvents,
-      this.eventRetentionSize
-    );
-    if (retainStartIndex === 0) {
-      return false;
-    }
-    const promptTokenCount = latestPromptTokenCount(
-      activeEvents,
-      invocationContext
-    );
-    if (promptTokenCount === void 0) {
-      return false;
-    }
-    return promptTokenCount > this.tokenThreshold;
-  }
-  async compact(invocationContext) {
-    const events = invocationContext.session.events;
-    const activeEvents = getActiveEvents(events);
-    const rawEvents = activeEvents.filter((e) => !isCompactedEvent(e));
-    if (rawEvents.length <= this.eventRetentionSize) {
-      return;
-    }
-    const retainStartIndex = calculateRetainStartIndex(
-      rawEvents,
-      this.eventRetentionSize
-    );
-    if (retainStartIndex === 0) {
-      return;
-    }
-    const rawEventsToCompact = rawEvents.slice(0, retainStartIndex);
-    const compactedEventPresent = activeEvents.find(isCompactedEvent);
-    const eventsToCompact = compactedEventPresent ? [compactedEventPresent, ...rawEventsToCompact] : rawEventsToCompact;
-    const compactedEvent = await this.summarizer.summarize(eventsToCompact);
-    if (!compactedEvent.actions) {
-      compactedEvent.actions = {
-        stateDelta: {},
-        artifactDelta: {},
-        requestedAuthConfigs: {},
-        requestedToolConfirmations: {}
-      };
-    }
-    invocationContext.session.events.push(compactedEvent);
-  }
-};
-__name(_TokenBasedContextCompactor, "TokenBasedContextCompactor");
-let TokenBasedContextCompactor = _TokenBasedContextCompactor;
-function latestPromptTokenCount(activeEvents, invocationContext) {
-  var _a;
-  for (let i = activeEvents.length - 1; i >= 0; i--) {
-    const count = (_a = activeEvents[i].usageMetadata) == null ? void 0 : _a.promptTokenCount;
-    if (count !== void 0) {
-      return count;
-    }
-  }
-  return estimatePromptTokenCount(activeEvents, invocationContext);
-}
-__name(latestPromptTokenCount, "latestPromptTokenCount");
-function estimatePromptTokenCount(activeEvents, invocationContext) {
-  var _a;
-  const contents = getContents(
-    activeEvents,
-    requireAgent(invocationContext).name,
-    invocationContext.branch
-  );
-  let totalChars = 0;
-  for (const content of contents) {
-    for (const part of (_a = content.parts) != null ? _a : []) {
-      if (part.text) {
-        totalChars += part.text.length;
-      }
-      if (part.functionCall) {
-        totalChars += JSON.stringify(part.functionCall).length;
-      }
-      if (part.functionResponse) {
-        totalChars += JSON.stringify(part.functionResponse).length;
-      }
-    }
-  }
-  if (totalChars <= 0) {
-    return void 0;
-  }
-  return Math.ceil(totalChars / CHARS_PER_TOKEN);
-}
-__name(estimatePromptTokenCount, "estimatePromptTokenCount");
-export {
-  TokenBasedContextCompactor
-};

package/dist/web/context/trajectory_thought_pruning_compactor.js

@@ -1,47 +0,0 @@
-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 { hasThoughts, pruneThoughts } from "../events/event.js";
-const _TrajectoryThoughtPruningCompactor = class _TrajectoryThoughtPruningCompactor {
-  constructor(options) {
-    if (options.eventRetentionSize < 0) {
-      throw new Error("eventRetentionSize must be a non-negative integer.");
-    }
-    this.eventRetentionSize = options.eventRetentionSize;
-  }
-  shouldCompact(invocationContext) {
-    const events = invocationContext.session.events;
-    if (events.length <= this.eventRetentionSize) {
-      return false;
-    }
-    const olderEvents = events.slice(
-      0,
-      events.length - this.eventRetentionSize
-    );
-    return olderEvents.some((event) => hasThoughts(event));
-  }
-  compact(invocationContext) {
-    const events = invocationContext.session.events;
-    if (events.length <= this.eventRetentionSize) {
-      return;
-    }
-    const pruneLimit = events.length - this.eventRetentionSize;
-    for (let i = 0; i < pruneLimit; i++) {
-      const event = events[i];
-      if (hasThoughts(event)) {
-        events[i] = pruneThoughts(event);
-      }
-    }
-  }
-};
-__name(_TrajectoryThoughtPruningCompactor, "TrajectoryThoughtPruningCompactor");
-let TrajectoryThoughtPruningCompactor = _TrajectoryThoughtPruningCompactor;
-export {
-  TrajectoryThoughtPruningCompactor
-};

package/dist/web/context/truncating_context_compactor.js

@@ -1,34 +0,0 @@
-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 _TruncatingContextCompactor = class _TruncatingContextCompactor {
-  constructor(options) {
-    var _a;
-    this.threshold = options.threshold;
-    this.preserveLeadingEvents = (_a = options.preserveLeadingEvents) != null ? _a : 0;
-  }
-  shouldCompact(invocationContext) {
-    const eventsLength = invocationContext.session.events.length;
-    return eventsLength > this.threshold + Math.max(0, this.preserveLeadingEvents);
-  }
-  compact(invocationContext) {
-    const events = invocationContext.session.events;
-    const excess = events.length - this.threshold - Math.max(0, this.preserveLeadingEvents);
-    if (excess <= 0) {
-      return;
-    }
-    const startIndexToRemove = Math.max(0, this.preserveLeadingEvents);
-    events.splice(startIndexToRemove, excess);
-  }
-};
-__name(_TruncatingContextCompactor, "TruncatingContextCompactor");
-let TruncatingContextCompactor = _TruncatingContextCompactor;
-export {
-  TruncatingContextCompactor
-};

package/dist/web/environment/base_environment.js

@@ -1,71 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-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 { experimental } from "../utils/experimental.js";
-let BaseEnvironment = class {
-  constructor() {
-    /**
-     * Backing flag for {@link isInitialized}.
-     *
-     * Subclasses own this flag: set it in {@link initialize} and clear it in
-     * {@link close}.
-     */
-    this.initialized = false;
-  }
-  /** Whether the environment has been initialized. */
-  get isInitialized() {
-    return this.initialized;
-  }
-  /**
-   * Initializes the environment (e.g. creates the working directory).
-   *
-   * Called before first use. The default implementation is a no-op and leaves
-   * {@link isInitialized} `false`. Subclasses must be idempotent and must set
-   * {@link initialized}.
-   */
-  async initialize() {
-  }
-  /**
-   * Releases resources held by the environment.
-   *
-   * The default implementation is a no-op. Subclasses must be idempotent and
-   * must clear {@link initialized}.
-   */
-  async close() {
-  }
-  /**
-   * Throws if {@link initialize} has not been called.
-   *
-   * Implementations should call this at the start of every operation that needs
-   * a live working directory.
-   */
-  assertInitialized() {
-    if (!this.initialized) {
-      throw new Error(
-        "Environment is not initialized. Call initialize() first."
-      );
-    }
-  }
-};
-__name(BaseEnvironment, "BaseEnvironment");
-BaseEnvironment = __decorateClass([
-  experimental
-], BaseEnvironment);
-export {
-  BaseEnvironment
-};

package/dist/web/environment/local_environment.js

@@ -1,165 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-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 { spawn } from "node:child_process";
-import * as fs from "node:fs/promises";
-import * as os from "node:os";
-import * as path from "node:path";
-import { experimental } from "../utils/experimental.js";
-import { logger } from "../utils/logger.js";
-import { BaseEnvironment } from "./base_environment.js";
-const TEMP_WORKSPACE_PREFIX = "adk_workspace_";
-function resolvePathInWorkingDir(workingDir, filePath) {
-  const base = path.resolve(workingDir);
-  const resolved = path.resolve(base, filePath);
-  const relative = path.relative(base, resolved);
-  if (relative === ".." || relative.startsWith("..".concat(path.sep)) || // `path.relative` returns an absolute path across Windows drives.
-  path.isAbsolute(relative)) {
-    throw new Error("Path escapes working directory: ".concat(filePath));
-  }
-  return resolved;
-}
-__name(resolvePathInWorkingDir, "resolvePathInWorkingDir");
-let LocalEnvironment = class extends BaseEnvironment {
-  constructor(options = {}) {
-    super();
-    this.autoCreated = false;
-    this.currentWorkingDir = options.workingDir;
-    this.envVars = options.envVars;
-  }
-  get workingDir() {
-    if (this.currentWorkingDir === void 0) {
-      throw new Error("`workingDir` is not set. Call initialize() first.");
-    }
-    return this.currentWorkingDir;
-  }
-  async initialize() {
-    if (this.currentWorkingDir === void 0) {
-      this.currentWorkingDir = await fs.mkdtemp(
-        path.join(os.tmpdir(), TEMP_WORKSPACE_PREFIX)
-      );
-      this.autoCreated = true;
-      logger.debug("Created temporary workspace: ".concat(this.currentWorkingDir));
-    } else {
-      await fs.mkdir(this.currentWorkingDir, { recursive: true });
-    }
-    this.initialized = true;
-  }
-  async close() {
-    if (this.autoCreated && this.currentWorkingDir !== void 0) {
-      await fs.rm(this.currentWorkingDir, { recursive: true, force: true });
-      logger.debug("Removed temporary workspace: ".concat(this.currentWorkingDir));
-      this.currentWorkingDir = void 0;
-    }
-    this.initialized = false;
-  }
-  async execute(command, timeoutSeconds) {
-    this.assertInitialized();
-    const child = spawn(command, {
-      shell: true,
-      cwd: this.workingDir,
-      env: __spreadValues(__spreadValues({}, process.env), this.envVars)
-    });
-    const stdoutChunks = [];
-    const stderrChunks = [];
-    child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
-    child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
-    let timedOut = false;
-    let timer;
-    if (timeoutSeconds !== void 0) {
-      timer = setTimeout(() => {
-        timedOut = true;
-        child.kill("SIGKILL");
-        child.stdout.destroy();
-        child.stderr.destroy();
-      }, timeoutSeconds * 1e3);
-    }
-    try {
-      const exitCode = await new Promise((resolve, reject) => {
-        child.on("close", (code, signal) => {
-          resolve(
-            signal === null ? code != null ? code : 0 : -os.constants.signals[signal]
-          );
-        });
-        child.on("error", reject);
-      });
-      return {
-        exitCode,
-        // Decode once, so a multi-byte character split across two chunks is
-        // not corrupted. Invalid bytes become U+FFFD, matching Python's
-        // `errors='replace'`.
-        stdout: Buffer.concat(stdoutChunks).toString("utf-8"),
-        stderr: Buffer.concat(stderrChunks).toString("utf-8"),
-        timedOut
-      };
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  /**
-   * Reads a file from the working directory.
-   *
-   * `filePath` is confined to the working directory by a lexical check on the
-   * resolved path, which is not a sandbox.
-   *
-   * @throws If the environment is not initialized, if the path escapes the
-   *   working directory, or — as `ENOENT` — if the file does not exist.
-   */
-  async readFile(filePath) {
-    this.assertInitialized();
-    return fs.readFile(resolvePathInWorkingDir(this.workingDir, filePath));
-  }
-  /**
-   * Writes a file in the working directory, creating parent directories.
-   *
-   * `filePath` is confined to the working directory by a lexical check on the
-   * resolved path, which is not a sandbox. No newline translation is applied,
-   * so explicit CRLF sequences are preserved.
-   *
-   * @throws If the environment is not initialized or the path escapes the
-   *   working directory.
-   */
-  async writeFile(filePath, content) {
-    this.assertInitialized();
-    const resolved = resolvePathInWorkingDir(this.workingDir, filePath);
-    await fs.mkdir(path.dirname(resolved), { recursive: true });
-    await fs.writeFile(resolved, content);
-  }
-};
-__name(LocalEnvironment, "LocalEnvironment");
-LocalEnvironment = __decorateClass([
-  experimental
-], LocalEnvironment);
-export {
-  LocalEnvironment
-};

package/dist/web/events/compacted_event.js

@@ -1,51 +0,0 @@
-import {createRequire as topLevelCreateRequire} from 'module';
-const require = topLevelCreateRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __defProps = Object.defineProperties;
-var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
-var __getOwnPropSymbols = Object.getOwnPropertySymbols;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __propIsEnum = Object.prototype.propertyIsEnumerable;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __spreadValues = (a, b) => {
-  for (var prop in b || (b = {}))
-    if (__hasOwnProp.call(b, prop))
-      __defNormalProp(a, prop, b[prop]);
-  if (__getOwnPropSymbols)
-    for (var prop of __getOwnPropSymbols(b)) {
-      if (__propIsEnum.call(b, prop))
-        __defNormalProp(a, prop, b[prop]);
-    }
-  return a;
-};
-var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { createEvent } from "./event.js";
-function isCompactedEvent(event) {
-  return "isCompacted" in event && event.isCompacted === true;
-}
-__name(isCompactedEvent, "isCompactedEvent");
-function isScratchpadEvent(event) {
-  return isCompactedEvent(event) && event.isScratchpad === true;
-}
-__name(isScratchpadEvent, "isScratchpadEvent");
-function createCompactedEvent(params = {}) {
-  return __spreadProps(__spreadValues({}, createEvent(params)), {
-    isCompacted: params.isCompacted || true,
-    startTime: params.startTime,
-    endTime: params.endTime,
-    compactedContent: params.compactedContent,
-    isScratchpad: params.isScratchpad
-  });
-}
-__name(createCompactedEvent, "createCompactedEvent");
-export {
-  createCompactedEvent,
-  isCompactedEvent,
-  isScratchpadEvent
-};