Function normalizeAttachmentForAPI

src/utils/messages.ts:3841–4723

(
  attachment: Attachment,
)

}

export function normalizeAttachmentForAPI(
  attachment: Attachment,
): UserMessage[] {
  if (isAgentSwarmsEnabled()) {
    if (attachment.type === 'teammate_mailbox') {
      return [
        createUserMessage({
          content: getTeammateMailbox().formatTeammateMessages(
            attachment.messages,
          ),
          isMeta: true,
        }),
      ]
    }
    if (attachment.type === 'team_context') {
      return [
        createUserMessage({
          content: `<system-reminder>
# Team Coordination

You are a teammate in team "${attachment.teamName}".

**Your Identity:**
- Name: ${attachment.agentName}

**Team Resources:**
- Team config: ${attachment.teamConfigPath}
- Task list: ${attachment.taskListPath}

**Team Leader:** The team lead's name is "team-lead". Send updates and completion notifications to them.

Read the team config to discover your teammates' names. Check the task list periodically. Create new tasks when work should be divided. Mark tasks resolved when complete.

**IMPORTANT:** Always refer to teammates by their NAME (e.g., "team-lead", "analyzer", "researcher"), never by UUID. When messaging, use the name directly:

\`\`\`json
{
  "to": "team-lead",
  "message": "Your message here",
  "summary": "Brief 5-10 word preview"
}
\`\`\`
</system-reminder>`,
          isMeta: true,
        }),
      ]
    }
  }

  // skill_discovery handled here (not in the switch) so the 'skill_discovery'
  // string literal lives inside a feature()-guarded block. A case label can't
  // be gated, but this pattern can — same approach as teammate_mailbox above.
  if (feature('EXPERIMENTAL_SKILL_SEARCH')) {
    if (attachment.type === 'skill_discovery') {
      if (attachment.skills.length === 0 && !attachment.gap) return []
      const loaded = attachment.skills.filter(s => s.autoLoaded && s.content)
      const recommended = attachment.skills.filter(s => !s.autoLoaded)
      const loadedSections = loaded.map(