Function getDeferredToolsDeltaAttachment

src/utils/attachments.ts:1509–1528

(
  tools: Tools,
  model: string,
  messages: Message[] | undefined,
  scanContext?: DeferredToolsDeltaScanContext,
)

// Exported for compact.ts — the gate must be identical at both call sites.
export function getDeferredToolsDeltaAttachment(
  tools: Tools,
  model: string,
  messages: Message[] | undefined,
  scanContext?: DeferredToolsDeltaScanContext,
): Attachment[] {
  if (!isDeferredToolsDeltaEnabled()) return []
  // These three checks mirror the sync parts of isSearchExtraToolsEnabled —
  // the attachment text says "available via SearchExtraTools", so SearchExtraTools
  // has to actually be in the request. The async auto-threshold check
  // is not replicated (would double-fire tengu_search_extra_tools_mode_decision);
  // in tst-auto below-threshold the attachment can fire while SearchExtraTools
  // is filtered out, but that's a narrow case and the tools announced
  // are directly callable anyway.
  if (!isSearchExtraToolsEnabledOptimistic()) return []
  if (!isSearchExtraToolsToolAvailable(tools)) return []
  const delta = getDeferredToolsDelta(tools, messages ?? [], scanContext)
  if (!delta) return []
  return [{ type: 'deferred_tools_delta', ...delta }]
}

/**
 * Diff the current filtered agent pool against what's already been announced