Function handleBuildCreative

server/src/training-agent/task-handlers.ts:3118–3242

(args: ToolArgs, ctx: TrainingContext)

}

export async function handleBuildCreative(args: ToolArgs, ctx: TrainingContext): Promise<BuildCreativeResponse & { pricing_option_id?: string; vendor_cost?: number; currency?: string; consumption?: Record<string, unknown>; governance_context?: string }> {
  const req = args as unknown as BuildCreativeArgs;
  const session = await getSession(sessionKeyFromArgs(req as unknown as ToolArgs, ctx.mode, ctx.userId, ctx.moduleId));
  const agentUrl = getAgentUrl();
  const formats = getFormats();
  const rawGovCtx = (req as unknown as Record<string, unknown>).governance_context;
  const governanceContext = typeof rawGovCtx === 'string' && rawGovCtx.length <= 4096 ? rawGovCtx : undefined;
  const validFormatIds = new Map(formats.map(f => [f.format_id.id, f]));

  // Determine target formats (cap at 50 to prevent response amplification)
  const MAX_TARGET_FORMATS = 50;
  const targetIds: FormatID[] = req.target_format_ids?.length
    ? req.target_format_ids.slice(0, MAX_TARGET_FORMATS)
    : req.target_format_id
      ? [req.target_format_id]
      : [];

  // Mode 1: Library retrieval (creative_id)
  if (req.creative_id) {
    const creative = session.creatives.get(req.creative_id) ?? getComplianceCreative(req.creative_id);
    if (!creative) {
      return {
        errors: [{ code: 'NOT_FOUND', message: `Creative "${req.creative_id}" not found. Use sync_creatives to upload or list_creatives to browse.` }],
      };
    }

    const formatId = targetIds[0] || creative.formatId;
    const format = validFormatIds.get(formatId.id);
    const { w, h } = getDimensions(format);

    const base = {
      creative_manifest: {
        format_id: { agent_url: agentUrl, id: formatId.id },
        assets: buildHtmlAssets(`<!-- AdCP Training Agent tag for ${escapeHtmlAttr(req.creative_id!)} -->\n<div data-adcp-creative="${escapeHtmlAttr(req.creative_id!)}" data-format="${escapeHtmlAttr(formatId.id)}"${req.media_buy_id ? ` data-media-buy="${escapeHtmlAttr(req.media_buy_id)}"` : ''}${req.package_id ? ` data-package="${escapeHtmlAttr(req.package_id)}"` : ''} style="width:${w}px;height:${h}px;background:#f0f0f0;display:flex;align-items:center;justify-content:center;font-family:sans-serif;font-size:14px;color:#666;">Ad: ${escapeHtmlAttr(creative.name || req.creative_id!)}</div>`),
      },
      };

    // Return pricing when account is provided (paid creative agent mode)
    if (req.account) {
      const pricing = getCreativePricing(req.account, creative);
      creative.pricingOptionId = pricing.pricing_option_id;
      return {
        ...base,
        pricing_option_id: pricing.pricing_option_id,
        vendor_cost: 0, // CPM-priced: cost accrues at serve time
        currency: pricing.currency,
        consumption: {},
        ...(governanceContext && { governance_context: governanceContext }),
      };
    }

    return { ...base, ...(governanceContext && { governance_context: governanceContext }) };
  }

  // Mode 2: Stateless transformation (creative_manifest + target_format_id)
  if (req.creative_manifest) {
    const rawAssets = req.creative_manifest.assets;
    const inputAssetCount = Array.isArray(rawAssets) ? rawAssets.length : Object.keys(rawAssets || {}).length;