@open-loyalty/mcp-server 1.3.7 → 1.5.3

package/dist/tools/campaign/schemas.d.ts

@@ -65,17 +65,17 @@ export declare const CampaignUpdateInputSchema: {
         description: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodEnum<["self", "referrer"]>>;
         effects: z.ZodArray<z.ZodObject<{
-            effect: z.ZodString;
+            effect: z.ZodEnum<["give_points", "give_reward", "deduct_unit", "assign_member_custom_attribute", "remove_member_custom_attribute"]>;
             pointsRule: z.ZodOptional<z.ZodString>;
             walletCode: z.ZodOptional<z.ZodString>;
             rewardId: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            effect: string;
+            effect: "give_points" | "give_reward" | "deduct_unit" | "assign_member_custom_attribute" | "remove_member_custom_attribute";
             walletCode?: string | undefined;
             rewardId?: string | undefined;
             pointsRule?: string | undefined;
         }, {
-            effect: string;
+            effect: "give_points" | "give_reward" | "deduct_unit" | "assign_member_custom_attribute" | "remove_member_custom_attribute";
             walletCode?: string | undefined;
             rewardId?: string | undefined;
             pointsRule?: string | undefined;
@@ -83,20 +83,20 @@ export declare const CampaignUpdateInputSchema: {
         conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             operator: z.ZodString;
             attribute: z.ZodString;
-            data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            data: z.ZodUnknown;
         }, "strip", z.ZodTypeAny, {
             attribute: string;
             operator: string;
-            data?: Record<string, unknown> | undefined;
+            data?: unknown;
         }, {
             attribute: string;
             operator: string;
-            data?: Record<string, unknown> | undefined;
+            data?: unknown;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: {
-            effect: string;
+            effect: "give_points" | "give_reward" | "deduct_unit" | "assign_member_custom_attribute" | "remove_member_custom_attribute";
             walletCode?: string | undefined;
             rewardId?: string | undefined;
             pointsRule?: string | undefined;
@@ -105,13 +105,13 @@ export declare const CampaignUpdateInputSchema: {
         conditions?: {
             attribute: string;
             operator: string;
-            data?: Record<string, unknown> | undefined;
+            data?: unknown;
         }[] | undefined;
         target?: "self" | "referrer" | undefined;
     }, {
         name: string;
         effects: {
-            effect: string;
+            effect: "give_points" | "give_reward" | "deduct_unit" | "assign_member_custom_attribute" | "remove_member_custom_attribute";
             walletCode?: string | undefined;
             rewardId?: string | undefined;
             pointsRule?: string | undefined;
@@ -120,7 +120,7 @@ export declare const CampaignUpdateInputSchema: {
         conditions?: {
             attribute: string;
             operator: string;
-            data?: Record<string, unknown> | undefined;
+            data?: unknown;
         }[] | undefined;
         target?: "self" | "referrer" | undefined;
     }>, "many">;
@@ -129,11 +129,11 @@ export declare const CampaignUpdateInputSchema: {
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;
@@ -142,70 +142,133 @@ export declare const CampaignUpdateInputSchema: {
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "segment" | "tier";
+        target: "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "segment" | "tier";
+        target: "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;
     limits: z.ZodOptional<z.ZodObject<{
         points: z.ZodOptional<z.ZodObject<{
             value: z.ZodNumber;
-            interval: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }>>;
         pointsPerMember: z.ZodOptional<z.ZodObject<{
             value: z.ZodNumber;
-            interval: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }>>;
         executionsPerMember: z.ZodOptional<z.ZodObject<{
             value: z.ZodNumber;
-            interval: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            interval: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                value: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }, {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }, {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         points?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
         pointsPerMember?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
         executionsPerMember?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
     }, {
         points?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
         pointsPerMember?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
         executionsPerMember?: {
             value: number;
-            interval?: Record<string, unknown> | undefined;
+            interval?: {
+                type: "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears";
+                value?: number | undefined;
+            } | undefined;
         } | undefined;
     }>>;
     active: z.ZodOptional<z.ZodBoolean>;
@@ -545,11 +608,11 @@ export declare const CampaignCreateInputSchema: {
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "all" | "segment" | "tier";
+        target: "all" | "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;
@@ -558,11 +621,11 @@ export declare const CampaignCreateInputSchema: {
         tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         segments: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        target: "segment" | "tier";
+        target: "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }, {
-        target: "segment" | "tier";
+        target: "tier" | "segment";
         tiers?: string[] | undefined;
         segments?: string[] | undefined;
     }>>;

package/dist/tools/campaign/schemas.js

@@ -11,14 +11,13 @@ const TranslationsInputSchema = z.object({
 const CampaignEffectInputSchema = z.object({
     effect: z.enum(["give_points", "give_reward", "deduct_unit", "assign_member_custom_attribute", "remove_member_custom_attribute"])
         .describe("Effect type: give_points, give_reward, deduct_unit, etc. Use key `effect` (not `type`)."),
-    pointsRule: z.string().optional().describe("Points calculation expression (required for give_points). " +
+    pointsRule: z.string().optional().describe("Points calculation expression (required for give_points). Must be a STRING. " +
         "Fixed: '100'. Dynamic: 'transaction.grossValue * 10'. " +
         "Category: 'transaction.category(\"electronics\").grossValue * 5'. " +
         "Capped: '(transaction.grossValue * 2 >= 100) ? 100 : transaction.grossValue * 2'. " +
-        "Rounded: 'round_up(0.1 * transaction.grossValue)'. " +
-        "CONDITIONAL: Use ternary for conditional rewards based on custom event attributes: " +
-        "'event.body.minutes_before >= 60 ? 25 : 0' (awards 25 if condition met, else 0). " +
-        "Operators: ==, !=, >, <, >=, <=, &&, ||"),
+        "Conditional: 'event.body.minutes_before >= 60 ? 25 : 0'. " +
+        "BUSINESS IMPACT: 'transaction.grossValue * 10' on $500 avg transaction = 5,000 points/purchase. " +
+        "At $0.01/point, that is a 10% return rate. Confirm the formula and earn rate with the user."),
     walletCode: z.string().optional().describe("Wallet code for points (default wallet if not specified)."),
     rewardId: z.string().optional().describe("Reward ID (required for give_reward effect)."),
     customAttributeKey: z.string().optional().describe("Custom attribute key (for assign/remove member custom attribute effects)."),
@@ -54,7 +53,9 @@ const CampaignRuleInputSchema = z.object({
 // Activity input schema
 const CampaignActivityInputSchema = z.object({
     startsAt: z.string().describe("Campaign start date/time (ISO format: YYYY-MM-DD HH:mm+TZ). REQUIRED."),
-    endsAt: z.string().optional().describe("Campaign end date/time (ISO format). If not specified, campaign runs indefinitely."),
+    endsAt: z.string().optional().describe("Campaign end date/time (ISO format). " +
+        "BUSINESS IMPACT: If not specified, campaign runs indefinitely -- this is an open-ended budget commitment. " +
+        "Confirm with user whether the campaign should have an end date."),
 });
 // Visibility input schema
 const CampaignVisibilityInputSchema = z.object({
@@ -140,7 +141,7 @@ const SimulateReferrerSchema = z.object({
 }).optional();
 // Exported Input Schemas
 export const CampaignListInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 10)."),
     active: z.boolean().optional().describe("Filter by active status."),
@@ -148,72 +149,100 @@ export const CampaignListInputSchema = {
     trigger: CampaignTriggerEnum.optional().describe("Filter by trigger type: transaction, custom_event, time, etc."),
 };
 export const CampaignGetInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to retrieve."),
 };
 export const CampaignUpdateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to update."),
     type: CampaignTypeEnum.describe("Campaign type: direct or referral."),
-    trigger: CampaignTriggerEnum.describe("What triggers the campaign."),
+    trigger: CampaignTriggerEnum.describe("What triggers the campaign: transaction, custom_event, time, achievement, geolocation, etc."),
     translations: z.object({
         en: z.object({
-            name: z.string(),
-            description: z.string().optional(),
+            name: z.string().describe("Campaign name in English (REQUIRED)."),
+            description: z.string().optional().describe("Campaign description in English."),
         }),
     }).passthrough().describe("Translations object with at least 'en' key."),
     activity: z.object({
-        startsAt: z.string(),
-        endsAt: z.string().optional(),
-    }).describe("Campaign active period."),
+        startsAt: z.string().describe("Campaign start date/time (ISO format: YYYY-MM-DD HH:mm+TZ). REQUIRED."),
+        endsAt: z.string().optional().describe("Campaign end date/time (ISO format). If not specified, campaign runs indefinitely."),
+    }).describe("Campaign active period with required startsAt."),
     rules: z.array(z.object({
-        name: z.string(),
-        description: z.string().optional(),
-        target: z.enum(["self", "referrer"]).optional(),
+        name: z.string().describe("Rule name (required)."),
+        description: z.string().optional().describe("Rule description."),
+        target: z.enum(["self", "referrer"]).optional().describe("Target for rule effects: self (default) or referrer."),
         effects: z.array(z.object({
-            effect: z.string(),
-            pointsRule: z.string().optional(),
-            walletCode: z.string().optional(),
-            rewardId: z.string().optional(),
-        })),
+            effect: z.enum(["give_points", "give_reward", "deduct_unit", "assign_member_custom_attribute", "remove_member_custom_attribute"])
+                .describe("Effect type. Use key 'effect' (NOT 'type'): give_points, give_reward, deduct_unit."),
+            pointsRule: z.string().optional().describe("Points calculation expression (required for give_points). STRING value: '100' (fixed), 'transaction.grossValue * 10' (dynamic)."),
+            walletCode: z.string().optional().describe("Wallet code for points. Use ol_wallet_type_list to find valid codes. Default wallet if not specified."),
+            rewardId: z.string().optional().describe("Reward ID (required for give_reward effect). Use ol_reward_list to find rewardId."),
+        })).describe("Array of effects to apply when rule matches."),
         conditions: z.array(z.object({
-            operator: z.string(),
-            attribute: z.string(),
-            data: z.record(z.unknown()).optional(),
-        })).optional(),
-    })).describe("Campaign rules."),
+            operator: z.string().describe("Condition operator. Valid: is_equal, is_not_equal, is_greater, is_greater_or_equal, is_less, is_less_or_equal, " +
+                "contains, not_contains, has_at_least_one_label, is_one_of, is_between, is_after, is_before. " +
+                "Use FULL names (NOT 'gte', 'lte')."),
+            attribute: z.string().describe("Attribute path: 'transaction.grossValue', 'transaction.labels', 'customer.email'. Use full path with context prefix."),
+            data: z.unknown().describe("Condition value. Number for comparisons: 100. Label array for has_at_least_one_label: [{key: 'k', value: 'v'}]. " +
+                "Object for is_between: {from: 50, to: 200}."),
+        })).optional().describe("Array of conditions that must match for rule to apply."),
+    })).describe("Campaign rules with effects and optional conditions."),
     visibility: z.object({
-        target: z.enum(["all", "tier", "segment"]),
-        tiers: z.array(z.string()).optional(),
-        segments: z.array(z.string()).optional(),
-    }).optional(),
+        target: z.enum(["all", "tier", "segment"]).describe("Who can see the campaign: all, tier (specific tiers), or segment (specific segments)."),
+        tiers: z.array(z.string()).optional().describe("Array of tier level IDs (required if target is 'tier'). Use ol_tierset_get_tiers to find IDs."),
+        segments: z.array(z.string()).optional().describe("Array of segment IDs (required if target is 'segment'). Use ol_segment_list to find IDs."),
+    }).optional().describe("Who can see the campaign."),
     audience: z.object({
-        target: z.enum(["tier", "segment"]),
-        tiers: z.array(z.string()).optional(),
-        segments: z.array(z.string()).optional(),
-    }).optional(),
+        target: z.enum(["tier", "segment"]).describe("Who can participate: tier or segment. To target ALL members, OMIT the audience parameter entirely - do NOT use 'all'."),
+        tiers: z.array(z.string()).optional().describe("Array of tier level IDs (required if target is 'tier')."),
+        segments: z.array(z.string()).optional().describe("Array of segment IDs (required if target is 'segment')."),
+    }).optional().describe("Who can participate. OMIT entirely for all members."),
     limits: z.object({
-        points: z.object({ value: z.number(), interval: z.record(z.unknown()).optional() }).optional(),
-        pointsPerMember: z.object({ value: z.number(), interval: z.record(z.unknown()).optional() }).optional(),
-        executionsPerMember: z.object({ value: z.number(), interval: z.record(z.unknown()).optional() }).optional(),
-    }).optional(),
-    active: z.boolean().optional(),
-    displayOrder: z.number().optional(),
-    labels: z.array(z.object({ key: z.string(), value: z.string() })).optional(),
-    event: z.string().optional(),
+        points: z.object({
+            value: z.number().describe("Maximum total points."),
+            interval: z.object({
+                type: z.enum(["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"])
+                    .describe("Interval type: calendarDays, calendarWeeks, calendarMonths, calendarYears. Omit interval for lifetime limit."),
+                value: z.number().optional().describe("Interval value (e.g., 1 for every 1 day)."),
+            }).optional().describe("Time interval for limit reset. Omit for lifetime limit."),
+        }).optional().describe("Total points limit for the campaign."),
+        pointsPerMember: z.object({
+            value: z.number().describe("Maximum points per member."),
+            interval: z.object({
+                type: z.enum(["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"])
+                    .describe("Interval type: calendarDays, calendarWeeks, calendarMonths, calendarYears."),
+                value: z.number().optional().describe("Interval value."),
+            }).optional().describe("Time interval for limit reset. Omit for lifetime limit."),
+        }).optional().describe("Points limit per member."),
+        executionsPerMember: z.object({
+            value: z.number().describe("Maximum executions per member."),
+            interval: z.object({
+                type: z.enum(["calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"])
+                    .describe("Interval type: calendarDays, calendarWeeks, calendarMonths, calendarYears."),
+                value: z.number().optional().describe("Interval value."),
+            }).optional().describe("Time interval for limit reset. Omit for lifetime limit."),
+        }).optional().describe("Execution limit per member."),
+    }).optional().describe("Campaign limits for points and executions."),
+    active: z.boolean().optional().describe("Whether campaign is active."),
+    displayOrder: z.number().optional().describe("Display order for sorting campaigns."),
+    labels: z.array(z.object({
+        key: z.string().describe("Label key."),
+        value: z.string().describe("Label value."),
+    })).optional().describe("Custom labels/tags for the campaign."),
+    event: z.string().optional().describe("Custom event name (required for custom_event trigger). Use ol_custom_event_schema_list to find valid event codes."),
 };
 export const CampaignPatchInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to patch."),
     active: z.boolean().optional().describe("Set campaign active status."),
     displayOrder: z.number().optional().describe("Set campaign display order."),
 };
 export const CampaignDeleteInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to delete."),
 };
 export const CampaignSimulateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     trigger: CampaignTriggerEnum.describe("Campaign trigger type to simulate: transaction, custom_event, etc."),
     transaction: SimulateTransactionSchema.describe("Transaction data (required for transaction trigger)."),
     customEvent: SimulateCustomEventSchema.describe("Custom event data (required for custom_event trigger)."),
@@ -221,12 +250,12 @@ export const CampaignSimulateInputSchema = {
     referrer: SimulateReferrerSchema.describe("Referrer data for referral campaigns."),
 };
 export const CampaignGenerateCodesInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to generate codes for."),
     quantity: z.number().min(1).describe("Number of codes to generate."),
 };
 export const CampaignListCodesInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to list codes for."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
@@ -234,7 +263,7 @@ export const CampaignListCodesInputSchema = {
     code: z.string().optional().describe("Filter by specific code."),
 };
 export const CampaignGetAvailableInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     memberId: z.string().describe("The member ID (UUID) to get available campaigns for."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
@@ -242,27 +271,32 @@ export const CampaignGetAvailableInputSchema = {
     trigger: CampaignTriggerEnum.optional().describe("Filter by campaign trigger."),
 };
 export const CampaignGetVisibleInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     memberId: z.string().describe("The member ID (UUID) to get visible campaigns for."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
     active: z.boolean().optional().describe("Filter by active status."),
 };
 export const CampaignGetLeaderboardInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     campaignId: z.string().describe("The campaign ID (UUID) to get leaderboard for."),
     type: z.string().optional().describe("Cycle type for ranking (e.g., 'weekly', 'monthly')."),
 };
 export const CampaignCreateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     type: CampaignTypeEnum.describe("Campaign type: direct (standard) or referral (for referral programs)."),
     trigger: CampaignTriggerEnum.describe("What triggers the campaign: transaction, custom_event, time, achievement, etc."),
     translations: TranslationsInputSchema,
     activity: CampaignActivityInputSchema.describe("Campaign active period with required startsAt and optional endsAt."),
     rules: z.array(CampaignRuleInputSchema).describe("Array of rules defining when and what effects to apply. Each rule requires a name."),
     visibility: CampaignVisibilityInputSchema.describe("Who can see the campaign."),
-    audience: CampaignAudienceInputSchema.describe("Who can participate in the campaign. OMIT this parameter entirely to target ALL members."),
-    limits: CampaignLimitsInputSchema.describe("Campaign limits for points and executions."),
+    audience: CampaignAudienceInputSchema.describe("Who can participate. OMIT entirely for all members -- do NOT pass target: 'all' (API rejects it). " +
+        "BUSINESS DECISION: Targeting wrong audience wastes budget or excludes key segments. " +
+        "Use target: 'tier' + tiers array, or target: 'segment' + segments array."),
+    limits: CampaignLimitsInputSchema.describe("Budget controls for the campaign. " +
+        "BUSINESS IMPACT: Without limits, a campaign running 12 months on 10K txn/month at 100 pts each = 12M points liability. " +
+        "BUSINESS DECISION: Set points (total cap), pointsPerMember (per-member cap), and/or executionsPerMember (frequency). " +
+        "Omit interval for lifetime limit, or use { type: 'calendarDays', value: 1 } for daily reset."),
     active: z.boolean().optional().describe("Whether campaign is active (default: false)."),
     displayOrder: z.number().optional().describe("Display order for sorting campaigns."),
     labels: z.array(CampaignLabelInputSchema).optional().describe("Custom labels/tags for the campaign."),

package/dist/tools/custom-event.js

@@ -4,7 +4,7 @@ import { formatApiError } from "../utils/errors.js";
 import { getStoreCode } from "../config.js";
 // Input Schemas
 export const CustomEventSchemaListInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
     eventType: z.string().optional().describe("Filter by event type code."),
@@ -12,7 +12,7 @@ export const CustomEventSchemaListInputSchema = {
     active: z.boolean().optional().describe("Filter by active status."),
 };
 export const CustomEventSchemaGetInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     eventType: z.string().describe("The custom event type code to retrieve."),
 };
 const CustomEventSchemaFieldSchema = z.object({
@@ -21,27 +21,27 @@ const CustomEventSchemaFieldSchema = z.object({
     description: z.string().optional().describe("Field description."),
 });
 export const CustomEventSchemaCreateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     eventType: z.string().describe("Unique event type code (e.g., 'location_visit', 'app_login', 'video_watch'). " +
         "Use snake_case. This is referenced in campaigns and achievements."),
     name: z.string().describe("Human-readable name for the event schema."),
-    fields: z.array(CustomEventSchemaFieldSchema).describe("Array of fields the event can contain. Example: [{name: 'minutes_watched', type: 'integer'}]"),
+    fields: z.array(CustomEventSchemaFieldSchema).describe("Array of fields. Example: [{name: 'minutes_watched', type: 'number'}, {name: 'location', type: 'text'}]. Valid types: text, number, boolean, datetime."),
     active: z.boolean().optional().describe("Whether the schema is active (default: true)."),
 };
 export const CustomEventSchemaUpdateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     eventType: z.string().describe("The custom event type code to update."),
     name: z.string().describe("Human-readable name for the event schema."),
     fields: z.array(CustomEventSchemaFieldSchema).describe("Array of fields the event can contain."),
     active: z.boolean().optional().describe("Whether the schema is active."),
 };
 export const CustomEventSchemaActivateInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     eventType: z.string().describe("The custom event type code to activate/deactivate."),
     active: z.boolean().describe("Set to true to activate, false to deactivate."),
 };
 export const CustomEventSendInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     eventType: z.string().describe("The custom event type code (must match an existing schema)."),
     customerData: z.object({
         customerId: z.string().optional().describe("Member ID (UUID) for identification."),
@@ -54,7 +54,7 @@ export const CustomEventSendInputSchema = {
     eventId: z.string().optional().describe("Unique event identifier for deduplication (optional, max 255 chars)."),
 };
 export const CustomEventListInputSchema = {
-    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."),
+    storeCode: z.string().optional().describe("INTERNAL: Auto-configured from server settings. NEVER ask the user for this value. Only set if the user explicitly requests a different store."),
     page: z.number().optional().describe("Page number (default: 1)."),
     perPage: z.number().optional().describe("Items per page (default: 25)."),
     type: z.string().optional().describe("Filter by event type."),
@@ -228,7 +228,8 @@ export const customEventToolDefinitions = [
         name: "ol_custom_event_schema_create",
         title: "Create Custom Event Schema",
         description: "Create a new custom event schema. REQUIRED before using a custom event in campaigns or achievements. " +
-            "Example: To track location visits, create schema with eventType='location_visit' and fields like [{name: 'location_id', type: 'string'}]. " +
+            "Example: To track location visits, create schema with eventType='location_visit' and fields like [{name: 'location_id', type: 'text'}]. " +
+            "Valid field types: 'text' (strings), 'number' (integers/decimals), 'boolean', 'datetime'. " +
             "Then use campaign_create with trigger='custom_event', event='location_visit'.",
         readOnly: false,
         inputSchema: CustomEventSchemaCreateInputSchema,