@open-loyalty/mcp-server 1.0.3 → 1.3.1

package/dist/tools/achievement.d.ts

@@ -70,42 +70,45 @@ export declare const AchievementCreateInputSchema: {
             name: string;
             description?: string | undefined;
         }>>>;
-        trigger: z.ZodOptional<z.ZodString>;
-        type: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "registration", "profile_update"]>>;
+        type: z.ZodOptional<z.ZodEnum<["direct", "referral"]>>;
         event: z.ZodOptional<z.ZodString>;
         completeRule: z.ZodObject<{
             periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-            period: z.ZodOptional<z.ZodObject<{
-                consecutive: z.ZodOptional<z.ZodNumber>;
-                value: z.ZodOptional<z.ZodNumber>;
+            period: z.ZodObject<{
+                type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                consecutive: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
-                value?: number | undefined;
-                consecutive?: number | undefined;
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
             }, {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            }>>;
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            }>;
             uniqueAttribute: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         }, {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         }>;
         aggregation: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["quantity", "sum", "average", "min", "max"]>;
             rule: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         }, {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         }>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -138,22 +141,23 @@ export declare const AchievementCreateInputSchema: {
     }, "strip", z.ZodTypeAny, {
         completeRule: {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         };
-        type?: string | undefined;
+        type?: "direct" | "referral" | undefined;
         conditions?: Record<string, unknown>[] | undefined;
         translations?: Record<string, {
             name: string;
             description?: string | undefined;
         }> | undefined;
-        trigger?: string | undefined;
+        trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
         event?: string | undefined;
         achievementRuleId?: string | undefined;
         aggregation?: {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         } | undefined;
         limit?: {
@@ -167,22 +171,23 @@ export declare const AchievementCreateInputSchema: {
     }, {
         completeRule: {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         };
-        type?: string | undefined;
+        type?: "direct" | "referral" | undefined;
         conditions?: Record<string, unknown>[] | undefined;
         translations?: Record<string, {
             name: string;
             description?: string | undefined;
         }> | undefined;
-        trigger?: string | undefined;
+        trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
         event?: string | undefined;
         achievementRuleId?: string | undefined;
         aggregation?: {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         } | undefined;
         limit?: {
@@ -264,42 +269,45 @@ export declare const AchievementUpdateInputSchema: {
             name: string;
             description?: string | undefined;
         }>>>;
-        trigger: z.ZodOptional<z.ZodString>;
-        type: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "registration", "profile_update"]>>;
+        type: z.ZodOptional<z.ZodEnum<["direct", "referral"]>>;
         event: z.ZodOptional<z.ZodString>;
         completeRule: z.ZodObject<{
             periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-            period: z.ZodOptional<z.ZodObject<{
-                consecutive: z.ZodOptional<z.ZodNumber>;
-                value: z.ZodOptional<z.ZodNumber>;
+            period: z.ZodObject<{
+                type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                consecutive: z.ZodNumber;
             }, "strip", z.ZodTypeAny, {
-                value?: number | undefined;
-                consecutive?: number | undefined;
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
             }, {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            }>>;
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            }>;
             uniqueAttribute: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         }, {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         }>;
         aggregation: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["quantity", "sum", "average", "min", "max"]>;
             rule: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         }, {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         }>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -332,22 +340,23 @@ export declare const AchievementUpdateInputSchema: {
     }, "strip", z.ZodTypeAny, {
         completeRule: {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         };
-        type?: string | undefined;
+        type?: "direct" | "referral" | undefined;
         conditions?: Record<string, unknown>[] | undefined;
         translations?: Record<string, {
             name: string;
             description?: string | undefined;
         }> | undefined;
-        trigger?: string | undefined;
+        trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
         event?: string | undefined;
         achievementRuleId?: string | undefined;
         aggregation?: {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         } | undefined;
         limit?: {
@@ -361,22 +370,23 @@ export declare const AchievementUpdateInputSchema: {
     }, {
         completeRule: {
             periodGoal: string | number;
-            period?: {
-                value?: number | undefined;
-                consecutive?: number | undefined;
-            } | undefined;
+            period: {
+                type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                consecutive: number;
+            };
             uniqueAttribute?: string | undefined;
         };
-        type?: string | undefined;
+        type?: "direct" | "referral" | undefined;
         conditions?: Record<string, unknown>[] | undefined;
         translations?: Record<string, {
             name: string;
             description?: string | undefined;
         }> | undefined;
-        trigger?: string | undefined;
+        trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
         event?: string | undefined;
         achievementRuleId?: string | undefined;
         aggregation?: {
+            type: "quantity" | "min" | "max" | "sum" | "average";
             rule?: string | undefined;
         } | undefined;
         limit?: {
@@ -535,7 +545,9 @@ export declare function achievementListMemberAchievements(input: {
 }>;
 export declare const achievementToolDefinitions: readonly [{
     readonly name: "openloyalty_achievement_list";
+    readonly title: "List Achievements";
     readonly description: "List achievements. Achievements gamify member behavior by setting goals (e.g., 'Make 5 purchases this month'). Returns achievementId, name, active status, and associated badge. Use achievement_get for full rules and configuration.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         page: z.ZodOptional<z.ZodNumber>;
@@ -546,7 +558,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementList;
 }, {
     readonly name: "openloyalty_achievement_create";
-    readonly description: "Create achievement with rules that track member progress. Triggers: transaction (purchases), custom_event (custom actions), points_transfer, referral, etc. CompleteRule sets the goal: periodGoal (target value) with optional period (consecutive periods). Example - '5 purchases/month': rules: [{ trigger: 'transaction', completeRule: { periodGoal: 5, period: { value: 1, consecutive: 1 } } }]";
+    readonly title: "Create Achievement";
+    readonly description: string;
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         translations: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -610,42 +624,45 @@ export declare const achievementToolDefinitions: readonly [{
                 name: string;
                 description?: string | undefined;
             }>>>;
-            trigger: z.ZodOptional<z.ZodString>;
-            type: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "registration", "profile_update"]>>;
+            type: z.ZodOptional<z.ZodEnum<["direct", "referral"]>>;
             event: z.ZodOptional<z.ZodString>;
             completeRule: z.ZodObject<{
                 periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                period: z.ZodOptional<z.ZodObject<{
-                    consecutive: z.ZodOptional<z.ZodNumber>;
-                    value: z.ZodOptional<z.ZodNumber>;
+                period: z.ZodObject<{
+                    type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                    consecutive: z.ZodNumber;
                 }, "strip", z.ZodTypeAny, {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
                 }, {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                }>>;
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                }>;
                 uniqueAttribute: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             }, {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             }>;
             aggregation: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["quantity", "sum", "average", "min", "max"]>;
                 rule: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             }, {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             }>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -678,22 +695,23 @@ export declare const achievementToolDefinitions: readonly [{
         }, "strip", z.ZodTypeAny, {
             completeRule: {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             };
-            type?: string | undefined;
+            type?: "direct" | "referral" | undefined;
             conditions?: Record<string, unknown>[] | undefined;
             translations?: Record<string, {
                 name: string;
                 description?: string | undefined;
             }> | undefined;
-            trigger?: string | undefined;
+            trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
             event?: string | undefined;
             achievementRuleId?: string | undefined;
             aggregation?: {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             } | undefined;
             limit?: {
@@ -707,22 +725,23 @@ export declare const achievementToolDefinitions: readonly [{
         }, {
             completeRule: {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             };
-            type?: string | undefined;
+            type?: "direct" | "referral" | undefined;
             conditions?: Record<string, unknown>[] | undefined;
             translations?: Record<string, {
                 name: string;
                 description?: string | undefined;
             }> | undefined;
-            trigger?: string | undefined;
+            trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
             event?: string | undefined;
             achievementRuleId?: string | undefined;
             aggregation?: {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             } | undefined;
             limit?: {
@@ -739,7 +758,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementCreate;
 }, {
     readonly name: "openloyalty_achievement_get";
+    readonly title: "Get Achievement Details";
     readonly description: "Get achievement details including all rules, conditions, activity period, limits, and completions count.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         achievementId: z.ZodString;
@@ -747,7 +768,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementGet;
 }, {
     readonly name: "openloyalty_achievement_update";
+    readonly title: "Update Achievement";
     readonly description: "Update achievement configuration. Requires full achievement object (translations, rules). Use achievement_get first to retrieve current configuration.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         achievementId: z.ZodString;
@@ -812,42 +835,45 @@ export declare const achievementToolDefinitions: readonly [{
                 name: string;
                 description?: string | undefined;
             }>>>;
-            trigger: z.ZodOptional<z.ZodString>;
-            type: z.ZodOptional<z.ZodString>;
+            trigger: z.ZodOptional<z.ZodEnum<["transaction", "custom_event", "points_transfer", "reward_redemption", "referral", "achievement", "tier_change", "registration", "profile_update"]>>;
+            type: z.ZodOptional<z.ZodEnum<["direct", "referral"]>>;
             event: z.ZodOptional<z.ZodString>;
             completeRule: z.ZodObject<{
                 periodGoal: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                period: z.ZodOptional<z.ZodObject<{
-                    consecutive: z.ZodOptional<z.ZodNumber>;
-                    value: z.ZodOptional<z.ZodNumber>;
+                period: z.ZodObject<{
+                    type: z.ZodEnum<["day", "week", "month", "year", "last_day", "calendarDays", "calendarWeeks", "calendarMonths", "calendarYears"]>;
+                    consecutive: z.ZodNumber;
                 }, "strip", z.ZodTypeAny, {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
                 }, {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                }>>;
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                }>;
                 uniqueAttribute: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             }, {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             }>;
             aggregation: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["quantity", "sum", "average", "min", "max"]>;
                 rule: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             }, {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             }>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -880,22 +906,23 @@ export declare const achievementToolDefinitions: readonly [{
         }, "strip", z.ZodTypeAny, {
             completeRule: {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             };
-            type?: string | undefined;
+            type?: "direct" | "referral" | undefined;
             conditions?: Record<string, unknown>[] | undefined;
             translations?: Record<string, {
                 name: string;
                 description?: string | undefined;
             }> | undefined;
-            trigger?: string | undefined;
+            trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
             event?: string | undefined;
             achievementRuleId?: string | undefined;
             aggregation?: {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             } | undefined;
             limit?: {
@@ -909,22 +936,23 @@ export declare const achievementToolDefinitions: readonly [{
         }, {
             completeRule: {
                 periodGoal: string | number;
-                period?: {
-                    value?: number | undefined;
-                    consecutive?: number | undefined;
-                } | undefined;
+                period: {
+                    type: "day" | "week" | "month" | "year" | "calendarDays" | "calendarWeeks" | "calendarMonths" | "calendarYears" | "last_day";
+                    consecutive: number;
+                };
                 uniqueAttribute?: string | undefined;
             };
-            type?: string | undefined;
+            type?: "direct" | "referral" | undefined;
             conditions?: Record<string, unknown>[] | undefined;
             translations?: Record<string, {
                 name: string;
                 description?: string | undefined;
             }> | undefined;
-            trigger?: string | undefined;
+            trigger?: "referral" | "transaction" | "custom_event" | "achievement" | "points_transfer" | "reward_redemption" | "tier_change" | "registration" | "profile_update" | undefined;
             event?: string | undefined;
             achievementRuleId?: string | undefined;
             aggregation?: {
+                type: "quantity" | "min" | "max" | "sum" | "average";
                 rule?: string | undefined;
             } | undefined;
             limit?: {
@@ -941,7 +969,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementUpdate;
 }, {
     readonly name: "openloyalty_achievement_patch";
+    readonly title: "Patch Achievement";
     readonly description: "Partial update of achievement. Use for simple changes like activating/deactivating or updating translations without providing full rules.";
+    readonly readOnly: false;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         achievementId: z.ZodString;
@@ -960,7 +990,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementPatch;
 }, {
     readonly name: "openloyalty_achievement_get_member_progress";
+    readonly title: "Get Member Achievement Progress";
     readonly description: "Get member's progress on a specific achievement. Returns completedCount, and for each rule: periodGoal, currentPeriodValue, and consecutive period tracking.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;
@@ -969,7 +1001,9 @@ export declare const achievementToolDefinitions: readonly [{
     readonly handler: typeof achievementGetMemberProgress;
 }, {
     readonly name: "openloyalty_achievement_list_member_achievements";
+    readonly title: "List Member Achievements";
     readonly description: "List all achievements with member's progress. Returns each achievement's status, completion count, and per-rule progress. Use for displaying gamification dashboard.";
+    readonly readOnly: true;
     readonly inputSchema: {
         storeCode: z.ZodOptional<z.ZodString>;
         memberId: z.ZodString;