qingflow-mcp 0.3.20 → 0.3.22

package/README.md

@@ -117,7 +117,7 @@ npm i -g git+https://github.com/853046310/qingflow-mcp.git
 Install from npm (pinned version):
 
 ```bash
-npm i -g qingflow-mcp@0.3.20
+npm i -g qingflow-mcp@0.3.22
 ```
 
 Or one-click installer:

package/dist/server.js

@@ -46,6 +46,9 @@ class InputValidationError extends Error {
 }
 const FORM_CACHE_TTL_MS = Number(process.env.QINGFLOW_FORM_CACHE_TTL_MS ?? "300000");
 const formCache = new Map();
+const APPLY_APP_KEY_CACHE_TTL_MS = Number(process.env.QINGFLOW_APPLY_APP_KEY_CACHE_TTL_MS ?? "1800000");
+const applyAppKeyCache = new Map();
+const requestAppKeyCache = new Map();
 const CONTINUATION_CACHE_TTL_MS = Number(process.env.QINGFLOW_CONTINUATION_CACHE_TTL_MS ?? "900000");
 const continuationCache = new Map();
 const DEFAULT_PAGE_SIZE = 50;
@@ -65,7 +68,7 @@ const REQUEST_TIMEOUT_MS = toPositiveInt(process.env.QINGFLOW_REQUEST_TIMEOUT_MS
 const EXECUTION_BUDGET_MS = toPositiveInt(process.env.QINGFLOW_EXECUTION_BUDGET_MS) ?? 20000;
 const WAIT_RESULT_DEFAULT_TIMEOUT_MS = toPositiveInt(process.env.QINGFLOW_WAIT_RESULT_TIMEOUT_MS) ?? 5000;
 const WAIT_RESULT_POLL_INTERVAL_MS = toPositiveInt(process.env.QINGFLOW_WAIT_RESULT_POLL_INTERVAL_MS) ?? 500;
-const SERVER_VERSION = "0.3.20";
+const SERVER_VERSION = "0.3.22";
 const accessToken = process.env.QINGFLOW_ACCESS_TOKEN;
 const baseUrl = process.env.QINGFLOW_BASE_URL;
 if (!accessToken) {
@@ -2406,6 +2409,8 @@ server.registerTool("qf_record_create", {
         const result = asObject(response.result);
         const requestId = asNullableString(result?.requestId);
         const immediateApplyId = result?.applyId ?? null;
+        rememberRequestAppKey(requestId, parsedArgs.app_key);
+        rememberApplyAppKey(immediateApplyId, parsedArgs.app_key);
         const shouldWaitForResult = (parsedArgs.wait_result ?? false) && requestId !== null && immediateApplyId === null;
         let finalApplyId = immediateApplyId;
         let waitStatus = immediateApplyId !== null ? "completed" : "pending";
@@ -2418,6 +2423,7 @@ server.registerTool("qf_record_create", {
             waitStatus = waited.status;
             rawOperationResult = waited.operationResult;
             finalApplyId = waited.applyId;
+            rememberApplyAppKey(waited.applyId, parsedArgs.app_key);
         }
         const createResource = finalApplyId !== null ? { type: "record", apply_id: finalApplyId } : null;
         const createNextAction = waitStatus === "pending" || waitStatus === "timeout"
@@ -2478,6 +2484,8 @@ server.registerTool("qf_record_update", {
         const response = await client.updateRecord(String(parsedArgs.apply_id), { answers: normalizedAnswers }, { userId: parsedArgs.user_id });
         const result = asObject(response.result);
         const updateRequestId = asNullableString(result?.requestId);
+        rememberRequestAppKey(updateRequestId, parsedArgs.app_key ?? null);
+        rememberApplyAppKey(parsedArgs.apply_id, parsedArgs.app_key ?? null);
         const shouldWaitForUpdate = (parsedArgs.wait_result ?? false) && updateRequestId !== null;
         let updateStatus = "pending";
         let updateRawOperationResult = null;
@@ -2493,6 +2501,7 @@ server.registerTool("qf_record_update", {
             if (waited.applyId !== null) {
                 updateApplyId = waited.applyId;
             }
+            rememberApplyAppKey(waited.applyId, parsedArgs.app_key ?? null);
         }
         else if (updateRequestId === null) {
             // No async operation — synchronous completion
@@ -2538,6 +2547,8 @@ server.registerTool("qf_operation_get", {
 }, async (args) => {
     try {
         const response = await client.getOperation(args.request_id);
+        const cachedAppKey = getCachedRequestAppKey(args.request_id);
+        rememberApplyAppKey(extractOperationApplyId(response.result), cachedAppKey);
         return okResult({
             ok: true,
             data: {
@@ -2834,6 +2845,58 @@ function buildMeta(response) {
         base_url: baseUrl
     };
 }
+function rememberApplyAppKey(applyId, appKey) {
+    const normalizedApplyId = asNullableString(applyId)?.trim();
+    const normalizedAppKey = asNullableString(appKey)?.trim();
+    if (!normalizedApplyId || !normalizedAppKey) {
+        return;
+    }
+    applyAppKeyCache.set(normalizedApplyId, {
+        appKey: normalizedAppKey,
+        expiresAt: Date.now() + APPLY_APP_KEY_CACHE_TTL_MS
+    });
+}
+function rememberRequestAppKey(requestId, appKey) {
+    const normalizedRequestId = asNullableString(requestId)?.trim();
+    const normalizedAppKey = asNullableString(appKey)?.trim();
+    if (!normalizedRequestId || !normalizedAppKey) {
+        return;
+    }
+    requestAppKeyCache.set(normalizedRequestId, {
+        appKey: normalizedAppKey,
+        expiresAt: Date.now() + APPLY_APP_KEY_CACHE_TTL_MS
+    });
+}
+function getCachedApplyAppKey(applyId) {
+    const normalizedApplyId = asNullableString(applyId)?.trim();
+    if (!normalizedApplyId) {
+        return null;
+    }
+    const hit = applyAppKeyCache.get(normalizedApplyId);
+    if (!hit) {
+        return null;
+    }
+    if (hit.expiresAt <= Date.now()) {
+        applyAppKeyCache.delete(normalizedApplyId);
+        return null;
+    }
+    return hit.appKey;
+}
+function getCachedRequestAppKey(requestId) {
+    const normalizedRequestId = asNullableString(requestId)?.trim();
+    if (!normalizedRequestId) {
+        return null;
+    }
+    const hit = requestAppKeyCache.get(normalizedRequestId);
+    if (!hit) {
+        return null;
+    }
+    if (hit.expiresAt <= Date.now()) {
+        requestAppKeyCache.delete(normalizedRequestId);
+        return null;
+    }
+    return hit.appKey;
+}
 async function fetchRecordsByApplyIds(params) {
     const response = await client.listRecords(params.appKey, buildListPayload({
         pageNum: 1,
@@ -3778,7 +3841,7 @@ function normalizeListInput(raw) {
         strict_full: coerceBooleanLike(normalizedObj.strict_full),
         include_answers: coerceBooleanLike(normalizedObj.include_answers),
         output_profile: normalizeOutputProfileInput(normalizedObj.output_profile),
-        apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
+        apply_ids: normalizeOpaqueIdArrayInput(normalizedObj.apply_ids),
         sort: normalizeSortInput(normalizedObj.sort),
         filters: normalizeFiltersInput(normalizedObj.filters),
         select_columns: normalizeSelectorListInput(selectColumns),
@@ -3795,7 +3858,7 @@ function normalizeRecordGetInput(raw) {
     const selectColumns = normalizedObj.select_columns ?? normalizedObj.keep_columns;
     return {
         ...normalizedObj,
-        apply_id: coerceNumberLike(normalizedObj.apply_id),
+        apply_id: normalizeOpaqueIdInput(normalizedObj.apply_id),
         app_key: coerceStringLike(normalizedObj.app_key),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         select_columns: normalizeSelectorListInput(selectColumns),
@@ -3821,12 +3884,12 @@ function normalizeQueryInput(raw) {
         max_rows: coerceNumberLike(normalizedObj.max_rows),
         max_items: coerceNumberLike(normalizedObj.max_items),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
-        apply_id: coerceNumberLike(normalizedObj.apply_id),
+        apply_id: normalizeOpaqueIdInput(normalizedObj.apply_id),
         strict_full: coerceBooleanLike(normalizedObj.strict_full),
         include_answers: coerceBooleanLike(normalizedObj.include_answers),
         output_profile: normalizeOutputProfileInput(normalizedObj.output_profile),
         amount_column: normalizeAmountColumnInput(normalizedObj.amount_column),
-        apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
+        apply_ids: normalizeOpaqueIdArrayInput(normalizedObj.apply_ids),
         sort: normalizeSortInput(normalizedObj.sort),
         filters: normalizeFiltersInput(normalizedObj.filters),
         select_columns: normalizeSelectorListInput(selectColumns),
@@ -3858,7 +3921,7 @@ function normalizeAggregateInput(raw) {
         amount_column: normalizeAmountColumnInput(amountColumns),
         metrics: normalizeMetricsInput(normalizedObj.metrics),
         time_bucket: normalizeTimeBucketInput(normalizedObj.time_bucket),
-        apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
+        apply_ids: normalizeOpaqueIdArrayInput(normalizedObj.apply_ids),
         sort: normalizeSortInput(normalizedObj.sort),
         filters: normalizeFiltersInput(normalizedObj.filters),
         time_range: timeRange,
@@ -3918,7 +3981,7 @@ function normalizeBatchGetInput(raw) {
     return {
         ...normalizedObj,
         app_key: coerceStringLike(normalizedObj.app_key),
-        apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
+        apply_ids: normalizeOpaqueIdArrayInput(normalizedObj.apply_ids),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         select_columns: normalizeSelectorListInput(selectColumns),
         output_profile: normalizeOutputProfileInput(normalizedObj.output_profile)
@@ -3944,7 +4007,7 @@ function normalizeExportInput(raw) {
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         strict_full: coerceBooleanLike(normalizedObj.strict_full),
         output_profile: normalizeOutputProfileInput(normalizedObj.output_profile),
-        apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
+        apply_ids: normalizeOpaqueIdArrayInput(normalizedObj.apply_ids),
         sort: normalizeSortInput(normalizedObj.sort),
         filters: normalizeFiltersInput(normalizedObj.filters),
         select_columns: normalizeSelectorListInput(selectColumns),
@@ -4071,6 +4134,34 @@ function normalizeIdArrayInput(value) {
     }
     return parsed;
 }
+function normalizeOpaqueIdInput(value) {
+    const parsed = parseJsonLikeDeep(value);
+    if (parsed === undefined || parsed === null) {
+        return parsed;
+    }
+    if (typeof parsed === "string") {
+        const trimmed = parsed.trim();
+        return trimmed ? trimmed : parsed;
+    }
+    if (typeof parsed === "number" && Number.isFinite(parsed)) {
+        return String(Math.trunc(parsed));
+    }
+    return parsed;
+}
+function normalizeOpaqueIdArrayInput(value) {
+    const parsed = parseJsonLikeDeep(value);
+    if (Array.isArray(parsed)) {
+        return parsed.map((item) => normalizeOpaqueIdInput(item));
+    }
+    if (typeof parsed === "string" && parsed.includes(",")) {
+        return parsed
+            .split(",")
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0)
+            .map((item) => normalizeOpaqueIdInput(item));
+    }
+    return parsed;
+}
 function normalizeSortInput(value) {
     const parsed = parseJsonLikeDeep(value);
     if (!Array.isArray(parsed)) {
@@ -5640,6 +5731,7 @@ async function executeRecordsBatchGet(args) {
             missingApplyIds.push(applyId);
             continue;
         }
+        rememberApplyAppKey(record.applyId ?? applyId, args.app_key);
         rows.push(buildFlatRowFromAnswers({
             applyId: record.applyId ?? applyId,
             answers: asArray(record.answers),
@@ -6063,6 +6155,9 @@ async function executeRecordsList(args) {
     const items = collectedRawItems
         .slice(0, listLimit.limit)
         .map((raw) => normalizeRecordItem(raw, includeAnswers));
+    for (const item of items) {
+        rememberApplyAppKey(item.apply_id, args.app_key);
+    }
     const sourceItemsForRows = items.slice();
     const requestedSelectColumns = selectResolution.columns.map((item) => item.requested);
     const columnProjection = projectRecordItemsColumns({
@@ -6219,11 +6314,12 @@ async function executeRecordGet(args) {
         if (!shouldFallback) {
             throw error;
         }
-        if (!args.app_key) {
+        const fallbackAppKey = args.app_key ?? getCachedApplyAppKey(args.apply_id);
+        if (!fallbackAppKey) {
             throw new InputValidationError({
                 message: `qf_record_get could not read apply_id \"${String(args.apply_id)}\" through the direct record endpoint`,
                 errorCode: "APP_KEY_REQUIRED_FOR_RECORD_GET",
-                fixHint: "Retry qf_record_get with app_key, or use qf_query/qf_records_batch_get with explicit app_key for this record.",
+                fixHint: "Retry qf_record_get with app_key, or call qf_records_batch_get/qf_records_list/qf_record_update first so MCP can infer the app_key for this apply_id.",
                 details: {
                     apply_id: String(args.apply_id),
                     provider_err_code: providerError?.errCode ?? null,
@@ -6232,22 +6328,23 @@ async function executeRecordGet(args) {
             });
         }
         const fallback = await fetchRecordsByApplyIds({
-            appKey: args.app_key,
+            appKey: fallbackAppKey,
             applyIds: [String(args.apply_id)]
         });
         response = fallback.response;
         record = fallback.records.find((item) => String(item.applyId ?? "") === String(args.apply_id)) ?? null;
         if (!record) {
             throw new InputValidationError({
-                message: `Record \"${String(args.apply_id)}\" not found in app \"${args.app_key}\"`,
+                message: `Record \"${String(args.apply_id)}\" not found in app \"${fallbackAppKey}\"`,
                 errorCode: "RECORD_NOT_FOUND",
                 fixHint: "Confirm apply_id and app_key, or fetch the row via qf_records_list/qf_query first.",
                 details: {
                     apply_id: String(args.apply_id),
-                    app_key: args.app_key
+                    app_key: fallbackAppKey
                 }
             });
         }
+        rememberApplyAppKey(record.applyId ?? args.apply_id, fallbackAppKey);
     }
     const projection = projectAnswersForOutput({
         answers: asArray(record?.answers),
@@ -6280,6 +6377,7 @@ async function executeRecordGet(args) {
         apply_id: String(args.apply_id),
         selected_columns: selectedColumnsForRow
     };
+    rememberApplyAppKey(record?.applyId ?? args.apply_id, args.app_key ?? getCachedApplyAppKey(args.apply_id));
     return {
         payload: {
             ok: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qingflow-mcp",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "private": false,
   "license": "MIT",
   "type": "module",