@fuul/mcp-server 1.7.0 → 1.9.0

package/dist/triggers/trigger-create-payload-guide.js

@@ -0,0 +1,171 @@
+/**
+ * Maps list_trigger_types `id` values to POST /triggers body shape.
+ * Aligned with fuul-webapp `encodeByTriggerType` / `encode.ts` and fuul-server
+ * `CreateTriggerCommand.parseTriggerContext`.
+ */
+/** Server copies the whole DTO into stored context (fields must be at trigger root, not only in context). */
+const FLAT_DTO_TRIGGER_TYPES = new Set(['custom', 'classic']);
+/** Preset types: type-specific fields live only under trigger.context (no root identifier fields). */
+const CONTEXT_ONLY_TRIGGER_TYPES = new Set(['token-holder', 'liquidity-pool-v2']);
+export const CREATE_TRIGGER_GLOBAL_GUIDE = {
+    endpoint: 'POST /api/v1/projects/:projectId/triggers',
+    always_required: ['name', 'description', 'type'],
+    type_field: 'Set trigger.type to the trigger_types[].id from list_trigger_types (e.g. "token-holder", "custom", "hibachi-trading").',
+    layouts: {
+        flat_dto: {
+            applies_to: [...FLAT_DTO_TRIGGER_TYPES],
+            rule: 'Put every field from context_json_schema on the trigger object ROOT (siblings of name, description, type). ' +
+                'Do NOT nest signature, event_type, or expressions only inside trigger.context — the API validates them at the root. ' +
+                'The server persists them as trigger context internally.',
+        },
+        context_only: {
+            applies_to: [...CONTEXT_ONLY_TRIGGER_TYPES],
+            rule: 'Put type-specific fields under trigger.context only. Required: name, description, type, and context per context_json_schema.',
+        },
+        context_and_root_fields: {
+            applies_to: 'All other trigger type ids (protocol presets, liquidity v3, social, trading, etc.).',
+            rule: 'Put type-specific fields under trigger.context per context_json_schema. ' +
+                'Also set end_user_identifier_property (and end_user_identifier_expression when needed) at the trigger ROOT when the schema or webapp form requires it.',
+        },
+    },
+    workflow: [
+        'Call list_trigger_types and read create_payload_layout + create_payload_example for the chosen id.',
+        'Call list_chains when the trigger needs chain_id.',
+        'Build trigger object; use create_trigger with dry_run then confirmed.',
+    ],
+    reference: 'fuul-webapp src/modules/triggers/infra/encode.ts (encodeByTriggerType)',
+};
+/** Minimal create_trigger.trigger examples (dashboard-aligned). */
+export const CREATE_PAYLOAD_EXAMPLES = {
+    'token-holder': {
+        name: 'Hold TOKEN',
+        description: 'Daily holding of TOKEN on Ethereum',
+        type: 'token-holder',
+        context: {
+            token_address: '0x0000000000000000000000000000000000000000',
+            chain_id: 1,
+            volume_currency_expression: '0x0000000000000000000000000000000000000000',
+        },
+    },
+    custom: {
+        name: 'My off-chain event',
+        description: 'Tracks a custom SDK / off-chain event',
+        type: 'custom',
+        signature: 'my_event_name',
+        event_type: 'off-chain-event',
+        end_user_identifier_property: 'address',
+        payable: true,
+        volume_expression: 'extractedValueAmount',
+        revenue_expression: 'extractedRevenueAmount',
+        currency_expression: 'extractedVolumeCurrencyAddress',
+        volume_currency_expression: 'extractedVolumeCurrencyAddress',
+        revenue_currency_expression: 'extractedRevenueCurrencyAddress',
+    },
+    'hibachi-trading': {
+        name: 'Hibachi Trades',
+        description: 'Trades from Hibachi platform',
+        type: 'hibachi-trading',
+        context: { chainId: 8453 },
+        end_user_identifier_property: 'address',
+        end_user_identifier_expression: null,
+    },
+    'hibachi-affiliate-referred-fees': {
+        name: 'Hibachi Affiliates - Base - Level1',
+        description: 'Hibachi affiliate referred fees',
+        type: 'hibachi-affiliate-referred-fees',
+        context: { chainId: 8453, referredFeesLevel: 'level1' },
+        end_user_identifier_property: 'address',
+        end_user_identifier_expression: null,
+    },
+    'follow-on-x': {
+        name: 'Follow @handle on X',
+        description: 'Follow on X',
+        type: 'follow-on-x',
+        context: { usernameToFollow: 'handle' },
+        end_user_identifier_property: 'twitter_username',
+        end_user_identifier_expression: null,
+    },
+    'liquidity-pool-v2': {
+        name: 'Hold TOKEN - Ethereum',
+        description: 'Daily holding on Ethereum',
+        type: 'liquidity-pool-v2',
+        context: {
+            token_address: '0x0000000000000000000000000000000000000000',
+            chain_id: 1,
+            volume_currency_expression: '0x0000000000000000000000000000000000000000',
+        },
+    },
+    'uniswap-liquidity-v3': {
+        name: 'Uniswap WETH-USDC',
+        description: 'Deposit into WETH-USDC pool on Uniswap',
+        type: 'uniswap-liquidity-v3',
+        context: {
+            liquidityPoolId: '<pool-uuid>',
+            strategy: 'ActiveLiquidity',
+            activeLiquidityArgs: { tokenDenominator: 'token0' },
+        },
+        end_user_identifier_property: 'address',
+        end_user_identifier_expression: null,
+    },
+    'solana-token-holder': {
+        name: 'Hold TOKEN - Solana',
+        description: 'Daily holding of Solana token',
+        type: 'solana-token-holder',
+        context: {
+            token_address: '<mint-address>',
+            volume_currency_expression: '<optional-mint-or-price-ref>',
+            chain_identifier: '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+        },
+        end_user_identifier_property: 'address',
+        end_user_identifier_expression: null,
+    },
+};
+export function getCreatePayloadLayout(triggerTypeId) {
+    if (FLAT_DTO_TRIGGER_TYPES.has(triggerTypeId)) {
+        return 'flat_dto';
+    }
+    if (CONTEXT_ONLY_TRIGGER_TYPES.has(triggerTypeId)) {
+        return 'context_only';
+    }
+    return 'context_and_root_fields';
+}
+export function getCreatePayloadNotes(layout) {
+    switch (layout) {
+        case 'flat_dto':
+            return CREATE_TRIGGER_GLOBAL_GUIDE.layouts.flat_dto.rule;
+        case 'context_only':
+            return CREATE_TRIGGER_GLOBAL_GUIDE.layouts.context_only.rule;
+        case 'context_and_root_fields':
+            return CREATE_TRIGGER_GLOBAL_GUIDE.layouts.context_and_root_fields.rule;
+    }
+}
+export function enrichTriggerTypesResponse(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return raw;
+    }
+    const payload = raw;
+    if (!Array.isArray(payload.trigger_types)) {
+        return raw;
+    }
+    const trigger_types = payload.trigger_types.map((row) => {
+        if (!row || typeof row !== 'object') {
+            return row;
+        }
+        const typed = row;
+        const id = typeof typed.id === 'string' ? typed.id : '';
+        const layout = id ? getCreatePayloadLayout(id) : 'context_and_root_fields';
+        const example = id ? CREATE_PAYLOAD_EXAMPLES[id] : undefined;
+        return {
+            ...typed,
+            create_payload_layout: layout,
+            create_payload_notes: getCreatePayloadNotes(layout),
+            ...(example ? { create_payload_example: example } : {}),
+        };
+    });
+    return {
+        ...payload,
+        create_trigger_payload_guide: CREATE_TRIGGER_GLOBAL_GUIDE,
+        trigger_types,
+    };
+}
+//# sourceMappingURL=trigger-create-payload-guide.js.map

package/dist/triggers/trigger-create-payload-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-create-payload-guide.js","sourceRoot":"","sources":["../../src/triggers/trigger-create-payload-guide.ts"],"names":[],"mappings":"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"}

package/dist/triggers/trigger-write-handlers.d.ts

@@ -0,0 +1,5 @@
+import { type FuulApiClient } from '../http/fuul-api-client.js';
+import type { CreateTriggerInput, DeleteTriggerInput } from '../tools/tool-schemas.js';
+export declare function runCreateTrigger(api: FuulApiClient, input: CreateTriggerInput): Promise<unknown>;
+export declare function runDeleteTrigger(api: FuulApiClient, input: DeleteTriggerInput): Promise<unknown>;
+//# sourceMappingURL=trigger-write-handlers.d.ts.map

package/dist/triggers/trigger-write-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-write-handlers.d.ts","sourceRoot":"","sources":["../../src/triggers/trigger-write-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOvF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CActG;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBtG"}

package/dist/triggers/trigger-write-handlers.js

@@ -0,0 +1,38 @@
+import { assertWriteConfirmedOrDryRun } from '../agent/write-confirmation.js';
+import { ApiRequestError } from '../http/fuul-api-client.js';
+const TRIGGER_IN_USE_HINT = 'This trigger is linked to one or more incentives. Delete those incentives first with delete_incentive ' +
+    '(use list_incentives to find draft_conversion_id), or create a replacement trigger with create_trigger ' +
+    'without deleting the old one. Never delete a trigger without explicit user confirmation.';
+export async function runCreateTrigger(api, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const path = `/api/v1/projects/${input.project_id}/triggers`;
+    const body = input.trigger;
+    if (input.dry_run === true) {
+        return {
+            dry_run: true,
+            would_post: path,
+            body,
+        };
+    }
+    return api.postJson(path, body);
+}
+export async function runDeleteTrigger(api, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const path = `/api/v1/projects/${input.project_id}/triggers/${input.trigger_id}`;
+    if (input.dry_run === true) {
+        return {
+            dry_run: true,
+            would_delete: path,
+        };
+    }
+    try {
+        return await api.deleteJson(path);
+    }
+    catch (e) {
+        if (e instanceof ApiRequestError && e.status === 422) {
+            throw new Error(`${e.message} ${TRIGGER_IN_USE_HINT}`);
+        }
+        throw e;
+    }
+}
+//# sourceMappingURL=trigger-write-handlers.js.map

package/dist/triggers/trigger-write-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-write-handlers.js","sourceRoot":"","sources":["../../src/triggers/trigger-write-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAsB,MAAM,4BAA4B,CAAC;AAGjF,MAAM,mBAAmB,GACvB,wGAAwG;IACxG,yGAAyG;IACzG,0FAA0F,CAAC;AAE7F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAkB,EAAE,KAAyB;IAClF,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,WAAW,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;IAE3B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,IAAI;SACL,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAkB,EAAE,KAAyB;IAClF,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,aAAa,KAAK,CAAC,UAAU,EAAE,CAAC;IAEjF,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuul/mcp-server",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Fuul MCP server for program management via MCP-compatible clients",
   "keywords": [
     "Fuul",