@google/adk 1.6.0 → 2.1.0

package/dist/esm/utils/ssrf_guard.js

@@ -0,0 +1,230 @@
+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 { lookup } from "node:dns/promises";
+import { isIP } from "node:net";
+const HTTP_SCHEMES = /* @__PURE__ */ new Set(["http:", "https:"]);
+const NON_GLOBAL_IPV4_CIDRS = [
+  "0.0.0.0/8",
+  // "this host on this network"
+  "10.0.0.0/8",
+  // private
+  "100.64.0.0/10",
+  // shared address space / CGNAT
+  "127.0.0.0/8",
+  // loopback
+  "169.254.0.0/16",
+  // link-local (includes GCP metadata 169.254.169.254)
+  "172.16.0.0/12",
+  // private
+  "192.0.0.0/24",
+  // IETF protocol assignments
+  "192.0.2.0/24",
+  // TEST-NET-1 (documentation)
+  "192.88.99.0/24",
+  // 6to4 relay anycast (deprecated)
+  "192.168.0.0/16",
+  // private
+  "198.18.0.0/15",
+  // benchmarking
+  "198.51.100.0/24",
+  // TEST-NET-2 (documentation)
+  "203.0.113.0/24",
+  // TEST-NET-3 (documentation)
+  "224.0.0.0/4",
+  // multicast
+  "240.0.0.0/4"
+  // reserved / future use (includes 255.255.255.255)
+].map(parseIpv4Cidr);
+const NON_GLOBAL_IPV6_CIDRS = [
+  "::/128",
+  // unspecified
+  "::1/128",
+  // loopback
+  "64:ff9b:1::/48",
+  // local NAT64
+  "100::/64",
+  // discard-only
+  "2001:db8::/32",
+  // documentation
+  "fc00::/7",
+  // unique-local (ULA, private)
+  "fe80::/10",
+  // link-local
+  "ff00::/8"
+  // multicast
+].map(parseIpv6Cidr);
+const LINK_LOCAL_IPV4_CIDR = parseIpv4Cidr("169.254.0.0/16");
+const LINK_LOCAL_IPV6_CIDR = parseIpv6Cidr("fe80::/10");
+const IPV4_MAPPED_CIDR = parseIpv6Cidr("::ffff:0:0/96");
+const NAT64_CIDR = parseIpv6Cidr("64:ff9b::/96");
+const SIX_TO_FOUR_CIDR = parseIpv6Cidr("2002::/16");
+const IPV4_COMPATIBLE_CIDR = parseIpv6Cidr("::/96");
+function isHttpUrl(url) {
+  return HTTP_SCHEMES.has(url.protocol);
+}
+__name(isHttpUrl, "isHttpUrl");
+function isLocalhostHostname(hostname) {
+  const normalized = hostname.replace(/\.+$/, "").toLowerCase();
+  return normalized === "localhost" || normalized.endsWith(".localhost");
+}
+__name(isLocalhostHostname, "isLocalhostHostname");
+function normalizeHost(hostname) {
+  return hostname.startsWith("[") ? hostname.slice(1, -1) : hostname;
+}
+__name(normalizeHost, "normalizeHost");
+function isNonGlobalAddress(address) {
+  return classifyAddress(address, isNonGlobalIpv4, isNonGlobalIpv6);
+}
+__name(isNonGlobalAddress, "isNonGlobalAddress");
+function isLinkLocalAddress(address) {
+  return classifyAddress(address, isLinkLocalIpv4, isLinkLocalIpv6);
+}
+__name(isLinkLocalAddress, "isLinkLocalAddress");
+async function resolveHostAddresses(hostname) {
+  if (isIP(hostname) !== 0) {
+    return [hostname];
+  }
+  const records = await lookup(hostname, { all: true });
+  const addresses = [...new Set(records.map((record) => record.address))];
+  if (addresses.length === 0) {
+    throw new Error(`Unable to resolve host: ${hostname}`);
+  }
+  return addresses;
+}
+__name(resolveHostAddresses, "resolveHostAddresses");
+function classifyAddress(address, matchesIpv4, matchesIpv6) {
+  const octets = parseIpv4(address);
+  if (octets) {
+    return matchesIpv4(octets);
+  }
+  const hextets = parseIpv6(address);
+  if (hextets) {
+    return matchesIpv6(hextets);
+  }
+  return true;
+}
+__name(classifyAddress, "classifyAddress");
+function parseIpv4(address) {
+  const match = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(address);
+  if (!match) {
+    return null;
+  }
+  const octets = match.slice(1).map(Number);
+  if (octets.some((octet) => octet > 255)) {
+    return null;
+  }
+  return octets;
+}
+__name(parseIpv4, "parseIpv4");
+function parseIpv6(address) {
+  if (isIP(address) !== 6) {
+    return null;
+  }
+  const [head, tail] = address.split("::");
+  const highGroups = head ? expandHextets(head) : [];
+  const lowGroups = tail ? expandHextets(tail) : [];
+  const compressed = address.includes("::") ? new Array(8 - highGroups.length - lowGroups.length).fill(0) : [];
+  return [...highGroups, ...compressed, ...lowGroups];
+}
+__name(parseIpv6, "parseIpv6");
+function expandHextets(fragment) {
+  const hextets = [];
+  for (const group of fragment.split(":")) {
+    if (group.includes(".")) {
+      const octets = parseIpv4(group);
+      hextets.push(octets[0] << 8 | octets[1], octets[2] << 8 | octets[3]);
+    } else {
+      hextets.push(parseInt(group, 16));
+    }
+  }
+  return hextets;
+}
+__name(expandHextets, "expandHextets");
+function ipv4ToInt(octets) {
+  return (octets[0] << 24 | octets[1] << 16 | octets[2] << 8 | octets[3]) >>> 0;
+}
+__name(ipv4ToInt, "ipv4ToInt");
+function hextetsToBigInt(hextets) {
+  let value = 0n;
+  for (const hextet of hextets) {
+    value = value << 16n | BigInt(hextet);
+  }
+  return value;
+}
+__name(hextetsToBigInt, "hextetsToBigInt");
+function parseIpv4Cidr(cidr) {
+  const [address, prefix] = cidr.split("/");
+  const mask = 4294967295 << 32 - Number(prefix) >>> 0;
+  return { base: (ipv4ToInt(parseIpv4(address)) & mask) >>> 0, mask };
+}
+__name(parseIpv4Cidr, "parseIpv4Cidr");
+function parseIpv6Cidr(cidr) {
+  const [address, prefix] = cidr.split("/");
+  return { base: hextetsToBigInt(parseIpv6(address)), prefix: Number(prefix) };
+}
+__name(parseIpv6Cidr, "parseIpv6Cidr");
+function matchesIpv4Cidr(octets, { base, mask }) {
+  return (ipv4ToInt(octets) & mask) >>> 0 === base;
+}
+__name(matchesIpv4Cidr, "matchesIpv4Cidr");
+function matchesIpv6Cidr(hextets, { base, prefix }) {
+  const shift = BigInt(128 - prefix);
+  return hextetsToBigInt(hextets) >> shift === base >> shift;
+}
+__name(matchesIpv6Cidr, "matchesIpv6Cidr");
+function embeddedIpv4(hextets) {
+  if (matchesIpv6Cidr(hextets, SIX_TO_FOUR_CIDR)) {
+    return hextetsToOctets(hextets[1], hextets[2]);
+  }
+  if (matchesIpv6Cidr(hextets, IPV4_MAPPED_CIDR) || matchesIpv6Cidr(hextets, NAT64_CIDR)) {
+    return hextetsToOctets(hextets[6], hextets[7]);
+  }
+  if (matchesIpv6Cidr(hextets, IPV4_COMPATIBLE_CIDR) && (hextets[6] !== 0 || hextets[7] > 1)) {
+    return hextetsToOctets(hextets[6], hextets[7]);
+  }
+  return null;
+}
+__name(embeddedIpv4, "embeddedIpv4");
+function hextetsToOctets(high, low) {
+  return [high >> 8, high & 255, low >> 8, low & 255];
+}
+__name(hextetsToOctets, "hextetsToOctets");
+function isNonGlobalIpv4(octets) {
+  return NON_GLOBAL_IPV4_CIDRS.some((cidr) => matchesIpv4Cidr(octets, cidr));
+}
+__name(isNonGlobalIpv4, "isNonGlobalIpv4");
+function isNonGlobalIpv6(hextets) {
+  const embedded = embeddedIpv4(hextets);
+  if (embedded) {
+    return isNonGlobalIpv4(embedded);
+  }
+  return NON_GLOBAL_IPV6_CIDRS.some((cidr) => matchesIpv6Cidr(hextets, cidr));
+}
+__name(isNonGlobalIpv6, "isNonGlobalIpv6");
+function isLinkLocalIpv4(octets) {
+  return matchesIpv4Cidr(octets, LINK_LOCAL_IPV4_CIDR);
+}
+__name(isLinkLocalIpv4, "isLinkLocalIpv4");
+function isLinkLocalIpv6(hextets) {
+  const embedded = embeddedIpv4(hextets);
+  if (embedded) {
+    return isLinkLocalIpv4(embedded);
+  }
+  return matchesIpv6Cidr(hextets, LINK_LOCAL_IPV6_CIDR);
+}
+__name(isLinkLocalIpv6, "isLinkLocalIpv6");
+export {
+  isHttpUrl,
+  isLinkLocalAddress,
+  isLocalhostHostname,
+  isNonGlobalAddress,
+  normalizeHost,
+  resolveHostAddresses
+};

package/dist/esm/utils/streaming_utils.js

@@ -1,5 +1,7 @@
 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
@@ -13,7 +15,7 @@ import { generateClientFunctionCallId } from "../events/event.js";
 import { FeatureName, isFeatureEnabled } from "../features/feature_registry.js";
 import { createLlmResponse } from "../models/llm_response.js";
 const UNSAFE_PROPERTY_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
-class ProgressiveStrategy {
+const _ProgressiveStrategy = class _ProgressiveStrategy {
   constructor() {
     this.partsSequence = [];
     this.currentTextBuffer = "";
@@ -195,8 +197,10 @@ class ProgressiveStrategy {
     }
     return finalParts;
   }
-}
-class NonProgressiveStrategy {
+};
+__name(_ProgressiveStrategy, "ProgressiveStrategy");
+let ProgressiveStrategy = _ProgressiveStrategy;
+const _NonProgressiveStrategy = class _NonProgressiveStrategy {
   constructor() {
     this.text = "";
     this.thoughtText = "";
@@ -270,8 +274,10 @@ class NonProgressiveStrategy {
     }
     return void 0;
   }
-}
-class StreamingResponseAggregator {
+};
+__name(_NonProgressiveStrategy, "NonProgressiveStrategy");
+let NonProgressiveStrategy = _NonProgressiveStrategy;
+const _StreamingResponseAggregator = class _StreamingResponseAggregator {
   constructor(isProgressiveMode = isFeatureEnabled(
     FeatureName.PROGRESSIVE_SSE_STREAMING
   )) {
@@ -349,10 +355,13 @@ class StreamingResponseAggregator {
       partial: false
     };
   }
-}
+};
+__name(_StreamingResponseAggregator, "StreamingResponseAggregator");
+let StreamingResponseAggregator = _StreamingResponseAggregator;
 function isEmptyContentPart(part) {
   return !part.functionCall && !part.functionResponse && !part.fileData && !part.inlineData && !part.executableCode && !part.codeExecutionResult && (!part.text || part.text === "");
 }
+__name(isEmptyContentPart, "isEmptyContentPart");
 export {
   StreamingResponseAggregator,
   isEmptyContentPart

package/dist/esm/utils/task.js

@@ -1,18 +1,20 @@
 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
  */
-class Task {
+const _Task = class _Task {
   constructor(executable) {
     this.executable = executable;
     this.isDone = false;
     this.abortController = new AbortController();
-    const markDone = () => {
+    const markDone = /* @__PURE__ */ __name(() => {
       this.isDone = true;
-    };
+    }, "markDone");
     this.promise = executable(this.abortController.signal);
     this.promise.then(markDone).catch(markDone);
   }
@@ -28,7 +30,9 @@ class Task {
   done() {
     return this.isDone;
   }
-}
+};
+__name(_Task, "Task");
+let Task = _Task;
 export {
   Task
 };

package/dist/esm/utils/variant_utils.js

@@ -1,19 +1,22 @@
 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 { getBooleanEnvVar } from "./env_aware_utils.js";
+import { isEnterpriseModeEnabled } from "./env_aware_utils.js";
 var GoogleLLMVariant = /* @__PURE__ */ ((GoogleLLMVariant2) => {
   GoogleLLMVariant2["VERTEX_AI"] = "VERTEX_AI";
   GoogleLLMVariant2["GEMINI_API"] = "GEMINI_API";
   return GoogleLLMVariant2;
 })(GoogleLLMVariant || {});
 function getGoogleLlmVariant() {
-  return getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI") ? "VERTEX_AI" /* VERTEX_AI */ : "GEMINI_API" /* GEMINI_API */;
+  return isEnterpriseModeEnabled() ? "VERTEX_AI" /* VERTEX_AI */ : "GEMINI_API" /* GEMINI_API */;
 }
+__name(getGoogleLlmVariant, "getGoogleLlmVariant");
 export {
   GoogleLLMVariant,
   getGoogleLlmVariant

package/dist/esm/utils/vertex_ai_utils.js

@@ -1,11 +1,13 @@
 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 { getBooleanEnvVar } from "./env_aware_utils.js";
+import { isEnterpriseModeEnabled } from "./env_aware_utils.js";
 const EXPRESS_MODE_UNSUPPORTED_MESSAGE = "Vertex AI Express Mode (expressModeApiKey / GOOGLE_API_KEY) is not supported: the @google-cloud/vertexai Agent Engine client cannot send an API key. Provide projectId and location (with Application Default Credentials), or inject a preconfigured client.";
 function getExpressModeApiKey(project, location, expressModeApiKey) {
   if ((project || location) && expressModeApiKey) {
@@ -13,11 +15,12 @@ function getExpressModeApiKey(project, location, expressModeApiKey) {
       "Cannot specify project or location and expressModeApiKey. Either use project and location, or just the expressModeApiKey."
     );
   }
-  if (getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI")) {
+  if (isEnterpriseModeEnabled()) {
     return expressModeApiKey || process.env.GOOGLE_API_KEY;
   }
   return void 0;
 }
+__name(getExpressModeApiKey, "getExpressModeApiKey");
 export {
   EXPRESS_MODE_UNSUPPORTED_MESSAGE,
   getExpressModeApiKey

package/dist/esm/version.js

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

package/dist/esm/workflow/base_node.js

@@ -0,0 +1,182 @@
+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 _a;
+import { createModelContent } from "@google/genai";
+import { createEvent, isEvent } from "../events/event.js";
+import { parseWithSchema } from "../utils/schema.js";
+import { NodeSchemaValidationError } from "./errors.js";
+import { isRequestInput } from "./request_input.js";
+import {
+  prepareRetryConfig
+} from "./retry_config.js";
+import { createRequestInputEvent } from "./utils/hitl_utils.js";
+const BASE_NODE_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.workflow.baseNode");
+_a = BASE_NODE_SIGNATURE_SYMBOL;
+const _BaseNode = class _BaseNode {
+  constructor(config) {
+    /** Brand identifying this object as a {@link BaseNode} (see `isBaseNode`). */
+    this[_a] = true;
+    var _a2, _b, _c;
+    if (!config.name || typeof config.name !== "string" || config.name.trim().length === 0) {
+      throw new Error("Node name must be a non-empty string.");
+    }
+    this.name = config.name.trim();
+    this.description = (_a2 = config.description) != null ? _a2 : "";
+    this.rerunOnResume = (_b = config.rerunOnResume) != null ? _b : false;
+    this.waitForOutput = (_c = config.waitForOutput) != null ? _c : false;
+    this.retryConfig = config.retryConfig;
+    this.preparedRetryConfig = config.retryConfig ? prepareRetryConfig(config.retryConfig) : void 0;
+    this.timeout = config.timeout;
+    this.inputSchema = config.inputSchema;
+    this.outputSchema = config.outputSchema;
+    this.stateSchema = config.stateSchema;
+    this.isolationScope = config.isolationScope;
+  }
+  /**
+   * Whether this node must wait for ALL of its predecessors to trigger before
+   * it runs (fan-in barrier). Overridden by `JoinNode`.
+   */
+  get requiresAllPredecessors() {
+    return false;
+  }
+  /**
+   * Runs the node, normalizing every yielded item into an {@link Event}. This
+   * is what the engine (and `ctx.runNode()`) consumes. Validates the input
+   * against `inputSchema` once, up front (skipping genai `Content`, which nodes
+   * coerce themselves).
+   */
+  async *run(ctx, input) {
+    const validatedInput = this.validateInput(input);
+    for await (const item of this.runImpl(ctx, validatedInput)) {
+      if (isRequestInput(item)) {
+        yield createRequestInputEvent(item);
+        continue;
+      }
+      const event = this.toEvent(ctx, item);
+      if (event) {
+        yield event;
+      }
+    }
+  }
+  /**
+   * Validates node input against `inputSchema` (Content passes through). Only
+   * enforced for Zod schemas; a genai `Schema` is left unvalidated (see
+   * `parseWithSchema`).
+   */
+  validateInput(input) {
+    if (isContent(input)) {
+      return input;
+    }
+    try {
+      return parseWithSchema(this.inputSchema, input);
+    } catch (e) {
+      throw new NodeSchemaValidationError({
+        nodeName: this.name,
+        direction: "input",
+        cause: e
+      });
+    }
+  }
+  /**
+   * Validates node output against `outputSchema` (Content passes through). Only
+   * enforced for Zod schemas; a genai `Schema` is left unvalidated (see
+   * `parseWithSchema`).
+   */
+  validateOutput(output) {
+    if (isContent(output)) {
+      return output;
+    }
+    try {
+      return parseWithSchema(this.outputSchema, output);
+    } catch (e) {
+      throw new NodeSchemaValidationError({
+        nodeName: this.name,
+        direction: "output",
+        cause: e
+      });
+    }
+  }
+  /**
+   * Normalizes a single yielded item into an {@link Event} (or `null` to skip).
+   * Subclasses may override for richer coercion (e.g. `FunctionNode`).
+   */
+  toEvent(ctx, data) {
+    if (data === null || data === void 0) {
+      return null;
+    }
+    if (isEvent(data)) {
+      const event = data;
+      if (event.output !== void 0) {
+        event.output = this.validateOutput(event.output);
+      }
+      return event;
+    }
+    const output = this.validateOutput(data);
+    return createEvent({
+      author: this.name,
+      invocationId: ctx.invocationContext.invocationId,
+      branch: ctx.branch,
+      content: toContent(output),
+      output
+    });
+  }
+};
+__name(_BaseNode, "BaseNode");
+let BaseNode = _BaseNode;
+function isBaseNode(value) {
+  return typeof value === "object" && value !== null && BASE_NODE_SIGNATURE_SYMBOL in value && value[BASE_NODE_SIGNATURE_SYMBOL] === true;
+}
+__name(isBaseNode, "isBaseNode");
+function isContent(value) {
+  return typeof value === "object" && value !== null && "parts" in value && Array.isArray(value.parts);
+}
+__name(isContent, "isContent");
+const _StartNode = class _StartNode extends BaseNode {
+  // eslint-disable-next-line require-yield
+  async *runImpl() {
+    throw new Error("START node is never executed.");
+  }
+};
+__name(_StartNode, "StartNode");
+let StartNode = _StartNode;
+const START = new StartNode({ name: "__START__" });
+function toContent(val) {
+  if (val === null || val === void 0) {
+    return void 0;
+  }
+  if (isContent(val)) {
+    return val;
+  }
+  try {
+    return createModelContent(val);
+  } catch {
+    return createModelContent(valueToText(val));
+  }
+}
+__name(toContent, "toContent");
+function valueToText(val) {
+  var _a2;
+  if (typeof val === "string") {
+    return val;
+  }
+  try {
+    return (_a2 = JSON.stringify(val)) != null ? _a2 : String(val);
+  } catch {
+    return String(val);
+  }
+}
+__name(valueToText, "valueToText");
+export {
+  BaseNode,
+  START,
+  isBaseNode,
+  isContent,
+  toContent
+};

package/dist/esm/workflow/branch_path.js

@@ -0,0 +1,77 @@
+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 _BranchPath = class _BranchPath {
+  constructor(segments) {
+    this.segments = [...segments];
+  }
+  toString() {
+    return this.segments.join(".");
+  }
+  /** Returns a copy of the path segments. */
+  getSegments() {
+    return [...this.segments];
+  }
+  /** Whether this path is a strict descendant of `ancestor`. */
+  isDescendantOf(ancestor) {
+    if (this.segments.length <= ancestor.segments.length) {
+      return false;
+    }
+    return ancestor.segments.every((seg, i) => this.segments[i] === seg);
+  }
+  /** Returns a new path with a `name@runId` (or `name`) segment appended. */
+  append(name, runId) {
+    const segment = runId !== void 0 ? `${name}@${runId}` : name;
+    return new _BranchPath([...this.segments, segment]);
+  }
+};
+__name(_BranchPath, "BranchPath");
+let BranchPath = _BranchPath;
+function branchPathFromString(path) {
+  if (!path) {
+    return new BranchPath([]);
+  }
+  return new BranchPath(path.split("."));
+}
+__name(branchPathFromString, "branchPathFromString");
+function commonPrefixOfPaths(paths) {
+  if (paths.length === 0) {
+    return new BranchPath([]);
+  }
+  const allSegments = paths.map((p) => p.getSegments());
+  const common = [];
+  const minLen = Math.min(...allSegments.map((s) => s.length));
+  for (let i = 0; i < minLen; i++) {
+    const seg = allSegments[0][i];
+    if (allSegments.every((s) => s[i] === seg)) {
+      common.push(seg);
+    } else {
+      break;
+    }
+  }
+  return new BranchPath(common);
+}
+__name(commonPrefixOfPaths, "commonPrefixOfPaths");
+function createSubBranch(baseBranch, options) {
+  return branchPathFromString(baseBranch).append(options.name, options.runId).toString();
+}
+__name(createSubBranch, "createSubBranch");
+function commonPrefixOf(branches) {
+  return commonPrefixOfPaths(
+    branches.map((b) => branchPathFromString(b))
+  ).toString();
+}
+__name(commonPrefixOf, "commonPrefixOf");
+export {
+  BranchPath,
+  branchPathFromString,
+  commonPrefixOf,
+  commonPrefixOfPaths,
+  createSubBranch
+};