Function buildMessageTurnsWithMetadata

server/src/addie/prompts.ts:588–711

(
  userMessage: string,
  threadContext?: ThreadContextEntry[],
  options?: BuildMessageTurnsOptions
)

 * Use this when you need visibility into whether conversation was trimmed.
 */
export function buildMessageTurnsWithMetadata(
  userMessage: string,
  threadContext?: ThreadContextEntry[],
  options?: BuildMessageTurnsOptions
): BuildMessageTurnsResult {
  const maxMessages = options?.maxMessages ?? 50;
  // Pass toolCount for more accurate token budget when available
  const tokenLimit = options?.tokenLimit ?? getConversationTokenLimit(options?.model, options?.toolCount);

  let messages: MessageTurn[] = [];

  // Detect whether the thread has multiple distinct human speakers. When it
  // does, prefix every user-role turn with the speaker's name so the model
  // can tell when the speaker switches mid-thread (e.g. an admin replying to
  // a non-member's question). 'User' is the unknown-speaker sentinel and is
  // not counted. Names are re-sanitized here as defense in depth — callers
  // are expected to sanitize at ingest, but stored rows or hand-built
  // entries shouldn't be able to break out of the `[name] text` envelope.
  const sanitizedCurrent = sanitizeSpeakerName(options?.currentSpeakerName);
  const distinctSpeakers = new Set<string>();
  if (threadContext) {
    for (const e of threadContext) {
      if (e.user && e.user !== 'Addie' && e.user !== 'User') {
        const clean = sanitizeSpeakerName(e.user);
        if (clean) distinctSpeakers.add(clean);
      }
    }
  }
  if (sanitizedCurrent) distinctSpeakers.add(sanitizedCurrent);
  const isMultiSpeaker = distinctSpeakers.size > 1;

  if (threadContext && threadContext.length > 0) {
    // First pass: apply message count limit if specified
    let recentHistory = maxMessages > 0
      ? threadContext.slice(-maxMessages)
      : threadContext;

    // Convert each entry to proper message turn
    // Skip empty messages defensively
    for (const entry of recentHistory) {
      const trimmedText = entry.text?.trim();
      if (!trimmedText) continue;
      const role: 'user' | 'assistant' = entry.user === 'Addie' ? 'assistant' : 'user';
      const cleanSpeaker = role === 'user' && entry.user !== 'User'
        ? sanitizeSpeakerName(entry.user)
        : undefined;
      // Skip the prefix when content already starts with `[` to avoid
      // double-bracketed turns like `[Brian] [User reacted with ...]`.
      const content = (isMultiSpeaker && role === 'user' && cleanSpeaker && !trimmedText.startsWith('['))
        ? `[${cleanSpeaker}] ${trimmedText}`
        : trimmedText;
      // Pass through tool calls so claude-client can reconstruct proper API blocks
      const toolCalls = (role === 'assistant' && entry.toolCalls && entry.toolCalls.length > 0)
        ? entry.toolCalls.map(tc => ({
          name: tc.name,
          input: tc.input,
          result: typeof tc.result === 'string' ? tc.result : tc.result != null ? JSON.stringify(tc.result) : '',
          is_error: tc.is_error,