qingflow-mcp 0.3.19 → 0.3.20

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.19
+npm i -g qingflow-mcp@0.3.20
 ```
 
 Or one-click installer:

package/dist/server.js

@@ -65,7 +65,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.19";
+const SERVER_VERSION = "0.3.20";
 const accessToken = process.env.QINGFLOW_ACCESS_TOKEN;
 const baseUrl = process.env.QINGFLOW_BASE_URL;
 if (!accessToken) {
@@ -745,12 +745,14 @@ const listOutputSchema = listSuccessOutputSchema;
 const recordGetInputPublicSchema = z
     .object({
     apply_id: publicFieldSelectorSchema,
+    app_key: publicStringSchema.optional(),
     max_columns: z.number().int().positive().max(MAX_COLUMN_LIMIT).optional(),
     select_columns: z.array(publicFieldSelectorSchema).min(1).max(MAX_COLUMN_LIMIT),
     output_profile: outputProfileSchema.optional()
 });
 const recordGetInputSchema = z.preprocess(normalizeRecordGetInput, z.object({
     apply_id: z.union([z.string().min(1), z.number().int()]),
+    app_key: z.string().min(1).optional(),
     max_columns: z.number().int().positive().max(MAX_COLUMN_LIMIT).optional(),
     select_columns: z
         .array(z.union([z.string().min(1), z.number().int()]))
@@ -2832,6 +2834,17 @@ function buildMeta(response) {
         base_url: baseUrl
     };
 }
+async function fetchRecordsByApplyIds(params) {
+    const response = await client.listRecords(params.appKey, buildListPayload({
+        pageNum: 1,
+        pageSize: Math.min(Math.max(params.applyIds.length, 1), 200),
+        applyIds: params.applyIds
+    }), { userId: params.userId });
+    const records = asArray(asObject(response.result)?.result)
+        .map((item) => asObject(item))
+        .filter((item) => Boolean(item));
+    return { response, records };
+}
 function normalizeStringArray(value) {
     return uniqueStringList(asArray(value)
         .map((item) => asNullableString(item)?.trim() ?? "")
@@ -3783,6 +3796,7 @@ function normalizeRecordGetInput(raw) {
     return {
         ...normalizedObj,
         apply_id: coerceNumberLike(normalizedObj.apply_id),
+        app_key: coerceStringLike(normalizedObj.app_key),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         select_columns: normalizeSelectorListInput(selectColumns),
         output_profile: normalizeOutputProfileInput(normalizedObj.output_profile)
@@ -3903,6 +3917,7 @@ function normalizeBatchGetInput(raw) {
     const selectColumns = normalizedObj.select_columns ?? normalizedObj.keep_columns;
     return {
         ...normalizedObj,
+        app_key: coerceStringLike(normalizedObj.app_key),
         apply_ids: normalizeIdArrayInput(normalizedObj.apply_ids),
         max_columns: coerceNumberLike(normalizedObj.max_columns),
         select_columns: normalizeSelectorListInput(selectColumns),
@@ -5503,6 +5518,7 @@ function buildRecordGetArgsFromQuery(args) {
     }
     return recordGetInputSchema.parse({
         apply_id: args.apply_id,
+        app_key: args.app_key,
         max_columns: args.max_columns,
         select_columns: args.select_columns,
         output_profile: args.output_profile
@@ -5588,6 +5604,13 @@ async function executeQueryPlan(args) {
     };
 }
 async function executeRecordsBatchGet(args) {
+    if (!args.app_key) {
+        throw missingRequiredFieldError({
+            field: "app_key",
+            tool: "qf_records_batch_get",
+            fixHint: "Provide app_key, for example: {\"app_key\":\"21b3d559\",\"apply_ids\":[\"...\"],\"select_columns\":[0]}."
+        });
+    }
     if (!args.select_columns?.length) {
         throw missingRequiredFieldError({
             field: "select_columns",
@@ -5605,25 +5628,23 @@ async function executeRecordsBatchGet(args) {
     const rows = [];
     const missingApplyIds = [];
     let metaResponse = null;
+    const { response, records } = await fetchRecordsByApplyIds({
+        appKey: args.app_key,
+        applyIds: requestedApplyIds
+    });
+    metaResponse = buildMeta(response);
+    const byApplyId = new Map(records.map((record) => [String(record.applyId ?? ""), record]));
     for (const applyId of requestedApplyIds) {
-        try {
-            const response = await client.getRecord(applyId);
-            metaResponse = metaResponse ?? buildMeta(response);
-            const record = asObject(response.result) ?? {};
-            rows.push(buildFlatRowFromAnswers({
-                applyId: record.applyId ?? applyId,
-                answers: asArray(record.answers),
-                selectedColumns: selectedColumnsForRow
-            }));
-        }
-        catch (error) {
-            if (error instanceof QingflowApiError &&
-                (error.httpStatus === 404 || error.errCode === 404)) {
-                missingApplyIds.push(applyId);
-                continue;
-            }
-            throw error;
+        const record = byApplyId.get(String(applyId));
+        if (!record) {
+            missingApplyIds.push(applyId);
+            continue;
         }
+        rows.push(buildFlatRowFromAnswers({
+            applyId: record.applyId ?? applyId,
+            answers: asArray(record.answers),
+            selectedColumns: selectedColumnsForRow
+        }));
     }
     const completeness = {
         result_amount: requestedApplyIds.length,
@@ -6186,10 +6207,50 @@ async function executeRecordGet(args) {
     }
     const outputProfile = resolveOutputProfile(args.output_profile);
     const queryId = randomUUID();
-    const response = await client.getRecord(String(args.apply_id));
-    const record = asObject(response.result) ?? {};
+    let response;
+    let record = null;
+    try {
+        response = await client.getRecord(String(args.apply_id));
+        record = asObject(response.result) ?? {};
+    }
+    catch (error) {
+        const providerError = error instanceof QingflowApiError ? error : null;
+        const shouldFallback = providerError && (providerError.httpStatus === 404 || providerError.errCode === 404 || providerError.errCode === 49304);
+        if (!shouldFallback) {
+            throw error;
+        }
+        if (!args.app_key) {
+            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.",
+                details: {
+                    apply_id: String(args.apply_id),
+                    provider_err_code: providerError?.errCode ?? null,
+                    provider_err_msg: providerError?.errMsg ?? null
+                }
+            });
+        }
+        const fallback = await fetchRecordsByApplyIds({
+            appKey: args.app_key,
+            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}\"`,
+                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
+                }
+            });
+        }
+    }
     const projection = projectAnswersForOutput({
-        answers: asArray(record.answers),
+        answers: asArray(record?.answers),
         maxColumns: args.max_columns,
         selectColumns: args.select_columns
     });
@@ -6197,8 +6258,8 @@ async function executeRecordGet(args) {
         ? (projection.selectedColumns ?? []).slice(0, args.max_columns)
         : projection.selectedColumns ?? [];
     const row = buildFlatRowFromAnswers({
-        applyId: record.applyId ?? null,
-        answers: asArray(record.answers),
+        applyId: record?.applyId ?? null,
+        answers: asArray(record?.answers),
         selectedColumns: selectedColumnsForRow
     });
     const completeness = {
@@ -6223,7 +6284,7 @@ async function executeRecordGet(args) {
         payload: {
             ok: true,
             data: {
-                apply_id: record.applyId ?? null,
+                apply_id: record?.applyId ?? null,
                 row,
                 applied_limits: {
                     column_cap: args.max_columns ?? null,

package/package.json

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