@open-loyalty/mcp-server 1.3.6 → 1.4.1

package/dist/tools/tierset.js

@@ -42,14 +42,14 @@ export const TierSetUpdateTiersInputSchema = {
     tierSetId: z.string().describe("The tier set ID to update tiers for."),
     tiers: z.array(z.object({
         levelId: z.string().optional().describe("Existing level ID (for updates). Omit for new tiers."),
-        name: z.string().describe("Name of the tier (e.g., Bronze, Silver, Gold)."),
-        description: z.string().optional().describe("Description of the tier."),
+        name: z.string().describe("Tier name as a TOP-LEVEL string (e.g., 'Bronze'). NOT in translations wrapper."),
+        description: z.string().optional().describe("Tier description as a TOP-LEVEL string. NOT in translations wrapper."),
         active: z.boolean().optional().describe("Whether the tier is active. Defaults to true."),
         conditions: z.array(z.object({
             conditionId: z.string().describe("Condition ID from tierset_get response."),
             value: z.number().describe("Threshold value for this condition (e.g., 400 points for Bronze)."),
         })).describe("Array of condition thresholds. Each uses conditionId from tierset_get."),
-    })).describe("Array of tier definitions."),
+    })).describe("Array of tier definitions. Each tier needs 'name' as a direct string field, NOT wrapped in translations."),
 };
 export const TierSetGetTiersInputSchema = {
     storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
@@ -90,14 +90,30 @@ export async function tiersetCreate(input) {
     // REQUIRED fields:
     // - translations.en.name (string)
     // - conditions (array with attribute, optionally walletType)
+    //
+    // IMPORTANT: Only include description if actually provided - API rejects empty string as "extra field"
+    const enTranslation = {
+        name: input.name,
+    };
+    if (input.description) {
+        enTranslation.description = input.description;
+    }
+    // Explicitly map conditions to only include known fields (attribute + walletType)
+    // This strips any extra fields that might slip through Zod validation
+    const mappedConditions = input.conditions.map((c) => {
+        const condition = {
+            attribute: c.attribute,
+        };
+        if (c.walletType) {
+            condition.walletType = c.walletType;
+        }
+        return condition;
+    });
     const tierSetPayload = {
         translations: {
-            en: {
-                name: input.name,
-                description: input.description || "",
-            },
+            en: enTranslation,
         },
-        conditions: input.conditions,
+        conditions: mappedConditions,
     };
     const payload = { tierSet: tierSetPayload };
     try {
@@ -220,8 +236,8 @@ export const tiersetToolDefinitions = [
     {
         name: "ol_tierset_list",
         title: "List Loyalty Programs",
-        description: "List all tier sets. RECOMMENDED: Check if tier set already exists before creating a new one. " +
-            "If exists, use tierset_get to fetch conditionId needed for defining tiers via tierset_update_tiers. " +
+        description: "List all tier sets. A tier set is a CONTAINER that holds MULTIPLE tiers (e.g., Bronze/Silver/Gold). " +
+            "⚠️ ALWAYS check existing tier sets FIRST before creating - reuse if one exists. " +
             "Returns tierSetId, name, active status, and tier count for each tier set.",
         readOnly: true,
         inputSchema: TierSetListInputSchema,
@@ -230,13 +246,13 @@ export const tiersetToolDefinitions = [
     {
         name: "ol_tierset_create",
         title: "Create Loyalty Program",
-        description: "Create a new tier set (loyalty program structure). " +
-            "⚠️ LIMIT: Maximum 3 ACTIVE tier sets per store. ALWAYS call tierset_list FIRST to check existing tier sets - if one exists that matches your needs, REUSE IT instead of creating a new one. " +
-            "WORKFLOW: 1) tierset_list (check existing) → 2) tierset_create (only if needed) → 3) tierset_get (to get conditionId) → 4) tierset_update_tiers (to define thresholds). " +
+        description: "Create ONE tier set that will contain ALL your tiers (e.g., Bronze/Silver/Gold/Platinum). " +
+            "⚠️ CRITICAL: Create exactly ONE tier set, then add ALL tiers to it via tierset_update_tiers. " +
+            "DO NOT create multiple tier sets for different tiers - all tiers belong in ONE tier set! " +
+            "⚠️ LIMIT: Maximum 3 ACTIVE tier sets per store. ALWAYS call tierset_list FIRST to check existing tier sets. " +
+            "WORKFLOW: 1) tierset_list → 2) tierset_create (ONE tier set) → 3) tierset_get (get conditionId) → 4) tierset_update_tiers (add ALL tiers in one call). " +
             "⚠️ API LIMITATION: Only 'name', 'description', and 'conditions' are accepted at creation time. " +
-            "Fields like 'active', 'downgrade', 'tiers' are NOT supported at creation - use tierset_update after creation to set these. " +
-            "Valid condition attributes: 'totalEarnedUnits' (lifetime points), 'activeUnits' (current balance), 'totalSpending', 'monthsSinceJoiningProgram'. " +
-            "COMMON MISTAKE: Use 'totalEarnedUnits' NOT 'earnedUnits' for lifetime points. " +
+            "Valid condition attributes: 'totalEarnedUnits' (lifetime points), 'activeUnits' (current balance), 'totalSpending'. " +
             "For unit-based attributes, set walletType to 'default'.",
         readOnly: false,
         inputSchema: TierSetCreateInputSchema,
@@ -246,9 +262,8 @@ export const tiersetToolDefinitions = [
         name: "ol_tierset_get",
         title: "Get Loyalty Program Details",
         description: "Get tier set details including conditionId values needed for tierset_update_tiers. " +
-            "CRITICAL: After tierset_create, you MUST call this to get the conditionId from the conditions array. " +
-            "The conditionId is then used in tierset_update_tiers to set tier thresholds. " +
-            "Response includes conditions[].id (this is the conditionId) and conditions[].attribute.",
+            "CRITICAL: After tierset_create, call this to get the conditionId from conditions[].id. " +
+            "Use this SAME conditionId for ALL tiers when calling tierset_update_tiers.",
         readOnly: true,
         inputSchema: TierSetGetInputSchema,
         handler: tiersetGet,
@@ -266,14 +281,23 @@ export const tiersetToolDefinitions = [
     {
         name: "ol_tierset_update_tiers",
         title: "Configure Tier Thresholds",
-        description: `Define tier thresholds for a tier set. PREREQUISITE: Call tierset_get first to obtain conditionId values. Each tier's conditions array uses conditionId from the parent tier set plus a threshold value.
+        description: `Add ALL tiers to a tier set in ONE call. A tier set is a CONTAINER - add all tiers (Bronze, Silver, Gold, etc.) to it together.
+
+⚠️ CRITICAL: Pass ALL tiers in a SINGLE call to this endpoint. DO NOT call this multiple times with one tier each.
+
+⚠️ INPUT FORMAT: Pass 'name' and 'description' as TOP-LEVEL fields on each tier object.
+❌ WRONG: { translations: { en: { name: "Bronze" } } }
+✅ CORRECT: { name: "Bronze", description: "Entry tier" }
 
-Example for a 3-tier program with points-based progression:
-- Bronze tier: conditions: [{ conditionId: "xxx", value: 400 }]
-- Silver tier: conditions: [{ conditionId: "xxx", value: 800 }]
-- Gold tier: conditions: [{ conditionId: "xxx", value: 1200 }]
+Example - Creating 4 tiers in ONE call:
+tiers: [
+  { name: "Bronze", description: "Entry tier", conditions: [{ conditionId: "xxx", value: 0 }] },
+  { name: "Silver", description: "500+ points", conditions: [{ conditionId: "xxx", value: 500 }] },
+  { name: "Gold", description: "1000+ points", conditions: [{ conditionId: "xxx", value: 1000 }] },
+  { name: "Platinum", description: "Top tier", conditions: [{ conditionId: "xxx", value: 2000 }] }
+]
 
-The conditionId must match one from tierset_get response.`,
+The conditionId must match the one from tierset_get response - use the SAME conditionId for all tiers.`,
         readOnly: false,
         inputSchema: TierSetUpdateTiersInputSchema,
         handler: tiersetUpdateTiers,

package/dist/tools/transaction.js

@@ -10,14 +10,14 @@ const LabelInputSchema = z.object({
 });
 const TransactionHeaderInputSchema = z.object({
     documentNumber: z.string().describe("Unique document number (required, unique per store)."),
-    purchasedAt: z.string().describe("Purchase date/time in ISO format (required)."),
+    purchasedAt: z.string().describe("Purchase date/time in ISO format (required). Use 'purchasedAt' NOT 'purchaseDate'. Example: '2026-01-15T10:00:00Z'."),
     documentType: z.enum(["sell", "return"]).optional().describe("Document type: sell (default) or return."),
     linkedDocumentNumber: z.string().optional().describe("Original document number (required for returns)."),
     purchasePlace: z.string().optional().describe("Location/store where purchase was made."),
     labels: z.array(LabelInputSchema).optional().describe("Custom key-value labels."),
 });
 const TransactionItemInputSchema = z.object({
-    sku: z.string().describe("Product SKU (required, max 255 chars)."),
+    sku: z.string().describe("Product SKU as a STRING (required). Use 'sku: \"PROD-123\"' NOT 'sku: { code: \"...\" }'."),
     name: z.string().describe("Product name (required, max 255 chars)."),
     grossValue: z.number().describe("Item gross value (required)."),
     category: z.string().describe("Product category (required, max 255 chars)."),
@@ -219,6 +219,9 @@ export const transactionToolDefinitions = [
         title: "Record Purchase",
         description: "Record a purchase transaction. If customerData provided, auto-matches to member and triggers point campaigns. " +
             "For returns, set documentType='return' and provide linkedDocumentNumber referencing original sale. " +
+            "⚠️ FIELD NAMES - use exactly these: " +
+            "header.purchasedAt (NOT purchaseDate), items[].sku as STRING (NOT object). " +
+            "Example: { header: { documentNumber: 'INV-001', purchasedAt: '2026-01-15T10:00:00Z' }, items: [{ sku: 'PROD-123', name: 'Product', grossValue: 50, category: 'Sales' }] }. " +
             "Returns transactionId and pointsEarned if campaigns triggered.",
         readOnly: false,
         inputSchema: TransactionCreateInputSchema,

package/dist/tools/wallet-type.js

@@ -138,11 +138,18 @@ export async function walletTypeCreate(input) {
         // Check for duplicate code error
         const errorMsg = getErrorMessage(error);
         if (errorMsg.toLowerCase().includes("code") && errorMsg.toLowerCase().includes("already")) {
+            const isDefaultCode = input.code === "default" || !input.code;
             throw new OpenLoyaltyError({
                 code: "DUPLICATE_CODE",
-                message: `Wallet type with code '${input.code}' already exists`,
-                hint: `Use a different code value, or use ol_wallet_type_list() to find existing wallet types. ` +
-                    `Each wallet type must have a unique code.`,
+                message: `Wallet type with code '${input.code || "default"}' already exists`,
+                hint: isDefaultCode
+                    ? `Every store comes with a 'Default wallet' (code: 'default') pre-installed. ` +
+                        `You do NOT need to create it. Use ol_wallet_type_list() to find it, then ` +
+                        `ol_wallet_type_update() to customize its name, units, or expiry settings. ` +
+                        `Only create a new wallet if you need a SECOND point currency with a different code.`
+                    : `A wallet type with code '${input.code}' already exists. ` +
+                        `Use ol_wallet_type_list() to see all existing wallet types. ` +
+                        `Either use a different code, or find the existing wallet and update it with ol_wallet_type_update().`,
                 relatedTool: "ol_wallet_type_create",
             });
         }
@@ -231,9 +238,9 @@ export const walletTypeToolDefinitions = [
         name: "ol_wallet_type_list",
         title: "List Point Currencies",
         description: "List all available wallet types (point currencies). " +
-            "Use this to find wallet type codes and IDs for other operations. " +
-            "Returns walletTypeId (UUID), code (unique identifier like 'default'), and name for each wallet type. " +
-            "💡 TIP: Most stores have a 'default' wallet type for main loyalty points.",
+            "ALWAYS call this BEFORE creating a new wallet type - every store already has a 'Default wallet' " +
+            "(code: 'default', units: points) pre-installed. " +
+            "Returns walletTypeId (UUID), code (unique identifier like 'default'), and name for each wallet type.",
         readOnly: true,
         inputSchema: WalletTypeListInputSchema,
         handler: walletTypeList,
@@ -252,20 +259,23 @@ export const walletTypeToolDefinitions = [
         name: "ol_wallet_type_create",
         title: "Create Point Currency",
         description: "Create a new wallet type (point currency) for the loyalty program. " +
-            "⚠️ REQUIRED FIELDS (will fail without these): " +
+            "IMPORTANT: Every store already has a 'Default wallet' (code: 'default', units: points) out of the box. " +
+            "ALWAYS call ol_wallet_type_list() FIRST to check what wallets exist before creating a new one. " +
+            "If the default wallet fits your needs, use it as-is or update it with ol_wallet_type_update(). " +
+            "Only create a new wallet if you need a SECOND currency (e.g., 'stars', 'coins', 'miles'). " +
+            "REQUIRED FIELDS (will fail without these): " +
             "1. translations: { en: { name: 'Currency Name' } } - Name is REQUIRED. " +
             "2. unitSingularName: 'point' (or 'coin', 'star', etc.) - The singular form. " +
             "3. unitPluralName: 'points' (or 'coins', 'stars', etc.) - The plural form. " +
             "4. unitDaysExpiryAfter: 'all_time_active' or number string like '365'. " +
-            "📝 OPTIONAL: " +
-            "• code: Unique identifier (auto-generated if omitted, cannot change later). " +
-            "• allowNegativeBalance: true/false (default: false). " +
-            "• unitExpiryDate: Annual expiry in 'MM-DD' format (e.g., '12-31'). " +
-            "• unitDaysLocked: Days before points become spendable (0 for immediate). " +
-            "⚠️ NOT SUPPORTED AT CREATION: 'active' and 'limits' - use ol_wallet_type_update after creation. " +
-            "⏰ NOTE: New wallets are 'blocked' for ~2 minutes after creation - wait before updating. " +
-            "💡 EXAMPLE: { translations: { en: { name: 'Bonus Points' } }, unitSingularName: 'point', " +
-            "unitPluralName: 'points', unitDaysExpiryAfter: 'all_time_active', code: 'bonus' }",
+            "OPTIONAL: " +
+            "code: Unique identifier (auto-generated if omitted, cannot change later). " +
+            "allowNegativeBalance: true/false (default: false). " +
+            "unitExpiryDate: Annual expiry in 'MM-DD' format (e.g., '12-31'). " +
+            "allTimeNotLocked: TRUE = 'No pending' (points immediately available). " +
+            "unitDaysLocked: Only if allTimeNotLocked=false, set days for pending period. " +
+            "NOT SUPPORTED AT CREATION: 'active' and 'limits' - use ol_wallet_type_update after creation. " +
+            "NOTE: New wallets are 'blocked' for ~2 minutes after creation - wait before updating.",
         readOnly: false,
         inputSchema: WalletTypeCreateInputSchema,
         handler: walletTypeCreate,
@@ -283,6 +293,7 @@ export const walletTypeToolDefinitions = [
             "• allowNegativeBalance: Allow/disallow negative balances. " +
             "• limits: Update earning limits (same format as create). " +
             "• Expiry settings: unitExpiryDate, unitDaysExpiryAfter, etc. " +
+            "• ⭐ PENDING: allTimeNotLocked=true for 'No pending', or =false with unitDaysLocked for pending period. " +
             "💡 TIP: Use ol_wallet_type_get(walletTypeId) first to see current configuration.",
         readOnly: false,
         inputSchema: WalletTypeUpdateInputSchema,

package/dist/types/schemas/admin.d.ts

@@ -11,16 +11,16 @@ export declare const AdminRoleSchema: z.ZodObject<{
     default: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
+    default?: boolean | undefined;
     id?: string | number | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
 }, {
     name?: string | undefined;
+    default?: boolean | undefined;
     id?: string | number | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
 }>;
 export type AdminRole = z.infer<typeof AdminRoleSchema>;
 /**
@@ -58,16 +58,16 @@ export declare const AdminUserSchema: z.ZodObject<{
         default: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         name?: string | undefined;
+        default?: boolean | undefined;
         id?: string | number | undefined;
         role?: string | undefined;
         master?: boolean | undefined;
-        default?: boolean | undefined;
     }, {
         name?: string | undefined;
+        default?: boolean | undefined;
         id?: string | number | undefined;
         role?: string | undefined;
         master?: boolean | undefined;
-        default?: boolean | undefined;
     }>, "many">>;
     settings: z.ZodOptional<z.ZodObject<{
         notificationsEnabled: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
@@ -92,10 +92,10 @@ export declare const AdminUserSchema: z.ZodObject<{
     canChangePassword?: boolean | undefined;
     roles?: {
         name?: string | undefined;
+        default?: boolean | undefined;
         id?: string | number | undefined;
         role?: string | undefined;
         master?: boolean | undefined;
-        default?: boolean | undefined;
     }[] | undefined;
     settings?: {
         notificationsEnabled?: string | boolean | undefined;
@@ -115,10 +115,10 @@ export declare const AdminUserSchema: z.ZodObject<{
     canChangePassword?: boolean | undefined;
     roles?: {
         name?: string | undefined;
+        default?: boolean | undefined;
         id?: string | number | undefined;
         role?: string | undefined;
         master?: boolean | undefined;
-        default?: boolean | undefined;
     }[] | undefined;
     settings?: {
         notificationsEnabled?: string | boolean | undefined;

package/dist/types/schemas/role.d.ts

@@ -56,9 +56,9 @@ export declare const RoleSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -70,9 +70,9 @@ export declare const RoleSchema: z.ZodObject<{
 }, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -116,9 +116,9 @@ export declare const RoleListItemSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;
@@ -130,9 +130,9 @@ export declare const RoleListItemSchema: z.ZodObject<{
 }, {
     name: string;
     id: string | number;
+    default?: boolean | undefined;
     role?: string | undefined;
     master?: boolean | undefined;
-    default?: boolean | undefined;
     permissions?: {
         resource: string;
         access: string;

package/dist/types/schemas/wallet-type.js

@@ -75,9 +75,11 @@ export const WalletTypeCreateInputSchema = {
         "IMPORTANT: Use 'MM-DD' format, NOT 'YYYY-MM-DD'."),
     unitDaysActiveCount: z.number().int().nonnegative().optional().describe("Number of days points remain active after earning. Use with unitDaysExpiryAfter."),
     unitYearsActiveCount: z.number().int().nonnegative().optional().describe("Number of years points remain active after earning."),
-    unitDaysLocked: z.number().int().nonnegative().optional().describe("Number of days points are locked after earning before becoming spendable. " +
-        "Use 0 or omit for immediately available points."),
-    allTimeNotLocked: z.boolean().optional().describe("If true, points are never locked and immediately available. Overrides unitDaysLocked."),
+    unitDaysLocked: z.number().int().nonnegative().optional().describe("Number of days points are PENDING (locked) after earning before becoming spendable. " +
+        "Only used when allTimeNotLocked is false. Example: 7 for a 7-day pending period."),
+    allTimeNotLocked: z.boolean().optional().describe("⭐ PENDING METHOD: Set to TRUE for 'No pending' (points immediately available). " +
+        "Set to FALSE (or omit) for 'Pending for X days' mode, then set unitDaysLocked to the number of days. " +
+        "This maps to the 'Unit pending method' dropdown in the UI."),
 };
 export const WalletTypeUpdateInputSchema = {
     storeCode: z.string().optional().describe("Store code for multi-tenant routing. DO NOT pass this parameter - the configured default will be used automatically. Only provide a value if the user explicitly asks to work with a different store."),
@@ -93,6 +95,6 @@ export const WalletTypeUpdateInputSchema = {
     unitDaysExpiryAfter: z.string().optional().describe("Update days until expiry or 'all_time_active'."),
     unitDaysActiveCount: z.number().int().nonnegative().optional().describe("Update days active count."),
     unitYearsActiveCount: z.number().int().nonnegative().optional().describe("Update years active count."),
-    unitDaysLocked: z.number().int().nonnegative().optional().describe("Update locked days."),
-    allTimeNotLocked: z.boolean().optional().describe("Update not-locked setting."),
+    unitDaysLocked: z.number().int().nonnegative().optional().describe("Update pending period (days points are locked). Only applies when allTimeNotLocked is false."),
+    allTimeNotLocked: z.boolean().optional().describe("⭐ PENDING METHOD: Set TRUE for 'No pending' (immediate), FALSE for 'Pending for X days'."),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-loyalty/mcp-server",
-  "version": "1.3.6",
+  "version": "1.4.1",
   "type": "module",
   "description": "MCP server for Open Loyalty API - enables AI agents to manage loyalty programs, members, points, rewards, and transactions",
   "author": "Marcin Dyguda <md@openloyalty.io>",

package/dist/prompts/fan-engagement-setup.d.ts

@@ -1,107 +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.
- */
-export interface WorkflowQuestion {
-    id: string;
-    question: string;
-    type: "number" | "boolean" | "string" | "select";
-    default?: unknown;
-    options?: string[];
-    validation?: (value: unknown) => boolean;
-    hint?: string;
-}
-export interface WorkflowStep {
-    id: string;
-    action: string;
-    tool: string;
-    description: string;
-}
-export interface WorkflowDefinition {
-    id: string;
-    name: string;
-    description: string;
-    triggerPhrases: string[];
-    questions: WorkflowQuestion[];
-    steps: WorkflowStep[];
-}
-export declare const DEFAULTS: {
-    readonly matchAttendance: {
-        readonly coinsPerMatch: 50;
-        readonly milestones: number[];
-        readonly milestoneBonuses: Record<string | number, number>;
-        readonly limitPerDay: 1;
-        readonly badges: Record<string | number, string>;
-    };
-    readonly earlyArrival: {
-        readonly minutesBefore: 60;
-        readonly coinsPerArrival: 25;
-        readonly limitPerMatch: 1;
-    };
-    readonly sportsbarVisit: {
-        readonly coinsPerVisit: 50;
-        readonly visitMilestone: 5;
-        readonly milestoneBonus: 500;
-        readonly limitPerDay: 1;
-    };
-    readonly vodWatching: {
-        readonly trackBy: "views" | "minutes";
-        readonly coinsPerUnit: 10;
-        readonly unitSize: 10;
-        readonly achievementMinutes: 300;
-        readonly achievementBonus: 200;
-    };
-    readonly appLoginStreak: {
-        readonly coinsPerLogin: 5;
-        readonly streakDays: 7;
-        readonly streakBonus: 50;
-        readonly limitPerDay: 1;
-    };
-    readonly seasonDates: {
-        readonly start: string;
-        readonly end: string;
-    };
-};
-export declare const MATCH_ATTENDANCE_WORKFLOW: WorkflowDefinition;
-export declare const EARLY_ARRIVAL_WORKFLOW: WorkflowDefinition;
-export declare const SPORTSBAR_VISIT_WORKFLOW: WorkflowDefinition;
-export declare const VOD_WATCHING_WORKFLOW: WorkflowDefinition;
-export declare const APP_LOGIN_STREAK_WORKFLOW: WorkflowDefinition;
-export declare const ALL_WORKFLOWS: WorkflowDefinition[];
-/**
- * Find matching workflow based on user input
- */
-export declare function findMatchingWorkflow(userInput: string): WorkflowDefinition | undefined;
-/**
- * Get workflow by ID
- */
-export declare function getWorkflowById(id: string): WorkflowDefinition | undefined;
-/**
- * Parse comma-separated values to array
- */
-export declare function parseCommaSeparated(value: string): string[];
-/**
- * Parse milestones (handles both numbers and percentages like "80%")
- */
-export declare function parseMilestones(value: string): (number | string)[];
-/**
- * Format ISO date for Open Loyalty (YYYY-MM-DD HH:mm+TZ)
- */
-export declare function formatOLDate(date: string | Date): string;
-export declare const AGENT_PROMPTS: {
-    /**
-     * System prompt for fan engagement setup
-     */
-    systemPrompt: string;
-    /**
-     * Workflow completion template
-     */
-    completionTemplate: (results: {
-        campaignIds: string[];
-        achievementIds: string[];
-        summary: string;
-    }) => string;
-};