@google/adk 2.4.0 → 2.5.0

package/dist/cjs/telemetry/api/internal/trace/inference.js

@@ -0,0 +1,132 @@
+/**
+  * @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 inference_exports = {};
+__export(inference_exports, {
+  buildResponseAttributes: () => buildResponseAttributes,
+  setInferenceOperationDetails: () => setInferenceOperationDetails,
+  setInferenceResponseAttributes: () => setInferenceResponseAttributes,
+  startInferenceSpan: () => startInferenceSpan
+});
+module.exports = __toCommonJS(inference_exports);
+var import_attributes = require("../common/attributes.js");
+var import_config = require("../common/config.js");
+var import_finish_reason = require("../common/finish_reason.js");
+var import_genai_messages = require("../common/genai_messages.js");
+var import_serialization = require("../common/serialization.js");
+var import_token_usage = require("../common/token_usage.js");
+var import_tracer = require("./tracer.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function startInferenceSpan({
+  llmRequest,
+  commonAttributes
+}) {
+  var _a, _b;
+  const config = llmRequest.config;
+  return (0, import_tracer.getTracer)().startSpan(
+    `generate_content ${(_a = llmRequest.model) != null ? _a : ""}`.trim(),
+    {
+      attributes: {
+        [import_attributes.GenAiAttr.OPERATION_NAME]: "generate_content",
+        [import_attributes.GenAiAttr.REQUEST_MODEL]: (_b = llmRequest.model) != null ? _b : "",
+        ...(config == null ? void 0 : config.topP) === void 0 ? {} : { [import_attributes.GenAiAttr.REQUEST_TOP_P]: config.topP },
+        ...(config == null ? void 0 : config.maxOutputTokens) === void 0 ? {} : { [import_attributes.GenAiAttr.REQUEST_MAX_TOKENS]: config.maxOutputTokens },
+        ...commonAttributes
+      }
+    }
+  );
+}
+__name(startInferenceSpan, "startInferenceSpan");
+function buildResponseAttributes(llmResponse) {
+  return {
+    ...(0, import_finish_reason.isReportedFinishReason)(llmResponse.finishReason) ? {
+      [import_attributes.GenAiAttr.RESPONSE_FINISH_REASONS]: [
+        String(llmResponse.finishReason).toLowerCase()
+      ]
+    } : {},
+    ...llmResponse.usageMetadata ? new import_token_usage.TokenUsage(llmResponse.usageMetadata).asAttributes() : {}
+  };
+}
+__name(buildResponseAttributes, "buildResponseAttributes");
+function groundingSourceUris(chunks) {
+  var _a, _b, _c;
+  const uris = /* @__PURE__ */ new Set();
+  for (const chunk of chunks) {
+    for (const uri of [
+      (_a = chunk.web) == null ? void 0 : _a.uri,
+      (_b = chunk.retrievedContext) == null ? void 0 : _b.uri,
+      (_c = chunk.maps) == null ? void 0 : _c.uri
+    ]) {
+      if (uri) {
+        uris.add(uri);
+      }
+    }
+  }
+  return [...uris];
+}
+__name(groundingSourceUris, "groundingSourceUris");
+function buildGroundingAttributes(groundingMetadata, captureContent) {
+  var _a, _b;
+  const queries = ((_a = groundingMetadata.webSearchQueries) != null ? _a : []).filter(Boolean);
+  const chunks = (_b = groundingMetadata.groundingChunks) != null ? _b : [];
+  const sourceUris = groundingSourceUris(chunks);
+  return {
+    [import_attributes.AdkAttr.EXPERIMENTAL_GROUNDING_QUERY_COUNT]: new Set(queries).size,
+    [import_attributes.AdkAttr.EXPERIMENTAL_GROUNDING_CHUNK_COUNT]: chunks.length,
+    ...captureContent && queries.length > 0 ? { [import_attributes.AdkAttr.EXPERIMENTAL_GROUNDING_WEB_SEARCH_QUERIES]: queries } : {},
+    ...captureContent && sourceUris.length > 0 ? { [import_attributes.AdkAttr.EXPERIMENTAL_GROUNDING_SOURCE_URIS]: sourceUris } : {}
+  };
+}
+__name(buildGroundingAttributes, "buildGroundingAttributes");
+function setInferenceResponseAttributes(span, llmResponse, config) {
+  span.setAttributes(buildResponseAttributes(llmResponse));
+  if (llmResponse.groundingMetadata && (0, import_config.isExperimentalFeatureEnabled)(config, "grounding")) {
+    span.setAttributes(
+      buildGroundingAttributes(
+        llmResponse.groundingMetadata,
+        (0, import_config.shouldAddContentToSpans)(config)
+      )
+    );
+  }
+}
+__name(setInferenceResponseAttributes, "setInferenceResponseAttributes");
+function setInferenceOperationDetails(span, details, config) {
+  const recorded = (0, import_config.shouldAddContentToSpans)(config) ? details : (0, import_genai_messages.withoutContent)(details);
+  for (const [key, value] of Object.entries(recorded)) {
+    span.setAttribute(key, (0, import_serialization.safeJsonSerialize)(value));
+  }
+}
+__name(setInferenceOperationDetails, "setInferenceOperationDetails");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildResponseAttributes,
+  setInferenceOperationDetails,
+  setInferenceResponseAttributes,
+  startInferenceSpan
+});

package/dist/cjs/telemetry/api/internal/trace/live.js

@@ -0,0 +1,52 @@
+/**
+  * @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 live_exports = {};
+__export(live_exports, {
+  setSendDataAttributes: () => setSendDataAttributes
+});
+module.exports = __toCommonJS(live_exports);
+var import_attributes = require("../common/attributes.js");
+var import_serialization = require("../common/serialization.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function setSendDataAttributes(span, { invocationContext, eventId, data }) {
+  span.setAttributes({
+    [import_attributes.GcpAttr.INVOCATION_ID]: invocationContext.invocationId,
+    [import_attributes.GcpAttr.EVENT_ID]: eventId
+  });
+  span.setAttribute(
+    import_attributes.GcpAttr.DATA,
+    (0, import_serialization.shouldAddRequestResponseToSpans)() ? (0, import_serialization.safeJsonSerialize)(data) : "{}"
+  );
+}
+__name(setSendDataAttributes, "setSendDataAttributes");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setSendDataAttributes
+});

package/dist/cjs/telemetry/api/internal/trace/node.js

@@ -0,0 +1,73 @@
+/**
+  * @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 node_exports = {};
+__export(node_exports, {
+  hasOwnInvocationSpan: () => hasOwnInvocationSpan,
+  setAssociatedEventIds: () => setAssociatedEventIds,
+  startNodeSpan: () => startNodeSpan
+});
+module.exports = __toCommonJS(node_exports);
+var import_attributes = require("../common/attributes.js");
+var import_tracer = require("./tracer.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const SELF_TRACED_NODE_BRANDS = [
+  /* @__PURE__ */ Symbol.for("google.adk.baseAgent"),
+  /* @__PURE__ */ Symbol.for("google.adk.workflow.workflow")
+];
+function hasOwnInvocationSpan(node) {
+  return SELF_TRACED_NODE_BRANDS.some(
+    (brand) => brand in node && Reflect.get(node, brand) === true
+  );
+}
+__name(hasOwnInvocationSpan, "hasOwnInvocationSpan");
+function startNodeSpan({
+  nodeName,
+  sessionId
+}) {
+  return (0, import_tracer.getTracer)().startSpan(`invoke_node ${nodeName}`, {
+    attributes: {
+      [import_attributes.GenAiAttr.OPERATION_NAME]: "invoke_node",
+      [import_attributes.GenAiAttr.CONVERSATION_ID]: sessionId
+    }
+  });
+}
+__name(startNodeSpan, "startNodeSpan");
+function setAssociatedEventIds(span, eventIds) {
+  if (eventIds.length > 0) {
+    span.setAttribute(import_attributes.GcpAttr.ASSOCIATED_EVENT_IDS, [...eventIds]);
+  }
+}
+__name(setAssociatedEventIds, "setAssociatedEventIds");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasOwnInvocationSpan,
+  setAssociatedEventIds,
+  startNodeSpan
+});

package/dist/cjs/telemetry/api/internal/trace/propagation.js

@@ -0,0 +1,67 @@
+/**
+  * @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 propagation_exports = {};
+__export(propagation_exports, {
+  INCOMING_HEADERS_GETTER: () => INCOMING_HEADERS_GETTER,
+  addMissingHeaders: () => addMissingHeaders
+});
+module.exports = __toCommonJS(propagation_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const INCOMING_HEADERS_GETTER = Object.freeze({
+  keys: /* @__PURE__ */ __name((carrier) => Object.keys(carrier), "keys"),
+  get(carrier, key) {
+    const name = key.toLowerCase();
+    for (const [headerName, value] of Object.entries(carrier)) {
+      if (headerName.toLowerCase() === name) {
+        return value;
+      }
+    }
+    return void 0;
+  }
+});
+function addMissingHeaders(input, init, injected) {
+  var _a;
+  const isRequest = typeof Request !== "undefined" && input instanceof Request;
+  const headers = new Headers(
+    (_a = init == null ? void 0 : init.headers) != null ? _a : isRequest ? input.headers : void 0
+  );
+  for (const [name, value] of Object.entries(injected)) {
+    if (!headers.has(name)) {
+      headers.set(name, value);
+    }
+  }
+  return headers;
+}
+__name(addMissingHeaders, "addMissingHeaders");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  INCOMING_HEADERS_GETTER,
+  addMissingHeaders
+});

package/dist/cjs/telemetry/api/internal/trace/tool.js

@@ -0,0 +1,122 @@
+/**
+  * @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 tool_exports = {};
+__export(tool_exports, {
+  buildMergedToolCallsAttributes: () => buildMergedToolCallsAttributes,
+  buildSkillAttributes: () => buildSkillAttributes,
+  buildSkillSpanName: () => buildSkillSpanName,
+  buildToolCallAttributes: () => buildToolCallAttributes,
+  setSkillSpanAttributes: () => setSkillSpanAttributes
+});
+module.exports = __toCommonJS(tool_exports);
+var import_attributes = require("../common/attributes.js");
+var import_config = require("../common/config.js");
+var import_redaction = require("../common/redaction.js");
+var import_serialization = require("../common/serialization.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const UNSPECIFIED = "<not specified>";
+function serializeToolResult(result) {
+  try {
+    return (0, import_serialization.safeJsonSerialize)((0, import_redaction.redactCredentialSecrets)(result));
+  } catch {
+    return "<not serializable>";
+  }
+}
+__name(serializeToolResult, "serializeToolResult");
+function buildToolCallAttributes({
+  tool,
+  args,
+  agentName,
+  outcome,
+  config
+}) {
+  var _a, _b, _c, _d;
+  const functionResponseEvent = outcome.kind === "response" ? outcome.functionResponseEvent : void 0;
+  const functionResponse = (_c = (_b = (_a = functionResponseEvent == null ? void 0 : functionResponseEvent.content) == null ? void 0 : _a.parts) == null ? void 0 : _b[0]) == null ? void 0 : _c.functionResponse;
+  const errorType = outcome.errorType;
+  const captureContent = (0, import_config.shouldAddContentToSpans)(config);
+  const result = functionResponse == null ? void 0 : functionResponse.response;
+  return {
+    [import_attributes.GenAiAttr.OPERATION_NAME]: "execute_tool",
+    [import_attributes.GenAiAttr.TOOL_DESCRIPTION]: tool.description,
+    [import_attributes.GenAiAttr.TOOL_NAME]: tool.name,
+    [import_attributes.GenAiAttr.TOOL_TYPE]: tool.constructor.name,
+    ...agentName ? { [import_attributes.GenAiAttr.AGENT_NAME]: agentName } : {},
+    ...errorType === void 0 ? {} : { [import_attributes.ERROR_TYPE_ATTR]: errorType },
+    [import_attributes.GenAiAttr.TOOL_CALL_ID]: (_d = functionResponse == null ? void 0 : functionResponse.id) != null ? _d : UNSPECIFIED,
+    ...functionResponseEvent ? { [import_attributes.GcpAttr.EVENT_ID]: functionResponseEvent.id } : {},
+    ...captureContent ? { [import_attributes.GenAiAttr.TOOL_CALL_ARGUMENTS]: (0, import_serialization.safeJsonSerialize)(args) } : {},
+    ...captureContent && result !== void 0 && result !== null ? { [import_attributes.GenAiAttr.TOOL_CALL_RESULT]: serializeToolResult(result) } : {}
+  };
+}
+__name(buildToolCallAttributes, "buildToolCallAttributes");
+function buildMergedToolCallsAttributes(responseEventId) {
+  return {
+    [import_attributes.GenAiAttr.OPERATION_NAME]: "execute_tool",
+    [import_attributes.GenAiAttr.TOOL_NAME]: "(merged tools)",
+    [import_attributes.GenAiAttr.TOOL_DESCRIPTION]: "(merged tools)",
+    [import_attributes.GenAiAttr.TOOL_CALL_ID]: responseEventId,
+    [import_attributes.GcpAttr.EVENT_ID]: responseEventId
+  };
+}
+__name(buildMergedToolCallsAttributes, "buildMergedToolCallsAttributes");
+function buildSkillSpanName(toolName, report) {
+  return report.resourceName === void 0 ? `execute_tool ${toolName} ${report.skillName}` : `execute_tool ${toolName} ${report.skillName} ${report.resourceName}`;
+}
+__name(buildSkillSpanName, "buildSkillSpanName");
+function buildSkillAttributes(report) {
+  var _a;
+  const { skill } = report;
+  const additionalTools = (_a = skill == null ? void 0 : skill.frontmatter.metadata) == null ? void 0 : _a["adk_additional_tools"];
+  return {
+    [import_attributes.GenAiAttr.SKILL_NAME]: report.skillName,
+    ...skill ? { [import_attributes.GenAiAttr.SKILL_DESCRIPTION]: skill.frontmatter.description } : {},
+    ...report.resourceName === void 0 ? {} : { [import_attributes.GenAiAttr.SKILL_RESOURCE_NAME]: report.resourceName },
+    ...report.isSkillLoad && skill && Array.isArray(additionalTools) ? {
+      [import_attributes.AdkAttr.SKILL_ADDITIONAL_TOOLS]: additionalTools.filter(
+        (name) => typeof name === "string"
+      )
+    } : {}
+  };
+}
+__name(buildSkillAttributes, "buildSkillAttributes");
+function setSkillSpanAttributes(span, toolName, report) {
+  span.updateName(buildSkillSpanName(toolName, report));
+  span.setAttributes(buildSkillAttributes(report));
+}
+__name(setSkillSpanAttributes, "setSkillSpanAttributes");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildMergedToolCallsAttributes,
+  buildSkillAttributes,
+  buildSkillSpanName,
+  buildToolCallAttributes,
+  setSkillSpanAttributes
+});

package/dist/cjs/telemetry/api/internal/trace/tracer.js

@@ -0,0 +1,77 @@
+/**
+  * @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 tracer_exports = {};
+__export(tracer_exports, {
+  bindOtelContextToAsyncGenerator: () => bindOtelContextToAsyncGenerator,
+  getTracer: () => getTracer,
+  setSpanError: () => setSpanError
+});
+module.exports = __toCommonJS(tracer_exports);
+var import_api = require("@opentelemetry/api");
+var import_version = require("../../../../version.js");
+var import_attributes = require("../common/attributes.js");
+var import_error = require("../common/error.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function getTracer() {
+  return import_api.trace.getTracerProvider().getTracer(import_attributes.GEN_AI_SYSTEM_VALUE, import_version.version, { schemaUrl: import_attributes.SCHEMA_URL });
+}
+__name(getTracer, "getTracer");
+function bindOtelContextToAsyncGenerator(ctx, generator) {
+  return {
+    next: import_api.context.bind(ctx, generator.next.bind(generator)),
+    return: import_api.context.bind(ctx, generator.return.bind(generator)),
+    throw: import_api.context.bind(ctx, generator.throw.bind(generator)),
+    [Symbol.asyncIterator]() {
+      return bindOtelContextToAsyncGenerator(
+        ctx,
+        generator[Symbol.asyncIterator]()
+      );
+    }
+  };
+}
+__name(bindOtelContextToAsyncGenerator, "bindOtelContextToAsyncGenerator");
+function setSpanError(span, error) {
+  const errorType = (0, import_error.resolveErrorType)(error);
+  let exception;
+  try {
+    exception = error instanceof Error ? error : errorType;
+  } catch {
+    exception = errorType;
+  }
+  span.recordException(exception);
+  span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: errorType });
+}
+__name(setSpanError, "setSpanError");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bindOtelContextToAsyncGenerator,
+  getTracer,
+  setSpanError
+});

package/dist/cjs/telemetry/api/internal/trace/workflow.js

@@ -0,0 +1,77 @@
+/**
+  * @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 workflow_exports = {};
+__export(workflow_exports, {
+  startWorkflowSpan: () => startWorkflowSpan
+});
+module.exports = __toCommonJS(workflow_exports);
+var import_api = require("@opentelemetry/api");
+var import_attributes = require("../common/attributes.js");
+var import_tracer = require("./tracer.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const SUPPORT_ID_KEY = (0, import_api.createContextKey)("google.adk.agent_engine.support_id");
+function getSupportId(parentContext, nested) {
+  if (nested) {
+    return void 0;
+  }
+  const parentSpanContext = import_api.trace.getSpanContext(parentContext);
+  if (parentSpanContext && !parentSpanContext.isRemote) {
+    return void 0;
+  }
+  const supportId = parentContext.getValue(SUPPORT_ID_KEY);
+  return typeof supportId === "string" ? supportId : void 0;
+}
+__name(getSupportId, "getSupportId");
+function startWorkflowSpan({
+  workflowName,
+  sessionId,
+  nested,
+  parentContext = import_api.context.active()
+}) {
+  const supportId = getSupportId(parentContext, nested);
+  return (0, import_tracer.getTracer)().startSpan(
+    workflowName ? `invoke_workflow ${workflowName}` : "invoke_workflow",
+    {
+      attributes: {
+        [import_attributes.GenAiAttr.OPERATION_NAME]: "invoke_workflow",
+        [import_attributes.GenAiAttr.CONVERSATION_ID]: sessionId,
+        ...nested ? { [import_attributes.GenAiAttr.WORKFLOW_NESTED]: true } : {},
+        ...workflowName ? { [import_attributes.GenAiAttr.WORKFLOW_NAME]: workflowName } : {},
+        ...supportId ? { [import_attributes.SUPPORT_ID_ATTR]: supportId } : {}
+      }
+    },
+    parentContext
+  );
+}
+__name(startWorkflowSpan, "startWorkflowSpan");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  startWorkflowSpan
+});