adaptive-cards-mcp

Instructions

Implementation Reference

• packages/core/src/tools/template-card.ts:17-55 (handler)

  The handleTemplateCard function is the primary handler for the 'template_card' tool. It takes a static Adaptive Card or a description, converts it into an Adaptive Card Template, generates sample data, and creates a binding guide.

  export function handleTemplateCard(input: TemplateCardInput): TemplateCardOutput {
    const { card, dataShape, description } = input;
  
    let sourceCard: Record<string, unknown>;
  
    if (card) {
      sourceCard = JSON.parse(JSON.stringify(card));
    } else if (description) {
      // Generate a card from the description, then templatize it
      sourceCard = assembleCard({
        content: description,
        version: "1.6",
      });
    } else {
      throw new Error("Either 'card' or 'description' must be provided");
    }
  
    const expressions: ExpressionEntry[] = [];
    const sampleData: Record<string, unknown> = {};
    const repeatedDataSamples: Record<string, unknown[]> = {};
  
    // Templatize the card
    const template = templatizeNode(sourceCard, "$", expressions, sampleData, repeatedDataSamples, dataShape);
  
    // Merge repeated data samples into sampleData
    for (const [key, samples] of Object.entries(repeatedDataSamples)) {
      sampleData[key] = samples;
    }
  
    // Build binding guide
    const bindingGuide = buildBindingGuide(expressions, sampleData);
  
    return {
      template: template as Record<string, unknown>,
      sampleData,
      expressions,
      bindingGuide,
    };
  }