@fuul/mcp-server 1.6.1 → 1.8.0

package/dist/referral-attribution/referral-attribution-handlers.js

@@ -26,6 +26,28 @@ export function buildDeleteReferralPath(code, query) {
     const encoded = encodeURIComponent(code);
     return qs ? `/api/v1/referral_codes/${encoded}/referrals?${qs}` : `/api/v1/referral_codes/${encoded}/referrals`;
 }
+export function buildUseReferralCodePath(code, query) {
+    const qs = buildNestQueryString(query);
+    const encoded = encodeURIComponent(code);
+    return qs ? `/api/v1/referral_codes/${encoded}/use?${qs}` : `/api/v1/referral_codes/${encoded}/use`;
+}
+export function buildGetUserReferrerPath(query) {
+    const qs = buildNestQueryString(query);
+    return qs ? `/api/v1/user/referrer?${qs}` : '/api/v1/user/referrer';
+}
+function normalizePatchUseResult(data) {
+    if (data === undefined || data === null || data === '') {
+        return { status: 'used' };
+    }
+    return data;
+}
+export async function runGetUserReferrer(api, bearer, input) {
+    const path = buildGetUserReferrerPath({
+        user_identifier: input.user_identifier,
+        user_identifier_type: input.user_identifier_type,
+    });
+    return api.getJson(path, { bearerToken: bearer });
+}
 export async function runUpdateUserReferrer(api, bearer, input) {
     assertWriteConfirmedOrDryRun(input);
     const body = buildUpdateUserReferrerBody(input);
@@ -35,6 +57,18 @@ export async function runUpdateUserReferrer(api, bearer, input) {
     }
     return api.putJson(path, body, { bearerToken: bearer });
 }
+export async function runUseReferralCode(api, bearer, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const path = buildUseReferralCodePath(input.referral_code, {
+        user_identifier: input.user_identifier,
+        user_identifier_type: input.user_identifier_type,
+    });
+    if (input.dry_run === true) {
+        return { dry_run: true, would_patch: path, body: {} };
+    }
+    const data = await api.patchJson(path, {}, { bearerToken: bearer });
+    return normalizePatchUseResult(data);
+}
 export async function runRemoveUserFromReferralCode(api, bearer, input) {
     assertWriteConfirmedOrDryRun(input);
     const path = buildDeleteReferralPath(input.referral_code, {
@@ -64,18 +98,15 @@ export async function runSwapUserReferralCode(api, bearer, input) {
         referrer_identifier: input.from_referrer_identifier,
         referrer_identifier_type: input.from_referrer_identifier_type,
     });
-    const putBody = buildUpdateUserReferrerBody({
+    const usePath = buildUseReferralCodePath(input.to_referral_code, {
         user_identifier: input.user_identifier,
         user_identifier_type: input.user_identifier_type,
-        referrer_identifier: input.to_referrer_identifier,
-        referrer_identifier_type: input.to_referrer_identifier_type,
-        referral_code: input.to_referral_code,
     });
     if (input.dry_run === true) {
         return {
             dry_run: true,
             step1_remove: { would_delete: removePath, body: {} },
-            step2_assign: { would_put: '/api/v1/user-referrers', body: putBody },
+            step2_use: { would_patch: usePath, body: {} },
         };
     }
     let removeResult;
@@ -91,15 +122,15 @@ export async function runSwapUserReferralCode(api, bearer, input) {
         }
     }
     try {
-        const putResult = await api.putJson('/api/v1/user-referrers', putBody, { bearerToken: bearer });
-        return { remove: removeResult, assign: putResult };
+        const useResult = normalizePatchUseResult(await api.patchJson(usePath, {}, { bearerToken: bearer }));
+        return { remove: removeResult, use: useResult };
     }
     catch (e) {
-        const assignError = e instanceof ApiRequestError ? { message: e.message, status: e.status } : { message: e instanceof Error ? e.message : String(e) };
+        const useError = e instanceof ApiRequestError ? { message: e.message, status: e.status } : { message: e instanceof Error ? e.message : String(e) };
         return {
             partial: true,
             remove: removeResult,
-            assign_error: assignError,
+            use_error: useError,
         };
     }
 }

package/dist/referral-attribution/referral-attribution-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"referral-attribution-handlers.js","sourceRoot":"","sources":["../../src/referral-attribution/referral-attribution-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAsB,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,sCAAsC;IACtC,sCAAsC;IACtC,6DAA6D;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAGC;IAED,MAAM,IAAI,GAA4B;QACpC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;KAC1D,CAAC;IACF,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,KAAK,EAAE,EAAE,CAAC;QAChE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,KAKC;IAED,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,YAAY,CAAC;AAClH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAA8B;IAC5G,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,wBAAwB,CAAC;IAEtC,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,GAAkB,EAAE,MAAc,EAAE,KAAsC;IAC5H,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,aAAa,EAAE;QACxD,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;KACzD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3F,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAAgC;IAChH,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,kBAAkB,EAAE;QACnE,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,mBAAmB,EAAE,KAAK,CAAC,wBAAwB;QACnD,wBAAwB,EAAE,KAAK,CAAC,6BAA6B;KAC9D,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,2BAA2B,CAAC;QAC1C,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,mBAAmB,EAAE,KAAK,CAAC,sBAAsB;QACjD,wBAAwB,EAAE,KAAK,CAAC,2BAA2B;QAC3D,aAAa,EAAE,KAAK,CAAC,gBAAgB;KACtC,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;YACpD,YAAY,EAAE,EAAE,SAAS,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE;SACrE,CAAC;IACJ,CAAC;IAED,IAAI,YAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3F,YAAY,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,wBAAwB,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QAChG,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,WAAW,GACf,CAAC,YAAY,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACpI,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,WAAW;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"referral-attribution-handlers.js","sourceRoot":"","sources":["../../src/referral-attribution/referral-attribution-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAsB,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAS7D,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,sCAAsC;IACtC,sCAAsC;IACtC,6DAA6D;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAGC;IAED,MAAM,IAAI,GAA4B;QACpC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;KAC1D,CAAC;IACF,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,KAAK,EAAE,EAAE,CAAC;QAChE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,KAKC;IAED,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,YAAY,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,KAGC;IAED,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,0BAA0B,OAAO,MAAM,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAgE;IACvG,MAAM,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB,CAAC;AACtE,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAa;IAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,IAA0B,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAA2B;IACtG,MAAM,IAAI,GAAG,wBAAwB,CAAC;QACpC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAA8B;IAC5G,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,wBAAwB,CAAC;IAEtC,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAA2B;IACtG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,aAAa,EAAE;QACzD,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,GAAkB,EAAE,MAAc,EAAE,KAAsC;IAC5H,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,aAAa,EAAE;QACxD,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;KACzD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3F,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAkB,EAAE,MAAc,EAAE,KAAgC;IAChH,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,kBAAkB,EAAE;QACnE,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,mBAAmB,EAAE,KAAK,CAAC,wBAAwB;QACnD,wBAAwB,EAAE,KAAK,CAAC,6BAA6B;KAC9D,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,gBAAgB,EAAE;QAC/D,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;YACpD,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,YAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3F,YAAY,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,uBAAuB,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACrG,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,QAAQ,GACZ,CAAC,YAAY,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACpI,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/tool-descriptions.d.ts

@@ -4,8 +4,8 @@
 export declare const PING_DESCRIPTION = "Health check: returns \"pong\" if the MCP process is running. No API calls. Example: invoke with empty input {}.";
 export declare const WHOAMI_DESCRIPTION = "Returns the current Fuul dashboard user as JSON from GET /api/v1/auth/user. Requires prior CLI login (tokens in ~/.fuul/tokens.json). Example: {} after `npm run cli -- login`.";
 export declare const LIST_CHAINS_DESCRIPTION = "Lists supported blockchain chains from GET /public-api/v1/metadata/chains. Uses server metadata (not a hardcoded catalog); responses are cached with ETag/Cache-Control. Each chain includes snake_case fields such as chain_id, is_testnet, optional svm_network and webapp_capabilities, and can_be_used_for_payouts (boolean: true where Fuul reward/payout infra is deployed). Params: none (pass {}). Pagination: not exposed by this tool until the API adds cursor/limit.";
-export declare const LIST_TRIGGER_TYPES_DESCRIPTION = "Lists trigger type metadata from GET /public-api/v1/metadata/trigger-types (cached). Use ids from this response when building programs/triggers. Params: {}.";
-export declare const LIST_PAYOUT_SCHEMAS_DESCRIPTION = "Lists payout schema metadata from GET /public-api/v1/metadata/payout-schemas (cached). Params: {}.";
+export declare const LIST_TRIGGER_TYPES_DESCRIPTION: string;
+export declare const LIST_PAYOUT_SCHEMAS_DESCRIPTION: string;
 export declare const LIST_PROJECTS_DESCRIPTION = "Lists dashboard projects for the current user: GET /api/v1/projects with optional ?page= (1-based) and ?query=. Example: {\"page\":1} or {\"query\":\"acme\"}.";
 export declare const GET_PROJECT_DESCRIPTION: string;
 export declare const LIST_INCENTIVES_DESCRIPTION: string;
@@ -14,6 +14,11 @@ export declare const GET_TRIGGER_DESCRIPTION: string;
 export declare const UPDATE_PAYOUT_TERM_DESCRIPTION: string;
 export declare const UPDATE_PROJECT_TIER_DESCRIPTION: string;
 export declare const UPDATE_AUDIENCE_DESCRIPTION: string;
+export declare const CREATE_TRIGGER_DESCRIPTION: string;
+export declare const DELETE_TRIGGER_DESCRIPTION: string;
+export declare const CREATE_INCENTIVE_DESCRIPTION: string;
+export declare const DELETE_CONVERSION_DESCRIPTION: string;
+export declare const DELETE_INCENTIVE_DESCRIPTION: string;
 export declare const UPDATE_TRIGGER_DESCRIPTION: string;
 export declare const LIST_PAYOUTS_PENDING_APPROVAL_DESCRIPTION = "Lists payouts pending approval: GET /api/v1/projects/:projectId/payouts/pending-approval. Optional page, page_size. Example: {\"project_id\":\"<uuid>\",\"page\":1,\"page_size\":50}.";
 export declare const LIST_REWARDS_PAYOUTS_DESCRIPTION = "Lists rewards payouts history: GET /api/v1/projects/:projectId/payouts/rewards-payouts. Optional page, page_size, status, from_date, to_date. Example: {\"project_id\":\"<uuid>\",\"page\":1}.";
@@ -28,7 +33,9 @@ export declare const UPDATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION: string;
 export declare const SEND_EVENT_DESCRIPTION: string;
 export declare const SEND_BATCH_EVENTS_DESCRIPTION: string;
 export declare const CHECK_EVENT_STATUS_DESCRIPTION: string;
+export declare const GET_USER_REFERRER_DESCRIPTION: string;
 export declare const UPDATE_USER_REFERRER_DESCRIPTION: string;
+export declare const USE_REFERRAL_CODE_DESCRIPTION: string;
 export declare const REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION: string;
 export declare const SWAP_USER_REFERRAL_CODE_DESCRIPTION: string;
 //# sourceMappingURL=tool-descriptions.d.ts.map

package/dist/tools/tool-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,qHAAmH,CAAC;AAEjJ,eAAO,MAAM,kBAAkB,oLACoJ,CAAC;AAEpL,eAAO,MAAM,uBAAuB,qdACgb,CAAC;AAErd,eAAO,MAAM,8BAA8B,iKACqH,CAAC;AAEjK,eAAO,MAAM,+BAA+B,uGAAuG,CAAC;AAEpJ,eAAO,MAAM,yBAAyB,mKACsH,CAAC;AAE7J,eAAO,MAAM,uBAAuB,QAK+B,CAAC;AAEpE,eAAO,MAAM,2BAA2B,QAGH,CAAC;AAEtC,eAAO,MAAM,yBAAyB,QAGwB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,QAGuB,CAAC;AAE5D,eAAO,MAAM,8BAA8B,QAKwF,CAAC;AAEpI,eAAO,MAAM,+BAA+B,QAEyF,CAAC;AAEtI,eAAO,MAAM,2BAA2B,QAEgF,CAAC;AAEzH,eAAO,MAAM,0BAA0B,QAEgE,CAAC;AAExG,eAAO,MAAM,yCAAyC,0LAC2H,CAAC;AAElL,eAAO,MAAM,gCAAgC,mMAC+I,CAAC;AAE7L,eAAO,MAAM,2BAA2B,oQACiN,CAAC;AAE1P,eAAO,MAAM,0BAA0B,2GAA2G,CAAC;AAInJ,eAAO,MAAM,sCAAsC,QAKlC,CAAC;AAElB,eAAO,MAAM,6CAA6C,QAIzC,CAAC;AAElB,eAAO,MAAM,4CAA4C,QAIxC,CAAC;AAKlB,eAAO,MAAM,wCAAwC,QAGuC,CAAC;AAE7F,eAAO,MAAM,2CAA2C,QAG6G,CAAC;AAEtK,eAAO,MAAM,2CAA2C,QAG0D,CAAC;AAKnH,eAAO,MAAM,sBAAsB,QAY2G,CAAC;AAE/I,eAAO,MAAM,6BAA6B,QASsH,CAAC;AAEjK,eAAO,MAAM,8BAA8B,QAQsC,CAAC;AAElF,eAAO,MAAM,gCAAgC,QAG8O,CAAC;AAE5R,eAAO,MAAM,0CAA0C,QAGiL,CAAC;AAEzO,eAAO,MAAM,mCAAmC,QAGgT,CAAC"}
+{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,qHAAmH,CAAC;AAEjJ,eAAO,MAAM,kBAAkB,oLACoJ,CAAC;AAEpL,eAAO,MAAM,uBAAuB,qdACgb,CAAC;AAErd,eAAO,MAAM,8BAA8B,QAIY,CAAC;AAExD,eAAO,MAAM,+BAA+B,QAG6F,CAAC;AAE1I,eAAO,MAAM,yBAAyB,mKACsH,CAAC;AAE7J,eAAO,MAAM,uBAAuB,QAK+B,CAAC;AAEpE,eAAO,MAAM,2BAA2B,QAGH,CAAC;AAEtC,eAAO,MAAM,yBAAyB,QAGwB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,QAGuB,CAAC;AAE5D,eAAO,MAAM,8BAA8B,QAKwF,CAAC;AAEpI,eAAO,MAAM,+BAA+B,QAEyF,CAAC;AAEtI,eAAO,MAAM,2BAA2B,QAEgF,CAAC;AAEzH,eAAO,MAAM,0BAA0B,QAQyK,CAAC;AAWjN,eAAO,MAAM,0BAA0B,QAKsE,CAAC;AAE9G,eAAO,MAAM,4BAA4B,QAMgE,CAAC;AAE1G,eAAO,MAAM,6BAA6B,QAG4F,CAAC;AAEvI,eAAO,MAAM,4BAA4B,QAG8D,CAAC;AAExG,eAAO,MAAM,0BAA0B,QAOwF,CAAC;AAEhI,eAAO,MAAM,yCAAyC,0LAC2H,CAAC;AAElL,eAAO,MAAM,gCAAgC,mMAC+I,CAAC;AAE7L,eAAO,MAAM,2BAA2B,oQACiN,CAAC;AAE1P,eAAO,MAAM,0BAA0B,2GAA2G,CAAC;AAInJ,eAAO,MAAM,sCAAsC,QAKlC,CAAC;AAElB,eAAO,MAAM,6CAA6C,QAIzC,CAAC;AAElB,eAAO,MAAM,4CAA4C,QAIxC,CAAC;AAKlB,eAAO,MAAM,wCAAwC,QAGuC,CAAC;AAE7F,eAAO,MAAM,2CAA2C,QAG6G,CAAC;AAEtK,eAAO,MAAM,2CAA2C,QAG0D,CAAC;AAKnH,eAAO,MAAM,sBAAsB,QAY2G,CAAC;AAE/I,eAAO,MAAM,6BAA6B,QASsH,CAAC;AAEjK,eAAO,MAAM,8BAA8B,QAQsC,CAAC;AAElF,eAAO,MAAM,6BAA6B,QAGyC,CAAC;AAEpF,eAAO,MAAM,gCAAgC,QAG+J,CAAC;AAE7M,eAAO,MAAM,6BAA6B,QAGoH,CAAC;AAE/J,eAAO,MAAM,0CAA0C,QAGiL,CAAC;AAEzO,eAAO,MAAM,mCAAmC,QAG6N,CAAC"}

package/dist/tools/tool-descriptions.js

@@ -4,8 +4,13 @@
 export const PING_DESCRIPTION = 'Health check: returns "pong" if the MCP process is running. No API calls. Example: invoke with empty input {}.';
 export const WHOAMI_DESCRIPTION = 'Returns the current Fuul dashboard user as JSON from GET /api/v1/auth/user. Requires prior CLI login (tokens in ~/.fuul/tokens.json). Example: {} after `npm run cli -- login`.';
 export const LIST_CHAINS_DESCRIPTION = 'Lists supported blockchain chains from GET /public-api/v1/metadata/chains. Uses server metadata (not a hardcoded catalog); responses are cached with ETag/Cache-Control. Each chain includes snake_case fields such as chain_id, is_testnet, optional svm_network and webapp_capabilities, and can_be_used_for_payouts (boolean: true where Fuul reward/payout infra is deployed). Params: none (pass {}). Pagination: not exposed by this tool until the API adds cursor/limit.';
-export const LIST_TRIGGER_TYPES_DESCRIPTION = 'Lists trigger type metadata from GET /public-api/v1/metadata/trigger-types (cached). Use ids from this response when building programs/triggers. Params: {}.';
-export const LIST_PAYOUT_SCHEMAS_DESCRIPTION = 'Lists payout schema metadata from GET /public-api/v1/metadata/payout-schemas (cached). Params: {}.';
+export const LIST_TRIGGER_TYPES_DESCRIPTION = 'Lists trigger type metadata from GET /public-api/v1/metadata/trigger-types (cached), enriched for create_trigger. ' +
+    'Each trigger_types[] row includes: context_json_schema (field definitions), create_payload_layout (flat_dto | context_only | context_and_root_fields), create_payload_notes, and create_payload_example when available. ' +
+    'Top-level create_trigger_payload_guide explains the three layouts (same as fuul-webapp encode.ts). ' +
+    'Always call this before create_trigger. Params: {}.';
+export const LIST_PAYOUT_SCHEMAS_DESCRIPTION = 'Lists payout schema metadata from GET /public-api/v1/metadata/payout-schemas (cached), enriched for create_incentive. ' +
+    'Includes enums, payout_term_dto.schemes (per PayoutScheme), plus reward_types[] with create_payload_example for: fixed-reward, variable-reward, proportional-pool, leaderboard. ' +
+    'Top-level create_incentive_payload_guide documents body shape and webapp encode.ts mappers. Call before create_incentive. Params: {}.';
 export const LIST_PROJECTS_DESCRIPTION = 'Lists dashboard projects for the current user: GET /api/v1/projects with optional ?page= (1-based) and ?query=. Example: {"page":1} or {"query":"acme"}.';
 export const GET_PROJECT_DESCRIPTION = 'Loads one project (draft + published trigger mapping). Calls GET /api/v1/projects/:projectId and GET /api/v1/projects/:projectId/customizations in parallel. ' +
     'Replaces triggers[] with scoped rows: ref, signature, draft_trigger_id, published_trigger_id, draft, published. ' +
@@ -30,8 +35,45 @@ export const UPDATE_PROJECT_TIER_DESCRIPTION = 'Updates a project affiliate tier
     'At least one field required. dry_run then confirmed. Example: {"project_id":"<uuid>","tier_id":"<uuid>","rank":2,"dry_run":true}.';
 export const UPDATE_AUDIENCE_DESCRIPTION = 'Updates an audience (user list): PATCH /api/v1/projects/:projectId/audiences/:audienceId. Body matches CreateOrUpdateAudienceDto: name (required), optional conditions[] (signature + parameters), condition_match_mode "any"|"all" (required if conditions non-empty), contractId. ' +
     'dry_run then confirmed. Example dry_run: {"project_id":"<uuid>","audience_id":"<uuid>","name":"VIP","dry_run":true}.';
+export const CREATE_TRIGGER_DESCRIPTION = 'Creates a draft trigger: POST /api/v1/projects/:projectId/triggers. Body matches CreateTriggerDto (fuul-webapp triggersService.create / encodeByTriggerType). ' +
+    'REQUIRED: call list_trigger_types first; use trigger_types[].id as trigger.type and follow create_payload_layout for that id. ' +
+    'Layouts: (1) flat_dto — types custom/classic: put context_json_schema fields at trigger ROOT (signature, event_type, expressions, payable, end_user_identifier_property, contract_ids), NOT nested only in context. ' +
+    '(2) context_only — token-holder, liquidity-pool-v2: fields only under trigger.context. ' +
+    '(3) context_and_root_fields — most presets: fields under trigger.context plus end_user_identifier_property at root when needed. ' +
+    'Use create_payload_example from list_trigger_types when present. Call list_chains for chain_id. dry_run then confirmed. ' +
+    'Token-holder: {"name":"...","description":"...","type":"token-holder","context":{"token_address":"0x...","chain_id":1,"volume_currency_expression":"0x..."}}. ' +
+    'Custom off-chain: {"name":"...","description":"...","type":"custom","signature":"event_name","event_type":"off-chain-event","end_user_identifier_property":"address","payable":true,...expressions at root}.';
+const REPLACE_TRIGGER_TOKEN_FLOW = 'Replace-trigger flow (token/chain change; after telling the user update_trigger cannot change token_address/chain_id): ' +
+    '(1) get_project or list_incentives — list every incentive/conversion whose triggers[] includes this draft_trigger_id; ' +
+    '(2) delete_conversion for each draft_conversion_id (removes conversion + trigger links); ' +
+    '(3) delete_trigger; ' +
+    '(4) create_trigger with the new context; ' +
+    '(5) create_incentive if the program must be recreated. ' +
+    'Do not call delete_trigger until step 2 is done for all linked conversions.';
+export const DELETE_TRIGGER_DESCRIPTION = 'Deletes a draft trigger: DELETE /api/v1/projects/:projectId/triggers/:triggerId. Use draft_trigger_id from get_project. ' +
+    'Requires dry_run then confirmed. Never call without explicit user approval. ' +
+    'Mandatory pre-check: call get_project or list_incentives and find every conversion (draft_conversion_id) linked to this draft_trigger_id. ' +
+    REPLACE_TRIGGER_TOKEN_FLOW +
+    ' If delete still returns HTTP 422, report remaining links and stop — do not retry delete_trigger blindly.';
+export const CREATE_INCENTIVE_DESCRIPTION = 'Creates a draft incentive (conversion): POST /api/v1/projects/:projectId/incentives. Body: name, trigger_ids[] (draft_trigger_id), payout_terms[] (PayoutTermDto, min 1 each). ' +
+    'REQUIRED: list_payout_schemas first — pick reward_types[].id (fixed-reward | variable-reward | proportional-pool | leaderboard) and use create_payload_example. ' +
+    'Schemes on wire: pay-per-attribution (fixed/variable), pool, rank. type: point | onchain-currency. payee_type: affiliate | end-user | both. ' +
+    'Fixed: calculation_strategy fixed, referrer_amount/referral_amount. Variable: calculation_strategy variable, trigger_amount_source, base_currency, *_amount_percentage. ' +
+    'Pool: scheme pool, amount_source, pool_amount, pool_duration, pool_calculation_day_cron. Leaderboard: scheme rank, rank_scheme_config.ranks, pool window fields. ' +
+    'MCP normalizes variable terms (referral_amount → referral_amount_percentage). dry_run then confirmed.';
+export const DELETE_CONVERSION_DESCRIPTION = 'Deletes a draft conversion (incentive): DELETE /api/v1/projects/:projectId/incentives/:conversionId. Use draft_conversion_id from list_incentives or get_project conversions[]. ' +
+    'Soft-deletes the conversion, its payout terms, and conversion_triggers links so delete_trigger can succeed. dry_run then confirmed. ' +
+    'Required before delete_trigger when replacing a trigger (token/chain change). Prefer this tool over delete_incentive in that flow.';
+export const DELETE_INCENTIVE_DESCRIPTION = 'Deletes a draft incentive (conversion): DELETE /api/v1/projects/:projectId/incentives/:conversionId. Same API as delete_conversion. ' +
+    'Use draft_conversion_id from list_incentives or get_project conversions[]. dry_run then confirmed. ' +
+    'When replacing a trigger, use delete_conversion (step 2 of the replace flow) before delete_trigger.';
 export const UPDATE_TRIGGER_DESCRIPTION = 'Updates a trigger: PATCH /api/v1/projects/:projectId/triggers/:triggerId. Partial body matching UpdateTriggerDto (name, description, event_type, expressions, payable, ref, contract_ids as single-element array, etc.). ' +
-    'At least one patch field required. dry_run then confirmed. Use get_trigger first for current state.';
+    'Does NOT update context fields such as token_address or chain_id — those are immutable after create. ' +
+    'If the user asks to change token_address, chain_id, or the tracked token/contract: do NOT call PATCH. First inform the user clearly: "This cannot be updated in place; you must delete the trigger and create a new one with the new token/chain." ' +
+    'Then, only with explicit user approval, run the replace flow: ' +
+    REPLACE_TRIGGER_TOKEN_FLOW +
+    ' Never skip step 1 — always list linked conversions before delete_trigger. ' +
+    'At least one patch field required for allowed fields only. dry_run then confirmed. Use get_trigger first for current state.';
 export const LIST_PAYOUTS_PENDING_APPROVAL_DESCRIPTION = 'Lists payouts pending approval: GET /api/v1/projects/:projectId/payouts/pending-approval. Optional page, page_size. Example: {"project_id":"<uuid>","page":1,"page_size":50}.';
 export const LIST_REWARDS_PAYOUTS_DESCRIPTION = 'Lists rewards payouts history: GET /api/v1/projects/:projectId/payouts/rewards-payouts. Optional page, page_size, status, from_date, to_date. Example: {"project_id":"<uuid>","page":1}.';
 export const APPROVE_PAYOUTS_DESCRIPTION = 'Approves payouts: PATCH /api/v1/projects/:projectId/payouts/approve. Body: payout_ids OR date filters (server validates mutual exclusivity). dry_run then confirmed. Example dry_run: {"project_id":"<uuid>","payout_ids":["<uuid>"],"dry_run":true}.';
@@ -91,13 +133,19 @@ export const CHECK_EVENT_STATUS_DESCRIPTION = 'Check event ingestion and downstr
     RATE_LIMIT_HINT +
     ' Example status: {"user_identifier":"0x...","user_identifier_type":"evm_address","event_name":"trade"}. ' +
     'Example verbose: {"verbose":true,"dedup_id":"swap-123","event_name":"trade"}.';
-export const UPDATE_USER_REFERRER_DESCRIPTION = 'Create or overwrite a user referrer: PUT /api/v1/user-referrers (idempotent upsert). Sets user_referrers for the project inferred from the API key. Optional referral_code links referral_code_id on the row; does not create referral_code_uses or increment actual_uses. Requires project API key with service_role scope.' +
+export const GET_USER_REFERRER_DESCRIPTION = 'Read a user referrer from user_referrers: GET /api/v1/user/referrer?user_identifier=&user_identifier_type=. Returns referrer_identifier, referrer_code, referrer_codes, referrer_name, referrer_user_rebate_rate (null referrer fields when unassigned). Unlike GET /referral_codes/status, this reflects PUT /user-referrers assignments even without referral_code_uses.' +
     PROJECT_API_KEY_HINT +
-    ' dry_run then confirmed. Example dry_run (reassign KOL, no code): {"user_identifier":"0xUser...","user_identifier_type":"evm_address","referrer_identifier":"0xNewKol...","referrer_identifier_type":"evm_address","dry_run":true}. Example with code: add "referral_code":"PROMO2024".';
+    ' Example: {"user_identifier":"0xUser...","user_identifier_type":"evm_address"}.';
+export const UPDATE_USER_REFERRER_DESCRIPTION = 'Admin override: create or overwrite user_referrers via PUT /api/v1/user-referrers (idempotent upsert). Sets source=project_imported; does NOT create referral_code_uses or increment actual_uses (status may stay referred:false). For real code redemption use use_referral_code instead. Requires service_role project API key.' +
+    PROJECT_API_KEY_HINT +
+    ' dry_run then confirmed. Example dry_run: {"user_identifier":"0xUser...","user_identifier_type":"evm_address","referrer_identifier":"0xKol...","referrer_identifier_type":"evm_address","dry_run":true}.';
+export const USE_REFERRAL_CODE_DESCRIPTION = 'Redeem a referral code for a user: PATCH /api/v1/referral_codes/:code/use. Creates referral_code_uses, increments actual_uses, sets user_referrers with source=code_redemption (GET /referral_codes/status → referred:true). Referrer is the code owner (do not pass referrer_identifier). Requires user has no existing referrer unless service_role idempotent replay of the same code. No wallet signature with service_role.' +
+    PROJECT_API_KEY_HINT +
+    ' dry_run then confirmed. Example dry_run: {"referral_code":"PROMO2024","user_identifier":"0xUser...","user_identifier_type":"evm_address","dry_run":true}.';
 export const REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION = 'Remove a user from a referral code: DELETE /api/v1/referral_codes/:code/referrals. Atomically deletes user_referrers + referral_code_uses and decrements actual_uses. Not idempotent on the API; this tool maps known 422 cases to {"already_removed":true,"reason":"..."} for safe retries. Requires service_role project API key (no wallet signature).' +
     PROJECT_API_KEY_HINT +
     ' dry_run then confirmed. Example dry_run: {"referral_code":"PROMO2024","user_identifier":"0xUser...","user_identifier_type":"evm_address","referrer_identifier":"0xKol...","referrer_identifier_type":"evm_address","dry_run":true}.';
-export const SWAP_USER_REFERRAL_CODE_DESCRIPTION = 'Swap a user from one referral code to another referrer/code: DELETE from from_referral_code then PUT /api/v1/user-referrers (not a single atomic API transaction). Step 1 tolerates already-removed 422s. If PUT fails after DELETE, response includes partial:true with remove result and assign_error. Requires service_role project API key.' +
+export const SWAP_USER_REFERRAL_CODE_DESCRIPTION = 'Move a user between referral codes with full redemption semantics: DELETE from from_referral_code then PATCH /api/v1/referral_codes/:to_referral_code/use (not atomic). Step 1 tolerates already-removed 422s (e.g. user never had a prior code). Step 2 assigns to the owner of to_referral_code — there are no to_referrer_* params. If PATCH /use fails after DELETE, response has partial:true with use_error; complete with use_referral_code or update_user_referrer. Legacy PUT-only users (user_referrers without referral_code_use) may block step 2 with "User already has a referrer". For first assign with no prior code, use use_referral_code directly. Requires service_role project API key.' +
     PROJECT_API_KEY_HINT +
-    ' dry_run then confirmed. Example dry_run: {"user_identifier":"0xUser...","user_identifier_type":"evm_address","from_referral_code":"OLD","from_referrer_identifier":"0xOldKol...","from_referrer_identifier_type":"evm_address","to_referrer_identifier":"0xNewKol...","to_referrer_identifier_type":"evm_address","to_referral_code":"NEW","dry_run":true}.';
+    ' dry_run then confirmed. Example dry_run: {"user_identifier":"0xUser...","user_identifier_type":"evm_address","from_referral_code":"OLD","from_referrer_identifier":"0xOldKol...","from_referrer_identifier_type":"evm_address","to_referral_code":"NEW","dry_run":true}.';
 //# sourceMappingURL=tool-descriptions.js.map

package/dist/tools/tool-descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-schemas.d.ts

@@ -420,6 +420,169 @@ export declare const updateTriggerInputSchema: z.ZodEffects<z.ZodObject<{
     contract_ids?: string[] | undefined;
 }>;
 export type UpdateTriggerInput = z.infer<typeof updateTriggerInputSchema>;
+/** POST body matches fuul-server CreateTriggerDto (same shape as fuul-webapp triggersService.create). */
+export declare const createTriggerFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export declare const createTriggerInputSchema: z.ZodEffects<z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    trigger: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export type CreateTriggerInput = z.infer<typeof createTriggerInputSchema>;
+export declare const deleteTriggerFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export declare const deleteTriggerInputSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export type DeleteTriggerInput = z.infer<typeof deleteTriggerInputSchema>;
+export declare const createIncentiveFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    name: z.ZodString;
+    trigger_ids: z.ZodArray<z.ZodString, "many">;
+    payout_terms: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    name: string;
+    trigger_ids: string[];
+    payout_terms: Record<string, unknown>[];
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    name: string;
+    trigger_ids: string[];
+    payout_terms: Record<string, unknown>[];
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export declare const createIncentiveInputSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    name: z.ZodString;
+    trigger_ids: z.ZodArray<z.ZodString, "many">;
+    payout_terms: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    name: string;
+    trigger_ids: string[];
+    payout_terms: Record<string, unknown>[];
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    name: string;
+    trigger_ids: string[];
+    payout_terms: Record<string, unknown>[];
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export type CreateIncentiveInput = z.infer<typeof createIncentiveInputSchema>;
+export declare const deleteIncentiveFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    conversion_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    conversion_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    conversion_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export declare const deleteIncentiveInputSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    conversion_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    conversion_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    conversion_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
+export type DeleteIncentiveInput = z.infer<typeof deleteIncentiveInputSchema>;
 export declare const listPayoutsPendingApprovalSchema: z.ZodObject<{
     project_id: z.ZodString;
     page: z.ZodOptional<z.ZodNumber>;
@@ -3782,6 +3945,84 @@ export declare const removeUserFromReferralCodeInputSchema: z.ZodObject<{
     project_api_key?: string | undefined;
 }>;
 export type RemoveUserFromReferralCodeInput = z.infer<typeof removeUserFromReferralCodeInputSchema>;
+export declare const getUserReferrerFieldsSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    project_api_key?: string | undefined;
+}>;
+export declare const getUserReferrerInputSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    project_api_key?: string | undefined;
+}>;
+export type GetUserReferrerInput = z.infer<typeof getUserReferrerInputSchema>;
+export declare const useReferralCodeFieldsSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    referral_code: z.ZodString;
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}>;
+export declare const useReferralCodeInputSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    referral_code: z.ZodString;
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}>;
+export type UseReferralCodeInput = z.infer<typeof useReferralCodeInputSchema>;
 export declare const swapUserReferralCodeFieldsSchema: z.ZodObject<{
     project_api_key: z.ZodOptional<z.ZodString>;
 } & {
@@ -3793,33 +4034,27 @@ export declare const swapUserReferralCodeFieldsSchema: z.ZodObject<{
     from_referral_code: z.ZodString;
     from_referrer_identifier: z.ZodString;
     from_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
-    to_referrer_identifier: z.ZodString;
-    to_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
-    to_referral_code: z.ZodOptional<z.ZodString>;
+    to_referral_code: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }>;
 export declare const swapUserReferralCodeInputSchema: z.ZodEffects<z.ZodObject<{
     project_api_key: z.ZodOptional<z.ZodString>;
@@ -3832,57 +4067,47 @@ export declare const swapUserReferralCodeInputSchema: z.ZodEffects<z.ZodObject<{
     from_referral_code: z.ZodString;
     from_referrer_identifier: z.ZodString;
     from_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
-    to_referrer_identifier: z.ZodString;
-    to_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
-    to_referral_code: z.ZodOptional<z.ZodString>;
+    to_referral_code: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }>, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }, {
     user_identifier: string;
     user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
     from_referral_code: string;
     from_referrer_identifier: string;
     from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
-    to_referrer_identifier: string;
-    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referral_code: string;
     dry_run?: boolean | undefined;
     confirmed?: boolean | undefined;
     project_api_key?: string | undefined;
-    to_referral_code?: string | undefined;
 }>;
 export type SwapUserReferralCodeInput = z.infer<typeof swapUserReferralCodeInputSchema>;
 //# sourceMappingURL=tool-schemas.d.ts.map