@google/adk 2.0.0 → 2.2.0

package/dist/esm/context/truncating_context_compactor.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 { isEventVisibleInIsolationScope } from "./compaction_utils.js";
 const _TruncatingContextCompactor = class _TruncatingContextCompactor {
   constructor(options) {
     var _a;
@@ -14,17 +15,28 @@ const _TruncatingContextCompactor = class _TruncatingContextCompactor {
     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);
+    const visibleEventsLength = invocationContext.session.events.filter(
+      (event) => isEventVisibleInIsolationScope(event, invocationContext.isolationScope)
+    ).length;
+    return visibleEventsLength > 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);
+    const visibleIndices = events.flatMap(
+      (event, index) => isEventVisibleInIsolationScope(event, invocationContext.isolationScope) ? [index] : []
+    );
+    const excess = visibleIndices.length - this.threshold - Math.max(0, this.preserveLeadingEvents);
     if (excess <= 0) {
       return;
     }
-    const startIndexToRemove = Math.max(0, this.preserveLeadingEvents);
-    events.splice(startIndexToRemove, excess);
+    const preserveCount = Math.max(0, this.preserveLeadingEvents);
+    const indicesToRemove = visibleIndices.slice(
+      preserveCount,
+      preserveCount + excess
+    );
+    for (const index of indicesToRemove.reverse()) {
+      events.splice(index, 1);
+    }
   }
 };
 __name(_TruncatingContextCompactor, "TruncatingContextCompactor");

package/dist/esm/errors/already_exists_error.js

@@ -0,0 +1,23 @@
+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 _AlreadyExistsError = class _AlreadyExistsError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "The resource already exists.") {
+    super(message);
+    this.name = "AlreadyExistsError";
+  }
+};
+__name(_AlreadyExistsError, "AlreadyExistsError");
+let AlreadyExistsError = _AlreadyExistsError;
+export {
+  AlreadyExistsError
+};

package/dist/esm/errors/input_validation_error.js

@@ -0,0 +1,23 @@
+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 _InputValidationError = class _InputValidationError extends Error {
+  /**
+   * @param message A message describing why the input is invalid.
+   */
+  constructor(message = "Invalid input.") {
+    super(message);
+    this.name = "InputValidationError";
+  }
+};
+__name(_InputValidationError, "InputValidationError");
+let InputValidationError = _InputValidationError;
+export {
+  InputValidationError
+};

package/dist/{web/auth/refresher/base_credential_refresher.js → esm/errors/not_found_error.js}

@@ -7,14 +7,17 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const _CredentialRefresherError = class _CredentialRefresherError extends Error {
-  constructor(message) {
+const _NotFoundError = class _NotFoundError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "The requested item was not found.") {
     super(message);
-    this.name = "CredentialRefresherError";
+    this.name = "NotFoundError";
   }
 };
-__name(_CredentialRefresherError, "CredentialRefresherError");
-let CredentialRefresherError = _CredentialRefresherError;
+__name(_NotFoundError, "NotFoundError");
+let NotFoundError = _NotFoundError;
 export {
-  CredentialRefresherError
+  NotFoundError
 };

package/dist/esm/errors/session_not_found_error.js

@@ -0,0 +1,23 @@
+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 _SessionNotFoundError = class _SessionNotFoundError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "Session not found.") {
+    super(message);
+    this.name = "SessionNotFoundError";
+  }
+};
+__name(_SessionNotFoundError, "SessionNotFoundError");
+let SessionNotFoundError = _SessionNotFoundError;
+export {
+  SessionNotFoundError
+};

package/dist/esm/errors/tool_execution_error.js

@@ -0,0 +1,40 @@
+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
+ */
+var ToolErrorType = /* @__PURE__ */ ((ToolErrorType2) => {
+  ToolErrorType2["BAD_REQUEST"] = "BAD_REQUEST";
+  ToolErrorType2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  ToolErrorType2["FORBIDDEN"] = "FORBIDDEN";
+  ToolErrorType2["NOT_FOUND"] = "NOT_FOUND";
+  ToolErrorType2["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+  ToolErrorType2["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+  ToolErrorType2["BAD_GATEWAY"] = "BAD_GATEWAY";
+  ToolErrorType2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ToolErrorType2["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
+  return ToolErrorType2;
+})(ToolErrorType || {});
+const _ToolExecutionError = class _ToolExecutionError extends Error {
+  /**
+   * @param message A message describing the error.
+   * @param errorType The semantic error type (e.g.
+   *   {@link ToolErrorType.REQUEST_TIMEOUT} or `'500'`). Used to populate the
+   *   `error.type` span attribute in OpenTelemetry traces.
+   */
+  constructor(message, errorType) {
+    super(message);
+    this.errorType = errorType;
+    this.name = "ToolExecutionError";
+  }
+};
+__name(_ToolExecutionError, "ToolExecutionError");
+let ToolExecutionError = _ToolExecutionError;
+export {
+  ToolErrorType,
+  ToolExecutionError
+};

package/dist/esm/events/event.js

@@ -10,7 +10,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import { randomUUID } from "../utils/env_aware_utils.js";
 import { toCamelCase, toSnakeCase } from "../utils/object_notation_utils.js";
 import { createEventActions } from "./event_actions.js";
-const EVENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.event");
+const EVENT_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.event");
 function createEvent(params = {}) {
   return {
     ...params,

package/dist/esm/events/event_actions.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 { isEmpty } from "lodash-es";
 import { carryDeltaStamps } from "../sessions/state_write_order.js";
 function createEventActions(state = {}) {
   return {
@@ -18,6 +19,10 @@ function createEventActions(state = {}) {
   };
 }
 __name(createEventActions, "createEventActions");
+function isDefaultEventActions(actions) {
+  return isEmpty(actions.stateDelta) && isEmpty(actions.artifactDelta) && isEmpty(actions.requestedAuthConfigs) && isEmpty(actions.requestedToolConfirmations) && actions.skipSummarization === void 0 && actions.transferToAgent === void 0 && actions.escalate === void 0;
+}
+__name(isDefaultEventActions, "isDefaultEventActions");
 function mergeEventActions(sources, target) {
   const result = createEventActions();
   if (target) {
@@ -56,5 +61,6 @@ function mergeEventActions(sources, target) {
 __name(mergeEventActions, "mergeEventActions");
 export {
   createEventActions,
+  isDefaultEventActions,
   mergeEventActions
 };

package/dist/esm/examples/base_example_provider.js

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

package/dist/esm/examples/example.js

@@ -1,7 +1,92 @@
 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
  * SPDX-License-Identifier: Apache-2.0
  */
+import { BaseExampleProvider } from "./base_example_provider.js";
+const SIMILARITY_SCORE_THRESHOLD = 0.5;
+const DEFAULT_TOP_K = 10;
+const _VertexAiExampleStore = class _VertexAiExampleStore extends BaseExampleProvider {
+  /**
+   * Initializes the VertexAiExampleStore.
+   *
+   * @param examplesStoreName The resource name of the vertex example store, in
+   *   the format of
+   *   `projects/{project}/locations/{location}/exampleStores/{example_store}`.
+   * @param apiClient A client that reaches the Vertex AI Example Store API.
+   *   adk-js does not bundle the `vertexai` dependency the Python SDK relies
+   *   on, so the caller supplies this client.
+   */
+  constructor(examplesStoreName, apiClient) {
+    super();
+    this.examplesStoreName = examplesStoreName;
+    this.apiClient = apiClient;
+  }
+  /**
+   * Retrieves relevant examples from the Vertex AI Example Store for the given
+   * query.
+   */
+  async getExamples(query) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    const request = {
+      storedContentsExampleParameters: {
+        contentSearchKey: {
+          contents: [{ role: "user", parts: [{ text: query }] }],
+          searchKeyGenerationMethod: { lastEntry: {} }
+        }
+      },
+      topK: DEFAULT_TOP_K,
+      exampleStore: this.examplesStoreName
+    };
+    const response = await this.apiClient.searchExamples(request);
+    const returnedExamples = [];
+    for (const result of (_a = response.results) != null ? _a : []) {
+      if (((_b = result.similarityScore) != null ? _b : 0) < SIMILARITY_SCORE_THRESHOLD) {
+        continue;
+      }
+      const storedExample = (_c = result.example) == null ? void 0 : _c.storedContentsExample;
+      const expectedContents = ((_e = (_d = storedExample == null ? void 0 : storedExample.contentsExample) == null ? void 0 : _d.expectedContents) != null ? _e : []).map((entry) => entry.content).filter((content) => content !== void 0);
+      const expectedOutput = [];
+      for (const content of expectedContents) {
+        const expectedParts = [];
+        for (const part of (_f = content.parts) != null ? _f : []) {
+          if (part.text) {
+            expectedParts.push({ text: part.text });
+          } else if (part.functionCall) {
+            expectedParts.push({
+              functionCall: {
+                name: part.functionCall.name,
+                args: { ...(_g = part.functionCall.args) != null ? _g : {} }
+              }
+            });
+          } else if (part.functionResponse) {
+            expectedParts.push({
+              functionResponse: {
+                name: part.functionResponse.name,
+                response: { ...(_h = part.functionResponse.response) != null ? _h : {} }
+              }
+            });
+          }
+        }
+        expectedOutput.push({ role: content.role, parts: expectedParts });
+      }
+      returnedExamples.push({
+        input: {
+          role: "user",
+          parts: [{ text: (_i = storedExample == null ? void 0 : storedExample.searchKey) != null ? _i : "" }]
+        },
+        output: expectedOutput
+      });
+    }
+    return returnedExamples;
+  }
+};
+__name(_VertexAiExampleStore, "VertexAiExampleStore");
+let VertexAiExampleStore = _VertexAiExampleStore;
+export {
+  VertexAiExampleStore
+};

package/dist/esm/examples/example_util.js

@@ -7,6 +7,8 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { getFunctionResponses } from "../events/event.js";
+import { logger } from "../utils/logger.js";
 import {
   isBaseExampleProvider
 } from "./base_example_provider.js";
@@ -68,17 +70,37 @@ function convertExamplesToText(examples, model) {
   return `${EXAMPLES_INTRO}${examplesStr}${EXAMPLES_END}`;
 }
 __name(convertExamplesToText, "convertExamplesToText");
-function buildExampleSi(examples, query, model) {
+function getLatestMessageFromUser(session) {
+  var _a, _b;
+  const events = session.events;
+  if (!events || events.length === 0) {
+    return "";
+  }
+  const event = events[events.length - 1];
+  if (event.author === "user" && getFunctionResponses(event).length === 0) {
+    if (((_a = event.content) == null ? void 0 : _a.parts) && ((_b = event.content.parts[0]) == null ? void 0 : _b.text)) {
+      return event.content.parts[0].text;
+    } else {
+      logger.warn("No message from user for fetching example.");
+    }
+  }
+  return "";
+}
+__name(getLatestMessageFromUser, "getLatestMessageFromUser");
+const _getLatestMessageFromUser = getLatestMessageFromUser;
+async function buildExampleSi(examples, query, model) {
   if (Array.isArray(examples)) {
     return convertExamplesToText(examples, model);
   }
   if (isBaseExampleProvider(examples)) {
-    return convertExamplesToText(examples.getExamples(query), model);
+    return convertExamplesToText(await examples.getExamples(query), model);
   }
   throw new Error("Invalid example configuration");
 }
 __name(buildExampleSi, "buildExampleSi");
 export {
+  _getLatestMessageFromUser,
   buildExampleSi,
-  convertExamplesToText
+  convertExamplesToText,
+  getLatestMessageFromUser
 };

package/dist/{web/auth/credential_service/base_credential_service.js → esm/examples/index.js}

@@ -5,3 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+export * from "./base_example_provider.js";
+export * from "./example.js";
+export * from "./example_util.js";
+export * from "./vertex_ai_example_store.js";

package/dist/{web/version.js → esm/examples/vertex_ai_example_store.js}

@@ -5,7 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "2.0.0";
+import { VertexAiExampleStore } from "./example.js";
 export {
-  version
+  VertexAiExampleStore
 };

package/dist/esm/index.js

@@ -5,6 +5,8 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { installNodeLogger } from "./utils/logger_node.js";
+installNodeLogger();
 export * from "./a2a/index.js";
 import { InvocationContext } from "./agents/invocation_context.js";
 import { FileArtifactService } from "./artifacts/file_artifact_service.js";
@@ -14,44 +16,129 @@ import {
   AgentEngineSandboxCodeExecutor
 } from "./code_executors/agent_engine_sandbox_code_executor.js";
 import { CodeExecutionLanguage } from "./code_executors/code_execution_utils.js";
+import {
+  ContainerCodeExecutor
+} from "./code_executors/container_code_executor.js";
 import {
   UnsafeLocalCodeExecutor
 } from "./code_executors/unsafe_local_code_executor.js";
 export * from "./common.js";
 import { LocalEnvironment } from "./environment/local_environment.js";
+import { VertexAiMemoryBankService } from "./memory/vertex_ai_memory_bank_service.js";
+import { VertexAiRagMemoryService } from "./memory/vertex_ai_rag_memory_service.js";
 import { DatabaseSessionService } from "./sessions/database_session_service.js";
 import { getSessionServiceFromUri } from "./sessions/registry.js";
 import { VertexAiSessionService } from "./sessions/vertex_ai_session_service.js";
+import { GCPSkillRegistry } from "./skills/gcp_skill_registry.js";
 import {
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
   validateSkillDir
 } from "./skills/loader.js";
+import { LOAD_WEB_PAGE, loadWebPage } from "./tools/load_web_page.js";
+import {
+  credentialToParam,
+  dictToAuthScheme,
+  INTERNAL_AUTH_PREFIX,
+  openidDictToSchemeCredential,
+  openidUrlToSchemeCredential,
+  serviceAccountDictToSchemeCredential,
+  serviceAccountSchemeCredential,
+  tokenToSchemeCredential
+} from "./tools/openapi_tool/auth/auth_helpers.js";
+import { AutoAuthCredentialExchanger } from "./tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js";
+import {
+  AuthCredentialMissingError,
+  BaseAuthCredentialExchanger
+} from "./tools/openapi_tool/auth/credential_exchangers/base_auth_credential_exchanger.js";
+import {
+  exchangeCredential,
+  OAuth2BearerExchanger
+} from "./tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js";
+import { ServiceAccountCredentialExchanger } from "./tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js";
+import {
+  createApiParameter,
+  generateParamDoc,
+  generateReturnDoc,
+  getTypeHint
+} from "./tools/openapi_tool/common/common.js";
+import { OpenApiSpecParser } from "./tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js";
+import { OperationParser } from "./tools/openapi_tool/openapi_spec_parser/operation_parser.js";
+import {
+  ToolAuthHandler,
+  ToolContextCredentialStore
+} from "./tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js";
+import { OpenAPIToolset } from "./tools/openapi_tool/openapi_toolset.js";
+import {
+  createRestApiTool,
+  createRestApiToolFromJson,
+  RestApiTool
+} from "./tools/openapi_tool/rest_api_tool.js";
+import { FilesRetrieval } from "./tools/retrieval/files_retrieval.js";
+import { LoadSkillResourceTool } from "./tools/skill/load_skill_resource_tool.js";
 import {
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool
 } from "./tools/skill/run_skill_inline_script_tool.js";
 import { RunSkillScriptTool } from "./tools/skill/run_skill_script_tool.js";
+import { SkillToolset } from "./tools/skill/skill_toolset.js";
 export * from "./integrations/agent_registry/agent_registry.js";
 export * from "./telemetry/google_cloud.js";
 export * from "./telemetry/setup.js";
 export * from "./tools/mcp/index.js";
 export {
   AgentEngineSandboxCodeExecutor,
+  AuthCredentialMissingError,
+  AutoAuthCredentialExchanger,
+  BaseAuthCredentialExchanger,
   CodeExecutionLanguage,
+  ContainerCodeExecutor,
   DatabaseSessionService,
   FileArtifactService,
+  FilesRetrieval,
+  GCPSkillRegistry,
   GcsArtifactService,
+  INTERNAL_AUTH_PREFIX,
   InvocationContext,
+  LOAD_WEB_PAGE,
+  LoadSkillResourceTool,
   LocalEnvironment,
+  OAuth2BearerExchanger,
+  OpenAPIToolset,
+  OpenApiSpecParser,
+  OperationParser,
+  RestApiTool,
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool,
   RunSkillScriptTool,
+  ServiceAccountCredentialExchanger,
+  SkillToolset,
+  ToolAuthHandler,
+  ToolContextCredentialStore,
   UnsafeLocalCodeExecutor,
+  VertexAiMemoryBankService,
+  VertexAiRagMemoryService,
   VertexAiSessionService,
+  createApiParameter,
+  createRestApiTool,
+  createRestApiToolFromJson,
+  credentialToParam,
+  dictToAuthScheme,
+  exchangeCredential,
+  generateParamDoc,
+  generateReturnDoc,
   getArtifactServiceFromUri,
   getSessionServiceFromUri,
+  getTypeHint,
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
+  loadWebPage,
+  openidDictToSchemeCredential,
+  openidUrlToSchemeCredential,
+  serviceAccountDictToSchemeCredential,
+  serviceAccountSchemeCredential,
+  tokenToSchemeCredential,
   validateSkillDir
 };

package/dist/esm/index_web.js

@@ -5,4 +5,6 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { installBrowserLogger } from "./utils/logger_browser.js";
+installBrowserLogger();
 export * from "./common.js";

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

@@ -318,8 +318,9 @@ const _AgentRegistry = class _AgentRegistry {
       capabilities: {
         streaming: false
       },
-      defaultInputModes: ["text"],
-      defaultOutputModes: ["text"]
+      // The A2A spec defines the default modes as media types.
+      defaultInputModes: ["text/plain"],
+      defaultOutputModes: ["text/plain"]
     };
     return new RemoteA2AAgent({
       name,

package/dist/esm/memory/rag_memory_transcript.js

@@ -0,0 +1,106 @@
+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 SOURCE_DISPLAY_NAME_PREFIX = "adk-memory-v1.";
+const SOURCE_DISPLAY_NAME_SEGMENTS = 3;
+const MILLISECONDS_PER_SECOND = 1e3;
+function encodeSegment(value) {
+  return Buffer.from(value, "utf-8").toString("base64url");
+}
+__name(encodeSegment, "encodeSegment");
+function decodeSegment(segment) {
+  if (!segment) {
+    return void 0;
+  }
+  const decoded = Buffer.from(segment, "base64url").toString("utf-8");
+  return encodeSegment(decoded) === segment ? decoded : void 0;
+}
+__name(decodeSegment, "decodeSegment");
+function buildSourceDisplayName(appName, userId, sessionId) {
+  const segments = [appName, userId, sessionId].map(encodeSegment);
+  return SOURCE_DISPLAY_NAME_PREFIX + segments.join(".");
+}
+__name(buildSourceDisplayName, "buildSourceDisplayName");
+function parseSourceDisplayName(displayName) {
+  const isPrefixed = displayName.startsWith(SOURCE_DISPLAY_NAME_PREFIX);
+  const raw = isPrefixed ? displayName.slice(SOURCE_DISPLAY_NAME_PREFIX.length) : displayName;
+  const parts = raw.split(".");
+  if (parts.length !== SOURCE_DISPLAY_NAME_SEGMENTS) {
+    return void 0;
+  }
+  if (!isPrefixed) {
+    return { appName: parts[0], userId: parts[1], sessionId: parts[2] };
+  }
+  const [appName, userId, sessionId] = parts.map(decodeSegment);
+  if (appName === void 0 || userId === void 0 || sessionId === void 0) {
+    return void 0;
+  }
+  return { appName, userId, sessionId };
+}
+__name(parseSourceDisplayName, "parseSourceDisplayName");
+function serializeSessionTranscript(session) {
+  var _a, _b, _c;
+  const lines = [];
+  for (const event of session.events) {
+    const texts = [];
+    for (const part of (_b = (_a = event.content) == null ? void 0 : _a.parts) != null ? _b : []) {
+      if (part.text) {
+        texts.push(part.text.replaceAll("\n", " "));
+      }
+    }
+    if (texts.length === 0) {
+      continue;
+    }
+    lines.push(
+      JSON.stringify({
+        author: (_c = event.author) != null ? _c : "",
+        timestamp: event.timestamp / MILLISECONDS_PER_SECOND,
+        text: texts.join(".")
+      })
+    );
+  }
+  return lines.join("\n");
+}
+__name(serializeSessionTranscript, "serializeSessionTranscript");
+function parseTranscriptLine(line) {
+  let parsed;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    return void 0;
+  }
+  if (parsed === null || typeof parsed !== "object") {
+    return void 0;
+  }
+  const record = parsed;
+  const seconds = typeof record["timestamp"] === "number" ? record["timestamp"] : 0;
+  return {
+    author: typeof record["author"] === "string" ? record["author"] : "",
+    timestamp: seconds * MILLISECONDS_PER_SECOND,
+    text: typeof record["text"] === "string" ? record["text"] : ""
+  };
+}
+__name(parseTranscriptLine, "parseTranscriptLine");
+function parseTranscriptEvents(text) {
+  const events = [];
+  for (const line of text.split("\n")) {
+    const event = parseTranscriptLine(line);
+    if (event) {
+      events.push(event);
+    }
+  }
+  return events;
+}
+__name(parseTranscriptEvents, "parseTranscriptEvents");
+export {
+  buildSourceDisplayName,
+  parseSourceDisplayName,
+  parseTranscriptEvents,
+  serializeSessionTranscript
+};