@oomol-lab/open-connector 1.6.2 → 1.6.4

package/src/providers/hithink_finance/runtime.js

@@ -1,33 +1,12 @@
-import { compactObject } from "../../core/cast.js";
-import { runProviderRequest, ProviderRequestError, providerUserAgent } from "../provider-runtime.js";
+import { compactObject, optionalInteger, optionalNumber, optionalString, optionalStringArray, } from "../../core/cast.js";
+import { requiredInputNumber, requiredInputString, runProviderRequest, ProviderRequestError, providerUserAgent, } from "../provider-runtime.js";
 import { createMarketDumpHandlers } from "./market-dumps.js";
-function requiredString(value, fieldName) {
-    if (typeof value !== "string" || !value.trim()) {
-        throw hithinkError("invalid_input", `${fieldName} is required`, 400);
-    }
-    return value.trim();
-}
-function optionalString(value) {
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-function optionalStringArray(value) {
-    return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : undefined;
-}
 function requiredStringArray(value, fieldName) {
     const result = optionalStringArray(value);
     if (!result || result.length === 0) {
         throw hithinkError("invalid_input", `${fieldName} is required`, 400);
     }
-    return result.map((item, index) => requiredString(item, `${fieldName}[${index}]`));
-}
-function optionalNumber(value) {
-    return typeof value === "number" ? value : undefined;
-}
-function requiredNumber(value, fieldName) {
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw hithinkError("invalid_input", `${fieldName} is required`, 400);
-    }
-    return value;
+    return result.map((item, index) => requiredInputString(item, `${fieldName}[${index}]`));
 }
 export const hithinkFinanceProxyMaxResponseBytes = 4 * 1024 * 1024;
 const hithinkFinanceActionMaxResponseBytes = 16 * 1024 * 1024;
@@ -75,7 +54,7 @@ export async function fetchHithinkFinanceProxy(input) {
         }
         throw error;
     }
-    const code = readInteger(payload.code);
+    const code = optionalInteger(payload.code);
     if (!response.ok || code !== 0) {
         throw buildProviderError(response.status, code, payload, "execute");
     }
@@ -130,7 +109,7 @@ async function readBoundedResponse(response, maximumBytes, tooLargeError, emptyM
 export const hithinkFinanceActionHandlers = {
     search_tickers(input, context) {
         return get("/api/meta/tickers/search", {
-            q: requiredString(input.query, "query"),
+            q: requiredInputString(input.query, "query"),
             exchange: optionalString(input.exchange),
             asset_type: optionalStringArray(input.assetTypes)?.join(","),
             limit: optionalNumber(input.limit),
@@ -153,17 +132,17 @@ export const hithinkFinanceActionHandlers = {
     },
     get_stock_history(input, context) {
         return get("/api/a-share/prices/historical", {
-            thscode: requiredString(input.thscode, "thscode"),
+            thscode: requiredInputString(input.thscode, "thscode"),
             interval: "1d",
-            start: requiredNumber(input.startTimeMs, "startTimeMs"),
-            end: requiredNumber(input.endTimeMs, "endTimeMs"),
+            start: requiredInputNumber(input.startTimeMs, "startTimeMs"),
+            end: requiredInputNumber(input.endTimeMs, "endTimeMs"),
             adjust: optionalString(input.adjust),
             offset: optionalNumber(input.offset),
         }, context);
     },
     get_adjustment_factors(input, context) {
         return get("/api/a-share/corporate-actions/adjustment-factors", {
-            thscode: requiredString(input.thscode, "thscode"),
+            thscode: requiredInputString(input.thscode, "thscode"),
             from: optionalString(input.from),
             to: optionalString(input.to),
         }, context);
@@ -179,8 +158,8 @@ export const hithinkFinanceActionHandlers = {
     },
     get_financial_indicators(input, context) {
         return get("/api/a-share/financials/indicators", {
-            thscode: requiredString(input.thscode, "thscode"),
-            report: requiredString(input.report, "report"),
+            thscode: requiredInputString(input.thscode, "thscode"),
+            report: requiredInputString(input.report, "report"),
         }, context);
     },
     get_valuation_snapshot(input, context) {
@@ -193,17 +172,17 @@ export const hithinkFinanceActionHandlers = {
         return get("/api/a-share-index/catalog/ths-index-list", { tag: optionalString(input.tag) }, context);
     },
     get_index_constituents(input, context) {
-        return get("/api/a-share-index/constituents/ths-stock-list", { thscode: requiredString(input.thscode, "thscode") }, context);
+        return get("/api/a-share-index/constituents/ths-stock-list", { thscode: requiredInputString(input.thscode, "thscode") }, context);
     },
     get_index_snapshot(input, context) {
         return get("/api/a-share-index/prices/snapshot", { thscodes: requiredStringArray(input.thscodes, "thscodes").join(",") }, context);
     },
     get_index_history(input, context) {
         return get("/api/a-share-index/prices/historical", {
-            thscode: requiredString(input.thscode, "thscode"),
+            thscode: requiredInputString(input.thscode, "thscode"),
             interval: "1d",
-            start: requiredNumber(input.startTimeMs, "startTimeMs"),
-            end: requiredNumber(input.endTimeMs, "endTimeMs"),
+            start: requiredInputNumber(input.startTimeMs, "startTimeMs"),
+            end: requiredInputNumber(input.endTimeMs, "endTimeMs"),
         }, context);
     },
     get_auction_snapshot(input, context) {
@@ -242,26 +221,26 @@ function createFundHandlers(get) {
             });
         },
         get_fund_market_snapshot(input, context) {
-            return get("/api/fund/market/snapshot", { thscode: requiredString(input.thscode, "thscode") }, context);
+            return get("/api/fund/market/snapshot", { thscode: requiredInputString(input.thscode, "thscode") }, context);
         },
         get_fund_market_history(input, context) {
             return get("/api/fund/market/historical", {
-                thscode: requiredString(input.thscode, "thscode"),
+                thscode: requiredInputString(input.thscode, "thscode"),
                 interval: "1d",
-                start: requiredNumber(input.startTimeMs, "startTimeMs"),
-                end: requiredNumber(input.endTimeMs, "endTimeMs"),
+                start: requiredInputNumber(input.startTimeMs, "startTimeMs"),
+                end: requiredInputNumber(input.endTimeMs, "endTimeMs"),
             }, context);
         },
         get_fund_company(input, context) {
-            return get("/api/fund/companies/detail", { company_id: requiredString(input.companyId, "companyId") }, context);
+            return get("/api/fund/companies/detail", { company_id: requiredInputString(input.companyId, "companyId") }, context);
         },
         get_fund_industry_allocation(input, context) {
             return getFund(get, "/api/fund/portfolio/industry-allocation", input, context);
         },
         get_fund_performance_indicators(input, context) {
             return getFund(get, "/api/fund/performance/indicators-historical", input, context, {
-                start: requiredNumber(input.startTimeMs, "startTimeMs"),
-                end: requiredNumber(input.endTimeMs, "endTimeMs"),
+                start: requiredInputNumber(input.startTimeMs, "startTimeMs"),
+                end: requiredInputNumber(input.endTimeMs, "endTimeMs"),
             });
         },
         get_fund_drawdowns(input, context) {
@@ -292,7 +271,7 @@ function createFundHandlers(get) {
         },
         get_fund_manager_performance(input, context) {
             return getManager(get, "/api/fund/managers/performance", input, context, {
-                range: requiredString(input.range, "range"),
+                range: requiredInputString(input.range, "range"),
             });
         },
         get_fund_manager_experience(input, context) {
@@ -308,7 +287,7 @@ function createFundHandlers(get) {
             });
         },
         list_fund_offerings(input, context) {
-            return get("/api/fund/offerings/list", { subscribe: requiredString(input.subscriptionStatus, "subscriptionStatus") }, context);
+            return get("/api/fund/offerings/list", { subscribe: requiredInputString(input.subscriptionStatus, "subscriptionStatus") }, context);
         },
         get_fund_stock_holdings_history(input, context) {
             return getFundHoldingsHistory(get, "/api/fund/portfolio/stock-history", input, context);
@@ -329,8 +308,8 @@ function createFundHandlers(get) {
 }
 function getFund(get, path, input, context, extra = {}) {
     return get(path, {
-        fund_type: requiredString(input.fundType, "fundType"),
-        thscode: requiredString(input.thscode, "thscode"),
+        fund_type: requiredInputString(input.fundType, "fundType"),
+        thscode: requiredInputString(input.thscode, "thscode"),
         ...extra,
     }, context);
 }
@@ -348,12 +327,12 @@ function normalizeNavTypes(value) {
     return undefined;
 }
 function getManager(get, path, input, context, extra = {}) {
-    return get(path, { manager_id: requiredString(input.managerId, "managerId"), ...extra }, context);
+    return get(path, { manager_id: requiredInputString(input.managerId, "managerId"), ...extra }, context);
 }
 function getFundHoldingsHistory(get, path, input, context) {
     return getFund(get, path, input, context, {
-        report_type: requiredString(input.reportType, "reportType"),
-        end_date: requiredString(input.endDate, "endDate"),
+        report_type: requiredInputString(input.reportType, "reportType"),
+        end_date: requiredInputString(input.endDate, "endDate"),
     });
 }
 function getFundReportDates(get, path, input, context) {
@@ -382,13 +361,13 @@ function createSpecialDataHandlers(get) {
             return get("/api/a-share/special-data/hot-stock-list", { period: optionalString(input.period) }, context);
         },
         get_hot_stock_history(input, context) {
-            return get("/api/a-share/special-data/hot-stock-list-history", { date: requiredString(input.date, "date") }, context);
+            return get("/api/a-share/special-data/hot-stock-list-history", { date: requiredInputString(input.date, "date") }, context);
         },
         get_hot_stock_rank_trend(input, context) {
             return get("/api/a-share/special-data/hot-stock-rank-trend", {
-                thscode: requiredString(input.thscode, "thscode"),
-                start_date: requiredString(input.startDate, "startDate"),
-                end_date: requiredString(input.endDate, "endDate"),
+                thscode: requiredInputString(input.thscode, "thscode"),
+                start_date: requiredInputString(input.startDate, "startDate"),
+                end_date: requiredInputString(input.endDate, "endDate"),
             }, context);
         },
         get_dragon_tiger_list(input, context) {
@@ -413,7 +392,7 @@ function getPool(get, path, input, context) {
 }
 function getFinancialStatements(path, input, context) {
     return get(path, {
-        thscode: requiredString(input.thscode, "thscode"),
+        thscode: requiredInputString(input.thscode, "thscode"),
         period: optionalString(input.period),
         limit: optionalNumber(input.limit),
         start: optionalNumber(input.startTimeMs),
@@ -455,7 +434,7 @@ async function hithinkFinanceGet(path, query, apiKey, fetcher, phase, signal) {
         }
         throw error;
     }
-    const code = readInteger(payload.code);
+    const code = optionalInteger(payload.code);
     if (!response.ok || code !== 0) {
         throw buildProviderError(response.status, code, payload, phase);
     }
@@ -500,7 +479,10 @@ function buildProviderError(status, code, payload, phase) {
         return hithinkError(phase === "validate" ? "invalid_input" : "scope_missing", detail, phase === "validate" ? 400 : 403);
     }
     if (code === 4001 || status === 429) {
-        return hithinkError("rate_limited", `${detail}. Reduce request frequency and concurrency, then retry with exponential backoff (up to 3 attempts)`, 429);
+        const retryAdvice = message.startsWith("Global request rate limit exceeded")
+            ? "This upstream limit is shared across the account. Wait before retrying; reconnecting or sending concurrent retries will not reset it"
+            : "Reduce request frequency and concurrency, then retry with exponential backoff (up to 3 attempts)";
+        return hithinkError("rate_limited", `${detail}. ${retryAdvice}`, 429);
     }
     if (code === 4040) {
         return hithinkError("provider_error", requestId
@@ -522,9 +504,6 @@ function buildProviderError(status, code, payload, phase) {
     }
     return hithinkError("provider_error", detail, status >= 500 ? 502 : 503);
 }
-function readInteger(value) {
-    return typeof value === "number" && Number.isInteger(value) ? value : undefined;
-}
 function hithinkError(code, message, status) {
     return new ProviderRequestError(status, message, { code });
 }

package/src/providers/linkfox/actions.js

@@ -6,6 +6,7 @@ import { chuhaijiangActions } from "./chuhaijiang-actions.js";
 import { maidalvAction } from "./maidalv-actions.js";
 import { mercadoActions } from "./mercado-actions.js";
 import { seerfarActions } from "./seerfar-actions.js";
+import { sifActions } from "./sif-actions.js";
 import { zhihuiyaActions } from "./zhihuiya-actions.js";
 const service = "linkfox";
 const amazonDomains = [
@@ -974,6 +975,7 @@ const tiktokShopProductInput = s.object("TikTok Shop product detail parameters."
     region: s.optional(s.stringEnum("The TikTok Shop region.", ["US", "GB", "ID", "MY", "TH", "VN", "PH", "SG", "DE", "FR", "IT", "ES"])),
 });
 export const linkfoxActions = [
+    ...sifActions,
     ...mercadoActions,
     ...zhihuiyaActions,
     ...chuhaijiangActions,

package/src/providers/linkfox/runtime.js

@@ -4,6 +4,7 @@ import { chuhaijiangOperations } from "./chuhaijiang-actions.js";
 import { normalizeChuhaijiang, searchChuhaijiangImage } from "./chuhaijiang-runtime.js";
 import { mercadoOperations } from "./mercado-actions.js";
 import { seerfarOperations } from "./seerfar-actions.js";
+import { sifOperations } from "./sif-actions.js";
 import { zhihuiyaOperations } from "./zhihuiya-actions.js";
 import { validateZhihuiyaInput } from "./zhihuiya-runtime.js";
 const zhihuiyaOperationsByName = new Map(zhihuiyaOperations.map(({ action, path }) => [action.name, { path }]));
@@ -32,6 +33,10 @@ const directOperations = {
             normalize: (payload) => requiredResponseRecord(payload, "LinkFox Seerfar response"),
         },
     ])),
+    ...Object.fromEntries(sifOperations.map(({ action, path }) => [
+        action.name,
+        { path, gatewayBusinessCodeOnly: true, normalize: normalizeSifResult },
+    ])),
     get_current_account: {
         path: "/account/currentByAPI",
         method: "GET",
@@ -299,10 +304,13 @@ export async function executeLinkfoxAction(actionName, input, apiKey, fetcher, p
     }
     const direct = directOperations[actionName];
     if (direct) {
+        if (direct.gatewayBusinessCodeOnly)
+            validateSifInput(actionName, input);
         const body = direct.buildBody ? direct.buildBody(input) : input;
         const payload = await requestLinkfoxPayload(direct.path, {
             method: direct.method ?? "POST",
             timeoutMs: direct.timeoutMs,
+            gatewayBusinessCodeOnly: direct.gatewayBusinessCodeOnly,
             ...((direct.method ?? "POST") === "POST" ? { body } : {}),
         }, apiKey, fetcher, "execute", false, parentSignal);
         return direct.normalize(payload);
@@ -313,6 +321,32 @@ export async function executeLinkfoxAction(actionName, input, apiKey, fetcher, p
     }
     return handler(input, { apiKey, fetcher, signal: parentSignal });
 }
+function validateSifInput(actionName, input) {
+    if (actionName === "list_sif_asin_keywords") {
+        const periodType = optionalString(input.timePieceType) ?? "latelyDay";
+        const periodValue = optionalString(input.timePieceValue);
+        if ((periodType === "month" || periodType === "week") && !periodValue) {
+            throw new ProviderRequestError(400, "timePieceValue is required for month or week periods");
+        }
+    }
+    const startDate = optionalString(input.startDate);
+    const endDate = optionalString(input.endDate);
+    if ((startDate && !endDate) || (!startDate && endDate)) {
+        throw new ProviderRequestError(400, "startDate and endDate must be provided together");
+    }
+    if ((startDate || endDate) && input.last7d !== false) {
+        throw new ProviderRequestError(400, "last7d must be false when a date range is provided");
+    }
+    if (startDate && endDate && startDate > endDate) {
+        throw new ProviderRequestError(400, "startDate must not be later than endDate");
+    }
+    if (actionName === "get_sif_asin_traffic_summary") {
+        const asins = optionalString(input.asins);
+        if (asins && asins.split(",").length > 10) {
+            throw new ProviderRequestError(400, "asins must contain at most 10 comma-separated ASINs");
+        }
+    }
+}
 function validateLinkfoxActionInput(actionName, input) {
     if (actionName === "search_amazon_by_image" && input.deliveryZip && input.countryOrAreaCode) {
         throw new ProviderRequestError(400, "deliveryZip and countryOrAreaCode cannot be used together");
@@ -422,7 +456,9 @@ async function requestLinkfoxPayload(path, options, apiKey, fetcher, phase = "ex
             signal,
         });
         const payload = await readJsonPayload(response);
-        const businessCode = readBusinessCode(payload);
+        const businessCode = options.gatewayBusinessCodeOnly
+            ? readGatewayBusinessCode(payload)
+            : readBusinessCode(payload);
         if (acceptCreditError && businessCode === 402)
             return payload;
         if (!response.ok || (businessCode !== undefined && businessCode !== 200)) {
@@ -482,6 +518,17 @@ function readBusinessCode(payload) {
     }
     return undefined;
 }
+function readGatewayBusinessCode(payload) {
+    const record = optionalRecord(payload);
+    for (const key of ["errcode", "errorCode"]) {
+        const value = record?.[key];
+        if (typeof value === "number" && Number.isFinite(value))
+            return value;
+        if (typeof value === "string" && value.trim() && Number.isFinite(Number(value)))
+            return Number(value);
+    }
+    return undefined;
+}
 function readErrorMessage(payload) {
     if (typeof payload === "string" && payload.trim()) {
         return payload.trim();
@@ -522,6 +569,28 @@ function normalizeDataList(payload) {
         costToken: readNumber(record.costToken),
     };
 }
+function normalizeSifResult(payload) {
+    const record = requireRecord(payload, "LinkFox returned an invalid SIF response");
+    const code = typeof record.code === "string" || typeof record.code === "number" ? String(record.code) : undefined;
+    if (code !== "1") {
+        throw new ProviderRequestError(502, readString(record.msg) ?? "LinkFox SIF returned an unsuccessful business response", record);
+    }
+    const data = readArray(record.data);
+    if (!data)
+        throw new ProviderRequestError(502, "LinkFox SIF response did not include data", record);
+    return {
+        ...record,
+        code,
+        msg: readString(record.msg) ?? null,
+        total: readInteger(record.total) ?? data.length,
+        data,
+        columns: readArray(record.columns) ?? [],
+        type: readString(record.type) ?? null,
+        title: readString(record.title) ?? null,
+        costTime: readInteger(record.costTime),
+        costToken: readNumber(record.costToken),
+    };
+}
 function normalizeVideoList(payload) {
     const record = requireRecord(payload, "LinkFox returned an invalid video response");
     const videos = readArray(record.videos) ?? readArray(record.data) ?? [];

package/src/providers/linkfox/sif-actions.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderActionDefinition } from "../../core/provider-definition.ts";
+import type { ActionDefinition } from "../../core/types.ts";
+interface SifOperation {
+    path: string;
+    usage: number;
+    action: ProviderActionDefinition;
+}
+export declare const sifOperations: readonly SifOperation[];
+export declare const sifActions: readonly ActionDefinition[];
+export {};

package/src/providers/linkfox/sif-actions.js

@@ -0,0 +1,193 @@
+import { jsonSchema as s } from "../../core/json-schema.js";
+import { defineProviderAction } from "../../core/provider-definition.js";
+const sifCountries = ["US", "UK", "DE", "CA", "JP", "FR", "ES", "IT", "MX", "AU", "AE", "BR", "SA"];
+const summarySortFields = [
+    "totalKeywordNum",
+    "naturalKeywordNum",
+    "brandKeywordNum",
+    "vedioKeywordNum",
+    "acKeywordNum",
+    "erKeywordNum",
+    "trKeywordNum",
+    "sumScore",
+    "totalNfScore",
+    "totalSpSocre",
+    "totalBrandScore",
+    "totalVedioScore",
+    "totalAcScore",
+    "totalTrScore",
+    "totalErScore",
+];
+const keywordSummaryConditions = [
+    "nfPosition",
+    "isSpAd",
+    "isVedioAd",
+    "isBrandAd",
+    "isPPCAd",
+    "isSearchRecommend",
+    "acAd",
+    "totalPeriod.in",
+    "nfKeywordCnt.total",
+    "nfKeywordCnt.in",
+    "adKeywordCnt.total",
+    "adKeywordCnt.in",
+    "allSpKeywordCnt.total",
+    "allSpKeywordCnt.in",
+    "spKeywordCnt.total",
+    "spKeywordCnt.in",
+    "recSpKeywordCnt.total",
+    "recSpKeywordCnt.in",
+    "allSbKeywordCnt.total",
+    "allSbKeywordCnt.in",
+    "sbKeywordCnt.total",
+    "sbKeywordCnt.in",
+    "sbvKeywordCnt.total",
+    "sbvKeywordCnt.in",
+];
+const _asinKeywordConditionValues = [
+    "nfPosition",
+    "isSpAd",
+    "isBrandAd",
+    "isVedioAd",
+    "isAC",
+    "isAccurateKw",
+    "isAccurateTailKw",
+    "isPurchaseKw",
+    "isQualityKw",
+    "isStableKw",
+    "isLossKw",
+    "isInvalidKw",
+    "isMultiVariantKw",
+    "isSearchVolUpKw",
+    "isSearchVolDownKw",
+    "totalPeriod.in",
+    "nfKeywordCnt.total",
+    "nfKeywordCnt.in",
+    "adKeywordCnt.total",
+    "adKeywordCnt.in",
+    "allSpKeywordCnt.total",
+    "allSpKeywordCnt.in",
+    "spKeywordCnt.total",
+    "spKeywordCnt.in",
+    "recSpKeywordCnt.total",
+    "recSpKeywordCnt.in",
+    "allSbKeywordCnt.total",
+    "allSbKeywordCnt.in",
+    "sbKeywordCnt.total",
+    "sbKeywordCnt.in",
+    "sbvKeywordCnt.total",
+    "sbvKeywordCnt.in",
+];
+const _asinSummaryConditionValues = ["nf", "sp", "sb", "sbv", "ad", "acAd", "totalPeriod.in"];
+const countrySchema = s.optional(s.stringEnum("The Amazon marketplace code. LinkFox defaults to US when omitted.", sifCountries));
+const nullableInteger = (description) => s.nullable(s.integer(description));
+const nullableNumber = (description) => s.nullable(s.number(description));
+const nullableString = (description) => s.nullable(s.string(description));
+function resultSchema(description, recordDescription, extra = {}) {
+    return s.looseRequiredObject(description, {
+        code: s.string("The SIF business code; 1 indicates success."),
+        msg: nullableString("The SIF response message."),
+        total: s.integer("The number of records returned by this request.", { minimum: 0 }),
+        data: s.array("The SIF records returned by this request.", s.looseObject(recordDescription)),
+        columns: s.array("The LinkFox rendering-column definitions.", s.looseObject("A provider-defined rendering-column definition.")),
+        type: nullableString("The LinkFox rendering style when provided."),
+        title: nullableString("The result title when provided."),
+        costTime: nullableInteger("The upstream processing time in milliseconds."),
+        costToken: nullableNumber("The LinkFox token cost when provided."),
+        ...extra,
+    });
+}
+const asinKeywordsInputBase = s.object("Parameters for reverse-searching one ASIN's SIF keywords.", {
+    asin: s.nonEmptyString("The single Amazon ASIN to analyze.", { maxLength: 1000 }),
+    country: countrySchema,
+    keyword: s.optional(s.string("An optional localized keyword used to filter the result.", { maxLength: 1000 })),
+    timePieceType: s.optional(s.stringEnum("The analysis period type. LinkFox defaults to latelyDay.", ["latelyDay", "month", "week"])),
+    timePieceValue: s.optional(s.string("The period value: 7 or 30 for latelyDay, YYYY-MM for month, or the week-start date in YYYY-MM-DD format.", { maxLength: 1000 })),
+    conditions: s.optional(s.string("Comma-separated SIF keyword filters, including traffic-position, advertising, conversion, stability, and period-entry markers.", { maxLength: 1000 })),
+    sortBy: s.optional(s.stringEnum("The keyword sort field. Omit it to use SIF's system order.", [
+        "lastRank",
+        "adLastRank",
+        "updateTime",
+        "searchesRank",
+        "estSearchesNum",
+    ])),
+    desc: s.optional(s.boolean("Whether to sort descending. LinkFox defaults to true.")),
+    pageNum: s.optional(s.integer("The one-based result page. LinkFox defaults to 1.", { minimum: 1 })),
+    pageSize: s.optional(s.integer("The number of keyword records per page. LinkFox defaults to 100.", {
+        minimum: 10,
+        maximum: 100,
+    })),
+});
+const asinKeywordsInput = asinKeywordsInputBase;
+const dateRangeFields = {
+    last7d: s.optional(s.boolean("Whether to use the latest seven days. Set false to use startDate and endDate; LinkFox defaults to true.")),
+    startDate: s.optional(s.date("The period start date, used when last7d is false.")),
+    endDate: s.optional(s.date("The period end date, paired with startDate.")),
+};
+const asinSummaryInputBase = s.object("Parameters for summarizing SIF traffic sources by ASIN.", {
+    searchValue: s.nonEmptyString("One to ten comma-separated Amazon ASINs.", { maxLength: 1000 }),
+    country: countrySchema,
+    ...dateRangeFields,
+    conditions: s.optional(s.string("Comma-separated SIF filters: nf, sp, sb, sbv, ad, acAd, or totalPeriod.in.", {
+        maxLength: 1000,
+    })),
+    sortBy: s.optional(s.stringEnum("The ASIN traffic-summary sort field.", summarySortFields)),
+    pageNum: s.optional(s.integer("The one-based result page. LinkFox defaults to 1.", { minimum: 1 })),
+    pageSize: s.optional(s.integer("The number of ASIN summaries per page. LinkFox defaults to 10000.", {
+        minimum: 10,
+        maximum: 10_000,
+    })),
+    desc: s.optional(s.boolean("Whether to sort descending. LinkFox defaults to true.")),
+});
+const asinSummaryInput = asinSummaryInputBase;
+const keywordOverviewInputBase = s.object("Parameters for retrieving a SIF keyword overview.", {
+    keyword: s.nonEmptyString("The localized Amazon keyword to analyze.", { maxLength: 1000 }),
+    country: countrySchema,
+    ...dateRangeFields,
+});
+const keywordOverviewInput = keywordOverviewInputBase;
+const keywordSummaryInputBase = s.object("Parameters for summarizing competitor traffic sources for one keyword.", {
+    searchKeyword: s.nonEmptyString("The localized Amazon keyword to analyze.", {
+        maxLength: 1000,
+    }),
+    country: countrySchema,
+    asins: s.optional(s.string("An optional comma-separated ASIN filter.", { maxLength: 1000 })),
+    condition: s.optional(s.stringEnum("One SIF traffic or period filter, such as nfPosition, isSpAd, isBrandAd, isPPCAd, acAd, or totalPeriod.in.", keywordSummaryConditions)),
+    ...dateRangeFields,
+    sortBy: s.optional(s.stringEnum("The competitor traffic-summary sort field.", summarySortFields)),
+    pageNum: s.optional(s.integer("The one-based result page. LinkFox defaults to 1.", { minimum: 1 })),
+    pageSize: s.optional(s.integer("The number of competitor ASINs per page. LinkFox defaults to 100.", {
+        minimum: 10,
+        maximum: 100,
+    })),
+    desc: s.optional(s.boolean("Whether to sort descending. LinkFox defaults to true.")),
+});
+const keywordSummaryInput = keywordSummaryInputBase;
+function operation(name, path, description, inputSchema, outputSchema) {
+    return {
+        path,
+        usage: 9,
+        action: defineProviderAction("linkfox", {
+            name,
+            description,
+            operationType: "read",
+            inputSchema,
+            outputSchema,
+        }),
+    };
+}
+export const sifOperations = [
+    operation("list_sif_asin_keywords", "/sif/asinKeywords", "Reverse-search one Amazon ASIN's SIF traffic keywords, ranks, traffic shares, and conversion markers through LinkFox.", asinKeywordsInput, resultSchema("SIF keyword intelligence for one Amazon ASIN.", "A SIF keyword record with ranks, search volume, traffic shares, exposure scores, placements, and conversion markers.", {
+        isParentAsin: s.optional(s.boolean("Whether the queried ASIN is a parent ASIN.")),
+        hasVaiants: s.optional(s.boolean("Whether the queried product has variants.")),
+        abaCreateDateWeek: nullableString("The latest week represented by the ABA data."),
+    })),
+    operation("get_sif_asin_traffic_summary", "/sif/asinSummary", "Summarize natural, advertising, and recommendation traffic sources for up to ten Amazon ASINs through LinkFox and SIF.", asinSummaryInput, resultSchema("SIF traffic-source summaries for Amazon ASINs.", "A SIF ASIN summary with product context, current and previous exposure scores, traffic shares, keyword counts, entry or exit counts, and source markers.", {
+        isParentAsin: s.optional(s.boolean("Whether the search target is a parent ASIN.")),
+        variantsNum: nullableInteger("The number of variants with traffic keywords."),
+        noKeywordVariantsNum: nullableInteger("The number of variants without traffic keywords."),
+    })),
+    operation("get_sif_keyword_overview", "/sif/keywordOverview", "Get SIF search demand, supply-demand ratio, and advertising or recommendation competition for one Amazon keyword through LinkFox.", keywordOverviewInput, resultSchema("A SIF market-competition overview for one Amazon keyword.", "A SIF keyword overview with search volume, supply-demand ratio, product counts by traffic placement, tracked ASIN totals, and data-period timestamps.")),
+    operation("get_sif_keyword_traffic_summary", "/sif/keywordSummary", "Analyze competitor ASIN traffic shares and natural, advertising, or recommendation exposure for one Amazon keyword through LinkFox and SIF.", keywordSummaryInput, resultSchema("SIF competitor traffic-source summaries for one Amazon keyword.", "A SIF competitor record with product context, overall and queried-keyword exposure scores, traffic shares, and source markers.")),
+];
+export const sifActions = sifOperations.map(({ action }) => action);

package/src/providers/mcp-client.d.ts

@@ -10,6 +10,7 @@ export interface McpClientOptions {
     signal?: AbortSignal;
     protocolVersion?: McpProtocolVersion;
     terminateSession?: boolean;
+    retryOnSessionNotFound?: boolean;
     mapError?: (error: unknown) => unknown;
 }
 export declare function withMcpClient<T>(options: McpClientOptions, run: (client: Client) => Promise<T>): Promise<T>;