@open-loyalty/mcp-server 1.3.7 → 1.4.1

package/dist/prompts/fan-engagement-setup.js

@@ -1,492 +0,0 @@
-/**
- * Fan Engagement Setup Prompts
- *
- * MCP prompt templates for guided campaign setup.
- * These define conversational flows and default values for AI agents
- * to help program admins create fan engagement campaigns.
- */
-// ============================================================================
-// Default Values
-// ============================================================================
-export const DEFAULTS = {
-    // Match Attendance
-    matchAttendance: {
-        coinsPerMatch: 50,
-        milestones: [6, 12],
-        milestoneBonuses: { 6: 500, 12: 1000, "80%": 2000 },
-        limitPerDay: 1,
-        badges: { 6: "Silver", 12: "Gold", "80%": "Platinum" },
-    },
-    // Early Arrival
-    earlyArrival: {
-        minutesBefore: 60,
-        coinsPerArrival: 25,
-        limitPerMatch: 1,
-    },
-    // Sports Bar
-    sportsbarVisit: {
-        coinsPerVisit: 50,
-        visitMilestone: 5,
-        milestoneBonus: 500,
-        limitPerDay: 1,
-    },
-    // VOD Watching
-    vodWatching: {
-        trackBy: "minutes",
-        coinsPerUnit: 10,
-        unitSize: 10, // coins per X minutes
-        achievementMinutes: 300,
-        achievementBonus: 200,
-    },
-    // App Login Streak
-    appLoginStreak: {
-        coinsPerLogin: 5,
-        streakDays: 7,
-        streakBonus: 50,
-        limitPerDay: 1,
-    },
-    // General
-    seasonDates: {
-        start: new Date().toISOString().split("T")[0],
-        end: new Date(new Date().setFullYear(new Date().getFullYear() + 1)).toISOString().split("T")[0],
-    },
-};
-// ============================================================================
-// Workflow Definitions
-// ============================================================================
-export const MATCH_ATTENDANCE_WORKFLOW = {
-    id: "match-attendance",
-    name: "Match Attendance Campaign",
-    description: "Reward fans for attending matches with coins and achievements",
-    triggerPhrases: [
-        "set up a campaign to reward fans for attending matches",
-        "create match attendance rewards",
-        "reward match attendance",
-        "attendance campaign",
-        "match attendance",
-    ],
-    questions: [
-        {
-            id: "coinsPerMatch",
-            question: "How many coins should fans receive per match attendance?",
-            type: "number",
-            default: DEFAULTS.matchAttendance.coinsPerMatch,
-            hint: "Common values: 50, 100, 200",
-        },
-        {
-            id: "createAchievements",
-            question: "Set up achievements for attending multiple matches?",
-            type: "boolean",
-            default: true,
-            hint: "Creates milestone achievements (e.g., 6 matches, 12 matches)",
-        },
-        {
-            id: "milestones",
-            question: "What attendance milestones should earn achievements?",
-            type: "string",
-            default: "6,12",
-            hint: "Comma-separated numbers (e.g., '6,12' or '6,12,80%')",
-        },
-        {
-            id: "badgeNames",
-            question: "What badge names for each milestone?",
-            type: "string",
-            default: "Silver,Gold",
-            hint: "Comma-separated names matching milestones (e.g., 'Silver,Gold,Platinum')",
-        },
-        {
-            id: "milestoneBonuses",
-            question: "Bonus coins for each milestone?",
-            type: "string",
-            default: "500,1000",
-            hint: "Comma-separated values matching milestones",
-        },
-        {
-            id: "limitPerDay",
-            question: "Maximum attendances per day (anti-fraud)?",
-            type: "number",
-            default: DEFAULTS.matchAttendance.limitPerDay,
-            hint: "Usually 1 to prevent multiple scans per match",
-        },
-        {
-            id: "seasonStart",
-            question: "Season start date?",
-            type: "string",
-            default: DEFAULTS.seasonDates.start,
-            hint: "ISO format: YYYY-MM-DD",
-        },
-        {
-            id: "seasonEnd",
-            question: "Season end date?",
-            type: "string",
-            default: DEFAULTS.seasonDates.end,
-            hint: "ISO format: YYYY-MM-DD",
-        },
-    ],
-    steps: [
-        {
-            id: "create-base-campaign",
-            action: "Create base match attendance campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign with custom_event trigger for match_attendance event",
-        },
-        {
-            id: "create-achievements",
-            action: "Create milestone achievements",
-            tool: "openloyalty_achievement_create",
-            description: "Creates achievements for each attendance milestone with badges",
-        },
-        {
-            id: "create-achievement-campaigns",
-            action: "Create achievement bonus campaigns",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaigns triggered by achievement completion for bonus coins",
-        },
-        {
-            id: "verify",
-            action: "Verify all campaigns and achievements",
-            tool: "openloyalty_campaign_list",
-            description: "Lists created campaigns to confirm setup",
-        },
-    ],
-};
-export const EARLY_ARRIVAL_WORKFLOW = {
-    id: "early-arrival",
-    name: "Early Arrival Campaign",
-    description: "Reward fans who arrive early to matches",
-    triggerPhrases: [
-        "reward fans who arrive early",
-        "early arrival rewards",
-        "early arrival campaign",
-        "reward early arrival",
-    ],
-    questions: [
-        {
-            id: "minutesBefore",
-            question: "How early (in minutes) counts as 'early arrival'?",
-            type: "number",
-            default: DEFAULTS.earlyArrival.minutesBefore,
-            hint: "Common values: 30, 45, 60 minutes before kickoff",
-        },
-        {
-            id: "coinsPerArrival",
-            question: "How many coins for early arrival?",
-            type: "number",
-            default: DEFAULTS.earlyArrival.coinsPerArrival,
-            hint: "Usually less than match attendance reward",
-        },
-        {
-            id: "limitPerMatch",
-            question: "Limit early arrival bonus per match?",
-            type: "number",
-            default: DEFAULTS.earlyArrival.limitPerMatch,
-            hint: "1 = one bonus per match day",
-        },
-    ],
-    steps: [
-        {
-            id: "create-campaign",
-            action: "Create early arrival campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign with custom_event trigger and minutes_before condition",
-        },
-    ],
-};
-export const SPORTSBAR_VISIT_WORKFLOW = {
-    id: "sportsbar-visit",
-    name: "Sports Bar Visit Campaign",
-    description: "Reward fans for visiting the sports bar",
-    triggerPhrases: [
-        "set up rewards for visiting the sports bar",
-        "sports bar visit rewards",
-        "sportsbar visit campaign",
-        "reward bar visits",
-    ],
-    questions: [
-        {
-            id: "coinsPerVisit",
-            question: "How many coins per sports bar visit?",
-            type: "number",
-            default: DEFAULTS.sportsbarVisit.coinsPerVisit,
-            hint: "Common values: 25, 50, 100",
-        },
-        {
-            id: "createAchievement",
-            question: "Set up achievement for multiple visits?",
-            type: "boolean",
-            default: true,
-            hint: "Creates milestone achievement for visiting X times",
-        },
-        {
-            id: "visitMilestone",
-            question: "How many visits for the achievement?",
-            type: "number",
-            default: DEFAULTS.sportsbarVisit.visitMilestone,
-            hint: "Common values: 5, 10, 20",
-        },
-        {
-            id: "milestoneBonus",
-            question: "Bonus coins for completing the achievement?",
-            type: "number",
-            default: DEFAULTS.sportsbarVisit.milestoneBonus,
-            hint: "Bonus awarded when milestone is reached",
-        },
-        {
-            id: "limitPerDay",
-            question: "Maximum visits counted per day?",
-            type: "number",
-            default: DEFAULTS.sportsbarVisit.limitPerDay,
-            hint: "Prevents abuse from multiple scans",
-        },
-    ],
-    steps: [
-        {
-            id: "create-visit-campaign",
-            action: "Create visit campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign with custom_event trigger for sportsbar_visit",
-        },
-        {
-            id: "create-achievement",
-            action: "Create visit milestone achievement",
-            tool: "openloyalty_achievement_create",
-            description: "Creates achievement for visiting X times",
-        },
-        {
-            id: "create-achievement-campaign",
-            action: "Create achievement bonus campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign triggered by achievement completion",
-        },
-    ],
-};
-export const VOD_WATCHING_WORKFLOW = {
-    id: "vod-watching",
-    name: "VOD Watching Campaign",
-    description: "Reward fans for watching video content",
-    triggerPhrases: [
-        "reward fans for watching video content",
-        "vod watching rewards",
-        "video content rewards",
-        "reward watching videos",
-    ],
-    questions: [
-        {
-            id: "trackBy",
-            question: "Track by views or minutes watched?",
-            type: "select",
-            options: ["views", "minutes"],
-            default: DEFAULTS.vodWatching.trackBy,
-            hint: "Minutes watched is more engagement-focused",
-        },
-        {
-            id: "coinsPerUnit",
-            question: "How many coins per unit (view or X minutes)?",
-            type: "number",
-            default: DEFAULTS.vodWatching.coinsPerUnit,
-            hint: "For minutes: coins per unitSize minutes",
-        },
-        {
-            id: "unitSize",
-            question: "If tracking minutes, how many minutes per reward?",
-            type: "number",
-            default: DEFAULTS.vodWatching.unitSize,
-            hint: "e.g., 10 = earn coins every 10 minutes watched",
-        },
-        {
-            id: "createAchievement",
-            question: "Set up achievement for total minutes/views?",
-            type: "boolean",
-            default: true,
-            hint: "Creates milestone achievement for watching X total",
-        },
-        {
-            id: "achievementTarget",
-            question: "Target for achievement (minutes or views)?",
-            type: "number",
-            default: DEFAULTS.vodWatching.achievementMinutes,
-            hint: "Total minutes or views to earn achievement",
-        },
-        {
-            id: "achievementBonus",
-            question: "Bonus coins for completing the achievement?",
-            type: "number",
-            default: DEFAULTS.vodWatching.achievementBonus,
-            hint: "Bonus awarded when target is reached",
-        },
-    ],
-    steps: [
-        {
-            id: "create-watch-campaign",
-            action: "Create VOD watching campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign with custom_event trigger for vod_watch",
-        },
-        {
-            id: "create-achievement",
-            action: "Create watching achievement",
-            tool: "openloyalty_achievement_create",
-            description: "Creates achievement tracking total minutes/views with attribute sum",
-        },
-        {
-            id: "create-achievement-campaign",
-            action: "Create achievement bonus campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign triggered by achievement completion",
-        },
-    ],
-};
-export const APP_LOGIN_STREAK_WORKFLOW = {
-    id: "app-login-streak",
-    name: "App Login Streak Campaign",
-    description: "Reward fans for daily login streaks",
-    triggerPhrases: [
-        "set up daily login rewards",
-        "daily login streak",
-        "app login rewards",
-        "login streak campaign",
-    ],
-    questions: [
-        {
-            id: "coinsPerLogin",
-            question: "How many coins per daily login?",
-            type: "number",
-            default: DEFAULTS.appLoginStreak.coinsPerLogin,
-            hint: "Usually a small amount (5-20)",
-        },
-        {
-            id: "createStreakBonus",
-            question: "Set up streak bonus?",
-            type: "boolean",
-            default: true,
-            hint: "Extra reward for consecutive daily logins",
-        },
-        {
-            id: "streakDays",
-            question: "How many consecutive days for streak bonus?",
-            type: "number",
-            default: DEFAULTS.appLoginStreak.streakDays,
-            hint: "Common values: 7, 14, 30 days",
-        },
-        {
-            id: "streakBonus",
-            question: "Bonus coins for completing the streak?",
-            type: "number",
-            default: DEFAULTS.appLoginStreak.streakBonus,
-            hint: "Bonus awarded when streak is achieved",
-        },
-    ],
-    steps: [
-        {
-            id: "create-login-campaign",
-            action: "Create daily login campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign with custom_event trigger for app_login, limited to 1/day",
-        },
-        {
-            id: "create-streak-achievement",
-            action: "Create login streak achievement",
-            tool: "openloyalty_achievement_create",
-            description: "Creates achievement for X consecutive daily logins",
-        },
-        {
-            id: "create-streak-campaign",
-            action: "Create streak bonus campaign",
-            tool: "openloyalty_campaign_create",
-            description: "Creates campaign triggered by streak achievement completion",
-        },
-    ],
-};
-// ============================================================================
-// All Workflows
-// ============================================================================
-export const ALL_WORKFLOWS = [
-    MATCH_ATTENDANCE_WORKFLOW,
-    EARLY_ARRIVAL_WORKFLOW,
-    SPORTSBAR_VISIT_WORKFLOW,
-    VOD_WATCHING_WORKFLOW,
-    APP_LOGIN_STREAK_WORKFLOW,
-];
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Find matching workflow based on user input
- */
-export function findMatchingWorkflow(userInput) {
-    const input = userInput.toLowerCase();
-    return ALL_WORKFLOWS.find((workflow) => workflow.triggerPhrases.some((phrase) => input.includes(phrase.toLowerCase())));
-}
-/**
- * Get workflow by ID
- */
-export function getWorkflowById(id) {
-    return ALL_WORKFLOWS.find((workflow) => workflow.id === id);
-}
-/**
- * Parse comma-separated values to array
- */
-export function parseCommaSeparated(value) {
-    return value.split(",").map((v) => v.trim()).filter(Boolean);
-}
-/**
- * Parse milestones (handles both numbers and percentages like "80%")
- */
-export function parseMilestones(value) {
-    return parseCommaSeparated(value).map((v) => {
-        if (v.includes("%"))
-            return v;
-        const num = parseInt(v, 10);
-        return isNaN(num) ? v : num;
-    });
-}
-/**
- * Format ISO date for Open Loyalty (YYYY-MM-DD HH:mm+TZ)
- */
-export function formatOLDate(date) {
-    const d = typeof date === "string" ? new Date(date) : date;
-    const pad = (n) => n.toString().padStart(2, "0");
-    const offset = -d.getTimezoneOffset();
-    const offsetHours = Math.floor(Math.abs(offset) / 60);
-    const offsetSign = offset >= 0 ? "+" : "-";
-    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} 00:00${offsetSign}${pad(offsetHours)}:00`;
-}
-// ============================================================================
-// Prompt Templates for AI Agents
-// ============================================================================
-export const AGENT_PROMPTS = {
-    /**
-     * System prompt for fan engagement setup
-     */
-    systemPrompt: `You are helping a program admin set up fan engagement campaigns in Open Loyalty.
-For each campaign type, guide the user through the setup questions step by step.
-Use the default values when the user doesn't have a preference.
-After collecting all information, execute the workflow to create the campaigns and achievements.
-
-Available campaign types:
-1. Match Attendance - Reward fans for attending matches with coins and milestone achievements
-2. Early Arrival - Bonus for arriving early to matches
-3. Sports Bar Visits - Reward visits to the sports bar
-4. VOD Watching - Reward watching video content
-5. App Login Streak - Daily login rewards with streak bonuses
-
-When creating campaigns:
-- Always use custom_event trigger for fan engagement events
-- Custom events are defined inline (no separate create step needed)
-- Use achievement trigger for bonus campaigns on milestones
-- Set appropriate execution limits to prevent abuse
-- Create achievements with badges for milestone rewards`,
-    /**
-     * Workflow completion template
-     */
-    completionTemplate: (results) => `Your fan engagement program is now set up!
-
-Created campaigns:
-${results.campaignIds.map((id) => `- Campaign ID: ${id}`).join("\n")}
-
-Created achievements:
-${results.achievementIds.map((id) => `- Achievement ID: ${id}`).join("\n")}
-
-Summary:
-${results.summary}`,
-};