Brand Agent → Creative → Sales Agent
    ↓           ↓           ↓
 Advertiser   Ad Asset   Publisher

// Creative formats are matched to sales agent capabilities
creative = { format: "video/mp4" };
salesAgent = { supportedFormats: ["video/mp4", "video/webm"] };
// ✅ Match - sync will proceed

creative = { format: "video/mp4" };
salesAgent = { supportedFormats: ["image/jpeg", "image/png"] };
// ❌ No match - sync will be skipped

// Update creative content
await creativeUpdateTool.execute({
  creativeId: "creative_123",
  updates: {
    content: {
      htmlSnippet: "<div>Updated creative</div>",
      vastTag: "https://example.com/new-vast.xml",
    },
  },
});

// Automatic flow:
// 1. Creative updated successfully
// 2. System identifies previously synced sales agents
// 3. Background re-sync triggered to those agents
// 4. Notifications sent if any re-sync failures occur

// Assign creative to campaign
await creativeAssignTool.execute({
  creativeId: "creative_123",
  campaignId: "campaign_456",
  buyerAgentId: "ba_789",
});

// Automatic flow:
// 1. Creative assigned to campaign
// 2. System gets campaign's active tactics
// 3. Extracts sales agents from those tactics
// 4. Triggers sync to format-compatible agents
// 5. User receives confirmation of assignment + sync status

// Create new tactic
await createTacticTool.execute({
  name: "Mobile Video Tactic",
  campaignId: "campaign_456",
  mediaProductId: "mobile_video_product",
  // ... other tactic config
});

// Automatic flow:
// 1. Tactic created with sales agent (from media product)
// 2. System finds campaign's existing creatives
// 3. Filters for format-compatible creatives
// 4. Syncs compatible creatives to new sales agent
// 5. Tactic ready for activation with pre-approved creatives

// Auto-detection (default behavior)
await creativeSyncSalesAgentsTool.execute({
  creativeId: "creative_123",
  // No explicit agents - system auto-detects based on:
  // - Recent 30-day tactic activity for this brand agent
  // - Creative format compatibility
  // - Active campaign sales agents
});

// Manual override
await creativeSyncSalesAgentsTool.execute({
  creativeId: "creative_123",
  salesAgentIds: ["agent_1", "agent_2", "agent_3"],
});

// Campaign-specific sync
await creativeSyncSalesAgentsTool.execute({
  creativeId: "creative_123",
  campaignId: "campaign_456",
  // Only syncs to sales agents used by this campaign
});

// campaign/list response includes health indicators
campaigns = [
  {
    id: "campaign_123",
    name: "Summer Campaign",
    syncHealth: {
      status: "healthy", // healthy | warning | critical
      syncedTactics: 8,
      totalTactics: 8,
      approvedCreatives: 12,
      totalCreatives: 15,
      lastSyncIssue: null,
    },
    notifications: {
      unread: 0,
      highPriority: 0,
    },
  },
  {
    id: "campaign_456",
    name: "Holiday Campaign",
    syncHealth: {
      status: "warning",
      syncedTactics: 3,
      totalTactics: 5,
      approvedCreatives: 8,
      totalCreatives: 12,
      lastSyncIssue: "2 tactics have creative sync failures",
    },
    notifications: {
      unread: 3,
      highPriority: 1,
    },
  },
];

// creative/get response includes sync summary
creative = {
  id: "creative_123",
  name: "Video Creative",
  syncStatusSummary: {
    totalRelevantAgents: 8,
    approved: 6,
    pending: 1,
    rejected: 1,
    lastSyncDate: "2024-01-15T14:30:00Z",
  },
  syncDetails: [
    {
      salesAgentId: "video_agent_1",
      salesAgentName: "Premium Video",
      status: "synced",
      approvalStatus: "approved",
      syncDate: "2024-01-15T14:30:00Z",
    },
    {
      salesAgentId: "video_agent_2",
      salesAgentName: "Mobile Video",
      status: "synced",
      approvalStatus: "rejected",
      rejectionReason: "Creative resolution too low for mobile",
      syncDate: "2024-01-15T14:30:00Z",
    },
  ],
};

// Creative content update → Re-sync → Notifications
{
  type: "creative.sync_started",
  data: {
    message: "Re-syncing updated creative to 5 sales agents",
    creativeId: "creative_123",
    actionRequired: "Monitor for approval updates"
  }
}

// Sync failure → Actionable notification
{
  type: "creative.sync_failed",
  data: {
    message: "Creative sync failed: format not supported",
    creativeId: "creative_123",
    salesAgentId: "display_agent_456",
    rejectionReason: "Video format not supported by display agent",
    actionRequired: "Update creative format or exclude this agent"
  }
}

// Campaign health issue → High-priority notification
{
  type: "campaign.creative_sync_unhealthy",
  data: {
    message: "Campaign has 3 tactics with sync failures",
    campaignId: "campaign_456",
    actionRequired: "Review sync failures before campaign launch",
    urgency: "high"
  }
}

// Monitor for high-priority campaign issues
const urgentIssues = await getNotifications({
  types: ["campaign.creative_sync_unhealthy", "campaign.missing_creatives"],
  urgency: "high",
  acknowledged: false,
});

// Handle creative sync failures systematically
const syncFailures = await getNotifications({
  type: "creative.sync_failed",
  unreadOnly: true,
});

// Batch process by failure type
const formatIssues = syncFailures.filter((n) =>
  n.data.rejectionReason?.includes("format"),
);
const resolutionIssues = syncFailures.filter((n) =>
  n.data.rejectionReason?.includes("resolution"),
);