@librechat/agents 3.3.6 → 3.3.8

package/dist/esm/summarization/node.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.mjs","names":["chunkAny"],"sources":["../../../src/summarization/node.ts"],"sourcesContent":["import {\n  AIMessage,\n  ToolMessage,\n  HumanMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { UsageMetadata, BaseMessage } from '@langchain/core/messages';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type { HookRegistry } from '@/hooks';\nimport type { OnChunk } from '@/llm/invoke';\nimport type * as t from '@/types';\nimport {\n  cloneToolMessageWithContent,\n  compactToolContent,\n  isComputerCallOutputMessage,\n  serializeToolContentBounded,\n} from '@/utils/toolContent';\nimport {\n  addTailCacheControl,\n  resolvePromptCacheTtl,\n  type PromptCacheTtl,\n} from '@/messages/cache';\nimport {\n  DEFAULT_RETAIN_RECENT_TURNS,\n  splitAtRecencyBoundary,\n} from '@/messages/recency';\nimport {\n  Constants,\n  ContentTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n} from '@/common';\nimport { safeDispatchCustomEvent, emitAgentLog } from '@/utils/events';\nimport { attemptInvoke, tryFallbackProviders } from '@/llm/invoke';\nimport { calculateMaxToolResultChars } from '@/utils/truncation';\nimport { createRemoveAllMessage } from '@/messages/reducer';\nimport { getMaxOutputTokensKey } from '@/llm/request';\nimport { initializeModel } from '@/llm/init';\nimport { getChunkContent } from '@/stream';\nimport { executeHooks } from '@/hooks';\n\nconst SUMMARIZATION_PARAM_KEYS = new Set(['maxSummaryTokens']);\n\n/**\n * Default number of recent user-led turns preserved verbatim during\n * compaction.  A turn begins at a HumanMessage and includes every\n * following AIMessage and ToolMessage up to the next HumanMessage.\n * The most recent turn is always retained regardless of this value;\n * the default of `2` additionally keeps the prior exchange so the\n * model has fresh context on what just happened.  Setting\n * `retainRecent.turns` to `0` reverts to the legacy \"summarize every\n * message\" behavior.\n */\n/**\n * Token overhead of the XML wrapper + instruction text added around the\n * summary at injection time in AgentContext.buildSystemRunnable:\n * `<summary>\\n${text}\\n</summary>\\n\\nYour context window was compacted...`\n * ~33 tokens on Anthropic, ~24-27 on OpenAI.  Using 33 as a safe ceiling.\n */\nconst SUMMARY_WRAPPER_OVERHEAD_TOKENS = 33;\n\n/** Structured checkpoint prompt for fresh summarization (no prior summary). */\nexport const DEFAULT_SUMMARIZATION_PROMPT = `Hold on, before you continue I need you to write me a checkpoint of everything so far. Your context window is filling up and this checkpoint replaces the messages above, so capture everything you need to pick right back up.\n\nDon't second-guess or fact-check anything you did, your tool results reflect exactly what happened. If a tool result appears truncated, that's just a display artifact from context management: the tool executed fully. Just record what you did and what you observed. Only the checkpoint, don't respond to me or continue the conversation.\n\n## Checkpoint\n\n## Goal\nWhat I asked you to do and any sub-goals you identified.\n\n## Constraints & Preferences\nAny rules, preferences, or configuration I established.\n\n## Progress\n### Done\n- What you completed and the outcomes\n\n### In Progress\n- What you're currently working on\n\n## Key Decisions\nDecisions you made and why.\n\n## Next Steps\nConcrete task actions remaining, in priority order.\n\n## Critical Context\nExact identifiers, names, error messages, URLs, and details you need to preserve verbatim.\n\nRules:\n- Record what you did and observed, don't judge or re-evaluate it\n- For each tool call: the tool name, key inputs, and the outcome\n- Preserve exact identifiers, names, errors, and references verbatim\n- Short declarative sentences\n- Skip empty sections`;\n\n/** Prompt for re-compaction when a prior summary exists. */\nexport const DEFAULT_UPDATE_SUMMARIZATION_PROMPT = `Hold on again, update your checkpoint. Merge the new messages into your existing checkpoint and give me a single consolidated replacement.\n\nKeep it roughly the same length as your last checkpoint. Compress older details to make room for what's new, don't just append. Give recent actions more detail, compress older items to one-liners.\n\nDon't fact-check or second-guess anything, your tool results are ground truth. If a tool result appears truncated, that's just a display artifact: the tool executed fully. Only the checkpoint, don't respond to me or continue the conversation.\n\nRules:\n- Merge new progress into existing sections, don't duplicate headers\n- Compress older completed items into one-line entries\n- Move items from \"In Progress\" to \"Done\" when you completed them\n- Update \"Next Steps\" to reflect current task priorities.\n- For each new tool call: the tool name, key inputs, and the outcome\n- Preserve exact identifiers, names, errors, and references verbatim\n- Skip empty sections`;\n\nfunction separateParameters(parameters: Record<string, unknown>): {\n  llmParams: Record<string, unknown>;\n  maxSummaryTokens?: number;\n} {\n  const llmParams: Record<string, unknown> = {};\n  let maxSummaryTokens: number | undefined;\n\n  for (const [key, value] of Object.entries(parameters)) {\n    if (SUMMARIZATION_PARAM_KEYS.has(key)) {\n      if (\n        key === 'maxSummaryTokens' &&\n        typeof value === 'number' &&\n        value > 0\n      ) {\n        maxSummaryTokens = value;\n      }\n    } else {\n      llmParams[key] = value;\n    }\n  }\n\n  return { llmParams, maxSummaryTokens };\n}\n\n/**\n * Generates a structural metadata summary without making an LLM call.\n * Used as a last-resort fallback when all summarization attempts fail.\n * Preserves tool names and message counts so the agent retains basic context.\n */\nfunction generateMetadataStub(messages: BaseMessage[]): string {\n  const counts: Record<string, number> = {};\n  const toolNames = new Set<string>();\n\n  for (const msg of messages) {\n    const role = msg.getType();\n    counts[role] = (counts[role] ?? 0) + 1;\n\n    if (role === 'tool' && msg.name != null && msg.name !== '') {\n      toolNames.add(msg.name);\n    }\n\n    if (\n      role === 'ai' &&\n      msg instanceof AIMessage &&\n      msg.tool_calls &&\n      msg.tool_calls.length > 0\n    ) {\n      for (const tc of msg.tool_calls) {\n        toolNames.add(tc.name);\n      }\n    }\n  }\n\n  const countParts = Object.entries(counts)\n    .map(([role, count]) => `${count} ${role}`)\n    .join(', ');\n\n  const lines = [\n    `[Metadata summary: ${messages.length} messages (${countParts})]`,\n  ];\n\n  if (toolNames.size > 0) {\n    lines.push(`[Tools used: ${Array.from(toolNames).join(', ')}]`);\n  }\n\n  return lines.join('\\n');\n}\n\n/** Maximum number of tool failures to include in the enrichment section. */\nconst MAX_TOOL_FAILURES = 8;\n/** Maximum chars per failure summary line. */\nconst MAX_TOOL_FAILURE_CHARS = 240;\n\n/**\n * Extracts failed tool results from messages and formats them as a structured\n * section. LLMs often omit specific failure details (exit codes, error messages)\n * from their summaries, this mechanical enrichment guarantees they survive.\n */\nfunction extractToolFailuresSection(messages: BaseMessage[]): string {\n  const failures: Array<{ toolName: string; summary: string }> = [];\n  const seen = new Set<string>();\n\n  for (const msg of messages) {\n    if (msg.getType() !== 'tool') {\n      continue;\n    }\n    const toolMsg = msg as ToolMessage;\n    if (toolMsg.status !== 'error') {\n      continue;\n    }\n    // Deduplicate by tool_call_id\n    const callId = toolMsg.tool_call_id;\n    if (callId && seen.has(callId)) {\n      continue;\n    }\n    if (callId) {\n      seen.add(callId);\n    }\n\n    const toolName = toolMsg.name ?? 'tool';\n    const content = serializeToolContentBounded(\n      toolMsg.content,\n      MAX_TOOL_FAILURE_CHARS * 4\n    );\n    const normalized = content.replace(/\\s+/g, ' ').trim();\n    const summary =\n      normalized.length > MAX_TOOL_FAILURE_CHARS\n        ? `${normalized.slice(0, MAX_TOOL_FAILURE_CHARS - 3)}...`\n        : normalized;\n\n    failures.push({ toolName, summary });\n  }\n\n  if (failures.length === 0) {\n    return '';\n  }\n\n  const lines = failures\n    .slice(0, MAX_TOOL_FAILURES)\n    .map((f) => `- ${f.toolName}: ${f.summary}`);\n  if (failures.length > MAX_TOOL_FAILURES) {\n    lines.push(`- ...and ${failures.length - MAX_TOOL_FAILURES} more`);\n  }\n\n  return `\\n\\n## Tool Failures\\n${lines.join('\\n')}`;\n}\n\n/**\n * Appends mechanical enrichment sections to an LLM-generated summary.\n * Tool failures are appended verbatim because LLMs often omit specific\n * error details from their summaries.\n */\nfunction enrichSummary(summaryText: string, messages: BaseMessage[]): string {\n  return summaryText + extractToolFailuresSection(messages);\n}\n\n/**\n * Restores pre-masking tool content onto the messages array using\n * `pendingOriginalToolContent` stored on AgentContext. Only allocates\n * a new array when there are entries to restore; otherwise returns the\n * input reference unchanged.\n */\nfunction restoreOriginalToolContent(\n  messages: BaseMessage[],\n  originalToolContent: Map<number, string> | undefined,\n  maxContextTokens?: number\n): BaseMessage[] {\n  if (originalToolContent == null || originalToolContent.size === 0) {\n    return messages;\n  }\n\n  const restorable: Array<{\n    index: number;\n    message: ToolMessage;\n    content: string;\n  }> = [];\n  for (const [index, content] of originalToolContent) {\n    const message = messages[index];\n    if (\n      message instanceof ToolMessage &&\n      !isComputerCallOutputMessage(message)\n    ) {\n      restorable.push({ index, message, content });\n    }\n  }\n  if (restorable.length === 0) {\n    return messages;\n  }\n\n  /**\n   * Restored originals improve checkpoint quality, but they still feed a\n   * provider call. Share one tool-result budget across every restoration so\n   * several previously masked results cannot overflow the summarizer.\n   */\n  let remainingChars = calculateMaxToolResultChars(maxContextTokens);\n  const restored = [...messages];\n  for (let i = 0; i < restorable.length; i++) {\n    const { index, message, content } = restorable[i];\n    const maxChars = Math.floor(remainingChars / (restorable.length - i));\n    const compacted = compactToolContent(content, maxChars).content;\n    restored[index] = cloneToolMessageWithContent(message, compacted);\n    remainingChars -= serializeToolContentBounded(compacted, maxChars).length;\n  }\n  return restored;\n}\n\n// ---------------------------------------------------------------------------\n// Extracted helpers for createSummarizeNode\n// ---------------------------------------------------------------------------\n\ninterface SummarizationClientConfig {\n  provider: string;\n  modelName?: string;\n  clientOptions: Record<string, unknown>;\n  effectiveMaxSummaryTokens?: number;\n  promptText: string;\n  updatePromptText: string;\n}\n\n/** Assembles the summarization model's client options from agent and config. */\nfunction buildSummarizationClientConfig(\n  agentContext: AgentContext,\n  summarizationConfig?: t.SummarizationConfig\n): SummarizationClientConfig {\n  const provider = (summarizationConfig?.provider ??\n    agentContext.provider) as string;\n  const modelName = summarizationConfig?.model;\n  const parameters = summarizationConfig?.parameters ?? {};\n  const promptText =\n    summarizationConfig?.prompt ?? DEFAULT_SUMMARIZATION_PROMPT;\n  const updatePromptText =\n    summarizationConfig?.updatePrompt ?? DEFAULT_UPDATE_SUMMARIZATION_PROMPT;\n\n  const { llmParams, maxSummaryTokens: paramMaxSummaryTokens } =\n    separateParameters(parameters);\n\n  const isSelfSummarize = provider === (agentContext.provider as string);\n  const baseOptions =\n    isSelfSummarize && agentContext.clientOptions\n      ? { ...agentContext.clientOptions }\n      : {};\n\n  const clientOptions: Record<string, unknown> = {\n    ...baseOptions,\n    ...llmParams,\n  };\n\n  if (modelName != null && modelName !== '') {\n    clientOptions.model = modelName;\n    clientOptions.modelName = modelName;\n  }\n\n  const effectiveMaxSummaryTokens =\n    paramMaxSummaryTokens ?? summarizationConfig?.maxSummaryTokens;\n\n  if (effectiveMaxSummaryTokens != null) {\n    clientOptions[getMaxOutputTokensKey(provider)] = effectiveMaxSummaryTokens;\n  }\n\n  return {\n    provider,\n    modelName,\n    clientOptions,\n    effectiveMaxSummaryTokens,\n    promptText,\n    updatePromptText,\n  };\n}\n\n/** Computes the token count for a summary, preferring provider output tokens when available. */\nfunction computeSummaryTokenCount(\n  summaryText: string,\n  summaryUsage: Partial<UsageMetadata> | undefined,\n  tokenCounter?: (message: BaseMessage) => number\n): number {\n  const providerOutputTokens = Number(summaryUsage?.output_tokens) || 0;\n  if (providerOutputTokens > 0) {\n    return providerOutputTokens + SUMMARY_WRAPPER_OVERHEAD_TOKENS;\n  }\n  if (tokenCounter) {\n    return (\n      tokenCounter(new SystemMessage(summaryText)) +\n      SUMMARY_WRAPPER_OVERHEAD_TOKENS\n    );\n  }\n  return 0;\n}\n\n/** Constructs the SummaryContentBlock persisted in the run step and dispatched to events. */\nfunction buildSummaryBlock(params: {\n  summaryText: string;\n  tokenCount: number;\n  stepId: string;\n  stepIndex: number;\n  modelName?: string;\n  provider: string;\n  summaryVersion: number;\n}): t.SummaryContentBlock {\n  return {\n    type: ContentTypes.SUMMARY,\n    content: [\n      {\n        type: ContentTypes.TEXT,\n        text: params.summaryText,\n      } as t.MessageContentComplex,\n    ],\n    tokenCount: params.tokenCount,\n    summaryVersion: params.summaryVersion,\n    boundary: {\n      messageId: params.stepId,\n      contentIndex: params.stepIndex,\n    },\n    model: params.modelName,\n    provider: params.provider,\n    createdAt: new Date().toISOString(),\n  };\n}\n\ntype LogFn = (\n  level: 'debug' | 'info' | 'warn' | 'error',\n  message: string,\n  data?: Record<string, unknown>\n) => void;\n\n/**\n * Extracts an HTTP status code from a thrown LLM-provider error. Returns\n * `undefined` for non-object values (including `null` or `undefined`, both\n * valid `throw` targets in JS) so callers never dereference a nullish\n * value.\n */\nfunction extractHttpStatus(err: unknown): number | undefined {\n  if (err == null || typeof err !== 'object') {\n    return undefined;\n  }\n  const errRecord = err as Record<string, unknown>;\n  const direct = errRecord.status;\n  if (typeof direct === 'number') {\n    return direct;\n  }\n  const statusCode = errRecord.statusCode;\n  if (typeof statusCode === 'number') {\n    return statusCode;\n  }\n  const response = errRecord.response;\n  if (response != null && typeof response === 'object') {\n    const nested = (response as Record<string, unknown>).status;\n    if (typeof nested === 'number') {\n      return nested;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Formats a provider-level error for logging. Returns both a human-readable\n * suffix (safe to include in the message string so it survives any host-side\n * formatter) and a structured metadata bag for rich log backends.\n */\nfunction describeProviderError(\n  err: unknown,\n  provider: string,\n  modelName?: string\n): { suffix: string; data: Record<string, unknown> } {\n  const providerLabel = `${provider}/${modelName ?? '(no-model)'}`;\n  const errMsg = err instanceof Error ? err.message : String(err);\n\n  const data: Record<string, unknown> = {\n    provider,\n    model: modelName,\n  };\n  if (err instanceof Error) {\n    data.errorName = err.name;\n    data.errorStack = err.stack;\n  }\n\n  const status = extractHttpStatus(err);\n  const statusSuffix = status != null ? ` (HTTP ${status})` : '';\n  if (status != null) {\n    data.status = status;\n  }\n\n  return {\n    suffix: `[${providerLabel}]${statusSuffix}: ${errMsg}`,\n    data,\n  };\n}\n\n/**\n * Formats an exhausted-fallback error. `tryFallbackProviders` throws the\n * last fallback provider's error, which may be from any of the configured\n * fallbacks — not the primary — so we label the log with the list of\n * fallback providers attempted rather than mis-attributing to the primary.\n *\n * Entries in `fallbacks` are normally strongly typed, but we defend against\n * malformed runtime config (null/undefined entries, missing `provider`\n * field) so a recoverable summarization failure is never promoted to an\n * uncaught exception from inside the logging path.\n */\nfunction describeFallbackError(\n  err: unknown,\n  fallbacks: unknown\n): { suffix: string; data: Record<string, unknown> } {\n  const errMsg = err instanceof Error ? err.message : String(err);\n  const list: ReadonlyArray<unknown> = Array.isArray(fallbacks)\n    ? fallbacks\n    : [];\n  const providerNames = list\n    .map((f) => {\n      if (f == null || typeof f !== 'object') {\n        return undefined;\n      }\n      const raw = (f as { provider?: unknown }).provider;\n      return raw != null ? String(raw) : undefined;\n    })\n    .filter((p): p is string => typeof p === 'string');\n  const label =\n    providerNames.length > 0\n      ? `fallbacks=[${providerNames.join(',')}]`\n      : 'no-fallbacks';\n\n  const data: Record<string, unknown> = {\n    fallbackProviders: providerNames,\n    fallbackCount: list.length,\n  };\n  if (err instanceof Error) {\n    data.errorName = err.name;\n    data.errorStack = err.stack;\n  }\n  const status = extractHttpStatus(err);\n  const statusSuffix = status != null ? ` (HTTP ${status})` : '';\n  if (status != null) {\n    data.status = status;\n  }\n\n  return {\n    suffix: `[${label}]${statusSuffix}: ${errMsg}`,\n    data,\n  };\n}\n\n/**\n * Runs the summarization LLM call with primary + fallback providers,\n * falling back to a metadata stub when all calls fail.\n */\nasync function executeSummarizationWithFallback(params: {\n  agentContext: AgentContext;\n  messages: BaseMessage[];\n  clientConfig: SummarizationClientConfig;\n  summarizeConfig?: RunnableConfig;\n  stepId: string;\n  usePromptCache: boolean;\n  log: LogFn;\n}): Promise<{\n  text: string;\n  usage?: Partial<UsageMetadata>;\n  /**\n   * True when every model call failed and `text` is the generated metadata\n   * stub rather than a real summary. Callers that would replace history with\n   * this need to know it carries none of the original content.\n   */\n  usedMetadataStub?: boolean;\n}> {\n  const {\n    agentContext,\n    messages,\n    clientConfig,\n    summarizeConfig,\n    stepId,\n    usePromptCache,\n    log,\n  } = params;\n\n  const priorSummaryText = agentContext.getSummaryText()?.trim() ?? '';\n\n  let summaryText = '';\n  let summaryUsage: Partial<UsageMetadata> | undefined;\n  let usedMetadataStub = false;\n\n  try {\n    /**\n     * Initialize inside the try so that a misconfigured provider\n     * (e.g. an unrecognized summarization.provider) surfaces through the\n     * `log('error', ...)` path below rather than bubbling up silently.\n     */\n    const summarizationModel = initializeModel({\n      provider: clientConfig.provider as Providers,\n      clientOptions: clientConfig.clientOptions as t.ClientOptions,\n      tools: agentContext.getToolsForBinding(),\n    }) as t.ChatModel;\n\n    const result = await summarizeWithCacheHit({\n      model: summarizationModel,\n      messages,\n      promptText: clientConfig.promptText,\n      updatePromptText: clientConfig.updatePromptText,\n      priorSummaryText,\n      config: summarizeConfig,\n      stepId,\n      provider: clientConfig.provider as Providers,\n      reasoningKey: agentContext.reasoningKey,\n      usePromptCache,\n      promptCacheTtl:\n        (clientConfig.provider as Providers) === Providers.ANTHROPIC ||\n        (clientConfig.provider as Providers) === Providers.OPENROUTER\n          ? resolvePromptCacheTtl(\n            (\n                clientConfig.clientOptions as {\n                  promptCacheTtl?: PromptCacheTtl;\n                }\n            ).promptCacheTtl\n          )\n          : undefined,\n      log,\n    });\n    summaryText = result.text;\n    summaryUsage = result.usage;\n  } catch (primaryError) {\n    const primaryDescribed = describeProviderError(\n      primaryError,\n      clientConfig.provider,\n      clientConfig.modelName\n    );\n    log('error', `Summarization LLM call failed ${primaryDescribed.suffix}`, {\n      ...primaryDescribed.data,\n      messagesToRefineCount: messages.length,\n    });\n\n    const rawFallbacks = (\n      clientConfig.clientOptions as unknown as t.LLMConfig | undefined\n    )?.fallbacks;\n    const fallbacks = Array.isArray(rawFallbacks) ? rawFallbacks : [];\n    if (fallbacks.length > 0) {\n      try {\n        const onChunk = createSummarizationChunkHandler({\n          stepId,\n          config: traceConfig(summarizeConfig, 'cache_hit_compaction'),\n          provider: clientConfig.provider as Providers,\n          reasoningKey: agentContext.reasoningKey,\n        });\n        const fbResult = await tryFallbackProviders({\n          fallbacks,\n          tools: agentContext.getToolsForBinding(),\n          messages: [\n            ...messages,\n            new HumanMessage(\n              buildSummarizationInstruction(\n                clientConfig.promptText,\n                clientConfig.updatePromptText,\n                priorSummaryText\n              )\n            ),\n          ],\n          config: traceConfig(summarizeConfig, 'cache_hit_compaction'),\n          primaryError,\n          onChunk,\n        });\n        const fbMsg = fbResult?.messages?.[0];\n        if (fbMsg) {\n          summaryText = extractResponseText(\n            fbMsg as { content: string | object }\n          );\n        }\n      } catch (fbErr) {\n        const fbDescribed = describeFallbackError(fbErr, fallbacks);\n        log('warn', `Fallback providers also failed ${fbDescribed.suffix}`, {\n          ...fbDescribed.data,\n        });\n      }\n    }\n    if (!summaryText) {\n      log(\n        'warn',\n        `Summarization failed, falling back to metadata stub ${primaryDescribed.suffix}`,\n        {\n          ...primaryDescribed.data,\n          messagesToRefineCount: messages.length,\n        }\n      );\n      summaryText = generateMetadataStub(messages);\n      usedMetadataStub = true;\n    }\n  }\n\n  return { text: summaryText, usage: summaryUsage, usedMetadataStub };\n}\n\n/** Dispatches run step completion, ON_SUMMARIZE_COMPLETE, and rebuilds token map. */\nasync function dispatchCompletionEvents(params: {\n  graph: CreateSummarizeNodeParams['graph'];\n  runnableConfig?: RunnableConfig;\n  stepId: string;\n  summaryBlock: t.SummaryContentBlock;\n  agentContext: AgentContext;\n  runStep: t.RunStep;\n  summaryUsage?: Partial<UsageMetadata>;\n  agentId: string;\n  /**\n   * Number of messages preserved verbatim by the recency window after\n   * compaction.  Reported via the PostCompact hook payload so observers\n   * (metrics, cleanup) see the true post-compaction message count\n   * instead of always-zero.\n   */\n  messagesAfterCount: number;\n}): Promise<void> {\n  const {\n    graph,\n    runnableConfig,\n    stepId,\n    summaryBlock,\n    agentContext,\n    runStep,\n    summaryUsage,\n    agentId,\n    messagesAfterCount,\n  } = params;\n\n  runStep.summary = summaryBlock;\n  if (summaryUsage) {\n    runStep.usage = {\n      prompt_tokens: Number(summaryUsage.input_tokens) || 0,\n      completion_tokens: Number(summaryUsage.output_tokens) || 0,\n      total_tokens:\n        (Number(summaryUsage.input_tokens) || 0) +\n        (Number(summaryUsage.output_tokens) || 0),\n    };\n  }\n\n  await graph.dispatchRunStepCompleted(\n    stepId,\n    { type: 'summary', summary: summaryBlock } satisfies t.SummaryCompleted,\n    runnableConfig\n  );\n\n  if (runnableConfig) {\n    await safeDispatchCustomEvent(\n      GraphEvents.ON_SUMMARIZE_COMPLETE,\n      {\n        id: stepId,\n        agentId,\n        summary: summaryBlock,\n      } satisfies t.SummarizeCompleteEvent,\n      runnableConfig\n    );\n  }\n\n  const sessionId = graph.runId ?? '';\n  if (graph.hookRegistry?.hasHookFor('PostCompact', sessionId) === true) {\n    const threadId = (\n      runnableConfig?.configurable as Record<string, unknown> | undefined\n    )?.thread_id as string | undefined;\n    const firstBlock = summaryBlock.content?.[0];\n    const summaryText =\n      firstBlock != null &&\n      typeof firstBlock === 'object' &&\n      'text' in firstBlock &&\n      typeof firstBlock.text === 'string'\n        ? firstBlock.text\n        : '';\n    await executeHooks({\n      registry: graph.hookRegistry,\n      input: {\n        hook_event_name: 'PostCompact',\n        runId: sessionId,\n        threadId,\n        agentId,\n        summary: summaryText,\n        messagesAfterCount,\n      },\n      sessionId,\n    }).catch(() => {\n      /* PostCompact is observational — swallow errors */\n    });\n  }\n\n  agentContext.rebuildTokenMapAfterSummarization({});\n}\n\n// ---------------------------------------------------------------------------\n// createSummarizeNode\n// ---------------------------------------------------------------------------\n\ninterface CreateSummarizeNodeParams {\n  agentContext: AgentContext;\n  graph: {\n    contentData: t.RunStep[];\n    contentIndexMap: Map<string, number>;\n    config?: RunnableConfig;\n    runId?: string;\n    isMultiAgent: boolean;\n    hookRegistry?: HookRegistry;\n    dispatchRunStep: (\n      runStep: t.RunStep,\n      config?: RunnableConfig\n    ) => Promise<void>;\n    dispatchRunStepCompleted: (\n      stepId: string,\n      result: t.StepCompleted,\n      config?: RunnableConfig\n    ) => Promise<void>;\n  };\n  generateStepId: (stepKey: string) => [string, number];\n}\n\nexport function createSummarizeNode({\n  agentContext,\n  graph,\n  generateStepId,\n}: CreateSummarizeNodeParams) {\n  return async (\n    state: {\n      messages: BaseMessage[];\n      summarizationRequest?: t.SummarizationNodeInput;\n    },\n    config?: RunnableConfig\n  ): Promise<{ summarizationRequest: undefined; messages?: BaseMessage[] }> => {\n    const request = state.summarizationRequest;\n    if (request == null) {\n      return { summarizationRequest: undefined };\n    }\n\n    /**\n     * Overflow recovery routes through this node purely to get back to the\n     * agent node with a corrected budget, and deliberately spends no model\n     * call on its first attempt: re-pruning under the raised context pressure\n     * drives the pruner's tool-output compression and masking, which is\n     * cheaper than a summary and cannot lose message content. Summarization\n     * is also skipped outright when the caller never enabled it.\n     */\n    if (\n      request.reason === 'overflow' &&\n      (request.allowSummarization !== true ||\n        agentContext.summarizationEnabled !== true)\n    ) {\n      emitAgentLog(\n        config,\n        'debug',\n        'summarize',\n        'Overflow recovery re-prune — compressing tool output without a summarization call',\n        {\n          maxContextTokens: agentContext.maxContextTokens,\n          summarizationEnabled: agentContext.summarizationEnabled === true,\n          allowSummarization: request.allowSummarization === true,\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      return { summarizationRequest: undefined };\n    }\n\n    const maxCtx = agentContext.maxContextTokens ?? 0;\n    if (maxCtx > 0 && agentContext.instructionTokens >= maxCtx) {\n      emitAgentLog(\n        config,\n        'warn',\n        'summarize',\n        'Summarization skipped, instructions exceed context budget. Reduce the number of tools or increase maxContextTokens.',\n        {\n          instructionTokens: agentContext.instructionTokens,\n          maxContextTokens: maxCtx,\n          breakdown: agentContext.formatTokenBudgetBreakdown(),\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      return { summarizationRequest: undefined };\n    }\n\n    /**\n     * Capture the original-tool-content map locally before doing the\n     * split.  We need it in three places: to restore the head for\n     * summarizer quality, to leave intact on the skip path (state is\n     * unchanged), and — critically — to carry forward the tail-relevant\n     * entries on the summarize-fired path.  Clearing it eagerly here\n     * would lose the originals for masked tool messages that the\n     * recency window keeps in the tail; a future summarization could\n     * then only summarize the masked stub instead of the full payload.\n     */\n    const originalPending = agentContext.pendingOriginalToolContent;\n\n    const restoredMessages = restoreOriginalToolContent(\n      state.messages,\n      originalPending,\n      agentContext.maxContextTokens\n    );\n\n    const runnableConfig = config ?? graph.config;\n\n    const retainRecent = agentContext.summarizationConfig?.retainRecent;\n    const { head: messagesToRefine, tailStartIndex } = splitAtRecencyBoundary(\n      restoredMessages,\n      {\n        turns: retainRecent?.turns ?? DEFAULT_RETAIN_RECENT_TURNS,\n        tokens: retainRecent?.tokens,\n        tokenCounter: agentContext.tokenCounter,\n      }\n    );\n    /**\n     * Use the *masked* messages for the retained tail so that any\n     * truncation prune applied to oversized ToolMessage content stays\n     * truncated in live state.  The summarizer above reads the restored\n     * (full-content) head for summary quality, but reinjecting restored\n     * tool payloads into state would defeat masking and bloat the\n     * checkpoint, forcing more expensive re-pruning on later turns.\n     * `restoreOriginalToolContent` returns an array with identical\n     * length and structure to `state.messages` (replacements only at\n     * specific indices), so the same tailStartIndex slices both arrays\n     * at the same turn boundary.\n     */\n    const messagesToRetain = state.messages.slice(tailStartIndex);\n\n    if (messagesToRefine.length === 0) {\n      /**\n       * Recency window covers the entire conversation — there is no\n       * older content to summarize.  Skipping prevents the model from\n       * destroying the user's most recent message (e.g. a large pasted\n       * payload on the first turn) by replacing it with a generic\n       * checkpoint summary.  Mark the trigger so the same unchanged\n       * state is not re-evaluated on the next prune cycle.\n       */\n      emitAgentLog(\n        config,\n        'debug',\n        'summarize',\n        'Summarization skipped — recency window retains all messages',\n        {\n          messagesRetained: messagesToRetain.length,\n          retainTurns: retainRecent?.turns ?? DEFAULT_RETAIN_RECENT_TURNS,\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      agentContext.markSummarizationTriggered(state.messages.length);\n      return { summarizationRequest: undefined };\n    }\n\n    const clientConfig = buildSummarizationClientConfig(\n      agentContext,\n      agentContext.summarizationConfig\n    );\n\n    const stepKey = `summarize-${request.agentId}`;\n    const [stepId, stepIndex] = generateStepId(stepKey);\n\n    const placeholderSummary: t.SummaryContentBlock = {\n      type: ContentTypes.SUMMARY,\n      model: clientConfig.modelName,\n      provider: clientConfig.provider,\n    };\n\n    const runStep: t.RunStep = {\n      stepIndex,\n      id: stepId,\n      type: StepTypes.MESSAGE_CREATION,\n      index: graph.contentData.length,\n      stepDetails: {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: { message_id: stepId },\n      },\n      summary: placeholderSummary,\n      usage: null,\n    };\n\n    if (graph.runId != null && graph.runId !== '') {\n      runStep.runId = graph.runId;\n    }\n    if (graph.isMultiAgent && agentContext.agentId) {\n      runStep.agentId = agentContext.agentId;\n    }\n\n    await graph.dispatchRunStep(runStep, runnableConfig);\n\n    if (runnableConfig) {\n      await safeDispatchCustomEvent(\n        GraphEvents.ON_SUMMARIZE_START,\n        {\n          agentId: request.agentId,\n          provider: clientConfig.provider,\n          model: clientConfig.modelName,\n          messagesToRefineCount: messagesToRefine.length,\n          summaryVersion: agentContext.summaryVersion + 1,\n        } satisfies t.SummarizeStartEvent,\n        runnableConfig\n      );\n    }\n\n    const sessionId = graph.runId ?? '';\n    if (graph.hookRegistry?.hasHookFor('PreCompact', sessionId) === true) {\n      const threadId = (\n        runnableConfig?.configurable as Record<string, unknown> | undefined\n      )?.thread_id as string | undefined;\n      await executeHooks({\n        registry: graph.hookRegistry,\n        input: {\n          hook_event_name: 'PreCompact',\n          runId: sessionId,\n          threadId,\n          agentId: request.agentId,\n          messagesBeforeCount: messagesToRefine.length,\n          trigger: agentContext.summarizationConfig?.trigger?.type ?? 'default',\n        },\n        sessionId,\n      }).catch(() => {\n        /* PreCompact is observational — swallow errors */\n      });\n    }\n\n    const isSelfSummarizeModel =\n      clientConfig.provider === (agentContext.provider as string);\n    const hasPromptCache =\n      isSelfSummarizeModel &&\n      (agentContext.clientOptions as Record<string, unknown> | undefined)\n        ?.promptCache === true;\n\n    const log: LogFn = (level, message, data) => {\n      emitAgentLog(runnableConfig, level, 'summarize', message, data, {\n        runId: graph.runId,\n        agentId: request.agentId,\n      });\n    };\n\n    log('debug', 'Summarization starting', {\n      messagesToRefineCount: messagesToRefine.length,\n      hasPriorSummary: (agentContext.getSummaryText()?.trim() ?? '') !== '',\n      summaryVersion: agentContext.summaryVersion + 1,\n      isSelfSummarize: isSelfSummarizeModel,\n      hasPromptCache,\n      provider: clientConfig.provider,\n    });\n\n    const summarizeConfig: RunnableConfig | undefined = config\n      ? {\n        ...config,\n        metadata: {\n          ...config.metadata,\n          agent_id: request.agentId,\n          summarization_provider: clientConfig.provider,\n          summarization_model: clientConfig.modelName,\n          /**\n             * Per-call model attribution for usage consumers (the subagent\n             * usage-capture handler): the summarizer's model can differ from\n             * the agent's primary, and providers that emit no `ls_model_name`\n             * would otherwise be billed against the primary config's model.\n             * Omitted for self-summarize (no explicit model — the primary\n             * config fallback is then correct). `tryFallbackProviders`\n             * overrides this per fallback attempt; `INVOKED_PROVIDER` is\n             * stamped by `attemptInvoke` itself.\n             */\n          ...(clientConfig.modelName != null && clientConfig.modelName !== ''\n            ? { [Constants.INVOKED_MODEL]: clientConfig.modelName }\n            : {}),\n        },\n      }\n      : undefined;\n\n    const {\n      text: rawText,\n      usage: summaryUsage,\n      usedMetadataStub,\n    } = await executeSummarizationWithFallback({\n      agentContext,\n      messages: messagesToRefine,\n      clientConfig,\n      summarizeConfig,\n      stepId,\n      usePromptCache: isSelfSummarizeModel && hasPromptCache,\n      log,\n    });\n\n    /**\n     * The metadata stub describes the history rather than summarizing it, so\n     * committing it means removing the head and keeping nothing of what it\n     * said. That trade is never worth making to paper over an overflow: the\n     * recovery would \"succeed\" only by destroying the conversation it was\n     * supposed to preserve. Leave state untouched and let the provider error\n     * surface instead.\n     */\n    if (usedMetadataStub === true && request.reason === 'overflow') {\n      log(\n        'warn',\n        'Overflow summarization failed; keeping history rather than replacing it with a metadata stub'\n      );\n      agentContext.markSummarizationTriggered(state.messages.length);\n      /**\n       * The run step was already dispatched, so it has to be resolved here or\n       * consumers tracking step lifecycle keep an unfinished placeholder for\n       * the rest of the run.\n       */\n      await graph.dispatchRunStepCompleted(\n        stepId,\n        {\n          type: 'summary',\n          summary: placeholderSummary,\n        } satisfies t.SummaryCompleted,\n        runnableConfig\n      );\n      if (runnableConfig) {\n        await safeDispatchCustomEvent(\n          GraphEvents.ON_SUMMARIZE_COMPLETE,\n          {\n            id: stepId,\n            agentId: request.agentId,\n            error:\n              'Summarization failed during overflow recovery; conversation history was preserved',\n          } satisfies t.SummarizeCompleteEvent,\n          runnableConfig\n        );\n      }\n      return { summarizationRequest: undefined };\n    }\n\n    if (!rawText) {\n      agentContext.markSummarizationTriggered(0);\n      if (runnableConfig) {\n        await safeDispatchCustomEvent(\n          GraphEvents.ON_SUMMARIZE_COMPLETE,\n          {\n            id: stepId,\n            agentId: request.agentId,\n            error: 'Summarization produced empty output',\n          } satisfies t.SummarizeCompleteEvent,\n          runnableConfig\n        );\n      }\n      return { summarizationRequest: undefined };\n    }\n\n    const summaryText = enrichSummary(rawText, messagesToRefine);\n\n    const tokenCount = computeSummaryTokenCount(\n      summaryText,\n      summaryUsage,\n      agentContext.tokenCounter\n    );\n\n    agentContext.setSummary(summaryText, tokenCount);\n\n    log('info', 'Summary persisted');\n    log('debug', 'Summary details', {\n      summaryTokens: tokenCount,\n      textLength: summaryText.length,\n      messagesCompacted: messagesToRefine.length,\n      summaryVersion: agentContext.summaryVersion,\n      ...(summaryUsage != null\n        ? {\n          input_tokens: summaryUsage.input_tokens,\n          output_tokens: summaryUsage.output_tokens,\n          cache_read: summaryUsage.input_token_details?.cache_read,\n          cache_creation: summaryUsage.input_token_details?.cache_creation,\n        }\n        : {}),\n    });\n\n    const summaryBlock = buildSummaryBlock({\n      summaryText,\n      tokenCount,\n      stepId,\n      stepIndex: runStep.index,\n      modelName: clientConfig.modelName,\n      provider: clientConfig.provider,\n      summaryVersion: agentContext.summaryVersion,\n    });\n\n    await dispatchCompletionEvents({\n      graph,\n      runnableConfig,\n      stepId,\n      summaryBlock,\n      agentContext,\n      runStep,\n      summaryUsage,\n      agentId: request.agentId,\n      messagesAfterCount: messagesToRetain.length,\n    });\n\n    /**\n     * `dispatchCompletionEvents` calls `rebuildTokenMapAfterSummarization({})`\n     * which resets the dedupe baseline to 0 — correct under the legacy\n     * \"remove-all only\" shape where no messages survived, but stale once\n     * the recency window keeps a tail.  Realign the baseline to the\n     * surviving tail length so a subsequent prune cycle on the unchanged\n     * tail short-circuits via `shouldSkipSummarization` instead of\n     * looping back into another summarize call.\n     */\n    agentContext.markSummarizationTriggered(messagesToRetain.length);\n\n    /**\n     * Carry forward the original-content entries that correspond to the\n     * retained tail, reindexed for the post-removeAll state where tail\n     * messages start at index 0.  Without this, a future summarization\n     * that pulls these tail messages into its head would only see the\n     * masked stubs (since `setSummary` clears `pruneMessages`, and the\n     * fresh pruner at the next turn has no record of prior masks).\n     * Entries for indices < `tailStartIndex` belong to messages we just\n     * summarized — they are no longer reachable so they are dropped.\n     */\n    if (originalPending != null && originalPending.size > 0) {\n      const tailPending = new Map<number, string>();\n      for (const [idx, content] of originalPending) {\n        if (idx >= tailStartIndex) {\n          tailPending.set(idx - tailStartIndex, content);\n        }\n      }\n      agentContext.pendingOriginalToolContent =\n        tailPending.size > 0 ? tailPending : undefined;\n    } else {\n      agentContext.pendingOriginalToolContent = undefined;\n    }\n\n    return {\n      summarizationRequest: undefined,\n      messages:\n        messagesToRetain.length > 0\n          ? [createRemoveAllMessage(), ...messagesToRetain]\n          : [createRemoveAllMessage()],\n    };\n  };\n}\n\n/** Extracts text from an LLM response, skipping reasoning/thinking blocks. */\nfunction extractResponseText(response: { content: string | object }): string {\n  const { content } = response;\n  if (typeof content === 'string') {\n    return content.trim();\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const block of content) {\n    if (typeof block === 'string') {\n      parts.push(block);\n      continue;\n    }\n    if (block == null || typeof block !== 'object') {\n      continue;\n    }\n    const rec = block as Record<string, unknown>;\n    if (\n      rec.type === ContentTypes.THINKING ||\n      rec.type === ContentTypes.REASONING_CONTENT ||\n      rec.type === 'redacted_thinking'\n    ) {\n      continue;\n    }\n    if (rec.type === 'text' && typeof rec.text === 'string') {\n      parts.push(rec.text);\n    }\n  }\n  return parts.join('').trim();\n}\n\nfunction buildSummarizationInstruction(\n  promptText: string,\n  updatePromptText: string | undefined,\n  priorSummaryText: string\n): string {\n  const effectivePrompt = priorSummaryText\n    ? (updatePromptText ?? promptText)\n    : promptText;\n  const parts = [effectivePrompt];\n  if (priorSummaryText) {\n    parts.push(\n      `\\n\\n<previous-summary>\\n${priorSummaryText}\\n</previous-summary>`\n    );\n  }\n  return parts.join('');\n}\n\n/** Creates an `onChunk` callback that dispatches `ON_SUMMARIZE_DELTA` events for streaming. */\nfunction createSummarizationChunkHandler({\n  stepId,\n  config,\n  provider,\n  reasoningKey = 'reasoning_content',\n}: {\n  stepId?: string;\n  config?: RunnableConfig;\n  provider?: Providers;\n  reasoningKey?: 'reasoning_content' | 'reasoning';\n}): OnChunk | undefined {\n  if (stepId == null || stepId === '' || !config) {\n    return undefined;\n  }\n  return (chunk) => {\n    const chunkAny = chunk as Parameters<typeof getChunkContent>[0]['chunk'];\n    const raw = getChunkContent({ chunk: chunkAny, provider, reasoningKey });\n    if (raw == null || (typeof raw === 'string' && !raw)) {\n      return;\n    }\n    const contentBlocks: t.MessageContentComplex[] =\n      typeof raw === 'string'\n        ? [{ type: ContentTypes.TEXT, text: raw } as t.MessageContentComplex]\n        : raw;\n\n    void safeDispatchCustomEvent(\n      GraphEvents.ON_SUMMARIZE_DELTA,\n      {\n        id: stepId,\n        delta: {\n          summary: {\n            type: ContentTypes.SUMMARY,\n            content: contentBlocks,\n            provider: String(config.metadata?.summarization_provider ?? ''),\n            model: String(config.metadata?.summarization_model ?? ''),\n          },\n        },\n      } satisfies t.SummarizeDeltaEvent,\n      config\n    );\n  };\n}\n\nfunction traceConfig(\n  config: RunnableConfig | undefined,\n  stage: string\n): RunnableConfig | undefined {\n  if (!config) {\n    return undefined;\n  }\n  return {\n    ...config,\n    runName: `summarization:${stage}`,\n    metadata: { ...config.metadata, summarization: true, stage },\n  };\n}\n\n/**\n * Cache-friendly compaction: sends raw conversation messages with the\n * summarization instruction appended as the final HumanMessage.\n * Providers with prompt caching get a cache hit on the system prompt +\n * tool definitions prefix.\n */\nasync function summarizeWithCacheHit({\n  model,\n  messages,\n  promptText,\n  updatePromptText,\n  priorSummaryText,\n  config,\n  stepId,\n  provider,\n  reasoningKey,\n  usePromptCache,\n  promptCacheTtl,\n  log,\n}: {\n  model: t.ChatModel;\n  messages: BaseMessage[];\n  promptText: string;\n  updatePromptText?: string;\n  priorSummaryText: string;\n  config?: RunnableConfig;\n  stepId?: string;\n  provider: Providers;\n  reasoningKey?: 'reasoning_content' | 'reasoning';\n  usePromptCache?: boolean;\n  promptCacheTtl?: PromptCacheTtl;\n  log?: LogFn;\n}): Promise<{ text: string; usage?: Partial<UsageMetadata> }> {\n  const instruction = buildSummarizationInstruction(\n    promptText,\n    updatePromptText,\n    priorSummaryText\n  );\n\n  const fullMessages = [...messages, new HumanMessage(instruction)];\n  const invokeMessages =\n    usePromptCache === true\n      ? addTailCacheControl(fullMessages, promptCacheTtl)\n      : fullMessages;\n\n  const result = await attemptInvoke(\n    {\n      model,\n      messages: invokeMessages,\n      provider,\n      onChunk: createSummarizationChunkHandler({\n        stepId,\n        config: traceConfig(config, 'cache_hit_compaction'),\n        provider,\n        reasoningKey,\n      }),\n    },\n    traceConfig(config, 'cache_hit_compaction')\n  );\n\n  const responseMsg = result.messages?.[0];\n  const text = responseMsg\n    ? extractResponseText(responseMsg as { content: string | object })\n    : '';\n  let usage: Partial<UsageMetadata> | undefined;\n  let usageSource = 'none';\n  if (\n    responseMsg != null &&\n    'usage_metadata' in responseMsg &&\n    responseMsg.usage_metadata != null\n  ) {\n    usage = responseMsg.usage_metadata as Partial<UsageMetadata>;\n    usageSource = 'usage_metadata';\n  } else if (responseMsg != null) {\n    const respMeta = responseMsg.response_metadata as\n      | Record<string, unknown>\n      | undefined;\n    const raw = (respMeta?.metadata as Record<string, unknown> | undefined)\n      ?.usage as Record<string, unknown> | undefined;\n    if (raw != null) {\n      usage = {\n        input_tokens: Number(raw.inputTokens) || undefined,\n        output_tokens: Number(raw.outputTokens) || undefined,\n      } as Partial<UsageMetadata>;\n      usageSource = 'response_metadata';\n    }\n  }\n  const cacheDetails = (\n    usage as\n      | {\n          input_token_details?: {\n            cache_read?: number;\n            cache_creation?: number;\n          };\n        }\n      | undefined\n  )?.input_token_details;\n  log?.('debug', 'Summarization LLM usage', {\n    source: usageSource,\n    input_tokens: usage?.input_tokens,\n    output_tokens: usage?.output_tokens,\n    ...(cacheDetails?.cache_read != null || cacheDetails?.cache_creation != null\n      ? {\n        'input_token_details.cache_read': cacheDetails.cache_read,\n        'input_token_details.cache_creation': cacheDetails.cache_creation,\n      }\n      : {}),\n  });\n  return { text, usage };\n}\n"],"mappings":"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"}
+{"version":3,"file":"node.mjs","names":["chunkAny"],"sources":["../../../src/summarization/node.ts"],"sourcesContent":["import {\n  AIMessage,\n  ToolMessage,\n  HumanMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { UsageMetadata, BaseMessage } from '@langchain/core/messages';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type { HookRegistry } from '@/hooks';\nimport type { OnChunk } from '@/llm/invoke';\nimport type * as t from '@/types';\nimport {\n  cloneToolMessageWithContent,\n  compactToolContent,\n  isComputerCallOutputMessage,\n  serializeToolContentBounded,\n} from '@/utils/toolContent';\nimport {\n  addTailCacheControl,\n  resolvePromptCacheTtl,\n  type PromptCacheTtl,\n} from '@/messages/cache';\nimport {\n  DEFAULT_RETAIN_RECENT_TURNS,\n  splitAtRecencyBoundary,\n} from '@/messages/recency';\nimport {\n  Constants,\n  ContentTypes,\n  GraphEvents,\n  StepTypes,\n  Providers,\n} from '@/common';\nimport { safeDispatchCustomEvent, emitAgentLog } from '@/utils/events';\nimport { attemptInvoke, tryFallbackProviders } from '@/llm/invoke';\nimport { calculateMaxToolResultChars } from '@/utils/truncation';\nimport { createRemoveAllMessage } from '@/messages/reducer';\nimport { getMaxOutputTokensKey } from '@/llm/request';\nimport { initializeModel } from '@/llm/init';\nimport { getChunkContent } from '@/stream';\nimport { executeHooks } from '@/hooks';\n\nconst SUMMARIZATION_PARAM_KEYS = new Set(['maxSummaryTokens']);\n\n/**\n * Default number of recent user-led turns preserved verbatim during\n * compaction.  A turn begins at a HumanMessage and includes every\n * following AIMessage and ToolMessage up to the next HumanMessage.\n * The most recent turn is always retained regardless of this value;\n * the default of `2` additionally keeps the prior exchange so the\n * model has fresh context on what just happened.  Setting\n * `retainRecent.turns` to `0` reverts to the legacy \"summarize every\n * message\" behavior.\n */\n/**\n * Token overhead of the XML wrapper + instruction text added around the\n * summary at injection time in AgentContext.buildSystemRunnable:\n * `<summary>\\n${text}\\n</summary>\\n\\nYour context window was compacted...`\n * ~33 tokens on Anthropic, ~24-27 on OpenAI.  Using 33 as a safe ceiling.\n */\nconst SUMMARY_WRAPPER_OVERHEAD_TOKENS = 33;\n\n/** Structured checkpoint prompt for fresh summarization (no prior summary). */\nexport const DEFAULT_SUMMARIZATION_PROMPT = `Hold on, before you continue I need you to write me a checkpoint of everything so far. Your context window is filling up and this checkpoint replaces the messages above, so capture everything you need to pick right back up.\n\nDon't second-guess or fact-check anything you did, your tool results reflect exactly what happened. If a tool result appears truncated, that's just a display artifact from context management: the tool executed fully. Just record what you did and what you observed. Only the checkpoint, don't respond to me or continue the conversation.\n\n## Checkpoint\n\n## Goal\nWhat I asked you to do and any sub-goals you identified.\n\n## Constraints & Preferences\nAny rules, preferences, or configuration I established.\n\n## Progress\n### Done\n- What you completed and the outcomes\n\n### In Progress\n- What you're currently working on\n\n## Key Decisions\nDecisions you made and why.\n\n## Next Steps\nConcrete task actions remaining, in priority order.\n\n## Critical Context\nExact identifiers, names, error messages, URLs, and details you need to preserve verbatim.\n\nRules:\n- Record what you did and observed, don't judge or re-evaluate it\n- For each tool call: the tool name, key inputs, and the outcome\n- Preserve exact identifiers, names, errors, and references verbatim\n- Short declarative sentences\n- Skip empty sections`;\n\n/** Prompt for re-compaction when a prior summary exists. */\nexport const DEFAULT_UPDATE_SUMMARIZATION_PROMPT = `Hold on again, update your checkpoint. Merge the new messages into your existing checkpoint and give me a single consolidated replacement.\n\nKeep it roughly the same length as your last checkpoint. Compress older details to make room for what's new, don't just append. Give recent actions more detail, compress older items to one-liners.\n\nDon't fact-check or second-guess anything, your tool results are ground truth. If a tool result appears truncated, that's just a display artifact: the tool executed fully. Only the checkpoint, don't respond to me or continue the conversation.\n\nRules:\n- Merge new progress into existing sections, don't duplicate headers\n- Compress older completed items into one-line entries\n- Move items from \"In Progress\" to \"Done\" when you completed them\n- Update \"Next Steps\" to reflect current task priorities.\n- For each new tool call: the tool name, key inputs, and the outcome\n- Preserve exact identifiers, names, errors, and references verbatim\n- Skip empty sections`;\n\nfunction separateParameters(parameters: Record<string, unknown>): {\n  llmParams: Record<string, unknown>;\n  maxSummaryTokens?: number;\n} {\n  const llmParams: Record<string, unknown> = {};\n  let maxSummaryTokens: number | undefined;\n\n  for (const [key, value] of Object.entries(parameters)) {\n    if (SUMMARIZATION_PARAM_KEYS.has(key)) {\n      if (\n        key === 'maxSummaryTokens' &&\n        typeof value === 'number' &&\n        value > 0\n      ) {\n        maxSummaryTokens = value;\n      }\n    } else {\n      llmParams[key] = value;\n    }\n  }\n\n  return { llmParams, maxSummaryTokens };\n}\n\n/**\n * Generates a structural metadata summary without making an LLM call.\n * Used as a last-resort fallback when all summarization attempts fail.\n * Preserves tool names and message counts so the agent retains basic context.\n */\nfunction generateMetadataStub(messages: BaseMessage[]): string {\n  const counts: Record<string, number> = {};\n  const toolNames = new Set<string>();\n\n  for (const msg of messages) {\n    const role = msg.getType();\n    counts[role] = (counts[role] ?? 0) + 1;\n\n    if (role === 'tool' && msg.name != null && msg.name !== '') {\n      toolNames.add(msg.name);\n    }\n\n    if (\n      role === 'ai' &&\n      msg instanceof AIMessage &&\n      msg.tool_calls &&\n      msg.tool_calls.length > 0\n    ) {\n      for (const tc of msg.tool_calls) {\n        toolNames.add(tc.name);\n      }\n    }\n  }\n\n  const countParts = Object.entries(counts)\n    .map(([role, count]) => `${count} ${role}`)\n    .join(', ');\n\n  const lines = [\n    `[Metadata summary: ${messages.length} messages (${countParts})]`,\n  ];\n\n  if (toolNames.size > 0) {\n    lines.push(`[Tools used: ${Array.from(toolNames).join(', ')}]`);\n  }\n\n  return lines.join('\\n');\n}\n\n/** Maximum number of tool failures to include in the enrichment section. */\nconst MAX_TOOL_FAILURES = 8;\n/** Maximum chars per failure summary line. */\nconst MAX_TOOL_FAILURE_CHARS = 240;\n\n/**\n * Extracts failed tool results from messages and formats them as a structured\n * section. LLMs often omit specific failure details (exit codes, error messages)\n * from their summaries, this mechanical enrichment guarantees they survive.\n */\nfunction extractToolFailuresSection(messages: BaseMessage[]): string {\n  const failures: Array<{ toolName: string; summary: string }> = [];\n  const seen = new Set<string>();\n\n  for (const msg of messages) {\n    if (msg.getType() !== 'tool') {\n      continue;\n    }\n    const toolMsg = msg as ToolMessage;\n    if (toolMsg.status !== 'error') {\n      continue;\n    }\n    // Deduplicate by tool_call_id\n    const callId = toolMsg.tool_call_id;\n    if (callId && seen.has(callId)) {\n      continue;\n    }\n    if (callId) {\n      seen.add(callId);\n    }\n\n    const toolName = toolMsg.name ?? 'tool';\n    const content = serializeToolContentBounded(\n      toolMsg.content,\n      MAX_TOOL_FAILURE_CHARS * 4\n    );\n    const normalized = content.replace(/\\s+/g, ' ').trim();\n    const summary =\n      normalized.length > MAX_TOOL_FAILURE_CHARS\n        ? `${normalized.slice(0, MAX_TOOL_FAILURE_CHARS - 3)}...`\n        : normalized;\n\n    failures.push({ toolName, summary });\n  }\n\n  if (failures.length === 0) {\n    return '';\n  }\n\n  const lines = failures\n    .slice(0, MAX_TOOL_FAILURES)\n    .map((f) => `- ${f.toolName}: ${f.summary}`);\n  if (failures.length > MAX_TOOL_FAILURES) {\n    lines.push(`- ...and ${failures.length - MAX_TOOL_FAILURES} more`);\n  }\n\n  return `\\n\\n## Tool Failures\\n${lines.join('\\n')}`;\n}\n\n/**\n * Appends mechanical enrichment sections to an LLM-generated summary.\n * Tool failures are appended verbatim because LLMs often omit specific\n * error details from their summaries.\n */\nfunction enrichSummary(summaryText: string, messages: BaseMessage[]): string {\n  return summaryText + extractToolFailuresSection(messages);\n}\n\n/**\n * Restores pre-masking tool content onto the messages array using\n * `pendingOriginalToolContent` stored on AgentContext. Only allocates\n * a new array when there are entries to restore; otherwise returns the\n * input reference unchanged.\n */\nfunction restoreOriginalToolContent(\n  messages: BaseMessage[],\n  originalToolContent: Map<number, string> | undefined,\n  maxContextTokens?: number\n): BaseMessage[] {\n  if (originalToolContent == null || originalToolContent.size === 0) {\n    return messages;\n  }\n\n  const restorable: Array<{\n    index: number;\n    message: ToolMessage;\n    content: string;\n  }> = [];\n  for (const [index, content] of originalToolContent) {\n    const message = messages[index];\n    if (\n      message instanceof ToolMessage &&\n      !isComputerCallOutputMessage(message)\n    ) {\n      restorable.push({ index, message, content });\n    }\n  }\n  if (restorable.length === 0) {\n    return messages;\n  }\n\n  /**\n   * Restored originals improve checkpoint quality, but they still feed a\n   * provider call. Share one tool-result budget across every restoration so\n   * several previously masked results cannot overflow the summarizer.\n   */\n  let remainingChars = calculateMaxToolResultChars(maxContextTokens);\n  const restored = [...messages];\n  for (let i = 0; i < restorable.length; i++) {\n    const { index, message, content } = restorable[i];\n    const maxChars = Math.floor(remainingChars / (restorable.length - i));\n    const compacted = compactToolContent(content, maxChars).content;\n    restored[index] = cloneToolMessageWithContent(message, compacted);\n    remainingChars -= serializeToolContentBounded(compacted, maxChars).length;\n  }\n  return restored;\n}\n\n// ---------------------------------------------------------------------------\n// Extracted helpers for createSummarizeNode\n// ---------------------------------------------------------------------------\n\ninterface SummarizationClientConfig {\n  provider: string;\n  modelName?: string;\n  clientOptions: Record<string, unknown>;\n  effectiveMaxSummaryTokens?: number;\n  promptText: string;\n  updatePromptText: string;\n}\n\n/** Assembles the summarization model's client options from agent and config. */\nfunction buildSummarizationClientConfig(\n  agentContext: AgentContext,\n  summarizationConfig?: t.SummarizationConfig\n): SummarizationClientConfig {\n  const provider = (summarizationConfig?.provider ??\n    agentContext.provider) as string;\n  const modelName = summarizationConfig?.model;\n  const parameters = summarizationConfig?.parameters ?? {};\n  const promptText =\n    summarizationConfig?.prompt ?? DEFAULT_SUMMARIZATION_PROMPT;\n  const updatePromptText =\n    summarizationConfig?.updatePrompt ?? DEFAULT_UPDATE_SUMMARIZATION_PROMPT;\n\n  const { llmParams, maxSummaryTokens: paramMaxSummaryTokens } =\n    separateParameters(parameters);\n\n  const isSelfSummarize = provider === (agentContext.provider as string);\n  const baseOptions =\n    isSelfSummarize && agentContext.clientOptions\n      ? { ...agentContext.clientOptions }\n      : {};\n\n  const clientOptions: Record<string, unknown> = {\n    ...baseOptions,\n    ...llmParams,\n  };\n\n  if (modelName != null && modelName !== '') {\n    clientOptions.model = modelName;\n    clientOptions.modelName = modelName;\n  }\n\n  const effectiveMaxSummaryTokens =\n    paramMaxSummaryTokens ?? summarizationConfig?.maxSummaryTokens;\n\n  if (effectiveMaxSummaryTokens != null) {\n    clientOptions[getMaxOutputTokensKey(provider)] = effectiveMaxSummaryTokens;\n  }\n\n  return {\n    provider,\n    modelName,\n    clientOptions,\n    effectiveMaxSummaryTokens,\n    promptText,\n    updatePromptText,\n  };\n}\n\n/** Computes the token count for a summary, preferring provider output tokens when available. */\nfunction computeSummaryTokenCount(\n  summaryText: string,\n  summaryUsage: Partial<UsageMetadata> | undefined,\n  tokenCounter?: (message: BaseMessage) => number\n): number {\n  const providerOutputTokens = Number(summaryUsage?.output_tokens) || 0;\n  if (providerOutputTokens > 0) {\n    return providerOutputTokens + SUMMARY_WRAPPER_OVERHEAD_TOKENS;\n  }\n  if (tokenCounter) {\n    return (\n      tokenCounter(new SystemMessage(summaryText)) +\n      SUMMARY_WRAPPER_OVERHEAD_TOKENS\n    );\n  }\n  return 0;\n}\n\n/**\n * Names the first retained message so the summary declares its own extent\n * rather than leaving the next run to infer coverage from where the block\n * happens to sit.\n *\n * Anchored to the retained side, not the covered side. One source message can\n * expand into several messages — a steer splits an assistant entry into\n * pre-steer, steer, and post-steer entries sharing its ID — and the recency\n * split lands on any human-type message, including the steer. Naming the last\n * *covered* message would then name a half-covered ID with no correct reading;\n * naming the first *retained* message makes that same message the anchor, so it\n * survives whole and everything before it is unambiguously covered.\n *\n * Synthetic entries are skipped, because they can sit *before* a resolvable\n * one. `formatAgentMessages` reconstructs skill bodies inside its payload loop\n * (see the `pendingSkillNames` block) and keeps processing payload entries\n * afterwards, so an unstamped skill body — which `messagesStateReducer` then\n * gives a UUID no payload entry carries — is followed by stamped messages.\n * Anchoring on the UUID would look resolvable at write time and degrade to\n * positional trimming on read, dropping the retained tail. Skipping it reaches\n * the stamped message behind it.\n *\n * `convertInjectedMessages` records `injected` on everything it builds, which is\n * what makes this decidable: `isMeta` and `source` are both optional on\n * `InjectedMessage`, so a bare entry carries no marker of its own, and an\n * injected `source: 'steer'` is otherwise indistinguishable from a replayed one.\n * The remaining `isMeta`/`source` checks cover the constructors that build\n * synthetic entries directly instead of going through that funnel — hook context\n * in `ToolNode` and `StandardGraph`, handoff cues, reconstructed skill bodies.\n *\n * `steer` is exempt from the `source` check because a replayed steer *is*\n * stamped from its payload entry; rejecting every marked `source` once dropped\n * exactly those retained steers. Injected steers are still caught, by `injected`.\n *\n * Known limitation: a payload entry that omits `messageId` is never stamped, so\n * the reducer's UUID is recorded and cannot resolve on the next run. There is no\n * write-time fix — such an entry has no stable ID to name in the next payload\n * either — and the reader's positional fallback is what `main` already does, so\n * the anchor degrades rather than misleads.\n */\nfunction isSyntheticContext(message: BaseMessage): boolean {\n  const { additional_kwargs: kwargs } = message;\n  if (kwargs.injected === true || kwargs.isMeta === true) {\n    return true;\n  }\n  return kwargs.source != null && kwargs.source !== 'steer';\n}\n\nfunction resolveSummaryCoverage(\n  messagesToRetain: BaseMessage[]\n): t.SummaryCoverage | undefined {\n  for (let i = 0; i < messagesToRetain.length; i++) {\n    const message = messagesToRetain[i];\n    if (isSyntheticContext(message)) {\n      continue;\n    }\n    const id = message.id?.trim();\n    if (id != null && id !== '') {\n      return { retainedFromMessageId: id };\n    }\n  }\n  return undefined;\n}\n\n/** Constructs the SummaryContentBlock persisted in the run step and dispatched to events. */\nfunction buildSummaryBlock(params: {\n  summaryText: string;\n  tokenCount: number;\n  coverage?: t.SummaryCoverage;\n  stepId: string;\n  stepIndex: number;\n  modelName?: string;\n  provider: string;\n  summaryVersion: number;\n}): t.SummaryContentBlock {\n  return {\n    type: ContentTypes.SUMMARY,\n    content: [\n      {\n        type: ContentTypes.TEXT,\n        text: params.summaryText,\n      } as t.MessageContentComplex,\n    ],\n    tokenCount: params.tokenCount,\n    ...(params.coverage != null ? { coverage: params.coverage } : {}),\n    summaryVersion: params.summaryVersion,\n    boundary: {\n      messageId: params.stepId,\n      contentIndex: params.stepIndex,\n    },\n    model: params.modelName,\n    provider: params.provider,\n    createdAt: new Date().toISOString(),\n  };\n}\n\ntype LogFn = (\n  level: 'debug' | 'info' | 'warn' | 'error',\n  message: string,\n  data?: Record<string, unknown>\n) => void;\n\n/**\n * Extracts an HTTP status code from a thrown LLM-provider error. Returns\n * `undefined` for non-object values (including `null` or `undefined`, both\n * valid `throw` targets in JS) so callers never dereference a nullish\n * value.\n */\nfunction extractHttpStatus(err: unknown): number | undefined {\n  if (err == null || typeof err !== 'object') {\n    return undefined;\n  }\n  const errRecord = err as Record<string, unknown>;\n  const direct = errRecord.status;\n  if (typeof direct === 'number') {\n    return direct;\n  }\n  const statusCode = errRecord.statusCode;\n  if (typeof statusCode === 'number') {\n    return statusCode;\n  }\n  const response = errRecord.response;\n  if (response != null && typeof response === 'object') {\n    const nested = (response as Record<string, unknown>).status;\n    if (typeof nested === 'number') {\n      return nested;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Formats a provider-level error for logging. Returns both a human-readable\n * suffix (safe to include in the message string so it survives any host-side\n * formatter) and a structured metadata bag for rich log backends.\n */\nfunction describeProviderError(\n  err: unknown,\n  provider: string,\n  modelName?: string\n): { suffix: string; data: Record<string, unknown> } {\n  const providerLabel = `${provider}/${modelName ?? '(no-model)'}`;\n  const errMsg = err instanceof Error ? err.message : String(err);\n\n  const data: Record<string, unknown> = {\n    provider,\n    model: modelName,\n  };\n  if (err instanceof Error) {\n    data.errorName = err.name;\n    data.errorStack = err.stack;\n  }\n\n  const status = extractHttpStatus(err);\n  const statusSuffix = status != null ? ` (HTTP ${status})` : '';\n  if (status != null) {\n    data.status = status;\n  }\n\n  return {\n    suffix: `[${providerLabel}]${statusSuffix}: ${errMsg}`,\n    data,\n  };\n}\n\n/**\n * Formats an exhausted-fallback error. `tryFallbackProviders` throws the\n * last fallback provider's error, which may be from any of the configured\n * fallbacks — not the primary — so we label the log with the list of\n * fallback providers attempted rather than mis-attributing to the primary.\n *\n * Entries in `fallbacks` are normally strongly typed, but we defend against\n * malformed runtime config (null/undefined entries, missing `provider`\n * field) so a recoverable summarization failure is never promoted to an\n * uncaught exception from inside the logging path.\n */\nfunction describeFallbackError(\n  err: unknown,\n  fallbacks: unknown\n): { suffix: string; data: Record<string, unknown> } {\n  const errMsg = err instanceof Error ? err.message : String(err);\n  const list: ReadonlyArray<unknown> = Array.isArray(fallbacks)\n    ? fallbacks\n    : [];\n  const providerNames = list\n    .map((f) => {\n      if (f == null || typeof f !== 'object') {\n        return undefined;\n      }\n      const raw = (f as { provider?: unknown }).provider;\n      return raw != null ? String(raw) : undefined;\n    })\n    .filter((p): p is string => typeof p === 'string');\n  const label =\n    providerNames.length > 0\n      ? `fallbacks=[${providerNames.join(',')}]`\n      : 'no-fallbacks';\n\n  const data: Record<string, unknown> = {\n    fallbackProviders: providerNames,\n    fallbackCount: list.length,\n  };\n  if (err instanceof Error) {\n    data.errorName = err.name;\n    data.errorStack = err.stack;\n  }\n  const status = extractHttpStatus(err);\n  const statusSuffix = status != null ? ` (HTTP ${status})` : '';\n  if (status != null) {\n    data.status = status;\n  }\n\n  return {\n    suffix: `[${label}]${statusSuffix}: ${errMsg}`,\n    data,\n  };\n}\n\n/**\n * Runs the summarization LLM call with primary + fallback providers,\n * falling back to a metadata stub when all calls fail.\n */\nasync function executeSummarizationWithFallback(params: {\n  agentContext: AgentContext;\n  messages: BaseMessage[];\n  clientConfig: SummarizationClientConfig;\n  summarizeConfig?: RunnableConfig;\n  stepId: string;\n  usePromptCache: boolean;\n  log: LogFn;\n}): Promise<{\n  text: string;\n  usage?: Partial<UsageMetadata>;\n  /**\n   * True when every model call failed and `text` is the generated metadata\n   * stub rather than a real summary. Callers that would replace history with\n   * this need to know it carries none of the original content.\n   */\n  usedMetadataStub?: boolean;\n}> {\n  const {\n    agentContext,\n    messages,\n    clientConfig,\n    summarizeConfig,\n    stepId,\n    usePromptCache,\n    log,\n  } = params;\n\n  const priorSummaryText = agentContext.getSummaryText()?.trim() ?? '';\n\n  let summaryText = '';\n  let summaryUsage: Partial<UsageMetadata> | undefined;\n  let usedMetadataStub = false;\n\n  try {\n    /**\n     * Initialize inside the try so that a misconfigured provider\n     * (e.g. an unrecognized summarization.provider) surfaces through the\n     * `log('error', ...)` path below rather than bubbling up silently.\n     */\n    const summarizationModel = initializeModel({\n      provider: clientConfig.provider as Providers,\n      clientOptions: clientConfig.clientOptions as t.ClientOptions,\n      tools: agentContext.getToolsForBinding(),\n    }) as t.ChatModel;\n\n    const result = await summarizeWithCacheHit({\n      model: summarizationModel,\n      messages,\n      promptText: clientConfig.promptText,\n      updatePromptText: clientConfig.updatePromptText,\n      priorSummaryText,\n      config: summarizeConfig,\n      stepId,\n      provider: clientConfig.provider as Providers,\n      reasoningKey: agentContext.reasoningKey,\n      usePromptCache,\n      promptCacheTtl:\n        (clientConfig.provider as Providers) === Providers.ANTHROPIC ||\n        (clientConfig.provider as Providers) === Providers.OPENROUTER\n          ? resolvePromptCacheTtl(\n            (\n                clientConfig.clientOptions as {\n                  promptCacheTtl?: PromptCacheTtl;\n                }\n            ).promptCacheTtl\n          )\n          : undefined,\n      log,\n    });\n    summaryText = result.text;\n    summaryUsage = result.usage;\n  } catch (primaryError) {\n    const primaryDescribed = describeProviderError(\n      primaryError,\n      clientConfig.provider,\n      clientConfig.modelName\n    );\n    log('error', `Summarization LLM call failed ${primaryDescribed.suffix}`, {\n      ...primaryDescribed.data,\n      messagesToRefineCount: messages.length,\n    });\n\n    const rawFallbacks = (\n      clientConfig.clientOptions as unknown as t.LLMConfig | undefined\n    )?.fallbacks;\n    const fallbacks = Array.isArray(rawFallbacks) ? rawFallbacks : [];\n    if (fallbacks.length > 0) {\n      try {\n        const onChunk = createSummarizationChunkHandler({\n          stepId,\n          config: traceConfig(summarizeConfig, 'cache_hit_compaction'),\n          provider: clientConfig.provider as Providers,\n          reasoningKey: agentContext.reasoningKey,\n        });\n        const fbResult = await tryFallbackProviders({\n          fallbacks,\n          tools: agentContext.getToolsForBinding(),\n          messages: [\n            ...messages,\n            new HumanMessage(\n              buildSummarizationInstruction(\n                clientConfig.promptText,\n                clientConfig.updatePromptText,\n                priorSummaryText\n              )\n            ),\n          ],\n          config: traceConfig(summarizeConfig, 'cache_hit_compaction'),\n          primaryError,\n          onChunk,\n        });\n        const fbMsg = fbResult?.messages?.[0];\n        if (fbMsg) {\n          summaryText = extractResponseText(\n            fbMsg as { content: string | object }\n          );\n        }\n      } catch (fbErr) {\n        const fbDescribed = describeFallbackError(fbErr, fallbacks);\n        log('warn', `Fallback providers also failed ${fbDescribed.suffix}`, {\n          ...fbDescribed.data,\n        });\n      }\n    }\n    if (!summaryText) {\n      log(\n        'warn',\n        `Summarization failed, falling back to metadata stub ${primaryDescribed.suffix}`,\n        {\n          ...primaryDescribed.data,\n          messagesToRefineCount: messages.length,\n        }\n      );\n      summaryText = generateMetadataStub(messages);\n      usedMetadataStub = true;\n    }\n  }\n\n  return { text: summaryText, usage: summaryUsage, usedMetadataStub };\n}\n\n/** Dispatches run step completion, ON_SUMMARIZE_COMPLETE, and rebuilds token map. */\nasync function dispatchCompletionEvents(params: {\n  graph: CreateSummarizeNodeParams['graph'];\n  runnableConfig?: RunnableConfig;\n  stepId: string;\n  summaryBlock: t.SummaryContentBlock;\n  agentContext: AgentContext;\n  runStep: t.RunStep;\n  summaryUsage?: Partial<UsageMetadata>;\n  agentId: string;\n  /**\n   * Number of messages preserved verbatim by the recency window after\n   * compaction.  Reported via the PostCompact hook payload so observers\n   * (metrics, cleanup) see the true post-compaction message count\n   * instead of always-zero.\n   */\n  messagesAfterCount: number;\n}): Promise<void> {\n  const {\n    graph,\n    runnableConfig,\n    stepId,\n    summaryBlock,\n    agentContext,\n    runStep,\n    summaryUsage,\n    agentId,\n    messagesAfterCount,\n  } = params;\n\n  runStep.summary = summaryBlock;\n  if (summaryUsage) {\n    runStep.usage = {\n      prompt_tokens: Number(summaryUsage.input_tokens) || 0,\n      completion_tokens: Number(summaryUsage.output_tokens) || 0,\n      total_tokens:\n        (Number(summaryUsage.input_tokens) || 0) +\n        (Number(summaryUsage.output_tokens) || 0),\n    };\n  }\n\n  await graph.dispatchRunStepCompleted(\n    stepId,\n    { type: 'summary', summary: summaryBlock } satisfies t.SummaryCompleted,\n    runnableConfig\n  );\n\n  if (runnableConfig) {\n    await safeDispatchCustomEvent(\n      GraphEvents.ON_SUMMARIZE_COMPLETE,\n      {\n        id: stepId,\n        agentId,\n        summary: summaryBlock,\n      } satisfies t.SummarizeCompleteEvent,\n      runnableConfig\n    );\n  }\n\n  const sessionId = graph.runId ?? '';\n  if (graph.hookRegistry?.hasHookFor('PostCompact', sessionId) === true) {\n    const threadId = (\n      runnableConfig?.configurable as Record<string, unknown> | undefined\n    )?.thread_id as string | undefined;\n    const firstBlock = summaryBlock.content?.[0];\n    const summaryText =\n      firstBlock != null &&\n      typeof firstBlock === 'object' &&\n      'text' in firstBlock &&\n      typeof firstBlock.text === 'string'\n        ? firstBlock.text\n        : '';\n    await executeHooks({\n      registry: graph.hookRegistry,\n      input: {\n        hook_event_name: 'PostCompact',\n        runId: sessionId,\n        threadId,\n        agentId,\n        summary: summaryText,\n        messagesAfterCount,\n      },\n      sessionId,\n    }).catch(() => {\n      /* PostCompact is observational — swallow errors */\n    });\n  }\n\n  agentContext.rebuildTokenMapAfterSummarization({});\n}\n\n// ---------------------------------------------------------------------------\n// createSummarizeNode\n// ---------------------------------------------------------------------------\n\ninterface CreateSummarizeNodeParams {\n  agentContext: AgentContext;\n  graph: {\n    contentData: t.RunStep[];\n    contentIndexMap: Map<string, number>;\n    config?: RunnableConfig;\n    runId?: string;\n    isMultiAgent: boolean;\n    hookRegistry?: HookRegistry;\n    dispatchRunStep: (\n      runStep: t.RunStep,\n      config?: RunnableConfig\n    ) => Promise<void>;\n    dispatchRunStepCompleted: (\n      stepId: string,\n      result: t.StepCompleted,\n      config?: RunnableConfig\n    ) => Promise<void>;\n  };\n  generateStepId: (stepKey: string) => [string, number];\n}\n\nexport function createSummarizeNode({\n  agentContext,\n  graph,\n  generateStepId,\n}: CreateSummarizeNodeParams) {\n  return async (\n    state: {\n      messages: BaseMessage[];\n      summarizationRequest?: t.SummarizationNodeInput;\n    },\n    config?: RunnableConfig\n  ): Promise<{ summarizationRequest: undefined; messages?: BaseMessage[] }> => {\n    const request = state.summarizationRequest;\n    if (request == null) {\n      return { summarizationRequest: undefined };\n    }\n\n    /**\n     * Overflow recovery routes through this node purely to get back to the\n     * agent node with a corrected budget, and deliberately spends no model\n     * call on its first attempt: re-pruning under the raised context pressure\n     * drives the pruner's tool-output compression and masking, which is\n     * cheaper than a summary and cannot lose message content. Summarization\n     * is also skipped outright when the caller never enabled it.\n     */\n    if (\n      request.reason === 'overflow' &&\n      (request.allowSummarization !== true ||\n        agentContext.summarizationEnabled !== true)\n    ) {\n      emitAgentLog(\n        config,\n        'debug',\n        'summarize',\n        'Overflow recovery re-prune — compressing tool output without a summarization call',\n        {\n          maxContextTokens: agentContext.maxContextTokens,\n          summarizationEnabled: agentContext.summarizationEnabled === true,\n          allowSummarization: request.allowSummarization === true,\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      return { summarizationRequest: undefined };\n    }\n\n    const maxCtx = agentContext.maxContextTokens ?? 0;\n    if (maxCtx > 0 && agentContext.instructionTokens >= maxCtx) {\n      emitAgentLog(\n        config,\n        'warn',\n        'summarize',\n        'Summarization skipped, instructions exceed context budget. Reduce the number of tools or increase maxContextTokens.',\n        {\n          instructionTokens: agentContext.instructionTokens,\n          maxContextTokens: maxCtx,\n          breakdown: agentContext.formatTokenBudgetBreakdown(),\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      return { summarizationRequest: undefined };\n    }\n\n    /**\n     * Capture the original-tool-content map locally before doing the\n     * split.  We need it in three places: to restore the head for\n     * summarizer quality, to leave intact on the skip path (state is\n     * unchanged), and — critically — to carry forward the tail-relevant\n     * entries on the summarize-fired path.  Clearing it eagerly here\n     * would lose the originals for masked tool messages that the\n     * recency window keeps in the tail; a future summarization could\n     * then only summarize the masked stub instead of the full payload.\n     */\n    const originalPending = agentContext.pendingOriginalToolContent;\n\n    const restoredMessages = restoreOriginalToolContent(\n      state.messages,\n      originalPending,\n      agentContext.maxContextTokens\n    );\n\n    const runnableConfig = config ?? graph.config;\n\n    const retainRecent = agentContext.summarizationConfig?.retainRecent;\n    const { head: messagesToRefine, tailStartIndex } = splitAtRecencyBoundary(\n      restoredMessages,\n      {\n        turns: retainRecent?.turns ?? DEFAULT_RETAIN_RECENT_TURNS,\n        tokens: retainRecent?.tokens,\n        tokenCounter: agentContext.tokenCounter,\n      }\n    );\n    /**\n     * Use the *masked* messages for the retained tail so that any\n     * truncation prune applied to oversized ToolMessage content stays\n     * truncated in live state.  The summarizer above reads the restored\n     * (full-content) head for summary quality, but reinjecting restored\n     * tool payloads into state would defeat masking and bloat the\n     * checkpoint, forcing more expensive re-pruning on later turns.\n     * `restoreOriginalToolContent` returns an array with identical\n     * length and structure to `state.messages` (replacements only at\n     * specific indices), so the same tailStartIndex slices both arrays\n     * at the same turn boundary.\n     */\n    const messagesToRetain = state.messages.slice(tailStartIndex);\n\n    if (messagesToRefine.length === 0) {\n      /**\n       * Recency window covers the entire conversation — there is no\n       * older content to summarize.  Skipping prevents the model from\n       * destroying the user's most recent message (e.g. a large pasted\n       * payload on the first turn) by replacing it with a generic\n       * checkpoint summary.  Mark the trigger so the same unchanged\n       * state is not re-evaluated on the next prune cycle.\n       */\n      emitAgentLog(\n        config,\n        'debug',\n        'summarize',\n        'Summarization skipped — recency window retains all messages',\n        {\n          messagesRetained: messagesToRetain.length,\n          retainTurns: retainRecent?.turns ?? DEFAULT_RETAIN_RECENT_TURNS,\n        },\n        { runId: graph.runId, agentId: request.agentId }\n      );\n      agentContext.markSummarizationTriggered(state.messages.length);\n      return { summarizationRequest: undefined };\n    }\n\n    const clientConfig = buildSummarizationClientConfig(\n      agentContext,\n      agentContext.summarizationConfig\n    );\n\n    const stepKey = `summarize-${request.agentId}`;\n    const [stepId, stepIndex] = generateStepId(stepKey);\n\n    const placeholderSummary: t.SummaryContentBlock = {\n      type: ContentTypes.SUMMARY,\n      model: clientConfig.modelName,\n      provider: clientConfig.provider,\n    };\n\n    const runStep: t.RunStep = {\n      stepIndex,\n      id: stepId,\n      type: StepTypes.MESSAGE_CREATION,\n      index: graph.contentData.length,\n      stepDetails: {\n        type: StepTypes.MESSAGE_CREATION,\n        message_creation: { message_id: stepId },\n      },\n      summary: placeholderSummary,\n      usage: null,\n    };\n\n    if (graph.runId != null && graph.runId !== '') {\n      runStep.runId = graph.runId;\n    }\n    if (graph.isMultiAgent && agentContext.agentId) {\n      runStep.agentId = agentContext.agentId;\n    }\n\n    await graph.dispatchRunStep(runStep, runnableConfig);\n\n    if (runnableConfig) {\n      await safeDispatchCustomEvent(\n        GraphEvents.ON_SUMMARIZE_START,\n        {\n          agentId: request.agentId,\n          provider: clientConfig.provider,\n          model: clientConfig.modelName,\n          messagesToRefineCount: messagesToRefine.length,\n          summaryVersion: agentContext.summaryVersion + 1,\n        } satisfies t.SummarizeStartEvent,\n        runnableConfig\n      );\n    }\n\n    const sessionId = graph.runId ?? '';\n    if (graph.hookRegistry?.hasHookFor('PreCompact', sessionId) === true) {\n      const threadId = (\n        runnableConfig?.configurable as Record<string, unknown> | undefined\n      )?.thread_id as string | undefined;\n      await executeHooks({\n        registry: graph.hookRegistry,\n        input: {\n          hook_event_name: 'PreCompact',\n          runId: sessionId,\n          threadId,\n          agentId: request.agentId,\n          messagesBeforeCount: messagesToRefine.length,\n          trigger: agentContext.summarizationConfig?.trigger?.type ?? 'default',\n        },\n        sessionId,\n      }).catch(() => {\n        /* PreCompact is observational — swallow errors */\n      });\n    }\n\n    const isSelfSummarizeModel =\n      clientConfig.provider === (agentContext.provider as string);\n    const hasPromptCache =\n      isSelfSummarizeModel &&\n      (agentContext.clientOptions as Record<string, unknown> | undefined)\n        ?.promptCache === true;\n\n    const log: LogFn = (level, message, data) => {\n      emitAgentLog(runnableConfig, level, 'summarize', message, data, {\n        runId: graph.runId,\n        agentId: request.agentId,\n      });\n    };\n\n    log('debug', 'Summarization starting', {\n      messagesToRefineCount: messagesToRefine.length,\n      hasPriorSummary: (agentContext.getSummaryText()?.trim() ?? '') !== '',\n      summaryVersion: agentContext.summaryVersion + 1,\n      isSelfSummarize: isSelfSummarizeModel,\n      hasPromptCache,\n      provider: clientConfig.provider,\n    });\n\n    const summarizeConfig: RunnableConfig | undefined = config\n      ? {\n        ...config,\n        metadata: {\n          ...config.metadata,\n          agent_id: request.agentId,\n          summarization_provider: clientConfig.provider,\n          summarization_model: clientConfig.modelName,\n          /**\n             * Per-call model attribution for usage consumers (the subagent\n             * usage-capture handler): the summarizer's model can differ from\n             * the agent's primary, and providers that emit no `ls_model_name`\n             * would otherwise be billed against the primary config's model.\n             * Omitted for self-summarize (no explicit model — the primary\n             * config fallback is then correct). `tryFallbackProviders`\n             * overrides this per fallback attempt; `INVOKED_PROVIDER` is\n             * stamped by `attemptInvoke` itself.\n             */\n          ...(clientConfig.modelName != null && clientConfig.modelName !== ''\n            ? { [Constants.INVOKED_MODEL]: clientConfig.modelName }\n            : {}),\n        },\n      }\n      : undefined;\n\n    const {\n      text: rawText,\n      usage: summaryUsage,\n      usedMetadataStub,\n    } = await executeSummarizationWithFallback({\n      agentContext,\n      messages: messagesToRefine,\n      clientConfig,\n      summarizeConfig,\n      stepId,\n      usePromptCache: isSelfSummarizeModel && hasPromptCache,\n      log,\n    });\n\n    /**\n     * The metadata stub describes the history rather than summarizing it, so\n     * committing it means removing the head and keeping nothing of what it\n     * said. That trade is never worth making to paper over an overflow: the\n     * recovery would \"succeed\" only by destroying the conversation it was\n     * supposed to preserve. Leave state untouched and let the provider error\n     * surface instead.\n     */\n    if (usedMetadataStub === true && request.reason === 'overflow') {\n      log(\n        'warn',\n        'Overflow summarization failed; keeping history rather than replacing it with a metadata stub'\n      );\n      agentContext.markSummarizationTriggered(state.messages.length);\n      /**\n       * The run step was already dispatched, so it has to be resolved here or\n       * consumers tracking step lifecycle keep an unfinished placeholder for\n       * the rest of the run.\n       */\n      await graph.dispatchRunStepCompleted(\n        stepId,\n        {\n          type: 'summary',\n          summary: placeholderSummary,\n        } satisfies t.SummaryCompleted,\n        runnableConfig\n      );\n      if (runnableConfig) {\n        await safeDispatchCustomEvent(\n          GraphEvents.ON_SUMMARIZE_COMPLETE,\n          {\n            id: stepId,\n            agentId: request.agentId,\n            error:\n              'Summarization failed during overflow recovery; conversation history was preserved',\n          } satisfies t.SummarizeCompleteEvent,\n          runnableConfig\n        );\n      }\n      return { summarizationRequest: undefined };\n    }\n\n    if (!rawText) {\n      agentContext.markSummarizationTriggered(0);\n      if (runnableConfig) {\n        await safeDispatchCustomEvent(\n          GraphEvents.ON_SUMMARIZE_COMPLETE,\n          {\n            id: stepId,\n            agentId: request.agentId,\n            error: 'Summarization produced empty output',\n          } satisfies t.SummarizeCompleteEvent,\n          runnableConfig\n        );\n      }\n      return { summarizationRequest: undefined };\n    }\n\n    const summaryText = enrichSummary(rawText, messagesToRefine);\n\n    const tokenCount = computeSummaryTokenCount(\n      summaryText,\n      summaryUsage,\n      agentContext.tokenCounter\n    );\n\n    agentContext.setSummary(summaryText, tokenCount);\n\n    log('info', 'Summary persisted');\n    log('debug', 'Summary details', {\n      summaryTokens: tokenCount,\n      textLength: summaryText.length,\n      messagesCompacted: messagesToRefine.length,\n      summaryVersion: agentContext.summaryVersion,\n      ...(summaryUsage != null\n        ? {\n          input_tokens: summaryUsage.input_tokens,\n          output_tokens: summaryUsage.output_tokens,\n          cache_read: summaryUsage.input_token_details?.cache_read,\n          cache_creation: summaryUsage.input_token_details?.cache_creation,\n        }\n        : {}),\n    });\n\n    const summaryBlock = buildSummaryBlock({\n      summaryText,\n      tokenCount,\n      coverage: resolveSummaryCoverage(messagesToRetain),\n      stepId,\n      stepIndex: runStep.index,\n      modelName: clientConfig.modelName,\n      provider: clientConfig.provider,\n      summaryVersion: agentContext.summaryVersion,\n    });\n\n    await dispatchCompletionEvents({\n      graph,\n      runnableConfig,\n      stepId,\n      summaryBlock,\n      agentContext,\n      runStep,\n      summaryUsage,\n      agentId: request.agentId,\n      messagesAfterCount: messagesToRetain.length,\n    });\n\n    /**\n     * `dispatchCompletionEvents` calls `rebuildTokenMapAfterSummarization({})`\n     * which resets the dedupe baseline to 0 — correct under the legacy\n     * \"remove-all only\" shape where no messages survived, but stale once\n     * the recency window keeps a tail.  Realign the baseline to the\n     * surviving tail length so a subsequent prune cycle on the unchanged\n     * tail short-circuits via `shouldSkipSummarization` instead of\n     * looping back into another summarize call.\n     */\n    agentContext.markSummarizationTriggered(messagesToRetain.length);\n\n    /**\n     * Carry forward the original-content entries that correspond to the\n     * retained tail, reindexed for the post-removeAll state where tail\n     * messages start at index 0.  Without this, a future summarization\n     * that pulls these tail messages into its head would only see the\n     * masked stubs (since `setSummary` clears `pruneMessages`, and the\n     * fresh pruner at the next turn has no record of prior masks).\n     * Entries for indices < `tailStartIndex` belong to messages we just\n     * summarized — they are no longer reachable so they are dropped.\n     */\n    if (originalPending != null && originalPending.size > 0) {\n      const tailPending = new Map<number, string>();\n      for (const [idx, content] of originalPending) {\n        if (idx >= tailStartIndex) {\n          tailPending.set(idx - tailStartIndex, content);\n        }\n      }\n      agentContext.pendingOriginalToolContent =\n        tailPending.size > 0 ? tailPending : undefined;\n    } else {\n      agentContext.pendingOriginalToolContent = undefined;\n    }\n\n    return {\n      summarizationRequest: undefined,\n      messages:\n        messagesToRetain.length > 0\n          ? [createRemoveAllMessage(), ...messagesToRetain]\n          : [createRemoveAllMessage()],\n    };\n  };\n}\n\n/** Extracts text from an LLM response, skipping reasoning/thinking blocks. */\nfunction extractResponseText(response: { content: string | object }): string {\n  const { content } = response;\n  if (typeof content === 'string') {\n    return content.trim();\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const block of content) {\n    if (typeof block === 'string') {\n      parts.push(block);\n      continue;\n    }\n    if (block == null || typeof block !== 'object') {\n      continue;\n    }\n    const rec = block as Record<string, unknown>;\n    if (\n      rec.type === ContentTypes.THINKING ||\n      rec.type === ContentTypes.REASONING_CONTENT ||\n      rec.type === 'redacted_thinking'\n    ) {\n      continue;\n    }\n    if (rec.type === 'text' && typeof rec.text === 'string') {\n      parts.push(rec.text);\n    }\n  }\n  return parts.join('').trim();\n}\n\nfunction buildSummarizationInstruction(\n  promptText: string,\n  updatePromptText: string | undefined,\n  priorSummaryText: string\n): string {\n  const effectivePrompt = priorSummaryText\n    ? (updatePromptText ?? promptText)\n    : promptText;\n  const parts = [effectivePrompt];\n  if (priorSummaryText) {\n    parts.push(\n      `\\n\\n<previous-summary>\\n${priorSummaryText}\\n</previous-summary>`\n    );\n  }\n  return parts.join('');\n}\n\n/** Creates an `onChunk` callback that dispatches `ON_SUMMARIZE_DELTA` events for streaming. */\nfunction createSummarizationChunkHandler({\n  stepId,\n  config,\n  provider,\n  reasoningKey = 'reasoning_content',\n}: {\n  stepId?: string;\n  config?: RunnableConfig;\n  provider?: Providers;\n  reasoningKey?: 'reasoning_content' | 'reasoning';\n}): OnChunk | undefined {\n  if (stepId == null || stepId === '' || !config) {\n    return undefined;\n  }\n  return (chunk) => {\n    const chunkAny = chunk as Parameters<typeof getChunkContent>[0]['chunk'];\n    const raw = getChunkContent({ chunk: chunkAny, provider, reasoningKey });\n    if (raw == null || (typeof raw === 'string' && !raw)) {\n      return;\n    }\n    const contentBlocks: t.MessageContentComplex[] =\n      typeof raw === 'string'\n        ? [{ type: ContentTypes.TEXT, text: raw } as t.MessageContentComplex]\n        : raw;\n\n    void safeDispatchCustomEvent(\n      GraphEvents.ON_SUMMARIZE_DELTA,\n      {\n        id: stepId,\n        delta: {\n          summary: {\n            type: ContentTypes.SUMMARY,\n            content: contentBlocks,\n            provider: String(config.metadata?.summarization_provider ?? ''),\n            model: String(config.metadata?.summarization_model ?? ''),\n          },\n        },\n      } satisfies t.SummarizeDeltaEvent,\n      config\n    );\n  };\n}\n\nfunction traceConfig(\n  config: RunnableConfig | undefined,\n  stage: string\n): RunnableConfig | undefined {\n  if (!config) {\n    return undefined;\n  }\n  return {\n    ...config,\n    runName: `summarization:${stage}`,\n    metadata: { ...config.metadata, summarization: true, stage },\n  };\n}\n\n/**\n * Cache-friendly compaction: sends raw conversation messages with the\n * summarization instruction appended as the final HumanMessage.\n * Providers with prompt caching get a cache hit on the system prompt +\n * tool definitions prefix.\n */\nasync function summarizeWithCacheHit({\n  model,\n  messages,\n  promptText,\n  updatePromptText,\n  priorSummaryText,\n  config,\n  stepId,\n  provider,\n  reasoningKey,\n  usePromptCache,\n  promptCacheTtl,\n  log,\n}: {\n  model: t.ChatModel;\n  messages: BaseMessage[];\n  promptText: string;\n  updatePromptText?: string;\n  priorSummaryText: string;\n  config?: RunnableConfig;\n  stepId?: string;\n  provider: Providers;\n  reasoningKey?: 'reasoning_content' | 'reasoning';\n  usePromptCache?: boolean;\n  promptCacheTtl?: PromptCacheTtl;\n  log?: LogFn;\n}): Promise<{ text: string; usage?: Partial<UsageMetadata> }> {\n  const instruction = buildSummarizationInstruction(\n    promptText,\n    updatePromptText,\n    priorSummaryText\n  );\n\n  const fullMessages = [...messages, new HumanMessage(instruction)];\n  const invokeMessages =\n    usePromptCache === true\n      ? addTailCacheControl(fullMessages, promptCacheTtl)\n      : fullMessages;\n\n  const result = await attemptInvoke(\n    {\n      model,\n      messages: invokeMessages,\n      provider,\n      onChunk: createSummarizationChunkHandler({\n        stepId,\n        config: traceConfig(config, 'cache_hit_compaction'),\n        provider,\n        reasoningKey,\n      }),\n    },\n    traceConfig(config, 'cache_hit_compaction')\n  );\n\n  const responseMsg = result.messages?.[0];\n  const text = responseMsg\n    ? extractResponseText(responseMsg as { content: string | object })\n    : '';\n  let usage: Partial<UsageMetadata> | undefined;\n  let usageSource = 'none';\n  if (\n    responseMsg != null &&\n    'usage_metadata' in responseMsg &&\n    responseMsg.usage_metadata != null\n  ) {\n    usage = responseMsg.usage_metadata as Partial<UsageMetadata>;\n    usageSource = 'usage_metadata';\n  } else if (responseMsg != null) {\n    const respMeta = responseMsg.response_metadata as\n      | Record<string, unknown>\n      | undefined;\n    const raw = (respMeta?.metadata as Record<string, unknown> | undefined)\n      ?.usage as Record<string, unknown> | undefined;\n    if (raw != null) {\n      usage = {\n        input_tokens: Number(raw.inputTokens) || undefined,\n        output_tokens: Number(raw.outputTokens) || undefined,\n      } as Partial<UsageMetadata>;\n      usageSource = 'response_metadata';\n    }\n  }\n  const cacheDetails = (\n    usage as\n      | {\n          input_token_details?: {\n            cache_read?: number;\n            cache_creation?: number;\n          };\n        }\n      | undefined\n  )?.input_token_details;\n  log?.('debug', 'Summarization LLM usage', {\n    source: usageSource,\n    input_tokens: usage?.input_tokens,\n    output_tokens: usage?.output_tokens,\n    ...(cacheDetails?.cache_read != null || cacheDetails?.cache_creation != null\n      ? {\n        'input_token_details.cache_read': cacheDetails.cache_read,\n        'input_token_details.cache_creation': cacheDetails.cache_creation,\n      }\n      : {}),\n  });\n  return { text, usage };\n}\n"],"mappings":"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"}

package/dist/esm/tools/intentArg.mjs

@@ -1,8 +1,29 @@
 //#region src/tools/intentArg.ts
 /** Argument carrying the model-authored label for a tool call. */
 const INTENT_ARG = "intent";
-/** Model-facing instruction for the injected `intent` property. */
-const INTENT_DESCRIPTION = "ALWAYS write this field FIRST, before any other argument. One short sentence, present progressive, stating what this specific call is about to do: \"Searching for OAuth handling in the callback router\". It is shown to the user as the live status label for this call while it runs, so write it for a human reading a progress line. Do not restate the tool name. Do not exceed one sentence. When you make several calls to the same tool in one turn, each intent must distinguish that call from its siblings.";
+/**
+* Opening words of {@link INTENT_DESCRIPTION}, and the discriminator that
+* tells the injected LABEL apart from a tool's own business parameter that
+* merely shares the name `intent`.
+*
+* Exported because host applications reimplement the same strip/sanitize
+* passes and would otherwise duplicate this as a string literal: if the two
+* copies drift, the host silently stops recognizing SDK-native labels and
+* fails OPEN (labels stay in schemas, opt-outs stop working) with no error.
+* Any edit to the description must preserve this prefix verbatim.
+*/
+const INTENT_LABEL_MARKER = "ALWAYS write this field FIRST";
+/**
+* Model-facing instruction for the injected `intent` property.
+*
+* Deliberately terse — it is repeated on every opted-in tool schema, on every
+* request, so each sentence is paid for many times over. What remains is
+* load-bearing: first-position placement (the entire streaming mechanism),
+* the one-sentence present-progressive form, who reads it, and the sibling
+* rule, without which models emit identical labels for parallel calls to one
+* tool and defeat the feature's headline case.
+*/
+const INTENT_DESCRIPTION = `${INTENT_LABEL_MARKER}, before any other argument. One present-progressive sentence saying what THIS call is about to do: "Searching for OAuth handling in the callback router". Shown to the user as this call's live status. Never name the tool. Sibling calls to one tool must differ.`;
 /**
 * Canonical (frozen) shape of the injected property. Always embed a COPY
 * (`{ ...INTENT_PROPERTY }`): LangChain's JSON-schema validator stamps a
@@ -26,6 +47,38 @@ function isIntentLabelProperty(property) {
 	return record.type === "string" && typeof record.description === "string" && record.description.startsWith("ALWAYS write this field FIRST");
 }
 /**
+* Returns a copy of `parameters` without the injected intent LABEL — the
+* opt-out for consumers that render no status label and should not pay for
+* the property.
+*
+* The SDK's native schemas carry the label unconditionally, so without this
+* an embedder has no lever at all: `withIntent` is applied at module scope.
+* Marker-guarded, so a tool's own business parameter named `intent` is never
+* removed. Returns the input unchanged when there is nothing to strip.
+*
+* `required` is pruned alongside the property: a schema that lists `intent`
+* as required (strict-mode normalization does exactly that, since OpenAI
+* strict function schemas require every property to appear in `required`)
+* would otherwise be left naming a property it no longer declares, which is
+* invalid JSON Schema and gets rejected by the provider instead of quietly
+* opting out.
+*/
+function withoutIntent(parameters) {
+	const props = parameters?.properties;
+	if (parameters == null || props == null || !isIntentLabelProperty(props["intent"])) return parameters;
+	const { [INTENT_ARG]: _omit, ...rest } = props;
+	const next = {
+		...parameters,
+		properties: rest
+	};
+	if (parameters.required != null) {
+		const required = parameters.required.filter((key) => key !== INTENT_ARG);
+		if (required.length > 0) next.required = required;
+		else delete next.required;
+	}
+	return next;
+}
+/**
 * Returns a copy of the parameters schema with `intent` prepended as the
 * FIRST property (object key order is insertion order and every provider
 * serializer preserves it — first key in the schema means first key in the
@@ -79,54 +132,24 @@ function stripIntent(args) {
 	return rest;
 }
 /**
-* Leading-verb map for the mechanical outcome transform, keyed by the
-* lowercased first word of the intent. Deliberately small: an unknown leading
-* word leaves the intent unchanged rather than mangling it.
-*/
-const OUTCOME_VERB_MAP = new Map([
-	["searching", "Searched"],
-	["reading", "Read"],
-	["writing", "Wrote"],
-	["editing", "Edited"],
-	["running", "Ran"],
-	["creating", "Created"],
-	["checking", "Checked"],
-	["fetching", "Fetched"],
-	["listing", "Listed"],
-	["looking", "Looked"],
-	["building", "Built"],
-	["deleting", "Deleted"],
-	["updating", "Updated"],
-	["adding", "Added"],
-	["removing", "Removed"],
-	["verifying", "Verified"],
-	["analyzing", "Analyzed"],
-	["generating", "Generated"],
-	["delegating", "Delegated"],
-	["spawning", "Spawned"],
-	["compiling", "Compiled"],
-	["grepping", "Grepped"]
-]);
-function matchLeadingCase(replacement, original) {
-	if (original.charAt(0) === original.charAt(0).toLowerCase()) return replacement.charAt(0).toLowerCase() + replacement.slice(1);
-	return replacement;
-}
-function transformLeadingVerb(intent) {
-	const spaceIdx = intent.search(/\s/);
-	const leading = spaceIdx === -1 ? intent : intent.slice(0, spaceIdx);
-	const mapped = OUTCOME_VERB_MAP.get(leading.toLowerCase());
-	if (mapped == null) return intent;
-	return matchLeadingCase(mapped, leading) + intent.slice(leading.length);
-}
-/**
 * Resolves the settled label for a call from its model-authored `intent` and
 * the tool's result fields, in precedence order:
 *
 *  1. `outcome` — full replacement authored by the tool.
 *  2. `outcome_patch` — first occurrence of `from` in the intent replaced
 *     with `to` (case-sensitive); no-op when `from` is absent or empty.
-*  3. Mechanical transform — the leading word mapped present-progressive →
-*     past tense; an unknown leading word leaves the intent unchanged.
+*  3. Otherwise the intent is returned UNCHANGED.
+*
+* There is deliberately no mechanical present-progressive→past-tense rewrite.
+* Such a transform can only be a closed list of English verbs, which makes it
+* wrong in three ways at once: it never fires for the non-English labels this
+* feature expects (the model answers in the user's language), it fires for
+* some sibling calls and not others inside one group — "Searched…" beside
+* "Recording…" — and it quietly enumerates a vocabulary in a feature whose
+* premise is that the sentence is free-form. Completion is conveyed by UI
+* state (the shimmer stopping, the icon settling), which is language-neutral
+* and always consistent; a tool that wants past tense says so explicitly via
+* `outcome` or `outcome_patch`.
 *
 * Returns undefined when there is neither an intent nor an outcome, so
 * callers fall back to their default label. Pure and dependency-free — host
@@ -142,7 +165,7 @@ function applyOutcome(intent, result) {
 	*  argument would interpret `$&`/`$'`-style tokens in tool-authored
 	*  text (e.g. labels derived from shell syntax). */
 	return intent.replace(patch.from, () => patch.to);
-	return transformLeadingVerb(intent);
+	return intent;
 }
 /**
 * Hard cap on an emitted outcome label. The label is a single progress line
@@ -160,15 +183,16 @@ function boundOutcomeLabel(label) {
 /**
 * Resolves the settled label to emit on a completion event: only when the
 * tool actually authored `outcome`/`outcome_patch` fields. Returns undefined
-* otherwise — the mechanical transform of a bare intent is left to the host
-* so the wire never carries a label the host can derive itself. The result
-* is collapsed to a bounded single line before emission.
+* otherwise, so the wire never carries a label the host already has — a bare
+* intent needs no settled form, because it is displayed unchanged and the UI
+* conveys completion through its own state. Hosts must NOT rewrite it (see
+* {@link applyOutcome} for why a tense transform is deliberately absent). The
+* result is collapsed to a bounded single line before emission.
 *
 * For failed calls (`isError`), only tool-AUTHORED text may label the call:
-* an explicit `outcome`, or a patch whose `from` actually matches the
-* intent. An unmatched patch must not fall through to the mechanical
-* past-tense transform — wording drift in a failure patch would otherwise
-* render a success-looking label for an error.
+* an explicit `outcome`, or a patch whose `from` actually matches the intent.
+* An unmatched patch resolves to undefined rather than silently reusing the
+* in-flight intent, so a failure is never labelled as though it succeeded.
 */
 function resolveToolOutcome(args, fields, options) {
 	if (fields == null || fields.outcome == null && fields.outcome_patch == null) return;
@@ -215,6 +239,6 @@ function readOutcomeFields(source) {
 	};
 }
 //#endregion
-export { INTENT_ARG, INTENT_DESCRIPTION, INTENT_PROPERTY, applyOutcome, isIntentLabelProperty, outcomeFieldsFromResult, readIntent, readOutcomeFields, resolveToolOutcome, stripIntent, withIntent };
+export { INTENT_ARG, INTENT_DESCRIPTION, INTENT_LABEL_MARKER, INTENT_PROPERTY, applyOutcome, isIntentLabelProperty, outcomeFieldsFromResult, readIntent, readOutcomeFields, resolveToolOutcome, stripIntent, withIntent, withoutIntent };
 
 //# sourceMappingURL=intentArg.mjs.map

package/dist/esm/tools/intentArg.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intentArg.mjs","names":[],"sources":["../../../src/tools/intentArg.ts"],"sourcesContent":["/**\n * @fileoverview Tool intent labels.\n *\n * Lets a tool declare, as the FIRST property of its input schema, an `intent`\n * string: one model-authored sentence stating what that specific call is about\n * to do (\"Searching for OAuth handling in the callback router\"). Because the\n * property is first, it is the first key providers stream in the tool-call\n * args, so a host UI can render it as the call's live status label before the\n * rest of the args exist. When the call settles, {@link applyOutcome} edits\n * the sentence in place into its outcome form — a tool-supplied replacement\n * (`outcome`), a tool-supplied span edit (`outcome_patch`), or a mechanical\n * present-progressive→past-tense transform of the leading verb.\n *\n * The arg is always optional (never listed in `required`): the same schemas\n * are callable from programmatic tool calling, where no UI renders a label\n * and forcing generated code to fabricate one would be pure cost. Tool bodies\n * must call {@link stripIntent} before using their args so no tool receives a\n * parameter it did not declare.\n */\n\nimport type { JsonSchemaType, OutcomePatch } from '@/types';\n\n/** Argument carrying the model-authored label for a tool call. */\nexport const INTENT_ARG = 'intent';\n\n/** Model-facing instruction for the injected `intent` property. */\nexport const INTENT_DESCRIPTION =\n  'ALWAYS write this field FIRST, before any other argument. One short sentence, ' +\n  'present progressive, stating what this specific call is about to do: ' +\n  '\"Searching for OAuth handling in the callback router\". It is shown to the user ' +\n  'as the live status label for this call while it runs, so write it for a human ' +\n  'reading a progress line. Do not restate the tool name. Do not exceed one sentence. ' +\n  'When you make several calls to the same tool in one turn, each intent must ' +\n  'distinguish that call from its siblings.';\n\n/**\n * Canonical (frozen) shape of the injected property. Always embed a COPY\n * (`{ ...INTENT_PROPERTY }`): LangChain's JSON-schema validator stamps a\n * `__absolute_uri__` marker onto every subschema it dereferences, which\n * throws on a frozen object — and a single shared instance would be stamped\n * with one schema's URI while embedded in many.\n */\nexport const INTENT_PROPERTY: JsonSchemaType = Object.freeze<JsonSchemaType>({\n  type: 'string',\n  description: INTENT_DESCRIPTION,\n});\n\n/**\n * Discriminates the intent LABEL property from a tool's own business\n * parameter that merely shares the name: the label contract always opens\n * with the same instruction. Removal/sanitize passes must never strip a\n * parameter the tool actually needs.\n */\nexport function isIntentLabelProperty(property: unknown): boolean {\n  if (property == null || typeof property !== 'object') {\n    return false;\n  }\n  const record = property as { type?: unknown; description?: unknown };\n  return (\n    record.type === 'string' &&\n    typeof record.description === 'string' &&\n    record.description.startsWith('ALWAYS write this field FIRST')\n  );\n}\n\n/**\n * Returns a copy of the parameters schema with `intent` prepended as the\n * FIRST property (object key order is insertion order and every provider\n * serializer preserves it — first key in the schema means first key in the\n * streamed input). Never mutates the input; no-op when the schema already\n * declares `intent`. The property is not added to `required`.\n */\nexport function withIntent(parameters?: JsonSchemaType): JsonSchemaType {\n  const existingProps = parameters?.properties ?? {};\n  if (INTENT_ARG in existingProps) {\n    return parameters as JsonSchemaType;\n  }\n  return {\n    ...parameters,\n    type: 'object',\n    properties: { [INTENT_ARG]: { ...INTENT_PROPERTY }, ...existingProps },\n  };\n}\n\n/**\n * Coerces tool-call args to an object, parsing a stringified JSON object\n * (some providers deliver args as a string). Returns undefined otherwise.\n */\nfunction coerceArgsObject(args: unknown): Record<string, unknown> | undefined {\n  if (typeof args === 'object' && args !== null && !Array.isArray(args)) {\n    return args as Record<string, unknown>;\n  }\n  if (typeof args === 'string' && args.trim().startsWith('{')) {\n    try {\n      const parsed = JSON.parse(args) as unknown;\n      if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n        return parsed as Record<string, unknown>;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Reads the model-authored intent from tool-call args (handles stringified\n * args). Returns undefined when absent, empty, or not a string.\n */\nexport function readIntent(args: unknown): string | undefined {\n  const value = coerceArgsObject(args)?.[INTENT_ARG];\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed;\n}\n\n/**\n * Returns the args without the `intent` key so downstream consumers that did\n * not declare it never receive it. Parses stringified JSON object args;\n * returns the value unchanged when the key is absent.\n */\nexport function stripIntent(args: unknown): unknown {\n  const obj = coerceArgsObject(args);\n  if (!obj || !(INTENT_ARG in obj)) {\n    return args;\n  }\n  const { [INTENT_ARG]: _omit, ...rest } = obj;\n  return rest;\n}\n\n/**\n * Leading-verb map for the mechanical outcome transform, keyed by the\n * lowercased first word of the intent. Deliberately small: an unknown leading\n * word leaves the intent unchanged rather than mangling it.\n */\nconst OUTCOME_VERB_MAP: ReadonlyMap<string, string> = new Map([\n  ['searching', 'Searched'],\n  ['reading', 'Read'],\n  ['writing', 'Wrote'],\n  ['editing', 'Edited'],\n  ['running', 'Ran'],\n  ['creating', 'Created'],\n  ['checking', 'Checked'],\n  ['fetching', 'Fetched'],\n  ['listing', 'Listed'],\n  ['looking', 'Looked'],\n  ['building', 'Built'],\n  ['deleting', 'Deleted'],\n  ['updating', 'Updated'],\n  ['adding', 'Added'],\n  ['removing', 'Removed'],\n  ['verifying', 'Verified'],\n  ['analyzing', 'Analyzed'],\n  ['generating', 'Generated'],\n  ['delegating', 'Delegated'],\n  ['spawning', 'Spawned'],\n  ['compiling', 'Compiled'],\n  ['grepping', 'Grepped'],\n]);\n\nfunction matchLeadingCase(replacement: string, original: string): string {\n  if (original.charAt(0) === original.charAt(0).toLowerCase()) {\n    return replacement.charAt(0).toLowerCase() + replacement.slice(1);\n  }\n  return replacement;\n}\n\nfunction transformLeadingVerb(intent: string): string {\n  const spaceIdx = intent.search(/\\s/);\n  const leading = spaceIdx === -1 ? intent : intent.slice(0, spaceIdx);\n  const mapped = OUTCOME_VERB_MAP.get(leading.toLowerCase());\n  if (mapped == null) {\n    return intent;\n  }\n  return matchLeadingCase(mapped, leading) + intent.slice(leading.length);\n}\n\n/**\n * Resolves the settled label for a call from its model-authored `intent` and\n * the tool's result fields, in precedence order:\n *\n *  1. `outcome` — full replacement authored by the tool.\n *  2. `outcome_patch` — first occurrence of `from` in the intent replaced\n *     with `to` (case-sensitive); no-op when `from` is absent or empty.\n *  3. Mechanical transform — the leading word mapped present-progressive →\n *     past tense; an unknown leading word leaves the intent unchanged.\n *\n * Returns undefined when there is neither an intent nor an outcome, so\n * callers fall back to their default label. Pure and dependency-free — host\n * UIs needing identical logic can import or mirror it.\n */\nexport function applyOutcome(\n  intent: string | undefined,\n  result?: { outcome?: string; outcome_patch?: OutcomePatch },\n): string | undefined {\n  const outcome = result?.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return outcome;\n  }\n  if (intent == null || intent === '') {\n    return undefined;\n  }\n  const patch = result?.outcome_patch;\n  if (patch != null && patch.from !== '' && intent.includes(patch.from)) {\n    /** Replacement callback keeps `to` verbatim — a direct string second\n     *  argument would interpret `$&`/`$'`-style tokens in tool-authored\n     *  text (e.g. labels derived from shell syntax). */\n    return intent.replace(patch.from, () => patch.to);\n  }\n  return transformLeadingVerb(intent);\n}\n\n/**\n * Hard cap on an emitted outcome label. The label is a single progress line\n * in UI chrome; a tool that derives it from data (or a malformed patch)\n * must not be able to inflate completion events or persisted parts.\n */\nconst MAX_OUTCOME_CHARS = 256;\n\nfunction boundOutcomeLabel(label: string | undefined): string | undefined {\n  if (label == null) {\n    return undefined;\n  }\n  const singleLine = label.replace(/\\s+/g, ' ').trim();\n  if (singleLine === '') {\n    return undefined;\n  }\n  if (singleLine.length <= MAX_OUTCOME_CHARS) {\n    return singleLine;\n  }\n  return `${singleLine.slice(0, MAX_OUTCOME_CHARS - 1)}…`;\n}\n\n/**\n * Resolves the settled label to emit on a completion event: only when the\n * tool actually authored `outcome`/`outcome_patch` fields. Returns undefined\n * otherwise — the mechanical transform of a bare intent is left to the host\n * so the wire never carries a label the host can derive itself. The result\n * is collapsed to a bounded single line before emission.\n *\n * For failed calls (`isError`), only tool-AUTHORED text may label the call:\n * an explicit `outcome`, or a patch whose `from` actually matches the\n * intent. An unmatched patch must not fall through to the mechanical\n * past-tense transform — wording drift in a failure patch would otherwise\n * render a success-looking label for an error.\n */\nexport function resolveToolOutcome(\n  args: unknown,\n  fields?: { outcome?: string; outcome_patch?: OutcomePatch } | null,\n  options?: { isError?: boolean },\n): string | undefined {\n  if (fields == null || (fields.outcome == null && fields.outcome_patch == null)) {\n    return undefined;\n  }\n  if (options?.isError !== true) {\n    return boundOutcomeLabel(applyOutcome(readIntent(args), fields));\n  }\n  const outcome = fields.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return boundOutcomeLabel(outcome);\n  }\n  const intent = readIntent(args);\n  const patch = fields.outcome_patch;\n  if (\n    intent != null &&\n    patch != null &&\n    patch.from !== '' &&\n    intent.includes(patch.from)\n  ) {\n    return boundOutcomeLabel(intent.replace(patch.from, () => patch.to));\n  }\n  return undefined;\n}\n\n/**\n * Reads the outcome fields off a tool-execution result: the typed\n * `outcome`/`outcome_patch` fields when present, else the artifact channel\n * (see {@link readOutcomeFields}) — so a `content_and_artifact` tool authors\n * its label the same way on the direct and event-driven paths.\n */\nexport function outcomeFieldsFromResult(result: {\n  outcome?: string;\n  outcome_patch?: OutcomePatch;\n  artifact?: unknown;\n}): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (result.outcome != null || result.outcome_patch != null) {\n    return result;\n  }\n  return readOutcomeFields(result.artifact);\n}\n\n/**\n * Extracts validated `outcome`/`outcome_patch` fields from an arbitrary\n * value — the artifact channel through which an in-process\n * `content_and_artifact` tool authors its settled label. Returns undefined\n * when neither field is usable.\n */\nexport function readOutcomeFields(\n  source: unknown,\n): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (source == null || typeof source !== 'object' || Array.isArray(source)) {\n    return undefined;\n  }\n  const record = source as Record<string, unknown>;\n  const outcome =\n    typeof record.outcome === 'string' && record.outcome.trim() !== ''\n      ? record.outcome\n      : undefined;\n  let outcome_patch: OutcomePatch | undefined;\n  const rawPatch = record.outcome_patch;\n  if (rawPatch != null && typeof rawPatch === 'object' && !Array.isArray(rawPatch)) {\n    const patch = rawPatch as Record<string, unknown>;\n    if (typeof patch.from === 'string' && typeof patch.to === 'string') {\n      outcome_patch = { from: patch.from, to: patch.to };\n    }\n  }\n  if (outcome == null && outcome_patch == null) {\n    return undefined;\n  }\n  return { outcome, outcome_patch };\n}\n"],"mappings":"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"}
+{"version":3,"file":"intentArg.mjs","names":[],"sources":["../../../src/tools/intentArg.ts"],"sourcesContent":["/**\n * @fileoverview Tool intent labels.\n *\n * Lets a tool declare, as the FIRST property of its input schema, an `intent`\n * string: one model-authored sentence stating what that specific call is about\n * to do (\"Searching for OAuth handling in the callback router\"). Because the\n * property is first, it is the first key providers stream in the tool-call\n * args, so a host UI can render it as the call's live status label before the\n * rest of the args exist. When the call settles, {@link applyOutcome} edits\n * the sentence in place into its outcome form — a tool-supplied replacement\n * (`outcome`) or a tool-supplied span edit (`outcome_patch`). Absent either,\n * the label is left exactly as the model wrote it: completion is a UI state\n * (the shimmer stopping, the icon settling), not a tense change.\n *\n * The arg is always optional (never listed in `required`): the same schemas\n * are callable from programmatic tool calling, where no UI renders a label\n * and forcing generated code to fabricate one would be pure cost. Tool bodies\n * must call {@link stripIntent} before using their args so no tool receives a\n * parameter it did not declare.\n */\n\nimport type { JsonSchemaType, OutcomePatch } from '@/types';\n\n/** Argument carrying the model-authored label for a tool call. */\nexport const INTENT_ARG = 'intent';\n\n/**\n * Opening words of {@link INTENT_DESCRIPTION}, and the discriminator that\n * tells the injected LABEL apart from a tool's own business parameter that\n * merely shares the name `intent`.\n *\n * Exported because host applications reimplement the same strip/sanitize\n * passes and would otherwise duplicate this as a string literal: if the two\n * copies drift, the host silently stops recognizing SDK-native labels and\n * fails OPEN (labels stay in schemas, opt-outs stop working) with no error.\n * Any edit to the description must preserve this prefix verbatim.\n */\nexport const INTENT_LABEL_MARKER = 'ALWAYS write this field FIRST';\n\n/**\n * Model-facing instruction for the injected `intent` property.\n *\n * Deliberately terse — it is repeated on every opted-in tool schema, on every\n * request, so each sentence is paid for many times over. What remains is\n * load-bearing: first-position placement (the entire streaming mechanism),\n * the one-sentence present-progressive form, who reads it, and the sibling\n * rule, without which models emit identical labels for parallel calls to one\n * tool and defeat the feature's headline case.\n */\nexport const INTENT_DESCRIPTION =\n  `${INTENT_LABEL_MARKER}, before any other argument. One present-progressive ` +\n  'sentence saying what THIS call is about to do: \"Searching for OAuth handling ' +\n  'in the callback router\". Shown to the user as this call\\'s live status. ' +\n  'Never name the tool. Sibling calls to one tool must differ.';\n\n/**\n * Canonical (frozen) shape of the injected property. Always embed a COPY\n * (`{ ...INTENT_PROPERTY }`): LangChain's JSON-schema validator stamps a\n * `__absolute_uri__` marker onto every subschema it dereferences, which\n * throws on a frozen object — and a single shared instance would be stamped\n * with one schema's URI while embedded in many.\n */\nexport const INTENT_PROPERTY: JsonSchemaType = Object.freeze<JsonSchemaType>({\n  type: 'string',\n  description: INTENT_DESCRIPTION,\n});\n\n/**\n * Discriminates the intent LABEL property from a tool's own business\n * parameter that merely shares the name: the label contract always opens\n * with the same instruction. Removal/sanitize passes must never strip a\n * parameter the tool actually needs.\n */\nexport function isIntentLabelProperty(property: unknown): boolean {\n  if (property == null || typeof property !== 'object') {\n    return false;\n  }\n  const record = property as { type?: unknown; description?: unknown };\n  return (\n    record.type === 'string' &&\n    typeof record.description === 'string' &&\n    record.description.startsWith(INTENT_LABEL_MARKER)\n  );\n}\n\n/**\n * Schema shape accepted by {@link withoutIntent}.\n *\n * `required` is widened to `readonly string[]` because the SDK's own native\n * schemas are declared `as const` — their `required` is a readonly tuple, and\n * a mutable `string[]` parameter would reject the very schemas this helper\n * exists for (TS2345), forcing embedders to cast to use the advertised API.\n */\nexport type IntentStrippableSchema = Omit<JsonSchemaType, 'required'> & {\n  required?: readonly string[];\n};\n\n/**\n * Returns a copy of `parameters` without the injected intent LABEL — the\n * opt-out for consumers that render no status label and should not pay for\n * the property.\n *\n * The SDK's native schemas carry the label unconditionally, so without this\n * an embedder has no lever at all: `withIntent` is applied at module scope.\n * Marker-guarded, so a tool's own business parameter named `intent` is never\n * removed. Returns the input unchanged when there is nothing to strip.\n *\n * `required` is pruned alongside the property: a schema that lists `intent`\n * as required (strict-mode normalization does exactly that, since OpenAI\n * strict function schemas require every property to appear in `required`)\n * would otherwise be left naming a property it no longer declares, which is\n * invalid JSON Schema and gets rejected by the provider instead of quietly\n * opting out.\n */\nexport function withoutIntent(parameters?: IntentStrippableSchema): JsonSchemaType | undefined {\n  const props = parameters?.properties;\n  if (parameters == null || props == null || !isIntentLabelProperty(props[INTENT_ARG])) {\n    return parameters as JsonSchemaType | undefined;\n  }\n  const { [INTENT_ARG]: _omit, ...rest } = props;\n  const next: JsonSchemaType = {\n    ...(parameters as JsonSchemaType),\n    properties: rest,\n  };\n  if (parameters.required != null) {\n    const required = parameters.required.filter((key) => key !== INTENT_ARG);\n    if (required.length > 0) {\n      next.required = required;\n    } else {\n      delete next.required;\n    }\n  }\n  return next;\n}\n\n/**\n * Returns a copy of the parameters schema with `intent` prepended as the\n * FIRST property (object key order is insertion order and every provider\n * serializer preserves it — first key in the schema means first key in the\n * streamed input). Never mutates the input; no-op when the schema already\n * declares `intent`. The property is not added to `required`.\n */\nexport function withIntent(parameters?: JsonSchemaType): JsonSchemaType {\n  const existingProps = parameters?.properties ?? {};\n  if (INTENT_ARG in existingProps) {\n    return parameters as JsonSchemaType;\n  }\n  return {\n    ...parameters,\n    type: 'object',\n    properties: { [INTENT_ARG]: { ...INTENT_PROPERTY }, ...existingProps },\n  };\n}\n\n/**\n * Coerces tool-call args to an object, parsing a stringified JSON object\n * (some providers deliver args as a string). Returns undefined otherwise.\n */\nfunction coerceArgsObject(args: unknown): Record<string, unknown> | undefined {\n  if (typeof args === 'object' && args !== null && !Array.isArray(args)) {\n    return args as Record<string, unknown>;\n  }\n  if (typeof args === 'string' && args.trim().startsWith('{')) {\n    try {\n      const parsed = JSON.parse(args) as unknown;\n      if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n        return parsed as Record<string, unknown>;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Reads the model-authored intent from tool-call args (handles stringified\n * args). Returns undefined when absent, empty, or not a string.\n */\nexport function readIntent(args: unknown): string | undefined {\n  const value = coerceArgsObject(args)?.[INTENT_ARG];\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed;\n}\n\n/**\n * Returns the args without the `intent` key so downstream consumers that did\n * not declare it never receive it. Parses stringified JSON object args;\n * returns the value unchanged when the key is absent.\n */\nexport function stripIntent(args: unknown): unknown {\n  const obj = coerceArgsObject(args);\n  if (!obj || !(INTENT_ARG in obj)) {\n    return args;\n  }\n  const { [INTENT_ARG]: _omit, ...rest } = obj;\n  return rest;\n}\n\n/**\n * Resolves the settled label for a call from its model-authored `intent` and\n * the tool's result fields, in precedence order:\n *\n *  1. `outcome` — full replacement authored by the tool.\n *  2. `outcome_patch` — first occurrence of `from` in the intent replaced\n *     with `to` (case-sensitive); no-op when `from` is absent or empty.\n *  3. Otherwise the intent is returned UNCHANGED.\n *\n * There is deliberately no mechanical present-progressive→past-tense rewrite.\n * Such a transform can only be a closed list of English verbs, which makes it\n * wrong in three ways at once: it never fires for the non-English labels this\n * feature expects (the model answers in the user's language), it fires for\n * some sibling calls and not others inside one group — \"Searched…\" beside\n * \"Recording…\" — and it quietly enumerates a vocabulary in a feature whose\n * premise is that the sentence is free-form. Completion is conveyed by UI\n * state (the shimmer stopping, the icon settling), which is language-neutral\n * and always consistent; a tool that wants past tense says so explicitly via\n * `outcome` or `outcome_patch`.\n *\n * Returns undefined when there is neither an intent nor an outcome, so\n * callers fall back to their default label. Pure and dependency-free — host\n * UIs needing identical logic can import or mirror it.\n */\nexport function applyOutcome(\n  intent: string | undefined,\n  result?: { outcome?: string; outcome_patch?: OutcomePatch },\n): string | undefined {\n  const outcome = result?.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return outcome;\n  }\n  if (intent == null || intent === '') {\n    return undefined;\n  }\n  const patch = result?.outcome_patch;\n  if (patch != null && patch.from !== '' && intent.includes(patch.from)) {\n    /** Replacement callback keeps `to` verbatim — a direct string second\n     *  argument would interpret `$&`/`$'`-style tokens in tool-authored\n     *  text (e.g. labels derived from shell syntax). */\n    return intent.replace(patch.from, () => patch.to);\n  }\n  return intent;\n}\n\n/**\n * Hard cap on an emitted outcome label. The label is a single progress line\n * in UI chrome; a tool that derives it from data (or a malformed patch)\n * must not be able to inflate completion events or persisted parts.\n */\nconst MAX_OUTCOME_CHARS = 256;\n\nfunction boundOutcomeLabel(label: string | undefined): string | undefined {\n  if (label == null) {\n    return undefined;\n  }\n  const singleLine = label.replace(/\\s+/g, ' ').trim();\n  if (singleLine === '') {\n    return undefined;\n  }\n  if (singleLine.length <= MAX_OUTCOME_CHARS) {\n    return singleLine;\n  }\n  return `${singleLine.slice(0, MAX_OUTCOME_CHARS - 1)}…`;\n}\n\n/**\n * Resolves the settled label to emit on a completion event: only when the\n * tool actually authored `outcome`/`outcome_patch` fields. Returns undefined\n * otherwise, so the wire never carries a label the host already has — a bare\n * intent needs no settled form, because it is displayed unchanged and the UI\n * conveys completion through its own state. Hosts must NOT rewrite it (see\n * {@link applyOutcome} for why a tense transform is deliberately absent). The\n * result is collapsed to a bounded single line before emission.\n *\n * For failed calls (`isError`), only tool-AUTHORED text may label the call:\n * an explicit `outcome`, or a patch whose `from` actually matches the intent.\n * An unmatched patch resolves to undefined rather than silently reusing the\n * in-flight intent, so a failure is never labelled as though it succeeded.\n */\nexport function resolveToolOutcome(\n  args: unknown,\n  fields?: { outcome?: string; outcome_patch?: OutcomePatch } | null,\n  options?: { isError?: boolean },\n): string | undefined {\n  if (fields == null || (fields.outcome == null && fields.outcome_patch == null)) {\n    return undefined;\n  }\n  if (options?.isError !== true) {\n    return boundOutcomeLabel(applyOutcome(readIntent(args), fields));\n  }\n  const outcome = fields.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return boundOutcomeLabel(outcome);\n  }\n  const intent = readIntent(args);\n  const patch = fields.outcome_patch;\n  if (\n    intent != null &&\n    patch != null &&\n    patch.from !== '' &&\n    intent.includes(patch.from)\n  ) {\n    return boundOutcomeLabel(intent.replace(patch.from, () => patch.to));\n  }\n  return undefined;\n}\n\n/**\n * Reads the outcome fields off a tool-execution result: the typed\n * `outcome`/`outcome_patch` fields when present, else the artifact channel\n * (see {@link readOutcomeFields}) — so a `content_and_artifact` tool authors\n * its label the same way on the direct and event-driven paths.\n */\nexport function outcomeFieldsFromResult(result: {\n  outcome?: string;\n  outcome_patch?: OutcomePatch;\n  artifact?: unknown;\n}): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (result.outcome != null || result.outcome_patch != null) {\n    return result;\n  }\n  return readOutcomeFields(result.artifact);\n}\n\n/**\n * Extracts validated `outcome`/`outcome_patch` fields from an arbitrary\n * value — the artifact channel through which an in-process\n * `content_and_artifact` tool authors its settled label. Returns undefined\n * when neither field is usable.\n */\nexport function readOutcomeFields(\n  source: unknown,\n): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (source == null || typeof source !== 'object' || Array.isArray(source)) {\n    return undefined;\n  }\n  const record = source as Record<string, unknown>;\n  const outcome =\n    typeof record.outcome === 'string' && record.outcome.trim() !== ''\n      ? record.outcome\n      : undefined;\n  let outcome_patch: OutcomePatch | undefined;\n  const rawPatch = record.outcome_patch;\n  if (rawPatch != null && typeof rawPatch === 'object' && !Array.isArray(rawPatch)) {\n    const patch = rawPatch as Record<string, unknown>;\n    if (typeof patch.from === 'string' && typeof patch.to === 'string') {\n      outcome_patch = { from: patch.from, to: patch.to };\n    }\n  }\n  if (outcome == null && outcome_patch == null) {\n    return undefined;\n  }\n  return { outcome, outcome_patch };\n}\n"],"mappings":"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"}

package/dist/esm/tools/search/tool.mjs

@@ -24,12 +24,12 @@ import { tool } from "@langchain/core/tools";
 *
 * A caught provider or processing failure is reported through `data.error`
 * while the tool still returns NORMALLY, so that case must author its own
-* label: the `ToolMessage` carries success status, and a bare intent would
-* otherwise settle mechanically from "Searching…" to "Searched…" and present
-* a failed search as a successful one.
+* label: the `ToolMessage` carries success status, so without an authored
+* outcome the in-flight intent ("Searching…") would stand as the settled
+* label and present a failed search as an ordinary one.
 *
-* Returns undefined for a genuine zero-result search, leaving the host's
-* mechanical past-tense transform to label it.
+* Returns undefined for a genuine zero-result search, leaving the
+* model-authored intent to stand unchanged as the label.
 */
 function resolveSearchOutcome(data, query) {
 	if (data.error != null && data.error !== "") return `Search failed for "${query}"`;