@google/adk 1.6.0 → 2.1.0

package/dist/cjs/context/agent_controlled_context_compactor.js

@@ -9,6 +9,7 @@ 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 });
@@ -35,7 +36,7 @@ var import_compaction_utils = require("./compaction_utils.js");
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class AgentControlledContextCompactor {
+const _AgentControlledContextCompactor = class _AgentControlledContextCompactor {
   constructor(options) {
     this.trigger = import_base_plugin.ContextCompactionTrigger.AgentControlled;
     this.summarizer = options.summarizer;
@@ -44,15 +45,19 @@ class AgentControlledContextCompactor {
     return invocationContext.session.state["temp:consolidate_context"] === true;
   }
   async compact(invocationContext) {
+    var _a;
     const events = invocationContext.session.events;
-    const activeEvents = (0, import_compaction_utils.getActiveEvents)(events);
+    const activeEvents = (0, import_compaction_utils.getActiveEvents)(
+      events,
+      invocationContext.isolationScope
+    );
     const consolidateToolCallIndex = activeEvents.reduce(
       (acc, e, idx) => {
-        var _a, _b;
-        return ((_b = (_a = e.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.some(
+        var _a2, _b;
+        return ((_b = (_a2 = e.content) == null ? void 0 : _a2.parts) == null ? void 0 : _b.some(
           (p) => {
-            var _a2;
-            return ((_a2 = p.functionCall) == null ? void 0 : _a2.name) === "consolidate_context";
+            var _a3;
+            return ((_a3 = p.functionCall) == null ? void 0 : _a3.name) === "consolidate_context";
           }
         )) ? idx : acc;
       },
@@ -82,6 +87,7 @@ class AgentControlledContextCompactor {
     }
     try {
       const compactedEvent = await this.summarizer.summarize(eventsToCompact);
+      (_a = compactedEvent.isolationScope) != null ? _a : compactedEvent.isolationScope = invocationContext.isolationScope;
       invocationContext.session.events.push(compactedEvent);
     } catch (error) {
       console.error("Compaction failed:", error);
@@ -93,7 +99,9 @@ class AgentControlledContextCompactor {
     delete invocationContext.session.state["temp:consolidate_context"];
     delete invocationContext.session.state["temp:consolidate_context_detail"];
   }
-}
+};
+__name(_AgentControlledContextCompactor, "AgentControlledContextCompactor");
+let AgentControlledContextCompactor = _AgentControlledContextCompactor;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentControlledContextCompactor

package/dist/cjs/context/anchored_context_compactor.js

@@ -9,6 +9,7 @@ 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 });
@@ -35,32 +36,38 @@ var import_compaction_utils = require("./compaction_utils.js");
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class AnchoredContextCompactor {
+const _AnchoredContextCompactor = class _AnchoredContextCompactor {
   constructor(options) {
     this.tokenThreshold = options.tokenThreshold;
     this.eventRetentionSize = options.eventRetentionSize;
     this.summarizer = options.summarizer;
   }
-  getActiveEvents(events) {
+  getActiveEvents(events, currentIsolationScope) {
+    const visibleEvents = events.filter(
+      (event) => (0, import_compaction_utils.isEventVisibleInIsolationScope)(event, currentIsolationScope)
+    );
     let latestScratchpad = void 0;
-    for (let i = events.length - 1; i >= 0; i--) {
-      const e = events[i];
+    for (let i = visibleEvents.length - 1; i >= 0; i--) {
+      const e = visibleEvents[i];
       if ((0, import_compacted_event.isScratchpadEvent)(e)) {
         latestScratchpad = e;
         break;
       }
     }
     if (!latestScratchpad) {
-      return events;
+      return visibleEvents;
     }
-    const activeRawEvents = events.filter(
+    const activeRawEvents = visibleEvents.filter(
       (e) => e.timestamp > latestScratchpad.endTime && !(0, import_compacted_event.isScratchpadEvent)(e)
     );
     return [latestScratchpad, ...activeRawEvents];
   }
   shouldCompact(invocationContext) {
     const events = invocationContext.session.events;
-    const activeEvents = this.getActiveEvents(events);
+    const activeEvents = this.getActiveEvents(
+      events,
+      invocationContext.isolationScope
+    );
     const hasScratchpad = activeEvents.length > 0 && (0, import_compacted_event.isScratchpadEvent)(activeEvents[0]);
     const rawEvents = hasScratchpad ? activeEvents.slice(1) : activeEvents;
     if (rawEvents.length <= this.eventRetentionSize) {
@@ -81,7 +88,10 @@ class AnchoredContextCompactor {
   }
   async compact(invocationContext) {
     const events = invocationContext.session.events;
-    const activeEvents = this.getActiveEvents(events);
+    const activeEvents = this.getActiveEvents(
+      events,
+      invocationContext.isolationScope
+    );
     const hasScratchpad = activeEvents.length > 0 && (0, import_compacted_event.isScratchpadEvent)(activeEvents[0]);
     const rawEvents = hasScratchpad ? activeEvents.slice(1) : activeEvents;
     if (rawEvents.length <= this.eventRetentionSize) {
@@ -96,10 +106,11 @@ class AnchoredContextCompactor {
     }
     const rawEventsToCompact = rawEvents.slice(0, retainStartIndex);
     let scratchpadEvent;
-    if (hasScratchpad) {
-      const existingScratchpad = activeEvents[0];
+    const existingScratchpad = hasScratchpad ? activeEvents[0] : void 0;
+    const reusableScratchpad = existingScratchpad && (existingScratchpad.isolationScope === void 0 || existingScratchpad.isolationScope === invocationContext.isolationScope) ? existingScratchpad : void 0;
+    if (reusableScratchpad) {
       scratchpadEvent = await this.summarizer.summarize([
-        existingScratchpad,
+        reusableScratchpad,
         ...rawEventsToCompact
       ]);
     } else {
@@ -108,19 +119,34 @@ class AnchoredContextCompactor {
     const updatedScratchpad = {
       ...scratchpadEvent,
       isScratchpad: true,
-      author: "system"
+      author: "system",
+      ...invocationContext.isolationScope === void 0 ? {} : { isolationScope: invocationContext.isolationScope }
     };
-    const inactiveEvents = events.slice(0, events.indexOf(activeEvents[0]));
-    const retainedRawEvents = rawEvents.slice(retainStartIndex);
-    const newEventsList = [
-      ...inactiveEvents,
-      updatedScratchpad,
-      ...retainedRawEvents
-    ];
+    const shouldReplaceEvent = /* @__PURE__ */ __name((event) => invocationContext.isolationScope === void 0 || event.isolationScope === invocationContext.isolationScope, "shouldReplaceEvent");
+    const replacedEvents = /* @__PURE__ */ new Set([
+      ...reusableScratchpad && shouldReplaceEvent(reusableScratchpad) ? [reusableScratchpad] : [],
+      ...rawEventsToCompact.filter(shouldReplaceEvent)
+    ]);
+    const firstReplacedIndex = events.findIndex(
+      (event) => replacedEvents.has(event)
+    );
+    const newEventsList = [];
+    let insertedScratchpad = false;
+    for (let index = 0; index < events.length; index++) {
+      const event = events[index];
+      if (index === firstReplacedIndex) {
+        newEventsList.push(updatedScratchpad);
+        insertedScratchpad = true;
+      }
+      if (!replacedEvents.has(event)) newEventsList.push(event);
+    }
+    if (!insertedScratchpad) newEventsList.push(updatedScratchpad);
     events.length = 0;
     events.push(...newEventsList);
   }
-}
+};
+__name(_AnchoredContextCompactor, "AnchoredContextCompactor");
+let AnchoredContextCompactor = _AnchoredContextCompactor;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnchoredContextCompactor

package/dist/cjs/context/compaction_utils.js

@@ -9,6 +9,7 @@ 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 });
@@ -25,7 +26,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var compaction_utils_exports = {};
 __export(compaction_utils_exports, {
   calculateRetainStartIndex: () => calculateRetainStartIndex,
-  getActiveEvents: () => getActiveEvents
+  getActiveEvents: () => getActiveEvents,
+  isEventVisibleInIsolationScope: () => isEventVisibleInIsolationScope
 });
 module.exports = __toCommonJS(compaction_utils_exports);
 var import_compacted_event = require("../events/compacted_event.js");
@@ -35,15 +37,23 @@ var import_event = require("../events/event.js");
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-function getActiveEvents(events) {
-  const latest = events.filter(import_compacted_event.isCompactedEvent).pop();
+function getActiveEvents(events, currentIsolationScope) {
+  const visibleEvents = events.filter(
+    (event) => isEventVisibleInIsolationScope(event, currentIsolationScope)
+  );
+  const latest = visibleEvents.filter(import_compacted_event.isCompactedEvent).pop();
   return latest ? [
     latest,
-    ...events.filter(
+    ...visibleEvents.filter(
       (e) => !(0, import_compacted_event.isCompactedEvent)(e) && e.timestamp > latest.endTime
     )
-  ] : events;
+  ] : visibleEvents;
 }
+__name(getActiveEvents, "getActiveEvents");
+function isEventVisibleInIsolationScope(event, currentIsolationScope) {
+  return event.isolationScope === void 0 || event.isolationScope === currentIsolationScope;
+}
+__name(isEventVisibleInIsolationScope, "isEventVisibleInIsolationScope");
 function calculateRetainStartIndex(rawEvents, eventRetentionSize) {
   let retainStartIndex = Math.max(0, rawEvents.length - eventRetentionSize);
   while (retainStartIndex > 0) {
@@ -57,8 +67,10 @@ function calculateRetainStartIndex(rawEvents, eventRetentionSize) {
   }
   return retainStartIndex;
 }
+__name(calculateRetainStartIndex, "calculateRetainStartIndex");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   calculateRetainStartIndex,
-  getActiveEvents
+  getActiveEvents,
+  isEventVisibleInIsolationScope
 });

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

@@ -9,6 +9,7 @@ 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 });
@@ -35,7 +36,7 @@ var import_event = require("../../events/event.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 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.";
-class LlmSummarizer {
+const _LlmSummarizer = class _LlmSummarizer {
   /**
    * @param options - Configuration specifying the LLM and optional prompt.
    */
@@ -97,7 +98,9 @@ ${formattedEvents}`;
       compactedContent
     });
   }
-}
+};
+__name(_LlmSummarizer, "LlmSummarizer");
+let LlmSummarizer = _LlmSummarizer;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LlmSummarizer

package/dist/cjs/context/token_based_context_compactor.js

@@ -9,6 +9,7 @@ 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 });
@@ -27,6 +28,7 @@ __export(token_based_context_compactor_exports, {
   TokenBasedContextCompactor: () => TokenBasedContextCompactor
 });
 module.exports = __toCommonJS(token_based_context_compactor_exports);
+var import_invocation_context = require("../agents/invocation_context.js");
 var import_content_processor_utils = require("../agents/processors/content_processor_utils.js");
 var import_compacted_event = require("../events/compacted_event.js");
 var import_compaction_utils = require("./compaction_utils.js");
@@ -36,7 +38,7 @@ var import_compaction_utils = require("./compaction_utils.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 const CHARS_PER_TOKEN = 4;
-class TokenBasedContextCompactor {
+const _TokenBasedContextCompactor = class _TokenBasedContextCompactor {
   constructor(options) {
     this.tokenThreshold = options.tokenThreshold;
     this.eventRetentionSize = options.eventRetentionSize;
@@ -44,7 +46,10 @@ class TokenBasedContextCompactor {
   }
   shouldCompact(invocationContext) {
     const events = invocationContext.session.events;
-    const activeEvents = (0, import_compaction_utils.getActiveEvents)(events);
+    const activeEvents = (0, import_compaction_utils.getActiveEvents)(
+      events,
+      invocationContext.isolationScope
+    );
     const rawEvents = activeEvents.filter((e) => !(0, import_compacted_event.isCompactedEvent)(e));
     if (rawEvents.length <= this.eventRetentionSize) {
       return false;
@@ -66,8 +71,12 @@ class TokenBasedContextCompactor {
     return promptTokenCount > this.tokenThreshold;
   }
   async compact(invocationContext) {
+    var _a;
     const events = invocationContext.session.events;
-    const activeEvents = (0, import_compaction_utils.getActiveEvents)(events);
+    const activeEvents = (0, import_compaction_utils.getActiveEvents)(
+      events,
+      invocationContext.isolationScope
+    );
     const rawEvents = activeEvents.filter((e) => !(0, import_compacted_event.isCompactedEvent)(e));
     if (rawEvents.length <= this.eventRetentionSize) {
       return;
@@ -91,9 +100,12 @@ class TokenBasedContextCompactor {
         requestedToolConfirmations: {}
       };
     }
+    (_a = compactedEvent.isolationScope) != null ? _a : compactedEvent.isolationScope = invocationContext.isolationScope;
     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--) {
@@ -104,11 +116,12 @@ function latestPromptTokenCount(activeEvents, invocationContext) {
   }
   return estimatePromptTokenCount(activeEvents, invocationContext);
 }
+__name(latestPromptTokenCount, "latestPromptTokenCount");
 function estimatePromptTokenCount(activeEvents, invocationContext) {
   var _a;
   const contents = (0, import_content_processor_utils.getContents)(
     activeEvents,
-    invocationContext.agent.name,
+    (0, import_invocation_context.requireAgent)(invocationContext).name,
     invocationContext.branch
   );
   let totalChars = 0;
@@ -130,6 +143,7 @@ function estimatePromptTokenCount(activeEvents, invocationContext) {
   }
   return Math.ceil(totalChars / CHARS_PER_TOKEN);
 }
+__name(estimatePromptTokenCount, "estimatePromptTokenCount");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TokenBasedContextCompactor

package/dist/cjs/context/trajectory_thought_pruning_compactor.js

@@ -9,6 +9,7 @@ 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 });
@@ -28,12 +29,13 @@ __export(trajectory_thought_pruning_compactor_exports, {
 });
 module.exports = __toCommonJS(trajectory_thought_pruning_compactor_exports);
 var import_event = require("../events/event.js");
+var import_compaction_utils = require("./compaction_utils.js");
 /**
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class TrajectoryThoughtPruningCompactor {
+const _TrajectoryThoughtPruningCompactor = class _TrajectoryThoughtPruningCompactor {
   constructor(options) {
     if (options.eventRetentionSize < 0) {
       throw new Error("eventRetentionSize must be a non-negative integer.");
@@ -42,29 +44,37 @@ class TrajectoryThoughtPruningCompactor {
   }
   shouldCompact(invocationContext) {
     const events = invocationContext.session.events;
-    if (events.length <= this.eventRetentionSize) {
+    const visibleIndices = events.flatMap(
+      (event, index) => (0, import_compaction_utils.isEventVisibleInIsolationScope)(event, invocationContext.isolationScope) ? [index] : []
+    );
+    if (visibleIndices.length <= this.eventRetentionSize) {
       return false;
     }
-    const olderEvents = events.slice(
-      0,
-      events.length - this.eventRetentionSize
-    );
+    const olderEvents = visibleIndices.slice(0, visibleIndices.length - this.eventRetentionSize).map((index) => events[index]);
     return olderEvents.some((event) => (0, import_event.hasThoughts)(event));
   }
   compact(invocationContext) {
     const events = invocationContext.session.events;
-    if (events.length <= this.eventRetentionSize) {
+    const visibleIndices = events.flatMap(
+      (event, index) => (0, import_compaction_utils.isEventVisibleInIsolationScope)(event, invocationContext.isolationScope) ? [index] : []
+    );
+    if (visibleIndices.length <= this.eventRetentionSize) {
       return;
     }
-    const pruneLimit = events.length - this.eventRetentionSize;
-    for (let i = 0; i < pruneLimit; i++) {
-      const event = events[i];
+    const pruneIndices = visibleIndices.slice(
+      0,
+      visibleIndices.length - this.eventRetentionSize
+    );
+    for (const index of pruneIndices) {
+      const event = events[index];
       if ((0, import_event.hasThoughts)(event)) {
-        events[i] = (0, import_event.pruneThoughts)(event);
+        events[index] = (0, import_event.pruneThoughts)(event);
       }
     }
   }
-}
+};
+__name(_TrajectoryThoughtPruningCompactor, "TrajectoryThoughtPruningCompactor");
+let TrajectoryThoughtPruningCompactor = _TrajectoryThoughtPruningCompactor;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TrajectoryThoughtPruningCompactor

package/dist/cjs/context/truncating_context_compactor.js

@@ -9,6 +9,7 @@ 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 });
@@ -27,31 +28,45 @@ __export(truncating_context_compactor_exports, {
   TruncatingContextCompactor: () => TruncatingContextCompactor
 });
 module.exports = __toCommonJS(truncating_context_compactor_exports);
+var import_compaction_utils = require("./compaction_utils.js");
 /**
  * @license
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class TruncatingContextCompactor {
+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);
+    const visibleEventsLength = invocationContext.session.events.filter(
+      (event) => (0, import_compaction_utils.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) => (0, import_compaction_utils.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");
+let TruncatingContextCompactor = _TruncatingContextCompactor;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TruncatingContextCompactor

package/dist/cjs/environment/base_environment.js

@@ -0,0 +1,97 @@
+/**
+  * @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 __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;
+};
+var base_environment_exports = {};
+__export(base_environment_exports, {
+  BaseEnvironment: () => BaseEnvironment
+});
+module.exports = __toCommonJS(base_environment_exports);
+var import_experimental = require("../utils/experimental.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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([
+  import_experimental.experimental
+], BaseEnvironment);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseEnvironment
+});