@fuul/mcp-server 1.10.0 → 1.12.0

package/dist/currencies/currency-handlers.d.ts

@@ -0,0 +1,6 @@
+import type { FuulApiClient } from '../http/fuul-api-client.js';
+import type { ListPriceReferencesInput, ResolveTokenHolderPriceReferenceInput } from '../tools/tool-schemas.js';
+export declare function runListPriceReferences(api: FuulApiClient, input: ListPriceReferencesInput): Promise<unknown>;
+export declare function runResolveTokenHolderPriceReference(api: FuulApiClient, input: ResolveTokenHolderPriceReferenceInput): Promise<unknown>;
+export declare function enrichPriceReferencesResponse(raw: unknown): unknown;
+//# sourceMappingURL=currency-handlers.d.ts.map

package/dist/currencies/currency-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-handlers.d.ts","sourceRoot":"","sources":["../../src/currencies/currency-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AAOhH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAalH;AAED,wBAAsB,mCAAmC,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,qCAAqC,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB5I;AAeD,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAYnE"}

package/dist/currencies/currency-handlers.js

@@ -0,0 +1,59 @@
+import { TOKEN_HOLDER_PRICE_REFERENCE_GUIDE } from '../triggers/price-reference-guide.js';
+import { fetchPriceReferences } from './fetch-price-references.js';
+import { chainIdentifierFromChainId, resolveTokenHolderPriceReference } from './resolve-token-holder-price-reference.js';
+const CURRENCIES_PATH = '/api/v1/currencies';
+export async function runListPriceReferences(api, input) {
+    const query = {
+        price_reference: true,
+        page: 1,
+        page_size: 100,
+    };
+    if (input.chain_identifier != null && input.chain_identifier !== '') {
+        query.chain_identifier = input.chain_identifier;
+    }
+    const data = await api.getJson(CURRENCIES_PATH, { query });
+    return enrichPriceReferencesResponse(data);
+}
+export async function runResolveTokenHolderPriceReference(api, input) {
+    const chainIdentifier = resolveChainIdentifier(input);
+    const priceReferences = await fetchPriceReferences(api, chainIdentifier);
+    const result = resolveTokenHolderPriceReference({
+        token_address: input.token_address,
+        chain_identifier: chainIdentifier,
+        token_kind: input.token_kind,
+        decimals: input.decimals,
+    }, priceReferences);
+    return {
+        ...result,
+        next_step: result.status === 'needs_user_input'
+            ? 'Ask the user the questions_for_user, then call resolve_token_holder_price_reference again with token_kind and decimals before create_trigger.'
+            : result.status === 'resolved' || result.status === 'listed_use_same_address'
+                ? `Set trigger.context.volume_currency_expression to ${result.volume_currency_expression}, then create_trigger (dry_run then confirmed).`
+                : 'Review matching_references_by_decimals or contact Fuul support.',
+    };
+}
+function resolveChainIdentifier(input) {
+    if (input.chain_identifier != null && input.chain_identifier !== '') {
+        return input.chain_identifier;
+    }
+    if (input.chain_id != null) {
+        const mapped = chainIdentifierFromChainId(input.chain_id);
+        if (mapped) {
+            return mapped;
+        }
+    }
+    throw new Error('Provide chain_identifier (e.g. "ethereum") or a supported chain_id (e.g. 1).');
+}
+export function enrichPriceReferencesResponse(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return {
+            results: [],
+            token_holder_price_reference_guide: TOKEN_HOLDER_PRICE_REFERENCE_GUIDE,
+        };
+    }
+    return {
+        ...raw,
+        token_holder_price_reference_guide: TOKEN_HOLDER_PRICE_REFERENCE_GUIDE,
+    };
+}
+//# sourceMappingURL=currency-handlers.js.map

package/dist/currencies/currency-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-handlers.js","sourceRoot":"","sources":["../../src/currencies/currency-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAEzH,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAkB,EAAE,KAA+B;IAC9F,MAAM,KAAK,GAA4B;QACrC,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,CAAC;QACP,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,IAAI,KAAK,CAAC,gBAAgB,IAAI,IAAI,IAAI,KAAK,CAAC,gBAAgB,KAAK,EAAE,EAAE,CAAC;QACpE,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,OAAO,6BAA6B,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mCAAmC,CAAC,GAAkB,EAAE,KAA4C;IACxH,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,gCAAgC,CAC7C;QACE,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,gBAAgB,EAAE,eAAe;QACjC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,EACD,eAAe,CAChB,CAAC;IAEF,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EACP,MAAM,CAAC,MAAM,KAAK,kBAAkB;YAClC,CAAC,CAAC,+IAA+I;YACjJ,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,yBAAyB;gBAC3E,CAAC,CAAC,qDAAqD,MAAM,CAAC,0BAA0B,iDAAiD;gBACzI,CAAC,CAAC,iEAAiE;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAA4C;IAC1E,IAAI,KAAK,CAAC,gBAAgB,IAAI,IAAI,IAAI,KAAK,CAAC,gBAAgB,KAAK,EAAE,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC,gBAAgB,CAAC;IAChC,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,GAAY;IACxD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,EAAE;YACX,kCAAkC,EAAE,kCAAkC;SACvE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAI,GAA+B;QACnC,kCAAkC,EAAE,kCAAkC;KACvE,CAAC;AACJ,CAAC"}

package/dist/currencies/fetch-price-references.d.ts

@@ -0,0 +1,11 @@
+import type { FuulApiClient } from '../http/fuul-api-client.js';
+export type PriceReferenceRow = {
+    id: string;
+    name: string;
+    identifier: string;
+    chain_identifier: string;
+    decimals: number;
+};
+export declare function fetchPriceReferences(api: FuulApiClient, chainIdentifier: string): Promise<PriceReferenceRow[]>;
+export declare function parsePriceReferenceResults(raw: unknown): PriceReferenceRow[];
+//# sourceMappingURL=fetch-price-references.d.ts.map

package/dist/currencies/fetch-price-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-price-references.d.ts","sourceRoot":"","sources":["../../src/currencies/fetch-price-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAIhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAWpH;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,EAAE,CA6B5E"}

package/dist/currencies/fetch-price-references.js

@@ -0,0 +1,40 @@
+const CURRENCIES_PATH = '/api/v1/currencies';
+export async function fetchPriceReferences(api, chainIdentifier) {
+    const data = await api.getJson(CURRENCIES_PATH, {
+        query: {
+            price_reference: true,
+            chain_identifier: chainIdentifier,
+            page: 1,
+            page_size: 100,
+        },
+    });
+    return parsePriceReferenceResults(data);
+}
+export function parsePriceReferenceResults(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return [];
+    }
+    const results = raw.results;
+    if (!Array.isArray(results)) {
+        return [];
+    }
+    const rows = [];
+    for (const row of results) {
+        if (!row || typeof row !== 'object') {
+            continue;
+        }
+        const r = row;
+        if (typeof r.identifier !== 'string' || typeof r.name !== 'string' || typeof r.decimals !== 'number') {
+            continue;
+        }
+        rows.push({
+            id: typeof r.id === 'string' ? r.id : '',
+            name: r.name,
+            identifier: r.identifier,
+            chain_identifier: typeof r.chain_identifier === 'string' ? r.chain_identifier : '',
+            decimals: r.decimals,
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=fetch-price-references.js.map

package/dist/currencies/fetch-price-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-price-references.js","sourceRoot":"","sources":["../../src/currencies/fetch-price-references.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAU7C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAkB,EAAE,eAAuB;IACpF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE;QAC9C,KAAK,EAAE;YACL,eAAe,EAAE,IAAI;YACrB,gBAAgB,EAAE,eAAe;YACjC,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,GAAG;SACf;KACF,CAAC,CAAC;IAEH,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACrD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAI,GAA6B,CAAC,OAAO,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrG,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACxC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,gBAAgB,EAAE,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;YAClF,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/currencies/resolve-token-holder-price-reference.d.ts

@@ -0,0 +1,26 @@
+import type { PriceReferenceRow } from './fetch-price-references.js';
+export type TokenKind = 'stablecoin' | 'variable';
+export type TokenDecimals = 6 | 18;
+export type ResolveTokenHolderPriceReferenceInput = {
+    token_address: string;
+    chain_identifier: string;
+    token_kind?: TokenKind;
+    decimals?: TokenDecimals;
+};
+export type ResolveTokenHolderPriceReferenceResult = {
+    token_address: string;
+    chain_identifier: string;
+    token_is_listed_as_price_reference: boolean;
+    status: 'listed_use_same_address' | 'resolved' | 'needs_user_input' | 'no_matching_reference';
+    volume_currency_expression: string | null;
+    assigned_reference: Pick<PriceReferenceRow, 'identifier' | 'name' | 'decimals'> | null;
+    reason: string;
+    questions_for_user?: string[];
+    matching_references_by_decimals?: Array<Pick<PriceReferenceRow, 'identifier' | 'name' | 'decimals'>>;
+};
+export declare function resolveTokenHolderPriceReference(input: ResolveTokenHolderPriceReferenceInput, priceReferences: PriceReferenceRow[]): ResolveTokenHolderPriceReferenceResult;
+export declare function pickPriceReference(rows: PriceReferenceRow[], tokenKind: TokenKind, decimals: TokenDecimals): PriceReferenceRow | null;
+/** chain_id (EVM) → currencies API chain_identifier */
+export declare const CHAIN_ID_TO_IDENTIFIER: Record<number, string>;
+export declare function chainIdentifierFromChainId(chainId: number): string | null;
+//# sourceMappingURL=resolve-token-holder-price-reference.d.ts.map

package/dist/currencies/resolve-token-holder-price-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-token-holder-price-reference.d.ts","sourceRoot":"","sources":["../../src/currencies/resolve-token-holder-price-reference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,CAAC;AAEnC,MAAM,MAAM,qCAAqC,GAAG;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC,EAAE,OAAO,CAAC;IAC5C,MAAM,EAAE,yBAAyB,GAAG,UAAU,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;IAC9F,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,+BAA+B,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;CACtG,CAAC;AAMF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,EAC5C,eAAe,EAAE,iBAAiB,EAAE,GACnC,sCAAsC,CAiExC;AAWD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI,CAuBrI;AAgBD,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMzD,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzE"}

package/dist/currencies/resolve-token-holder-price-reference.js

@@ -0,0 +1,113 @@
+import { isTokenListedAsPriceReference, normalizeEvmAddress } from '../triggers/price-reference-guide.js';
+const STABLECOIN_18_PREFERRED_NAMES = ['DAI'];
+const STABLECOIN_6_PREFERRED_NAMES = ['USDC'];
+const VARIABLE_18_PREFERRED_NAMES = ['WETH', 'ETH', 'WSTETH'];
+export function resolveTokenHolderPriceReference(input, priceReferences) {
+    const tokenAddress = input.token_address.trim();
+    const chainIdentifier = input.chain_identifier.trim();
+    const base = {
+        token_address: tokenAddress,
+        chain_identifier: chainIdentifier,
+        token_is_listed_as_price_reference: isTokenListedAsPriceReference(tokenAddress, priceReferences),
+    };
+    if (base.token_is_listed_as_price_reference) {
+        return {
+            ...base,
+            status: 'listed_use_same_address',
+            volume_currency_expression: tokenAddress,
+            assigned_reference: findListedRow(tokenAddress, priceReferences),
+            reason: 'Token is already a price reference in Fuul. Set context.volume_currency_expression to the same address as token_address, then create_trigger.',
+        };
+    }
+    if (input.token_kind == null || input.decimals == null) {
+        return {
+            ...base,
+            status: 'needs_user_input',
+            volume_currency_expression: null,
+            assigned_reference: null,
+            reason: 'Token is not a listed price reference. Ask the user before create_trigger, then call this tool again with token_kind and decimals.',
+            questions_for_user: [
+                'Is this a stablecoin or a variable-price token? (stablecoin | variable)',
+                'How many decimals does the token have? (6 or 18 — verify on Etherscan/Arbiscan/etc.)',
+            ],
+            matching_references_by_decimals: undefined,
+        };
+    }
+    const assigned = pickPriceReference(priceReferences, input.token_kind, input.decimals);
+    if (!assigned) {
+        const withDecimals = priceReferences.filter((r) => r.decimals === input.decimals);
+        return {
+            ...base,
+            status: 'no_matching_reference',
+            volume_currency_expression: null,
+            assigned_reference: null,
+            reason: `No price reference with ${input.decimals} decimals on ${chainIdentifier}. Contact Fuul support or pick manually from list_price_references.`,
+            matching_references_by_decimals: withDecimals.map((r) => ({
+                identifier: r.identifier,
+                name: r.name,
+                decimals: r.decimals,
+            })),
+        };
+    }
+    return {
+        ...base,
+        status: 'resolved',
+        volume_currency_expression: assigned.identifier,
+        assigned_reference: {
+            identifier: assigned.identifier,
+            name: assigned.name,
+            decimals: assigned.decimals,
+        },
+        reason: buildResolvedReason(input.token_kind, input.decimals, assigned),
+    };
+}
+function findListedRow(tokenAddress, rows) {
+    const normalized = normalizeEvmAddress(tokenAddress);
+    const row = rows.find((r) => normalizeEvmAddress(r.identifier) === normalized);
+    if (!row) {
+        return null;
+    }
+    return { identifier: row.identifier, name: row.name, decimals: row.decimals };
+}
+export function pickPriceReference(rows, tokenKind, decimals) {
+    const matchingDecimals = rows.filter((r) => r.decimals === decimals);
+    if (matchingDecimals.length === 0) {
+        return null;
+    }
+    const preferredNames = tokenKind === 'stablecoin'
+        ? decimals === 18
+            ? STABLECOIN_18_PREFERRED_NAMES
+            : STABLECOIN_6_PREFERRED_NAMES
+        : decimals === 18
+            ? VARIABLE_18_PREFERRED_NAMES
+            : STABLECOIN_6_PREFERRED_NAMES;
+    for (const name of preferredNames) {
+        const hit = matchingDecimals.find((r) => nameMatches(r.name, name));
+        if (hit) {
+            return hit;
+        }
+    }
+    return matchingDecimals[0] ?? null;
+}
+function nameMatches(currencyName, preferred) {
+    const n = currencyName.trim().toUpperCase();
+    const p = preferred.toUpperCase();
+    return n === p || n.startsWith(`${p} `) || n.startsWith(p);
+}
+function buildResolvedReason(tokenKind, decimals, assigned) {
+    return (`Assigned ${assigned.name} (${assigned.identifier}) as volume_currency_expression: ` +
+        `${tokenKind} with ${decimals} decimals → use a listed reference with matching decimals ` +
+        `(e.g. 18-decimal stablecoin on Ethereum → DAI). Put this address in context.volume_currency_expression, not the held token address.`);
+}
+/** chain_id (EVM) → currencies API chain_identifier */
+export const CHAIN_ID_TO_IDENTIFIER = {
+    1: 'ethereum',
+    10: 'optimistic-ethereum',
+    137: 'polygon',
+    42161: 'arbitrum',
+    8453: 'base',
+};
+export function chainIdentifierFromChainId(chainId) {
+    return CHAIN_ID_TO_IDENTIFIER[chainId] ?? null;
+}
+//# sourceMappingURL=resolve-token-holder-price-reference.js.map

package/dist/currencies/resolve-token-holder-price-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-token-holder-price-reference.js","sourceRoot":"","sources":["../../src/currencies/resolve-token-holder-price-reference.ts"],"names":[],"mappings":"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"}

package/dist/incentives/incentive-write-handlers.d.ts

@@ -1,5 +1,5 @@
 import type { FuulApiClient } from '../http/fuul-api-client.js';
 import type { CreateIncentiveInput, DeleteIncentiveInput } from '../tools/tool-schemas.js';
-export declare function runCreateIncentive(api: FuulApiClient, input: CreateIncentiveInput): Promise<unknown>;
-export declare function runDeleteIncentive(api: FuulApiClient, input: DeleteIncentiveInput): Promise<unknown>;
+export declare function runCreateIncentive(api: FuulApiClient, input: CreateIncentiveInput, toolTimeoutMs: number): Promise<unknown>;
+export declare function runDeleteIncentive(api: FuulApiClient, input: DeleteIncentiveInput, toolTimeoutMs: number): Promise<unknown>;
 //# sourceMappingURL=incentive-write-handlers.d.ts.map

package/dist/incentives/incentive-write-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"incentive-write-handlers.d.ts","sourceRoot":"","sources":["../../src/incentives/incentive-write-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAU3F,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1G;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY1G"}
+{"version":3,"file":"incentive-write-handlers.d.ts","sourceRoot":"","sources":["../../src/incentives/incentive-write-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAOhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAU3F,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,oBAAoB,EAC3B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,oBAAoB,EAC3B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/incentives/incentive-write-handlers.js

@@ -1,34 +1,40 @@
 import { assertWriteConfirmedOrDryRun } from '../agent/write-confirmation.js';
+import { attachDraftIdResolution, resolveDraftConversionIdForWrite, resolveDraftTriggerIdsForWrite, } from '../metadata-scope/resolve-draft-ids.js';
 import { normalizePayoutTermBodyForPatch } from '../payouts/normalize-payout-term-body.js';
-function buildCreateIncentiveBody(input) {
+function buildCreateIncentiveBody(input, triggerIds) {
     return {
         name: input.name,
-        trigger_ids: input.trigger_ids,
+        trigger_ids: triggerIds,
         payout_terms: input.payout_terms.map((term) => normalizePayoutTermBodyForPatch(term)),
     };
 }
-export async function runCreateIncentive(api, input) {
+export async function runCreateIncentive(api, input, toolTimeoutMs) {
     assertWriteConfirmedOrDryRun(input);
+    const triggerResolutions = await resolveDraftTriggerIdsForWrite(api, input.project_id, input.trigger_ids, toolTimeoutMs);
+    const resolvedTriggerIds = triggerResolutions.map((row) => row.resolved_draft_trigger_id);
     const path = `/api/v1/projects/${input.project_id}/incentives`;
-    const body = buildCreateIncentiveBody(input);
+    const body = buildCreateIncentiveBody(input, resolvedTriggerIds);
     if (input.dry_run === true) {
-        return {
+        return attachDraftIdResolution({
             dry_run: true,
             would_post: path,
             body,
-        };
+        }, { triggers: triggerResolutions });
     }
-    return api.postJson(path, body);
+    const result = await api.postJson(path, body);
+    return attachDraftIdResolution(result, { triggers: triggerResolutions });
 }
-export async function runDeleteIncentive(api, input) {
+export async function runDeleteIncentive(api, input, toolTimeoutMs) {
     assertWriteConfirmedOrDryRun(input);
-    const path = `/api/v1/projects/${input.project_id}/incentives/${input.conversion_id}`;
+    const resolution = await resolveDraftConversionIdForWrite(api, input.project_id, input.conversion_id, toolTimeoutMs);
+    const path = `/api/v1/projects/${input.project_id}/incentives/${resolution.resolved_draft_conversion_id}`;
     if (input.dry_run === true) {
-        return {
+        return attachDraftIdResolution({
             dry_run: true,
             would_delete: path,
-        };
+        }, resolution);
     }
-    return api.deleteJson(path);
+    const result = await api.deleteJson(path);
+    return attachDraftIdResolution(result ?? { ok: true }, resolution);
 }
 //# sourceMappingURL=incentive-write-handlers.js.map

package/dist/incentives/incentive-write-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"incentive-write-handlers.js","sourceRoot":"","sources":["../../src/incentives/incentive-write-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAG3F,SAAS,wBAAwB,CAAC,KAA2B;IAC3D,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAA+B,CAAC,CAAC;KACjH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAkB,EAAE,KAA2B;IACtF,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,aAAa,CAAC;IAC/D,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAE7C,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,kBAAkB,CAAC,GAAkB,EAAE,KAA2B;IACtF,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,eAAe,KAAK,CAAC,aAAa,EAAE,CAAC;IAEtF,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI;SACnB,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"incentive-write-handlers.js","sourceRoot":"","sources":["../../src/incentives/incentive-write-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAG3F,SAAS,wBAAwB,CAAC,KAA2B,EAAE,UAAoB;IACjF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAA+B,CAAC,CAAC;KACjH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAkB,EAClB,KAA2B,EAC3B,aAAqB;IAErB,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,kBAAkB,GAAG,MAAM,8BAA8B,CAC7D,GAAG,EACH,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,EACjB,aAAa,CACd,CAAC;IACF,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,aAAa,CAAC;IAC/D,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAEjE,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,uBAAuB,CAC5B;YACE,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,IAAI;SACL,EACD,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,uBAAuB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAkB,EAClB,KAA2B,EAC3B,aAAqB;IAErB,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,MAAM,gCAAgC,CACvD,GAAG,EACH,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,aAAa,EACnB,aAAa,CACd,CAAC;IACF,MAAM,IAAI,GAAG,oBAAoB,KAAK,CAAC,UAAU,eAAe,UAAU,CAAC,4BAA4B,EAAE,CAAC;IAE1G,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,uBAAuB,CAC5B;YACE,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,IAAI;SACnB,EACD,UAAU,CACX,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,uBAAuB,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;AACrE,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@ import { assertWriteConfirmedOrDryRun, WriteNotConfirmedError } from './agent/wr
 import { OAuthClient } from './auth/oauth-client.js';
 import { TokenStore } from './auth/token-store.js';
 import { loadEnv } from './config/env.js';
+import { runListPriceReferences, runResolveTokenHolderPriceReference } from './currencies/currency-handlers.js';
 import { runCheckEventStatus, runSendBatchEvents, runSendEvent } from './events/events-handlers.js';
 import { ApiRequestError, FuulApiClient, NotLoggedInError } from './http/fuul-api-client.js';
 import { MissingProjectApiKeyError, resolveProjectApiKeyBearer } from './http/project-api-key-bearer.js';
@@ -14,11 +15,12 @@ import { enrichPayoutSchemasResponse } from './incentives/incentive-create-paylo
 import { runCreateIncentive, runDeleteIncentive } from './incentives/incentive-write-handlers.js';
 import { MetadataService } from './metadata/metadata-service.js';
 import { loadIncentivesListWithMetadataScope, loadIncentiveWithMetadataScope, loadProjectWithMetadataScope, } from './metadata-scope/fetch-project-config.js';
+import { attachDraftIdResolution, resolveDraftConversionIdForWrite, resolveDraftTriggerIdForWrite } from './metadata-scope/resolve-draft-ids.js';
 import { normalizePayoutTermBodyForPatch } from './payouts/normalize-payout-term-body.js';
 import { runPayoutBatchAction } from './payouts/payout-batch-handlers.js';
 import { runDeleteUserReferrer, runGetUserReferrer, runRemoveUserFromReferralCode, runSwapUserReferralCode, runUpdateUserReferrer, runUseReferralCode, } from './referral-attribution/referral-attribution-handlers.js';
-import { APPROVE_PAYOUTS_DESCRIPTION, CHECK_EVENT_STATUS_DESCRIPTION, CREATE_INCENTIVE_DESCRIPTION, CREATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, CREATE_TRIGGER_DESCRIPTION, DELETE_INCENTIVE_DESCRIPTION, DELETE_TRIGGER_DESCRIPTION, DELETE_USER_REFERRER_DESCRIPTION, GET_AFFILIATE_PORTAL_STATS_DESCRIPTION, GET_INCENTIVE_DESCRIPTION, GET_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, GET_PROJECT_AFFILIATE_TOTAL_STATS_DESCRIPTION, GET_PROJECT_AFFILIATES_BREAKDOWN_DESCRIPTION, GET_PROJECT_DESCRIPTION, GET_TRIGGER_DESCRIPTION, GET_USER_REFERRER_DESCRIPTION, LIST_CHAINS_DESCRIPTION, LIST_INCENTIVES_DESCRIPTION, LIST_PAYOUT_SCHEMAS_DESCRIPTION, LIST_PAYOUTS_PENDING_APPROVAL_DESCRIPTION, LIST_PROJECTS_DESCRIPTION, LIST_REWARDS_PAYOUTS_DESCRIPTION, LIST_TRIGGER_TYPES_DESCRIPTION, PING_DESCRIPTION, REJECT_PAYOUTS_DESCRIPTION, REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION, SEND_BATCH_EVENTS_DESCRIPTION, SEND_EVENT_DESCRIPTION, SWAP_USER_REFERRAL_CODE_DESCRIPTION, UPDATE_AUDIENCE_DESCRIPTION, UPDATE_PAYOUT_TERM_DESCRIPTION, UPDATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, UPDATE_PROJECT_TIER_DESCRIPTION, UPDATE_TRIGGER_DESCRIPTION, UPDATE_USER_REFERRER_DESCRIPTION, USE_REFERRAL_CODE_DESCRIPTION, WHOAMI_DESCRIPTION, } from './tools/tool-descriptions.js';
-import { checkEventStatusFieldsSchema, checkEventStatusInputSchema, createIncentiveFieldsSchema, createIncentiveInputSchema, createProjectAffiliatePublicFieldsSchema, createProjectAffiliatePublicInputSchema, createTriggerFieldsSchema, createTriggerInputSchema, deleteIncentiveFieldsSchema, deleteIncentiveInputSchema, deleteTriggerFieldsSchema, deleteTriggerInputSchema, deleteUserReferrerFieldsSchema, deleteUserReferrerInputSchema, getAffiliatePortalStatsSchema, getIncentiveInputSchema, getProjectAffiliatePublicInputSchema, getProjectAffiliatesBreakdownSchema, getProjectAffiliateTotalStatsSchema, getTriggerInputSchema, getUserReferrerFieldsSchema, getUserReferrerInputSchema, listPayoutsPendingApprovalSchema, listProjectsInputSchema, listRewardsPayoutsSchema, payoutBatchActionInputSchema, projectIdParamSchema, removeUserFromReferralCodeFieldsSchema, removeUserFromReferralCodeInputSchema, sendBatchEventsFieldsSchema, sendBatchEventsInputSchema, sendEventFieldsSchema, sendEventInputSchema, swapUserReferralCodeFieldsSchema, swapUserReferralCodeInputSchema, updateAudienceFieldsSchema, updateAudienceInputSchema, updatePayoutTermInputSchema, updateProjectAffiliatePublicFieldsSchema, updateProjectAffiliatePublicInputSchema, updateProjectTierFieldsSchema, updateProjectTierInputSchema, updateTriggerFieldsSchema, updateTriggerInputSchema, updateUserReferrerFieldsSchema, updateUserReferrerInputSchema, useReferralCodeFieldsSchema, useReferralCodeInputSchema, } from './tools/tool-schemas.js';
+import { APPROVE_PAYOUTS_DESCRIPTION, CHECK_EVENT_STATUS_DESCRIPTION, CREATE_INCENTIVE_DESCRIPTION, CREATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, CREATE_TRIGGER_DESCRIPTION, DELETE_INCENTIVE_DESCRIPTION, DELETE_TRIGGER_DESCRIPTION, DELETE_USER_REFERRER_DESCRIPTION, GET_AFFILIATE_PORTAL_STATS_DESCRIPTION, GET_INCENTIVE_DESCRIPTION, GET_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, GET_PROJECT_AFFILIATE_TOTAL_STATS_DESCRIPTION, GET_PROJECT_AFFILIATES_BREAKDOWN_DESCRIPTION, GET_PROJECT_DESCRIPTION, GET_TRIGGER_DESCRIPTION, GET_USER_REFERRER_DESCRIPTION, LIST_CHAINS_DESCRIPTION, LIST_INCENTIVES_DESCRIPTION, LIST_PAYOUT_SCHEMAS_DESCRIPTION, LIST_PAYOUTS_PENDING_APPROVAL_DESCRIPTION, LIST_PRICE_REFERENCES_DESCRIPTION, LIST_PROJECTS_DESCRIPTION, LIST_REWARDS_PAYOUTS_DESCRIPTION, LIST_TRIGGER_TYPES_DESCRIPTION, PING_DESCRIPTION, REJECT_PAYOUTS_DESCRIPTION, REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION, RESOLVE_TOKEN_HOLDER_PRICE_REFERENCE_DESCRIPTION, SEND_BATCH_EVENTS_DESCRIPTION, SEND_EVENT_DESCRIPTION, SWAP_USER_REFERRAL_CODE_DESCRIPTION, UPDATE_AUDIENCE_DESCRIPTION, UPDATE_PAYOUT_TERM_DESCRIPTION, UPDATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION, UPDATE_PROJECT_TIER_DESCRIPTION, UPDATE_TRIGGER_DESCRIPTION, UPDATE_USER_REFERRER_DESCRIPTION, USE_REFERRAL_CODE_DESCRIPTION, WHOAMI_DESCRIPTION, } from './tools/tool-descriptions.js';
+import { checkEventStatusFieldsSchema, checkEventStatusInputSchema, createIncentiveFieldsSchema, createIncentiveInputSchema, createProjectAffiliatePublicFieldsSchema, createProjectAffiliatePublicInputSchema, createTriggerFieldsSchema, createTriggerInputSchema, deleteIncentiveFieldsSchema, deleteIncentiveInputSchema, deleteTriggerFieldsSchema, deleteTriggerInputSchema, deleteUserReferrerFieldsSchema, deleteUserReferrerInputSchema, getAffiliatePortalStatsSchema, getIncentiveInputSchema, getProjectAffiliatePublicInputSchema, getProjectAffiliatesBreakdownSchema, getProjectAffiliateTotalStatsSchema, getTriggerInputSchema, getUserReferrerFieldsSchema, getUserReferrerInputSchema, listPayoutsPendingApprovalSchema, listPriceReferencesInputSchema, listProjectsInputSchema, listRewardsPayoutsSchema, payoutBatchActionInputSchema, projectIdParamSchema, removeUserFromReferralCodeFieldsSchema, removeUserFromReferralCodeInputSchema, resolveTokenHolderPriceReferenceFieldsSchema, resolveTokenHolderPriceReferenceInputSchema, sendBatchEventsFieldsSchema, sendBatchEventsInputSchema, sendEventFieldsSchema, sendEventInputSchema, swapUserReferralCodeFieldsSchema, swapUserReferralCodeInputSchema, updateAudienceFieldsSchema, updateAudienceInputSchema, updatePayoutTermInputSchema, updateProjectAffiliatePublicFieldsSchema, updateProjectAffiliatePublicInputSchema, updateProjectTierFieldsSchema, updateProjectTierInputSchema, updateTriggerFieldsSchema, updateTriggerInputSchema, updateUserReferrerFieldsSchema, updateUserReferrerInputSchema, useReferralCodeFieldsSchema, useReferralCodeInputSchema, } from './tools/tool-schemas.js';
 import { enrichTriggerTypesResponse } from './triggers/trigger-create-payload-guide.js';
 import { runCreateTrigger, runDeleteTrigger } from './triggers/trigger-write-handlers.js';
 import { compactQuery } from './util/compact-query.js';
@@ -84,6 +86,26 @@ async function main() {
             return toolErrorPayload(e);
         }
     });
+    server.tool('list_price_references', LIST_PRICE_REFERENCES_DESCRIPTION, listPriceReferencesInputSchema.shape, async (args) => {
+        try {
+            const parsed = listPriceReferencesInputSchema.parse(args);
+            const data = await withTimeout(runListPriceReferences(api, parsed), toolTimeoutMs, 'list_price_references');
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return toolErrorPayload(e, 'Failed to list price references');
+        }
+    });
+    server.tool('resolve_token_holder_price_reference', RESOLVE_TOKEN_HOLDER_PRICE_REFERENCE_DESCRIPTION, resolveTokenHolderPriceReferenceFieldsSchema.shape, async (args) => {
+        try {
+            const parsed = resolveTokenHolderPriceReferenceInputSchema.parse(args);
+            const data = await withTimeout(runResolveTokenHolderPriceReference(api, parsed), toolTimeoutMs, 'resolve_token_holder_price_reference');
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return toolErrorPayload(e, 'Failed to resolve token holder price reference');
+        }
+    });
     server.tool('list_trigger_types', LIST_TRIGGER_TYPES_DESCRIPTION, {}, async () => {
         try {
             const data = await withTimeout(metadata.getTriggerTypes(), toolTimeoutMs, 'list_trigger_types');
@@ -174,7 +196,7 @@ async function main() {
     server.tool('delete_trigger', DELETE_TRIGGER_DESCRIPTION, deleteTriggerFieldsSchema.shape, async (args) => {
         try {
             const parsed = deleteTriggerInputSchema.parse(args);
-            const data = await withTimeout(runDeleteTrigger(api, parsed), toolTimeoutMs, 'delete_trigger');
+            const data = await withTimeout(runDeleteTrigger(api, parsed, toolTimeoutMs), toolTimeoutMs, 'delete_trigger');
             return { content: [{ type: 'text', text: stringifyToolPayload(data ?? { ok: true }, parsed.dry_run) }] };
         }
         catch (e) {
@@ -184,7 +206,7 @@ async function main() {
     server.tool('create_incentive', CREATE_INCENTIVE_DESCRIPTION, createIncentiveFieldsSchema.shape, async (args) => {
         try {
             const parsed = createIncentiveInputSchema.parse(args);
-            const data = await withTimeout(runCreateIncentive(api, parsed), toolTimeoutMs, 'create_incentive');
+            const data = await withTimeout(runCreateIncentive(api, parsed, toolTimeoutMs), toolTimeoutMs, 'create_incentive');
             return { content: [{ type: 'text', text: stringifyToolPayload(data, parsed.dry_run) }] };
         }
         catch (e) {
@@ -194,7 +216,7 @@ async function main() {
     server.tool('delete_incentive', DELETE_INCENTIVE_DESCRIPTION, deleteIncentiveFieldsSchema.shape, async (args) => {
         try {
             const parsed = deleteIncentiveInputSchema.parse(args);
-            const data = await withTimeout(runDeleteIncentive(api, parsed), toolTimeoutMs, 'delete_incentive');
+            const data = await withTimeout(runDeleteIncentive(api, parsed, toolTimeoutMs), toolTimeoutMs, 'delete_incentive');
             return { content: [{ type: 'text', text: stringifyToolPayload(data ?? { ok: true }, parsed.dry_run) }] };
         }
         catch (e) {
@@ -435,20 +457,28 @@ async function main() {
         try {
             const parsed = updatePayoutTermInputSchema.parse(args);
             assertWriteConfirmedOrDryRun(parsed);
-            const path = `/api/v1/projects/${parsed.project_id}/conversions/${parsed.conversion_id}/payout_terms/${parsed.payout_term_id}`;
+            const conversionResolution = await resolveDraftConversionIdForWrite(api, parsed.project_id, parsed.conversion_id, toolTimeoutMs);
+            const path = `/api/v1/projects/${parsed.project_id}/conversions/${conversionResolution.resolved_draft_conversion_id}/payout_terms/${parsed.payout_term_id}`;
             const patchBody = normalizePayoutTermBodyForPatch(parsed.payout_term);
             if (parsed.dry_run === true) {
                 return {
                     content: [
                         {
                             type: 'text',
-                            text: JSON.stringify({ dry_run: true, would_patch: path, body: patchBody }, null, 2),
+                            text: JSON.stringify(attachDraftIdResolution({ dry_run: true, would_patch: path, body: patchBody }, conversionResolution), null, 2),
                         },
                     ],
                 };
             }
             const data = await withTimeout(api.patchJson(path, patchBody), toolTimeoutMs, 'update_payout_term');
-            return { content: [{ type: 'text', text: stringifyToolPayload(data, parsed.dry_run) }] };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: stringifyToolPayload(attachDraftIdResolution(data, conversionResolution), parsed.dry_run),
+                    },
+                ],
+            };
         }
         catch (e) {
             return toolErrorPayload(e, 'Failed to update payout term');
@@ -485,7 +515,8 @@ async function main() {
         try {
             const parsed = updateTriggerInputSchema.parse(args);
             assertWriteConfirmedOrDryRun(parsed);
-            const path = `/api/v1/projects/${parsed.project_id}/triggers/${parsed.trigger_id}`;
+            const triggerResolution = await resolveDraftTriggerIdForWrite(api, parsed.project_id, parsed.trigger_id, toolTimeoutMs);
+            const path = `/api/v1/projects/${parsed.project_id}/triggers/${triggerResolution.resolved_draft_trigger_id}`;
             const body = {};
             if (parsed.name !== undefined) {
                 body.name = parsed.name;
@@ -534,11 +565,23 @@ async function main() {
             }
             if (parsed.dry_run === true) {
                 return {
-                    content: [{ type: 'text', text: JSON.stringify({ dry_run: true, would_patch: path, body }, null, 2) }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(attachDraftIdResolution({ dry_run: true, would_patch: path, body }, triggerResolution), null, 2),
+                        },
+                    ],
                 };
             }
             const data = await withTimeout(api.patchJson(path, body), toolTimeoutMs, 'update_trigger');
-            return { content: [{ type: 'text', text: stringifyToolPayload(data, parsed.dry_run) }] };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: stringifyToolPayload(attachDraftIdResolution(data, triggerResolution), parsed.dry_run),
+                    },
+                ],
+            };
         }
         catch (e) {
             return toolErrorPayload(e, 'Failed to update trigger');