qingflow-mcp 0.3.20 → 0.3.21

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.21
 ```
 
 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.21";
 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,
@@ -5640,6 +5703,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 +6127,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 +6286,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 +6300,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 +6349,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.21",
   "private": false,
   "license": "MIT",
   "type": "module",