@librechat/agents 3.4.5 → 3.4.6

package/dist/cjs/langfuseTraceShaping.cjs

@@ -14,6 +14,8 @@ const CHAIN_OBSERVATION_TYPE = "chain";
 const TOOL_OBSERVATION_TYPE = "tool";
 const AGENT_TRACE_TAG = "agent";
 const TITLE_TRACE_TAG = "title";
+const ACTIVITY_PHASE_TRACE_TAG = "activity-phase";
+const ACTIVITY_PHASE_ROOT_NAME = "summarize-activity-phase";
 const EPHEMERAL_AGENT_SENDER_SEPARATOR = "___";
 const EPHEMERAL_AGENT_INDEX_SEPARATOR = "____";
 const OBSERVATION_METADATA_LANGGRAPH_NODE = `${_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_METADATA}.langgraph_node`;
@@ -276,11 +278,11 @@ function hasTraceTag(span, expectedTag) {
 }
 function shapeRootObservationType(span) {
 	if (isGenerationSpan(span)) return;
-	if (hasTraceTag(span, AGENT_TRACE_TAG)) {
-		span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE] = ROOT_OBSERVATION_TYPE;
+	if (hasTraceTag(span, TITLE_TRACE_TAG) || span.name === ACTIVITY_PHASE_ROOT_NAME && hasTraceTag(span, ACTIVITY_PHASE_TRACE_TAG)) {
+		span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE] = CHAIN_OBSERVATION_TYPE;
 		return;
 	}
-	if (hasTraceTag(span, TITLE_TRACE_TAG)) span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE] = CHAIN_OBSERVATION_TYPE;
+	if (hasTraceTag(span, AGENT_TRACE_TAG)) span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE] = ROOT_OBSERVATION_TYPE;
 }
 /**
 * Reshapes spans per Langfuse-team feedback before export:
@@ -295,9 +297,10 @@ function shapeRootObservationType(span) {
 * - Agent nodes become `agent` observations, while tool-dispatch nodes become
 *   stable `chain` observations whose input is scoped to the pending calls.
 *   Individual child calls remain `tool` observations (items 3 & 4).
-* - Agent trace roots become `agent` observations and title trace roots become
-*   `chain` observations. Root and trace input/output are reduced to the user
-*   question and assistant response when chat messages are available (item 2).
+* - Agent trace roots become `agent` observations, while title and activity
+*   summary roots become `chain` observations. Root and trace input/output are
+*   reduced to the user question and assistant response when chat messages are
+*   available (item 2).
 */
 function shapeLangfuseSpan(span) {
 	const mutable = span;

package/dist/cjs/langfuseTraceShaping.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuseTraceShaping.cjs","names":["LangfuseOtelSpanAttributes"],"sources":["../../src/langfuseTraceShaping.ts"],"sourcesContent":["import { LangfuseOtelSpanAttributes } from '@langfuse/tracing';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { Constants } from '@/common';\n\nconst LANGGRAPH_START_NODE = '__start__';\nconst ANONYMOUS_LAMBDA_NAME = 'RunnableLambda';\nconst LANGGRAPH_AGENT_NODE_PREFIX = 'agent=';\nconst LANGGRAPH_TOOL_NODE_PREFIX = 'tools=';\nconst AGENT_NODE_SPAN_NAME = 'agent';\nconst TOOL_DISPATCH_SPAN_NAME = 'tool-dispatch';\nconst GENERATION_SPAN_NAME = 'llm';\nconst ROOT_OBSERVATION_TYPE = 'agent';\nconst CHAIN_OBSERVATION_TYPE = 'chain';\nconst TOOL_OBSERVATION_TYPE = 'tool';\nconst AGENT_TRACE_TAG = 'agent';\nconst TITLE_TRACE_TAG = 'title';\nconst EPHEMERAL_AGENT_SENDER_SEPARATOR = '___';\nconst EPHEMERAL_AGENT_INDEX_SEPARATOR = '____';\nconst OBSERVATION_METADATA_LANGGRAPH_NODE = `${LangfuseOtelSpanAttributes.OBSERVATION_METADATA}.langgraph_node`;\n\ntype MutableSpan = ReadableSpan & {\n  name: string;\n  attributes: Record<string, unknown>;\n};\n\ntype SerializedToolCall = {\n  name: string;\n  args: unknown;\n  id?: string;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction parseAttributeValue(value: unknown): unknown {\n  if (typeof value !== 'string') {\n    return value;\n  }\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {\n    return value;\n  }\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction getMessageArray(\n  value: unknown\n): Record<string, unknown>[] | undefined {\n  if (Array.isArray(value)) {\n    const records = value.filter(isRecord);\n    return records.length > 0 ? records : undefined;\n  }\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  return (\n    getMessageArray(value.messages) ??\n    getMessageArray(value.input) ??\n    getMessageArray(value.output)\n  );\n}\n\nfunction getMessageRole(message: Record<string, unknown>): string | undefined {\n  const id = message.id;\n  if (Array.isArray(id)) {\n    const className = id[id.length - 1];\n    if (typeof className === 'string') {\n      if (className.includes('Human')) {\n        return 'user';\n      }\n      if (className.includes('AI')) {\n        return 'assistant';\n      }\n      if (className.includes('System')) {\n        return 'system';\n      }\n      if (className.includes('Tool')) {\n        return 'tool';\n      }\n    }\n  }\n  const rawRole =\n    message.type ?? message._type ?? message.role ?? message.sender;\n  if (typeof rawRole !== 'string') {\n    const kwargs = message.kwargs;\n    return isRecord(kwargs) ? getMessageRole(kwargs) : undefined;\n  }\n  const normalized = rawRole.toLowerCase();\n  if (normalized === 'human') {\n    return 'user';\n  }\n  if (normalized === 'ai') {\n    return 'assistant';\n  }\n  return normalized;\n}\n\nfunction getMessageText(message: Record<string, unknown>): string | undefined {\n  const content =\n    message.content ??\n    (isRecord(message.kwargs) ? message.kwargs.content : undefined) ??\n    (isRecord(message.data) ? message.data.content : undefined);\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return undefined;\n  }\n  const text = content\n    .filter(isRecord)\n    .map((part) => (typeof part.text === 'string' ? part.text : ''))\n    .join('');\n  return text === '' ? undefined : text;\n}\n\nfunction findLastMessageText(value: unknown, role: string): string | undefined {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return undefined;\n  }\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== role) {\n      continue;\n    }\n    const text = getMessageText(messages[i]);\n    if (text != null && text.trim() !== '') {\n      return text;\n    }\n  }\n  return undefined;\n}\n\nfunction normalizeToolCall(value: unknown): SerializedToolCall | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  const fn = value.function;\n  if (isRecord(fn) && typeof fn.name === 'string') {\n    return {\n      name: fn.name,\n      args: parseAttributeValue(fn.arguments),\n      ...(typeof value.id === 'string' ? { id: value.id } : {}),\n    };\n  }\n  if (typeof value.name !== 'string') {\n    return undefined;\n  }\n  return {\n    name: value.name,\n    args: value.args ?? {},\n    ...(typeof value.id === 'string' ? { id: value.id } : {}),\n  };\n}\n\nfunction getMessageToolCalls(\n  message: Record<string, unknown>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.tool_calls : undefined) ??\n    (isRecord(message.additional_kwargs)\n      ? message.additional_kwargs.tool_calls\n      : undefined) ??\n    (isRecord(message.data) ? message.data.tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    const call = normalizeToolCall(rawCall);\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/**\n * Id-bearing `invalid_tool_calls` on the assistant turn. ToolNode pairs these\n * with synthesized error results (and an invalid-only turn is routed on them\n * alone), so the tool-dispatch span must count them as part of the executing\n * batch — otherwise an invalid-only dispatch finds zero calls and the span\n * keeps the full serialized graph state as its input, and a mixed dispatch\n * silently omits the malformed call. `args` stays the raw unparsed string.\n */\n/** Tool-result ids present in the serialized state — ToolNode's\n *  `!toolMessageIds.has(id)` execution filter, mirrored for the span. */\nfunction getToolResultIds(\n  messages: Record<string, unknown>[]\n): Set<string> {\n  const ids = new Set<string>();\n  for (const message of messages) {\n    if (getMessageRole(message) !== 'tool') {\n      continue;\n    }\n    const rawId =\n      message.tool_call_id ??\n      (isRecord(message.kwargs) ? message.kwargs.tool_call_id : undefined) ??\n      (isRecord(message.data) ? message.data.tool_call_id : undefined);\n    if (typeof rawId === 'string' && rawId !== '') {\n      ids.add(rawId);\n    }\n  }\n  return ids;\n}\n\nfunction getMessageInvalidToolCalls(\n  message: Record<string, unknown>,\n  answeredIds: ReadonlySet<string>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.invalid_tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.invalid_tool_calls : undefined) ??\n    (isRecord(message.data) ? message.data.invalid_tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    // Same attribution predicate ToolNode executes with (id-bearing,\n    // non-server) so the span never claims calls the node deliberately skips.\n    if (\n      !isRecord(rawCall) ||\n      typeof rawCall.id !== 'string' ||\n      rawCall.id === '' ||\n      answeredIds.has(rawCall.id) ||\n      rawCall.id.startsWith(Constants.ANTHROPIC_SERVER_TOOL_PREFIX)\n    ) {\n      continue;\n    }\n    // Same name fallback ToolNode synthesizes with — a nameless attributable\n    // call still gets a result, so it must still count in the span input.\n    const call = normalizeToolCall(\n      typeof rawCall.name === 'string' && rawCall.name !== ''\n        ? rawCall\n        : { ...rawCall, name: 'unknown' }\n    );\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/** The serialized message's own id (uuid), NOT the LC-serialization type id\n *  array that `message.id` carries in constructor dumps. */\nfunction getSerializedMessageId(\n  message: Record<string, unknown>\n): string | undefined {\n  const kwargsId = isRecord(message.kwargs) ? message.kwargs.id : undefined;\n  const dataId = isRecord(message.data) ? message.data.id : undefined;\n  const rawId = message.id;\n  const id = kwargsId ?? dataId ?? rawId;\n  return typeof id === 'string' && id !== '' ? id : undefined;\n}\n\n/** Latest assistant turn's tool calls — the calls this tool node is executing. */\nfunction findPendingToolCalls(value: unknown): SerializedToolCall[] {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return [];\n  }\n  /**\n   * Invalid calls count only where ToolNode's own gate lets them execute:\n   * the messages-state form (a bare-array state means the node returns a\n   * plain output list and skips invalid handling) with an id-bearing\n   * assistant message (no id, no reducer upsert). Mirrors\n   * `canPromoteInvalidCalls` so the span never reports skipped calls.\n   */\n  const invalidCallsApply = !Array.isArray(value);\n  const answeredIds = invalidCallsApply\n    ? getToolResultIds(messages)\n    : undefined;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== 'assistant') {\n      continue;\n    }\n    const calls = [\n      ...getMessageToolCalls(messages[i]),\n      ...(invalidCallsApply && getSerializedMessageId(messages[i]) != null\n        ? getMessageInvalidToolCalls(messages[i], answeredIds!)\n        : []),\n    ];\n    if (calls.length > 0) {\n      return calls;\n    }\n  }\n  return [];\n}\n\nfunction getRootSpanParentId(span: ReadableSpan): string | undefined {\n  const legacyParent = (span as { parentSpanId?: string }).parentSpanId;\n  if (typeof legacyParent === 'string' && legacyParent !== '') {\n    return legacyParent;\n  }\n  const parentContext = (span as { parentSpanContext?: { spanId?: string } })\n    .parentSpanContext;\n  const spanId = parentContext?.spanId;\n  return typeof spanId === 'string' && spanId !== '' ? spanId : undefined;\n}\n\nfunction isRootSpan(span: ReadableSpan): boolean {\n  return getRootSpanParentId(span) == null;\n}\n\n/**\n * LangGraph plumbing observations that add noise without information:\n * the duplicated `__start__` channel-seed nodes and anonymous\n * `RunnableLambda` pass-throughs (Langfuse team feedback items 4 & 5).\n * Internal ToolNode batch spans are disabled at their source so traced child\n * tools retain an exported parent. Explicitly traced ToolNodes are preserved.\n */\nexport function shouldDropLangfuseSpan(spanName: string): boolean {\n  return (\n    spanName === LANGGRAPH_START_NODE || spanName === ANONYMOUS_LAMBDA_NAME\n  );\n}\n\nfunction shapeToolNodeSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  span.name = TOOL_DISPATCH_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    CHAIN_OBSERVATION_TYPE;\n  const calls = findPendingToolCalls(\n    parseAttributeValue(span.attributes[inputKey])\n  );\n  if (calls.length === 0) {\n    return;\n  }\n  span.attributes[inputKey] = JSON.stringify(\n    calls.map(({ name, args }) => ({ name, args }))\n  );\n}\n\nfunction shapeAgentNodeSpan(span: MutableSpan): void {\n  span.name = AGENT_NODE_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction shapeRootSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  const outputKey = LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT;\n  const question = findLastMessageText(\n    parseAttributeValue(span.attributes[inputKey]),\n    'user'\n  );\n  const answer = findLastMessageText(\n    parseAttributeValue(span.attributes[outputKey]),\n    'assistant'\n  );\n  /** A generation that IS the trace root — a bare `model.invoke` with no\n   *  wrapping chain, i.e. the activity-label path — is also the only\n   *  observation carrying its own prompt: reducing its observation input\n   *  would discard the SystemMessage from the one place it is traced.\n   *  Chain/agent roots keep the full reduction; their child generations\n   *  still record the complete prompt. Trace-level input/output reduce\n   *  either way, so the trace list keeps showing question and answer. */\n  if (!isGenerationSpan(span)) {\n    if (question != null) {\n      span.attributes[inputKey] = question;\n    }\n    if (answer != null) {\n      span.attributes[outputKey] = answer;\n    }\n  }\n  const traceInput = question ?? span.attributes[inputKey];\n  const traceOutput = answer ?? span.attributes[outputKey];\n  if (traceInput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_INPUT] = traceInput;\n  }\n  if (traceOutput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_OUTPUT] = traceOutput;\n  }\n}\n\nfunction isGenerationSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return typeof type === 'string' && type.toLowerCase() === 'generation';\n}\n\nfunction isToolSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return (\n    typeof type === 'string' && type.toLowerCase() === TOOL_OBSERVATION_TYPE\n  );\n}\n\n/**\n * Whether the span is a LangGraph node execution whose node id is the span\n * name — the shape of the outer workflow-agent node. `@langfuse/tracing`\n * flattens object metadata to per-key attributes with string values stored\n * raw, so LangGraph's `langgraph_node` arrives directly comparable.\n */\nfunction isWorkflowNodeSpan(span: MutableSpan): boolean {\n  return span.attributes[OBSERVATION_METADATA_LANGGRAPH_NODE] === span.name;\n}\n\n/**\n * LibreChat ephemeral agents are identified as\n * `endpoint__model___sender[____index]` (`__` encodes `:`; see LibreChat's\n * `encodeEphemeralAgentId`), and the outer workflow node carries that id as\n * its span name — so switching models renames the span (item 1). Returns the\n * stable human `sender` segment only when the name matches that encoding:\n * the `endpoint__model` prefix must contain both segments and — unlike\n * display names such as `LibreChat Agent: Ops___EU` — never contains\n * whitespace, so legitimate names that merely embed `___` are left alone.\n */\nfunction extractEphemeralAgentSender(name: string): string | undefined {\n  let workingId = name;\n  const indexSeparator = workingId.lastIndexOf(EPHEMERAL_AGENT_INDEX_SEPARATOR);\n  if (\n    indexSeparator !== -1 &&\n    /^\\d+$/.test(\n      workingId.slice(indexSeparator + EPHEMERAL_AGENT_INDEX_SEPARATOR.length)\n    )\n  ) {\n    workingId = workingId.slice(0, indexSeparator);\n  }\n  const senderSeparator = workingId.indexOf(EPHEMERAL_AGENT_SENDER_SEPARATOR);\n  if (senderSeparator <= 0) {\n    return undefined;\n  }\n  const encodedPrefix = workingId.slice(0, senderSeparator);\n  if (/\\s/.test(encodedPrefix)) {\n    return undefined;\n  }\n  const prefixParts = encodedPrefix.split('__');\n  if (prefixParts.length < 2 || prefixParts.some((part) => part === '')) {\n    return undefined;\n  }\n  const sender = workingId\n    .slice(senderSeparator + EPHEMERAL_AGENT_SENDER_SEPARATOR.length)\n    .replace(/__/g, ':');\n  return sender === '' ? undefined : sender;\n}\n\n/** Workflow-agent node spans are always children of the run's root chain and\n *  always carry `langgraph_node` metadata equal to their name, so host-named\n *  run roots (`LibreChat Agent: <name>`) and ordinary chains that merely look\n *  like encoded ids (`pipeline__stage___EU`) are never rename candidates.\n *  Successful decodes become `agent` observations, matching the inner\n *  `agent=<id>` node shaping. */\nfunction shapeEphemeralAgentNodeSpan(span: MutableSpan): void {\n  if (isToolSpan(span) || isRootSpan(span) || !isWorkflowNodeSpan(span)) {\n    return;\n  }\n  const sender = extractEphemeralAgentSender(span.name);\n  if (sender == null) {\n    return;\n  }\n  span.name = sender;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction hasTraceTag(span: MutableSpan, expectedTag: string): boolean {\n  const tags = parseAttributeValue(\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_TAGS]\n  );\n  return (\n    Array.isArray(tags) &&\n    tags.some((tag) => typeof tag === 'string' && tag === expectedTag)\n  );\n}\n\nfunction shapeRootObservationType(span: MutableSpan): void {\n  if (isGenerationSpan(span)) {\n    return;\n  }\n  if (hasTraceTag(span, AGENT_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      ROOT_OBSERVATION_TYPE;\n    return;\n  }\n  if (hasTraceTag(span, TITLE_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      CHAIN_OBSERVATION_TYPE;\n  }\n}\n\n/**\n * Reshapes spans per Langfuse-team feedback before export:\n * - `agent=<id>` / `tools=<id>` node names carry the ephemeral agent id\n *   (`provider__model`) — strip it so switching models doesn't break\n *   name-based logic (item 1). The outer workflow node is named with the\n *   bare agent id; ephemeral ids reduce to their stable sender name.\n * - LLM generation spans keep the provider client class name (`ChatOpenAI`,\n *   `AzureChatOpenAI`, …); rename them to a provider-agnostic `llm` so the\n *   name reflects the operation, not the model (the model stays on the\n *   generation's model attribute).\n * - Agent nodes become `agent` observations, while tool-dispatch nodes become\n *   stable `chain` observations whose input is scoped to the pending calls.\n *   Individual child calls remain `tool` observations (items 3 & 4).\n * - Agent trace roots become `agent` observations and title trace roots become\n *   `chain` observations. Root and trace input/output are reduced to the user\n *   question and assistant response when chat messages are available (item 2).\n */\nexport function shapeLangfuseSpan(span: ReadableSpan): void {\n  const mutable = span as MutableSpan;\n  if (mutable.name.startsWith(LANGGRAPH_AGENT_NODE_PREFIX)) {\n    shapeAgentNodeSpan(mutable);\n  } else if (mutable.name.startsWith(LANGGRAPH_TOOL_NODE_PREFIX)) {\n    shapeToolNodeSpan(mutable);\n  } else if (isGenerationSpan(mutable)) {\n    mutable.name = GENERATION_SPAN_NAME;\n  } else {\n    shapeEphemeralAgentNodeSpan(mutable);\n  }\n  if (!isRootSpan(span)) {\n    return;\n  }\n  shapeRootObservationType(mutable);\n  shapeRootSpan(mutable);\n}\n"],"mappings":"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"}
+{"version":3,"file":"langfuseTraceShaping.cjs","names":["LangfuseOtelSpanAttributes"],"sources":["../../src/langfuseTraceShaping.ts"],"sourcesContent":["import { LangfuseOtelSpanAttributes } from '@langfuse/tracing';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { Constants } from '@/common';\n\nconst LANGGRAPH_START_NODE = '__start__';\nconst ANONYMOUS_LAMBDA_NAME = 'RunnableLambda';\nconst LANGGRAPH_AGENT_NODE_PREFIX = 'agent=';\nconst LANGGRAPH_TOOL_NODE_PREFIX = 'tools=';\nconst AGENT_NODE_SPAN_NAME = 'agent';\nconst TOOL_DISPATCH_SPAN_NAME = 'tool-dispatch';\nconst GENERATION_SPAN_NAME = 'llm';\nconst ROOT_OBSERVATION_TYPE = 'agent';\nconst CHAIN_OBSERVATION_TYPE = 'chain';\nconst TOOL_OBSERVATION_TYPE = 'tool';\nconst AGENT_TRACE_TAG = 'agent';\nconst TITLE_TRACE_TAG = 'title';\nconst ACTIVITY_PHASE_TRACE_TAG = 'activity-phase';\nconst ACTIVITY_PHASE_ROOT_NAME = 'summarize-activity-phase';\nconst EPHEMERAL_AGENT_SENDER_SEPARATOR = '___';\nconst EPHEMERAL_AGENT_INDEX_SEPARATOR = '____';\nconst OBSERVATION_METADATA_LANGGRAPH_NODE = `${LangfuseOtelSpanAttributes.OBSERVATION_METADATA}.langgraph_node`;\n\ntype MutableSpan = ReadableSpan & {\n  name: string;\n  attributes: Record<string, unknown>;\n};\n\ntype SerializedToolCall = {\n  name: string;\n  args: unknown;\n  id?: string;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction parseAttributeValue(value: unknown): unknown {\n  if (typeof value !== 'string') {\n    return value;\n  }\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {\n    return value;\n  }\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction getMessageArray(\n  value: unknown\n): Record<string, unknown>[] | undefined {\n  if (Array.isArray(value)) {\n    const records = value.filter(isRecord);\n    return records.length > 0 ? records : undefined;\n  }\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  return (\n    getMessageArray(value.messages) ??\n    getMessageArray(value.input) ??\n    getMessageArray(value.output)\n  );\n}\n\nfunction getMessageRole(message: Record<string, unknown>): string | undefined {\n  const id = message.id;\n  if (Array.isArray(id)) {\n    const className = id[id.length - 1];\n    if (typeof className === 'string') {\n      if (className.includes('Human')) {\n        return 'user';\n      }\n      if (className.includes('AI')) {\n        return 'assistant';\n      }\n      if (className.includes('System')) {\n        return 'system';\n      }\n      if (className.includes('Tool')) {\n        return 'tool';\n      }\n    }\n  }\n  const rawRole =\n    message.type ?? message._type ?? message.role ?? message.sender;\n  if (typeof rawRole !== 'string') {\n    const kwargs = message.kwargs;\n    return isRecord(kwargs) ? getMessageRole(kwargs) : undefined;\n  }\n  const normalized = rawRole.toLowerCase();\n  if (normalized === 'human') {\n    return 'user';\n  }\n  if (normalized === 'ai') {\n    return 'assistant';\n  }\n  return normalized;\n}\n\nfunction getMessageText(message: Record<string, unknown>): string | undefined {\n  const content =\n    message.content ??\n    (isRecord(message.kwargs) ? message.kwargs.content : undefined) ??\n    (isRecord(message.data) ? message.data.content : undefined);\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return undefined;\n  }\n  const text = content\n    .filter(isRecord)\n    .map((part) => (typeof part.text === 'string' ? part.text : ''))\n    .join('');\n  return text === '' ? undefined : text;\n}\n\nfunction findLastMessageText(value: unknown, role: string): string | undefined {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return undefined;\n  }\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== role) {\n      continue;\n    }\n    const text = getMessageText(messages[i]);\n    if (text != null && text.trim() !== '') {\n      return text;\n    }\n  }\n  return undefined;\n}\n\nfunction normalizeToolCall(value: unknown): SerializedToolCall | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  const fn = value.function;\n  if (isRecord(fn) && typeof fn.name === 'string') {\n    return {\n      name: fn.name,\n      args: parseAttributeValue(fn.arguments),\n      ...(typeof value.id === 'string' ? { id: value.id } : {}),\n    };\n  }\n  if (typeof value.name !== 'string') {\n    return undefined;\n  }\n  return {\n    name: value.name,\n    args: value.args ?? {},\n    ...(typeof value.id === 'string' ? { id: value.id } : {}),\n  };\n}\n\nfunction getMessageToolCalls(\n  message: Record<string, unknown>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.tool_calls : undefined) ??\n    (isRecord(message.additional_kwargs)\n      ? message.additional_kwargs.tool_calls\n      : undefined) ??\n    (isRecord(message.data) ? message.data.tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    const call = normalizeToolCall(rawCall);\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/**\n * Id-bearing `invalid_tool_calls` on the assistant turn. ToolNode pairs these\n * with synthesized error results (and an invalid-only turn is routed on them\n * alone), so the tool-dispatch span must count them as part of the executing\n * batch — otherwise an invalid-only dispatch finds zero calls and the span\n * keeps the full serialized graph state as its input, and a mixed dispatch\n * silently omits the malformed call. `args` stays the raw unparsed string.\n */\n/** Tool-result ids present in the serialized state — ToolNode's\n *  `!toolMessageIds.has(id)` execution filter, mirrored for the span. */\nfunction getToolResultIds(\n  messages: Record<string, unknown>[]\n): Set<string> {\n  const ids = new Set<string>();\n  for (const message of messages) {\n    if (getMessageRole(message) !== 'tool') {\n      continue;\n    }\n    const rawId =\n      message.tool_call_id ??\n      (isRecord(message.kwargs) ? message.kwargs.tool_call_id : undefined) ??\n      (isRecord(message.data) ? message.data.tool_call_id : undefined);\n    if (typeof rawId === 'string' && rawId !== '') {\n      ids.add(rawId);\n    }\n  }\n  return ids;\n}\n\nfunction getMessageInvalidToolCalls(\n  message: Record<string, unknown>,\n  answeredIds: ReadonlySet<string>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.invalid_tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.invalid_tool_calls : undefined) ??\n    (isRecord(message.data) ? message.data.invalid_tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    // Same attribution predicate ToolNode executes with (id-bearing,\n    // non-server) so the span never claims calls the node deliberately skips.\n    if (\n      !isRecord(rawCall) ||\n      typeof rawCall.id !== 'string' ||\n      rawCall.id === '' ||\n      answeredIds.has(rawCall.id) ||\n      rawCall.id.startsWith(Constants.ANTHROPIC_SERVER_TOOL_PREFIX)\n    ) {\n      continue;\n    }\n    // Same name fallback ToolNode synthesizes with — a nameless attributable\n    // call still gets a result, so it must still count in the span input.\n    const call = normalizeToolCall(\n      typeof rawCall.name === 'string' && rawCall.name !== ''\n        ? rawCall\n        : { ...rawCall, name: 'unknown' }\n    );\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/** The serialized message's own id (uuid), NOT the LC-serialization type id\n *  array that `message.id` carries in constructor dumps. */\nfunction getSerializedMessageId(\n  message: Record<string, unknown>\n): string | undefined {\n  const kwargsId = isRecord(message.kwargs) ? message.kwargs.id : undefined;\n  const dataId = isRecord(message.data) ? message.data.id : undefined;\n  const rawId = message.id;\n  const id = kwargsId ?? dataId ?? rawId;\n  return typeof id === 'string' && id !== '' ? id : undefined;\n}\n\n/** Latest assistant turn's tool calls — the calls this tool node is executing. */\nfunction findPendingToolCalls(value: unknown): SerializedToolCall[] {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return [];\n  }\n  /**\n   * Invalid calls count only where ToolNode's own gate lets them execute:\n   * the messages-state form (a bare-array state means the node returns a\n   * plain output list and skips invalid handling) with an id-bearing\n   * assistant message (no id, no reducer upsert). Mirrors\n   * `canPromoteInvalidCalls` so the span never reports skipped calls.\n   */\n  const invalidCallsApply = !Array.isArray(value);\n  const answeredIds = invalidCallsApply\n    ? getToolResultIds(messages)\n    : undefined;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== 'assistant') {\n      continue;\n    }\n    const calls = [\n      ...getMessageToolCalls(messages[i]),\n      ...(invalidCallsApply && getSerializedMessageId(messages[i]) != null\n        ? getMessageInvalidToolCalls(messages[i], answeredIds!)\n        : []),\n    ];\n    if (calls.length > 0) {\n      return calls;\n    }\n  }\n  return [];\n}\n\nfunction getRootSpanParentId(span: ReadableSpan): string | undefined {\n  const legacyParent = (span as { parentSpanId?: string }).parentSpanId;\n  if (typeof legacyParent === 'string' && legacyParent !== '') {\n    return legacyParent;\n  }\n  const parentContext = (span as { parentSpanContext?: { spanId?: string } })\n    .parentSpanContext;\n  const spanId = parentContext?.spanId;\n  return typeof spanId === 'string' && spanId !== '' ? spanId : undefined;\n}\n\nfunction isRootSpan(span: ReadableSpan): boolean {\n  return getRootSpanParentId(span) == null;\n}\n\n/**\n * LangGraph plumbing observations that add noise without information:\n * the duplicated `__start__` channel-seed nodes and anonymous\n * `RunnableLambda` pass-throughs (Langfuse team feedback items 4 & 5).\n * Internal ToolNode batch spans are disabled at their source so traced child\n * tools retain an exported parent. Explicitly traced ToolNodes are preserved.\n */\nexport function shouldDropLangfuseSpan(spanName: string): boolean {\n  return (\n    spanName === LANGGRAPH_START_NODE || spanName === ANONYMOUS_LAMBDA_NAME\n  );\n}\n\nfunction shapeToolNodeSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  span.name = TOOL_DISPATCH_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    CHAIN_OBSERVATION_TYPE;\n  const calls = findPendingToolCalls(\n    parseAttributeValue(span.attributes[inputKey])\n  );\n  if (calls.length === 0) {\n    return;\n  }\n  span.attributes[inputKey] = JSON.stringify(\n    calls.map(({ name, args }) => ({ name, args }))\n  );\n}\n\nfunction shapeAgentNodeSpan(span: MutableSpan): void {\n  span.name = AGENT_NODE_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction shapeRootSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  const outputKey = LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT;\n  const question = findLastMessageText(\n    parseAttributeValue(span.attributes[inputKey]),\n    'user'\n  );\n  const answer = findLastMessageText(\n    parseAttributeValue(span.attributes[outputKey]),\n    'assistant'\n  );\n  /** A generation that IS the trace root — a bare `model.invoke` with no\n   *  wrapping chain, i.e. the activity-label path — is also the only\n   *  observation carrying its own prompt: reducing its observation input\n   *  would discard the SystemMessage from the one place it is traced.\n   *  Chain/agent roots keep the full reduction; their child generations\n   *  still record the complete prompt. Trace-level input/output reduce\n   *  either way, so the trace list keeps showing question and answer. */\n  if (!isGenerationSpan(span)) {\n    if (question != null) {\n      span.attributes[inputKey] = question;\n    }\n    if (answer != null) {\n      span.attributes[outputKey] = answer;\n    }\n  }\n  const traceInput = question ?? span.attributes[inputKey];\n  const traceOutput = answer ?? span.attributes[outputKey];\n  if (traceInput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_INPUT] = traceInput;\n  }\n  if (traceOutput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_OUTPUT] = traceOutput;\n  }\n}\n\nfunction isGenerationSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return typeof type === 'string' && type.toLowerCase() === 'generation';\n}\n\nfunction isToolSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return (\n    typeof type === 'string' && type.toLowerCase() === TOOL_OBSERVATION_TYPE\n  );\n}\n\n/**\n * Whether the span is a LangGraph node execution whose node id is the span\n * name — the shape of the outer workflow-agent node. `@langfuse/tracing`\n * flattens object metadata to per-key attributes with string values stored\n * raw, so LangGraph's `langgraph_node` arrives directly comparable.\n */\nfunction isWorkflowNodeSpan(span: MutableSpan): boolean {\n  return span.attributes[OBSERVATION_METADATA_LANGGRAPH_NODE] === span.name;\n}\n\n/**\n * LibreChat ephemeral agents are identified as\n * `endpoint__model___sender[____index]` (`__` encodes `:`; see LibreChat's\n * `encodeEphemeralAgentId`), and the outer workflow node carries that id as\n * its span name — so switching models renames the span (item 1). Returns the\n * stable human `sender` segment only when the name matches that encoding:\n * the `endpoint__model` prefix must contain both segments and — unlike\n * display names such as `LibreChat Agent: Ops___EU` — never contains\n * whitespace, so legitimate names that merely embed `___` are left alone.\n */\nfunction extractEphemeralAgentSender(name: string): string | undefined {\n  let workingId = name;\n  const indexSeparator = workingId.lastIndexOf(EPHEMERAL_AGENT_INDEX_SEPARATOR);\n  if (\n    indexSeparator !== -1 &&\n    /^\\d+$/.test(\n      workingId.slice(indexSeparator + EPHEMERAL_AGENT_INDEX_SEPARATOR.length)\n    )\n  ) {\n    workingId = workingId.slice(0, indexSeparator);\n  }\n  const senderSeparator = workingId.indexOf(EPHEMERAL_AGENT_SENDER_SEPARATOR);\n  if (senderSeparator <= 0) {\n    return undefined;\n  }\n  const encodedPrefix = workingId.slice(0, senderSeparator);\n  if (/\\s/.test(encodedPrefix)) {\n    return undefined;\n  }\n  const prefixParts = encodedPrefix.split('__');\n  if (prefixParts.length < 2 || prefixParts.some((part) => part === '')) {\n    return undefined;\n  }\n  const sender = workingId\n    .slice(senderSeparator + EPHEMERAL_AGENT_SENDER_SEPARATOR.length)\n    .replace(/__/g, ':');\n  return sender === '' ? undefined : sender;\n}\n\n/** Workflow-agent node spans are always children of the run's root chain and\n *  always carry `langgraph_node` metadata equal to their name, so host-named\n *  run roots (`LibreChat Agent: <name>`) and ordinary chains that merely look\n *  like encoded ids (`pipeline__stage___EU`) are never rename candidates.\n *  Successful decodes become `agent` observations, matching the inner\n *  `agent=<id>` node shaping. */\nfunction shapeEphemeralAgentNodeSpan(span: MutableSpan): void {\n  if (isToolSpan(span) || isRootSpan(span) || !isWorkflowNodeSpan(span)) {\n    return;\n  }\n  const sender = extractEphemeralAgentSender(span.name);\n  if (sender == null) {\n    return;\n  }\n  span.name = sender;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction hasTraceTag(span: MutableSpan, expectedTag: string): boolean {\n  const tags = parseAttributeValue(\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_TAGS]\n  );\n  return (\n    Array.isArray(tags) &&\n    tags.some((tag) => typeof tag === 'string' && tag === expectedTag)\n  );\n}\n\nfunction shapeRootObservationType(span: MutableSpan): void {\n  if (isGenerationSpan(span)) {\n    return;\n  }\n  if (\n    hasTraceTag(span, TITLE_TRACE_TAG) ||\n    (span.name === ACTIVITY_PHASE_ROOT_NAME &&\n      hasTraceTag(span, ACTIVITY_PHASE_TRACE_TAG))\n  ) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      CHAIN_OBSERVATION_TYPE;\n    return;\n  }\n  if (hasTraceTag(span, AGENT_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      ROOT_OBSERVATION_TYPE;\n  }\n}\n\n/**\n * Reshapes spans per Langfuse-team feedback before export:\n * - `agent=<id>` / `tools=<id>` node names carry the ephemeral agent id\n *   (`provider__model`) — strip it so switching models doesn't break\n *   name-based logic (item 1). The outer workflow node is named with the\n *   bare agent id; ephemeral ids reduce to their stable sender name.\n * - LLM generation spans keep the provider client class name (`ChatOpenAI`,\n *   `AzureChatOpenAI`, …); rename them to a provider-agnostic `llm` so the\n *   name reflects the operation, not the model (the model stays on the\n *   generation's model attribute).\n * - Agent nodes become `agent` observations, while tool-dispatch nodes become\n *   stable `chain` observations whose input is scoped to the pending calls.\n *   Individual child calls remain `tool` observations (items 3 & 4).\n * - Agent trace roots become `agent` observations, while title and activity\n *   summary roots become `chain` observations. Root and trace input/output are\n *   reduced to the user question and assistant response when chat messages are\n *   available (item 2).\n */\nexport function shapeLangfuseSpan(span: ReadableSpan): void {\n  const mutable = span as MutableSpan;\n  if (mutable.name.startsWith(LANGGRAPH_AGENT_NODE_PREFIX)) {\n    shapeAgentNodeSpan(mutable);\n  } else if (mutable.name.startsWith(LANGGRAPH_TOOL_NODE_PREFIX)) {\n    shapeToolNodeSpan(mutable);\n  } else if (isGenerationSpan(mutable)) {\n    mutable.name = GENERATION_SPAN_NAME;\n  } else {\n    shapeEphemeralAgentNodeSpan(mutable);\n  }\n  if (!isRootSpan(span)) {\n    return;\n  }\n  shapeRootObservationType(mutable);\n  shapeRootSpan(mutable);\n}\n"],"mappings":"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"}

package/dist/cjs/run.cjs

@@ -39,11 +39,14 @@ const defaultOmitOptions = new Set([
 	"maxOutputTokens",
 	"additionalModelRequestFields"
 ]);
+const ACTIVITY_LABEL_TRACE_NAME = "LibreChat Activity Label";
+const ACTIVITY_PHASE_TRACE_NAME = "LibreChat Activity Phase";
 const CUSTOM_GRAPH_EVENTS = new Set([
 	"on_agent_update",
 	"on_run_step",
 	"on_run_step_delta",
 	"on_run_step_completed",
+	"on_run_step_closed",
 	"on_message_delta",
 	"on_reasoning_delta",
 	"on_tool_execute",
@@ -58,6 +61,7 @@ const CUSTOM_GRAPH_EVENTS = new Set([
 const DIRECT_DISPATCHED_STEP_EVENTS = new Set([
 	"on_run_step",
 	"on_run_step_delta",
+	"on_run_step_closed",
 	"on_message_delta",
 	"on_reasoning_delta"
 ]);
@@ -66,6 +70,25 @@ function getStepScopedEventId(data) {
 	const candidate = data;
 	return typeof candidate.id === "string" ? candidate.id : void 0;
 }
+/**
+* Narrows an ON_RUN_STEP_COMPLETED payload (`{ result: ToolCompleteEvent }`)
+* to the ids step closure needs. Returns undefined for malformed payloads and
+* the resume race's empty step id.
+*/
+function getToolCompletion(data) {
+	if (data == null || typeof data !== "object") return;
+	const { result } = data;
+	if (result == null || typeof result !== "object") return;
+	const candidate = result;
+	if (typeof candidate.id !== "string" || candidate.id === "") return;
+	const toolCallId = candidate.tool_call?.id;
+	const completedAt = candidate.completed_at;
+	return {
+		stepId: candidate.id,
+		...typeof toolCallId === "string" ? { toolCallId } : {},
+		...typeof completedAt === "number" ? { completedAt } : {}
+	};
+}
 function isLangGraphResumeMapForInterrupt(value, interruptId) {
 	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
 	return Object.prototype.hasOwnProperty.call(value, interruptId);
@@ -464,7 +487,32 @@ var Run = class Run {
 			const stepScopedEventId = getStepScopedEventId(data);
 			if (DIRECT_DISPATCHED_STEP_EVENTS.has(eventName) && this.Graph != null && stepScopedEventId != null && this.Graph.hasHandlerDispatchedEvent(eventName, stepScopedEventId)) return;
 			const handler = this.handlerRegistry?.getHandler(eventName);
-			if (handler && this.Graph) return await handler.handle(eventName, data, metadata, this.Graph);
+			/**
+			* Tool completions arriving over the custom-event channel are the only
+			* signal ToolNode (which holds no graph reference) emits — observe them
+			* here to drive step closure. Runs in `finally`, independent of handler
+			* registration, so an absent or throwing host handler cannot lose the
+			* close; duplicate callback echoes are absorbed by the terminal-status
+			* guard in `closeRunStep`.
+			*/
+			try {
+				if (handler && this.Graph) return await handler.handle(eventName, data, metadata, this.Graph);
+			} finally {
+				if (eventName === "on_run_step_completed" && this.Graph != null) {
+					const completion = getToolCompletion(data);
+					if (completion != null)
+ /**
+					* The producer stamped `completed_at` before dispatch. Carrying it
+					* through keeps the recorded duration the tool's, not the host
+					* handler's — this runs after an arbitrarily slow handler resolves.
+					*/
+					await this.Graph.recordStepCompletion(completion.stepId, {
+						toolCallId: completion.toolCallId,
+						metadata,
+						at: completion.completedAt
+					});
+				}
+			}
 		};
 	}
 	shouldClearHookSession(streamThrew) {
@@ -473,6 +521,18 @@ var Run = class Run {
 	isAwaitingResume(streamThrew) {
 		return this._interrupt != null && this._haltedReason == null && !streamThrew;
 	}
+	/**
+	* Terminal status for steps still open at end-of-run: `cancelled` for
+	* intentional stops (caller abort, hook halt), `failed` for unexpected
+	* stream errors, `completed` for a natural finish. Reads `_haltedReason`
+	* behind a method boundary on purpose — it is assigned inside the
+	* `consumeStream` closure, which control-flow narrowing cannot see.
+	*/
+	resolveSweepStatus(streamThrew, streamAborted) {
+		if (streamThrew) return streamAborted ? "cancelled" : "failed";
+		if (this._haltedReason != null) return "cancelled";
+		return "completed";
+	}
 	getStreamLangfuseConfig(graph) {
 		const primaryContext = graph.agentContexts.get(graph.defaultAgentId);
 		if (primaryContext != null) return require_langfuseConfig.resolveLangfuseConfig(this.langfuse, primaryContext.langfuse);
@@ -644,6 +704,14 @@ var Run = class Run {
 		* preserving session hooks would leak them into the next run.
 		*/
 		let streamThrew = false;
+		let streamAborted = false;
+		/**
+		* When the stream itself ended — captured before the post-stream work in
+		* the `finally` (Stop/StopFailure hooks, Langfuse disposal, which can
+		* force-flush) so a slow hook cannot inflate the terminal stamps that the
+		* sweep writes onto steps that were still open.
+		*/
+		let terminalAt;
 		const consumeStream = async () => {
 			/**
 			* `streamEvents` accepts both state inputs and `Command` (resume) at
@@ -700,9 +768,22 @@ var Run = class Run {
 						};
 					}
 				}
+				/**
+				* Stamped before the handler runs: the close below happens after an
+				* arbitrarily slow host handler resolves, and the step's duration
+				* should end when the model did, not when the host finished with it.
+				*/
+				const modelEndAt = eventName === "on_chat_model_end" ? Date.now() : void 0;
 				const handler = this.handlerRegistry?.getHandler(eventName);
 				if (handler) await handler.handle(eventName, data, metadata, this.Graph);
 				/**
+				* A finished model call ends its lane's open message step. Placed
+				* here — not in `ModelEndHandler` — because hosts replace the
+				* CHAT_MODEL_END handler with their own instance, which would
+				* silently drop the close.
+				*/
+				if (eventName === "on_chat_model_end" && this.Graph != null) await this.Graph.closeOpenMessageStep(metadata, modelEndAt);
+				/**
 				* Mid-flight halt: any hook (PreToolUse, PostToolUse,
 				* PostToolBatch, SubagentStart/Stop, PreCompact, PostCompact)
 				* that returned `preventContinuation: true` raises a halt
@@ -729,6 +810,7 @@ var Run = class Run {
 					break;
 				}
 			}
+			terminalAt = Date.now();
 			if (this._interrupt != null) await this.resolveInterruptResumeConfig(config);
 			/**
 			* Skip the Stop hook when the run paused on a HITL interrupt
@@ -787,7 +869,16 @@ var Run = class Run {
 				tags: ["librechat", "agent"]
 			}, consumeStream));
 		} catch (err) {
+			terminalAt = Date.now();
 			streamThrew = true;
+			/**
+			* Corroborate cancellation against an actually-aborted signal. A
+			* provider SDK or host handler can reject with an `AbortError` while
+			* nothing was cancelled — that is an unexpected failure (it also fires
+			* `StopFailure`), and naming it `cancelled` would misreport abort
+			* forensics.
+			*/
+			streamAborted = config.signal?.aborted === true || this.Graph.signal?.aborted === true;
 			if (this.hookRegistry?.hasHookFor("StopFailure", this.id) === true) {
 				const runMessages = this.Graph.getRunMessages() ?? [];
 				await require_executeHooks.executeHooks({
@@ -831,6 +922,21 @@ var Run = class Run {
 			this.hookRegistry?.clearHaltSignal(this.id);
 			await require_langfuse.disposeLangfuseHandler(langfuseHandler);
 			/**
+			* Terminal sweep: close every step that never reached a terminal
+			* status — `completed` on a natural end, `cancelled` on caller abort
+			* or hook halt, `failed` on an unexpected stream error. Skipped on a
+			* HITL pause, where the open steps continue after `resume()`.
+			*
+			* Runs BEFORE the callback teardown below, so a caller observing
+			* lifecycle events only through `RunnableConfig.callbacks` still
+			* receives these closures rather than being left with unmatched
+			* starts, and before `getContentParts()` so terminal stamps flow into
+			* content and session serialization.
+			*/
+			if (!this.isAwaitingResume(streamThrew)) try {
+				await this.Graph.closeUnfinishedRunSteps(this.resolveSweepStatus(streamThrew, streamAborted), terminalAt);
+			} catch {}
+			/**
 			* Break the reference chain that keeps heavy data alive via
 			* LangGraph's internal `__pregel_scratchpad.currentTaskInput` →
 			* `@langchain/core` `RunTree.extra[lc:child_config]` →
@@ -1190,17 +1296,40 @@ var Run = class Run {
 		*  than the labeled agent's. Skip generation entirely instead. */
 		if (agentId != null && requestedContext == null) return {};
 		const labelContext = this.Graph == null ? void 0 : requestedContext ?? this.Graph.agentContexts.get(this.Graph.defaultAgentId);
-		const traceMetadata = require_langfuse.createLangfuseTraceMetadata({
-			messageId: "activity-label-" + this.id,
-			agentName: labelContext?.name
-		});
-		const labelRunName = require_langfuse.getLangfuseTraceName(traceMetadata, "LibreChat Activity Label");
 		/** Shallow-cloned: activity labels run once per tool batch, and writing
 		*  the Langfuse handler back onto a host-reused `chainOptions` would
 		*  accumulate duplicate callbacks across batches. */
 		const labelChainOptions = { ...chainOptions ?? {} };
 		const labelUserId = typeof labelChainOptions.configurable?.user_id === "string" ? labelChainOptions.configurable.user_id : void 0;
 		const labelSessionId = typeof labelChainOptions.configurable?.thread_id === "string" ? labelChainOptions.configurable.thread_id : void 0;
+		const labelIndex = labelSeq - 1;
+		const labelParentMessageId = labelChainOptions.configurable?.requestBody?.parentMessageId;
+		/** An omitted `agentId` is attributable only when exactly one context
+		*  exists. Multi-agent callers remain unattributed instead of being
+		*  incorrectly assigned to the graph's default agent. */
+		const labelAgentId = agentId ?? (this.Graph?.agentContexts.size === 1 ? this.Graph.defaultAgentId : void 0);
+		const labelAgentName = labelAgentId == null ? void 0 : labelContext?.name;
+		const labelMetadata = {
+			sourceRunId: this.id,
+			responseId: this.id,
+			activityIndex: labelIndex,
+			...typeof labelParentMessageId === "string" ? { parentMessageId: labelParentMessageId } : {},
+			...labelAgentId == null ? {} : { agentId: labelAgentId },
+			...labelAgentName == null ? {} : { agentName: labelAgentName }
+		};
+		const traceMetadata = {
+			...require_langfuse.createLangfuseTraceMetadata({
+				messageId: "activity-label-" + this.id,
+				parentMessageId: labelParentMessageId,
+				agentId: labelAgentId,
+				agentName: labelAgentName
+			}),
+			sourceRunId: this.id,
+			responseId: this.id,
+			activityIndex: String(labelIndex)
+		};
+		const labelRunName = labelChainOptions.runName ?? ACTIVITY_LABEL_TRACE_NAME;
+		const labelTags = ["librechat", "activity-label"];
 		const labelLangfuseConfig = require_langfuseConfig.resolveLangfuseConfig(this.langfuse, labelContext?.langfuse);
 		require_instrumentation.initializeLangfuseTracing(labelLangfuseConfig);
 		/** Seed policy, threading two constraints:
@@ -1236,11 +1365,11 @@ var Run = class Run {
 			userId: labelUserId,
 			sessionId: labelSessionId,
 			traceMetadata,
-			tags: ["librechat", "activity-label"],
+			tags: labelTags,
 			traceIdSeed: labelLangfuseConfig?.deterministicTraceId === true ? labelTraceSeed : void 0,
 			runId: labelScopeRunId,
 			toolOutputTracing: labelRuntimeScope.toolOutputTracing,
-			traceName: labelChainOptions.runName ?? labelRunName
+			traceName: labelRunName
 		});
 		if (labelLangfuseHandler != null) labelChainOptions.callbacks = require_callbacks.appendCallbacks(labelChainOptions.callbacks, [labelLangfuseHandler]);
 		/** The label prompt becomes Langfuse generation input, so the resolved
@@ -1293,15 +1422,20 @@ var Run = class Run {
 		const invokeConfig = Object.assign({}, labelChainOptions, {
 			run_id: labelRunId,
 			runId: labelRunId,
-			runName: labelChainOptions.runName ?? labelRunName
+			runName: labelRunName,
+			tags: [...new Set([...labelChainOptions.tags ?? [], ...labelTags])],
+			metadata: {
+				...labelChainOptions.metadata ?? {},
+				...labelMetadata
+			}
 		});
 		const invokeLabel = (runtimeConfig) => require_langfuse.withLangfuseAttributes({
 			langfuse: labelLangfuseConfig,
 			userId: labelUserId,
 			sessionId: labelSessionId,
-			traceName: runtimeConfig.runName ?? labelRunName,
+			traceName: labelRunName,
 			traceMetadata,
-			tags: ["librechat", "activity-label"]
+			tags: labelTags
 		}, () => model.invoke([new _langchain_core_messages.SystemMessage(prompt ?? require_activityLabel.ACTIVITY_LABEL_PROMPT), new _langchain_core_messages.HumanMessage(userPrompt)], runtimeConfig));
 		const extractLabel = (response) => {
 			const content = response?.content;
@@ -1339,7 +1473,7 @@ var Run = class Run {
 	}
 	/**
 	* Generates one parent summary for two or more logical activities. The
-	* summary model is traced as a dedicated activity-phase agent root in the
+	* summary model is traced as a dedicated activity-phase chain root in the
 	* conversation session, with the model callback recorded as its generation
 	* child. No session id means no phase trace, avoiding orphan observations.
 	*/
@@ -1417,8 +1551,7 @@ var Run = class Run {
 			...contributingAgentIds.length === 0 ? {} : { contributingAgentIds: contributingAgentIds.join(",") },
 			...closingTextPhase == null ? {} : { closingTextPhase }
 		};
-		const phaseRunName = require_langfuse.getLangfuseTraceName(traceMetadata, "LibreChat Activity Phase");
-		const phaseTraceName = phaseChainOptions.runName ?? phaseRunName;
+		const phaseTraceName = phaseChainOptions.runName ?? ACTIVITY_PHASE_TRACE_NAME;
 		const phaseTags = [
 			"librechat",
 			"activity-phase",